@elite-dangerous-almanac/core 0.2.8 → 0.2.10

package/dist/equipment/modifications.d.ts

@@ -15,7 +15,13 @@ import { PersonalModifier } from './engineering.js';
  * @packageDocumentation
  */
 
-/** Equipment kind a personal modification can be installed on. */
+/**
+ * Equipment kind a personal modification can be installed on.
+ *
+ * @remarks
+ * A suit tool is not one of them. The one recipe that changes a tool, Reduced Tool
+ * Battery Consumption, is installed on the suit and carries `"suit"`.
+ */
 type PersonalModificationTarget = 'suit' | 'weapon';
 /** One permanent personal-equipment engineering recipe. */
 interface PersonalModification {
@@ -31,29 +37,32 @@ interface PersonalModification {
      * `equipment/engineering`.
      *
      * A modifier names a stat of whatever it modifies, which is usually the equipment
-     * the recipe is installed on. Extra Ammo Capacity is the exception a consumer has
-     * to know about: it is a suit modification and it multiplies a *weapon's*
-     * `reserveAmmo`.
+     * the recipe is installed on. Two suit modifications move something else, and a
+     * consumer has to know about both: Extra Ammo Capacity multiplies a *weapon's*
+     * `reserveAmmo`, and Reduced Tool Battery Consumption halves a *tool's*
+     * `powerUsage` and the Energylink's `overloadPowerUsage` under the name
+     * `toolEnergyDrain`.
      *
      * @remarks
      * **Empty** where the recipe changes nothing this catalogue names. Night Vision,
-     * Scope, Stowed reloading and Combat Movement Speed have no numeric magnitude at
-     * all — Scope swaps the sight, and each weapon's two magnifications are on its own
-     * `scopeMagnification`. Faster Handling, Improved Hip Fire
-     * Accuracy, Stability and Improved Jump Assist do change stats, ones the personal
-     * stats panel does not put a number on; see
+     * Scope, Reload Speed, Stowed reloading and Combat Movement Speed have no numeric
+     * magnitude at all — Scope swaps the sight, and each weapon's two magnifications
+     * are on its own `scopeMagnification`; Reload Speed shortens the reload, and each
+     * weapon's two reload times are on its own `reloadTime`. Faster Handling, Improved
+     * Hip Fire Accuracy, Stability and Improved Jump Assist do change stats, ones the
+     * personal stats panel does not put a number on; see
      * [`data/equipment/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/equipment/SOURCES.md).
      */
     readonly modifiers: readonly PersonalModifier[];
 }
 /**
- * All 31 suit and weapon engineering recipes, keyed by recipe symbol.
+ * Every suit and weapon engineering recipe, keyed by recipe symbol.
  *
  * @remarks
- * There are 25 distinct display names. Greater Range, Headshot Damage and Improved
- * Hip Fire Accuracy each have separate Kinetic, Laser and Plasma recipes because their
- * material costs differ. Their keys end in `_kinetic`, `_laser` or `_plasma`; the
- * journal omits that suffix, so resolve its value with
+ * A recipe symbol is finer-grained than a display name: Greater Range, Headshot Damage
+ * and Improved Hip Fire Accuracy each have separate Kinetic, Laser and Plasma recipes
+ * because their material costs differ. Their keys end in `_kinetic`, `_laser` or
+ * `_plasma`; the journal omits that suffix, so resolve its value with
  * `resolvePersonalModificationForWeapon` from `equipment/modification-journal`.
  *
  * @example

package/dist/equipment/modifications.js

@@ -1 +1 @@
-export{PERSONAL_MODIFICATIONS,getPersonalModification}from"../chunk-GIGRBFIJ.js";                                                                                       //# sourceMappingURL=modifications.js.map
+export{PERSONAL_MODIFICATIONS,getPersonalModification}from"../chunk-YI5XKWW2.js";                                                                                       //# sourceMappingURL=modifications.js.map

package/dist/equipment/suits.d.ts

@@ -1,145 +1,2 @@
-/**
- * Odyssey personal suits: their journal identifiers, the suit-wide component stats every
- * grade shares, and the grade-dependent defensive stats.
- *
- * @packageDocumentation
- */
-/** A Pioneer Supplies equipment grade, from the stock grade 1 through grade 5. */
-type EquipmentGrade = 1 | 2 | 3 | 4 | 5;
-/** The stats of one suit at one equipment grade. */
-interface SuitGrade {
-    /** Frontier item symbol for this exact suit and grade. */
-    readonly symbol: string;
-    /** Permanent engineering-modification slots available, from `0` through `4`. */
-    readonly modificationSlots: number;
-    /** Base shield strength in shield points. */
-    readonly shieldStrength: number;
-    /** Shield points regenerated per second. */
-    readonly shieldRegeneration: number;
-    /** Kinetic damage resistance as a fraction; negative values increase damage. */
-    readonly kineticResistance: number;
-    /** Thermal damage resistance as a fraction. */
-    readonly thermalResistance: number;
-    /** Plasma damage resistance as a fraction; negative values increase damage. */
-    readonly plasmaResistance: number;
-    /** Explosive damage resistance as a fraction. */
-    readonly explosiveResistance: number;
-}
-/** One personal suit model sold by Pioneer Supplies. */
-interface Suit {
-    /** Suit family without a grade suffix, e.g. `"utilitysuit"`. */
-    readonly family: string;
-    /** English display name, e.g. `"Maverick Suit"`. */
-    readonly name: string;
-    /** Number of primary-weapon slots. */
-    readonly primarySlots: number;
-    /** Number of secondary-weapon slots. */
-    readonly secondarySlots: number;
-    /** Suit health in health points, the pool the shield protects. */
-    readonly health: number;
-    /** Suit mass in kilograms. */
-    readonly mass: number;
-    /** Battery capacity in energy units, the pool the suit's tools draw from. */
-    readonly batteryCapacity: number;
-    /** Emergency air, in seconds of life support. */
-    readonly oxygenTime: number;
-    /** Jump-assist boost acceleration, the bare figure the panel shows, which has no unit. */
-    readonly boostAcceleration: number;
-    /** Backpack goods capacity in items. */
-    readonly goodsCapacity: number;
-    /** Backpack assets capacity in components. */
-    readonly assetsCapacity: number;
-    /** Backpack data capacity in items. */
-    readonly dataCapacity: number;
-    /** How far footsteps carry, as a multiplier of the base audible range. */
-    readonly footstepAudibleRange: number;
-    /** Line-of-sight analysis range in metres. */
-    readonly losAnalysisRange: number;
-    /** Seconds of line of sight the suit needs to complete an analysis. */
-    readonly losAnalysisTime: number;
-    /**
-     * Available grade records, keyed by `"1"` through `"5"`.
-     *
-     * @remarks
-     * A grade changes exactly what {@link SuitGrade} carries — the four resistances,
-     * shield strength, shield regeneration, the modification slots and the item symbol.
-     * Every stat above is a property of the suit family and is the same at all five.
-     */
-    readonly grades: Readonly<Partial<Record<`${EquipmentGrade}`, SuitGrade>>>;
-}
-/**
- * All four personal suits, including the non-upgradeable Flight Suit.
- *
- * @example
- * ```ts
- * import { SUITS } from '@elite-dangerous-almanac/core/equipment/suits';
- * SUITS.length; // -> 4
- * ```
- */
-declare const SUITS: readonly Suit[];
-/**
- * Look up a suit model by its grade-independent family, case-insensitively.
- *
- * @param family - Family such as `"utilitysuit"`, matched case-insensitively after
- * trimming surrounding whitespace.
- * @returns The frozen suit record, or `null` when unknown.
- * @throws {TypeError} If `family` is present and not a string. A nullish family is a
- * miss, answered like an unrecognised one.
- * @example
- * ```ts
- * import { getSuitByFamily } from '@elite-dangerous-almanac/core/equipment/suits';
- * getSuitByFamily('utilitysuit')?.name; // -> 'Maverick Suit'
- * ```
- */
-declare function getSuitByFamily(family: string): Suit | null;
-/**
- * Look up a suit by its display name, case-insensitively.
- *
- * @param name - Display name such as `"Maverick Suit"`, matched case-insensitively
- * after trimming surrounding whitespace.
- * @returns The frozen suit record, or `null` when unknown.
- * @throws {TypeError} If `name` is present and not a string. A nullish name is a miss,
- * answered like an unrecognised one.
- * @example
- * ```ts
- * import { getSuitByName } from '@elite-dangerous-almanac/core/equipment/suits';
- * getSuitByName('Maverick Suit')?.family; // -> 'utilitysuit'
- * ```
- */
-declare function getSuitByName(name: string): Suit | null;
-/**
- * Resolve the grade-specific Frontier item symbol reported by journal suit events.
- *
- * @param symbol - Item symbol such as `"utilitysuit_class3"`, matched
- * case-insensitively after trimming surrounding whitespace.
- * @returns The owning suit and its numeric grade, or `null` when unknown.
- * @throws {TypeError} If `symbol` is present and not a string. A nullish symbol is a
- * miss, answered like an unrecognised one.
- * @example
- * ```ts
- * import { getSuitBySymbol } from '@elite-dangerous-almanac/core/equipment/suits';
- * getSuitBySymbol('utilitysuit_class3')?.grade; // -> 3
- * ```
- */
-declare function getSuitBySymbol(symbol: string): Readonly<{
-    suit: Suit;
-    grade: EquipmentGrade;
-}> | null;
-/**
- * Read a suit's stats at one grade.
- *
- * @param suit - A catalogue suit record.
- * @param grade - Integer grade `1`–`5`.
- * @returns The frozen grade record, or `null` when that suit has no such grade.
- * @throws {RangeError} If `grade` is not an integer from 1 through 5.
- * @example
- * ```ts
- * import { getSuitByFamily, getSuitGrade } from '@elite-dangerous-almanac/core/equipment/suits';
- * const suit = getSuitByFamily('utilitysuit');
- * if (!suit) throw new Error('Maverick Suit is missing');
- * getSuitGrade(suit, 5)?.modificationSlots; // -> 4
- * ```
- */
-declare function getSuitGrade(suit: Suit, grade: number): SuitGrade | null;
-
-export { type EquipmentGrade, SUITS, type Suit, type SuitGrade, getSuitByFamily, getSuitByName, getSuitBySymbol, getSuitGrade };
+export { E as EquipmentGrade, c as PersonalMount, d as PersonalMountKey, S as SUITS, l as Suit, m as SuitGrade, q as getSuitByFamily, r as getSuitByName, s as getSuitBySymbol, t as getSuitGrade } from '../suits-B4sQMLFe.js';
+import './engineering.js';

package/dist/equipment/suits.js

@@ -1 +1 @@
-export{SUITS,getSuitByFamily,getSuitByName,getSuitBySymbol,getSuitGrade}from"../chunk-LWNBWRKL.js";                                                                                                                    //# sourceMappingURL=suits.js.map
+export{SUITS,getSuitByFamily,getSuitByName,getSuitBySymbol,getSuitGrade}from"../chunk-C6G7IN74.js";                                                                                                                    //# sourceMappingURL=suits.js.map

package/dist/equipment/tools.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Odyssey suit tools: the Energylink, Profile Analyser, Arc Cutter and Genetic Sampler,
+ * the suits that carry each one, and their battery and timing stats.
+ *
+ * @packageDocumentation
+ */
+/**
+ * One tool a Commander carries on foot.
+ *
+ * @remarks
+ * A stat a tool does not have is absent rather than zero: only the Energylink
+ * discharges and overloads, and only the Profile Analyser scans and clones.
+ *
+ * Every power figure is in the same unit as {@link Suit.batteryCapacity}, so a suit's
+ * battery divided by a tool's per-second drain is the seconds of use it holds.
+ */
+interface PersonalTool {
+    /**
+     * This library's own id, e.g. `"arc-cutter"`.
+     *
+     * @remarks
+     * Frontier publishes no item symbol for a tool: a journal `SuitLoadout` names the
+     * suit and its weapon mounts only. The id is therefore a library key, and joins to
+     * no journal field.
+     */
+    readonly id: string;
+    /**
+     * English display name, e.g. `"Arc Cutter"`.
+     *
+     * @remarks
+     * This is the canonical English. `getPersonalToolName` in `i18n/personal-tools`
+     * takes the same `id` and answers in all six stored locales.
+     */
+    readonly name: string;
+    /** Families of the suits that carry the tool, as {@link Suit.family} spells them. */
+    readonly suitFamilies: readonly string[];
+    /** Energylink: battery charge delivered to a target, in MW per second. */
+    readonly rechargeRate?: number;
+    /** Energylink: battery charge drawn from a target, in MW per second. */
+    readonly dischargeRate?: number;
+    /** Energylink: seconds one discharge lasts. */
+    readonly dischargeDuration?: number;
+    /**
+     * Energylink: battery charge one overload costs, in MW. The Reduced Tool Battery
+     * Consumption factor, named `toolEnergyDrain`, applies to this.
+     */
+    readonly overloadPowerUsage?: number;
+    /**
+     * Battery charge the tool draws while it works, in MW per second. The Reduced Tool
+     * Battery Consumption factor, named `toolEnergyDrain`, applies to this.
+     */
+    readonly powerUsage?: number;
+    /** Profile Analyser: seconds one profile scan takes. */
+    readonly scanDuration?: number;
+    /** Profile Analyser: seconds one profile clone takes. */
+    readonly cloneDuration?: number;
+}
+/**
+ * Every suit tool, in catalogue order.
+ *
+ * @remarks
+ * The Reduced Tool Battery Consumption suit modification halves the `toolEnergyDrain`
+ * stat, which is this catalogue's `powerUsage` and the Energylink's
+ * `overloadPowerUsage`. It leaves `dischargeRate` alone, which is why the two carry
+ * separate names: pass the base a factor applies to, and the discharge rate can never
+ * pick one up.
+ *
+ * @example
+ * ```ts
+ * import { PERSONAL_TOOLS } from '@elite-dangerous-almanac/core/equipment/tools';
+ * PERSONAL_TOOLS[0]?.name; // -> 'Energylink'
+ * ```
+ * @example
+ * ```ts
+ * import { applyPersonalModifiers } from '@elite-dangerous-almanac/core/equipment/engineering';
+ * import { getPersonalModification } from '@elite-dangerous-almanac/core/equipment/modifications';
+ * import { getPersonalToolById } from '@elite-dangerous-almanac/core/equipment/tools';
+ *
+ * const recipe = getPersonalModification('suit_reducedtoolbatteryconsumption');
+ * const cutter = getPersonalToolById('arc-cutter');
+ * applyPersonalModifiers('toolEnergyDrain', cutter?.powerUsage ?? 0, recipe?.modifiers ?? []);
+ * // -> 0.075
+ * ```
+ */
+declare const PERSONAL_TOOLS: readonly PersonalTool[];
+/**
+ * Look up a suit tool by its library id, case-insensitively.
+ *
+ * @param id - Library id such as `"energylink"`, matched case-insensitively after
+ * trimming surrounding whitespace.
+ * @returns The frozen tool record, or `null` when unknown.
+ * @throws {TypeError} If `id` is present and not a string. A nullish id is a miss,
+ * answered like an unrecognised one.
+ * @example
+ * ```ts
+ * import { getPersonalToolById } from '@elite-dangerous-almanac/core/equipment/tools';
+ * getPersonalToolById('arc-cutter')?.suitFamilies; // -> ['utilitysuit']
+ * ```
+ */
+declare function getPersonalToolById(id: string): PersonalTool | null;
+
+export { PERSONAL_TOOLS, type PersonalTool, getPersonalToolById };

package/dist/equipment/tools.js

@@ -0,0 +1 @@
+export{PERSONAL_TOOLS,getPersonalToolById}from"../chunk-CEF7SMB2.js";                                                                                       //# sourceMappingURL=tools.js.map

package/dist/equipment/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"O"}

package/dist/equipment/upgrade-costs.d.ts

@@ -1,6 +1,5 @@
-import { WeaponUpgradeGroup } from './weapons.js';
+import { W as WeaponUpgradeGroup } from '../suits-B4sQMLFe.js';
 import { PersonalEngineeringIngredient } from './engineering.js';
-import './suits.js';
 
 /**
  * Material costs for Pioneer Supplies suit and handheld-weapon grade upgrades.
@@ -40,7 +39,7 @@ type PersonalUpgradeGradeCosts = Readonly<Record<'2' | '3' | '4' | '5', readonly
  * } from '@elite-dangerous-almanac/core/equipment/upgrade-costs';
  *
  * const costs: PersonalUpgradeCosts = PERSONAL_UPGRADE_COSTS;
- * Object.keys(costs.suits).length; // -> 3
+ * costs.suits['utilitysuit']?.['2']?.[0]?.symbol; // -> 'suitschematic'
  * ```
  */
 interface PersonalUpgradeCosts {

package/dist/equipment/upgrade-costs.js

@@ -1 +1 @@
-import{getSuitByFamily}from"../chunk-LWNBWRKL.js";import{getPersonalWeaponBySymbol}from"../chunk-IUSMAX5T.js";                             import{sumPersonalEngineeringIngredients}from"../chunk-WV7QCDL5.js";                                                          import{deepFreeze}from"../chunk-DURKO7JU.js";var upgrade_costs_default={suits:{utilitysuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"carbonfibreplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"carbonfibreplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"carbonfibreplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"carbonfibreplating",count:12},{symbol:"graphene",count:12}]},tacticalsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"titaniumplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"titaniumplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"titaniumplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"titaniumplating",count:12},{symbol:"graphene",count:12}]},explorationsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"aerogel",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"aerogel",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"aerogel",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"aerogel",count:12},{symbol:"graphene",count:12}]}},weaponGroups:{takada:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"opticalfibre",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"opticalfibre",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"opticalfibre",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"opticalfibre",count:12}]},manticore:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"chemicalsuperbase",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"chemicalsuperbase",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"chemicalsuperbase",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"chemicalsuperbase",count:12}]},karma:{2:[{symbol:"weaponschematic",count:1},{symbol:"compressionliquefiedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"weaponcomponent",count:2},{symbol:"tungstencarbide",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"compressionliquefiedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"weaponcomponent",count:5},{symbol:"tungstencarbide",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"compressionliquefiedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"weaponcomponent",count:9},{symbol:"tungstencarbide",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"compressionliquefiedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"weaponcomponent",count:12},{symbol:"tungstencarbide",count:12}]}}};var PERSONAL_UPGRADE_COSTS=deepFreeze(upgrade_costs_default);function getSuitUpgradeStepCost(family,targetGrade){assertTargetGrade(targetGrade,"getSuitUpgradeStepCost");const costs=getSuitUpgradeCosts(family);return costs?.[String(targetGrade)]??null}function getSuitUpgradeCost(family,targetGrade,currentGrade=1){assertGrade(targetGrade,"getSuitUpgradeCost: targetGrade");assertGrade(currentGrade,"getSuitUpgradeCost: currentGrade");const costs=getSuitUpgradeCosts(family);if(!costs)return null;return totalCosts(costs,targetGrade,currentGrade)}function getPersonalWeaponUpgradeStepCost(symbol,targetGrade){assertTargetGrade(targetGrade,"getPersonalWeaponUpgradeStepCost");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup][String(targetGrade)]??null}function getPersonalWeaponUpgradeCost(symbol,targetGrade,currentGrade=1){assertGrade(targetGrade,"getPersonalWeaponUpgradeCost: targetGrade");assertGrade(currentGrade,"getPersonalWeaponUpgradeCost: currentGrade");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return totalCosts(PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup],targetGrade,currentGrade)}function totalCosts(costs,targetGrade,currentGrade){const steps=[];for(let grade=currentGrade+1;grade<=targetGrade;grade++){steps.push(costs[String(grade)])}return sumPersonalEngineeringIngredients(...steps)}function getSuitUpgradeCosts(family){const suit=getSuitByFamily(family);if(!suit||!Object.hasOwn(PERSONAL_UPGRADE_COSTS.suits,suit.family))return null;return PERSONAL_UPGRADE_COSTS.suits[suit.family]}function assertTargetGrade(grade,functionName){if(!Number.isInteger(grade)||grade<2||grade>5){throw new RangeError(`${functionName}: targetGrade must be an integer in [2, 5]`)}}function assertGrade(grade,label){if(!Number.isInteger(grade)||grade<1||grade>5){throw new RangeError(`${label} must be an integer in [1, 5]`)}}export{PERSONAL_UPGRADE_COSTS,getPersonalWeaponUpgradeCost,getPersonalWeaponUpgradeStepCost,getSuitUpgradeCost,getSuitUpgradeStepCost};//# sourceMappingURL=upgrade-costs.js.map
+import{getSuitByFamily}from"../chunk-C6G7IN74.js";import{getPersonalWeaponBySymbol}from"../chunk-PIU24HRN.js";                             import{sumPersonalEngineeringIngredients}from"../chunk-SIL356HB.js";                                                          import{deepFreeze}from"../chunk-DURKO7JU.js";var upgrade_costs_default={suits:{utilitysuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"carbonfibreplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"carbonfibreplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"carbonfibreplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"carbonfibreplating",count:12},{symbol:"graphene",count:12}]},tacticalsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"titaniumplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"titaniumplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"titaniumplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"titaniumplating",count:12},{symbol:"graphene",count:12}]},explorationsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"aerogel",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"aerogel",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"aerogel",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"aerogel",count:12},{symbol:"graphene",count:12}]}},weaponGroups:{takada:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"opticalfibre",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"opticalfibre",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"opticalfibre",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"opticalfibre",count:12}]},manticore:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"chemicalsuperbase",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"chemicalsuperbase",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"chemicalsuperbase",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"chemicalsuperbase",count:12}]},karma:{2:[{symbol:"weaponschematic",count:1},{symbol:"compressionliquefiedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"weaponcomponent",count:2},{symbol:"tungstencarbide",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"compressionliquefiedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"weaponcomponent",count:5},{symbol:"tungstencarbide",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"compressionliquefiedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"weaponcomponent",count:9},{symbol:"tungstencarbide",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"compressionliquefiedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"weaponcomponent",count:12},{symbol:"tungstencarbide",count:12}]}}};var PERSONAL_UPGRADE_COSTS=deepFreeze(upgrade_costs_default);function getSuitUpgradeStepCost(family,targetGrade){assertTargetGrade(targetGrade,"getSuitUpgradeStepCost");const costs=getSuitUpgradeCosts(family);return costs?.[String(targetGrade)]??null}function getSuitUpgradeCost(family,targetGrade,currentGrade=1){assertGrade(targetGrade,"getSuitUpgradeCost: targetGrade");assertGrade(currentGrade,"getSuitUpgradeCost: currentGrade");const costs=getSuitUpgradeCosts(family);if(!costs)return null;return totalCosts(costs,targetGrade,currentGrade)}function getPersonalWeaponUpgradeStepCost(symbol,targetGrade){assertTargetGrade(targetGrade,"getPersonalWeaponUpgradeStepCost");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup][String(targetGrade)]??null}function getPersonalWeaponUpgradeCost(symbol,targetGrade,currentGrade=1){assertGrade(targetGrade,"getPersonalWeaponUpgradeCost: targetGrade");assertGrade(currentGrade,"getPersonalWeaponUpgradeCost: currentGrade");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return totalCosts(PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup],targetGrade,currentGrade)}function totalCosts(costs,targetGrade,currentGrade){const steps=[];for(let grade=currentGrade+1;grade<=targetGrade;grade++){steps.push(costs[String(grade)])}return sumPersonalEngineeringIngredients(...steps)}function getSuitUpgradeCosts(family){const suit=getSuitByFamily(family);if(!suit||!Object.hasOwn(PERSONAL_UPGRADE_COSTS.suits,suit.family))return null;return PERSONAL_UPGRADE_COSTS.suits[suit.family]}function assertTargetGrade(grade,functionName){if(!Number.isInteger(grade)||grade<2||grade>5){throw new RangeError(`${functionName}: targetGrade must be an integer in [2, 5]`)}}function assertGrade(grade,label){if(!Number.isInteger(grade)||grade<1||grade>5){throw new RangeError(`${label} must be an integer in [1, 5]`)}}export{PERSONAL_UPGRADE_COSTS,getPersonalWeaponUpgradeCost,getPersonalWeaponUpgradeStepCost,getSuitUpgradeCost,getSuitUpgradeStepCost};//# sourceMappingURL=upgrade-costs.js.map

