@ankhorage/zora 21.0.22 → 21.1.0

package/dist/features/game/adapters/inbound/useGameInputZoneResponder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameInputZoneResponder.js","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/useGameInputZoneResponder.ts"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport type { GestureResponderEvent, LayoutChangeEvent } from 'react-native';\n\nimport type { GameInputZoneProps } from '../../../../types/gamePresentation';\nimport { GameRuntimeContext } from '../../composition/GameRuntimeContext';\nimport { createGameKeyboardEvent } from './createGameKeyboardEvent';\nimport { createGamePointerEvent } from './createGamePointerEvent';\n\ninterface GameKeyboardInputEvent {\n  readonly key: string;\n  preventDefault(): void;\n}\n\ninterface MeasuredSize {\n  readonly width: number;\n  readonly height: number;\n}\n\n/*** Own React Native responder measurement and event dispatch for one Game input zone. */\nexport function useGameInputZoneResponder(props: GameInputZoneProps) {\n  const runtime = React.useContext(GameRuntimeContext);\n  if (runtime === null) throw new Error('GameInputZone must be rendered inside Game.');\n\n  const measuredSizeRef = React.useRef<MeasuredSize>({ width: 0, height: 0 });\n  const handleLayout = React.useCallback((event: LayoutChangeEvent) => {\n    const { width, height } = event.nativeEvent.layout;\n    measuredSizeRef.current = { width, height };\n  }, []);\n\n  const dispatchPointer = React.useCallback(\n    (event: GestureResponderEvent) => {\n      if (runtime.interactionPolicy === 'passive' || props.interactionPolicy === 'passive') return;\n      const measured = measuredSizeRef.current;\n      const gameEvent = createGamePointerEvent({\n        eventType: props.eventType,\n        ...(props.entityId === undefined ? {} : { entityId: props.entityId }),\n        localX: event.nativeEvent.locationX,\n        localY: event.nativeEvent.locationY,\n        measuredWidth: measured.width,\n        measuredHeight: measured.height,\n        zoneX: props.x ?? 0,\n        zoneY: props.y ?? 0,\n        zoneWidth: props.width ?? 100,\n        zoneHeight: props.height ?? 100,\n      });\n      if (gameEvent !== undefined) runtime.dispatch(gameEvent);\n    },\n    [\n      props.entityId,\n      props.eventType,\n      props.height,\n      props.interactionPolicy,\n      props.width,\n      props.x,\n      props.y,\n      runtime,\n    ],\n  );\n\n  const dispatchKeyboard = React.useCallback(\n    (event: GameKeyboardInputEvent) => {\n      if (runtime.interactionPolicy === 'passive' || props.interactionPolicy === 'passive') return;\n      const result = createGameKeyboardEvent({\n        bindings: props.keyboardBindings ?? [],\n        fallbackEventType: props.eventType,\n        ...(props.entityId === undefined ? {} : { fallbackEntityId: props.entityId }),\n        key: event.key,\n      });\n      if (result === undefined) return;\n      if (result.preventDefault) event.preventDefault();\n      runtime.dispatch(result.event);\n    },\n    [props.entityId, props.eventType, props.interactionPolicy, props.keyboardBindings, runtime],\n  );\n\n  return {\n    dispatchKeyboard,\n    dispatchPointer,\n    handleLayout,\n    shouldSetResponder: () =>\n      (props.enabled ?? true) &&\n      props.interactionPolicy !== 'passive' &&\n      runtime.interactionPolicy !== 'passive',\n  };\n}\n"]}

package/dist/features/game/composition/GameRuntimeContext.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { GameRuntimeContextValue } from '../../../types/gameRuntime';
+/*** Provide the local transient game session and event dispatcher to presentation adapters. */
+export declare const GameRuntimeContext: React.Context<GameRuntimeContextValue | null>;
+//# sourceMappingURL=GameRuntimeContext.d.ts.map

package/dist/features/game/composition/GameRuntimeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../src/features/game/composition/GameRuntimeContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,+CAA4D,CAAC"}

package/dist/features/game/composition/GameRuntimeContext.js

@@ -0,0 +1,4 @@
+import React from 'react';
+/*** Provide the local transient game session and event dispatcher to presentation adapters. */
+export const GameRuntimeContext = React.createContext(null);
+//# sourceMappingURL=GameRuntimeContext.js.map

