@alife-sdk/ai 0.1.0

package/dist/states/StateHandlerMap.js

@@ -0,0 +1,88 @@
+// states/StateHandlerMap.ts
+// Fluent registry for online state handlers.
+//
+// Usage:
+//   const handlers = buildDefaultHandlerMap(cfg, tr)
+//     .register('HUNT', new HuntState(cfg))
+//     .register('AMBUSH', new AmbushState(cfg));
+//
+//   const driver = new OnlineAIDriver(ctx, handlers, 'IDLE');
+/**
+ * Type-safe registry for online NPC state handlers.
+ *
+ * Wraps a Map<string, IOnlineStateHandler> with a fluent API to make
+ * custom state registration explicit and discoverable.
+ *
+ * @example
+ * ```ts
+ * // Zombie game with custom states
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   combatOnPanicked: 'shamble_away',
+ *   monsterOnNoEnemy: 'wander',
+ * })
+ *   .register('HUNT', new HuntState(cfg))
+ *   .register('shamble_away', new ShamblingFleeState(cfg))
+ *   .extend(buildMonsterHandlerMap(cfg));
+ * ```
+ */
+export class StateHandlerMap {
+    constructor(entries) {
+        this._map = new Map(entries);
+    }
+    /**
+     * Register a handler for a state ID.
+     * Overwrites any existing handler for that ID.
+     * Returns `this` for fluent chaining.
+     */
+    register(stateId, handler) {
+        this._map.set(stateId, handler);
+        return this;
+    }
+    /**
+     * Merge all handlers from another StateHandlerMap or Map.
+     * Existing IDs in `this` are NOT overwritten — use {@link register} for targeted overrides.
+     * Returns `this` for fluent chaining.
+     */
+    extend(other) {
+        const source = other instanceof StateHandlerMap ? other._map : other;
+        for (const [id, handler] of source) {
+            if (!this._map.has(id)) {
+                this._map.set(id, handler);
+            }
+        }
+        return this;
+    }
+    /**
+     * Override all handlers from another StateHandlerMap or Map.
+     * Existing IDs in `this` ARE overwritten.
+     * Returns `this` for fluent chaining.
+     */
+    override(other) {
+        const source = other instanceof StateHandlerMap ? other._map : other;
+        for (const [id, handler] of source) {
+            this._map.set(id, handler);
+        }
+        return this;
+    }
+    /** Returns the handler registered for `stateId`, or undefined. */
+    get(stateId) {
+        return this._map.get(stateId);
+    }
+    /** Returns true if a handler for `stateId` is registered. */
+    has(stateId) {
+        return this._map.has(stateId);
+    }
+    /** Number of registered handlers. */
+    get size() {
+        return this._map.size;
+    }
+    /** Iterate over all [stateId, handler] pairs. */
+    [Symbol.iterator]() {
+        return this._map[Symbol.iterator]();
+    }
+    /** Returns the underlying Map (read-only view). */
+    toMap() {
+        return this._map;
+    }
+}
+//# sourceMappingURL=StateHandlerMap.js.map

package/dist/states/StateHandlerMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHandlerMap.js","sourceRoot":"","sources":["../../src/states/StateHandlerMap.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,6CAA6C;AAC7C,EAAE;AACF,SAAS;AACT,qDAAqD;AACrD,4CAA4C;AAC5C,iDAAiD;AACjD,EAAE;AACF,8DAA8D;AAI9D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,eAAe;IAG1B,YAAY,OAAiD;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,OAAe,EAAE,OAA4B;QACpD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAyD;QAC9D,MAAM,MAAM,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAyD;QAChE,MAAM,MAAM,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kEAAkE;IAClE,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,6DAA6D;IAC7D,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,iDAAiD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,mDAAmD;IACnD,KAAK;QACH,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/states/eat-corpse/EatCorpseState.d.ts

