@ankhorage/zora 21.0.23 → 21.1.0

package/dist/features/game/adapters/inbound/createGameMeasurementEvent.js

@@ -0,0 +1,25 @@
+/*** Create one raw geometry event without deciding collision semantics. */
+export function createGameMeasurementEvent(input) {
+    return {
+        type: input.eventType,
+        entityId: input.entityId ?? input.sourceId,
+        payload: {
+            sourceId: input.sourceId,
+            targetId: input.targetId,
+            source: toGameMeasurementRecord(input.source),
+            target: toGameMeasurementRecord(input.target),
+        },
+    };
+}
+/*** Convert measured geometry into a serializable Game record. */
+function toGameMeasurementRecord(bounds) {
+    return {
+        left: bounds.left,
+        right: bounds.right,
+        top: bounds.top,
+        bottom: bounds.bottom,
+        width: bounds.width,
+        height: bounds.height,
+    };
+}
+//# sourceMappingURL=createGameMeasurementEvent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createGameMeasurementEvent.js","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/createGameMeasurementEvent.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,MAAM,UAAU,0BAA0B,CAAC,KAAsC;IAC/E,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,SAAS;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ;QAC1C,OAAO,EAAE;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC;YAC7C,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC;SAC9C;KACF,CAAC;AACJ,CAAC;AAWD,kEAAkE;AAClE,SAAS,uBAAuB,CAAC,MAA6B;IAC5D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC","sourcesContent":["import type { GameEvent, GameRecord } from '@ankhorage/game';\n\nimport type { GameMeasurementBounds } from '../../../../types/gameRuntime';\n\n/*** Create one raw geometry event without deciding collision semantics. */\nexport function createGameMeasurementEvent(input: CreateGameMeasurementEventInput): GameEvent {\n  return {\n    type: input.eventType,\n    entityId: input.entityId ?? input.sourceId,\n    payload: {\n      sourceId: input.sourceId,\n      targetId: input.targetId,\n      source: toGameMeasurementRecord(input.source),\n      target: toGameMeasurementRecord(input.target),\n    },\n  };\n}\n\ninterface CreateGameMeasurementEventInput {\n  readonly eventType: string;\n  readonly entityId?: string;\n  readonly sourceId: string;\n  readonly targetId: string;\n  readonly source: GameMeasurementBounds;\n  readonly target: GameMeasurementBounds;\n}\n\n/*** Convert measured geometry into a serializable Game record. */\nfunction toGameMeasurementRecord(bounds: GameMeasurementBounds): GameRecord {\n  return {\n    left: bounds.left,\n    right: bounds.right,\n    top: bounds.top,\n    bottom: bounds.bottom,\n    width: bounds.width,\n    height: bounds.height,\n  };\n}\n"]}

package/dist/features/game/adapters/inbound/createGamePointerEvent.d.ts

@@ -0,0 +1,17 @@
+import type { GameEvent } from '@ankhorage/game';
+interface GamePointerEventInput {
+    readonly eventType: string;
+    readonly entityId?: string;
+    readonly localX: number;
+    readonly localY: number;
+    readonly measuredWidth: number;
+    readonly measuredHeight: number;
+    readonly zoneX: number;
+    readonly zoneY: number;
+    readonly zoneWidth: number;
+    readonly zoneHeight: number;
+}
+/*** Normalize one measured pointer/touch position into a field-relative generic Game event. */
+export declare function createGamePointerEvent(input: GamePointerEventInput): GameEvent | undefined;
+export {};
+//# sourceMappingURL=createGamePointerEvent.d.ts.map

package/dist/features/game/adapters/inbound/createGamePointerEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGamePointerEvent.d.ts","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/createGamePointerEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GAAG,SAAS,CAoB1F"}

package/dist/features/game/adapters/inbound/createGamePointerEvent.js

