@jgengine/shell 0.14.0 → 0.15.0-next.0

package/dist/GamePlayerShell.js

@@ -3,6 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore
 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 { useDisplayProfile } from "@jgengine/react/display";
@@ -11,6 +12,7 @@ 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 { 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";
@@ -19,7 +21,7 @@ import { withDevtoolsLatency } from "./devtools/DevtoolsOverlay.js";
 import { resolveRigKind } from "./camera/index.js";
 import { contextModels } from "./render/resolveModel.js";
 import { OrientationHint } from "./touch/OrientationHint.js";
-import { useTouchStyle, useGraphicsSettings } from "./settings/appliedSettings.js";
+import { useTouchStyle, useTouchJoystickVariant, useGraphicsSettings } from "./settings/appliedSettings.js";
 import { logRuntimeError, } from "./diagnostics/RuntimeDiagnostics.js";
 import { EMPTY_RESERVED } from "./shellConstants.js";
 import { useShellMultiplayerSync } from "./useShellMultiplayerSync.js";
@@ -41,6 +43,7 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const multiplayer = useMemo(() => (rawMultiplayer === null ? null : withDevtoolsLatency(rawMultiplayer)), [rawMultiplayer]);
     const devtoolsEnabled = playable.devtools !== false && !poster;
     armFallbackSeams(devtoolsEnabled);
+    armTextureErrors(devtoolsEnabled);
     // `?debug` mirrors the devtools overlay into the URL: open with a link, strip the param to close.
     const [devtoolsOpen, setDevtoolsOpen] = useState(() => devtoolsEnabled && readUrlFlag(DEBUG_PARAM));
     const devtoolsOpenRef = useRef(false);
@@ -76,9 +79,12 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
     const f2HeldRef = useRef(false);
     const settingsStore = useMemo(() => createSettingsStore(), []);
     const [bindingOverrides, setBindingOverrides] = useState(() => loadBindingOverrides(playable.game.name));
-    useEffect(() => {
+    // Render-time reset (no stale-keybinds frame): reload persisted overrides once per playable change.
+    const [overridesPlayable, setOverridesPlayable] = useState(playable);
+    if (overridesPlayable !== playable) {
+        setOverridesPlayable(playable);
         setBindingOverrides(loadBindingOverrides(playable.game.name));
-    }, [playable]);
+    }
     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]);
@@ -95,16 +101,28 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
         if (state !== null && state.active)
             pointerAxisRef.current = { ...state, active: false };
     };
+    // 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.
+    const touchMode = ctx === null ? null : activeTouchControlsMode(ctx);
     const touchScheme = useMemo(() => deriveTouchScheme(playable.game.input, {
         reserved: resolveRigKind(playable.camera) === "none" || playable.presentation === "hud"
             ? EMPTY_RESERVED
             : RESERVED_INPUT_ACTIONS,
         firstPerson: resolveRigKind(playable.camera) === "first",
         config: playable.touch,
-    }), [playable]);
+        mode: touchMode,
+    }), [playable, touchMode]);
     const touchStyle = useTouchStyle(settingsStore, touchScheme?.style ?? DEFAULT_TOUCH_STYLE);
+    const touchJoystickVariant = useTouchJoystickVariant(settingsStore);
     const { coarsePointer, portrait, compact } = useDisplayProfile();
-    const touchSink = useMemo(() => ({ onCodeDown: (code) => tracker.handleDown(code), onCodeUp: (code) => tracker.handleUp(code) }), [tracker]);
+    const analogRef = useRef(null);
+    const touchSink = useMemo(() => ({
+        onCodeDown: (code) => tracker.handleDown(code),
+        onCodeUp: (code) => tracker.handleUp(code),
+        onAnalog: (values) => {
+            analogRef.current = values;
+        },
+    }), [tracker]);
     const gateRef = useRef(false);
     const orientationPlatform = coarsePointer ? "mobile" : "desktop";
     const orientationRequirement = useMemo(() => resolveOrientationRequirement(playable.orientation, orientationPlatform), [playable, orientationPlatform]);
