@alife-sdk/ai 0.1.0

package/dist/goap/GoalSelector.js

@@ -0,0 +1,115 @@
+// goap/GoalSelector.ts
+// Pure function to select a GOAP goal based on configurable priority rules.
+// No side effects — all decision logic is deterministic.
+import { WorldState } from '@alife-sdk/core';
+import { WorldProperty, GoalPriority } from '../types/IPerceptionTypes';
+// ---------------------------------------------------------------------------
+// Pre-allocated WorldState and IGoalResult objects for DEFAULT_GOAL_RULES.
+// These are immutable after construction — rules return the same instances
+// every evaluation to avoid per-tick allocations.
+// ---------------------------------------------------------------------------
+const _criticalGoal = /* @__PURE__ */ (() => {
+    const ws = new WorldState();
+    ws.set(WorldProperty.CRITICALLY_WOUNDED, false);
+    ws.set(WorldProperty.ENEMY_PRESENT, false);
+    return ws;
+})();
+const _enemyResult = /* @__PURE__ */ (() => {
+    const ws = new WorldState();
+    ws.set(WorldProperty.ENEMY_PRESENT, false);
+    return { goal: ws, priority: GoalPriority.ENEMY_PRESENT, reason: 'Enemy detected' };
+})();
+const _dangerResult = /* @__PURE__ */ (() => {
+    const ws = new WorldState();
+    ws.set(WorldProperty.DANGER, false);
+    return { goal: ws, priority: GoalPriority.DANGER, reason: 'Danger signal without visible enemy' };
+})();
+const _anomalyResult = /* @__PURE__ */ (() => {
+    const ws = new WorldState();
+    ws.set(WorldProperty.ANOMALY_NEAR, false);
+    return { goal: ws, priority: GoalPriority.ANOMALY_AVOID, reason: 'Anomaly zone detected' };
+})();
+const _defaultResult = /* @__PURE__ */ (() => {
+    const ws = new WorldState();
+    ws.set(WorldProperty.AT_TARGET, true);
+    return { goal: ws, priority: GoalPriority.DEFAULT, reason: 'No threats — patrol or idle' };
+})();
+/**
+ * Default goal rules corresponding to the 5-band priority hierarchy.
+ * Sorted by priority ascending (highest importance first).
+ *
+ * WorldState objects are pre-allocated and reused across evaluations to
+ * eliminate per-tick allocations.
+ */
+export const DEFAULT_GOAL_RULES = [
+    {
+        priority: GoalPriority.CRITICALLY_WOUNDED,
+        name: 'critically_wounded',
+        evaluate(snapshot, config) {
+            if (snapshot.hpRatio <= config.healHpThreshold) {
+                return {
+                    goal: _criticalGoal,
+                    priority: GoalPriority.CRITICALLY_WOUNDED,
+                    reason: `HP critical (${(snapshot.hpRatio * 100).toFixed(0)}%)`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        priority: GoalPriority.ENEMY_PRESENT,
+        name: 'enemy_present',
+        evaluate(snapshot) {
+            if (snapshot.enemyPresent)
+                return _enemyResult;
+            return null;
+        },
+    },
+    {
+        priority: GoalPriority.DANGER,
+        name: 'danger',
+        evaluate(snapshot) {
+            if (snapshot.hasDanger)
+                return _dangerResult;
+            return null;
+        },
+    },
+    {
+        priority: GoalPriority.ANOMALY_AVOID,
+        name: 'anomaly_avoidance',
+        evaluate(snapshot) {
+            if (snapshot.nearAnomalyZone)
+                return _anomalyResult;
+            return null;
+        },
+    },
+    {
+        priority: GoalPriority.DEFAULT,
+        name: 'default',
+        evaluate() {
+            return _defaultResult;
+        },
+    },
+];
+/**
+ * Select a GOAP goal based on the current NPC state.
+ *
+ * Rules are evaluated in order — first rule that returns a non-null result wins.
+ * DEFAULT_GOAL_RULES provides the original 4-band hierarchy.
+ *
+ * @param snapshot - Pre-computed NPC world data
+ * @param config - GOAP configuration (healHpThreshold)
+ * @param rules - Optional custom goal rules. Defaults to DEFAULT_GOAL_RULES.
+ * @returns Goal and priority band info
+ */
+export function selectGoal(snapshot, config, rules) {
+    for (const rule of (rules ?? DEFAULT_GOAL_RULES)) {
+        const result = rule.evaluate(snapshot, config);
+        if (result)
+            return result;
+    }
+    // Fallback — should not normally be reached with default rules
+    const goal = new WorldState();
+    return { goal, priority: GoalPriority.DEFAULT, reason: 'No rules matched' };
+}
+//# sourceMappingURL=GoalSelector.js.map

package/dist/goap/GoalSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalSelector.js","sourceRoot":"","sources":["../../src/goap/GoalSelector.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,4EAA4E;AAC5E,yDAAyD;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAoE,MAAM,2BAA2B,CAAC;AAwB1I,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,aAAa,GAAe,eAAe,CAAC,CAAC,GAAG,EAAE;IACtD,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAChD,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,YAAY,GAAgB,eAAe,CAAC,CAAC,GAAG,EAAE;IACtD,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AACtF,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,aAAa,GAAgB,eAAe,CAAC,CAAC,GAAG,EAAE;IACvD,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;AACpG,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,cAAc,GAAgB,eAAe,CAAC,CAAC,GAAG,EAAE;IACxD,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;AAC7F,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,cAAc,GAAgB,eAAe,CAAC,CAAC,GAAG,EAAE;IACxD,MAAM,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;IAC5B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;AAC7F,CAAC,CAAC,EAAE,CAAC;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD;QACE,QAAQ,EAAE,YAAY,CAAC,kBAAkB;QACzC,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM;YACvB,IAAI,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC/C,OAAO;oBACL,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,YAAY,CAAC,kBAAkB;oBACzC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;iBAChE,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,QAAQ,EAAE,YAAY,CAAC,aAAa;QACpC,IAAI,EAAE,eAAe;QACrB,QAAQ,CAAC,QAAQ;YACf,IAAI,QAAQ,CAAC,YAAY;gBAAE,OAAO,YAAY,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,QAAQ,EAAE,YAAY,CAAC,MAAM;QAC7B,IAAI,EAAE,QAAQ;QACd,QAAQ,CAAC,QAAQ;YACf,IAAI,QAAQ,CAAC,SAAS;gBAAE,OAAO,aAAa,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,QAAQ,EAAE,YAAY,CAAC,aAAa;QACpC,IAAI,EAAE,mBAAmB;QACzB,QAAQ,CAAC,QAAQ;YACf,IAAI,QAAQ,CAAC,eAAe;gBAAE,OAAO,cAAc,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,QAAQ,EAAE,YAAY,CAAC,OAAO;QAC9B,IAAI,EAAE,SAAS;QACf,QAAQ;YACN,OAAO,cAAc,CAAC;QACxB,CAAC;KACF;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,QAA2B,EAC3B,MAAmB,EACnB,KAA4B;IAE5B,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,kBAAkB,CAAC,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,MAAM,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;AAC9E,CAAC"}

package/dist/goap/IHazardZoneAccess.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Port interface (seam) for spatial hazard zone avoidance used by EvadeHazardAction.
+ *
+ * Implement on a host-side adapter that translates from the game's concrete
+ * zone representation into the two queries this action needs.
+ */
+export interface IHazardZoneAccess {
+    /** True if (x,y) is within hazard detection radius. */
+    isNearHazard(x: number, y: number): boolean;
+    /** Normalized escape direction (unit vec) away from nearest hazard, null if already clear. */
+    getEscapeDirection(x: number, y: number): {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+}
+//# sourceMappingURL=IHazardZoneAccess.d.ts.map

package/dist/goap/IHazardZoneAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHazardZoneAccess.d.ts","sourceRoot":"","sources":["../../src/goap/IHazardZoneAccess.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,8FAA8F;IAC9F,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7F"}

package/dist/goap/IHazardZoneAccess.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IHazardZoneAccess.js.map

package/dist/goap/IHazardZoneAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHazardZoneAccess.js","sourceRoot":"","sources":["../../src/goap/IHazardZoneAccess.ts"],"names":[],"mappings":""}

package/dist/goap/WorldStateBuilder.d.ts

@@ -0,0 +1,27 @@
+import { WorldState } from '@alife-sdk/core';
+import { type INPCWorldSnapshot } from '../types/IPerceptionTypes';
+/**
+ * A single world state property builder.
+ * Each builder is responsible for computing one boolean property from the snapshot.
+ */
+export interface IWorldPropertyBuilder {
+    readonly key: string;
+    build(snapshot: INPCWorldSnapshot): boolean;
+}
+/**
+ * Default property builders corresponding to the original 16 hardcoded assignments.
+ * Order matches the original buildWorldState implementation.
+ */
+export declare const DEFAULT_WORLD_PROPERTY_BUILDERS: readonly IWorldPropertyBuilder[];
+/**
+ * Build a GOAP WorldState from an NPC data snapshot.
+ *
+ * This is a pure function: same input → same output.
+ * The snapshot captures all relevant NPC data at a single point in time.
+ *
+ * @param snapshot - Pre-computed NPC data (health, perception, loadout, etc.)
+ * @param builders - Optional custom property builders. Defaults to DEFAULT_WORLD_PROPERTY_BUILDERS.
+ * @returns A new WorldState populated with properties from the builders
+ */
+export declare function buildWorldState(snapshot: INPCWorldSnapshot, builders?: readonly IWorldPropertyBuilder[]): WorldState;
+//# sourceMappingURL=WorldStateBuilder.d.ts.map

package/dist/goap/WorldStateBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorldStateBuilder.d.ts","sourceRoot":"","sources":["../../src/goap/WorldStateBuilder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC7C;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,qBAAqB,EAuB3E,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAC1C,UAAU,CAQZ"}

package/dist/goap/WorldStateBuilder.js

@@ -0,0 +1,51 @@
+// goap/WorldStateBuilder.ts
+// Pure function to build a GOAP world state snapshot from NPC data.
+// No side effects — caller provides all inputs as a snapshot.
+import { WorldState } from '@alife-sdk/core';
+import { WorldProperty } from '../types/IPerceptionTypes';
+/**
+ * Default property builders corresponding to the original 16 hardcoded assignments.
+ * Order matches the original buildWorldState implementation.
+ */
+export const DEFAULT_WORLD_PROPERTY_BUILDERS = [
+    // Direct properties
+    { key: WorldProperty.ALIVE, build: (s) => s.isAlive },
+    { key: WorldProperty.CRITICALLY_WOUNDED, build: (s) => s.hpRatio <= 0.3 },
+    { key: WorldProperty.HAS_WEAPON, build: (s) => s.hasWeapon },
+    { key: WorldProperty.HAS_AMMO, build: (s) => s.hasAmmo },
+    { key: WorldProperty.IN_COVER, build: (s) => s.inCover },
+    { key: WorldProperty.SEE_ENEMY, build: (s) => s.seeEnemy },
+    { key: WorldProperty.ENEMY_PRESENT, build: (s) => s.enemyPresent },
+    { key: WorldProperty.ENEMY_IN_RANGE, build: (s) => s.enemyInRange },
+    { key: WorldProperty.DANGER, build: (s) => s.hasDanger },
+    { key: WorldProperty.DANGER_GRENADE, build: (s) => s.hasDangerGrenade },
+    { key: WorldProperty.ENEMY_WOUNDED, build: (s) => s.enemyWounded },
+    { key: WorldProperty.ANOMALY_NEAR, build: (s) => s.nearAnomalyZone },
+    // Derived properties
+    { key: WorldProperty.ENEMY_SEE_ME, build: (s) => s.seeEnemy },
+    {
+        key: WorldProperty.READY_TO_KILL,
+        build: (s) => s.hasWeapon && s.hasAmmo && s.seeEnemy && s.enemyInRange,
+    },
+    { key: WorldProperty.POSITION_HELD, build: (s) => s.inCover && !s.seeEnemy },
+    { key: WorldProperty.LOOKED_OUT, build: () => false },
+    { key: WorldProperty.AT_TARGET, build: (s) => !s.enemyPresent && !s.hasDanger },
+];
+/**
+ * Build a GOAP WorldState from an NPC data snapshot.
+ *
+ * This is a pure function: same input → same output.
+ * The snapshot captures all relevant NPC data at a single point in time.
+ *
+ * @param snapshot - Pre-computed NPC data (health, perception, loadout, etc.)
+ * @param builders - Optional custom property builders. Defaults to DEFAULT_WORLD_PROPERTY_BUILDERS.
+ * @returns A new WorldState populated with properties from the builders
+ */
+export function buildWorldState(snapshot, builders) {
+    const state = new WorldState();
+    for (const b of (builders ?? DEFAULT_WORLD_PROPERTY_BUILDERS)) {
+        state.set(b.key, b.build(snapshot));
+    }
+    return state;
+}
+//# sourceMappingURL=WorldStateBuilder.js.map

package/dist/goap/WorldStateBuilder.js.map

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

package/dist/goap/index.d.ts

@@ -0,0 +1,9 @@
+export { buildWorldState, DEFAULT_WORLD_PROPERTY_BUILDERS } from './WorldStateBuilder';
+export type { IWorldPropertyBuilder } from './WorldStateBuilder';
+export { selectGoal, DEFAULT_GOAL_RULES } from './GoalSelector';
+export type { IGoalResult, IGoalRule } from './GoalSelector';
+export { GOAPController } from './GOAPController';
+export type { IGOAPUpdateResult, IGOAPControllerState } from './GOAPController';
+export type { IHazardZoneAccess } from './IHazardZoneAccess';
+export { EvadeHazardAction } from './EvadeHazardAction';
+//# sourceMappingURL=index.d.ts.map

package/dist/goap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/goap/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/goap/index.js

@@ -0,0 +1,6 @@
+// goap sub-path barrel
+export { buildWorldState, DEFAULT_WORLD_PROPERTY_BUILDERS } from './WorldStateBuilder';
+export { selectGoal, DEFAULT_GOAL_RULES } from './GoalSelector';
+export { GOAPController } from './GOAPController';
+export { EvadeHazardAction } from './EvadeHazardAction';
+//# sourceMappingURL=index.js.map

package/dist/goap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/goap/index.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from './types/index';
+export * from './config/index';
+export * from './cover/index';
+export * from './combat/index';
+export * from './navigation/index';
+export * from './squad/index';
+export * from './conditions/index';
+export * from './suspicion/index';
+export * from './animation/index';
+export * from './sound/index';
+export * from './perception/index';
+export * from './goap/index';
+export * from './ports/index';
+export * from './plugin/index';
+export * from './states/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// @alife-sdk/ai — online frame-based NPC behavior system.
+// Zero Phaser dependencies. Depends on @alife-sdk/core + alife-simulation.
+export * from './types/index';
+export * from './config/index';
+export * from './cover/index';
+export * from './combat/index';
+export * from './navigation/index';
+export * from './squad/index';
+export * from './conditions/index';
+export * from './suspicion/index';
+export * from './animation/index';
+export * from './sound/index';
+export * from './perception/index';
+export * from './goap/index';
+export * from './ports/index';
+export * from './plugin/index';
+export * from './states/index';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,2EAA2E;AAE3E,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/navigation/PathSmoother.d.ts

@@ -0,0 +1,29 @@
+import type { Vec2, IRandom } from '@alife-sdk/core';
+import type { INavigationConfig } from '../types/IOnlineAIConfig';
+/**
+ * Generate a smooth path from sparse waypoints using CatmullRom interpolation.
+ *
+ * Interior points receive deterministic jitter for natural feel.
+ * Results are cached (FIFO eviction at 64 entries).
+ *
+ * @param waypoints - Sparse control points (at least 1).
+ * @param config - Navigation tuning (pointsPerSegment, smoothRandomOffset).
+ * @param random - Seeded random source for deterministic jitter.
+ * @param cache - Optional shared cache instance.
+ * @returns Dense smooth path including exact start/end.
+ */
+export declare function smoothPath(waypoints: readonly Vec2[], config: INavigationConfig, random: IRandom, cache?: Map<string, readonly Vec2[]>): readonly Vec2[];
+/**
+ * Enhance a smooth path with Dubins-style arcs at sharp turns.
+ *
+ * Turns exceeding `dubinsMaxInstantTurn` get replaced with circular
+ * arc approximations for realistic movement.
+ *
+ * @param waypoints - Sparse control points.
+ * @param config - Navigation tuning.
+ * @param random - Seeded random for smooth path generation.
+ * @param cache - Optional smooth path cache.
+ * @returns Path with arc insertions at sharp turns.
+ */
+export declare function smoothPathWithTurning(waypoints: readonly Vec2[], config: INavigationConfig, random: IRandom, cache?: Map<string, readonly Vec2[]>): readonly Vec2[];
+//# sourceMappingURL=PathSmoother.d.ts.map

package/dist/navigation/PathSmoother.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathSmoother.d.ts","sourceRoot":"","sources":["../../src/navigation/PathSmoother.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAgClE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,SAAS,IAAI,EAAE,EAC1B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,GACnC,SAAS,IAAI,EAAE,CA+CjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,IAAI,EAAE,EAC1B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,GACnC,SAAS,IAAI,EAAE,CAmFjB"}

package/dist/navigation/PathSmoother.js

@@ -0,0 +1,172 @@
+// navigation/PathSmoother.ts
+// Immutable path smoothing pipeline using CatmullRom splines.
+// Pure functions + LRU cache — no framework dependencies.
+import { catmullRom } from '@alife-sdk/core';
+const MAX_CACHE_ENTRIES = 64;
+// Module-level scratch arrays — reused across smoothPath calls (single-threaded)
+const _scratchXs = [];
+const _scratchYs = [];
+/**
+ * Pad waypoints to meet the CatmullRom minimum of 4 control points.
+ * Duplicates endpoints as necessary.
+ */
+function padWaypoints(pts) {
+    if (pts.length >= 4)
+        return pts;
+    if (pts.length === 1)
+        return [pts[0], pts[0], pts[0], pts[0]];
+    if (pts.length === 2)
+        return [pts[0], pts[0], pts[1], pts[1]];
+    // pts.length === 3
+    return [pts[0], pts[0], pts[1], pts[2]];
+}
+/**
+ * Build a cache key from waypoint coordinates.
+ * Rounds to 1 decimal to absorb floating-point noise.
+ */
+function cacheKey(pts) {
+    let key = '';
+    for (const p of pts) {
+        key += `${p.x.toFixed(1)},${p.y.toFixed(1)};`;
+    }
+    return key;
+}
+/**
+ * Generate a smooth path from sparse waypoints using CatmullRom interpolation.
+ *
+ * Interior points receive deterministic jitter for natural feel.
+ * Results are cached (FIFO eviction at 64 entries).
+ *
+ * @param waypoints - Sparse control points (at least 1).
+ * @param config - Navigation tuning (pointsPerSegment, smoothRandomOffset).
+ * @param random - Seeded random source for deterministic jitter.
+ * @param cache - Optional shared cache instance.
+ * @returns Dense smooth path including exact start/end.
+ */
+export function smoothPath(waypoints, config, random, cache) {
+    if (waypoints.length === 0)
+        return [];
+    if (waypoints.length === 1)
+        return [waypoints[0]];
+    const key = cacheKey(waypoints);
+    if (cache) {
+        const cached = cache.get(key);
+        if (cached)
+            return cached;
+    }
+    const padded = padWaypoints(waypoints);
+    _scratchXs.length = 0;
+    _scratchYs.length = 0;
+    for (const p of padded) {
+        _scratchXs.push(p.x);
+        _scratchYs.push(p.y);
+    }
+    const xs = _scratchXs;
+    const ys = _scratchYs;
+    const segmentCount = padded.length - 1;
+    const totalSteps = segmentCount * config.smoothPointsPerSegment + 1;
+    const points = [];
+    for (let i = 0; i < totalSteps; i++) {
+        const t = i / (totalSteps - 1);
+        let x = catmullRom(xs, t);
+        let y = catmullRom(ys, t);
+        // Apply jitter to interior points only.
+        if (i > 0 && i < totalSteps - 1 && config.smoothRandomOffset > 0) {
+            x += (random.next() - 0.5) * 2 * config.smoothRandomOffset;
+            y += (random.next() - 0.5) * 2 * config.smoothRandomOffset;
+        }
+        points.push({ x, y });
+    }
+    if (cache) {
+        cache.set(key, points);
+        if (cache.size > MAX_CACHE_ENTRIES) {
+            const oldest = cache.keys().next().value;
+            if (oldest !== undefined)
+                cache.delete(oldest);
+        }
+    }
+    return points;
+}
+/**
+ * Enhance a smooth path with Dubins-style arcs at sharp turns.
+ *
+ * Turns exceeding `dubinsMaxInstantTurn` get replaced with circular
+ * arc approximations for realistic movement.
+ *
+ * @param waypoints - Sparse control points.
+ * @param config - Navigation tuning.
+ * @param random - Seeded random for smooth path generation.
+ * @param cache - Optional smooth path cache.
+ * @returns Path with arc insertions at sharp turns.
+ */
+export function smoothPathWithTurning(waypoints, config, random, cache) {
+    const base = smoothPath(waypoints, config, random, cache);
+    if (base.length < 3)
+        return base;
+    const ARC_SUBDIVISIONS = 6;
+    const result = [base[0]];
+    for (let i = 1; i < base.length - 1; i++) {
+        const a = base[i - 1];
+        const b = base[i];
+        const c = base[i + 1];
+        // Compute segment vectors and lengths once — shared by both
+        // the turn-angle check and the arc construction below.
+        const abx = b.x - a.x;
+        const aby = b.y - a.y;
+        const bcx = c.x - b.x;
+        const bcy = c.y - b.y;
+        const abLen = Math.sqrt(abx * abx + aby * aby);
+        const bcLen = Math.sqrt(bcx * bcx + bcy * bcy);
+        if (abLen < 1e-6 || bcLen < 1e-6) {
+            result.push(b);
+            continue;
+        }
+        // Turn angle (inlined to reuse abLen/bcLen).
+        const abNx = abx / abLen;
+        const abNy = aby / abLen;
+        const bcNx = bcx / bcLen;
+        const bcNy = bcy / bcLen;
+        const dot = abNx * bcNx + abNy * bcNy;
+        const angle = Math.acos(Math.max(-1, Math.min(1, dot)));
+        if (angle <= config.dubinsMaxInstantTurn) {
+            result.push(b);
+            continue;
+        }
+        // Insert arc at sharp turn.
+        const halfAngle = angle / 2;
+        const sinHalf = Math.sin(halfAngle);
+        if (sinHalf < 1e-6) {
+            result.push(b);
+            continue;
+        }
+        // Bisector points away from the turn.
+        let bisX = abNx + bcNx;
+        let bisY = abNy + bcNy;
+        const bisLen = Math.sqrt(bisX * bisX + bisY * bisY);
+        if (bisLen < 1e-6) {
+            result.push(b);
+            continue;
+        }
+        bisX /= bisLen;
+        bisY /= bisLen;
+        const centerDist = config.dubinsTurningRadius / sinHalf;
+        const cx = b.x + bisX * centerDist;
+        const cy = b.y + bisY * centerDist;
+        // Compute start/end angles of the arc.
+        const startAngle = Math.atan2(a.y - cy, a.x - cx);
+        const endAngle = Math.atan2(c.y - cy, c.x - cx);
+        // Signed sweep from startAngle to endAngle — same formula for both turn directions.
+        const sweep = endAngle - startAngle;
+        for (let s = 1; s <= ARC_SUBDIVISIONS; s++) {
+            const t = s / (ARC_SUBDIVISIONS + 1);
+            const arcAngle = startAngle + sweep * t;
+            result.push({
+                x: cx + Math.cos(arcAngle) * config.dubinsTurningRadius,
+                y: cy + Math.sin(arcAngle) * config.dubinsTurningRadius,
+            });
+        }
+    }
+    result.push(base[base.length - 1]);
+    return result;
+}
+//# sourceMappingURL=PathSmoother.js.map

package/dist/navigation/PathSmoother.js.map

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

package/dist/navigation/RestrictedZoneManager.d.ts

@@ -0,0 +1,83 @@
+import type { Vec2 } from '@alife-sdk/core';
+/**
+ * Zone restriction types.
+ * - IN: NPC must stay inside the zone.
+ * - OUT: NPC cannot enter the zone.
+ * - DANGER: Soft avoidance — NPC prefers to avoid but can enter.
+ */
+export declare const RestrictionType: {
+    readonly IN: 0;
+    readonly OUT: 1;
+    readonly DANGER: 2;
+};
+export type RestrictionType = (typeof RestrictionType)[keyof typeof RestrictionType];
+/**
+ * A circular restricted zone in world space.
+ */
+export interface IRestrictedZone {
+    readonly id: string;
+    readonly type: RestrictionType;
+    readonly x: number;
+    readonly y: number;
+    readonly radius: number;
+    active: boolean;
+    readonly metadata?: string;
+}
+/**
+ * Manages circular no-go and soft-avoidance zones for NPC movement.
+ *
+ * Instance-based — create one per simulation. No global state.
+ *
+ * @example
+ * ```ts
+ * const zones = new RestrictedZoneManager(20); // 20px safety margin
+ * zones.addZone({ id: 'rad_1', type: RestrictionType.OUT, x: 100, y: 100, radius: 50, active: true });
+ *
+ * if (!zones.accessible(110, 110)) {
+ *   const safe = zones.getSafeDirection(110, 110);
+ *   // Move NPC along safe.dx, safe.dy
+ * }
+ * ```
+ */
+export declare class RestrictedZoneManager {
+    private readonly zones;
+    private readonly safeMargin;
+    constructor(safeMargin: number);
+    addZone(zone: IRestrictedZone): void;
+    removeZone(id: string): void;
+    setActive(id: string, active: boolean): void;
+    removeByMetadata(tag: string): void;
+    getAllZones(): readonly IRestrictedZone[];
+    getZonesAt(x: number, y: number): readonly IRestrictedZone[];
+    get size(): number;
+    clear(): void;
+    /**
+     * Check if a position satisfies all hard zone constraints.
+     *
+     * - OUT zones: position must be outside (radius + safeMargin).
+     * - IN zones: position must be inside zone radius.
+     * - DANGER zones: ignored (soft avoidance only).
+     *
+     * Uses squared-distance for performance. Early-exit on first violation.
+     */
+    accessible(x: number, y: number): boolean;
+    /**
+     * Check if a position is inside any active DANGER zone.
+     * Does not prevent movement — used to trigger escape behavior.
+     */
+    isDangerous(x: number, y: number): boolean;
+    /**
+     * Compute a normalized direction vector to move away from the nearest
+     * active OUT or DANGER zone that contains this point.
+     *
+     * @returns Unit vector `{x, y}` pointing away from the zone center,
+     *          or null if the position is already safe.
+     */
+    getSafeDirection(x: number, y: number): Vec2 | null;
+    /**
+     * Filter a list of waypoints to only those in accessible positions.
+     * O(waypoints × zones).
+     */
+    filterAccessibleWaypoints<T extends Vec2>(waypoints: readonly T[]): T[];
+}
+//# sourceMappingURL=RestrictedZoneManager.d.ts.map

package/dist/navigation/RestrictedZoneManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestrictedZoneManager.d.ts","sourceRoot":"","sources":["../../src/navigation/RestrictedZoneManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,EAAE,MAAM;IAQ9B,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAIpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAK5C,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnC,WAAW,IAAI,SAAS,eAAe,EAAE;IAIzC,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE;IAa5D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAQb;;;;;;;;OAQG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAuBzC;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAgB1C;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAuCnD;;;OAGG;IACH,yBAAyB,CAAC,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;CAGxE"}