@alife-sdk/ai 0.1.0

package/dist/combat/LoadoutBuilder.js

@@ -0,0 +1,213 @@
+// combat/LoadoutBuilder.ts
+// Builder pattern for creating NPC weapon loadouts.
+// Clean, fluent API — no framework dependencies.
+import { WeaponCategory } from '../types/IWeaponTypes';
+/**
+ * Builds an NPC loadout step-by-step with a fluent API.
+ *
+ * @example
+ * ```ts
+ * const loadout = new LoadoutBuilder(config.weapon)
+ *   .withPrimary(WeaponCategory.RIFLE)
+ *   .withSecondary(WeaponCategory.PISTOL)
+ *   .withGrenades(2)
+ *   .withMedkits(1)
+ *   .build();
+ * ```
+ */
+export class LoadoutBuilder {
+    constructor(weaponConfigs) {
+        this.primary = null;
+        this.secondary = null;
+        this.grenades = 0;
+        this.medkits = 0;
+        this.weaponConfigs = weaponConfigs;
+    }
+    withPrimary(category, ammo) {
+        this.primary = this.createSlot(category, ammo);
+        return this;
+    }
+    withSecondary(category, ammo) {
+        this.secondary = this.createSlot(category, ammo);
+        return this;
+    }
+    withGrenades(count) {
+        this.grenades = Math.max(0, count);
+        return this;
+    }
+    withMedkits(count) {
+        this.medkits = Math.max(0, count);
+        return this;
+    }
+    build() {
+        return {
+            primary: this.primary,
+            secondary: this.secondary,
+            grenades: this.grenades,
+            medkits: this.medkits,
+        };
+    }
+    createSlot(category, ammoOverride) {
+        const cfg = this.weaponConfigs.weapons[category];
+        if (!cfg) {
+            throw new Error(`[LoadoutBuilder] Unknown weapon category: ${String(category)}. Register it in IWeaponSelectionConfig.weapons.`);
+        }
+        const ammo = ammoOverride ?? cfg.defaultAmmo;
+        return {
+            category,
+            ammo,
+            maxAmmo: cfg.defaultAmmo,
+            range: cfg.range,
+            damage: cfg.damage,
+            fireRate: cfg.fireRate,
+        };
+    }
+}
+/**
+ * Default rank → loadout recipes matching the original if-else chain.
+ * Ranks not present (7+) fall through to formula-based generation.
+ */
+export const DEFAULT_LOADOUT_RECIPES = {
+    1: { primary: WeaponCategory.PISTOL, grenades: 0, medkits: 0 },
+    2: { primary: WeaponCategory.PISTOL, grenades: 0, medkits: 1 },
+    3: { primary: WeaponCategory.PISTOL, grenades: 0, medkits: 1, useFactionPreference: true, secondary: WeaponCategory.PISTOL },
+    4: { primary: WeaponCategory.PISTOL, grenades: 1, medkits: 2, useFactionPreference: true, secondary: WeaponCategory.PISTOL },
+    5: { primary: WeaponCategory.RIFLE, secondary: WeaponCategory.SHOTGUN, grenades: 1, medkits: 2 },
+    6: { primary: WeaponCategory.RIFLE, secondary: WeaponCategory.SHOTGUN, grenades: 2, medkits: 2 },
+};
+export const FactionWeaponPreference = {
+    rifle: WeaponCategory.RIFLE,
+    shotgun: WeaponCategory.SHOTGUN,
+    pistol: WeaponCategory.PISTOL,
+    sniper: WeaponCategory.SNIPER,
+};
+/**
+ * Resolve the primary weapon for mid-rank NPCs (rank 3–4) based on faction preference.
+ * Sniper is too advanced for rookies — falls back to rifle.
+ */
+function resolveMidRankPrimary(preference) {
+    if (preference === WeaponCategory.SHOTGUN)
+        return WeaponCategory.SHOTGUN;
+    if (preference === WeaponCategory.SNIPER)
+        return WeaponCategory.RIFLE;
+    return WeaponCategory.RIFLE;
+}
+/**
+ * Create a rank-appropriate loadout for an NPC.
+ *
+ * Rank determines the tier of equipment. Faction preference
+ * influences weapon choice at mid ranks where multiple options
+ * are viable.
+ *
+ * | Rank | Primary | Secondary | Grenades | Medkits |
+ * |------|---------|-----------|----------|---------|
+ * | 1    | PISTOL  | —         | 0        | 0       |
+ * | 2    | PISTOL  | —         | 0        | 1       |
+ * | 3    | faction | PISTOL    | 0        | 1       |
+ * | 4    | faction | PISTOL    | 1        | 2       |
+ * | 5    | RIFLE   | SHOTGUN   | 1        | 2       |
+ * | 6    | RIFLE*  | SHOTGUN   | 2        | 2       |
+ * | 7+   | SNIPER  | RIFLE     | min(r-4,3) | 3    |
+ *
+ * *At rank 6, sniper factions get SNIPER as primary.
+ *
+ * @param recipes - Optional custom recipe map. If provided and a matching rank
+ *   entry exists (exact or highest rank <= current), it is used instead of the
+ *   built-in if-else chain. If not provided, the original hardcoded logic applies.
+ */
+export function createLoadout(rank, factionPreference, config, recipes) {
+    if (recipes) {
+        const recipe = findRecipe(rank, recipes);
+        if (recipe) {
+            return applyRecipe(recipe, factionPreference, config);
+        }
+    }
+    return createLoadoutDefault(rank, factionPreference, config);
+}
+/**
+ * Find the best matching recipe for the given rank.
+ * Returns exact match, or the highest rank key <= current rank.
+ * Returns undefined if no suitable recipe exists.
+ */
+function findRecipe(rank, recipes) {
+    if (recipes[rank])
+        return recipes[rank];
+    // Find highest rank key that is <= current rank.
+    let bestKey = -1;
+    for (const key of Object.keys(recipes)) {
+        const k = Number(key);
+        if (k <= rank && k > bestKey)
+            bestKey = k;
+    }
+    return bestKey >= 0 ? recipes[bestKey] : undefined;
+}
+/**
+ * Apply a recipe to build a loadout.
+ */
+function applyRecipe(recipe, factionPreference, config) {
+    const b = new LoadoutBuilder(config);
+    const primaryCategory = recipe.useFactionPreference
+        ? resolveMidRankPrimary(factionPreference)
+        : recipe.primary;
+    b.withPrimary(primaryCategory);
+    if (recipe.secondary != null) {
+        b.withSecondary(recipe.secondary);
+    }
+    b.withGrenades(recipe.grenades);
+    b.withMedkits(recipe.medkits);
+    return b.build();
+}
+/**
+ * Original hardcoded loadout creation logic (unchanged).
+ */
+function createLoadoutDefault(rank, factionPreference, config) {
+    const b = new LoadoutBuilder(config);
+    if (rank <= 1) {
+        return b.withPrimary(WeaponCategory.PISTOL).build();
+    }
+    if (rank === 2) {
+        return b.withPrimary(WeaponCategory.PISTOL).withMedkits(1).build();
+    }
+    if (rank === 3) {
+        return b
+            .withPrimary(resolveMidRankPrimary(factionPreference))
+            .withSecondary(WeaponCategory.PISTOL)
+            .withMedkits(1)
+            .build();
+    }
+    if (rank === 4) {
+        return b
+            .withPrimary(resolveMidRankPrimary(factionPreference))
+            .withSecondary(WeaponCategory.PISTOL)
+            .withGrenades(1)
+            .withMedkits(2)
+            .build();
+    }
+    if (rank === 5) {
+        return b
+            .withPrimary(WeaponCategory.RIFLE)
+            .withSecondary(WeaponCategory.SHOTGUN)
+            .withGrenades(1)
+            .withMedkits(2)
+            .build();
+    }
+    if (rank === 6) {
+        const primary = factionPreference === WeaponCategory.SNIPER
+            ? WeaponCategory.SNIPER
+            : WeaponCategory.RIFLE;
+        return b
+            .withPrimary(primary)
+            .withSecondary(WeaponCategory.SHOTGUN)
+            .withGrenades(2)
+            .withMedkits(2)
+            .build();
+    }
+    // Rank 7+
+    return b
+        .withPrimary(WeaponCategory.SNIPER)
+        .withSecondary(WeaponCategory.RIFLE)
+        .withGrenades(Math.min(rank - 4, 3))
+        .withMedkits(3)
+        .build();
+}
+//# sourceMappingURL=LoadoutBuilder.js.map

