@alife-sdk/core 0.1.0

package/dist/ports/IDataLoader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Async-capable loader that supplies game data to the kernel at boot time.
+ *
+ * Each method may return data synchronously (from an in-memory object)
+ * or as a Promise (from a network/file request). The kernel awaits all
+ * results before populating registries.
+ *
+ * Returned objects are keyed by ID string. Each value should conform to
+ * the matching registry definition interface — see the `registry/` module.
+ */
+import type { IFactionDefinition } from '../registry/FactionRegistry';
+import type { INPCTypeDefinition } from '../registry/NPCTypeRegistry';
+import type { IMonsterDefinition } from '../registry/MonsterRegistry';
+import type { ISmartTerrainConfig } from '../terrain/SmartTerrain';
+import type { IAnomalyTypeDefinition } from '../registry/AnomalyTypeRegistry';
+/** Map of factionId → IFactionDefinition. */
+export type IFactionDataFile = Record<string, IFactionDefinition>;
+/** Map of npcTypeId → INPCTypeDefinition. */
+export type INPCTypeDataFile = Record<string, INPCTypeDefinition>;
+/** Map of monsterTypeId → IMonsterDefinition. */
+export type IMonsterDataFile = Record<string, IMonsterDefinition>;
+/** Map of terrainId → ISmartTerrainConfig. */
+export type ITerrainDataFile = Record<string, ISmartTerrainConfig>;
+/** Map of anomalyTypeId → IAnomalyTypeDefinition. */
+export type IAnomalyDataFile = Record<string, IAnomalyTypeDefinition>;
+export interface IDataLoader {
+    /** Load faction definitions. Keys = faction IDs, values = IFactionDefinition. */
+    loadFactions(): IFactionDataFile | Promise<IFactionDataFile>;
+    /** Load NPC type definitions. Keys = NPC type IDs, values = INPCTypeDefinition. */
+    loadNPCTypes(): INPCTypeDataFile | Promise<INPCTypeDataFile>;
+    /** Load monster definitions. Keys = monster type IDs, values = IMonsterDefinition. */
+    loadMonsters(): IMonsterDataFile | Promise<IMonsterDataFile>;
+    /** Load smart terrain configurations. Keys = terrain IDs, values = ISmartTerrainConfig. */
+    loadTerrains(): ITerrainDataFile | Promise<ITerrainDataFile>;
+    /** Load anomaly type definitions. Keys = anomaly type IDs, values = IAnomalyTypeDefinition. */
+    loadAnomalies(): IAnomalyDataFile | Promise<IAnomalyDataFile>;
+}
+//# sourceMappingURL=IDataLoader.d.ts.map

package/dist/ports/IDataLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDataLoader.d.ts","sourceRoot":"","sources":["../../src/ports/IDataLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAElE,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAElE,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAElE,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEnE,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,YAAY,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7D,mFAAmF;IACnF,YAAY,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7D,sFAAsF;IACtF,YAAY,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7D,2FAA2F;IAC3F,YAAY,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7D,+FAA+F;IAC/F,aAAa,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D"}

package/dist/ports/IDataLoader.js

@@ -0,0 +1,12 @@
+/**
+ * Async-capable loader that supplies game data to the kernel at boot time.
+ *
+ * Each method may return data synchronously (from an in-memory object)
+ * or as a Promise (from a network/file request). The kernel awaits all
+ * results before populating registries.
+ *
+ * Returned objects are keyed by ID string. Each value should conform to
+ * the matching registry definition interface — see the `registry/` module.
+ */
+export {};
+//# sourceMappingURL=IDataLoader.js.map

package/dist/ports/IDataLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDataLoader.js","sourceRoot":"","sources":["../../src/ports/IDataLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/ports/IEntityAdapter.d.ts

