@jgengine/shell 0.18.1 → 0.21.0

package/dist/GameHost.d.ts

@@ -1,9 +1,15 @@
 import { type ComponentType } from "react";
 import type { EditorCatalogDefinition } from "@jgengine/core/editor/types";
+import type { CreatorConfig } from "@jgengine/core/editor/creatorStorage";
 import { type ResolveShellMultiplayerArgs, type ShellMultiplayer } from "./multiplayer.js";
 import type { PlayableGame } from "./registry.js";
 /** Structural shape of the module `GameHost`'s `editor` loader resolves — `import("@jgengine/editor")` satisfies it. */
 export interface EditorSummonModule {
+    CreatorApp?: ComponentType<{
+        gameId: string;
+        config: CreatorConfig<PlayableGame>;
+        onExit: () => void;
+    }>;
     EditorApp: ComponentType<{
         gameId: string;
         playable: PlayableGame;
@@ -28,6 +34,11 @@ export interface GameHostProps {
      * stays a lazy chunk the game bundles only when this prop is set.
      */
     editor?: () => Promise<EditorSummonModule>;
+    /** Player creator: injected durable storage, bounded catalog and a fresh runtime factory. */
+    creator?: CreatorConfig<PlayableGame>;
+    /** Controlled by the game's production menu. */
+    creatorOpen?: boolean;
+    onCreatorOpenChange?: (open: boolean) => void;
 }
 /**
  * The one documented mount: resolves multiplayer for the playable and renders the shell. With the
@@ -35,4 +46,4 @@ export interface GameHostProps {
  *
  * @capability mount-game mount a defined game in the browser — `<GameHost playable={game} editor={() => import("@jgengine/editor")} />`
  */
-export declare function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultiplayer, editor }: GameHostProps): import("react").JSX.Element;
+export declare function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultiplayer, editor, creator, creatorOpen, onCreatorOpenChange }: GameHostProps): import("react").JSX.Element;

package/dist/GameHost.js

