@sadhaka/loom-engine 0.10.0

package/dist/renderer/graphics-device.d.ts

@@ -0,0 +1,36 @@
+import type { ColorRGBA } from '../util/color.js';
+import type { CameraView } from './camera.js';
+export type AtlasHandle = number;
+export interface AtlasDescriptor {
+    image: HTMLImageElement | HTMLCanvasElement | ImageBitmap;
+    frames: ReadonlyArray<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    name?: string;
+}
+export interface TextStyle {
+    font: string;
+    fill: ColorRGBA;
+    align?: 'left' | 'center' | 'right';
+    baseline?: 'top' | 'middle' | 'bottom' | 'alphabetic';
+}
+export interface IGraphicsDevice {
+    readonly canvas: HTMLCanvasElement;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    beginFrame(): void;
+    endFrame(): void;
+    setCamera(cam: Readonly<CameraView>): void;
+    registerAtlas(desc: AtlasDescriptor): AtlasHandle;
+    releaseAtlas(handle: AtlasHandle): void;
+    drawSprite(worldX: number, worldY: number, worldZ: number, atlas: AtlasHandle, frame: number, tint?: Readonly<ColorRGBA>): void;
+    drawTile(tileX: number, tileY: number, atlas: AtlasHandle, frame: number): void;
+    drawText(worldX: number, worldY: number, text: string, style: TextStyle): void;
+    drawParticle(worldX: number, worldY: number, worldZ: number, size: number, color: Readonly<ColorRGBA>, additive: boolean): void;
+    getDrawCallCount(): number;
+}
+export type DeviceBackend = 'canvas2d' | 'webgl2';
+//# sourceMappingURL=graphics-device.d.ts.map

package/dist/renderer/graphics-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-device.d.ts","sourceRoot":"","sources":["../../src/renderer/graphics-device.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAGjC,MAAM,WAAW,eAAe;IAE9B,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,CAAC;IAG1D,MAAM,EAAE,aAAa,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;CACvD;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAGhC,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,IAAI,IAAI,CAAC;IAIjB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAG3C,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IAClD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAMxC,UAAU,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,GACzB,IAAI,CAAC;IAER,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GACf,IAAI,CAAC;IAOR,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,QAAQ,EAAE,OAAO,GAChB,IAAI,CAAC;IAIR,gBAAgB,IAAI,MAAM,CAAC;CAC5B;AAGD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC"}

package/dist/renderer/graphics-device.js

@@ -0,0 +1,12 @@
+// Graphics device abstraction for the Loom Engine.
+//
+// All higher-level systems talk to IGraphicsDevice, never to the
+// concrete backend. This is the Babylon.js ThinEngine split: lean
+// GPU core (the device) + higher-level scene logic (everything
+// else). See PRIOR-ART.md for the citation.
+//
+// Two backends ship over time:
+//   Canvas2DDevice  - v1 primary, Phase 1
+//   WebGL2Device    - Phase 2 if profiling demands
+export {};
+//# sourceMappingURL=graphics-device.js.map

package/dist/renderer/graphics-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics-device.js","sourceRoot":"","sources":["../../src/renderer/graphics-device.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,iEAAiE;AACjE,kEAAkE;AAClE,+DAA+D;AAC/D,4CAA4C;AAC5C,EAAE;AACF,+BAA+B;AAC/B,0CAA0C;AAC1C,mDAAmD"}

package/dist/renderer/iso-projection.d.ts

@@ -0,0 +1,11 @@
+import type { Vec2, Vec3 } from '../util/math.js';
+export declare const ISO_TILE_WIDTH: number;
+export declare const ISO_TILE_HEIGHT: number;
+export declare const ISO_HALF_W: number;
+export declare const ISO_HALF_H: number;
+export declare const ISO_Z_SCALE: number;
+export declare function tileToIso(tileX: number, tileY: number, out: Vec2): Vec2;
+export declare function worldToIso(world: Vec3, out: Vec2): Vec2;
+export declare function isoToTile(isoX: number, isoY: number, out: Vec2): Vec2;
+export declare function isoDepthKey(world: Vec3): number;
+//# sourceMappingURL=iso-projection.d.ts.map

