@elite-dangerous-almanac/core 0.2.10 → 0.2.12

package/dist/equipment/suit-loadout.d.ts

@@ -0,0 +1,284 @@
+import { PersonalModifier } from './engineering.js';
+import { PersonalModification } from './modifications.js';
+import { d as PersonalMountKey, e as PersonalWeapon, E as EquipmentGrade, i as PersonalWeaponMetrics, l as Suit, m as SuitGrade } from '../suits-B4sQMLFe.js';
+
+/**
+ * Import a journal suit loadout: the suit a Commander wears, its grade, the permanent
+ * modifications on it, and the weapon at each mount with the modifications on that.
+ *
+ * The game writes the same payload under three event names — `SuitLoadout` when a
+ * session starts or a loadout changes, `SwitchSuitLoadout` when the Commander changes
+ * suit, and `CreateSuitLoadout` when they save a new one — so {@link parseSuitLoadout}
+ * takes any of the three.
+ *
+ * This is the personal-equipment counterpart of `ships/ship-loadout`, at the scale the
+ * domain needs: a suit has no editor, so an import is one frozen record rather than a
+ * mutable build. It carries the suit and weapon catalogues and the modification recipes,
+ * which is every catalogue an event names.
+ *
+ * @packageDocumentation
+ */
+
+/** One weapon entry in a journal suit-loadout event. */
+interface SuitLoadoutModuleEvent {
+    /** The mount it occupies, e.g. `"PrimaryWeapon1"`. */
+    readonly SlotName: string;
+    /** The owned weapon instance's id. */
+    readonly SuitModuleID?: number;
+    /** The weapon's Frontier symbol, e.g. `"wpn_m_launcher_rocket_sauto"`. */
+    readonly ModuleName: string;
+    /** The weapon's display name, when the event states one. */
+    readonly ModuleName_Localised?: string;
+    /** The weapon's Pioneer Supplies grade, 1–5. */
+    readonly Class: number;
+    /** Each permanent modification on the weapon, in the game's own spelling. */
+    readonly WeaponMods?: readonly string[];
+}
+/**
+ * A journal `SuitLoadout`, `SwitchSuitLoadout` or `CreateSuitLoadout` event.
+ *
+ * @remarks
+ * `event` and `timestamp` name the journal line rather than the loadout, and the
+ * `_Localised` fields are the game's own display text for a locale. {@link
+ * parseSuitLoadout} drops all four; `i18n/suits`, `i18n/personal-weapons` and
+ * `i18n/personal-modifications` answer for display text in every stored locale.
+ */
+interface SuitLoadoutEvent {
+    /** The journal event name. Accepted on input, and not part of the loadout. */
+    readonly event?: string;
+    /** When the game wrote the line. */
+    readonly timestamp?: string;
+    /** The owned suit instance's id. */
+    readonly SuitID?: number;
+    /** The suit's grade-specific Frontier symbol, e.g. `"tacticalsuit_class5"`. */
+    readonly SuitName: string;
+    /** The suit's display name, when the event states one. */
+    readonly SuitName_Localised?: string;
+    /** Each permanent modification on the suit, in the game's own spelling. */
+    readonly SuitMods?: readonly string[];
+    /** The saved loadout's id. */
+    readonly LoadoutID?: number;
+    /** The player-given loadout name, e.g. `"Double Trouble"`. */
+    readonly LoadoutName?: string;
+    /** The weapon at each occupied mount. */
+    readonly Modules?: readonly SuitLoadoutModuleEvent[];
+}
+/** One modification an event states, resolved against the recipe catalogue. */
+interface FittedPersonalModification {
+    /** The symbol the event wrote, e.g. `"weapon_range"`. */
+    readonly journalSymbol: string;
+    /**
+     * The recipe key, e.g. `"weapon_range_kinetic"`, ready to index
+     * `PERSONAL_MODIFICATIONS` and `PERSONAL_MODIFICATION_COSTS`.
+     *
+     * @remarks
+     * It is {@link journalSymbol} trimmed and lower-cased, which is how both catalogues
+     * key a recipe. Greater Range, Headshot Damage and Improved Hip Fire Accuracy carry
+     * a Kinetic, a Laser and a Plasma recipe each, and the journal writes one symbol for
+     * all three, so there the key also gains the suffix the weapon at the mount settles;
+     * `equipment/modification-journal` is that lookup.
+     */
+    readonly symbol: string;
+    /** The recipe itself. */
+    readonly modification: PersonalModification;
+}
+/** One weapon an event puts on a suit mount, resolved against the weapon catalogue. */
+interface FittedPersonalWeapon {
+    /** The mount, in the catalogue's spelling, whatever spelling the event used. */
+    readonly mount: PersonalMountKey;
+    /** The owned weapon instance's id, or `null` when the event states none. */
+    readonly moduleId: number | null;
+    /** The weapon. */
+    readonly weapon: PersonalWeapon;
+    /** The weapon's grade, from the event's `Class`. */
+    readonly grade: EquipmentGrade;
+    /**
+     * Each modification the catalogues resolved, in the order the event lists them.
+     * Anything the event stated and this leaves out is in
+     * {@link SuitLoadout.importOutcomes}.
+     */
+    readonly modifications: readonly FittedPersonalModification[];
+    /**
+     * Every modifier that acts on this weapon, ready for `applyPersonalModifiers`.
+     *
+     * @remarks
+     * This includes the suit's own modifiers that name a stat the weapon carries: Extra
+     * Ammo Capacity is a suit modification and multiplies a *weapon's* `reserveAmmo`, so
+     * one list answers for the weapon and a consumer does not have to know which
+     * equipment the recipe sits on. That is also why nothing is ever concatenated onto
+     * it: adding {@link SuitLoadout.modifiers} multiplies those factors in a second time.
+     */
+    readonly modifiers: readonly PersonalModifier[];
+    /** Whether Reload Speed is fitted, which selects `weapon.reloadTime.upgraded`. */
+    readonly reloadSpeed: boolean;
+    /** Whether Scope is fitted, which selects `weapon.scopeMagnification.upgraded`. */
+    readonly scope: boolean;
+    /** What the weapon does per second at this grade, with {@link modifiers} folded in. */
+    readonly metrics: PersonalWeaponMetrics;
+}
+/**
+ * Something an event states that the import could not use.
+ *
+ * @remarks
+ * An event is taken as far as the catalogues allow. Every outcome reports one entry the
+ * import left out — a weapon it does not fit, or a modification it does not apply — so
+ * the loadout holds what the catalogues answer for. The suit is the one identity a miss
+ * refuses outright, because nothing else in the event stands without it; a malformed
+ * event is refused too, and {@link parseSuitLoadout} states what it checks.
+ */
+interface SuitLoadoutImportOutcome {
+    /**
+     * Why the entry is left out:
+     *
+     * - `unknownWeapon` — no catalogue weapon answers to `ModuleName`.
+     * - `unknownMount` — the suit carries no mount by that `SlotName`.
+     * - `refusedMount` — the weapon resolves, and the mount does not take its kind: a
+     *   primary weapon in the secondary mount, or the reverse.
+     * - `unknownGrade` — `Class` is not an integer from 1 through 5, so the weapon has
+     *   no stats to report.
+     * - `unknownModification` — no recipe answers to the symbol.
+     * - `refusedModification` — the recipe resolves, and it belongs to the other
+     *   equipment: a suit recipe under `WeaponMods`, or a weapon recipe under `SuitMods`.
+     */
+    readonly action: 'unknownWeapon' | 'unknownMount' | 'refusedMount' | 'unknownGrade' | 'unknownModification' | 'refusedModification';
+    /**
+     * The mount the event named, in its own spelling, or `null` for a modification on
+     * the suit itself.
+     */
+    readonly mount: string | null;
+    /** The weapon or recipe symbol the event stated. */
+    readonly sourceSymbol: string;
+}
+/**
+ * One imported suit loadout: the suit, its modifications, and the weapon at each mount.
+ *
+ * @remarks
+ * Every field is a frozen fact the event stated or the catalogues resolved. Read a mount
+ * with `loadout.weapons.find((fitted) => fitted.mount === 'PrimaryWeapon1')`; an absent
+ * one holds no weapon, which is what the game writes for an empty mount.
+ */
+interface SuitLoadout {
+    /** The suit model. */
+    readonly suit: Suit;
+    /** The suit's grade, from its Frontier symbol. */
+    readonly grade: EquipmentGrade;
+    /** The suit's stats at {@link grade}. */
+    readonly stats: SuitGrade;
+    /** The owned suit instance's id, or `null` when the event states none. */
+    readonly suitId: number | null;
+    /** The saved loadout's id, or `null` when the event states none. */
+    readonly loadoutId: number | null;
+    /** The player-given loadout name, or `null` when the event states none. */
+    readonly name: string | null;
+    /**
+     * Each modification the catalogues resolved, in the order the event lists them.
+     * Anything the event stated and this leaves out is in {@link importOutcomes}.
+     */
+    readonly modifications: readonly FittedPersonalModification[];
+    /**
+     * Every modifier the suit's modifications carry, ready for `applyPersonalModifiers`.
+     *
+     * @remarks
+     * A modifier here names a stat of whatever the recipe changes. Most name a suit
+     * stat; Extra Ammo Capacity names a weapon's `reserveAmmo` and Reduced Tool Battery
+     * Consumption names a tool's `toolEnergyDrain`. `applyPersonalModifiers` reads one
+     * stat at a time, so pass the base the stat belongs to and the rest are skipped.
+     *
+     * **Never concatenate this list with a weapon's own.**
+     * {@link FittedPersonalWeapon.modifiers} already carries the suit modifiers that act
+     * on that weapon, so a joined list multiplies them in twice: the reserve of a weapon
+     * behind Extra Ammo Capacity reads 1.5× from either list alone, and 2.25× from both.
+     * Use the weapon's list for a weapon stat, and this one for a suit or tool stat.
+     */
+    readonly modifiers: readonly PersonalModifier[];
+    /** The weapon at each occupied mount, in the order the event lists them. */
+    readonly weapons: readonly FittedPersonalWeapon[];
+    /**
+     * Everything the event stated that the import left out, as
+     * `ships/ship-loadout` reports its own import changes.
+     */
+    readonly importOutcomes: readonly SuitLoadoutImportOutcome[];
+}
+/**
+ * Import a journal `SuitLoadout`, `SwitchSuitLoadout` or `CreateSuitLoadout` event.
+ *
+ * @param event - The event object, as the game wrote it.
+ * @returns The frozen {@link SuitLoadout}.
+ * @remarks
+ * A mount name is matched case-insensitively, with surrounding whitespace ignored, and
+ * the loadout reports the catalogue's own spelling — so `fitted.mount === 'PrimaryWeapon1'`
+ * holds whatever spelling the source used. Weapon and recipe symbols are matched the
+ * same way.
+ *
+ * The suit has to resolve: an unknown `SuitName` is a `TypeError`, because the grade,
+ * the mounts and every stat come from it. Everything else the catalogues cannot resolve
+ * is left out of the loadout and reported by {@link SuitLoadout.importOutcomes}, so one
+ * unknown weapon does not cost a caller the rest of the event.
+ *
+ * `SuitID`, `SuitModuleID`, `LoadoutID` and `LoadoutName` are kept: they name the items
+ * the Commander owns and the loadout slot they sit in, which is what a later
+ * `LoadoutEquipModule` event joins to. `event`, `timestamp` and the `_Localised` display
+ * text are dropped.
+ * @throws {TypeError} If `event` is not shaped like one. `event` must be an object whose
+ * `SuitName` is a string naming a catalogued suit; `Modules`, `SuitMods` and `WeaponMods`
+ * must be arrays whenever they are present; each module must be an object with a string
+ * `SlotName` and `ModuleName`, no two claiming the same mount; and each modification must
+ * be a string. Every other field is trusted.
+ * @example
+ * ```ts
+ * import { parseSuitLoadout } from '@elite-dangerous-almanac/core/equipment/suit-loadout';
+ *
+ * const loadout = parseSuitLoadout({
+ *     event: 'SwitchSuitLoadout',
+ *     SuitID: 1700482757598197,
+ *     SuitName: 'tacticalsuit_class5',
+ *     SuitMods: ['suit_nightvision', 'suit_increasedammoreserves'],
+ *     LoadoutID: 4293000007,
+ *     LoadoutName: 'Double Trouble',
+ *     Modules: [
+ *         {
+ *             SlotName: 'PrimaryWeapon1',
+ *             SuitModuleID: 1701103603778031,
+ *             ModuleName: 'wpn_m_launcher_rocket_sauto',
+ *             Class: 5,
+ *             WeaponMods: ['weapon_clipsize'],
+ *         },
+ *     ],
+ * });
+ *
+ * loadout.suit.name; // -> 'Dominator Suit'
+ * loadout.grade; // -> 5
+ * loadout.name; // -> 'Double Trouble'
+ * loadout.weapons[0]?.weapon.name; // -> 'Karma L-6'
+ * loadout.weapons[0]?.metrics.damagePerSecond; // -> 119.2
+ * ```
+ * @example
+ * A stat the game shows on foot is the catalogue's base with the fitted modifiers folded
+ * onto it. The suit's Extra Ammo Capacity reaches the weapon that carries the reserve.
+ *
+ * ```ts
+ * import { applyPersonalModifiers } from '@elite-dangerous-almanac/core/equipment/engineering';
+ * import { parseSuitLoadout } from '@elite-dangerous-almanac/core/equipment/suit-loadout';
+ *
+ * const loadout = parseSuitLoadout({
+ *     SuitName: 'tacticalsuit_class5',
+ *     SuitMods: ['suit_increasedshieldregen', 'suit_increasedammoreserves'],
+ *     Modules: [
+ *         {
+ *             SlotName: 'PrimaryWeapon1',
+ *             ModuleName: 'wpn_m_launcher_rocket_sauto',
+ *             Class: 5,
+ *             WeaponMods: [],
+ *         },
+ *     ],
+ * });
+ *
+ * const fitted = loadout.weapons[0]!;
+ * applyPersonalModifiers('shieldRegeneration', loadout.stats.shieldRegeneration, loadout.modifiers);
+ * // -> 3.1
+ * applyPersonalModifiers('reserveAmmo', fitted.weapon.reserveAmmo, fitted.modifiers); // -> 12
+ * ```
+ */
+declare function parseSuitLoadout(event: SuitLoadoutEvent): SuitLoadout;
+
+export { type FittedPersonalModification, type FittedPersonalWeapon, type SuitLoadout, type SuitLoadoutEvent, type SuitLoadoutImportOutcome, type SuitLoadoutModuleEvent, parseSuitLoadout };