@@ -0,0 +1,73 @@
+import type { Vec2 } from '../core/Vec2';
+/** Read-only queries on entity state. No side effects. */
+export interface IEntityQuery {
+    /** Return world position (px), or `null` if entity no longer exists. */
+    getPosition(entityId: string): Vec2 | null;
+    /** Return `true` if entity exists and is alive. */
+    isAlive(entityId: string): boolean;
+    /** Check if entity has the named component. */
+    hasComponent(entityId: string, componentName: string): boolean;
+    /** Read a component value. Returns `null` if missing. */
+    getComponentValue<T>(entityId: string, componentName: string): T | null;
+    /** Read arbitrary metadata. Optional — return `undefined` when unsupported. */
+    getMetadata?(entityId: string, key: string): unknown;
+}
+/** Mutate entity state: position, velocity, rotation, visibility, activity. */
+export interface IEntityMutation {
+    /** Move entity to world coordinates (px). */
+    setPosition(entityId: string, position: Vec2): void;
+    /** Enable/disable entity. Inactive entities skip physics and rendering. */
+    setActive(entityId: string, active: boolean): void;
+    /** Show/hide entity. Separate from active (e.g. stealth = active + invisible). */
+    setVisible(entityId: string, visible: boolean): void;
+    /** Write arbitrary metadata. Optional — no-op when unsupported. */
+    setMetadata?(entityId: string, key: string, value: unknown): void;
+    /** Set physics velocity (px/s). FSM guarantees single-writer per entity/frame. */
+    setVelocity(entityId: string, velocity: Vec2): void;
+    /** Current physics velocity. Returns {x:0,y:0} for unknown IDs. */
+    getVelocity(entityId: string): Vec2;
+    /** Set facing rotation (radians, clockwise from +X). */
+    setRotation(entityId: string, radians: number): void;
+    /** Teleport entity instantly — bypasses physics interpolation. */
+    teleport(entityId: string, position: Vec2): void;
+    /** Disable physics body (corpses, death state). */
+    disablePhysics(entityId: string): void;
+}
+/** Rendering operations. Only needed by online AI, not by offline simulation. */
+export interface IEntityRendering {
+    /** Set transparency (0=invisible, 1=opaque). For stealth mechanics. */
+    setAlpha(entityId: string, alpha: number): void;
+    /** Play a named animation. When `ignoreIfPlaying` is true (default), skip if already playing this key. */
+    playAnimation(entityId: string, key: string, ignoreIfPlaying?: boolean): void;
+    /** Check if animation key exists for this entity. */
+    hasAnimation(entityId: string, key: string): boolean;
+}
+/**
+ * Full bridge between SDK and host game engine.
+ *
+ * Consumers that only need read access can depend on {@link IEntityQuery}.
+ * Offline simulation needs {@link IEntityQuery} + {@link IEntityMutation}.
+ * Online AI needs all three.
+ */
+export interface IEntityAdapter extends IEntityQuery, IEntityMutation, IEntityRendering {
+}
+/** @deprecated Use IEntityRendering instead. */
+export type IEntityPresentation = IEntityRendering;
+/**
+ * Create a no-op {@link IEntityAdapter} with safe default behaviour.
+ *
+ * Safe defaults:
+ * - `getPosition` returns `null` — no world position.
+ * - `isAlive` returns `true` — all entities considered alive.
+ * - `hasComponent` returns `false` — no components present.
+ * - `getComponentValue` returns `null` — no component values.
+ * - `getVelocity` returns `{x:0,y:0}` — zero velocity.
+ * - `hasAnimation` returns `false` — no animations available.
+ * - All mutation/rendering methods are no-ops.
+ *
+ * @example
+ * // Unit-testing kernel logic without a full game engine:
+ * kernel.provide(Ports.EntityAdapter, createNoOpEntityAdapter());
+ */
+export declare function createNoOpEntityAdapter(): IEntityAdapter;
+//# sourceMappingURL=IEntityAdapter.d.ts.map

package/dist/ports/IEntityAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityAdapter.d.ts","sourceRoot":"","sources":["../../src/ports/IEntityAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMzC,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,mDAAmD;IACnD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,+CAA+C;IAC/C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,yDAAyD;IACzD,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IACxE,+EAA+E;IAC/E,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAMD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACpD,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,kFAAkF;IAClF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,mEAAmE;IACnE,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE,kFAAkF;IAClF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACpD,mEAAmE;IACnE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,wDAAwD;IACxD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACjD,mDAAmD;IACnD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAMD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,0GAA0G;IAC1G,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9E,qDAAqD;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY,EAAE,eAAe,EAAE,gBAAgB;CAAG;AAE1F,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAkBxD"}

package/dist/ports/IEntityAdapter.js

