rn-gamekit 0.1.0 → 0.2.0

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

@@ -0,0 +1,292 @@
+import type { Point2D } from '../geometry/types.js';
+export type ParticleSpace = 'world' | 'screen';
+export type ParticleOverflow = 'drop-new' | 'recycle-oldest';
+export type ParticleKind = 'sprite' | 'shape';
+export type ShapeKind = 'circle' | 'rectangle';
+export interface Range {
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * One author-input endpoint of an explicit scale envelope (T20.1): a fixed
+ * scalar or a `{ min, max }` sampling range for deterministic per-particle
+ * variation. `defineParticleEffect` normalizes scalars into frozen fixed
+ * ranges (T20A-R3).
+ */
+export type ParticleScaleEndpointInput = number | Range;
+/**
+ * Author-input scale envelope (T20.1): scale begins at `start` and ends at
+ * `end`, interpolated linearly from active age. Mutually exclusive with the
+ * legacy `scaleOverLife` range; the runtime rejects definitions that carry
+ * both (T20A-R3 keeps that check in the type layer as well).
+ */
+export interface ParticleScaleEnvelopeInput {
+    readonly start: ParticleScaleEndpointInput;
+    readonly end: ParticleScaleEndpointInput;
+}
+/**
+ * Normalized envelope endpoint (T20A-R3): always a frozen `{ min, max }`
+ * range — scalar author inputs never appear on a normalized definition.
+ */
+export type ParticleScaleEndpoint = Range;
+/**
+ * Normalized explicit scale envelope (T20.1): scale begins at `start` and
+ * ends at `end`, interpolated linearly from active age. Both endpoints are
+ * sampled independently (start first, then end) so shrinking, growth, and
+ * fixed scales are all directly expressible. Endpoints are non-negative and
+ * finite; zero collapses the particle to a point. Negative scale has no
+ * defined rendering semantics and is rejected at definition time (T20A-R1).
+ * Mutually exclusive with the legacy `scaleOverLife` range.
+ */
+export interface ParticleScaleEnvelope {
+    readonly start: ParticleScaleEndpoint;
+    readonly end: ParticleScaleEndpoint;
+}
+export interface SpriteParticleConfig {
+    readonly kind: 'sprite';
+    readonly sheet: string;
+    readonly frame: string;
+    readonly size: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface ShapeParticleConfig {
+    readonly kind: 'shape';
+    readonly shape: ShapeKind;
+    readonly radius?: number;
+    readonly width?: number;
+    readonly height?: number;
+    readonly color?: string;
+}
+export type ParticleConfig = SpriteParticleConfig | ShapeParticleConfig;
+export interface ParticleEffectDefinitionFields {
+    readonly capacity: number;
+    readonly space: ParticleSpace;
+    readonly overflow: ParticleOverflow;
+    readonly particle: ParticleConfig;
+    readonly burst: {
+        readonly count: number;
+    };
+    readonly lifetimeSeconds: Range;
+    readonly speed: Range;
+    readonly direction?: Range;
+    readonly gravity: Point2D;
+    readonly fadeOut: boolean;
+    readonly rotation?: Range;
+}
+/**
+ * Normalized effect definition (T20A-R3): the scale fields are an exclusive
+ * union — a normalized definition carries the explicit `scale` envelope, the
+ * legacy `scaleOverLife` range, or neither, never both. Declared as a flat
+ * union (not an intersection) so normalized definitions remain assignable to
+ * the author-input type at every call site.
+ */
+interface NormalizedExplicitScale extends ParticleEffectDefinitionFields {
+    readonly scale: ParticleScaleEnvelope;
+    readonly scaleOverLife?: undefined;
+}
+interface NormalizedLegacyScale extends ParticleEffectDefinitionFields {
+    readonly scale?: undefined;
+    readonly scaleOverLife: Range;
+}
+interface NormalizedNoScale extends ParticleEffectDefinitionFields {
+    readonly scale?: undefined;
+    readonly scaleOverLife?: undefined;
+}
+export type ParticleEffectDefinition = NormalizedExplicitScale | NormalizedLegacyScale | NormalizedNoScale;
+/**
+ * Authoring shape for `defineParticleEffect` (T20A-R3): identical to the
+ * normalized definition except that scale envelope endpoints accept scalars,
+ * and legacy versus explicit scale authoring is an exclusive union — a
+ * definition carrying both `scale` and `scaleOverLife` fails to compile.
+ * The runtime boundary still validates every JavaScript input.
+ */
+export type ParticleEffectDefinitionInput = Omit<ParticleEffectDefinition, 'scale' | 'scaleOverLife'> & ({
+    readonly scale?: ParticleScaleEnvelopeInput | undefined;
+    readonly scaleOverLife?: undefined;
+} | {
+    readonly scale?: undefined;
+    readonly scaleOverLife?: Range | undefined;
+});
+export interface ParticleEmitCommand {
+    /** Center position of the burst origin (the anchor convention for every kind). */
+    readonly position: Point2D;
+    readonly seed: number;
+}
+export interface ParticleSystemOptions {
+    /**
+     * Raw author definitions or already-normalized definitions. Every value is
+     * validated, cloned, and frozen at the system boundary (T15-F6).
+     */
+    readonly effects: Record<string, ParticleEffectDefinitionInput>;
+}
+/**
+ * Frozen diagnostic counters. Semantics are per particle:
+ * - `emitted`: particles actually placed into a slot this burst (fresh OR
+ *   recycled).
+ * - `dropped`: particles never placed — overflow under `drop-new`, plus every
+ *   particle of a burst rejected while paused.
+ * - `recycled`: placed particles whose slot was previously occupied.
+ */
+export interface ParticleDiagnostics {
+    readonly active: number;
+    readonly emitted: number;
+    readonly dropped: number;
+    readonly recycled: number;
+}
+/** A frozen, sampled view of one active particle (safe for consumers). */
+export interface ParticleSlotSnapshot {
+    readonly active: boolean;
+    readonly age: number;
+    readonly lifetime: number;
+    readonly origin: Point2D;
+    readonly position: Point2D;
+    readonly velocity: Point2D;
+    readonly rotation: number;
+    readonly scale: number;
+    readonly opacity: number;
+    readonly color: string;
+    readonly spawnSequence: number;
+    readonly effect: string;
+}
+export interface ParticleSystem<TEffects extends Record<string, ParticleEffectDefinitionInput> = Record<string, ParticleEffectDefinition>> {
+    /** Validate + place a burst. Throws for unknown effect or malformed command, even while paused. */
+    emit<K extends keyof TEffects & string>(effect: K, command: ParticleEmitCommand): void;
+    /** Advance the clock; a no-op while paused. */
+    update(deltaSeconds: number): void;
+    pause(): void;
+    resume(): void;
+    dispose(): void;
+    getDiagnostics(effect?: keyof TEffects & string): ParticleDiagnostics;
+    /**
+     * Frozen snapshots of active slots. Mutating the returned objects can never
+     * affect controller state (T15-F6).
+     */
+    getActiveParticles(effect: keyof TEffects & string): readonly ParticleSlotSnapshot[];
+    /** Session-lifecycle helpers: idempotent transitions that never throw on already-paused/running. */
+    pauseIfRunning(): void;
+    resumeIfPaused(): void;
+    /** 'running' | 'paused' | 'disposed' — read once per decision point. */
+    readonly status: 'running' | 'paused' | 'disposed';
+    /**
+     * Typed presentation binding for renderers (T15-F6): exposes frozen
+     * definitions plus fixed-capacity sample buffers without revealing pool
+     * internals. One binding per renderer generation; creating it does not
+     * start any clock.
+     */
+    bindPresentation(): ParticlePresentationBinding;
+}
+/**
+ * The exclusive presentation-clock lease (T15-RF3).
+ *
+ * Exactly one owner may drive the clock. While a driver is held, public
+ * `tick()` calls are rejected so ad-hoc callers can never double-advance
+ * the system. The driver exposes an idle probe and a wake listener so the
+ * scheduler can fully stop while nothing is active and resume on the next
+ * accepted emission.
+ */
+export interface ParticleDriverHandle {
+    /** Advance + resample. No-op while the owning system is paused/disposed. */
+    step(deltaSeconds: number): void;
+    /** True when every pool slot is inactive (scheduler may stop). */
+    isIdle(): boolean;
+    /** Observe emissions that may end an idle period; pass null to clear. */
+    setWakeListener(listener: (() => void) | null): void;
+    /** Release the exclusive lease; idempotent. */
+    release(): void;
+}
+/**
+ * The renderer-facing half of a particle system (T15-F1/F2/F6).
+ *
+ * A binding owns sampled, fixed-capacity buffers per effect. React views
+ * are readers: they never advance the system. The clock itself is held by
+ * exactly one driver acquired through `acquireDriver()`.
+ */
+export interface ParticlePresentationBinding {
+    /** Generation of the owning system at bind time. */
+    readonly systemGeneration: number;
+    /** The frozen, validated definition for one effect. Throws when unknown. */
+    definition(effect: string): ParticleEffectDefinition;
+    /** All bound effect names (stable order). */
+    readonly effects: readonly string[];
+    /**
+     * Manual advance for headless tests and custom drivers. Throws while a
+     * driver owns the clock (T15-RF3); otherwise advances the active clock and
+     * expires slots. A no-op while paused.
+     */
+    tick(deltaSeconds: number): void;
+    /** Acquire the exclusive presentation clock. Throws while another owner holds it. */
+    acquireDriver(): ParticleDriverHandle;
+    /** Whether a driver currently holds the exclusive clock. */
+    readonly driverOwned: boolean;
+    /** Monotonic revision of the EMISSION REGISTRY (bumped on membership changes). */
+    readonly registryRevision: number;
+    /** Current accumulated ACTIVE time (freezes while paused). */
+    readonly activeClock: number;
+    /** Number of active slots summed over all effects (idle probe). */
+    readonly activeCount: number;
+    /**
+     * Deeply frozen per-emission init records for one effect — the diagnostics/
+     * readback surface. Positions derive analytically from activeClock.
+     */
+    emissions(effect: string): readonly ParticleEmissionRecord[];
+    /** Build the bounded UI-runtime registry (frozen). Called on membership changes. */
+    buildUiRegistry(): ParticleUiRegistry;
+}
+/**
+ * Structural mirror of the React-layer frame snapshot, declared here so the
+ * particle types stay renderer-agnostic.
+ */
+export interface ParticleFrameSnapshotLike {
+    readonly revision: number;
+    readonly effects: Readonly<Record<string, {
+        readonly x: number[];
+        readonly y: number[];
+        readonly rotation: number[];
+        readonly scale: number[];
+        readonly opacity: number[];
+        readonly visible: number[];
+        readonly capacity: number;
+    }>>;
+}
+/** Fixed-capacity presentation buffers for one effect (T15-F2). */
+export interface ParticleSlotBuffers {
+    readonly x: Float32Array;
+    readonly y: Float32Array;
+    readonly rotation: Float32Array;
+    readonly scale: Float32Array;
+    readonly opacity: Float32Array;
+    readonly visible: Uint8Array;
+    readonly capacity: number;
+}
+/** Initial state for one emitted particle, in ACTIVE-time coordinates. */
+export interface ParticleEmissionRecord {
+    /** ACTIVE-clock time at which this particle was born. */
+    readonly bornAt: number;
+    readonly originX: number;
+    readonly originY: number;
+    readonly vx: number;
+    readonly vy: number;
+    readonly rotation: number;
+    readonly rotationSpeed: number;
+    readonly scaleStart: number;
+    readonly scaleEnd: number;
+    readonly lifetime: number;
+    readonly spawnSequence: number;
+}
+/**
+ * What the presentation layer transfers across the runtime boundary
+ * (T15-SF1): bounded per-emission init records plus the scalar clock.
+ * Transforms are computed analytically on the UI runtime.
+ */
+export interface ParticleUiRegistry {
+    readonly registryRevision: number;
+    readonly activeClock: number;
+    readonly effects: Readonly<Record<string, {
+        readonly capacity: number;
+        readonly particles: readonly ParticleEmissionRecord[];
+    }>>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/particles/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export * from './particles/index.js';
+//# sourceMappingURL=particles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"particles.d.ts","sourceRoot":"","sources":["../../../src/particles.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAmB,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * Multitouch button pad (T20).
+ *
+ * The React surface over the headless button-pad controller
+ * (`core/input/buttonPad`): compose any number of {@link GameButton} zones
+ * inside a {@link GameButtonPad}; every active pointer is mapped to the zone
+ * it covers and press/release edges flow into the session's declared button
+ * actions. Unlike RN `Pressable`, simultaneous fingers on different buttons
+ * all register — hold left/right and jump at the same time.
+ *
+ * Semantics carried over from the reference implementation:
+ * - Release edges ALWAYS fire on touch up/cancel, so edge-triggered actions
+ *   (a jump pulse) re-arm for the next press.
+ * - A finger sliding between zones reassigns: release + press.
+ * - Unmount releases every held action; no input outlives the pad.
+ *
+ * GS-INPUT-03: zones measure into pad coordinates (never parent-relative),
+ * every mounted zone has an owner identity with idempotent cleanup, and
+ * terminal cleanup never touches a disposed session.
+ * GS-INPUT-04: one invalidation policy — pause, session replacement, and
+ * unmount bump an ownership generation stamped onto every scheduled RN
+ * callback; stale callbacks die at ingress, pad ownership clears, and a
+ * fresh down is required before moves can acquire again.
+ */
+import { type ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { InputMap } from '../definition/types.js';
+import type { SceneMap } from '../definition/types.js';
+import type { GameSession } from '../core/session/types.js';
+/** Declared button action names of an input map. */
+export type ButtonActionName<TInput extends InputMap> = {
+    [TName in Extract<keyof TInput, string>]: TInput[TName] extends {
+        readonly type: 'button';
+    } ? TName : never;
+}[Extract<keyof TInput, string>];
+export interface GameButtonPadProps<TScenes extends SceneMap, TInput extends InputMap> {
+    /** The session whose input buffer receives button presses. */
+    readonly game: GameSession<TScenes, TInput>;
+    /** One or more {@link GameButton} zones (any layout). */
+    readonly children?: ReactNode;
+    /**
+     * Container style layered over the default full-surface overlay. The pad
+     * never draws and never blocks touches outside mounted GameButtons.
+     */
+    readonly style?: StyleProp<ViewStyle>;
+    /** Extra hit area around every zone, in dp. Default 0. */
+    readonly hitSlop?: number;
+    /** Test id for the pad container. */
+    readonly testID?: string;
+}
+/**
+ * Map simultaneous multitouch zones onto declared button actions.
+ *
+ * The pad is an INVISIBLE FULL-SURFACE OVERLAY: it draws nothing and its
+ * empty areas let touches pass through (`pointerEvents="box-none"`), so you
+ * can render whatever React children you like underneath and position each
+ * {@link GameButton} anywhere on screen — flex rows, corners, one thumb-zone
+ * per side — with ordinary styles. Only the measured bounds of mounted
+ * {@link GameButton} components capture touches; every other point falls
+ * through to the content below.
+ */
+export declare function GameButtonPad<TScenes extends SceneMap, TInput extends InputMap>({ game, children, style, hitSlop, testID, }: GameButtonPadProps<TScenes, TInput>): import("react").JSX.Element;
+export interface GameButtonProps {
+    /** The declared button action this zone presses. */
+    readonly action: string;
+    /** Zone content (label, icon, art). */
+    readonly children?: ReactNode;
+    /** Zone layout + presentation styles. */
+    readonly style?: StyleProp<ViewStyle>;
+    /** Test id for end-to-end tests. */
+    readonly testID?: string;
+    /** Accessibility role announced to the OS. */
+    readonly accessibilityRole?: 'button';
+}
+/**
+ * One touch zone of the pad. Layout it however you like; its measured
+ * bounds become the multitouch hit area for `action`, in pad coordinates.
+ *
+ * GS-INPUT-03: the zone registers on layout (provisional, parent-relative)
+ * and re-resolves into pad space through native measurement whenever
+ * available; unmount and action replacement release the zone exactly once.
+ */
+export declare function GameButton({ action, children, style, testID, accessibilityRole }: GameButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=GameButtonPad.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameButtonPad.d.ts","sourceRoot":"","sources":["../../../../src/react/GameButtonPad.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AAEzD,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,QAAQ,IAAI;KACrD,KAAK,IAAI,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,GACvF,KAAK,GACL,KAAK;CACV,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAkCjC,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ;IACnF,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAAE,EAC/E,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,OAAW,EACX,MAAM,GACP,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,+BAyQrC;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,eAAe,+BAsBjG"}

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

@@ -1 +1 @@
-{"version":3,"file":"GamePointerInput.d.ts","sourceRoot":"","sources":["../../../../src/react/GamePointerInput.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AAUzD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAmB,CAAC;AAWpE,qDAAqD;AACrD,KAAK,iBAAiB,CAAC,MAAM,SAAS,QAAQ,IAAI;KAC/C,KAAK,IAAI,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,kBAAkB,GAAG,KAAK,GAAG,KAAK;CACnG,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAQjC,wEAAwE;AACxE,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ;IACtF,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC;CACvD;AAwED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAAE,EAClF,IAAI,EACJ,MAAM,EACN,eAAe,GAChB,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,+BA2UxC"}
+{"version":3,"file":"GamePointerInput.d.ts","sourceRoot":"","sources":["../../../../src/react/GamePointerInput.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AAUzD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAmB,CAAC;AAYpE,qDAAqD;AACrD,KAAK,iBAAiB,CAAC,MAAM,SAAS,QAAQ,IAAI;KAC/C,KAAK,IAAI,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,kBAAkB,GAAG,KAAK,GAAG,KAAK;CACnG,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAQjC,wEAAwE;AACxE,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ;IACtF,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,0BAA0B,CAAC;CACvD;AA+ED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAAE,EAClF,IAAI,EACJ,MAAM,EACN,eAAe,GAChB,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,+BAmYxC"}

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

@@ -1,10 +1,12 @@
 import { type ComponentType, type ReactNode } from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import { type SharedValue } from 'react-native-reanimated';
+import type { CameraCut2D } from '../camera2d.js';
 import type { InputMap, SceneMap } from '../definition/types.js';
 import type { AssetGroupMap, LoadedAssets } from '../assets/types.js';
 import type { CommitFrame, GameSession } from '../core/session/types.js';
 import type { ResolvedViewport2D } from '../viewport2d/index.js';
+import type { GameCamera2DDefinition } from './camera2d/defineGameCamera2D.js';
 import type { GameViewInstrumentation } from './instrumentation.js';
 import { type ViewportBinding } from './viewportBinding.js';
 /** Stable imperative values supplied to a Skia renderer component. */
@@ -18,6 +20,12 @@ export interface GameRendererProps<TScenes extends SceneMap, TAssets extends Ass
     readonly alpha: SharedValue<number>;
     /** Latest resolved viewport shared with the input adapter. */
     readonly viewport: SharedValue<ResolvedViewport2D | undefined>;
+    /**
+     * The presented camera cut (T12.3), present only when the game opts in
+     * via `camera2D`. Undefined until the first committed camera; camera
+     * movement never re-renders React.
+     */
+    readonly camera?: SharedValue<CameraCut2D | undefined>;
     /** The stable loaded asset lease (T7.5); shape-only renderers omit it. */
     readonly assets?: LoadedAssets<TAssets>;
 }
@@ -34,6 +42,13 @@ export interface GameViewProps<TScenes extends SceneMap, TInput extends InputMap
     readonly presentationKey?: string | number;
     /** The stable loaded asset lease; shape-only games omit it. */
     readonly assets?: LoadedAssets<TAssets>;
+    /**
+     * Optional static camera binding (T12.3). When absent, the exact current
+     * viewport path is preserved. GameView owns the presented camera; the
+     * renderer receives it as a prop and the pointer adapter discovers it
+     * from the mounted surface.
+     */
+    readonly camera2D?: GameCamera2DDefinition<CommitFrame<TScenes>>;
     /** Stable Skia renderer component for the session's scene snapshots. */
     readonly renderer: ComponentType<GameRendererProps<TScenes, TAssets>>;
     /** Optional measurement callbacks for the Performance Lab (F1). */
@@ -57,5 +72,16 @@ export interface GameViewport {
     readonly viewport: SharedValue<ResolvedViewport2D | undefined>;
 }
 export declare const GameViewportContext: import("react").Context<GameViewport | null>;
-export declare function GameView<TScenes extends SceneMap, TInput extends InputMap, TAssets extends AssetGroupMap = AssetGroupMap>({ game, presentationKey, assets, renderer: Renderer, children, style, instrumentation, }: GameViewProps<TScenes, TInput, TAssets>): import("react").JSX.Element;
+/**
+ * Context supplying the presented camera to pointer input children.
+ *
+ * The shared value is owned by `GameView` (fed by the per-session
+ * presentation), so renderer and pointer adapter observe the same camera
+ * generation. `undefined` when the game has no camera.
+ */
+export interface GameCameraSurface {
+    readonly presented: SharedValue<CameraCut2D | undefined> | undefined;
+}
+export declare const GameCameraContext: import("react").Context<GameCameraSurface | null>;
+export declare function GameView<TScenes extends SceneMap, TInput extends InputMap, TAssets extends AssetGroupMap = AssetGroupMap>({ game, presentationKey, assets, renderer: Renderer, children, style, instrumentation, camera2D, }: GameViewProps<TScenes, TInput, TAssets>): import("react").JSX.Element;
 //# sourceMappingURL=GameView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GameView.d.ts","sourceRoot":"","sources":["../../../../src/react/GameView.tsx"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG7F,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAe,CAAC;AAIxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AACjE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,sBAAmB,CAAC;AAE7E,sEAAsE;AACtE,MAAM,WAAW,iBAAiB,CAChC,OAAO,SAAS,QAAQ,EACxB,OAAO,SAAS,aAAa,GAAG,aAAa;IAE7C,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa,CAC5B,OAAO,SAAS,QAAQ,EACxB,MAAM,SAAS,QAAQ,EACvB,OAAO,SAAS,aAAa,GAAG,aAAa;IAE7C,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,mEAAmE;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IACnD,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;CAChE;AAED,eAAO,MAAM,mBAAmB,8CAA2C,CAAC;AAsJ5E,wBAAgB,QAAQ,CACtB,OAAO,SAAS,QAAQ,EACxB,MAAM,SAAS,QAAQ,EACvB,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7C,EACA,IAAI,EACJ,eAAe,EACf,MAAM,EACN,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EACR,KAAK,EACL,eAAe,GAChB,EAAE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,+BA2DzC"}
+{"version":3,"file":"GameView.d.ts","sourceRoot":"","sources":["../../../../src/react/GameView.tsx"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"createGameAssetStore.d.ts","sourceRoot":"","sources":["../../../../../src/react/assets/createGameAssetStore.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EAOf,MAAM,uBAAoB,CAAC;AAI5B,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,KAAK,IAAI,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,IAAI,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAmED,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,aAAa,EACtE,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,cAAc,GACxB;IACD,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;CACpC,CA+TA;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"createGameAssetStore.d.ts","sourceRoot":"","sources":["../../../../../src/react/assets/createGameAssetStore.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EAOf,MAAM,uBAAoB,CAAC;AAI5B,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,KAAK,IAAI,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,IAAI,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAkED,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,aAAa,EACtE,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,cAAc,GACxB;IACD,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;CACpC,CAuVA;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useGameAssets.d.ts","sourceRoot":"","sources":["../../../../../src/react/assets/useGameAssets.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAAwB,CAAC;AAE7D,wEAAwE;AACxE,MAAM,WAAW,SAAS,CAAC,SAAS,SAAS,aAAa;IACxD,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAiBD;;qDAEqD;AACrD,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,aAAa,IACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClH;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrH;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG;8CAC8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAEzE;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE;AAED,wBAAgB,aAAa,CAAC,SAAS,SAAS,aAAa,EAC3D,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;CAAE,EAC3E,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC,SAAS,CAAC,GAC3D,eAAe,CAAC,SAAS,CAAC,CAoG5B"}
+{"version":3,"file":"useGameAssets.d.ts","sourceRoot":"","sources":["../../../../../src/react/assets/useGameAssets.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAAwB,CAAC;AAE7D,wEAAwE;AACxE,MAAM,WAAW,SAAS,CAAC,SAAS,SAAS,aAAa;IACxD,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAiBD;;qDAEqD;AACrD,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,aAAa,IACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClH;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrH;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG;8CAC8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAEzE;AAmBD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE;AAED,wBAAgB,aAAa,CAAC,SAAS,SAAS,aAAa,EAC3D,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;CAAE,EAC3E,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC,SAAS,CAAC,GAC3D,eAAe,CAAC,SAAS,CAAC,CA6G5B"}

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

@@ -1,4 +1,4 @@
-import type { GameSessionStatus } from '../core/session/types.js';
+import type { GameSessionStatus, GameSubscription } from '../core/session/types.js';
 /** Minimal AppState-like source used to keep this seam platform-neutral. */
 export interface AppLifecycleSource {
     /** The current app state, read synchronously at bind time. */
@@ -15,6 +15,12 @@ export interface AppLifecycleSession {
     pause(): void;
     /** Resume a paused session. */
     resume(): void;
+    /**
+     * Optional status observation (T10.6): when present, the binder also
+     * guards against an external `start()` while the host is inactive, so a
+     * frame loop can never escape into the background.
+     */
+    addStatusListener?(listener: (status: GameSessionStatus) => void): GameSubscription;
 }
 /**
  * Pause a running session when the app becomes inactive or backgrounded and

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

@@ -1 +1 @@
-{"version":3,"file":"bindAppLifecycle.d.ts","sourceRoot":"","sources":["../../../../src/react/bindAppLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAAuB,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,gBAAgB,CACd,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,SAAS,IAAI,iBAAiB,CAAC;IAC/B,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;IACd,+BAA+B;IAC/B,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,MAAM,IAAI,CAyCZ"}
+{"version":3,"file":"bindAppLifecycle.d.ts","sourceRoot":"","sources":["../../../../src/react/bindAppLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAAuB,CAAC;AAGjF,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,gBAAgB,CACd,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC/B;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,SAAS,IAAI,iBAAiB,CAAC;IAC/B,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;IACd,+BAA+B;IAC/B,MAAM,IAAI,IAAI,CAAC;IACf;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,gBAAgB,CAAC;CACrF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,mBAAmB,GAC3B,MAAM,IAAI,CAsEZ"}

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

@@ -1 +1 @@
-{"version":3,"file":"bindGameSession.d.ts","sourceRoot":"","sources":["../../../../src/react/bindGameSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AAEtE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAC/E,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAClC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI,CAwBZ"}
+{"version":3,"file":"bindGameSession.d.ts","sourceRoot":"","sources":["../../../../src/react/bindGameSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAAuB,CAAC;AAGtE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,EAC/E,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAClC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI,CAiCZ"}

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

@@ -0,0 +1,24 @@
+/**
+ * `GameLayer2D` — an ordered parallax layer (T12.5).
+ *
+ * A small rendering primitive, not a scene graph: the layer draws its
+ * children with the presented camera whose center contribution is scaled
+ * per axis by the parallax factor. JSX order is render order; no z-index
+ * scheduler exists.
+ *
+ * Frozen policy: parallax scales only the camera center contribution. Zoom
+ * and rotation apply fully at every factor; factor 1 is the primary layer,
+ * factor 0 is camera-fixed on that axis. The correction is a pure
+ * translation relative to the parent camera, so layers never double-apply
+ * zoom or rotation.
+ */
+import type { ReactNode } from 'react';
+export declare function GameLayer2D({ parallax, children, }: {
+    /** Per-axis parallax factor; defaults to the primary layer `{ x: 1, y: 1 }`. */
+    readonly parallax?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=GameLayer2D.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameLayer2D.d.ts","sourceRoot":"","sources":["../../../../../src/react/camera2d/GameLayer2D.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYvC,wBAAgB,WAAW,CAAC,EAC1B,QAAyB,EACzB,QAAQ,GACT,EAAE;IACD,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,+BASA"}

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

@@ -0,0 +1,44 @@
+/**
+ * Camera2D definition (T12.3).
+ *
+ * A static, declarative camera binding: `select` reads the authored camera
+ * from committed frames, and the optional `cut` predicate signals an
+ * explicit cut (teleports, respawns) where interpolation must snap. The
+ * binding is owned by `GameView` and never by the renderer or the pointer
+ * adapter, so both consume the same presented generation.
+ */
+import type { Camera2D } from '../../camera2d.js';
+/** Failure context for a camera selector/cut/validation failure (GS-CAMERA-02). */
+export interface GameCameraErrorInfo {
+    /** Which stage of the commit transaction failed. */
+    readonly phase: 'select' | 'cut' | 'validate';
+    /** The original thrown value, preserved verbatim. */
+    readonly error: unknown;
+    /** The scene whose commit failed. */
+    readonly scene: string;
+}
+/** The static camera definition supplied to `GameView`. */
+export interface GameCamera2DDefinition<TFrame> {
+    /**
+     * Read the authored camera from a committed frame. Runs once per commit
+     * on the JS runtime; returning the same value keeps the camera static.
+     */
+    readonly select: (frame: TFrame) => Camera2D;
+    /**
+     * Optional explicit cut signal evaluated per commit. Returning true
+     * snaps presentation (no interpolation into the new camera), joining the
+     * automatic cuts for scene transitions, session replacement, and
+     * binding-generation changes.
+     */
+    readonly cut?: (frame: TFrame) => boolean;
+    /**
+     * Optional failure reporter (GS-CAMERA-02). Invoked at most once per
+     * failure episode with the failing phase and scene; a successful commit
+     * resets deduplication. Failures without a reporter keep the last valid
+     * presentation silently.
+     */
+    readonly onError?: (info: GameCameraErrorInfo) => void;
+}
+/** Validate and return a camera definition. */
+export declare function defineGameCamera2D<TFrame>(definition: GameCamera2DDefinition<TFrame>): GameCamera2DDefinition<TFrame>;
+//# sourceMappingURL=defineGameCamera2D.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defineGameCamera2D.d.ts","sourceRoot":"","sources":["../../../../../src/react/camera2d/defineGameCamera2D.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAgB,CAAC;AAE/C,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IAC9C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB,CAAC,MAAM;IAC5C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACxD;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,MAAM,EACvC,UAAU,EAAE,sBAAsB,CAAC,MAAM,CAAC,GACzC,sBAAsB,CAAC,MAAM,CAAC,CAWhC"}

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

@@ -0,0 +1,22 @@
+import { type SharedValue } from 'react-native-reanimated';
+import { type CameraCut2D } from '../../camera2d.js';
+import type { CommitFrame } from '../../core/session/types.js';
+import type { SceneMap } from '../../definition/types.js';
+import type { GameCamera2DDefinition } from './defineGameCamera2D.js';
+/** A UI-side camera binding for one session presentation. */
+export interface PresentedCameraBinding<TScenes extends SceneMap> {
+    /** Evaluate the selector against one committed frame (JS runtime). */
+    commit(frame: CommitFrame<TScenes>): void;
+    /** Advance presentation by the current alpha (UI runtime worklet). */
+    present(alpha: number): void;
+    /** Drop the current state; the presented value stays as-is. */
+    dispose(): void;
+}
+/**
+ * Create the camera binding for one presentation.
+ *
+ * The `presented` shared value is owned by `GameView` so the pointer
+ * adapter (a sibling of the renderer) reads the same generation.
+ */
+export declare function usePresentedCameraBinding<TScenes extends SceneMap>(definition: GameCamera2DDefinition<CommitFrame<TScenes>> | undefined, presented: SharedValue<CameraCut2D | undefined>): PresentedCameraBinding<TScenes>;
+//# sourceMappingURL=usePresentedCameraBinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePresentedCameraBinding.d.ts","sourceRoot":"","sources":["../../../../../src/react/camera2d/usePresentedCameraBinding.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,mBAAgB,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAsB,CAAC;AAEnE,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,QAAQ;IAC9D,sEAAsE;IACtE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,sEAAsE;IACtE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,QAAQ,EAChE,UAAU,EAAE,sBAAsB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,EACpE,SAAS,EAAE,WAAW,CAAC,WAAW,GAAG,SAAS,CAAC,GAC9C,sBAAsB,CAAC,OAAO,CAAC,CAoIjC"}