rn-gamekit 0.1.0

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

@@ -0,0 +1,37 @@
+import type { CoalescedPointerEvent } from './pointerCoalescer.js';
+/** RN-side mirror of whether the trailing-flush sampler should be mounted. */
+export interface SamplerMirrorState {
+    readonly generation: number;
+    readonly active: boolean;
+}
+/**
+ * Manual-gesture terminal lifecycle (F3).
+ *
+ * The RNGH 3 manual recognizer is activated explicitly on touch-down and
+ * must be returned to its terminal state explicitly: it stays active across
+ * separate touches and screen lifecycles otherwise. This pure decision
+ * drives the deactivation call in `GamePointerInput`; the recognizer-state
+ * operations themselves stay on the UI runtime.
+ */
+/** A single-pointer binding begins only with the first native touch. */
+export declare function canBeginPrimaryPointer(nativeTouchCount: number): boolean;
+/** After an up edge, deactivate once RNGH reports that no touches remain. */
+export declare function deactivateAfterUp(remainingTouches: number): boolean;
+/** Unexpected finalization while a pointer is still active must neutralize ownership. */
+export declare function cancelOnActiveFinalize(activePointerId: number | undefined): boolean;
+/**
+ * Sampler mirror for the F2 trailing flush (F2 lifecycle).
+ *
+ * The trailing-flush frame callback must stay active exactly while the
+ * coalescer owns a pointer. Returns `true` when a begin crossed (pointer
+ * owned), `false` when a terminal edge crossed (pointer released), and
+ * `undefined` for empty batches (secondary touches — never toggle the
+ * sampler) and flushed moves (the pointer stays owned).
+ */
+export declare function samplerMirrorFromBatch(batch: readonly CoalescedPointerEvent[]): boolean | undefined;
+/**
+ * Apply a UI-originated sampler update only when it belongs to the current
+ * binding generation.
+ */
+export declare function reduceSamplerMirrorState(currentGeneration: number, previous: SamplerMirrorState, next: SamplerMirrorState): SamplerMirrorState;
+//# sourceMappingURL=gestureLifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gestureLifecycle.d.ts","sourceRoot":"","sources":["../../../../src/react/gestureLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAEhE,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AAEH,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC,OAAO,GAAG,SAAS,CAarB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,CAEpB"}

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

@@ -0,0 +1,47 @@
+/**
+ * Optional measurement seams for the mounted game pipeline (F1).
+ *
+ * These callbacks let the Performance Lab attribute results to the real
+ * mounted components — GameView presentation, RNGH raw touches, and
+ * UI→RN forwarding — instead of headless substitutes. They are optional,
+ * cost nothing when absent (a single optional chain at event sites, never
+ * per-frame), and are not part of the gameplay API contract: the playground
+ * lab is their only consumer until the device matrix approves them.
+ *
+ * Runtime ownership:
+ * - Pointer callbacks run on the **UI runtime** (inside gesture worklets);
+ *   pass stable workletized closures and only touch worklet-safe state
+ *   (shared values, counters).
+ * - `onPresentCommit` runs on the **RN runtime** (inside the commit
+ *   binding); pass a plain JS callback.
+ */
+import type { CoalescedPointerEvent } from './pointerCoalescer.js';
+/** Raw touch kinds as observed by the manual gesture callbacks. */
+export type PointerStageKind = 'down' | 'move' | 'up' | 'cancel';
+/** Pointer pipeline instrumentation (UI runtime callbacks). */
+export interface GamePointerInstrumentation {
+    /** A raw touch reached the manual gesture handlers. */
+    readonly onRawTouch?: (kind: PointerStageKind, pointerId: number, atMs: number) => void;
+    /** A coalesced event crossed from the UI runtime into the RN runtime. */
+    readonly onForwarded?: (kind: CoalescedPointerEvent['kind'], pointerId: number, atMs: number) => void;
+    /**
+     * RN runtime: the binding's verdict for a dispatched packet (F1). Only
+     * accepted packets may become latency samples; stale/rejected packets are
+     * counted but never sampled.
+     */
+    readonly onDispatchResult?: (seq: number, atMs: number, accepted: boolean) => void;
+    /** The trailing-flush sampler mounted (true) or unmounted (false). */
+    readonly onSamplerChanged?: (mounted: boolean) => void;
+}
+/** GameView presentation instrumentation (RN runtime callback). */
+export interface GameViewInstrumentation {
+    /** A commit was presented to the canvas frame shared value. */
+    readonly onPresentCommit?: (revision: number, atMs: number) => void;
+    /**
+     * UI runtime: the first UI frame that observed a new commit revision (the
+     * alpha clock's reset detects it). Skia GPU presentation is not proven by
+     * this hook, so latency consumers must name the stage honestly.
+     */
+    readonly onUiRevisionObserved?: (revision: number, atMs: number) => void;
+}
+//# sourceMappingURL=instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../../../src/react/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAEhE,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEjE,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxF,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,KACT,IAAI,CAAC;IACV;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACnF,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1E"}

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