package/dist/combat/LoadoutBuilder.js.map

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

package/dist/combat/MonsterAbilityData.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Monster ability type identifiers.
+ * Used to determine which ability phase data to create.
+ */
+export declare const MonsterAbility: {
+    readonly CHARGE: "charge";
+    readonly STALK: "stalk";
+    readonly LEAP: "leap";
+    readonly PSI_ATTACK: "psi_attack";
+};
+export type MonsterAbility = (typeof MonsterAbility)[keyof typeof MonsterAbility] | (string & {});
+export type LinearChargePhase = 'windup' | 'charging' | 'impact';
+export interface ILinearChargeData {
+    phase: LinearChargePhase;
+    timer: number;
+    startX: number;
+    startY: number;
+    targetX: number;
+    targetY: number;
+}
+export declare function createLinearChargeData(startX: number, startY: number, targetX: number, targetY: number, windupMs: number): ILinearChargeData;
+export type ApproachPhase = 'approach' | 'uncloak';
+export interface IApproachData {
+    phase: ApproachPhase;
+    targetX: number;
+    targetY: number;
+}
+export declare function createApproachData(targetX: number, targetY: number): IApproachData;
+export type LeapPhase = 'windup' | 'airborne' | 'land';
+export interface ILeapData {
+    phase: LeapPhase;
+    timer: number;
+    startX: number;
+    startY: number;
+    targetX: number;
+    targetY: number;
+}
+export declare function createLeapData(startX: number, startY: number, targetX: number, targetY: number, windupMs: number): ILeapData;
+export type ChannelAbilityPhase = 'channel' | 'fire';
+export interface IChannelAbilityData {
+    phase: ChannelAbilityPhase;
+    timer: number;
+    targetX: number;
+    targetY: number;
+}
+export declare function createChannelAbilityData(targetX: number, targetY: number, channelMs: number): IChannelAbilityData;
+/**
+ * Context for determining which monster ability to trigger.
+ */
+export interface IMonsterAbilityContext {
+    readonly monsterType: string;
+    readonly distanceToEnemy: number;
+    readonly attackRange: number;
+    readonly meleeCooldownRemaining: number;
+    readonly hpRatio: number;
+    readonly moraleValue: number;
+}
+/**
+ * Strategy rule for monster ability activation.
+ * Evaluated in order — first rule whose `shouldTrigger` returns true wins.
+ */
+export interface IMonsterAbilityRule {
+    readonly abilityId: string;
+    shouldTrigger(ctx: IMonsterAbilityContext): boolean;
+}
+/**
+ * Default ability rules per monster type, extracted from the original switch logic.
+ * Each entry is evaluated in order; the first matching rule's abilityId is returned.
+ */
+export declare const DEFAULT_ABILITY_RULES: Readonly<Record<string, readonly IMonsterAbilityRule[]>>;
+/**
+ * Determine which ability a monster should use, if any.
+ *
+ * Only fires when melee cooldown has expired. Rules are evaluated in order
+ * per monster type — first matching rule wins.
+ *
+ * @param ctx - Monster ability context (type, distance, cooldowns, etc.)
+ * @param rules - Optional custom ability rules. Defaults to DEFAULT_ABILITY_RULES.
+ * @returns The ability ID to use, or null if none should trigger.
+ */
+export declare function selectMonsterAbility(ctx: IMonsterAbilityContext, rules?: Readonly<Record<string, readonly IMonsterAbilityRule[]>>): string | null;
+/**
+ * Configuration for monster flee behavior.
+ */
+export interface IMonsterFleeConfig {
+    /** HP ratio threshold below which flee is considered. Default 0.2. */
+    readonly hpThreshold: number;
+    /** Morale threshold below which flee is triggered. Default -0.3. */
+    readonly moraleThreshold: number;
+}
+export declare const DEFAULT_MONSTER_FLEE_CONFIG: IMonsterFleeConfig;
+/**
+ * Check if a monster should flee based on critical state.
+ * Common to all monster types.
+ */
+export declare function shouldMonsterFlee(hpRatio: number, moraleValue: number, config?: IMonsterFleeConfig): boolean;
+//# sourceMappingURL=MonsterAbilityData.d.ts.map