@@ -0,0 +1,32 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+import type { ICorpseSource } from './ICorpseSource';
+import type { IEatCorpseConfig } from './IEatCorpseConfig';
+/**
+ * Stateless EAT_CORPSE state handler for predatory NPCs.
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * @example
+ * ```ts
+ * // Register alongside the default monster handler map:
+ * const handlers = buildMonsterHandlerMap(cfg, {
+ *   monsterOnNoEnemy: 'EAT_CORPSE',   // try eating after a kill
+ *   eatCorpseOnNoCorpse: 'IDLE',      // nothing nearby? just idle
+ * });
+ * handlers.set('EAT_CORPSE', new EatCorpseState(cfg, tr, corpseSource));
+ * ```
+ */
+export declare class EatCorpseState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    private readonly source;
+    private readonly eatCfg;
+    constructor(cfg: IStateConfig, tr: Partial<IStateTransitionMap> | undefined, corpseSource: ICorpseSource, eatCfg?: Partial<IEatCorpseConfig>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=EatCorpseState.d.ts.map

package/dist/states/eat-corpse/EatCorpseState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EatCorpseState.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/EatCorpseState.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,mBAAmB;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAGxC,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAC5C,YAAY,EAAE,aAAa,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAQpC,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAmC7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsDhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/eat-corpse/EatCorpseState.js

@@ -0,0 +1,126 @@
+// states/eat-corpse/EatCorpseState.ts
+// Opt-in state handler: predatory NPC approaches and consumes a nearby corpse.
+//
+// Phase cycle:
+//   APPROACH — NPC moves toward the target corpse.
+//   EATING   — NPC halts at the corpse for eatDurationMs.
+//   DONE     — Reward applied, consumeCorpse() called, transition out.
+//
+// Transitions out:
+//   - Eating complete      → eatCorpseOnDone     (default: 'IDLE')
+//   - No corpse in radius  → eatCorpseOnNoCorpse (default: 'IDLE')
+//   - Enemy spotted        → eatCorpseOnInterrupt (default: 'ALERT')
+//
+// enter: find nearest corpse, set phase data
+// exit:  mark phase inactive (corpse NOT consumed unless eating completed)
+//
+// Opt-in: never registered by buildDefaultHandlerMap / buildMonsterHandlerMap.
+// Register manually:
+//   handlerMap.set('EAT_CORPSE', new EatCorpseState(cfg, tr, corpseSource));
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward, distanceTo } from '../handlers/_utils';
+import { createDefaultEatCorpseConfig } from './IEatCorpseConfig';
+/**
+ * Stateless EAT_CORPSE state handler for predatory NPCs.
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * @example
+ * ```ts
+ * // Register alongside the default monster handler map:
+ * const handlers = buildMonsterHandlerMap(cfg, {
+ *   monsterOnNoEnemy: 'EAT_CORPSE',   // try eating after a kill
+ *   eatCorpseOnNoCorpse: 'IDLE',      // nothing nearby? just idle
+ * });
+ * handlers.set('EAT_CORPSE', new EatCorpseState(cfg, tr, corpseSource));
+ * ```
+ */
+export class EatCorpseState {
+    constructor(cfg, tr, corpseSource, eatCfg) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+        this.source = corpseSource;
+        this.eatCfg = createDefaultEatCorpseConfig(eatCfg);
+    }
+    enter(ctx) {
+        var _a;
+        const corpses = this.source.findCorpses(ctx.npcId, ctx.x, ctx.y, this.eatCfg.searchRadius);
+        if (corpses.length === 0) {
+            ctx.transition(this.tr.eatCorpseOnNoCorpse);
+            return;
+        }
+        const target = corpses[0];
+        // Lazy-init phase bag — zero cost for NPCs that never eat.
+        (_a = ctx.state).eatCorpsePhase ?? (_a.eatCorpsePhase = {
+            active: false,
+            corpseId: '',
+            corpseX: 0,
+            corpseY: 0,
+            healAmount: 0,
+            eatStartMs: 0,
+            eating: false,
+        });
+        const phase = ctx.state.eatCorpsePhase;
+        phase.active = true;
+        phase.corpseId = target.id;
+        phase.corpseX = target.x;
+        phase.corpseY = target.y;
+        phase.healAmount = target.healAmount;
+        phase.eatStartMs = 0;
+        phase.eating = false;
+        ctx.emitVocalization('EAT_CORPSE_START');
+    }
+    update(ctx, _deltaMs) {
+        const phase = ctx.state.eatCorpsePhase;
+        if (!phase?.active) {
+            ctx.transition(this.tr.eatCorpseOnNoCorpse);
+            return;
+        }
+        // Interrupt: enemy spotted (even while eating).
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemy = ctx.perception.getVisibleEnemies()[0];
+            ctx.state.lastKnownEnemyX = enemy.x;
+            ctx.state.lastKnownEnemyY = enemy.y;
+            ctx.state.targetId = enemy.id;
+            ctx.transition(this.tr.eatCorpseOnInterrupt);
+            return;
+        }
+        const now = ctx.now();
+        // APPROACH phase: move toward corpse until close enough.
+        if (!phase.eating) {
+            const dist = distanceTo(ctx.x, ctx.y, phase.corpseX, phase.corpseY);
+            if (dist > this.eatCfg.arriveThreshold) {
+                const speed = this.eatCfg.approachSpeed ?? this.cfg.approachSpeed;
+                moveToward(ctx, phase.corpseX, phase.corpseY, speed);
+                return;
+            }
+            // Arrived — start eating.
+            phase.eating = true;
+            phase.eatStartMs = now;
+            ctx.halt();
+            return;
+        }
+        // EATING phase: wait for duration then apply reward.
+        ctx.halt();
+        if (now - phase.eatStartMs >= this.eatCfg.eatDurationMs) {
+            // consumeCorpse returns false if another NPC already consumed this
+            // corpse during the approach/eating phase (TOCTOU race). Gate heal and
+            // morale reward on successful consumption — always transition out.
+            const consumed = this.source.consumeCorpse(ctx.npcId, phase.corpseId);
+            if (consumed) {
+                if (phase.healAmount > 0) {
+                    ctx.health?.heal(phase.healAmount);
+                }
+                ctx.state.morale = Math.min(1, Math.max(-1, ctx.state.morale + this.eatCfg.moraleBoost));
+            }
+            ctx.emitVocalization('EAT_CORPSE_DONE');
+            ctx.transition(this.tr.eatCorpseOnDone);
+        }
+    }
+    exit(ctx) {
+        if (ctx.state.eatCorpsePhase) {
+            ctx.state.eatCorpsePhase.active = false;
+        }
+    }
+}
+//# sourceMappingURL=EatCorpseState.js.map