package/dist/renderer/iso-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-projection.d.ts","sourceRoot":"","sources":["../../src/renderer/iso-projection.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKlD,eAAO,MAAM,cAAc,EAAE,MAAW,CAAC;AACzC,eAAO,MAAM,eAAe,EAAE,MAAW,CAAC;AAC1C,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,UAAU,EAAE,MAA4B,CAAC;AAGtD,eAAO,MAAM,WAAW,EAAE,MAAW,CAAC;AAKtC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAIvE;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAIvD;AAID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAWrE;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAE/C"}

package/dist/renderer/iso-projection.js

@@ -0,0 +1,59 @@
+// Isometric projection for the Loom Engine.
+//
+// Standard 2:1 dimetric projection. Tile width:height = 2:1. World
+// coords use (x, y) on the tile grid; iso transform produces screen
+// (sx, sy) where sx = (x - y) * (TILE_W/2), sy = (x + y) * (TILE_H/2).
+//
+// This is a public-domain technique - 1980s arcade games (Q*bert),
+// 1990s ARPGs (Diablo, Baldur's Gate). See PRIOR-ART.md for the
+// citation. We add a Z component to each entity (world height for
+// flying / floating sprites + iso-grid depth sort) but Z does not
+// affect the screen Y projection beyond a fixed offset.
+// Iso tile dimensions in pixels at zoom = 1. Pure 2:1 dimetric.
+// These are engine constants for v1; future zoom levels scale them
+// uniformly.
+export const ISO_TILE_WIDTH = 64;
+export const ISO_TILE_HEIGHT = 32;
+export const ISO_HALF_W = ISO_TILE_WIDTH / 2;
+export const ISO_HALF_H = ISO_TILE_HEIGHT / 2;
+// Z (height above ground) -> screen-space Y offset. 1 world unit of
+// height = ISO_Z_SCALE pixels of vertical lift.
+export const ISO_Z_SCALE = 16;
+// World tile coords -> iso screen-space (before camera transform).
+// y increases southward in world space; iso shifts that to lower-
+// right in screen space.
+export function tileToIso(tileX, tileY, out) {
+    out.x = (tileX - tileY) * ISO_HALF_W;
+    out.y = (tileX + tileY) * ISO_HALF_H;
+    return out;
+}
+// Continuous world-space coords (sub-tile precision) -> iso screen-
+// space. Same formula, no rounding.
+export function worldToIso(world, out) {
+    out.x = (world.x - world.y) * ISO_HALF_W;
+    out.y = (world.x + world.y) * ISO_HALF_H - world.z * ISO_Z_SCALE;
+    return out;
+}
+// Iso screen-space -> world tile coords (inverse projection). Used
+// for cursor-to-tile picking.
+export function isoToTile(isoX, isoY, out) {
+    // Solve the 2x2 system:
+    //   isoX = (x - y) * HALF_W
+    //   isoY = (x + y) * HALF_H
+    // -> x = isoX/(2*HALF_W) + isoY/(2*HALF_H)
+    // -> y = isoY/(2*HALF_H) - isoX/(2*HALF_W)
+    const a = isoX / (2 * ISO_HALF_W);
+    const b = isoY / (2 * ISO_HALF_H);
+    out.x = a + b;
+    out.y = b - a;
+    return out;
+}
+// Depth-sort key for iso rendering. Lower = drawn first (back).
+// Uses world (x + y) as the diagonal sort axis. Z (height) breaks
+// ties so taller objects of the same diagonal draw later (front).
+//
+// Inspired by standard iso-game depth sorting; see PRIOR-ART.md.
+export function isoDepthKey(world) {
+    return (world.x + world.y) * 1000 + world.z;
+}
+//# sourceMappingURL=iso-projection.js.map