@@ -199,6 +217,8 @@ export function GamePlayerShell({ playable, multiplayer: rawMultiplayer = null,
         pitchRef,
         touchScheme,
         touchSink,
+        touchJoystickVariant,
+        analogRef,
         orientationGate,
         orientationGateEl,
         coarsePointer,

package/dist/Shell3dPresentation.d.ts

@@ -2,16 +2,17 @@ import { type Dispatch, type MutableRefObject, type RefObject, type SetStateActi
 import type { PointerAxisState } from "@jgengine/core/input/pointerAxis";
 import type { ActionStateTracker } from "@jgengine/core/input/actionBindings";
 import type { BindingOverrides } from "@jgengine/core/input/bindingOverrides";
-import type { TouchScheme, TouchStyle } from "@jgengine/core/input/touchScheme";
+import type { TouchJoystickVariant, TouchScheme, TouchStyle } from "@jgengine/core/input/touchScheme";
 import { type GraphicsQuality, 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";
 import type { ShellMultiplayer } from "./multiplayer.js";
 import type { PlayableGame } from "./registry.js";
+import { type TouchCodeSink } from "./touch/TouchControlsOverlay.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, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, }: {
+export declare function Shell3dPresentation({ playable, ctx, multiplayer, tracker, pointerAxisRef, gateRef, wrapperRef, f2HeldRef, yawRef, pitchRef, primaryClickRef, cameraDraggingRef, serverIdRef, remotePlayers, touchScheme, touchSink, touchStyle, touchJoystickVariant, analogRef, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, }: {
     playable: PlayableGame;
     ctx: GameContext;
     multiplayer: ShellMultiplayer | null;
@@ -27,11 +28,10 @@ export declare function Shell3dPresentation({ playable, ctx, multiplayer, tracke
     serverIdRef: MutableRefObject<string | null>;
     remotePlayers: PresencePoseRow[];
     touchScheme: TouchScheme | null;
-    touchSink: {
-        onCodeDown: (code: string) => void;
-        onCodeUp: (code: string) => void;
-    };
+    touchSink: TouchCodeSink;
     touchStyle: TouchStyle;
+    touchJoystickVariant: TouchJoystickVariant;
+    analogRef: MutableRefObject<Readonly<Record<string, number>> | null>;
     orientationGate: boolean;
     orientationGateEl: React.ReactNode;
     coarsePointer: boolean;

package/dist/Shell3dPresentation.js

@@ -44,7 +44,7 @@ import { resolvePresentationEffects, resolveWorldOverlayBars, } from "./presenta
 const PRIMARY_CLICK_MOVE_THRESHOLD_PX = 6;
 const DEFAULT_BACKGROUND_COLOR = "#14161b";
 /** 3D play surface: canvas, world overlays, and shared chrome. @internal */
-export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, pointerAxisRef, gateRef, wrapperRef, f2HeldRef, yawRef, pitchRef, primaryClickRef, cameraDraggingRef, serverIdRef, remotePlayers, touchScheme, touchSink, touchStyle, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, }) {
+export function Shell3dPresentation({ playable, ctx, multiplayer, tracker, pointerAxisRef, gateRef, wrapperRef, f2HeldRef, yawRef, pitchRef, primaryClickRef, cameraDraggingRef, serverIdRef, remotePlayers, touchScheme, touchSink, touchStyle, touchJoystickVariant, analogRef, orientationGate, orientationGateEl, coarsePointer, compact, graphics, settingsStore, bindingOverrides, rebindAction, resetActionBinding, diagnostics, devtoolsEnabled, devtoolsOpen, setDevtoolsOpen, reportRuntimeError, trackPointerAxis, deactivatePointerAxis, audioEngine, poster, posterFrozen, onPosterSettled, }) {
     const GameUI = playable.GameUI;
     const WorldOverlay = playable.WorldOverlay;
     const pointerService = useMemo(() => createPointerService(), []);
@@ -289,14 +289,14 @@ 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: [backgroundColor !== undefined ? _jsx("color", { attach: "background", args: [backgroundColor] }) : null, cinematicLook ? _jsx(EnvironmentLighting, {}) : null, lighting !== undefined ? (_jsx(ConfiguredLighting, { lighting: lighting })) : 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, 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 }) })) : 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(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) => {
+                                        }, shadows: graphics.shadows, dpr: [Math.min(1, graphics.dpr), graphics.dpr], gl: { preserveDrawingBuffer: true }, style: { touchAction: "none" }, children: [backgroundColor !== undefined ? _jsx("color", { attach: "background", args: [backgroundColor] }) : null, cinematicLook ? (_jsx(EnvironmentLighting, { 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 })) : 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, 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 }) })) : 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(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, gateRef: gateRef, onRuntimeError: reportRuntimeError, multiplayer: multiplayer, serverIdRef: serverIdRef, pointerService: pointerService, pointerAim: pointer?.aim === true, pingCommand: pointer?.pingCommand, poster: poster, onPosterSettled: onPosterSettled }), _jsx(DevtoolsRendererProbe, {}), resolvedLook.postProcessing !== undefined && resolvedLook.postProcessing.enabled !== false ? (_jsx(PostProcessing, { config: resolvedLook.postProcessing, quality: graphics.quality })) : null] }), !poster &&
+                                                    } }), _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 }), _jsx(DevtoolsRendererProbe, {}), resolvedLook.postProcessing !== undefined && resolvedLook.postProcessing.enabled !== false ? (_jsx(PostProcessing, { config: resolvedLook.postProcessing, quality: graphics.quality })) : null] }), !poster &&
                                     !orientationGate &&
                                     coarsePointer &&
                                     controlsActive &&
                                     touchScheme !== null &&
                                     (touchScheme.gestures !== null || touchScheme.look) ? (_jsx(TouchPlaySurface, { scheme: touchScheme, sink: touchSink, yawRef: yawRef, pitchRef: pitchRef, maxPitch: playable.camera?.firstPerson?.maxPitch ?? 1.45, onPrimaryTap: () => {
                                         primaryClickRef.current = true;
-                                    } })) : null, _jsx(ShellGameUiChrome, { ctx: ctx, playable: playable, GameUI: GameUI, uiScale: graphics.uiScale, orientationGate: orientationGate, onRuntimeError: reportRuntimeError }), !poster && !orientationGate && showReticle ? _jsx(Reticle, {}) : null, dockMounted && touchScheme !== null ? (_jsx(TouchControlsDock, { scheme: touchScheme, sink: touchSink, style: touchStyle, scale: touchScale })) : null, orientationGateEl, marquee !== null ? _jsx(MarqueeBox, { rect: marquee }) : null, contextMenu !== null ? (_jsx(ContextMenuView, { menu: contextMenu.menu, x: contextMenu.x, y: contextMenu.y, onPick: handleVerbPick, onClose: () => setContextMenu(null) })) : null, _jsx(ShellDebugOverlays, { ctx: ctx, playable: playable, multiplayer: multiplayer, diagnostics: diagnostics, devtoolsEnabled: devtoolsEnabled, devtoolsOpen: devtoolsOpen, hideDiagnostics: poster }), poster || orthographic || settingsHostsFov ? null : _jsx(PlayerFovSlider, {}), poster ? null : _jsx(SettingsChrome, {})] }) }) })] }) }));
+                                    } })) : null, _jsx(ShellGameUiChrome, { ctx: ctx, playable: playable, GameUI: GameUI, uiScale: graphics.uiScale, orientationGate: orientationGate, onRuntimeError: reportRuntimeError }), !poster && !orientationGate && showReticle ? _jsx(Reticle, {}) : null, dockMounted && touchScheme !== null ? (_jsx(TouchControlsDock, { scheme: touchScheme, sink: touchSink, style: touchStyle, scale: touchScale, joystickVariant: touchJoystickVariant })) : null, orientationGateEl, marquee !== null ? _jsx(MarqueeBox, { rect: marquee }) : null, contextMenu !== null ? (_jsx(ContextMenuView, { menu: contextMenu.menu, x: contextMenu.x, y: contextMenu.y, onPick: handleVerbPick, onClose: () => setContextMenu(null) })) : null, _jsx(ShellDebugOverlays, { ctx: ctx, playable: playable, multiplayer: multiplayer, diagnostics: diagnostics, devtoolsEnabled: devtoolsEnabled, devtoolsOpen: devtoolsOpen, hideDiagnostics: poster }), poster || orthographic || settingsHostsFov ? null : _jsx(PlayerFovSlider, {}), poster ? null : _jsx(SettingsChrome, {})] }) }) })] }) }));
 }

