@elite-dangerous-almanac/core 0.1.8 → 0.2.1

package/dist/ships/build-metrics.js

@@ -0,0 +1 @@
+export{BuildMetrics}from"../chunk-6S36AVA4.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            //# sourceMappingURL=build-metrics.js.map

package/dist/ships/build-metrics.js.map

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

package/dist/ships/distributor.d.ts

@@ -5,8 +5,8 @@
  * and WEP use the same non-linear allocation curve:
  * `ratedRecharge * (pips / 4) ^ 1.1`.
  *
- * This module is data-free. {@link ShipLoadout.distributorMetrics}
- * (`./ship-loadout`) resolves the powered distributor in a build for you.
+ * This module is data-free. {@link BuildMetrics.distributorMetrics}
+ * (`./build-metrics`) resolves the powered distributor in a build for you.
  *
  * @remarks
  * The SYS and WEP curves follow EDCD/Coriolis; the ENG curve is cross-checked
@@ -54,7 +54,14 @@ interface DistributorPips {
     /** Pips assigned to WEP, in `[0, 4]`. */
     readonly weapons: number;
 }
-/** All three capacitor figures for one power distributor and pip allocation. */
+/**
+ * All three capacitor figures for one power distributor and pip allocation.
+ *
+ * @remarks
+ * Frozen — nested records and lists included — so a result can be held, cached and
+ * shared without a defensive copy. Derive a changed figure with a spread rather than
+ * by assigning into one.
+ */
 interface DistributorMetrics {
     /** SYS-capacitor capacity and recharge. */
     readonly systems: DistributorCapacitorMetrics;

package/dist/ships/distributor.js

@@ -1 +1 @@
-export{distributorMetrics}from"../chunk-P2QOL63K.js";                             //# sourceMappingURL=distributor.js.map
+export{distributorMetrics}from"../chunk-M2TCZKRT.js";                                                          //# sourceMappingURL=distributor.js.map

package/dist/ships/engineering-options.d.ts

@@ -114,6 +114,7 @@ declare const ENGINEERING_OPTION_GROUPS: Readonly<Record<EngineeringGroupId, Eng
  * Accelerator, which upstream denies every blueprint.
  *
  * @param symbol - A module symbol, e.g. `"Hpt_BeamLaser_Fixed_Small"`.
+ * Leading/trailing whitespace and case are ignored.
  * @returns The group id, or `null` when the module is not in the catalogue.
  *
  * @throws {TypeError} If `symbol` is present and not a string. A nullish
@@ -156,7 +157,7 @@ declare function getEngineeringGroup(symbol: string): EngineeringGroupId | null;
  * Guardian weapons as well as modules — every group here lists that id, and `BLUEPRINTS`
  * keys the recipe under it alone.
  *
- * @param symbol - A module symbol.
+ * @param symbol - A module symbol. Leading/trailing whitespace and case are ignored.
  * @returns Blueprint ids, sorted. Join to `BLUEPRINTS`.
  *
  * @throws {TypeError} If `symbol` is present and not a string. A nullish
@@ -188,7 +189,7 @@ declare function getBlueprintsForModule(symbol: string): readonly string[];
  * and every Guardian group, weapons and modules alike. An ungrouped module answers empty
  * too; {@link getEngineeringGroup} tells the two apart.
  *
- * @param symbol - A module symbol.
+ * @param symbol - A module symbol. Leading/trailing whitespace and case are ignored.
  * @returns Experimental-effect ids. Join to `EXPERIMENTAL_EFFECTS`.
  *
  * @throws {TypeError} If `symbol` is present and not a string. A nullish
@@ -229,12 +230,13 @@ declare function getExperimentalsForModule(symbol: string): readonly string[];
  * that is the exact answer rather
  * than a miss: it has no experimental slot, on any of the nine groups that offer it.
  *
- * @param fdname - A blueprint recipe `fdname`, e.g. `"Weapon_Efficient"`.
+ * @param blueprintSymbol - A blueprint recipe's Frontier symbol, e.g. `"Weapon_Efficient"`.
+ * Leading/trailing whitespace and case are ignored.
  * @returns Experimental-effect ids, sorted and de-duplicated; empty when no group names
  * the blueprint, or when its groups take no experimental.
  *
- * @throws {TypeError} If `fdname` is present and not a string. A nullish
- * `fdname` is a miss, answered the way an unrecognised one is.
+ * @throws {TypeError} If `blueprintSymbol` is present and not a string. A nullish
+ * `blueprintSymbol` is a miss, answered the way an unrecognised one is.
  * @example
  * ```ts
  * import { getExperimentalsForBlueprint } from '@elite-dangerous-almanac/core/ships/engineering-options';
@@ -243,6 +245,6 @@ declare function getExperimentalsForModule(symbol: string): readonly string[];
  * // -> ['special_fsd_cooled', 'special_fsd_fuelcapacity', 'special_fsd_heavy', ...]
  * ```
  */
-declare function getExperimentalsForBlueprint(fdname: string): readonly string[];
+declare function getExperimentalsForBlueprint(blueprintSymbol: string): readonly string[];
 
 export { ENGINEERING_OPTION_GROUPS, type EngineeringGroupId, type EngineeringOptionGroup, getBlueprintsForModule, getEngineeringGroup, getExperimentalsForBlueprint, getExperimentalsForModule };

package/dist/ships/engineering-options.js

@@ -1 +1 @@
-export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-QTZPA2FR.js";                                                                                       //# sourceMappingURL=engineering-options.js.map
+export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-GLWPSVFV.js";                                                                                       //# sourceMappingURL=engineering-options.js.map

package/dist/ships/engineering.d.ts

@@ -156,7 +156,7 @@ type BlueprintGrades = Readonly<Record<string, BlueprintGrade>>;
  * One engineering blueprint — its in-game display name and its per-grade data.
  *
  * @remarks
- * A blueprint is keyed in {@link BLUEPRINTS} by its Frontier `fdname`; this is the record
+ * A blueprint is keyed in {@link BLUEPRINTS} by its Frontier symbol; this is the record
  * that key maps to. Each member of `grades` carries modifier `features` and an optional
  * converted damage distribution (a blueprint need not define every grade `1`–`5`). A
  * journal id shared by two recipes is resolved against the fitted module by
@@ -194,20 +194,6 @@ interface Blueprint {
  * @throws {RangeError} If `quality` is not a finite number in `[0, 1]`.
  */
 declare function computeModifiers(base: Readonly<Record<string, number>>, grade: BlueprintGrade | readonly BlueprintFeature[], quality?: number, experimental?: ExperimentalEffect | readonly ExperimentalContribution[]): EngineeringModifier[];
-/**
- * The number of engineering rolls to complete a single blueprint grade: grade `N` takes
- * `N` rolls (grade 1 → 1 roll, grade 2 → 2 rolls, … grade 5 → 5 rolls). Each roll at a
- * grade consumes that grade's cost, so the total to engineer a module *up to* a
- * grade is the running sum of `rollsForGrade(g) ·` (grade `g`'s cost) for every
- * grade `g` up to the target — what
- * {@link ships/blueprint-costs!getBlueprintCost | getBlueprintCost} computes, for the
- * materials and the Merc Coin alike.
- *
- * @param grade - The blueprint grade, `1`–`5`.
- * @returns The rolls to complete that grade (equal to the grade number).
- * @throws {RangeError} If `grade` is not an integer from 1 through 5.
- */
-declare function rollsForGrade(grade: number): number;
 /**
  * Combine several material lists into one, summing the counts of any material that
  * appears in more than one list (matched by `symbol`, case-insensitively). Use it to
@@ -231,4 +217,4 @@ declare function rollsForGrade(grade: number): number;
  */
 declare function sumMaterials(...lists: readonly (readonly EngineeringMaterial[])[]): EngineeringMaterial[];
 
-export { type Blueprint, type BlueprintFeature, type BlueprintGrade, type BlueprintGrades, type EngineeringMaterial, type ExperimentalContribution, type ExperimentalEffect, type ModifierMethod, computeModifiers, rollsForGrade, sumMaterials };
+export { type Blueprint, type BlueprintFeature, type BlueprintGrade, type BlueprintGrades, type EngineeringMaterial, type ExperimentalContribution, type ExperimentalEffect, type ModifierMethod, computeModifiers, sumMaterials };

package/dist/ships/engineering.js

@@ -1 +1 @@
-export{computeModifiers,rollsForGrade,sumMaterials}from"../chunk-DYPOL3CI.js";//# sourceMappingURL=engineering.js.map
+export{computeModifiers,sumMaterials}from"../chunk-CJQ37JII.js";//# sourceMappingURL=engineering.js.map

package/dist/ships/experimental-effect-costs.d.ts

@@ -20,7 +20,7 @@ import './slots.js';
  */
 
 /**
- * Every experimental effect's one-application material list, keyed by Frontier `fdname`.
+ * Every experimental effect's one-application material list, keyed by Frontier symbol.
  *
  * @remarks
  * Its ids exactly match `EXPERIMENTAL_EFFECTS` from `ships/experimental-effects`. The
@@ -44,11 +44,11 @@ declare const EXPERIMENTAL_EFFECT_COSTS: Readonly<Record<string, readonly Engine
  * 25 blueprints whose {@link ships/blueprint-costs!getBlueprintCost | getBlueprintCost}
  * reports a non-zero `mercCoins`.
  *
- * @param fdname - The effect id, e.g. `"special_fsd_heavy"`, matched
+ * @param experimentalEffectSymbol - The effect id, e.g. `"special_fsd_heavy"`, matched
  * case-insensitively after trimming surrounding whitespace.
  * @returns The frozen material list, or `null` if the effect is unknown.
- * @throws {TypeError} If `fdname` is present and not a string. A nullish
- * `fdname` is a miss, answered the way an unrecognised one is.
+ * @throws {TypeError} If `experimentalEffectSymbol` is present and not a string. A nullish
+ * `experimentalEffectSymbol` is a miss, answered the way an unrecognised one is.
  * @example
  * ```ts
  * import { getExperimentalEffectCost } from '@elite-dangerous-almanac/core/ships/experimental-effect-costs';
@@ -57,6 +57,6 @@ declare const EXPERIMENTAL_EFFECT_COSTS: Readonly<Record<string, readonly Engine
  * // -> [{ symbol: 'DisruptedWakeEchoes', ... }, ...]
  * ```
  */
-declare function getExperimentalEffectCost(fdname: string): readonly EngineeringMaterial[] | null;
+declare function getExperimentalEffectCost(experimentalEffectSymbol: string): readonly EngineeringMaterial[] | null;
 
 export { EXPERIMENTAL_EFFECT_COSTS, getExperimentalEffectCost };

package/dist/ships/experimental-effect-costs.js

@@ -1 +1 @@
-export{EXPERIMENTAL_EFFECT_COSTS,getExperimentalEffectCost}from"../chunk-SNADUQSJ.js";                                                                                       //# sourceMappingURL=experimental-effect-costs.js.map
+export{EXPERIMENTAL_EFFECT_COSTS,getExperimentalEffectCost}from"../chunk-CJK2IBI2.js";                                                                                       //# sourceMappingURL=experimental-effect-costs.js.map

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

@@ -7,7 +7,7 @@ import './slots.js';
 
 /**
  * The **experimental-effect mechanics catalogue** — each engineering special effect's
- * stat modifiers and qualitative behavior, keyed by the effect's Frontier `fdname` (as it
+ * stat modifiers and qualitative behavior, keyed by the effect's Frontier symbol (as it
  * appears in a journal `Loadout` event's `Engineering.ExperimentalEffect`).
  *
  * Its own module (and data file) so consumers who never engineer a build do not bundle
@@ -18,7 +18,7 @@ import './slots.js';
  * `ships/experimental-effect-costs`, so applying an effect does not bundle what it costs —
  * though `ShipLoadout` carries both, since it prices a build as well as engineering one.
  *
- * Keys are Frontier `fdname`s — the exact strings a journal `Loadout` event carries in
+ * Keys are Frontier symbols — the exact strings a journal `Loadout` event carries in
  * `Engineering.ExperimentalEffect` (e.g. `"special_fsd_heavy"`), not the in-game
  * display names. Enumerate the available effects with `Object.keys(EXPERIMENTAL_EFFECTS)`.
  *
@@ -29,7 +29,7 @@ import './slots.js';
  */
 
 /**
- * Every experimental effect, keyed by Frontier `fdname` (e.g. `"special_fsd_heavy"`).
+ * Every experimental effect, keyed by Frontier symbol (e.g. `"special_fsd_heavy"`).
  * Each carries its `modifiers` (stat contributions), optional damage conversion, and
  * optional qualitative description.
  *
@@ -43,13 +43,14 @@ import './slots.js';
  */
 declare const EXPERIMENTAL_EFFECTS: Readonly<Record<string, ExperimentalEffect>>;
 /**
- * Look up an experimental effect by its Frontier `fdname`, case-insensitively.
+ * Look up an experimental effect by its Frontier symbol, case-insensitively.
  *
- * @param fdname - The effect id, e.g. `"special_fsd_heavy"`.
+ * @param experimentalEffectSymbol - The effect id, e.g. `"special_fsd_heavy"`. Leading/trailing
+ * whitespace and case are ignored.
  * @returns The effect record — its display `name`, modifier contributions, optional
  * `damageDistribution`, and optional qualitative description — or `null` if unknown.
- * @throws {TypeError} If `fdname` is present and not a string. A nullish
- * `fdname` is a miss, answered the way an unrecognised one is.
+ * @throws {TypeError} If `experimentalEffectSymbol` is present and not a string. A nullish
+ * `experimentalEffectSymbol` is a miss, answered the way an unrecognised one is.
  * @example
  * ```ts
  * import { getExperimentalEffect } from '@elite-dangerous-almanac/core/ships/experimental-effects';
@@ -59,6 +60,6 @@ declare const EXPERIMENTAL_EFFECTS: Readonly<Record<string, ExperimentalEffect>>
  * effect?.modifiers; // -> [{ label: 'Integrity', ... }, ...]
  * ```
  */
-declare function getExperimentalEffect(fdname: string): ExperimentalEffect | null;
+declare function getExperimentalEffect(experimentalEffectSymbol: string): ExperimentalEffect | null;
 
 export { EXPERIMENTAL_EFFECTS, getExperimentalEffect };

package/dist/ships/experimental-effects.js

@@ -1 +1 @@
-export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-JPBMRJFC.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map
+export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-77I24V6B.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map

package/dist/ships/heat.d.ts

@@ -21,8 +21,8 @@
  * else: it is thermal inertia, not a budget.
  *
  * This module is data-free — hand {@link heatMetrics} a hull's two heat stats, the
- * plant's efficiency and the build's draw. {@link ShipLoadout.heatMetrics} (in
- * `./ship-loadout`) reads all of that off a build, post-engineering, for you.
+ * plant's efficiency and the build's draw. {@link BuildMetrics.heatMetrics} (in
+ * `./build-metrics`) reads all of that off a build, post-engineering, for you.
  *
  * Two heat sources stand outside the scenarios reported here, both of them momentary
  * rather than sustained, and they are not interchangeable with the figures above:
@@ -194,6 +194,11 @@ interface HeatState {
 /**
  * A build's heat: what the plant and the hull make of each other, and what the build
  * runs at stowed, flying, jumping and firing.
+ *
+ * @remarks
+ * Frozen — nested records and lists included — so a result can be held, cached and
+ * shared without a defensive copy. Derive a changed figure with a spread rather than
+ * by assigning into one.
  */
 interface HeatMetrics {
     /** The fitted plant's heat efficiency, post-engineering. */

package/dist/ships/heat.js

@@ -1 +1 @@
-export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-W6EPHHTS.js";//# sourceMappingURL=heat.js.map
+export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-6HA2YIKW.js";                             //# sourceMappingURL=heat.js.map

package/dist/ships/index.d.ts

@@ -9,13 +9,15 @@
  * export ({@link ShipLoadout.fromSlef}) or a journal `Loadout` event
  * ({@link ShipLoadout.fromLoadout}), writes either back out
  * ({@link ShipLoadout.toSlefString}, {@link ShipLoadout.toLoadoutEvent}), fits modules
- * and applies engineering, and answers the questions apps actually ask
- * ({@link ShipLoadout.maxJumpRange}, {@link ShipLoadout.powerBudget},
- * {@link ShipLoadout.shieldMetrics}, `unladenMass`, `rebuy`) — keeping what a capture
- * said it *paid* apart from what the build is worth at retail
- * ({@link ShipLoadout.sourcePurchase}). It is the batteries-included facade and pulls in
- * every catalogue; everything below is what it is built from, so drop to the pieces when
- * you need one answer rather than a whole ship.
+ * and applies engineering, and carries the figures a capture stated (`unladenMass`,
+ * `rebuy`) — keeping what a capture said it *paid* apart from what the build is worth at
+ * retail ({@link ShipLoadout.sourcePurchase}). **{@link BuildMetrics} is the other
+ * half**: `BuildMetrics.of(build)` answers the questions apps actually ask
+ * ({@link BuildMetrics.maxJumpRange}, {@link BuildMetrics.powerBudget},
+ * {@link BuildMetrics.shieldMetrics}), so an editor need not import the calculations nor
+ * a viewer the editors. Together they are the batteries-included facade and pull in
+ * every catalogue; everything below is what they are built from, so drop to the pieces
+ * when you need one answer rather than a whole ship.
  *
  * The area has five layers:
  *
@@ -45,8 +47,11 @@
  *   data-free module: {@link powerBudget}, {@link shieldMetrics} and
  *   {@link armourMetrics} (with {@link stackShieldResistance} /
  *   {@link stackArmourResistance} behind their resistances), {@link weaponMetrics},
- *   {@link distributorMetrics}, {@link weaponsCapacitorMetrics},
- *   {@link ammunitionCapacity} and {@link heatMetrics}.
+ *   {@link mobilityMetrics}, {@link shieldRecovery}, {@link distributorMetrics},
+ *   {@link ammunitionCapacity} and {@link heatMetrics}. A pip allocation is always a
+ *   separate call over the bare figure, one entry point per capacitor:
+ *   {@link shieldCapacitorMetrics} for SYS, {@link mobilityCapacitorMetrics} for ENG
+ *   and {@link weaponsCapacitorMetrics} for WEP.
  * - **Engineering** — {@link computeModifiers} applies the primitive legs of a
  *   {@link BLUEPRINTS} recipe and an {@link EXPERIMENTAL_EFFECTS} entry;
  *   {@link ShipLoadout.applyBlueprint} presents that result under Frontier's journal
@@ -57,16 +62,18 @@
  *   {@link ships/blueprint-costs!BLUEPRINT_COSTS | blueprint-costs} and
  *   {@link ships/experimental-effect-costs!EXPERIMENTAL_EFFECT_COSTS | experimental-effect-costs}
  *   subpaths, so a consumer can price one recipe without the mechanics — and the facade
- *   carries them, since {@link ShipLoadout.buildCost} prices a whole build. A blueprint
+ *   carries them, since {@link BuildMetrics.buildCost} prices a whole build. A blueprint
  *   cost carries both halves of what a climb takes: the materials and the Merc Coin 25 of
  *   the recipes charge beside them.
  *
  * The registries use two distinct Frontier identity spaces. `symbol` identifies an
  * item — a hull, module, material, micro-resource or commodity — and is what item and
- * journal `Item` lookups accept. Engineering catalogues instead use `fdname` to identify
- * a recipe, effect or fixed variant, which is what the journal writes in
- * `Engineering.BlueprintName` and `Engineering.ExperimentalEffect`; the few colliding
- * blueprint aliases are resolved for their module by {@link resolveBlueprintForModule}.
+ * journal `Item` lookups accept. Engineering catalogues carry ids of their own:
+ * `blueprintSymbol` names a recipe, a fixed variant's identity included, and
+ * `experimentalEffectSymbol` names an effect. Those two are what the journal writes in
+ * `Engineering.BlueprintName` and `Engineering.ExperimentalEffect` respectively; the few
+ * colliding blueprint aliases are resolved for their module by
+ * {@link resolveBlueprintForModule}.
  * Pre-engineered variants are found from the base module's `symbol` with
  * {@link getPreEngineeredVariants}.
  *
@@ -89,17 +96,18 @@
  * pulls in every catalogue.
  *
  * ```ts
+ * import { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
  * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
  * import type { LoadoutEvent } from '@elite-dangerous-almanac/core/ships/slef';
  *
  * declare const event: LoadoutEvent;
  *
  * // Figures below are one build's — a Krait Phantom explorer.
- * const build = ShipLoadout.fromLoadout(event);
- * build.maxJumpRange(); // -> 60.5478  (ly)
- * build.powerBudget().withinBudget; // -> true
- * build.shieldMetrics()?.strength; // -> 743.12   (MJ)
- * build.weaponMetrics().total.damagePerSecond; // -> 34
+ * const metrics = BuildMetrics.of(ShipLoadout.fromLoadout(event));
+ * metrics.maxJumpRange(); // -> 60.5478  (ly)
+ * metrics.powerBudget().withinBudget; // -> true
+ * metrics.shieldMetrics()?.strength; // -> 743.12   (MJ)
+ * metrics.weaponMetrics().total.damagePerSecond; // -> 34
  * ```
  *
  * @example
@@ -122,7 +130,8 @@
  * @example
  * **The data-free layer.** Each calculation is its own module over plain constants, so
  * it costs nothing but the function — no catalogue, no build. `./power`, `./shields`,
- * `./armour`, `./weapons`, `./ammunition` and `./resistances` are the same shape.
+ * `./shield-capacitor`, `./armour`, `./weapons`, `./weapons-capacitor`, `./mobility`,
+ * `./mobility-capacitor`, `./ammunition` and `./resistances` are the same shape.
  *
  * ```ts
  * import { singleJumpRange } from '@elite-dangerous-almanac/core/ships/jump-range';
@@ -146,14 +155,17 @@ export { FrameShiftDriveJumpStats, MassCurveStats, PowerDistributorStats, PowerG
 export { OUTFITTING_FAMILIES, OutfittingFamilyId } from './module-families.js';
 export { BlueprintModuleEngineering, EngineeringModifier, LoadoutEvent, LoadoutModule, ModuleEngineering, Slef, SlefConstraint, SlefDiagnostic, SlefDiagnosticCode, SlefEntry, SlefHeader, SlefInspection, SlefStringifyOptions, getLoadoutModifier, inspectSlef, parseSlef, stringifySlef, toSlef } from './slef.js';
 export { FrameShiftDriveParams, TotalRangeDetails, frameShiftDriveMassFactor, fuelPerJump, singleJumpRange, totalRange } from './jump-range.js';
-export { ApplyBlueprintOptions, AvailableBlueprint, BuildCost, BuildCredits, BuildMass, BuildWeaponMetrics, DefenceOptions, DistributorOptions, EngineeringNormalizationCode, EngineeringNormalizationResult, EngineeringNormalizationUnchanged, EngineeringNormalizationUnsupported, EngineeringNormalized, ExperimentalEffectMutationCode, ExperimentalEffectMutationResult, ExperimentalEffectUnchanged, ExperimentalEffectUnsupported, ExperimentalEffectUpdated, FittedModule, FittedWeaponMetrics, FixedMountRepairResult, ImmovableReason, JumpOptions, JumpRangeSummary, LoadoutEditError, LoadoutEditErrorCode, LoadoutExportOptions, LoadoutImportOutcome, LoadoutSlot, MobilityOptions, ShipLoadout, SlefExportOptions, StandardLoad, StandardLoadInputs, WeaponsOptions } from './ship-loadout.js';
+export { ApplyBlueprintOptions, AvailableBlueprint, EngineeringNormalizationCode, EngineeringNormalizationResult, EngineeringNormalizationUnchanged, EngineeringNormalizationUnsupported, EngineeringNormalized, ExperimentalEffectMutationCode, ExperimentalEffectMutationResult, ExperimentalEffectUnchanged, ExperimentalEffectUnsupported, ExperimentalEffectUpdated, FittedModule, FixedMountRepairResult, ImmovableReason, LoadoutEditError, LoadoutEditErrorCode, LoadoutExportOptions, LoadoutImportOutcome, LoadoutSlot, ShipLoadout, SlefExportOptions } from './ship-loadout.js';
+export { BuildCost, BuildCredits, BuildMass, BuildMetrics, BuildWeaponMetrics, DistributorOptions, FittedWeaponMetrics, JumpOptions, JumpRangeSummary, MobilityCapacitorOptions, ShieldCapacitorOptions, ShieldRecoveryOptions, StandardLoad, StandardLoadInputs, WeaponsOptions } from './build-metrics.js';
 export { CalculationIssue, CalculationIssueReason, CalculationResult, FuelCapacity, LoadoutCalculationModule, calculateCargoCapacity, calculateFuelCapacity, calculateUnladenMass } from './loadout-calculations.js';
-export { LoadoutIssue, LoadoutIssueCode, LoadoutIssueParam, LoadoutIssueParams, LoadoutValidation, LoadoutValidationInput, ModuleFitConstraint, ValidationModule, validateLoadout } from './loadout-validation.js';
+export { LoadoutIssue, LoadoutIssueCode, LoadoutIssueParam, LoadoutIssueParams, LoadoutMass, LoadoutValidation, LoadoutValidationInput, ModuleFitConstraint, ThrusterLoad, ValidationModule, validateLoadout } from './loadout-validation.js';
 export { SourceModuleValue, SourcePurchaseRecord, getSourceModuleValue, sourcePurchaseFromLoadout, sumSourceModuleValues } from './source-purchase.js';
 export { PowerBand, PowerBudget, PowerConsumer, PowerConsumerResult, powerBudget } from './power.js';
 export { DamageResistanceParams, DamageResistances, DamageType, DamageTypeValues, effectiveHitPoints, mapDamageTypes, stackArmourResistance, stackShieldResistance, systemsResistance } from './resistances.js';
 export { ShieldBoosterParams, ShieldGeneratorParams, ShieldInput, ShieldMetrics, shieldMassCurveMultiplier, shieldMetrics, shieldStrength } from './shields.js';
+export { ShieldCapacitorInput, ShieldCapacitorMetrics, shieldCapacitorMetrics } from './shield-capacitor.js';
 export { MobilityInput, MobilityMetrics, ThrusterCurveParams, ThrusterParams, mobilityMetrics, thrusterMassCurveMultiplier } from './mobility.js';
+export { MobilityCapacitorInput, MobilityCapacitorMetrics, mobilityCapacitorMetrics } from './mobility-capacitor.js';
 export { CellBankInput, CellBankMetrics, CellBankSummary, ShieldRecovery, ShieldRecoveryInput, cellBankSummary, shieldRecovery } from './shield-recovery.js';
 export { ArmourInput, ArmourMetrics, BulkheadParams, HullReinforcementParams, ModuleReinforcementParams, armourMetrics } from './armour.js';
 export { DamageSplit, WeaponMetrics, WeaponStats, WeaponTotals, armourPiercingFactor, combinedRateOfFire, damageFalloff, damagePerSecond, energyPerSecond, heatPerSecond, splitDamage, sumWeaponMetrics, sustainedDamagePerSecond, sustainedFireFactor, weaponMetrics } from './weapons.js';
@@ -162,7 +174,7 @@ export { WeaponsCapacitorInput, WeaponsCapacitorMetrics, weaponsCapacitorMetrics
 export { AmmunitionCapacity, AmmunitionStats, ammunitionCapacity } from './ammunition.js';
 export { HeatInput, HeatMetrics, HeatState, HeatWeapon, OVERHEAT_HEAT_LEVEL, effectiveWeaponThermalLoad, equilibriumHeatLevel, heatLevelAtTime, heatMetrics, secondsToHeatLevel } from './heat.js';
 export { BuildSlot, BuildSlotBase, CoreBuildSlot, CoreSlotType, CoreSlots, HardpointBuildSlot, HardpointRestriction, HardpointSlotSpec, ModuleSlot, OptionalBuildSlot, OptionalRestriction, OptionalSlotSpec, ParsedSlot, SLOT_RESTRICTION_LABELS, ShipSlots, SimpleBuildSlot, SlotKind, SlotRestriction, enumerateSlots, parseSlotName } from './slots.js';
-export { Blueprint, BlueprintFeature, BlueprintGrade, BlueprintGrades, EngineeringMaterial, ExperimentalContribution, ExperimentalEffect, ModifierMethod, computeModifiers, rollsForGrade, sumMaterials } from './engineering.js';
+export { Blueprint, BlueprintFeature, BlueprintGrade, BlueprintGrades, EngineeringMaterial, ExperimentalContribution, ExperimentalEffect, ModifierMethod, computeModifiers, sumMaterials } from './engineering.js';
 export { BLUEPRINTS, getBlueprint, getBlueprintGrade } from './blueprints.js';
 export { EXPERIMENTAL_EFFECTS, getExperimentalEffect } from './experimental-effects.js';
 export { ENGINEERING_OPTION_GROUPS, EngineeringGroupId, EngineeringOptionGroup, getBlueprintsForModule, getEngineeringGroup, getExperimentalsForBlueprint, getExperimentalsForModule } from './engineering-options.js';

package/dist/ships/index.js

@@ -1 +1 @@
-export{LoadoutEditError,ShipLoadout}from"../chunk-3BM5BHI3.js";export{weaponsCapacitorMetrics}from"../chunk-FMPRCYKY.js";export{cellBankSummary,shieldRecovery}from"../chunk-VZZUNSDF.js";export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-2FHHMYDC.js";export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-WNGQ3IAM.js";export{getLoadoutModifier,inspectSlef,parseSlef,stringifySlef,toSlef}from"../chunk-OVUHQEH5.js";export{getSourceModuleValue,sourcePurchaseFromLoadout,sumSourceModuleValues}from"../chunk-IYU4WLFM.js";export{powerBudget}from"../chunk-RLUS76LZ.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-6BO5JJNI.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-LJI7VXJD.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-PA5EITW5.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-2VPVZELZ.js";export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-GQ5GX5TB.js";export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-AFVYCQWL.js";export{validateLoadout}from"../chunk-B4ZSTOM4.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-CX7B67OI.js";export{hasFrameShiftDriveJumpStats,hasMassCurveStats,hasPowerDistributorStats,hasPowerGenerationStats,hasShieldRegenerationStats,hasWeaponDamageStats}from"../chunk-JTQVWIGL.js";export{OUTFITTING_FAMILIES}from"../chunk-M6G3UDTX.js";export{SHIP_MODULE_LIMITS,calculateModuleLimits}from"../chunk-KPETDYQX.js";                                                                                                                                                                              export{distributorMetrics}from"../chunk-P2QOL63K.js";                                                          export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-JPBMRJFC.js";export{SHIP_GUNSIGHTS,getShipGunsight,projectGunsight}from"../chunk-DBGXZF7O.js";export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-W6EPHHTS.js";export{ammunitionCapacity}from"../chunk-AA3K5XUE.js";export{armourMetrics}from"../chunk-FGXWVFN6.js";export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance}from"../chunk-ZNCXENNB.js";                             export{computeModifiers,rollsForGrade,sumMaterials}from"../chunk-DYPOL3CI.js";export{resolveBlueprintForModule}from"../chunk-2TW4ZBI3.js";export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-QTZPA2FR.js";export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-Q3QCLNVG.js";                                                          export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map
+export{LoadoutEditError,ShipLoadout}from"../chunk-SG6YLUQ4.js";export{validateLoadout}from"../chunk-OJC6AUL7.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-DBGXZF7O.js";export{BuildMetrics}from"../chunk-6S36AVA4.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{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-JET673E5.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-37JIMWLK.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-PL75RTA2.js";export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-5VWACBTN.js";export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-6UNAD74Z.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-HUYYGTRM.js";                                                                                                                                                                              export{powerBudget}from"../chunk-GGQMIQPC.js";export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-VTMCSCXV.js";export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-DCB4COCL.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-CJQ37JII.js";export{resolveBlueprintForModule}from"../chunk-OLKNYGGT.js";export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-GLWPSVFV.js";export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-AYAKU4YA.js";                             export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map

package/dist/ships/jump-range.d.ts

@@ -3,7 +3,7 @@
  * the ship-build maths.
  *
  * These are the pure functions; they take the drive's constants and the ship's
- * mass and hand back light-years and tonnes. {@link ShipLoadout} (`./ship-loadout`)
+ * mass and hand back light-years and tonnes. {@link BuildMetrics} (`./build-metrics`)
  * is the convenient front end that pulls the constants out of a SLEF build for you.
  *
  * The model is the community-standard one used by EDSY and Coriolis, itself derived
@@ -43,7 +43,14 @@ interface FrameShiftDriveParams {
      */
     readonly jumpBoost?: number;
 }
-/** A multi-jump tank-range result and the number of jumps that produce it. */
+/**
+ * A multi-jump tank-range result and the number of jumps that produce it.
+ *
+ * @remarks
+ * Frozen — nested records and lists included — so a result can be held, cached and
+ * shared without a defensive copy. Derive a changed figure with a spread rather than
+ * by assigning into one.
+ */
 interface TotalRangeDetails {
     /** Sum of the successive jumps as the tank drains, in light-years. */
     readonly range: number;
@@ -89,7 +96,7 @@ declare function frameShiftDriveMassFactor(mass: number, fuel: number, fsd: Pick
  * drive cannot jump (`maxFuel` or `fuel` = 0).
  * @remarks
  * Lighter ships and larger `optMass` jump farther; carrying more fuel than one jump
- * needs only weighs you down, which is why {@link ShipLoadout.maxJumpRange} loads
+ * needs only weighs you down, which is why {@link BuildMetrics.maxJumpRange} loads
  * exactly one jump's worth.
  * @throws {RangeError} If a quantity is negative or non-finite, or a required drive
  * constant is not positive.

package/dist/ships/jump-range.js

@@ -1 +1 @@
-export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-GQ5GX5TB.js";//# sourceMappingURL=jump-range.js.map
+export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-VTMCSCXV.js";                             //# sourceMappingURL=jump-range.js.map

package/dist/ships/loadout-calculations.d.ts

@@ -21,7 +21,7 @@ type CalculationIssueReason = 'missing' | 'unresolved' | 'disabled' | 'shed' | '
 /** An input or fitted-module state that prevented a complete build metric. */
 interface CalculationIssue {
     /** Calculation input that is missing or unavailable. */
-    readonly field: 'mass' | 'fuelCapacity' | 'frameShiftDrive' | 'powerCapacity' | 'powerDraw' | 'thrusters' | 'shieldGenerator';
+    readonly field: 'mass' | 'fuelCapacity' | 'frameShiftDrive' | 'powerCapacity' | 'powerDraw' | 'heatEfficiency' | 'thrusters' | 'shieldGenerator' | 'powerDistributor';
     /** Machine-readable unavailable-state discriminator. */
     readonly reason: CalculationIssueReason;
     /** Slot containing the incomplete module, when the dependency belongs to a module. */

package/dist/ships/loadout-calculations.js

@@ -1 +1 @@
-export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-AFVYCQWL.js";//# sourceMappingURL=loadout-calculations.js.map
+export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-DCB4COCL.js";//# sourceMappingURL=loadout-calculations.js.map

package/dist/ships/loadout-validation.d.ts

@@ -18,8 +18,27 @@ import './module-families.js';
  * `ShipLoadout` reports neither: it is keyed by slot and `fromLoadout` throws a
  * `TypeError` on a duplicate, and every build fills its fixed mounts from the hull
  * defaults. Switch on them when you validate your own list; skip them for a build.
+ *
+ * `thrusterMassExceeded` is the one code that reads a figure rather than the structure,
+ * so it is reported only when the input states both a
+ * {@link LoadoutValidationInput.mass} and the fitted thrusters'
+ * {@link ValidationModule.thrusterMaxMass}. A build supplies both.
+ */
+type LoadoutIssueCode = 'duplicateSlot' | 'unknownSlot' | 'missingRequiredSlot' | 'incompatibleModule' | 'duplicateExclusiveModule' | 'moduleLimitExceeded' | 'thrusterMassExceeded';
+/**
+ * A load a thruster rating is read against, lightest first.
+ *
+ * @remarks
+ * `dry` is the fit alone — hull plus modules, an empty tank and no cargo. `unladen`
+ * adds a full main tank, and is the figure the game and every outfitting tool call a
+ * ship's unladen mass; note that {@link ships!ShipLoadout.unladenMass} is the `dry`
+ * figure, because that is what a journal's `UnladenMass` states. `laden` adds a full
+ * hold on top.
+ *
+ * A ship cannot undock without fuel, so failing at `dry` or `unladen` is an error.
+ * Failing only at `laden` is a warning: the hold is the one load a pilot chooses.
  */
-type LoadoutIssueCode = 'duplicateSlot' | 'unknownSlot' | 'missingRequiredSlot' | 'incompatibleModule' | 'duplicateExclusiveModule' | 'moduleLimitExceeded';
+type ThrusterLoad = 'dry' | 'unladen' | 'laden';
 /** Stable machine-readable constraint behind an `incompatibleModule` issue. */
 type ModuleFitConstraint = 'immutableSlot' | 'armourRequired' | 'wrongHullArmour' | 'restrictedHull' | 'restrictedMount' | 'wrongCoreType' | 'hardpointRequired' | 'utilityRequired' | 'optionalInternalRequired' | 'coreModuleInOptionalSlot' | 'oversized' | 'unknownConstraint';
 /**
@@ -34,8 +53,18 @@ type LoadoutIssueParams = Readonly<Record<string, LoadoutIssueParam>>;
 interface LoadoutIssue {
     /** Machine-readable reason. */
     readonly code: LoadoutIssueCode;
-    /** Invalid input is an error; a missing required module makes the build incomplete. */
-    readonly severity: 'error' | 'incomplete';
+    /**
+     * Invalid input is an error; a missing required module makes the build incomplete;
+     * a warning is a build that flies, but not at every load it can carry.
+     *
+     * @remarks
+     * Only `error` clears {@link LoadoutValidation.valid}, and only `error` or
+     * `incomplete` clears {@link LoadoutValidation.complete}. A `warning` is a note
+     * against a legal, fully-mounted build, so it leaves both answers alone. Branch on
+     * {@link code} rather than on this: one severity covers findings that belong in
+     * different places on a panel.
+     */
+    readonly severity: 'error' | 'incomplete' | 'warning';
     /** Slot involved, in the build's own spelling when possible. */
     readonly slot?: string;
     /** Module symbol involved, when any. */
@@ -77,6 +106,18 @@ interface ValidationModule {
     readonly limitGroup?: ModuleLimitGroup;
     /** Per-ship count allowance increase this resolved module grants, when any. */
     readonly limitIncrease?: ModuleLimitIncrease;
+    /**
+     * The mass this module can still move, in tonnes — a thruster's post-engineering
+     * `maxMass`, and the top of its mass curve.
+     *
+     * @remarks
+     * Present only on the fitted thrusters, and only where their record carries the
+     * figure. Above it the curve contributes nothing and the ship does not move, which
+     * is what {@link LoadoutValidationInput.mass} is weighed against. Leave it off every
+     * other module: a shield generator's curve has a `maxMass` of its own and is not a
+     * limit on the build's mass.
+     */
+    readonly thrusterMaxMass?: number;
 }
 /** Input to {@link validateLoadout}. */
 interface LoadoutValidationInput {
@@ -86,12 +127,57 @@ interface LoadoutValidationInput {
     readonly slots: readonly BuildSlot[];
     /** Fitted modules. Duplicate keys must be retained here so they can be diagnosed. */
     readonly modules: readonly ValidationModule[];
+    /**
+     * What the assembled ship weighs, for the one rule that reads a figure: thrusters
+     * rated below the ship's mass cannot move it.
+     *
+     * Omit it to check structure alone.
+     */
+    readonly mass?: LoadoutMass;
+}
+/**
+ * What a build weighs at each load a thruster rating is read against, in tonnes.
+ *
+ * @remarks
+ * State as much as the build knows. {@link fuel} and {@link cargo} are *capacities*,
+ * not a chosen load: the rule weighs a full tank and a full hold, because those are the
+ * heaviest the build can become without being re-fitted. Leave one off and the loads
+ * above it simply go unchecked.
+ */
+interface LoadoutMass {
+    /**
+     * Hull plus every fitted module, an empty tank and no cargo — a build's
+     * {@link ships!ShipLoadout.unladenMass | unladenMass}.
+     *
+     * @remarks
+     * Despite that name this is the *dry* figure: a journal's `UnladenMass` excludes
+     * fuel, while the game's own "unladen mass" readout includes a full tank. The two
+     * are told apart here as {@link ThrusterLoad}'s `dry` and `unladen`.
+     */
+    readonly dry: number;
+    /** Main-tank capacity. The reserve is not counted, as the flight model does not. */
+    readonly fuel?: number;
+    /** Cargo capacity, as fitted racks allow rather than as any hold currently holds. */
+    readonly cargo?: number;
 }
 /**
  * Validate a resolved fitted build without importing any catalogue.
  *
- * @param input - Hull layout and resolved module classifications.
+ * @param input - Hull layout and resolved module classifications, and optionally what
+ * the assembled ship weighs.
  * @returns Structural validity, operational completeness, and diagnostics.
+ * @remarks
+ * Every rule but one reads the structure alone. The exception is
+ * `thrusterMassExceeded`: state {@link LoadoutValidationInput.mass} and the fitted
+ * thrusters' {@link ValidationModule.thrusterMaxMass}, and a ship too heavy for its own
+ * thrusters is reported, because above that rating the thruster curve contributes
+ * nothing and the ship does not move at all.
+ *
+ * The rating is weighed against each {@link ThrusterLoad} the input can state, and the
+ * lightest load that is already too heavy is the one reported. A ship that cannot move
+ * `dry` or `unladen` is an error — it cannot leave a pad, where the tank is always
+ * full. One that only fails `laden` is a warning, and leaves the build both valid and
+ * complete: the hold is the one load a pilot chooses.
  * @example
  * ```ts
  * import { validateLoadout } from '@elite-dangerous-almanac/core/ships/loadout-validation';
@@ -99,9 +185,29 @@ interface LoadoutValidationInput {
  * const result = validateLoadout({ shipSymbol: 'CustomHull', slots: [], modules: [] });
  * result.valid; // -> true: no impossible fit was claimed
  * result.complete; // -> true: the supplied layout has no required mounts
+ *
+ * const overloaded = validateLoadout({
+ *     shipSymbol: 'CustomHull',
+ *     slots: [],
+ *     mass: { dry: 60.6, fuel: 25 },
+ *     modules: [
+ *         {
+ *             slot: 'MainEngines',
+ *             symbol: 'Int_Engine_Size2_Class1',
+ *             requiresKnownSlot: false,
+ *             fitError: null,
+ *             thrusterMaxMass: 72,
+ *         },
+ *     ],
+ * });
+ * overloaded.valid; // -> false
+ * overloaded.issues[0]?.code; // -> 'thrusterMassExceeded'
+ * overloaded.issues[0]?.params?.load; // -> 'unladen': it is the full tank that sinks it
  * ```
  * @throws {TypeError} If `input.slots` is not an array.
+ * @throws {RangeError} If a figure in `input.mass`, or a module's `thrusterMaxMass`, is
+ * present and is not a finite number of zero or more.
  */
 declare function validateLoadout(input: LoadoutValidationInput): LoadoutValidation;
 
-export { type LoadoutIssue, type LoadoutIssueCode, type LoadoutIssueParam, type LoadoutIssueParams, type LoadoutValidation, type LoadoutValidationInput, type ModuleFitConstraint, type ValidationModule, validateLoadout };
+export { type LoadoutIssue, type LoadoutIssueCode, type LoadoutIssueParam, type LoadoutIssueParams, type LoadoutMass, type LoadoutValidation, type LoadoutValidationInput, type ModuleFitConstraint, type ThrusterLoad, type ValidationModule, validateLoadout };