@alife-sdk/ai 0.1.0

package/dist/types/IAnimationTypes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Eight cardinal/intercardinal directions for sprite animation.
+ * Values are string keys used in animation name composition.
+ */
+export declare const AnimDirection: {
+    readonly DOWN: "down";
+    readonly DOWN_LEFT: "down_left";
+    readonly DOWN_RIGHT: "down_right";
+    readonly LEFT: "left";
+    readonly RIGHT: "right";
+    readonly UP: "up";
+    readonly UP_LEFT: "up_left";
+    readonly UP_RIGHT: "up_right";
+};
+export type AnimDirection = (typeof AnimDirection)[keyof typeof AnimDirection];
+/**
+ * Resolved animation key ready for sprite playback.
+ * Contains the full key string and optional metadata.
+ */
+export interface IAnimKeyResult {
+    /** Full animation key, e.g. 'walk_rifle_down_left'. */
+    readonly key: string;
+    /** Direction component for flip/mirror logic. */
+    readonly direction: AnimDirection;
+    /** Whether the sprite should be horizontally flipped. */
+    readonly flipX: boolean;
+}
+//# sourceMappingURL=IAnimationTypes.d.ts.map

package/dist/types/IAnimationTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAnimationTypes.d.ts","sourceRoot":"","sources":["../../src/types/IAnimationTypes.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/types/IAnimationTypes.js

@@ -0,0 +1,17 @@
+// types/IAnimationTypes.ts
+// Animation key resolution types for NPC sprite systems.
+/**
+ * Eight cardinal/intercardinal directions for sprite animation.
+ * Values are string keys used in animation name composition.
+ */
+export const AnimDirection = {
+    DOWN: 'down',
+    DOWN_LEFT: 'down_left',
+    DOWN_RIGHT: 'down_right',
+    LEFT: 'left',
+    RIGHT: 'right',
+    UP: 'up',
+    UP_LEFT: 'up_left',
+    UP_RIGHT: 'up_right',
+};
+//# sourceMappingURL=IAnimationTypes.js.map

package/dist/types/IAnimationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAnimationTypes.js","sourceRoot":"","sources":["../../src/types/IAnimationTypes.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,yDAAyD;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,IAAI;IACR,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/types/ICoverPoint.d.ts

@@ -0,0 +1,76 @@
+import type { Vec2 } from '@alife-sdk/core';
+/**
+ * A firing position within a cover point.
+ *
+ * Loopholes represent peek offsets from the cover center where an NPC
+ * can expose themselves to fire while remaining partially protected.
+ * The firing arc defines the angular range the NPC can engage from
+ * this position.
+ */
+export interface ILoophole {
+    /** X offset from cover center to peek position (px). */
+    readonly offsetX: number;
+    /** Y offset from cover center to peek position (px). */
+    readonly offsetY: number;
+    /** Start of the valid firing arc (radians, 0 = right, CCW positive). */
+    readonly angleMin: number;
+    /** End of the valid firing arc (radians). */
+    readonly angleMax: number;
+}
+/**
+ * A single cover position in world space.
+ *
+ * Cover points are registered with a {@link CoverRegistry} and queried
+ * during combat to find the best tactical position. Occupancy is tracked
+ * per point — only one NPC can shelter at each point at a time.
+ */
+export interface ICoverPoint {
+    /** Unique identifier (e.g. 'cover_0042'). */
+    readonly id: string;
+    /** World X coordinate. */
+    readonly x: number;
+    /** World Y coordinate. */
+    readonly y: number;
+    /** Protection radius in pixels. */
+    readonly radius: number;
+    /** NPC ID currently sheltering here, or null if free. */
+    occupiedBy: string | null;
+    /** Auto-generated firing positions. Populated lazily. */
+    loopholes: readonly ILoophole[];
+}
+/**
+ * Minimal enemy position for cover evaluation.
+ * Avoids entity references so evaluators remain pure functions.
+ */
+export type IEnemyPosition = Vec2;
+/**
+ * Context passed to cover evaluators for scoring decisions.
+ * Aggregates all tactical data an evaluator needs.
+ */
+export interface ICoverEvalContext {
+    /** Position of the NPC seeking cover. */
+    readonly npcPosition: Vec2;
+    /** Known enemy positions. */
+    readonly enemies: readonly IEnemyPosition[];
+    /** Search radius limit (squared for perf). */
+    readonly maxRadiusSq: number;
+}
+/**
+ * Evaluator categories — each optimizes for a different tactical priority.
+ */
+export declare const CoverType: {
+    /** Nearest cover — quick retreat, prioritizes proximity. */
+    readonly CLOSE: "close";
+    /** Far cover — strategic retreat, maximizes distance from enemies. */
+    readonly FAR: "far";
+    /** Balanced scoring — distance + safety + angle (default). */
+    readonly BALANCED: "balanced";
+    /** @deprecated Use BALANCED */
+    readonly BEST: "balanced";
+    /** Flanking position — good angle on enemy, offensive. */
+    readonly AMBUSH: "ambush";
+    /** Maximum safety — minimum aggregate threat exposure. */
+    readonly SAFE: "safe";
+};
+export type CoverType = (typeof CoverType)[keyof typeof CoverType];
+//# sourceMappingURL=ICoverPoint.d.ts.map