@@ -0,0 +1,104 @@
+import type { InputController } from '../core/input/types.js';
+import type { Point2D } from '../geometry/types.js';
+import { type ResolvedViewport2D } from '../viewport2d/index.js';
+import type { CoalescedPointerEvent } from './pointerCoalescer.js';
+/**
+ * A coalesced pointer event stamped with the binding epoch it was scheduled
+ * under (F6). Packets scheduled before a layout revision or binding
+ * replacement carry the old epoch and are rejected on the RN runtime, so a
+ * stale begin cannot reacquire input with old coordinates and a stale
+ * terminal edge cannot release a newer capture that reused the pointer id.
+ */
+export type PointerPacket = CoalescedPointerEvent & {
+    /** Monotonic adapter-owned binding generation (F3 follow-up). */
+    readonly generation: number;
+    /** Adapter-owned layout epoch; bumped on layout revisions and unmount. */
+    readonly layoutEpoch: number;
+    /** Monotonic UI-runtime forward sequence (F1 latency causality). */
+    readonly seq: number;
+    /** UI-runtime timestamp of the forward (F1 latency causality). */
+    readonly atMs: number;
+};
+/** The identity a pointer binding is scoped to. */
+export interface PointerBindingIdentity<TName extends string> {
+    /** The session input controller (identity changes when the session changes). */
+    readonly input: InputController<TName>;
+    /** The declared pointer action name. */
+    readonly action: TName;
+    /** Identity token for the viewport provider (changes on layout owner swaps). */
+    readonly viewport: unknown;
+}
+/** A binding plus the identity it was created for. */
+export interface PointerBindingEntry<TName extends string> {
+    readonly binding: PointerBinding<TName>;
+    readonly identity: PointerBindingIdentity<TName>;
+}
+/**
+ * Reuse the previous binding when the identity is unchanged, otherwise dispose
+ * it and create a fresh binding. Returns whether a new binding was created.
+ */
+export declare function createPointerBinding<TName extends string>(identity: PointerBindingIdentity<TName>, getViewport: () => ResolvedViewport2D | undefined, previous: PointerBindingEntry<TName> | undefined): {
+    readonly entry: PointerBindingEntry<TName>;
+    readonly created: boolean;
+};
+/**
+ * Platform-neutral pointer binding seam.
+ *
+ * It converts gesture positions from surface coordinates into logical world
+ * coordinates through the current resolved viewport, rejects begins that
+ * start in `fit` letterbox space, and forwards semantic events into the
+ * session input buffer. The high-level `handleTouches*` methods mirror the
+ * adapter's touch dispatch (including forwarding the final up position) so
+ * the full adapter behavior is testable without mounting native gesture
+ * views. Ownership and neutralization live in the input buffer.
+ */
+export declare class PointerBinding<TActionName extends string> {
+    #private;
+    constructor(action: TActionName, input: InputController<TActionName>, getViewport: () => ResolvedViewport2D | undefined, generation: number);
+    /**
+     * The monotonic adapter-owned generation this binding belongs to (F3).
+     * Generations never reset to zero, so a replacement binding and the
+     * worklet closures that stamp its packets agree by construction — no
+     * post-commit synchronization is needed.
+     */
+    get generation(): number;
+    /**
+     * Dispatch a coalesced packet stamped with its scheduling generation.
+     *
+     * Returns `false` (and forwards nothing) when the binding is disposed or
+     * the packet belongs to a different generation; the active gesture's
+     * packets keep flowing under the current generation with the latest
+     * viewport. Layout-epoch rejection happens on the adapter side (the epoch
+     * is adapter-owned and never resets, so it cannot desynchronize).
+     */
+    dispatch(packet: PointerPacket): boolean;
+    /**
+     * Begin a pointer at a surface point.
+     *
+     * Returns `false` when the layout is invalid or the point starts in
+     * letterbox space; the gesture must be rejected and never becomes the owner.
+     */
+    begin(pointerId: number, surfacePoint: Point2D): boolean;
+    /** Move a pointer. Conversion remains unbounded outside content bounds. */
+    move(pointerId: number, surfacePoint: Point2D): void;
+    /** End a pointer. The owning pointer is released by the input buffer. */
+    end(pointerId: number): void;
+    /** Cancel the active pointer (gesture cancellation, layout change, unmount). */
+    cancel(): void;
+    /** Handle a touch-down gesture event with a surface position. */
+    handleTouchesDown(pointerId: number, x: number, y: number): boolean;
+    /** Handle a touch-move gesture event with a surface position. */
+    handleTouchesMove(pointerId: number, x: number, y: number): void;
+    /**
+     * Handle a touch-up gesture event with its final surface position.
+     *
+     * The final position is forwarded before ownership ends so the documented
+     * release frame contains the actual point where the pointer lifted.
+     */
+    handleTouchesUp(pointerId: number, x: number, y: number): void;
+    /** Handle a platform touch cancellation. */
+    handleTouchesCancelled(): void;
+    /** Stop forwarding events. Safe to call repeatedly. */
+    dispose(): void;
+}
+//# sourceMappingURL=pointerBinding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pointerBinding.d.ts","sourceRoot":"","sources":["../../../../src/react/pointerBinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAmB,CAAC;AACjD,OAAO,EAAwC,KAAK,kBAAkB,EAAE,MAAM,wBAAe,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG;IAClD,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAKF,mDAAmD;AACnD,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,MAAM;IAC1D,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,MAAM;IACvD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,MAAM,EACvD,QAAQ,EAAE,sBAAsB,CAAC,KAAK,CAAC,EACvC,WAAW,EAAE,MAAM,kBAAkB,GAAG,SAAS,EACjD,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,SAAS,GAC/C;IAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAwB3E;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc,CAAC,WAAW,SAAS,MAAM;;gBAQlD,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,EACnC,WAAW,EAAE,MAAM,kBAAkB,GAAG,SAAS,EACjD,UAAU,EAAE,MAAM;IAQpB;;;;;OAKG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAqBxC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO;IAexD,2EAA2E;IAC3E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI;IAWpD,yEAAyE;IACzE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO5B,gFAAgF;IAChF,MAAM,IAAI,IAAI;IAOd,iEAAiE;IACjE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAInE,iEAAiE;IACjE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhE;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9D,4CAA4C;IAC5C,sBAAsB,IAAI,IAAI;IAI9B,uDAAuD;IACvD,OAAO,IAAI,IAAI;CAGhB"}

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

