@elite-dangerous-almanac/core 0.1.0-beta.9 → 0.1.2

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

@@ -19,8 +19,9 @@ import './slots.js';
  * gzipped). Consumers that only list variants can import `./pre-engineered.js` without
  * these module catalogues.
  * A journal or SLEF module can instead be classified with
- * {@link identifyPreEngineeredVariant}: it matches the article's reported stat signature
- * and composes an experimental effect added after purchase before comparing values.
+ * {@link identifyPreEngineeredVariant}: it matches a reward article's reported stat signature
+ * and composes an experimental effect added after purchase before comparing values. A Mercenary
+ * article is identified by its Mercenary-only blueprint, including after later grade upgrades.
  *
  * **What is resolved, and what is not.** The module catalogues carry the mechanical
  * stats (mass, integrity, power, capacities, optimal mass), defence stats and weapon
@@ -83,17 +84,32 @@ declare function getPreEngineeredJournalModifiers(variant: PreEngineeredVariant)
 /**
  * Identify the fixed pre-engineered/reward variant described by a fitted loadout module.
  *
- * Matching uses the reported post-engineering stat values rather than trusting the
+ * Reward matching uses the reported post-engineering stat values rather than trusting the
  * blueprint tuple alone: reward variants carry hand-set values that an ordinary roll of
  * the named blueprint does not reproduce. A captured experimental effect is composed
  * with each candidate before comparison, because some fixed articles accept an effect
  * after purchase (the V1 frame-shift drives are the common example).
  *
+ * Mercenary articles are the exception: their bespoke blueprint is available only after
+ * buying the article, while their unpublished purchase modifier block cannot identify it.
+ * The module symbol and blueprint therefore identify the purchase at grade 1 and after
+ * upgrading it through grades 2–5. The fitted grade and experimental effect remain the
+ * loadout's current engineering state; the returned variant carries the original purchase
+ * grade and Merc Coin price.
+ *
+ * A locked fixed article is also identified by its unique
+ * symbol/blueprint/grade/experimental tuple when a SLEF capture omits the `Modifiers` key
+ * entirely. A present empty or partial array does not use this shortcut: older library
+ * exports can carry an ordinary roll with the same tuple, and its values must not be
+ * replaced by reward stats. A third-party export can omit the array from such a roll;
+ * that record is indistinguishable from the fixed article, so the catalogue identity
+ * wins.
+ *
  * Frontier journals and captures may omit a derived modifier, so one predicted value may
  * be absent. Every stated predicted value must agree within journal float noise, and all
  * but at most one must be present. Ambiguous or incomplete evidence returns `null` rather
  * than guessing.
- * Variants without a published stat block cannot be identified this way.
+ * Other variants without a published stat block cannot be identified.
  *
  * @param module - A module from a journal `Loadout` event or SLEF export.
  * @returns The uniquely matching catalogue variant, or `null` when the stats do not

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

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

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

@@ -34,10 +34,9 @@
  * computed. Resolve them against the base module with `getPreEngineeredStats` from
  * `./pre-engineered-stats.js`; it lives in its own module so that consumers who only
  * want the catalogue do not bundle the module and engineering tables.
- * The only pre-engineered Guardian variants are seven Guardian-weapon records. They are
- * final articles and carry {@link PreEngineeredVariant.engineeringLocked}; their stock
- * counterparts can take Anti-Guardian Zone Resistance, but the resolved pre-engineered
- * articles cannot.
+ * Final articles carry {@link PreEngineeredVariant.engineeringLocked}. These are the seven
+ * pre-engineered Guardian weapons, whose stock counterparts can take Anti-Guardian Zone
+ * Resistance, and five fixed Enzyme/AX rewards whose stock modules have no engineering menu.
  *
  * @packageDocumentation
  */
@@ -112,10 +111,10 @@ interface PreEngineeredVariant {
      * Whether the article is final and accepts no further engineering.
      *
      * @remarks
-     * Present as `true` on the pre-engineered Guardian weapons. Their stock counterparts
-     * can take Anti-Guardian Zone Resistance, but the pre-engineered articles cannot:
-     * neither that recipe nor any ordinary weapon recipe may be applied to them.
-     * Absence means this catalogue does not lock further engineering.
+     * Present as `true` on the final pre-engineered Guardian, Enzyme and AX weapons.
+     * Neither a blueprint nor an experimental effect may be applied to these articles,
+     * and their baked engineering cannot be removed. Absence means this catalogue does
+     * not lock further engineering.
      */
     readonly engineeringLocked?: true;
     /**

package/dist/ships/pre-engineered.js

@@ -1 +1 @@
-export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-32PVERNH.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map
+export{PRE_ENGINEERED_MODULES,getPreEngineeredVariants,isPreEngineered}from"../chunk-EU42PAV4.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map

package/dist/ships/shield-recovery.d.ts

@@ -51,6 +51,8 @@ interface CellBankInput {
     readonly duration: number;
     /** Heat generated by one activation, in the game's thermal-load units. */
     readonly heat: number;
+    /** Whether the fitted bank is switched on and receiving power. Must be a boolean. */
+    readonly powered: boolean;
 }
 /** One fitted bank as exposed in a {@link CellBankSummary}. */
 interface CellBankMetrics {
@@ -68,14 +70,16 @@ interface CellBankMetrics {
     readonly duration: number;
     /** Heat generated by one activation, in the game's thermal-load units. */
     readonly heat: number;
+    /** Whether the fitted bank is switched on and receiving power. */
+    readonly powered: boolean;
 }
-/** Every fitted shield cell bank and its combined pool. */
+/** Every fitted shield cell bank and the combined pool available from powered banks. */
 interface CellBankSummary {
     /** Fitted banks in slot order. */
     readonly banks: readonly CellBankMetrics[];
-    /** Megajoules restorable across every bank and cell. */
+    /** Megajoules restorable across every powered bank and cell. */
     readonly totalRestorable: number;
-    /** Cells aboard across every fitted bank. */
+    /** Cells aboard across every powered bank. */
     readonly totalCells: number;
 }
 /**
@@ -97,17 +101,19 @@ interface CellBankSummary {
  */
 declare function shieldRecovery(input: ShieldRecoveryInput): ShieldRecovery;
 /**
- * Aggregate fitted shield cell banks.
+ * Aggregate fitted shield cell banks while retaining their individual power state.
  *
  * @param banks - Banks in the order their slots should be reported.
- * @returns Frozen per-bank metrics and totals. An empty input returns an empty bank list and zero totals.
+ * @returns Frozen per-bank metrics and totals over powered banks. An empty input returns
+ * an empty bank list and zero totals.
+ * @throws {TypeError} If any bank's `powered` value is not a boolean.
  * @example
  * ```ts
  * import { cellBankSummary } from '@elite-dangerous-almanac/core/ships/shield-recovery';
  *
  * cellBankSummary([{
  *   slot: 'Slot01_Size6', symbol: 'bank', reinforcementRate: 12,
- *   cells: 4, spinUp: 5, duration: 1, heat: 170,
+ *   cells: 4, spinUp: 5, duration: 1, heat: 170, powered: true,
  * }]).totalRestorable; // -> 48
  * ```
  */

package/dist/ships/shield-recovery.js

@@ -1 +1 @@
-export{cellBankSummary,shieldRecovery}from"../chunk-MPZGCTRG.js";                             //# sourceMappingURL=shield-recovery.js.map
+export{cellBankSummary,shieldRecovery}from"../chunk-VZZUNSDF.js";                             //# sourceMappingURL=shield-recovery.js.map