package/dist/renderer/iso-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-projection.js","sourceRoot":"","sources":["../../src/renderer/iso-projection.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,uEAAuE;AACvE,EAAE;AACF,mEAAmE;AACnE,gEAAgE;AAChE,kEAAkE;AAClE,kEAAkE;AAClE,wDAAwD;AAIxD,gEAAgE;AAChE,mEAAmE;AACnE,aAAa;AACb,MAAM,CAAC,MAAM,cAAc,GAAW,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAW,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAW,cAAc,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAW,eAAe,GAAG,CAAC,CAAC;AACtD,oEAAoE;AACpE,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAW,EAAE,CAAC;AAEtC,mEAAmE;AACnE,kEAAkE;AAClE,yBAAyB;AACzB,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,KAAa,EAAE,GAAS;IAC/D,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC;IACrC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC;IACrC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oEAAoE;AACpE,oCAAoC;AACpC,MAAM,UAAU,UAAU,CAAC,KAAW,EAAE,GAAS;IAC/C,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IACzC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC;IACjE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mEAAmE;AACnE,8BAA8B;AAC9B,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY,EAAE,GAAS;IAC7D,wBAAwB;IACxB,4BAA4B;IAC5B,4BAA4B;IAC5B,2CAA2C;IAC3C,2CAA2C;IAC3C,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;IAClC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gEAAgE;AAChE,kEAAkE;AAClE,kEAAkE;AAClE,EAAE;AACF,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,KAAW;IACrC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,28 @@
+export declare class ResourceRegistry {
+    private resources;
+    set<T>(key: string, value: T): void;
+    get<T>(key: string): T | undefined;
+    require<T>(key: string): T;
+    has(key: string): boolean;
+    remove(key: string): boolean;
+    keys(): IterableIterator<string>;
+}
+export interface TimeResource {
+    elapsed: number;
+    delta: number;
+    frame: number;
+}
+export declare function createTimeResource(): TimeResource;
+export declare const RESOURCE_TIME = "time";
+export declare const RESOURCE_CAMERA = "camera";
+export declare const RESOURCE_DEVICE = "device";
+export interface VeilBudgetResource {
+    particleBudget: number;
+    shaderBudget: number;
+    eventBudget: number;
+    audioBudget: number;
+    lastUpdatedFrame: number;
+}
+export declare function createVeilBudgetResource(): VeilBudgetResource;
+export declare const RESOURCE_VEIL_BUDGET = "veil_budget";
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAUA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAmC;IAEpD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMlC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAQ1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;CAGjC;AAID,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAGhB,KAAK,EAAE,MAAM,CAAC;IAEd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAED,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,eAAe,WAAW,CAAC;AAexC,MAAM,WAAW,kBAAkB;IAKjC,cAAc,EAAE,MAAM,CAAC;IAEvB,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;IAKpB,WAAW,EAAE,MAAM,CAAC;IAGpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAQ7D;AAED,eAAO,MAAM,oBAAoB,gBAAgB,CAAC"}

package/dist/resources.js

@@ -0,0 +1,53 @@
+// Resource registry for the Loom Engine ECS.
+//
+// Resources are singleton state injected into systems by string key.
+// Time, Input, Camera, RNG, etc. all live here. The registry is just
+// a typed Map.
+//
+// Inspired by Bevy's Resource pattern (see PRIOR-ART.md). Bevy uses
+// type-as-key via Rust's TypeId; in TS we use string keys with a
+// generic accessor.
+export class ResourceRegistry {
+    resources = new Map();
+    set(key, value) {
+        this.resources.set(key, value);
+    }
+    get(key) {
+        return this.resources.get(key);
+    }
+    // Throws if missing. Useful for resources that must always exist
+    // (Time, Camera) so the call site stays terse.
+    require(key) {
+        const v = this.resources.get(key);
+        if (v === undefined) {
+            throw new Error('ResourceRegistry: required resource "' + key + '" not registered');
+        }
+        return v;
+    }
+    has(key) {
+        return this.resources.has(key);
+    }
+    remove(key) {
+        return this.resources.delete(key);
+    }
+    keys() {
+        return this.resources.keys();
+    }
+}
+export function createTimeResource() {
+    return { elapsed: 0, delta: 0, frame: 0 };
+}
+export const RESOURCE_TIME = 'time';
+export const RESOURCE_CAMERA = 'camera';
+export const RESOURCE_DEVICE = 'device';
+export function createVeilBudgetResource() {
+    return {
+        particleBudget: 4096,
+        shaderBudget: 8,
+        eventBudget: 256,
+        audioBudget: 1.0,
+        lastUpdatedFrame: -1,
+    };
+}
+export const RESOURCE_VEIL_BUDGET = 'veil_budget';
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,eAAe;AACf,EAAE;AACF,oEAAoE;AACpE,iEAAiE;AACjE,oBAAoB;AAEpB,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEpD,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAClD,CAAC;IAED,iEAAiE;IACjE,+CAA+C;IAC/C,OAAO,CAAI,GAAW;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,GAAG,GAAG,kBAAkB,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;CACF;AAcD,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAmCxC,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,CAAC,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC"}