@@ -0,0 +1,106 @@
+/**
+ * Pointer coalescer (T7).
+ *
+ * Pure, worklet-safe state machine that throttles move forwarding from the
+ * UI runtime: at most one move crosses runtimes per configured interval
+ * (default: one fixed step), always carrying the latest dirty position.
+ * Edges are never throttled or dropped:
+ *
+ * - `down` forwards the begin immediately (latency-critical) and establishes
+ *   the single active pointer; a secondary pointer is ignored.
+ * - `move` updates the latest dirty position and forwards it at most once
+ *   per interval.
+ * - `flush` forwards the latest deferred move even if native touch movement
+ *   has paused.
+ * - `up` forwards the final position in the terminal edge and releases the
+ *   active pointer.
+ * - `cancel` neutralizes exactly once.
+ * - `reset` drops all queued state (layout revision, unmount).
+ *
+ * The coalescer is not the authoritative owner: ownership, edge sampling,
+ * and containment re-validation stay on the JS side (input buffer).
+ * Time is injected so ordering and frequency are testable without a device.
+ */
+export type CoalescedPointerEvent = {
+    readonly kind: 'begin';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: 'move';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: 'end';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+} | {
+    readonly kind: 'cancel';
+};
+export interface PointerCoalescer {
+    /** A pointer went down at a surface point. Returns the events to forward. */
+    down(pointerId: number, x: number, y: number, nowMs: number): readonly CoalescedPointerEvent[];
+    /** A pointer moved. Returns at most one (coalesced) move per interval. */
+    move(pointerId: number, x: number, y: number, nowMs: number): readonly CoalescedPointerEvent[];
+    /** Forward a deferred move when the frame clock reaches the interval. */
+    flush(nowMs: number): readonly CoalescedPointerEvent[];
+    /** A pointer lifted. Returns the final point and the terminal edge together. */
+    up(pointerId: number, x: number, y: number, nowMs: number): readonly CoalescedPointerEvent[];
+    /** Neutralize the active pointer. Returns the cancel event exactly once. */
+    cancel(nowMs: number): readonly CoalescedPointerEvent[];
+    /** Drop all queued state without emitting anything (layout/unmount). */
+    reset(): void;
+}
+interface ActivePointer {
+    readonly pointerId: number;
+    readonly lastForwardMs: number;
+    readonly pendingMove: {
+        readonly x: number;
+        readonly y: number;
+    } | undefined;
+}
+/** Explicit coalescer state stored in one UI-runtime SharedValue. */
+export interface PointerCoalescerState {
+    readonly maxMoveIntervalMs: number;
+    readonly active: ActivePointer | undefined;
+}
+/** One native touch input consumed by the pure coalescer reducer. */
+export type PointerCoalescerInput = {
+    readonly kind: 'down' | 'move' | 'up';
+    readonly pointerId: number;
+    readonly x: number;
+    readonly y: number;
+    readonly nowMs: number;
+} | {
+    readonly kind: 'cancel';
+    readonly nowMs: number;
+} | {
+    readonly kind: 'flush';
+    readonly nowMs: number;
+} | {
+    readonly kind: 'reset';
+};
+/** Immutable state plus the ordered events produced by one coalescer input. */
+export interface PointerCoalescerTransition {
+    readonly state: PointerCoalescerState;
+    readonly events: readonly CoalescedPointerEvent[];
+}
+/** Create fresh state for a UI-runtime coalescer. */
+export declare function createPointerCoalescerState(maxMoveIntervalMs: number): PointerCoalescerState;
+/**
+ * Advance pointer coalescing without relying on mutable worklet closures.
+ *
+ * RNGH registers each touch callback as a separate worklet. Closure-captured
+ * objects may therefore be serialized into independent copies; callers must
+ * keep the returned state in one SharedValue and pass it into every handler.
+ */
+export declare function reducePointerCoalescer(state: PointerCoalescerState, input: PointerCoalescerInput): PointerCoalescerTransition;
+/**
+ * Stateful RN-runtime adapter retained for pure tests and non-worklet callers.
+ * UI gesture handlers use `reducePointerCoalescer` with a SharedValue instead.
+ */
+export declare function createPointerCoalescer(maxMoveIntervalMs: number): PointerCoalescer;
+export {};
+//# sourceMappingURL=pointerCoalescer.d.ts.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * UI-side containment mirror (T7).
+ *
+ * The exact same viewport formula the JS binding uses to reject begins in
+ * `fit` letterbox space, workletized so the Manual gesture can fail before
+ * activation. JS re-validates on receipt; this mirror only prevents an
+ * obviously invalid begin from activating the gesture at all.
+ */
+import type { ResolvedViewport2D } from '../viewport2d/index.js';
+/** Whether a surface point may begin a gesture in the interactive content. */
+export declare function isBeginAllowed(viewport: ResolvedViewport2D | undefined, x: number, y: number): boolean;
+//# sourceMappingURL=pointerContainment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pointerContainment.d.ts","sourceRoot":"","sources":["../../../../src/react/pointerContainment.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAe,CAAC;AAExD,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAOT"}

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

