@alife-sdk/core 0.1.1 → 0.3.0

package/dist/ai/BehaviorTree.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Behavior Tree — hierarchical AI task composition.
+ *
+ * Pairs well with GOAP: GOAP decides *what* goal to pursue, the BT decides
+ * *how* to execute it step by step. The BT is driven externally by calling
+ * `tree.tick(blackboard)` each frame or simulation step.
+ *
+ * Node types:
+ *   Composites  — Sequence, Selector, Parallel
+ *   Decorators  — Inverter, Repeater, AlwaysSucceed, AlwaysFail, Cooldown
+ *   Leaves      — Task (action), Condition
+ *
+ * Blackboard:
+ *   Typed key-value store shared across all nodes in one tick. Nodes read
+ *   perception data from it and write intermediate results to it.
+ *
+ * @example
+ * ```ts
+ * const bb = new Blackboard({ canSeeTarget: false, ammoCount: 10 });
+ *
+ * const tree = new Selector([
+ *   new Sequence([
+ *     new Condition((bb) => bb.get('canSeeTarget')),
+ *     new Condition((bb) => bb.get('ammoCount') > 0),
+ *     new Task((bb) => { shoot(); return 'success'; }),
+ *   ]),
+ *   new Task(() => { patrol(); return 'running'; }),
+ * ]);
+ *
+ * // Each frame:
+ * tree.tick(bb);
+ * ```
+ */
+/** Result returned by every node's `tick()`. */
+export type TaskStatus = 'success' | 'failure' | 'running';
+/**
+ * Typed key-value store shared across all nodes during a single tick.
+ *
+ * Initialize it with a plain object; the keys become the allowed set of keys
+ * via the generic type parameter.
+ */
+export declare class Blackboard<T extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly data;
+    constructor(initial?: Partial<T>);
+    get<K extends keyof T>(key: K): T[K] | undefined;
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    has(key: keyof T): boolean;
+    delete(key: keyof T): void;
+}
+/** Every node in the tree implements this single interface. */
+export interface ITreeNode<TBB extends Blackboard = Blackboard> {
+    tick(blackboard: TBB): TaskStatus;
+}
+/**
+ * Task (action leaf).
+ * Runs an arbitrary callback; the callback returns the status directly.
+ */
+export declare class Task<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly action;
+    constructor(action: (bb: TBB) => TaskStatus);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * Condition (boolean leaf).
+ * Returns 'success' when the predicate is true, 'failure' otherwise.
+ */
+export declare class Condition<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly predicate;
+    constructor(predicate: (bb: TBB) => boolean);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * Sequence — AND gate.
+ * Ticks children left-to-right. Returns 'failure' on the first failing child,
+ * 'running' on the first running child, 'success' when all succeed.
+ */
+export declare class Sequence<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly children;
+    constructor(children: ITreeNode<TBB>[]);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * Selector — OR gate.
+ * Ticks children left-to-right. Returns 'success' on the first succeeding
+ * child, 'running' on the first running child, 'failure' when all fail.
+ */
+export declare class Selector<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly children;
+    constructor(children: ITreeNode<TBB>[]);
+    tick(bb: TBB): TaskStatus;
+}
+/** Policy for the Parallel node. */
+export type ParallelPolicy = 'require-all' | 'require-one';
+/**
+ * Parallel — ticks ALL children every tick simultaneously.
+ *
+ * `require-all` (default — AND semantics):
+ *   - Success: all children succeed.
+ *   - Failure: any child fails.
+ *   - Running: otherwise.
+ *
+ * `require-one` (OR semantics):
+ *   - Success: at least one child succeeds.
+ *   - Failure: all children fail.
+ *   - Running: otherwise (some running, none succeeded yet).
+ */
+export declare class Parallel<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly children;
+    private readonly successPolicy;
+    constructor(children: ITreeNode<TBB>[], successPolicy?: ParallelPolicy);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * Inverter — flips 'success' ↔ 'failure'; passes 'running' unchanged.
+ */
+export declare class Inverter<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly child;
+    constructor(child: ITreeNode<TBB>);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * AlwaysSucceed — maps any child result to 'success'.
+ */
+export declare class AlwaysSucceed<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly child;
+    constructor(child: ITreeNode<TBB>);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * AlwaysFail — maps any child result to 'failure'.
+ */
+export declare class AlwaysFail<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly child;
+    constructor(child: ITreeNode<TBB>);
+    tick(bb: TBB): TaskStatus;
+}
+/**
+ * Repeater — ticks its child N times, returning 'success' after all iterations.
+ * If the child returns 'failure' the repeater short-circuits with 'failure'.
+ * Pass `Infinity` for an endless loop (returns 'running' every tick).
+ */
+export declare class Repeater<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly child;
+    private readonly times;
+    private remaining;
+    constructor(child: ITreeNode<TBB>, times: number);
+    tick(bb: TBB): TaskStatus;
+    /** Reset the repeat counter to allow reuse. */
+    reset(): void;
+}
+/**
+ * Cooldown — blocks its child while a cooldown timer is active.
+ *
+ * When the cooldown is inactive: ticks the child normally. If the child
+ * succeeds, starts the cooldown and returns 'success'. While the cooldown
+ * is active: immediately returns 'failure' (the action is on cooldown).
+ *
+ * `now` defaults to `Date.now` — inject a custom clock for deterministic tests.
+ */
+export declare class Cooldown<TBB extends Blackboard = Blackboard> implements ITreeNode<TBB> {
+    private readonly child;
+    private readonly durationMs;
+    private readonly clock;
+    private readyAt;
+    constructor(child: ITreeNode<TBB>, durationMs: number, clock?: () => number);
+    tick(bb: TBB): TaskStatus;
+    /** Force the cooldown to expire immediately. */
+    reset(): void;
+    /** `true` while the cooldown timer is active. */
+    get isOnCooldown(): boolean;
+}
+//# sourceMappingURL=BehaviorTree.d.ts.map

