@elite-dangerous-almanac/core 0.2.7 → 0.2.9

package/dist/ships/default-loadouts.d.ts

@@ -31,7 +31,7 @@ interface DefaultLoadout {
     readonly modules: readonly DefaultLoadoutModule[];
 }
 /**
- * Default loadouts for all 48 player-flyable hulls, in
+ * Default loadouts for every player-flyable hull, in
  * {@link ships!SHIPS | SHIPS} catalogue order.
  *
  * @remarks
@@ -42,7 +42,6 @@ interface DefaultLoadout {
  * ```ts
  * import { DEFAULT_LOADOUTS } from '@elite-dangerous-almanac/core/ships/default-loadouts';
  *
- * DEFAULT_LOADOUTS.length; // -> 48
  * DEFAULT_LOADOUTS[0]?.modules.find((module) => module.slot === 'FrameShiftDrive')?.symbol;
  * // -> 'Int_Hyperdrive_Size2_Class1'
  * ```
@@ -60,7 +59,7 @@ declare const DEFAULT_LOADOUTS: readonly DefaultLoadout[];
  * ```ts
  * import { getDefaultLoadout } from '@elite-dangerous-almanac/core/ships/default-loadouts';
  *
- * getDefaultLoadout(' sidewinder ')?.modules.length; // -> 16
+ * getDefaultLoadout(' sidewinder ')?.symbol; // -> 'SideWinder'
  * getDefaultLoadout('not_a_ship'); // -> null
  * ```
  */

package/dist/ships/default-loadouts.js

@@ -1 +1 @@
-export{DEFAULT_LOADOUTS,getDefaultLoadout}from"../chunk-GRIK3EDH.js";                                                                                       //# sourceMappingURL=default-loadouts.js.map
+export{DEFAULT_LOADOUTS,getDefaultLoadout}from"../chunk-KY7KSPU6.js";                                                                                       //# sourceMappingURL=default-loadouts.js.map

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

@@ -8,20 +8,17 @@
  * this module?" is the question the game actually answers. So modules are grouped, and
  * each group lists what it offers.
  *
