rn-gamekit 0.1.0 → 0.2.1

package/lib/typescript/src/collision2d/sweeps.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Swept collision queries (T11.3, repaired in T11-F2, allocation-disciplined
+ * in T11-FF7).
+ *
+ * `time` is normalized to `[0, 1]` along the displacement. A starting
+ * overlap returns `time: 0` with the static manifold normal; zero
+ * displacement returns `undefined` (never NaN). At equal times the
+ * candidate evaluated FIRST wins — the X face before the Y face, faces
+ * before corners, corners in index order (T11-TF1). Circle-sweep misses
+ * allocate nothing; AABB-AABB sweep misses still allocate the expanded
+ * box, segment endpoints, and axis array (GS-COLLISION-03: the old blanket
+ * claim overstated this path, which stays scalar-simple by design).
+ *
+ * Circle-AABB sweeps raycast against the exact Minkowski geometry: the
+ * target expanded by the radius with ROUNDED corners. Face candidates come
+ * from the four expanded faces (valid only within the face's extent), and
+ * corner candidates come from radius circles around each target corner
+ * (valid only in the corner's exterior quadrant). AABB-AABB sweeps use the
+ * asymmetric expansion for the moving AABB's top-left reference point —
+ * the Minkowski sum of two AABBs is an AABB, so the slab method is exact.
+ *
+ * T11-FF7 allocation discipline: the four corner descriptors are derived
+ * arithmetically from the corner index (no per-call arrays or predicate
+ * closures), the two quadratic roots are evaluated as scalars, and the best
+ * candidate is tracked in scalars; only the final public `SweepHit2D` is
+ * allocated.
+ */
+import type { Aabb2D, Circle2D, Point2D, Vector2D } from '../geometry/types.js';
+/** Earliest impact of a swept circle against an AABB. */
+export interface SweepCircleAabb2DOptions {
+    /** The moving circle at the start of the step. */
+    readonly circle: Circle2D;
+    /** Displacement over the step (velocity times delta time). */
+    readonly displacement: Vector2D;
+    /** The stationary target. */
+    readonly target: Aabb2D;
+}
+/** Earliest impact of a swept AABB against an AABB. */
+export interface SweepAabbAabb2DOptions {
+    /** The moving AABB at the start of the step. */
+    readonly aabb: Aabb2D;
+    /** Displacement over the step. */
+    readonly displacement: Vector2D;
+    /** The stationary target. */
+    readonly target: Aabb2D;
+}
+/** Earliest impact of a swept shape against a target. */
+export interface SweepHit2D {
+    /** Normalized impact time in `[0, 1]`. */
+    readonly time: number;
+    /** Unit normal moving the swept shape out of the target. */
+    readonly normal: Vector2D;
+    /** Contact point on the target at impact. */
+    readonly point: Point2D;
+}
+/** Swept circle-AABB against the exact rounded-rectangle Minkowski shape. */
+export declare function sweepCircleAabb2D(options: SweepCircleAabb2DOptions): SweepHit2D | undefined;
+/** Swept AABB-AABB with the exact asymmetric reference expansion. */
+export declare function sweepAabbAabb2D(options: SweepAabbAabb2DOptions): SweepHit2D | undefined;
+//# sourceMappingURL=sweeps.d.ts.map

package/lib/typescript/src/collision2d/sweeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweeps.d.ts","sourceRoot":"","sources":["../../../../src/collision2d/sweeps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAmB,CAAC;AAU7E,yDAAyD;AACzD,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAuBD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,GAAG,SAAS,CA0H3F;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,UAAU,GAAG,SAAS,CA0CvF"}

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

@@ -0,0 +1,7 @@
+/**
+ * Subpath entry for `rn-gamekit/collision2d`.
+ *
+ * Headless collision predicates — no React, Skia, or physics backends.
+ */
+export * from './collision2d/index.js';
+//# sourceMappingURL=collision2d.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collision2d.d.ts","sourceRoot":"","sources":["../../../src/collision2d.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,wBAAqB,CAAC"}

package/lib/typescript/src/core/input/buttonPad.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Multitouch button-pad controller (headless).
+ *
+ * Maps every active pointer to the button zone it covers and turns touch
+ * transitions into press/release diffs for a session input buffer. Pure and
+ * React-free: the React surface (`GameButtonPad`) only registers zone rects,
+ * feeds touch lists in, and applies the returned diffs to
+ * `session.input`.
+ *
+ * Semantics:
+ * - A zone is a rectangle; an optional global hit slop expands it.
+ * - Each pointer maps to AT MOST one action (first registered zone wins).
+ * - An action is pressed while ANY pointer covers its zone (refcounted);
+ *   it releases when the last pointer leaves or lifts. Edges fire only on
+ *   0-to-1 (press) and 1-to-0 (release) owner transitions — a second owner
+ *   never re-presses and an unbalanced release never emits.
+ * - Sliding between zones reassigns the pointer: release + press diff.
+ * - Moves acquire: a pointer that begins in empty space and slides into a
+ *   zone presses it; leaving a zone releases. Every touch in a move list
+ *   is hit-tested, mapped or not.
+ * - Zone rects are cloned at registration: later caller mutation of the
+ *   passed object cannot alter hit areas invisibly.
+ */
+/** A rectangular hit area, in the pad's local coordinate space. */
+export interface ButtonPadRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** One active pointer sample. */
+export interface ButtonPadTouch {
+    /** Native pointer id; stable for the lifetime of one touch. */
+    readonly id: number;
+    readonly x: number;
+    readonly y: number;
+}
+/** Press/release transitions derived from one touch event. */
+export interface ButtonPadDiff {
+    /** Actions that transitioned to held. */
+    readonly pressed: readonly string[];
+    /** Actions that transitioned to released. */
+    readonly released: readonly string[];
+}
+/** Create a controller bound to no particular session (diffs are applied by the caller). */
+export declare function createButtonPadController(options?: {
+    readonly hitSlop?: number;
+}): {
+    setZone(action: string, rect: ButtonPadRect): void;
+    removeZone(action: string): readonly string[];
+    touchesDown(touches: readonly ButtonPadTouch[]): ButtonPadDiff;
+    touchesMove(touches: readonly ButtonPadTouch[]): ButtonPadDiff;
+    touchesUp(changed: readonly ButtonPadTouch[]): ButtonPadDiff;
+    touchesCancel(changed: readonly ButtonPadTouch[]): ButtonPadDiff;
+    releaseAll(): readonly string[];
+    invalidateOwnership(): void;
+    held(): readonly string[];
+};
+//# sourceMappingURL=buttonPad.d.ts.map

package/lib/typescript/src/core/input/buttonPad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttonPad.d.ts","sourceRoot":"","sources":["../../../../../src/core/input/buttonPad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAkBD,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C,WAAW,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAAC;IAC/D,WAAW,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAAC;IAC/D,SAAS,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAAC;IAC7D,aAAa,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,CAAC;IACjE,UAAU,IAAI,SAAS,MAAM,EAAE,CAAC;IAChC,mBAAmB,IAAI,IAAI,CAAC;IAC5B,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;CAC3B,CA+JA"}

package/lib/typescript/src/core/input/createInputBuffer.d.ts

@@ -7,6 +7,6 @@ interface InputBuffer<TActionName extends string> {
     resetForTransition(targetActions: readonly string[]): void;
     reset(): void;
 }
-export declare function createInputBuffer<TInput extends InputMap>(input: TInput, assertLive: () => void): InputBuffer<Extract<keyof TInput, string>>;
+export declare function createInputBuffer<TInput extends InputMap>(input: TInput, assertLive: () => void, isRejectingInput?: () => boolean): InputBuffer<Extract<keyof TInput, string>>;
 export {};
 //# sourceMappingURL=createInputBuffer.d.ts.map

package/lib/typescript/src/core/input/createInputBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createInputBuffer.d.ts","sourceRoot":"","sources":["../../../../../src/core/input/createInputBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AAEvD,OAAO,KAAK,EAAe,eAAe,EAAE,UAAU,EAAgB,MAAM,YAAS,CAAC;AA8BtF,UAAU,WAAW,CAAC,WAAW,SAAS,MAAM;IAC9C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAClC,oFAAoF;IACpF,kBAAkB,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3D,KAAK,IAAI,IAAI,CAAC;CACf;AAkBD,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,QAAQ,EACvD,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,IAAI,GACrB,WAAW,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,CAqR5C"}
+{"version":3,"file":"createInputBuffer.d.ts","sourceRoot":"","sources":["../../../../../src/core/input/createInputBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AAEvD,OAAO,KAAK,EAAe,eAAe,EAAE,UAAU,EAAgB,MAAM,YAAS,CAAC;AA0CtF,UAAU,WAAW,CAAC,WAAW,SAAS,MAAM;IAC9C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAClC,oFAAoF;IACpF,kBAAkB,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3D,KAAK,IAAI,IAAI,CAAC;CACf;AAkBD,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,QAAQ,EACvD,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,IAAI,EACtB,gBAAgB,GAAE,MAAM,OAAqB,GAC5C,WAAW,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,CAyV5C"}

package/lib/typescript/src/core/input/types.d.ts

@@ -60,5 +60,12 @@ export interface InputController<TActionName extends string> {
      * inputs its fixed step actually sampled.
      */
     readonly acceptedCount: number;
+    /**
+     * The number of fixed-step input samples taken by the session (T12-TF3):
+     * the authoritative committed boundary — one increment per tick, whether
+     * or not any pointer or button changed. Distinct from the dispatch-stage
+     * `acceptedCount`.
+     */
+    readonly sampledCount: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/core/input/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/input/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAsB,CAAC;AAEpD,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU,CAAC,WAAW,SAAS,MAAM;IACpD,6CAA6C;IAC7C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;CAC5C;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe,CAAC,WAAW,SAAS,MAAM;IACzD,oDAAoD;IACpD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,sDAAsD;IACtD,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,qDAAqD;IACrD,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACvE,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACtE,2DAA2D;IAC3D,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,uEAAuE;IACvE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/input/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAsB,CAAC;AAEpD,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU,CAAC,WAAW,SAAS,MAAM;IACpD,6CAA6C;IAC7C,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAAC;CAC5C;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe,CAAC,WAAW,SAAS,MAAM;IACzD,oDAAoD;IACpD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,sDAAsD;IACtD,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,qDAAqD;IACrD,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACvE,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACtE,2DAA2D;IAC3D,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,uEAAuE;IACvE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/lib/typescript/src/core/session/createGameSession.d.ts

@@ -1,7 +1,9 @@
+import type { AssetGroupMap } from '../../assets/types.js';
 import type { GameDefinition, InputMap, SceneMap } from '../../definition/types.js';
 import { type FrameDriver } from '../frameDriver.js';
 import { type GameSession } from './types.js';
 import type { SessionDiagnostics } from './diagnostics.js';
+import type { GameEventDescriptor } from '../../events/types.js';
 interface SessionOptions {
     readonly frameDriver: FrameDriver;
     readonly fixedStepMs?: number;
@@ -11,8 +13,8 @@ interface SessionOptions {
     readonly diagnostics?: SessionDiagnostics;
 }
 /** Create a live session using the platform animation-frame driver. */
-export declare function createGameSession<const TScenes extends SceneMap, const TInput extends InputMap, const TInitialScene extends keyof TScenes>(definition: GameDefinition<TScenes, TInput, TInitialScene>): GameSession<TScenes, TInput>;
+export declare function createGameSession<const TScenes extends SceneMap, const TInput extends InputMap, const TInitialScene extends keyof TScenes, const TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>>(definition: GameDefinition<TScenes, TInput, TInitialScene, AssetGroupMap, TEventDefs>): GameSession<TScenes, TInput, TEventDefs>;
 /** @internal Deterministic construction seam used by the headless test suite. */
-export declare function createGameSessionWithDriver<const TScenes extends SceneMap, const TInput extends InputMap, const TInitialScene extends keyof TScenes>(definition: GameDefinition<TScenes, TInput, TInitialScene>, options: SessionOptions): GameSession<TScenes, TInput>;
+export declare function createGameSessionWithDriver<const TScenes extends SceneMap, const TInput extends InputMap, const TInitialScene extends keyof TScenes, const TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>>(definition: GameDefinition<TScenes, TInput, TInitialScene, AssetGroupMap, TEventDefs>, options: SessionOptions): GameSession<TScenes, TInput, TEventDefs>;
 export {};
 //# sourceMappingURL=createGameSession.d.ts.map

package/lib/typescript/src/core/session/createGameSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createGameSession.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/createGameSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AAEjF,OAAO,EAA8B,KAAK,WAAW,EAAoB,MAAM,mBAAgB,CAAC;AAGhG,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,YAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAe,CAAC;AAMxD,UAAU,cAAc;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAsDD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,MAAM,SAAS,QAAQ,EAC7B,KAAK,CAAC,aAAa,SAAS,MAAM,OAAO,EAEzC,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,GACzD,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAI9B;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,MAAM,SAAS,QAAQ,EAC7B,KAAK,CAAC,aAAa,SAAS,MAAM,OAAO,EAEzC,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAC1D,OAAO,EAAE,cAAc,GACtB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAqiB9B"}
+{"version":3,"file":"createGameSession.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/createGameSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AAEjF,OAAO,EAA8B,KAAK,WAAW,EAAoB,MAAM,mBAAgB,CAAC;AAGhG,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,YAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAe,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAoB,CAAC;AAkD9D,UAAU,cAAc;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AA8DD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,MAAM,SAAS,QAAQ,EAC7B,KAAK,CAAC,aAAa,SAAS,MAAM,OAAO,EACzC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE7F,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,CAAC,GACpF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAI1C;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,MAAM,SAAS,QAAQ,EAC7B,KAAK,CAAC,aAAa,SAAS,MAAM,OAAO,EACzC,KAAK,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE7F,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,CAAC,EACrF,OAAO,EAAE,cAAc,GACtB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAu5B1C"}

package/lib/typescript/src/core/session/deepFreeze.d.ts

@@ -20,8 +20,28 @@
  *   snapshots holds in every build.
  */
 import type { DeepReadonly } from './types.js';
+/**
+ * Supported snapshot domain (GS-SCENE-03): plain records
+ * (`Object.prototype` or `null` prototype), arrays, and scalar values.
+ * Everything else — functions, symbols, bigints, and class instances
+ * (Map, Set, Date, typed arrays, custom classes, …) — is rejected at the
+ * publication boundary because freezing cannot secure it (`Object.freeze`
+ * on a Map does not freeze its entries; a frozen function stays callable).
+ */
+export declare class SnapshotDomainError extends Error {
+    /** Dot/bracket path from the snapshot root to the offending value. */
+    readonly path: string;
+    /** The scene whose snapshot was rejected, when the session supplied it. */
+    readonly scene?: string;
+    constructor(path: string, detail: string, scene?: string);
+}
+/** Context the session attaches so rejections name the offending scene. */
+export interface SnapshotFreezeContext {
+    readonly scene?: string;
+    readonly tick?: number;
+}
 export interface DeepFreezer {
-    <T>(value: T): DeepReadonly<T>;
+    <T>(value: T, context?: SnapshotFreezeContext): DeepReadonly<T>;
 }
 export declare function createDeepFreeze(): DeepFreezer;
 //# sourceMappingURL=deepFreeze.d.ts.map

package/lib/typescript/src/core/session/deepFreeze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepFreeze.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/deepFreeze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAS,CAAC;AA4D5C,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CAChC;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAuE9C"}
+{"version":3,"file":"deepFreeze.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/deepFreeze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAS,CAAC;AAE5C;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAYzD;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAyGD,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CACjE;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CA8F9C"}

package/lib/typescript/src/core/session/diagnostics.d.ts

@@ -32,5 +32,7 @@ export interface SessionDiagnostics {
     onCommitNotification(): void;
     /** Listener count at publish time. */
     onListenerCount(count: number): void;
+    /** Status-listener count after registration or removal (T10 control plane). */
+    onStatusListenerCount?(count: number): void;
 }
 //# sourceMappingURL=diagnostics.d.ts.map

package/lib/typescript/src/core/session/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,yDAAyD;IACzD,kBAAkB,IAAI,IAAI,CAAC;IAC3B,mCAAmC;IACnC,WAAW,IAAI,IAAI,CAAC;IACpB,kEAAkE;IAClE,aAAa,IAAI,IAAI,CAAC;IACtB,gEAAgE;IAChE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,yDAAyD;IACzD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sDAAsD;IACtD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gEAAgE;IAChE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iDAAiD;IACjD,oBAAoB,IAAI,IAAI,CAAC;IAC7B,sCAAsC;IACtC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../src/core/session/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,yDAAyD;IACzD,kBAAkB,IAAI,IAAI,CAAC;IAC3B,mCAAmC;IACnC,WAAW,IAAI,IAAI,CAAC;IACpB,kEAAkE;IAClE,aAAa,IAAI,IAAI,CAAC;IACtB,gEAAgE;IAChE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kDAAkD;IAClD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,yDAAyD;IACzD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sDAAsD;IACtD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gEAAgE;IAChE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iDAAiD;IACjD,oBAAoB,IAAI,IAAI,CAAC;IAC7B,sCAAsC;IACtC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,+EAA+E;IAC/E,qBAAqB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C"}

package/lib/typescript/src/core/session/types.d.ts

@@ -1,4 +1,5 @@
 import type { InputMap, SceneMap } from '../../definition/types.js';
+import type { GameEventDescriptor, GameEventEnvelope, InferGameEventMap } from '../../events/types.js';
 import type { SceneSnapshot } from '../../scene/types.js';
 import type { Viewport } from '../../viewport2d/types.js';
 import type { InputController } from '../input/types.js';
@@ -8,6 +9,28 @@ export type DeepReadonly<T> = T extends (...arguments_: never[]) => unknown ? T
 } : T;
 /** Lifecycle states of a headless game session. */
 export type GameSessionStatus = 'idle' | 'running' | 'paused' | 'disposed';
+/**
+ * Minimal read-only lifecycle surface for presentation layers (T20.3).
+ *
+ * Exposes exactly what a renderer-side consumer needs to follow its owning
+ * session — the current status and a way to observe transitions — and
+ * nothing it must not have: no `start`, `pause`, `press`, `setScene`, event
+ * subscription, or other session internals. `GameView` owns one source per
+ * session and supplies it to its renderer subtree; haptics and particle
+ * presentation consume it instead of casting to private session methods or
+ * reaching for module-global coordinators.
+ */
+export interface GameLifecycleSource {
+    /** The owning session's current lifecycle status. */
+    getStatus(): GameSessionStatus;
+    /**
+     * Observe lifecycle transitions. Returns a detach function. Subscribing
+     * to a disposed session returns a no-op detach: the terminal notification
+     * was already delivered, and `addStatusListener` follows the
+     * disposed-error policy for new subscribers.
+     */
+    subscribe(listener: (status: GameSessionStatus) => void): () => void;
+}
 /** One renderer-neutral simulation commit produced by a game session. */
 export interface CommitFrameBase<TSnapshot> {
     /** Snapshot immediately before the latest simulation update. */
@@ -49,7 +72,7 @@ export interface GameSubscription {
     remove(): void;
 }
 /** A closure-backed, headless running instance of one game definition. */
-export interface GameSession<TScenes extends SceneMap = SceneMap, TInput extends InputMap = InputMap> {
+export interface GameSession<TScenes extends SceneMap = SceneMap, TInput extends InputMap = InputMap, TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>> {
     /** Current lifecycle status. */
     readonly status: GameSessionStatus;
     /** The active scene name, updated by transitions and restarts. */
@@ -62,12 +85,28 @@ export interface GameSession<TScenes extends SceneMap = SceneMap, TInput extends
     start(): void;
     /** Pause simulation and discard suspended wall time. */
     pause(): void;
+    /**
+     * Observe lifecycle transitions at control frequency.
+     *
+     * The listener receives each actual status transition after it becomes
+     * authoritative (`idle`, `running`, `paused`, `disposed`); idempotent
+     * commands emit nothing, and no initial value is emitted on subscribe —
+     * read `status` for the snapshot. `disposed` is delivered exactly once
+     * before listeners are released. Listeners are called from a snapshot and
+     * a listener that issues another lifecycle command observes complete
+     * states; a throwing listener does not abort delivery, and the first
+     * failure is rethrown from the command after the pass completes. Status
+     * notifications are not render commits.
+     */
+    addStatusListener(listener: (status: GameSessionStatus) => void): GameSubscription;
     /**
      * Transition to a declared scene.
      *
-     * While running, the transition commits at the next fixed-step boundary.
-     * While idle or paused, it commits synchronously and publishes the new
-     * frame. Setting the current scene is an idempotent no-op.
+     * While running, the transition commits at the next frame-driver callback
+     * — even when no fixed step is due — without advancing simulation tick or
+     * time. The target scene first updates at the next due fixed step. While
+     * idle or paused, it commits synchronously and publishes the new frame.
+     * Setting the current scene is an idempotent no-op.
      */
     setScene(name: keyof TScenes): void;
     /** Recreate the active scene with fresh state. */
@@ -82,10 +121,36 @@ export interface GameSession<TScenes extends SceneMap = SceneMap, TInput extends
      * accumulated timing fraction at call time and is only meaningful for
      * headless inspection. Rendering uses the UI-owned alpha clock; the
      * envelope fields never change between commits.
+     *
+     * Event-time authority (GS-EVENT-02): this frame is the most recently
+     * PUBLISHED presentation frame, which can lag the authoritative tick
+     * when several simulation ticks run in one driver callback. Inside a
+     * game-event listener, the envelope (tick, scene, ordinal, payload) is
+     * the authority for that event — never re-read this frame to place the
+     * event. Put the data an effect needs into its small payload.
      */
     getRenderFrame(): GameRenderFrame<TScenes>;
     /** Observe simulation commits at commit frequency (never per display frame). */
     addCommitListener(listener: (frame: CommitFrame<TScenes>) => void): GameSubscription;
+    /**
+     * Observe deterministic game events after they commit (T13).
+     *
+     * Each listener receives committed envelopes for the subscribed name in
+     * deterministic `(tick, ordinal)` order. Delivery happens after the
+     * source tick's authoritative state commits and never during the update
+     * itself. Listeners run from a per-tick snapshot taken before the
+     * tick's first delivery (GS-EVENT-01): a listener added during delivery
+     * receives only later ticks, and a removal prevents only future ticks —
+     * neither affects the envelopes already staged for the running tick.
+     * Lifecycle calls during delivery (pause, setScene, dispose) take
+     * effect after the staged batch completes: every snapshotted listener
+     * still runs exactly once for the tick. Removing a listener is
+     * idempotent. A throwing listener does not suppress siblings or alter
+     * simulation; the error is reported via a visible non-recursive sink
+     * (`console.error`). Simulation never awaits an async effect started
+     * by a listener.
+     */
+    addGameEventListener<TName extends keyof InferGameEventMap<TEventDefs> & string>(name: TName, listener: (event: GameEventEnvelope<TName, InferGameEventMap<TEventDefs>[TName]>) => void | Promise<void>): GameSubscription;
 }
 /** Error thrown when live work is requested from a disposed session. */
 export declare class GameSessionDisposedError extends Error {

package/lib/typescript/src/core/session/types.d.ts.map

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

package/lib/typescript/src/definition/defineGame.d.ts

@@ -1,4 +1,5 @@
 import type { AssetGroupMap } from '../assets/types.js';
+import type { GameEventDescriptor } from '../events/types.js';
 import type { GameDefinition, InputMap, SceneMap } from './types.js';
 type SceneActions<TScene> = TScene extends {
     readonly __actionType?: infer TAction;
@@ -14,6 +15,16 @@ type ValidateSceneActions<TScenes extends SceneMap, TInput extends InputMap> = U
 type ValidateSceneTransitions<TScenes extends SceneMap> = UndeclaredSceneTransitions<TScenes> extends never ? unknown : {
     readonly __undeclaredSceneTransitions: UndeclaredSceneTransitions<TScenes>;
 };
+type SceneEmits<TScene> = TScene extends {
+    readonly __emitType?: infer TEmits;
+} ? Exclude<TEmits, undefined> : never;
+type UndeclaredSceneEmits<TScenes extends SceneMap, TEventDefs extends Record<string, GameEventDescriptor<unknown>>> = TEventDefs extends Record<string, never> ? SceneEmits<TScenes[keyof TScenes]> : Exclude<SceneEmits<TScenes[keyof TScenes]>, keyof TEventDefs & string>;
+type ValidateSceneEmits<TScenes extends SceneMap, TEventDefs extends Record<string, GameEventDescriptor<unknown>>> = UndeclaredSceneEmits<TScenes, TEventDefs> extends never ? unknown : {
+    readonly __undeclaredSceneEmits: UndeclaredSceneEmits<TScenes, TEventDefs>;
+};
+type ValidateEventsWhenScenesEmit<TScenes extends SceneMap, TEventDefs extends Record<string, GameEventDescriptor<unknown>>> = SceneEmits<TScenes[keyof TScenes]> extends never ? unknown : TEventDefs extends Record<string, never> ? {
+    readonly __eventsRequired: 'scenes declare emits but game has no events map';
+} : unknown;
 /**
  * Declare a game.
  *
@@ -61,6 +72,6 @@ type ValidateSceneTransitions<TScenes extends SceneMap> = UndeclaredSceneTransit
  * });
  * ```
  */
-export declare function defineGame<const TScenes extends SceneMap, const TInput extends InputMap = InputMap, const TInitialScene extends keyof TScenes = keyof TScenes, const TAssets extends AssetGroupMap = AssetGroupMap>(definition: GameDefinition<TScenes, TInput, TInitialScene, TAssets> & ValidateSceneActions<TScenes, TInput> & ValidateSceneTransitions<TScenes>): GameDefinition<TScenes, TInput, TInitialScene, TAssets>;
+export declare function defineGame<const TScenes extends SceneMap, const TInput extends InputMap = InputMap, const TInitialScene extends keyof TScenes = keyof TScenes, const TAssets extends AssetGroupMap = AssetGroupMap, const TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>>(definition: GameDefinition<TScenes, TInput, TInitialScene, TAssets, TEventDefs> & ValidateSceneActions<TScenes, TInput> & ValidateSceneTransitions<TScenes> & ValidateSceneEmits<TScenes, TEventDefs> & ValidateEventsWhenScenesEmit<TScenes, TEventDefs>): GameDefinition<TScenes, TInput, TInitialScene, TAssets, TEventDefs>;
 export {};
 //# sourceMappingURL=defineGame.d.ts.map

package/lib/typescript/src/definition/defineGame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineGame.d.ts","sourceRoot":"","sources":["../../../../src/definition/defineGame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAS,CAAC;AAElE,KAAK,YAAY,CAAC,MAAM,IAAI,MAAM,SAAS;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAA;CAAE,GAChF,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,GAC3B,KAAK,CAAC;AAEV,KAAK,gBAAgB,CAAC,MAAM,IAAI,MAAM,SAAS;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,WAAW,CAAA;CAAE,GAC5F,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,GAC/B,KAAK,CAAC;AAEV,KAAK,sBAAsB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,IAAI,OAAO,CACtF,YAAY,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC,EACpC,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAC9B,CAAC;AAEF,KAAK,0BAA0B,CAAC,OAAO,SAAS,QAAQ,IAAI,OAAO,CACjE,gBAAgB,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC,EACxC,MAAM,OAAO,CACd,CAAC;AAEF,KAAK,oBAAoB,CAAC,OAAO,SAAS,QAAQ,EAAE,MAAM,SAAS,QAAQ,IACzE,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,KAAK,GACjD,OAAO,GACP;IAAE,QAAQ,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAErF,KAAK,wBAAwB,CAAC,OAAO,SAAS,QAAQ,IACpD,0BAA0B,CAAC,OAAO,CAAC,SAAS,KAAK,GAC7C,OAAO,GACP;IAAE,QAAQ,CAAC,4BAA4B,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ,EACxC,KAAK,CAAC,aAAa,SAAS,MAAM,OAAO,GAAG,MAAM,OAAO,EACzD,KAAK,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAEnD,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,GACjE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,GACrC,wBAAwB,CAAC,OAAO,CAAC,GAClC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAMzD"}
+{"version":3,"file":"defineGame.d.ts","sourceRoot":"","sources":["../../../../src/definition/defineGame.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import type { AssetGroupMap, GameAssetManifest } from '../assets/types.js';
+import type { GameEventDescriptor } from '../events/types.js';
 import type { Viewport } from '../viewport2d/types.js';
 /** The button action supported by the runtime. */
 export interface ButtonInputAction {
@@ -32,6 +33,12 @@ export interface SceneDefinitionMarker {
     readonly __actionType?: string;
     /** @internal Type witness for transition targets declared by this scene. */
     readonly __transitionType?: string;
+    /** @internal Type witness for emitted event names. */
+    readonly __emitType?: string;
+    /** @internal Type witness for the game event map. */
+    readonly __eventMapType?: Record<string, unknown>;
+    /** @internal Type witness for the branded event definitions identity. */
+    readonly __eventDefsType?: Record<string, GameEventDescriptor<unknown>>;
 }
 /** The collection of functional scenes declared by a game. */
 export type SceneMap = Readonly<Record<string, SceneDefinitionMarker>>;
@@ -41,7 +48,7 @@ export type SceneMap = Readonly<Record<string, SceneDefinitionMarker>>;
  * Creating a definition allocates no runtime state. Pass it to
  * `createGameSession` when a live headless session is required.
  */
-export interface GameDefinition<TScenes extends SceneMap = SceneMap, TInput extends InputMap = InputMap, TInitialScene extends keyof TScenes = keyof TScenes, TAssets extends AssetGroupMap = AssetGroupMap> {
+export interface GameDefinition<TScenes extends SceneMap = SceneMap, TInput extends InputMap = InputMap, TInitialScene extends keyof TScenes = keyof TScenes, TAssets extends AssetGroupMap = AssetGroupMap, TEventDefs extends Record<string, GameEventDescriptor<unknown>> = Record<string, never>> {
     /** The viewport configuration of the game. */
     readonly viewport: Viewport;
     /** Typed asset manifest; optional for shape-only games. */
@@ -52,5 +59,7 @@ export interface GameDefinition<TScenes extends SceneMap = SceneMap, TInput exte
     readonly scenes: TScenes;
     /** The scene created first when a session starts. */
     readonly initialScene: TInitialScene;
+    /** Typed game event declarations (T13). Absence keeps the no-event fast path. */
+    readonly events?: TEventDefs;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/definition/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAEpD,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEjE,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,OAAO,SAAS,QAAQ,GAAG,QAAQ,EACnC,MAAM,SAAS,QAAQ,GAAG,QAAQ,EAClC,aAAa,SAAS,MAAM,OAAO,GAAG,MAAM,OAAO,EACnD,OAAO,SAAS,aAAa,GAAG,aAAa;IAE7C,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;CACtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/definition/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAqB,CAAC;AAEpD,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEjE,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,yEAAyE;IACzE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;CACzE;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,OAAO,SAAS,QAAQ,GAAG,QAAQ,EACnC,MAAM,SAAS,QAAQ,GAAG,QAAQ,EAClC,aAAa,SAAS,MAAM,OAAO,GAAG,MAAM,OAAO,EACnD,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7C,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvF,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC7C,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B"}

package/lib/typescript/src/events/defineGameEvents.d.ts

@@ -0,0 +1,26 @@
+import type { BrandedGameEventDefs, GameEventDescriptor } from './types.js';
+/**
+ * Create a type witness for one event payload.
+ *
+ * `gameEvent` owns no runtime resource — it returns a frozen empty
+ * descriptor whose generic preserves the payload type. Payload shapes are
+ * validated when events are staged, not when they are declared.
+ *
+ * @example
+ * ```ts
+ * const events = defineGameEvents({
+ *   'brick-hit': gameEvent<{ brickId: string; point: Point2D }>(),
+ * });
+ * ```
+ */
+export declare function gameEvent<TPayload>(): GameEventDescriptor<TPayload>;
+/**
+ * Define and freeze a game event map.
+ *
+ * Validates every name, freezes the declaration map and its entries,
+ * and preserves literal inference so `keyof typeof events` and the
+ * payload types flow through `defineGame`, scenes, and subscriptions
+ * without duplicate author-written unions.
+ */
+export declare function defineGameEvents<const T extends Record<string, GameEventDescriptor<unknown>>>(definitions: T): BrandedGameEventDefs<T>;
+//# sourceMappingURL=defineGameEvents.d.ts.map

package/lib/typescript/src/events/defineGameEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineGameEvents.d.ts","sourceRoot":"","sources":["../../../../src/events/defineGameEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,QAAQ,KAAK,mBAAmB,CAAC,QAAQ,CAAC,CAEnE;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAC3F,WAAW,EAAE,CAAC,GACb,oBAAoB,CAAC,CAAC,CAAC,CAWzB"}

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

@@ -0,0 +1,12 @@
+/**
+ * Game event payload validation errors (T13).
+ *
+ * Every rejection identifies the event name and the exact payload path
+ * that caused the failure. The payload never captures React or native
+ * handles, sparse holes, cycles, or non-finite numbers.
+ */
+export declare class GameEventError extends Error {
+    readonly name = "GameEventError";
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/events/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAkB,IAAI,oBAAoB;gBAE9B,OAAO,EAAE,MAAM;CAG5B"}

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

@@ -0,0 +1,6 @@
+export { GameEventError } from './errors.js';
+export { cloneAndValidatePayload, PAYLOAD_LIMITS } from './payload.js';
+export { defineGameEvents, gameEvent } from './defineGameEvents.js';
+export { seedGameEvent } from './seed.js';
+export type { AnyGameEventEnvelope, GameEventDefinitions, GameEventDescriptor, GameEventEmitter, GameEventEnvelope, GameEventListener, GameEventMap, InferGameEventMap, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAU,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAW,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,uBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAQ,CAAC;AACvC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,YAAS,CAAC"}

package/lib/typescript/src/events/payload.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Validate, clone, and deeply freeze a payload.
+ *
+ * Accepted: finite numbers, strings, booleans, `null`, `undefined` (as an
+ * optional property value), arrays, and plain records (`Object.prototype`
+ * or `Object.create(null)`). Rejected: functions, symbols, bigints,
+ * promises/thenables, sparse arrays, class instances, unsafe prototypes,
+ * native handles, React elements (`$$typeof`), cycles, accessors,
+ * non-enumerable properties, and non-finite numbers. Errors are reported
+ * with `Event "<name>" payload invalid at <path>`.
+ *
+ * The clone is frozen deeply so callers cannot mutate the staged envelope.
+ */
+export declare function cloneAndValidatePayload(payload: unknown, eventName: string, basePath?: string): unknown;
+export declare const PAYLOAD_LIMITS: {
+    readonly MAX_PAYLOAD_NODES: 512;
+    readonly MAX_PAYLOAD_DEPTH: 10;
+    readonly MAX_PAYLOAD_STRING_LENGTH: 4096;
+    readonly MAX_PAYLOAD_ARRAY_LENGTH: 256;
+};
+//# sourceMappingURL=payload.d.ts.map

package/lib/typescript/src/events/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../src/events/payload.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAY,GACnB,OAAO,CA0MT;AAED,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}

package/lib/typescript/src/events/seed.d.ts

@@ -0,0 +1,3 @@
+import type { AnyGameEventEnvelope } from './types.js';
+export declare function seedGameEvent(event: AnyGameEventEnvelope): number;
+//# sourceMappingURL=seed.d.ts.map

package/lib/typescript/src/events/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../../src/events/seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAS,CAAC;AAqBpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAWjE"}