rn-gamekit 0.1.0

package/lib/module/viewport2d/math.js

@@ -0,0 +1,129 @@
+"use strict";
+
+function freezeRect(value) {
+  return Object.freeze(value);
+}
+function rect(x, y, width, height) {
+  return freezeRect({
+    x,
+    y,
+    width,
+    height
+  });
+}
+function invalidLogicalSize(config) {
+  const {
+    width,
+    height
+  } = config.logicalSize;
+  return `Viewport logical size must be finite and positive (got ${width} x ${height})`;
+}
+function isUsableSurface(size) {
+  return Number.isFinite(size.width) && Number.isFinite(size.height) && size.width > 0 && size.height > 0;
+}
+
+/**
+ * Resolve an authored viewport configuration against an actual surface size.
+ *
+ * Returns `undefined` until both surface dimensions are positive — a
+ * zero-sized layout is normal before the first layout pass. Invalid authored
+ * sizes throw a `RangeError` naming the invalid dimension. The result is
+ * immutable plain data with no platform dependencies.
+ */
+export function resolveViewport2D(config, surfaceSize) {
+  const {
+    width: logicalWidth,
+    height: logicalHeight
+  } = config.logicalSize;
+  if (!Number.isFinite(logicalWidth) || !Number.isFinite(logicalHeight)) {
+    throw new RangeError(invalidLogicalSize(config));
+  }
+  if (!(logicalWidth > 0) || !(logicalHeight > 0)) {
+    throw new RangeError(invalidLogicalSize(config));
+  }
+  if (!isUsableSurface(surfaceSize)) {
+    return undefined;
+  }
+  if (config.mode !== 'fit' && config.mode !== 'fill' && config.mode !== 'extend-world') {
+    throw new RangeError(`Unknown viewport mode: ${String(config.mode)}`);
+  }
+  const {
+    width: surfaceWidth,
+    height: surfaceHeight
+  } = surfaceSize;
+  const widthScale = surfaceWidth / logicalWidth;
+  const heightScale = surfaceHeight / logicalHeight;
+  let scale;
+  let offsetX;
+  let offsetY;
+  let visibleLogicalBounds;
+  let contentBounds;
+  if (config.mode === 'fill') {
+    scale = Math.max(widthScale, heightScale);
+    offsetX = (surfaceWidth - logicalWidth * scale) / 2;
+    offsetY = (surfaceHeight - logicalHeight * scale) / 2;
+    visibleLogicalBounds = rect(-offsetX / scale, -offsetY / scale, surfaceWidth / scale, surfaceHeight / scale);
+    contentBounds = rect(0, 0, surfaceWidth, surfaceHeight);
+  } else {
+    // `fit` and `extend-world` share the fit (minimum uniform) scale.
+    scale = Math.min(widthScale, heightScale);
+    offsetX = (surfaceWidth - logicalWidth * scale) / 2;
+    offsetY = (surfaceHeight - logicalHeight * scale) / 2;
+    if (config.mode === 'extend-world') {
+      const worldWidth = surfaceWidth / scale;
+      const worldHeight = surfaceHeight / scale;
+      visibleLogicalBounds = rect((logicalWidth - worldWidth) / 2, (logicalHeight - worldHeight) / 2, worldWidth, worldHeight);
+      contentBounds = rect(0, 0, surfaceWidth, surfaceHeight);
+    } else {
+      visibleLogicalBounds = rect(0, 0, logicalWidth, logicalHeight);
+      contentBounds = rect(offsetX, offsetY, logicalWidth * scale, logicalHeight * scale);
+    }
+  }
+  return Object.freeze({
+    surfaceSize: Object.freeze({
+      width: surfaceWidth,
+      height: surfaceHeight
+    }),
+    logicalBounds: rect(0, 0, logicalWidth, logicalHeight),
+    visibleLogicalBounds,
+    contentBounds,
+    scale,
+    offsetX,
+    offsetY
+  });
+}
+
+/** Convert a logical/world point into surface coordinates. */
+export function worldToSurface(viewport, point) {
+  return Object.freeze({
+    x: point.x * viewport.scale + viewport.offsetX,
+    y: point.y * viewport.scale + viewport.offsetY
+  });
+}
+
+/** Convert a surface point into logical/world coordinates. */
+export function surfaceToWorld(viewport, point) {
+  return Object.freeze({
+    x: (point.x - viewport.offsetX) / viewport.scale,
+    y: (point.y - viewport.offsetY) / viewport.scale
+  });
+}
+
+/**
+ * Decide whether a surface point lies inside the interactive content area.
+ *
+ * For `fit` this rejects letterbox space so a pointer cannot begin there. For
+ * `fill` and `extend-world` the entire surface is interactive. Conversion
+ * itself remains mathematical everywhere; this operation decides whether a
+ * gesture may begin.
+ */
+export function containsSurfacePoint(viewport, point) {
+  const {
+    x,
+    y,
+    width,
+    height
+  } = viewport.contentBounds;
+  return point.x >= x && point.y >= y && point.x <= x + width && point.y <= y + height;
+}
+//# sourceMappingURL=math.js.map

