@alife-sdk/ai 0.1.0

package/dist/states/handlers/CombatTransitionHandler.js

@@ -0,0 +1,137 @@
+// states/handlers/CombatTransitionHandler.ts
+// Coordinator that wraps the pure-function CombatTransitionChain for use as a
+// state handler.
+//
+// Bridges INPCContext → ICombatContext so the existing SDK logic can evaluate
+// all priority-ordered transition rules and return the appropriate next state.
+//
+// enter:  nothing
+// update: build ICombatContext snapshot from ctx, run evaluateTransitions(),
+//         call ctx.transition() if a rule fires
+// exit:   nothing
+import { evaluateTransitions, createDefaultCombatTransitionConfig, DEFAULT_COMBAT_RULES, } from '../../combat/CombatTransitionChain';
+import { WeaponCategory } from '../../types/IWeaponTypes';
+/**
+ * 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 class CombatTransitionHandler {
+    constructor(cfg, transitionCfgOverrides, rules, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _tr) {
+        this.cfg = cfg;
+        this.transitionCfg = createDefaultCombatTransitionConfig({
+            woundedHpThreshold: cfg.woundedHpThreshold,
+            retreatMoraleThreshold: cfg.retreatMoraleThreshold,
+            ...transitionCfgOverrides,
+        });
+        this.rules = rules ?? DEFAULT_COMBAT_RULES;
+    }
+    enter(_ctx) {
+        // Nothing to set up.
+    }
+    update(ctx, _deltaMs) {
+        const snapshot = this._buildSnapshot(ctx);
+        const next = evaluateTransitions(this.rules, snapshot, this.transitionCfg);
+        if (next !== null) {
+            ctx.transition(next);
+        }
+    }
+    exit(_ctx) {
+        // Nothing to clean up.
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Build a framework-agnostic ICombatContext snapshot from INPCContext.
+     */
+    _buildSnapshot(ctx) {
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const enemy = enemies[0] ?? null;
+        const hpRatio = ctx.health !== null
+            ? ctx.health.hpPercent
+            : 1;
+        const moraleValue = ctx.state.morale;
+        const isPanicked = ctx.state.moraleState === 'PANICKED';
+        // Lost sight: if no visible enemy, estimate time since last known position.
+        // We treat lastShootMs as a proxy for "last active combat tick". If there is
+        // a visible enemy, lostSightMs = 0.
+        const lostSightMs = enemy !== null
+            ? 0
+            : (ctx.state.lastShootMs > 0 ? ctx.now() - ctx.state.lastShootMs : Infinity);
+        const distanceToEnemy = enemy !== null
+            ? Math.sqrt(Math.pow(enemy.x - ctx.x, 2) + Math.pow(enemy.y - ctx.y, 2))
+            : Math.sqrt(Math.pow(ctx.state.lastKnownEnemyX - ctx.x, 2) +
+                Math.pow(ctx.state.lastKnownEnemyY - ctx.y, 2));
+        // Target-inertia: can switch target if lock expired.
+        const canSwitchTarget = ctx.now() >= ctx.state.targetLockUntilMs;
+        // Explosive danger check via danger subsystem.
+        const hasExplosiveDanger = ctx.danger?.getGrenadeDanger(ctx.x, ctx.y)?.active ?? false;
+        // Build a minimal loadout from state bag.
+        const loadout = this._buildLoadout(ctx);
+        // Has ammo if primary or secondary has ammo, or we have no loadout (default: has ammo).
+        const hasAmmo = (loadout.primary !== null && loadout.primary.ammo > 0) ||
+            (loadout.secondary !== null && loadout.secondary.ammo > 0) ||
+            (loadout.primary === null && loadout.secondary === null);
+        // Time since wounded: use woundedStartMs as a proxy.
+        const timeSinceWoundedMs = ctx.state.woundedStartMs > 0
+            ? ctx.now() - ctx.state.woundedStartMs
+            : Infinity;
+        return {
+            hpRatio,
+            moraleValue,
+            isPanicked,
+            lostSightMs,
+            distanceToEnemy,
+            visibleEnemyCount: enemies.length,
+            loadout,
+            canSwitchTarget,
+            timeSinceWoundedMs,
+            hasExplosiveDanger,
+            hasAmmo,
+        };
+    }
+    /**
+     * 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.
+     */
+    _buildLoadout(ctx) {
+        const primaryWeapon = ctx.state.primaryWeapon;
+        const secondaryWeapon = ctx.state.secondaryWeapon;
+        // Create minimal weapon slots with reasonable defaults when weapon type is known.
+        const primary = primaryWeapon !== null
+            ? {
+                category: WeaponCategory.RIFLE,
+                ammo: 30,
+                maxAmmo: 30,
+                range: { min: 100, max: 400 },
+                damage: this.cfg.bulletDamage,
+                fireRate: 1,
+            }
+            : null;
+        const secondary = secondaryWeapon !== null
+            ? {
+                category: WeaponCategory.PISTOL,
+                ammo: 15,
+                maxAmmo: 15,
+                range: { min: 0, max: 200 },
+                damage: this.cfg.bulletDamage * 0.7,
+                fireRate: 1,
+            }
+            : null;
+        return {
+            primary,
+            secondary,
+            grenades: ctx.state.grenadeCount,
+            medkits: ctx.state.medkitCount,
+        };
+    }
+}
+//# sourceMappingURL=CombatTransitionHandler.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeadState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/DeadState.ts"],"names":[],"mappings":"AAUA,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;AAElE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,mBAAmB;gBAKvC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAElE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAM7B,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAI9B"}