package/dist/combat/MonsterAbilityData.d.ts.map

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

package/dist/combat/MonsterAbilityData.js

@@ -0,0 +1,94 @@
+// combat/MonsterAbilityData.ts
+// Value objects for monster ability state tracking.
+// These are mutable phase-state objects consumed by the host's state machine.
+/**
+ * Monster ability type identifiers.
+ * Used to determine which ability phase data to create.
+ */
+export const MonsterAbility = {
+    CHARGE: 'charge',
+    STALK: 'stalk',
+    LEAP: 'leap',
+    PSI_ATTACK: 'psi_attack',
+};
+export function createLinearChargeData(startX, startY, targetX, targetY, windupMs) {
+    return {
+        phase: 'windup',
+        timer: windupMs,
+        startX,
+        startY,
+        targetX,
+        targetY,
+    };
+}
+export function createApproachData(targetX, targetY) {
+    return { phase: 'approach', targetX, targetY };
+}
+export function createLeapData(startX, startY, targetX, targetY, windupMs) {
+    return {
+        phase: 'windup',
+        timer: windupMs,
+        startX,
+        startY,
+        targetX,
+        targetY,
+    };
+}
+export function createChannelAbilityData(targetX, targetY, channelMs) {
+    return { phase: 'channel', timer: channelMs, targetX, targetY };
+}
+/**
+ * Default ability rules per monster type, extracted from the original switch logic.
+ * Each entry is evaluated in order; the first matching rule's abilityId is returned.
+ */
+export const DEFAULT_ABILITY_RULES = {
+    boar: [
+        { abilityId: 'charge', shouldTrigger: (ctx) => ctx.distanceToEnemy > ctx.attackRange },
+    ],
+    bloodsucker: [
+        { abilityId: 'stalk', shouldTrigger: (ctx) => ctx.distanceToEnemy > ctx.attackRange * 2 },
+    ],
+    snork: [
+        {
+            abilityId: 'leap',
+            shouldTrigger: (ctx) => ctx.distanceToEnemy > ctx.attackRange && ctx.distanceToEnemy <= ctx.attackRange * 3,
+        },
+    ],
+    controller: [
+        { abilityId: 'psi_attack', shouldTrigger: (ctx) => ctx.distanceToEnemy > ctx.attackRange },
+    ],
+};
+/**
+ * Determine which ability a monster should use, if any.
+ *
+ * Only fires when melee cooldown has expired. Rules are evaluated in order
+ * per monster type — first matching rule wins.
+ *
+ * @param ctx - Monster ability context (type, distance, cooldowns, etc.)
+ * @param rules - Optional custom ability rules. Defaults to DEFAULT_ABILITY_RULES.
+ * @returns The ability ID to use, or null if none should trigger.
+ */
+export function selectMonsterAbility(ctx, rules) {
+    if (ctx.meleeCooldownRemaining > 0)
+        return null;
+    const monsterRules = (rules ?? DEFAULT_ABILITY_RULES)[ctx.monsterType];
+    if (!monsterRules)
+        return null;
+    for (const rule of monsterRules) {
+        if (rule.shouldTrigger(ctx))
+            return rule.abilityId;
+    }
+    return null;
+}
+export const DEFAULT_MONSTER_FLEE_CONFIG = {
+    hpThreshold: 0.2,
+    moraleThreshold: -0.3,
+};
+/**
+ * Check if a monster should flee based on critical state.
+ * Common to all monster types.
+ */
+export function shouldMonsterFlee(hpRatio, moraleValue, config = DEFAULT_MONSTER_FLEE_CONFIG) {
+    return hpRatio < config.hpThreshold && moraleValue < config.moraleThreshold;
+}
+//# sourceMappingURL=MonsterAbilityData.js.map