package/dist/system.d.ts

@@ -0,0 +1,14 @@
+import type { World } from './world.js';
+export interface System {
+    readonly name: string;
+    update(world: World, dt: number): void;
+}
+export declare const SYSTEM_PHASE_INPUT = 0;
+export declare const SYSTEM_PHASE_LOGIC = 1;
+export declare const SYSTEM_PHASE_PHYSICS = 2;
+export declare const SYSTEM_PHASE_ANIMATION = 3;
+export declare const SYSTEM_PHASE_RENDER = 4;
+export declare const SYSTEM_PHASE_POST_RENDER = 5;
+export type SystemPhase = typeof SYSTEM_PHASE_INPUT | typeof SYSTEM_PHASE_LOGIC | typeof SYSTEM_PHASE_PHYSICS | typeof SYSTEM_PHASE_ANIMATION | typeof SYSTEM_PHASE_RENDER | typeof SYSTEM_PHASE_POST_RENDER;
+export declare const SYSTEM_PHASES_IN_ORDER: ReadonlyArray<SystemPhase>;
+//# sourceMappingURL=system.d.ts.map

package/dist/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,MAAM;IAGrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAID,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,MAAM,MAAM,WAAW,GACnB,OAAO,kBAAkB,GACzB,OAAO,kBAAkB,GACzB,OAAO,oBAAoB,GAC3B,OAAO,sBAAsB,GAC7B,OAAO,mBAAmB,GAC1B,OAAO,wBAAwB,CAAC;AAEpC,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,WAAW,CAO7D,CAAC"}

package/dist/system.js

@@ -0,0 +1,25 @@
+// System interface for the Loom Engine ECS.
+//
+// A System is just a function-with-name. Systems run in registration
+// order, single-threaded, deterministic. No parallel scheduler in v1
+// (Bevy-style work-stealing is post-funding).
+//
+// Systems read/write component pools and resources. They're registered
+// with World.addSystem and run via World.update(dt).
+// System lifecycle phase. The scheduler runs phases in this order
+// every tick. Within a phase, systems run in registration order.
+export const SYSTEM_PHASE_INPUT = 0;
+export const SYSTEM_PHASE_LOGIC = 1;
+export const SYSTEM_PHASE_PHYSICS = 2;
+export const SYSTEM_PHASE_ANIMATION = 3;
+export const SYSTEM_PHASE_RENDER = 4;
+export const SYSTEM_PHASE_POST_RENDER = 5;
+export const SYSTEM_PHASES_IN_ORDER = [
+    SYSTEM_PHASE_INPUT,
+    SYSTEM_PHASE_LOGIC,
+    SYSTEM_PHASE_PHYSICS,
+    SYSTEM_PHASE_ANIMATION,
+    SYSTEM_PHASE_RENDER,
+    SYSTEM_PHASE_POST_RENDER,
+];
+//# sourceMappingURL=system.js.map

package/dist/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,8CAA8C;AAC9C,EAAE;AACF,uEAAuE;AACvE,qDAAqD;AAYrD,kEAAkE;AAClE,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAS1C,MAAM,CAAC,MAAM,sBAAsB,GAA+B;IAChE,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;IACtB,mBAAmB;IACnB,wBAAwB;CACzB,CAAC"}

package/dist/systems/animation-system.d.ts

