@sadhaka/loom-engine 0.10.0

package/dist/world.d.ts

@@ -0,0 +1,23 @@
+import { EntityAllocator, type EntityId } from './entity.js';
+import { ResourceRegistry } from './resources.js';
+import { type System, type SystemPhase } from './system.js';
+export declare class World {
+    readonly entities: EntityAllocator;
+    readonly resources: ResourceRegistry;
+    private pools;
+    private systemsByPhase;
+    constructor();
+    registerPool<T>(key: string, pool: T): void;
+    getPool<T>(key: string): T | undefined;
+    requirePool<T>(key: string): T;
+    addSystem(system: System, phase?: SystemPhase): void;
+    update(dt: number): void;
+    countEntities(): number;
+    countSystems(): number;
+    countSystemsInPhase(phase: SystemPhase): number;
+    createEntity(): EntityId;
+    destroyEntity(e: EntityId): boolean;
+}
+export declare const POOL_TRANSFORM = "transform";
+export declare const POOL_SPRITE = "sprite";
+//# sourceMappingURL=world.d.ts.map

package/dist/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,KAAK,MAAM,EACX,KAAK,WAAW,EAGjB,MAAM,aAAa,CAAC;AAErB,qBAAa,KAAK;IAChB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAKrC,OAAO,CAAC,KAAK,CAAmC;IAIhD,OAAO,CAAC,cAAc,CAAyC;;IAY/D,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI3C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAItC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAU9B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgC,GAAG,IAAI;IAUxE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWxB,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,MAAM;IAQtB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAK/C,YAAY,IAAI,QAAQ;IAIxB,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;CAGpC;AAKD,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,WAAW,WAAW,CAAC"}

package/dist/world.js

@@ -0,0 +1,101 @@
+// World - the ECS container for the Loom Engine.
+//
+// Holds:
+//   - EntityAllocator: 32-bit handle allocator
+//   - Component pools: registered by string key, opaque to the world
+//   - Systems: ordered by phase, run in registration order within
+//     a phase
+//   - Resources: singleton state (Time, Camera, Device, Input, RNG)
+//
+// Systems read/write pools + resources directly. The world doesn't
+// dispatch queries; systems are responsible for knowing which pools
+// they need.
+//
+// Inspiration:
+//   - PlayCanvas ECS shape (component-pool registration pattern)
+//   - Bevy ECS scheduling (Resource pattern, phase ordering)
+// See PRIOR-ART.md.
+import { EntityAllocator } from './entity.js';
+import { ResourceRegistry } from './resources.js';
+import { SYSTEM_PHASE_LOGIC, SYSTEM_PHASES_IN_ORDER, } from './system.js';
+export class World {
+    entities;
+    resources;
+    // Component pools registered by string key. Opaque - the world
+    // never inspects them, just stores + hands back. Systems know what
+    // type each pool is (TransformPool, SpritePool, etc.).
+    pools = new Map();
+    // Systems indexed by phase. Within a phase, registration order is
+    // preserved (Map iteration is insertion-ordered for string keys).
+    systemsByPhase = new Map();
+    constructor() {
+        this.entities = new EntityAllocator();
+        this.resources = new ResourceRegistry();
+        for (const phase of SYSTEM_PHASES_IN_ORDER) {
+            this.systemsByPhase.set(phase, []);
+        }
+    }
+    // Component pool registration. The pool is whatever the caller
+    // passes; the world is just a typed Map under the hood.
+    registerPool(key, pool) {
+        this.pools.set(key, pool);
+    }
+    getPool(key) {
+        return this.pools.get(key);
+    }
+    requirePool(key) {
+        const v = this.pools.get(key);
+        if (v === undefined) {
+            throw new Error('World: required pool "' + key + '" not registered');
+        }
+        return v;
+    }
+    // System registration. Default phase is LOGIC; render systems
+    // pass SYSTEM_PHASE_RENDER explicitly.
+    addSystem(system, phase = SYSTEM_PHASE_LOGIC) {
+        const list = this.systemsByPhase.get(phase);
+        if (!list) {
+            // Phase not in SYSTEM_PHASES_IN_ORDER - guard rail.
+            throw new Error('World: unknown system phase ' + phase);
+        }
+        list.push(system);
+    }
+    // Run all systems in phase order. dt is seconds-since-last-tick.
+    update(dt) {
+        for (const phase of SYSTEM_PHASES_IN_ORDER) {
+            const list = this.systemsByPhase.get(phase);
+            if (!list)
+                continue;
+            for (const sys of list) {
+                sys.update(this, dt);
+            }
+        }
+    }
+    // Diagnostics.
+    countEntities() {
+        return this.entities.count();
+    }
+    countSystems() {
+        let total = 0;
+        for (const list of this.systemsByPhase.values()) {
+            total += list.length;
+        }
+        return total;
+    }
+    countSystemsInPhase(phase) {
+        return this.systemsByPhase.get(phase)?.length ?? 0;
+    }
+    // Convenience passthrough for the most common operation.
+    createEntity() {
+        return this.entities.create();
+    }
+    destroyEntity(e) {
+        return this.entities.destroy(e);
+    }
+}
+// Conventional pool keys. Systems and components use these to find
+// each other so a pool registered as POOL_TRANSFORM is discoverable
+// by any system that needs transforms.
+export const POOL_TRANSFORM = 'transform';
+export const POOL_SPRITE = 'sprite';
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

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

