@alife-sdk/core 0.1.0

package/dist/core/PortRegistry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Opaque token identifying a port type.
+ *
+ * The phantom `_brand` field carries the port's TypeScript type without
+ * contributing to the runtime shape, enabling type-safe `require<T>()`.
+ *
+ * @example
+ * ```ts
+ * const MyPort = createPortToken<IMyAdapter>('myAdapter', 'Bridge to XYZ');
+ * kernel.provide(MyPort, new MyAdapterImpl());
+ * const adapter = kernel.portRegistry.require(MyPort); // typed as IMyAdapter
+ * ```
+ */
+export interface PortToken<T> {
+    readonly id: string;
+    readonly description: string;
+    /** @internal Phantom field for type inference — never set at runtime. */
+    readonly _brand?: T;
+}
+/**
+ * Create a new port token with a unique id and human-readable description.
+ *
+ * @param id          - Unique identifier (e.g. `'entityAdapter'`).
+ * @param description - Short explanation shown in diagnostics.
+ */
+export declare function createPortToken<T>(id: string, description: string): PortToken<T>;
+/**
+ * Runtime container for port implementations, keyed by {@link PortToken}.
+ *
+ * Designed for a single-phase lifecycle:
+ *   1. `provide()` during setup (before `kernel.init()`).
+ *   2. `require()` / `tryGet()` during init and at runtime.
+ *
+ * Duplicate registrations throw immediately to surface wiring bugs early.
+ */
+export declare class PortRegistry {
+    private readonly ports;
+    /**
+     * Register a port implementation.
+     *
+     * @throws {Error} If a port with the same token id is already registered.
+     */
+    provide<T>(token: PortToken<T>, impl: T): void;
+    /**
+     * Retrieve a required port.
+     *
+     * @throws {Error} If the port has not been provided.
+     */
+    require<T>(token: PortToken<T>): T;
+    /** Retrieve an optional port, returning `undefined` when absent. */
+    tryGet<T>(token: PortToken<T>): T | undefined;
+    /** Check whether a port has been provided. */
+    has(token: PortToken<unknown>): boolean;
+    /** Return all registered port ids (useful for diagnostics). */
+    registeredIds(): string[];
+}
+//# sourceMappingURL=PortRegistry.d.ts.map

package/dist/core/PortRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortRegistry.d.ts","sourceRoot":"","sources":["../../src/core/PortRegistry.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAEhF;AAMD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAU9C;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAWlC,oEAAoE;IACpE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS;IAI7C,8CAA8C;IAC9C,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAIvC,+DAA+D;IAC/D,aAAa,IAAI,MAAM,EAAE;CAG1B"}

package/dist/core/PortRegistry.js

@@ -0,0 +1,72 @@
+// core/PortRegistry.ts
+// Type-safe service registry with token-based port resolution.
+//
+// Ports are external adapters (entity adapter, player position, pathfinder)
+// that the host game engine supplies to the A-Life kernel. PortRegistry
+// replaces the hard-coded IALifeKernelPorts interface with an extensible
+// token-based lookup, allowing third-party plugins to declare and consume
+// custom ports without modifying the kernel's constructor signature.
+/**
+ * Create a new port token with a unique id and human-readable description.
+ *
+ * @param id          - Unique identifier (e.g. `'entityAdapter'`).
+ * @param description - Short explanation shown in diagnostics.
+ */
+export function createPortToken(id, description) {
+    return { id, description };
+}
+// ---------------------------------------------------------------------------
+// PortRegistry
+// ---------------------------------------------------------------------------
+/**
+ * Runtime container for port implementations, keyed by {@link PortToken}.
+ *
+ * Designed for a single-phase lifecycle:
+ *   1. `provide()` during setup (before `kernel.init()`).
+ *   2. `require()` / `tryGet()` during init and at runtime.
+ *
+ * Duplicate registrations throw immediately to surface wiring bugs early.
+ */
+export class PortRegistry {
+    constructor() {
+        this.ports = new Map();
+    }
+    /**
+     * Register a port implementation.
+     *
+     * @throws {Error} If a port with the same token id is already registered.
+     */
+    provide(token, impl) {
+        if (this.ports.has(token.id)) {
+            throw new Error(`[PortRegistry] Port "${token.id}" already registered. ` +
+                `Each port token must be provided exactly once.`);
+        }
+        this.ports.set(token.id, impl);
+    }
+    /**
+     * Retrieve a required port.
+     *
+     * @throws {Error} If the port has not been provided.
+     */
+    require(token) {
+        const impl = this.ports.get(token.id);
+        if (impl === undefined) {
+            throw new Error(`[PortRegistry] Required port "${token.id}" (${token.description}) ` +
+                `not provided. Call kernel.provide(token, impl) before init().`);
+        }
+        return impl;
+    }
+    /** Retrieve an optional port, returning `undefined` when absent. */
+    tryGet(token) {
+        return this.ports.get(token.id);
+    }
+    /** Check whether a port has been provided. */
+    has(token) {
+        return this.ports.has(token.id);
+    }
+    /** Return all registered port ids (useful for diagnostics). */
+    registeredIds() {
+        return [...this.ports.keys()];
+    }
+}
+//# sourceMappingURL=PortRegistry.js.map

