rn-gamekit 0.1.0 → 0.2.1

package/lib/typescript/src/react/useGameSession.d.ts

@@ -0,0 +1,48 @@
+import type { GameSession } from '../core/session/types.js';
+import type { GameDefinition, InputMap, SceneMap } from '../definition/types.js';
+type SessionCreator<TScenes extends SceneMap, TInput extends InputMap> = (definition: GameDefinition<TScenes, TInput>) => GameSession<TScenes, TInput>;
+/**
+ * Create and own a `GameSession` for a `GameDefinition`, with React
+ * ownership.
+ *
+ * The hook creates an idle session during the commit phase, publishes it,
+ * and disposes it exactly once when it is replaced or the owner unmounts.
+ * React Strict Mode's development setup/cleanup rehearsal is safe: every
+ * rehearsal session is disposed exactly once and a disposed session is never
+ * published.
+ *
+ * Ownership rules:
+ *
+ * - The return value is `undefined` until React commits a live session for
+ *   the current definition: the initial render, and the boundary while a
+ *   definition replacement is being created. Render a deliberate fallback
+ *   instead of hiding it.
+ * - The same definition object returns the same session across re-renders.
+ *   A different definition object unpublishes the old session, disposes it,
+ *   and publishes a fresh one. Disposed sessions are never revived, so
+ *   declaring definitions at module scope keeps identity stable.
+ * - The hook owns terminal disposal. Do not call `session.dispose()` on a
+ *   hook-owned session.
+ * - The hook does not start the session. Pass it to `GameView`, which binds,
+ *   starts, pauses on unmount/backgrounding, and never terminally disposes a
+ *   borrowed session.
+ * - For an asset-backed game, mount the component that calls this hook only
+ *   after `useGameAssets()` reports `ready`; this hook does not load assets.
+ *
+ * Use `createGameSession()` with explicit `try/finally` disposal for headless
+ * tests, non-React programs, and custom surface controllers that need to own
+ * sessions imperatively.
+ */
+export declare function useGameSession<TScenes extends SceneMap, TInput extends InputMap>(definition: GameDefinition<TScenes, TInput>): GameSession<TScenes, TInput> | undefined;
+/**
+ * @internal
+ *
+ * The injectable-creator seam behind `useGameSession`, exported from this
+ * module only (never from the `rn-gamekit/react` barrel). Tests supply a
+ * deterministic creator (for example `createGameSessionWithDriver` with a
+ * `ManualFrameDriver`, since node has no `requestAnimationFrame`) and must
+ * pass a stable factory identity across renders.
+ */
+export declare function useOwnedGameSession<TScenes extends SceneMap, TInput extends InputMap>(definition: GameDefinition<TScenes, TInput>, create: SessionCreator<TScenes, TInput>): GameSession<TScenes, TInput> | undefined;
+export {};
+//# sourceMappingURL=useGameSession.d.ts.map

package/lib/typescript/src/react/useGameSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameSession.d.ts","sourceRoot":"","sources":["../../../../src/react/useGameSession.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAE9E,KAAK,cAAc,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,IAAI,CACvE,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,KACxC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AASlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAC9E,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1C,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,SAAS,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EACnF,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,EAC3C,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,GACtC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,SAAS,CAuB1C"}

package/lib/typescript/src/react/useGameSessionStatus.d.ts

@@ -0,0 +1,23 @@
+import type { GameSession, GameSessionStatus } from '../core/session/types.js';
+import type { InputMap, SceneMap } from '../definition/types.js';
+/**
+ * Observe a session's lifecycle status from React.
+ *
+ * Returns the current `session.status` on the render that observes a
+ * session, and re-renders once per actual lifecycle transition. `undefined`
+ * means no session is currently available — the same meaning Task 9's
+ * `useGameSession()` gives its pre-commit value, so both hooks compose
+ * unconditionally:
+ *
+ * ```ts
+ * const session = useGameSession(game);
+ * const status = useGameSessionStatus(session);
+ * ```
+ *
+ * The hook subscribes through `addStatusListener` and never polls; it owns
+ * no session and never disposes one. Replacing the session argument detaches
+ * the old subscription before the replacement's status is reported, and
+ * idempotent lifecycle commands do not cause redundant re-renders.
+ */
+export declare function useGameSessionStatus<TScenes extends SceneMap, TInput extends InputMap>(session: GameSession<TScenes, TInput> | undefined): GameSessionStatus | undefined;
+//# sourceMappingURL=useGameSessionStatus.d.ts.map

package/lib/typescript/src/react/useGameSessionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameSessionStatus.d.ts","sourceRoot":"","sources":["../../../../src/react/useGameSessionStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAK9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,SAAS,QAAQ,EACxB,MAAM,SAAS,QAAQ,EACvB,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAuBlF"}

package/lib/typescript/src/react/viewportBinding.d.ts

