spoint 0.1.668 → 0.1.670

package/client/BootFailureOverlay.js

@@ -0,0 +1,49 @@
+// Boot-diagnostics helpers for app.js: shadow-cascade-count resolution (device-aware default the
+// shadow pipeline registry itself has no knowledge of) and the single boot-failure overlay renderer,
+// reused by every early-boot catch site (WebGL2-context-creation failure, window.onerror,
+// unhandledrejection). Split out as the only two functions in app.js's top-level boot script with no
+// interleaved side-effecting script logic immediately around them -- app.js itself is a flat top-to-
+// bottom boot sequence, not a factory, so most of it cannot be safely cut without risking a module-eval
+// ordering regression; these two are genuinely self-contained.
+
+import { QualityPresets } from './core/QualityPresets.js'
+
+function _shadowCascadeCountForBoot(deviceInfo) {
+  const explicit = typeof window !== 'undefined' ? window.__shadowCascades : undefined
+  if (Number.isFinite(explicit)) return Math.max(1, Math.min(3, Math.round(explicit)))
+  const presetName = QualityPresets.getPersisted() || QualityPresets.chooseInitialPreset(deviceInfo)
+  const byTier = { Low: 1, Medium: 1, High: 2, Ultra: 3 }
+  return byTier[presetName] || 1
+}
+
+// Single boot-failure overlay renderer, reused by both the WebGL2-specific catch below AND the
+// generic window.onerror/unhandledrejection listeners -- one visual style for "the client failed
+// to boot" regardless of WHERE in the boot sequence it failed, instead of a blank canvas / silently
+// stuck loading screen. Idempotent (a data-flag guards double-render across multiple errors racing
+// in, e.g. a synchronous throw immediately followed by a rejected promise from the same root cause).
+let _bootFailureShown = false
+function _showBootFailureOverlay(title, detail) {
+  if (_bootFailureShown) return
+  _bootFailureShown = true
+  try {
+    const o = document.createElement('div')
+    o.setAttribute('role', 'alert')
+    o.style.cssText = 'position:fixed;inset:0;z-index:99999;display:flex;align-items:center;justify-content:center;padding:24px;background:#0b0e14;color:#e6e6e6;font:16px/1.5 system-ui,sans-serif;text-align:center'
+    const titleEl = document.createElement('div')
+    titleEl.style.cssText = 'font-size:22px;font-weight:600;margin-bottom:12px'
+    titleEl.textContent = title
+    const detailEl = document.createElement('div')
+    detailEl.style.cssText = 'max-width:640px;white-space:pre-wrap;word-break:break-word;font:13px/1.5 ui-monospace,monospace;opacity:0.85;margin-top:8px;text-align:left'
+    detailEl.textContent = detail || ''
+    const wrap = document.createElement('div')
+    wrap.style.cssText = 'max-width:640px'
+    wrap.appendChild(titleEl)
+    wrap.appendChild(detailEl)
+    o.appendChild(wrap)
+    document.body.appendChild(o)
+    const ls = document.getElementById('loading-screen') || document.querySelector('.loading-screen')
+    if (ls) ls.style.display = 'none'
+  } catch (_) { /* overlay itself must never throw during an already-failing boot */ }
+}
+
+export { _shadowCascadeCountForBoot, _showBootFailureOverlay }

package/client/app.js

@@ -62,6 +62,7 @@ import { getSharedStreamingScheduler } from './core/StreamingScheduler.js'
 import { createPlacementScheduler } from './core/PlacementScheduler.js'
 import { getSharedCacheRevalidationSweep } from './core/CacheRevalidationSweep.js'
 import { QualityPresets, installQualityPresets } from './core/QualityPresets.js'
+import { _shadowCascadeCountForBoot, _showBootFailureOverlay } from './BootFailureOverlay.js'
 import { createSettingsMenu } from './hud/SettingsMenu.js'
 import { createPauseMenu } from './hud/PauseMenu.js'
 import { createEmoteWheel } from './hud/EmoteWheel.js'
@@ -118,48 +119,6 @@ if (typeof window !== 'undefined') window.__deviceInfo = _deviceInfoEarly
 // Device-tier default for ShadowPipeline's cascade count (shadowCascades RenderControls knob, doc'd
 // in RenderControls.js: Low/Medium=1, High=2, Ultra=3). RenderControls.get() itself only ever returns
 // an explicit window.__shadowCascades override or the registry's static default (1) -- it has no
-// device-awareness of its own -- so a real tier default has to be resolved here, once, the same way
-// QualityPresets.autoApplyPersisted resolves a tier below (persisted user choice wins, else the same
-// chooseInitialPreset heuristic), and passed into createShadowPipeline explicitly. window.__shadowCascades
-// (if pre-set before this script runs, e.g. by a test harness) always wins over both.
-function _shadowCascadeCountForBoot(deviceInfo) {
-  const explicit = typeof window !== 'undefined' ? window.__shadowCascades : undefined
-  if (Number.isFinite(explicit)) return Math.max(1, Math.min(3, Math.round(explicit)))
-  const presetName = QualityPresets.getPersisted() || QualityPresets.chooseInitialPreset(deviceInfo)
-  const byTier = { Low: 1, Medium: 1, High: 2, Ultra: 3 }
-  return byTier[presetName] || 1
-}
-
-// Single boot-failure overlay renderer, reused by both the WebGL2-specific catch below AND the
-// generic window.onerror/unhandledrejection listeners -- one visual style for "the client failed
-// to boot" regardless of WHERE in the boot sequence it failed, instead of a blank canvas / silently
-// stuck loading screen. Idempotent (a data-flag guards double-render across multiple errors racing
-// in, e.g. a synchronous throw immediately followed by a rejected promise from the same root cause).
-let _bootFailureShown = false
-function _showBootFailureOverlay(title, detail) {
-  if (_bootFailureShown) return
-  _bootFailureShown = true
-  try {
-    const o = document.createElement('div')
-    o.setAttribute('role', 'alert')
-    o.style.cssText = 'position:fixed;inset:0;z-index:99999;display:flex;align-items:center;justify-content:center;padding:24px;background:#0b0e14;color:#e6e6e6;font:16px/1.5 system-ui,sans-serif;text-align:center'
-    const titleEl = document.createElement('div')
-    titleEl.style.cssText = 'font-size:22px;font-weight:600;margin-bottom:12px'
-    titleEl.textContent = title
-    const detailEl = document.createElement('div')
-    detailEl.style.cssText = 'max-width:640px;white-space:pre-wrap;word-break:break-word;font:13px/1.5 ui-monospace,monospace;opacity:0.85;margin-top:8px;text-align:left'
-    detailEl.textContent = detail || ''
-    const wrap = document.createElement('div')
-    wrap.style.cssText = 'max-width:640px'
-    wrap.appendChild(titleEl)
-    wrap.appendChild(detailEl)
-    o.appendChild(wrap)
-    document.body.appendChild(o)
-    const ls = document.getElementById('loading-screen') || document.querySelector('.loading-screen')
-    if (ls) ls.style.display = 'none'
-  } catch (_) { /* overlay itself must never throw during an already-failing boot */ }
-}
-
 // Generic boot-failure safety net: ANY uncaught error or unhandled promise rejection during client
 // boot (not just the WebGL2-context-creation case caught explicitly below) renders the same overlay
 // style with the real error message/stack, instead of leaving the user staring at a stuck loading

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spoint",
-  "version": "0.1.668",
+  "version": "0.1.670",
   "description": "Physics and netcode SDK for multiplayer game servers",
   "type": "module",
   "workspaces": [