package/dist/equipment/weapons.d.ts

@@ -1,135 +1,2 @@
-import { EquipmentGrade } from './suits.js';
-
-/**
- * Odyssey handheld weapons: their journal identifiers, combat stats, sight
- * magnification and grade-dependent damage.
- *
- * @packageDocumentation
- */
-
-/** A weapon manufacturer's shared Pioneer grade-upgrade recipe. */
-type WeaponUpgradeGroup = 'karma' | 'takada' | 'manticore';
-/** Technology suffix used to disambiguate personal-weapon modification recipes. */
-type PersonalWeaponEngineeringType = 'kinetic' | 'laser' | 'plasma';
-/** A handheld weapon's form factor. */
-type PersonalWeaponClass = 'pistol' | 'carbine' | 'rifle' | 'shotgun' | 'sniper' | 'launcher';
-/** Which suit weapon slot accepts the weapon. */
-type PersonalWeaponSlot = 'primary' | 'secondary';
-/** The damage family relevant to resistances and some modification recipes. */
-type PersonalDamageType = 'kinetic' | 'thermal' | 'plasma' | 'explosive';
-/** A handheld weapon firing cycle. */
-type PersonalFireMode = 'automatic' | 'semi-automatic' | 'burst';
-/** A weapon's aim-down-sights magnification, before and after the Scope modification. */
-interface ScopeMagnification {
-    /** Magnification of the sight the weapon ships with, e.g. `1.12` for 1.12x. */
-    readonly default: number;
-    /** Magnification of the sight the Scope modification fits, e.g. `1.41` for 1.41x. */
-    readonly upgraded: number;
-}
-/** Grade-dependent stats for one handheld weapon. */
-interface PersonalWeaponGrade {
-    /** Damage per projectile or pellet. */
-    readonly damage: number;
-    /** Permanent engineering-modification slots available, from `0` through `4`. */
-    readonly modificationSlots: number;
-}
-/** One handheld weapon sold by Pioneer Supplies. */
-interface PersonalWeapon {
-    /** Frontier item id reported by journal loadout events. */
-    readonly symbol: string;
-    /** English display name. */
-    readonly name: string;
-    /** Manufacturer recipe family used for grade upgrades. */
-    readonly upgradeGroup: WeaponUpgradeGroup;
-    /** Recipe suffix used when the journal omits a modification's weapon technology. */
-    readonly engineeringType: PersonalWeaponEngineeringType;
-    /** Weapon form factor. */
-    readonly class: PersonalWeaponClass;
-    /** Suit slot this weapon occupies. */
-    readonly slot: PersonalWeaponSlot;
-    /** Base damage family. */
-    readonly damageType: PersonalDamageType;
-    /** Firing cycle. */
-    readonly fireMode: PersonalFireMode;
-    /** Shots per second. */
-    readonly rateOfFire: number;
-    /** Rounds loaded in one magazine. */
-    readonly magazineSize: number;
-    /** Spare rounds carried before suit-capacity changes. */
-    readonly reserveAmmo: number;
-    /** Headshot damage multiplier (`2` means 200%). */
-    readonly headshotMultiplier: number;
-    /** Nominal effective range in metres. */
-    readonly effectiveRange: number;
-    /**
-     * Aim-down-sights magnification with the stock sight and with the one the Scope
-     * modification fits. Scope carries no modifier of its own: this pair is its whole
-     * numeric effect, and it differs per weapon.
-     */
-    readonly scopeMagnification: ScopeMagnification;
-    /**
-     * Grade records keyed by `"1"` through `"5"` — every weapon carries all five,
-     * unlike {@link Suit.grades}, and `equipment.test.ts` pins that. Read one through
-     * {@link getPersonalWeaponGrade} to get the same nullable answer suits give.
-     */
-    readonly grades: Readonly<Record<`${EquipmentGrade}`, PersonalWeaponGrade>>;
-}
-/**
- * All eleven handheld weapons in catalogue order.
- *
- * @example
- * ```ts
- * import { PERSONAL_WEAPONS } from '@elite-dangerous-almanac/core/equipment/weapons';
- * PERSONAL_WEAPONS.length; // -> 11
- * ```
- */
-declare const PERSONAL_WEAPONS: readonly PersonalWeapon[];
-/**
- * Look up a handheld weapon by its Frontier journal symbol, case-insensitively.
- *
- * @param symbol - Journal item id such as `"wpn_m_assaultrifle_kinetic_fauto"`,
- * matched case-insensitively after trimming surrounding whitespace.
- * @returns The frozen weapon record, or `null` when unknown.
- * @throws {TypeError} If `symbol` is present and not a string. A nullish symbol is a
- * miss, answered like an unrecognised one.
- * @example
- * ```ts
- * import { getPersonalWeaponBySymbol } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponBySymbol('wpn_m_assaultrifle_kinetic_fauto')?.name; // -> 'Karma AR-50'
- * ```
- */
-declare function getPersonalWeaponBySymbol(symbol: string): PersonalWeapon | null;
-/**
- * Look up a handheld weapon by display name, case-insensitively.
- *
- * @param name - English display name such as `"Karma AR-50"`; surrounding
- * whitespace is ignored.
- * @returns The frozen weapon record, or `null` when unknown.
- * @throws {TypeError} If `name` is present and not a string. A nullish name is a miss,
- * answered like an unrecognised one.
- * @example
- * ```ts
- * import { getPersonalWeaponByName } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponByName('Karma AR-50')?.symbol; // -> 'wpn_m_assaultrifle_kinetic_fauto'
- * ```
- */
-declare function getPersonalWeaponByName(name: string): PersonalWeapon | null;
-/**
- * Read one handheld weapon's stats at a grade.
- *
- * @param weapon - A catalogue weapon record.
- * @param grade - Integer grade `1`–`5`.
- * @returns The frozen grade record, or `null` when the record carries no such grade.
- * Every catalogued weapon carries all five, so the `null` is the same promise
- * {@link getSuitGrade} makes rather than an outcome the shipped catalogue produces —
- * write the two the same way and neither can surprise you.
- * @throws {RangeError} If `grade` is not an integer from 1 through 5.
- * @example
- * ```ts
- * import { PERSONAL_WEAPONS, getPersonalWeaponGrade } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponGrade(PERSONAL_WEAPONS[0]!, 5)?.modificationSlots; // -> 4
- * ```
- */
-declare function getPersonalWeaponGrade(weapon: PersonalWeapon, grade: number): PersonalWeaponGrade | null;
-
-export { PERSONAL_WEAPONS, type PersonalDamageType, type PersonalFireMode, type PersonalWeapon, type PersonalWeaponClass, type PersonalWeaponEngineeringType, type PersonalWeaponGrade, type PersonalWeaponSlot, type ScopeMagnification, type WeaponUpgradeGroup, getPersonalWeaponByName, getPersonalWeaponBySymbol, getPersonalWeaponGrade };
+import './engineering.js';
+export { P as PERSONAL_WEAPONS, a as PersonalDamageType, b as PersonalFireMode, e as PersonalWeapon, f as PersonalWeaponClass, g as PersonalWeaponEngineeringType, h as PersonalWeaponGrade, i as PersonalWeaponMetrics, j as PersonalWeaponSlot, R as ReloadTime, k as ScopeMagnification, W as WeaponUpgradeGroup, n as getPersonalWeaponByName, o as getPersonalWeaponBySymbol, p as getPersonalWeaponGrade, u as personalWeaponMetrics } from '../suits-B4sQMLFe.js';