@@ -27,7 +27,7 @@ function initialEditorMode(enabled) {
  *
  * @capability mount-game mount a defined game in the browser — `<GameHost playable={game} editor={() => import("@jgengine/editor")} />`
  */
-export function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultiplayer, editor }) {
+export function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultiplayer, editor, creator, creatorOpen = false, onCreatorOpenChange }) {
     const resolvedGameId = gameId ?? playable.game.name;
     const [editorOpen, setEditorOpen] = useState(() => initialEditorMode(editor !== undefined));
     useEffect(() => {
@@ -88,6 +88,16 @@ export function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultipla
             return null;
         return lazy(async () => ({ default: (await editor()).EditorApp }));
     }, [editor]);
+    const CreatorLazy = useMemo(() => {
+        if (editor === undefined)
+            return null;
+        return lazy(async () => {
+            const module = await editor();
+            if (module.CreatorApp === undefined)
+                throw new Error("Editor module does not expose CreatorApp");
+            return { default: module.CreatorApp };
+        });
+    }, [editor]);
     const resolved = useMemo(() => {
         if (multiplayer !== undefined)
             return multiplayer;
@@ -105,6 +115,9 @@ export function GameHost({ playable, gameId, wsUrl, multiplayer, resolveMultipla
         }
         return session;
     }, [playable, resolvedGameId, wsUrl, multiplayer, resolveMultiplayer]);
+    if (creatorOpen && creator !== undefined && CreatorLazy !== null) {
+        return _jsx(Suspense, { fallback: null, children: _jsx(CreatorLazy, { gameId: resolvedGameId, config: creator, onExit: () => onCreatorOpenChange?.(false) }) });
+    }
     if (editorOpen && EditorLazy !== null) {
         return (_jsx(Suspense, { fallback: null, children: _jsx(EditorLazy, { gameId: resolvedGameId, playable: playable, catalogs: playable.editorCatalogs, onExitEditor: () => setEditorOpen(false) }) }));
     }

package/dist/GamePlayerShell.js

@@ -1,25 +1,28 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore, } from "react";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from "react";
 import { createActionStateTracker, toActionStateBindingMap, } from "@jgengine/core/input/actionBindings";
 import { RESERVED_INPUT_ACTIONS } from "./boundActionDispatch.js";
 import { deriveTouchScheme, withTouchCodes, DEFAULT_TOUCH_STYLE } from "@jgengine/core/input/touchScheme";
 import { activeTouchControlsMode } from "@jgengine/core/input/touchControlsMode";
 import { normalizePointerToAxis } from "@jgengine/core/input/pointerAxis";
 import { createGameContext } from "@jgengine/core/runtime/gameContext";
-import { activeActionCodes } from "@jgengine/core/game/controlGate";
+import { localPlayers } from "@jgengine/core/runtime/localPlayers";
+import { actionContextStack, activeActionCodes } from "@jgengine/core/game/controlGate";
 import { useDisplayProfile } from "@jgengine/react/display";
 import { RotateDeviceScreen } from "@jgengine/react/rotateDevice";
 import { createSettingsStore } from "@jgengine/core/settings/settingsModel";
 import { applyBindingOverrides, clearBindingOverride, loadBindingOverrides, saveBindingOverride, } from "@jgengine/core/input/bindingOverrides";
 import { orientationGateActive, orientationHintActive, resolveOrientationRequirement, } from "@jgengine/core/ui/orientation";
+import { devtools } from "@jgengine/core/devtools/devtools";
 import { armFallbackSeams } from "@jgengine/core/devtools/fallbackSeams";
 import { armTextureErrors } from "@jgengine/core/devtools/textureErrors";
 import { readUrlFlag, subscribeUrlChange, writeUrlParam } from "@jgengine/core/devtools/urlFlags";
 import { createAudioEngine } from "./audio/audioEngine.js";
 import { attachAudioEventWire } from "./audio/audioWire.js";
 import { installAgentBridge } from "./devtools/agentBridge.js";
-import { withDevtoolsLatency } from "./devtools/DevtoolsOverlay.js";
-import { resolveRigKind } from "./camera/index.js";
+import { attachPlaytestProbe } from "./devtools/playtestProbe.js";
+import { withDevtoolsLatency } from "./devtools/latencyInstrumentation.js";
+import { resolveRigKind } from "./camera/rigResolve.js";
 import { contextModels } from "./render/resolveModel.js";
 import { OrientationHint } from "./touch/OrientationHint.js";
 import { useTouchStyle, useTouchJoystickVariant, useGraphicsSettings } from "./settings/appliedSettings.js";
@@ -28,10 +31,18 @@ import { EMPTY_RESERVED } from "./shellConstants.js";
 import { JoinGate } from "./JoinGate.js";
 import { useShellMultiplayerSync } from "./useShellMultiplayerSync.js";
 import { ShellHudPresentation } from "./ShellHudPresentation.js";
-import { Shell3dPresentation } from "./Shell3dPresentation.js";
+import { isServerAuthoritative } from "@jgengine/core/runtime/adapter";
+import { playControlsActive } from "@jgengine/core/game/controlGate";
+import { resolveInputSink } from "./inputSink.js";
+import { observableShellTracker, attachShellInputPublication } from "./shellInputPublication.js";
+import { attachShellControlSuspension } from "./shellControlSuspension.js";
+import { LazyShell3dPresentation } from "./lazyShell3dPresentation.js";
+import { createPresentationDiagnosticOwnership, createPlaySurfaceFocusOwnership, PresentationRecovery } from "./presentationRecovery.js";
 const DEV_USER_ID = "dev-player";
 /** The query param that mirrors the devtools overlay into the URL — present = open. */
 const DEBUG_PARAM = "debug";
+const NO_SUBSCRIBE = () => () => undefined;
+const ZERO_VERSION = () => 0;
 export { applyMotionImpulses } from "@jgengine/core/runtime/motionIntents";
 export { nearbyObstacles } from "@jgengine/core/movement/movementModel";
 export { resolvePhysicsTuning } from "@jgengine/core/movement/playerMovement";
@@ -70,8 +81,11 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const posterSettledRef = useRef(false);
     const [ctx, setCtx] = useState(null);
     const [diagnostics, setDiagnostics] = useState([]);
+    const diagnosticSequence = useRef(0);
+    const presentationDiagnostics = useRef(createPresentationDiagnosticOwnership());
     const [remotePlayers, setRemotePlayers] = useState([]);
     const wrapperRef = useRef(null);
+    const recoveredFocus = useRef(createPlaySurfaceFocusOwnership());
     const yawRef = useRef(0);
     const pitchRef = useRef(0);
     const serverIdRef = useRef(null);
@@ -90,7 +104,19 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const effectiveInput = useMemo(() => applyBindingOverrides(playable.game.input ?? {}, bindingOverrides), [playable, bindingOverrides]);
     const rebindAction = useCallback((action, code) => setBindingOverrides(saveBindingOverride(playable.game.name, action, [code])), [playable]);
     const resetActionBinding = useCallback((action) => setBindingOverrides(clearBindingOverride(playable.game.name, action)), [playable]);
-    const tracker = useMemo(() => createActionStateTracker(toActionStateBindingMap(withTouchCodes(ctx === null ? effectiveInput : activeActionCodes(ctx, effectiveInput)))), [ctx, effectiveInput]);
+    const contextStack = ctx === null ? null : actionContextStack(ctx);
+    const contextVersion = useSyncExternalStore(contextStack?.subscribe ?? NO_SUBSCRIBE, contextStack?.version ?? ZERO_VERSION, contextStack?.version ?? ZERO_VERSION);
+    const activeInput = useMemo(() => (ctx === null ? effectiveInput : activeActionCodes(ctx, effectiveInput)), 
+    // contextVersion re-derives the layered map when a context is pushed or popped mid-game.
+    [ctx, effectiveInput, contextVersion]);
+    const activeBindingMap = useMemo(() => toActionStateBindingMap(withTouchCodes(activeInput)), [activeInput]);
+    // One tracker per context, rebound in place so keys held across a context swap stay held.
+    const tracker = useMemo(() => observableShellTracker(createActionStateTracker(activeBindingMap)), [ctx]);
+    const boundMapRef = useRef(activeBindingMap);
+    if (boundMapRef.current !== activeBindingMap) {
+        boundMapRef.current = activeBindingMap;
+        tracker.rebind(activeBindingMap);
+    }
     const graphics = useGraphicsSettings(settingsStore, playable.shadows ?? true, playable.graphics);
     const trackPointerAxis = (event) => {
         const rect = wrapperRef.current?.getBoundingClientRect();
@@ -100,8 +126,10 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     };
     const deactivatePointerAxis = () => {
         const state = pointerAxisRef.current;
-        if (state !== null && state.active)
+        if (state !== null && state.active) {
             pointerAxisRef.current = { ...state, active: false };
+            tracker.notify("discrete");
+        }
     };
     // Reads fresh every render: the ctx-version useSyncExternalStore below re-renders on store
     // writes, so a gameplay setTouchControlsMode("car") swaps the visible control set that frame.
@@ -123,9 +151,31 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
         onCodeUp: (code) => tracker.handleUp(code),
         onAnalog: (values) => {
             analogRef.current = values;
+            tracker.notify("analog");
         },
     }), [tracker]);
+    useLayoutEffect(() => {
+        if (ctx === null)
+            return;
+        return attachShellControlSuspension({
+            ctx, tracker, pointerAxisRef, analogRef, primaryClickRef, cameraDraggingRef, f2HeldRef,
+        });
+    }, [ctx, tracker]);
     const gateRef = useRef(false);
+    useLayoutEffect(() => {
+        if (ctx === null || poster)
+            return;
+        return attachShellInputPublication({
+            ctx, tracker,
+            active: () => !gateRef.current && playControlsActive(ctx),
+            analog: () => analogRef.current,
+            pointer: () => pointerAxisRef.current,
+            sink: () => resolveInputSink({
+                serverAuthoritative: isServerAuthoritative(playable.game.multiplayer) && multiplayer !== null,
+                backend: multiplayer?.backend ?? null, serverId: serverIdRef.current,
+            }),
+        });
+    }, [ctx, tracker, multiplayer, playable, poster]);
     const orientationPlatform = coarsePointer ? "mobile" : "desktop";
     const orientationRequirement = useMemo(() => resolveOrientationRequirement(playable.orientation, orientationPlatform), [playable, orientationPlatform]);
     const liveOrientation = portrait ? "portrait" : "landscape";