package/dist/zone/zone-catalog.d.ts

@@ -0,0 +1,17 @@
+import type { ZoneId } from './zone-state.js';
+import type { ColorRGBA } from '../util/color.js';
+export interface ZoneTilePalette {
+    fill: Readonly<ColorRGBA>;
+    stroke: Readonly<ColorRGBA>;
+    highlight: Readonly<ColorRGBA>;
+}
+export interface ZoneCatalogEntry {
+    id: ZoneId;
+    name: string;
+    knot: 'str' | 'dex' | 'int' | 'mixed' | 'center';
+    palette: ZoneTilePalette;
+    musicLevel: number;
+    exits: ReadonlyArray<ZoneId>;
+}
+export declare const ZONE_CATALOG: Record<ZoneId, ZoneCatalogEntry>;
+//# sourceMappingURL=zone-catalog.d.ts.map

package/dist/zone/zone-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-catalog.d.ts","sourceRoot":"","sources":["../../src/zone/zone-catalog.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE1B,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE5B,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAIb,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAGjD,OAAO,EAAE,eAAe,CAAC;IAGzB,UAAU,EAAE,MAAM,CAAC;IAGnB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAiGzD,CAAC"}

package/dist/zone/zone-catalog.js

@@ -0,0 +1,116 @@
+// ZoneCatalog - data table of zone configurations.
+//
+// Each zone entry describes the rendering hints (tile palette, mood,
+// ambient audio bus level), the NPCs that live there, and the
+// connections to other zones. Phase 8 v1 ships 2 zones:
+//
+//   lastlight_plaza   - Act 1 convergence hub. Misha Dev greets the
+//                       player. Portal connects to iron_reach.
+//   iron_reach        - Strknot starter zone. Forge-city aesthetic,
+//                       smoke-stained stone palette, no NPCs in v1
+//                       beyond the return portal back to Plaza.
+//
+// Per LOOM-CLASS-SYSTEM-SPEC Section 3, the other 5 knot zones
+// (saltsprig, the_archive, hammerwash, crystwell, forge_archive,
+// centerknot_crossroads) get their own entries in subsequent
+// sessions as the spec ships them.
+import { hexToRgba } from '../util/color.js';
+export const ZONE_CATALOG = {
+    lastlight_plaza: {
+        id: 'lastlight_plaza',
+        name: 'Lastlight Plaza',
+        knot: 'center',
+        palette: {
+            fill: hexToRgba(0x3a3a4e), // muted lavender-grey stone
+            stroke: hexToRgba(0x6a6a8a),
+            highlight: hexToRgba(0x9a9aba),
+        },
+        musicLevel: 0.6,
+        exits: ['iron_reach'],
+    },
+    iron_reach: {
+        id: 'iron_reach',
+        name: 'Iron Reach',
+        knot: 'str',
+        palette: {
+            fill: hexToRgba(0x4a2418), // smoke-stained brick
+            stroke: hexToRgba(0x804020),
+            highlight: hexToRgba(0xc06030),
+        },
+        musicLevel: 0.9,
+        exits: ['lastlight_plaza'],
+    },
+    saltsprig: {
+        id: 'saltsprig',
+        name: 'Saltsprig',
+        knot: 'dex',
+        palette: {
+            fill: hexToRgba(0x1a4a52),
+            stroke: hexToRgba(0x2a8c95),
+            highlight: hexToRgba(0x5ac9d6),
+        },
+        musicLevel: 0.7,
+        exits: ['lastlight_plaza'],
+    },
+    the_archive: {
+        id: 'the_archive',
+        name: 'The Archive',
+        knot: 'int',
+        palette: {
+            fill: hexToRgba(0x2a1a3a),
+            stroke: hexToRgba(0x603b91),
+            highlight: hexToRgba(0x9b5de5),
+        },
+        musicLevel: 0.5,
+        exits: ['lastlight_plaza'],
+    },
+    hammerwash: {
+        id: 'hammerwash',
+        name: 'Hammerwash',
+        knot: 'mixed',
+        palette: {
+            fill: hexToRgba(0x3a3030),
+            stroke: hexToRgba(0x5a4040),
+            highlight: hexToRgba(0xa07060),
+        },
+        musicLevel: 0.8,
+        exits: ['lastlight_plaza'],
+    },
+    crystwell: {
+        id: 'crystwell',
+        name: 'Crystwell',
+        knot: 'mixed',
+        palette: {
+            fill: hexToRgba(0x1a3a4a),
+            stroke: hexToRgba(0x456080),
+            highlight: hexToRgba(0x80a0c8),
+        },
+        musicLevel: 0.7,
+        exits: ['lastlight_plaza'],
+    },
+    forge_archive: {
+        id: 'forge_archive',
+        name: 'Forge-Archive',
+        knot: 'mixed',
+        palette: {
+            fill: hexToRgba(0x3a2030),
+            stroke: hexToRgba(0x6b3050),
+            highlight: hexToRgba(0xa86090),
+        },
+        musicLevel: 0.7,
+        exits: ['lastlight_plaza'],
+    },
+    centerknot_crossroads: {
+        id: 'centerknot_crossroads',
+        name: 'Centerknot Crossroads',
+        knot: 'center',
+        palette: {
+            fill: hexToRgba(0x2a2a30),
+            stroke: hexToRgba(0x6a6a40),
+            highlight: hexToRgba(0xffd86a),
+        },
+        musicLevel: 0.6,
+        exits: ['lastlight_plaza'],
+    },
+};
+//# sourceMappingURL=zone-catalog.js.map