package/dist/equipment/suit-loadout.js

@@ -0,0 +1 @@
+export{parseSuitLoadout}from"../chunk-36I5QLTL.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=suit-loadout.js.map

package/dist/equipment/suit-loadout.js.map

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

package/dist/i18n/blueprints.js

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

package/dist/i18n/codex-regions.d.ts

@@ -0,0 +1,33 @@
+/** Localized galactic codex region names, isolated from the region footprints. */
+/**
+ * Look up a galactic codex region's source-backed display name for a locale.
+ *
+ * @param id - Region id, 1–42, as `CodexRegion.id` carries it. Id `0` means
+ * "outside the mapped region grid" and has no name.
+ * @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 region name; the canonical `CodexRegion.name` for any English
+ * tag; or `null` when the id is not 1–42 or the locale is not one of the six this
+ * catalogue stores.
+ * @remarks
+ * The catalogue is keyed by region id rather than by English name, because the id is
+ * the region's stable identity while the name is the value being translated.
+ *
+ * All six stored locales are complete, so a supported locale always answers. The game
+ * leaves many regions untranslated in some languages, and spells Izanami, Temple, Mare
+ * Somnia, Xibalba and Tenebrae alike in all six. The catalogue stores those source values
+ * verbatim rather than treating them as a missing translation.
+ * @throws {TypeError} If `locale` is not a string. A nullish or out-of-range `id` is a
+ * lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getCodexRegionName } from '@elite-dangerous-almanac/core/i18n/codex-regions';
+ *
+ * getCodexRegionName(1, 'de-DE'); // -> 'Galaktisches Zentrum'
+ * getCodexRegionName(5, 'fr'); // -> 'Bras de la Règle'
+ * getCodexRegionName(5, 'it'); // -> null
+ * ```
+ */
+declare function getCodexRegionName(id: number, locale: string): string | null;
+
+export { getCodexRegionName };