package/dist/states/handlers/DeadState.js

@@ -0,0 +1,35 @@
+// states/handlers/DeadState.ts
+// Terminal state — the NPC is dead.
+//
+// enter()  — halts velocity and disables the physics body so the corpse no
+//             longer participates in collisions.
+// update() — deliberate no-op: the entity will be cleaned up by the host.
+//             Any AI tick that reaches a dead NPC is silently swallowed.
+// exit()   — safety no-op; the FSM should never leave DEAD under normal
+//             operation, but implementations are allowed to resurrect NPCs.
+/**
+ * Stateless dead-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class DeadState {
+    // IStateConfig and IStateTransitionMap are accepted but not used in this
+    // terminal state — kept for constructor signature consistency with all other
+    // handlers.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    constructor(_cfg, _tr) { }
+    enter(ctx) {
+        ctx.halt();
+        ctx.disablePhysics();
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    update(_ctx, _deltaMs) {
+        // Intentional no-op — dead entities do nothing each frame.
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    exit(_ctx) {
+        // The FSM should not exit DEAD under normal operation.
+        // No cleanup required — this is a safety no-op.
+    }
+}
+//# sourceMappingURL=DeadState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeadState.js","sourceRoot":"","sources":["../../../src/states/handlers/DeadState.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,oCAAoC;AACpC,EAAE;AACF,2EAA2E;AAC3E,iDAAiD;AACjD,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,4EAA4E;AAO5E;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB,yEAAyE;IACzE,6EAA6E;IAC7E,YAAY;IACZ,6DAA6D;IAC7D,YAAY,IAAkB,EAAE,GAAkC,IAAG,CAAC;IAEtE,KAAK,CAAC,GAAgB;QACpB,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,GAAG,CAAC,cAAc,EAAE,CAAC;IACvB,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,IAAiB,EAAE,QAAgB;QACxC,2DAA2D;IAC7D,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,IAAiB;QACpB,uDAAuD;QACvD,gDAAgD;IAClD,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless evade-grenade state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class EvadeGrenadeState 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;
+    /**
+     * Choose the post-evade state based on whether an enemy is currently visible.
+     * enemy visible → evadeOnClear (default: 'COMBAT'), no enemy → SEARCH.
+     */
+    private _exitToNextState;
+}
+//# sourceMappingURL=EvadeGrenadeState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EvadeGrenadeState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/EvadeGrenadeState.ts"],"names":[],"mappings":"AAuBA,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;AASlE;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,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;IAI7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqChD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAQ5B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/states/handlers/EvadeGrenadeState.js