@@ -0,0 +1,8 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare const POOL_ANIMATION = "animation";
+export declare class AnimationSystem implements System {
+    readonly name: string;
+    update(world: World, dt: number): void;
+}
+//# sourceMappingURL=animation-system.d.ts.map

package/dist/systems/animation-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-system.d.ts","sourceRoot":"","sources":["../../src/systems/animation-system.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkBzC,eAAO,MAAM,cAAc,cAAc,CAAC;AAc1C,qBAAa,eAAgB,YAAW,MAAM;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAe;IAEpC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAiDvC"}

package/dist/systems/animation-system.js

@@ -0,0 +1,77 @@
+// AnimationSystem - advances each active AnimationState's elapsedMs
+// and writes the resolved frame index back to SpritePool.
+//
+// Runs in SYSTEM_PHASE_ANIMATION. By the time SpriteRenderSystem
+// runs in SYSTEM_PHASE_RENDER, every entity's frame is up-to-date.
+//
+// Lookup cost per entity: O(clipCount) to find the named clip, then
+// O(1) for uniform-fps clips or O(framesInClip) for per-frame
+// duration clips. For Phase 3 / typical clips of <16 frames, no
+// optimization beyond a linear scan. Phase 4+ may swap in a clip-
+// name-to-index hash if profiling exposes hotspots.
+import { POOL_SPRITE } from '../world.js';
+import { ANIMATION_FLAG_ACTIVE, ANIMATION_FLAG_FINISHED, } from '../animation/animation-state-pool.js';
+import { frameInClipAt, manifestFrameIndex, clipDurationMs, } from '../animation/animation-clip.js';
+// Conventional pool key. Engine.create registers AnimationStatePool
+// under this name; Phase 3 demo + ARPG systems look it up by it.
+export const POOL_ANIMATION = 'animation';
+// Find a clip by name on a manifest. Linear scan is fine for the
+// typical clip count (idle / walk / run / attack / hit / death = ~6).
+function findClip(clips, name) {
+    for (let i = 0; i < clips.length; i++) {
+        if (clips[i]?.name === name)
+            return clips[i];
+    }
+    return undefined;
+}
+export class AnimationSystem {
+    name = 'animation';
+    update(world, dt) {
+        const animations = world.getPool(POOL_ANIMATION);
+        const sprites = world.getPool(POOL_SPRITE);
+        if (!animations || !sprites)
+            return;
+        // dt is seconds; manifests work in milliseconds.
+        const dtMs = dt * 1000;
+        const hwm = animations.getHighWaterMark();
+        for (let i = 1; i < hwm; i++) { // index 0 reserved for NULL
+            const flags = animations.flags[i] ?? 0;
+            if ((flags & ANIMATION_FLAG_ACTIVE) === 0)
+                continue;
+            const manifest = animations.manifest[i];
+            const clipName = animations.clipName[i] ?? '';
+            if (!manifest || !clipName)
+                continue;
+            const clip = findClip(manifest.clips, clipName);
+            if (!clip)
+                continue;
+            const prevElapsed = animations.elapsedMs[i] ?? 0;
+            const nextElapsed = prevElapsed + dtMs;
+            if (clip.loop) {
+                animations.elapsedMs[i] = nextElapsed;
+            }
+            else {
+                // Non-looping: clamp at total duration so subsequent ticks
+                // keep returning the last frame, and set FINISHED once we
+                // cross the boundary.
+                const total = clipDurationMs(clip, manifest.fps);
+                if (nextElapsed >= total && total > 0) {
+                    animations.elapsedMs[i] = total;
+                    animations.flags[i] = (flags | ANIMATION_FLAG_FINISHED);
+                }
+                else {
+                    animations.elapsedMs[i] = nextElapsed;
+                }
+            }
+            const frameInClip = frameInClipAt(clip, animations.elapsedMs[i] ?? 0, manifest.fps);
+            const sheetFrame = manifestFrameIndex(clip, frameInClip);
+            // SpritePool indexes per entity index, same shape; we can
+            // write directly without going through setFrame for fewer
+            // function calls in the hot loop.
+            if (i < sprites.frame.length) {
+                sprites.frame[i] = sheetFrame;
+            }
+        }
+    }
+}
+//# sourceMappingURL=animation-system.js.map

