@alife-sdk/ai 0.1.0

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

@@ -0,0 +1,11 @@
+// states/eat-corpse — opt-in corpse-eating behavior module.
+//
+// Import explicitly to opt in:
+//   import { EatCorpseState, withEatCorpseGuard } from '@alife-sdk/ai/states/eat-corpse';
+//
+// Never imported by buildDefaultHandlerMap or buildMonsterHandlerMap.
+// Zero bundle cost for projects that do not use this module.
+export { createDefaultEatCorpseConfig, createDefaultEatCorpseGuardConfig } from './IEatCorpseConfig';
+export { EatCorpseState } from './EatCorpseState';
+export { withEatCorpseGuard } from './EatCorpseTransitionGuard';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/states/eat-corpse/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,+BAA+B;AAC/B,0FAA0F;AAC1F,EAAE;AACF,sEAAsE;AACtE,6DAA6D;AAK7D,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"}

package/dist/states/handlers/AlertState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless alert-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class AlertState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(_ctx: INPCContext): void;
+}
+//# sourceMappingURL=AlertState.d.ts.map

package/dist/states/handlers/AlertState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/AlertState.ts"],"names":[],"mappings":"AAcA,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;AAGlE;;;;GAIG;AACH,qBAAa,UAAW,YAAW,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAc7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAyEhD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/AlertState.js

@@ -0,0 +1,104 @@
+// states/handlers/AlertState.ts
+// NPC heard something (gunshot, sound) and investigates the source.
+// Upgrades to COMBAT when the enemy is directly spotted; reverts to PATROL
+// if the alert timer expires without finding anyone.
+//
+// Morale-aware:
+//   - PANICKED NPC → skip investigation, flee immediately (FLEE).
+//
+// Transitions out of ALERT:
+//   - morale is PANICKED                        → FLEE
+//   - visible enemy spotted                     → COMBAT
+//   - alert timer (cfg.alertDuration) expired   → PATROL
+//   - arrived at last known position            → wait in place until timer
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless alert-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class AlertState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.alertStartMs = ctx.now();
+        ctx.halt();
+        // Pack alert broadcast (opt-in)
+        if (ctx.state.lastKnownEnemyX !== 0 || ctx.state.lastKnownEnemyY !== 0) {
+            ctx.pack?.broadcastTarget(ctx.state.targetId, ctx.state.lastKnownEnemyX, ctx.state.lastKnownEnemyY);
+            ctx.pack?.broadcastAlertLevel('ALERTED');
+        }
+    }
+    update(ctx, _deltaMs) {
+        // --- Morale check: panicked NPC flees immediately ---
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.transition(this.tr.alertOnPanic);
+            return;
+        }
+        // --- Perception: visible enemy → COMBAT (or KILL_WOUNDED if wounded, opt-in) ---
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            // Kill-wounded seam (opt-in) — only when morale is STABLE
+            if (ctx.state.moraleState === 'STABLE') {
+                const woundedEnemies = ctx.perception?.getWoundedEnemies?.() ?? [];
+                if (woundedEnemies.length > 0) {
+                    const we = woundedEnemies[0];
+                    ctx.state.killWoundedTargetId = we.id;
+                    ctx.state.killWoundedTargetX = we.x;
+                    ctx.state.killWoundedTargetY = we.y;
+                    ctx.transition(this.tr.alertOnKillWounded);
+                    return;
+                }
+            }
+            ctx.transition(this.tr.alertOnEnemy);
+            return;
+        }
+        // --- Pack combat fast-path (opt-in): skip alert timer when pack is already fighting ---
+        if (ctx.pack?.getPackAlertLevel() === 'COMBAT') {
+            const pt = ctx.pack.getPackTarget();
+            if (pt) {
+                ctx.state.lastKnownEnemyX = pt.x;
+                ctx.state.lastKnownEnemyY = pt.y;
+                ctx.state.targetId = pt.id;
+            }
+            ctx.transition(this.tr.alertOnPackCombat);
+            return;
+        }
+        // --- Timer countdown ---
+        const elapsed = ctx.now() - ctx.state.alertStartMs;
+        if (elapsed >= this.cfg.alertDuration) {
+            ctx.halt();
+            ctx.transition(this.tr.alertOnTimeout);
+            return;
+        }
+        // --- Move toward last known position ---
+        const targetX = ctx.state.lastKnownEnemyX;
+        const targetY = ctx.state.lastKnownEnemyY;
+        const dx = targetX - ctx.x;
+        const dy = targetY - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const thresh = this.cfg.arriveThreshold;
+        if (distSq <= thresh * thresh) {
+            // Reached the sound source; nothing found — wait for timer.
+            ctx.halt();
+            // Face the direction we were heading (last known angle).
+            if (targetX !== ctx.x || targetY !== ctx.y) {
+                ctx.setRotation(Math.atan2(targetY - ctx.y, targetX - ctx.x));
+            }
+        }
+        else {
+            moveToward(ctx, targetX, targetY, this.cfg.approachSpeed);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    exit(_ctx) {
+        // Nothing to clean up.
+    }
+}
+//# sourceMappingURL=AlertState.js.map

