chore(docs): update code docs

Author: jellyrock[bot]

docs/components_settings_settings.bs.html

@@ -742,9 +742,19 @@
   newLocale = m.languagePicker.selectedCode
   selectedSetting = m.userLocation.peek().filteredChildren[m.settingsMenu.itemFocused]
 
-  ' Save to user registry (empty string = automatic)
+  ' Save to registry (empty string = automatic). The auto-sync observer routes
+  ' global* settings to the device-wide section and per-user settings to the
+  ' user's section.
   user.settings.Save(selectedSetting.settingName, newLocale)
 
+  ' globalTranslationLocale is the device-wide sign-in-screen language, consumed
+  ' ONLY pre-login (see resolveTranslationLocale). It must NOT live-reload the
+  ' current post-login session — that would re-theme the home screen the user is
+  ' looking at to the device default, overriding their own language. It takes
+  ' effect the next time the sign-in screens render (Sign Out / Change User),
+  ' which re-resolve the pre-login locale at the appStart login-flow entry.
+  if selectedSetting.settingName = "globalTranslationLocale" then return
+
   ' Resolve and load the new locale
   if newLocale = ""
     resolvedLocale = resolveTranslationLocale(true)

docs/data/search.json

@@ -37,6 +37,13 @@
 
   appStart:
   m.global.sceneManager.callFunc("clearScenes")
+  ' Re-resolve the pre-login locale on every entry to the login flow. We reach
+  ' here both at cold start AND on re-entry from Change Server / Change User /
+  ' Sign Out (which `goto appStart`). Without this re-resolve, a changed global
+  ' sign-in language would only apply after a full app restart, and the sign-in
+  ' screens would render in the just-signed-out user's language rather than the
+  ' device-wide default. isPostLogin defaults to false here → pre-login cascade.
+  loadTranslations(resolveTranslationLocale())
   ' First thing to do is validate the ability to use the API
   if not LoginFlow() then return
 

docs/module-translateLocale.html

@@ -6,7 +6,7 @@
 ' from source/ context (Main.bs, session.bs) where config.bs is auto-scoped.
 
 ' Determine which locale to load using the fallback cascade.
-' Pre-login (isPostLogin=false): device locale -> en_US
+' Pre-login (isPostLogin=false): global sign-in language -> device locale -> en_US
 ' Post-login (isPostLogin=true): user setting -> server language -> device locale -> en_US
 ' @param {boolean} isPostLogin - Whether a user is authenticated
 ' @param {string} serverLanguage - Language from server CustomPrefs.language (empty if unavailable)
@@ -24,13 +24,24 @@
     return normalizeLocaleCode(serverLanguage)
   end if
 
-  ' Priority 3: Roku device locale
+  ' Priority 3: Global device-wide sign-in language — PRE-LOGIN ONLY.
+  ' Localizes the server-select / user-select screens, where no user context
+  ' exists yet. Read via getSetting (NOT getUserSetting) so it resolves with no
+  ' signed-in user. Deliberately skipped post-login: a signed-in user's session
+  ' is governed entirely by their own setting / server pref / device locale, so a
+  ' user's home screen never inherits the device-wide sign-in default.
+  if not isPostLogin
+    globalLocale = getSetting("globalTranslationLocale")
+    if isValidAndNotEmpty(globalLocale) then return globalLocale
+  end if
+
+  ' Priority 4: Roku device locale
   deviceLocale = m.global.device.locale
   if isValidAndNotEmpty(deviceLocale)
     return mapRokuLocaleToTranslationLocale(deviceLocale)
   end if
 
-  ' Priority 4: Hardcoded default
+  ' Priority 5: Hardcoded default
   return "en_US"
 end function