package/dist/features/game/composition/GameRuntimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameRuntimeContext.js","sourceRoot":"","sources":["../../../../src/features/game/composition/GameRuntimeContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,+FAA+F;AAC/F,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAiC,IAAI,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport type { GameRuntimeContextValue } from '../../../types/gameRuntime';\n\n/*** Provide the local transient game session and event dispatcher to presentation adapters. */\nexport const GameRuntimeContext = React.createContext<GameRuntimeContextValue | null>(null);\n"]}

package/dist/features/game/composition/createGameBindingContext.d.ts

@@ -0,0 +1,4 @@
+import type { GameSession } from '@ankhorage/game';
+/*** Create the canonical Runtime context namespace for one local game session. */
+export declare function createGameBindingContext(session: GameSession): Record<string, unknown>;
+//# sourceMappingURL=createGameBindingContext.d.ts.map

package/dist/features/game/composition/createGameBindingContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGameBindingContext.d.ts","sourceRoot":"","sources":["../../../../src/features/game/composition/createGameBindingContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOtF"}

package/dist/features/game/composition/createGameBindingContext.js

@@ -0,0 +1,10 @@
+/*** Create the canonical Runtime context namespace for one local game session. */
+export function createGameBindingContext(session) {
+    return {
+        game: {
+            entities: Object.values(session.entities),
+            session,
+        },
+    };
+}
+//# sourceMappingURL=createGameBindingContext.js.map

package/dist/features/game/composition/createGameBindingContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGameBindingContext.js","sourceRoot":"","sources":["../../../../src/features/game/composition/createGameBindingContext.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,OAAO;QACL,IAAI,EAAE;YACJ,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;YACzC,OAAO;SACR;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { GameSession } from '@ankhorage/game';\n\n/*** Create the canonical Runtime context namespace for one local game session. */\nexport function createGameBindingContext(session: GameSession): Record<string, unknown> {\n  return {\n    game: {\n      entities: Object.values(session.entities),\n      session,\n    },\n  };\n}\n"]}

package/dist/features/game/composition/createGameMeasurementRegistry.d.ts

@@ -0,0 +1,4 @@
+import type { GameMeasurementRegistry } from '../../../types/gameRuntime';
+/*** Create one isolated measurement registry for an embeddable Game instance. */
+export declare function createGameMeasurementRegistry(): GameMeasurementRegistry;
+//# sourceMappingURL=createGameMeasurementRegistry.d.ts.map

package/dist/features/game/composition/createGameMeasurementRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGameMeasurementRegistry.d.ts","sourceRoot":"","sources":["../../../../src/features/game/composition/createGameMeasurementRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEjG,iFAAiF;AACjF,wBAAgB,6BAA6B,IAAI,uBAAuB,CAYvE"}

package/dist/features/game/composition/createGameMeasurementRegistry.js

@@ -0,0 +1,15 @@
+/*** Create one isolated measurement registry for an embeddable Game instance. */
+export function createGameMeasurementRegistry() {
+    const readers = new Map();
+    return {
+        registerMeasurement: (id, reader) => {
+            readers.set(id, reader);
+            return () => {
+                if (readers.get(id) === reader)
+                    readers.delete(id);
+            };
+        },
+        measure: (id) => readers.get(id)?.() ?? Promise.resolve(undefined),
+    };
+}
+//# sourceMappingURL=createGameMeasurementRegistry.js.map

package/dist/features/game/composition/createGameMeasurementRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGameMeasurementRegistry.js","sourceRoot":"","sources":["../../../../src/features/game/composition/createGameMeasurementRegistry.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,MAAM,UAAU,6BAA6B;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEzD,OAAO;QACL,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;YAClC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;KACnE,CAAC;AACJ,CAAC","sourcesContent":["import type { GameMeasurementReader, GameMeasurementRegistry } from '../../../types/gameRuntime';\n\n/*** Create one isolated measurement registry for an embeddable Game instance. */\nexport function createGameMeasurementRegistry(): GameMeasurementRegistry {\n  const readers = new Map<string, GameMeasurementReader>();\n\n  return {\n    registerMeasurement: (id, reader) => {\n      readers.set(id, reader);\n      return () => {\n        if (readers.get(id) === reader) readers.delete(id);\n      };\n    },\n    measure: (id) => readers.get(id)?.() ?? Promise.resolve(undefined),\n  };\n}\n"]}