package/dist/types/ICoverPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoverPoint.d.ts","sourceRoot":"","sources":["../../src/types/ICoverPoint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yDAAyD;IACzD,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,4DAA4D;;IAE5D,sEAAsE;;IAEtE,8DAA8D;;IAE9D,+BAA+B;;IAE/B,0DAA0D;;IAE1D,0DAA0D;;CAElD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/types/ICoverPoint.js

@@ -0,0 +1,21 @@
+// types/ICoverPoint.ts
+// Value objects for the tactical cover system.
+// All types are pure data — no behavior, no framework coupling.
+/**
+ * Evaluator categories — each optimizes for a different tactical priority.
+ */
+export const CoverType = {
+    /** Nearest cover — quick retreat, prioritizes proximity. */
+    CLOSE: 'close',
+    /** Far cover — strategic retreat, maximizes distance from enemies. */
+    FAR: 'far',
+    /** Balanced scoring — distance + safety + angle (default). */
+    BALANCED: 'balanced',
+    /** @deprecated Use BALANCED */
+    BEST: 'balanced',
+    /** Flanking position — good angle on enemy, offensive. */
+    AMBUSH: 'ambush',
+    /** Maximum safety — minimum aggregate threat exposure. */
+    SAFE: 'safe',
+};
+//# sourceMappingURL=ICoverPoint.js.map

package/dist/types/ICoverPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoverPoint.js","sourceRoot":"","sources":["../../src/types/ICoverPoint.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,+CAA+C;AAC/C,gEAAgE;AAgEhE;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,4DAA4D;IAC5D,KAAK,EAAE,OAAO;IACd,sEAAsE;IACtE,GAAG,EAAE,KAAK;IACV,8DAA8D;IAC9D,QAAQ,EAAE,UAAU;IACpB,+BAA+B;IAC/B,IAAI,EAAE,UAAU;IAChB,0DAA0D;IAC1D,MAAM,EAAE,QAAQ;IAChB,0DAA0D;IAC1D,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/types/IOnlineAIConfig.d.ts

