@elite-dangerous-almanac/core 0.1.6 → 0.1.8

package/dist/ships/index.d.ts

@@ -143,9 +143,10 @@ export { GunsightOffset, GunsightPoint, SHIP_GUNSIGHTS, ShipGunsight, ShipGunsig
 export { DamageComponents, DamageDistribution, ModuleCategory, ModuleExclusionGroup, ModuleGuidance, ModuleLimitGroup, ModuleLimitIncrease, ModuleMount, ModuleRating, OutfittingModule, OutfittingModuleIdentity, OutfittingModuleStats, ProjectileRangeBoundaries, getBulkheadsForShip, getModuleBySymbol, getModulesByName } from './modules.js';
 export { ModuleLimitEntry, ModuleLimitUsage, SHIP_MODULE_LIMITS, calculateModuleLimits } from './module-limits.js';
 export { FrameShiftDriveJumpStats, MassCurveStats, PowerDistributorStats, PowerGenerationStats, ShieldRegenerationStats, WeaponDamageStats, hasFrameShiftDriveJumpStats, hasMassCurveStats, hasPowerDistributorStats, hasPowerGenerationStats, hasShieldRegenerationStats, hasWeaponDamageStats } from './module-capabilities.js';
+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, 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, 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 { 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';

package/dist/ships/index.js

@@ -1 +1 @@
-export{LoadoutEditError,ShipLoadout}from"../chunk-ZKU7CMAH.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-UXFMVZAY.js";export{getSourceModuleValue,sourcePurchaseFromLoadout,sumSourceModuleValues}from"../chunk-IYU4WLFM.js";export{weaponsCapacitorMetrics}from"../chunk-FMPRCYKY.js";export{powerBudget}from"../chunk-RLUS76LZ.js";export{getPreEngineeredJournalModifiers,getPreEngineeredModifiers,getPreEngineeredStats,identifyPreEngineeredVariant,unresolvedModifiers}from"../chunk-BZDTEXXM.js";export{armourPiercingFactor,combinedRateOfFire,damageFalloff,damagePerSecond,energyPerSecond,heatPerSecond,splitDamage,sumWeaponMetrics,sustainedDamagePerSecond,sustainedFireFactor,weaponMetrics}from"../chunk-LJI7VXJD.js";export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-UPUC5X2C.js";export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-2VPVZELZ.js";export{cellBankSummary,shieldRecovery}from"../chunk-VZZUNSDF.js";export{calculateCargoCapacity,calculateFuelCapacity,calculateUnladenMass}from"../chunk-AFVYCQWL.js";export{validateLoadout}from"../chunk-B4ZSTOM4.js";export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-24INI4U7.js";export{hasFrameShiftDriveJumpStats,hasMassCurveStats,hasPowerDistributorStats,hasPowerGenerationStats,hasShieldRegenerationStats,hasWeaponDamageStats}from"../chunk-JTQVWIGL.js";export{SHIP_MODULE_LIMITS,calculateModuleLimits}from"../chunk-KPETDYQX.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{frameShiftDriveMassFactor,fuelPerJump,singleJumpRange,totalRange}from"../chunk-GQ5GX5TB.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{distributorMetrics}from"../chunk-P2QOL63K.js";                                                          export{SLOT_RESTRICTION_LABELS,enumerateSlots,parseSlotName}from"../chunk-RAO35XDF.js";                                                                                       //# sourceMappingURL=index.js.map
+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

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

@@ -1,6 +1,7 @@
 import { BuildSlot } from './slots.js';
 import { ModuleExclusionGroup, ModuleLimitGroup, ModuleLimitIncrease } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 
 /**
  * Structural validation for fitted ship loadouts.

package/dist/ships/mobility.d.ts

@@ -66,6 +66,18 @@ interface MobilityInput {
 }
 /** Speed and rotation rates for one loaded ship. */
 interface MobilityMetrics {
+    /**
+     * The loaded mass these figures were calculated at, in tonnes — the
+     * {@link MobilityInput.mass} that went in.
+     *
+     * @remarks
+     * Reported so a build-level caller, which never states the mass itself, can read
+     * what the curve was evaluated at. Against the fitted curve's `optMass` and
+     * `maxMass` it is the build's position on that curve: at or below `optMass` the
+     * thrusters are at or above their rated performance, and past `maxMass` they do not
+     * move the ship at all — {@link massCurveMultiplier} is `0` there.
+     */
+    readonly loadedMass: number;
     /** Top speed at this mass and ENG allocation, in metres per second. */
     readonly speed: number;
     /** Boost speed at this mass, in metres per second. */

package/dist/ships/mobility.js

@@ -1 +1 @@
-export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-24INI4U7.js";//# sourceMappingURL=mobility.js.map
+export{mobilityMetrics,thrusterMassCurveMultiplier}from"../chunk-CX7B67OI.js";//# sourceMappingURL=mobility.js.map

package/dist/ships/module-capabilities.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModuleStats } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**

package/dist/ships/module-families.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The outfitting **module families** — the grouping an outfitting list shows above the
+ * modules that share it, and the id every {@link OutfittingModuleIdentity} carries.
+ *
+ * A family is coarser than an engineering group and finer than an outfitting category:
+ * ordinary, Bi-Weave and Prismatic generators are all `shieldGenerators`, while the
+ * eight core mounts each have their own family. Localized display text for these ids is
+ * `getOutfittingFamilyName` in `i18n/module-families`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * A stable identifier for an outfitting module family.
+ *
+ * @remarks
+ * These are the keys of {@link OUTFITTING_FAMILIES}. Every module carries one, core
+ * modules included, so an outfitting list can group every choice
+ * `ShipLoadout.modulesForSlot()` returns without a private taxonomy. Closely related
+ * variants share a family: Mk II and corrosion-resistant racks are `cargoRacks`, and a
+ * pre-engineered or Powerplay variant stays in its base module's family.
+ *
+ * @example
+ * ```ts
+ * import type { OutfittingFamilyId } from '@elite-dangerous-almanac/core/ships/module-families';
+ *
+ * const family: OutfittingFamilyId = 'shieldGenerators';
+ * ```
+ */
+type OutfittingFamilyId = 'armour' | 'powerPlants' | 'engines' | 'fsd' | 'lifeSupport' | 'powerDistributors' | 'sensors' | 'fuelTanks' | 'dockingComputers' | 'shieldGenerators' | 'shieldCellBanks' | 'cargoRacks' | 'hatchBreakerLimpets' | 'surfaceScanners' | 'fuelScoops' | 'refineries' | 'fsdInterdictors' | 'afms' | 'hullReinforcements' | 'collectorLimpets' | 'fuelTransferLimpets' | 'prospectingLimpets' | 'planetaryVehicleHangars' | 'planetaryApproachSuites' | 'cargoHatches' | 'passengerCabins' | 'vesselHangars' | 'moduleReinforcements' | 'repairLimpets' | 'researchLimpets' | 'decontaminationLimpets' | 'guardianShieldReinforcementPackages' | 'fsdBoosters' | 'guardianHybridPowerDistributors' | 'guardianHybridPowerPlants' | 'reconLimpets' | 'flightAssists' | 'miningMultiLimpetControllers' | 'multiLimpetControllers' | 'experimentalWeaponStabilisers' | 'pulseLasers' | 'burstLasers' | 'beamLasers' | 'cannons' | 'fragmentCannons' | 'multiCannons' | 'plasmaAccelerators' | 'railGuns' | 'missiles' | 'mines' | 'torpedoes' | 'miningLasers' | 'remoteReleaseFlakLaunchers' | 'axMissileRacks' | 'axMultiCannons' | 'guardianGaussCannons' | 'remoteReleaseFlechetteLaunchers' | 'guardianPlasmaChargers' | 'guardianShardCannons' | 'shockCannons' | 'subSurfaceDisplacementMissiles' | 'abrasionBlasters' | 'miningTools' | 'subSurfaceExtractionMissiles' | 'guardianNaniteTorpedoPylons' | 'chaffLaunchers' | 'ecms' | 'heatsinkLaunchers' | 'pointDefence' | 'manifestScanners' | 'wakeScanners' | 'killWarrantScanners' | 'shieldBoosters' | 'shutdownFieldNeutralisers' | 'xenoScanners' | 'pulseWaveAnalyser' | 'causticSinkLaunchers';
+/**
+ * Every outfitting family's canonical English display name, keyed by id.
+ *
+ * @remarks
+ * The names are Frontier's own outfitting category labels where the game publishes one,
+ * and the Almanac's descriptive name for the 19 families it does not. They are
+ * canonical English, not localized UI text: use
+ * `getOutfittingFamilyName` for a locale.
+ *
+ * @example
+ * ```ts
+ * import { OUTFITTING_FAMILIES } from '@elite-dangerous-almanac/core/ships/module-families';
+ *
+ * OUTFITTING_FAMILIES.shieldGenerators; // -> 'Shield Generators'
+ * OUTFITTING_FAMILIES.armour; // -> 'Armour'
+ * ```
+ */
+declare const OUTFITTING_FAMILIES: Readonly<Record<OutfittingFamilyId, string>>;
+
+export { OUTFITTING_FAMILIES, type OutfittingFamilyId };

package/dist/ships/module-families.js

@@ -0,0 +1 @@
+export{OUTFITTING_FAMILIES}from"../chunk-M6G3UDTX.js";                             //# sourceMappingURL=module-families.js.map

package/dist/ships/module-families.js.map

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

package/dist/ships/module-limits.d.ts

@@ -1,5 +1,6 @@
 import { ModuleLimitGroup, ModuleLimitIncrease } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**

package/dist/ships/modules-all.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModule } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**

package/dist/ships/modules-all.js

@@ -1 +1 @@
-export{ALL_MODULES}from"../chunk-PEHOKSSD.js";                                                                                                                                                                              //# sourceMappingURL=modules-all.js.map
+export{ALL_MODULES}from"../chunk-QY3L5BKN.js";                                                                                                                                                                              //# sourceMappingURL=modules-all.js.map

package/dist/ships/modules-core.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModule } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**