package/dist/features/game/composition/useGameRuntime.d.ts

@@ -0,0 +1,5 @@
+import type { GameProps } from '../../../types/gamePresentation';
+import type { GameRuntimeValue } from '../../../types/gameRuntime';
+/*** Own one local transient Game session while delegating all domain transitions to @ankhorage/game. */
+export declare function useGameRuntime(props: GameProps): GameRuntimeValue;
+//# sourceMappingURL=useGameRuntime.d.ts.map

package/dist/features/game/composition/useGameRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameRuntime.d.ts","sourceRoot":"","sources":["../../../../src/features/game/composition/useGameRuntime.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKrF,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CAsDjE"}

package/dist/features/game/composition/useGameRuntime.js

@@ -0,0 +1,117 @@
+import { advanceGameTime, applyGameEvent, createGameSession, } from '@ankhorage/game';
+import React from 'react';
+import { useGameScheduledEffects } from './useGameScheduledEffects';
+const EMPTY_GAME_INPUT = {};
+/*** Own one local transient Game session while delegating all domain transitions to @ankhorage/game. */
+export function useGameRuntime(props) {
+    const { definition, input = EMPTY_GAME_INPUT, seed = 0, resetKey = '' } = props;
+    const definitionRef = useLatestValue(definition);
+    const inputRef = useLatestValue(input);
+    const outputRef = useLatestValue(props.onOutput);
+    const autoAdvanceTime = props.autoAdvanceTime ?? true;
+    const clockRef = React.useRef(0);
+    const runtimeKey = createRuntimeKey(definition.id, resetKey, seed);
+    const [runtime, setRuntime] = React.useState(() => createRuntimeState(definition, input, seed, runtimeKey, 0));
+    useGameRuntimeReset({
+        clockRef,
+        definitionRef,
+        inputRef,
+        runtimeKey,
+        seed,
+        setRuntime,
+    });
+    useGameAutoAdvanceClock(autoAdvanceTime, clockRef);
+    useGameOutputEmitter(runtime, outputRef, setRuntime);
+    const dispatch = React.useCallback((event) => {
+        const now = Date.now();
+        setRuntime((current) => applyRuntimeEvent({
+            autoAdvanceTime,
+            current,
+            definition: definitionRef.current,
+            elapsedMs: Math.max(0, now - clockRef.current),
+            event,
+            input: inputRef.current,
+            runtimeKey,
+            seed,
+        }));
+        clockRef.current = now;
+    }, [autoAdvanceTime, definitionRef, inputRef, runtimeKey, seed]);
+    useGameScheduledEffects({
+        clockRef,
+        definitionRef,
+        enabled: autoAdvanceTime,
+        inputRef,
+        runtimeKey,
+        scheduled: runtime.session.scheduled,
+        setRuntime,
+    });
+    return React.useMemo(() => ({ session: runtime.session, dispatch }), [dispatch, runtime.session]);
+}
+/*** Reset the transient session only when its explicit serializable runtime identity changes. */
+function useGameRuntimeReset({ clockRef, definitionRef, inputRef, runtimeKey, seed, setRuntime, }) {
+    React.useEffect(() => {
+        clockRef.current = Date.now();
+        setRuntime((current) => current.key === runtimeKey
+            ? current
+            : createRuntimeState(definitionRef.current, inputRef.current, seed, runtimeKey, current.revision + 1));
+    }, [clockRef, definitionRef, inputRef, runtimeKey, seed, setRuntime]);
+}
+/*** Rebase elapsed-time tracking when automatic game-time advancement resumes. */
+function useGameAutoAdvanceClock(enabled, clockRef) {
+    const previousEnabledRef = React.useRef(enabled);
+    React.useEffect(() => {
+        if (enabled && !previousEnabledRef.current) {
+            clockRef.current = Date.now();
+        }
+        previousEnabledRef.current = enabled;
+    }, [clockRef, enabled]);
+}
+/*** Emit each committed runtime output once and clear the delivered queue. */
+function useGameOutputEmitter(runtime, outputRef, setRuntime) {
+    React.useEffect(() => {
+        if (runtime.outputs.length === 0)
+            return;
+        setRuntime((current) => current.revision === runtime.revision ? { ...current, outputs: [] } : current);
+        emitGameOutputs(runtime.outputs, outputRef.current);
+    }, [outputRef, runtime.outputs, runtime.revision, setRuntime]);
+}
+/*** Apply elapsed time and one explicit game event against the matching local session. */
+function applyRuntimeEvent(args) {
+    const base = args.current.key === args.runtimeKey
+        ? args.current
+        : createRuntimeState(args.definition, args.input, args.seed, args.runtimeKey, args.current.revision);
+    const timed = args.autoAdvanceTime
+        ? advanceGameTime(args.definition, base.session, args.elapsedMs, args.input)
+        : { session: base.session, outputs: [] };
+    const result = applyGameEvent(args.definition, timed.session, args.event, args.input);
+    return {
+        key: args.runtimeKey,
+        session: result.session,
+        outputs: [...base.outputs, ...timed.outputs, ...result.outputs],
+        revision: args.current.revision + 1,
+    };
+}
+/*** Create one transient runtime state through the published Game owner API. */
+function createRuntimeState(definition, input, seed, key, revision) {
+    const result = createGameSession(definition, { input, seed });
+    return { key, session: result.session, outputs: result.outputs, revision };
+}
+/*** Create one runtime identity from serializable definition/session initialization inputs. */
+function createRuntimeKey(definitionId, resetKey, seed) {
+    return `${definitionId}:${resetKey}:${seed}`;
+}
+/*** Emit runtime outputs through the ZORA event callback boundary. */
+function emitGameOutputs(outputs, onOutput) {
+    if (onOutput === undefined)
+        return;
+    outputs.forEach((output) => onOutput(output));
+}
+/*** Keep a stable ref object updated with the latest adapter input. */
+function useLatestValue(value) {
+    const ref = React.useRef(value);
+    React.useEffect(() => {
+        ref.current = value;
+    }, [value]);
+    return ref;
+}
+//# sourceMappingURL=useGameRuntime.js.map