package/dist/i18n/codex-regions.js

@@ -0,0 +1 @@
+export{getCodexRegionName}from"../chunk-O4NIJDL4.js";                                                                                       //# sourceMappingURL=codex-regions.js.map

package/dist/i18n/codex-regions.js.map

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

package/dist/i18n/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * Sparse, source-backed localized display names and descriptions for Elite Dangerous
- * outfitting, personal-equipment, engineering, material and market-commodity
- * catalogues.
+ * outfitting, personal-equipment, engineering, material, market-commodity and galactic
+ * codex-region catalogues.
  *
  * Each lookup takes the identifier its owning catalogue is keyed by — a Frontier symbol,
- * or the library id where the game publishes none, as for a suit tool — and a BCP 47
- * locale. English is complete: for a name catalogue it is exactly the owning record's
- * `name`, and for a description catalogue it is the game's own display prose, which no
- * catalogue otherwise publishes.
+ * the library id where the game publishes none, as for a suit tool, or the region id for
+ * a galactic codex region — and a BCP 47 locale. English is complete: for a name
+ * catalogue it is exactly the owning record's `name`, and for a description catalogue it
+ * is the game's own display prose, which no catalogue otherwise publishes.
  * Other locales are intentionally sparse: the function returns `null` when its pinned
  * sources carry no translation, leaving the application in control of fallback policy.
  * A source-backed localized spelling can be identical to English; the lookup returns
