@alife-sdk/ai 0.1.0

package/dist/states/OnlineAIDriver.d.ts

@@ -0,0 +1,64 @@
+import type { INPCContext } from './INPCContext';
+import type { IOnlineStateHandler } from './IOnlineStateHandler';
+import { StateHandlerMap } from './StateHandlerMap';
+/**
+ * Minimal host interface provided by the caller when constructing an
+ * {@link OnlineAIDriver}.
+ *
+ * Omits `transition` and `currentStateId` from {@link INPCContext} because
+ * those two fields are owned by the driver itself — it wraps `hostCtx` and
+ * injects its own implementations.
+ *
+ * All other fields are delegated transparently to the host object.
+ */
+export type IOnlineDriverHost = Omit<INPCContext, 'transition' | 'currentStateId'>;
+/**
+ * Per-NPC coordinator that drives a lightweight finite state machine over a
+ * set of {@link IOnlineStateHandler} instances.
+ *
+ * Create one driver per active NPC entity and call {@link update} each frame.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildDefaultHandlerMap();
+ * const driver = new OnlineAIDriver(phaserNPCContext, handlers, 'IDLE');
+ *
+ * // Game loop:
+ * driver.update(scene.game.loop.delta);
+ *
+ * // On NPC death / scene shutdown:
+ * driver.destroy();
+ * ```
+ */
+export declare class OnlineAIDriver {
+    private readonly handlers;
+    private _currentStateId;
+    private readonly ctx;
+    /** True while a transition is in progress (guards against re-entrant transitions). */
+    private _transitioning;
+    /** True after destroy() has been called. Guards against use-after-destroy. */
+    private _destroyed;
+    constructor(host: IOnlineDriverHost, handlers: StateHandlerMap | ReadonlyMap<string, IOnlineStateHandler>, initialState: string);
+    /** Identifier of the currently active state. */
+    get currentStateId(): string;
+    /**
+     * Run one frame of the AI.
+     *
+     * Calls `update(ctx, deltaMs)` on the current state handler.
+     * If the handler called `ctx.transition()` the FSM will have already
+     * performed exit/enter — no additional bookkeeping is required.
+     *
+     * @param deltaMs - Elapsed time since the last frame (milliseconds).
+     */
+    update(deltaMs: number): void;
+    /**
+     * Exit the current state.
+     *
+     * Call when the NPC entity is destroyed or the scene shuts down.
+     */
+    destroy(): void;
+    /** @internal Called by {@link DriverContext.transition}. */
+    _doTransition(newStateId: string): void;
+    private getHandler;
+}
+//# sourceMappingURL=OnlineAIDriver.d.ts.map

package/dist/states/OnlineAIDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnlineAIDriver.d.ts","sourceRoot":"","sources":["../../src/states/OnlineAIDriver.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,gBAAgB,CAAC,CAAC;AAMnF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAElC,sFAAsF;IACtF,OAAO,CAAC,cAAc,CAAS;IAE/B,8EAA8E;IAC9E,OAAO,CAAC,UAAU,CAAS;gBAGzB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACpE,YAAY,EAAE,MAAM;IAkBtB,gDAAgD;IAChD,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAUf,4DAA4D;IAC5D,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAqBvC,OAAO,CAAC,UAAU;CAOnB"}

package/dist/states/OnlineAIDriver.js