package/dist/camera/ControllerCameraShake.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+import type { CameraShakeController } from "@jgengine/core/vfx/cameraShake";
+/** Props for {@link ControllerCameraShake}. */
+export interface ControllerCameraShakeProps {
+    /**
+     * The core camera-shake controller to drive and apply. Feed it impacts with
+     * `controller.add(amount, kind?)` from anywhere; this component ticks its decay
+     * and applies the resulting offset to the active camera every frame.
+     */
+    controller: CameraShakeController;
+    /**
+     * `useFrame` priority. Must run AFTER the camera rig has posed the camera this
+     * frame so the shake lands on top of the freshly-set base pose (the rig
+     * overwrites the base each frame, so no manual restore is needed). Default
+     * {@link GAME_SIM_FRAME_PRIORITY} (`0`) which runs after the orbit/rig cameras
+     * (priority `-1`). Keep it `<= 0` so R3F's automatic render is preserved.
+     */
+    priority?: number;
+}
+/**
+ * The shell-side consumer of a core {@link CameraShakeController}: each frame it
+ * calls `controller.update(delta)` to bleed trauma, reads the pooled
+ * `controller.offset()`, and applies it additively to the active camera — a
+ * positional kick plus a pitch/yaw/roll rotation — so the view VISIBLY shakes on
+ * impacts. It runs after the camera rig (which re-poses the camera to its base
+ * every frame), so the shake composes with any rig without a manual save/restore
+ * and without fighting the built-in `shakeChannel`. Renders nothing.
+ *
+ * @capability controller-camera-shake R3F consumer that applies a core camera-shake controller's pooled per-frame offset to the active camera (translation + pitch/yaw/roll) so the view visibly shakes
+ */
+export declare function ControllerCameraShake({ controller, priority, }: ControllerCameraShakeProps): ReactNode;

package/dist/camera/ControllerCameraShake.js