package/dist/states/eat-corpse/EatCorpseState.js.map

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

package/dist/states/eat-corpse/EatCorpseTransitionGuard.d.ts

@@ -0,0 +1,34 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { ICorpseSource } from './ICorpseSource';
+import type { IEatCorpseGuardConfig } from './IEatCorpseConfig';
+/**
+ * Wraps an existing calm-state handler (IDLE, PATROL, CAMP, etc.) with a
+ * periodic hunger check. When the NPC's HP drops below `hungerHpThreshold`,
+ * a random roll is performed, and if corpses are nearby, the NPC transitions
+ * to `eatStateId` (default `'EAT_CORPSE'`).
+ *
+ * The inner handler's behavior is fully preserved — enter, update, and exit
+ * are all forwarded before the hunger check runs.
+ *
+ * **Memory**: stores a `Map<string, number>` (npcId → lastCheckMs) in the
+ * decorator closure. Entries are removed in `exit()` to prevent leaks.
+ *
+ * @example
+ * ```ts
+ * // Wrap IDLE and PATROL so dogs/boars look for corpses while calm:
+ * const idleWithEating = withEatCorpseGuard(handlers.get('IDLE')!, corpseSource, {
+ *   allowedEntityTypes: ['dog', 'boar'],
+ *   hungerHpThreshold: 0.7,
+ * });
+ * handlers.set('IDLE', idleWithEating);
+ * handlers.set('PATROL', withEatCorpseGuard(handlers.get('PATROL')!, corpseSource, {
+ *   allowedEntityTypes: ['dog', 'boar'],
+ * }));
+ * ```
+ *
+ * @param inner      - The handler to wrap.
+ * @param corpseSource - Host-provided corpse discovery service.
+ * @param guardCfg   - Optional config overrides.
+ */
+export declare function withEatCorpseGuard(inner: IOnlineStateHandler, corpseSource: ICorpseSource, guardCfg?: Partial<IEatCorpseGuardConfig>): IOnlineStateHandler;
+//# sourceMappingURL=EatCorpseTransitionGuard.d.ts.map

package/dist/states/eat-corpse/EatCorpseTransitionGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EatCorpseTransitionGuard.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/EatCorpseTransitionGuard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,YAAY,EAAE,aAAa,EAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACxC,mBAAmB,CAwDrB"}