package/dist/systems/animation-system.js.map

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

package/dist/systems/attack-system.d.ts

@@ -0,0 +1,17 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+import { type EntityId } from '../entity.js';
+export interface AttackSystemOptions {
+    damage: number;
+    range: number;
+    player: EntityId;
+}
+export declare class AttackSystem implements System {
+    private opts;
+    readonly name: string;
+    lastTargetIndex: number;
+    lastDamageApplied: number;
+    constructor(opts: AttackSystemOptions);
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=attack-system.d.ts.map

package/dist/systems/attack-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attack-system.d.ts","sourceRoot":"","sources":["../../src/systems/attack-system.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAazC,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,cAAc,CAAC;AAIzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,qBAAa,YAAa,YAAW,MAAM;IAM7B,OAAO,CAAC,IAAI;IALxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAY;IAEjC,eAAe,EAAE,MAAM,CAAM;IAC7B,iBAAiB,EAAE,MAAM,CAAK;gBAEV,IAAI,EAAE,mBAAmB;IAE7C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAsDxC"}

package/dist/systems/attack-system.js

@@ -0,0 +1,94 @@
+// AttackSystem - reads input + camera + transforms and applies
+// damage to the entity nearest the click point. Phase 7's minimum
+// player attack.
+//
+// For Phase 7's combat slice, this is intentionally simple:
+//   - Click anywhere -> damage the nearest pursuing entity
+//   - Damage amount is a constructor parameter
+//   - Range is a constructor parameter (max world distance from
+//     click)
+//
+// Real Survivor combat will replace this with a per-skill router:
+//   - Different click positions = different skills
+//   - Skills have cooldowns, projectiles, AoE patterns
+//   - Knot-context modifies damage type
+// All of which fit the engine's existing surface (TimeResource for
+// cooldowns, ParticleEmitterPool for projectiles, KnotContextResource
+// for damage tinting). For Phase 7's first slice we ship the simplest
+// working attack.
+import { POOL_TRANSFORM } from '../world.js';
+import { POOL_HEALTH } from '../components/health.js';
+import { POOL_PURSUE } from '../components/pursue.js';
+import { RESOURCE_INPUT, } from '../input/input-manager.js';
+import { RESOURCE_CAMERA } from '../resources.js';
+import { isoToTile } from '../renderer/iso-projection.js';
+import { vec2 } from '../util/math.js';
+import { makeEntity } from '../entity.js';
+const SCRATCH_TILE = vec2(0, 0);
+export class AttackSystem {
+    opts;
+    name = 'attack';
+    // Last entity damaged this tick (for VFX hooks). -1 if no hit.
+    lastTargetIndex = -1;
+    lastDamageApplied = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    update(world, _dt) {
+        const input = world.resources.get(RESOURCE_INPUT);
+        const camera = world.resources.get(RESOURCE_CAMERA);
+        if (!input || !camera)
+            return;
+        const transforms = world.getPool(POOL_TRANSFORM);
+        const health = world.getPool(POOL_HEALTH);
+        const pursuit = world.getPool(POOL_PURSUE);
+        if (!transforms || !health || !pursuit)
+            return;
+        this.lastTargetIndex = -1;
+        this.lastDamageApplied = 0;
+        // Only react to a fresh primary-button click.
+        const leftClicked = (input.pointerPressedThisFrame & 1) !== 0;
+        if (!leftClicked)
+            return;
+        // Convert click pixel coords -> world iso -> tile.
+        const worldIsoX = (input.pointer.x - camera.viewportWidth / 2) / camera.zoom + camera.centerX;
+        const worldIsoY = (input.pointer.y - camera.viewportHeight / 2) / camera.zoom + camera.centerY;
+        isoToTile(worldIsoX, worldIsoY, SCRATCH_TILE);
+        const clickTileX = SCRATCH_TILE.x;
+        const clickTileY = SCRATCH_TILE.y;
+        // Find the nearest pursuer (i.e. enemy) within range.
+        const playerIdx = this.opts.player & 0x00ffffff;
+        const hwm = pursuit.getHighWaterMark();
+        let bestIdx = -1;
+        let bestDist = this.opts.range;
+        for (let i = 1; i < hwm; i++) {
+            if (i === playerIdx)
+                continue; // never damage the player via this attack
+            const f = pursuit.flags[i] ?? 0;
+            if ((f & 1) === 0)
+                continue; // PURSUE_FLAG_ACTIVE
+            // Only attack live entities.
+            if (health.isDead(makeEntity(i, 0)))
+                continue;
+            const tx = transforms.x[i] ?? 0;
+            const ty = transforms.y[i] ?? 0;
+            const dx = tx - clickTileX;
+            const dy = ty - clickTileY;
+            const d = Math.sqrt(dx * dx + dy * dy);
+            if (d < bestDist) {
+                bestDist = d;
+                bestIdx = i;
+            }
+        }
+        if (bestIdx < 0)
+            return;
+        const target = makeEntity(bestIdx, 0);
+        const now = typeof performance !== 'undefined' ? performance.now() : 0;
+        const applied = health.applyDamage(target, this.opts.damage, now);
+        if (applied > 0) {
+            this.lastTargetIndex = bestIdx;
+            this.lastDamageApplied = applied;
+        }
+    }
+}
+//# sourceMappingURL=attack-system.js.map

package/dist/systems/attack-system.js.map

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

package/dist/systems/damage-system.d.ts

@@ -0,0 +1,18 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export interface KillEvent {
+    entityIndex: number;
+    killerIndex: number | null;
+    atMs: number;
+}
+export declare class DeathLog {
+    recent: KillEvent[];
+    totalKills: number;
+    static readonly MAX_KILLS = 64;
+}
+export declare const RESOURCE_DEATH_LOG = "death_log";
+export declare class DamageSystem implements System {
+    readonly name: string;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=damage-system.d.ts.map

package/dist/systems/damage-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"damage-system.d.ts","sourceRoot":"","sources":["../../src/systems/damage-system.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAazC,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,QAAQ;IAEnB,MAAM,EAAE,SAAS,EAAE,CAAM;IACzB,UAAU,EAAE,MAAM,CAAK;IACvB,MAAM,CAAC,QAAQ,CAAC,SAAS,MAAM;CAChC;AAED,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAY;IAEjC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAiDxC"}

package/dist/systems/damage-system.js

@@ -0,0 +1,77 @@
+// DamageSystem - sweeps the HealthPool each tick, removes dead
+// entities (clears their Sprite + Transform components and destroys
+// the entity handle).
+//
+// Death pipeline:
+//   1. AttackSystem (or any gameplay code) calls health.applyDamage
+//   2. If HP drops to 0, HEALTH_FLAG_DEAD is set on the pool
+//   3. DamageSystem next tick walks the pool, sees DEAD flag,
+//      detaches Sprite + Transform + Health + Animation +
+//      Emitter components, destroys the entity
+//   4. Optional consumers can listen to the event log for kill
+//      notifications (Phase 7+ adds a kill-event ring buffer)
+//
+// Runs in PHASE_LOGIC, after AttackSystem + PursueSystem so this
+// frame's damage events have been resolved before cleanup.
+import { POOL_HEALTH, HEALTH_FLAG_ACTIVE, HEALTH_FLAG_DEAD } from '../components/health.js';
+import { POOL_TRANSFORM, POOL_SPRITE } from '../world.js';
+import { POOL_EMITTER } from './particle-emitter-system.js';
+import { POOL_ANIMATION } from './animation-system.js';
+import { makeEntity } from '../entity.js';
+export class DeathLog {
+    // Newest first. Capped at MAX_KILLS to bound memory.
+    recent = [];
+    totalKills = 0;
+    static MAX_KILLS = 64;
+}
+export const RESOURCE_DEATH_LOG = 'death_log';
+export class DamageSystem {
+    name = 'damage';
+    update(world, _dt) {
+        const health = world.getPool(POOL_HEALTH);
+        if (!health)
+            return;
+        const transforms = world.getPool(POOL_TRANSFORM);
+        const sprites = world.getPool(POOL_SPRITE);
+        const emitters = world.getPool(POOL_EMITTER);
+        const animations = world.getPool(POOL_ANIMATION);
+        const deathLog = world.resources.get(RESOURCE_DEATH_LOG);
+        const hwm = health.getHighWaterMark();
+        const now = typeof performance !== 'undefined' ? performance.now() : 0;
+        for (let i = 1; i < hwm; i++) {
+            const f = health.flags[i] ?? 0;
+            if ((f & HEALTH_FLAG_ACTIVE) === 0)
+                continue;
+            if ((f & HEALTH_FLAG_DEAD) === 0)
+                continue;
+            // Reconstruct an EntityId for the index. Generation isn't
+            // material here because the pools all store by index and the
+            // entity allocator's destroy will bump the generation.
+            const e = makeEntity(i, 0);
+            // Detach everything we know about. Pool detach is idempotent
+            // and bounds-checked, so unknown components are no-ops.
+            health.detach(e);
+            transforms?.detach(e);
+            sprites?.detach(e);
+            emitters?.detach(e);
+            animations?.stop(e);
+            // Destroy the entity allocator slot. The slot returns to the
+            // free list and a future create() will recycle it. The
+            // generation bump invalidates any stale handles still held
+            // by gameplay code.
+            world.destroyEntity(e);
+            // Record the kill in the log. Killer attribution is gameplay-
+            // specific and not tracked here; AttackSystem can extend the
+            // log with killer info when it deals lethal damage.
+            if (deathLog) {
+                const ev = { entityIndex: i, killerIndex: null, atMs: now };
+                deathLog.recent.unshift(ev);
+                if (deathLog.recent.length > DeathLog.MAX_KILLS) {
+                    deathLog.recent.length = DeathLog.MAX_KILLS;
+                }
+                deathLog.totalKills++;
+            }
+        }
+    }
+}
+//# sourceMappingURL=damage-system.js.map

package/dist/systems/damage-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"damage-system.js","sourceRoot":"","sources":["../../src/systems/damage-system.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oEAAoE;AACpE,sBAAsB;AACtB,EAAE;AACF,kBAAkB;AAClB,oEAAoE;AACpE,6DAA6D;AAC7D,8DAA8D;AAC9D,0DAA0D;AAC1D,+CAA+C;AAC/C,+DAA+D;AAC/D,8DAA8D;AAC9D,EAAE;AACF,iEAAiE;AACjE,2DAA2D;AAI3D,OAAO,EAAc,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKxG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU1C,MAAM,OAAO,QAAQ;IACnB,qDAAqD;IACrD,MAAM,GAAgB,EAAE,CAAC;IACzB,UAAU,GAAW,CAAC,CAAC;IACvB,MAAM,CAAU,SAAS,GAAG,EAAE,CAAC;;AAGjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE9C,MAAM,OAAO,YAAY;IACd,IAAI,GAAW,QAAQ,CAAC;IAEjC,MAAM,CAAC,KAAY,EAAE,GAAW;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAa,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAgB,cAAc,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAa,WAAW,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAsB,YAAY,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAqB,cAAc,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAW,kBAAkB,CAAC,CAAC;QAEnE,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC7C,IAAI,CAAC,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE3C,0DAA0D;YAC1D,6DAA6D;YAC7D,uDAAuD;YACvD,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAE3B,6DAA6D;YAC7D,wDAAwD;YACxD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAEpB,6DAA6D;YAC7D,uDAAuD;YACvD,2DAA2D;YAC3D,oBAAoB;YACpB,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAEvB,8DAA8D;YAC9D,6DAA6D;YAC7D,oDAAoD;YACpD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,EAAE,GAAc,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBACvE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC5B,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;oBAChD,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;gBAC9C,CAAC;gBACD,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/systems/input-system.d.ts

@@ -0,0 +1,7 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+export declare class InputSystem implements System {
+    readonly name: string;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=input-system.d.ts.map

package/dist/systems/input-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-system.d.ts","sourceRoot":"","sources":["../../src/systems/input-system.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,qBAAa,WAAY,YAAW,MAAM;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAW;IAEhC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAMxC"}