@elite-dangerous-almanac/core 0.1.7 → 0.2.0

package/dist/equipment/upgrade-costs.js

@@ -1 +1 @@
-import{sumPersonalEngineeringIngredients}from"../chunk-C5HG4GJI.js";import{getPersonalWeaponBySymbol}from"../chunk-OCND33TO.js";import{getSuitByFamily}from"../chunk-TMMGS6TC.js";                                                          import{deepFreeze}from"../chunk-DURKO7JU.js";var upgrade_costs_default={suits:{utilitysuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"carbonfibreplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"carbonfibreplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"carbonfibreplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"carbonfibreplating",count:12},{symbol:"graphene",count:12}]},tacticalsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"titaniumplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"titaniumplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"titaniumplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"titaniumplating",count:12},{symbol:"graphene",count:12}]},explorationsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"aerogel",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"aerogel",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"aerogel",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"aerogel",count:12},{symbol:"graphene",count:12}]}},weaponGroups:{takada:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"opticalfibre",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"opticalfibre",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"opticalfibre",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"opticalfibre",count:12}]},manticore:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"chemicalsuperbase",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"chemicalsuperbase",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"chemicalsuperbase",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"chemicalsuperbase",count:12}]},karma:{2:[{symbol:"weaponschematic",count:1},{symbol:"compressionliquefiedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"weaponcomponent",count:2},{symbol:"tungstencarbide",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"compressionliquefiedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"weaponcomponent",count:5},{symbol:"tungstencarbide",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"compressionliquefiedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"weaponcomponent",count:9},{symbol:"tungstencarbide",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"compressionliquefiedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"weaponcomponent",count:12},{symbol:"tungstencarbide",count:12}]}}};var PERSONAL_UPGRADE_COSTS=deepFreeze(upgrade_costs_default);function getSuitUpgradeStepCost(family,targetGrade){assertTargetGrade(targetGrade,"getSuitUpgradeStepCost");const costs=getSuitUpgradeCosts(family);return costs?.[String(targetGrade)]??null}function getSuitUpgradeCost(family,targetGrade,currentGrade=1){assertGrade(targetGrade,"getSuitUpgradeCost: targetGrade");assertGrade(currentGrade,"getSuitUpgradeCost: currentGrade");const costs=getSuitUpgradeCosts(family);if(!costs)return null;return totalCosts(costs,targetGrade,currentGrade)}function getPersonalWeaponUpgradeStepCost(symbol,targetGrade){assertTargetGrade(targetGrade,"getPersonalWeaponUpgradeStepCost");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup][String(targetGrade)]??null}function getPersonalWeaponUpgradeCost(symbol,targetGrade,currentGrade=1){assertGrade(targetGrade,"getPersonalWeaponUpgradeCost: targetGrade");assertGrade(currentGrade,"getPersonalWeaponUpgradeCost: currentGrade");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return totalCosts(PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup],targetGrade,currentGrade)}function totalCosts(costs,targetGrade,currentGrade){const steps=[];for(let grade=currentGrade+1;grade<=targetGrade;grade++){steps.push(costs[String(grade)])}return sumPersonalEngineeringIngredients(...steps)}function getSuitUpgradeCosts(family){const suit=getSuitByFamily(family);if(!suit||!Object.hasOwn(PERSONAL_UPGRADE_COSTS.suits,suit.family))return null;return PERSONAL_UPGRADE_COSTS.suits[suit.family]}function assertTargetGrade(grade,functionName){if(!Number.isInteger(grade)||grade<2||grade>5){throw new RangeError(`${functionName}: targetGrade must be an integer in [2, 5]`)}}function assertGrade(grade,label){if(!Number.isInteger(grade)||grade<1||grade>5){throw new RangeError(`${label} must be an integer in [1, 5]`)}}export{PERSONAL_UPGRADE_COSTS,getPersonalWeaponUpgradeCost,getPersonalWeaponUpgradeStepCost,getSuitUpgradeCost,getSuitUpgradeStepCost};//# sourceMappingURL=upgrade-costs.js.map
+import{sumPersonalEngineeringIngredients}from"../chunk-C5HG4GJI.js";import{getPersonalWeaponBySymbol}from"../chunk-6GJHUWMO.js";import{getSuitByFamily}from"../chunk-B7EYTZRK.js";                                                                                       import{deepFreeze}from"../chunk-DURKO7JU.js";var upgrade_costs_default={suits:{utilitysuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"carbonfibreplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"carbonfibreplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"carbonfibreplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"carbonfibreplating",count:12},{symbol:"graphene",count:12}]},tacticalsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"titaniumplating",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"titaniumplating",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"titaniumplating",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"titaniumplating",count:12},{symbol:"graphene",count:12}]},explorationsuit:{2:[{symbol:"suitschematic",count:1},{symbol:"healthmonitor",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"aerogel",count:2},{symbol:"graphene",count:2}],3:[{symbol:"suitschematic",count:2},{symbol:"healthmonitor",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"aerogel",count:5},{symbol:"graphene",count:5}],4:[{symbol:"suitschematic",count:4},{symbol:"healthmonitor",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"aerogel",count:9},{symbol:"graphene",count:9}],5:[{symbol:"suitschematic",count:5},{symbol:"healthmonitor",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"aerogel",count:12},{symbol:"graphene",count:12}]}},weaponGroups:{takada:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"opticalfibre",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"opticalfibre",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"opticalfibre",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"opticalfibre",count:12}]},manticore:{2:[{symbol:"weaponschematic",count:1},{symbol:"ionisedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"microelectrode",count:2},{symbol:"chemicalsuperbase",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"ionisedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"microelectrode",count:5},{symbol:"chemicalsuperbase",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"ionisedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"microelectrode",count:9},{symbol:"chemicalsuperbase",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"ionisedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"microelectrode",count:12},{symbol:"chemicalsuperbase",count:12}]},karma:{2:[{symbol:"weaponschematic",count:1},{symbol:"compressionliquefiedgas",count:1},{symbol:"manufacturinginstructions",count:1},{symbol:"weaponcomponent",count:2},{symbol:"tungstencarbide",count:2}],3:[{symbol:"weaponschematic",count:2},{symbol:"compressionliquefiedgas",count:2},{symbol:"manufacturinginstructions",count:2},{symbol:"weaponcomponent",count:5},{symbol:"tungstencarbide",count:5}],4:[{symbol:"weaponschematic",count:4},{symbol:"compressionliquefiedgas",count:4},{symbol:"manufacturinginstructions",count:4},{symbol:"weaponcomponent",count:9},{symbol:"tungstencarbide",count:9}],5:[{symbol:"weaponschematic",count:5},{symbol:"compressionliquefiedgas",count:5},{symbol:"manufacturinginstructions",count:5},{symbol:"weaponcomponent",count:12},{symbol:"tungstencarbide",count:12}]}}};var PERSONAL_UPGRADE_COSTS=deepFreeze(upgrade_costs_default);function getSuitUpgradeStepCost(family,targetGrade){assertTargetGrade(targetGrade,"getSuitUpgradeStepCost");const costs=getSuitUpgradeCosts(family);return costs?.[String(targetGrade)]??null}function getSuitUpgradeCost(family,targetGrade,currentGrade=1){assertGrade(targetGrade,"getSuitUpgradeCost: targetGrade");assertGrade(currentGrade,"getSuitUpgradeCost: currentGrade");const costs=getSuitUpgradeCosts(family);if(!costs)return null;return totalCosts(costs,targetGrade,currentGrade)}function getPersonalWeaponUpgradeStepCost(symbol,targetGrade){assertTargetGrade(targetGrade,"getPersonalWeaponUpgradeStepCost");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup][String(targetGrade)]??null}function getPersonalWeaponUpgradeCost(symbol,targetGrade,currentGrade=1){assertGrade(targetGrade,"getPersonalWeaponUpgradeCost: targetGrade");assertGrade(currentGrade,"getPersonalWeaponUpgradeCost: currentGrade");const weapon=getPersonalWeaponBySymbol(symbol);if(!weapon)return null;return totalCosts(PERSONAL_UPGRADE_COSTS.weaponGroups[weapon.upgradeGroup],targetGrade,currentGrade)}function totalCosts(costs,targetGrade,currentGrade){const steps=[];for(let grade=currentGrade+1;grade<=targetGrade;grade++){steps.push(costs[String(grade)])}return sumPersonalEngineeringIngredients(...steps)}function getSuitUpgradeCosts(family){const suit=getSuitByFamily(family);if(!suit||!Object.hasOwn(PERSONAL_UPGRADE_COSTS.suits,suit.family))return null;return PERSONAL_UPGRADE_COSTS.suits[suit.family]}function assertTargetGrade(grade,functionName){if(!Number.isInteger(grade)||grade<2||grade>5){throw new RangeError(`${functionName}: targetGrade must be an integer in [2, 5]`)}}function assertGrade(grade,label){if(!Number.isInteger(grade)||grade<1||grade>5){throw new RangeError(`${label} must be an integer in [1, 5]`)}}export{PERSONAL_UPGRADE_COSTS,getPersonalWeaponUpgradeCost,getPersonalWeaponUpgradeStepCost,getSuitUpgradeCost,getSuitUpgradeStepCost};//# sourceMappingURL=upgrade-costs.js.map

package/dist/equipment/upgrade-costs.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/equipment/upgrade-costs.ts"],"names":["sumPersonalEngineeringIngredients","getPersonalWeaponBySymbol","getSuitByFamily","deepFreeze","upgrade_costs_default","suits","symbol","weaponGroups","PERSONAL_UPGRADE_COSTS","getSuitUpgradeStepCost","family","targetGrade","assertTargetGrade","costs","getSuitUpgradeCosts","String","getSuitUpgradeCost","currentGrade","assertGrade","totalCosts","getPersonalWeaponUpgradeStepCost","weapon","upgradeGroup","getPersonalWeaponUpgradeCost","steps","grade","push","suit","Object","hasOwn","functionName","Number","isInteger","RangeError","label"],"mappings":"O,yqJA4EO,IAAMQ,uBAA+CL,WACxDC,uBAkBG,SAASK,uBACZC,OACAC,aAEAC,kBAAkBD,YAAa,0BAC/B,MAAME,MAAQC,oBAAoBJ,QAClC,OAAOG,QAAQE,OAAOJ,eAAoD,IAC9E,CAmBO,SAASK,mBACZN,OACAC,YACAM,aAAe,GAEfC,YAAYP,YAAa,mCACzBO,YAAYD,aAAc,oCAC1B,MAAMJ,MAAQC,oBAAoBJ,QAClC,IAAKG,MAAO,OAAO,KACnB,OAAOM,WAAWN,MAAOF,YAAaM,aAC1C,CAiBO,SAASG,iCACZd,OACAK,aAEAC,kBAAkBD,YAAa,oCAC/B,MAAMU,OAASpB,0BAA0BK,QACzC,IAAKe,OAAQ,OAAO,KACpB,OACIb,uBAAuBD,aAAac,OAAOC,cAAcP,OAAOJ,eAAwB,IAEhG,CAoBO,SAASY,6BACZjB,OACAK,YACAM,aAAe,GAEfC,YAAYP,YAAa,6CACzBO,YAAYD,aAAc,8CAC1B,MAAMI,OAASpB,0BAA0BK,QACzC,IAAKe,OAAQ,OAAO,KACpB,OAAOF,WACHX,uBAAuBD,aAAac,OAAOC,cAC3CX,YACAM,aAER,CAEA,SAASE,WACLN,MACAF,YACAM,cAEA,MAAMO,MAAsD,GAC5D,IAAA,IAASC,MAAQR,aAAe,EAAGQ,OAASd,YAAac,QAAS,CAC9DD,MAAME,KAAKb,MAAME,OAAOU,QAC5B,CACA,OAAOzB,qCAAqCwB,MAChD,CAEA,SAASV,oBAAoBJ,QACzB,MAAMiB,KAAOzB,gBAAgBQ,QAC7B,IAAKiB,OAASC,OAAOC,OAAOrB,uBAAuBH,MAAOsB,KAAKjB,QAAS,OAAO,KAC/E,OAAOF,uBAAuBH,MAAMsB,KAAKjB,OAC7C,CAEA,SAASE,kBAAkBa,MAAeK,cACtC,IAAKC,OAAOC,UAAUP,QAAUA,MAAQ,GAAKA,MAAQ,EAAG,CACpD,MAAM,IAAIQ,WAAW,GAAGH,yDAC5B,CACJ,CAEA,SAASZ,YAAYO,MAAeS,OAChC,IAAKH,OAAOC,UAAUP,QAAUA,MAAQ,GAAKA,MAAQ,EAAG,CACpD,MAAM,IAAIQ,WAAW,GAAGC,qCAC5B,CACJ,QAAA1B,uBAAAe,6BAAAH,iCAAAJ,mBAAAP"}
+{"version":3,"sources":["../../src/equipment/upgrade-costs.ts"],"names":["sumPersonalEngineeringIngredients","getPersonalWeaponBySymbol","getSuitByFamily","deepFreeze","upgrade_costs_default","suits","symbol","weaponGroups","PERSONAL_UPGRADE_COSTS","getSuitUpgradeStepCost","family","targetGrade","assertTargetGrade","costs","getSuitUpgradeCosts","String","getSuitUpgradeCost","currentGrade","assertGrade","totalCosts","getPersonalWeaponUpgradeStepCost","weapon","upgradeGroup","getPersonalWeaponUpgradeCost","steps","grade","push","suit","Object","hasOwn","functionName","Number","isInteger","RangeError","label"],"mappings":"O,ssJA4EO,IAAMQ,uBAA+CL,WACxDC,uBAmBG,SAASK,uBACZC,OACAC,aAEAC,kBAAkBD,YAAa,0BAC/B,MAAME,MAAQC,oBAAoBJ,QAClC,OAAOG,QAAQE,OAAOJ,eAAoD,IAC9E,CAoBO,SAASK,mBACZN,OACAC,YACAM,aAAe,GAEfC,YAAYP,YAAa,mCACzBO,YAAYD,aAAc,oCAC1B,MAAMJ,MAAQC,oBAAoBJ,QAClC,IAAKG,MAAO,OAAO,KACnB,OAAOM,WAAWN,MAAOF,YAAaM,aAC1C,CAkBO,SAASG,iCACZd,OACAK,aAEAC,kBAAkBD,YAAa,oCAC/B,MAAMU,OAASpB,0BAA0BK,QACzC,IAAKe,OAAQ,OAAO,KACpB,OACIb,uBAAuBD,aAAac,OAAOC,cAAcP,OAAOJ,eAAwB,IAEhG,CAqBO,SAASY,6BACZjB,OACAK,YACAM,aAAe,GAEfC,YAAYP,YAAa,6CACzBO,YAAYD,aAAc,8CAC1B,MAAMI,OAASpB,0BAA0BK,QACzC,IAAKe,OAAQ,OAAO,KACpB,OAAOF,WACHX,uBAAuBD,aAAac,OAAOC,cAC3CX,YACAM,aAER,CAEA,SAASE,WACLN,MACAF,YACAM,cAEA,MAAMO,MAAsD,GAC5D,IAAA,IAASC,MAAQR,aAAe,EAAGQ,OAASd,YAAac,QAAS,CAC9DD,MAAME,KAAKb,MAAME,OAAOU,QAC5B,CACA,OAAOzB,qCAAqCwB,MAChD,CAEA,SAASV,oBAAoBJ,QACzB,MAAMiB,KAAOzB,gBAAgBQ,QAC7B,IAAKiB,OAASC,OAAOC,OAAOrB,uBAAuBH,MAAOsB,KAAKjB,QAAS,OAAO,KAC/E,OAAOF,uBAAuBH,MAAMsB,KAAKjB,OAC7C,CAEA,SAASE,kBAAkBa,MAAeK,cACtC,IAAKC,OAAOC,UAAUP,QAAUA,MAAQ,GAAKA,MAAQ,EAAG,CACpD,MAAM,IAAIQ,WAAW,GAAGH,yDAC5B,CACJ,CAEA,SAASZ,YAAYO,MAAeS,OAChC,IAAKH,OAAOC,UAAUP,QAAUA,MAAQ,GAAKA,MAAQ,EAAG,CACpD,MAAM,IAAIQ,WAAW,GAAGC,qCAC5B,CACJ,QAAA1B,uBAAAe,6BAAAH,iCAAAJ,mBAAAP"}

package/dist/equipment/weapons.d.ts

@@ -53,7 +53,11 @@ interface PersonalWeapon {
     readonly headshotMultiplier: number;
     /** Nominal effective range in metres. */
     readonly effectiveRange: number;
-    /** Grade records keyed by `"1"` through `"5"`. */
+    /**
+     * Grade records keyed by `"1"` through `"5"` — every weapon carries all five,
+     * unlike {@link Suit.grades}, and `equipment.test.ts` pins that. Read one through
+     * {@link getPersonalWeaponGrade} to get the same nullable answer suits give.
+     */
     readonly grades: Readonly<Record<`${EquipmentGrade}`, PersonalWeaponGrade>>;
 }
 /**
@@ -69,7 +73,8 @@ declare const PERSONAL_WEAPONS: readonly PersonalWeapon[];
 /**
  * Look up a handheld weapon by its Frontier journal symbol, case-insensitively.
  *
- * @param symbol - Journal item id such as `"wpn_m_assaultrifle_kinetic_fauto"`.
+ * @param symbol - Journal item id such as `"wpn_m_assaultrifle_kinetic_fauto"`,
+ * matched case-insensitively after trimming surrounding whitespace.
  * @returns The frozen weapon record, or `null` when unknown.
  * @throws {TypeError} If `symbol` is present and not a string. A nullish symbol is a
  * miss, answered like an unrecognised one.
@@ -100,14 +105,17 @@ declare function getPersonalWeaponByName(name: string): PersonalWeapon | null;
  *
  * @param weapon - A catalogue weapon record.
  * @param grade - Integer grade `1`–`5`.
- * @returns The frozen grade record.
+ * @returns The frozen grade record, or `null` when the record carries no such grade.
+ * Every catalogued weapon carries all five, so the `null` is the same promise
+ * {@link getSuitGrade} makes rather than an outcome the shipped catalogue produces —
+ * write the two the same way and neither can surprise you.
  * @throws {RangeError} If `grade` is not an integer from 1 through 5.
  * @example
  * ```ts
  * import { PERSONAL_WEAPONS, getPersonalWeaponGrade } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponGrade(PERSONAL_WEAPONS[0]!, 5).modificationSlots; // -> 4
+ * getPersonalWeaponGrade(PERSONAL_WEAPONS[0]!, 5)?.modificationSlots; // -> 4
  * ```
  */
-declare function getPersonalWeaponGrade(weapon: PersonalWeapon, grade: number): PersonalWeaponGrade;
+declare function getPersonalWeaponGrade(weapon: PersonalWeapon, grade: number): PersonalWeaponGrade | null;
 
 export { PERSONAL_WEAPONS, type PersonalDamageType, type PersonalFireMode, type PersonalWeapon, type PersonalWeaponClass, type PersonalWeaponEngineeringType, type PersonalWeaponGrade, type PersonalWeaponSlot, type WeaponUpgradeGroup, getPersonalWeaponByName, getPersonalWeaponBySymbol, getPersonalWeaponGrade };

package/dist/equipment/weapons.js

@@ -1 +1 @@
-export{PERSONAL_WEAPONS,getPersonalWeaponByName,getPersonalWeaponBySymbol,getPersonalWeaponGrade}from"../chunk-OCND33TO.js";                                                                                       //# sourceMappingURL=weapons.js.map
+export{PERSONAL_WEAPONS,getPersonalWeaponByName,getPersonalWeaponBySymbol,getPersonalWeaponGrade}from"../chunk-6GJHUWMO.js";                                                                                                                    //# sourceMappingURL=weapons.js.map

package/dist/i18n/blueprints.d.ts

@@ -2,7 +2,7 @@
 /**
  * Look up an engineering blueprint's source-backed display name for a locale.
  *
- * @param fdname - Frontier's blueprint id, such as `"FSD_LongRange"`. Matching ignores
+ * @param blueprintSymbol - Frontier's blueprint id, such as `"FSD_LongRange"`. Matching ignores
  * case and surrounding whitespace.
  * @param locale - A BCP 47 language or regional tag, such as `"de"`, `"de-DE"` or
  * `"en-GB"`. Matching is case-insensitive; underscores are accepted in place of
@@ -11,12 +11,12 @@
  * tag; or `null` when the id is unknown, the locale is
  * unsupported, or the pinned source carries no value for that blueprint and locale.
  * @remarks
- * Names stay keyed per `fdname`: the same English phrase can require different grammar
- * when translated for different module families. This function bundles names only, not
+ * Names stay keyed per blueprint symbol: the same English phrase can require different
+ * grammar when translated for different module families. This function bundles names only, not
  * blueprint modifiers or material costs. Missing translations never silently fall back
  * to English.
- * @throws {TypeError} If `fdname` is present and not a string, or `locale` is not a
- * string. A nullish `fdname` is a lookup miss and returns `null`.
+ * @throws {TypeError} If `blueprintSymbol` is present and not a string, or `locale` is not a
+ * string. A nullish `blueprintSymbol` is a lookup miss and returns `null`.
  * @example
  * ```ts
  * import { getBlueprintName } from '@elite-dangerous-almanac/core/i18n/blueprints';
@@ -26,6 +26,6 @@
  * getBlueprintName('MC_Overcharged', 'fr'); // -> 'Arme surchargée'
  * ```
  */
-declare function getBlueprintName(fdname: string, locale: string): string | null;
+declare function getBlueprintName(blueprintSymbol: string, locale: string): string | null;
 
 export { getBlueprintName };

package/dist/i18n/blueprints.js

@@ -1 +1 @@
-export{getBlueprintName}from"../chunk-Z6XMXMVI.js";                                                                                       //# sourceMappingURL=blueprints.js.map
+export{getBlueprintName}from"../chunk-DBDCOHI4.js";                                                                                       //# sourceMappingURL=blueprints.js.map

package/dist/i18n/diagnostics.d.ts

@@ -6,20 +6,8 @@ import '../ships/slots.js';
 import '../ships/modules.js';
 import '../ships/engineering-options.js';
 import '../ships/module-families.js';
-import '../ships/jump-range.js';
-import '../ships/engineering.js';
-import '../ships/power.js';
-import '../ships/heat.js';
-import '../ships/shields.js';
-import '../ships/resistances.js';
-import '../ships/armour.js';
-import '../ships/weapons.js';
-import '../ships/ammunition.js';
-import '../ships/weapons-capacitor.js';
-import '../ships/distributor.js';
-import '../ships/mobility.js';
-import '../ships/shield-recovery.js';
 import '../ships/pre-engineered.js';
+import '../ships/ammunition.js';
 import '../ships/source-purchase.js';
 
 /** Locale-aware access to the English fallback carried by structured diagnostics. */

package/dist/i18n/engineering-groups.d.ts

@@ -3,6 +3,7 @@
  * Look up an engineering option group's display name.
  *
  * @param groupId - The stable group id used by `EngineeringOptionGroup.groupId`.
+ * Matching ignores case and surrounding whitespace.
  * @param locale - A BCP 47 locale. English covers every group; the current source also
  * supplies partial Russian coverage.
  * @returns The localized group name, or `null` for an unknown group or unavailable locale.

package/dist/i18n/engineering-groups.js

@@ -1 +1 @@
-export{getEngineeringGroupName}from"../chunk-EKQCVCMK.js";                                                                                       //# sourceMappingURL=engineering-groups.js.map
+export{getEngineeringGroupName}from"../chunk-5ZVYRX6Z.js";                                                                                       //# sourceMappingURL=engineering-groups.js.map

package/dist/i18n/experimental-effect-descriptions.d.ts

@@ -2,11 +2,12 @@
 /**
  * Look up an experimental effect's display description.
  *
- * @param fdname - Frontier's experimental-effect id.
+ * @param experimentalEffectSymbol - Frontier's experimental-effect id. Matching ignores case and
+ * surrounding whitespace.
  * @param locale - A BCP 47 locale. The current source supplies canonical English only.
  * @returns The localized description, or `null` when the effect is unknown, has no
  * source description, or the requested locale is unavailable.
- * @throws {TypeError} If a present `fdname` or `locale` is not a string.
+ * @throws {TypeError} If a present `experimentalEffectSymbol` or `locale` is not a string.
  * @example
  * ```ts
  * import { getExperimentalEffectDescription } from '@elite-dangerous-almanac/core/i18n/experimental-effect-descriptions';
@@ -15,6 +16,6 @@
  * getExperimentalEffectDescription('special_auto_loader', 'fr'); // -> null
  * ```
  */
-declare function getExperimentalEffectDescription(fdname: string, locale: string): string | null;
+declare function getExperimentalEffectDescription(experimentalEffectSymbol: string, locale: string): string | null;
 
 export { getExperimentalEffectDescription };

package/dist/i18n/experimental-effect-descriptions.js

@@ -1 +1 @@
-export{getExperimentalEffectDescription}from"../chunk-4S6WB7QR.js";                                                                                       //# sourceMappingURL=experimental-effect-descriptions.js.map
+export{getExperimentalEffectDescription}from"../chunk-FF2X4K5P.js";                                                                                       //# sourceMappingURL=experimental-effect-descriptions.js.map

package/dist/i18n/experimental-effects.d.ts

@@ -2,7 +2,7 @@
 /**
  * Look up an engineering experimental effect's source-backed display name for a locale.
  *
- * @param fdname - Frontier's experimental-effect id, such as
+ * @param experimentalEffectSymbol - Frontier's experimental-effect id, such as
  * `"special_concordant_sequence"`. Matching ignores case and surrounding whitespace.
  * @param locale - A BCP 47 language or regional tag, such as `"de"`, `"de-DE"` or
  * `"en-GB"`. Matching is case-insensitive; underscores are accepted in place of
@@ -14,8 +14,9 @@
  * @remarks
  * This function bundles names only, not modifier mechanics or material costs. Missing
  * translations never silently fall back to English.
- * @throws {TypeError} If `fdname` is present and not a string, or `locale` is not a
- * string. A nullish `fdname` is a lookup miss and returns `null`.
+ * @throws {TypeError} If `experimentalEffectSymbol` is present and not a string, or
+ * `locale` is not a string. A nullish `experimentalEffectSymbol` is a lookup miss and
+ * returns `null`.
  * @example
  * ```ts
  * import { getExperimentalEffectName } from '@elite-dangerous-almanac/core/i18n/experimental-effects';
@@ -25,6 +26,6 @@
  * getExperimentalEffectName('special_concordant_sequence', 'ja-JP'); // -> null
  * ```
  */
-declare function getExperimentalEffectName(fdname: string, locale: string): string | null;
+declare function getExperimentalEffectName(experimentalEffectSymbol: string, locale: string): string | null;
 
 export { getExperimentalEffectName };

package/dist/i18n/experimental-effects.js

@@ -1 +1 @@
-export{getExperimentalEffectName}from"../chunk-CJWFY6OX.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map
+export{getExperimentalEffectName}from"../chunk-DSMLYA2M.js";                                                                                       //# sourceMappingURL=experimental-effects.js.map

package/dist/i18n/index.d.ts

@@ -18,20 +18,8 @@ import '../ships/engineering-options.js';
 import '../ships/module-families.js';
 import '../ships/ship-loadout.js';
 import '../ships/slef.js';
-import '../ships/jump-range.js';
-import '../ships/engineering.js';
-import '../ships/power.js';
-import '../ships/heat.js';
-import '../ships/shields.js';
-import '../ships/resistances.js';
-import '../ships/armour.js';
-import '../ships/weapons.js';
-import '../ships/ammunition.js';
-import '../ships/weapons-capacitor.js';
-import '../ships/distributor.js';
-import '../ships/mobility.js';
-import '../ships/shield-recovery.js';
 import '../ships/pre-engineered.js';
+import '../ships/ammunition.js';
 import '../ships/source-purchase.js';
 
 /**

package/dist/i18n/index.js

@@ -1 +1 @@
-export{getMicroResourceName}from"../chunk-GRSNX36B.js";export{getOutfittingFamilyName}from"../chunk-SD6GNFDX.js";export{getModuleName}from"../chunk-LZYHBFJC.js";export{getPreEngineeredVariantName}from"../chunk-J42ZXLBL.js";export{getShipManufacturer,getShipName}from"../chunk-KJFUNIIY.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getBlueprintName}from"../chunk-Z6XMXMVI.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getEngineeringGroupName}from"../chunk-EKQCVCMK.js";export{getExperimentalEffectDescription}from"../chunk-4S6WB7QR.js";export{getExperimentalEffectName}from"../chunk-CJWFY6OX.js";export{getMaterialName}from"../chunk-TW7LUBHD.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getMicroResourceName}from"../chunk-GRSNX36B.js";export{getOutfittingFamilyName}from"../chunk-SD6GNFDX.js";export{getModuleName}from"../chunk-LZYHBFJC.js";export{getPreEngineeredVariantName}from"../chunk-T62GO4AA.js";export{getShipManufacturer,getShipName}from"../chunk-KJFUNIIY.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getBlueprintName}from"../chunk-DBDCOHI4.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getEngineeringGroupName}from"../chunk-5ZVYRX6Z.js";export{getExperimentalEffectDescription}from"../chunk-FF2X4K5P.js";export{getExperimentalEffectName}from"../chunk-DSMLYA2M.js";export{getMaterialName}from"../chunk-TW7LUBHD.js";                                                                                                                    //# sourceMappingURL=index.js.map

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

@@ -6,10 +6,10 @@ import { PreEngineeredAcquisition } from '../ships/pre-engineered.js';
 interface PreEngineeredVariantIdentity {
     /** Base outfitting-module symbol. */
     readonly symbol: string;
-    /** Frontier blueprint or fixed-reward id. */
-    readonly blueprint: string;
-    /** Frontier experimental-effect id, or `null`/omitted when none is fitted. */
-    readonly experimental?: string | null;
+    /** Frontier blueprint or fixed-reward symbol. */
+    readonly blueprintSymbol: string;
+    /** Frontier experimental-effect symbol, or `null`/omitted when none is fitted. */
+    readonly experimentalEffectSymbol?: string | null;
     /** Route through which the variant is obtained. */
     readonly acquisition: PreEngineeredAcquisition;
 }
@@ -22,14 +22,15 @@ interface PreEngineeredVariantIdentity {
  * @returns The explicit localized name, or `null` for an unknown variant or unavailable
  * translation. Decorative reward names currently have English values only.
  * @throws {TypeError} If `variant` is not an object, a required identity field or a
- * non-null `experimental` value is not a string, or `locale` is not a string.
+ * non-null `experimentalEffectSymbol` value is not a string, or `locale` is not a
+ * string.
  * @example
  * ```ts
  * import { getPreEngineeredVariantName } from '@elite-dangerous-almanac/core/i18n/pre-engineered';
  *
  * getPreEngineeredVariantName({
  *   symbol: 'Hpt_FlakMortar_Turret_Medium',
- *   blueprint: 'Decorative_Red',
+ *   blueprintSymbol: 'Decorative_Red',
  *   acquisition: 'eventReward',
  * }, 'en'); // -> 'Festive Red Remote Release Flak Launcher'
  * ```

package/dist/i18n/pre-engineered.js

@@ -1 +1 @@
-export{getPreEngineeredVariantName}from"../chunk-J42ZXLBL.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map
+export{getPreEngineeredVariantName}from"../chunk-T62GO4AA.js";                                                                                       //# sourceMappingURL=pre-engineered.js.map

package/dist/materials/index.d.ts

@@ -22,14 +22,26 @@
  * getMicroResourceBySymbol('graphene')?.name;     // -> 'Graphene'
  * ```
  *
- * Every lookup also takes an optional trailing argument to **narrow** the search to
- * a subset — one category's catalogue, or an array you have filtered yourself:
+ * The by-key lookups also take an optional trailing argument to **narrow** the search
+ * to a subset — one category's catalogue, or an array you have filtered yourself. It
+ * must be one of the exported catalogues *by reference*; `ALL_MATERIALS` (or omitting
+ * it) is the one that answers from an index rather than a scan:
  *
  * ```ts
- * import { materialsByGrade } from '@elite-dangerous-almanac/core/materials';
+ * import { getMaterialByName } from '@elite-dangerous-almanac/core/materials';
  * import { RAW_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-raw';
  *
- * materialsByGrade(MaterialGrade.Rare, RAW_MATERIALS).length; // -> 7, one per raw line
+ * getMaterialByName('imperial shielding', RAW_MATERIALS); // -> null; it is manufactured
+ * ```
+ *
+ * A lookup that returns an array takes no catalogue — narrow its result, or the subset
+ * you already imported, with `.filter()`:
+ *
+ * ```ts
+ * import { MaterialGrade } from '@elite-dangerous-almanac/core/materials';
+ * import { RAW_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-raw';
+ *
+ * RAW_MATERIALS.filter((m) => m.grade === MaterialGrade.Rare).length; // -> 7, one per raw line
  * ```
  *
  * @packageDocumentation

package/dist/materials/index.js

@@ -1 +1 @@
-export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-MKGJPVPS.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-IOJXLDJN.js";export{ALL_MICRO_RESOURCES}from"../chunk-GVNTKCVF.js";export{ITEM_MICRO_RESOURCES}from"../chunk-WHWFKHV3.js";export{COMPONENT_MICRO_RESOURCES}from"../chunk-HTB52N6S.js";export{CONSUMABLE_MICRO_RESOURCES}from"../chunk-K7L7SMIR.js";export{DATA_MICRO_RESOURCES}from"../chunk-GVLDFJEY.js";                             export{ALL_MATERIALS}from"../chunk-V4C6FIE2.js";export{ENCODED_MATERIALS}from"../chunk-Q5XOGATC.js";export{MANUFACTURED_MATERIALS}from"../chunk-HKXXFIRI.js";export{RAW_MATERIALS}from"../chunk-SQS7672E.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-MRTTQYT5.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-OYR5HUQZ.js";export{ALL_MICRO_RESOURCES}from"../chunk-GVNTKCVF.js";export{ITEM_MICRO_RESOURCES}from"../chunk-WHWFKHV3.js";export{COMPONENT_MICRO_RESOURCES}from"../chunk-HTB52N6S.js";export{CONSUMABLE_MICRO_RESOURCES}from"../chunk-K7L7SMIR.js";export{DATA_MICRO_RESOURCES}from"../chunk-GVLDFJEY.js";                             export{ALL_MATERIALS}from"../chunk-V4C6FIE2.js";export{ENCODED_MATERIALS}from"../chunk-Q5XOGATC.js";export{MANUFACTURED_MATERIALS}from"../chunk-HKXXFIRI.js";export{RAW_MATERIALS}from"../chunk-SQS7672E.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/materials/materials.d.ts

@@ -16,8 +16,9 @@
  * getMaterialByName('iron')?.grade; // -> MaterialGrade.VeryCommon (1)
  * ```
  *
- * Each lookup takes an optional second argument to **narrow** the search to a
- * subset — one category's catalogue, or any array you have filtered yourself:
+ * The three **by-key** lookups take an optional second argument to **narrow** the
+ * search to a subset — one category's catalogue, or any array you have filtered
+ * yourself:
  *
  * | Module | Export | Entries |
  * | --- | --- | --- |
@@ -27,9 +28,19 @@
  * | `./materials-all` | `ALL_MATERIALS` | 146 (the default) |
  *
  * It narrows *results*, not bundle size: importing a lookup pulls all three
- * catalogues, since that is what it falls back to — 16.9 KiB minified for all 146.
+ * catalogues, since that is what it falls back to — 17.2 KiB minified for all 146.
  * {@link materialsInCategory} reaches the same subsets from a plain string.
  *
+ * **Only `ALL_MATERIALS` itself is indexed.** A by-key lookup answers from an O(1)
+ * index when the catalogue you pass *is* `ALL_MATERIALS` — the same object, not a copy
+ * — and scans linearly otherwise, including for `[...ALL_MATERIALS]`, which holds the
+ * same 146 records. Omitting the argument always takes the indexed path, so pass one
+ * only when you mean to exclude the rest.
+ *
+ * The filtering lookups ({@link materialsByGrade}, {@link materialsInLine},
+ * {@link materialsInCategory}) take no catalogue: each returns an array, so narrowing
+ * one is `.filter()` on the result or on the subset you already imported.
+ *
  * Data originates from EDCD FDevIDs, with Thargoid materials absent from that
  * pinned source supplied by INARA; see [`data/materials/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/materials/SOURCES.md).
  *
@@ -168,10 +179,14 @@ interface Material {
  * Here, `symbol` is Frontier's internal item id for the material.
  *
  * @param symbol - The internal symbol, e.g. `"GridResistors"`, or the lower-cased
- * form the player journal reports (`"gridresistors"`).
+ * form the player journal reports (`"gridresistors"`). Leading/trailing whitespace
+ * and case are ignored.
  * @param materials - Optional subset to search instead of all 146 materials —
  * `RAW_MATERIALS`, `MANUFACTURED_MATERIALS`, `ENCODED_MATERIALS`, or any array you
- * have filtered yourself. Omit it unless you specifically want to exclude the rest.
+ * have filtered yourself. Omit it unless you specifically want to exclude the rest:
+ * the indexed O(1) path is taken only when the argument is omitted or is
+ * `ALL_MATERIALS` **by reference**, and every other array — a copy of that same
+ * catalogue included — is scanned.
  * @returns The matching {@link Material}, or `null` if no material has that symbol.
  * @throws {TypeError} If `symbol` is present and not a string. A nullish
  * `symbol` is a miss, answered the way an unrecognised one is.
@@ -187,6 +202,7 @@ declare function getMaterialBySymbol(symbol: string, materials?: readonly Materi
  * Look up a material by its display name (case-insensitive).
  *
  * @param name - The display name as the catalogue spells it, e.g. `"Grid Resistors"`.
+ * Leading/trailing whitespace and case are ignored.
  * @param materials - Optional subset to search (see {@link getMaterialBySymbol}).
  * @returns The matching {@link Material}, or `null` if no material has that name.
  * @throws {TypeError} If `name` is present and not a string. A nullish
@@ -202,7 +218,8 @@ declare function getMaterialByName(name: string, materials?: readonly Material[]
 /**
  * Look up a raw material by its chemical element symbol (case-insensitive).
  *
- * @param elementSymbol - The element symbol, e.g. `"Fe"` or `"fe"`.
+ * @param elementSymbol - The element symbol, e.g. `"Fe"` or `"fe"`. Leading/trailing
+ * whitespace and case are ignored.
  * @param materials - Optional subset to search (see {@link getMaterialBySymbol}).
  * @returns The matching {@link Material}, or `null`. Only raw materials carry an
  * element symbol, so a manufactured or encoded subset never matches.
@@ -217,29 +234,30 @@ declare function getMaterialByName(name: string, materials?: readonly Material[]
  */
 declare function getMaterialByElementSymbol(elementSymbol: string, materials?: readonly Material[]): Material | null;
 /**
- * Every material of a given grade, in catalogue order.
+ * Every material of a given grade, across all three categories, in catalogue order.
  *
- * @param grade - The grade to match, 1–5 (or a {@link MaterialGrade} member).
- * @param materials - Optional subset to search (see {@link getMaterialBySymbol}).
- * @returns A new array of matches (possibly empty). The input is not modified.
+ * @param grade - The grade to match, 1–5 (or a {@link MaterialGrade} member). A grade
+ * no material carries matches nothing, the way an unrecognised symbol does.
+ * @returns A new array of matches (possibly empty).
+ * @throws {TypeError} If `grade` is present and not a number. A nullish `grade` is a
+ * miss, answered the way an unrecognised one is.
  * @example
  * ```ts
  * import { MaterialGrade, materialsByGrade } from '@elite-dangerous-almanac/core/materials/materials';
  * import { RAW_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-raw';
  *
- * materialsByGrade(MaterialGrade.VeryRare).length;                 // -> across every category
- * materialsByGrade(MaterialGrade.Rare, RAW_MATERIALS).length;      // -> 7, one per raw line
+ * materialsByGrade(MaterialGrade.VeryRare).length;                        // -> across every category
+ * RAW_MATERIALS.filter((m) => m.grade === MaterialGrade.Rare).length;     // -> 7, one per raw line
  * ```
  */
-declare function materialsByGrade(grade: MaterialGrade, materials?: readonly Material[]): Material[];
+declare function materialsByGrade(grade: MaterialGrade): Material[];
 /**
  * Every material in a given line, in catalogue order.
  *
  * @param line - The line to match, e.g. `MaterialLine.Chemical`. A plain string of
  * the line's value works too: leading/trailing whitespace and case are ignored, like
  * every other lookup here.
- * @param materials - Optional subset to search (see {@link getMaterialBySymbol}).
- * @returns A new array of matches (possibly empty). The input is not modified.
+ * @returns A new array of matches (possibly empty).
  * @throws {TypeError} If `line` is present and not a string. A nullish
  * `line` is a miss, answered the way an unrecognised one is.
  * @example
@@ -249,7 +267,7 @@ declare function materialsByGrade(grade: MaterialGrade, materials?: readonly Mat
  * materialsInLine(MaterialLine.Chemical).map((m) => m.grade); // -> [1, 2, 3, 4, 5]
  * ```
  */
-declare function materialsInLine(line: string, materials?: readonly Material[]): Material[];
+declare function materialsInLine(line: string): Material[];
 /**
  * Every material in a given category, in catalogue order.
  *
@@ -260,8 +278,7 @@ declare function materialsInLine(line: string, materials?: readonly Material[]):
  *
  * @param category - The category to match: `'raw'`, `'manufactured'` or `'encoded'`.
  * Leading/trailing whitespace and case are ignored, like every other lookup here.
- * @param materials - Optional subset to search (see {@link getMaterialBySymbol}).
- * @returns A new array of matches (possibly empty). The input is not modified.
+ * @returns A new array of matches (possibly empty).
  * @throws {TypeError} If `category` is present and not a string. A nullish
  * `category` is a miss, answered the way an unrecognised one is.
  * @example
@@ -272,6 +289,6 @@ declare function materialsInLine(line: string, materials?: readonly Material[]):
  * materialsInCategory('Encoded').length;      // -> 47; case is ignored
  * ```
  */
-declare function materialsInCategory(category: string, materials?: readonly Material[]): Material[];
+declare function materialsInCategory(category: string): Material[];
 
 export { type Material, type MaterialCategory, MaterialGrade, MaterialLine, getMaterialByElementSymbol, getMaterialByName, getMaterialBySymbol, materialsByGrade, materialsInCategory, materialsInLine };

package/dist/materials/materials.js

@@ -1 +1 @@
-export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-IOJXLDJN.js";                                                                                                                                                                                                           //# sourceMappingURL=materials.js.map
+export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-OYR5HUQZ.js";                                                                                                                                                                                                           //# sourceMappingURL=materials.js.map

package/dist/materials/micro-resources.d.ts

@@ -15,8 +15,8 @@
  * getMicroResourceBySymbol('graphene')?.category; // -> 'component'
  * ```
  *
- * Each lookup takes an optional second argument to **narrow** the search to a
- * subset — one category's catalogue, or any array you have filtered yourself:
+ * The two **by-key** lookups take an optional second argument to **narrow** the search
+ * to a subset — one category's catalogue, or any array you have filtered yourself:
  *
  * | Module | Export | Entries |
  * | --- | --- | --- |
@@ -27,9 +27,18 @@
  * | `./micro-resources-all` | `ALL_MICRO_RESOURCES` | 226 (the default) |
  *
  * It narrows *results*, not bundle size: importing a lookup pulls all four
- * catalogues, since that is what it falls back to — 13.0 KiB minified for all 226.
+ * catalogues, since that is what it falls back to — 13.4 KiB minified for all 226.
  * {@link microResourcesInCategory} reaches the same subsets from a plain string.
  *
+ * **Only `ALL_MICRO_RESOURCES` itself is indexed.** A by-key lookup answers from an
+ * O(1) index when the catalogue you pass *is* `ALL_MICRO_RESOURCES` — the same object,
+ * not a copy — and scans linearly otherwise, including for `[...ALL_MICRO_RESOURCES]`,
+ * which holds the same 226 records. Omitting the argument always takes the indexed
+ * path, so pass one only when you mean to exclude the rest.
+ *
+ * {@link microResourcesInCategory} takes no catalogue: it returns an array, so
+ * narrowing it is `.filter()` on the result or on the subset you already imported.
+ *
  * Data originates from EDCD FDevIDs (`microresources.csv`), in-game verification and
  * Inara; see [`data/materials/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/materials/SOURCES.md).
  *
@@ -83,7 +92,10 @@ interface MicroResource {
  * @param microResources - Optional subset to search instead of all 226 micro
  * resources — `COMPONENT_MICRO_RESOURCES`, `CONSUMABLE_MICRO_RESOURCES`,
  * `DATA_MICRO_RESOURCES`, `ITEM_MICRO_RESOURCES`, or any array you have filtered
- * yourself. Omit it unless you specifically want to exclude the rest.
+ * yourself. Omit it unless you specifically want to exclude the rest: the indexed O(1)
+ * path is taken only when the argument is omitted or is `ALL_MICRO_RESOURCES` **by
+ * reference**, and every other array — a copy of that same catalogue included — is
+ * scanned.
  * @returns The matching {@link MicroResource}, or `null` if no micro resource has
  * that symbol.
  * @throws {TypeError} If `symbol` is present and not a string. A nullish
@@ -119,8 +131,7 @@ declare function getMicroResourceByName(name: string, microResources?: readonly
  *
  * @param category - The category to match, e.g. `'component'`. Leading/trailing
  * whitespace and case are ignored, like every other lookup here.
- * @param microResources - Optional subset to search (see {@link getMicroResourceBySymbol}).
- * @returns A new array of matches (possibly empty). The input is not modified.
+ * @returns A new array of matches (possibly empty).
  * @throws {TypeError} If `category` is present and not a string. A nullish
  * `category` is a miss, answered the way an unrecognised one is.
  * @example
@@ -131,6 +142,6 @@ declare function getMicroResourceByName(name: string, microResources?: readonly
  * microResourcesInCategory('Consumable').length; // -> 6; case is ignored
  * ```
  */
-declare function microResourcesInCategory(category: string, microResources?: readonly MicroResource[]): MicroResource[];
+declare function microResourcesInCategory(category: string): MicroResource[];
 
 export { type MicroResource, type MicroResourceCategory, getMicroResourceByName, getMicroResourceBySymbol, microResourcesInCategory };

package/dist/materials/micro-resources.js

@@ -1 +1 @@
-export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-MKGJPVPS.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=micro-resources.js.map
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-MRTTQYT5.js";                                                                                                                                                                                                                                                                     //# sourceMappingURL=micro-resources.js.map

package/dist/ships/armour.d.ts

@@ -14,7 +14,7 @@ import { DamageResistanceParams, DamageResistances, DamageTypeValues } from './r
  * stack onto with diminishing returns — see `./resistances`. Module reinforcement
  * packages protect the *modules* rather than the hull, and are reported separately.
  *
- * This module is data-free. {@link ShipLoadout.armourMetrics} (in `./ship-loadout`)
+ * This module is data-free. {@link BuildMetrics.armourMetrics} (in `./build-metrics`)
  * gathers a build's bulkhead and reinforcement packages, post-engineering, and calls
  * {@link armourMetrics} for you.
  *
@@ -77,7 +77,7 @@ interface ArmourInput {
      * @remarks
      * Absent means **no** bulkhead: no armour bonus and no resistances, so the hull
      * reports its bare `baseArmour`. No ship in the game flies like that;
-     * `ShipLoadout.armourMetrics()` substitutes the hull's stock lightweight alloy
+     * `BuildMetrics.armourMetrics()` substitutes the hull's stock lightweight alloy
      * instead, and you should pass the hull's own armour record here to do the same.
      */
     readonly bulkhead?: BulkheadParams | null;
@@ -86,7 +86,14 @@ interface ArmourInput {
     /** Each fitted, powered module reinforcement package. Defaults to none. */
     readonly moduleReinforcements?: readonly ModuleReinforcementParams[];
 }
-/** A build's armour: hit points, where they come from, and what the hull resists. */
+/**
+ * A build's armour: hit points, where they come from, and what the hull resists.
+ *
+ * @remarks
+ * Frozen — nested records and lists included — so a result can be held, cached and
+ * shared without a defensive copy. Derive a changed figure with a spread rather than
+ * by assigning into one.
+ */
 interface ArmourMetrics {
     /** Total hull hit points. */
     readonly hitPoints: number;
@@ -94,7 +101,16 @@ interface ArmourMetrics {
     readonly bulkheads: number;
     /** What the hull reinforcement packages add. */
     readonly reinforcement: number;
-    /** Effective resistances, bulkhead and reinforcement stacked with diminishing returns. */
+    /**
+     * Effective resistances, bulkhead and reinforcement stacked with diminishing returns.
+     *
+     * @remarks
+     * Fractions rather than percentages, and **unrounded**: the stacking is
+     * floating-point arithmetic, so a nominal −20% reads as `-0.19999999999999996`
+     * rather than `-0.2`. Round where the figure is displayed, not before it is
+     * composed further — {@link ArmourMetrics.effectiveHitPoints} is derived from
+     * exactly these values.
+     */
     readonly resistances: DamageResistances;
     /**
      * Effective hit points against each damage type — `hitPoints / (1 − resistance)`,

package/dist/ships/armour.js

@@ -1 +1 @@
-export{armourMetrics}from"../chunk-FGXWVFN6.js";                             //# sourceMappingURL=armour.js.map
+export{armourMetrics}from"../chunk-FYVPZBXN.js";                                                          //# sourceMappingURL=armour.js.map