package/dist/features/game/composition/useGameRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameRuntime.js","sourceRoot":"","sources":["../../../../src/features/game/composition/useGameRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  advanceGameTime,\n  applyGameEvent,\n  createGameSession,\n  type GameInput,\n  type GameOutput,\n} from '@ankhorage/game';\nimport React from 'react';\n\nimport type { GameProps } from '../../../types/gamePresentation';\nimport type { GameRuntimeState, GameRuntimeValue } from '../../../types/gameRuntime';\nimport { useGameScheduledEffects } from './useGameScheduledEffects';\n\nconst EMPTY_GAME_INPUT: GameInput = {};\n\n/*** Own one local transient Game session while delegating all domain transitions to @ankhorage/game. */\nexport function useGameRuntime(props: GameProps): GameRuntimeValue {\n  const { definition, input = EMPTY_GAME_INPUT, seed = 0, resetKey = '' } = props;\n  const definitionRef = useLatestValue(definition);\n  const inputRef = useLatestValue(input);\n  const outputRef = useLatestValue(props.onOutput);\n  const autoAdvanceTime = props.autoAdvanceTime ?? true;\n  const clockRef = React.useRef(0);\n  const runtimeKey = createRuntimeKey(definition.id, resetKey, seed);\n  const [runtime, setRuntime] = React.useState<GameRuntimeState>(() =>\n    createRuntimeState(definition, input, seed, runtimeKey, 0),\n  );\n\n  useGameRuntimeReset({\n    clockRef,\n    definitionRef,\n    inputRef,\n    runtimeKey,\n    seed,\n    setRuntime,\n  });\n  useGameAutoAdvanceClock(autoAdvanceTime, clockRef);\n  useGameOutputEmitter(runtime, outputRef, setRuntime);\n\n  const dispatch = React.useCallback<GameRuntimeValue['dispatch']>(\n    (event) => {\n      const now = Date.now();\n      setRuntime((current) =>\n        applyRuntimeEvent({\n          autoAdvanceTime,\n          current,\n          definition: definitionRef.current,\n          elapsedMs: Math.max(0, now - clockRef.current),\n          event,\n          input: inputRef.current,\n          runtimeKey,\n          seed,\n        }),\n      );\n      clockRef.current = now;\n    },\n    [autoAdvanceTime, definitionRef, inputRef, runtimeKey, seed],\n  );\n\n  useGameScheduledEffects({\n    clockRef,\n    definitionRef,\n    enabled: autoAdvanceTime,\n    inputRef,\n    runtimeKey,\n    scheduled: runtime.session.scheduled,\n    setRuntime,\n  });\n\n  return React.useMemo(() => ({ session: runtime.session, dispatch }), [dispatch, runtime.session]);\n}\n\ninterface GameRuntimeResetArgs {\n  readonly clockRef: React.RefObject<number>;\n  readonly definitionRef: React.RefObject<GameProps['definition']>;\n  readonly inputRef: React.RefObject<GameInput>;\n  readonly runtimeKey: string;\n  readonly seed: number;\n  readonly setRuntime: React.Dispatch<React.SetStateAction<GameRuntimeState>>;\n}\n\n/*** Reset the transient session only when its explicit serializable runtime identity changes. */\nfunction useGameRuntimeReset({\n  clockRef,\n  definitionRef,\n  inputRef,\n  runtimeKey,\n  seed,\n  setRuntime,\n}: GameRuntimeResetArgs): void {\n  React.useEffect(() => {\n    clockRef.current = Date.now();\n    setRuntime((current) =>\n      current.key === runtimeKey\n        ? current\n        : createRuntimeState(\n            definitionRef.current,\n            inputRef.current,\n            seed,\n            runtimeKey,\n            current.revision + 1,\n          ),\n    );\n  }, [clockRef, definitionRef, inputRef, runtimeKey, seed, setRuntime]);\n}\n\n/*** Rebase elapsed-time tracking when automatic game-time advancement resumes. */\nfunction useGameAutoAdvanceClock(enabled: boolean, clockRef: React.RefObject<number>): void {\n  const previousEnabledRef = React.useRef(enabled);\n\n  React.useEffect(() => {\n    if (enabled && !previousEnabledRef.current) {\n      clockRef.current = Date.now();\n    }\n    previousEnabledRef.current = enabled;\n  }, [clockRef, enabled]);\n}\n\n/*** Emit each committed runtime output once and clear the delivered queue. */\nfunction useGameOutputEmitter(\n  runtime: GameRuntimeState,\n  outputRef: React.RefObject<GameProps['onOutput']>,\n  setRuntime: React.Dispatch<React.SetStateAction<GameRuntimeState>>,\n): void {\n  React.useEffect(() => {\n    if (runtime.outputs.length === 0) return;\n\n    setRuntime((current) =>\n      current.revision === runtime.revision ? { ...current, outputs: [] } : current,\n    );\n    emitGameOutputs(runtime.outputs, outputRef.current);\n  }, [outputRef, runtime.outputs, runtime.revision, setRuntime]);\n}\n\ninterface ApplyRuntimeEventArgs {\n  readonly autoAdvanceTime: boolean;\n  readonly current: GameRuntimeState;\n  readonly definition: GameProps['definition'];\n  readonly elapsedMs: number;\n  readonly event: Parameters<typeof applyGameEvent>[2];\n  readonly input: GameInput;\n  readonly runtimeKey: string;\n  readonly seed: number;\n}\n\n/*** Apply elapsed time and one explicit game event against the matching local session. */\nfunction applyRuntimeEvent(args: ApplyRuntimeEventArgs): GameRuntimeState {\n  const base =\n    args.current.key === args.runtimeKey\n      ? args.current\n      : createRuntimeState(\n          args.definition,\n          args.input,\n          args.seed,\n          args.runtimeKey,\n          args.current.revision,\n        );\n  const timed = args.autoAdvanceTime\n    ? advanceGameTime(args.definition, base.session, args.elapsedMs, args.input)\n    : { session: base.session, outputs: [] };\n  const result = applyGameEvent(args.definition, timed.session, args.event, args.input);\n  return {\n    key: args.runtimeKey,\n    session: result.session,\n    outputs: [...base.outputs, ...timed.outputs, ...result.outputs],\n    revision: args.current.revision + 1,\n  };\n}\n\n/*** Create one transient runtime state through the published Game owner API. */\nfunction createRuntimeState(\n  definition: GameProps['definition'],\n  input: GameInput,\n  seed: number,\n  key: string,\n  revision: number,\n): GameRuntimeState {\n  const result = createGameSession(definition, { input, seed });\n  return { key, session: result.session, outputs: result.outputs, revision };\n}\n\n/*** Create one runtime identity from serializable definition/session initialization inputs. */\nfunction createRuntimeKey(definitionId: string, resetKey: string, seed: number): string {\n  return `${definitionId}:${resetKey}:${seed}`;\n}\n\n/*** Emit runtime outputs through the ZORA event callback boundary. */\nfunction emitGameOutputs(outputs: readonly GameOutput[], onOutput: GameProps['onOutput']): void {\n  if (onOutput === undefined) return;\n  outputs.forEach((output) => onOutput(output));\n}\n\n/*** Keep a stable ref object updated with the latest adapter input. */\nfunction useLatestValue<TValue>(value: TValue): React.RefObject<TValue> {\n  const ref = React.useRef(value);\n  React.useEffect(() => {\n    ref.current = value;\n  }, [value]);\n  return ref;\n}\n"]}