package/dist/core/PortRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortRegistry.js","sourceRoot":"","sources":["../../src/core/PortRegistry.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,+DAA+D;AAC/D,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE;AA0BrE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAI,EAAU,EAAE,WAAmB;IAChE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IAAzB;QACmB,UAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IA+CtD,CAAC;IA7CC;;;;OAIG;IACH,OAAO,CAAI,KAAmB,EAAE,IAAO;QACrC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,CAAC,EAAE,wBAAwB;gBACxD,gDAAgD,CACjD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAI,KAAmB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC,WAAW,IAAI;gBACpE,+DAA+D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAI,KAAmB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAkB,CAAC;IACnD,CAAC;IAED,8CAA8C;IAC9C,GAAG,CAAC,KAAyB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,+DAA+D;IAC/D,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/core/PortTokens.d.ts

@@ -0,0 +1,39 @@
+import type { IEntityAdapter } from '../ports/IEntityAdapter';
+import type { IPlayerPositionProvider } from '../ports/IPlayerPositionProvider';
+import type { IEntityFactory } from '../ports/IEntityFactory';
+import type { IRandom } from '../ports/IRandom';
+import type { IRuntimeClock } from '../ports/IRuntimeClock';
+/**
+ * Well-known port tokens shipped with the SDK.
+ *
+ * The first three (`EntityAdapter`, `PlayerPosition`, `EntityFactory`) are
+ * required by the kernel — `init()` will report a diagnostic error if any
+ * is missing. The rest are optional capability ports consumed by plugins.
+ *
+ * @example
+ * ```ts
+ * import { Ports } from '@alife-sdk/core';
+ *
+ * kernel.provide(Ports.EntityAdapter, myAdapter);
+ * kernel.provide(Ports.PlayerPosition, myPositionProvider);
+ * kernel.provide(Ports.EntityFactory, myFactory);
+ * ```
+ */
+export declare const Ports: {
+    readonly EntityAdapter: import("./PortRegistry").PortToken<IEntityAdapter>;
+    readonly PlayerPosition: import("./PortRegistry").PortToken<IPlayerPositionProvider>;
+    readonly EntityFactory: import("./PortRegistry").PortToken<IEntityFactory>;
+    readonly Random: import("./PortRegistry").PortToken<IRandom>;
+    readonly RuntimeClock: import("./PortRegistry").PortToken<IRuntimeClock>;
+};
+/**
+ * Port tokens that the kernel unconditionally requires.
+ *
+ * `EntityAdapter`, `PlayerPosition`, and `EntityFactory` are no longer listed
+ * here — the kernel auto-provides no-op defaults for them in `init()` when the
+ * host does not supply real implementations (same pattern as `Random`).
+ * Plugins that genuinely need real implementations declare them via
+ * `plugin.requiredPorts`.
+ */
+export declare const REQUIRED_PORTS: readonly import('./PortRegistry').PortToken<unknown>[];
+//# sourceMappingURL=PortTokens.d.ts.map