@@ -28,7 +28,8 @@
  * <!-- generated by scripts/i18n-coverage.mjs -->
  * | Lookup | Keys | en | de | es | fr | pt | ru |
  * | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
- * | `getBlueprintName` | 107 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getBlueprintName` | 111 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getCodexRegionName` | 42 | 100 | 100 | 100 | 100 | 100 | 100 |
  * | `getCommodityName` | 412 | 100 | 100 | 100 | 100 | 100 | 100 |
  * | `getExperimentalEffectDescription` | 86 | 100 | 100 | 100 | 100 | 100 | 100 |
  * | `getExperimentalEffectName` | 86 | 100 | 100 | 100 | 100 | 100 | 100 |
@@ -41,7 +42,7 @@
  * | `getPersonalWeaponDescription` | 11 | 100 | 100 | 100 | 100 | 100 | 100 |
  * | `getSuitDescription` | 19 | 100 | 100 | 100 | 100 | 100 | 100 |
  * | `getSuitName` | 19 | 100 | 100 | 100 | 100 | 100 | 100 |
- * | `getPreEngineeredVariantName` | 76 | 100 | 92 | 89 | 89 | 100 | 100 |
+ * | `getPreEngineeredVariantName` | 79 | 100 | 92 | 89 | 89 | 100 | 100 |
  * | `getOutfittingFamilyName` | 77 | 100 | 75 | 75 | 75 | 75 | 75 |
  * <!-- end generated -->
  *
