refactor(util): clean up script-related methods in OCP\Util

[joshtrichards]

• Resolves: #

Summary

This PR refactors the script registration methods in OCP\Util for clarity and safety. It improves docblocks and naming, adds missing type declarations, fixes a couple of array-initialization issues, and makes translation asset registration idempotent earlier in the pipeline.

Changes

• expand/clarify docblocks for script-related properties and methods
• rename scriptOrderValue() to scriptPriority()
• add missing parameter/return types to several Util methods
• tighten addScript()’s $file parameter from ?string to string
• fix potential undefined-index / missing-initialization cases in addScript() and addTranslations()
• deduplicate repeated translation asset registrations at insertion time via new private helpers
• small readability cleanups (isset() for $scriptDeps, local variable renames, docblock cleanup)

Behavior notes

• addScript() no longer accepts null for $file (technically a BC, but it would have never worked anyhow)
• translation asset registration is now idempotent at insertion time

Scope note

This branch also currently contains a few small non-script-adjacent Util.php cleanups (getServerHostName(), numericToNumber(), and related docblocks). I can split those out if preferred.

Follow-up ideas

• Introduce a dedicated script-registry service and start migrating to it

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• Tests (unit, integration, api and/or acceptance) are included
• Screenshots before/after for front-end changes
• Documentation (manuals or wiki) has been updated or is not required
• Backports requested where applicable (ex: critical bugfixes)
• Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
• Milestone added for target branch/version (ex: 32.x for stable32)

AI (if applicable)

• The content of this PR was partly or fully generated using AI