package/dist/ships/modules-core.js

@@ -1 +1 @@
-export{CORE_MODULES}from"../chunk-3EO7PTAP.js";                                                          //# sourceMappingURL=modules-core.js.map
+export{CORE_MODULES}from"../chunk-EVJ32UF3.js";                                                          //# sourceMappingURL=modules-core.js.map

package/dist/ships/modules-hardpoint.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModule } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**
@@ -34,7 +35,7 @@ import './slots.js';
  * import { HARDPOINT_MODULES } from '@elite-dangerous-almanac/core/ships/modules-hardpoint';
  *
  * HARDPOINT_MODULES.length; // -> 159
- * HARDPOINT_MODULES.filter((m) => m.family === 'Beam Lasers').length; // -> 12
+ * HARDPOINT_MODULES.filter((m) => m.familyId === 'beamLasers').length; // -> 12
  * HARDPOINT_MODULES.filter((m) => m.mount === 'Turreted').length; // turreted variants
  * ```
  */

package/dist/ships/modules-hardpoint.js

@@ -1 +1 @@
-export{HARDPOINT_MODULES}from"../chunk-PYV7VI6I.js";                                                          //# sourceMappingURL=modules-hardpoint.js.map
+export{HARDPOINT_MODULES}from"../chunk-4TFAZX73.js";                                                          //# sourceMappingURL=modules-hardpoint.js.map

package/dist/ships/modules-internal.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModule } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**
@@ -33,7 +34,7 @@ import './slots.js';
  * import { INTERNAL_MODULES } from '@elite-dangerous-almanac/core/ships/modules-internal';
  *
  * INTERNAL_MODULES.length; // -> 484
- * INTERNAL_MODULES.filter((m) => m.family === 'Cargo Racks').length; // -> 16
+ * INTERNAL_MODULES.filter((m) => m.familyId === 'cargoRacks').length; // -> 16
  * ```
  */
 declare const INTERNAL_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-internal.js