package/dist/core/PortTokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortTokens.d.ts","sourceRoot":"","sources":["../../src/core/PortTokens.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,KAAK;;;;;;CAqBR,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,gBAAgB,EAAE,SAAS,CAAC,OAAO,CAAC,EAAO,CAAC"}

package/dist/core/PortTokens.js

@@ -0,0 +1,39 @@
+// core/PortTokens.ts
+// Built-in port tokens for the standard A-Life kernel adapters.
+//
+// Third-party plugins can create their own tokens via createPortToken<T>().
+import { createPortToken } from './PortRegistry';
+/**
+ * Well-known port tokens shipped with the SDK.
+ *
+ * The first three (`EntityAdapter`, `PlayerPosition`, `EntityFactory`) are
+ * required by the kernel — `init()` will report a diagnostic error if any
+ * is missing. The rest are optional capability ports consumed by plugins.
+ *
+ * @example
+ * ```ts
+ * import { Ports } from '@alife-sdk/core';
+ *
+ * kernel.provide(Ports.EntityAdapter, myAdapter);
+ * kernel.provide(Ports.PlayerPosition, myPositionProvider);
+ * kernel.provide(Ports.EntityFactory, myFactory);
+ * ```
+ */
+export const Ports = {
+    EntityAdapter: createPortToken('entityAdapter', 'Bridge between kernel and host entity system'),
+    PlayerPosition: createPortToken('playerPosition', 'Provides player world position for online/offline checks'),
+    EntityFactory: createPortToken('entityFactory', 'Creates and destroys game entities on spawn/despawn'),
+    Random: createPortToken('random', 'PRNG for simulation randomness'),
+    RuntimeClock: createPortToken('runtimeClock', 'Monotonic real-time ms for cooldowns and memory aging'),
+};
+/**
+ * Port tokens that the kernel unconditionally requires.
+ *
+ * `EntityAdapter`, `PlayerPosition`, and `EntityFactory` are no longer listed
+ * here — the kernel auto-provides no-op defaults for them in `init()` when the
+ * host does not supply real implementations (same pattern as `Random`).
+ * Plugins that genuinely need real implementations declare them via
+ * `plugin.requiredPorts`.
+ */
+export const REQUIRED_PORTS = [];
+//# sourceMappingURL=PortTokens.js.map

package/dist/core/PortTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PortTokens.js","sourceRoot":"","sources":["../../src/core/PortTokens.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,aAAa,EAAE,eAAe,CAC5B,eAAe,EACf,8CAA8C,CAC/C;IACD,cAAc,EAAE,eAAe,CAC7B,gBAAgB,EAChB,0DAA0D,CAC3D;IACD,aAAa,EAAE,eAAe,CAC5B,eAAe,EACf,qDAAqD,CACtD;IACD,MAAM,EAAE,eAAe,CACrB,QAAQ,EACR,gCAAgC,CACjC;IACD,YAAY,EAAE,eAAe,CAC3B,cAAc,EACd,uDAAuD,CACxD;CACO,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2D,EAAE,CAAC"}

package/dist/core/SpatialGrid.d.ts