package/dist/equipment/weapons.js

@@ -1 +1 @@
-export{PERSONAL_WEAPONS,getPersonalWeaponByName,getPersonalWeaponBySymbol,getPersonalWeaponGrade}from"../chunk-IUSMAX5T.js";                                                                                                                    //# sourceMappingURL=weapons.js.map
+export{PERSONAL_WEAPONS,getPersonalWeaponByName,getPersonalWeaponBySymbol,getPersonalWeaponGrade,personalWeaponMetrics}from"../chunk-PIU24HRN.js";                                                                                                                                                 //# sourceMappingURL=weapons.js.map

package/dist/i18n/blueprints.d.ts

@@ -4,9 +4,8 @@
  *
  * @param blueprintSymbol - Frontier's blueprint id, such as `"FSD_LongRange"`. Matching ignores
  * case and surrounding whitespace.
- * @param locale - A BCP 47 language or regional tag, such as `"de"`, `"de-DE"` or
- * `"en-GB"`. Matching is case-insensitive; underscores are accepted in place of
- * hyphens. A regional tag falls back to its language after an exact-locale miss.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
  * @returns The localized blueprint name; the canonical `Blueprint.name` for any English
  * tag; or `null` when the id is unknown, the locale is
  * unsupported, or the pinned source carries no value for that blueprint and locale.