package/dist/ai/BehaviorTree.d.ts.map

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

package/dist/ai/BehaviorTree.js

@@ -0,0 +1,275 @@
+/**
+ * Behavior Tree — hierarchical AI task composition.
+ *
+ * Pairs well with GOAP: GOAP decides *what* goal to pursue, the BT decides
+ * *how* to execute it step by step. The BT is driven externally by calling
+ * `tree.tick(blackboard)` each frame or simulation step.
+ *
+ * Node types:
+ *   Composites  — Sequence, Selector, Parallel
+ *   Decorators  — Inverter, Repeater, AlwaysSucceed, AlwaysFail, Cooldown
+ *   Leaves      — Task (action), Condition
+ *
+ * Blackboard:
+ *   Typed key-value store shared across all nodes in one tick. Nodes read
+ *   perception data from it and write intermediate results to it.
+ *
+ * @example
+ * ```ts
+ * const bb = new Blackboard({ canSeeTarget: false, ammoCount: 10 });
+ *
+ * const tree = new Selector([
+ *   new Sequence([
+ *     new Condition((bb) => bb.get('canSeeTarget')),
+ *     new Condition((bb) => bb.get('ammoCount') > 0),
+ *     new Task((bb) => { shoot(); return 'success'; }),
+ *   ]),
+ *   new Task(() => { patrol(); return 'running'; }),
+ * ]);
+ *
+ * // Each frame:
+ * tree.tick(bb);
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Blackboard
+// ---------------------------------------------------------------------------
+/**
+ * Typed key-value store shared across all nodes during a single tick.
+ *
+ * Initialize it with a plain object; the keys become the allowed set of keys
+ * via the generic type parameter.
+ */
+export class Blackboard {
+    constructor(initial = {}) {
+        this.data = new Map(Object.entries(initial));
+    }
+    get(key) {
+        return this.data.get(key);
+    }
+    set(key, value) {
+        this.data.set(key, value);
+    }
+    has(key) {
+        return this.data.has(key);
+    }
+    delete(key) {
+        this.data.delete(key);
+    }
+}
+// ---------------------------------------------------------------------------
+// Leaf nodes
+// ---------------------------------------------------------------------------
+/**
+ * Task (action leaf).
+ * Runs an arbitrary callback; the callback returns the status directly.
+ */
+export class Task {
+    constructor(action) {
+        this.action = action;
+    }
+    tick(bb) {
+        return this.action(bb);
+    }
+}
+/**
+ * Condition (boolean leaf).
+ * Returns 'success' when the predicate is true, 'failure' otherwise.
+ */
+export class Condition {
+    constructor(predicate) {
+        this.predicate = predicate;
+    }
+    tick(bb) {
+        return this.predicate(bb) ? 'success' : 'failure';
+    }
+}
+// ---------------------------------------------------------------------------
+// Composite nodes
+// ---------------------------------------------------------------------------
+/**
+ * Sequence — AND gate.
+ * Ticks children left-to-right. Returns 'failure' on the first failing child,
+ * 'running' on the first running child, 'success' when all succeed.
+ */
+export class Sequence {
+    constructor(children) {
+        this.children = children;
+    }
+    tick(bb) {
+        for (const child of this.children) {
+            const status = child.tick(bb);
+            if (status !== 'success')
+                return status;
+        }
+        return 'success';
+    }
+}
+/**
+ * Selector — OR gate.
+ * Ticks children left-to-right. Returns 'success' on the first succeeding
+ * child, 'running' on the first running child, 'failure' when all fail.
+ */
+export class Selector {
+    constructor(children) {
+        this.children = children;
+    }
+    tick(bb) {
+        for (const child of this.children) {
+            const status = child.tick(bb);
+            if (status !== 'failure')
+                return status;
+        }
+        return 'failure';
+    }
+}
+/**
+ * Parallel — ticks ALL children every tick simultaneously.
+ *
+ * `require-all` (default — AND semantics):
+ *   - Success: all children succeed.
+ *   - Failure: any child fails.
+ *   - Running: otherwise.
+ *
+ * `require-one` (OR semantics):
+ *   - Success: at least one child succeeds.
+ *   - Failure: all children fail.
+ *   - Running: otherwise (some running, none succeeded yet).
+ */
+export class Parallel {
+    constructor(children, successPolicy = 'require-all') {
+        this.children = children;
+        this.successPolicy = successPolicy;
+    }
+    tick(bb) {
+        let successCount = 0;
+        let failureCount = 0;
+        for (const child of this.children) {
+            const status = child.tick(bb);
+            if (status === 'success')
+                successCount++;
+            else if (status === 'failure')
+                failureCount++;
+        }
+        if (this.successPolicy === 'require-all') {
+            if (failureCount > 0)
+                return 'failure';
+            if (successCount === this.children.length)
+                return 'success';
+        }
+        else {
+            if (successCount > 0)
+                return 'success';
+            if (failureCount === this.children.length)
+                return 'failure';
+        }
+        return 'running';
+    }
+}
+// ---------------------------------------------------------------------------
+// Decorator nodes
+// ---------------------------------------------------------------------------
+/**
+ * Inverter — flips 'success' ↔ 'failure'; passes 'running' unchanged.
+ */
+export class Inverter {
+    constructor(child) {
+        this.child = child;
+    }
+    tick(bb) {
+        const status = this.child.tick(bb);
+        if (status === 'success')
+            return 'failure';
+        if (status === 'failure')
+            return 'success';
+        return 'running';
+    }
+}
+/**
+ * AlwaysSucceed — maps any child result to 'success'.
+ */
+export class AlwaysSucceed {
+    constructor(child) {
+        this.child = child;
+    }
+    tick(bb) {
+        this.child.tick(bb);
+        return 'success';
+    }
+}
+/**
+ * AlwaysFail — maps any child result to 'failure'.
+ */
+export class AlwaysFail {
+    constructor(child) {
+        this.child = child;
+    }
+    tick(bb) {
+        this.child.tick(bb);
+        return 'failure';
+    }
+}
+/**
+ * Repeater — ticks its child N times, returning 'success' after all iterations.
+ * If the child returns 'failure' the repeater short-circuits with 'failure'.
+ * Pass `Infinity` for an endless loop (returns 'running' every tick).
+ */
+export class Repeater {
+    constructor(child, times) {
+        this.child = child;
+        this.times = times;
+        this.remaining = times;
+    }
+    tick(bb) {
+        if (this.remaining <= 0)
+            return 'success';
+        const status = this.child.tick(bb);
+        if (status === 'failure')
+            return 'failure';
+        if (status === 'success') {
+            this.remaining--;
+            if (this.remaining <= 0)
+                return 'success';
+        }
+        return 'running';
+    }
+    /** Reset the repeat counter to allow reuse. */
+    reset() {
+        this.remaining = this.times;
+    }
+}
+/**
+ * Cooldown — blocks its child while a cooldown timer is active.
+ *
+ * When the cooldown is inactive: ticks the child normally. If the child
+ * succeeds, starts the cooldown and returns 'success'. While the cooldown
+ * is active: immediately returns 'failure' (the action is on cooldown).
+ *
+ * `now` defaults to `Date.now` — inject a custom clock for deterministic tests.
+ */
+export class Cooldown {
+    constructor(child, durationMs, clock = Date.now) {
+        this.child = child;
+        this.durationMs = durationMs;
+        this.clock = clock;
+        this.readyAt = 0;
+    }
+    tick(bb) {
+        if (this.clock() < this.readyAt)
+            return 'failure';
+        const status = this.child.tick(bb);
+        if (status === 'success') {
+            this.readyAt = this.clock() + this.durationMs;
+        }
+        return status;
+    }
+    /** Force the cooldown to expire immediately. */
+    reset() {
+        this.readyAt = 0;
+    }
+    /** `true` while the cooldown timer is active. */
+    get isOnCooldown() {
+        return this.clock() < this.readyAt;
+    }
+}
+//# sourceMappingURL=BehaviorTree.js.map