@@ -0,0 +1,150 @@
+import type { IWeaponConfig, WeaponCategory } from './IWeaponTypes';
+import type { IPerceptionConfig, IGOAPConfig } from './IPerceptionTypes';
+/**
+ * Cover system tuning constants.
+ */
+export interface ICoverConfig {
+    /** Max search radius when finding cover (px). */
+    readonly searchRadius: number;
+    /** Default protection radius for cover points (px). */
+    readonly pointRadius: number;
+    /** Distance within which an NPC counts as "in cover" (px). */
+    readonly occupyDistance: number;
+    /** Minimum score threshold — points below this are rejected. */
+    readonly minScoreThreshold: number;
+    /** CLOSE evaluator: max acceptable distance (px). */
+    readonly closeMaxRange: number;
+    /** FAR evaluator: max acceptable distance (px). */
+    readonly farMaxRange: number;
+    /** AMBUSH evaluator: minimum flanking angle (radians). */
+    readonly ambushMinAngle: number;
+    /** AMBUSH evaluator: maximum flanking angle (radians). */
+    readonly ambushMaxAngle: number;
+    /** AMBUSH evaluator: minimum distance from enemy (px). */
+    readonly ambushMinDist: number;
+    /** AMBUSH evaluator: maximum distance from enemy (px). */
+    readonly ambushMaxDist: number;
+    /** HP ratio below which cover is critical (CLOSE). */
+    readonly recommendHpCritical: number;
+    /** HP ratio above which NPC can be offensive (AMBUSH). */
+    readonly recommendHpHealthy: number;
+    /** Morale below which NPC should flee (FAR/SAFE). */
+    readonly recommendMoraleDemoralized: number;
+    /** Enemy count above which SAFE is preferred. */
+    readonly recommendOutnumberedCount: number;
+    /** Total angular width of a loophole firing arc (radians). */
+    readonly loopholeFireArc: number;
+    /** Maximum loopholes per cover point. */
+    readonly loopholeMaxPerCover: number;
+    /** Distance from cover center to peek position (px). */
+    readonly loopholeOffsetDistance: number;
+}
+/**
+ * Navigation and pathfinding tuning constants.
+ */
+export interface INavigationConfig {
+    /** CatmullRom interpolation points per path segment. */
+    readonly smoothPointsPerSegment: number;
+    /** Max random jitter offset for path smoothing (px). */
+    readonly smoothRandomOffset: number;
+    /** Distance threshold for considering a waypoint reached (px). */
+    readonly arrivalThreshold: number;
+    /** Maximum turn angle before Dubins arc insertion (radians). */
+    readonly dubinsMaxInstantTurn: number;
+    /** Turning radius for Dubins arcs (px). */
+    readonly dubinsTurningRadius: number;
+    /** Velocity multiplier for straight segments. */
+    readonly velocityCurveFast: number;
+    /** Velocity multiplier for moderate turns. */
+    readonly velocityCurveMedium: number;
+    /** Velocity multiplier for sharp turns. */
+    readonly velocityCurveSlow: number;
+    /** Interpolation rate for velocity transitions per step. */
+    readonly velocityTransitionRate: number;
+    /** Safety margin around restricted zones (px). */
+    readonly restrictedZoneSafeMargin: number;
+}
+/**
+ * Per-weapon-category scoring factors for multi-factor weapon selection.
+ * When provided in `IWeaponSelectionConfig.scoringFactors`, overrides the
+ * hardcoded enemy-count and HP-ratio modifiers for the given category.
+ */
+export interface IWeaponScoringFactors {
+    /** Base effectiveness score (unused by default distance scoring, reserved for extensions). */
+    readonly baseEffectiveness: number;
+    /** Modifier applied when 3+ enemies are visible. */
+    readonly multiEnemyModifier: number;
+    /** Modifier applied when HP ratio < 0.3. */
+    readonly lowHpModifier: number;
+    /** Modifier applied when HP ratio > 0.7. */
+    readonly highHpModifier: number;
+}
+/**
+ * Weapon selection and loadout tuning constants.
+ */
+export interface IWeaponSelectionConfig {
+    /** Per-weapon-category configurations. */
+    readonly weapons: Readonly<Record<WeaponCategory, IWeaponConfig>>;
+    /** Shotgun maximum effective range (px). */
+    readonly shotgunEffectiveMax: number;
+    /** Rifle minimum effective range (px). */
+    readonly rifleEffectiveMin: number;
+    /** Rifle maximum effective range (px). */
+    readonly rifleEffectiveMax: number;
+    /** Sniper minimum effective range (px). */
+    readonly sniperEffectiveMin: number;
+    /** Minimum throw distance for grenades (px). */
+    readonly grenadeMinDistance: number;
+    /** Maximum throw distance for grenades (px). */
+    readonly grenadeMaxDistance: number;
+    /** Minimum enemies to justify a grenade throw. */
+    readonly grenadeMinEnemies: number;
+    /** HP ratio threshold to consider using a medkit. */
+    readonly medkitHpThreshold: number;
+    /** HP ratio below which medkit is used even in combat. */
+    readonly medkitEmergencyThreshold: number;
+    /** Optional per-category scoring overrides for enemy-count and HP-ratio modifiers. */
+    readonly scoringFactors?: Readonly<Record<string, IWeaponScoringFactors>>;
+}
+/**
+ * Squad tactical evaluation tuning.
+ */
+export interface ISquadTacticsConfig {
+    /** Enemy-to-ally ratio above which the squad is outnumbered. */
+    readonly outnumberRatio: number;
+    /** Morale value at which NPC is considered panicked. */
+    readonly moralePanickedThreshold: number;
+    /** Distance within which squad members are considered "nearby" (px). */
+    readonly nearbyRadius: number;
+}
+/**
+ * Monster ability timing constants.
+ */
+export interface IMonsterAbilityConfig {
+    readonly chargeWindupMs: number;
+    readonly chargeDamageMult: number;
+    readonly chargeSpeedMult: number;
+    readonly stalkApproachDist: number;
+    readonly stalkAlphaInvisible: number;
+    readonly stalkUncloakDist: number;
+    readonly leapWindupMs: number;
+    readonly leapAirtimeMs: number;
+    readonly leapDamageMult: number;
+    readonly psiChannelMs: number;
+    readonly psiRadius: number;
+    readonly psiDamagePerTick: number;
+}
+/**
+ * Root configuration for all online AI subsystems.
+ * Passed to AIPlugin constructor; each subsystem reads its own section.
+ */
+export interface IOnlineAIConfig {
+    readonly cover: ICoverConfig;
+    readonly navigation: INavigationConfig;
+    readonly weapon: IWeaponSelectionConfig;
+    readonly squad: ISquadTacticsConfig;
+    readonly monsterAbility: IMonsterAbilityConfig;
+    readonly perception: IPerceptionConfig;
+    readonly goap: IGOAPConfig;
+}
+//# sourceMappingURL=IOnlineAIConfig.d.ts.map