package/dist/features/game/composition/useGameScheduledEffects.d.ts

@@ -0,0 +1,17 @@
+import { type GameDefinition, type GameInput } from '@ankhorage/game';
+import React from 'react';
+import type { GameRuntimeState } from '../../../types/gameRuntime';
+type SetGameRuntime = React.Dispatch<React.SetStateAction<GameRuntimeState>>;
+/*** Advance the nearest scheduled game effects through one platform timer. */
+export declare function useGameScheduledEffects({ clockRef, definitionRef, enabled, inputRef, runtimeKey, scheduled, setRuntime, }: UseGameScheduledEffectsArgs): void;
+interface UseGameScheduledEffectsArgs {
+    readonly clockRef: React.RefObject<number>;
+    readonly definitionRef: React.RefObject<GameDefinition>;
+    readonly enabled: boolean;
+    readonly inputRef: React.RefObject<GameInput>;
+    readonly runtimeKey: string;
+    readonly scheduled: GameRuntimeState['session']['scheduled'];
+    readonly setRuntime: SetGameRuntime;
+}
+export {};
+//# sourceMappingURL=useGameScheduledEffects.d.ts.map

package/dist/features/game/composition/useGameScheduledEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameScheduledEffects.d.ts","sourceRoot":"","sources":["../../../../src/features/game/composition/useGameScheduledEffects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,KAAK,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE7E,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,aAAa,EACb,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,GACX,EAAE,2BAA2B,GAAG,IAAI,CAsBpC;AAED,UAAU,2BAA2B;IACnC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACrC"}