@@ -29,7 +29,11 @@ export declare class ViewportBinding {
     setSurfaceSize(size: SurfaceSize): void;
     /** Observe layout revisions. Returns an idempotent unsubscribe. */
     subscribe(listener: () => void): () => void;
-    /** Release subscribers. The binding becomes inert. */
+    /**
+     * Release current subscribers (GS-VIEWPORT-01). This is not a lifecycle
+     * gate: late subscriptions still register and setSurfaceSize still
+     * resolves. Discard the binding after disposal instead of reusing it.
+     */
     dispose(): void;
 }
 /**

package/lib/typescript/src/react/viewportBinding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewportBinding.d.ts","sourceRoot":"","sources":["../../../../src/react/viewportBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAe,CAAC;AAE5G;;;;;;;;;GASG;AACH,qBAAa,eAAe;;gBAOd,MAAM,EAAE,QAAQ;IAI5B,iEAAiE;IACjE,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,gFAAgF;IAChF,IAAI,QAAQ,IAAI,kBAAkB,GAAG,SAAS,CAE7C;IAED,6EAA6E;IAC7E,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,8DAA8D;IAC9D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAgBvC,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAY3C,sDAAsD;IACtD,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,eAAe,GAAG,IAAI,GAC/B,eAAe,CAUjB"}
+{"version":3,"file":"viewportBinding.d.ts","sourceRoot":"","sources":["../../../../src/react/viewportBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAe,CAAC;AAE5G;;;;;;;;;GASG;AACH,qBAAa,eAAe;;gBAOd,MAAM,EAAE,QAAQ;IAI5B,iEAAiE;IACjE,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,gFAAgF;IAChF,IAAI,QAAQ,IAAI,kBAAkB,GAAG,SAAS,CAE7C;IAED,6EAA6E;IAC7E,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,8DAA8D;IAC9D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAgBvC,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAY3C;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,eAAe,GAAG,IAAI,GAC/B,eAAe,CAUjB"}

package/lib/typescript/src/react.d.ts

@@ -1,8 +1,15 @@
 export { GameView } from './react/GameView.js';
+export { useGameSession } from './react/useGameSession.js';
+export { useGameSessionStatus } from './react/useGameSessionStatus.js';
+export { createGameLifecycleSource, GameLifecycleProvider, useGameLifecycleSource } from './react/lifecycleSource.js';
+export type { GameLifecycleSource } from './core/session/types.js';
 export { createGameAssetStore } from './react/assets/decodeSkiaImage.js';
 export { useGameAssets, stableGroupsKey } from './react/assets/useGameAssets.js';
 export type { GameAssetsState } from './react/assets/useGameAssets.js';
-export { GameWorld2D, viewportTransform } from './react/sprites/GameWorld2D.js';
+export { GameWorld2D, viewportTransform, cameraViewportTransform2D, layerParallaxTransform2D } from './react/sprites/GameWorld2D.js';
+export { GameLayer2D } from './react/camera2d/GameLayer2D.js';
+export { defineGameCamera2D } from './react/camera2d/defineGameCamera2D.js';
+export type { GameCamera2DDefinition } from './react/camera2d/defineGameCamera2D.js';
 export { Sprite, resolveSpriteFrameRect } from './react/sprites/Sprite.js';
 export type { SpriteAnimatable, SpriteAnimatableBoolean, SpriteProps } from './react/sprites/Sprite.js';
 export { GameSprite, spriteFrameNameForClip } from './react/sprites/GameSprite.js';
@@ -16,5 +23,15 @@ export type { AcquireOptions, AssetPipelines, GameAssetStore, NativeImageHandle,
 export type { GameRendererProps, GameViewProps } from './react/GameView.js';
 export { GamePointerInput } from './react/GamePointerInput.js';
 export type { GamePointerInputProps } from './react/GamePointerInput.js';
+export { GameButtonPad, GameButton } from './react/GameButtonPad.js';
+export type { GameButtonPadProps, GameButtonProps, ButtonActionName } from './react/GameButtonPad.js';
 export type { GamePointerInstrumentation, GameViewInstrumentation } from './react/instrumentation.js';
+export { ParticleView } from './react/particles/ParticleView.js';
+export type { ParticleViewProps } from './react/particles/ParticleView.js';
+export { useParticlePresentation } from './react/particles/useParticlePresentation.js';
+export type { ParticlePresentation } from './react/particles/useParticlePresentation.js';
+export { particleSpriteXform, assertUniformParticleSpriteRatio } from './react/particles/spriteXForm.js';
+export { cameraVisibleWorldBounds, visibleInBounds, PARTICLE_CULL_PADDING } from './react/particles/culling.js';
+export { TileMapLayer2D } from './react/tilemap/TileMapLayer2D.js';
+export type { TileMapLayer2DProps } from './react/tilemap/TileMapLayer2D.js';
 //# sourceMappingURL=react.d.ts.map

package/lib/typescript/src/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAkB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iCAA8B,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,iCAA8B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAA6B,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,2BAAwB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,2BAAwB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,+BAA4B,CAAC;AAChF,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,+BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAA6B,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oCAAiC,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAiC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAqC,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,wCAAqC,CAAC;AAE7C,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAkB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA0B,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA0B,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,4BAAyB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAAwB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAA8B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,4BAAyB,CAAC;AACnH,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAsB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAgC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iCAA8B,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,iCAA8B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,gCAA6B,CAAC;AAClI,OAAO,EAAE,WAAW,EAAE,MAAM,iCAA8B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAqC,CAAC;AACzE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wCAAqC,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,2BAAwB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,2BAAwB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,+BAA4B,CAAC;AAChF,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,+BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAA6B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gCAA6B,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oCAAiC,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAiC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAqC,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,wCAAqC,CAAC;AAE7C,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAkB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA0B,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA0B,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAAuB,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAAuB,CAAC;AACnG,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,4BAAyB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAgC,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAgC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA2C,CAAC;AACpF,YAAY,EAAE,oBAAoB,EAAE,MAAM,8CAA2C,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,gCAAgC,EAAE,MAAM,kCAA+B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,8BAA2B,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAgC,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAgC,CAAC"}

package/lib/typescript/src/scene/defineScene.d.ts

@@ -1,8 +1,26 @@
+import type { GameEventDescriptor, InferGameEventMap } from '../events/types.js';
 import type { SceneDefinition } from './types.js';
 /**
  * Define a synchronous functional scene while inferring its state, snapshot,
  * action, and transition types.
  *
+ * To get typed event emission in a standalone scene, pass the same
+ * `events` object that will be passed to `defineGame({ events })`:
+ *
+ * ```ts
+ * const events = defineGameEvents({ 'brick-hit': gameEvent<{ id: string }>() });
+ * const play = defineScene({
+ *   actions: ['primary'],
+ *   emits: ['brick-hit'],
+ *   events,
+ *   update: ({ events }) => {
+ *     events.emit('brick-hit', { id: '1' }); // typed, wrong payload fails
+ *   },
+ *   // ...
+ * });
+ * const game = defineGame({ events, scenes: { play }, initialScene: 'play' });
+ * ```
+ *
  * @example
  * ```ts
  * const ready = defineScene({
@@ -19,8 +37,10 @@ import type { SceneDefinition } from './types.js';
  * });
  * ```
  */