package/dist/i18n/blueprints.js

@@ -1 +1 @@
-export{getBlueprintName}from"../chunk-DBDCOHI4.js";                                                                                       //# sourceMappingURL=blueprints.js.map
+export{getBlueprintName}from"../chunk-UI5RROGI.js";                                                                                       //# sourceMappingURL=blueprints.js.map

package/dist/i18n/commodities.d.ts

@@ -0,0 +1,36 @@
+/** Localized market-commodity display names, isolated from commodity metadata. */
+/**
+ * Look up a market commodity's source-backed display name for a locale.
+ *
+ * @param symbol - Frontier's commodity symbol, such as `"LavianBrandy"`. Matching
+ * ignores case and surrounding whitespace, so the lower-cased form a market or journal
+ * line reports resolves too.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
+ * @returns The localized commodity name; the canonical `Commodity.name` for any English
+ * tag; or `null` when the symbol is unknown or the locale is not one of the six this
+ * catalogue stores.
+ * @remarks
+ * Standard and rare commodities share this one lookup, as they share one symbol space.
+ * All six stored locales are complete for this dataset, so a supported locale always
+ * answers. This function bundles names only, not categories or the `rare` flag.
+ *
+ * **This is a heavy `i18n` dataset**: six locales for every good in both commodity
+ * catalogues is ~101 KiB minified (~27 KiB gzipped). It has its own module so an application that
+ * never shows a translated commodity name does not pay for it — import it from
+ * `core/i18n/commodities` rather than the `core/i18n` barrel if you want that boundary
+ * to be explicit.
+ * @throws {TypeError} If `symbol` is present and not a string, or `locale` is not a
+ * string. A nullish `symbol` is a lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getCommodityName } from '@elite-dangerous-almanac/core/i18n/commodities';
+ *
+ * getCommodityName('LavianBrandy', 'de-DE'); // -> 'Lave-Brandy'
+ * getCommodityName('platinum', 'ru'); // -> 'Платина'
+ * getCommodityName('platinum', 'it'); // -> null
+ * ```
+ */
+declare function getCommodityName(symbol: string, locale: string): string | null;
+
+export { getCommodityName };