@@ -0,0 +1,34 @@
+import { useFrame, useThree } from "@react-three/fiber";
+import * as THREE from "three";
+import { GAME_SIM_FRAME_PRIORITY } from "./orbitCameraMath.js";
+// Reused scratch objects — never allocate inside the frame loop.
+const shakeEuler = new THREE.Euler();
+const shakeQuat = new THREE.Quaternion();
+/**
+ * The shell-side consumer of a core {@link CameraShakeController}: each frame it
+ * calls `controller.update(delta)` to bleed trauma, reads the pooled
+ * `controller.offset()`, and applies it additively to the active camera — a
+ * positional kick plus a pitch/yaw/roll rotation — so the view VISIBLY shakes on
+ * impacts. It runs after the camera rig (which re-poses the camera to its base
+ * every frame), so the shake composes with any rig without a manual save/restore
+ * and without fighting the built-in `shakeChannel`. Renders nothing.
+ *
+ * @capability controller-camera-shake R3F consumer that applies a core camera-shake controller's pooled per-frame offset to the active camera (translation + pitch/yaw/roll) so the view visibly shakes
+ */
+export function ControllerCameraShake({ controller, priority = GAME_SIM_FRAME_PRIORITY, }) {
+    const camera = useThree((state) => state.camera);
+    useFrame((_, delta) => {
+        controller.update(delta);
+        const offset = controller.offset();
+        // Additive on top of the rig's freshly-set base pose (rig runs at priority -1).
+        camera.position.x += offset.x;
+        camera.position.y += offset.y;
+        camera.position.z += offset.z;
+        if (offset.pitch !== 0 || offset.yaw !== 0 || offset.roll !== 0) {
+            shakeEuler.set(offset.pitch, offset.yaw, offset.roll, "XYZ");
+            shakeQuat.setFromEuler(shakeEuler);
+            camera.quaternion.multiply(shakeQuat);
+        }
+    }, priority);
+    return null;
+}

package/dist/camera/GameCameraRig.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useMemo, useReducer } from "react";
+import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
 import { ChaseRig, CinematicRig, LockOnRig, ObserverRig, RtsRig, ShoulderRig, SideScrollRig, TopDownRig, } from "./cameraRigs.js";
 import { GameFirstPersonCamera } from "./GameFirstPersonCamera.js";
 import { GameInspectionCamera } from "./GameInspectionCamera.js";