@@ -0,0 +1,114 @@
+import type { Vec2 } from './Vec2';
+export interface IRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Spatial hash grid that supports fast radius and rectangle queries
+ * over an arbitrary item type.
+ *
+ * @typeParam T - Any object stored in the grid. Position is extracted
+ *   via the `positionFn` supplied at construction time.
+ *
+ * @example
+ * ```ts
+ * interface NPC { name: string; pos: Vec2 }
+ *
+ * const grid = new SpatialGrid<NPC>(200, (npc) => npc.pos);
+ * grid.insert(myNpc);
+ *
+ * const nearby = grid.queryRadius({ x: 400, y: 300 }, 250);
+ * ```
+ */
+export declare class SpatialGrid<T> {
+    /** Offset to shift cell indices into non-negative range. Supports +/-512 cells. */
+    private static readonly CELL_OFFSET;
+    /** Stride for packing (cx, cy) into a single integer. */
+    private static readonly CELL_STRIDE;
+    /** Pixel size of each square cell. */
+    private readonly cellSize;
+    /** Extracts a world-space position from an item. */
+    private readonly positionFn;
+    /**
+     * Packed integer key -> Set of items whose position hashes to that cell.
+     * Cells are created lazily and deleted when they become empty.
+     */
+    private readonly cells;
+    /**
+     * item -> packed integer cell key where that item currently lives.
+     * Enables O(1) lookup of the old cell in update() and remove().
+     */
+    private readonly itemToCell;
+    /**
+     * Scratch array reused by queryRadius() and queryRect() to avoid
+     * allocating a new array on every call. Callers that need to hold
+     * results beyond the next query should copy the returned array.
+     */
+    private readonly _scratchResults;
+    /**
+     * @param cellSize   - Width and height of each grid cell in world units.
+     *   A good default is 2x your most common query radius so that a centred
+     *   radius query never reads more than ~9 cells.
+     * @param positionFn - Pure function that extracts a Vec2 from an item.
+     */
+    constructor(cellSize: number, positionFn: (item: T) => Vec2);
+    /**
+     * Add an item to the grid.
+     *
+     * If the item is already tracked, this behaves like {@link update} to keep
+     * internal state consistent.
+     */
+    insert(item: T): void;
+    /**
+     * Remove an item from the grid.
+     *
+     * @returns `true` if the item was found and removed, `false` if it was not tracked.
+     */
+    remove(item: T): boolean;
+    /**
+     * Re-hash an item after its position has changed.
+     *
+     * If the item has not crossed a cell boundary this is a no-op.
+     * If the item is not yet tracked, it is inserted automatically.
+     */
+    update(item: T): void;
+    /** Remove all items and all cells. */
+    clear(): void;
+    /**
+     * Return all items within `radius` world-units of `center`.
+     *
+     * **Note:** The returned array is reused between calls. Callers that need
+     * to hold the result beyond the next query should copy it (e.g. `[...result]`).
+     *
+     * Algorithm:
+     *   1. Compute the cell-space AABB that covers the bounding box of the circle.
+     *   2. Iterate that rectangular band of cells.
+     *   3. Filter each candidate by exact squared distance (no sqrt).
+     */
+    queryRadius(center: Vec2, radius: number): T[];
+    /**
+     * Return all items whose position lies within the axis-aligned rectangle
+     * defined by its top-left corner (x, y) and dimensions (width x height).
+     *
+     * **Note:** The returned array is reused between calls. Callers that need
+     * to hold the result beyond the next query should copy it (e.g. `[...result]`).
+     */
+    queryRect(bounds: IRect): T[];
+    /** Total number of items currently tracked by the grid. */
+    get size(): number;
+    /**
+     * Pack cell coordinates (cx, cy) into a single non-negative integer.
+     * Supports cell indices in the range [-512, +511].
+     */
+    private cellKeyInt;
+    /** Add an item to the cell identified by `key`, creating the cell lazily. */
+    private addToCell;
+    /**
+     * Remove an item from the cell at `key`.
+     * Prunes the cell if it becomes empty to prevent unbounded growth.
+     */
+    private removeFromCell;
+}
+//# sourceMappingURL=SpatialGrid.d.ts.map

package/dist/core/SpatialGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialGrid.d.ts","sourceRoot":"","sources":["../../src/core/SpatialGrid.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,WAAW,KAAK;IACpB,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;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,CAAC;IAKxB,mFAAmF;IACnF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAO;IAE1C,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAM3C,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAExD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAM3C;;;;;OAKG;gBACS,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI;IAY3D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAYrB;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IASxB;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAuBrB,sCAAsC;IACtC,KAAK,IAAI,IAAI;IASb;;;;;;;;;;OAUG;IACH,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE;IAgC9C;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE;IAoC7B,2DAA2D;IAC3D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;;OAGG;IACH,OAAO,CAAC,UAAU;IAMlB,6EAA6E;IAC7E,OAAO,CAAC,SAAS;IASjB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAUvB"}