package/dist/i18n/commodities.js

@@ -0,0 +1 @@
+export{getCommodityName}from"../chunk-TRGHPX2O.js";                                                                                       //# sourceMappingURL=commodities.js.map

package/dist/i18n/commodities.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"O"}

package/dist/i18n/experimental-effect-descriptions.d.ts

@@ -9,12 +9,11 @@
  * question — it names the damage split or behaviour the `modifiers` list cannot
  * express — and the two are deliberately not the same string.
  *
- * **This is the heaviest `i18n` dataset**: six locales of prose for all 86 effects is
- * ~129 KiB minified (~25 KiB gzipped), more than module names cost. Every other lookup
- * on this subpath carries short display names. It has its own module so an application
- * that never shows an effect description does not pay for it — import it from
- * `core/i18n/experimental-effect-descriptions` rather than the `core/i18n` barrel if
- * you want that boundary to be explicit.
+ * **This is a heavy `i18n` dataset**: six locales of prose for every effect is ~129 KiB
+ * minified (~25 KiB gzipped), more than module names cost. It has its own module so an
+ * application that never shows an effect description does not pay for it — import it
+ * from `core/i18n/experimental-effect-descriptions` rather than the `core/i18n` barrel
+ * if you want that boundary to be explicit.
  *
  * @param experimentalEffectSymbol - Frontier's experimental-effect id. Matching ignores case and
  * surrounding whitespace.