package/dist/states/eat-corpse/EatCorpseTransitionGuard.js

@@ -0,0 +1,82 @@
+// states/eat-corpse/EatCorpseTransitionGuard.ts
+// Decorator that adds periodic corpse-hunger checks to calm-state handlers.
+import { createDefaultEatCorpseGuardConfig } from './IEatCorpseConfig';
+/**
+ * Wraps an existing calm-state handler (IDLE, PATROL, CAMP, etc.) with a
+ * periodic hunger check. When the NPC's HP drops below `hungerHpThreshold`,
+ * a random roll is performed, and if corpses are nearby, the NPC transitions
+ * to `eatStateId` (default `'EAT_CORPSE'`).
+ *
+ * The inner handler's behavior is fully preserved — enter, update, and exit
+ * are all forwarded before the hunger check runs.
+ *
+ * **Memory**: stores a `Map<string, number>` (npcId → lastCheckMs) in the
+ * decorator closure. Entries are removed in `exit()` to prevent leaks.
+ *
+ * @example
+ * ```ts
+ * // Wrap IDLE and PATROL so dogs/boars look for corpses while calm:
+ * const idleWithEating = withEatCorpseGuard(handlers.get('IDLE')!, corpseSource, {
+ *   allowedEntityTypes: ['dog', 'boar'],
+ *   hungerHpThreshold: 0.7,
+ * });
+ * handlers.set('IDLE', idleWithEating);
+ * handlers.set('PATROL', withEatCorpseGuard(handlers.get('PATROL')!, corpseSource, {
+ *   allowedEntityTypes: ['dog', 'boar'],
+ * }));
+ * ```
+ *
+ * @param inner      - The handler to wrap.
+ * @param corpseSource - Host-provided corpse discovery service.
+ * @param guardCfg   - Optional config overrides.
+ */
+export function withEatCorpseGuard(inner, corpseSource, guardCfg) {
+    const cfg = createDefaultEatCorpseGuardConfig(guardCfg);
+    // Per-NPC last-check timestamps, stored in decorator closure.
+    const lastCheckMs = new Map();
+    return {
+        enter(ctx) {
+            inner.enter(ctx);
+        },
+        exit(ctx) {
+            inner.exit(ctx);
+            lastCheckMs.delete(ctx.npcId);
+        },
+        update(ctx, deltaMs) {
+            // Capture current state ID before delegating so we can detect if the
+            // inner handler already triggered a transition (e.g. IDLE spotted an
+            // enemy and called ctx.transition('ALERT')). If the state changed we
+            // must bail — overriding a completed transition would cause the NPC to
+            // ignore threats and walk toward corpses during combat.
+            const stateBefore = ctx.currentStateId;
+            inner.update(ctx, deltaMs);
+            if (ctx.currentStateId !== stateBefore)
+                return;
+            // Entity-type filter (skip if this NPC type doesn't eat).
+            if (cfg.allowedEntityTypes !== null &&
+                !cfg.allowedEntityTypes.includes(ctx.entityType)) {
+                return;
+            }
+            // Throttle: only check every checkIntervalMs.
+            // Use -Infinity as sentinel so the very first call always proceeds
+            // regardless of ctx.now() value (even if it returns 0).
+            const now = ctx.now();
+            const last = lastCheckMs.get(ctx.npcId) ?? -Infinity;
+            if (now - last < cfg.checkIntervalMs)
+                return;
+            lastCheckMs.set(ctx.npcId, now);
+            // Only hungry NPCs look for food.
+            if ((ctx.health?.hpPercent ?? 1) > cfg.hungerHpThreshold)
+                return;
+            // Probabilistic roll to avoid every NPC eating at the same moment.
+            if (ctx.random() >= cfg.eatProbability)
+                return;
+            // Pre-flight corpse check — avoids EAT_CORPSE enter/exit ping-pong.
+            const corpses = corpseSource.findCorpses(ctx.npcId, ctx.x, ctx.y, cfg.searchRadius);
+            if (corpses.length === 0)
+                return;
+            ctx.transition(cfg.eatStateId);
+        },
+    };
+}
+//# sourceMappingURL=EatCorpseTransitionGuard.js.map