@@ -1 +1 @@
-export{INTERNAL_MODULES}from"../chunk-5V4OXZLE.js";                                                          //# sourceMappingURL=modules-internal.js.map
+export{INTERNAL_MODULES}from"../chunk-4ZGUSHTP.js";                                                          //# sourceMappingURL=modules-internal.js.map

package/dist/ships/modules-utility.d.ts

@@ -1,5 +1,6 @@
 import { OutfittingModule } from './modules.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**
@@ -33,7 +34,7 @@ import './slots.js';
  * import { UTILITY_MODULES } from '@elite-dangerous-almanac/core/ships/modules-utility';
  *
  * UTILITY_MODULES.length; // -> 35
- * UTILITY_MODULES.filter((m) => m.family === 'Shield Boosters').length; // -> 5
+ * UTILITY_MODULES.filter((m) => m.familyId === 'shieldBoosters').length; // -> 5
  * ```
  */
 declare const UTILITY_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-utility.js

@@ -1 +1 @@
-export{UTILITY_MODULES}from"../chunk-6FKBZPI6.js";                                                          //# sourceMappingURL=modules-utility.js.map
+export{UTILITY_MODULES}from"../chunk-ELT3FEA4.js";                                                          //# sourceMappingURL=modules-utility.js.map

package/dist/ships/modules.d.ts

@@ -1,4 +1,5 @@
 import { EngineeringGroupId } from './engineering-options.js';
+import { OutfittingFamilyId } from './module-families.js';
 import { ModuleSlot, SlotRestriction } from './slots.js';
 
 /**
@@ -43,7 +44,7 @@ import { ModuleSlot, SlotRestriction } from './slots.js';
  *
  * @remarks
  * **This is the one default that costs real bundle weight.** A lookup imported from
- * here pulls all four catalogues — 318.3 KiB minified (32.4 KiB gzipped) — since
+ * here pulls all four catalogues — 337.4 KiB minified (33.3 KiB gzipped) — since
  * that is what it falls back to, and passing an explicit catalogue does not undo it.
  * A build that must carry only one category should import that catalogue and search
  * it directly:
@@ -200,7 +201,7 @@ interface ProjectileRangeBoundaries {
  * Identity, classification, fit constraints, and price for one outfitting module.
  *
  * @remarks
- * The core identity fields (`symbol`, `name`, `category`, `family`, `class`, and `rating`)
+ * The core identity fields (`symbol`, `name`, `category`, `familyId`, `class`, and `rating`)
  * are always present. Optional fields describe fit restrictions, purchase entitlement,
  * and price. Performance data belongs to {@link OutfittingModuleStats}; the complete
  * flat catalogue record is {@link OutfittingModule}.
@@ -213,7 +214,7 @@ interface ProjectileRangeBoundaries {
  *   symbol: 'CustomBeamLaser',
  *   category: 'hardpoint',
  *   engineeringGroup: 'beamLasers',
- *   family: 'Beam Lasers',
+ *   familyId: 'beamLasers',
  *   name: 'Custom Beam Laser',
  *   class: 2,
  *   rating: 'D',
@@ -241,21 +242,21 @@ interface OutfittingModuleIdentity {
      */
     readonly engineeringGroup: EngineeringGroupId | null;
     /**
-     * Stable descriptive English family used to group an outfitting list, such as
-     * `"Cargo Racks"`, `"Shield Generators"`, or `"Beam Lasers"`.
+     * Stable outfitting family used to group an outfitting list, such as
+     * `'cargoRacks'`, `'shieldGenerators'` or `'beamLasers'`. See
+     * {@link OutfittingFamilyId}.
      *
      * @remarks
-     * Every optional-internal, hardpoint, and utility-mount record carries a family.
-     * Closely related variants share it: Bi-Weave and Prismatic generators are Shield
-     * Generators, Mk II and corrosion-resistant racks are Cargo Racks, and Powerplay
-     * weapon variants stay with their base weapon family. Core modules are outside this
-     * display grouping and carry `null`.
+     * Every record carries one, core modules included, so every choice
+     * {@link ShipLoadout.modulesForSlot} returns has a family. Closely related variants
+     * share it: Bi-Weave and Prismatic generators are `'shieldGenerators'`, Mk II and
+     * corrosion-resistant racks are `'cargoRacks'`, and a Powerplay or pre-engineered
+     * variant stays with its base weapon's family.
      *
-     * This canonical label is not localized and is not suitable as a localization key;
-     * source-backed locale coverage is tracked in
-     * [#320](https://github.com/DarkSession/Elite-Dangerous-Almanac/issues/320).
+     * {@link OUTFITTING_FAMILIES} gives the canonical English display name;
+     * `getOutfittingFamilyName` in `i18n/module-families` gives a localized one.
      */
-    readonly family: string | null;
+    readonly familyId: OutfittingFamilyId;
     /**
      * The one fixed mount this module fills, when it fills one: `'armour'` or one of
      * the seven {@link CoreSlotType} core functions.
@@ -498,6 +499,32 @@ interface OutfittingModuleStats {
      * drive of the same size.
      */
     readonly fsdHeatRate?: number;
+    /**
+     * Frame shift drive: `true` on a Supercruise Overcharge drive, the line the
+     * outfitting screen labels SCO.
+     *
+     * @remarks
+     * A sparse capability flag on the 36 Overcharge drives and absent everywhere else,
+     * including on the 36 ordinary drives of the same sizes and ratings. Read it rather
+     * than matching `Int_Hyperdrive_Overcharge` on the symbol: the capability is the
+     * record's to state, and a pre-engineered or fitted article carries the flag
+     * through while its symbol is not always the one you looked up.
+     *
+     * The two lines share every jump constant this library models, so the flag changes
+     * no calculation here; it is what an outfitting list filters and labels on. The
+     * overcharged supercruise behaviour itself — the boosted acceleration and the extra
+     * fuel it burns — is in-flight behaviour the game publishes no figures for, and the
+     * library models none of it.
+     *
+     * @example
+     * ```ts
+     * import { getModuleBySymbol } from '@elite-dangerous-almanac/core/ships/modules';
+     *
+     * getModuleBySymbol('Int_Hyperdrive_Overcharge_Size5_Class5')?.supercruiseOvercharge; // -> true
+     * getModuleBySymbol('Int_Hyperdrive_Size5_Class5')?.supercruiseOvercharge; // -> undefined
+     * ```
+     */
+    readonly supercruiseOvercharge?: boolean;
     /** Guardian FSD Booster: flat jump-range bonus, in light-years. */
     readonly jumpBoost?: number;
     /** Power plant: power generated, in megawatts. */

package/dist/ships/modules.js

@@ -1 +1 @@
-export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-UPUC5X2C.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=modules.js.map
+export{getBulkheadsForShip,getModuleBySymbol,getModulesByName}from"../chunk-PA5EITW5.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=modules.js.map

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

@@ -2,6 +2,7 @@ import { OutfittingModule } from './modules.js';
 import { PreEngineeredVariant } from './pre-engineered.js';
 import { EngineeringModifier, LoadoutModule } from './slef.js';
 import './engineering-options.js';
+import './module-families.js';
 import './slots.js';
 
 /**

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

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

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

@@ -11,13 +11,14 @@ import { WeaponMetrics, WeaponTotals } from './weapons.js';
 import { AmmunitionCapacity } from './ammunition.js';
 import { WeaponsCapacitorMetrics } from './weapons-capacitor.js';
 import { DistributorMetrics } from './distributor.js';
-import { MobilityMetrics } from './mobility.js';
+import { ThrusterParams, MobilityMetrics } from './mobility.js';
 import { ShieldRecovery, CellBankSummary } from './shield-recovery.js';
 import { PreEngineeredVariant } from './pre-engineered.js';
 import { SourcePurchaseRecord } from './source-purchase.js';
 import { FuelCapacity, CalculationResult } from './loadout-calculations.js';
 import { ModuleFitConstraint, LoadoutIssueParams, LoadoutValidation } from './loadout-validation.js';
 import './engineering-options.js';
+import './module-families.js';
 import './resistances.js';
 
 /**
@@ -389,7 +390,10 @@ interface EngineeringNormalizationUnchanged {
 interface EngineeringNormalized {
     /** Discriminator for a successful normalization. */
     readonly kind: 'normalized';
-    /** Quality reported by the fitted module before normalization, in `[0, 1)`. */
+    /**
+     * Quality reported by the fitted module before normalization, in `[0, 1]`. It reads
+     * `1` where a completed roll stated no modifiers and this call spelled them out.
+     */
     readonly previousQuality: number;
     /** Completed engineering quality. Always `1`. */
     readonly quality: 1;
@@ -421,12 +425,29 @@ interface MobilityOptions extends JumpOptions {
 }
 /** A standard fuel-and-cargo condition shared by jump and mobility views. */
 type StandardLoad = 'maximum' | 'unladen' | 'laden';
-/** Fuel and cargo carried for a {@link StandardLoad}, both in tonnes. */
+/** What a {@link StandardLoad} carries, and what the ship weighs carrying it. */
 interface StandardLoadInputs {
     /** Main-tank fuel carried, in tonnes. */
     readonly fuel: number;
     /** Cargo carried, in tonnes. */
     readonly cargo: number;
+    /**
+     * What the ship weighs at this load, in tonnes: {@link ShipLoadout.unladenMass}
+     * plus `fuel` plus `cargo`.
+     *
+     * @remarks
+     * This is the mass the jump and mobility calculations run on, so it is the figure
+     * 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 ShipLoadout.mobilityMetrics}. Add {@link 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 ShipLoadout.jumpRange} or
+     * {@link ShipLoadout.mobilityMetrics} is unaffected by its presence.
+     */
+    readonly mass: number;
 }
 /** Optional WEP allocation for {@link ShipLoadout.weaponsCapacitorMetrics}. */
 interface WeaponsOptions {
@@ -499,6 +520,47 @@ interface BuildCost {
      */
     readonly materials: readonly EngineeringMaterial[];
 }
+/**
+ * What an assembled build weighs, broken down the way {@link ShipLoadout.buildMass}
+ * weighs it. Every figure is in tonnes.
+ *
+ * @remarks
+ * The mass counterpart of {@link BuildCredits}, and the same split: what the bare hull
+ * contributes, what the fit adds, and the total. `fuel` and `cargo` are the chosen load
+ * on top of that, so `total` is the mass the jump and mobility calculations run on.
+ */
+interface BuildMass {
+    /** Bare hull mass — the {@link ships!Ship.hullMass | hullMass} of the hull being flown. */
+    readonly hull: number;
+    /**
+     * Every fitted module's post-engineering mass, summed.
+     *
+     * @remarks
+     * Lightweight blueprints are already folded in, and the cargo hatch weighs nothing.
+     * A fitted record with no mass at all contributes `0` rather than making the total
+     * unavailable — mass is the one figure no article can be missing (see
+     * {@link ShipLoadout.unladenMass}), which is why there is no `unpriced` counterpart
+     * to {@link BuildCredits.unpriced} here.
+     */
+    readonly modules: number;
+    /**
+     * The ship with an empty tank and no cargo — {@link ShipLoadout.unladenMass}.
+     *
+     * @remarks
+     * `hull` and `modules` are always computed from the hull record and the current
+     * fit, while this is the build's own unladen mass, which for an unedited import is
+     * the figure the **capture** stated. The two agree on anything assembled here; where
+     * a capture disagrees with the catalogues, this is the one the jump and mobility
+     * calculations use and the decomposition is what the catalogues say it is made of.
+     */
+    readonly unladen: number;
+    /** Main-tank fuel counted, in tonnes. Defaults to a full main tank. */
+    readonly fuel: number;
+    /** Cargo counted, in tonnes. Defaults to an empty hold. */
+    readonly cargo: number;
+    /** `unladen + fuel + cargo`: what the ship weighs at the chosen load. */
+    readonly total: number;
+}
 /** One fitted weapon and what it does, as {@link ShipLoadout.weaponMetrics} reports it. */
 interface FittedWeaponMetrics {
     /** The hardpoint's slot key, e.g. `"LargeHardpoint1"`. */
@@ -1137,6 +1199,11 @@ declare class ShipLoadout {
      * reward rebuilds its hand-authored modifiers and optional effect without losing its
      * purchase identity. A refusal never changes the loadout.
      *
+     * A block that names a blueprint and grade but states no `Modifiers` at all is rolled
+     * here too, even at quality `1` — SLEF permits that identity-only shape and Inara
+     * writes it, so a capture of a completed roll would otherwise stay stock. A stated
+     * modifier array, empty or partial, is left alone at quality `1`.
+     *
      * @param slotKey - The engineered slot, matched case-insensitively.
      * @returns A frozen result identifying a normalized, unchanged or unsupported state.
      * @throws {TypeError} If `slotKey` is not a string.
@@ -1294,6 +1361,36 @@ declare class ShipLoadout {
      * jump constants.
      */
     get frameShiftDrive(): FrameShiftDriveParams;
+    /**
+     * The fitted thrusters' post-engineering mass curve, or `null` when the build has
+     * none — the thruster counterpart of {@link frameShiftDrive}.
+     *
+     * @remarks
+     * A {@link ships!ThrusterParams | ThrusterParams} carries the three masses the
+     * curve is defined over and the multiplier at each, plus the separate `speedCurve`
+     * and `rotationCurve` an enhanced-performance thruster refines them with. Pass it
+     * straight to
+     * {@link ships!thrusterMassCurveMultiplier | thrusterMassCurveMultiplier} for the
+     * multiplier at a mass of your own, or read `optMass` and `maxMass` against
+     * {@link ships!MobilityMetrics.loadedMass | loadedMass} for where this build sits
+     * on the curve.
+     *
+     * This is the fitted article's curve, so a switched-off or shed thruster still has
+     * one; {@link mobilityMetricsResult} is what judges whether the build can use it.
+     * It answers `null` rather than throwing — unlike `frameShiftDrive`, which the jump
+     * equation cannot do without — when no thrusters are fitted or the fitted record
+     * carries no complete curve.
+     *
+     * @example
+     * ```ts
+     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
+     *
+     * const build = ShipLoadout.default('Anaconda');
+     * build.thrusters?.optMass; // -> 1440, tonnes
+     * build.thrusters?.maxMass; // -> 2160, past which the ship does not move at all
+     * ```
+     */
+    get thrusters(): ThrusterParams | null;
     /**
      * The fitted frame shift drive's dimensionless mass factor at a chosen load.
      *
@@ -1380,9 +1477,10 @@ declare class ShipLoadout {
      *
      * @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 Fuel and cargo in tonnes. Only `'maximum'` can come back incomplete: it
-     * validates the whole fitted drive, jump booster included, so a complete one can be
-     * passed straight to {@link jumpRange}.
+     * @returns The fuel and cargo carried, and the {@link StandardLoadInputs.mass} the
+     * ship weighs carrying them, all in tonnes. Only `'maximum'` can come back
+     * incomplete: it validates the whole fitted drive, jump booster included, so a
+     * complete one can be passed straight to {@link jumpRange}.
      * @throws {RangeError} If `load` is not a recognised standard load.
      * @example
      * ```ts