@@ -0,0 +1,171 @@
+// states/OnlineAIDriver.ts
+// Per-NPC coordinator for the online AI tick.
+//
+// Owns:
+//   - A Map<stateId, IOnlineStateHandler> shared handler registry
+//   - An INPCContext facade wired to drive FSM transitions
+//
+// Design: OnlineAIDriver does NOT use the core StateMachine (which works with
+// IEntity + AIStateRegistry). Instead it owns a minimal FSM — a currentStateId
+// string and direct enter/update/exit calls — to keep alife-ai independent of
+// any entity or registry contract.
+//
+// The host (e.g. Phaser layer) calls:
+//   1. update(deltaMs)  — each frame
+//   2. destroy()        — when the entity is removed
+import { StateHandlerMap } from './StateHandlerMap';
+// ---------------------------------------------------------------------------
+// OnlineAIDriver
+// ---------------------------------------------------------------------------
+/**
+ * Per-NPC coordinator that drives a lightweight finite state machine over a
+ * set of {@link IOnlineStateHandler} instances.
+ *
+ * Create one driver per active NPC entity and call {@link update} each frame.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildDefaultHandlerMap();
+ * const driver = new OnlineAIDriver(phaserNPCContext, handlers, 'IDLE');
+ *
+ * // Game loop:
+ * driver.update(scene.game.loop.delta);
+ *
+ * // On NPC death / scene shutdown:
+ * driver.destroy();
+ * ```
+ */
+export class OnlineAIDriver {
+    constructor(host, handlers, initialState) {
+        /** True while a transition is in progress (guards against re-entrant transitions). */
+        this._transitioning = false;
+        /** True after destroy() has been called. Guards against use-after-destroy. */
+        this._destroyed = false;
+        this.handlers = handlers instanceof StateHandlerMap ? handlers.toMap() : handlers;
+        this._currentStateId = initialState;
+        // Build the wrapped context that intercepts transition() and currentStateId.
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const driver = this;
+        this.ctx = new DriverContext(host, driver);
+        // Call enter() on the initial state.
+        this.getHandler(initialState).enter(this.ctx);
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /** Identifier of the currently active state. */
+    get currentStateId() {
+        return this._currentStateId;
+    }
+    /**
+     * Run one frame of the AI.
+     *
+     * Calls `update(ctx, deltaMs)` on the current state handler.
+     * If the handler called `ctx.transition()` the FSM will have already
+     * performed exit/enter — no additional bookkeeping is required.
+     *
+     * @param deltaMs - Elapsed time since the last frame (milliseconds).
+     */
+    update(deltaMs) {
+        if (this._destroyed)
+            return;
+        this.getHandler(this._currentStateId).update(this.ctx, deltaMs);
+    }
+    /**
+     * Exit the current state.
+     *
+     * Call when the NPC entity is destroyed or the scene shuts down.
+     */
+    destroy() {
+        if (this._destroyed)
+            return;
+        this._destroyed = true;
+        this.getHandler(this._currentStateId).exit(this.ctx);
+    }
+    // -------------------------------------------------------------------------
+    // Internal — called by DriverContext
+    // -------------------------------------------------------------------------
+    /** @internal Called by {@link DriverContext.transition}. */
+    _doTransition(newStateId) {
+        if (this._transitioning) {
+            // Re-entrant guard: a transition triggered while another is in progress
+            // is silently ignored to prevent stack overflow in pathological handlers.
+            return;
+        }
+        this._transitioning = true;
+        try {
+            this.getHandler(this._currentStateId).exit(this.ctx);
+            this._currentStateId = newStateId;
+            this.getHandler(newStateId).enter(this.ctx);
+        }
+        finally {
+            this._transitioning = false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    getHandler(stateId) {
+        const h = this.handlers.get(stateId);
+        if (!h) {
+            throw new Error(`OnlineAIDriver: no handler registered for state "${stateId}"`);
+        }
+        return h;
+    }
+}
+// ---------------------------------------------------------------------------
+// DriverContext — internal INPCContext wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Internal wrapper that delegates all INPCContext members to the host object
+ * except `currentStateId` and `transition`, which are owned by the driver.
+ *
+ * Using a class (rather than an object literal) lets us refer to it by type
+ * internally and avoids closure-per-field allocation on hot paths.
+ *
+ * @internal
+ */
+class DriverContext {
+    constructor(host, driver) {
+        this.host = host;
+        this.driver = driver;
+    }
+    // Identity
+    get npcId() { return this.host.npcId; }
+    get factionId() { return this.host.factionId; }
+    get entityType() { return this.host.entityType; }
+    // Position
+    get x() { return this.host.x; }
+    get y() { return this.host.y; }
+    // Mutable AI state bag
+    get state() { return this.host.state; }
+    // Optional subsystems
+    get perception() { return this.host.perception; }
+    get health() { return this.host.health; }
+    get cover() { return this.host.cover; }
+    get danger() { return this.host.danger; }
+    get restrictedZones() { return this.host.restrictedZones; }
+    get squad() { return this.host.squad; }
+    get pack() { return this.host.pack; }
+    get conditions() { return this.host.conditions; }
+    get suspicion() { return this.host.suspicion; }
+    // Movement & rendering — delegate to host
+    setVelocity(vx, vy) { this.host.setVelocity(vx, vy); }
+    halt() { this.host.halt(); }
+    setRotation(r) { this.host.setRotation(r); }
+    setAlpha(a) { this.host.setAlpha(a); }
+    teleport(x, y) { this.host.teleport(x, y); }
+    disablePhysics() { this.host.disablePhysics(); }
+    // FSM control — owned by driver
+    get currentStateId() { return this.driver.currentStateId; }
+    transition(newStateId) { this.driver._doTransition(newStateId); }
+    // Event emission — delegate to host
+    emitShoot(p) { this.host.emitShoot(p); }
+    emitMeleeHit(p) { this.host.emitMeleeHit(p); }
+    emitVocalization(t) { this.host.emitVocalization(t); }
+    emitPsiAttackStart(x, y) { this.host.emitPsiAttackStart(x, y); }
+    // Utilities — delegate to host
+    now() { return this.host.now(); }
+    random() { return this.host.random(); }
+}
+//# sourceMappingURL=OnlineAIDriver.js.map

package/dist/states/OnlineAIDriver.js.map

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

package/dist/states/OnlineStateRegistryBuilder.d.ts

@@ -0,0 +1,115 @@
+import type { IStateConfig } from './IStateConfig';
+import type { IStateTransitionMap } from './IStateTransitionMap';
+import { StateHandlerMap } from './StateHandlerMap';
+/**
+ * Canonical state identifier strings used by both factory functions.
+ *
+ * Exported so hosts can reference them without hard-coding string literals.
+ */
+export declare const ONLINE_STATE: {
+    readonly DEAD: "DEAD";
+    readonly IDLE: "IDLE";
+    readonly PATROL: "PATROL";
+    readonly ALERT: "ALERT";
+    readonly FLEE: "FLEE";
+    readonly SEARCH: "SEARCH";
+    readonly CAMP: "CAMP";
+    readonly SLEEP: "SLEEP";
+    readonly COMBAT: "COMBAT";
+    readonly TAKE_COVER: "TAKE_COVER";
+    readonly GRENADE: "GRENADE";
+    readonly EVADE_GRENADE: "EVADE_GRENADE";
+    readonly WOUNDED: "WOUNDED";
+    readonly RETREAT: "RETREAT";
+    readonly CHARGE: "CHARGE";
+    readonly STALK: "STALK";
+    readonly LEAP: "LEAP";
+    readonly PSI_ATTACK: "PSI_ATTACK";
+};
+/**
+ * Build a handler map for human NPC entities.
+ *
+ * Registers 14 states: the 13 shared core states plus {@link CombatState}
+ * (ranged weapon engagement, cover seeking, morale checks).
+ *
+ * The returned Map is a new instance each call — safe to mutate (e.g. replace
+ * individual entries) without affecting other callers.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; handlers use these
+ *   instead of hard-coded state IDs, allowing SDK users to rename states.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildDefaultHandlerMap({ combatRange: 300 })
+ *   .register('HUNT', new HuntState(cfg));
+ * const driver = new OnlineAIDriver(ctx, handlers, 'IDLE');
+ * ```
+ */
+export declare function buildDefaultHandlerMap(config?: Partial<IStateConfig>, tr?: Partial<IStateTransitionMap>): StateHandlerMap;
+/**
+ * Build a handler map for monster entities.
+ *
+ * Registers 14 states: the 13 shared core states plus
+ * {@link MonsterCombatController} (melee attacks, no special abilities by
+ * default). Monster ability states are opt-in — register them explicitly and
+ * provide a matching {@link MonsterAbilitySelector}.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; passed to all handlers.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example Basic monster (melee only):
+ * ```ts
+ * const handlers = buildMonsterHandlerMap({ meleeRange: 64 });
+ * const driver = new OnlineAIDriver(monsterCtx, handlers, 'IDLE');
+ * ```
+ *
+ * @example Stalker-style monster with ability states:
+ * ```ts
+ * import { CHORNOBYL_ABILITY_SELECTOR } from '@alife-sdk/ai/states';
+ *
+ * const cfg = { meleeRange: 64 };
+ * const handlers = buildMonsterHandlerMap(cfg)
+ *   .register(ONLINE_STATE.COMBAT,     new MonsterCombatController(cfg, tr, CHORNOBYL_ABILITY_SELECTOR))
+ *   .register(ONLINE_STATE.CHARGE,     new ChargeState(cfg, tr))
+ *   .register(ONLINE_STATE.STALK,      new StalkState(cfg, tr))
+ *   .register(ONLINE_STATE.LEAP,       new LeapState(cfg, tr))
+ *   .register(ONLINE_STATE.PSI_ATTACK, new PsiAttackState(cfg, tr));
+ * ```
+ */
+export declare function buildMonsterHandlerMap(config?: Partial<IStateConfig>, tr?: Partial<IStateTransitionMap>): StateHandlerMap;
+/**
+ * Build a handler map for Stalker-style monster entities.
+ *
+ * Registers 18 states: the 13 shared core states plus
+ * {@link MonsterCombatController} wired to {@link CHORNOBYL_ABILITY_SELECTOR}
+ * and the four species-specific ability states:
+ *
+ * | Entity type   | Ability state |
+ * |---------------|--------------|
+ * | `boar`        | `CHARGE`     |
+ * | `bloodsucker` | `STALK`      |
+ * | `snork`       | `LEAP`       |
+ * | `controller`  | `PSI_ATTACK` |
+ *
+ * All five state registrations are guaranteed to be consistent — no risk of
+ * the ability selector returning a state ID that is not in the map.
+ *
+ * For a custom entity-to-ability mapping pass `abilitySelector` to
+ * {@link MonsterCombatController} and register only the states you need via
+ * {@link buildMonsterHandlerMap} + `.register()`.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; passed to all handlers.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildChornobylMonsterHandlerMap({ meleeRange: 64 });
+ * const driver = new OnlineAIDriver(monsterCtx, handlers, 'IDLE');
+ * ```
+ */
+export declare function buildChornobylMonsterHandlerMap(config?: Partial<IStateConfig>, tr?: Partial<IStateTransitionMap>): StateHandlerMap;
+//# sourceMappingURL=OnlineStateRegistryBuilder.d.ts.map

package/dist/states/OnlineStateRegistryBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnlineStateRegistryBuilder.d.ts","sourceRoot":"","sources":["../../src/states/OnlineStateRegistryBuilder.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;CAmBf,CAAC;AAmCX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAChC,eAAe,CAIjB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAChC,eAAe,CAIjB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAChC,eAAe,CAQjB"}

package/dist/states/OnlineStateRegistryBuilder.js

@@ -0,0 +1,184 @@
+// states/OnlineStateRegistryBuilder.ts
+// Factory functions that assemble the Map<stateId, IOnlineStateHandler> for
+// OnlineAIDriver.
+//
+// All handlers are stateless — per-NPC runtime data lives in INPCOnlineState.
+// The returned StateHandlerMap is a fresh instance each call and safe to mutate.
+//
+// Four functions:
+//   buildCoreHandlerMap()             — private: 13 shared states, no COMBAT
+//   buildDefaultHandlerMap()          — human NPCs: core + CombatState (14 states)
+//   buildMonsterHandlerMap()          — monsters:   core + MonsterCombatController (14 states)
+//   buildChornobylMonsterHandlerMap() — Stalker-style: core + MonsterCombatController
+//                                       (CHORNOBYL_ABILITY_SELECTOR) + 4 ability states (18 states)
+//
+// Monster ability states (CHARGE, STALK, LEAP, PSI_ATTACK) are opt-in:
+//   - Use buildChornobylMonsterHandlerMap() for the full Stalker preset, or
+//   - Manually extend buildMonsterHandlerMap() for custom ability sets.
+import { DeadState, IdleState, PatrolState, AlertState, FleeState, SearchState, CampState, SleepState, CombatState, TakeCoverState, GrenadeState, EvadeGrenadeState, WoundedState, RetreatState, MonsterCombatController, CHORNOBYL_ABILITY_SELECTOR, ChargeState, StalkState, LeapState, PsiAttackState, } from './handlers/index';
+import { createDefaultStateConfig } from './IStateConfig';
+import { StateHandlerMap } from './StateHandlerMap';
+// ---------------------------------------------------------------------------
+// State identifiers (string constants — not const enum, so hosts can extend)
+// ---------------------------------------------------------------------------
+/**
+ * Canonical state identifier strings used by both factory functions.
+ *
+ * Exported so hosts can reference them without hard-coding string literals.
+ */
+export const ONLINE_STATE = {
+    DEAD: 'DEAD',
+    IDLE: 'IDLE',
+    PATROL: 'PATROL',
+    ALERT: 'ALERT',
+    FLEE: 'FLEE',
+    SEARCH: 'SEARCH',
+    CAMP: 'CAMP',
+    SLEEP: 'SLEEP',
+    COMBAT: 'COMBAT',
+    TAKE_COVER: 'TAKE_COVER',
+    GRENADE: 'GRENADE',
+    EVADE_GRENADE: 'EVADE_GRENADE',
+    WOUNDED: 'WOUNDED',
+    RETREAT: 'RETREAT',
+    CHARGE: 'CHARGE',
+    STALK: 'STALK',
+    LEAP: 'LEAP',
+    PSI_ATTACK: 'PSI_ATTACK',
+};
+// ---------------------------------------------------------------------------
+// buildCoreHandlerMap (private)
+// ---------------------------------------------------------------------------
+/**
+ * Shared base: 13 states common to both humans and monsters.
+ * Does NOT include COMBAT (differs per entity type) nor monster ability states.
+ */
+function buildCoreHandlerMap(cfg, tr) {
+    return new StateHandlerMap([
+        [ONLINE_STATE.DEAD, new DeadState(cfg, tr)],
+        [ONLINE_STATE.IDLE, new IdleState(cfg, tr)],
+        [ONLINE_STATE.PATROL, new PatrolState(cfg, tr)],
+        [ONLINE_STATE.ALERT, new AlertState(cfg, tr)],
+        [ONLINE_STATE.FLEE, new FleeState(cfg, tr)],
+        [ONLINE_STATE.SEARCH, new SearchState(cfg, tr)],
+        [ONLINE_STATE.CAMP, new CampState(cfg, tr)],
+        [ONLINE_STATE.SLEEP, new SleepState(cfg, tr)],
+        [ONLINE_STATE.TAKE_COVER, new TakeCoverState(cfg, tr)],
+        [ONLINE_STATE.GRENADE, new GrenadeState(cfg, tr)],
+        [ONLINE_STATE.EVADE_GRENADE, new EvadeGrenadeState(cfg, tr)],
+        [ONLINE_STATE.WOUNDED, new WoundedState(cfg, tr)],
+        [ONLINE_STATE.RETREAT, new RetreatState(cfg, tr)],
+    ]);
+}
+// ---------------------------------------------------------------------------
+// buildDefaultHandlerMap
+// ---------------------------------------------------------------------------
+/**
+ * Build a handler map for human NPC entities.
+ *
+ * Registers 14 states: the 13 shared core states plus {@link CombatState}
+ * (ranged weapon engagement, cover seeking, morale checks).
+ *
+ * The returned Map is a new instance each call — safe to mutate (e.g. replace
+ * individual entries) without affecting other callers.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; handlers use these
+ *   instead of hard-coded state IDs, allowing SDK users to rename states.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildDefaultHandlerMap({ combatRange: 300 })
+ *   .register('HUNT', new HuntState(cfg));
+ * const driver = new OnlineAIDriver(ctx, handlers, 'IDLE');
+ * ```
+ */
+export function buildDefaultHandlerMap(config, tr) {
+    const cfg = createDefaultStateConfig(config);
+    return buildCoreHandlerMap(cfg, tr)
+        .register(ONLINE_STATE.COMBAT, new CombatState(cfg, tr));
+}
+// ---------------------------------------------------------------------------
+// buildMonsterHandlerMap
+// ---------------------------------------------------------------------------
+/**
+ * Build a handler map for monster entities.
+ *
+ * Registers 14 states: the 13 shared core states plus
+ * {@link MonsterCombatController} (melee attacks, no special abilities by
+ * default). Monster ability states are opt-in — register them explicitly and
+ * provide a matching {@link MonsterAbilitySelector}.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; passed to all handlers.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example Basic monster (melee only):
+ * ```ts
+ * const handlers = buildMonsterHandlerMap({ meleeRange: 64 });
+ * const driver = new OnlineAIDriver(monsterCtx, handlers, 'IDLE');
+ * ```
+ *
+ * @example Stalker-style monster with ability states:
+ * ```ts
+ * import { CHORNOBYL_ABILITY_SELECTOR } from '@alife-sdk/ai/states';
+ *
+ * const cfg = { meleeRange: 64 };
+ * const handlers = buildMonsterHandlerMap(cfg)
+ *   .register(ONLINE_STATE.COMBAT,     new MonsterCombatController(cfg, tr, CHORNOBYL_ABILITY_SELECTOR))
+ *   .register(ONLINE_STATE.CHARGE,     new ChargeState(cfg, tr))
+ *   .register(ONLINE_STATE.STALK,      new StalkState(cfg, tr))
+ *   .register(ONLINE_STATE.LEAP,       new LeapState(cfg, tr))
+ *   .register(ONLINE_STATE.PSI_ATTACK, new PsiAttackState(cfg, tr));
+ * ```
+ */
+export function buildMonsterHandlerMap(config, tr) {
+    const cfg = createDefaultStateConfig(config);
+    return buildCoreHandlerMap(cfg, tr)
+        .register(ONLINE_STATE.COMBAT, new MonsterCombatController(cfg, tr));
+}
+// ---------------------------------------------------------------------------
+// buildChornobylMonsterHandlerMap
+// ---------------------------------------------------------------------------
+/**
+ * Build a handler map for Stalker-style monster entities.
+ *
+ * Registers 18 states: the 13 shared core states plus
+ * {@link MonsterCombatController} wired to {@link CHORNOBYL_ABILITY_SELECTOR}
+ * and the four species-specific ability states:
+ *
+ * | Entity type   | Ability state |
+ * |---------------|--------------|
+ * | `boar`        | `CHARGE`     |
+ * | `bloodsucker` | `STALK`      |
+ * | `snork`       | `LEAP`       |
+ * | `controller`  | `PSI_ATTACK` |
+ *
+ * All five state registrations are guaranteed to be consistent — no risk of
+ * the ability selector returning a state ID that is not in the map.
+ *
+ * For a custom entity-to-ability mapping pass `abilitySelector` to
+ * {@link MonsterCombatController} and register only the states you need via
+ * {@link buildMonsterHandlerMap} + `.register()`.
+ *
+ * @param config - Optional partial config overrides; merged with defaults.
+ * @param tr - Optional partial transition map overrides; passed to all handlers.
+ * @returns Fresh {@link StateHandlerMap} ready for {@link OnlineAIDriver}.
+ *
+ * @example
+ * ```ts
+ * const handlers = buildChornobylMonsterHandlerMap({ meleeRange: 64 });
+ * const driver = new OnlineAIDriver(monsterCtx, handlers, 'IDLE');
+ * ```
+ */
+export function buildChornobylMonsterHandlerMap(config, tr) {
+    const cfg = createDefaultStateConfig(config);
+    return buildCoreHandlerMap(cfg, tr)
+        .register(ONLINE_STATE.COMBAT, new MonsterCombatController(cfg, tr, CHORNOBYL_ABILITY_SELECTOR))
+        .register(ONLINE_STATE.CHARGE, new ChargeState(cfg, tr))
+        .register(ONLINE_STATE.STALK, new StalkState(cfg, tr))
+        .register(ONLINE_STATE.LEAP, new LeapState(cfg, tr))
+        .register(ONLINE_STATE.PSI_ATTACK, new PsiAttackState(cfg, tr));
+}
+//# sourceMappingURL=OnlineStateRegistryBuilder.js.map

package/dist/states/OnlineStateRegistryBuilder.js.map

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

package/dist/states/StateHandlerMap.d.ts

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

package/dist/states/StateHandlerMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHandlerMap.d.ts","sourceRoot":"","sources":["../../src/states/StateHandlerMap.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;gBAE5C,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAI7D;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAK7D;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,IAAI;IAUvE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,IAAI;IAQzE,kEAAkE;IAClE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIrD,6DAA6D;IAC7D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iDAAiD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAIpE,mDAAmD;IACnD,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC;CAGlD"}