package/dist/states/eat-corpse/EatCorpseTransitionGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EatCorpseTransitionGuard.js","sourceRoot":"","sources":["../../../src/states/eat-corpse/EatCorpseTransitionGuard.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,4EAA4E;AAK5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA0B,EAC1B,YAA2B,EAC3B,QAAyC;IAEzC,MAAM,GAAG,GAAG,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IACxD,8DAA8D;IAC9D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,OAAO;QACL,KAAK,CAAC,GAAgB;YACpB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,GAAgB;YACnB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,MAAM,CAAC,GAAgB,EAAE,OAAe;YACtC,qEAAqE;YACrE,qEAAqE;YACrE,qEAAqE;YACrE,uEAAuE;YACvE,wDAAwD;YACxD,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC;YACvC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3B,IAAI,GAAG,CAAC,cAAc,KAAK,WAAW;gBAAE,OAAO;YAE/C,0DAA0D;YAC1D,IACE,GAAG,CAAC,kBAAkB,KAAK,IAAI;gBAC/B,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAChD,CAAC;gBACD,OAAO;YACT,CAAC;YAED,8CAA8C;YAC9C,mEAAmE;YACnE,wDAAwD;YACxD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;YACrD,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,eAAe;gBAAE,OAAO;YAC7C,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAEhC,kCAAkC;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,iBAAiB;gBAAE,OAAO;YAEjE,mEAAmE;YACnE,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,cAAc;gBAAE,OAAO;YAE/C,oEAAoE;YACpE,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAC1C,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAEjC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/states/eat-corpse/ICorpseSource.d.ts

@@ -0,0 +1,87 @@
+/**
+ * A single corpse available for consumption.
+ *
+ * Populated by the host from its own entity system.
+ * `healAmount` is per-corpse so different enemy types can yield
+ * different rewards (e.g. boar corpse > dog corpse).
+ * `corpseType` is a passthrough tag — the SDK ignores it, but the host
+ * may use it inside `findCorpses()` to filter by edibility.
+ */
+export interface ICorpseRecord {
+    /** Stable entity ID of the corpse. */
+    readonly id: string;
+    /** World X of the corpse (px). */
+    readonly x: number;
+    /** World Y of the corpse (px). */
+    readonly y: number;
+    /**
+     * HP to restore to the eating NPC on successful consumption.
+     * 0 means no HP reward (morale boost still applies).
+     */
+    readonly healAmount: number;
+    /**
+     * Optional tag for host-side filtering (e.g. 'human', 'animal').
+     * The SDK never reads this field.
+     */
+    readonly corpseType?: string;
+}
+/**
+ * Callback interface the host injects into `EatCorpseState`.
+ *
+ * Mirrors the `emitMeleeHit()` / `emitShoot()` pattern:
+ * the SDK declares intent (`consumeCorpse`) and the host executes the
+ * side-effect (entity removal, loot drop, etc.).
+ *
+ * @example
+ * ```ts
+ * // Phaser layer implementation:
+ * const corpseSource: ICorpseSource = {
+ *   findCorpses(npcId, x, y, radius) {
+ *     return spatialGrid.query(x, y, radius)
+ *       .filter(e => e.type === 'corpse')
+ *       .map(e => ({ id: e.id, x: e.x, y: e.y, healAmount: 20 }));
+ *   },
+ *   consumeCorpse(_npcId, corpseId) {
+ *     const entity = scene.getEntityById(corpseId);
+ *     if (!entity) return false;
+ *     entity.destroy();
+ *     return true;
+ *   },
+ * };
+ * ```
+ */
+export interface ICorpseSource {
+    /**
+     * Return corpses within `radius` px of the NPC, sorted nearest-first.
+     *
+     * @param npcId  - ID of the requesting NPC (for ownership checks if needed).
+     * @param x      - Searcher world X.
+     * @param y      - Searcher world Y.
+     * @param radius - Search radius (px).
+     */
+    findCorpses(npcId: string, x: number, y: number, radius: number): ReadonlyArray<ICorpseRecord>;
+    /**
+     * Mark a corpse as consumed (remove it from the world).
+     *
+     * Called by `EatCorpseState` after the eating timer completes.
+     * If `corpseId` was already removed (race with another NPC or despawn),
+     * return `false` — the SDK will skip the heal and morale reward.
+     *
+     * @param npcId    - ID of the consuming NPC.
+     * @param corpseId - ID of the corpse to remove.
+     * @returns `true` if the corpse was successfully consumed, `false` if it
+     *          was already gone (duplicate eat, early despawn, etc.).
+     *
+     * @example
+     * ```ts
+     * consumeCorpse(_npcId, corpseId) {
+     *   const entity = scene.getEntityById(corpseId);
+     *   if (!entity) return false;
+     *   entity.destroy();
+     *   return true;
+     * },
+     * ```
+     */
+    consumeCorpse(npcId: string, corpseId: string): boolean;
+}
+//# sourceMappingURL=ICorpseSource.d.ts.map