@@ -81,6 +82,7 @@ export { getBlueprintName } from './blueprints.js';
 export { getExperimentalEffectName } from './experimental-effects.js';
 export { getExperimentalEffectDescription } from './experimental-effect-descriptions.js';
 export { getCommodityName } from './commodities.js';
+export { getCodexRegionName } from './codex-regions.js';
 export { getMaterialName } from './materials.js';
 export { getMicroResourceName } from './micro-resources.js';
 export { getPersonalMountName, getSuitDescription, getSuitName } from './suits.js';

package/dist/i18n/index.js

@@ -1 +1 @@
-export{getPersonalModificationDescription,getPersonalModificationName}from"../chunk-SS7HVNP5.js";export{getPersonalToolName}from"../chunk-E2HDF6PJ.js";export{getPersonalWeaponDescription}from"../chunk-7C7NJWCF.js";export{getPreEngineeredVariantName}from"../chunk-T7IQHFQ2.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getPersonalMountName,getSuitDescription,getSuitName}from"../chunk-RA4YJBU5.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getExperimentalEffectDescription}from"../chunk-RJ3ZLQRB.js";export{getExperimentalEffectName}from"../chunk-QPT2WJYN.js";export{getMaterialName}from"../chunk-UE22QU7A.js";export{getMicroResourceName}from"../chunk-WZIBBJHA.js";export{getOutfittingFamilyName}from"../chunk-YBE5M27G.js";export{getModuleName}from"../chunk-URRPEUIK.js";export{getBlueprintName}from"../chunk-UI5RROGI.js";export{getCommodityName}from"../chunk-TRGHPX2O.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getOutfittingFamilyName}from"../chunk-YBE5M27G.js";export{getModuleName}from"../chunk-URRPEUIK.js";export{getPersonalModificationDescription,getPersonalModificationName}from"../chunk-SS7HVNP5.js";export{getPersonalToolName}from"../chunk-E2HDF6PJ.js";export{getPersonalWeaponDescription}from"../chunk-7C7NJWCF.js";export{getPreEngineeredVariantName}from"../chunk-FRG7MKSJ.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getPersonalMountName,getSuitDescription,getSuitName}from"../chunk-RA4YJBU5.js";export{getCodexRegionName}from"../chunk-O4NIJDL4.js";export{getCommodityName}from"../chunk-TRGHPX2O.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getExperimentalEffectDescription}from"../chunk-RJ3ZLQRB.js";export{getExperimentalEffectName}from"../chunk-QPT2WJYN.js";export{getMaterialName}from"../chunk-UE22QU7A.js";export{getMicroResourceName}from"../chunk-WZIBBJHA.js";export{getBlueprintName}from"../chunk-KR664YI3.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/i18n/pre-engineered.d.ts

@@ -1,4 +1,8 @@
 import { PreEngineeredAcquisition } from '../ships/pre-engineered.js';
+import '../ships/modules.js';
+import '../ships/engineering-options.js';
+import '../ships/module-families.js';
+import '../ships/slots.js';
 
 /** Localized pre-engineered variant names, isolated from module and modifier statistics. */
 

package/dist/i18n/pre-engineered.js

@@ -1 +1 @@
-export{getPreEngineeredVariantName}from"../chunk-T7IQHFQ2.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map
+export{getPreEngineeredVariantName}from"../chunk-FRG7MKSJ.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map

package/dist/materials/index.js

@@ -1 +1 @@
-export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-X3MXPE7G.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-ETREYN5U.js";export{ALL_MICRO_RESOURCES}from"../chunk-GVNTKCVF.js";export{ITEM_MICRO_RESOURCES}from"../chunk-WHWFKHV3.js";export{COMPONENT_MICRO_RESOURCES}from"../chunk-HTB52N6S.js";export{CONSUMABLE_MICRO_RESOURCES}from"../chunk-K7L7SMIR.js";export{DATA_MICRO_RESOURCES}from"../chunk-GVLDFJEY.js";                             export{ALL_MATERIALS}from"../chunk-FP2TQJZP.js";export{ENCODED_MATERIALS}from"../chunk-A5TCT2AJ.js";export{MANUFACTURED_MATERIALS}from"../chunk-PF3HZ73R.js";export{RAW_MATERIALS}from"../chunk-GZLD7RTK.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-7UF4XRIR.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-ETREYN5U.js";export{ALL_MATERIALS}from"../chunk-FP2TQJZP.js";export{ENCODED_MATERIALS}from"../chunk-A5TCT2AJ.js";export{MANUFACTURED_MATERIALS}from"../chunk-PF3HZ73R.js";export{RAW_MATERIALS}from"../chunk-GZLD7RTK.js";                             export{ALL_MICRO_RESOURCES}from"../chunk-KLC5XT6F.js";export{CONSUMABLE_MICRO_RESOURCES}from"../chunk-K7L7SMIR.js";export{DATA_MICRO_RESOURCES}from"../chunk-GVLDFJEY.js";export{ITEM_MICRO_RESOURCES}from"../chunk-WHWFKHV3.js";export{COMPONENT_MICRO_RESOURCES}from"../chunk-HTB52N6S.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/materials/micro-resources-all.js