@@ -0,0 +1,93 @@
+// states/handlers/EvadeGrenadeState.ts
+// NPC sprints away from an active grenade or explosion danger.
+//
+// Behaviour summary:
+//   enter()  — record ctx.now() in ctx.state.evadeStartMs so the handler
+//              knows when the evasion sprint began.
+//   update() — query ctx.danger?.getGrenadeDanger(x, y) each frame.
+//              If grenade danger is active:
+//                - move AWAY from the danger origin at
+//                  approachSpeed × evadeSpeedMultiplier (sprint).
+//              Exit conditions:
+//                (a) Grenade danger is no longer active AND
+//                    elapsed >= evadeGrenadeDurationMs  → COMBAT or SEARCH
+//                (b) No danger system registered AND
+//                    elapsed >= evadeGrenadeDurationMs  → COMBAT
+//                (c) Grenade danger cleared early (active===false) →
+//                    check enemy visibility: enemy present → COMBAT,
+//                    else → SEARCH.
+//   exit()   — halt() so the NPC doesn't keep drifting.
+//
+// State ID: 'EVADE_GRENADE'
+// Transitions: → 'COMBAT' | 'SEARCH'
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { awayFrom } from './_utils';
+/**
+ * Default evasion sprint duration (ms).
+ * Long enough to clear a grenade blast radius at sprint speed.
+ */
+const EVADE_GRENADE_DURATION_MS = 2000;
+/**
+ * Stateless evade-grenade state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class EvadeGrenadeState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.evadeStartMs = ctx.now();
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        const elapsed = now - ctx.state.evadeStartMs;
+        // --- Query grenade/explosion danger ---
+        const dangerInfo = ctx.danger?.getGrenadeDanger(ctx.x, ctx.y) ?? null;
+        if (dangerInfo && dangerInfo.active) {
+            // Sprint directly away from the danger origin.
+            const speed = this.cfg.approachSpeed * this.cfg.evadeSpeedMultiplier;
+            awayFrom(ctx, dangerInfo.originX, dangerInfo.originY, speed);
+            // Don't exit yet — keep sprinting until danger clears or timer expires.
+            return;
+        }
+        // --- No active grenade danger ---
+        if (ctx.danger === null) {
+            // No danger system at all — time out and return to COMBAT.
+            if (elapsed >= EVADE_GRENADE_DURATION_MS) {
+                ctx.halt();
+                ctx.transition(this.tr.evadeOnNoSystem);
+            }
+            return;
+        }
+        // Danger system present but grenade is no longer active (or was never found).
+        if (elapsed >= EVADE_GRENADE_DURATION_MS) {
+            ctx.halt();
+            this._exitToNextState(ctx);
+            return;
+        }
+        // Danger cleared early — transition immediately.
+        ctx.halt();
+        this._exitToNextState(ctx);
+    }
+    exit(ctx) {
+        ctx.halt();
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Choose the post-evade state based on whether an enemy is currently visible.
+     * enemy visible → evadeOnClear (default: 'COMBAT'), no enemy → SEARCH.
+     */
+    _exitToNextState(ctx) {
+        if (ctx.perception?.hasVisibleEnemy()) {
+            ctx.transition(this.tr.evadeOnClear);
+        }
+        else {
+            ctx.transition('SEARCH');
+        }
+    }
+}
+//# sourceMappingURL=EvadeGrenadeState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EvadeGrenadeState.js","sourceRoot":"","sources":["../../../src/states/handlers/EvadeGrenadeState.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,+DAA+D;AAC/D,EAAE;AACF,qBAAqB;AACrB,yEAAyE;AACzE,oDAAoD;AACpD,oEAAoE;AACpE,4CAA4C;AAC5C,uDAAuD;AACvD,kEAAkE;AAClE,gCAAgC;AAChC,4DAA4D;AAC5D,2EAA2E;AAC3E,qDAAqD;AACrD,iEAAiE;AACjE,qEAAqE;AACrE,qEAAqE;AACrE,oCAAoC;AACpC,wDAAwD;AACxD,EAAE;AACF,4BAA4B;AAC5B,qCAAqC;AAKrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;GAGG;AACH,MAAM,yBAAyB,GAAG,IAAK,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAI5B,YAAY,GAAiB,EAAE,EAAiC;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAgB;QACpB,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,GAAgB,EAAE,QAAgB;QACvC,MAAM,GAAG,GAAO,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC;QAE7C,yCAAyC;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAEtE,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACpC,+CAA+C;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACrE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7D,wEAAwE;YACxE,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACxB,2DAA2D;YAC3D,IAAI,OAAO,IAAI,yBAAyB,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACX,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO;QACT,CAAC;QAED,8EAA8E;QAC9E,IAAI,OAAO,IAAI,yBAAyB,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,iDAAiD;QACjD,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,GAAgB;QACnB,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E;;;OAGG;IACK,gBAAgB,CAAC,GAAgB;QACvC,IAAI,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC;YACtC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF"}