-export declare function defineScene<const TActions extends readonly string[], TState, TSnapshot, const TTransitions extends readonly string[] = []>(definition: Omit<SceneDefinition<TState, TSnapshot, TActions[number], TTransitions[number]>, 'kind' | '__actionType' | '__transitionType' | '__snapshotType' | 'actions' | 'transitions'> & {
+export declare function defineScene<const TActions extends readonly string[], TState, TSnapshot, const TTransitions extends readonly string[] = [], const TEmits extends readonly (keyof InferGameEventMap<TEventDefs> & string)[] = [], const TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>>(definition: Omit<SceneDefinition<TState, TSnapshot, TActions[number], TTransitions[number], TEmits[number], TEventDefs>, 'kind' | '__actionType' | '__transitionType' | '__snapshotType' | '__emitType' | '__eventMapType' | '__eventDefsType' | 'actions' | 'transitions' | 'emits' | 'events'> & {
     readonly actions: TActions;
     readonly transitions?: TTransitions;
-}): SceneDefinition<TState, TSnapshot, TActions[number], TTransitions[number]>;
+    readonly emits?: TEmits;
+    readonly events?: TEventDefs;
+}): SceneDefinition<TState, TSnapshot, TActions[number], TTransitions[number], TEmits[number], TEventDefs>;
 //# sourceMappingURL=defineScene.d.ts.map