package/dist/zone/zone-catalog.js.map

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

package/dist/zone/zone-state.d.ts

@@ -0,0 +1,18 @@
+export type ZoneId = 'lastlight_plaza' | 'iron_reach' | 'saltsprig' | 'the_archive' | 'hammerwash' | 'crystwell' | 'forge_archive' | 'centerknot_crossroads';
+export type TransitionKind = 'walk' | 'portal' | 'cinematic' | 'instant';
+export interface ZoneStateResource {
+    activeZoneId: ZoneId;
+    transition: {
+        fromZoneId: ZoneId;
+        toZoneId: ZoneId;
+        kind: TransitionKind;
+        startMs: number;
+        durationMs: number;
+    } | null;
+}
+export declare function createZoneState(initial?: ZoneId): ZoneStateResource;
+export declare function beginTransition(state: ZoneStateResource, toZoneId: ZoneId, kind: TransitionKind, durationMs: number, nowMs: number): boolean;
+export declare function tickTransition(state: ZoneStateResource, nowMs: number): number;
+export declare function isTransitioning(state: ZoneStateResource): boolean;
+export declare const RESOURCE_ZONE_STATE = "zone_state";
+//# sourceMappingURL=zone-state.d.ts.map

package/dist/zone/zone-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-state.d.ts","sourceRoot":"","sources":["../../src/zone/zone-state.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,MAAM,GACd,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,aAAa,GACb,YAAY,GACZ,WAAW,GACX,eAAe,GACf,uBAAuB,CAAC;AAE5B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAEhC,YAAY,EAAE,MAAM,CAAC;IAGrB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;CACV;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAA0B,GAAG,iBAAiB,CAKtF;AAID,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAUT;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAEjE;AAED,eAAO,MAAM,mBAAmB,eAAe,CAAC"}

package/dist/zone/zone-state.js

