@elite-dangerous-almanac/core 0.1.8 → 0.2.0

package/dist/ships/build-metrics.js

@@ -0,0 +1 @@
+export{BuildMetrics}from"../chunk-PY5L6WC5.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-YXPZ7QQB.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-Q2L75GSI.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 { 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-OYFMHDYT.js";export{getSourceModuleValue,sourcePurchaseFromLoadout,sumSourceModuleValues}from"../chunk-NIURLW2F.js";export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-6UNAD74Z.js";export{validateLoadout}from"../chunk-B4ZSTOM4.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-PY5L6WC5.js";export{weaponsCapacitorMetrics}from"../chunk-RRYBSAPX.js";export{shieldCapacitorMetrics}from"../chunk-6L56LWTT.js";export{cellBankSummary,shieldRecovery}from"../chunk-4KJ7CR74.js";                             export{getLoadoutModifier,inspectSlef,parseSlef,stringifySlef,toSlef}from"../chunk-OVUHQEH5.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-GZYPQIO2.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-7TQ2X6Q3.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-PL75RTA2.js";export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-QTAMQ6ME.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-PA5EITW5.js";                                                                                                                                                                              export{powerBudget}from"../chunk-D6YEHR5S.js";export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-6O4NRRSB.js";export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-DCB4COCL.js";export{mobilityCapacitorMetrics}from"../chunk-XUHAPOM6.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-Y6KJJMIM.js";                                                          export{distributorMetrics}from"../chunk-YXPZ7QQB.js";                                                          export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-77I24V6B.js";export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-Q2L75GSI.js";export{ammunitionCapacity}from"../chunk-AA3K5XUE.js";export{armourMetrics}from"../chunk-FYVPZBXN.js";export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance}from"../chunk-JGOAQLYW.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-6O4NRRSB.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/mobility-capacitor.d.ts

@@ -0,0 +1,90 @@
+import { MobilityInput, ThrusterParams } from './mobility.js';
+
+/**
+ * **The ENG capacitor** — speed and handling at a chosen ENG-pip allocation.
+ *
+ * A hull publishes two endpoints for each of speed, pitch, roll and yaw: the figure at
+ * **no** ENG pips (`minimumSpeed`, `minPitch`, `minRoll`, `minYaw`) and the figure at
+ * **four** (`maximumSpeed`, `pitch`, `roll`, `yaw`). The allocation interpolates
+ * linearly between them, and the fitted thruster's mass curves are applied to the
+ * result:
+ *
+ * ```text
+ * speed = (minimumSpeed + (maximumSpeed − minimumSpeed) × pips / 4) × speedCurve(mass)
+ * ```
+ *
+ * Boost does **not** move with the pips, so it is not reported here — it is on
+ * {@link MobilityMetrics.boost}, along with the loaded mass and the two curve
+ * multipliers these figures share.
+ *
+ * This module is data-free. {@link BuildMetrics.mobilityCapacitorMetrics} (in
+ * `./build-metrics`) reads the hull, the loaded mass and the powered thrusters out of a
+ * build and calls {@link mobilityCapacitorMetrics} for you.
+ *
+ * @remarks
+ * Reference implementations: EDCD/Coriolis and EDSY; the algorithm is ported as fact,
+ * not code, and credit and licence terms are in
+ * [ATTRIBUTIONS.md](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/ATTRIBUTIONS.md).
+ *
+ * @packageDocumentation
+ */
+
+/** Everything {@link mobilityCapacitorMetrics} needs about one loaded ship. */
+interface MobilityCapacitorInput extends MobilityInput {
+    /** Finite pips assigned to ENG, in `[0, 4]`. Fractional pips are accepted; defaults to `4`. */
+    readonly enginesPips?: number;
+}
+/**
+ * Speed and rotation rates at one ENG-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 MobilityCapacitorMetrics {
+    /** Pips assigned to ENG for this result, in `[0, 4]`. */
+    readonly enginesPips: number;
+    /** Top speed at this mass and allocation, in metres per second. */
+    readonly speed: number;
+    /** Pitch rate at this mass and allocation, in degrees per second. */
+    readonly pitch: number;
+    /** Roll rate at this mass and allocation, in degrees per second. */
+    readonly roll: number;
+    /** Yaw rate at this mass and allocation, in degrees per second. */
+    readonly yaw: number;
+}
+/**
+ * Calculate a loaded ship's speed and rotation rates at one ENG-pip allocation.
+ *
+ * @param input - The same hull figures, loaded mass and fitted thrusters
+ * {@link mobilityMetrics} takes, plus the allocation to model.
+ * @returns The {@link MobilityCapacitorMetrics}, or `null` without thrusters. A mass
+ * above the thrusters' maximum returns zero performance rather than a fabricated curve
+ * value. At four pips every figure equals its {@link MobilityMetrics} counterpart.
+ * @throws {RangeError} If `enginesPips` is outside `[0, 4]`, an input is not finite or
+ * is outside its documented range, or a thruster curve does not follow the ordering
+ * {@link ThrusterCurveParams} documents. The pips are checked before the hull figures,
+ * so a bad allocation is reported first.
+ * @example
+ * ```ts
+ * import { mobilityCapacitorMetrics } from '@elite-dangerous-almanac/core/ships/mobility-capacitor';
+ *
+ * mobilityCapacitorMetrics({
+ *   minimumSpeed: 100, maximumSpeed: 220, boost: 320,
+ *   minPitch: 34, pitch: 42, minRoll: 110, roll: 110, minYaw: 16, yaw: 16,
+ *   mass: 48,
+ *   thrusters: {
+ *     minMass: 24, optMass: 48, maxMass: 72,
+ *     minMultiplier: 0.83, optMultiplier: 1, maxMultiplier: 1.03,
+ *   },
+ *   enginesPips: 2,
+ * })?.speed; // -> 160
+ * ```
+ */
+declare function mobilityCapacitorMetrics(input: MobilityCapacitorInput & {
+    readonly thrusters: ThrusterParams;
+}): MobilityCapacitorMetrics;
+declare function mobilityCapacitorMetrics(input: MobilityCapacitorInput): MobilityCapacitorMetrics | null;
+
+export { type MobilityCapacitorInput, type MobilityCapacitorMetrics, mobilityCapacitorMetrics };

package/dist/ships/mobility-capacitor.js

@@ -0,0 +1 @@
+export{mobilityCapacitorMetrics}from"../chunk-XUHAPOM6.js";                                                                                       //# sourceMappingURL=mobility-capacitor.js.map

package/dist/ships/mobility-capacitor.js.map

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