@elite-dangerous-almanac/core 0.2.0 → 0.2.2

package/dist/ships/build-metrics.d.ts

@@ -44,12 +44,8 @@ import './loadout-validation.js';
  * `./shield-recovery`, `./armour`, `./weapons`, `./weapons-capacitor` and
  * `./distributor` each take a plain input object and import no catalogue. This class is the convenience that reads those inputs off a build.
  *
- * **Unavailable metrics come in pairs.** Eight metrics depend on build state that may not
- * be there — no module fitted, a record that does not state a number, a switch turned
- * off, a priority group the plant sheds. Each is offered twice: a nullable method that
- * is the convenience, and a `…Result` companion carrying the same value plus the reason
- * it is unavailable. `standardLoad` / `standardLoadResult` is the same pair for a load
- * condition the fitted drive may not support.
+ * Metrics that depend on optional build state return a {@link CalculationResult}: its
+ * `value` is the completed figure or `null`, and `issues` explains an unavailable one.
  *
  * @example
  * ```ts
@@ -72,25 +68,25 @@ interface JumpOptions {
     readonly cargo?: number;
 }
 /**
- * Optional SYS allocation for {@link BuildMetrics.shieldCapacitorMetrics}.
+ * Optional SYS allocation for {@link BuildMetrics.shieldCapacitorMetricsResult}.
  *
  * @remarks
  * Its own type, rather than one shared with {@link ShieldRecoveryOptions}, because the
  * two answer different questions from the same allocation — resistance here, recharge
  * there — and each is free to document its own rule.
- * {@link BuildMetrics.shieldMetrics} takes no allocation at all: the bare shield is
+ * {@link BuildMetrics.shieldMetricsResult} takes no allocation at all: the bare shield is
  * pip-free.
  */
 interface ShieldCapacitorOptions {
     /**
      * Pips to the systems capacitor, `0`–`4`. Defaults to `4` — a full SYS capacitor,
      * the condition the game's own panel quotes. Pass `0` for the bare shield, whose
-     * effective figures then equal {@link BuildMetrics.shieldMetrics}.
+     * effective figures then equal {@link BuildMetrics.shieldMetricsResult}.
      */
     readonly systemsPips?: number;
 }
 /**
- * Optional SYS allocation for {@link BuildMetrics.shieldRecovery}.
+ * Optional SYS allocation for {@link BuildMetrics.shieldRecoveryResult}.
  *
  * @remarks
  * See {@link ShieldCapacitorOptions} for why recovery has an options type of its own.
@@ -102,11 +98,11 @@ interface ShieldRecoveryOptions {
      */
     readonly systemsPips?: number;
 }
-/** Optional load and ENG allocation for {@link BuildMetrics.mobilityCapacitorMetrics}. */
+/** Optional load and ENG allocation for {@link BuildMetrics.mobilityCapacitorMetricsResult}. */
 interface MobilityCapacitorOptions extends JumpOptions {
     /**
      * Pips assigned to the engines capacitor, `0`–`4`. Defaults to `4`, which reproduces
-     * {@link BuildMetrics.mobilityMetrics} exactly.
+     * {@link BuildMetrics.mobilityMetricsResult} exactly.
      */
     readonly enginesPips?: number;
 }
@@ -128,13 +124,13 @@ interface StandardLoadInputs {
      * to show beside them rather than one reassembled by the caller. The reserve tank
      * is **not** in it: the game's statistics panel counts the reserve in the current
      * mass it displays, and neither calculation here does — see
-     * {@link BuildMetrics.mobilityMetrics}. Add
+     * {@link BuildMetrics.mobilityMetricsResult}. Add
      * {@link ships!FuelCapacity.reserve | FuelCapacity.reserve} to
      * match the panel.
      *
      * The extra `fuel` and `cargo` are the load a screen labels; the mass is what they
      * add up to, and passing the whole value back into {@link BuildMetrics.jumpRange} or
-     * {@link BuildMetrics.mobilityMetrics} is unaffected by its presence.
+     * {@link BuildMetrics.mobilityMetricsResult} is unaffected by its presence.
      */
     readonly mass: number;
 }
@@ -143,7 +139,7 @@ interface WeaponsOptions {
     /** Pips assigned to the weapons capacitor, `0`–`4`. Defaults to `4`. */
     readonly weaponsPips?: number;
 }
-/** Optional SYS, ENG and WEP allocations for {@link BuildMetrics.distributorMetrics}. */
+/** Optional SYS, ENG and WEP allocations for {@link BuildMetrics.distributorMetricsResult}. */
 interface DistributorOptions {
     /** Pips assigned to the systems capacitor, `0`–`4`. Defaults to `4`. */
     readonly systemsPips?: number;
@@ -321,20 +317,15 @@ interface JumpRangeSummary {
  * - **Attach** — {@link of}.
  * - **Jump** — {@link frameShiftDrive}, {@link frameShiftDriveMassFactor},
  *   {@link maxJumpRange}, {@link jumpRange}, {@link ladenJumpRange}, {@link fuelPerJump},
- *   {@link totalRange}, {@link jumpRangeSummary}, {@link standardLoad},
- *   {@link standardLoadResult}.
+ *   {@link totalRange}, {@link jumpRangeSummary}, {@link standardLoadResult}.
  * - **Mass and cost** — {@link buildMass}, {@link buildCost}.
- * - **Power and heat** — {@link powerBudget}, {@link heatMetrics},
- *   {@link heatMetricsResult}.
- * - **Mobility** — {@link thrusters}, {@link mobilityMetrics},
- *   {@link mobilityMetricsResult}, {@link mobilityCapacitorMetrics},
+ * - **Power and heat** — {@link powerBudget}, {@link heatMetricsResult}.
+ * - **Mobility** — {@link thrusters}, {@link mobilityMetricsResult},
  *   {@link mobilityCapacitorMetricsResult}.
- * - **Defence** — {@link armourMetrics}, {@link shieldMetrics},
- *   {@link shieldMetricsResult}, {@link shieldCapacitorMetrics},
- *   {@link shieldCapacitorMetricsResult}, {@link shieldRecovery},
- *   {@link shieldRecoveryResult}, {@link cellBanks}.
+ * - **Defence** — {@link armourMetrics}, {@link shieldMetricsResult},
+ *   {@link shieldCapacitorMetricsResult}, {@link shieldRecoveryResult}, {@link cellBanks}.
  * - **Offence** — {@link weaponMetrics}, {@link weaponsCapacitorMetrics},
- *   {@link distributorMetrics}, {@link distributorMetricsResult}.
+ *   {@link distributorMetricsResult}.
  *
  * Every member is a method. Nothing here is a fact the fit already carries — each one
  * computes from build state — so there are no properties to confuse with them.
@@ -491,27 +482,6 @@ declare class BuildMetrics {
      * ```
      */
     totalRange(options?: JumpOptions): TotalRangeDetails;