package/dist/features/game/composition/useGameScheduledEffects.js

@@ -0,0 +1,40 @@
+import { advanceGameTime } from '@ankhorage/game';
+import React from 'react';
+/*** Advance the nearest scheduled game effects through one platform timer. */
+export function useGameScheduledEffects({ clockRef, definitionRef, enabled, inputRef, runtimeKey, scheduled, setRuntime, }) {
+    React.useEffect(() => {
+        if (!enabled || scheduled.length === 0)
+            return undefined;
+        const delayMs = resolveNextScheduledDelay(scheduled);
+        const timer = setTimeout(() => {
+            const now = Date.now();
+            const elapsedMs = Math.max(0, now - clockRef.current);
+            clockRef.current = now;
+            setRuntime((current) => advanceScheduledRuntime({
+                current,
+                definition: definitionRef.current,
+                elapsedMs,
+                input: inputRef.current,
+                runtimeKey,
+            }));
+        }, delayMs);
+        return () => clearTimeout(timer);
+    }, [clockRef, definitionRef, enabled, inputRef, runtimeKey, scheduled, setRuntime]);
+}
+/*** Advance one matching runtime state while preserving sessions that have already reset. */
+function advanceScheduledRuntime({ current, definition, elapsedMs, input, runtimeKey, }) {
+    if (current.key !== runtimeKey)
+        return current;
+    const result = advanceGameTime(definition, current.session, elapsedMs, input);
+    return {
+        key: runtimeKey,
+        session: result.session,
+        outputs: [...current.outputs, ...result.outputs],
+        revision: current.revision + 1,
+    };
+}
+/*** Resolve the nearest scheduled game consequence without owning domain timing rules. */
+function resolveNextScheduledDelay(scheduledEffects) {
+    return scheduledEffects.reduce((nearest, scheduled) => Math.min(nearest, scheduled.remainingMs), Number.POSITIVE_INFINITY);
+}
+//# sourceMappingURL=useGameScheduledEffects.js.map