@@ -0,0 +1,20 @@
+import { clampGamePercentage } from '../../utils/clampGamePercentage';
+/*** Normalize one measured pointer/touch position into a field-relative generic Game event. */
+export function createGamePointerEvent(input) {
+    if (!Number.isFinite(input.measuredWidth) ||
+        !Number.isFinite(input.measuredHeight) ||
+        input.measuredWidth <= 0 ||
+        input.measuredHeight <= 0) {
+        return undefined;
+    }
+    const localX = clampGamePercentage((input.localX / input.measuredWidth) * 100);
+    const localY = clampGamePercentage((input.localY / input.measuredHeight) * 100);
+    const x = clampGamePercentage(input.zoneX + (localX * input.zoneWidth) / 100);
+    const y = clampGamePercentage(input.zoneY + (localY * input.zoneHeight) / 100);
+    return {
+        type: input.eventType,
+        ...(input.entityId === undefined ? {} : { entityId: input.entityId }),
+        payload: { x, y },
+    };
+}
+//# sourceMappingURL=createGamePointerEvent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createGamePointerEvent.js","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/createGamePointerEvent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAetE,+FAA+F;AAC/F,MAAM,UAAU,sBAAsB,CAAC,KAA4B;IACjE,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC;QACrC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC;QACtC,KAAK,CAAC,aAAa,IAAI,CAAC;QACxB,KAAK,CAAC,cAAc,IAAI,CAAC,EACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,mBAAmB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,CAAC;IAChF,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9E,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;IAE/E,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,SAAS;QACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;KAClB,CAAC;AACJ,CAAC","sourcesContent":["import type { GameEvent } from '@ankhorage/game';\n\nimport { clampGamePercentage } from '../../utils/clampGamePercentage';\n\ninterface GamePointerEventInput {\n  readonly eventType: string;\n  readonly entityId?: string;\n  readonly localX: number;\n  readonly localY: number;\n  readonly measuredWidth: number;\n  readonly measuredHeight: number;\n  readonly zoneX: number;\n  readonly zoneY: number;\n  readonly zoneWidth: number;\n  readonly zoneHeight: number;\n}\n\n/*** Normalize one measured pointer/touch position into a field-relative generic Game event. */\nexport function createGamePointerEvent(input: GamePointerEventInput): GameEvent | undefined {\n  if (\n    !Number.isFinite(input.measuredWidth) ||\n    !Number.isFinite(input.measuredHeight) ||\n    input.measuredWidth <= 0 ||\n    input.measuredHeight <= 0\n  ) {\n    return undefined;\n  }\n\n  const localX = clampGamePercentage((input.localX / input.measuredWidth) * 100);\n  const localY = clampGamePercentage((input.localY / input.measuredHeight) * 100);\n  const x = clampGamePercentage(input.zoneX + (localX * input.zoneWidth) / 100);\n  const y = clampGamePercentage(input.zoneY + (localY * input.zoneHeight) / 100);\n\n  return {\n    type: input.eventType,\n    ...(input.entityId === undefined ? {} : { entityId: input.entityId }),\n    payload: { x, y },\n  };\n}\n"]}

package/dist/features/game/adapters/inbound/measureGameEntity.d.ts

@@ -0,0 +1,5 @@
+import type { View } from 'react-native';
+import type { GameMeasurementBounds } from '../../../../types/gameRuntime';
+/*** Measure one rendered React Native or React Native Web game entity in window coordinates. */
+export declare function measureGameEntity(element: View | null): Promise<GameMeasurementBounds | undefined>;
+//# sourceMappingURL=measureGameEntity.d.ts.map

package/dist/features/game/adapters/inbound/measureGameEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureGameEntity.d.ts","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/measureGameEntity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,gGAAgG;AAChG,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,IAAI,GAAG,IAAI,GACnB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAoB5C"}

package/dist/features/game/adapters/inbound/measureGameEntity.js

@@ -0,0 +1,22 @@
+/*** Measure one rendered React Native or React Native Web game entity in window coordinates. */
+export function measureGameEntity(element) {
+    if (element === null)
+        return Promise.resolve(undefined);
+    return new Promise((resolve) => {
+        element.measureInWindow((left, top, width, height) => {
+            if (![left, top, width, height].every(Number.isFinite) || width < 0 || height < 0) {
+                resolve(undefined);
+                return;
+            }
+            resolve({
+                left,
+                right: left + width,
+                top,
+                bottom: top + height,
+                width,
+                height,
+            });
+        });
+    });
+}
+//# sourceMappingURL=measureGameEntity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measureGameEntity.js","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/measureGameEntity.ts"],"names":[],"mappings":"AAIA,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAC/B,OAAoB;IAEpB,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACnD,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClF,OAAO,CAAC,SAAS,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC;gBACN,IAAI;gBACJ,KAAK,EAAE,IAAI,GAAG,KAAK;gBACnB,GAAG;gBACH,MAAM,EAAE,GAAG,GAAG,MAAM;gBACpB,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { View } from 'react-native';\n\nimport type { GameMeasurementBounds } from '../../../../types/gameRuntime';\n\n/*** Measure one rendered React Native or React Native Web game entity in window coordinates. */\nexport function measureGameEntity(\n  element: View | null,\n): Promise<GameMeasurementBounds | undefined> {\n  if (element === null) return Promise.resolve(undefined);\n\n  return new Promise((resolve) => {\n    element.measureInWindow((left, top, width, height) => {\n      if (![left, top, width, height].every(Number.isFinite) || width < 0 || height < 0) {\n        resolve(undefined);\n        return;\n      }\n\n      resolve({\n        left,\n        right: left + width,\n        top,\n        bottom: top + height,\n        width,\n        height,\n      });\n    });\n  });\n}\n"]}