package/dist/ai/BehaviorTree.js.map

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

package/dist/ai/StateMachine.d.ts

@@ -18,13 +18,51 @@ export type TransitionResult = {
     readonly success: false;
     readonly reason: 'not_allowed' | 'exit_guard' | 'enter_guard';
 };
+export interface StateTransitionEvent {
+    readonly from: string;
+    readonly to: string;
+    readonly timestamp: number;
+}
 export declare class StateMachine {
     private currentStateId;
+    private previousStateId;
+    private stateEnterTime;
     private readonly registry;
     private readonly entity;
+    private readonly enterListeners;
+    private readonly exitListeners;
+    private readonly changeListeners;
+    private readonly historyLog;
     constructor(entity: IEntity, registry: AIStateRegistry, initialState: string);
     /** Current active state identifier. */
     get state(): string;
+    /** Previous state identifier, or `null` if no transition has occurred yet. */
+    get previous(): string | null;
+    /** Milliseconds elapsed since entering the current state. */
+    get currentStateDuration(): number;
+    /** Returns `true` if the current state has the given tag. */
+    hasTag(tag: string): boolean;
+    /** Returns the metadata object of the current state, or `undefined`. */
+    get metadata(): Readonly<Record<string, unknown>> | undefined;
+    /**
+     * Subscribe to the moment the FSM enters `state`.
+     * @returns Unsubscribe function.
+     */
+    onEnter(state: string, callback: (from: string | null) => void): () => void;
+    /**
+     * Subscribe to the moment the FSM exits `state`.
+     * @returns Unsubscribe function.
+     */
+    onExit(state: string, callback: (to: string) => void): () => void;
+    /**
+     * Subscribe to any state change.
+     * @returns Unsubscribe function.
+     */
+    onChange(callback: (from: string, to: string) => void): () => void;
+    /** Returns a snapshot of the transition history (oldest first). */
+    getHistory(): readonly StateTransitionEvent[];
+    /** Clears the transition history. */
+    clearHistory(): void;
     /**
      * Force transition to a new state.
      *

package/dist/ai/StateMachine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StateMachine.d.ts","sourceRoot":"","sources":["../../src/ai/StateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,aAAa,CAAA;CAAE,CAAC;AAE/F,qBAAa,YAAY;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM;IAa5E,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAMD;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAsB9C;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB3B,iEAAiE;IACjE,OAAO,IAAI,IAAI;CAIhB"}
+{"version":3,"file":"StateMachine.d.ts","sourceRoot":"","sources":["../../src/ai/StateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,aAAa,CAAA;CAAE,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyD;IACxF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;gBAE7C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM;IAc5E,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,6DAA6D;IAC7D,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAMD,6DAA6D;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK5B,wEAAwE;IACxE,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAE5D;IAMD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAM3E;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAMjE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IASlE,mEAAmE;IACnE,UAAU,IAAI,SAAS,oBAAoB,EAAE;IAI7C,qCAAqC;IACrC,YAAY,IAAI,IAAI;IAQpB;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAwC9C;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB3B,iEAAiE;IACjE,OAAO,IAAI,IAAI;CAIhB"}

package/dist/ai/StateMachine.js

@@ -12,9 +12,15 @@
  */
 export class StateMachine {
     constructor(entity, registry, initialState) {
+        this.previousStateId = null;
+        this.enterListeners = new Map();
+        this.exitListeners = new Map();
+        this.changeListeners = new Set();
+        this.historyLog = [];
         this.entity = entity;
         this.registry = registry;
         this.currentStateId = initialState;
+        this.stateEnterTime = Date.now();
         const definition = this.registry.get(this.currentStateId);
         definition.handler.enter(this.entity);
     }
@@ -25,6 +31,68 @@ export class StateMachine {
     get state() {
         return this.currentStateId;
     }
+    /** Previous state identifier, or `null` if no transition has occurred yet. */
+    get previous() {
+        return this.previousStateId;
+    }
+    /** Milliseconds elapsed since entering the current state. */
+    get currentStateDuration() {
+        return Date.now() - this.stateEnterTime;
+    }
+    // -----------------------------------------------------------------------
+    // Tag queries
+    // -----------------------------------------------------------------------
+    /** Returns `true` if the current state has the given tag. */
+    hasTag(tag) {
+        const def = this.registry.tryGet(this.currentStateId);
+        return def?.tags?.includes(tag) ?? false;
+    }
+    /** Returns the metadata object of the current state, or `undefined`. */
+    get metadata() {
+        return this.registry.tryGet(this.currentStateId)?.metadata;
+    }
+    // -----------------------------------------------------------------------
+    // Event subscriptions
+    // -----------------------------------------------------------------------
+    /**
+     * Subscribe to the moment the FSM enters `state`.
+     * @returns Unsubscribe function.
+     */
+    onEnter(state, callback) {
+        if (!this.enterListeners.has(state))
+            this.enterListeners.set(state, new Set());
+        this.enterListeners.get(state).add(callback);
+        return () => this.enterListeners.get(state)?.delete(callback);
+    }
+    /**
+     * Subscribe to the moment the FSM exits `state`.
+     * @returns Unsubscribe function.
+     */
+    onExit(state, callback) {
+        if (!this.exitListeners.has(state))
+            this.exitListeners.set(state, new Set());
+        this.exitListeners.get(state).add(callback);
+        return () => this.exitListeners.get(state)?.delete(callback);
+    }
+    /**
+     * Subscribe to any state change.
+     * @returns Unsubscribe function.
+     */
+    onChange(callback) {
+        this.changeListeners.add(callback);
+        return () => this.changeListeners.delete(callback);
+    }
+    // -----------------------------------------------------------------------
+    // History
+    // -----------------------------------------------------------------------
+    /** Returns a snapshot of the transition history (oldest first). */
+    getHistory() {
+        return [...this.historyLog];
+    }
+    /** Clears the transition history. */
+    clearHistory() {
+        this.historyLog.length = 0;
+    }
     // -----------------------------------------------------------------------
     // Transitions
     // -----------------------------------------------------------------------
@@ -46,9 +114,21 @@ export class StateMachine {
             return { success: false, reason: 'exit_guard' };
         if (newDefinition.canEnter?.(this.entity, this.currentStateId) === false)
             return { success: false, reason: 'enter_guard' };
+        const from = this.currentStateId;
+        // Exit
         oldDefinition.handler.exit(this.entity);
+        this.exitListeners.get(from)?.forEach(cb => cb(newState));
+        // Advance state
+        this.previousStateId = from;
         this.currentStateId = newState;
+        this.stateEnterTime = Date.now();
+        // Record history
+        this.historyLog.push({ from, to: newState, timestamp: this.stateEnterTime });
+        // Notify change listeners
+        this.changeListeners.forEach(cb => cb(from, newState));
+        // Enter
         newDefinition.handler.enter(this.entity);
+        this.enterListeners.get(newState)?.forEach(cb => cb(from));
         return { success: true };
     }
     // -----------------------------------------------------------------------

package/dist/ai/StateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateMachine.js","sourceRoot":"","sources":["../../src/ai/StateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,OAAO,YAAY;IAKvB,YAAY,MAAe,EAAE,QAAyB,EAAE,YAAoB;QAC1E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC;QAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1D,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,0EAA0E;IAC1E,YAAY;IACZ,0EAA0E;IAE1E,uCAAuC;IACvC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,0EAA0E;IAC1E,cAAc;IACd,0EAA0E;IAE1E;;;;;;OAMG;IACH,UAAU,CAAC,QAAgB;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAElD,oFAAoF;QACpF,IAAI,aAAa,CAAC,kBAAkB,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAC9G,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAE3H,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,0EAA0E;IAC1E,SAAS;IACT,0EAA0E;IAE1E;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAa;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1D,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CACjD,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,MAAM,CACZ,CAAC;QAEF,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,UAAU;IACV,0EAA0E;IAE1E,iEAAiE;IACjE,OAAO;QACL,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1D,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"StateMachine.js","sourceRoot":"","sources":["../../src/ai/StateMachine.ts"],"names":[],"mappings":"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"}

package/dist/ai/index.d.ts

@@ -1,5 +1,5 @@
 export { StateMachine } from './StateMachine';
-export type { TransitionResult } from './StateMachine';
+export type { TransitionResult, StateTransitionEvent } from './StateMachine';
 export { MemoryBank, MemoryChannel } from './MemorySystem';
 export type { MemoryRecord, IMemoryBankConfig, IMemoryInput } from './MemorySystem';
 export { DangerManager, DangerType } from './DangerManager';
@@ -7,4 +7,6 @@ export type { IDangerEntry } from './DangerManager';
 export { WorldState } from './WorldState';
 export { GOAPPlanner } from './GOAPPlanner';
 export { GOAPAction, ActionStatus } from './GOAPAction';
+export { Blackboard, Task, Condition, Sequence, Selector, Parallel, Inverter, AlwaysSucceed, AlwaysFail, Repeater, Cooldown } from './BehaviorTree';
+export type { TaskStatus, ITreeNode, ParallelPolicy } from './BehaviorTree';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpJ,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ai/index.js

@@ -5,4 +5,5 @@ export { DangerManager, DangerType } from './DangerManager';
 export { WorldState } from './WorldState';
 export { GOAPPlanner } from './GOAPPlanner';
 export { GOAPAction, ActionStatus } from './GOAPAction';
+export { Blackboard, Task, Condition, Sequence, Selector, Parallel, Inverter, AlwaysSucceed, AlwaysFail, Repeater, Cooldown } from './BehaviorTree';
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/ReactiveQuery.d.ts

@@ -0,0 +1,85 @@
+/**
+ * ReactiveQuery — observe when entities enter and exit a filtered set.
+ *
+ * Instead of polling the entire entity set every frame, a ReactiveQuery
+ * maintains a stable "matched" set and fires change notifications only when
+ * entities enter or leave the query (i.e. when the predicate result changes).
+ *
+ * Usage pattern:
+ *   1. Create a query with a predicate.
+ *   2. Subscribe to `onChange` to react to structural changes.
+ *   3. Call `update(allEntities)` each tick to re-evaluate.
+ *
+ * @example
+ * ```ts
+ * const hostileQuery = new ReactiveQuery<IEntity>(
+ *   (e) => e.isAlive && e.hasComponent('hostile')
+ * );
+ *
+ * hostileQuery.onChange(({ added, removed }) => {
+ *   added.forEach(e => combatSystem.track(e));
+ *   removed.forEach(e => combatSystem.untrack(e));
+ * });
+ *
+ * // Each tick:
+ * hostileQuery.update(world.entities());
+ * ```
+ */
+/** Changes detected since the last `update()` call. */
+export interface QueryChanges<T> {
+    /** Entities that newly matched the predicate this update. */
+    readonly added: readonly T[];
+    /** Entities that no longer match the predicate this update. */
+    readonly removed: readonly T[];
+    /** All entities currently matching the predicate after this update. */
+    readonly current: readonly T[];
+}
+/** Callback invoked when any entities are added or removed from the query. */
+export type QueryChangeListener<T> = (changes: QueryChanges<T>) => void;
+/**
+ * Tracks which entities satisfy a predicate and fires change events when
+ * the matched set changes.
+ */
+export declare class ReactiveQuery<T> {
+    private readonly predicate;
+    private readonly matched;
+    private readonly listeners;
+    constructor(predicate: (entity: T) => boolean);
+    /**
+     * Re-evaluate the predicate against `allEntities`.
+     *
+     * Fires `onChange` listeners if the matched set changed.
+     * Call this once per tick from the owning system.
+     */
+    update(allEntities: Iterable<T>): void;
+    /**
+     * Subscribe to change events. Called whenever entities enter or exit the
+     * matched set.
+     *
+     * @returns Unsubscribe function.
+     */
+    onChange(listener: QueryChangeListener<T>): () => void;
+    /** All entities currently matching the predicate (stable snapshot). */
+    get current(): readonly T[];
+    /** Number of currently matched entities. */
+    get size(): number;
+    /** Return `true` if the entity is currently in the matched set. */
+    has(entity: T): boolean;
+    /**
+     * Manually add an entity to the matched set without re-evaluating the
+     * predicate. Fires `onChange` with the single addition.
+     *
+     * Useful when external code creates entities and knows they should match.
+     */
+    track(entity: T): void;
+    /**
+     * Manually remove an entity from the matched set.
+     * Fires `onChange` with the single removal.
+     *
+     * Useful when entities are destroyed mid-tick.
+     */
+    untrack(entity: T): void;
+    /** Remove all entities and clear all listeners. */
+    dispose(): void;
+}
+//# sourceMappingURL=ReactiveQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReactiveQuery.d.ts","sourceRoot":"","sources":["../../src/core/ReactiveQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,uDAAuD;AACvD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CAChC;AAED,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAMxE;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC;IAId,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;gBAElC,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO;IAM9D;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAwCtC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAStD,uEAAuE;IACvE,IAAI,OAAO,IAAI,SAAS,CAAC,EAAE,CAE1B;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mEAAmE;IACnE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO;IAIvB;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAatB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAaxB,mDAAmD;IACnD,OAAO,IAAI,IAAI;CAIhB"}

package/dist/core/ReactiveQuery.js

@@ -0,0 +1,154 @@
+/**
+ * ReactiveQuery — observe when entities enter and exit a filtered set.
+ *
+ * Instead of polling the entire entity set every frame, a ReactiveQuery
+ * maintains a stable "matched" set and fires change notifications only when
+ * entities enter or leave the query (i.e. when the predicate result changes).
+ *
+ * Usage pattern:
+ *   1. Create a query with a predicate.
+ *   2. Subscribe to `onChange` to react to structural changes.
+ *   3. Call `update(allEntities)` each tick to re-evaluate.
+ *
+ * @example
+ * ```ts
+ * const hostileQuery = new ReactiveQuery<IEntity>(
+ *   (e) => e.isAlive && e.hasComponent('hostile')
+ * );
+ *
+ * hostileQuery.onChange(({ added, removed }) => {
+ *   added.forEach(e => combatSystem.track(e));
+ *   removed.forEach(e => combatSystem.untrack(e));
+ * });
+ *
+ * // Each tick:
+ * hostileQuery.update(world.entities());
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// ReactiveQuery
+// ---------------------------------------------------------------------------
+/**
+ * Tracks which entities satisfy a predicate and fires change events when
+ * the matched set changes.
+ */
+export class ReactiveQuery {
+    constructor(predicate) {
+        this.predicate = predicate;
+        this.matched = new Set();
+        this.listeners = new Set();
+    }
+    // -------------------------------------------------------------------------
+    // Update
+    // -------------------------------------------------------------------------
+    /**
+     * Re-evaluate the predicate against `allEntities`.
+     *
+     * Fires `onChange` listeners if the matched set changed.
+     * Call this once per tick from the owning system.
+     */
+    update(allEntities) {
+        const added = [];
+        const removed = [];
+        const nextMatched = new Set();
+        for (const entity of allEntities) {
+            if (this.predicate(entity)) {
+                nextMatched.add(entity);
+                if (!this.matched.has(entity)) {
+                    added.push(entity);
+                }
+            }
+        }
+        for (const entity of this.matched) {
+            if (!nextMatched.has(entity)) {
+                removed.push(entity);
+            }
+        }
+        // Commit new matched set
+        this.matched.clear();
+        for (const e of nextMatched)
+            this.matched.add(e);
+        if (added.length > 0 || removed.length > 0) {
+            const changes = {
+                added,
+                removed,
+                current: [...this.matched],
+            };
+            for (const listener of this.listeners) {
+                listener(changes);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Subscriptions
+    // -------------------------------------------------------------------------
+    /**
+     * Subscribe to change events. Called whenever entities enter or exit the
+     * matched set.
+     *
+     * @returns Unsubscribe function.
+     */
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    // -------------------------------------------------------------------------
+    // Accessors
+    // -------------------------------------------------------------------------
+    /** All entities currently matching the predicate (stable snapshot). */
+    get current() {
+        return [...this.matched];
+    }
+    /** Number of currently matched entities. */
+    get size() {
+        return this.matched.size;
+    }
+    /** Return `true` if the entity is currently in the matched set. */
+    has(entity) {
+        return this.matched.has(entity);
+    }
+    /**
+     * Manually add an entity to the matched set without re-evaluating the
+     * predicate. Fires `onChange` with the single addition.
+     *
+     * Useful when external code creates entities and knows they should match.
+     */
+    track(entity) {
+        if (this.matched.has(entity))
+            return;
+        this.matched.add(entity);
+        const changes = {
+            added: [entity],
+            removed: [],
+            current: [...this.matched],
+        };
+        for (const listener of this.listeners) {
+            listener(changes);
+        }
+    }
+    /**
+     * Manually remove an entity from the matched set.
+     * Fires `onChange` with the single removal.
+     *
+     * Useful when entities are destroyed mid-tick.
+     */
+    untrack(entity) {
+        if (!this.matched.has(entity))
+            return;
+        this.matched.delete(entity);
+        const changes = {
+            added: [],
+            removed: [entity],
+            current: [...this.matched],
+        };
+        for (const listener of this.listeners) {
+            listener(changes);
+        }
+    }
+    /** Remove all entities and clear all listeners. */
+    dispose() {
+        this.matched.clear();
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=ReactiveQuery.js.map

package/dist/core/ReactiveQuery.js.map

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

package/dist/entity/EntityHandle.d.ts

@@ -0,0 +1,76 @@
+/**
+ * EntityHandle — versioned entity references with use-after-free protection.
+ *
+ * Instead of holding raw entity references that can become dangling after an
+ * entity is destroyed, systems hold an EntityHandle. The handle encodes both
+ * the entity's slot index and a generation counter. When a slot is reused for
+ * a new entity the generation is bumped, making all old handles stale.
+ *
+ * Bit layout (fits in a JavaScript safe integer):
+ *   [47..20] generation  (28 bits, up to ~268 M versions per slot)
+ *   [19.. 0] index       (20 bits, up to ~1 M concurrent slots)
+ *
+ * Usage:
+ *   const manager = new EntityHandleManager();
+ *   const handle  = manager.alloc('wolf-1');
+ *   manager.resolve(handle);   // → 'wolf-1'
+ *   manager.free(handle);
+ *   manager.resolve(handle);   // → null  (stale)
+ */
+/** Opaque numeric type that encodes (generation, index). */
+export type EntityHandle = number & {
+    readonly __brand: 'EntityHandle';
+};
+/** Sentinel value for an absent or invalid handle. */
+export declare const NULL_HANDLE: EntityHandle;
+/** Pack (index, generation) into a single handle. */
+export declare function makeHandle(index: number, generation: number): EntityHandle;
+/** Extract the slot index from a handle. */
+export declare function indexOf(handle: EntityHandle): number;
+/** Extract the generation counter from a handle. */
+export declare function genOf(handle: EntityHandle): number;
+/** Return `true` if the handle is not the null sentinel. */
+export declare function isValidHandle(handle: EntityHandle): boolean;
+/** Human-readable description for logging / debugging. */
+export declare function handleToString(handle: EntityHandle): string;
+/**
+ * Central registry that owns the slot → entity-id mapping.
+ *
+ * Recycles freed slots so slot count stays bounded. Old handles pointing at
+ * recycled slots resolve to `null` because their stored generation no longer
+ * matches the slot's current generation.
+ */
+export declare class EntityHandleManager<TId = string> {
+    /** Generation counter per slot (index = slot index). */
+    private readonly generations;
+    /** Entity ID stored in each live slot. `null` = free. */
+    private readonly ids;
+    /** Slot indices available for reuse. */
+    private readonly freeList;
+    /** Next slot to allocate when freeList is empty. */
+    private nextSlot;
+    /**
+     * Allocate a new handle for the given entity id.
+     * @throws if the slot limit is exhausted.
+     */
+    alloc(id: TId): EntityHandle;
+    /**
+     * Release a handle, incrementing the slot's generation.
+     * All existing handles pointing at this slot become stale.
+     *
+     * Does nothing (and does not throw) if the handle is already stale.
+     */
+    free(handle: EntityHandle): void;
+    /**
+     * Resolve a handle to its entity id.
+     * Returns `null` if the handle is stale (entity was freed) or null.
+     */
+    resolve(handle: EntityHandle): TId | null;
+    /**
+     * Return `true` if the handle points to a currently-live slot.
+     */
+    isAlive(handle: EntityHandle): boolean;
+    /** Number of currently-live slots. */
+    get size(): number;
+}
+//# sourceMappingURL=EntityHandle.d.ts.map

package/dist/entity/EntityHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityHandle.d.ts","sourceRoot":"","sources":["../../src/entity/EntityHandle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgBH,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzE,sDAAsD;AACtD,eAAO,MAAM,WAAW,EAAQ,YAAY,CAAC;AAE7C,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAG1E;AAED,4CAA4C;AAC5C,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEpD;AAED,oDAAoD;AACpD,wBAAgB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE3D;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAG3D;AAMD;;;;;;GAMG;AACH,qBAAa,mBAAmB,CAAC,GAAG,GAAG,MAAM;IAC3C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;IAC1C,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAK;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,GAAG,GAAG,YAAY;IAiB5B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAQhC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,GAAG,IAAI;IAOzC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAMtC,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/entity/EntityHandle.js

@@ -0,0 +1,133 @@
+/**
+ * EntityHandle — versioned entity references with use-after-free protection.
+ *
+ * Instead of holding raw entity references that can become dangling after an
+ * entity is destroyed, systems hold an EntityHandle. The handle encodes both
+ * the entity's slot index and a generation counter. When a slot is reused for
+ * a new entity the generation is bumped, making all old handles stale.
+ *
+ * Bit layout (fits in a JavaScript safe integer):
+ *   [47..20] generation  (28 bits, up to ~268 M versions per slot)
+ *   [19.. 0] index       (20 bits, up to ~1 M concurrent slots)
+ *
+ * Usage:
+ *   const manager = new EntityHandleManager();
+ *   const handle  = manager.alloc('wolf-1');
+ *   manager.resolve(handle);   // → 'wolf-1'
+ *   manager.free(handle);
+ *   manager.resolve(handle);   // → null  (stale)
+ */
+// ---------------------------------------------------------------------------
+// Bit-layout constants
+// ---------------------------------------------------------------------------
+const INDEX_BITS = 20;
+const GEN_BITS = 28;
+const INDEX_MASK = (1 << INDEX_BITS) - 1; // 0x000FFFFF — 1 048 575 max slots
+const GEN_MASK = (1 << GEN_BITS) - 1; // 0x0FFFFFFF — 268 435 455 max gen
+const MAX_SLOTS = 1 << INDEX_BITS;
+/** Sentinel value for an absent or invalid handle. */
+export const NULL_HANDLE = 0;
+/** Pack (index, generation) into a single handle. */
+export function makeHandle(index, generation) {
+    // Use multiplication instead of bit-shift to avoid 32-bit truncation.
+    return ((generation & GEN_MASK) * MAX_SLOTS + (index & INDEX_MASK));
+}
+/** Extract the slot index from a handle. */
+export function indexOf(handle) {
+    return handle & INDEX_MASK;
+}
+/** Extract the generation counter from a handle. */
+export function genOf(handle) {
+    return Math.floor(handle / MAX_SLOTS) & GEN_MASK;
+}
+/** Return `true` if the handle is not the null sentinel. */
+export function isValidHandle(handle) {
+    return handle !== NULL_HANDLE;
+}
+/** Human-readable description for logging / debugging. */
+export function handleToString(handle) {
+    if (!isValidHandle(handle))
+        return 'Entity(NULL)';
+    return `Entity(idx=${indexOf(handle)}, gen=${genOf(handle)})`;
+}
+// ---------------------------------------------------------------------------
+// EntityHandleManager
+// ---------------------------------------------------------------------------
+/**
+ * Central registry that owns the slot → entity-id mapping.
+ *
+ * Recycles freed slots so slot count stays bounded. Old handles pointing at
+ * recycled slots resolve to `null` because their stored generation no longer
+ * matches the slot's current generation.
+ */
+export class EntityHandleManager {
+    constructor() {
+        /** Generation counter per slot (index = slot index). */
+        this.generations = [];
+        /** Entity ID stored in each live slot. `null` = free. */
+        this.ids = [];
+        /** Slot indices available for reuse. */
+        this.freeList = [];
+        /** Next slot to allocate when freeList is empty. */
+        this.nextSlot = 0;
+    }
+    /**
+     * Allocate a new handle for the given entity id.
+     * @throws if the slot limit is exhausted.
+     */
+    alloc(id) {
+        let index;
+        if (this.freeList.length > 0) {
+            index = this.freeList.pop();
+        }
+        else {
+            if (this.nextSlot >= MAX_SLOTS) {
+                throw new Error(`EntityHandleManager: slot limit (${MAX_SLOTS}) reached`);
+            }
+            index = this.nextSlot++;
+            this.generations[index] = 1;
+        }
+        this.ids[index] = id;
+        return makeHandle(index, this.generations[index]);
+    }
+    /**
+     * Release a handle, incrementing the slot's generation.
+     * All existing handles pointing at this slot become stale.
+     *
+     * Does nothing (and does not throw) if the handle is already stale.
+     */
+    free(handle) {
+        if (!this.isAlive(handle))
+            return;
+        const index = indexOf(handle);
+        this.ids[index] = null;
+        this.generations[index] = (this.generations[index] + 1) & GEN_MASK || 1; // skip 0
+        this.freeList.push(index);
+    }
+    /**
+     * Resolve a handle to its entity id.
+     * Returns `null` if the handle is stale (entity was freed) or null.
+     */
+    resolve(handle) {
+        if (!isValidHandle(handle))
+            return null;
+        const index = indexOf(handle);
+        if (this.generations[index] !== genOf(handle))
+            return null;
+        return this.ids[index] ?? null;
+    }
+    /**
+     * Return `true` if the handle points to a currently-live slot.
+     */
+    isAlive(handle) {
+        if (!isValidHandle(handle))
+            return false;
+        const index = indexOf(handle);
+        return this.generations[index] === genOf(handle) && this.ids[index] !== null;
+    }
+    /** Number of currently-live slots. */
+    get size() {
+        return this.nextSlot - this.freeList.length;
+    }
+}
+//# sourceMappingURL=EntityHandle.js.map

package/dist/entity/EntityHandle.js.map

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

package/dist/entity/index.d.ts

@@ -1,3 +1,5 @@
 export type { IEntity } from './IEntity';
 export type { IComponent } from './IComponent';
+export type { EntityHandle } from './EntityHandle';
+export { NULL_HANDLE, makeHandle, indexOf, genOf, isValidHandle, handleToString, EntityHandleManager, } from './EntityHandle';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,WAAW,EACX,UAAU,EACV,OAAO,EACP,KAAK,EACL,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/entity/index.js

@@ -1,2 +1,2 @@
-export {};
+export { NULL_HANDLE, makeHandle, indexOf, genOf, isValidHandle, handleToString, EntityHandleManager, } from './EntityHandle';
 //# sourceMappingURL=index.js.map

package/dist/entity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EACX,UAAU,EACV,OAAO,EACP,KAAK,EACL,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export { Clock } from './core/Clock';
 export type { IClockConfig, IClockState } from './core/Clock';
 export { SpatialGrid } from './core/SpatialGrid';
 export type { IRect } from './core/SpatialGrid';
+export { ReactiveQuery } from './core/ReactiveQuery';
+export type { QueryChanges, QueryChangeListener } from './core/ReactiveQuery';
 export type { ISerializable } from './core/ISerializable';
 export * from './core/math/index';
 export * from './events/index';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1I,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1I,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export { Ports, REQUIRED_PORTS } from './core/PortTokens';
 export { DiagnosticsCollector, ALifeValidationError } from './core/Diagnostics';
 export { Clock } from './core/Clock';
 export { SpatialGrid } from './core/SpatialGrid';
+export { ReactiveQuery } from './core/ReactiveQuery';
 // ---------------------------------------------------------------------------
 // Sub-path re-exports
 // ---------------------------------------------------------------------------

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sEAAsE;AACtE,+CAA+C;AAE/C,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAC9E,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,sEAAsE;AACtE,+CAA+C;AAE/C,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAC9E,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/registry/AIStateRegistry.d.ts

@@ -30,6 +30,10 @@ export interface IAIStateDefinition {
     readonly canEnter?: (entity: IEntity, fromState: string) => boolean;
     /** Guard: return `false` to prevent leaving this state for `toState`. */
     readonly canExit?: (entity: IEntity, toState: string) => boolean;
+    /** Categorical tags for querying state group membership (e.g. 'combat', 'grounded'). */
+    readonly tags?: readonly string[];
+    /** Arbitrary metadata for tooling/debugging (e.g. animation hints, priority weights). */
+    readonly metadata?: Readonly<Record<string, unknown>>;
 }
 /** Registry of AI FSM states with built-in transition evaluation. */
 export declare class AIStateRegistry extends Registry<string, IAIStateDefinition> {

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

@@ -1 +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"}
+{"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;IACjE,wFAAwF;IACxF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;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.map

@@ -1 +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"}
+{"version":3,"file":"AIStateRegistry.js","sourceRoot":"","sources":["../../src/registry/AIStateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAyCtC,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alife-sdk/core",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Framework-agnostic A-Life simulation and AI decision-making system",
   "type": "module",
   "sideEffects": false,