@@ -0,0 +1,36 @@
+/**
+ * Create a no-op {@link IEntityAdapter} with safe default behaviour.
+ *
+ * Safe defaults:
+ * - `getPosition` returns `null` — no world position.
+ * - `isAlive` returns `true` — all entities considered alive.
+ * - `hasComponent` returns `false` — no components present.
+ * - `getComponentValue` returns `null` — no component values.
+ * - `getVelocity` returns `{x:0,y:0}` — zero velocity.
+ * - `hasAnimation` returns `false` — no animations available.
+ * - All mutation/rendering methods are no-ops.
+ *
+ * @example
+ * // Unit-testing kernel logic without a full game engine:
+ * kernel.provide(Ports.EntityAdapter, createNoOpEntityAdapter());
+ */
+export function createNoOpEntityAdapter() {
+    return {
+        getPosition: () => null,
+        isAlive: () => true,
+        hasComponent: () => false,
+        getComponentValue: () => null,
+        setPosition: () => { },
+        setActive: () => { },
+        setVisible: () => { },
+        setVelocity: () => { },
+        getVelocity: () => ({ x: 0, y: 0 }),
+        setRotation: () => { },
+        teleport: () => { },
+        disablePhysics: () => { },
+        setAlpha: () => { },
+        playAnimation: () => { },
+        hasAnimation: () => false,
+    };
+}
+//# sourceMappingURL=IEntityAdapter.js.map

package/dist/ports/IEntityAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityAdapter.js","sourceRoot":"","sources":["../../src/ports/IEntityAdapter.ts"],"names":[],"mappings":"AA4EA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;QACzB,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI;QAC7B,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;QACrB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;QACnB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;QACpB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;QACrB,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;QACrB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;QACxB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;QACvB,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;KAC1B,CAAC;AACJ,CAAC"}

