@ankhorage/zora-game 0.1.0 → 0.2.0

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

@@ -0,0 +1,103 @@
+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,
+    });
+    useGameOutputEmitter(runtime, outputRef);
+    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]);
+}
+/*** Emit each runtime output exactly when one execution revision becomes current. */
+function useGameOutputEmitter(runtime, outputRef) {
+    React.useEffect(() => {
+        emitGameOutputs(runtime.outputs, outputRef.current);
+    }, [outputRef, runtime.outputs, runtime.revision]);
+}
+/*** 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 === args.current ? [] : 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-presentation/composition/useGameRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameRuntime.js","sourceRoot":"","sources":["../../../../src/features/game-presentation/composition/useGameRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,gBAAgB,GAAc,EAAE,CAAC;AAEvC,wGAAwG;AACxG,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,gBAAgB,EAAE,IAAI,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IAChF,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAmB,GAAG,EAAE,CAClE,kBAAkB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAC3D,CAAC;IAEF,mBAAmB,CAAC;QAClB,QAAQ;QACR,aAAa;QACb,QAAQ;QACR,UAAU;QACV,IAAI;QACJ,UAAU;KACX,CAAC,CAAC;IACH,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAChC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CACrB,iBAAiB,CAAC;YAChB,eAAe;YACf,OAAO;YACP,UAAU,EAAE,aAAa,CAAC,OAAO;YACjC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;YAC9C,KAAK;YACL,KAAK,EAAE,QAAQ,CAAC,OAAO;YACvB,UAAU;YACV,IAAI;SACL,CAAC,CACH,CAAC;QACF,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC;IACzB,CAAC,EACD,CAAC,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAC7D,CAAC;IAEF,uBAAuB,CAAC;QACtB,QAAQ;QACR,aAAa;QACb,OAAO,EAAE,eAAe;QACxB,QAAQ;QACR,UAAU;QACV,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS;QACpC,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AACpG,CAAC;AAWD,iGAAiG;AACjG,SAAS,mBAAmB,CAAC,EAC3B,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACV,IAAI,EACJ,UAAU,GACW;IACrB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CACrB,OAAO,CAAC,GAAG,KAAK,UAAU;YACxB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,kBAAkB,CAChB,aAAa,CAAC,OAAO,EACrB,QAAQ,CAAC,OAAO,EAChB,IAAI,EACJ,UAAU,EACV,OAAO,CAAC,QAAQ,GAAG,CAAC,CACrB,CACN,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,qFAAqF;AACrF,SAAS,oBAAoB,CAC3B,OAAyB,EACzB,SAAiD;IAEjD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAaD,0FAA0F;AAC1F,SAAS,iBAAiB,CAAC,IAA2B;IACpD,MAAM,IAAI,GACR,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,UAAU;QAClC,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,kBAAkB,CAChB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,OAAO,CAAC,QAAQ,CACtB,CAAC;IACR,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe;QAChC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC;QAC5E,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtF,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,UAAU;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9F,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,kBAAkB,CACzB,UAAmC,EACnC,KAAgB,EAChB,IAAY,EACZ,GAAW,EACX,QAAgB;IAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC7E,CAAC;AAED,+FAA+F;AAC/F,SAAS,gBAAgB,CAAC,YAAoB,EAAE,QAAgB,EAAE,IAAY;IAC5E,OAAO,GAAG,YAAY,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,sEAAsE;AACtE,SAAS,eAAe,CAAC,OAA8B,EAAE,QAA+B;IACtF,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,uEAAuE;AACvE,SAAS,cAAc,CAAS,KAAa;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC;AACb,CAAC","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 { GameRuntimeContextValue, GameRuntimeState } 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): GameRuntimeContextValue {\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  useGameOutputEmitter(runtime, outputRef);\n\n  const dispatch = React.useCallback<GameRuntimeContextValue['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/*** Emit each runtime output exactly when one execution revision becomes current. */\nfunction useGameOutputEmitter(\n  runtime: GameRuntimeState,\n  outputRef: React.RefObject<GameProps['onOutput']>,\n): void {\n  React.useEffect(() => {\n    emitGameOutputs(runtime.outputs, outputRef.current);\n  }, [outputRef, runtime.outputs, runtime.revision]);\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 === args.current ? [] : 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-presentation/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-presentation/composition/useGameScheduledEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameScheduledEffects.d.ts","sourceRoot":"","sources":["../../../../src/features/game-presentation/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-presentation/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: 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-presentation/composition/useGameScheduledEffects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameScheduledEffects.js","sourceRoot":"","sources":["../../../../src/features/game-presentation/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,MAAM,CAAC,OAAO;QACvB,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: 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"]}

package/dist/features/game-presentation/meta/gameMeta.d.ts

@@ -0,0 +1,120 @@
+/*** Describe the embeddable config-driven Game runtime/presentation boundary for ZORA authoring. */
+export declare const gameMeta: {
+    readonly name: "Game";
+    readonly category: "pattern";
+    readonly description: "Embeds one config-driven game session inside ordinary ZORA layout and emits domain-neutral game outputs.";
+    readonly directManifestNode: true;
+    readonly allowedChildren: readonly ["GameEntity", "GameOverlay", "Gradient", "Image", "View"];
+    readonly blueprint: {
+        readonly label: "Game";
+        readonly defaultProps: {
+            readonly definition: {
+                readonly id: "game";
+                readonly initialPhase: "playing";
+                readonly stages: readonly [{
+                    readonly id: "main";
+                }];
+                readonly rules: readonly [];
+            };
+            readonly seed: 0;
+            readonly resetKey: "";
+            readonly autoAdvanceTime: true;
+            readonly minHeight: 320;
+            readonly clip: true;
+        };
+    };
+    readonly bindings: {
+        readonly props: {
+            readonly definition: {
+                readonly value: {
+                    readonly type: "object";
+                };
+                readonly acceptsFallback: true;
+            };
+            readonly input: {
+                readonly value: {
+                    readonly type: "record";
+                };
+                readonly acceptsFallback: true;
+            };
+        };
+    };
+    readonly events: {
+        readonly output: {
+            readonly label: "Game output";
+            readonly eventType: "game.output";
+            readonly description: "Emitted when the platform-neutral game runtime produces an app/domain output.";
+            readonly payloadFields: readonly [{
+                readonly path: "type";
+                readonly type: "string";
+            }, {
+                readonly path: "payload";
+                readonly type: "record";
+            }];
+        };
+    };
+    readonly props: {
+        readonly seed: {
+            readonly type: "number";
+            readonly category: "Runtime";
+            readonly label: "Initial seed";
+            readonly default: 0;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly resetKey: {
+            readonly type: "string";
+            readonly category: "Runtime";
+            readonly label: "Reset key";
+            readonly default: "";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly autoAdvanceTime: {
+            readonly type: "boolean";
+            readonly category: "Runtime";
+            readonly label: "Advance scheduled effects";
+            readonly default: true;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly aspectRatio: {
+            readonly type: "number";
+            readonly category: "Layout";
+            readonly label: "Aspect ratio";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly minHeight: {
+            readonly type: "number";
+            readonly category: "Layout";
+            readonly label: "Minimum height";
+            readonly default: 320;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly clip: {
+            readonly type: "boolean";
+            readonly category: "Layout";
+            readonly label: "Clip overflow";
+            readonly default: true;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly accessibilityLabel: {
+            readonly type: "string";
+            readonly category: "Accessibility";
+            readonly label: "Accessibility label";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+    };
+};
+//# sourceMappingURL=gameMeta.d.ts.map

package/dist/features/game-presentation/meta/gameMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameMeta.d.ts","sourceRoot":"","sources":["../../../../src/features/game-presentation/meta/gameMeta.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FiB,CAAC"}

package/dist/features/game-presentation/meta/gameMeta.js

@@ -0,0 +1,97 @@
+/*** Describe the embeddable config-driven Game runtime/presentation boundary for ZORA authoring. */
+export const gameMeta = {
+    name: 'Game',
+    category: 'pattern',
+    description: 'Embeds one config-driven game session inside ordinary ZORA layout and emits domain-neutral game outputs.',
+    directManifestNode: true,
+    allowedChildren: ['GameEntity', 'GameOverlay', 'Gradient', 'Image', 'View'],
+    blueprint: {
+        label: 'Game',
+        defaultProps: {
+            definition: {
+                id: 'game',
+                initialPhase: 'playing',
+                stages: [{ id: 'main' }],
+                rules: [],
+            },
+            seed: 0,
+            resetKey: '',
+            autoAdvanceTime: true,
+            minHeight: 320,
+            clip: true,
+        },
+    },
+    bindings: {
+        props: {
+            definition: {
+                value: { type: 'object' },
+                acceptsFallback: true,
+            },
+            input: {
+                value: { type: 'record' },
+                acceptsFallback: true,
+            },
+        },
+    },
+    events: {
+        output: {
+            label: 'Game output',
+            eventType: 'game.output',
+            description: 'Emitted when the platform-neutral game runtime produces an app/domain output.',
+            payloadFields: [
+                { path: 'type', type: 'string' },
+                { path: 'payload', type: 'record' },
+            ],
+        },
+    },
+    props: {
+        seed: {
+            type: 'number',
+            category: 'Runtime',
+            label: 'Initial seed',
+            default: 0,
+            authoring: { authority: 'instance' },
+        },
+        resetKey: {
+            type: 'string',
+            category: 'Runtime',
+            label: 'Reset key',
+            default: '',
+            authoring: { authority: 'instance' },
+        },
+        autoAdvanceTime: {
+            type: 'boolean',
+            category: 'Runtime',
+            label: 'Advance scheduled effects',
+            default: true,
+            authoring: { authority: 'instance' },
+        },
+        aspectRatio: {
+            type: 'number',
+            category: 'Layout',
+            label: 'Aspect ratio',
+            authoring: { authority: 'instance' },
+        },
+        minHeight: {
+            type: 'number',
+            category: 'Layout',
+            label: 'Minimum height',
+            default: 320,
+            authoring: { authority: 'instance' },
+        },
+        clip: {
+            type: 'boolean',
+            category: 'Layout',
+            label: 'Clip overflow',
+            default: true,
+            authoring: { authority: 'instance' },
+        },
+        accessibilityLabel: {
+            type: 'string',
+            category: 'Accessibility',
+            label: 'Accessibility label',
+            authoring: { authority: 'instance' },
+        },
+    },
+};
+//# sourceMappingURL=gameMeta.js.map

package/dist/features/game-presentation/meta/gameMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameMeta.js","sourceRoot":"","sources":["../../../../src/features/game-presentation/meta/gameMeta.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,SAAS;IACnB,WAAW,EACT,0GAA0G;IAC5G,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAC3E,SAAS,EAAE;QACT,KAAK,EAAE,MAAM;QACb,YAAY,EAAE;YACZ,UAAU,EAAE;gBACV,EAAE,EAAE,MAAM;gBACV,YAAY,EAAE,SAAS;gBACvB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;gBACxB,KAAK,EAAE,EAAE;aACV;YACD,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,EAAE;YACZ,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,GAAG;YACd,IAAI,EAAE,IAAI;SACX;KACF;IACD,QAAQ,EAAE;QACR,KAAK,EAAE;YACL,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,eAAe,EAAE,IAAI;aACtB;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,eAAe,EAAE,IAAI;aACtB;SACF;KACF;IACD,MAAM,EAAE;QACN,MAAM,EAAE;YACN,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,aAAa;YACxB,WAAW,EAAE,+EAA+E;YAC5F,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;aACpC;SACF;KACF;IACD,KAAK,EAAE;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,2BAA2B;YAClC,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,cAAc;YACrB,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,gBAAgB;YACvB,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;QACD,kBAAkB,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,qBAAqB;YAC5B,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SACrC;KACF;CACmC,CAAC","sourcesContent":["import type { ZoraComponentMeta } from '@ankhorage/zora/metadata';\n\n/*** Describe the embeddable config-driven Game runtime/presentation boundary for ZORA authoring. */\nexport const gameMeta = {\n  name: 'Game',\n  category: 'pattern',\n  description:\n    'Embeds one config-driven game session inside ordinary ZORA layout and emits domain-neutral game outputs.',\n  directManifestNode: true,\n  allowedChildren: ['GameEntity', 'GameOverlay', 'Gradient', 'Image', 'View'],\n  blueprint: {\n    label: 'Game',\n    defaultProps: {\n      definition: {\n        id: 'game',\n        initialPhase: 'playing',\n        stages: [{ id: 'main' }],\n        rules: [],\n      },\n      seed: 0,\n      resetKey: '',\n      autoAdvanceTime: true,\n      minHeight: 320,\n      clip: true,\n    },\n  },\n  bindings: {\n    props: {\n      definition: {\n        value: { type: 'object' },\n        acceptsFallback: true,\n      },\n      input: {\n        value: { type: 'record' },\n        acceptsFallback: true,\n      },\n    },\n  },\n  events: {\n    output: {\n      label: 'Game output',\n      eventType: 'game.output',\n      description: 'Emitted when the platform-neutral game runtime produces an app/domain output.',\n      payloadFields: [\n        { path: 'type', type: 'string' },\n        { path: 'payload', type: 'record' },\n      ],\n    },\n  },\n  props: {\n    seed: {\n      type: 'number',\n      category: 'Runtime',\n      label: 'Initial seed',\n      default: 0,\n      authoring: { authority: 'instance' },\n    },\n    resetKey: {\n      type: 'string',\n      category: 'Runtime',\n      label: 'Reset key',\n      default: '',\n      authoring: { authority: 'instance' },\n    },\n    autoAdvanceTime: {\n      type: 'boolean',\n      category: 'Runtime',\n      label: 'Advance scheduled effects',\n      default: true,\n      authoring: { authority: 'instance' },\n    },\n    aspectRatio: {\n      type: 'number',\n      category: 'Layout',\n      label: 'Aspect ratio',\n      authoring: { authority: 'instance' },\n    },\n    minHeight: {\n      type: 'number',\n      category: 'Layout',\n      label: 'Minimum height',\n      default: 320,\n      authoring: { authority: 'instance' },\n    },\n    clip: {\n      type: 'boolean',\n      category: 'Layout',\n      label: 'Clip overflow',\n      default: true,\n      authoring: { authority: 'instance' },\n    },\n    accessibilityLabel: {\n      type: 'string',\n      category: 'Accessibility',\n      label: 'Accessibility label',\n      authoring: { authority: 'instance' },\n    },\n  },\n} as const satisfies ZoraComponentMeta;\n"]}

package/dist/features/game-presentation/public.d.ts

@@ -1,4 +1,5 @@
-export type { GameEntityProps, GameFieldProps, GameOverlayPlacement, GameOverlayProps, GamePointerEvents, } from '../../types/gamePresentation';
+export type { GameEntityProps, GameFieldProps, GameOverlayPlacement, GameOverlayProps, GamePointerEvents, GameProps, } from '../../types/gamePresentation';
+export { Game } from './adapters/inbound/Game';
 export { GameEntity } from './adapters/inbound/GameEntity';
 export { GameField } from './adapters/inbound/GameField';
 export { GameOverlay } from './adapters/inbound/GameOverlay';

package/dist/features/game-presentation/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/game-presentation/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/game-presentation/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/features/game-presentation/public.js

@@ -1,3 +1,4 @@
+export { Game } from './adapters/inbound/Game';
 export { GameEntity } from './adapters/inbound/GameEntity';
 export { GameField } from './adapters/inbound/GameField';
 export { GameOverlay } from './adapters/inbound/GameOverlay';

package/dist/features/game-presentation/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/game-presentation/public.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["export type {\n  GameEntityProps,\n  GameFieldProps,\n  GameOverlayPlacement,\n  GameOverlayProps,\n  GamePointerEvents,\n} from '../../types/gamePresentation';\nexport { GameEntity } from './adapters/inbound/GameEntity';\nexport { GameField } from './adapters/inbound/GameField';\nexport { GameOverlay } from './adapters/inbound/GameOverlay';\n"]}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/game-presentation/public.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC","sourcesContent":["export type {\n  GameEntityProps,\n  GameFieldProps,\n  GameOverlayPlacement,\n  GameOverlayProps,\n  GamePointerEvents,\n  GameProps,\n} from '../../types/gamePresentation';\nexport { Game } from './adapters/inbound/Game';\nexport { GameEntity } from './adapters/inbound/GameEntity';\nexport { GameField } from './adapters/inbound/GameField';\nexport { GameOverlay } from './adapters/inbound/GameOverlay';\n"]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { GameEntityProps, GameFieldProps, GameOverlayPlacement, GameOverlayProps, GamePointerEvents, } from './features/game-presentation/public';
-export { GameEntity, GameField, GameOverlay } from './features/game-presentation/public';
+export type { GameEntityProps, GameFieldProps, GameOverlayPlacement, GameOverlayProps, GamePointerEvents, GameProps, } from './features/game-presentation/public';
+export { Game, GameEntity, GameField, GameOverlay } from './features/game-presentation/public';
 export { ZORA_GAME_PLUGIN } from './ZORA_GAME_PLUGIN';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { GameEntity, GameField, GameOverlay } from './features/game-presentation/public';
+export { Game, GameEntity, GameField, GameOverlay } from './features/game-presentation/public';
 export { ZORA_GAME_PLUGIN } from './ZORA_GAME_PLUGIN';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type {\n  GameEntityProps,\n  GameFieldProps,\n  GameOverlayPlacement,\n  GameOverlayProps,\n  GamePointerEvents,\n} from './features/game-presentation/public';\nexport { GameEntity, GameField, GameOverlay } from './features/game-presentation/public';\nexport { ZORA_GAME_PLUGIN } from './ZORA_GAME_PLUGIN';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type {\n  GameEntityProps,\n  GameFieldProps,\n  GameOverlayPlacement,\n  GameOverlayProps,\n  GamePointerEvents,\n  GameProps,\n} from './features/game-presentation/public';\nexport { Game, GameEntity, GameField, GameOverlay } from './features/game-presentation/public';\nexport { ZORA_GAME_PLUGIN } from './ZORA_GAME_PLUGIN';\n"]}

package/dist/types/gamePresentation.d.ts

@@ -1,3 +1,4 @@
+import type { GameDefinition, GameInput, GameOutput } from '@ankhorage/game';
 import type React from 'react';
 type GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 export type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';
@@ -33,5 +34,13 @@ export interface GameOverlayProps {
     readonly accessibilityLabel?: string;
     readonly testID?: string;
 }
+export interface GameProps extends GameFieldProps {
+    readonly definition: GameDefinition;
+    readonly input?: GameInput;
+    readonly seed?: number;
+    readonly resetKey?: string;
+    readonly autoAdvanceTime?: boolean;
+    readonly onOutput?: (output: GameOutput) => void;
+}
 export {};
 //# sourceMappingURL=gamePresentation.d.ts.map

package/dist/types/gamePresentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gamePresentation.d.ts","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,0BAA0B,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAC9B,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,0BAA0B,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"gamePresentation.d.ts","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,0BAA0B,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAC9B,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,0BAA0B,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;CAClD"}

package/dist/types/gamePresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"gamePresentation.js","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\ntype GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';\n\nexport type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';\nexport type GameOverlayPlacement =\n  'fill' | 'center' | 'top' | 'bottom' | GameOverlayCornerPlacement;\n\nexport interface GameFieldProps {\n  readonly children?: React.ReactNode;\n  readonly aspectRatio?: number;\n  readonly minHeight?: number;\n  readonly clip?: boolean;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameEntityProps {\n  readonly children?: React.ReactNode;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly opacity?: number;\n  readonly scale?: number;\n  readonly rotation?: number;\n  readonly zIndex?: number;\n  readonly hidden?: boolean;\n  readonly pointerEvents?: GamePointerEvents;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameOverlayProps {\n  readonly children?: React.ReactNode;\n  readonly placement?: GameOverlayPlacement;\n  readonly blocking?: boolean;\n  readonly padding?: number;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n"]}
+{"version":3,"file":"gamePresentation.js","sourceRoot":"","sources":["../../src/types/gamePresentation.ts"],"names":[],"mappings":"","sourcesContent":["import type { GameDefinition, GameInput, GameOutput } from '@ankhorage/game';\nimport type React from 'react';\n\ntype GameOverlayCornerPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';\n\nexport type GamePointerEvents = 'auto' | 'box-none' | 'box-only' | 'none';\nexport type GameOverlayPlacement =\n  'fill' | 'center' | 'top' | 'bottom' | GameOverlayCornerPlacement;\n\nexport interface GameFieldProps {\n  readonly children?: React.ReactNode;\n  readonly aspectRatio?: number;\n  readonly minHeight?: number;\n  readonly clip?: boolean;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameEntityProps {\n  readonly children?: React.ReactNode;\n  readonly x?: number;\n  readonly y?: number;\n  readonly width?: number;\n  readonly height?: number;\n  readonly opacity?: number;\n  readonly scale?: number;\n  readonly rotation?: number;\n  readonly zIndex?: number;\n  readonly hidden?: boolean;\n  readonly pointerEvents?: GamePointerEvents;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameOverlayProps {\n  readonly children?: React.ReactNode;\n  readonly placement?: GameOverlayPlacement;\n  readonly blocking?: boolean;\n  readonly padding?: number;\n  readonly accessibilityLabel?: string;\n  readonly testID?: string;\n}\n\nexport interface GameProps extends GameFieldProps {\n  readonly definition: GameDefinition;\n  readonly input?: GameInput;\n  readonly seed?: number;\n  readonly resetKey?: string;\n  readonly autoAdvanceTime?: boolean;\n  readonly onOutput?: (output: GameOutput) => void;\n}\n"]}

package/dist/types/gameRuntime.d.ts

@@ -0,0 +1,12 @@
+import type { GameEvent, GameOutput, GameSession } from '@ankhorage/game';
+export interface GameRuntimeContextValue {
+    readonly session: GameSession;
+    readonly dispatch: (event: GameEvent) => void;
+}
+export interface GameRuntimeState {
+    readonly key: string;
+    readonly session: GameSession;
+    readonly outputs: readonly GameOutput[];
+    readonly revision: number;
+}
+//# sourceMappingURL=gameRuntime.d.ts.map

package/dist/types/gameRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameRuntime.d.ts","sourceRoot":"","sources":["../../src/types/gameRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/gameRuntime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gameRuntime.js.map

package/dist/types/gameRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameRuntime.js","sourceRoot":"","sources":["../../src/types/gameRuntime.ts"],"names":[],"mappings":"","sourcesContent":["import type { GameEvent, GameOutput, GameSession } from '@ankhorage/game';\n\nexport interface GameRuntimeContextValue {\n  readonly session: GameSession;\n  readonly dispatch: (event: GameEvent) => void;\n}\n\nexport interface GameRuntimeState {\n  readonly key: string;\n  readonly session: GameSession;\n  readonly outputs: readonly GameOutput[];\n  readonly revision: number;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/zora-game",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Generic game presentation primitives for React Native and React Native Web apps built on ZORA.",
   "homepage": "https://github.com/ankhorage/zora-game#readme",
@@ -91,5 +91,8 @@
     "react-native-web": "~0.21.0",
     "typescript": "~6.0.3"
   },
-  "packageManager": "bun@1.4.2"
+  "packageManager": "bun@1.4.2",
+  "dependencies": {
+    "@ankhorage/game": "^0.1.0"
+  }
 }

package/src/ZORA_GAME_COMPONENT_META.ts

@@ -1,9 +1,11 @@
 import { gameEntityMeta } from './features/game-presentation/meta/gameEntityMeta';
 import { gameFieldMeta } from './features/game-presentation/meta/gameFieldMeta';
+import { gameMeta } from './features/game-presentation/meta/gameMeta';
 import { gameOverlayMeta } from './features/game-presentation/meta/gameOverlayMeta';
 
 /*** Register the generic game presentation metadata owned by this package. */
 export const ZORA_GAME_COMPONENT_META = {
+  Game: gameMeta,
   GameEntity: gameEntityMeta,
   GameField: gameFieldMeta,
   GameOverlay: gameOverlayMeta,

package/src/ZORA_GAME_PLUGIN.ts

@@ -1,3 +1,4 @@
+import { Game } from './features/game-presentation/adapters/inbound/Game';
 import { GameEntity } from './features/game-presentation/adapters/inbound/GameEntity';
 import { GameField } from './features/game-presentation/adapters/inbound/GameField';
 import { GameOverlay } from './features/game-presentation/adapters/inbound/GameOverlay';
@@ -7,6 +8,7 @@ import { ZORA_PLUGIN_METADATA } from './ZORA_PLUGIN_METADATA';
 export const ZORA_GAME_PLUGIN = {
   ...ZORA_PLUGIN_METADATA,
   componentRegistry: {
+    Game,
     GameEntity,
     GameField,
     GameOverlay,