package/dist/types/IOnlineAIConfig.d.ts.map

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

package/dist/types/IOnlineAIConfig.js

@@ -0,0 +1,5 @@
+// types/IOnlineAIConfig.ts
+// Hierarchical configuration for all online AI subsystems.
+// Every numeric literal in the AI package is sourced from here.
+export {};
+//# sourceMappingURL=IOnlineAIConfig.js.map

package/dist/types/IOnlineAIConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOnlineAIConfig.js","sourceRoot":"","sources":["../../src/types/IOnlineAIConfig.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,2DAA2D;AAC3D,gEAAgE"}

package/dist/types/IPerceptionTypes.d.ts

@@ -0,0 +1,94 @@
+import type { Vec2 } from '@alife-sdk/core';
+/**
+ * An entity as perceived by the perception system.
+ * Minimal data — host provides via IPerceptionProvider port.
+ */
+export interface IPerceivedEntity {
+    readonly entityId: string;
+    readonly position: Vec2;
+    readonly factionId: string;
+    readonly isAlive: boolean;
+}
+/**
+ * Perception configuration constants.
+ */
+export interface IPerceptionConfig {
+    /** Maximum vision distance (px). */
+    readonly visionRange: number;
+    /** Half-angle of the vision cone (radians). Full FOV = 2× this value. */
+    readonly visionHalfAngle: number;
+    /** Maximum hearing range (px). */
+    readonly hearingRange: number;
+    /** Gunshot sound propagation radius (px). */
+    readonly weaponSoundRange: number;
+}
+/**
+ * GOAP controller configuration constants.
+ */
+export interface IGOAPConfig {
+    /** Time between periodic replans (ms). */
+    readonly replanIntervalMs: number;
+    /** Minimum NPC rank for GOAP eligibility. */
+    readonly eliteRankThreshold: number;
+    /** HP ratio below which the heal goal is prioritized. */
+    readonly healHpThreshold: number;
+    /** Maximum plan search depth. */
+    readonly maxPlanDepth: number;
+    /** Time after which danger memories are considered stale (ms). */
+    readonly dangerMemoryMaxAge: number;
+}
+/**
+ * World state property keys used by the GOAP subsystem.
+ * String-based for compatibility with alife-core WorldState.
+ */
+export declare const WorldProperty: {
+    readonly ALIVE: "alive";
+    readonly ENEMY_PRESENT: "enemyPresent";
+    readonly SEE_ENEMY: "seeEnemy";
+    readonly ENEMY_SEE_ME: "enemySeeMe";
+    readonly HAS_WEAPON: "hasWeapon";
+    readonly READY_TO_KILL: "readyToKill";
+    readonly IN_COVER: "inCover";
+    readonly CRITICALLY_WOUNDED: "criticallyWounded";
+    readonly ENEMY_WOUNDED: "enemyWounded";
+    readonly DANGER: "danger";
+    readonly DANGER_GRENADE: "dangerGrenade";
+    readonly HAS_AMMO: "hasAmmo";
+    readonly LOOKED_OUT: "lookedOut";
+    readonly POSITION_HELD: "positionHeld";
+    readonly ENEMY_IN_RANGE: "enemyInRange";
+    readonly AT_TARGET: "atTarget";
+    readonly ANOMALY_NEAR: "anomalyNear";
+};
+export type WorldPropertyKey = (typeof WorldProperty)[keyof typeof WorldProperty];
+/**
+ * Snapshot of NPC data used to build GOAP world state.
+ * All fields are readonly — the builder is a pure function.
+ */
+export interface INPCWorldSnapshot {
+    readonly isAlive: boolean;
+    readonly hpRatio: number;
+    readonly hasWeapon: boolean;
+    readonly hasAmmo: boolean;
+    readonly inCover: boolean;
+    readonly seeEnemy: boolean;
+    readonly enemyPresent: boolean;
+    readonly enemyInRange: boolean;
+    readonly hasDanger: boolean;
+    readonly hasDangerGrenade: boolean;
+    readonly enemyWounded: boolean;
+    readonly nearAnomalyZone: boolean;
+}
+/**
+ * Priority band for goal selection.
+ * Lower band number = higher priority.
+ */
+export declare const GoalPriority: {
+    readonly CRITICALLY_WOUNDED: 0;
+    readonly ENEMY_PRESENT: 1;
+    readonly DANGER: 2;
+    readonly ANOMALY_AVOID: 3;
+    readonly DEFAULT: 4;
+};
+export type GoalPriorityLevel = (typeof GoalPriority)[keyof typeof GoalPriority];
+//# sourceMappingURL=IPerceptionTypes.d.ts.map