@@ -135,6 +185,8 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const orientationGateEl = orientationGate ? (_jsx(RotateDeviceScreen, { requiredOrientation: orientationRequirement.required ?? "landscape", title: orientationRequirement.required === "portrait" ? "Turn your phone upright" : "Turn your phone sideways", description: `${playable.game.name} is built for ${orientationRequirement.required ?? "landscape"} play.` })) : orientationHint && orientationRequirement.preferred !== null ? (_jsx(OrientationHint, { wanted: orientationRequirement.preferred })) : null;
     const audioEngine = useMemo(() => createAudioEngine({
         sounds: playable.audio?.sounds,
+        maxVoices: playable.audio?.maxVoices,
+        voiceOverflow: playable.audio?.voiceOverflow,
         buses: playable.audio?.buses,
         music: playable.audio?.music,
         musicBus: playable.audio?.musicBus,
@@ -170,10 +222,59 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const userId = multiplayer?.userId ?? DEV_USER_ID;
     const reportRuntimeError = (error, phase, componentStack) => {
         const diagnostic = logRuntimeError(error, phase, componentStack);
-        setDiagnostics((current) => [...current.slice(-4), { ...diagnostic, id: Date.now() + current.length }]);
+        const id = ++diagnosticSequence.current;
+        presentationDiagnostics.current.register(error, id, phase);
+        setDiagnostics((current) => [...current.slice(-4), { ...diagnostic, id }]);
+    };
+    const recoveryTrace = useRef([]);
+    const traceRecovery = (event) => {
+        if (!devtoolsEnabled)
+            return;
+        const wrapper = wrapperRef.current;
+        const active = document.activeElement;
+        const rect = wrapper?.getBoundingClientRect();
+        recoveryTrace.current.push({ ...event, at: performance.now(), connected: wrapper?.isConnected ?? false,
+            rects: wrapper?.getClientRects().length ?? 0, width: rect?.width ?? null, height: rect?.height ?? null,
+            display: wrapper === null ? null : getComputedStyle(wrapper).display,
+            active: active?.tagName ?? null, ownsFocus: active === wrapper, focusInside: wrapper?.contains(active) ?? false });
+    };
+    useEffect(() => {
+        recoveryTrace.current = [];
+        if (!devtoolsEnabled)
+            return;
+        return devtools.probes.register("presentationRecovery", () => recoveryTrace.current);
+    }, [ctx, devtoolsEnabled]);
+    const revealRecoveredPresentation = () => {
+        if (ctx === null)
+            return;
+        traceRecovery({ phase: "shell-reveal-layout" });
+        recoveredFocus.current.reveal(ctx, wrapperRef.current, document.activeElement, document.body);
+        traceRecovery({ phase: "shell-focus-result" });
+    };
+    const retireRecoveredPresentation = (error) => {
+        traceRecovery({ phase: "shell-recovered-callback" });
+        const owned = presentationDiagnostics.current.recovered(error);
+        setDiagnostics((current) => current.filter((diagnostic) => !owned.has(diagnostic.id)));
+        if (ctx !== null)
+            recoveredFocus.current.request(ctx);
+        revealRecoveredPresentation();
     };
     useEffect(() => {
         setDiagnostics([]);
+        let detachProbe = () => { };
+        let ownedContext = null;
+        const disposeOwnedContext = () => {
+            const context = ownedContext;
+            ownedContext = null;
+            if (context === null)
+                return;
+            try {
+                playable.loop.onDispose(context);
+            }
+            catch (error) {
+                reportRuntimeError(error, "dispose");
+            }
+        };
         try {
             const models = contextModels(playable);
             const context = createGameContext({
@@ -182,17 +283,31 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
                 player: { userId, isNew: true },
                 ...(models === undefined ? {} : { models }),
             });
+            ownedContext = context;
+            if (playable.localPlayers !== undefined)
+                localPlayers(context).retune(playable.localPlayers);
             playable.loop.onInit(context);
             playable.loop.onNewPlayer(context);
             onContextReady?.(context);
+            const probe = playable.capture?.probe;
+            if (probe !== undefined && typeof window !== "undefined") {
+                detachProbe = attachPlaytestProbe(window, () => probe(context));
+            }
             setCtx(context);
         }
         catch (error) {
+            disposeOwnedContext();
             reportRuntimeError(error, "init");
             setCtx(null);
         }
         return () => {
-            setCtx(null);
+            try {
+                detachProbe();
+            }
+            finally {
+                disposeOwnedContext();
+                setCtx(null);
+            }
         };
     }, [playable, userId]);
     const authoritativeFrameRef = useRef(null);
@@ -224,7 +339,7 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
         touchSink,
         touchJoystickVariant,
         analogRef,
-        inputBindings: effectiveInput,
+        inputBindings: activeInput,
         orientationGate,
         orientationGateEl,
         coarsePointer,
@@ -237,12 +352,12 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
         deactivatePointerAxis,
     };
     if (rigKind === "none" || playable.presentation === "hud") {
-        return (_jsx(ShellHudPresentation, { ...shared, uiScale: graphics.uiScale, onPointerResumeAudio: () => audioEngine.resume() }));
+        return (_jsx(PresentationRecovery, { ctx: ctx, onRuntimeError: reportRuntimeError, onRetryCommitted: () => wrapperRef.current?.focus({ preventScroll: true }), onRecoveredDraw: retireRecoveredPresentation, onRecoveryEvent: traceRecovery, children: _jsx(ShellHudPresentation, { ...shared, serverIdRef: serverIdRef, uiScale: graphics.uiScale, onPointerResumeAudio: () => audioEngine.resume(), settingsStore: settingsStore, bindingOverrides: bindingOverrides, rebindAction: rebindAction, resetActionBinding: resetActionBinding, audioEngine: audioEngine, poster: poster }) }));
     }
-    return (_jsx(Shell3dPresentation, { ...shared, primaryClickRef: primaryClickRef, cameraDraggingRef: cameraDraggingRef, serverIdRef: serverIdRef, remotePlayers: remotePlayers, touchStyle: touchStyle, compact: compact, graphics: graphics, settingsStore: settingsStore, bindingOverrides: bindingOverrides, rebindAction: rebindAction, resetActionBinding: resetActionBinding, audioEngine: audioEngine, poster: poster, posterFrozen: posterFrozen, onPosterSettled: () => {
-            if (posterSettledRef.current)
-                return;
-            posterSettledRef.current = true;
-            setPosterFrozen(true);
-        }, authoritativeFrameRef: authoritativeFrameRef }));
+    return (_jsx(PresentationRecovery, { ctx: ctx, onRuntimeError: reportRuntimeError, onRetryCommitted: () => wrapperRef.current?.focus({ preventScroll: true }), onRecoveredDraw: retireRecoveredPresentation, onRecoveryEvent: traceRecovery, children: _jsx(LazyShell3dPresentation, { ...shared, onPresentationReveal: revealRecoveredPresentation, primaryClickRef: primaryClickRef, cameraDraggingRef: cameraDraggingRef, serverIdRef: serverIdRef, remotePlayers: remotePlayers, touchStyle: touchStyle, compact: compact, graphics: graphics, settingsStore: settingsStore, bindingOverrides: bindingOverrides, rebindAction: rebindAction, resetActionBinding: resetActionBinding, audioEngine: audioEngine, poster: poster, posterFrozen: posterFrozen, onPosterSettled: () => {
+                if (posterSettledRef.current)
+                    return;
+                posterSettledRef.current = true;
+                setPosterFrozen(true);
+            }, authoritativeFrameRef: authoritativeFrameRef }) }));
 }

package/dist/Shell3dPresentation.d.ts

@@ -1,10 +1,9 @@
 import { type Dispatch, type MutableRefObject, type RefObject, type SetStateAction } from "react";
 import type { PointerAxisState } from "@jgengine/core/input/pointerAxis";
-import type { ActionStateTracker } from "@jgengine/core/input/actionBindings";
+import type { observableShellTracker } from "./shellInputPublication.js";
 import type { BindingOverrides } from "@jgengine/core/input/bindingOverrides";
 import type { TouchJoystickVariant, TouchScheme, TouchStyle } from "@jgengine/core/input/touchScheme";
-import type { GraphicsProfile } from "@jgengine/core/settings/graphicsProfile";
-import { type GraphicsQuality, type SettingsStore } from "@jgengine/core/settings/settingsModel";
+import { type SettingsStore } from "@jgengine/core/settings/settingsModel";
 import type { PresencePoseRow } from "@jgengine/core/runtime/transport";
 import type { GameContext } from "@jgengine/core/runtime/gameContext";
 import type { AudioEngine } from "./audio/audioEngine.js";
@@ -12,13 +11,14 @@ import type { ShellMultiplayer } from "./multiplayer.js";
 import type { PlayableGame } from "./registry.js";
 import type { AuthoritativeFrameHandler } from "./worldSync.js";
 import { type TouchCodeSink } from "./touch/TouchControlsOverlay.js";
+import { type AppliedGraphicsSettings } from "./settings/appliedSettings.js";
 import type { RuntimeDiagnostic } from "./diagnostics/RuntimeDiagnostics.js";
 /** 3D play surface: canvas, world overlays, and shared chrome. @internal */
 export declare function Shell3dPresentation({ playable, ctx, multiplayer, tracker, pointerAxisRef, gateRef, wrapperRef, f2HeldRef, yawRef, pitchRef, primaryClickRef, cameraDraggingRef, serverIdRef, remotePlayers, touchScheme, touchSink, touchStyle, touchJoystickVariant, analogRef, inputBindings, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, authoritativeFrameRef, }: {
     playable: PlayableGame;
     ctx: GameContext;
     multiplayer: ShellMultiplayer | null;
-    tracker: ActionStateTracker<string>;
+    tracker: ReturnType<typeof observableShellTracker>;
     pointerAxisRef: MutableRefObject<PointerAxisState | null>;
     gateRef: MutableRefObject<boolean>;
     wrapperRef: RefObject<HTMLDivElement | null>;
@@ -39,13 +39,7 @@ export declare function Shell3dPresentation({ playable, ctx, multiplayer, tracke
     orientationGateEl: React.ReactNode;
     coarsePointer: boolean;
     compact: boolean;
-    graphics: {
-        shadows: boolean;
-        dpr: number;
-        uiScale: number;
-        quality: GraphicsQuality;
-        profile: GraphicsProfile;
-    };
+    graphics: AppliedGraphicsSettings;
     settingsStore: SettingsStore;
     bindingOverrides: BindingOverrides;
     rebindAction: (action: string, code: string) => void;

package/dist/Shell3dPresentation.js

@@ -1,6 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Canvas } from "@react-three/fiber";
-import { useMemo, useRef, useState, } from "react";
+import { useMemo, useEffect, useRef, useState, useSyncExternalStore, } from "react";
 import { useFrame, useThree } from "@react-three/fiber";
 import { contextVerbInput, } from "@jgengine/core/interaction/contextMenu";
 import { createSelectionSet, isMarquee, screenRect, selectWithinRect, } from "@jgengine/core/scene/selection";
@@ -15,7 +15,9 @@ import { GameViewportProvider } from "@jgengine/react/gameViewport";
 import { GameProvider } from "@jgengine/react/provider";
 import { SettingsProvider } from "@jgengine/react/settings";
 import { resolveWorldSky } from "./worldSky.js";
+import { resolveRuntimeCameraConfig } from "./camera/rigResolve.js";
 import { pointerAimFor, pointerContextMenu } from "./shellPointer.js";
+import { shellPointerInput } from "./shellPointerInput.js";
 import { AudioListener, EntityAudioEmitters, ObjectAudioEmitters } from "./audio/AudioComponents.js";
 import { PostProcessing } from "./postfx/PostProcessing.js";
 import { EnvironmentLighting } from "./render/EnvironmentLighting.js";
@@ -23,7 +25,9 @@ import { CollisionDebugWorld } from "./devtools/CollisionDebugWorld.js";
 import { DevtoolsRendererProbe } from "./devtools/DevtoolsOverlay.js";
 import { CAMERA_TRANSPARENT_USERDATA, GameCameraRig, PlayerFovProvider, PlayerFovSlider, resolveRigKind, rtsPanKeysConflict, } from "./camera/index.js";
 import { CullingProvider } from "./visibility/CullingProvider.js";
+import { BuildingRenderBudget } from "./structures/BuildingRenderBudget.js";
 import { SkyDaylight, TimeOfDayDaylight } from "./environment.js";
+import { bearingFromDirection } from "./environment/daylightCycle.js";
 import { resolveSkyLightOwnership, skyEmitsLights } from "./environment/skyLightingPolicy.js";
 import { EnvironmentScene } from "./environment/EnvironmentScene.js";
 import { PointerProbe } from "./pointer/PointerProbe.js";
@@ -37,10 +41,15 @@ import { TouchControlsDock, TouchPlaySurface, touchDockClearance } from "./touch
 import { SettingsRuntime } from "./settings/SettingsRuntime.js";
 import { SettingsChrome } from "./settings/SettingsChrome.js";
 import { AudioSettingsBridge } from "./settings/appliedSettings.js";
+import { TextureFiltering } from "./render/TextureFiltering.js";
+import { FrameRateLimiter } from "./drivers/FrameRateLimiter.js";
+import { FpsCounter, FpsProbe } from "./diagnostics/FpsCounter.js";
 import { ConfiguredLighting, BackdropFog } from "./render/SceneLighting.js";
 import { WorldView, RemotePlayers } from "./world/WorldScene.js";
 import { FrameDriver } from "./drivers/FrameDriver.js";
 import { GamepadSource } from "./input/gamepadSource.js";
+import { SplitScreenRenderer, useSeatViewports } from "./camera/Viewports.js";
+import { localPlayers } from "@jgengine/core/runtime/localPlayers";
 import { createShellKeyHandlers, ShellDebugOverlays, ShellGameUiChrome } from "./ShellChrome.js";
 import { CombatPresentation } from "./CombatPresentation.js";
 import { WorldParticles } from "./world/WorldParticles.js";
@@ -70,16 +79,19 @@ function PixelPerfectCamera({ pixelsPerUnit, integerScale }) {
 export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, pointerAxisRef, gateRef, wrapperRef, f2HeldRef, yawRef, pitchRef, primaryClickRef, cameraDraggingRef, serverIdRef, remotePlayers, touchScheme, touchSink, touchStyle, touchJoystickVariant, analogRef, inputBindings, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, authoritativeFrameRef, }) {
     const GameUI = playable.GameUI;
     const ktx2SupportDetected = useRef(false);
+    const frameTally = useRef({ frames: 0 }).current;
     const WorldOverlay = playable.WorldOverlay;
     const pointerService = useMemo(() => createPointerService(), []);
     const selection = useMemo(() => createSelectionSet(), [playable]);
     const controlledEntityId = ctx.player.possession.active(ctx.player.userId);
-    const cameraConfig = playable.camera?.followEntityId !== undefined
+    const cameraOverride = useSyncExternalStore(ctx.camera.subscribe, ctx.camera.rig, ctx.camera.rig);
+    const configuredCamera = playable.camera?.followEntityId !== undefined
         ? playable.camera
         : { ...playable.camera, followEntityId: controlledEntityId };
+    const cameraConfig = resolveRuntimeCameraConfig(configuredCamera, cameraOverride);
     const rigKind = resolveRigKind(cameraConfig);
     const firstPerson = rigKind === "first";
-    const showReticle = (firstPerson && playable.camera?.firstPerson?.reticle !== false) || rigKind === "shoulder";
+    const showReticle = (firstPerson && cameraConfig?.firstPerson?.reticle !== false) || rigKind === "shoulder";
     const rtsPanKeysEnabled = !rtsPanKeysConflict(playable.game.input);
     const bars = resolveWorldOverlayBars(playable.worldHealthBars);
     const nameplates = resolveWorldOverlayBars(playable.nameplates);
@@ -109,9 +121,13 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
     const cinematicLook = (playable.look ?? "cinematic") !== "flat";
     const backdrop = resolvedLook.backdrop;
     const backdropSky = backdrop?.sky !== undefined ? resolveSkyDescriptor(backdrop.sky) : undefined;
-    const effectiveSky = backdropSky ?? worldSky;
-    const backgroundColor = backdrop?.background ?? (effectiveSky === undefined ? DEFAULT_BACKGROUND_COLOR : undefined);
+    const authoredSky = backdropSky ?? worldSky;
     const lighting = resolvedLook.lighting;
+    const sunFromLighting = lighting?.directional?.[0]?.position;
+    const effectiveSky = useMemo(() => authoredSky === undefined || authoredSky.sun !== undefined || authoredSky.timeOfDay || sunFromLighting === undefined
+        ? authoredSky
+        : { ...authoredSky, sun: bearingFromDirection(sunFromLighting) }, [authoredSky, sunFromLighting]);
+    const backgroundColor = backdrop?.background ?? (effectiveSky === undefined ? DEFAULT_BACKGROUND_COLOR : undefined);
     const orthographic = playable.camera?.projection === "orthographic";
     const pointerDownRef = useRef(null);
     const marqueeStartRef = useRef(null);
@@ -141,7 +157,36 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
     };
     /** DOM UI sits in the same wrapper as the canvas — only canvas-targeted clicks are world input. */
     const isWorldPointerTarget = (event) => event.target instanceof HTMLCanvasElement;
+    const pointerInput = useMemo(() => shellPointerInput(tracker, () => playControlsActive(ctx)), [tracker, ctx]);
+    useEffect(() => {
+        const clearGesture = () => { pointerDownRef.current = null; marqueeStartRef.current = null; setMarquee(null); };
+        const up = (event) => {
+            pointerInput.up(event);
+            if (!(event.target instanceof Node) || !wrapperRef.current?.contains(event.target))
+                clearGesture();
+        };
+        const cancel = (event) => { pointerInput.cancel(event.pointerId); clearGesture(); };
+        const retire = () => { pointerInput.cancel(); clearGesture(); };
+        const blur = () => { tracker.reset(); retire(); };
+        const move = (event) => { pointerInput.move(event, false); };
+        const detachReset = pointerInput.attachReset(tracker, clearGesture);
+        window.addEventListener("pointerup", up);
+        window.addEventListener("pointermove", move);
+        window.addEventListener("pointercancel", cancel);
+        window.addEventListener("blur", blur);
+        return () => {
+            window.removeEventListener("pointerup", up);
+            window.removeEventListener("pointermove", move);
+            window.removeEventListener("pointercancel", cancel);
+            window.removeEventListener("blur", blur);
+            detachReset();
+            pointerInput.cancel();
+        };
+    }, [pointerInput, tracker]);
     const handlePointerDown = (event) => {
+        pointerInput.down(event, isWorldPointerTarget(event));
+        if (!playControlsActive(ctx))
+            return;
         if (isWorldPointerTarget(event))
             wrapperRef.current?.focus();
         trackPointerAxis(event);
@@ -156,6 +201,7 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
         }
     };
     const handlePointerMove = (event) => {
+        pointerInput.move(event, isWorldPointerTarget(event));
         trackPointerAxis(event);
         if (pointer?.select !== true)
             return;
@@ -166,6 +212,13 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
         setMarquee(screenRect(start.x, start.y, point.x, point.y));
     };
     const handlePointerUp = (event) => {
+        const boundPointer = pointerInput.up(event);
+        if (!playControlsActive(ctx)) {
+            pointerDownRef.current = null;
+            marqueeStartRef.current = null;
+            setMarquee(null);
+            return;
+        }
         if (event.button !== 0 || pointerDownRef.current === null)
             return;
         const start = pointerDownRef.current;
@@ -216,7 +269,7 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
             return;
         }
         const moved = (end.x - start.x) ** 2 + (end.y - start.y) ** 2;
-        if (moved <= PRIMARY_CLICK_MOVE_THRESHOLD_PX * PRIMARY_CLICK_MOVE_THRESHOLD_PX)
+        if (!boundPointer && moved <= PRIMARY_CLICK_MOVE_THRESHOLD_PX * PRIMARY_CLICK_MOVE_THRESHOLD_PX)
             primaryClickRef.current = true;
     };
     const handleContextMenu = (event) => {
@@ -258,6 +311,8 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
         }
     };
     const controlsActive = playControlsActive(ctx);