@@ -0,0 +1,75 @@
+/**
+ * `GameSprite` — the common GameKit sprite integration (T7.6).
+ *
+ * Accepts the renderer's commit/alpha shared values, narrows the snapshot
+ * by `scene`, invokes one worklet `select` mapper, and drives the
+ * underlying `Sprite` through coherent derived values. The selector's scene
+ * typing is exact — a `scene="play"` selector receives only the play
+ * snapshot without casts.
+ */
+import { type SharedValue } from 'react-native-reanimated';
+import type { CommitFrame } from '../../core/session/types.js';
+import type { SceneSnapshot } from '../../scene/types.js';
+import type { SceneMap } from '../../definition/types.js';
+import type { LoadedImage, LoadedSpriteSheet } from '../../assets/types.js';
+/** Interpolation context for the select mapper. */
+export interface GameSpriteSelectContext<TScenes extends SceneMap, TSceneName extends Extract<keyof TScenes, string>> {
+    /** The previous commit's snapshot for the selected scene. */
+    readonly previous: SceneSnapshot<TScenes[TSceneName]>;
+    /** The current commit's snapshot for the selected scene. */
+    readonly current: SceneSnapshot<TScenes[TSceneName]>;
+    /** Presentation interpolation alpha in [0, 1]. */
+    readonly alpha: number;
+}
+/** The discrete + interpolated presentation selection. */
+export interface GameSpriteSelection {
+    /** World position (interpolated when the selector requests it). */
+    readonly x: number;
+    readonly y: number;
+    /** Rotation in radians around the anchor. */
+    readonly rotation?: number;
+    /** Uniform scale around the anchor. */
+    readonly scale?: number;
+    /** The clip to select from the sprite sheet (discrete). */
+    readonly clip?: string;
+    /** Elapsed time within the clip in milliseconds (discrete). */
+    readonly elapsedMs?: number;
+    /** The exact frame name (discrete; overrides clip + elapsedMs). */
+    readonly frame?: string;
+    /** Explicit flips (discrete). */
+    readonly flipX?: boolean;
+    readonly flipY?: boolean;
+    /** Opacity in [0, 1]. */
+    readonly opacity?: number;
+    /** Hide the sprite. */
+    readonly visible?: boolean;
+}
+export interface GameSpriteProps<TScenes extends SceneMap, TSceneName extends Extract<keyof TScenes, string>> {
+    /** The scene whose snapshot the selector reads. */
+    readonly scene: TSceneName;
+    /** The renderer's latest commit. */
+    readonly commit: SharedValue<CommitFrame<TScenes>>;
+    /** The renderer's presentation alpha. */
+    readonly alpha: SharedValue<number>;
+    /** The loaded asset; the renderer borrows and never disposes it. */
+    readonly source: LoadedImage | LoadedSpriteSheet;
+    /** Normalized anchor in [0, 1] relative to the selected frame. */
+    readonly anchor?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** Worklet mapper from the scene snapshots to presentation values. */
+    readonly select: (context: GameSpriteSelectContext<TScenes, TSceneName>) => GameSpriteSelection;
+}
+/**
+ * Select the frame name for a clip + elapsed time (loop/once semantics).
+ * Reads the descriptor's animation table; the result is resolved against
+ * the frame rectangles by the caller. Reuses the pure sampler's semantics.
+ */
+export declare function spriteFrameNameForClip(animations: Readonly<Record<string, {
+    readonly frames: readonly string[];
+    readonly frameDurationMs: number;
+    readonly mode: 'loop' | 'once';
+}>>, clip: string, elapsedMs: number): string;
+export declare function GameSprite<TScenes extends SceneMap, TSceneName extends Extract<keyof TScenes, string>>({ scene, commit, alpha, source, anchor, select, }: GameSpriteProps<TScenes, TSceneName>): import("react").JSX.Element;
+//# sourceMappingURL=GameSprite.d.ts.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * `GameWorld2D` — the viewport transform group (T7.6).
+ *
+ * Applies the resolved viewport offset/scale exactly once to all child
+ * sprites. It adds no camera state, subscribes no React per frame, and is
+ * not a camera API. Raw Skia nodes may be nested inside.
+ */
+import type { ReactNode } from 'react';
+import { type SharedValue } from 'react-native-reanimated';
+import type { ResolvedViewport2D } from '../../viewport2d/types.js';
+/**
+ * The viewport transform as a Skia element list:
+ * `T(offset) · S(scale)` — logical units map to surface points.
+ */
+export declare function viewportTransform(viewport: ResolvedViewport2D | undefined): readonly ({
+    readonly translateX: number;
+} | {
+    readonly translateY: number;
+} | {
+    readonly scaleX: number;
+} | {
+    readonly scaleY: number;
+})[];
+export declare function GameWorld2D({ viewport, children, }: {
+    /** The resolved viewport shared value supplied to the renderer. */
+    readonly viewport: SharedValue<ResolvedViewport2D | undefined>;
+    readonly children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=GameWorld2D.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameWorld2D.d.ts","sourceRoot":"","sources":["../../../../../src/react/sprites/GameWorld2D.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAAwB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAClF;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAC9B,EAAE,CAWF;AAED,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,+BAGA"}

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

@@ -0,0 +1,43 @@
+import { type SamplingOptions } from '@shopify/react-native-skia';
+import { type SharedValue } from 'react-native-reanimated';
+import type { LoadedImage, LoadedSpriteSheet } from '../../assets/types.js';
+export { resolveSpriteFrameRect, type SpriteFrameRect } from './spriteTransform.js';
+export type SpriteAnimatable = number | SharedValue<number>;
+export type SpriteAnimatableBoolean = boolean | SharedValue<boolean>;
+export type SpriteAnimatableString = string | SharedValue<string>;
+export interface SpriteProps {
+    /** The loaded asset; the renderer borrows and never disposes it. */
+    readonly source: LoadedImage | LoadedSpriteSheet;
+    /** Frame name for sprite sheets; ignored for full images. A shared value
+     * may carry undefined while the selection has not been published. */
+    readonly frame?: SpriteAnimatableString | SharedValue<string | undefined>;
+    /** Clip name for sprite sheets; the frame is selected from it. */
+    readonly clip?: SpriteAnimatableString;
+    /** Elapsed milliseconds within the clip (frame selection). */
+    readonly elapsedMs?: SpriteAnimatable;
+    /** World position in logical units. */
+    readonly x?: SpriteAnimatable;
+    readonly y?: SpriteAnimatable;
+    /** Rotation in radians around the anchor. */
+    readonly rotation?: SpriteAnimatable;
+    /** Uniform scale around the anchor. */
+    readonly scale?: SpriteAnimatable;
+    /** Normalized anchor in [0, 1] relative to the selected frame. */
+    readonly anchor?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** Explicit flips preserve the anchor. */
+    readonly flipX?: SpriteAnimatableBoolean;
+    readonly flipY?: SpriteAnimatableBoolean;
+    /** Opacity in [0, 1]. */
+    readonly opacity?: SpriteAnimatable;
+    /** Optional tint color applied to the draw. */
+    readonly tint?: string;
+    /** Sampling for the texture; pixel-art defaults to nearest. */
+    readonly sampling?: SamplingOptions;
+    /** Hide the sprite without unmounting it. */
+    readonly visible?: SpriteAnimatableBoolean;
+}
+export declare function Sprite({ source, frame, clip, elapsedMs, x, y, rotation, scale, anchor, flipX, flipY, opacity, tint, sampling, visible, }: SpriteProps): import("react").JSX.Element;
+//# sourceMappingURL=Sprite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../src/react/sprites/Sprite.tsx"],"names":[],"mappings":"AAYA,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAoB,CAAC;AAQzE,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAmB,CAAC;AAEjF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACjD;yEACqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IACvC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,uCAAuC;IACvC,QAAQ,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC;IACzC,yBAAyB;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,wBAAgB,MAAM,CAAC,EACrB,MAAM,EACN,KAAK,EACL,IAAI,EACJ,SAAa,EACb,CAAK,EACL,CAAK,EACL,QAAY,EACZ,KAAS,EACT,MAAuB,EACvB,KAAa,EACb,KAAa,EACb,OAAW,EACX,IAAI,EACJ,QAAQ,EACR,OAAc,GACf,EAAE,WAAW,+BAmHb"}

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

@@ -0,0 +1,41 @@
+import { type SharedValue } from 'react-native-reanimated';
+import type { CommitFrame } from '../../core/session/types.js';
+import type { SceneSnapshot } from '../../scene/types.js';
+import type { SceneMap } from '../../definition/types.js';
+import type { LoadedImage, LoadedSpriteSheet } from '../../assets/types.js';
+/** The per-item write surface handed to the author's `write` mapper. */
+export interface SpriteBatchWrite {
+    /**
+     * Write one batch slot. `frame` names the sheet frame; `x`/`y` are world
+     * logical units; `rotation` is radians around the batch anchor; `scale`
+     * is uniform; `visible: false` hides the slot (zero-size rect). Writes
+     * past capacity fail in development.
+     */
+    readonly set: (index: number, frame: string, x: number, y: number, rotation: number, scale: number, visible?: boolean) => void;
+}
+export interface SpriteBatchProps<TScenes extends SceneMap, TSceneName extends Extract<keyof TScenes, string>, TItem> {
+    /** The scene whose snapshot `select` reads. */
+    readonly scene: TSceneName;
+    /** The renderer's latest commit. */
+    readonly commit: SharedValue<CommitFrame<TScenes>>;
+    /** The renderer's presentation alpha. */
+    readonly alpha: SharedValue<number>;
+    /** One decoded sheet shared by every instance. */
+    readonly source: LoadedImage | LoadedSpriteSheet;
+    /** Fixed slot capacity for the mounted batch. */
+    readonly capacity: number;
+    /** Map the committed snapshot to the item array. */
+    readonly select: (context: {
+        readonly current: SceneSnapshot<TScenes[TSceneName]>;
+        readonly alpha: number;
+    }) => readonly TItem[];
+    /** Write each item into its batch slot (UI runtime). */
+    readonly write: (write: SpriteBatchWrite, item: TItem, index: number) => void;
+    /** Uniform anchor in [0, 1] relative to the selected frame. */
+    readonly anchor?: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export declare function SpriteBatch<TScenes extends SceneMap, TSceneName extends Extract<keyof TScenes, string>, TItem>({ scene, commit, alpha, source, capacity, select, write, anchor, }: SpriteBatchProps<TScenes, TSceneName, TItem>): import("react").JSX.Element;
+//# sourceMappingURL=SpriteBatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteBatch.d.ts","sourceRoot":"","sources":["../../../../../src/react/sprites/SpriteBatch.tsx"],"names":[],"mappings":"AAmBA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAoB,CAAC;AAIzE,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,KACd,IAAI,CAAC;CACX;AAED,MAAM,WAAW,gBAAgB,CAC/B,OAAO,SAAS,QAAQ,EACxB,UAAU,SAAS,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,EACjD,KAAK;IAEL,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACjD,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;QACzB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,KAAK,SAAS,KAAK,EAAE,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAcD,wBAAgB,WAAW,CACzB,OAAO,SAAS,QAAQ,EACxB,UAAU,SAAS,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,EACjD,KAAK,EACL,EACA,KAAK,EACL,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,KAAK,EACL,MAAuB,GACxB,EAAE,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,+BAuH9C"}

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

@@ -0,0 +1,10 @@
+/** Pure SpriteBatch update policy (RF8): the overflow decision and the
+ * active count. Development reports a structured error; production clamps
+ * and hides the overflow so the UI runtime never crashes for ordinary data
+ * growth. Runs inside the batch's update worklet, so it carries the worklet
+ * directive. */
+export declare function batchUpdatePolicy(itemsCount: number, capacity: number, dev: boolean): {
+    readonly overflow: boolean;
+    readonly activeCount: number;
+};
+//# sourceMappingURL=spriteBatchPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spriteBatchPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/react/sprites/spriteBatchPolicy.ts"],"names":[],"mappings":"AAAA;;;;gBAIgB;AAChB,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,OAAO,GACX;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAW9D"}