package/dist/types/IPerceptionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPerceptionTypes.d.ts","sourceRoot":"","sources":["../../src/types/IPerceptionTypes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;CAkBhB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/types/IPerceptionTypes.js

@@ -0,0 +1,37 @@
+// types/IPerceptionTypes.ts
+// Value objects for the perception subsystem.
+/**
+ * World state property keys used by the GOAP subsystem.
+ * String-based for compatibility with alife-core WorldState.
+ */
+export const WorldProperty = {
+    ALIVE: 'alive',
+    ENEMY_PRESENT: 'enemyPresent',
+    SEE_ENEMY: 'seeEnemy',
+    ENEMY_SEE_ME: 'enemySeeMe',
+    HAS_WEAPON: 'hasWeapon',
+    READY_TO_KILL: 'readyToKill',
+    IN_COVER: 'inCover',
+    CRITICALLY_WOUNDED: 'criticallyWounded',
+    ENEMY_WOUNDED: 'enemyWounded',
+    DANGER: 'danger',
+    DANGER_GRENADE: 'dangerGrenade',
+    HAS_AMMO: 'hasAmmo',
+    LOOKED_OUT: 'lookedOut',
+    POSITION_HELD: 'positionHeld',
+    ENEMY_IN_RANGE: 'enemyInRange',
+    AT_TARGET: 'atTarget',
+    ANOMALY_NEAR: 'anomalyNear',
+};
+/**
+ * Priority band for goal selection.
+ * Lower band number = higher priority.
+ */
+export const GoalPriority = {
+    CRITICALLY_WOUNDED: 0,
+    ENEMY_PRESENT: 1,
+    DANGER: 2,
+    ANOMALY_AVOID: 3,
+    DEFAULT: 4,
+};
+//# sourceMappingURL=IPerceptionTypes.js.map

package/dist/types/IPerceptionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPerceptionTypes.js","sourceRoot":"","sources":["../../src/types/IPerceptionTypes.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,8CAA8C;AA6C9C;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,cAAc;IAC7B,SAAS,EAAE,UAAU;IACrB,YAAY,EAAE,YAAY;IAC1B,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,aAAa;IAC5B,QAAQ,EAAE,SAAS;IACnB,kBAAkB,EAAE,mBAAmB;IACvC,aAAa,EAAE,cAAc;IAC7B,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,eAAe;IAC/B,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,WAAW;IACvB,aAAa,EAAE,cAAc;IAC7B,cAAc,EAAE,cAAc;IAC9B,SAAS,EAAE,UAAU;IACrB,YAAY,EAAE,aAAa;CACnB,CAAC;AAuBX;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,kBAAkB,EAAE,CAAC;IACrB,aAAa,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC;IACT,aAAa,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC;CACF,CAAC"}