package/dist/states/handlers/AlertState.js.map

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

package/dist/states/handlers/CampState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless camp-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class CampState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=CampState.d.ts.map

package/dist/states/handlers/CampState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CampState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/CampState.ts"],"names":[],"mappings":"AAaA,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;AAOlE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,mBAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAa7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqDhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAM7B"}

package/dist/states/handlers/CampState.js

@@ -0,0 +1,94 @@
+// states/handlers/CampState.ts
+// NPC sits at a rest point with reduced vigilance (camp/guard post behavior).
+//
+// Behavior:
+//   - NPC stays stationary at the camp spot.
+//   - Reactions to visible enemies are delayed by cfg.schemeReactionDelayMs
+//     (simulates lower alertness while at rest).
+//   - No delay for danger-zone reactions (immediate relocation).
+//
+// Transitions out of CAMP:
+//   - visible enemy (after schemeReactionDelayMs delay) → COMBAT
+//   - NPC inside an inaccessible/restricted zone        → ALERT (walk away first)
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+// Internal flag stored in ctx.state.psiPhaseStartMs repurposed as the
+// reaction-pending timer timestamp. We use a sentinel value of 0 for "none".
+const NO_PENDING_REACTION = 0;
+/**
+ * Stateless camp-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class CampState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.halt();
+        // Reset the reaction timer (no pending delayed reaction on entry).
+        // We repurpose evadeStartMs as a scheme-reaction start timestamp.
+        ctx.state.evadeStartMs = NO_PENDING_REACTION;
+        // Emit a camp vocalization if a vocalization cooldown allows.
+        const now = ctx.now();
+        if (now - ctx.state.lastVocalizationMs >= this.cfg.meleeCooldownMs * 3) {
+            ctx.emitVocalization('CAMP_IDLE');
+            ctx.state.lastVocalizationMs = now;
+        }
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // --- Pending delayed-reaction processing ---
+        const reactionStart = ctx.state.evadeStartMs;
+        if (reactionStart !== NO_PENDING_REACTION) {
+            if (now - reactionStart >= this.cfg.schemeReactionDelayMs) {
+                // Delay elapsed — execute the queued transition.
+                // The target state is encoded in ctx.state.isAlert:
+                //   true  → COMBAT
+                //   false → ALERT
+                ctx.state.evadeStartMs = NO_PENDING_REACTION;
+                ctx.transition(ctx.state.isAlert ? this.tr.campOnEnemy : this.tr.campOnDanger);
+                return;
+            }
+            // Still waiting for delay — do nothing else this frame.
+            return;
+        }
+        // --- Visible enemy → queue delayed COMBAT reaction ---
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            ctx.state.isAlert = true;
+            ctx.state.evadeStartMs = now;
+            return;
+        }
+        // --- Restricted zone check (immediate — no delay for danger zones) ---
+        if (ctx.restrictedZones !== null && !ctx.restrictedZones.isAccessible(ctx.x, ctx.y)) {
+            const step = this.cfg.approachSpeed * 2;
+            const candidates = [
+                { x: ctx.x + step, y: ctx.y },
+                { x: ctx.x - step, y: ctx.y },
+                { x: ctx.x, y: ctx.y + step },
+                { x: ctx.x, y: ctx.y - step },
+            ];
+            const safe = ctx.restrictedZones.filterAccessible(candidates);
+            if (safe.length > 0) {
+                const dest = safe[0];
+                ctx.state.lastKnownEnemyX = dest.x;
+                ctx.state.lastKnownEnemyY = dest.y;
+                moveToward(ctx, dest.x, dest.y, this.cfg.approachSpeed);
+            }
+            ctx.transition(this.tr.campOnDanger);
+            return;
+        }
+    }
+    exit(ctx) {
+        // Clear any pending delayed reaction so it doesn't leak into the next
+        // activation of this state.
+        ctx.state.evadeStartMs = NO_PENDING_REACTION;
+        ctx.state.isAlert = false;
+    }
+}
+//# sourceMappingURL=CampState.js.map

package/dist/states/handlers/CampState.js.map

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

package/dist/states/handlers/ChargeState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless boar charge-attack handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class ChargeState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=ChargeState.d.ts.map

package/dist/states/handlers/ChargeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChargeState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/ChargeState.ts"],"names":[],"mappings":"AAgBA,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;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE;;;;GAIG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IAInD,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAGtB,GAAG,EAAE,YAAY,EAClC,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKnC,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IA2B7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsDhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/handlers/ChargeState.js

@@ -0,0 +1,103 @@
+// states/handlers/ChargeState.ts
+// Boar exclusive straight-line charge attack state.
+//
+// Phase pipeline (stored in ctx.state.chargePhase):
+//   WINDUP  — entity stops during telegraph pause; counts down chargeWindupMs.
+//             Target position is locked at enter() time.
+//   CHARGE  — entity moves toward stored target at approachSpeed × chargeSpeedMultiplier.
+//             Impact: dist <= meleeRange → emitMeleeHit(chargeDamageMultiplier), then COMBAT.
+//   Exit    — resets active flag; host caller may also halt movement.
+//
+// Early abort:
+//   - Windup phase with no visible enemy → transition to IDLE (tr.chargeOnAbort).
+//
+// All mutable state lives in INPCOnlineState.chargePhase so this handler is
+// stateless and safe to share across all NPC entities.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward, distanceTo } from './_utils';
+/**
+ * Stateless boar charge-attack handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class ChargeState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        var _a;
+        const now = ctx.now();
+        // Lock the target position from the first visible enemy or last known pos.
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const targetX = enemies.length > 0 ? enemies[0].x : ctx.state.lastKnownEnemyX;
+        const targetY = enemies.length > 0 ? enemies[0].y : ctx.state.lastKnownEnemyY;
+        // Lazy-initialise charge phase data if not yet present.
+        (_a = ctx.state).chargePhase ?? (_a.chargePhase = { active: false, windupStartMs: 0, charging: false, targetX: 0, targetY: 0 });
+        ctx.state.chargePhase.active = true;
+        ctx.state.chargePhase.charging = false;
+        ctx.state.chargePhase.windupStartMs = now;
+        ctx.state.chargePhase.targetX = targetX;
+        ctx.state.chargePhase.targetY = targetY;
+        // Stop completely during the windup telegraph.
+        ctx.halt();
+        // Face the target while winding up.
+        const dx = targetX - ctx.x;
+        const dy = targetY - ctx.y;
+        if (dx !== 0 || dy !== 0) {
+            ctx.setRotation(Math.atan2(dy, dx));
+        }
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        const phase = ctx.state.chargePhase;
+        const elapsed = now - phase.windupStartMs;
+        if (!phase.charging) {
+            // -----------------------------------------------------------------------
+            // WINDUP phase — wait for chargeWindupMs before launching charge
+            // -----------------------------------------------------------------------
+            // Safety: if no visible enemy and not yet charging, abort.
+            const hasEnemy = ctx.perception?.hasVisibleEnemy() ?? false;
+            if (!hasEnemy) {
+                ctx.transition(this.tr.chargeOnAbort);
+                return;
+            }
+            if (elapsed < this.cfg.chargeWindupMs) {
+                // Still winding up — face target but don't move.
+                const dx = phase.targetX - ctx.x;
+                const dy = phase.targetY - ctx.y;
+                if (dx !== 0 || dy !== 0) {
+                    ctx.setRotation(Math.atan2(dy, dx));
+                }
+                return;
+            }
+            // Windup complete — transition to charging phase.
+            phase.charging = true;
+        }
+        // -----------------------------------------------------------------------
+        // CHARGING phase — move toward locked target at charge speed
+        // -----------------------------------------------------------------------
+        const chargeSpeed = this.cfg.approachSpeed * this.cfg.chargeSpeedMultiplier;
+        const dist = distanceTo(ctx.x, ctx.y, phase.targetX, phase.targetY);
+        if (dist <= this.cfg.meleeRange) {
+            // Impact — apply charge damage and return to COMBAT.
+            ctx.state.lastMeleeMs = now;
+            ctx.emitMeleeHit({
+                npcId: ctx.npcId,
+                targetId: ctx.state.targetId ?? '',
+                damage: this.cfg.meleeDamage * this.cfg.chargeDamageMultiplier,
+            });
+            ctx.halt();
+            ctx.transition(this.tr.chargeOnComplete);
+            return;
+        }
+        // Continue charging toward the locked target.
+        moveToward(ctx, phase.targetX, phase.targetY, chargeSpeed);
+    }
+    exit(ctx) {
+        if (ctx.state.chargePhase) {
+            ctx.state.chargePhase.active = false;
+        }
+    }
+}
+//# sourceMappingURL=ChargeState.js.map

package/dist/states/handlers/ChargeState.js.map

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

package/dist/states/handlers/CombatState.d.ts

@@ -0,0 +1,19 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless combat state handler for human NPCs.
+ *
+ * Monsters use a separate controller (MonsterCombatController from Slice 14).
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class CombatState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(_ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(_ctx: INPCContext): void;
+}
+//# sourceMappingURL=CombatState.d.ts.map

package/dist/states/handlers/CombatState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombatState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/CombatState.ts"],"names":[],"mappings":"AAgBA,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;AAGlE;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI9B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiHhD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/CombatState.js

@@ -0,0 +1,137 @@
+// states/handlers/CombatState.ts
+// Human NPC actively engages a visible enemy.
+//
+// Logic:
+//   enter  — nothing special (vocalization handled by caller if needed)
+//   update —
+//     1. No visible enemy → SEARCH (if lastKnown known) or IDLE
+//     2. Morale PANICKED  → FLEE
+//     3. Morale SHAKEN    → RETREAT
+//     4. HP below woundedHpThreshold → WOUNDED
+//     5. Visible enemy wounded (STABLE morale, opt-in) → KILL_WOUNDED
+//     6. Move toward enemy when dist > combatRange, otherwise halt + check cover
+//     7. Fire when cooldown elapsed
+//     8. Share target with squad if available
+//   exit   — nothing
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless combat state handler for human NPCs.
+ *
+ * Monsters use a separate controller (MonsterCombatController from Slice 14).
+ * A single instance can be shared across all NPC entities.
+ */
+export class CombatState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(_ctx) {
+        // No special enter action — caller may emit vocalization if desired.
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // -------------------------------------------------------------------------
+        // 1. Perception: resolve visible enemy
+        // -------------------------------------------------------------------------
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const hasEnemy = enemies.length > 0;
+        if (!hasEnemy) {
+            // No visual contact — transition based on whether a last position is known.
+            if (ctx.state.lastKnownEnemyX !== 0 || ctx.state.lastKnownEnemyY !== 0) {
+                ctx.transition(this.tr.combatOnLastKnown);
+            }
+            else {
+                ctx.transition(this.tr.combatOnNoEnemy);
+            }
+            return;
+        }
+        // Update last known enemy position from the closest visible enemy.
+        const enemy = enemies[0];
+        ctx.state.lastKnownEnemyX = enemy.x;
+        ctx.state.lastKnownEnemyY = enemy.y;
+        // -------------------------------------------------------------------------
+        // 2. Morale checks (highest priority after target acquisition)
+        // -------------------------------------------------------------------------
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.transition(this.tr.combatOnPanicked);
+            return;
+        }
+        if (ctx.state.moraleState === 'SHAKEN') {
+            ctx.transition(this.tr.combatOnShaken);
+            return;
+        }
+        // -------------------------------------------------------------------------
+        // 3. HP threshold — wounded
+        // -------------------------------------------------------------------------
+        if (ctx.health !== null) {
+            if (ctx.health.hpPercent < this.cfg.woundedHpThreshold) {
+                ctx.transition(this.tr.combatOnWounded);
+                return;
+            }
+        }
+        // -------------------------------------------------------------------------
+        // 4. Kill-wounded seam (opt-in) — only when morale is STABLE
+        // -------------------------------------------------------------------------
+        const woundedEnemies = ctx.perception?.getWoundedEnemies?.() ?? [];
+        if (woundedEnemies.length > 0) {
+            const we = woundedEnemies[0];
+            ctx.state.killWoundedTargetId = we.id;
+            ctx.state.killWoundedTargetX = we.x;
+            ctx.state.killWoundedTargetY = we.y;
+            ctx.state.lastKnownEnemyX = we.x;
+            ctx.state.lastKnownEnemyY = we.y;
+            ctx.halt();
+            ctx.transition(this.tr.combatOnKillWounded);
+            return;
+        }
+        // -------------------------------------------------------------------------
+        // 5. Movement — approach or halt
+        // -------------------------------------------------------------------------
+        const dx = enemy.x - ctx.x;
+        const dy = enemy.y - ctx.y;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        if (dist > this.cfg.combatRange) {
+            moveToward(ctx, enemy.x, enemy.y, this.cfg.approachSpeed);
+        }
+        else {
+            ctx.halt();
+            ctx.setRotation(Math.atan2(dy, dx));
+            // Check cover transition when already in combat range.
+            if (ctx.cover !== null) {
+                const coverPt = ctx.cover.findCover(ctx.x, ctx.y, enemy.x, enemy.y, 'CLOSE');
+                if (coverPt !== null) {
+                    ctx.state.coverPointX = coverPt.x;
+                    ctx.state.coverPointY = coverPt.y;
+                    ctx.transition(this.tr.combatOnCover);
+                    return;
+                }
+            }
+        }
+        // -------------------------------------------------------------------------
+        // 7. Fire when cooldown elapsed
+        // -------------------------------------------------------------------------
+        if (now - ctx.state.lastShootMs >= this.cfg.fireRateMs) {
+            ctx.state.lastShootMs = now;
+            const weaponType = ctx.state.primaryWeapon ?? 'rifle';
+            ctx.emitShoot({
+                npcId: ctx.npcId,
+                x: ctx.x,
+                y: ctx.y,
+                targetX: enemy.x,
+                targetY: enemy.y,
+                weaponType,
+            });
+        }
+        // -------------------------------------------------------------------------
+        // 8. Share target with squad
+        // -------------------------------------------------------------------------
+        if (ctx.squad !== null) {
+            ctx.squad.shareTarget(enemy.id, enemy.x, enemy.y);
+        }
+    }
+    exit(_ctx) {
+        // Nothing to clean up.
+    }
+}
+//# sourceMappingURL=CombatState.js.map