- * The catalogue groups 1000 of the 1194 modules — every stock module with an ordinary
- * engineering menu. The other 194 have no ordinary menu: whole families (fuel tanks,
+ * The catalogue groups every stock module with an ordinary engineering menu. The rest
+ * have no ordinary menu: whole families (fuel tanks,
  * cargo racks, passenger cabins, the repair, recon, research, decontamination and
  * multi-limpet controllers, meta-alloy and ordinary module reinforcement, the Pulse Wave
  * Analyser, the mining launchers, Shock Cannons, Nanite Torpedo Pylons, fighter and vehicle
  * hangars, docking computers and Supercruise Assist, the module stabilisers, the planetary
  * approach suites, the cargo hatch and the AX utility modules), plus the individual
  * modules denied every ordinary blueprint — every anti-xeno multi-cannon and missile rack,
- * the Enzyme Missile Rack, all seven mining tools, the remote-release launchers and the Mk II
- * Plasma Shock Accelerator. Six module symbols without a menu still have a Mercenary upgrade
- * route: the Enzyme Missile Rack, fixed Mining Laser, fixed Abrasion Blaster, size-5 class-2
- * Module Reinforcement Package, and size-5 and size-6 cargo racks. Their qualifying articles can
- * take grades 2–5 of their bespoke recipes through
- * `ships/pre-engineered`; fixed community-goal cargo racks remain final articles.
+ * the Enzyme Missile Rack, every mining tool, the remote-release launchers and the Mk II
+ * Plasma Shock Accelerator. A few module symbols without a menu still have a Mercenary
+ * upgrade route through `ships/pre-engineered`; {@link getEngineeringGroup} names them.
  *
  * **A group is one menu.** Where the same kind of module comes in two flavours with
  * different menus, they are two groups: a Guardian Power Plant takes only Anti-Guardian
@@ -102,8 +99,7 @@ interface EngineeringOptionGroup {
  * ```ts
  * import { ENGINEERING_OPTION_GROUPS } from '@elite-dangerous-almanac/core/ships/engineering-options';
  *
- * ENGINEERING_OPTION_GROUPS['beamLasers'].experimentals.length; // -> 9
- * ENGINEERING_OPTION_GROUPS['beamLasers'].blueprints.length; // -> 7
+ * ENGINEERING_OPTION_GROUPS['beamLasers'].blueprints.includes('Weapon_Efficient'); // -> true
  * ```
  */
 declare const ENGINEERING_OPTION_GROUPS: Readonly<Record<EngineeringGroupId, EngineeringOptionGroup>>;
@@ -111,11 +107,13 @@ declare const ENGINEERING_OPTION_GROUPS: Readonly<Record<EngineeringGroupId, Eng
  * The group id a module is engineered as, or `null` when this catalogue does not group
  * it.
  *
- * `null` means **"this stock module has no ordinary engineering menu"**. For 188 of the
- * 194 ungrouped modules that is the same as "has no engineering route". Six instead
- * retain Mercenary upgrade routes: the Enzyme Missile Rack, fixed Mining Laser and Abrasion
+ * `null` means **"this stock module has no ordinary engineering menu"**. For nearly every
+ * ungrouped module that is the same as "has no engineering route". A few instead keep a
+ * Mercenary upgrade route: the Enzyme Missile Rack, fixed Mining Laser and Abrasion
  * Blaster, size-5 and size-6 cargo racks, and size-5 class-2 Module Reinforcement Package
- * have no stock menu while their qualifying Mercenary articles retain bespoke upgrade routes.
+ * have no stock menu, while their qualifying Mercenary articles take grades 2–5 of their
+ * bespoke recipes through `ships/pre-engineered`. The fixed community-goal cargo racks are
+ * final articles.
  * The build corpus also contains an unsupported declaration on the Mk II Plasma Shock
  * Accelerator, which upstream denies every blueprint.
  *
@@ -184,15 +182,15 @@ declare function getBlueprintsForModule(symbol: string): readonly string[];
  * Every experimental effect in a stock module's ordinary menu — its group's list, minus
  * the effects that particular module is excluded from.
  *
- * Most modules take their whole group's list, but 23 are exceptions: 13 Multi-cannons
- * cannot take Phasing Sequence, six dumbfire racks cannot take Drag Munitions, and four
+ * Most modules take their whole group's list, but some are exceptions: most Multi-cannons
+ * cannot take Phasing Sequence, dumbfire racks cannot take Drag Munitions, and some
  * missile racks are short of Penetrator Munitions or FSD Interrupt. Those are applied
  * here, so the result is the exact set for this module.
  *
- * **An empty array is the common answer, and it usually means "blueprints only".** 368
- * of the 1000 grouped modules have no experimental slot; all sit in the 27 of 48 groups
- * that offer none — life support, sensors, the limpet controllers, the utility scanners,
- * and every Guardian group, weapons and modules alike. An ungrouped module answers empty
+ * **An empty array is the common answer, and it usually means "blueprints only".** Whole
+ * groups offer no experimental effect at all — life support, sensors, the limpet
+ * controllers, the utility scanners, and every Guardian group, weapons and modules alike
+ * — so every module in them answers empty. An ungrouped module answers empty
  * too; {@link getEngineeringGroup} tells the two apart.
  *
  * @param symbol - A module symbol. Leading/trailing whitespace and case are ignored.
@@ -204,10 +202,10 @@ declare function getBlueprintsForModule(symbol: string): readonly string[];
  * ```ts
  * import { getExperimentalsForModule } from '@elite-dangerous-almanac/core/ships/engineering-options';
  *
- * getExperimentalsForModule('Hpt_MultiCannon_Fixed_Medium').length; // -> 12
+ * getExperimentalsForModule('Hpt_MultiCannon_Fixed_Medium').includes('special_phasing_sequence'); // -> true
  *
  * // The small Multi-cannon is one effect short — no Phasing Sequence.
- * getExperimentalsForModule('Hpt_MultiCannon_Fixed_Small').length; // -> 11
+ * getExperimentalsForModule('Hpt_MultiCannon_Fixed_Small').includes('special_phasing_sequence'); // -> false
  *
  * // The stock Abrasion Blaster has no ordinary engineering menu.
  * getExperimentalsForModule('Hpt_Mining_AbrBlstr_Fixed_Small'); // -> []
@@ -222,19 +220,18 @@ declare function getExperimentalsForModule(symbol: string): readonly string[];
  * `Weapon_LongRange` does not offer every effect listed here, only its own group's. Use
  * {@link getExperimentalsForModule} once you know the module — that is the exact answer.
  *
- * The groups name 85 of the 107 blueprints in `BLUEPRINTS`. Of the other 22, 21 are
- * Operations keys of modules sold already engineered rather than offered in a menu (see
- * `ships/pre-engineered`); the last is the fixed Expanded Cargo Rack reward identity.
- * All 22 answer `[]` here exactly as an unknown id would, so read this function's empty answer with
+ * The groups do not name every id in `BLUEPRINTS`. The ones they miss are Operations keys
+ * of modules sold already engineered rather than offered in a menu (see
+ * `ships/pre-engineered`), plus the fixed Expanded Cargo Rack reward identity.
+ * They answer `[]` here exactly as an unknown id would, so read this function's empty answer with
  * {@link getExperimentalsForModule} rather than as a claim about the recipe.
  *
- * Four Operations keys **are** named by a group, because they are recipes a player applies
+ * Some Operations keys **are** named by a group, because they are recipes a player applies
  * rather than a purchase: the Merc-Coin blueprints published with a full grade 1–5,
- * `FuelScoop_Efficiency` and the three lasers' `PulseLaser_ThermalPlasmaConversion`,
- * `BurstLaser_ThermalPlasmaConversion` and
- * `BeamLaser_ThermalPlasmaConversion`. Anti-Guardian Zone Resistance answers `[]`, and there
- * that is the exact answer rather
- * than a miss: it has no experimental slot, on any of the nine groups that offer it.
+ * `FuelScoop_Efficiency` and the lasers' `PulseLaser_ThermalPlasmaConversion`,
+ * `BurstLaser_ThermalPlasmaConversion` and `BeamLaser_ThermalPlasmaConversion`.
+ * Anti-Guardian Zone Resistance answers `[]`, and there that is the exact answer rather
+ * than a miss: it has no experimental slot, on any group that offers it.
  *
  * @param blueprintSymbol - A blueprint recipe's Frontier symbol, e.g. `"Weapon_Efficient"`.
  * Leading/trailing whitespace and case are ignored.

package/dist/ships/engineering-options.js

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

package/dist/ships/engineering.d.ts

@@ -37,8 +37,7 @@ import './slots.js';
  * Frontier exposes; {@link ShipLoadout.applyBlueprint} performs that presentation step.
  *
  * The catalogues live in `./blueprints` and `./experimental-effects`; this module
- * holds no data. {@link ShipLoadout.applyBlueprint} uses this calculator, then presents
- * its result in Frontier's journal form.
+ * holds no data.
  *
  * @example
  * ```ts

package/dist/ships/engineering.js

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

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

@@ -41,7 +41,7 @@ declare const EXPERIMENTAL_EFFECT_COSTS: Readonly<Record<string, readonly Engine
  *
  * @remarks
  * Materials are the whole cost: an experimental effect charges no Merc Coin, unlike the
- * 25 blueprints whose {@link ships/blueprint-costs!getBlueprintCost | getBlueprintCost}
+ * blueprints whose {@link ships/blueprint-costs!getBlueprintCost | getBlueprintCost}
  * reports a non-zero `mercCoins`.
  *
  * @param experimentalEffectSymbol - The effect id, e.g. `"special_fsd_heavy"`, matched

package/dist/ships/gunsights.d.ts

@@ -49,9 +49,9 @@ type ShipGunsightCatalogue = Readonly<Record<string, ShipGunsight>>;
  * by {@link ships!SHIPS | SHIPS}.
  *
  * @remarks
- * The map, each hull array and every offset pair are deeply frozen. It contains 48
- * hulls and 234 hardpoints. Importing this module adds only the compact offset map; it
- * does not import the ship or outfitting catalogues.
+ * The map, each hull array and every offset pair are deeply frozen. It covers every
+ * hardpoint of every player-flyable hull. Importing this module adds only the compact
+ * offset map; it does not import the ship or outfitting catalogues.
  *
  * @example
  * ```ts

package/dist/ships/heat.d.ts

@@ -13,7 +13,7 @@
  * settles at     heatLevel = √(thermal load / heatDissipation)
  * ```
  *
- * Two consequences are worth stating outright, because they are what the numbers mean:
+ * Two consequences follow, and they are what the numbers mean:
  * a build whose thermal load stays under the hull's `heatDissipation` **always settles**
  * below heat level `1` and never overheats, however long it holds the trigger; and one
  * whose load goes over it **never settles** — heat climbs until the ship cooks, and the

package/dist/ships/index.d.ts

@@ -28,7 +28,7 @@
  *   {@link ships/default-loadouts!DEFAULT_LOADOUTS | default-loadouts} subpath carries
  *   the stock modules {@link ShipLoadout.default} turns into a live build.
  * - **Modules** — the {@link OutfittingModule} type and the lookups
- *   ({@link getModuleBySymbol} & co.), which search all 1194 modules unless you hand
+ *   ({@link getModuleBySymbol} & co.), which search the whole catalogue unless you hand
  *   them a narrower set; capability guards such as {@link hasWeaponDamageStats} narrow
  *   the sparse record before stat access. The catalogues live on explicit subpaths split
  *   by Frontier's four outfitting categories —
@@ -111,8 +111,8 @@
  * ```
  *
  * @example
- * **The lookup layer.** One small hull catalogue, and 1194 modules split by Frontier's
- * four outfitting categories. Lookups ignore case and surrounding whitespace.
+ * **The lookup layer.** One small hull catalogue, and the outfitting modules split by
+ * Frontier's four categories. Lookups ignore case and surrounding whitespace.
  *
  * ```ts
  * import { getShipBySymbol } from '@elite-dangerous-almanac/core/ships/ships';
@@ -121,8 +121,7 @@
  *
  * getShipBySymbol('empire_trader')?.name; // -> 'Imperial Clipper'
  *
- * // Pass a category to bound what you bundle; omit it to search all 1194.
- * CORE_MODULES.length; // -> 516
+ * // Pass a category to bound what you bundle; omit it to search every module.
  * getModuleBySymbol('Int_Hyperdrive_Size6_Class5', CORE_MODULES)?.name;
  * // -> 'Frame Shift Drive'
  * ```

package/dist/ships/index.js

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

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

@@ -31,7 +31,7 @@ type LoadoutIssueCode = 'duplicateSlot' | 'unknownSlot' | 'missingRequiredSlot'
  * @remarks
  * `dry` is the fit alone — hull plus modules, an empty tank and no cargo. `unladen`
  * adds a full main tank, and is the figure the game and every outfitting tool call a
- * ship's unladen mass; note that {@link ships!ShipLoadout.unladenMass} is the `dry`
+ * ship's unladen mass; {@link ships!ShipLoadout.unladenMass} is the `dry`
  * figure, because that is what a journal's `UnladenMass` states. `laden` adds a full
  * hold on top.
  *
@@ -39,8 +39,13 @@ type LoadoutIssueCode = 'duplicateSlot' | 'unknownSlot' | 'missingRequiredSlot'
  * Failing only at `laden` is a warning: the hold is the one load a pilot chooses.
  */
 type ThrusterLoad = 'dry' | 'unladen' | 'laden';
-/** Stable machine-readable constraint behind an `incompatibleModule` issue. */
-type ModuleFitConstraint = 'immutableSlot' | 'armourRequired' | 'wrongHullArmour' | 'restrictedHull' | 'restrictedMount' | 'wrongCoreType' | 'hardpointRequired' | 'utilityRequired' | 'optionalInternalRequired' | 'coreModuleInOptionalSlot' | 'oversized' | 'unknownConstraint';
+/**
+ * Stable machine-readable constraint behind an `incompatibleModule` issue.
+ *
+ * `builtInHullModule` is the only one that does not depend on the mount: the cargo hatch
+ * comes with the hull and goes in no mount an editor can set.
+ */
+type ModuleFitConstraint = 'immutableSlot' | 'builtInHullModule' | 'armourRequired' | 'wrongHullArmour' | 'restrictedHull' | 'restrictedMount' | 'wrongCoreType' | 'hardpointRequired' | 'utilityRequired' | 'optionalInternalRequired' | 'coreModuleInOptionalSlot' | 'oversized' | 'unknownConstraint';
 /**
  * One language-neutral value carried by a structured loadout diagnostic: a scalar
  * string/number, or a string list the consumer can format for its locale. Paired name

package/dist/ships/loadout-validation.js

@@ -1 +1 @@
-export{validateLoadout}from"../chunk-MVBVXK3G.js";                                                                                       //# sourceMappingURL=loadout-validation.js.map
+export{validateLoadout}from"../chunk-3GNYPM6J.js";                                                                                       //# sourceMappingURL=loadout-validation.js.map

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

@@ -32,7 +32,7 @@ type OutfittingFamilyId = 'armour' | 'powerPlants' | 'engines' | 'fsd' | 'lifeSu
  *
  * @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
+ * and the Almanac's descriptive name for the families it does not. They are
  * canonical English, not localized UI text: use
  * `getOutfittingFamilyName` for a locale.
  *

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

@@ -9,7 +9,7 @@ import './slots.js';
  *
  * @remarks
  * **This module pulls in every module catalogue** — it exists for consumers that
- * really do want to search all 1194 modules (a "resolve any module id" lookup, say).
+ * really do want to search every module (a "resolve any module id" lookup, say).
  * If you only need one category, import that catalogue's module
  * (`./modules-core`, `./modules-internal`, `./modules-hardpoint`,
  * `./modules-utility`) and nothing else gets bundled.
@@ -35,8 +35,7 @@ import './slots.js';
  * ```ts
  * import { ALL_MODULES } from '@elite-dangerous-almanac/core/ships/modules-all';
  *
- * ALL_MODULES.length;                                          // -> 1194
- * ALL_MODULES.filter((m) => m.category === 'utility').length;  // -> 35
+ * ALL_MODULES.find((m) => m.symbol === 'Hpt_PulseLaser_Fixed_Small')?.category; // -> 'hardpoint'
  * ```
  */
 declare const ALL_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-all.js

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

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

@@ -20,20 +20,20 @@ import './slots.js';
  */
 
 /**
- * All 516 core internal modules, in Frontier's registry order.
+ * Every core internal module, in Frontier's registry order.
  *
  * @remarks
  * Every record has `category: 'core'`, added from the file it was read from
  * rather than repeated on every record. To keep the other three categories out of
  * your bundle, search this array directly — `CORE_MODULES.find((m) =>
  * m.symbol.toLowerCase() === wanted)`, lower-cased because a journal's symbols are —
- * rather than with the lookups in `./modules`, which default to all 1194 modules.
+ * rather than with the lookups in `./modules`, which default to the whole catalogue.
  *
  * @example
  * ```ts
  * import { CORE_MODULES } from '@elite-dangerous-almanac/core/ships/modules-core';
  *
- * CORE_MODULES.length; // -> 516
+ * CORE_MODULES.find((m) => m.symbol === 'Int_Powerplant_Size3_Class5')?.rating; // -> 'A'
  * ```
  */
 declare const CORE_MODULES: readonly OutfittingModule[];

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

@@ -21,22 +21,21 @@ import './slots.js';
  */
 
 /**
- * All 159 hardpoint modules, in Frontier's registry order.
+ * Every hardpoint module, in Frontier's registry order.
  *
  * @remarks
  * Every record has `category: 'hardpoint'`, added from the file it was read from
  * rather than repeated on every record. To keep the other three categories out of
  * your bundle, search this array directly — `HARDPOINT_MODULES.find((m) =>
  * m.symbol.toLowerCase() === wanted)`, lower-cased because a journal's symbols are —
- * rather than with the lookups in `./modules`, which default to all 1194 modules.
+ * rather than with the lookups in `./modules`, which default to the whole catalogue.
  *
  * @example
  * ```ts
  * import { HARDPOINT_MODULES } from '@elite-dangerous-almanac/core/ships/modules-hardpoint';
  *
- * HARDPOINT_MODULES.length; // -> 159
- * HARDPOINT_MODULES.filter((m) => m.familyId === 'beamLasers').length; // -> 12
- * HARDPOINT_MODULES.filter((m) => m.mount === 'Turreted').length; // turreted variants
+ * HARDPOINT_MODULES.find((m) => m.symbol === 'Hpt_PulseLaser_Fixed_Small')?.mount; // -> 'Fixed'
+ * HARDPOINT_MODULES.find((m) => m.familyId === 'beamLasers')?.name; // -> 'Beam Laser'
  * ```
  */
 declare const HARDPOINT_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-hardpoint.js

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

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

@@ -7,12 +7,14 @@ import './slots.js';
  * The **optional internal** modules — the `internal` outfitting category:
  * everything that fills an optional internal slot (cargo racks, shield generators,
  * fuel scoops, refineries, passenger cabins, limpet and planetary controllers,
- * hull/module reinforcement, …).
+ * hull/module reinforcement, …), plus the articles the registry files here that an
+ * optional slot does not take: the hull's own Cargo Hatch and the Guardian hybrid
+ * power plants and distributors, which go in a core mount.
  *
  * The other categories live in `./modules-core`, `./modules-hardpoint` and
  * `./modules-utility`, so importing this module never bundles them.
  *
- * Identity primarily from EDCD FDevIDs (`outfitting.csv`), with six bundle-granted
+ * Identity primarily from EDCD FDevIDs (`outfitting.csv`), with the bundle-granted
  * Vessel Hangar variants from a public CAPI capture; stats from EDCD/coriolis-data and
  * EDSY, joined on `symbol`. See [`data/ships/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/ships/SOURCES.md).
  *
@@ -20,21 +22,29 @@ import './slots.js';
  */
 
 /**
- * All 484 optional internal modules, in registry order.
+ * Every module in the `internal` outfitting category, in registry order.
  *
  * @remarks
  * Every record has `category: 'internal'`, added from the file it was read from
- * rather than repeated on every record. To keep the other three categories out of
- * your bundle, search this array directly — `INTERNAL_MODULES.find((m) =>
- * m.symbol.toLowerCase() === wanted)`, lower-cased because a journal's symbols are —
- * rather than with the lookups in `./modules`, which default to all 1194 modules.
+ * rather than repeated on every record. **The category is the registry's filing, not a
+ * fitting rule**, so do not read a fit off it: `ModularCargoBayDoor` (family
+ * `cargoHatches`) is the hull's built-in Cargo Hatch and goes in the fixed `CargoHatch`
+ * mount alone; the Guardian hybrid power plants and distributors carry a core
+ * {@link ships!OutfittingModule.slot | slot} and fit only that core mount; and others
+ * here reserve a restricted mount or a named hull. Ask
+ * {@link ships!ShipLoadout.modulesForSlot | ShipLoadout.modulesForSlot} what a mount
+ * takes rather than filtering this array by size.
+ *
+ * To keep the other three categories out of your bundle, search this array directly —
+ * `INTERNAL_MODULES.find((m) => m.symbol.toLowerCase() === wanted)`, lower-cased because
+ * a journal's symbols are — rather than with the lookups in `./modules`, which default
+ * to the whole catalogue.
  *
  * @example
  * ```ts
  * import { INTERNAL_MODULES } from '@elite-dangerous-almanac/core/ships/modules-internal';
  *
- * INTERNAL_MODULES.length; // -> 484
- * INTERNAL_MODULES.filter((m) => m.familyId === 'cargoRacks').length; // -> 16
+ * INTERNAL_MODULES.find((m) => m.symbol === 'Int_CargoRack_Size1_Class1')?.familyId; // -> 'cargoRacks'
  * ```
  */
 declare const INTERNAL_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-internal.js

@@ -1 +1 @@
-export{INTERNAL_MODULES}from"../chunk-FMA36V6A.js";                                                          //# sourceMappingURL=modules-internal.js.map
+export{INTERNAL_MODULES}from"../chunk-7Y5EK2VO.js";                                                          //# sourceMappingURL=modules-internal.js.map

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

@@ -20,21 +20,20 @@ import './slots.js';
  */
 
 /**
- * All 35 utility-mount modules, in Frontier's registry order.
+ * Every utility-mount module, in Frontier's registry order.
  *
  * @remarks
  * Every record has `category: 'utility'`, added from the file it was read from
  * rather than repeated on every record. To keep the other three categories out of
  * your bundle, search this array directly — `UTILITY_MODULES.find((m) =>
  * m.symbol.toLowerCase() === wanted)`, lower-cased because a journal's symbols are —
- * rather than with the lookups in `./modules`, which default to all 1194 modules.
+ * rather than with the lookups in `./modules`, which default to the whole catalogue.
  *
  * @example
  * ```ts
  * import { UTILITY_MODULES } from '@elite-dangerous-almanac/core/ships/modules-utility';
  *
- * UTILITY_MODULES.length; // -> 35
- * UTILITY_MODULES.filter((m) => m.familyId === 'shieldBoosters').length; // -> 5
+ * UTILITY_MODULES.find((m) => m.familyId === 'shieldBoosters')?.symbol; // -> 'Hpt_ShieldBooster_Size0_Class1'
  * ```
  */
 declare const UTILITY_MODULES: readonly OutfittingModule[];

package/dist/ships/modules-utility.js

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

package/dist/ships/modules.d.ts

@@ -5,12 +5,12 @@ import { ModuleSlot, SlotRestriction } from './slots.js';
 /**
  * Outfitting-module types and lookups.
  *
- * Elite Dangerous has ~1200 fittable modules. This module holds the
+ * Elite Dangerous fits ships from a large outfitting registry. This module holds the
  * {@link OutfittingModule} record shape — a module's **identity and its stats**
  * together — and the functions that find one ({@link getModuleBySymbol},
  * {@link getModulesByName}, {@link getBulkheadsForShip}).
  *
- * **Every lookup searches all 1194 modules by default.** A journal `Item` string does
+ * **Every lookup searches every module by default.** A journal `Item` string does
  * not identify its outfitting category, so callers need no category for lookup:
  *
  * ```ts
@@ -21,13 +21,16 @@ import { ModuleSlot, SlotRestriction } from './slots.js';
  * subset — any array you have filtered yourself. The catalogue is also exported split
  * by Frontier's four outfitting categories:
  *
- * | Module | Export | Entries |
- * | --- | --- | --- |
- * | `./modules-core` | `CORE_MODULES` | 516 |
- * | `./modules-internal` | `INTERNAL_MODULES` | 484 |
- * | `./modules-hardpoint` | `HARDPOINT_MODULES` | 159 |
- * | `./modules-utility` | `UTILITY_MODULES` | 35 |
- * | `./modules-all` | `ALL_MODULES` | 1194 (the default) |
+ * Sizes are each module's import graph once your bundler has minified it — the
+ * published package itself is not minified — before any transport compression.
+ *
+ * | Module | Export | Minified | Gzipped |
+ * | --- | --- | --- | --- |
+ * | `./modules-core` | `CORE_MODULES` | ~129 KiB | ~12 KiB |
+ * | `./modules-internal` | `INTERNAL_MODULES` | ~128 KiB | ~13 KiB |
+ * | `./modules-hardpoint` | `HARDPOINT_MODULES` | ~70 KiB | ~8 KiB |
+ * | `./modules-utility` | `UTILITY_MODULES` | ~10 KiB | ~2 KiB |
+ * | `./modules-all` | `ALL_MODULES` | ~335 KiB | ~33 KiB |
  *
  * Those four are for **listing** a category — an outfitting screen's hardpoint tab.
  * They make poor narrowing arguments: no module symbol or display name is shared
@@ -44,7 +47,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 — ~338 KiB minified (~33 KiB gzipped) — since
+ * here pulls all four catalogues — ~337 KiB minified (~33 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:
@@ -73,7 +76,11 @@ import { ModuleSlot, SlotRestriction } from './slots.js';
  *   which are the same seven {@link CoreSlotType}s plus armour. A fuel tank is a `core`
  *   module that also fits an optional slot.
  * - `internal` — optional internals (cargo racks, shield generators, fuel scoops,
- *   passenger cabins, limpet and planetary controllers, …).
+ *   passenger cabins, limpet and planetary controllers, …). The registry also files two
+ *   kinds of article here that no optional slot takes: the built-in Cargo Hatch, which
+ *   fits the hull's own fixed `CargoHatch` mount, and the Guardian hybrid power plants
+ *   and distributors, which carry a core {@link OutfittingModule.slot | slot} and fit
+ *   only that core mount.
  * - `hardpoint` — the weapons and tools mounted on a hardpoint.
  * - `utility` — the small utility-mount fittings (chaff, heat sinks, point defence,
  *   shield boosters, scanners).
@@ -262,7 +269,7 @@ interface OutfittingModuleIdentity {
      * the seven {@link CoreSlotType} core functions.
      *
      * @remarks
-     * Present on every `core` module, and on the fifteen Guardian Hybrid power plants
+     * Present on every `core` module, and on the Guardian Hybrid power plants
      * and power distributors — which Frontier files under `internal`, but which go in
      * a core mount. Absent on everything else, because there is no one mount to name:
      * a weapon, a utility fitting or an ordinary optional internal fits any mount of
@@ -338,8 +345,8 @@ interface OutfittingModuleIdentity {
      * that no outfitting screen sells. Absent on every module a station offers.
      *
      * @remarks
-     * The fifteen are the nine starter `*_free` fittings and the six bundle-granted
-     * Vessel Hangars. Each is a second identity for an article the game already sells:
+     * They are the starter `*_free` fittings and the bundle-granted Vessel Hangars. Each
+     * is a second identity for an article the game already sells:
      * `Int_Engine_Size2_Class1_free` is the 2E Thrusters again, which is why
      * {@link ShipLoadout.modulesForSlot} leaves them out — a picker that offered both
      * would list "2E Thrusters" twice, once unpriced.
@@ -377,7 +384,7 @@ interface OutfittingModuleIdentity {
      * rule: a mount's restriction says which modules it takes, this says which mounts
      * a module goes in. Most restricted families bind one way only — a cargo rack fits
      * a `cargo` mount *and* any unrestricted optional — so this is present on just the
-     * five records the game sells for one kind of mount and nowhere else:
+     * records the game sells for one kind of mount and nowhere else:
      *
      * | Module | Requires |
      * | --- | --- |
@@ -434,12 +441,11 @@ interface OutfittingModuleIdentity {
      * discount or markup, which is what an outfitting screen quotes at 0% discount.
      *
      * @remarks
-     * Absent on the handful of records no registry prices: the starter `*_free`
-     * variants, the two Community Goal Corrosion Resistant Cargo Racks, and the 1B
-     * shield generator — records no outfitting
-     * registry carries a figure for — among them the two Corrosion Resistant Cargo
-     * Racks no station sells, which are not free. Treat `undefined` as "unknown", never
-     * as free — see [`data/ships/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/ships/SOURCES.md).
+     * Absent on the handful of records no registry prices: the grant-only `*_free`
+     * articles, the Community Goal Corrosion Resistant Cargo Racks, which no station
+     * sells but which are not free, and the 1B shield generator. Treat `undefined` as
+     * "unknown", never as free; see
+     * [`data/ships/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/ships/SOURCES.md).
      */
     readonly cost?: number;
 }
