@its-not-rocket-science/ananke 0.1.0

package/dist/src/equipment.d.ts

@@ -0,0 +1,206 @@
+import type { I32, Q } from "./units.js";
+import type { Material } from "./crafting/materials.js";
+import type { ChannelMask } from "./channels.js";
+import { DamageChannel } from "./channels.js";
+import type { IndividualAttributes } from "./types.js";
+import type { BodyRegion } from "./sim/body.js";
+import type { TechCapability, TechContext } from "./sim/tech.js";
+import { HitArea } from "./sim/kinds.js";
+export type ItemId = string;
+export interface ItemBase {
+    id: ItemId;
+    name: string;
+    mass_kg: I32;
+    bulk: Q;
+    /** Phase 11: capabilities that must be in TechContext.available for this item to be usable. */
+    requiredCapabilities?: readonly TechCapability[];
+}
+export interface WeaponDamageProfile {
+    surfaceFrac: Q;
+    internalFrac: Q;
+    structuralFrac: Q;
+    bleedFactor: Q;
+    penetrationBias: Q;
+}
+export type Handedness = "oneHand" | "twoHand" | "mounted" | "natural";
+export interface Weapon extends ItemBase {
+    kind: "weapon";
+    reach_m?: I32 | undefined;
+    handlingMul?: Q;
+    readyTime_s?: I32;
+    strikeEffectiveMassFrac?: Q;
+    strikeSpeedMul?: Q;
+    damage: WeaponDamageProfile;
+    handedness?: Handedness;
+    /** Lever advantage (m). Used for parry/block effectiveness and control. */
+    momentArm_m?: number;
+    /** how tiring it is to wield (dimensionless Q multiplier). */
+    handlingLoadMul?: Q;
+    /** Phase 11C: energy weapon type — routes damage through DamageChannel.Energy; resisted by reflectivity. */
+    energyType?: "plasma" | "laser" | "sonic";
+    /** Phase 17: flexible/chain weapons (flail, morning star) that loop around shields.
+     *  q(0) = no bypass; q(0.50) = 50% reduction in effective shield coverageQ. */
+    shieldBypassQ?: Q;
+    /** Phase 25: cumulative use-wear (0 = new, q(1.0) = broken). Updated by applyWear(). */
+    wear_Q?: Q;
+}
+export interface Shield extends ItemBase {
+    kind: "shield";
+    coverageQ: Q;
+    blockResist_J: number;
+    deflectQ: Q;
+    arcDeg: number;
+    regions: BodyRegion[];
+    manipulationMul: Q;
+    mobilityMul: Q;
+    fatigueMul: Q;
+    covers?: HitArea[];
+    coverageProfileId?: string;
+}
+export type CoverageByRegion = Partial<Record<BodyRegion, Q>>;
+export interface Armour extends ItemBase {
+    kind: "armour";
+    protects: ChannelMask;
+    coverageByRegion: CoverageByRegion;
+    resist_J: I32;
+    protectedDamageMul: Q;
+    channelResistMul?: Partial<Record<DamageChannel, Q>>;
+    mobilityMul?: Q;
+    fatigueMul?: Q;
+    /** Phase 11C: fraction of energy-weapon damage reflected (0..1); q(0.40) = deflects 40%. */
+    reflectivity?: Q;
+    /** Phase 11C: ablative plating — resist_J degrades each time the armour absorbs a hit. */
+    ablative?: boolean;
+    /** Phase 29: thermal insulation value (m²K/W).
+     *  0 = none; 0.02 = plate metal; 0.15 = heavy wool; 0.25 = heavy fur.
+     *  Added to the 0.09 baseline in the heat-balance equation. */
+    insulation_m2KW?: number;
+}
+export interface Gear extends ItemBase {
+    kind: "gear";
+}
+/** Phase 11: powered exoskeleton — boosts speed and strike force at a continuous energy cost. */
+export interface Exoskeleton extends ItemBase {
+    kind: "exoskeleton";
+    /** Multiplier on effective sprint speed (e.g. q(1.25) = +25%). */
+    speedMultiplier: Q;
+    /** Multiplier on melee strike energy delivered (e.g. q(1.40) = +40%). */
+    forceMultiplier: Q;
+    /** Continuous power draw added to metabolic demand (watts). */
+    powerDrain_W: number;
+}
+/** Phase 3 extension: ammo type — overrides projectile properties per shot. */
+export interface AmmoType {
+    id: string;
+    name: string;
+    /** Override projectile mass (SCALE.kg). Omit to use weapon default. */
+    projectileMass_kg?: number;
+    /** Override drag coefficient per metre. Omit to use weapon default. */
+    dragCoeff_perM?: Q;
+    /** Override damage channel distribution. Omit to use weapon default. */
+    damage?: WeaponDamageProfile;
+    /** Multiplier on weapon's launchEnergy_J (Q). Default q(1.0). */
+    launchEnergyMul?: Q;
+}
+export interface RangedWeapon extends ItemBase {
+    kind: "ranged";
+    category: "thrown" | "bow" | "firearm";
+    launchEnergy_J: I32;
+    projectileMass_kg: I32;
+    dragCoeff_perM: Q;
+    dispersionQ: Q;
+    recycleTime_s: I32;
+    /** Phase 17: rounds per magazine; undefined = muzzle-loader (no tracking). */
+    magCapacity?: number;
+    /** Phase 17: SCALE.s — cooldown between shots within magazine; recycleTime_s used only when mag empties. */
+    shotInterval_s?: I32;
+    damage: WeaponDamageProfile;
+    /** Phase 11C: energy weapon type — routes damage through DamageChannel.Energy; resisted by reflectivity. */
+    energyType?: "plasma" | "laser" | "sonic";
+    /** Phase 3 extension: available ammo types for this weapon. */
+    ammo?: AmmoType[];
+    /** Phase 5 extension: scales per-tick suppression fear (default q(1.0)). */
+    suppressionFearMul?: Q;
+    shieldBypassQ?: Q;
+}
+/** Phase 11C: electronic sensor suite — boosts vision and hearing range while worn. */
+export interface Sensor extends ItemBase {
+    kind: "sensor";
+    /** Multiplier on effective vision range (e.g. q(2.0) = double range). */
+    visionRangeMul: Q;
+    /** Multiplier on effective hearing range (e.g. q(1.5) = +50%). */
+    hearingRangeMul: Q;
+}
+export type Item = Weapon | Armour | Gear | Shield | RangedWeapon | Exoskeleton | Sensor | Material;
+export interface Loadout {
+    items: Item[];
+}
+export interface EncumbranceTotals {
+    carriedMass_kg: I32;
+    carriedBulk: Q;
+    wornMass_kg: I32;
+    wornBulk: Q;
+    carriedMassFracOfBody: Q;
+}
+export interface EncumbrancePenalties {
+    speedMul: Q;
+    accelMul: Q;
+    jumpMul: Q;
+    energyDemandMul: Q;
+    controlMul: Q;
+    stabilityMul: Q;
+    encumbranceRatio: Q;
+    overloaded: boolean;
+}
+export interface CarryRules {
+    capacityFactor: Q;
+    bulkToMassFactor: Q;
+}
+export declare const DEFAULT_CARRY_RULES: CarryRules;
+export declare function computeLoadoutTotals(loadout: Loadout, armourIsWorn?: boolean): EncumbranceTotals;
+export declare function deriveCarryCapacityMass_kg(a: IndividualAttributes, rules?: CarryRules): I32;
+export declare function computeEncumbrance(a: IndividualAttributes, loadout: Loadout, rules?: CarryRules): {
+    totals: EncumbranceTotals;
+    penalties: EncumbrancePenalties;
+};
+export interface ProtectionProfile {
+    protects: ChannelMask;
+    coverageByRegion: Record<BodyRegion, Q>;
+    coverageOverall: Q;
+    resist_J: I32;
+    protectedDamageMul: Q;
+    mobilityMul: Q;
+    fatigueMul: Q;
+    channelResistMul: Partial<Record<DamageChannel, Q>>;
+    /** Phase 11C: max reflectivity across all armour items (for energy-weapon mitigation). */
+    reflectivity: Q;
+}
+export declare function deriveArmourProfile(loadout: Loadout, armourState?: Map<string, {
+    resistRemaining_J: number;
+}>): ProtectionProfile;
+export declare function findWeapon(loadout: Loadout, weaponId?: string): Weapon | null;
+export declare function findRangedWeapon(loadout: Loadout, weaponId?: string): RangedWeapon | null;
+export declare function findShield(loadout: Loadout): Shield | undefined;
+export declare function findExoskeleton(loadout: Loadout): Exoskeleton | null;
+/** Phase 11C: return the first Sensor in the loadout, or null. */
+export declare function findSensor(loadout: Loadout): Sensor | null;
+/**
+ * Phase 11: check that every item in a loadout is usable in the given TechContext.
+ * Returns an array of error messages; empty array means the loadout is valid.
+ */
+export declare function validateLoadout(loadout: Loadout, ctx: TechContext): string[];
+export declare function deriveWeaponHandling(w: Weapon, ownerStature_m: number): {
+    handedness: Handedness;
+    momentArm_m: number;
+    handlingLoadMul: Q;
+};
+export declare const STARTER_WEAPONS: Weapon[];
+export declare const STARTER_EXOSKELETONS: Exoskeleton[];
+export declare const STARTER_ARMOUR: Armour[];
+export declare const STARTER_SHIELDS: Shield[];
+export declare const STARTER_RANGED_WEAPONS: RangedWeapon[];
+/** Reflective/ablative armour items for energy and kinetic threats. */
+export declare const STARTER_ARMOUR_11C: Armour[];
+/** Phase 11C: sensor suites that boost vision and hearing range. */
+export declare const STARTER_SENSORS: Sensor[];
+export declare const STARTER_AMMO: AmmoType[];