+    const seatViewports = useSeatViewports(ctx, playable.viewports);
+    const splitScreen = playable.viewports !== undefined && seatViewports.length > 1;
     const settingsDisabled = playable.settings === false;
     const settingsConfig = playable.settings === false || playable.settings === undefined ? {} : playable.settings;
     const settingsSurface = settingsDisabled ? false : settingsConfig.surface ?? false;
@@ -289,7 +344,7 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
         controlsActive: () => playControlsActive(ctx),
         exitPointerLockOnDevtools: true,
     });
-    return (_jsx(SettingsProvider, { store: settingsStore, children: _jsxs(PlayerFovProvider, { config: playable.camera, orthographic: orthographic, children: [_jsx(AudioSettingsBridge, { store: settingsStore, engine: audioEngine, buses: playable.audio?.buses }), _jsx(SettingsRuntime, { variant: settingsVariant, surface: settingsSurface, actions: settingsActions, input: playable.game.input ?? {}, buses: playable.audio?.buses, extra: settingsConfig.extra ?? [], categories: settingsConfig.categories ?? [], hide: hideCategories, fovEnabled: fovControlEnabled, hideBindings: settingsConfig.hideBindings ?? [], touchStyle: coarsePointer &&
+    return (_jsx(SettingsProvider, { store: settingsStore, children: _jsxs(PlayerFovProvider, { config: playable.camera, orthographic: orthographic, children: [_jsx(AudioSettingsBridge, { store: settingsStore, engine: audioEngine, buses: playable.audio?.buses }), _jsx(SettingsRuntime, { variant: settingsVariant, surface: settingsSurface, actions: settingsActions, input: playable.game.input ?? {}, buses: playable.audio?.buses, extra: settingsConfig.extra ?? [], categories: settingsConfig.categories ?? [], hide: hideCategories, fovEnabled: fovControlEnabled, graphics: playable.graphics, hideBindings: settingsConfig.hideBindings ?? [], touchStyle: coarsePointer &&
                         touchScheme !== null &&
                         (touchScheme.joystick !== null || touchScheme.buttons.length > 0), overrides: bindingOverrides, rebind: rebindAction, resetBinding: resetActionBinding, children: _jsx("div", { ref: wrapperRef, tabIndex: 0, ...(poster && posterFrozen ? { "data-poster-ready": "" } : {}), className: "relative h-full w-full bg-neutral-950 outline-none", style: {
                             "--jg-hud-dock-clearance": `${dockMounted ? touchDockClearance(touchScheme, touchScale) : 0}px`,
@@ -308,7 +363,7 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
                                             return;
                                         ktx2SupportDetected.current = true;
                                         detectKtx2Support(gl);
-                                    }, frameloop: poster && posterFrozen ? "demand" : "always", orthographic: orthographic, camera: orthographic
+                                    }, frameloop: poster && posterFrozen ? "demand" : graphics.frameRateLimit > 0 && !poster ? "never" : "always", orthographic: orthographic, camera: orthographic
                                         ? {
                                             zoom: playable.camera?.frustum?.zoom ?? CAMERA_FRUSTUM_DEFAULTS.zoom,
                                             near: playable.camera?.frustum?.near ?? CAMERA_FRUSTUM_DEFAULTS.near,
@@ -318,9 +373,16 @@ export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, point
                                             fov: playable.camera?.frustum?.fov ?? CAMERA_FRUSTUM_DEFAULTS.fov,
                                             near: playable.camera?.frustum?.near ?? CAMERA_FRUSTUM_DEFAULTS.near,
                                             far: playable.camera?.frustum?.far ?? CAMERA_FRUSTUM_DEFAULTS.far,
-                                        }, shadows: graphics.shadows, dpr: [Math.min(1, graphics.dpr), graphics.dpr], gl: { preserveDrawingBuffer: true }, style: { touchAction: "none" }, children: [orthographic && playable.camera?.pixelPerfect !== undefined ? (_jsx(PixelPerfectCamera, { ...playable.camera.pixelPerfect })) : null, backgroundColor !== undefined ? _jsx("color", { attach: "background", args: [backgroundColor] }) : null, cinematicLook ? (_jsx(EnvironmentLighting, { source: playable.environmentSource, skyColor: lighting?.hemisphere?.skyColor ?? "#87b5e0", groundColor: lighting?.hemisphere?.groundColor ?? "#3d4a38", sunDirection: lighting?.directional?.[0]?.position, sunColor: lighting?.directional?.[0]?.color ?? "#fff2d6" })) : null, lighting !== undefined ? (_jsx(ConfiguredLighting, { lighting: lighting, profile: graphics.profile })) : effectiveSky === undefined ? (_jsxs(_Fragment, { children: [_jsx("ambientLight", { intensity: 0.55 }), _jsx("directionalLight", { position: [10, 16, 6], intensity: 1.3 })] })) : null, effectiveSky !== undefined ? (effectiveSky.timeOfDay ? (_jsx(TimeOfDayDaylight, { sky: effectiveSky, clock: ctx.time, bands: effectiveSky === worldSky ? biomeBands : undefined, lights: skyEmitsLights(resolveSkyLightOwnership(lighting !== undefined)) })) : (_jsx(SkyDaylight, { sky: effectiveSky, bands: effectiveSky === worldSky ? biomeBands : undefined, lights: skyEmitsLights(resolveSkyLightOwnership(lighting !== undefined)) }))) : null, _jsx(BackdropFog, { fog: backdrop?.fog }), _jsxs(GameProvider, { context: ctx, children: [_jsx(CullingProvider, { config: playable.visibility, drawDistance: graphics.profile.drawDistance, children: _jsx(WorldView, { entitySprites: playable.entitySprites, entityModels: playable.entityModels, objectModels: playable.objectModels, objectStyles: playable.objectStyles, environment: AutoEnvironment, assets: playable.game.assets, renderEntity: playable.renderEntity, renderObject: playable.renderObject, selectedIds: selectedIds, hideLocalActor: firstPerson }) }), WorldOverlay !== undefined ? (_jsx("group", { userData: CAMERA_TRANSPARENT_USERDATA, children: _jsx(WorldOverlay, { ctx: ctx }) })) : null, bars !== null ? (_jsx(WorldEntityBars, { statId: bars.statId, roles: bars.roles, resolveRole: resolveEntityRole, ...(bars.maxDistance === undefined ? {} : { maxDistance: bars.maxDistance }), ...(bars.occlude === undefined ? {} : { occlude: bars.occlude }) })) : null, nameplates !== null ? (_jsx(WorldNameplates, { statId: nameplates.statId, roles: nameplates.roles, resolveRole: resolveEntityRole, ...(nameplates.maxDistance === undefined ? {} : { maxDistance: nameplates.maxDistance }), ...(nameplates.showHealth === undefined ? {} : { showHealth: nameplates.showHealth }) })) : null, _jsx(WorldItems, { config: playable.worldItem }), _jsx(WorldParticles, { quality: graphics.quality, particleCap: graphics.profile.particleCap }), _jsx(CombatPresentation, { effects: effects }), devtoolsEnabled ? _jsx(CollisionDebugWorld, {}) : null, _jsx(AudioListener, { engine: audioEngine }), _jsx(EntityAudioEmitters, { engine: audioEngine, entitySounds: playable.entitySounds }), _jsx(ObjectAudioEmitters, { engine: audioEngine, objectSounds: playable.objectSounds }), _jsx(GameCameraRig, { yawRef: yawRef, pitchRef: pitchRef, config: cameraConfig, viewmodel: playable.viewmodel, pointerControls: pointerUsesLeft, panKeysEnabled: rtsPanKeysEnabled, director: ctx.camera, onDragChange: (dragging) => {
-                                                        cameraDraggingRef.current = dragging;
-                                                    } }), _jsx(PointerProbe, { service: pointerService })] }), _jsx(RemotePlayers, { rows: remotePlayers }), _jsx(FrameDriver, { ctx: ctx, playable: playable, tracker: tracker, yawRef: yawRef, pitchRef: pitchRef, primaryClickRef: primaryClickRef, pointerAxisRef: pointerAxisRef, analogRef: analogRef, gateRef: gateRef, onRuntimeError: reportRuntimeError, multiplayer: multiplayer, serverIdRef: serverIdRef, pointerService: pointerService, pointerAim: pointer?.aim === true, pingCommand: pointer?.pingCommand, poster: poster, onPosterSettled: onPosterSettled, authoritativeFrameRef: authoritativeFrameRef }), _jsx(GamepadSource, { tracker: tracker, bindings: inputBindings ?? {}, analogRef: analogRef, input: ctx.input }), _jsx(DevtoolsRendererProbe, {}), resolvedLook.postProcessing !== undefined && resolvedLook.postProcessing.enabled !== false ? (_jsx(PostProcessing, { config: resolvedLook.postProcessing, quality: graphics.quality, stages: graphics.profile.postStages })) : null] }), !poster &&
+                                        }, shadows: graphics.shadows, dpr: [Math.min(1, graphics.dpr), graphics.dpr], gl: { preserveDrawingBuffer: true, powerPreference: "high-performance" }, style: { touchAction: "none" }, children: [_jsx(TextureFiltering, { anisotropy: graphics.profile.anisotropy }), graphics.frameRateLimit > 0 && !poster ? _jsx(FrameRateLimiter, { fps: graphics.frameRateLimit }) : null, graphics.showFps ? _jsx(FpsProbe, { tally: frameTally }) : null, orthographic && playable.camera?.pixelPerfect !== undefined ? (_jsx(PixelPerfectCamera, { ...playable.camera.pixelPerfect })) : null, backgroundColor !== undefined ? _jsx("color", { attach: "background", args: [backgroundColor] }) : null, cinematicLook ? (_jsx(EnvironmentLighting, { source: playable.environmentSource, skyColor: lighting?.hemisphere?.skyColor ?? "#87b5e0", groundColor: lighting?.hemisphere?.groundColor ?? "#3d4a38", sunDirection: lighting?.directional?.[0]?.position, sunColor: lighting?.directional?.[0]?.color ?? "#fff2d6" })) : null, lighting !== undefined ? (_jsx(ConfiguredLighting, { lighting: lighting, profile: graphics.profile })) : effectiveSky === undefined ? (_jsxs(_Fragment, { children: [_jsx("ambientLight", { intensity: 0.55 }), _jsx("directionalLight", { position: [10, 16, 6], intensity: 1.3 })] })) : null, effectiveSky !== undefined ? (effectiveSky.timeOfDay ? (_jsx(TimeOfDayDaylight, { sky: effectiveSky, clock: ctx.time, bands: effectiveSky === worldSky ? biomeBands : undefined, lights: skyEmitsLights(resolveSkyLightOwnership(lighting !== undefined)) })) : (_jsx(SkyDaylight, { sky: effectiveSky, bands: effectiveSky === worldSky ? biomeBands : undefined, lights: skyEmitsLights(resolveSkyLightOwnership(lighting !== undefined)) }))) : null, _jsx(BackdropFog, { fog: backdrop?.fog }), _jsx(GameProvider, { context: ctx, children: _jsxs(BuildingRenderBudget, { drawDistance: graphics.profile.drawDistance, visibility: playable.visibility, cullingDisabled: splitScreen, children: [_jsxs(CullingProvider, { config: playable.visibility, drawDistance: graphics.profile.drawDistance, children: [_jsx(WorldView, { entitySprites: playable.entitySprites, entityModels: playable.entityModels, objectModels: playable.objectModels, objectStyles: playable.objectStyles, environment: AutoEnvironment, assets: playable.game.assets, renderEntity: playable.renderEntity, renderObject: playable.renderObject, selectedIds: selectedIds, hideLocalActor: firstPerson, editorLayers: playable.editorLayers }), bars !== null ? (_jsx(WorldEntityBars, { statId: bars.statId, roles: bars.roles, resolveRole: resolveEntityRole, ...(bars.maxSamples === undefined ? {} : { maxSamples: bars.maxSamples }), ...(bars.tickMs === undefined ? {} : { tickMs: bars.tickMs }), ...(bars.maxDistance === undefined ? {} : { maxDistance: bars.maxDistance }), ...(bars.occlude === undefined ? {} : { occlude: bars.occlude }) })) : null, nameplates !== null ? (_jsx(WorldNameplates, { statId: nameplates.statId, roles: nameplates.roles, resolveRole: resolveEntityRole, ...(nameplates.maxSamples === undefined ? {} : { maxSamples: nameplates.maxSamples }), ...(nameplates.tickMs === undefined ? {} : { tickMs: nameplates.tickMs }), ...(nameplates.maxDistance === undefined ? {} : { maxDistance: nameplates.maxDistance }), occlude: nameplates.occlude, ...(nameplates.resolveName === undefined ? {} : { resolveName: nameplates.resolveName }), ...(nameplates.showHealth === undefined ? {} : { showHealth: nameplates.showHealth }) })) : null, WorldOverlay !== undefined ? (_jsx("group", { userData: CAMERA_TRANSPARENT_USERDATA, children: _jsx(WorldOverlay, { ctx: ctx }) })) : null] }), _jsx(WorldItems, { config: playable.worldItem }), _jsx(WorldParticles, { quality: graphics.quality, particleCap: graphics.profile.particleCap, diagnostics: devtoolsEnabled }), _jsx(CombatPresentation, { effects: effects }), devtoolsEnabled ? _jsx(CollisionDebugWorld, {}) : null, _jsx(AudioListener, { engine: audioEngine }), _jsx(EntityAudioEmitters, { engine: audioEngine, entitySounds: playable.entitySounds }), _jsx(ObjectAudioEmitters, { engine: audioEngine, objectSounds: playable.objectSounds }), _jsx(GameCameraRig, { yawRef: yawRef, pitchRef: pitchRef, config: cameraConfig, viewmodel: playable.viewmodel, pointerControls: pointerUsesLeft, panKeysEnabled: rtsPanKeysEnabled, director: ctx.camera, onDragChange: (dragging) => {
+                                                            cameraDraggingRef.current = dragging;
+                                                        } }), _jsx(PointerProbe, { service: pointerService })] }) }), _jsx(RemotePlayers, { rows: remotePlayers }), _jsx(FrameDriver, { ctx: ctx, playable: playable, tracker: tracker, yawRef: yawRef, pitchRef: pitchRef, primaryClickRef: primaryClickRef, pointerAxisRef: pointerAxisRef, analogRef: analogRef, gateRef: gateRef, onRuntimeError: reportRuntimeError, multiplayer: multiplayer, serverIdRef: serverIdRef, pointerService: pointerService, pointerAim: pointer?.aim === true, pingCommand: pointer?.pingCommand, poster: poster, onPosterSettled: onPosterSettled, authoritativeFrameRef: authoritativeFrameRef }), _jsx(GamepadSource, { tracker: tracker, bindings: inputBindings ?? {}, analogRef: analogRef, input: ctx.input, feel: playable.gamepad, seats: localPlayers(ctx), onSeatJoin: (slot) => {
+                                                try {
+                                                    playable.loop.onNewPlayer(ctx, { userId: slot.userId, isNew: true });
+                                                }
+                                                catch (error) {
+                                                    reportRuntimeError(error, "tick");
+                                                }
+                                            }, seatsActive: () => !gateRef.current && playControlsActive(ctx) }), _jsx(DevtoolsRendererProbe, {}), splitScreen ? (_jsx(SplitScreenRenderer, { ctx: ctx, viewports: seatViewports, config: playable.viewports, mainCamera: playable.camera })) : null, !splitScreen && resolvedLook.postProcessing !== undefined && resolvedLook.postProcessing.enabled !== false ? (_jsx(PostProcessing, { config: resolvedLook.postProcessing, quality: graphics.quality, stages: graphics.profile.postStages })) : null] }), graphics.showFps && !poster ? _jsx(FpsCounter, { tally: frameTally }) : null, !poster &&
                                     !orientationGate &&
                                     coarsePointer &&
                                     controlsActive &&

package/dist/ShellChrome.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentType } from "react";
+import { type ComponentType } from "react";
 import type { GameContext } from "@jgengine/core/runtime/gameContext";
 import { type RuntimeDiagnostic } from "./diagnostics/RuntimeDiagnostics.js";
 import type { ShellMultiplayer } from "./multiplayer.js";
@@ -27,6 +27,7 @@ export type ShellKeyHandlers = {
     onKeyDown: (event: {
         code: string;
         target?: EventTarget | null;
+        defaultPrevented?: boolean;
         preventDefault: () => void;
     }) => void;
     onKeyUp: (event: {