package/dist/states/eat-corpse/ICorpseSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICorpseSource.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/ICorpseSource.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,aAAa,CAAC,CAAC;IAEhC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACzD"}

package/dist/states/eat-corpse/ICorpseSource.js

@@ -0,0 +1,5 @@
+// states/eat-corpse/ICorpseSource.ts
+// Host-implemented corpse discovery and consumption interface.
+// The SDK never creates, stores, or destroys corpse records.
+export {};
+//# sourceMappingURL=ICorpseSource.js.map

package/dist/states/eat-corpse/ICorpseSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICorpseSource.js","sourceRoot":"","sources":["../../../src/states/eat-corpse/ICorpseSource.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,+DAA+D;AAC/D,6DAA6D"}

package/dist/states/eat-corpse/IEatCorpseConfig.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Tuning parameters for the EAT_CORPSE state handler.
+ *
+ * All distances are in world pixels; all durations in milliseconds.
+ */
+export interface IEatCorpseConfig {
+    /**
+     * Radius (px) to search for corpses on `enter()`.
+     * @default 250
+     */
+    readonly searchRadius: number;
+    /**
+     * How long the NPC spends eating before the corpse is consumed (ms).
+     * @default 4_000
+     */
+    readonly eatDurationMs: number;
+    /**
+     * Approach speed toward the corpse (px/s).
+     * When omitted, falls back to `IStateConfig.approachSpeed`.
+     */
+    readonly approachSpeed?: number;
+    /**
+     * Distance threshold at which the NPC is considered "at" the corpse (px).
+     * @default 24
+     */
+    readonly arriveThreshold: number;
+    /**
+     * Additive morale bonus applied on successful consumption.
+     * Clamped to [-1, 1] after addition.
+     * @default 0.15
+     */
+    readonly moraleBoost: number;
+}
+export declare function createDefaultEatCorpseConfig(overrides?: Partial<IEatCorpseConfig>): IEatCorpseConfig;
+/**
+ * Tuning parameters for `withEatCorpseGuard()`.
+ */
+export interface IEatCorpseGuardConfig {
+    /**
+     * Interval between hunger checks (ms). Controls how often `findCorpses` is
+     * called from within calm states (IDLE / PATROL).
+     * @default 5_000
+     */
+    readonly checkIntervalMs: number;
+    /**
+     * HP fraction at or below which the NPC considers eating.
+     * 1.0 = always hungry; 0.0 = never hungry.
+     * @default 0.7
+     */
+    readonly hungerHpThreshold: number;
+    /**
+     * Probability [0, 1) of transitioning to EAT_CORPSE when conditions are met.
+     * Sampled via `ctx.random()`.
+     * @default 0.4
+     */
+    readonly eatProbability: number;
+    /**
+     * Radius (px) used in the guard's pre-flight `findCorpses` check.
+     * Should match or exceed `IEatCorpseConfig.searchRadius`.
+     * @default 250
+     */
+    readonly searchRadius: number;
+    /**
+     * State ID to transition to when the guard triggers.
+     * @default 'EAT_CORPSE'
+     */
+    readonly eatStateId: string;
+    /**
+     * Entity types allowed to trigger the guard, or null to allow all.
+     * @default null
+     */
+    readonly allowedEntityTypes: ReadonlyArray<string> | null;
+}
+export declare function createDefaultEatCorpseGuardConfig(overrides?: Partial<IEatCorpseGuardConfig>): IEatCorpseGuardConfig;
+//# sourceMappingURL=IEatCorpseConfig.d.ts.map

package/dist/states/eat-corpse/IEatCorpseConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEatCorpseConfig.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/IEatCorpseConfig.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAQlB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACzC,qBAAqB,CAUvB"}

package/dist/states/eat-corpse/IEatCorpseConfig.js