@@ -525,8 +531,8 @@ interface OutfittingModuleStats {
      * outfitting screen labels SCO.
      *
      * @remarks
-     * A sparse capability flag on the 36 Overcharge drives and absent everywhere else,
-     * including on the 31 ordinary drives of the same sizes and ratings. Read it rather
+     * A sparse capability flag on the Overcharge drives and absent everywhere else,
+     * including on the 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.
@@ -601,7 +607,7 @@ interface OutfittingModuleStats {
      * @remarks
      * A sparse capability flag rather than a percentage: `true` means the protection is
      * inherent or the grade-1 blueprint grants it, while absence means it is not granted.
-     * The two Guardian Nanite Torpedo Pylons carry it inherently; read engineered
+     * The Guardian Nanite Torpedo Pylons carry it inherently; read engineered
      * protection from a fitted module's {@link FittedModule.effectiveStats}.
      */
     readonly guardianZoneResistance?: boolean;
@@ -798,7 +804,7 @@ interface OutfittingModule extends OutfittingModuleIdentity, OutfittingModuleSta
  * @param symbol - The internal identifier, e.g. `"Hpt_PulseLaser_Fixed_Small"`.
  * Leading/trailing whitespace and case are ignored, so the journal's lower-cased
  * form resolves too.
- * @param modules - Optional subset to search instead of all 1194 modules —
+ * @param modules - Optional subset to search instead of every module —
  * `CORE_MODULES`, `INTERNAL_MODULES`, `HARDPOINT_MODULES`, `UTILITY_MODULES`, or any
  * array you have filtered yourself. Omit it unless you specifically want to exclude
  * the other categories; a symbol is unique across all four.

package/dist/ships/modules.js

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