package/dist/features/game/adapters/inbound/useGameInputZoneResponder.d.ts

@@ -0,0 +1,15 @@
+import type { GestureResponderEvent, LayoutChangeEvent } from 'react-native';
+import type { GameInputZoneProps } from '../../../../types/gamePresentation';
+interface GameKeyboardInputEvent {
+    readonly key: string;
+    preventDefault(): void;
+}
+/*** Own React Native responder measurement and event dispatch for one Game input zone. */
+export declare function useGameInputZoneResponder(props: GameInputZoneProps): {
+    dispatchKeyboard: (event: GameKeyboardInputEvent) => void;
+    dispatchPointer: (event: GestureResponderEvent) => void;
+    handleLayout: (event: LayoutChangeEvent) => void;
+    shouldSetResponder: () => boolean;
+};
+export {};
+//# sourceMappingURL=useGameInputZoneResponder.d.ts.map

package/dist/features/game/adapters/inbound/useGameInputZoneResponder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameInputZoneResponder.d.ts","sourceRoot":"","sources":["../../../../../src/features/game/adapters/inbound/useGameInputZoneResponder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAK7E,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,cAAc,IAAI,IAAI,CAAC;CACxB;AAOD,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,kBAAkB;8BAyCvD,sBAAsB;6BA9BtB,qBAAqB;0BANgB,iBAAiB;;EA4DjE"}

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

@@ -0,0 +1,67 @@
+import React from 'react';
+import { GameRuntimeContext } from '../../composition/GameRuntimeContext';
+import { createGameKeyboardEvent } from './createGameKeyboardEvent';
+import { createGamePointerEvent } from './createGamePointerEvent';
+/*** Own React Native responder measurement and event dispatch for one Game input zone. */
+export function useGameInputZoneResponder(props) {
+    const runtime = React.useContext(GameRuntimeContext);
+    if (runtime === null)
+        throw new Error('GameInputZone must be rendered inside Game.');
+    const measuredSizeRef = React.useRef({ width: 0, height: 0 });
+    const handleLayout = React.useCallback((event) => {
+        const { width, height } = event.nativeEvent.layout;
+        measuredSizeRef.current = { width, height };
+    }, []);
+    const dispatchPointer = React.useCallback((event) => {
+        if (runtime.interactionPolicy === 'passive' || props.interactionPolicy === 'passive')
+            return;
+        const measured = measuredSizeRef.current;
+        const gameEvent = createGamePointerEvent({
+            eventType: props.eventType,
+            ...(props.entityId === undefined ? {} : { entityId: props.entityId }),
+            localX: event.nativeEvent.locationX,
+            localY: event.nativeEvent.locationY,
+            measuredWidth: measured.width,
+            measuredHeight: measured.height,
+            zoneX: props.x ?? 0,
+            zoneY: props.y ?? 0,
+            zoneWidth: props.width ?? 100,
+            zoneHeight: props.height ?? 100,
+        });
+        if (gameEvent !== undefined)
+            runtime.dispatch(gameEvent);
+    }, [
+        props.entityId,
+        props.eventType,
+        props.height,
+        props.interactionPolicy,
+        props.width,
+        props.x,
+        props.y,
+        runtime,
+    ]);
+    const dispatchKeyboard = React.useCallback((event) => {
+        if (runtime.interactionPolicy === 'passive' || props.interactionPolicy === 'passive')
+            return;
+        const result = createGameKeyboardEvent({
+            bindings: props.keyboardBindings ?? [],
+            fallbackEventType: props.eventType,
+            ...(props.entityId === undefined ? {} : { fallbackEntityId: props.entityId }),
+            key: event.key,
+        });
+        if (result === undefined)
+            return;
+        if (result.preventDefault)
+            event.preventDefault();
+        runtime.dispatch(result.event);
+    }, [props.entityId, props.eventType, props.interactionPolicy, props.keyboardBindings, runtime]);
+    return {
+        dispatchKeyboard,
+        dispatchPointer,
+        handleLayout,
+        shouldSetResponder: () => (props.enabled ?? true) &&
+            props.interactionPolicy !== 'passive' &&
+            runtime.interactionPolicy !== 'passive',
+    };
+}
+//# sourceMappingURL=useGameInputZoneResponder.js.map

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"]}