@@ -1 +1 @@
-export{ALL_MICRO_RESOURCES}from"../chunk-GVNTKCVF.js";                                                                                                                                                                              //# sourceMappingURL=micro-resources-all.js.map
+export{ALL_MICRO_RESOURCES}from"../chunk-KLC5XT6F.js";                                                                                                                                                                              //# sourceMappingURL=micro-resources-all.js.map

package/dist/materials/micro-resources.js

@@ -1 +1 @@
-export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-X3MXPE7G.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=micro-resources.js.map
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-7UF4XRIR.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=micro-resources.js.map

package/dist/ships/blueprint-costs.js

@@ -1 +1 @@
-export{BLUEPRINT_COSTS,BLUEPRINT_MERC_COIN_COSTS,getBlueprintCost,getBlueprintCosts,getBlueprintGradeCost}from"../chunk-K5JK3XQB.js";                                                                                                                                                 //# sourceMappingURL=blueprint-costs.js.map
+export{BLUEPRINT_COSTS,BLUEPRINT_MERC_COIN_COSTS,getBlueprintCost,getBlueprintCosts,getBlueprintGradeCost}from"../chunk-ARG6ESYB.js";                                                                                                                                                 //# sourceMappingURL=blueprint-costs.js.map

package/dist/ships/blueprints.d.ts

@@ -30,10 +30,9 @@ import './slots.js';
  * full mechanics catalogue and resolves one against a module.
  *
  * Further keys are the **Operations** ids: recipes a module is *sold*
- * carrying (`ships/pre-engineered`) and the four Operations recipes a player rolls at an
+ * carrying (`ships/pre-engineered`) and the Operations recipes a player rolls at an
  * engineer (`ships/engineering-options`). No journal spelling has been observed for those
  * Operations ids — a gap in the evidence, not a claim that the game writes none.
- *
  * **Every recipe is keyed once.** Anti-Guardian Zone Resistance is
  * `GuardianModule_Sturdy`, the id the game writes on Guardian weapons as well as on
  * Guardian modules; the Inara registry's `recipe_guardianmodule_sturdy` and

package/dist/ships/blueprints.js

@@ -1 +1 @@
-export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-AYAKU4YA.js";                                                                                       //# sourceMappingURL=blueprints.js.map
+export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-WDAYRHXR.js";                                                                                       //# sourceMappingURL=blueprints.js.map

package/dist/ships/build-metrics.js

@@ -1 +1 @@
-export{BuildMetrics}from"../chunk-G7WARJ3X.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      //# sourceMappingURL=build-metrics.js.map
+export{BuildMetrics}from"../chunk-DEY44PHF.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      //# sourceMappingURL=build-metrics.js.map

package/dist/ships/index.js