package/dist/types/IWeaponTypes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Weapon category identifiers.
+ * Numeric values enable fast switch-case dispatch in scoring logic.
+ */
+export declare const WeaponCategory: {
+    readonly PISTOL: 0;
+    readonly SHOTGUN: 1;
+    readonly RIFLE: 2;
+    readonly SNIPER: 3;
+    readonly GRENADE: 4;
+    readonly MEDKIT: 5;
+};
+export type WeaponCategory = (typeof WeaponCategory)[keyof typeof WeaponCategory] | (string & {});
+/**
+ * Effective engagement range for a weapon type.
+ * Used by weapon selection scoring to evaluate distance suitability.
+ */
+export interface IWeaponRange {
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * Static configuration for a weapon type.
+ * Defines baseline stats used for loadout creation and scoring.
+ */
+export interface IWeaponConfig {
+    readonly category: WeaponCategory;
+    readonly range: IWeaponRange;
+    readonly damage: number;
+    /** Shots per second. */
+    readonly fireRate: number;
+    readonly defaultAmmo: number;
+}
+/**
+ * Runtime state for a single weapon carried by an NPC.
+ * Ammo is mutable — decremented as shots are fired.
+ */
+export interface IWeaponSlot {
+    readonly category: WeaponCategory;
+    ammo: number;
+    readonly maxAmmo: number;
+    readonly range: IWeaponRange;
+    readonly damage: number;
+    readonly fireRate: number;
+}
+/**
+ * Full inventory snapshot for one NPC.
+ * Primary and secondary slots may be null if the NPC carries no such weapon.
+ */
+export interface INPCLoadout {
+    primary: IWeaponSlot | null;
+    secondary: IWeaponSlot | null;
+    grenades: number;
+    medkits: number;
+}
+//# sourceMappingURL=IWeaponTypes.d.ts.map

package/dist/types/IWeaponTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWeaponTypes.d.ts","sourceRoot":"","sources":["../../src/types/IWeaponTypes.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/IWeaponTypes.js

@@ -0,0 +1,15 @@
+// types/IWeaponTypes.ts
+// Weapon system value objects and type definitions.
+/**
+ * Weapon category identifiers.
+ * Numeric values enable fast switch-case dispatch in scoring logic.
+ */
+export const WeaponCategory = {
+    PISTOL: 0,
+    SHOTGUN: 1,
+    RIFLE: 2,
+    SNIPER: 3,
+    GRENADE: 4,
+    MEDKIT: 5,
+};
+//# sourceMappingURL=IWeaponTypes.js.map

package/dist/types/IWeaponTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWeaponTypes.js","sourceRoot":"","sources":["../../src/types/IWeaponTypes.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,oDAAoD;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;CACD,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export type { ILoophole, ICoverPoint, IEnemyPosition, ICoverEvalContext, } from './ICoverPoint';
+export { CoverType } from './ICoverPoint';
+export type { IWeaponRange, IWeaponConfig, IWeaponSlot, INPCLoadout, } from './IWeaponTypes';
+export { WeaponCategory } from './IWeaponTypes';
+export type { IAnimKeyResult } from './IAnimationTypes';
+export { AnimDirection as AnimDirectionType } from './IAnimationTypes';
+export type { IWeaponScoringFactors, ICoverConfig, INavigationConfig, IWeaponSelectionConfig, ISquadTacticsConfig, IMonsterAbilityConfig, IOnlineAIConfig, } from './IOnlineAIConfig';
+export type { IPerceivedEntity, IPerceptionConfig, IGOAPConfig, INPCWorldSnapshot, WorldPropertyKey, GoalPriorityLevel, } from './IPerceptionTypes';
+export { WorldProperty, GoalPriority } from './IPerceptionTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+export { CoverType } from './ICoverPoint';
+export { WeaponCategory } from './IWeaponTypes';
+export { AnimDirection as AnimDirectionType } from './IAnimationTypes';
+export { WorldProperty, GoalPriority } from './IPerceptionTypes';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO1C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAkBvE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}