@@ -0,0 +1,23 @@
+// states/eat-corpse/IEatCorpseConfig.ts
+// Configuration for EatCorpseState and withEatCorpseGuard.
+export function createDefaultEatCorpseConfig(overrides) {
+    return {
+        searchRadius: 250,
+        eatDurationMs: 4000,
+        arriveThreshold: 24,
+        moraleBoost: 0.15,
+        ...overrides,
+    };
+}
+export function createDefaultEatCorpseGuardConfig(overrides) {
+    return {
+        checkIntervalMs: 5000,
+        hungerHpThreshold: 0.7,
+        eatProbability: 0.4,
+        searchRadius: 250,
+        eatStateId: 'EAT_CORPSE',
+        allowedEntityTypes: null,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=IEatCorpseConfig.js.map

package/dist/states/eat-corpse/IEatCorpseConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEatCorpseConfig.js","sourceRoot":"","sources":["../../../src/states/eat-corpse/IEatCorpseConfig.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,2DAA2D;AAwC3D,MAAM,UAAU,4BAA4B,CAC1C,SAAqC;IAErC,OAAO;QACL,YAAY,EAAE,GAAG;QACjB,aAAa,EAAE,IAAK;QACpB,eAAe,EAAE,EAAE;QACnB,WAAW,EAAE,IAAI;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAmDD,MAAM,UAAU,iCAAiC,CAC/C,SAA0C;IAE1C,OAAO;QACL,eAAe,EAAE,IAAK;QACtB,iBAAiB,EAAE,GAAG;QACtB,cAAc,EAAE,GAAG;QACnB,YAAY,EAAE,GAAG;QACjB,UAAU,EAAE,YAAY;QACxB,kBAAkB,EAAE,IAAI;QACxB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/states/eat-corpse/IEatCorpsePhase.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Mutable phase data stored in `INPCOnlineState.eatCorpsePhase`.
+ *
+ * Lazy-initialised by `EatCorpseState.enter()` via the `??=` operator;
+ * zero-cost for NPCs that never enter EAT_CORPSE.
+ */
+export interface IEatCorpsePhase {
+    /** Whether the eat sequence is currently active. */
+    active: boolean;
+    /** Stable entity ID of the target corpse. */
+    corpseId: string;
+    /** World X of the target corpse (set once in enter). */
+    corpseX: number;
+    /** World Y of the target corpse (set once in enter). */
+    corpseY: number;
+    /** HP reward to apply on completion (copied from ICorpseRecord.healAmount). */
+    healAmount: number;
+    /** ctx.now() when the eating phase began (0 while still approaching). */
+    eatStartMs: number;
+    /** True once the NPC has arrived at the corpse and started eating. */
+    eating: boolean;
+}
+//# sourceMappingURL=IEatCorpsePhase.d.ts.map

package/dist/states/eat-corpse/IEatCorpsePhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEatCorpsePhase.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/IEatCorpsePhase.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/states/eat-corpse/IEatCorpsePhase.js

@@ -0,0 +1,5 @@
+// states/eat-corpse/IEatCorpsePhase.ts
+// Per-NPC mutable phase data for the EAT_CORPSE state.
+// Follows the same pattern as IChargePhase, IStalkPhase, etc.
+export {};
+//# sourceMappingURL=IEatCorpsePhase.js.map

package/dist/states/eat-corpse/IEatCorpsePhase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEatCorpsePhase.js","sourceRoot":"","sources":["../../../src/states/eat-corpse/IEatCorpsePhase.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uDAAuD;AACvD,8DAA8D"}

package/dist/states/eat-corpse/index.d.ts

@@ -0,0 +1,7 @@
+export type { ICorpseRecord, ICorpseSource } from './ICorpseSource';
+export type { IEatCorpsePhase } from './IEatCorpsePhase';
+export type { IEatCorpseConfig, IEatCorpseGuardConfig } from './IEatCorpseConfig';
+export { createDefaultEatCorpseConfig, createDefaultEatCorpseGuardConfig } from './IEatCorpseConfig';
+export { EatCorpseState } from './EatCorpseState';
+export { withEatCorpseGuard } from './EatCorpseTransitionGuard';
+//# sourceMappingURL=index.d.ts.map

package/dist/states/eat-corpse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/states/eat-corpse/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}