package/lib/typescript/src/scene/defineScene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineScene.d.ts","sourceRoot":"","sources":["../../../../src/scene/defineScene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,KAAK,CAAC,QAAQ,SAAS,SAAS,MAAM,EAAE,EACxC,MAAM,EACN,SAAS,EACT,KAAK,CAAC,YAAY,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EAEjD,UAAU,EAAE,IAAI,CACd,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,EAC1E,MAAM,GAAG,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,SAAS,GAAG,aAAa,CAC5F,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAA;CAAE,GACtE,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAK5E"}
+{"version":3,"file":"defineScene.d.ts","sourceRoot":"","sources":["../../../../src/scene/defineScene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAS,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,CACzB,KAAK,CAAC,QAAQ,SAAS,SAAS,MAAM,EAAE,EACxC,MAAM,EACN,SAAS,EACT,KAAK,CAAC,YAAY,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,EACjD,KAAK,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,iBAAiB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,EACnF,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE7F,UAAU,EAAE,IAAI,CACd,eAAe,CACb,MAAM,EACN,SAAS,EACT,QAAQ,CAAC,MAAM,CAAC,EAChB,YAAY,CAAC,MAAM,CAAC,EACpB,MAAM,CAAC,MAAM,CAAC,EACd,UAAU,CACX,EACC,MAAM,GACN,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,SAAS,GACT,aAAa,GACb,OAAO,GACP,QAAQ,CACX,GAAG;IACF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B,GACA,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAKxG"}

package/lib/typescript/src/scene/types.d.ts

@@ -1,4 +1,5 @@
 import type { InputFrame } from '../core/input/types.js';
+import type { GameEventDescriptor, GameEventEmitter, InferGameEventMap } from '../events/types.js';
 /**
  * Update-scoped scene transition controls.
  *
@@ -18,13 +19,15 @@ export interface SceneTransitionController<TTransitionName extends string> {
     restartScene(): void;
 }
 /** Values supplied to a scene for one deterministic simulation tick. */
-export interface SceneUpdate<TState, TActionName extends string, TTransitionName extends string> {
+export interface SceneUpdate<TState, TActionName extends string, TTransitionName extends string, TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>, TEmits extends keyof InferGameEventMap<TEventDefs> & string = keyof InferGameEventMap<TEventDefs> & string> {
     /** The authoritative state produced by the previous tick. */
     readonly state: Readonly<TState>;
     /** One immutable semantic input snapshot for this tick. */
     readonly input: InputFrame<TActionName>;
     /** Update-scoped transition controls restricted to declared targets. */
     readonly transition: SceneTransitionController<TTransitionName>;
+    /** Update-scoped emitter for declared game events (T13). Invalid after the update returns or throws. */
+    readonly events: GameEventEmitter<Pick<InferGameEventMap<TEventDefs>, TEmits>>;
     /** One-based global simulation tick number. */
     readonly tick: number;
     /** One-based tick number within the current scene instance. */
@@ -42,7 +45,7 @@ export interface SceneSnapshotContext<TState> {
     readonly state: Readonly<TState>;
 }
 /** A synchronous functional scene used by the runtime. */
-export interface SceneDefinition<TState, TSnapshot, TActionName extends string = never, TTransitionName extends string = never> {
+export interface SceneDefinition<TState, TSnapshot, TActionName extends string = never, TTransitionName extends string = never, TEmits extends string = never, TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>> {
     /** Internal scene-definition discriminator. */
     readonly kind: 'gamekit.scene';
     /** @internal Covariant type witness used to infer presentation snapshots. */
@@ -51,15 +54,32 @@ export interface SceneDefinition<TState, TSnapshot, TActionName extends string =
     readonly __actionType?: TActionName;
     /** @internal Type witness used to validate scene transition targets. */
     readonly __transitionType?: TTransitionName;
+    /** @internal Type witness for emitted event names. */
+    readonly __emitType?: TEmits;
+    /** @internal Type witness for the game event map. */
+    readonly __eventMapType?: InferGameEventMap<TEventDefs>;
+    /** @internal Type witness for the branded event definitions identity. */
+    readonly __eventDefsType?: TEventDefs;
     /** Semantic input actions this scene may read. */
     readonly actions: readonly TActionName[];
     /** Declared scene names this scene may transition to. */
     readonly transitions?: readonly TTransitionName[];
+    /** Declared event names this scene may emit (subset of the game's event map). */
+    readonly emits?: readonly TEmits[];
+    /** The branded event definitions this scene is bound to (for standalone type safety). */
+    readonly events?: TEventDefs;
     /** Create the scene's initial authoritative state. */
     readonly create: () => TState;
     /** Produce the next state for one fixed simulation tick. */
-    readonly update: (frame: SceneUpdate<TState, TActionName, TTransitionName>) => TState;
-    /** Extract a compact renderer-specific snapshot from current state. */
+    readonly update: (frame: SceneUpdate<TState, TActionName, TTransitionName, TEventDefs, TEmits>) => TState;
+    /**
+     * Extract a compact renderer-specific snapshot from current state.
+     *
+     * The snapshot domain is plain records, arrays, and scalars; anything
+     * else fails with a `SnapshotDomainError` carrying the key path before
+     * publication. Returning a state reference transfers it into immutable
+     * snapshot ownership — it is frozen in place.
+     */
     readonly snapshot: (context: SceneSnapshotContext<TState>) => TSnapshot;
     /** Release scene-owned resources exactly once. */
     readonly dispose?: (state: Readonly<TState>) => void;

package/lib/typescript/src/scene/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/scene/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CAAC,eAAe,SAAS,MAAM;IACvE;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,mDAAmD;IACnD,YAAY,IAAI,IAAI,CAAC;CACtB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,WAAW,SAAS,MAAM,EAAE,eAAe,SAAS,MAAM;IAC7F,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAChE,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB,CAAC,MAAM;IAC1C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe,CAC9B,MAAM,EACN,SAAS,EACT,WAAW,SAAS,MAAM,GAAG,KAAK,EAClC,eAAe,SAAS,MAAM,GAAG,KAAK;IAEtC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IAC5C,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,KAAK,MAAM,CAAC;IACtF,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;IACxE,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CACtD;AAED,sEAAsE;AACtE,MAAM,MAAM,aAAa,CAAC,MAAM,IAC9B,MAAM,SAAS;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,SAAS,CAAA;CAAE,GAAG,SAAS,GAAG,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/scene/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/sprites/sampleSpriteClip.d.ts

@@ -4,14 +4,24 @@
  * Pure, allocation-free, worklet-compatible frame selection. The same clip
  * metadata and elapsed time always select the same frame, so equivalent
  * game time produces identical presentation at 30/60/90/120 Hz.
+ *
+ * Single-contract rule (GS-ANIMATION-01): every renderer path resolves
+ * frames through these helpers — never duplicated arithmetic. Negative
+ * elapsed clamps uniformly (loops wrap, one-shots pin to frame zero);
+ * non-finite elapsed, empty clips, and non-positive durations fail clearly
+ * instead of masking invalid data as frame zero. Unknown clip names throw
+ * a plain `[ASSET_UNKNOWN_CLIP]` error: the UI-reachable call graph must
+ * stay free of error-class construction so failure branches execute on the
+ * UI runtime exactly as they do headlessly (GS-ANIMATION-02).
  */
 import type { SpriteClip } from '../assets/types.js';
 /**
  * Select the frame index for `elapsedMs` of playback.
  *
  * Loop clips wrap with modulo — the boundary frame is never duplicated and
- * no zero-length boundary frame exists. One-shot clips clamp to their final
- * frame; completion is reported separately.
+ * no zero-length boundary frame exists; negative elapsed wraps into range.
+ * One-shot clips clamp to `[0, frameCount - 1]`; completion is reported
+ * separately by the playback state.
  */
 export declare function sampleSpriteClipFrame(clip: SpriteClip, elapsedMs: number): number;
 /**
@@ -21,4 +31,18 @@ export declare function sampleSpriteClipFrame(clip: SpriteClip, elapsedMs: numbe
 export declare function sampleSpriteClipFrameName(clip: SpriteClip, elapsedMs: number): string;
 /** Total clip duration in milliseconds (one-shot: its full timeline). */
 export declare function spriteClipDurationMs(clip: SpriteClip): number;
+/**
+ * Select the frame name for a clip + elapsed time (loop/once semantics).
+ *
+ * Reads the descriptor's animation table with the single sampler contract
+ * above. An absent clip table entry is an invalid clip — it throws instead
+ * of returning the clip string as if it were a frame name. Absent
+ * *selection* (no clip chosen yet) is distinct: callers keep that path and
+ * present nothing without calling this helper.
+ */
+export declare function spriteFrameNameForClip(animations: Readonly<Record<string, {
+    readonly frames: readonly string[];
+    readonly frameDurationMs: number;
+    readonly mode: 'loop' | 'once';
+}>>, clip: string, elapsedMs: number): string;
 //# sourceMappingURL=sampleSpriteClip.d.ts.map

package/lib/typescript/src/sprites/sampleSpriteClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sampleSpriteClip.d.ts","sourceRoot":"","sources":["../../../../src/sprites/sampleSpriteClip.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAUR;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAMR;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG7D"}
+{"version":3,"file":"sampleSpriteClip.d.ts","sourceRoot":"","sources":["../../../../src/sprites/sampleSpriteClip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAiB,CAAC;AA4BlD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAcjF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAG7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,QAAQ,CAClB,MAAM,CACJ,MAAM,EACN;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CACF,CACF,EACD,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR"}

package/lib/typescript/src/sprites/spriteAnimationState.d.ts

@@ -15,12 +15,11 @@ export interface SpriteAnimationState<TClipName extends string = string> {
 /** The clip names of a sprite-sheet descriptor (works through the manifest brand). */
 export type SpriteClipNames<TDescriptor extends SpriteSheetDescriptor> = Extract<keyof TDescriptor['animations'], string>;
 /**
- * Start playback of `clip` from its beginning. The clip name is preserved
- * as a string literal in the returned state; unknown clips are rejected at
- * runtime (the manifest descriptor keeps the sheet-level frame and clip
- * names literal via the spriteSheet contract).
+ * Start playback of `clip` from its beginning. The clip name is constrained
+ * to the descriptor's animation keys, so a misspelled clip fails compilation;
+ * untyped callers still hit the runtime check below.
  */
-export declare function startSpriteAnimation<TClipName extends string>(descriptor: SpriteSheetDescriptor, clip: TClipName): SpriteAnimationState<TClipName>;
+export declare function startSpriteAnimation<TDescriptor extends SpriteSheetDescriptor>(descriptor: TDescriptor, clip: SpriteClipNames<TDescriptor>): SpriteAnimationState<SpriteClipNames<TDescriptor>>;
 /**
  * Advance playback by `deltaSeconds` of fixed-step game time.
  *
@@ -28,12 +27,12 @@ export declare function startSpriteAnimation<TClipName extends string>(descripto
  * clearly. Loop clips keep their elapsed time bounded within one timeline
  * (modulo), so arbitrarily large deltas cost constant arithmetic.
  */
-export declare function advanceSpriteAnimation<TClipName extends string>(descriptor: SpriteSheetDescriptor, state: SpriteAnimationState<TClipName>, deltaSeconds: number): SpriteAnimationState<TClipName>;
+export declare function advanceSpriteAnimation<TDescriptor extends SpriteSheetDescriptor, TClip extends SpriteClipNames<TDescriptor>>(descriptor: TDescriptor, state: SpriteAnimationState<TClip>, deltaSeconds: number): SpriteAnimationState<TClip>;
 /**
  * Switch playback to `clip`, restarting it from the beginning. The clip
  * name is typed against the descriptor's animation table.
  */
-export declare function playSpriteAnimation<TClipName extends string>(descriptor: SpriteSheetDescriptor, state: SpriteAnimationState<TClipName>, clip: TClipName): SpriteAnimationState<TClipName>;
+export declare function playSpriteAnimation<TDescriptor extends SpriteSheetDescriptor, TClip extends SpriteClipNames<TDescriptor>>(descriptor: TDescriptor, state: SpriteAnimationState<TClip>, clip: SpriteClipNames<TDescriptor>): SpriteAnimationState<SpriteClipNames<TDescriptor>>;
 /** Pause playback; `advance` becomes a no-op while paused. */
 export declare function pauseSpriteAnimation<TClipName extends string>(state: SpriteAnimationState<TClipName>): SpriteAnimationState<TClipName>;
 /** Resume playback from the paused position. */

package/lib/typescript/src/sprites/spriteAnimationState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spriteAnimationState.d.ts","sourceRoot":"","sources":["../../../../src/sprites/spriteAnimationState.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAiB,CAAC;AAG7D,wDAAwD;AACxD,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IACrE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAaD,sFAAsF;AACtF,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,qBAAqB,IAAI,OAAO,CAC9E,MAAM,WAAW,CAAC,YAAY,CAAC,EAC/B,MAAM,CACP,CAAC;AAmBF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAC3D,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,SAAS,GACd,oBAAoB,CAAC,SAAS,CAAC,CAUjC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,SAAS,MAAM,EAC7D,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,EACtC,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAAC,SAAS,CAAC,CAkBjC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,SAAS,MAAM,EAC1D,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,EACtC,IAAI,EAAE,SAAS,GACd,oBAAoB,CAAC,SAAS,CAAC,CAajC;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAC3D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAGjC;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,CAAC,SAAS,SAAS,MAAM,EAC5D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAGjC;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAC3D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAGjC;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,SAAS,SAAS,MAAM,EAC9D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,EACtC,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAAC,SAAS,CAAC,CAIjC"}
+{"version":3,"file":"spriteAnimationState.d.ts","sourceRoot":"","sources":["../../../../src/sprites/spriteAnimationState.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAiB,CAAC;AAG7D,wDAAwD;AACxD,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IACrE,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAaD,sFAAsF;AACtF,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,qBAAqB,IAAI,OAAO,CAC9E,MAAM,WAAW,CAAC,YAAY,CAAC,EAC/B,MAAM,CACP,CAAC;AAkBF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,SAAS,qBAAqB,EAC5E,UAAU,EAAE,WAAW,EACvB,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,GACjC,oBAAoB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CASpD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,SAAS,qBAAqB,EACzC,KAAK,SAAS,eAAe,CAAC,WAAW,CAAC,EAE1C,UAAU,EAAE,WAAW,EACvB,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAClC,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAAC,KAAK,CAAC,CAiB7B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,SAAS,qBAAqB,EACzC,KAAK,SAAS,eAAe,CAAC,WAAW,CAAC,EAE1C,UAAU,EAAE,WAAW,EACvB,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAClC,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,GACjC,oBAAoB,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAYpD;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAC3D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAEjC;AAED,gDAAgD;AAChD,wBAAgB,qBAAqB,CAAC,SAAS,SAAS,MAAM,EAC5D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAEjC;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAC3D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACrC,oBAAoB,CAAC,SAAS,CAAC,CAEjC;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,SAAS,SAAS,MAAM,EAC9D,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,EACtC,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAAC,SAAS,CAAC,CAGjC"}

package/lib/typescript/src/sprites.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Subpath entry for `rn-gamekit/sprites`.
+ *
+ * Deterministic sprite-clip sampling and immutable playback-state helpers.
+ * React components (Sprite, GameSprite, SpriteBatch) remain in `rn-gamekit/react`.
+ */
+export { sampleSpriteClipFrame, sampleSpriteClipFrameName, spriteClipDurationMs, spriteFrameNameForClip, } from './sprites/sampleSpriteClip.js';
+export { advanceSpriteAnimation, pauseSpriteAnimation, playSpriteAnimation, resetSpriteAnimation, resumeSpriteAnimation, setSpriteAnimationSpeed, startSpriteAnimation, } from './sprites/spriteAnimationState.js';
+export type { SpriteAnimationState, SpriteClipNames } from './sprites/spriteAnimationState.js';
+//# sourceMappingURL=sprites.d.ts.map

package/lib/typescript/src/sprites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites.d.ts","sourceRoot":"","sources":["../../../src/sprites.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mCAAgC,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mCAAgC,CAAC"}

package/lib/typescript/src/storage/adapters/asyncStorage.d.ts

@@ -0,0 +1,18 @@
+import type { GameStorageAdapter } from '../types.js';
+export type LoadedAsyncStorage = {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+};
+type Loader = () => Promise<LoadedAsyncStorage>;
+export declare function __setAsyncStorageLoader(fn: Loader | null): void;
+export declare function __getAsyncStorageLoader(): Loader | null;
+/**
+ * RN adapter backed by AsyncStorage.
+ *
+ * Importing `rn-gamekit/storage` does not eagerly import AsyncStorage —
+ * the dynamic import happens on the first read/write/remove.
+ */
+export declare function createGameStorageAdapter(): GameStorageAdapter;
+export {};
+//# sourceMappingURL=asyncStorage.d.ts.map

package/lib/typescript/src/storage/adapters/asyncStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncStorage.d.ts","sourceRoot":"","sources":["../../../../../src/storage/adapters/asyncStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAU,CAAC;AAGnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAGhD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE/D;AAED,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AA6BD;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAuB7D"}

package/lib/typescript/src/storage/adapters/memory.d.ts

@@ -0,0 +1,16 @@
+import type { GameStorageAdapter } from '../types.js';
+/**
+ * In-memory adapter for tests and apps that own storage elsewhere.
+ * Each instance owns its map.
+ */
+export declare function createMemoryStorageAdapter(initial?: Record<string, string>): GameStorageAdapter;
+/**
+ * Programmable failure adapter for tests — wraps another adapter and injects failures.
+ */
+export declare function createFailingStorageAdapter(inner: GameStorageAdapter, opts?: {
+    failRead?: (key: string) => Error | null;
+    failWrite?: (key: string, value: string) => Error | null;
+    failRemove?: (key: string) => Error | null;
+    delayMs?: number;
+}): GameStorageAdapter;
+//# sourceMappingURL=memory.d.ts.map

package/lib/typescript/src/storage/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../src/storage/adapters/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAU,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAc/F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IACzD,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,kBAAkB,CAwBpB"}

package/lib/typescript/src/storage/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * V1 storage errors — stable codes, operation, namespace/slot, schema context,
+ * exact path where relevant, and original cause.
+ */
+export type GameStorageErrorCode = 'INVALID_NAMESPACE' | 'INVALID_SLOT' | 'INVALID_SCHEMA_ID' | 'INVALID_SCHEMA_VERSION' | 'INVALID_MIGRATION' | 'UNSUPPORTED_VALUE' | 'SERIALIZATION_FAILED' | 'SIZE_EXCEEDED' | 'DEPTH_EXCEEDED' | 'BACKEND_READ_FAILED' | 'BACKEND_WRITE_FAILED' | 'BACKEND_REMOVE_FAILED' | 'CORRUPT_ENVELOPE' | 'SCHEMA_ID_MISMATCH' | 'FUTURE_VERSION' | 'MISSING_MIGRATION' | 'MIGRATION_FAILED' | 'VALIDATION_FAILED' | 'DISPOSED';
+export type GameStorageOperation = 'load' | 'save' | 'remove' | 'delete' | 'flush' | 'dispose' | 'validate' | 'migrate' | 'serialize' | 'parse';
+export declare class GameStorageError extends Error {
+    readonly name = "GameStorageError";
+    readonly code: GameStorageErrorCode;
+    readonly operation: GameStorageOperation | undefined;
+    readonly namespace: string | undefined;
+    readonly slot: string | undefined;
+    readonly schemaId: string | undefined;
+    readonly schemaVersion: number | undefined;
+    readonly path: string | undefined;
+    readonly cause: unknown | undefined;
+    constructor(message: string, options: {
+        code: GameStorageErrorCode;
+        operation?: GameStorageOperation | undefined;
+        namespace?: string | undefined;
+        slot?: string | undefined;
+        schemaId?: string | undefined;
+        schemaVersion?: number | undefined;
+        path?: string | undefined;
+        cause?: unknown | undefined;
+    });
+}
+export declare function storageError(message: string, code: GameStorageErrorCode, opts?: {
+    operation?: GameStorageOperation | undefined;
+    namespace?: string | undefined;
+    slot?: string | undefined;
+    schemaId?: string | undefined;
+    schemaVersion?: number | undefined;
+    path?: string | undefined;
+    cause?: unknown | undefined;
+}): GameStorageError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/src/storage/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/storage/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,mBAAmB,GACnB,cAAc,GACd,mBAAmB,GACnB,wBAAwB,GACxB,mBAAmB,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,UAAU,CAAC;AAEf,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhJ,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAkB,IAAI,sBAAsB;IAE5C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAkB,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,IAAI,EAAE,oBAAoB,CAAC;QAC3B,SAAS,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;QAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAC7B;CAYJ;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,oBAAoB,EAC1B,IAAI,GAAE;IACJ,SAAS,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxB,GACL,gBAAgB,CAWlB"}

package/lib/typescript/src/storage/index.d.ts

@@ -0,0 +1,11 @@
+export { GameStorageError } from './errors.js';
+export type { GameStorageErrorCode, GameStorageOperation } from './errors.js';
+export { defineGameSave } from './schema.js';
+export { createGameSaveStore } from './store.js';
+export { createMemoryStorageAdapter } from './adapters/memory.js';
+export { createGameStorageAdapter } from './adapters/asyncStorage.js';
+export { __setAsyncStorageLoader, __getAsyncStorageLoader } from './adapters/asyncStorage.js';
+export type { GameSaveSchema, GameStorageAdapter, StoredGameEnvelope, GameSaveLoadResult, GameSaveLoadStatus, CreateGameSaveStoreOptions, GameSaveStore, } from './types.js';
+export { STORAGE_LIMITS } from './types.js';
+export { STORAGE_ENVELOPE_FORMAT } from './serialization.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAU,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAU,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAU,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAmB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAAyB,CAAC;AAC3F,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,GACd,MAAM,YAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAS,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAiB,CAAC"}

package/lib/typescript/src/storage/schema.d.ts

@@ -0,0 +1,22 @@
+import type { GameSaveSchema } from './types.js';
+/**
+ * Define a versioned game save schema.
+ *
+ * Id/version/migrations are validated immediately. `createDefault` and
+ * `validate` are stored as-is — they run later per load/save.
+ */
+export declare function defineGameSave<TData>(options: {
+    id: string;
+    version: number;
+    createDefault: () => TData;
+    validate: (value: unknown) => TData;
+    migrations?: Readonly<Record<number, (value: unknown) => unknown>>;
+}): GameSaveSchema<TData>;
+export declare function createDefaultData<TData>(schema: GameSaveSchema<TData>): TData;
+export declare function validateCurrentData<TData>(schema: GameSaveSchema<TData>, value: unknown, path?: string): TData;
+export declare function migratePayload<TData>(schema: GameSaveSchema<TData>, storedVersion: number, payload: unknown): {
+    data: unknown;
+    fromVersion: number;
+    toVersion: number;
+};
+//# sourceMappingURL=schema.d.ts.map

package/lib/typescript/src/storage/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAS,CAAC;AAI9C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,KAAK,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IACpC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;CACpE,GAAG,cAAc,CAAC,KAAK,CAAC,CAuBxB;AAuBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,KAAK,CAkB7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAS,GAAG,KAAK,CAgB9G;AAED,wBAAgB,cAAc,CAAC,KAAK,EAClC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAC7B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAyC3D"}

package/lib/typescript/src/storage/serialization.d.ts

@@ -0,0 +1,23 @@
+import { type StoredGameEnvelope } from './types.js';
+/**
+ * Bounded plain-data clone + validation for storage payloads.
+ *
+ * Mirrors the strictness of event payloads but with storage-sized limits.
+ * Rejects: functions, symbols, bigint, non-finite numbers, cycles,
+ * sparse holes, accessors, non-enumerable, unsafe prototype keys,
+ * array subclasses, class instances, React elements, thenables.
+ */
+export declare function cloneAndValidatePlainData(value: unknown, basePath?: string): unknown;
+/**
+ * Exact UTF-8 byte length (GS-STORAGE-03): the single routine for every
+ * storage size check. TextEncoder is exact everywhere it exists (Node,
+ * browsers, modern Hermes); the scalar fallback below is bit-exact too,
+ * including unpaired surrogates (which encode as U+FFFD, 3 bytes).
+ */
+export declare function utf8ByteLength(str: string): number;
+/** Bit-exact scalar UTF-8 length for runtimes without TextEncoder. */
+export declare function utf8ByteLengthScalar(str: string): number;
+export declare function serializeEnvelope(envelope: StoredGameEnvelope): string;
+export declare function parseEnvelope(raw: string): StoredGameEnvelope;
+export declare const STORAGE_ENVELOPE_FORMAT: "rn-gamekit.save";
+//# sourceMappingURL=serialization.d.ts.map

package/lib/typescript/src/storage/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../src/storage/serialization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,YAAS,CAAC;AAIlE;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAY,GAAG,OAAO,CA0IvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAetE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAiC7D;AAED,eAAO,MAAM,uBAAuB,mBAAkB,CAAC"}

package/lib/typescript/src/storage/store.d.ts

@@ -0,0 +1,3 @@
+import type { CreateGameSaveStoreOptions, GameSaveStore } from './types.js';
+export declare function createGameSaveStore<TData>(options: CreateGameSaveStoreOptions<TData>): GameSaveStore<TData>;
+//# sourceMappingURL=store.d.ts.map

package/lib/typescript/src/storage/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/storage/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAsB,aAAa,EAAE,MAAM,YAAS,CAAC;AAO7F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAmX3G"}