@@ -0,0 +1,52 @@
+// ZoneState - resource tracking the active zone + transition state.
+//
+// Per LOOM-CLASS-SYSTEM-SPEC Section 3 the v1 ARPG ships with 7
+// knot zones plus the Lastlight Plaza hub. The renderer holds one
+// ZoneState resource that names the current zone and any in-progress
+// transition. ZoneSystem applies scene.transition events from the
+// Director (or local triggers in the demo) to mutate this resource.
+//
+// Render systems read activeZoneId to pick the appropriate tile
+// atlas / palette / ambient audio. The Director-bridge populates
+// scene.transition events when the player crosses portals.
+export function createZoneState(initial = 'lastlight_plaza') {
+    return {
+        activeZoneId: initial,
+        transition: null,
+    };
+}
+// Begin a zone transition. Idempotent against the current zone (no-
+// op if the from and to are the same).
+export function beginTransition(state, toZoneId, kind, durationMs, nowMs) {
+    if (state.activeZoneId === toZoneId)
+        return false;
+    state.transition = {
+        fromZoneId: state.activeZoneId,
+        toZoneId,
+        kind,
+        startMs: nowMs,
+        durationMs: Math.max(1, durationMs),
+    };
+    return true;
+}
+// Tick the active transition. When the duration elapses, set
+// activeZoneId to the target and clear the transition. Returns the
+// transition progress in [0, 1] for renderer fades, or -1 if no
+// transition is active.
+export function tickTransition(state, nowMs) {
+    if (!state.transition)
+        return -1;
+    const t = state.transition;
+    const elapsed = nowMs - t.startMs;
+    if (elapsed >= t.durationMs) {
+        state.activeZoneId = t.toZoneId;
+        state.transition = null;
+        return 1;
+    }
+    return Math.max(0, elapsed / t.durationMs);
+}
+export function isTransitioning(state) {
+    return state.transition !== null;
+}
+export const RESOURCE_ZONE_STATE = 'zone_state';
+//# sourceMappingURL=zone-state.js.map

package/dist/zone/zone-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-state.js","sourceRoot":"","sources":["../../src/zone/zone-state.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,gEAAgE;AAChE,kEAAkE;AAClE,qEAAqE;AACrE,kEAAkE;AAClE,oEAAoE;AACpE,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,2DAA2D;AA4B3D,MAAM,UAAU,eAAe,CAAC,UAAkB,iBAAiB;IACjE,OAAO;QACL,YAAY,EAAE,OAAO;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,uCAAuC;AACvC,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,QAAgB,EAChB,IAAoB,EACpB,UAAkB,EAClB,KAAa;IAEb,IAAI,KAAK,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,KAAK,CAAC,UAAU,GAAG;QACjB,UAAU,EAAE,KAAK,CAAC,YAAY;QAC9B,QAAQ;QACR,IAAI;QACJ,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC;KACpC,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6DAA6D;AAC7D,mEAAmE;AACnE,gEAAgE;AAChE,wBAAwB;AACxB,MAAM,UAAU,cAAc,CAAC,KAAwB,EAAE,KAAa;IACpE,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;IAC3B,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC;IAClC,IAAI,OAAO,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5B,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC;QAChC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,OAAO,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@sadhaka/loom-engine",
+  "version": "0.10.0",
+  "description": "Browser-first 2D / 2.5D game engine. Canvas2D, ECS, render-graph stages, Director-bridge SSE integration. Built from scratch in TypeScript for TheWorldTable.ai.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "game-engine",
+    "ecs",
+    "browser",
+    "typescript",
+    "isometric",
+    "sse",
+    "director-events"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sadhaka/loom-engine"
+  },
+  "homepage": "https://loom-engine.pages.dev/",
+  "bugs": {
+    "url": "https://github.com/sadhaka/loom-engine/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:demo": "tsc -p tsconfig.demo.json",
+    "build:all": "npm run build && npm run build:demo",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist demo/*.js demo/*.js.map",
+    "test": "tsx --test tests/smoke.test.ts tests/world.test.ts tests/asset-loader.test.ts tests/animation.test.ts tests/vfx.test.ts tests/audio-input.test.ts tests/director.test.ts tests/combat.test.ts tests/projectile.test.ts tests/arpg.test.ts tests/snapshot-recovery.test.ts tests/touch-input.test.ts",
+    "docs": "typedoc",
+    "docs:ci": "typedoc --out docs-build --cleanOutputDir",
+    "prepublishOnly": "npm test && npm run build"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.11.0",
+    "typescript": "^5.4.0"
+  },
+  "license": "MIT",
+  "author": "Misha Mitiev"
+}