@@ -10,12 +10,17 @@ import { CameraShakeContext, createCameraShakeChannel } from "./shakeChannel.js"
 export { resolveRigKind } from "./rigResolve.js";
 export function GameCameraRig({ yawRef, pitchRef, config, onDragChange, pointerControls, panKeysEnabled, director, viewmodel, }) {
     const channel = useMemo(() => createCameraShakeChannel(config?.shake?.decayPerSecond), [config?.shake?.decayPerSecond]);
-    const [, notifyDirectorChange] = useReducer((count) => count + 1, 0);
-    useEffect(() => {
+    const directorVersionRef = useRef(0);
+    const subscribeDirector = useCallback((onStoreChange) => {
         if (director === undefined)
-            return undefined;
-        return director.subscribe(notifyDirectorChange);
+            return () => undefined;
+        return director.subscribe(() => {
+            directorVersionRef.current += 1;
+            onStoreChange();
+        });
     }, [director]);
+    const directorVersion = useCallback(() => directorVersionRef.current, []);
+    useSyncExternalStore(subscribeDirector, directorVersion, directorVersion);
     const directed = resolveDirectedCamera(director === undefined
         ? undefined
         : { followEntityId: director.followedEntityId(), cinematic: director.cinematic() }, { followEntityId: config?.followEntityId, cinematic: config?.cinematic });

package/dist/camera/GameOrbitCamera.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { OrbitControls } from "@react-three/drei";
 import { useFrame, useThree } from "@react-three/fiber";
-import { useEffect, useRef } from "react";
+import { useRef } from "react";
 import { MOUSE, PerspectiveCamera, Raycaster, Vector3 } from "three";
 import { isCameraOccluderTransparent } from "./cameraCollision.js";
 import { useGameContext } from "@jgengine/react/provider";
@@ -28,15 +28,6 @@ export function GameOrbitCamera({ yawRef, pitchRef, config: configPatch, followE
         distance: 0,
     });
     const followId = followEntityId ?? userId;
-    useEffect(() => {
-        const entity = ctx.scene.entity.get(followId);
-        if (entity === null || runtimeRef.current !== null)
-            return;
-        const seeded = seedOrbitFollowState({ entityPosition: entity.position, config });
-        runtimeRef.current = seeded;
-        camera.position.set(seeded.camera.x, seeded.camera.y, seeded.camera.z);
-        camera.lookAt(seeded.target.x, seeded.target.y, seeded.target.z);
-    }, [camera, config, ctx, followId]);
     useFrame((_, delta) => {
         const controls = controlsRef.current;
         const entity = ctx.scene.entity.get(followId);

package/dist/camera/cameraRigs.js

@@ -452,15 +452,23 @@ export function ChaseRig(props) {
             commit(pose, dt);
             return;
         }
-        let anchorYaw = yaw;
+        // Anchor yaw always eases toward its target (#1370): with drift-lag configured the target is
+        // the velocity-blended yaw at velocityYawResponse, otherwise the raw body facing at
+        // yawResponse — so a strafe-flipped facing arcs the boom around the character instead of
+        // teleporting it to the far side. yawResponse: Infinity restores the legacy rigid follow.
+        let targetYaw = yaw;
+        let response = resolved.yawResponse;
         if (resolved.velocityYawBlend > 0) {
             const velocity = dt > 0
                 ? { x: (follow.x - last.x) / dt, y: 0, z: (follow.z - last.z) / dt }
                 : { x: 0, y: 0, z: 0 };
-            const targetYaw = velocityYawTarget(yaw, velocity, resolved);
-            anchorYaw = smoothYaw(anchorYawRef.current ?? targetYaw, targetYaw, resolved.velocityYawResponse, dt);
-            anchorYawRef.current = anchorYaw;
+            targetYaw = velocityYawTarget(yaw, velocity, resolved);
+            response = resolved.velocityYawResponse;
         }
+        const anchorYaw = Number.isFinite(response)
+            ? smoothYaw(anchorYawRef.current ?? targetYaw, targetYaw, response, dt)
+            : targetYaw;
+        anchorYawRef.current = anchorYaw;
         // Report camera yaw back to the shell like every other player-facing rig, so
         // on-foot movement and aim stay camera-relative instead of frozen at yaw 0.
         props.yawRef.current = anchorYaw;

package/dist/camera/index.d.ts

@@ -5,6 +5,7 @@ export { GameInspectionCamera, type GameInspectionCameraProps } from "./GameInsp
 export { GameCameraRig, resolveRigKind, type GameCameraRigProps } from "./GameCameraRig.js";
 export { PlayerFovProvider, PlayerFovSlider, usePlayerFov, type PlayerFovState, } from "./PlayerFov.js";
 export { CameraShakeContext, cameraShake, createCameraShakeChannel, defaultCameraShakeChannel, useCameraShake, type CameraShakeChannel, } from "./shakeChannel.js";
+export { ControllerCameraShake, type ControllerCameraShakeProps } from "./ControllerCameraShake.js";
 export { rtsPanKeysConflict } from "./rigMath.js";
 export { GAME_SIM_FRAME_PRIORITY } from "./orbitCameraMath.js";
 export { CAMERA_TRANSPARENT_USERDATA, isCameraOccluderTransparent, type CameraOccluder, } from "./cameraCollision.js";

package/dist/camera/index.js

@@ -5,6 +5,7 @@ export { GameInspectionCamera } from "./GameInspectionCamera.js";
 export { GameCameraRig, resolveRigKind } from "./GameCameraRig.js";
 export { PlayerFovProvider, PlayerFovSlider, usePlayerFov, } from "./PlayerFov.js";
 export { CameraShakeContext, cameraShake, createCameraShakeChannel, defaultCameraShakeChannel, useCameraShake, } from "./shakeChannel.js";
+export { ControllerCameraShake } from "./ControllerCameraShake.js";
 export { rtsPanKeysConflict } from "./rigMath.js";
 export { GAME_SIM_FRAME_PRIORITY } from "./orbitCameraMath.js";
 export { CAMERA_TRANSPARENT_USERDATA, isCameraOccluderTransparent, } from "./cameraCollision.js";

package/dist/camera/rigMath.d.ts

@@ -134,6 +134,8 @@ export interface ResolvedChase {
     velocityYawMinSpeed: number;
     /** Exponential smoothing rate toward the blended anchor yaw (1-exp(-response*dt)). */
     velocityYawResponse: number;
+    /** Exponential smoothing rate the anchor yaw follows the body's facing with (#1370). `Infinity` restores the legacy rigid follow. */
+    yawResponse: number;
 }
 /** @internal */
 export declare function resolveChase(config: ChaseCameraConfig | undefined): ResolvedChase;

package/dist/camera/rigMath.js

@@ -245,6 +245,12 @@ export function lockOnPose(player, target, config, fov) {
     };
     return { pose: { position, lookAt: focus, fov }, yaw };
 }
+/**
+ * Default chase-yaw follow response: fast enough that the camera settles behind the runner in
+ * well under a second, slow enough that a strafe-flipped body facing arcs the boom around the
+ * character instead of teleporting it to the other side.
+ */
+const DEFAULT_CHASE_YAW_RESPONSE = 5;
 /** @internal */
 export function resolveChase(config) {
     return {
@@ -261,6 +267,7 @@ export function resolveChase(config) {
         velocityYawBlend: config?.velocityYaw === undefined ? 0 : config.velocityYaw.blend ?? 0.65,
         velocityYawMinSpeed: config?.velocityYaw?.minSpeed ?? 4,
         velocityYawResponse: config?.velocityYaw?.response ?? 6,
+        yawResponse: config?.yawResponse ?? DEFAULT_CHASE_YAW_RESPONSE,
     };
 }
 /** Velocity-lead the follow point (#286.9): aim `leadTime` seconds along the target's frame velocity, clamped to `leadMax`.

package/dist/devtools/CollisionDebugWorld.js

@@ -4,6 +4,7 @@ import { useFrame } from "@react-three/fiber";
 import { useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import * as THREE from "three";
 import { useGameContext } from "@jgengine/react/provider";
+import { useDisposable } from "../render/useDisposable.js";
 import { POSTFX_OVERLAY_USERDATA } from "../postfx/postfxOverlay.js";
 import { aimProbeNeeded, anyCollisionLayerOn, colliderScanNeeded, collisionDebug, projectileListenNeeded, } from "./collisionDebug.js";
 import { AIM_DAMAGE_COLOR, AIM_LASER_COLOR, AIM_MISS_COLOR, AIM_SOLID_COLOR, BODY_WIRE_COLOR, collectDebugShapes, computeAimLaser, HITBOX_WIRE_COLOR, muzzleMarkerFromOrigin, PROJECTILE_PATH_COLOR, } from "./collisionDebugMath.js";
@@ -17,13 +18,12 @@ function WireAabb({ center, halfExtents, rotationY, color, label, }) {
     return (_jsxs("group", { position: [center[0], center[1], center[2]], rotation: [0, rotationY, 0], children: [_jsxs("mesh", { children: [_jsx("boxGeometry", { args: [halfExtents[0] * 2, halfExtents[1] * 2, halfExtents[2] * 2] }), _jsx("meshBasicMaterial", { color: color, wireframe: true, transparent: true, opacity: 0.85, depthTest: false })] }), _jsx(Html, { position: [0, halfExtents[1] + 0.15, 0], center: true, distanceFactor: 14, zIndexRange: [25, 0], style: { pointerEvents: "none" }, children: _jsx("span", { className: "rounded bg-black/70 px-1 text-[9px] font-medium text-white/90", children: label }) })] }));
 }
 function WireTriangleMesh({ entry, shape, color, }) {
-    const geometry = useMemo(() => {
+    const geometry = useDisposable(() => {
         const built = new THREE.BufferGeometry();
         built.setAttribute("position", new THREE.BufferAttribute(shape.mesh.positions, 3));
         built.setIndex(new THREE.BufferAttribute(shape.mesh.indices, 1));
         return built;
     }, [shape.mesh]);
-    useEffect(() => () => geometry.dispose(), [geometry]);
     return (_jsxs("group", { children: [_jsx("group", { position: [entry.position[0], entry.position[1], entry.position[2]], rotation: [0, entry.rotationY, 0], children: _jsx("group", { position: [shape.meshTranslate[0], shape.meshTranslate[1], shape.meshTranslate[2]], scale: shape.meshScale, children: _jsx("mesh", { geometry: geometry, children: _jsx("meshBasicMaterial", { color: color, wireframe: true, transparent: true, opacity: 0.85, depthTest: false }) }) }) }), _jsx(Html, { position: [shape.center[0], shape.center[1] + shape.halfExtents[1] + 0.15, shape.center[2]], center: true, distanceFactor: 14, zIndexRange: [25, 0], style: { pointerEvents: "none" }, children: _jsx("span", { className: "rounded bg-black/70 px-1 text-[9px] font-medium text-white/90", children: entry.label }) })] }));
 }
 function ColliderShapeMesh({ entry }) {

package/dist/devtools/DevtoolsOverlay.js

@@ -3,6 +3,7 @@ import { useFrame, useThree } from "@react-three/fiber";
 import { useEffect, useRef, useState, useSyncExternalStore } from "react";
 import { devtools, instrumentLatency, } from "@jgengine/core/devtools/devtools";
 import { fallbackSeamsSnapshot } from "@jgengine/core/devtools/fallbackSeams";
+import { textureErrorsSnapshot } from "@jgengine/core/devtools/textureErrors";
 import { MOVEMENT_TUNING } from "@jgengine/core/movement/movementModel";
 import { collisionDebug } from "./collisionDebug.js";
 import { readStoredOverrides } from "./devtoolsOverrides.js";
@@ -210,6 +211,7 @@ export function DevtoolsOverlay({ open, ctx, playable, multiplayer, }) {
             devtools.probes.register("entities", () => ctx.scene.entity.list().length),
             devtools.probes.register("objects", () => ctx.scene.object.list().length),
             devtools.probes.register("fallbacks", () => fallbackSeamsSnapshot()),
+            devtools.probes.register("textureErrors", () => textureErrorsSnapshot()),
         ];
         return () => {
             for (const dispose of disposers)

package/dist/drivers/FrameDriver.d.ts

@@ -5,7 +5,7 @@ import type { PointerService } from "../pointer/pointerService.js";
 import type { ShellMultiplayer } from "../multiplayer.js";
 import type { PlayableGame } from "../registry.js";
 export declare const POSTER_SETTLE_SECONDS = 1.6;
-export declare function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryClickRef, pointerAxisRef, gateRef, onRuntimeError, multiplayer, serverIdRef, pointerService, pointerAim, pingCommand, poster, onPosterSettled, }: {
+export declare function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryClickRef, pointerAxisRef, analogRef, gateRef, onRuntimeError, multiplayer, serverIdRef, pointerService, pointerAim, pingCommand, poster, onPosterSettled, }: {
     ctx: GameContext;
     playable: PlayableGame;
     tracker: ActionStateTracker<string>;
@@ -21,6 +21,9 @@ export declare function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef,
     pointerAxisRef: {
         current: PointerAxisState | null;
     };
+    analogRef: {
+        current: Readonly<Record<string, number>> | null;
+    };
     gateRef: {
         current: boolean;
     };

package/dist/drivers/FrameDriver.js

@@ -19,7 +19,7 @@ import { GAME_SIM_FRAME_PRIORITY } from "../camera/index.js";
 import { NO_ACTIONS } from "../shellConstants.js";
 const TURN_SPEED = 2.4;
 export const POSTER_SETTLE_SECONDS = 1.6;
-export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryClickRef, pointerAxisRef, gateRef, onRuntimeError, multiplayer, serverIdRef, pointerService, pointerAim, pingCommand, poster, onPosterSettled, }) {
+export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryClickRef, pointerAxisRef, analogRef, gateRef, onRuntimeError, multiplayer, serverIdRef, pointerService, pointerAim, pingCommand, poster, onPosterSettled, }) {
     const posterElapsedRef = useRef(0);
     const posterDoneRef = useRef(false);
     const hasReportedTickError = useRef(false);
@@ -71,7 +71,7 @@ export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryC
         const sendInput = () => {
             if (!serverAuthoritative)
                 return;
-            const frame = { held: ctx.input.held(), pointer: ctx.input.pointer() };
+            const frame = { held: ctx.input.held(), pointer: ctx.input.pointer(), analog: ctx.input.analog() };
             const last = lastSentInputRef.current;
             if (last !== null && inputFramesEqual(last, frame))
                 return;
@@ -80,6 +80,7 @@ export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryC
         };
         if (gateRef.current || !playControlsActive(ctx)) {
             ctx.input.publish(heldActionsFor(tracker, NO_ACTIONS));
+            ctx.input.publishAnalog(null);
             sendInput();
             return;
         }
@@ -90,6 +91,7 @@ export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryC
             const gameDt = ctx.time.advance(dt);
             ctx.input.publish(heldActionsFor(tracker, inputActions));
             ctx.input.publishPointer(pointerAxisRef.current);
+            ctx.input.publishAnalog(analogRef.current);
             sendInput();
             const turnInput = (tracker.isDown("turnRight") ? 1 : 0) - (tracker.isDown("turnLeft") ? 1 : 0);
             if (turnInput !== 0)
@@ -99,7 +101,7 @@ export function FrameDriver({ ctx, playable, tracker, yawRef, pitchRef, primaryC
             const player = ctx.scene.entity.get(playerId);
             if (player !== null && drivesPose && !serverAuthoritative) {
                 endPhase = devtools.profile.begin("pose");
-                stepPlayerMovement(ctx, ctx.player.userId, { held: ctx.input.held(), pointer: ctx.input.pointer() }, rawDt, movementTuning, yawRef.current);
+                stepPlayerMovement(ctx, ctx.player.userId, { held: ctx.input.held(), pointer: ctx.input.pointer(), analog: ctx.input.analog() }, rawDt, movementTuning, yawRef.current);
                 endPhase();
             }
             if (autoPickupRadius !== null && !serverAuthoritative) {

package/dist/environment/DayNightSky.d.ts

@@ -0,0 +1,33 @@
+import type { DayNightCycle } from "@jgengine/core/time/dayNightCycle";
+/** Props for {@link DayNightSky}: the cycle to bind plus optional dome shape and light-strength knobs. */
+export interface DayNightSkyProps {
+    /** The serializable day-night brain. Its `sample()` drives the sky tint/light each frame. */
+    cycle: DayNightCycle;
+    /** Sky dome radius. Default `260`. */
+    radius?: number;
+    /** Horizon haze-band strength passed straight to the dome. Default `0.5`. */
+    hazeStrength?: number;
+    /** Sun-glow brightness passed straight to the dome. Default `1`. */
+    sunGlowStrength?: number;
+    /**
+     * Mount a hemisphere + shadow-casting directional light whose color and intensity
+     * track the cycle. Turn off (`false`) when the game authors its own `lighting`. Default `true`.
+     */
+    lights?: boolean;
+    /** Peak directional-light intensity at full `sample().intensity` (1). Default `1.1`. */
+    keyLightIntensity?: number;
+    /** Peak hemisphere (ambient) intensity at full `sample().intensity` (1). Default `0.6`. */
+    ambientIntensity?: number;
+}
+/**
+ * Binds a {@link DayNightCycle} to the engine's existing `SkyDome` shader and a pair of
+ * lights: each frame it reads `cycle.sample()` and writes the blended tint into the dome's
+ * top/horizon/sun uniforms while the sun's arc comes from the shared `daylightStateAt`
+ * geometry. This is the turnkey presentation seam — a game mounts this one component in its
+ * scene and gets a moving, color-graded day-night sky from the serializable model, with no
+ * hand-rolled per-frame lerp and no new renderer. The cycle's `phase`/color values are
+ * free-form and never interpreted here.
+ *
+ * @capability day-night-sky drop-in R3F presenter that drives the engine's existing sky dome and lights from a serializable day-night cycle for a moving, color-graded day-night look
+ */
+export declare function DayNightSky({ cycle, radius, hazeStrength, sunGlowStrength, lights, keyLightIntensity, ambientIntensity, }: DayNightSkyProps): import("react").JSX.Element;

package/dist/environment/DayNightSky.js

@@ -0,0 +1,51 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useFrame } from "@react-three/fiber";
+import { useMemo, useRef } from "react";
+import * as THREE from "three";
+import { SkyDome } from "./Daylight.js";
+import { daylightStateAt } from "./daylightCycle.js";
+const HEMI_GROUND = "#4c6b34";
+/**
+ * Binds a {@link DayNightCycle} to the engine's existing `SkyDome` shader and a pair of
+ * lights: each frame it reads `cycle.sample()` and writes the blended tint into the dome's
+ * top/horizon/sun uniforms while the sun's arc comes from the shared `daylightStateAt`
+ * geometry. This is the turnkey presentation seam — a game mounts this one component in its
+ * scene and gets a moving, color-graded day-night sky from the serializable model, with no
+ * hand-rolled per-frame lerp and no new renderer. The cycle's `phase`/color values are
+ * free-form and never interpreted here.
+ *
+ * @capability day-night-sky drop-in R3F presenter that drives the engine's existing sky dome and lights from a serializable day-night cycle for a moving, color-graded day-night look
+ */
+export function DayNightSky({ cycle, radius, hazeStrength, sunGlowStrength, lights = true, keyLightIntensity = 1.1, ambientIntensity = 0.6, }) {
+    const skyMaterialRef = useRef(null);
+    const sunRef = useRef(null);
+    const hemiRef = useRef(null);
+    const initial = useMemo(() => cycle.sample(), [cycle]);
+    const initialSun = useMemo(() => daylightStateAt(initial.dayFraction).sunPosition, [initial.dayFraction]);
+    useFrame(() => {
+        const sample = cycle.sample();
+        const geometry = daylightStateAt(sample.dayFraction);
+        const material = skyMaterialRef.current;
+        if (material !== null) {
+            material.uniforms.topColor.value.set(sample.lightColor);
+            material.uniforms.bottomColor.value.set(sample.color);
+            material.uniforms.uSunColor.value.set(sample.lightColor);
+            material.uniforms.uSunDirection.value
+                .set(geometry.sunPosition[0], geometry.sunPosition[1], geometry.sunPosition[2])
+                .normalize();
+            material.uniforms.uSunIntensity.value = sample.intensity;
+        }
+        const sun = sunRef.current;
+        if (sun !== null) {
+            sun.position.set(geometry.sunPosition[0], geometry.sunPosition[1], geometry.sunPosition[2]);
+            sun.intensity = sample.intensity * keyLightIntensity;
+            sun.color.set(sample.lightColor);
+        }
+        const hemi = hemiRef.current;
+        if (hemi !== null) {
+            hemi.intensity = sample.intensity * ambientIntensity;
+            hemi.color.set(sample.lightColor);
+        }
+    });
+    return (_jsxs(_Fragment, { children: [_jsx(SkyDome, { topColor: initial.lightColor, horizonColor: initial.color, sunDirection: initialSun, sunColor: initial.lightColor, sunIntensity: initial.intensity, materialRef: skyMaterialRef, ...(radius === undefined ? {} : { radius }), ...(hazeStrength === undefined ? {} : { hazeStrength }), ...(sunGlowStrength === undefined ? {} : { sunGlowStrength }) }), lights ? (_jsxs(_Fragment, { children: [_jsx("hemisphereLight", { ref: hemiRef, args: [initial.lightColor, HEMI_GROUND, initial.intensity * ambientIntensity] }), _jsx("directionalLight", { ref: sunRef, position: initialSun, intensity: initial.intensity * keyLightIntensity, color: initial.lightColor, castShadow: true, "shadow-mapSize-width": 2048, "shadow-mapSize-height": 2048, "shadow-camera-left": -90, "shadow-camera-right": 90, "shadow-camera-top": 90, "shadow-camera-bottom": -90, "shadow-camera-near": 10, "shadow-camera-far": 520, "shadow-bias": -0.0004, "shadow-normalBias": 0.02 })] })) : null] }));
+}

package/dist/environment/Daylight.d.ts

@@ -16,13 +16,15 @@ export interface SkyDomeProps {
     sunIntensity?: number;
     /** Horizon haze-band strength: 0 removes the dusty band, ~1 makes it heavy. Default 0.5. */
     hazeStrength?: number;
+    /** Procedural cloud-band opacity: 0 is a clear sky, 1 is heavy overcast. Default 0.35. */
+    cloudiness?: number;
     /** Sun-glow brightness multiplier around the sun disc. Default 1. */
     sunGlowStrength?: number;
     /** Exposes the created shader material so a time-of-day driver can mutate its uniforms per frame without recreating it. */
     materialRef?: MutableRefObject<THREE.ShaderMaterial | null>;
 }
 /** @internal */
-export declare function SkyDome({ topColor, horizonColor, radius, offset, exponent, sunDirection, sunColor, sunIntensity, hazeStrength, sunGlowStrength, materialRef, }?: SkyDomeProps): import("react").JSX.Element;
+export declare function SkyDome({ topColor, horizonColor, radius, offset, exponent, sunDirection, sunColor, sunIntensity, hazeStrength, sunGlowStrength, cloudiness, materialRef, }?: SkyDomeProps): import("react").JSX.Element;
 export interface DaylightProps {
     sky?: SkyDomeProps | false;
     fog?: {