@@ -1 +1 @@
-export{LoadoutEditError,ShipLoadout}from"../chunk-HIJR7DOC.js";export{validateLoadout}from"../chunk-3GNYPM6J.js";export{SHIP_MODULE_LIMITS,calculateModuleLimits}from"../chunk-KPETDYQX.js";export{hasFrameShiftDriveJumpStats,hasMassCurveStats,hasPowerDistributorStats,hasPowerGenerationStats,hasShieldRegenerationStats,hasWeaponDamageStats}from"../chunk-JTQVWIGL.js";export{OUTFITTING_FAMILIES}from"../chunk-M6G3UDTX.js";export{SHIP_GUNSIGHTS,getShipGunsight,projectGunsight}from"../chunk-XSN53F7W.js";export{BuildMetrics}from"../chunk-G7WARJ3X.js";export{weaponsCapacitorMetrics}from"../chunk-M4FZRDAH.js";export{shieldCapacitorMetrics}from"../chunk-XQJERZUS.js";export{cellBankSummary,shieldRecovery}from"../chunk-JMAXSXXQ.js";                             export{getLoadoutModifier,inspectSlef,parseSlef,stringifySlef,toSlef}from"../chunk-T4MKUKYS.js";export{getSourceModuleValue,sourcePurchaseFromLoadout,sumSourceModuleValues}from"../chunk-NIURLW2F.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-AAU7OM47.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-C3YZ5KTA.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-AUBV6S7V.js";export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-5VWACBTN.js";export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-C4FUV6GF.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-OSMBAFRW.js";                                                                                                                                                                              export{powerBudget}from"../chunk-GGQMIQPC.js";export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-VTMCSCXV.js";export{calculateCargoCapacity,calculateFuelCapacity,calculatePassengerCapacity,calculateUnladenMass}from"../chunk-C3LLPLLD.js";                             export{mobilityCapacitorMetrics}from"../chunk-VEEBJFJ7.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-A4QKXXZD.js";                                                                                       export{distributorMetrics}from"../chunk-M2TCZKRT.js";                                                          export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-77I24V6B.js";export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-6HA2YIKW.js";export{ammunitionCapacity}from"../chunk-AA3K5XUE.js";export{armourMetrics}from"../chunk-Q5ALV3DI.js";export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance}from"../chunk-F44QX47A.js";                                                          export{computeModifiers,sumMaterials}from"../chunk-U73MBQ45.js";                             export{resolveBlueprintForModule}from"../chunk-2J6NNI3Y.js";export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-M4STXLXO.js";export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-AYAKU4YA.js";                             export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map
+export{LoadoutEditError,ShipLoadout}from"../chunk-25EECUZ2.js";export{hasFrameShiftDriveJumpStats,hasMassCurveStats,hasPowerDistributorStats,hasPowerGenerationStats,hasShieldRegenerationStats,hasWeaponDamageStats}from"../chunk-JTQVWIGL.js";export{OUTFITTING_FAMILIES}from"../chunk-M6G3UDTX.js";export{SHIP_GUNSIGHTS,getShipGunsight,projectGunsight}from"../chunk-XSN53F7W.js";export{validateLoadout}from"../chunk-3GNYPM6J.js";export{SHIP_MODULE_LIMITS,calculateModuleLimits}from"../chunk-KPETDYQX.js";export{BuildMetrics}from"../chunk-DEY44PHF.js";                             export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-C4FUV6GF.js";export{getLoadoutModifier,inspectSlef,parseSlef,stringifySlef,toSlef}from"../chunk-T4MKUKYS.js";export{getSourceModuleValue,sourcePurchaseFromLoadout,sumSourceModuleValues}from"../chunk-NIURLW2F.js";export{weaponsCapacitorMetrics}from"../chunk-M4FZRDAH.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-AAU7OM47.js";export{powerBudget}from"../chunk-GGQMIQPC.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-P6HCQ2YE.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-OSMBAFRW.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-EXHZ4CFB.js";export{shieldCapacitorMetrics}from"../chunk-XQJERZUS.js";export{cellBankSummary,shieldRecovery}from"../chunk-JMAXSXXQ.js";export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-DBJKLXLS.js";                                                                                                                                                                              export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-6HA2YIKW.js";export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-VTMCSCXV.js";export{calculateCargoCapacity,calculateFuelCapacity,calculatePassengerCapacity,calculateUnladenMass}from"../chunk-C3LLPLLD.js";                             export{mobilityCapacitorMetrics}from"../chunk-VEEBJFJ7.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-A4QKXXZD.js";                                                          export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-WDAYRHXR.js";                             export{distributorMetrics}from"../chunk-M2TCZKRT.js";                                                          export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-77I24V6B.js";export{ammunitionCapacity}from"../chunk-AA3K5XUE.js";export{armourMetrics}from"../chunk-Q5ALV3DI.js";export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance}from"../chunk-F44QX47A.js";                                                          export{computeModifiers,sumMaterials}from"../chunk-U73MBQ45.js";                             export{resolveBlueprintForModule}from"../chunk-2J6NNI3Y.js";export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-M4STXLXO.js";                             export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map

package/dist/ships/pre-engineered-stats.d.ts

@@ -44,8 +44,7 @@ import './slots.js';
  *
  * @param variant - A pre-engineered variant.
  * @returns One modifier per computable label, or an empty array when the variant carries
- * neither a stat block nor a baked effect that moves a stat (a `mercenary` row carries no
- * stat block, so only its baked effect contributes) or its symbol is unknown.
+ * neither a stat block nor a baked effect that moves a stat, or its symbol is unknown.
  *
  * @example
  * ```ts
@@ -69,9 +68,8 @@ declare function getPreEngineeredModifiers(variant: PreEngineeredVariant): Engin
  *
  * @param variant - A pre-engineered variant.
  * @returns Its computable fixed modifiers in journal representation, or an empty array
- * when its symbol is unknown or it moves no stat the catalogue carries. A `mercenary` row
- * publishes no stat block, so what its baked experimental effect moves is the whole of
- * what it reports — the same block `ShipLoadout.setPreEngineeredVariant` fits.
+ * when its symbol is unknown or it moves no stat the catalogue carries. A measured
+ * Mercenary row combines its fixed block with its baked experimental effect.
  *
  * @example
  * ```ts