package/dist/i18n/experimental-effect-descriptions.js

@@ -1 +1 @@
-export{getExperimentalEffectDescription}from"../chunk-MRLUWHGI.js";                                                                                       //# sourceMappingURL=experimental-effect-descriptions.js.map
+export{getExperimentalEffectDescription}from"../chunk-RJ3ZLQRB.js";                                                                                       //# sourceMappingURL=experimental-effect-descriptions.js.map

package/dist/i18n/experimental-effects.d.ts

@@ -4,9 +4,8 @@
  *
  * @param experimentalEffectSymbol - Frontier's experimental-effect id, such as
  * `"special_concordant_sequence"`. Matching ignores case and surrounding whitespace.
- * @param locale - A BCP 47 language or regional tag, such as `"de"`, `"de-DE"` or
- * `"en-GB"`. Matching is case-insensitive; underscores are accepted in place of
- * hyphens. A regional tag falls back to its language after an exact-locale miss.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
  * @returns The localized effect name; the canonical `ExperimentalEffect.name` for any
  * English tag; or `null` when
  * the id is unknown, the locale is unsupported, or the pinned source carries no value

package/dist/i18n/experimental-effects.js

@@ -1 +1 @@
-export{getExperimentalEffectName}from"../chunk-BMQM4JBL.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map
+export{getExperimentalEffectName}from"../chunk-QPT2WJYN.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map