-    /**
-     * One of the package's standard load conditions, or `null` when the fitted drive
-     * cannot support it.
-     *
-     * @param load - `'maximum'` for one jump's fuel and no cargo, `'unladen'` for a
-     * full main tank and no cargo, or `'laden'` for a full main tank and full hold.
-     * @returns The fuel and cargo carried and the {@link StandardLoadInputs.mass}, or
-     * `null`. Only `'maximum'` can answer `null`: it validates the whole fitted drive,
-     * jump booster included, so a non-null one can be passed straight to
-     * {@link jumpRange}. Use {@link standardLoadResult} to learn why it is unavailable.
-     * @throws {RangeError} If `load` is not a recognised standard load.
-     * @example
-     * ```ts
-     * import { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
-     *
-     * const metrics = BuildMetrics.of(ShipLoadout.default('Anaconda'));
-     * metrics.standardLoad('laden')?.mass; // -> 1210, tonnes with a full tank and hold
-     * ```
-     */
-    standardLoad(load: StandardLoad): StandardLoadInputs | null;
     /**
      * Resolve one of the package's standard load conditions for jump and mobility views.
      *
@@ -528,7 +498,7 @@ declare class BuildMetrics {
      *
      * declare const metrics: BuildMetrics;
      * const load = metrics.standardLoadResult('maximum');
-     * if (load.complete) metrics.mobilityCapacitorMetrics({ ...load.value, enginesPips: 2 });
+     * if (load.complete) metrics.mobilityCapacitorMetricsResult({ ...load.value, enginesPips: 2 });
      * ```
      */
     standardLoadResult(load: StandardLoad): CalculationResult<StandardLoadInputs>;