package/dist/core/SpatialGrid.js

@@ -0,0 +1,258 @@
+// core/SpatialGrid.ts
+// Generic spatial hash grid for efficient radius and rectangle queries.
+//
+// Algorithm:
+//   The world is divided into axis-aligned cells of cellSize x cellSize pixels.
+//   Each item hashes to exactly one cell based on its position (extracted via
+//   a caller-supplied positionFn). Cells are lazily created as Maps keyed by
+//   integer and pruned when empty to bound memory.
+//
+// Performance:
+//   insert / remove / update   O(1)
+//   queryRadius / queryRect    O(k), k = items in intersected cells
+//   No Math.sqrt on the hot path — radius checks use squared distance.
+//   Cell keys are packed integers (no string allocation).
+//   Query methods reuse a scratch array to avoid per-call allocation.
+//
+// Generic design:
+//   SpatialGrid<T> works with any item type. The caller provides a positionFn
+//   that extracts a Vec2 from T, so there is no interface constraint on T.
+//   Internally, items are tracked via a WeakRef-free identity Map (item -> cell key).
+// ---------------------------------------------------------------------------
+// SpatialGrid<T>
+// ---------------------------------------------------------------------------
+/**
+ * Spatial hash grid that supports fast radius and rectangle queries
+ * over an arbitrary item type.
+ *
+ * @typeParam T - Any object stored in the grid. Position is extracted
+ *   via the `positionFn` supplied at construction time.
+ *
+ * @example
+ * ```ts
+ * interface NPC { name: string; pos: Vec2 }
+ *
+ * const grid = new SpatialGrid<NPC>(200, (npc) => npc.pos);
+ * grid.insert(myNpc);
+ *
+ * const nearby = grid.queryRadius({ x: 400, y: 300 }, 250);
+ * ```
+ */
+export class SpatialGrid {
+    // ---------------------------------------------------------------------------
+    // Constructor
+    // ---------------------------------------------------------------------------
+    /**
+     * @param cellSize   - Width and height of each grid cell in world units.
+     *   A good default is 2x your most common query radius so that a centred
+     *   radius query never reads more than ~9 cells.
+     * @param positionFn - Pure function that extracts a Vec2 from an item.
+     */
+    constructor(cellSize, positionFn) {
+        /**
+         * Packed integer key -> Set of items whose position hashes to that cell.
+         * Cells are created lazily and deleted when they become empty.
+         */
+        this.cells = new Map();
+        /**
+         * item -> packed integer cell key where that item currently lives.
+         * Enables O(1) lookup of the old cell in update() and remove().
+         */
+        this.itemToCell = new Map();
+        /**
+         * Scratch array reused by queryRadius() and queryRect() to avoid
+         * allocating a new array on every call. Callers that need to hold
+         * results beyond the next query should copy the returned array.
+         */
+        this._scratchResults = [];
+        if (cellSize <= 0) {
+            throw new RangeError(`SpatialGrid: cellSize must be > 0, got ${cellSize}`);
+        }
+        this.cellSize = cellSize;
+        this.positionFn = positionFn;
+    }
+    // ---------------------------------------------------------------------------
+    // Mutation API
+    // ---------------------------------------------------------------------------
+    /**
+     * Add an item to the grid.
+     *
+     * If the item is already tracked, this behaves like {@link update} to keep
+     * internal state consistent.
+     */
+    insert(item) {
+        if (this.itemToCell.has(item)) {
+            this.update(item);
+            return;
+        }
+        const pos = this.positionFn(item);
+        const key = this.cellKeyInt(pos.x, pos.y);
+        this.addToCell(key, item);
+        this.itemToCell.set(item, key);
+    }
+    /**
+     * Remove an item from the grid.
+     *
+     * @returns `true` if the item was found and removed, `false` if it was not tracked.
+     */
+    remove(item) {
+        const key = this.itemToCell.get(item);
+        if (key === undefined)
+            return false;
+        this.removeFromCell(key, item);
+        this.itemToCell.delete(item);
+        return true;
+    }
+    /**
+     * Re-hash an item after its position has changed.
+     *
+     * If the item has not crossed a cell boundary this is a no-op.
+     * If the item is not yet tracked, it is inserted automatically.
+     */
+    update(item) {
+        const pos = this.positionFn(item);
+        const newKey = this.cellKeyInt(pos.x, pos.y);
+        const oldKey = this.itemToCell.get(item);
+        if (oldKey === undefined) {
+            // Not yet tracked — insert.
+            this.addToCell(newKey, item);
+            this.itemToCell.set(item, newKey);
+            return;
+        }
+        if (oldKey === newKey) {
+            // Still in the same cell — nothing to do.
+            return;
+        }
+        // Moved to a different cell — re-bucket.
+        this.removeFromCell(oldKey, item);
+        this.addToCell(newKey, item);
+        this.itemToCell.set(item, newKey);
+    }
+    /** Remove all items and all cells. */
+    clear() {
+        this.cells.clear();
+        this.itemToCell.clear();
+    }
+    // ---------------------------------------------------------------------------
+    // Query API
+    // ---------------------------------------------------------------------------
+    /**
+     * Return all items within `radius` world-units of `center`.
+     *
+     * **Note:** The returned array is reused between calls. Callers that need
+     * to hold the result beyond the next query should copy it (e.g. `[...result]`).
+     *
+     * Algorithm:
+     *   1. Compute the cell-space AABB that covers the bounding box of the circle.
+     *   2. Iterate that rectangular band of cells.
+     *   3. Filter each candidate by exact squared distance (no sqrt).
+     */
+    queryRadius(center, radius) {
+        const radiusSq = radius * radius;
+        const results = this._scratchResults;
+        results.length = 0;
+        const minCX = Math.floor((center.x - radius) / this.cellSize);
+        const minCY = Math.floor((center.y - radius) / this.cellSize);
+        const maxCX = Math.floor((center.x + radius) / this.cellSize);
+        const maxCY = Math.floor((center.y + radius) / this.cellSize);
+        for (let cy = minCY; cy <= maxCY; cy++) {
+            for (let cx = minCX; cx <= maxCX; cx++) {
+                const cell = this.cells.get((cx + SpatialGrid.CELL_OFFSET) * SpatialGrid.CELL_STRIDE +
+                    (cy + SpatialGrid.CELL_OFFSET));
+                if (!cell)
+                    continue;
+                for (const item of cell) {
+                    const pos = this.positionFn(item);
+                    const dx = pos.x - center.x;
+                    const dy = pos.y - center.y;
+                    if (dx * dx + dy * dy <= radiusSq) {
+                        results.push(item);
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Return all items whose position lies within the axis-aligned rectangle
+     * defined by its top-left corner (x, y) and dimensions (width x height).
+     *
+     * **Note:** The returned array is reused between calls. Callers that need
+     * to hold the result beyond the next query should copy it (e.g. `[...result]`).
+     */
+    queryRect(bounds) {
+        const { x, y, width, height } = bounds;
+        const right = x + width;
+        const bottom = y + height;
+        const results = this._scratchResults;
+        results.length = 0;
+        const minCX = Math.floor(x / this.cellSize);
+        const minCY = Math.floor(y / this.cellSize);
+        const maxCX = Math.floor(right / this.cellSize);
+        const maxCY = Math.floor(bottom / this.cellSize);
+        for (let cy = minCY; cy <= maxCY; cy++) {
+            for (let cx = minCX; cx <= maxCX; cx++) {
+                const cell = this.cells.get((cx + SpatialGrid.CELL_OFFSET) * SpatialGrid.CELL_STRIDE +
+                    (cy + SpatialGrid.CELL_OFFSET));
+                if (!cell)
+                    continue;
+                for (const item of cell) {
+                    const pos = this.positionFn(item);
+                    if (pos.x >= x && pos.x <= right && pos.y >= y && pos.y <= bottom) {
+                        results.push(item);
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    // ---------------------------------------------------------------------------
+    // Diagnostics
+    // ---------------------------------------------------------------------------
+    /** Total number of items currently tracked by the grid. */
+    get size() {
+        return this.itemToCell.size;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Pack cell coordinates (cx, cy) into a single non-negative integer.
+     * Supports cell indices in the range [-512, +511].
+     */
+    cellKeyInt(x, y) {
+        const cx = Math.floor(x / this.cellSize);
+        const cy = Math.floor(y / this.cellSize);
+        return (cx + SpatialGrid.CELL_OFFSET) * SpatialGrid.CELL_STRIDE + (cy + SpatialGrid.CELL_OFFSET);
+    }
+    /** Add an item to the cell identified by `key`, creating the cell lazily. */
+    addToCell(key, item) {
+        let cell = this.cells.get(key);
+        if (!cell) {
+            cell = new Set();
+            this.cells.set(key, cell);
+        }
+        cell.add(item);
+    }
+    /**
+     * Remove an item from the cell at `key`.
+     * Prunes the cell if it becomes empty to prevent unbounded growth.
+     */
+    removeFromCell(key, item) {
+        const cell = this.cells.get(key);
+        if (!cell)
+            return;
+        cell.delete(item);
+        if (cell.size === 0) {
+            this.cells.delete(key);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Integer key packing constants
+// ---------------------------------------------------------------------------
+/** Offset to shift cell indices into non-negative range. Supports +/-512 cells. */
+SpatialGrid.CELL_OFFSET = 512;
+/** Stride for packing (cx, cy) into a single integer. */
+SpatialGrid.CELL_STRIDE = 1024;
+//# sourceMappingURL=SpatialGrid.js.map

package/dist/core/SpatialGrid.js.map

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

package/dist/core/Vec2.d.ts

@@ -0,0 +1,34 @@
+/** Immutable 2D point / vector. All positions and directions in the SDK use this type. */
+export interface Vec2 {
+    /** Horizontal coordinate (px, rightward positive). */
+    readonly x: number;
+    /** Vertical coordinate (px, downward positive). */
+    readonly y: number;
+}
+/** Frozen origin vector `{ x: 0, y: 0 }`. Safe to use as a default or sentinel. */
+export declare const ZERO: Vec2;
+/** Squared Euclidean distance. Prefer over distance() in hot loops to avoid sqrt. */
+export declare function distanceSq(a: Vec2, b: Vec2): number;
+/** Euclidean distance between two points. */
+export declare function distance(a: Vec2, b: Vec2): number;
+/** Linear interpolation. t = 0 returns `a`, t = 1 returns `b`. */
+export declare function lerp(a: Vec2, b: Vec2, t: number): Vec2;
+/** Component-wise subtraction (a − b). */
+export declare function subtract(a: Vec2, b: Vec2): Vec2;
+/** Length of the vector (distance from origin). */
+export declare function magnitude(v: Vec2): number;
+/** Unit vector in the same direction. Returns ZERO for zero-length input. */
+export declare function normalize(v: Vec2): Vec2;
+/** Component-wise addition. Returns a new Vec2. */
+export declare function add(a: Vec2, b: Vec2): Vec2;
+/** Scalar multiplication. Returns a new Vec2. */
+export declare function scale(v: Vec2, s: number): Vec2;
+/** Dot product of two vectors. */
+export declare function dot(a: Vec2, b: Vec2): number;
+/**
+ * Angle of vector from +X axis in radians (-π, +π].
+ * Returns 0 for the zero vector.
+ * Replaces `Math.atan2(dy, dx)` pattern in state handlers.
+ */
+export declare function angle(v: Vec2): number;
+//# sourceMappingURL=Vec2.d.ts.map

package/dist/core/Vec2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vec2.d.ts","sourceRoot":"","sources":["../../src/core/Vec2.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,WAAW,IAAI;IACnB,sDAAsD;IACtD,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,eAAO,MAAM,IAAI,EAAE,IAAoC,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAInD;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAEjD;AAED,kEAAkE;AAClE,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAE/C;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEzC;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAIvC;AAED,mDAAmD;AACnD,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAE1C;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,kCAAkC;AAClC,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAErC"}