package/dist/combat/MonsterAbilityData.js.map

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

package/dist/combat/WeaponSelector.d.ts

@@ -0,0 +1,47 @@
+import type { IWeaponSlot, INPCLoadout } from '../types/IWeaponTypes';
+import type { IWeaponSelectionConfig } from '../types/IOnlineAIConfig';
+/**
+ * Tactical context for weapon selection decisions.
+ * Groups NPC loadout and combat situation into a single parameter object.
+ */
+export interface IWeaponContext {
+    readonly loadout: INPCLoadout;
+    readonly distanceToEnemy: number;
+    readonly enemyCount: number;
+    readonly hpRatio: number;
+    readonly inCombat?: boolean;
+}
+/**
+ * Select the highest-scoring weapon from an NPC's loadout.
+ *
+ * Scoring formula: `distanceScore × enemyCountModifier × hpRatioModifier`.
+ * Primary weapon wins ties. Returns null if the NPC has no ammo at all
+ * (signal to flee/retreat).
+ *
+ * Single-pass, zero-allocation — no intermediate arrays.
+ *
+ * @param ctx - Weapon context (loadout, distance, enemy count, HP).
+ * @param config - Weapon selection configuration.
+ * @returns Best weapon slot, or null if no ammo.
+ */
+export declare function selectBestWeapon(ctx: IWeaponContext, config: IWeaponSelectionConfig): IWeaponSlot | null;
+/**
+ * Check whether a grenade throw is tactically advisable.
+ *
+ * All three conditions must be true:
+ * 1. NPC has grenades remaining.
+ * 2. At least `grenadeMinEnemies` visible.
+ * 3. Enemy within throw range [grenadeMinDistance, grenadeMaxDistance].
+ */
+export declare function shouldThrowGrenade(ctx: IWeaponContext, config: IWeaponSelectionConfig): boolean;
+/**
+ * Check whether the NPC should use a medkit now.
+ *
+ * Rules:
+ * - Has medkits remaining.
+ * - HP below `medkitHpThreshold`.
+ * - If HP below `medkitEmergencyThreshold`, use even mid-combat.
+ * - Otherwise, only use when not actively in combat.
+ */
+export declare function shouldUseMedkit(ctx: IWeaponContext, config: IWeaponSelectionConfig): boolean;
+//# sourceMappingURL=WeaponSelector.d.ts.map