package/dist/states/handlers/FleeState.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 flee-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class FleeState 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=FleeState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FleeState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/FleeState.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;;;;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;IAO7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8BhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAG7B"}

package/dist/states/handlers/FleeState.js

@@ -0,0 +1,61 @@
+// states/handlers/FleeState.ts
+// NPC sprints directly away from the threat's last known position.
+//
+// Morale-aware speed:
+//   - PANICKED NPC : base flee speed × fleeSpeedMultiplier × panicFleeMultiplier
+//   - SHAKEN NPC   : base flee speed × fleeSpeedMultiplier (no extra multiplier)
+//
+// Exit conditions (same rules as the game-layer FleeState):
+//   - moraleState is STABLE                              → ALERT  (recovered)
+//   - distance from threat > cfg.fleeDistance AND morale
+//     is SHAKEN (not PANICKED)                           → PATROL (far enough)
+//
+// Transitions out of FLEE:
+//   - morale is STABLE   → ALERT
+//   - far enough + SHAKEN → PATROL (then morale recovery will bring them back)
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { awayFrom } from './_utils';
+/**
+ * Stateless flee-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class FleeState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        // Zero velocity immediately so the first update tick applies the correct
+        // flee direction rather than inheriting stale combat velocity.
+        ctx.halt();
+        ctx.pack?.broadcastAlertLevel('PANIC');
+    }
+    update(ctx, _deltaMs) {
+        const moraleState = ctx.state.moraleState;
+        // --- Morale recovery: fully STABLE → resume investigating ---
+        if (moraleState === 'STABLE') {
+            ctx.halt();
+            ctx.transition(this.tr.fleeOnCalmed);
+            return;
+        }
+        const threatX = ctx.state.lastKnownEnemyX;
+        const threatY = ctx.state.lastKnownEnemyY;
+        const dx = ctx.x - threatX;
+        const dy = ctx.y - threatY;
+        const dist = Math.sqrt(dx * dx + dy * dy);
+        // --- SHAKEN + far enough → hold and wait for morale recovery ---
+        if (moraleState === 'SHAKEN' && dist >= this.cfg.fleeDistance) {
+            ctx.halt();
+            return;
+        }
+        // --- Compute flee speed ---
+        const panicMult = moraleState === 'PANICKED' ? this.cfg.panicFleeMultiplier : 1.0;
+        const speed = this.cfg.approachSpeed * this.cfg.fleeSpeedMultiplier * panicMult;
+        awayFrom(ctx, threatX, threatY, speed);
+    }
+    exit(ctx) {
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=FleeState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FleeState.js","sourceRoot":"","sources":["../../../src/states/handlers/FleeState.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,mEAAmE;AACnE,EAAE;AACF,sBAAsB;AACtB,iFAAiF;AACjF,iFAAiF;AACjF,EAAE;AACF,4DAA4D;AAC5D,8EAA8E;AAC9E,yDAAyD;AACzD,+EAA+E;AAC/E,EAAE;AACF,2BAA2B;AAC3B,iCAAiC;AACjC,+EAA+E;AAK/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAIpB,YAAY,GAAiB,EAAE,EAAiC;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAgB;QACpB,yEAAyE;QACzE,+DAA+D;QAC/D,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,GAAgB,EAAE,QAAgB;QACvC,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC;QAE1C,+DAA+D;QAC/D,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QAE1C,MAAM,EAAE,GAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QAC7B,MAAM,EAAE,GAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAE1C,kEAAkE;QAClE,IAAI,WAAW,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,MAAM,SAAS,GAAG,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;QAClF,MAAM,KAAK,GAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,GAAG,SAAS,CAAC;QAEpF,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,GAAgB;QACnB,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;CACF"}

package/dist/states/handlers/GrenadeState.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 grenade-throw state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class GrenadeState 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=GrenadeState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrenadeState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/GrenadeState.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;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;GAIG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,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;IAI7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAoChD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/GrenadeState.js

@@ -0,0 +1,61 @@
+// states/handlers/GrenadeState.ts
+// NPC throws a grenade at the last known enemy position.
+//
+// enter:  record grenadeThrowStartMs = ctx.now()
+// update:
+//   - if grenadeCount <= 0 → transition 'COMBAT' immediately
+//   - if elapsed >= grenadeWindupMs:
+//       emit shoot (weaponType: 'GRENADE'), decrement grenadeCount,
+//       record lastGrenadeMs, transition 'COMBAT'
+//   - during windup: halt movement, face last known enemy
+// exit:   nothing
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless grenade-throw state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class GrenadeState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.grenadeThrowStartMs = ctx.now();
+    }
+    update(ctx, _deltaMs) {
+        // Abort immediately if no grenades are available.
+        if (ctx.state.grenadeCount <= 0) {
+            ctx.transition(this.tr.grenadeOnNoAmmo);
+            return;
+        }
+        const now = ctx.now();
+        const elapsed = now - ctx.state.grenadeThrowStartMs;
+        if (elapsed >= this.cfg.grenadeWindupMs) {
+            // Throw the grenade — emit shoot event with GRENADE weapon type.
+            ctx.emitShoot({
+                npcId: ctx.npcId,
+                x: ctx.x,
+                y: ctx.y,
+                targetX: ctx.state.lastKnownEnemyX,
+                targetY: ctx.state.lastKnownEnemyY,
+                weaponType: 'GRENADE',
+            });
+            ctx.state.grenadeCount--;
+            ctx.state.lastGrenadeMs = now;
+            ctx.transition(this.tr.grenadeOnComplete);
+            return;
+        }
+        // Still in wind-up: halt and face the last known enemy position.
+        ctx.halt();
+        const dx = ctx.state.lastKnownEnemyX - ctx.x;
+        const dy = ctx.state.lastKnownEnemyY - ctx.y;
+        if (dx !== 0 || dy !== 0) {
+            ctx.setRotation(Math.atan2(dy, dx));
+        }
+    }
+    exit(_ctx) {
+        // Nothing to clean up.
+    }
+}
+//# sourceMappingURL=GrenadeState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrenadeState.js","sourceRoot":"","sources":["../../../src/states/handlers/GrenadeState.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,yDAAyD;AACzD,EAAE;AACF,iDAAiD;AACjD,UAAU;AACV,6DAA6D;AAC7D,qCAAqC;AACrC,oEAAoE;AACpE,kDAAkD;AAClD,0DAA0D;AAC1D,kBAAkB;AAKlB,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAIvB,YAAY,GAAiB,EAAE,EAAiC;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAgB;QACpB,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,GAAgB,EAAE,QAAgB;QACvC,kDAAkD;QAClD,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YAChC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC;QAEpD,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YACxC,iEAAiE;YACjE,GAAG,CAAC,SAAS,CAAC;gBACZ,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,CAAC,EAAE,GAAG,CAAC,CAAC;gBACR,CAAC,EAAE,GAAG,CAAC,CAAC;gBACR,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe;gBAClC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe;gBAClC,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YAEH,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACzB,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC;YAC9B,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,iEAAiE;QACjE,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAiB;QACpB,uBAAuB;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,27 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless two-phase help-wounded handler (X-Ray 16 `xr_help_wounded` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation:
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   patrolOnWoundedAlly: 'HELP_WOUNDED',
+ *   idleOnWoundedAlly:   'HELP_WOUNDED',
+ * });
+ * handlers.register('HELP_WOUNDED', new HelpWoundedState(cfg));
+ * ```
+ */
+export declare class HelpWoundedState 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=HelpWoundedState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HelpWoundedState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/HelpWoundedState.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAe,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAc,iBAAiB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAO,wBAAwB,CAAC;AAGnE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAuB;gBAE9B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAO7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiFhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAQ7B"}