package/dist/features/game/composition/useGameScheduledEffects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameScheduledEffects.js","sourceRoot":"","sources":["../../../../src/features/game/composition/useGameScheduledEffects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAuC,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,aAAa,EACb,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,GACkB;IAC5B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACzD,MAAM,OAAO,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAErD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtD,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC;YACvB,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CACrB,uBAAuB,CAAC;gBACtB,OAAO;gBACP,UAAU,EAAE,aAAa,CAAC,OAAO;gBACjC,SAAS;gBACT,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,UAAU;aACX,CAAC,CACH,CAAC;QACJ,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AACtF,CAAC;AAoBD,6FAA6F;AAC7F,SAAS,uBAAuB,CAAC,EAC/B,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,EACL,UAAU,GACkB;IAC5B,IAAI,OAAO,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,OAAO;QACL,GAAG,EAAE,UAAU;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,SAAS,yBAAyB,CAChC,gBAA0D;IAE1D,OAAO,gBAAgB,CAAC,MAAM,CAC5B,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,EAChE,MAAM,CAAC,iBAAiB,CACzB,CAAC;AACJ,CAAC","sourcesContent":["import { advanceGameTime, type GameDefinition, type GameInput } from '@ankhorage/game';\nimport React from 'react';\n\nimport type { GameRuntimeState } from '../../../types/gameRuntime';\n\ntype SetGameRuntime = React.Dispatch<React.SetStateAction<GameRuntimeState>>;\n\n/*** Advance the nearest scheduled game effects through one platform timer. */\nexport function useGameScheduledEffects({\n  clockRef,\n  definitionRef,\n  enabled,\n  inputRef,\n  runtimeKey,\n  scheduled,\n  setRuntime,\n}: UseGameScheduledEffectsArgs): void {\n  React.useEffect(() => {\n    if (!enabled || scheduled.length === 0) return undefined;\n    const delayMs = resolveNextScheduledDelay(scheduled);\n\n    const timer = setTimeout(() => {\n      const now = Date.now();\n      const elapsedMs = Math.max(0, now - clockRef.current);\n      clockRef.current = now;\n      setRuntime((current) =>\n        advanceScheduledRuntime({\n          current,\n          definition: definitionRef.current,\n          elapsedMs,\n          input: inputRef.current,\n          runtimeKey,\n        }),\n      );\n    }, delayMs);\n\n    return () => clearTimeout(timer);\n  }, [clockRef, definitionRef, enabled, inputRef, runtimeKey, scheduled, setRuntime]);\n}\n\ninterface UseGameScheduledEffectsArgs {\n  readonly clockRef: React.RefObject<number>;\n  readonly definitionRef: React.RefObject<GameDefinition>;\n  readonly enabled: boolean;\n  readonly inputRef: React.RefObject<GameInput>;\n  readonly runtimeKey: string;\n  readonly scheduled: GameRuntimeState['session']['scheduled'];\n  readonly setRuntime: SetGameRuntime;\n}\n\ninterface AdvanceScheduledRuntimeArgs {\n  readonly current: GameRuntimeState;\n  readonly definition: GameDefinition;\n  readonly elapsedMs: number;\n  readonly input: GameInput;\n  readonly runtimeKey: string;\n}\n\n/*** Advance one matching runtime state while preserving sessions that have already reset. */\nfunction advanceScheduledRuntime({\n  current,\n  definition,\n  elapsedMs,\n  input,\n  runtimeKey,\n}: AdvanceScheduledRuntimeArgs): GameRuntimeState {\n  if (current.key !== runtimeKey) return current;\n  const result = advanceGameTime(definition, current.session, elapsedMs, input);\n  return {\n    key: runtimeKey,\n    session: result.session,\n    outputs: [...current.outputs, ...result.outputs],\n    revision: current.revision + 1,\n  };\n}\n\n/*** Resolve the nearest scheduled game consequence without owning domain timing rules. */\nfunction resolveNextScheduledDelay(\n  scheduledEffects: GameRuntimeState['session']['scheduled'],\n): number {\n  return scheduledEffects.reduce(\n    (nearest, scheduled) => Math.min(nearest, scheduled.remainingMs),\n    Number.POSITIVE_INFINITY,\n  );\n}\n"]}