package/dist/combat/WeaponSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeaponSelector.d.ts","sourceRoot":"","sources":["../../src/combat/WeaponSelector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,sBAAsB,GAC7B,WAAW,GAAG,IAAI,CAqBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAQT;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAMT"}

package/dist/combat/WeaponSelector.js

@@ -0,0 +1,180 @@
+// combat/WeaponSelector.ts
+// Pure-function weapon selection — multi-factor scoring.
+// No side effects, no framework dependencies.
+import { WeaponCategory } from '../types/IWeaponTypes';
+/**
+ * Distance-based effectiveness score for a weapon category.
+ * Returns a value in [0, 1] where 1 = optimal engagement range.
+ */
+function distanceScore(category, distance, config) {
+    switch (category) {
+        case WeaponCategory.PISTOL:
+            return 0.4;
+        case WeaponCategory.SHOTGUN: {
+            if (config.shotgunEffectiveMax <= 0)
+                return 0;
+            if (distance <= config.shotgunEffectiveMax * 0.66)
+                return 1.0;
+            if (distance > config.shotgunEffectiveMax * 1.33)
+                return 0.0;
+            const overshoot = (distance - config.shotgunEffectiveMax * 0.66) /
+                (config.shotgunEffectiveMax * 0.66);
+            return Math.max(0, 1.0 - overshoot);
+        }
+        case WeaponCategory.RIFLE: {
+            if (config.rifleEffectiveMin <= 0)
+                return 0.6;
+            if (distance >= config.rifleEffectiveMin && distance <= config.rifleEffectiveMax)
+                return 1.0;
+            if (distance < config.rifleEffectiveMin)
+                return 0.6 + 0.4 * (distance / config.rifleEffectiveMin);
+            const falloff = (distance - config.rifleEffectiveMax) / 200;
+            return Math.max(0.2, 1.0 - falloff);
+        }
+        case WeaponCategory.SNIPER: {
+            if (config.sniperEffectiveMin <= 0)
+                return 0.1;
+            if (distance >= config.sniperEffectiveMin)
+                return 1.0;
+            return 0.1 + 0.9 * (distance / config.sniperEffectiveMin);
+        }
+        default:
+            return 0;
+    }
+}
+/**
+ * Modifier based on number of visible enemies.
+ * Only activates at 3+ enemies.
+ * If `config.scoringFactors` contains an entry for the category, uses its `multiEnemyModifier`.
+ */
+function enemyCountModifier(category, count, config) {
+    if (count <= 2)
+        return 1.0;
+    const factors = config.scoringFactors?.[String(category)];
+    if (factors)
+        return factors.multiEnemyModifier;
+    switch (category) {
+        case WeaponCategory.SHOTGUN:
+            return 1.5;
+        case WeaponCategory.RIFLE:
+            return 1.3;
+        case WeaponCategory.SNIPER:
+            return 0.6;
+        default:
+            return 1.0;
+    }
+}
+/**
+ * Modifier based on NPC's current HP ratio.
+ * Low HP favors ranged weapons; high HP allows aggression.
+ * If `config.scoringFactors` contains an entry for the category, uses its `lowHpModifier` / `highHpModifier`.
+ */
+function hpRatioModifier(category, hp, config) {
+    const factors = config.scoringFactors?.[String(category)];
+    if (hp < 0.3) {
+        if (factors)
+            return factors.lowHpModifier;
+        switch (category) {
+            case WeaponCategory.SNIPER:
+                return 1.3;
+            case WeaponCategory.RIFLE:
+                return 1.2;
+            case WeaponCategory.PISTOL:
+                return 0.9;
+            case WeaponCategory.SHOTGUN:
+                return 0.7;
+            default:
+                return 1.0;
+        }
+    }
+    if (hp > 0.7) {
+        if (factors)
+            return factors.highHpModifier;
+        switch (category) {
+            case WeaponCategory.SHOTGUN:
+                return 1.2;
+            case WeaponCategory.PISTOL:
+                return 1.1;
+            case WeaponCategory.SNIPER:
+                return 0.9;
+            default:
+                return 1.0;
+        }
+    }
+    return 1.0;
+}
+/**
+ * Compute the composite weapon score (distance × enemyCount × hpRatio modifiers).
+ */
+function weaponScore(category, distanceToEnemy, enemyCount, hpRatio, config) {
+    return (distanceScore(category, distanceToEnemy, config) *
+        enemyCountModifier(category, enemyCount, config) *
+        hpRatioModifier(category, hpRatio, config));
+}
+/**
+ * Select the highest-scoring weapon from an NPC's loadout.
+ *
+ * Scoring formula: `distanceScore × enemyCountModifier × hpRatioModifier`.
+ * Primary weapon wins ties. Returns null if the NPC has no ammo at all
+ * (signal to flee/retreat).
+ *
+ * Single-pass, zero-allocation — no intermediate arrays.
+ *
+ * @param ctx - Weapon context (loadout, distance, enemy count, HP).
+ * @param config - Weapon selection configuration.
+ * @returns Best weapon slot, or null if no ammo.
+ */
+export function selectBestWeapon(ctx, config) {
+    const { loadout, distanceToEnemy, enemyCount, hpRatio } = ctx;
+    let bestSlot = null;
+    let bestScore = -Infinity;
+    // Score primary (wins ties via evaluation order — scored first).
+    if (loadout.primary && loadout.primary.ammo > 0) {
+        bestScore = weaponScore(loadout.primary.category, distanceToEnemy, enemyCount, hpRatio, config);
+        bestSlot = loadout.primary;
+    }
+    // Score secondary — must strictly beat primary to win.
+    if (loadout.secondary && loadout.secondary.ammo > 0) {
+        const secScore = weaponScore(loadout.secondary.category, distanceToEnemy, enemyCount, hpRatio, config);
+        if (secScore > bestScore) {
+            bestScore = secScore;
+            bestSlot = loadout.secondary;
+        }
+    }
+    return bestSlot;
+}
+/**
+ * Check whether a grenade throw is tactically advisable.
+ *
+ * All three conditions must be true:
+ * 1. NPC has grenades remaining.
+ * 2. At least `grenadeMinEnemies` visible.
+ * 3. Enemy within throw range [grenadeMinDistance, grenadeMaxDistance].
+ */
+export function shouldThrowGrenade(ctx, config) {
+    const { loadout, enemyCount, distanceToEnemy } = ctx;
+    return (loadout.grenades > 0 &&
+        enemyCount >= config.grenadeMinEnemies &&
+        distanceToEnemy >= config.grenadeMinDistance &&
+        distanceToEnemy <= config.grenadeMaxDistance);
+}
+/**
+ * Check whether the NPC should use a medkit now.
+ *
+ * Rules:
+ * - Has medkits remaining.
+ * - HP below `medkitHpThreshold`.
+ * - If HP below `medkitEmergencyThreshold`, use even mid-combat.
+ * - Otherwise, only use when not actively in combat.
+ */
+export function shouldUseMedkit(ctx, config) {
+    const { loadout, hpRatio, inCombat } = ctx;
+    if (loadout.medkits <= 0)
+        return false;
+    if (hpRatio >= config.medkitHpThreshold)
+        return false;
+    if (hpRatio < config.medkitEmergencyThreshold)
+        return true;
+    return !inCombat;
+}
+//# sourceMappingURL=WeaponSelector.js.map

package/dist/combat/WeaponSelector.js.map

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