@alife-sdk/ai 0.1.0

package/dist/states/handlers/KillWoundedState.js

@@ -0,0 +1,147 @@
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless five-phase kill-wounded handler (X-Ray 16 `stalker_kill_wounded` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation (add to the handler registry):
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   combatOnKillWounded: 'KILL_WOUNDED',
+ *   alertOnKillWounded:  'KILL_WOUNDED',
+ * });
+ * handlers.register('KILL_WOUNDED', new KillWoundedState(cfg));
+ * ```
+ */
+export class KillWoundedState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.killWoundedStartMs = ctx.now();
+        ctx.state.killWoundedAimStartMs = -1;
+        ctx.state.killWoundedTauntStartMs = -1;
+        ctx.state.killWoundedExecuteStartMs = -1;
+        ctx.state.killWoundedShotsFired = 0;
+        ctx.state.killWoundedPauseStartMs = -1;
+        ctx.halt();
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // ── Priority: panic → flee ───────────────────────────────────────────────
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.halt();
+            ctx.transition(this.tr.killWoundedOnPanic);
+            return;
+        }
+        // ── PAUSE phase ───────────────────────────────────────────────────────────
+        if (ctx.state.killWoundedPauseStartMs >= 0) {
+            ctx.halt();
+            if (now - ctx.state.killWoundedPauseStartMs >= this.cfg.killWoundedPauseMs) {
+                if (ctx.perception?.hasVisibleEnemy()) {
+                    ctx.transition(this.tr.killWoundedOnComplete); // new threat → COMBAT
+                }
+                else if (ctx.state.lastKnownEnemyX !== 0 || ctx.state.lastKnownEnemyY !== 0) {
+                    ctx.transition(this.tr.killWoundedOnNoTarget); // last position known → SEARCH
+                }
+                else {
+                    ctx.transition(this.tr.killWoundedOnComplete); // nothing → COMBAT fallback
+                }
+            }
+            return;
+        }
+        // ── EXECUTE phase ─────────────────────────────────────────────────────────
+        if (ctx.state.killWoundedExecuteStartMs >= 0) {
+            ctx.halt();
+            ctx.setRotation(Math.atan2(ctx.state.killWoundedTargetY - ctx.y, ctx.state.killWoundedTargetX - ctx.x));
+            if (ctx.state.killWoundedShotsFired >= this.cfg.killWoundedBurstCount) {
+                // All shots fired → move to pause
+                ctx.state.killWoundedPauseStartMs = now;
+                return;
+            }
+            // Fire next shot when cooldown elapsed
+            if (now - ctx.state.lastShootMs >= this.cfg.fireRateMs) {
+                ctx.state.lastShootMs = now;
+                ctx.state.killWoundedShotsFired++;
+                ctx.emitShoot({
+                    npcId: ctx.npcId,
+                    x: ctx.x,
+                    y: ctx.y,
+                    targetX: ctx.state.killWoundedTargetX,
+                    targetY: ctx.state.killWoundedTargetY,
+                    weaponType: ctx.state.primaryWeapon ?? 'pistol',
+                });
+            }
+            return;
+        }
+        // ── TAUNT phase ───────────────────────────────────────────────────────────
+        if (ctx.state.killWoundedTauntStartMs >= 0) {
+            ctx.halt();
+            if (now - ctx.state.killWoundedTauntStartMs >= this.cfg.killWoundedTauntMs) {
+                ctx.state.killWoundedExecuteStartMs = now;
+                ctx.state.killWoundedShotsFired = 0;
+            }
+            return;
+        }
+        // ── AIM phase ─────────────────────────────────────────────────────────────
+        if (ctx.state.killWoundedAimStartMs >= 0) {
+            ctx.halt();
+            ctx.setRotation(Math.atan2(ctx.state.killWoundedTargetY - ctx.y, ctx.state.killWoundedTargetX - ctx.x));
+            if (now - ctx.state.killWoundedAimStartMs >= this.cfg.killWoundedAimMs) {
+                ctx.emitVocalization('KILL_WOUNDED_TAUNT');
+                ctx.state.killWoundedTauntStartMs = now;
+            }
+            return;
+        }
+        // ── APPROACH phase ────────────────────────────────────────────────────────
+        // Overall approach timeout
+        if (now - ctx.state.killWoundedStartMs >= this.cfg.killWoundedMaxApproachMs) {
+            ctx.halt();
+            ctx.transition(this.tr.killWoundedOnTimeout);
+            return;
+        }
+        // Refresh target position from live perception
+        const woundedEnemies = ctx.perception?.getWoundedEnemies?.() ?? [];
+        const target = woundedEnemies.find(e => e.id === ctx.state.killWoundedTargetId) ?? null;
+        if (!target) {
+            // Target healed, died, or left perception range
+            ctx.halt();
+            if (ctx.perception?.hasVisibleEnemy()) {
+                ctx.transition(this.tr.killWoundedOnComplete); // still enemies → COMBAT
+            }
+            else {
+                ctx.transition(this.tr.killWoundedOnNoTarget); // no one → SEARCH
+            }
+            return;
+        }
+        // Keep destination current (wounded enemy may crawl)
+        ctx.state.killWoundedTargetX = target.x;
+        ctx.state.killWoundedTargetY = target.y;
+        // Arrival check → begin AIM
+        const dx = target.x - ctx.x;
+        const dy = target.y - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const range = this.cfg.killWoundedExecuteRange;
+        if (distSq <= range * range) {
+            ctx.halt();
+            ctx.state.killWoundedAimStartMs = now;
+            return;
+        }
+        moveToward(ctx, target.x, target.y, this.cfg.approachSpeed);
+    }
+    exit(ctx) {
+        ctx.state.killWoundedTargetId = null;
+        ctx.state.killWoundedStartMs = 0;
+        ctx.state.killWoundedAimStartMs = -1;
+        ctx.state.killWoundedTauntStartMs = -1;
+        ctx.state.killWoundedExecuteStartMs = -1;
+        ctx.state.killWoundedShotsFired = 0;
+        ctx.state.killWoundedPauseStartMs = -1;
+        ctx.state.killWoundedTargetX = 0;
+        ctx.state.killWoundedTargetY = 0;
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=KillWoundedState.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LeapState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/LeapState.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;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,mBAAmB;IAIjD,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;IAoC7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiEhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/handlers/LeapState.js

@@ -0,0 +1,115 @@
+// states/handlers/LeapState.ts
+// Snork jump-attack state — winds up then arcs through the air to land on target.
+//
+// Phase pipeline (stored in ctx.state.leapPhase):
+//   WINDUP   — entity stops; counts down leapWindupMs; records start + target positions.
+//   AIRBORNE — entity position is teleported (lerped) from start → target over leapAirtimeMs.
+//              ctx.teleport() sets position directly to bypass normal velocity physics.
+//              airborne flag is set true once this phase begins.
+//   LAND     — when airtime has fully elapsed: emitMeleeHit + transition (tr.leapOnLand).
+//
+// All mutable state lives in INPCOnlineState.leapPhase so this handler is
+// stateless and safe to share across all NPC entities.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless snork leap-attack handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class LeapState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        var _a;
+        const now = ctx.now();
+        // Lock target from first visible enemy or last known position.
+        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;
+        if (enemies.length > 0) {
+            ctx.state.lastKnownEnemyX = enemies[0].x;
+            ctx.state.lastKnownEnemyY = enemies[0].y;
+            ctx.state.targetId = enemies[0].id;
+        }
+        // Lazy-initialise leap phase data if not yet present.
+        (_a = ctx.state).leapPhase ?? (_a.leapPhase = { active: false, windupStartMs: 0, airborne: false, startX: 0, startY: 0, targetX: 0, targetY: 0, airStartMs: 0 });
+        ctx.state.leapPhase.active = true;
+        ctx.state.leapPhase.airborne = false;
+        ctx.state.leapPhase.windupStartMs = now;
+        ctx.state.leapPhase.airStartMs = 0;
+        ctx.state.leapPhase.startX = ctx.x;
+        ctx.state.leapPhase.startY = ctx.y;
+        ctx.state.leapPhase.targetX = targetX;
+        ctx.state.leapPhase.targetY = targetY;
+        // Stop and crouch during windup.
+        ctx.halt();
+        // Face target during windup telegraph.
+        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.leapPhase;
+        if (!phase.airborne) {
+            // -----------------------------------------------------------------------
+            // WINDUP phase — wait for leapWindupMs before launching leap
+            // -----------------------------------------------------------------------
+            const windupElapsed = now - phase.windupStartMs;
+            if (windupElapsed < this.cfg.leapWindupMs) {
+                // 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 — begin airborne phase.
+            phase.airborne = true;
+            phase.airStartMs = now;
+        }
+        // -----------------------------------------------------------------------
+        // AIRBORNE phase — lerp position from start → target over leapAirtimeMs
+        // -----------------------------------------------------------------------
+        const airElapsed = now - phase.airStartMs;
+        if (airElapsed < this.cfg.leapAirtimeMs) {
+            // Lerp progress in [0, 1]; clamped so we never overshoot.
+            const progress = Math.min(1, airElapsed / this.cfg.leapAirtimeMs);
+            const lerpX = phase.startX + (phase.targetX - phase.startX) * progress;
+            const lerpY = phase.startY + (phase.targetY - phase.startY) * progress;
+            // Teleport sets world position directly — bypasses arcade velocity so
+            // the entity "flies" through the air ignoring normal collision response.
+            ctx.teleport(lerpX, lerpY);
+            // Face direction of travel during flight.
+            const dx = phase.targetX - lerpX;
+            const dy = phase.targetY - lerpY;
+            if (dx !== 0 || dy !== 0) {
+                ctx.setRotation(Math.atan2(dy, dx));
+            }
+            return;
+        }
+        // -----------------------------------------------------------------------
+        // LAND — airtime elapsed: snap to target, apply damage, return to COMBAT
+        // -----------------------------------------------------------------------
+        ctx.teleport(phase.targetX, phase.targetY);
+        ctx.halt();
+        ctx.state.lastMeleeMs = now;
+        ctx.emitMeleeHit({
+            npcId: ctx.npcId,
+            targetId: ctx.state.targetId ?? '',
+            damage: this.cfg.meleeDamage,
+        });
+        ctx.transition(this.tr.leapOnLand);
+    }
+    exit(ctx) {
+        if (ctx.state.leapPhase) {
+            ctx.state.leapPhase.active = false;
+        }
+    }
+}
+//# sourceMappingURL=LeapState.js.map

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

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

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

@@ -0,0 +1,55 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Callback that selects a special ability state ID for a monster entity.
+ * Return null to continue basic melee combat.
+ *
+ * @param entityType - The NPC's entity type string (e.g., 'boar', 'zombie')
+ * @param dist - Current distance to the enemy
+ * @param cfg - Current state config (for meleeRange etc.)
+ * @returns State ID to transition to, or null to stay in combat
+ */
+export type MonsterAbilitySelector = (entityType: string, dist: number, cfg: IStateConfig) => string | null;
+/**
+ * Chornobyl-style ability selector preset.
+ * boar→CHARGE, bloodsucker→STALK, snork→LEAP, controller→PSI_ATTACK.
+ *
+ * Pass this as `abilitySelector` to {@link MonsterCombatController} and
+ * register the corresponding ability states in your {@link StateHandlerMap}:
+ *
+ * ```ts
+ * const handlers = buildMonsterHandlerMap(cfg)
+ *   .register(ONLINE_STATE.CHARGE,     new ChargeState(cfg))
+ *   .register(ONLINE_STATE.STALK,      new StalkState(cfg))
+ *   .register(ONLINE_STATE.LEAP,       new LeapState(cfg))
+ *   .register(ONLINE_STATE.PSI_ATTACK, new PsiAttackState(cfg));
+ *
+ * // Tell MonsterCombatController to use it:
+ * handlers.register(
+ *   ONLINE_STATE.COMBAT,
+ *   new MonsterCombatController(cfg, tr, CHORNOBYL_ABILITY_SELECTOR),
+ * );
+ * ```
+ */
+export declare const CHORNOBYL_ABILITY_SELECTOR: MonsterAbilitySelector;
+/**
+ * Stateless monster melee combat handler.
+ *
+ * Shared across all monster entity types. Species-specific ability
+ * transitions are driven by an injectable {@link MonsterAbilitySelector}
+ * callback rather than a hardcoded switch — fully agnostic.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class MonsterCombatController implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    private readonly selectAbility;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>, abilitySelector?: MonsterAbilitySelector);
+    enter(_ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(_ctx: INPCContext): void;
+}
+//# sourceMappingURL=MonsterCombatController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MonsterCombatController.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/MonsterCombatController.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;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,KACd,MAAM,GAAG,IAAI,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B,EAAE,sBA4BxC,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAK/D,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAGpC,GAAG,EAAE,YAAY,EAClC,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACjC,eAAe,CAAC,EAAE,sBAAsB;IAM1C,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAK9B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8EhD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/MonsterCombatController.js

@@ -0,0 +1,152 @@
+// states/handlers/MonsterCombatController.ts
+// Base melee combat state handler for all monster types.
+//
+// Handles:
+//   - Moving toward the visible enemy at approachSpeed
+//   - Applying melee hits when within meleeRange (respects meleeCooldownMs)
+//   - Transitioning to species-specific ability states via MonsterAbilitySelector
+//   - Transitioning to SEARCH when no visual contact (last known exists)
+//   - Transitioning to IDLE when no contact and no last known position
+//
+// Monsters do NOT use ranged weapons, grenades, or cover.
+// Special ability transitions are gated by meleeCooldown to prevent
+// immediate re-activation after returning from an ability state.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward, distanceTo } from './_utils';
+/**
+ * Chornobyl-style ability selector preset.
+ * boar→CHARGE, bloodsucker→STALK, snork→LEAP, controller→PSI_ATTACK.
+ *
+ * Pass this as `abilitySelector` to {@link MonsterCombatController} and
+ * register the corresponding ability states in your {@link StateHandlerMap}:
+ *
+ * ```ts
+ * const handlers = buildMonsterHandlerMap(cfg)
+ *   .register(ONLINE_STATE.CHARGE,     new ChargeState(cfg))
+ *   .register(ONLINE_STATE.STALK,      new StalkState(cfg))
+ *   .register(ONLINE_STATE.LEAP,       new LeapState(cfg))
+ *   .register(ONLINE_STATE.PSI_ATTACK, new PsiAttackState(cfg));
+ *
+ * // Tell MonsterCombatController to use it:
+ * handlers.register(
+ *   ONLINE_STATE.COMBAT,
+ *   new MonsterCombatController(cfg, tr, CHORNOBYL_ABILITY_SELECTOR),
+ * );
+ * ```
+ */
+export const CHORNOBYL_ABILITY_SELECTOR = (entityType, dist, cfg) => {
+    switch (entityType) {
+        case 'boar':
+            // Charge when the boar is beyond direct melee range.
+            return dist > cfg.meleeRange ? 'CHARGE' : null;
+        case 'bloodsucker':
+            // Stalk when the bloodsucker is far enough to cloak without being seen.
+            return dist > cfg.meleeRange * 2 ? 'STALK' : null;
+        case 'snork': {
+            // Leap when in medium-to-far range (beyond melee but within 3× melee).
+            const leapRange = cfg.meleeRange * 3;
+            return dist > cfg.meleeRange && dist <= leapRange ? 'LEAP' : null;
+        }
+        case 'controller':
+            // PSI attack when the controller is beyond direct melee range.
+            return dist > cfg.meleeRange ? 'PSI_ATTACK' : null;
+        // Dogs and other unspecified types rely solely on basic melee.
+        default:
+            return null;
+    }
+};
+/**
+ * Stateless monster melee combat handler.
+ *
+ * Shared across all monster entity types. Species-specific ability
+ * transitions are driven by an injectable {@link MonsterAbilitySelector}
+ * callback rather than a hardcoded switch — fully agnostic.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class MonsterCombatController {
+    constructor(cfg, tr, abilitySelector) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+        this.selectAbility = abilitySelector ?? (() => null);
+    }
+    enter(_ctx) {
+        // No special enter logic for monster combat — perception/movement
+        // is handled in the first update tick.
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // -----------------------------------------------------------------------
+        // 1. Resolve visible enemy
+        // -----------------------------------------------------------------------
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        const hasEnemy = enemies.length > 0;
+        if (!hasEnemy) {
+            // No visual contact — use last known position or idle.
+            if (ctx.state.lastKnownEnemyX !== 0 || ctx.state.lastKnownEnemyY !== 0) {
+                ctx.transition(this.tr.monsterOnLastKnown);
+            }
+            else {
+                ctx.transition(this.tr.monsterOnNoEnemy);
+            }
+            return;
+        }
+        // Update last known position from closest visible enemy.
+        const enemy = enemies[0];
+        ctx.state.lastKnownEnemyX = enemy.x;
+        ctx.state.lastKnownEnemyY = enemy.y;
+        ctx.state.targetId = enemy.id;
+        // Pack broadcast (opt-in, throttled)
+        if (now - ctx.state.packLastBroadcastMs >= this.cfg.packAlertIntervalMs) {
+            ctx.state.packLastBroadcastMs = now;
+            ctx.pack?.broadcastTarget(enemy.id, enemy.x, enemy.y);
+            ctx.pack?.broadcastAlertLevel('COMBAT');
+        }
+        // -----------------------------------------------------------------------
+        // 2. Compute distance to enemy
+        // -----------------------------------------------------------------------
+        const dist = distanceTo(ctx.x, ctx.y, enemy.x, enemy.y);
+        // -----------------------------------------------------------------------
+        // 3. Move toward enemy or halt when in melee range
+        // -----------------------------------------------------------------------
+        if (dist > this.cfg.meleeRange) {
+            moveToward(ctx, enemy.x, enemy.y, this.cfg.approachSpeed);
+        }
+        else {
+            ctx.halt();
+            // Face the enemy even when standing still.
+            const dx = enemy.x - ctx.x;
+            const dy = enemy.y - ctx.y;
+            if (dx !== 0 || dy !== 0) {
+                ctx.setRotation(Math.atan2(dy, dx));
+            }
+        }
+        // -----------------------------------------------------------------------
+        // 4. Melee attack when in range and off cooldown
+        // -----------------------------------------------------------------------
+        if (dist <= this.cfg.meleeRange) {
+            if (now - ctx.state.lastMeleeMs >= this.cfg.meleeCooldownMs) {
+                ctx.state.lastMeleeMs = now;
+                ctx.emitMeleeHit({
+                    npcId: ctx.npcId,
+                    targetId: enemy.id,
+                    damage: this.cfg.meleeDamage,
+                });
+            }
+        }
+        // -----------------------------------------------------------------------
+        // 5. Special ability transitions (only when melee cooldown is expired)
+        // -----------------------------------------------------------------------
+        const meleeCooldownRemaining = this.cfg.meleeCooldownMs - (now - ctx.state.lastMeleeMs);
+        if (meleeCooldownRemaining <= 0) {
+            const abilityTransition = this.selectAbility(ctx.entityType, dist, this.cfg);
+            if (abilityTransition !== null) {
+                ctx.transition(abilityTransition);
+            }
+        }
+    }
+    exit(_ctx) {
+        // No cleanup needed.
+    }
+}
+//# sourceMappingURL=MonsterCombatController.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"PatrolState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/PatrolState.ts"],"names":[],"mappings":"AAsBA,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;AAIlE;;;;GAIG;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,GAAG,EAAE,WAAW,GAAG,IAAI;IAK7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAyGhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAG7B"}