package/dist/ports/IEntityFactory.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Parameters for creating a humanoid NPC entity in the host game engine.
+ * Passed to {@link IEntityFactory.createNPC}.
+ */
+export interface INPCSpawnRequest {
+    /** ID registered in NPCTypeRegistry. */
+    readonly npcTypeId: string;
+    /** Faction this NPC belongs to. Must be registered in FactionRegistry. */
+    readonly factionId: string;
+    /** Spawn X world coordinate (px). */
+    readonly x: number;
+    /** Spawn Y world coordinate (px). */
+    readonly y: number;
+    /** NPC power tier (1–5). Affects equipment and behavior. */
+    readonly rank: number;
+    /** Squad this NPC should join, if any. */
+    readonly squadId?: string;
+    /** Arbitrary data forwarded to the host engine (e.g. story flags). */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Parameters for creating a monster entity in the host game engine.
+ * Passed to {@link IEntityFactory.createMonster}.
+ */
+export interface IMonsterSpawnRequest {
+    /** ID registered in MonsterRegistry. */
+    readonly monsterTypeId: string;
+    /** Spawn X world coordinate (px). */
+    readonly x: number;
+    /** Spawn Y world coordinate (px). */
+    readonly y: number;
+    /** SmartTerrain that serves as this monster's home lair. */
+    readonly lairTerrainId?: string;
+    /** Index within the pack (0 = leader). */
+    readonly packIndex?: number;
+    /** Arbitrary data forwarded to the host engine. */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Factory the A-Life kernel calls to create and destroy game entities.
+ *
+ * Implement this to bridge spawn/despawn requests to your engine's
+ * object creation system (e.g. Phaser's GameObjectFactory).
+ */
+export interface IEntityFactory {
+    /** Create a humanoid NPC. Must return a unique entity ID string. */
+    createNPC(request: INPCSpawnRequest): string;
+    /** Create a monster entity. Must return a unique entity ID string. */
+    createMonster(request: IMonsterSpawnRequest): string;
+    /** Remove the entity from the game world and release its resources. */
+    destroyEntity(entityId: string): void;
+}
+/**
+ * Create a no-op {@link IEntityFactory} that returns deterministic stub IDs.
+ *
+ * Safe defaults:
+ * - `createNPC` returns `"noop-npc-<n>"` — unique per call, never null.
+ * - `createMonster` returns `"noop-monster-<n>"` — unique per call.
+ * - `destroyEntity` is a no-op.
+ *
+ * @example
+ * // Unit-testing kernel logic without a full game engine:
+ * kernel.provide(Ports.EntityFactory, createNoOpEntityFactory());
+ */
+export declare function createNoOpEntityFactory(): IEntityFactory;
+//# sourceMappingURL=IEntityFactory.d.ts.map

package/dist/ports/IEntityFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityFactory.d.ts","sourceRoot":"","sources":["../../src/ports/IEntityFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAE7C,sEAAsE;IACtE,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC;IAErD,uEAAuE;IACvE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAMxD"}

package/dist/ports/IEntityFactory.js

@@ -0,0 +1,21 @@
+let _noOpFactoryId = 0;
+/**
+ * Create a no-op {@link IEntityFactory} that returns deterministic stub IDs.
+ *
+ * Safe defaults:
+ * - `createNPC` returns `"noop-npc-<n>"` — unique per call, never null.
+ * - `createMonster` returns `"noop-monster-<n>"` — unique per call.
+ * - `destroyEntity` is a no-op.
+ *
+ * @example
+ * // Unit-testing kernel logic without a full game engine:
+ * kernel.provide(Ports.EntityFactory, createNoOpEntityFactory());
+ */
+export function createNoOpEntityFactory() {
+    return {
+        createNPC: () => `noop-npc-${++_noOpFactoryId}`,
+        createMonster: () => `noop-monster-${++_noOpFactoryId}`,
+        destroyEntity: () => { },
+    };
+}
+//# sourceMappingURL=IEntityFactory.js.map

package/dist/ports/IEntityFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntityFactory.js","sourceRoot":"","sources":["../../src/ports/IEntityFactory.ts"],"names":[],"mappings":"AAyDA,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE;QAC/C,aAAa,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,cAAc,EAAE;QACvD,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;KACxB,CAAC;AACJ,CAAC"}

package/dist/ports/ILogger.d.ts

@@ -0,0 +1,29 @@
+import type { ILogEntry } from '../logger/ILogEntry';
+/**
+ * Sink that receives formatted log entries from the Logger.
+ *
+ * Implement to forward logs to the console, a file, a remote service,
+ * or an in-game debug overlay.
+ */
+export interface ILogOutput {
+    /** Handle a single log entry. Called synchronously by the Logger. */
+    write(entry: ILogEntry): void;
+}
+/**
+ * Logging facade consumed by the kernel and plugins.
+ *
+ * The built-in {@link Logger} class implements this. You can substitute
+ * your own implementation via IALifeKernelConfig.logger if you have
+ * an existing logging pipeline.
+ */
+export interface ILogger {
+    /** Log at DEBUG level. Use for high-volume diagnostic output. */
+    debug(channel: string, message: string, data?: unknown): void;
+    /** Log at INFO level. Use for lifecycle events (init, spawn, state change). */
+    info(channel: string, message: string, data?: unknown): void;
+    /** Log at WARN level. Use for recoverable problems (budget exceeded, missing data). */
+    warn(channel: string, message: string, data?: unknown): void;
+    /** Log at ERROR level. Use for unrecoverable errors. */
+    error(channel: string, message: string, data?: unknown): void;
+}
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/ports/ILogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.d.ts","sourceRoot":"","sources":["../../src/ports/ILogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,iEAAiE;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE9D,+EAA+E;IAC/E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE7D,uFAAuF;IACvF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE7D,wDAAwD;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/D"}

package/dist/ports/ILogger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ILogger.js.map

package/dist/ports/ILogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogger.js","sourceRoot":"","sources":["../../src/ports/ILogger.ts"],"names":[],"mappings":""}

package/dist/ports/IPlayerPositionProvider.d.ts

@@ -0,0 +1,20 @@
+import type { Vec2 } from '../core/Vec2';
+/**
+ * Provides the player's current world position to the A-Life kernel.
+ *
+ * The kernel reads this every tick for online/offline radius checks.
+ * Implement with a live reference to your player entity's coordinates.
+ */
+export interface IPlayerPositionProvider {
+    /** Return the player's current world position (px). Must never return null. */
+    getPlayerPosition(): Vec2;
+}
+/**
+ * Create a no-op {@link IPlayerPositionProvider} that always returns origin.
+ *
+ * @example
+ * // Unit-testing kernel logic without a game engine:
+ * kernel.provide(Ports.PlayerPosition, createNoOpPlayerPosition());
+ */
+export declare function createNoOpPlayerPosition(): IPlayerPositionProvider;
+//# sourceMappingURL=IPlayerPositionProvider.d.ts.map

package/dist/ports/IPlayerPositionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlayerPositionProvider.d.ts","sourceRoot":"","sources":["../../src/ports/IPlayerPositionProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,iBAAiB,IAAI,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,uBAAuB,CAElE"}

package/dist/ports/IPlayerPositionProvider.js

@@ -0,0 +1,11 @@
+/**
+ * Create a no-op {@link IPlayerPositionProvider} that always returns origin.
+ *
+ * @example
+ * // Unit-testing kernel logic without a game engine:
+ * kernel.provide(Ports.PlayerPosition, createNoOpPlayerPosition());
+ */
+export function createNoOpPlayerPosition() {
+    return { getPlayerPosition: () => ({ x: 0, y: 0 }) };
+}
+//# sourceMappingURL=IPlayerPositionProvider.js.map

package/dist/ports/IPlayerPositionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlayerPositionProvider.js","sourceRoot":"","sources":["../../src/ports/IPlayerPositionProvider.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/ports/IRandom.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Injectable random number generator port.
+ * Allows deterministic testing via SeededRandom while using Math.random() in production.
+ */
+export interface IRandom {
+    /** Return a pseudo-random float in [0, 1). */
+    next(): number;
+    /** Return a pseudo-random integer in [min, max] (inclusive). */
+    nextInt(min: number, max: number): number;
+    /** Return a pseudo-random float in [min, max). */
+    nextFloat(min: number, max: number): number;
+}
+export declare class DefaultRandom implements IRandom {
+    next(): number;
+    nextInt(min: number, max: number): number;
+    nextFloat(min: number, max: number): number;
+}
+export declare class SeededRandom implements IRandom {
+    private state;
+    constructor(seed: number);
+    next(): number;
+    nextInt(min: number, max: number): number;
+    nextFloat(min: number, max: number): number;
+}
+//# sourceMappingURL=IRandom.d.ts.map

package/dist/ports/IRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRandom.d.ts","sourceRoot":"","sources":["../../src/ports/IRandom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,OAAO;IACtB,8CAA8C;IAC9C,IAAI,IAAI,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,kDAAkD;IAClD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAMD,qBAAa,aAAc,YAAW,OAAO;IAC3C,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAG5C;AAMD,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,MAAM;IAIxB,IAAI,IAAI,MAAM;IAOd,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAG5C"}

package/dist/ports/IRandom.js

@@ -0,0 +1,39 @@
+/**
+ * Injectable random number generator port.
+ * Allows deterministic testing via SeededRandom while using Math.random() in production.
+ */
+// ---------------------------------------------------------------------------
+// DefaultRandom — delegates to Math.random()
+// ---------------------------------------------------------------------------
+export class DefaultRandom {
+    next() {
+        return Math.random();
+    }
+    nextInt(min, max) {
+        return Math.floor(this.next() * (max - min + 1)) + min;
+    }
+    nextFloat(min, max) {
+        return this.next() * (max - min) + min;
+    }
+}
+// ---------------------------------------------------------------------------
+// SeededRandom — deterministic mulberry32 PRNG
+// ---------------------------------------------------------------------------
+export class SeededRandom {
+    constructor(seed) {
+        this.state = seed | 0;
+    }
+    next() {
+        let t = (this.state += 0x6D2B79F5) | 0;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    }
+    nextInt(min, max) {
+        return Math.floor(this.next() * (max - min + 1)) + min;
+    }
+    nextFloat(min, max) {
+        return this.next() * (max - min) + min;
+    }
+}
+//# sourceMappingURL=IRandom.js.map

package/dist/ports/IRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRandom.js","sourceRoot":"","sources":["../../src/ports/IRandom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,OAAO,aAAa;IACxB,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,GAAW;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACzD,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,GAAW;QAChC,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;CACF;AAED,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IAGvB,YAAY,IAAY;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,GAAW;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACzD,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,GAAW;QAChC,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACzC,CAAC;CACF"}

package/dist/ports/IRuntimeClock.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Real-time clock for cooldown timers and memory aging.
+ *
+ * Distinct from {@link Clock} which provides accelerated game-time (timeFactor).
+ * IRuntimeClock returns monotonic real elapsed ms — maps to Phaser's scene.time.now.
+ *
+ * @example
+ * // Phaser adapter
+ * const runtimeClock: IRuntimeClock = { now: () => scene.time.now };
+ *
+ * // Test stub
+ * const runtimeClock: IRuntimeClock = { now: () => Date.now() };
+ */
+export interface IRuntimeClock {
+    /** Monotonic real-time milliseconds since session start. */
+    now(): number;
+}
+//# sourceMappingURL=IRuntimeClock.d.ts.map

package/dist/ports/IRuntimeClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRuntimeClock.d.ts","sourceRoot":"","sources":["../../src/ports/IRuntimeClock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,GAAG,IAAI,MAAM,CAAC;CACf"}

package/dist/ports/IRuntimeClock.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IRuntimeClock.js.map

package/dist/ports/IRuntimeClock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRuntimeClock.js","sourceRoot":"","sources":["../../src/ports/IRuntimeClock.ts"],"names":[],"mappings":""}

package/dist/ports/index.d.ts

@@ -0,0 +1,12 @@
+export type { IEntityAdapter, IEntityQuery, IEntityMutation, IEntityRendering, IEntityPresentation } from './IEntityAdapter';
+export { createNoOpEntityAdapter } from './IEntityAdapter';
+export type { IPlayerPositionProvider } from './IPlayerPositionProvider';
+export { createNoOpPlayerPosition } from './IPlayerPositionProvider';
+export type { IEntityFactory, INPCSpawnRequest, IMonsterSpawnRequest } from './IEntityFactory';
+export { createNoOpEntityFactory } from './IEntityFactory';
+export type { IDataLoader } from './IDataLoader';
+export type { ILogger, ILogOutput } from './ILogger';
+export type { IRandom } from './IRandom';
+export type { IRuntimeClock } from './IRuntimeClock';
+export { DefaultRandom, SeededRandom } from './IRandom';
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC7H,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/ports/index.js

@@ -0,0 +1,5 @@
+export { createNoOpEntityAdapter } from './IEntityAdapter';
+export { createNoOpPlayerPosition } from './IPlayerPositionProvider';
+export { createNoOpEntityFactory } from './IEntityFactory';
+export { DefaultRandom, SeededRandom } from './IRandom';
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAK3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/registry/AIStateRegistry.d.ts

@@ -0,0 +1,42 @@
+import { Registry } from './Registry';
+import type { IEntity } from '../entity/IEntity';
+/** Lifecycle hooks for a single AI FSM state. */
+export interface IStateHandler {
+    /** Called once when the FSM transitions into this state. */
+    enter(entity: IEntity): void;
+    /** Called every frame while this state is active. `delta` is seconds since last frame. */
+    update(entity: IEntity, delta: number): void;
+    /** Called once when the FSM transitions out of this state. */
+    exit(entity: IEntity): void;
+}
+/** Rule that triggers an automatic state transition. Evaluated every frame. */
+export interface ITransitionCondition {
+    /** AI state ID to transition to when the condition fires. */
+    readonly targetState: string;
+    /** Predicate evaluated every frame. Return `true` to trigger the transition. */
+    readonly condition: (entity: IEntity) => boolean;
+    /** Evaluation order (highest first). First matching condition wins. */
+    readonly priority: number;
+}
+/** Complete definition of an AI state for registration in AIStateRegistry. */
+export interface IAIStateDefinition {
+    /** Lifecycle callbacks (enter/update/exit). */
+    readonly handler: IStateHandler;
+    /** Whitelist of state IDs this state can transition to. Unset = unrestricted. */
+    readonly allowedTransitions?: readonly string[];
+    /** Auto-evaluated rules checked every frame, sorted by priority (descending). */
+    readonly transitionConditions?: readonly ITransitionCondition[];
+    /** Guard: return `false` to veto entering this state from `fromState`. */
+    readonly canEnter?: (entity: IEntity, fromState: string) => boolean;
+    /** Guard: return `false` to prevent leaving this state for `toState`. */
+    readonly canExit?: (entity: IEntity, toState: string) => boolean;
+}
+/** Registry of AI FSM states with built-in transition evaluation. */
+export declare class AIStateRegistry extends Registry<string, IAIStateDefinition> {
+    constructor();
+    /** @override Pre-sort transition conditions by priority (descending) at registration time. */
+    register(id: string, config: IAIStateDefinition): this;
+    /** Evaluate pre-sorted transition conditions for the current state. Returns the first matching target state ID, or `null`. */
+    evaluateTransitions(currentState: string, entity: IEntity): string | null;
+}
+//# sourceMappingURL=AIStateRegistry.d.ts.map

package/dist/registry/AIStateRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIStateRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/AIStateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,8DAA8D;IAC9D,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACjD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChE,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAClE;AAED,qEAAqE;AACrE,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;;IAKvE,8FAA8F;IACrF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAQ/D,8HAA8H;IAC9H,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAS1E"}

package/dist/registry/AIStateRegistry.js

@@ -0,0 +1,27 @@
+import { Registry } from './Registry';
+/** Registry of AI FSM states with built-in transition evaluation. */
+export class AIStateRegistry extends Registry {
+    constructor() {
+        super({ name: 'AIStateRegistry' });
+    }
+    /** @override Pre-sort transition conditions by priority (descending) at registration time. */
+    register(id, config) {
+        const sorted = config.transitionConditions
+            ? { ...config, transitionConditions: [...config.transitionConditions].sort((a, b) => b.priority - a.priority) }
+            : config;
+        super.register(id, sorted);
+        return this;
+    }
+    /** Evaluate pre-sorted transition conditions for the current state. Returns the first matching target state ID, or `null`. */
+    evaluateTransitions(currentState, entity) {
+        const state = this.tryGet(currentState);
+        if (!state?.transitionConditions)
+            return null;
+        for (const tc of state.transitionConditions) {
+            if (tc.condition(entity))
+                return tc.targetState;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=AIStateRegistry.js.map

package/dist/registry/AIStateRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIStateRegistry.js","sourceRoot":"","sources":["../../src/registry/AIStateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqCtC,qEAAqE;AACrE,MAAM,OAAO,eAAgB,SAAQ,QAAoC;IACvE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,8FAA8F;IACrF,QAAQ,CAAC,EAAU,EAAE,MAA0B;QACtD,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB;YACxC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,oBAAoB,EAAE,CAAC,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE;YAC/G,CAAC,CAAC,MAAM,CAAC;QACX,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8HAA8H;IAC9H,mBAAmB,CAAC,YAAoB,EAAE,MAAe;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,oBAAoB;YAAE,OAAO,IAAI,CAAC;QAE9C,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAC5C,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,CAAC,WAAW,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/registry/AnomalyTypeRegistry.d.ts

@@ -0,0 +1,21 @@
+import { Registry } from './Registry';
+/** Definition of an anomaly zone type (e.g. 'fire_anomaly', 'psi_field'). */
+export interface IAnomalyTypeDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** ID of the damage type inflicted. Must be registered in DamageTypeRegistry. */
+    readonly damageTypeId: string;
+    /** Damage dealt per second to entities inside the zone (> 0). */
+    readonly damagePerSecond: number;
+    /** Anomaly zone radius (px, > 0). */
+    readonly radius: number;
+    /** Probability of spawning an artefact per cycle [0, 1]. */
+    readonly artefactChance: number;
+    /** Maximum artefacts the zone can hold simultaneously (≥ 0). */
+    readonly maxArtefacts: number;
+}
+/** Registry of anomaly zone types. Validates damagePerSecond > 0, radius > 0, artefactChance [0, 1]. */
+export declare class AnomalyTypeRegistry extends Registry<string, IAnomalyTypeDefinition> {
+    constructor();
+}
+//# sourceMappingURL=AnomalyTypeRegistry.d.ts.map

package/dist/registry/AnomalyTypeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnomalyTypeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/AnomalyTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAWD,wGAAwG;AACxG,qBAAa,mBAAoB,SAAQ,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;;CAIhF"}

package/dist/registry/AnomalyTypeRegistry.js

@@ -0,0 +1,20 @@
+import { Registry } from './Registry';
+function validate(c) {
+    const errors = [];
+    if (c.damagePerSecond <= 0)
+        errors.push('damagePerSecond must be > 0');
+    if (c.radius <= 0)
+        errors.push('radius must be > 0');
+    if (c.artefactChance < 0 || c.artefactChance > 1)
+        errors.push('artefactChance must be in [0, 1]');
+    if (c.maxArtefacts < 0)
+        errors.push('maxArtefacts must be >= 0');
+    return errors;
+}
+/** Registry of anomaly zone types. Validates damagePerSecond > 0, radius > 0, artefactChance [0, 1]. */
+export class AnomalyTypeRegistry extends Registry {
+    constructor() {
+        super({ name: 'AnomalyTypeRegistry', validate });
+    }
+}
+//# sourceMappingURL=AnomalyTypeRegistry.js.map