@@ -562,15 +532,15 @@ declare class BuildMetrics {
      * Lightweight roll is already in `modules`.
      *
      * The reserve tank is **not** counted. The main tank is the fuel the drive and the
-     * flight model see, and it is what {@link jumpRange} and {@link mobilityMetrics}
+     * flight model see, and it is what {@link jumpRange} and {@link mobilityMetricsResult}
      * weigh; the game's statistics panel additionally counts the reserve in the current
      * mass it displays, so add
      * {@link ships!ShipLoadout.fuelCapacity | fuelCapacity}`.reserve` to
      * reproduce that reading.
      *
      * @param options - {@link JumpOptions}. `fuel` defaults to a full main tank and
-     * `cargo` to `0`, matching {@link jumpRange} and {@link mobilityMetrics}. Pass
-     * {@link standardLoad} to weigh one of the standard loads.
+     * `cargo` to `0`, matching {@link jumpRange} and {@link mobilityMetricsResult}. Pass
+     * a complete {@link standardLoadResult} value to weigh one of the standard loads.
      * @returns A frozen {@link BuildMass}, every figure in tonnes.
      * @throws {RangeError} If fuel or cargo is not finite and non-negative.
      * @example
@@ -657,30 +627,6 @@ declare class BuildMetrics {
      * ```
      */
     powerBudget(): PowerBudget;
-    /**
-     * The build's heat: what it idles at, what it runs at flying and jumping, and
-     * whether firing everything cooks it.
-     *
-     * Every figure is post-engineering. The heat a build makes follows what the plant
-     * actually feeds, so a module switched off — or one in a priority group the plant
-     * cannot keep lit — contributes nothing.
-     *
-     * @returns The {@link HeatMetrics}, or `null` when the build has no powered power
-     * plant whose heat efficiency it can read. Use {@link heatMetricsResult} to
-     * distinguish the unavailable conditions.
-     * @example
-     * ```ts
-     * import type { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     *
-     * declare const metrics: BuildMetrics;
-     *
-     * const heat = metrics.heatMetrics();
-     * heat?.idle.gauge; // -> 0.23, i.e. the gauge reads 23%
-     * heat?.firingSustained.overheats; // -> false: the guns run cool enough to hold
-     * heat?.firingDrained.secondsToOverheat; // -> how long an alpha strike has on an empty WEP
-     * ```
-     */
-    heatMetrics(): HeatMetrics | null;
     /**
      * The build's heat with a diagnostic when its power plant is unavailable.
      *
@@ -698,33 +644,6 @@ declare class BuildMetrics {
      * ```
      */
     heatMetricsResult(): CalculationResult<HeatMetrics>;
-    /**
-     * The build's speed, boost and rotation rates at a chosen load and **full ENG**.
-     *
-     * @remarks
-     * Main-tank fuel contributes to the flight model's loaded mass. Reserve-tank fuel
-     * does not: although the statistics panel includes it in the displayed current
-     * mass, ten observed builds reproduce their angular rates only when the reserve is
-     * excluded from the thruster mass curve.
-     *
-     * These are the four-ENG-pip figures. A **lower** allocation is
-     * {@link mobilityCapacitorMetrics}, which owns the pip story the way
-     * {@link weaponsCapacitorMetrics} owns WEP's.
-     *
-     * @param options - Fuel defaults to a full main tank and cargo to `0`.
-     * @returns Loaded {@link MobilityMetrics}, or `null` when no fully described
-     * thrusters are powered with hardpoints retracted. Use
-     * {@link mobilityMetricsResult} to distinguish the unavailable conditions.
-     * @throws {RangeError} If fuel or cargo is not finite and non-negative.
-     * @example
-     * ```ts
-     * import type { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     *
-     * declare const metrics: BuildMetrics;
-     * metrics.mobilityMetrics({ cargo: 32, fuel: 8 })?.speed; // -> m/s at four ENG pips
-     * ```
-     */
-    mobilityMetrics(options?: JumpOptions): MobilityMetrics | null;
     /**
      * The build's mobility with a diagnostic when its thrusters or retracted power
      * supply is unavailable.
@@ -744,31 +663,6 @@ declare class BuildMetrics {
      * ```
      */
     mobilityMetricsResult(options?: JumpOptions): CalculationResult<MobilityMetrics>;
-    /**
-     * The build's speed and rotation rates at a chosen load and ENG-pip allocation.
-     *
-     * Boost is not here: it does not move with the allocation, so it stays on
-     * {@link mobilityMetrics} beside the loaded mass and the two curve multipliers these
-     * figures share.
-     *
-     * @param options - {@link MobilityCapacitorOptions}. Fuel defaults to a full main
-     * tank, cargo to `0`, and `enginesPips` to `4` — which reproduces
-     * {@link mobilityMetrics} exactly.
-     * @returns The {@link MobilityCapacitorMetrics}, or `null` when no fully described
-     * thrusters are powered with hardpoints retracted. Use
-     * {@link mobilityCapacitorMetricsResult} to distinguish the unavailable conditions.
-     * @throws {RangeError} If fuel or cargo is not finite and non-negative, or
-     * `enginesPips` is outside `[0, 4]`.
-     * @example
-     * ```ts
-     * import { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
-     *
-     * const metrics = BuildMetrics.of(ShipLoadout.default('SideWinder'));
-     * metrics.mobilityCapacitorMetrics({ enginesPips: 0 })?.enginesPips; // -> 0
-     * ```
-     */
-    mobilityCapacitorMetrics(options?: MobilityCapacitorOptions): MobilityCapacitorMetrics | null;
     /**
      * The build's ENG capacitor with a diagnostic when its thrusters or retracted power
      * supply is unavailable.
@@ -790,35 +684,6 @@ declare class BuildMetrics {
      * ```
      */
     mobilityCapacitorMetricsResult(options?: MobilityCapacitorOptions): CalculationResult<MobilityCapacitorMetrics>;
-    /**
-     * The build's shields: strength in megajoules, where it comes from, and the
-     * effective resistances.
-     *
-     * Shield strength scales with the **hull's** mass, not the build's, so fitting
-     * more modules never weakens it. Boosters, Guardian shield reinforcement and any
-     * engineering are all folded in; switched-off or shed boosters and reinforcement
-     * are ignored, while a switched-off or shed generator makes the metric unavailable.
-     *
-     * These are the **pip-free** figures, which is what an outfitting screen shows. What
-     * the SYS capacitor makes of them is {@link shieldCapacitorMetrics}, which owns the
-     * pip story the way {@link weaponsCapacitorMetrics} owns WEP's.
-     *
-     * @returns The {@link ShieldMetrics}, or `null` when the build has no shield
-     * generator powered with hardpoints retracted. Use
-     * {@link shieldMetricsResult} to distinguish the unavailable conditions.
-     * @example
-     * ```ts
-     * import type { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     *
-     * declare const metrics: BuildMetrics;
-     *
-     * const shields = metrics.shieldMetrics();
-     * shields?.strength; // -> MJ
-     * shields?.resistances.thermal; // -> negative on a stock generator
-     * metrics.shieldCapacitorMetrics()?.effectiveResistances.thermal; // -> with 4 pips to SYS
-     * ```
-     */
-    shieldMetrics(): ShieldMetrics | null;
     /**
      * The build's shields with a diagnostic when its hull, generator or retracted
      * power supply is unavailable.
@@ -836,36 +701,6 @@ declare class BuildMetrics {
      * ```
      */
     shieldMetricsResult(): CalculationResult<ShieldMetrics>;
-    /**
-     * The build's SYS capacitor: what the pips hold and recharge, the resistance they
-     * add, and what the shields are worth with them folded in.
-     *
-     * The effective resistances and hit points here are the ones the game's own panel
-     * shows while the allocation stands; {@link shieldMetrics} is the bare shield they
-     * are built from. Both come from one pass over the build, so a screen showing them
-     * side by side need not compute the shield twice.
-     *
-     * @param options - {@link ShieldCapacitorOptions}. `systemsPips` (0–4) defaults to
-     * `4`; at `0` the effective figures equal {@link shieldMetrics}.
-     * @returns The {@link ShieldCapacitorMetrics}, or `null` when the build has no
-     * shield generator powered with hardpoints retracted, or a fitted distributor does
-     * not state its SYS figures. Use {@link shieldCapacitorMetricsResult} to distinguish
-     * the unavailable conditions. With no distributor fitted, capacity and recharge are
-     * zero — the modelled truth for a build that has no SYS capacitor at all.
-     * @throws {RangeError} If `systemsPips` is outside `[0, 4]` or not finite.
-     * @example
-     * ```ts
-     * import { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
-     *
-     * const metrics = BuildMetrics.of(ShipLoadout.default('SideWinder'));
-     * const sys = metrics.shieldCapacitorMetrics({ systemsPips: 4 });
-     * sys?.systemsResistance; // -> 0.6
-     * // Effective hit points behind those pips, against the shield's weakest type.
-     * (sys?.effectiveHitPoints.thermal ?? 0) > (metrics.shieldMetrics()?.strength ?? 0); // -> true
-     * ```
-     */
-    shieldCapacitorMetrics(options?: ShieldCapacitorOptions): ShieldCapacitorMetrics | null;
     /**
      * The build's SYS capacitor with a diagnostic when its generator, retracted power
      * supply or distributor record is unavailable.
@@ -888,25 +723,6 @@ declare class BuildMetrics {
      * ```
      */
     shieldCapacitorMetricsResult(options?: ShieldCapacitorOptions): CalculationResult<ShieldCapacitorMetrics>;
-    /**
-     * Time for this build's shield to rise after collapse and then regenerate to full.
-     *
-     * @param options - {@link ShieldRecoveryOptions}. SYS pips in `[0, 4]`, defaulting
-     * to `4` — **not** the `0` {@link shieldMetrics} defaults to.
-     * @returns Recovery rates and seconds, or `null` when no shield generator is powered
-     * with hardpoints retracted. Use
-     * {@link shieldRecoveryResult} to distinguish the unavailable conditions.
-     * Insufficient zero-pip recharge produces `Infinity`.
-     * @throws {RangeError} If `systemsPips` is outside `[0, 4]` or not finite.
-     * @example
-     * ```ts
-     * import type { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     *
-     * declare const metrics: BuildMetrics;
-     * metrics.shieldRecovery({ systemsPips: 4 })?.recoveryTime; // -> seconds from collapse to 50%
-     * ```
-     */
-    shieldRecovery(options?: ShieldRecoveryOptions): ShieldRecovery | null;
     /**
      * The build's shield recovery with a diagnostic when its hull, generator or
      * retracted power supply is unavailable.
@@ -1008,33 +824,6 @@ declare class BuildMetrics {
      * ```
      */
     weaponsCapacitorMetrics(options?: WeaponsOptions): WeaponsCapacitorMetrics;
-    /**
-     * All three power-distributor capacitors at selected pip allocations.
-     *
-     * @param options - SYS, ENG and WEP pips in `[0, 4]`, each defaulting
-     * independently to `4`. The allocations need not sum to six, which permits
-     * independent comparisons of the three maxima.
-     * @returns Capacity, rated four-pip recharge and actual pip-scaled recharge for
-     * SYS, ENG and WEP, or `null` when the distributor is not fitted, switched off,
-     * shed by the retracted power budget, or its six capacitor stats cannot be
-     * resolved. Use {@link distributorMetricsResult} to distinguish those four. That
-     * retracted state represents the distributor itself; firing endurance in
-     * {@link weaponsCapacitorMetrics} separately applies the deployed state.
-     * @throws {RangeError} If any pip allocation is outside `[0, 4]` or not finite.
-     * @example
-     * ```ts
-     * import type { BuildMetrics } from '@elite-dangerous-almanac/core/ships/build-metrics';
-     *
-     * declare const metrics: BuildMetrics;
-     * const distributor = metrics.distributorMetrics({
-     *     systemsPips: 2,
-     *     enginesPips: 2,
-     *     weaponsPips: 2,
-     * });
-     * distributor?.engines.rechargeRate; // MJ/s
-     * ```
-     */
-    distributorMetrics(options?: DistributorOptions): DistributorMetrics | null;
     /**
      * The build's distributor with a diagnostic when it is unavailable.
      *

package/dist/ships/build-metrics.js

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

package/dist/ships/distributor.d.ts

@@ -5,7 +5,7 @@
  * and WEP use the same non-linear allocation curve:
  * `ratedRecharge * (pips / 4) ^ 1.1`.
  *
- * This module is data-free. {@link BuildMetrics.distributorMetrics}
+ * This module is data-free. {@link BuildMetrics.distributorMetricsResult}
  * (`./build-metrics`) resolves the powered distributor in a build for you.
  *
  * @remarks

package/dist/ships/distributor.js

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

package/dist/ships/heat.d.ts

@@ -21,7 +21,7 @@
  * 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 BuildMetrics.heatMetrics} (in
+ * plant's efficiency and the build's draw. {@link BuildMetrics.heatMetricsResult} (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

package/dist/ships/heat.js

@@ -1 +1 @@
-export{OVERHEAT_HEAT_LEVEL,effectiveWeaponThermalLoad,equilibriumHeatLevel,heatLevelAtTime,heatMetrics,secondsToHeatLevel}from"../chunk-Q2L75GSI.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

@@ -14,7 +14,7 @@
  * 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
+ * {@link BuildMetrics.shieldMetricsResult}), 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.
@@ -106,7 +106,7 @@
  * const metrics = BuildMetrics.of(ShipLoadout.fromLoadout(event));
  * metrics.maxJumpRange(); // -> 60.5478  (ly)
  * metrics.powerBudget().withinBudget; // -> true
- * metrics.shieldMetrics()?.strength; // -> 743.12   (MJ)
+ * metrics.shieldMetricsResult().value?.strength; // -> 743.12   (MJ)
  * metrics.weaponMetrics().total.damagePerSecond; // -> 34
  * ```
  *
@@ -158,7 +158,7 @@ export { FrameShiftDriveParams, TotalRangeDetails, frameShiftDriveMassFactor, fu
 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';

package/dist/ships/index.js

@@ -1 +1 @@
-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
+export{LoadoutEditError,ShipLoadout}from"../chunk-B5VTFOK4.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{validateLoadout}from"../chunk-OJC6AUL7.js";export{SHIP_MODULE_LIMITS,calculateModuleLimits}from"../chunk-KPETDYQX.js";export{BuildMetrics}from"../chunk-3RTUSDQF.js";export{cellBankSummary,shieldRecovery}from"../chunk-JMAXSXXQ.js";                             export{shieldMassCurveMultiplier,shieldMetrics,shieldStrength}from"../chunk-5VWACBTN.js";export{SHIPS,getShipByName,getShipBySymbol,getShipSlots}from"../chunk-6UNAD74Z.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{powerBudget}from"../chunk-GGQMIQPC.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-4OTQBHQL.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-37JIMWLK.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-3LZXB2MC.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-PL75RTA2.js";export{shieldCapacitorMetrics}from"../chunk-XQJERZUS.js";export{mobilityCapacitorMetrics}from"../chunk-VEEBJFJ7.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-A4QKXXZD.js";                                                                                                                                                                                                                                                                     export{EXPERIMENTAL_EFFECTS,getExperimentalEffect}from"../chunk-77I24V6B.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,calculateUnladenMass}from"../chunk-DCB4COCL.js";                             export{resolveBlueprintForModule}from"../chunk-OLKNYGGT.js";export{BLUEPRINTS,getBlueprint,getBlueprintGrade}from"../chunk-AYAKU4YA.js";                             export{distributorMetrics}from"../chunk-M2TCZKRT.js";                             export{ENGINEERING_OPTION_GROUPS,getBlueprintsForModule,getEngineeringGroup,getExperimentalsForBlueprint,getExperimentalsForModule}from"../chunk-GLWPSVFV.js";export{computeModifiers,sumMaterials}from"../chunk-CJQ37JII.js";export{ammunitionCapacity}from"../chunk-AA3K5XUE.js";export{armourMetrics}from"../chunk-Q5ALV3DI.js";export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance}from"../chunk-F44QX47A.js";                                                          export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map

package/dist/ships/jump-range.js

@@ -1 +1 @@
-export{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-6O4NRRSB.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

@@ -5,8 +5,8 @@
  * The three sums here consume already-resolved module contributions, so they import no
  * catalogue and know nothing of {@link ShipLoadout}. Every contribution is a known number
  * — a record missing one is refused long before it reaches a build — so each returns its
- * figure outright. The {@link CalculationResult} types below belong to the build metrics
- * that *can* come back unavailable, which `ShipLoadout` exposes as `…Result` companions.
+ * figure outright. The {@link CalculationResult} types below belong to the
+ * {@link ships!BuildMetrics | BuildMetrics} methods that can come back unavailable.
  *
  * @packageDocumentation
  */