package/lib/module/viewport2d/math.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["freezeRect","value","Object","freeze","rect","x","y","width","height","invalidLogicalSize","config","logicalSize","isUsableSurface","size","Number","isFinite","resolveViewport2D","surfaceSize","logicalWidth","logicalHeight","RangeError","undefined","mode","String","surfaceWidth","surfaceHeight","widthScale","heightScale","scale","offsetX","offsetY","visibleLogicalBounds","contentBounds","Math","max","min","worldWidth","worldHeight","logicalBounds","worldToSurface","viewport","point","surfaceToWorld","containsSurfacePoint"],"sourceRoot":"../../../src","sources":["viewport2d/math.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/viewport2d/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/viewport2d/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["viewport2d/types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/assets/defineAssets.d.ts

@@ -0,0 +1,20 @@
+import type { AssetGroupMap, GameAssetManifest, ImageDescriptor, SpriteClip, SpriteFrameRect, SpriteSheetDescriptor } from './types.js';
+/** Declare a single full-image asset from a static module handle. */
+export declare function image(source: number): ImageDescriptor;
+/**
+ * Declare a sprite-sheet asset: named source frames plus named animation
+ * clips. Frame and clip names are preserved as string literals; clip frame
+ * references are restricted to the declared frames.
+ */
+export declare function spriteSheet<TFrames extends Record<string, SpriteFrameRect>, TClips extends Record<string, SpriteClip<Extract<keyof TFrames, string>>>>(source: number, spec: {
+    readonly frames: TFrames;
+    readonly animations: TClips;
+}): SpriteSheetDescriptor<TFrames, TClips>;
+/**
+ * Declare the game's asset manifest: a deeply immutable, fully typed group
+ * map. Group, asset, frame, and clip names are preserved as string literals
+ * and every descriptor is branded with the manifest type so lookups stay
+ * typed. Allocates no native resources and performs no I/O.
+ */
+export declare function defineAssets<TGroups extends AssetGroupMap>(groups: TGroups): GameAssetManifest<TGroups>;
+//# sourceMappingURL=defineAssets.d.ts.map

package/lib/typescript/src/assets/defineAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAssets.d.ts","sourceRoot":"","sources":["../../../../src/assets/defineAssets.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAS,CAAC;AAEjB,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC/C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAEzE,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CASxC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAS,aAAa,EACxD,MAAM,EAAE,OAAO,GACd,iBAAiB,CAAC,OAAO,CAAC,CAI5B"}

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

@@ -0,0 +1,20 @@
+/**
+ * Structured asset errors (T7.2).
+ *
+ * Every definition/loading failure carries a stable machine-readable code
+ * and the field path that caused it. Paths are documented in the public
+ * error reference; messages never embed machine-specific paths.
+ */
+/** Stable error codes for asset definition and loading. */
+export type GameAssetErrorCode = 'ASSET_INVALID_IDENTIFIER' | 'ASSET_INVALID_SOURCE' | 'ASSET_INVALID_FRAME_RECT' | 'ASSET_EMPTY_CLIP' | 'ASSET_UNKNOWN_FRAME' | 'ASSET_UNKNOWN_CLIP' | 'ASSET_INVALID_DURATION' | 'ASSET_INVALID_MODE' | 'ASSET_UNSUPPORTED_SOURCE' | 'ASSET_UNKNOWN_GROUP' | 'ASSET_UNKNOWN_ASSET' | 'ASSET_RESOLVE_FAILED' | 'ASSET_DECODE_FAILED' | 'ASSET_FRAME_OUT_OF_BOUNDS' | 'ASSET_ABORTED' | 'ASSET_STORE_DISPOSED';
+/** A structured asset definition or loading failure. */
+export declare class GameAssetError extends Error {
+    /** Stable machine-readable code. */
+    readonly code: GameAssetErrorCode;
+    /** Field path within the manifest/descriptor that caused the failure. */
+    readonly path: readonly string[];
+    constructor(code: GameAssetErrorCode, path: readonly string[], message: string);
+}
+/** Throw when a definition-time identifier is invalid. */
+export declare function assertValidIdentifier(path: readonly string[], value: string): void;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/assets/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAC1B,0BAA0B,GAC1B,sBAAsB,GACtB,0BAA0B,GAC1B,kBAAkB,GAClB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,0BAA0B,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,2BAA2B,GAC3B,eAAe,GACf,sBAAsB,CAAC;AAE3B,wDAAwD;AACxD,qBAAa,cAAe,SAAQ,KAAK;IACvC,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;gBAErB,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM;CAM/E;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,IAAI,CAiBN"}

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

@@ -0,0 +1,138 @@
+/**
+ * Asset descriptor and manifest types (T7.2).
+ *
+ * The manifest is the static, deeply immutable declaration of a game's local
+ * assets. Group, asset, frame, and clip names are preserved as string
+ * literals; retrieval goes through typed descriptor references, never
+ * duplicated strings. Sources are static module handles (`number` from
+ * `require(...)`) only — string/URL sources are rejected at the type
+ * boundary and deliberately have no runtime branch.
+ */
+/** Static React Native module handle returned by `require(...)`. */
+export type AssetSourceHandle = number;
+/** A single full-image asset. */
+export interface ImageDescriptor {
+    /** Discriminant. */
+    readonly kind: 'image';
+    /** Static module handle. */
+    readonly source: AssetSourceHandle;
+}
+/** A named rectangle inside a sprite sheet, in source pixels. */
+export interface SpriteFrameRect {
+    /** Left edge in source pixels; non-negative finite number. */
+    readonly x: number;
+    /** Top edge in source pixels; non-negative finite number. */
+    readonly y: number;
+    /** Width in source pixels; greater than zero. */
+    readonly width: number;
+    /** Height in source pixels; greater than zero. */
+    readonly height: number;
+}
+/** Clip playback mode: looping or one-shot. */
+export type SpriteAnimationMode = 'loop' | 'once';
+/**
+ * A named animation clip over a sprite sheet's frames.
+ *
+ * Frame references are restricted to the sheet's declared frame names and
+ * durations are uniform per clip in this version (per-frame durations are
+ * deferred so precedence cannot be misunderstood).
+ */
+export interface SpriteClip<TFrameName extends string = string> {
+    /** Ordered frame references; at least one, all declared on the sheet. */
+    readonly frames: readonly TFrameName[];
+    /** Uniform per-frame duration in milliseconds; finite and greater than zero. */
+    readonly frameDurationMs: number;
+    /** Discriminated playback mode. */
+    readonly mode: SpriteAnimationMode;
+}
+/** A sprite-sheet asset: named frames plus named animation clips. */
+export interface SpriteSheetDescriptor<TFrames extends Record<string, SpriteFrameRect> = Record<string, SpriteFrameRect>, TClips extends Record<string, SpriteClip<Extract<keyof TFrames, string>>> = Record<string, SpriteClip<Extract<keyof TFrames, string>>>> {
+    /** Discriminant. */
+    readonly kind: 'sprite-sheet';
+    /** Static module handle. */
+    readonly source: AssetSourceHandle;
+    /** Named source rectangles. */
+    readonly frames: TFrames;
+    /** Named animation clips restricted to the declared frames. */
+    readonly animations: TClips;
+}
+/** Union of all asset descriptors. */
+export type AssetDescriptor = ImageDescriptor | SpriteSheetDescriptor;
+/** A group of named asset descriptors. */
+export type AssetGroup = Readonly<Record<string, AssetDescriptor>>;
+/** The author-facing group map accepted by `defineAssets`. */
+export type AssetGroupMap = Readonly<Record<string, AssetGroup>>;
+/**
+ * Type-level manifest brand. Every descriptor of a manifest carries a
+ * phantom reference to its originating manifest type, so a loaded store can
+ * reject descriptors from any other manifest at compile time.
+ */
+declare const manifestBrand: unique symbol;
+export type BrandedAssetDescriptor<TManifest, TDescriptor extends AssetDescriptor> = {
+    readonly [manifestBrand]?: TManifest;
+} & TDescriptor;
+/**
+ * The deeply immutable manifest produced by `defineAssets`.
+ *
+ * Groups and assets keep their literal names; every descriptor is branded
+ * with the manifest type so lookups stay typed.
+ */
+export type GameAssetManifest<TGroups extends AssetGroupMap = AssetGroupMap> = {
+    readonly [TGroup in keyof TGroups]: {
+        readonly [TAsset in keyof TGroups[TGroup]]: BrandedAssetDescriptor<GameAssetManifest<TGroups>, TGroups[TGroup][TAsset]>;
+    };
+};
+/** The manifest type of a descriptor's originating manifest. */
+export type ManifestOf<TDescriptor> = TDescriptor extends {
+    readonly [manifestBrand]?: infer TManifest;
+} ? TManifest : never;
+/** Loaded-asset lookup keyed by typed descriptor reference.
+ *
+ * v1 semantics (R9): lookup is descriptor-REFERENCE membership — the exact
+ * descriptor object declared by the manifest. The compile-time brand is
+ * structural, so identically shaped manifests are not nominally distinct;
+ * the runtime reference check is the guarantee, and the type layer still
+ * rejects duplicated string keys and descriptors from differently shaped
+ * manifests.
+ */
+export interface LoadedAssets<TManifest> {
+    /** The manifest this store was created from. */
+    readonly manifest: TManifest;
+    /** Retrieve a loaded asset by its typed descriptor reference. */
+    readonly get: <TDescriptor extends AssetDescriptor>(descriptor: BrandedAssetDescriptor<TManifest, TDescriptor>) => TDescriptor extends {
+        readonly kind: 'sprite-sheet';
+    } ? LoadedSpriteSheet : LoadedImage;
+}
+/** A ready full-image resource. */
+export interface LoadedImage {
+    /** Logical descriptor this resource was loaded for. */
+    readonly descriptor: ImageDescriptor;
+    /** Decoded source width in pixels. */
+    readonly width: number;
+    /** Decoded source height in pixels. */
+    readonly height: number;
+    /** The decoded image handle (Skia's SkImage satisfies this structurally). */
+    readonly image: unknown;
+}
+/** A ready sprite-sheet resource with validated frame rectangles. */
+export interface LoadedSpriteSheet {
+    /** Logical descriptor this resource was loaded for. */
+    readonly descriptor: SpriteSheetDescriptor;
+    /** Validated frames in source pixels (offsets against the decoded image). */
+    readonly frames: Readonly<Record<string, SpriteFrameRect>>;
+    /** Decoded source width in pixels. */
+    readonly width: number;
+    /** Decoded source height in pixels. */
+    readonly height: number;
+    /** The decoded image handle (Skia's SkImage satisfies this structurally). */
+    readonly image: unknown;
+}
+/** A ready, typed, caller-owned lease over loaded asset groups. */
+export interface GameAssetLease<TManifest> {
+    /** Typed lookup; rejects descriptors from other manifests. */
+    readonly assets: LoadedAssets<TManifest>;
+    /** Release this lease; idempotent; the final release disposes the image. */
+    readonly dispose: () => void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/lib/typescript/src/assets/validation.d.ts

@@ -0,0 +1,15 @@
+import type { AssetGroupMap, SpriteClip, SpriteFrameRect } from './types.js';
+/** Validate one frame rectangle. */
+export declare function validateFrameRect(path: readonly string[], name: string, rect: SpriteFrameRect): void;
+/** Validate one animation clip against the sheet's declared frames. */
+export declare function validateClip(path: readonly string[], name: string, clip: SpriteClip, frames: Readonly<Record<string, SpriteFrameRect>>): void;
+/** Validate a full sprite-sheet descriptor. */
+export declare function validateSpriteSheet(source: unknown, spec: {
+    readonly frames: Readonly<Record<string, SpriteFrameRect>>;
+    readonly animations: Readonly<Record<string, SpriteClip>>;
+}): void;
+/** Validate an image descriptor's source. */
+export declare function validateImageSource(source: unknown): void;
+/** Validate a full asset manifest. */
+export declare function validateManifest(manifest: AssetGroupMap): void;
+//# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/assets/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/assets/validation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,eAAe,EAEhB,MAAM,YAAS,CAAC;AAEjB,oCAAoC;AACpC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,GACpB,IAAI,CA2BN;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAChD,IAAI,CAiCN;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;CAAE,GAC9H,IAAI,CAcN;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAQzD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAmC9D"}

package/lib/typescript/src/core/frameDriver.d.ts

@@ -0,0 +1,12 @@
+/** Opaque handle returned by an animation-frame driver. */
+export type FrameHandle = number;
+/** Minimal presentation clock used by the fixed-step runtime. */
+export interface FrameDriver {
+    /** Request the next presentation callback. */
+    requestFrame(callback: (timestampMs: number) => void): FrameHandle;
+    /** Cancel a previously requested callback. */
+    cancelFrame(handle: FrameHandle): void;
+}
+/** Create the platform animation-frame driver used by live sessions. */
+export declare function createAnimationFrameDriver(): FrameDriver;
+//# sourceMappingURL=frameDriver.d.ts.map

package/lib/typescript/src/core/frameDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameDriver.d.ts","sourceRoot":"","sources":["../../../../src/core/frameDriver.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAAC;IACnE,8CAA8C;IAC9C,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACxC;AAOD,wEAAwE;AACxE,wBAAgB,0BAA0B,IAAI,WAAW,CAaxD"}

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

@@ -0,0 +1,12 @@
+import type { InputMap } from '../../definition/types.js';
+import type { InputController, InputFrame } from './types.js';
+interface InputBuffer<TActionName extends string> {
+    readonly controller: InputController<TActionName>;
+    sample(): InputFrame<TActionName>;
+    /** Clear scene-local edges while retaining pointers that remain physically down. */
+    resetForTransition(targetActions: readonly string[]): void;
+    reset(): void;
+}
+export declare function createInputBuffer<TInput extends InputMap>(input: TInput, assertLive: () => void): InputBuffer<Extract<keyof TInput, string>>;
+export {};
+//# sourceMappingURL=createInputBuffer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,64 @@
+import type { Point2D } from '../../geometry/types.js';
+/** The sampled state of a digital action for one simulation tick. */
+export interface ButtonState {
+    /** Whether the button is down at the tick boundary. */
+    readonly held: boolean;
+    /** Whether at least one press arrived since the previous tick. */
+    readonly pressed: boolean;
+    /** Whether at least one release arrived since the previous tick. */
+    readonly released: boolean;
+    /** Whether the platform cancelled ownership since the previous tick. */
+    readonly cancelled: boolean;
+}
+/**
+ * The sampled state of a pointer action for one simulation tick.
+ *
+ * `pressed`, `released`, and `cancelled` are one-tick edges. `active`
+ * persists while the owning pointer is down. `delta` accumulates movement
+ * between ticks and resets after each sample.
+ */
+export interface PointerState {
+    /** Whether the owning pointer is currently down. */
+    readonly active: boolean;
+    /** Whether a pointer began since the previous tick. */
+    readonly pressed: boolean;
+    /** Whether the owning pointer was released since the previous tick. */
+    readonly released: boolean;
+    /** Whether the owning pointer was cancelled since the previous tick. */
+    readonly cancelled: boolean;
+    /** Stable identifier of the pointer that owns the action. */
+    readonly pointerId?: number;
+    /** Current logical position of the owning pointer. */
+    readonly position?: Point2D;
+    /** Logical movement accumulated since the previous tick. */
+    readonly delta: Point2D;
+}
+/** An immutable semantic input snapshot sampled once per simulation tick. */
+export interface InputFrame<TActionName extends string> {
+    /** Read a declared digital button action. */
+    button(action: TActionName): ButtonState;
+    /** Read a declared pointer action. */
+    pointer(action: TActionName): PointerState;
+}
+/** Platform-facing controls for enqueueing semantic input changes. */
+export interface InputController<TActionName extends string> {
+    /** Enqueue a press for a declared button action. */
+    press(action: TActionName): void;
+    /** Enqueue a release for a declared button action. */
+    release(action: TActionName): void;
+    /** Begin a pointer for a declared pointer action. */
+    begin(action: TActionName, pointerId: number, position: Point2D): void;
+    /** Move the owning pointer of a declared pointer action. */
+    move(action: TActionName, pointerId: number, position: Point2D): void;
+    /** End the owning pointer of a declared pointer action. */
+    end(action: TActionName, pointerId: number): void;
+    /** Cancel the active button or owning pointer of a declared action. */
+    cancel(action: TActionName): void;
+    /**
+     * Monotonic count of input events accepted by this controller (F1). The
+     * session's commit instrumentation uses it to associate a commit with the
+     * inputs its fixed step actually sampled.
+     */
+    readonly acceptedCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,18 @@
+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';
+interface SessionOptions {
+    readonly frameDriver: FrameDriver;
+    readonly fixedStepMs?: number;
+    readonly maxCatchUpSteps?: number;
+    readonly maxFrameDeltaMs?: number;
+    /** @internal Performance instrumentation for the playground Performance Lab. */
+    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>;
+/** @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 {};
+//# sourceMappingURL=createGameSession.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,27 @@
+/**
+ * Trusted deep-freeze cache (T3).
+ *
+ * Each session owns one freezer. A subtree that has been completely frozen
+ * once is recorded in a `WeakSet` and never re-traversed: structurally
+ * shared snapshot subtrees (the common case: unchanged bricks, entities,
+ * or config objects reused by reference across ticks) are walked exactly
+ * once for the lifetime of the session.
+ *
+ * Correctness rules:
+ * - A node is promoted into the trusted set **only after** its whole
+ *   subtree finished freezing. A child getter that throws mid-traversal
+ *   leaves every ancestor untrusted, so a later snapshot re-walks it.
+ * - Cycle detection uses a separate per-traversal `visiting` set, never the
+ *   trusted set, so cycles freeze exactly once without infinite recursion.
+ * - `Object.isFrozen` is never used as a skip test: an externally
+ *   shallow-frozen object can contain mutable children and must still be
+ *   recursed into.
+ * - Freezing is never dev-only: the public API promise of deeply immutable
+ *   snapshots holds in every build.
+ */
+import type { DeepReadonly } from './types.js';
+export interface DeepFreezer {
+    <T>(value: T): DeepReadonly<T>;
+}
+export declare function createDeepFreeze(): DeepFreezer;
+//# sourceMappingURL=deepFreeze.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,36 @@
+/**
+ * Internal performance diagnostics sink.
+ *
+ * The session calls these hooks only when a sink is supplied through the
+ * testing seam. Production sessions pass no sink and pay no timing reads,
+ * callbacks, or wrapper allocation on the disabled path (F4). This is
+ * intentionally NOT a public diagnostics API: its usefulness is being proven
+ * by the playground Performance Lab before any public contract.
+ */
+export interface SessionDiagnostics {
+    /** A presentation callback was delivered by the frame driver. */
+    onDisplayCallback(): void;
+    /** A display callback that ran zero simulation steps. */
+    onZeroStepCallback(): void;
+    /** A fixed simulation step ran. */
+    onFixedStep(): void;
+    /** A catch-up step (second or later in the same callback) ran. */
+    onCatchUpStep(): void;
+    /** Whole-step debt dropped after the catch-up cap, in steps. */
+    onDroppedDebt(steps: number): void;
+    /** Duration of one scene update, milliseconds. */
+    onUpdate(durationMs: number): void;
+    /** Duration of one input sample, milliseconds. */
+    onInputSample(durationMs: number): void;
+    /** Duration of one snapshot extraction, milliseconds. */
+    onSnapshot(durationMs: number): void;
+    /** Duration of one deep-freeze pass, milliseconds. */
+    onDeepFreeze(durationMs: number): void;
+    /** Duration of one publish (listener fan-out), milliseconds. */
+    onPublish(durationMs: number): void;
+    /** A render frame was published to listeners. */
+    onCommitNotification(): void;
+    /** Listener count at publish time. */
+    onListenerCount(count: number): void;
+}
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +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"}