package/dist/states/handlers/CombatState.js.map

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

package/dist/states/handlers/CombatTransitionHandler.d.ts

@@ -0,0 +1,34 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+import type { ICombatTransitionConfig, ITransitionRule } from '../../combat/CombatTransitionChain';
+/**
+ * Stateless combat-transition coordinator handler.
+ *
+ * Consumes the pure-function CombatTransitionChain and bridges it to the
+ * INPCContext facade so any state handler can delegate complex transition
+ * evaluation without duplicating rule logic.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class CombatTransitionHandler implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly transitionCfg;
+    private readonly rules;
+    constructor(cfg: IStateConfig, transitionCfgOverrides?: Partial<ICombatTransitionConfig>, rules?: readonly ITransitionRule[], _tr?: Partial<IStateTransitionMap>);
+    enter(_ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(_ctx: INPCContext): void;
+    /**
+     * Build a framework-agnostic ICombatContext snapshot from INPCContext.
+     */
+    private _buildSnapshot;
+    /**
+     * Build a minimal INPCLoadout from the NPC's state bag.
+     * Returns a loadout with no weapons when the state has no weapon info,
+     * which signals the chain to fall back to default behaviour.
+     */
+    private _buildLoadout;
+}
+//# sourceMappingURL=CombatTransitionHandler.d.ts.map

package/dist/states/handlers/CombatTransitionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CombatTransitionHandler.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/CombatTransitionHandler.ts"],"names":[],"mappings":"AAYA,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;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAMlE,OAAO,KAAK,EAEV,uBAAuB,EACvB,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAI5C;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAK/D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAGhC,GAAG,EAAE,YAAY,EAClC,sBAAsB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,EACzD,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,EAElC,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAUpC,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI9B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQhD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAQ7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiEtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAkCtB"}