@alife-sdk/ai 0.1.0

package/dist/states/handlers/SleepState.js

@@ -0,0 +1,94 @@
+// states/handlers/SleepState.ts
+// NPC is asleep — minimal perception, very delayed reactions.
+//
+// Sleep behavior (scheme@sleep analogue):
+//   - Visual perception is intentionally NOT checked (eyes closed).
+//   - Sound/nearby enemies detected via perception → cfg.campSleepReactionDelayMs
+//     delay → ALERT (NPC wakes up slowly).
+//   - NPC inside a restricted/danger zone → ALERT (immediate — physical threat).
+//
+// Transitions out of SLEEP:
+//   - sound/nearby threat (after campSleepReactionDelayMs delay) → ALERT
+//   - NPC inside an inaccessible/danger zone                    → ALERT (immediate)
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+// Sentinel: no pending reaction timer.
+const NO_PENDING = 0;
+/**
+ * Stateless sleep-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class SleepState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.halt();
+        // Clear any stale delayed reaction from a previous SLEEP activation.
+        // We repurpose woundedStartMs as the sleep-reaction-start timestamp.
+        ctx.state.woundedStartMs = NO_PENDING;
+        // Slightly dim the NPC to indicate sleep visually.
+        ctx.setAlpha(0.8);
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // --- Pending delayed-reaction processing ---
+        const reactionStart = ctx.state.woundedStartMs;
+        if (reactionStart !== NO_PENDING) {
+            if (now - reactionStart >= this.cfg.campSleepReactionDelayMs) {
+                ctx.state.woundedStartMs = NO_PENDING;
+                ctx.transition(this.tr.sleepOnEnemy);
+                return;
+            }
+            // Still waking up — do nothing else.
+            return;
+        }
+        // --- Sound / nearby threat (non-visual perception) → queue delayed ALERT ---
+        // Note: visual enemies are intentionally NOT checked here (NPC eyes closed).
+        if (ctx.perception !== null) {
+            const allies = ctx.perception.getVisibleAllies(); // unused, but good guard
+            void allies;
+            const enemies = ctx.perception.getVisibleEnemies();
+            // We DO check getVisibleEnemies because the perception system may only
+            // include sound-detected entities in this list when used properly by the
+            // host. If only visual enemies appear here and the host disables visual
+            // perception for sleeping NPCs, this list will be empty — which is the
+            // correct behaviour. We keep the check simple and host-driven.
+            if (enemies.length > 0) {
+                const target = enemies[0];
+                ctx.state.lastKnownEnemyX = target.x;
+                ctx.state.lastKnownEnemyY = target.y;
+                ctx.state.woundedStartMs = now;
+                return;
+            }
+        }
+        // --- Restricted zone check (immediate wake-up — physical danger) ---
+        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.sleepOnEnemy);
+            return;
+        }
+    }
+    exit(ctx) {
+        // Restore full alpha when waking up.
+        ctx.setAlpha(1);
+        // Clear any pending delayed reaction.
+        ctx.state.woundedStartMs = NO_PENDING;
+    }
+}
+//# sourceMappingURL=SleepState.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"StalkState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/StalkState.ts"],"names":[],"mappings":"AAeA,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,UAAW,YAAW,mBAAmB;IAIlD,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;IAU7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA4ChD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAQ7B"}

package/dist/states/handlers/StalkState.js

@@ -0,0 +1,82 @@
+// states/handlers/StalkState.ts
+// Bloodsucker near-invisibility approach state.
+//
+// Phase pipeline (stored in ctx.state.stalkPhase):
+//   APPROACH  — entity alpha drops to stalkAlphaInvisible; moves toward enemy
+//               at approachSpeed × stalkSpeedMultiplier. Transitions to uncloak
+//               when distance < stalkUnclockDistance.
+//   UNCLOAK   — alpha restored to 1.0, then transition to COMBAT for the melee strike.
+//
+// exit() always restores full alpha (1.0) so the bloodsucker is never permanently
+// invisible if the state is interrupted (e.g. takes damage → COMBAT).
+//
+// All mutable state lives in INPCOnlineState.stalkPhase so this handler is
+// stateless and safe to share across all NPC entities.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward, distanceTo } from './_utils';
+/**
+ * Stateless bloodsucker stalk-approach handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class StalkState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        var _a;
+        // Go invisible immediately on enter.
+        ctx.setAlpha(this.cfg.stalkAlphaInvisible);
+        // Lazy-initialise stalk phase data if not yet present.
+        (_a = ctx.state).stalkPhase ?? (_a.stalkPhase = { active: false, approaching: false });
+        ctx.state.stalkPhase.active = true;
+        ctx.state.stalkPhase.approaching = false;
+    }
+    update(ctx, _deltaMs) {
+        // -----------------------------------------------------------------------
+        // No visible enemy during stalk → transition to SEARCH
+        // -----------------------------------------------------------------------
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const hasEnemy = enemies.length > 0;
+        if (!hasEnemy) {
+            ctx.transition(this.tr.stalkOnNoEnemy);
+            return;
+        }
+        // Update last known position.
+        const enemy = enemies[0];
+        ctx.state.lastKnownEnemyX = enemy.x;
+        ctx.state.lastKnownEnemyY = enemy.y;
+        ctx.state.targetId = enemy.id;
+        const dist = distanceTo(ctx.x, ctx.y, enemy.x, enemy.y);
+        // -----------------------------------------------------------------------
+        // APPROACH phase — close distance invisibly
+        // -----------------------------------------------------------------------
+        if (!ctx.state.stalkPhase.approaching) {
+            if (dist <= this.cfg.stalkUnclockDistance) {
+                // Close enough — flag as approaching (uncloak next frame).
+                ctx.state.stalkPhase.approaching = true;
+                return;
+            }
+            // Move toward enemy at reduced stalk speed.
+            const stalkSpeed = this.cfg.approachSpeed * this.cfg.stalkSpeedMultiplier;
+            moveToward(ctx, enemy.x, enemy.y, stalkSpeed);
+            return;
+        }
+        // -----------------------------------------------------------------------
+        // UNCLOAK phase — restore alpha and attack
+        // -----------------------------------------------------------------------
+        ctx.setAlpha(1.0);
+        ctx.halt();
+        ctx.transition(this.tr.stalkOnAttack);
+    }
+    exit(ctx) {
+        // Always restore full visibility on exit — prevents permanent invisibility
+        // if the state is interrupted by damage or an external transition.
+        ctx.setAlpha(1.0);
+        if (ctx.state.stalkPhase) {
+            ctx.state.stalkPhase.active = false;
+        }
+    }
+}
+//# sourceMappingURL=StalkState.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"TakeCoverState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/TakeCoverState.ts"],"names":[],"mappings":"AAiBA,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,cAAe,YAAW,mBAAmB;IACxD,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;IAiD7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsJhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/handlers/TakeCoverState.js

@@ -0,0 +1,208 @@
+// states/handlers/TakeCoverState.ts
+// NPC shelters at a cover point and uses a loophole peek-fire cycle.
+//
+// Loophole phase cycle:
+//   WAIT   — NPC halts behind cover. Duration: random [loopholeWaitMinMs, loopholeWaitMaxMs].
+//   PEEK   — NPC moves toward cover point. Duration: loopholePeekDurationMs.
+//   FIRE   — NPC emits shoot, stays in place. Duration: loopholeFireDurationMs.
+//   RETURN — NPC moves back / waits to return. Duration: loopholeReturnDurationMs.
+//
+// Transitions out:
+//   - No visible enemy → SEARCH
+//   - Morale PANICKED  → FLEE
+//   - Morale SHAKEN    → RETREAT
+//
+// enter: find cover, set coverPointX/Y, init loophole state
+// exit:  clear hasTakenCover + loophole
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless take-cover state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class TakeCoverState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        // Attempt to find a cover point using the cover subsystem.
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const enemy = enemies[0] ?? null;
+        let coverPt = null;
+        if (ctx.cover !== null && enemy !== null) {
+            coverPt = ctx.cover.findCover(ctx.x, ctx.y, enemy.x, enemy.y);
+        }
+        else if (ctx.cover !== null) {
+            // No enemy visible, find any nearby cover.
+            coverPt = ctx.cover.findCover(ctx.x, ctx.y, ctx.x, ctx.y);
+        }
+        if (coverPt !== null) {
+            // Lock the cover point; if contested, clear the selection so the NPC
+            // does not march into a point already occupied by another NPC.
+            const locked = ctx.cover?.lockLastFound?.(ctx.npcId) ?? true;
+            if (locked) {
+                ctx.state.coverPointX = coverPt.x;
+                ctx.state.coverPointY = coverPt.y;
+            }
+            else {
+                coverPt = null;
+            }
+        }
+        // If no cover found, we still enter — the NPC will try to move to last
+        // known coverPointX/Y (which may be 0,0 as fallback).
+        ctx.state.hasTakenCover = false;
+        // Initialise the loophole cycle starting in WAIT phase.
+        const waitDuration = this.cfg.loopholeWaitMinMs +
+            ctx.random() * (this.cfg.loopholeWaitMaxMs - this.cfg.loopholeWaitMinMs);
+        ctx.state.loophole = {
+            phase: 'WAIT',
+            phaseStartMs: ctx.now(),
+        };
+        // Store wait duration as a scratch value in phaseStartMs offset.
+        // We re-use phaseStartMs + phase duration to know when to advance.
+        // The actual wait end is computed as: phaseStartMs + waitDuration.
+        // Save waitDuration separately via a small trick: store -(waitDuration) in
+        // lastGrenadeMs as a per-NPC scratch. This avoids adding new fields.
+        // Instead, simpler: store the wait-end timestamp directly in lastGrenadeMs.
+        ctx.state.lastGrenadeMs = ctx.now() + waitDuration;
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // -------------------------------------------------------------------------
+        // Morale + perception exit checks
+        // -------------------------------------------------------------------------
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.transition(this.tr.takeCoverOnPanicked);
+            return;
+        }
+        if (ctx.state.moraleState === 'SHAKEN') {
+            ctx.transition(this.tr.takeCoverOnShaken);
+            return;
+        }
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const hasEnemy = enemies.length > 0;
+        if (!hasEnemy) {
+            ctx.transition(this.tr.takeCoverOnNoEnemy);
+            return;
+        }
+        // Update last known enemy position.
+        const enemy = enemies[0];
+        ctx.state.lastKnownEnemyX = enemy.x;
+        ctx.state.lastKnownEnemyY = enemy.y;
+        // -------------------------------------------------------------------------
+        // Ensure loophole state is initialised (safety guard).
+        // -------------------------------------------------------------------------
+        if (ctx.state.loophole === null) {
+            const waitDuration = this.cfg.loopholeWaitMinMs +
+                ctx.random() * (this.cfg.loopholeWaitMaxMs - this.cfg.loopholeWaitMinMs);
+            ctx.state.loophole = { phase: 'WAIT', phaseStartMs: now };
+            ctx.state.lastGrenadeMs = now + waitDuration;
+        }
+        // -------------------------------------------------------------------------
+        // Move to cover point if not yet there.
+        // -------------------------------------------------------------------------
+        if (!ctx.state.hasTakenCover) {
+            const dx = ctx.state.coverPointX - ctx.x;
+            const dy = ctx.state.coverPointY - ctx.y;
+            const dist = Math.sqrt(dx * dx + dy * dy);
+            if (dist > this.cfg.arriveThreshold) {
+                moveToward(ctx, ctx.state.coverPointX, ctx.state.coverPointY, this.cfg.approachSpeed);
+                return;
+            }
+            ctx.state.hasTakenCover = true;
+            ctx.halt();
+        }
+        // -------------------------------------------------------------------------
+        // Loophole phase state machine.
+        // -------------------------------------------------------------------------
+        const loophole = ctx.state.loophole;
+        switch (loophole.phase) {
+            // -----------------------------------------------------------------------
+            // WAIT: NPC crouches behind cover.
+            // -----------------------------------------------------------------------
+            case 'WAIT': {
+                ctx.halt();
+                // ctx.state.lastGrenadeMs stores the wait-end timestamp.
+                if (now >= ctx.state.lastGrenadeMs) {
+                    loophole.phase = 'PEEK';
+                    loophole.phaseStartMs = now;
+                }
+                break;
+            }
+            // -----------------------------------------------------------------------
+            // PEEK: NPC moves toward the cover peek position (= cover centre for now).
+            // -----------------------------------------------------------------------
+            case 'PEEK': {
+                const elapsed = now - loophole.phaseStartMs;
+                if (elapsed >= this.cfg.loopholePeekDurationMs) {
+                    ctx.halt();
+                    loophole.phase = 'FIRE';
+                    loophole.phaseStartMs = now;
+                }
+                else {
+                    // Move toward enemy slightly — simulate peeking out of cover.
+                    moveToward(ctx, enemy.x, enemy.y, this.cfg.approachSpeed * 0.5);
+                }
+                break;
+            }
+            // -----------------------------------------------------------------------
+            // FIRE: NPC holds and fires at enemy.
+            // -----------------------------------------------------------------------
+            case 'FIRE': {
+                const elapsed = now - loophole.phaseStartMs;
+                ctx.halt();
+                // Face the enemy.
+                const dx = enemy.x - ctx.x;
+                const dy = enemy.y - ctx.y;
+                if (dx !== 0 || dy !== 0) {
+                    ctx.setRotation(Math.atan2(dy, dx));
+                }
+                // Fire at fire rate.
+                if (now - ctx.state.lastShootMs >= this.cfg.fireRateMs) {
+                    ctx.state.lastShootMs = now;
+                    ctx.emitShoot({
+                        npcId: ctx.npcId,
+                        x: ctx.x,
+                        y: ctx.y,
+                        targetX: enemy.x,
+                        targetY: enemy.y,
+                        weaponType: ctx.state.primaryWeapon ?? 'rifle',
+                    });
+                }
+                if (elapsed >= this.cfg.loopholeFireDurationMs) {
+                    loophole.phase = 'RETURN';
+                    loophole.phaseStartMs = now;
+                }
+                break;
+            }
+            // -----------------------------------------------------------------------
+            // RETURN: NPC moves back to cover centre.
+            // -----------------------------------------------------------------------
+            case 'RETURN': {
+                const elapsed = now - loophole.phaseStartMs;
+                if (elapsed >= this.cfg.loopholeReturnDurationMs) {
+                    ctx.halt();
+                    // Start next WAIT phase.
+                    const waitDuration = this.cfg.loopholeWaitMinMs +
+                        ctx.random() * (this.cfg.loopholeWaitMaxMs - this.cfg.loopholeWaitMinMs);
+                    loophole.phase = 'WAIT';
+                    loophole.phaseStartMs = now;
+                    ctx.state.lastGrenadeMs = now + waitDuration;
+                }
+                else {
+                    // Move back toward cover point.
+                    moveToward(ctx, ctx.state.coverPointX, ctx.state.coverPointY, this.cfg.approachSpeed);
+                }
+                break;
+            }
+        }
+    }
+    exit(ctx) {
+        ctx.state.hasTakenCover = false;
+        ctx.state.loophole = null;
+        ctx.cover?.unlockAll?.(ctx.npcId);
+    }
+}
+//# sourceMappingURL=TakeCoverState.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"WoundedState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/WoundedState.ts"],"names":[],"mappings":"AAmBA,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,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;IA6ChD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/WoundedState.js

@@ -0,0 +1,71 @@
+// states/handlers/WoundedState.ts
+// NPC is critically wounded: crawls away from threats, attempts to heal with
+// medkits, and may panic-flee when hopeless.
+//
+// Behaviour summary:
+//   enter()  — record ctx.now() in ctx.state.woundedStartMs.
+//   update() — per frame:
+//              1. Check duration limit: if elapsed > woundedMaxDurationMs → FLEE.
+//              2. If medkit available AND HP still critically low:
+//                 heal(maxHp × medkitHealRatio), consume one medkit.
+//                 If HP recovers above woundedHpThreshold → COMBAT.
+//              3. If morale PANICKED AND no medkits left → FLEE immediately.
+//              4. Move away from last known enemy at crawl speed
+//                 (approachSpeed × woundedCrawlMultiplier).
+//   exit()   — nothing (no cleanup state needed).
+//
+// State ID: 'WOUNDED'
+// Transitions: → 'COMBAT' (healed) | 'FLEE' (time limit / panic)
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { awayFrom } from './_utils';
+/**
+ * Stateless wounded-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class WoundedState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.woundedStartMs = ctx.now();
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        const elapsed = now - ctx.state.woundedStartMs;
+        // --- Time limit: give up and flee after woundedMaxDurationMs ---
+        if (elapsed >= this.cfg.woundedMaxDurationMs) {
+            ctx.transition(this.tr.woundedOnTimeout);
+            return;
+        }
+        // --- Medkit healing ---
+        if (ctx.state.medkitCount > 0 && ctx.health !== null) {
+            const hpPercent = ctx.health.hpPercent;
+            if (hpPercent < this.cfg.woundedHpThreshold) {
+                // Apply heal.
+                const healAmount = ctx.health.maxHp * this.cfg.medkitHealRatio;
+                ctx.health.heal(healAmount);
+                ctx.state.medkitCount -= 1;
+                // Re-check HP after heal.
+                if (ctx.health.hpPercent >= this.cfg.woundedHpThreshold) {
+                    ctx.transition(this.tr.woundedOnHealed);
+                    return;
+                }
+            }
+        }
+        // --- Morale PANICKED with no medkits left → flee immediately ---
+        if (ctx.state.moraleState === 'PANICKED' && ctx.state.medkitCount <= 0) {
+            ctx.transition(this.tr.woundedOnPanic);
+            return;
+        }
+        // --- Crawl away from last known enemy position ---
+        const crawlSpeed = this.cfg.approachSpeed * this.cfg.woundedCrawlMultiplier;
+        awayFrom(ctx, ctx.state.lastKnownEnemyX, ctx.state.lastKnownEnemyY, crawlSpeed);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    exit(_ctx) {
+        // No cleanup required.
+    }
+}
+//# sourceMappingURL=WoundedState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WoundedState.js","sourceRoot":"","sources":["../../../src/states/handlers/WoundedState.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,6EAA6E;AAC7E,6CAA6C;AAC7C,EAAE;AACF,qBAAqB;AACrB,6DAA6D;AAC7D,0BAA0B;AAC1B,kFAAkF;AAClF,mEAAmE;AACnE,qEAAqE;AACrE,oEAAoE;AACpE,6EAA6E;AAC7E,iEAAiE;AACjE,4DAA4D;AAC5D,kDAAkD;AAClD,EAAE;AACF,sBAAsB;AACtB,iEAAiE;AAKjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC;;;;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,cAAc,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;IACvC,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,cAAc,CAAC;QAE/C,kEAAkE;QAClE,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YAC7C,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,yBAAyB;QACzB,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;YAEvC,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;gBAC5C,cAAc;gBACd,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;gBAC/D,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC5B,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;gBAE3B,0BAA0B;gBAC1B,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;oBACxD,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;oBACxC,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QAED,oDAAoD;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC5E,QAAQ,CACN,GAAG,EACH,GAAG,CAAC,KAAK,CAAC,eAAe,EACzB,GAAG,CAAC,KAAK,CAAC,eAAe,EACzB,UAAU,CACX,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,IAAiB;QACpB,uBAAuB;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,55 @@
+import type { INPCContext } from '../INPCContext';
+import { createDefaultSteeringConfig } from '../../navigation/SteeringBehaviors';
+import type { ISteeringConfig } from '../../navigation/SteeringBehaviors';
+/**
+ * Return the Euclidean distance between two world positions.
+ */
+export declare function distanceTo(ax: number, ay: number, bx: number, by: number): number;
+/**
+ * Return the angle in radians from (ax, ay) toward (bx, by).
+ * 0 = right, π/2 = down (screen-space Y is positive downward).
+ */
+export declare function angleToward(ax: number, ay: number, bx: number, by: number): number;
+/**
+ * Set the NPC's velocity so it moves toward (targetX, targetY) at the given
+ * speed (px/s). Also updates the NPC's rotation to face the target.
+ *
+ * If the NPC is already within 0.5 px of the target, velocity is zeroed to
+ * avoid jitter; no rotation change is applied.
+ */
+export declare function moveToward(ctx: INPCContext, targetX: number, targetY: number, speed: number): void;
+/**
+ * Set the NPC's velocity so it moves directly away from (fromX, fromY) at the
+ * given speed (px/s). Also updates the NPC's rotation to face away.
+ *
+ * If the NPC is exactly on top of (fromX, fromY), a default escape direction
+ * (positive X) is used instead.
+ */
+export declare function awayFrom(ctx: INPCContext, fromX: number, fromY: number, speed: number): void;
+/**
+ * Opt-in convenience helper: computes pack steering (separation + cohesion) from
+ * nearby ally positions and blends it with a primary movement direction before
+ * calling `ctx.setVelocity()` and `ctx.setRotation()`.
+ *
+ * State handlers that want group-aware movement call this instead of
+ * `moveToward()` when allies are visible.
+ *
+ * For advanced scenarios (custom forces, alignment, formation) use the
+ * composable primitives directly:
+ * `computePackSteering() + combineForces() + blendWithPrimary()`
+ *
+ * @param ctx          - NPC context (provides position and setVelocity/setRotation).
+ * @param allies       - Nearby ally positions (e.g. from ctx.perception.getVisibleAllies()).
+ * @param config       - Steering configuration.
+ * @param primaryVx    - Normalised X component of the desired movement direction.
+ * @param primaryVy    - Normalised Y component of the desired movement direction.
+ * @param speed        - Base movement speed (px/s).
+ * @param weight       - Blend weight for the steering force [0..1]. @default 0.35
+ */
+export declare function applyPackSteering(ctx: INPCContext, allies: ReadonlyArray<{
+    x: number;
+    y: number;
+}>, config: ISteeringConfig, primaryVx: number, primaryVy: number, speed: number, weight?: number): void;
+export { createDefaultSteeringConfig };
+export type { ISteeringConfig };
+//# sourceMappingURL=_utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/_utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAyC,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACxH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,IAAI,CAYN;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI,CAcN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,SAAO,GACZ,IAAI,CAMN;AAID,OAAO,EAAE,2BAA2B,EAAE,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,CAAC"}