@@ -178,10 +176,8 @@ declare function unresolvedModifiers(variant: PreEngineeredVariant): string[];
  * Exact damage components scale with an engineered `damage` value so their proportions
  * and the anti-xeno overlay remain coherent with the resolved scalar.
  *
- * A variant with no stat block (every `mercenary` row) resolves to a copy of the base
- * record with only its baked experimental effect applied, which is the honest answer —
- * the effect is published, the grade-1 pre-engineering those arrive with is not, so the
- * catalogue does not guess at it.
+ * A caller-supplied variant with no stat block resolves to a copy of the base record with only
+ * its baked experimental effect applied.
  *
  * `rateOfFire` follows a moved firing cycle even though no recipe names it: an article
  * whose burst interval, burst size or within-burst rate moves — by its own stat block or

package/dist/ships/pre-engineered-stats.js

@@ -1 +1 @@
-export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-C3YZ5KTA.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             //# sourceMappingURL=pre-engineered-stats.js.map
+export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-P6HCQ2YE.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             //# sourceMappingURL=pre-engineered-stats.js.map

package/dist/ships/pre-engineered.d.ts

@@ -1,3 +1,8 @@
+import { DamageDistribution } from './modules.js';
+import './engineering-options.js';
+import './module-families.js';
+import './slots.js';
+
 /**
  * The **pre-engineered module catalogue** — the outfitting rows you buy or receive
  * already modified, each paired with the base module it fits as and the engineering
@@ -18,10 +23,9 @@
  * grade already applied. Most blueprint ids join to `BLUEPRINTS`; the festive
  * `Decorative_*` ids instead identify fixed grade-5 reward articles with no craftable
  * recipe or material cost.
- * Mercenary entries are bought at grade 1 and their bespoke recipes start at
- * grade 2 — price the remaining upgrade with `getBlueprintCost(blueprint, target,
- * grade)` from `ships/blueprint-costs`, which answers with the materials and the Merc
- * Coin the climb costs.
+ * Mercenary entries are bought at grade 1. Measured bespoke recipes start at grade 2.
+ * Price a measured upgrade with `getBlueprintCost(blueprint, target, grade)` from
+ * `ships/blueprint-costs`. It returns `null` when numeric grades and costs are not measured.
  * Community-goal and tech-broker entries instead identify fixed reward articles; their
  * blueprint ids do not grant a recipe to the stock module.
  *
@@ -41,6 +45,7 @@
  *
  * @packageDocumentation
  */
+
 /**
  * Where a pre-engineered variant is obtained.
  *
@@ -130,11 +135,12 @@ interface PreEngineeredVariant {
      * {@link ships/blueprint-costs!getBlueprintCost | getBlueprintCost}.
      */
     readonly mercCoinCost?: number;
+    /** The fixed damage-type shares the variant arrives with. */
+    readonly damageDistribution?: DamageDistribution;
     /**
      * The hand-set stat block the variant arrives with, sorted by `label`.
      *
-     * Absent on every `mercenary` row: no registry publishes the grade-1 pre-engineering
-     * those arrive with. Present on all community-goal, tech-broker and event-reward rows.
+     * Every catalogued variant carries this block.
      */
     readonly modifiers?: readonly PreEngineeredModifier[];
 }

package/dist/ships/pre-engineered.js

@@ -1 +1 @@
-export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-AUBV6S7V.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map
+export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-EXHZ4CFB.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map

package/dist/ships/shields.d.ts

@@ -54,7 +54,10 @@ import { DamageResistances, DamageTypeValues, DamageResistanceParams } from './r
  * An {@link OutfittingModule} record satisfies this as-is, so a catalogue entry can be
  * passed straight in — the six curve fields and the resistances are exactly what a
  * generator's record carries. `optMultiplier` is what a Reinforced/Thermic blueprint
- * moves. Every field is optional because the type accepts those records; a generator
+ * moves, and `optMass` what Enhanced Low Power moves. A recipe names those two alone and
+ * the four endpoints follow them, so pass the whole moved curve rather than a moved
+ * optimum on stock endpoints. `FittedModule.effectiveStats` carries it already.
+ * Every field is optional because the type accepts those records; a generator
  * **missing** any of the six curve fields cannot be placed on the curve at all, and
  * raises no shield ({@link shieldMassCurveMultiplier} returns `0`).
  *

package/dist/ships/shields.js

@@ -1 +1 @@
-export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-5VWACBTN.js";                                                                                       //# sourceMappingURL=shields.js.map
+export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-DBJKLXLS.js";                                                                                       //# sourceMappingURL=shields.js.map