@@ -1392,6 +1490,13 @@ declare class ShipLoadout {
      * const load = build.standardLoadResult('maximum');
      * if (load.complete) build.mobilityMetrics({ ...load.value, enginesPips: 2 });
      * ```
+     * @example
+     * ```ts
+     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
+     *
+     * const build = ShipLoadout.default('Anaconda');
+     * build.standardLoadResult('laden').value?.mass; // -> 1210, tonnes with a full tank and hold
+     * ```
      */
     standardLoadResult(load: StandardLoad): CalculationResult<StandardLoadInputs>;
     /**
@@ -1653,6 +1758,37 @@ declare class ShipLoadout {
      * ```
      */
     buildCost(): BuildCost;
+    /**
+     * Weigh the whole build: the hull, the fitted modules, and the load on top of them.
+     *
+     * @remarks
+     * The mass companion to {@link buildCost}, answering the same question in tonnes
+     * that that one answers in credits. Every module's mass is post-engineering, so a
+     * 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}
+     * weigh; the game's statistics panel additionally counts the reserve in the current
+     * mass it displays, so add {@link 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 standardLoadResult} 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
+     * ```ts
+     * import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';
+     *
+     * const build = ShipLoadout.default('Anaconda');
+     * const mass = build.buildMass();
+     * mass.hull; // -> 400
+     * mass.modules; // -> 664
+     * mass.total; // -> 1096, a full main tank and an empty hold
+     * build.buildMass({ cargo: build.cargoCapacity }).total; // -> 1210
+     * ```
+     */
+    buildMass(options?: JumpOptions): BuildMass;
     /**
      * The build's armour: hull hit points, the bulkhead and reinforcement each
      * contribute, and the effective resistances.
@@ -1744,4 +1880,4 @@ declare class ShipLoadout {
     distributorMetrics(options?: DistributorOptions): DistributorMetrics | null;
 }
 
-export { type ApplyBlueprintOptions, type AvailableBlueprint, type BuildCost, type BuildCredits, type BuildWeaponMetrics, type DefenceOptions, type DistributorOptions, type EngineeringNormalizationCode, type EngineeringNormalizationResult, type EngineeringNormalizationUnchanged, type EngineeringNormalizationUnsupported, type EngineeringNormalized, type ExperimentalEffectMutationCode, type ExperimentalEffectMutationResult, type ExperimentalEffectUnchanged, type ExperimentalEffectUnsupported, type ExperimentalEffectUpdated, type FittedModule, type FittedWeaponMetrics, type FixedMountRepairResult, type ImmovableReason, type JumpOptions, type JumpRangeSummary, LoadoutEditError, type LoadoutEditErrorCode, type LoadoutExportOptions, type LoadoutImportOutcome, type LoadoutSlot, type MobilityOptions, ShipLoadout, type SlefExportOptions, type StandardLoad, type StandardLoadInputs, type WeaponsOptions };
+export { type ApplyBlueprintOptions, type AvailableBlueprint, type BuildCost, type BuildCredits, type BuildMass, type BuildWeaponMetrics, type DefenceOptions, type DistributorOptions, type EngineeringNormalizationCode, type EngineeringNormalizationResult, type EngineeringNormalizationUnchanged, type EngineeringNormalizationUnsupported, type EngineeringNormalized, type ExperimentalEffectMutationCode, type ExperimentalEffectMutationResult, type ExperimentalEffectUnchanged, type ExperimentalEffectUnsupported, type ExperimentalEffectUpdated, type FittedModule, type FittedWeaponMetrics, type FixedMountRepairResult, type ImmovableReason, type JumpOptions, type JumpRangeSummary, LoadoutEditError, type LoadoutEditErrorCode, type LoadoutExportOptions, type LoadoutImportOutcome, type LoadoutSlot, type MobilityOptions, ShipLoadout, type SlefExportOptions, type StandardLoad, type StandardLoadInputs, type WeaponsOptions };

package/dist/ships/ship-loadout.js

@@ -1 +1 @@
-export{LoadoutEditError,ShipLoadout}from"../chunk-ZKU7CMAH.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     //# sourceMappingURL=ship-loadout.js.map
+export{LoadoutEditError,ShipLoadout}from"../chunk-3BM5BHI3.js";                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     //# sourceMappingURL=ship-loadout.js.map

package/dist/ships/slef.d.ts

@@ -91,9 +91,10 @@ interface BlueprintModuleEngineering {
      * so an export from another app may name the blueprint and its roll without spelling
      * out the resulting stats. Treat a missing array as "not stated", not as "nothing was
      * changed". A craftable recipe can be reconstructed with
-     * {@link ShipLoadout.applyBlueprint}; resolve a fixed identity through the
-     * pre-engineered catalogue and fit it with
-     * {@link ShipLoadout.setPreEngineeredVariant}.
+     * {@link ShipLoadout.applyBlueprint}, or rolled where it stands with
+     * {@link ShipLoadout.completeEngineeringGrade}, which spells out a stated identity
+     * at quality `1`; resolve a fixed identity through the pre-engineered catalogue and
+     * fit it with {@link ShipLoadout.setPreEngineeredVariant}.
      */
     readonly Modifiers?: readonly EngineeringModifier[];
 }
@@ -149,13 +150,14 @@ interface LoadoutModule {
  * Only `Ship` and `Modules` are strictly required by SLEF; every other field is
  * optional. Masses are in tonnes, ranges in light-years, values in credits.
  *
- * `timestamp`, `ShipID`, `HullHealth` and `Hot` are deliberately outside the durable
- * loadout shape. They describe the capture or the ship instance/state rather than its
- * fit, so {@link ShipLoadout.fromLoadout} drops them and subsequent loadout/SLEF exports
- * never write them. A tolerant parse still accepts an input object carrying those keys.
+ * `event`, `timestamp`, `ShipID`, `HullHealth` and `Hot` are deliberately outside the
+ * durable loadout shape. They name the journal line, or describe the capture or the ship
+ * instance/state, rather than its fit, so {@link ShipLoadout.fromLoadout} drops them and
+ * subsequent loadout/SLEF exports never write them. A tolerant parse still accepts an
+ * input object carrying those keys.
  */
 interface LoadoutEvent {
-    /** Always `"Loadout"`. */
+    /** `"Loadout"` when a journal line supplied it. Accepted on input, never written. */
     readonly event?: string;
     /** The hull's internal id, e.g. `"explorer_nx"` (lower-cased). */
     readonly Ship: string;