@elite-dangerous-almanac/core 0.2.8 → 0.2.9

package/dist/i18n/personal-modifications.d.ts

@@ -11,10 +11,8 @@
  * `"weapon_range_laser"`. A journal line writes the unsuffixed `"weapon_range"`, which
  * `resolvePersonalModificationForWeapon` turns into the specific symbol. 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
- * hyphens. A regional or script subtag is dropped: every stored locale is a bare
- * language tag.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
  * @returns The localized modification name; the canonical `PersonalModification.name`
  * for any English tag; or `null` when the recipe is unknown or the locale is not one of
  * the six this catalogue stores.
@@ -49,8 +47,8 @@ declare function getPersonalModificationName(modificationSymbol: string, locale:
  * This is display prose, not a statement of the magnitudes a recipe applies: the game
  * says a modification "allows more ammo to be carried for each weapon", never how much
  * more. `PersonalModification.modifiers` answers that, and the two are deliberately not
- * the same string. It is also the only account of the ten recipes whose `modifiers` list
- * is empty, whether because the recipe switches a capability on or because it moves a
+ * the same string. It is also the only account of the recipes whose `modifiers` list is
+ * empty, whether because the recipe switches a capability on or because it moves a
  * stat the panel puts no number on. English is the game's own wording rather than a
  * projection of `PersonalModification.name`.
  * @throws {TypeError} If a present `modificationSymbol` or `locale` is not a string.

package/dist/i18n/personal-modifications.js

@@ -1 +1 @@
-export{getPersonalModificationDescription,getPersonalModificationName}from"../chunk-OLKOWR7S.js";                                                                                       //# sourceMappingURL=personal-modifications.js.map
+export{getPersonalModificationDescription,getPersonalModificationName}from"../chunk-SS7HVNP5.js";                                                                                       //# sourceMappingURL=personal-modifications.js.map

package/dist/i18n/personal-tools.d.ts

@@ -0,0 +1,33 @@
+/** Localized suit-tool display names, isolated from tool battery and timing stats. */
+/**
+ * Look up a suit tool's source-backed display name for a locale.
+ *
+ * @param id - The library id `PersonalTool.id` carries, such as `"arc-cutter"`. Matching
+ * ignores case and surrounding whitespace.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
+ * @returns The localized tool name; the canonical `PersonalTool.name` for any English
+ * tag; or `null` when the tool is unknown or the locale is not one of the six this
+ * catalogue stores.
+ * @remarks
+ * All six stored locales are complete for this dataset, so a supported locale always
+ * answers. Frontier publishes no item symbol for a tool, so the library id is the only
+ * identifier this lookup takes — the same one `getPersonalToolById` takes.
+ *
+ * A returned value can equal the English, because the game leaves some tool names
+ * untranslated. Such a value is the game's own, stored verbatim; the library never
+ * supplies an English fallback. This lookup bundles no tool stats.
+ * @throws {TypeError} If `id` is present and not a string, or `locale` is not a string. A
+ * nullish `id` is a lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getPersonalToolName } from '@elite-dangerous-almanac/core/i18n/personal-tools';
+ *
+ * getPersonalToolName('energylink', 'de-DE'); // -> 'Energie-Link'
+ * getPersonalToolName('profile-analyser', 'fr'); // -> 'Analyseur de profil'
+ * getPersonalToolName('arc-cutter', 'it'); // -> null
+ * ```
+ */
+declare function getPersonalToolName(id: string, locale: string): string | null;
+
+export { getPersonalToolName };

package/dist/i18n/personal-tools.js

@@ -0,0 +1 @@
+export{getPersonalToolName}from"../chunk-E2HDF6PJ.js";                                                                                       //# sourceMappingURL=personal-tools.js.map

package/dist/i18n/personal-tools.js.map

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

package/dist/i18n/personal-weapons.d.ts

@@ -5,10 +5,9 @@
  *
  * @param symbol - Frontier's weapon symbol, such as `"wpn_s_pistol_kinetic_sauto"`.
  * 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
- * hyphens. A regional or script subtag is dropped: every stored locale is a bare
- * language tag. All six stored locales are complete for this dataset.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched. All six stored locales are complete for
+ * this dataset.
  * @returns The localized description, or `null` when the weapon is unknown or the
  * requested locale is not one this catalogue stores.
  * @remarks

package/dist/i18n/personal-weapons.js

@@ -1 +1 @@
-export{getPersonalWeaponDescription}from"../chunk-W5ULI75F.js";                                                                                       //# sourceMappingURL=personal-weapons.js.map
+export{getPersonalWeaponDescription}from"../chunk-7C7NJWCF.js";                                                                                       //# sourceMappingURL=personal-weapons.js.map

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

@@ -20,7 +20,7 @@ interface PreEngineeredVariantIdentity {
  * because a base module and blueprint alone do not uniquely identify every reward.
  * @param locale - A BCP 47 locale. Regional tags fall back to their supported language.
  * @returns The explicit localized name, or `null` for an unknown variant or unavailable
- * translation. Decorative reward names currently have English values only.
+ * translation. Decorative reward names have English values only.
  * @throws {TypeError} If `variant` is not an object, a required identity field or a
  * non-null `experimentalEffectSymbol` value is not a string, or `locale` is not a
  * string.

package/dist/i18n/slots.d.ts

@@ -6,7 +6,7 @@ import { BuildSlot, SlotRestriction } from '../ships/slots.js';
  * Resolve a loadout slot's display name for a locale.
  *
  * @param slot - A slot returned by `enumerateSlots` or `ShipLoadout.slots`.
- * @param locale - A BCP 47 locale. Current slot-label sources supply English only.
+ * @param locale - A BCP 47 locale. The slot-label sources supply English only.
  * @returns The slot's English display name for an English locale, otherwise `null`.
  * @throws {TypeError} If `slot` is not an object or `locale` is not a string.
  * @example
@@ -26,7 +26,7 @@ declare function getLoadoutSlotName(slot: BuildSlot, locale: string): string | n
  * Resolve the short display label for a restricted slot.
  *
  * @param restriction - A `BuildSlot.restriction` value.
- * @param locale - A BCP 47 locale. Current restriction-label sources supply English only.
+ * @param locale - A BCP 47 locale. The restriction-label sources supply English only.
  * @returns The English label for an English locale, otherwise `null`.
  * @throws {TypeError} If `locale` is not a string.
  * @example

package/dist/i18n/suits.d.ts

@@ -1,14 +1,19 @@
-/** Localized personal-suit display names and descriptions, isolated from suit stats. */
+import { c as PersonalMount } from '../suits-B37rAORs.js';
+import '../equipment/engineering.js';
+
+/**
+ * Localized personal-suit display names and descriptions, and the weapon-mount labels,
+ * isolated from suit stats.
+ */
+
 /**
  * Look up an Odyssey suit's source-backed display name for a locale.
  *
  * @param suit - Either the grade-independent family `Suit.family` carries, such as
  * `"utilitysuit"`, or one grade's Frontier symbol, such as `"utilitysuit_class3"` — the
  * form a journal line writes. 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
- * hyphens. A regional or script subtag is dropped: every stored locale is a bare
- * language tag.
+ * @param locale - A BCP 47 language or regional tag, such as `"de"` or `"de-DE"`; see
+ * {@link GameLocale} for how a tag is matched.
  * @returns The localized suit name; the canonical `Suit.name` for any English tag; or
  * `null` when the suit is unknown or the locale is not one of the six this catalogue
  * stores.
@@ -55,5 +60,30 @@ declare function getSuitName(suit: string, locale: string): string | null;
  * ```
  */
 declare function getSuitDescription(suit: string, locale: string): string | null;
+/**
+ * Resolve a suit weapon mount's display name for a locale.
+ *
+ * @param mount - A mount from `Suit.mounts`.
+ * @param locale - A BCP 47 locale. The mount-label source supplies English only.
+ * @returns The mount's English display name for an English locale, otherwise `null`.
+ * `null` too when the mount carries a key this library does not name.
+ * @throws {TypeError} If `mount` is not an object or `locale` is not a string.
+ * @remarks
+ * The label reads the Frontier journal `SlotName` the mount carries, so it distinguishes
+ * a suit's primary mounts from each other. A consumer needs no table of its own.
+ *
+ * No locale but English answers, although the game itself publishes all six:
+ * https://github.com/DarkSession/Elite-Dangerous-Almanac/issues/26
+ * @example
+ * ```ts
+ * import { getSuitByFamily } from '@elite-dangerous-almanac/core/equipment/suits';
+ * import { getPersonalMountName } from '@elite-dangerous-almanac/core/i18n/suits';
+ *
+ * const suit = getSuitByFamily('tacticalsuit')!;
+ * getPersonalMountName(suit.mounts[1]!, 'en-GB'); // -> 'Primary Weapon 2'
+ * getPersonalMountName(suit.mounts[2]!, 'de'); // -> null
+ * ```
+ */
+declare function getPersonalMountName(mount: PersonalMount, locale: string): string | null;
 
-export { getSuitDescription, getSuitName };
+export { getPersonalMountName, getSuitDescription, getSuitName };

package/dist/i18n/suits.js

@@ -1 +1 @@
-export{getSuitDescription,getSuitName}from"../chunk-FJIWJYKO.js";                                                                                       //# sourceMappingURL=suits.js.map
+export{getPersonalMountName,getSuitDescription,getSuitName}from"../chunk-RA4YJBU5.js";                                                                                       //# sourceMappingURL=suits.js.map

package/dist/materials/index.d.ts

@@ -17,8 +17,8 @@
  * } from '@elite-dangerous-almanac/core/materials';
  *
  * getMaterialByName('iron')?.grade;               // -> MaterialGrade.VeryCommon
- * materialsByGrade(MaterialGrade.Rare).length;    // -> across every category
- * materialsInCategory('raw').length;              // -> 28
+ * materialsByGrade(MaterialGrade.Rare)[0]?.name; // -> 'Yttrium'
+ * materialsInCategory('raw')[0]?.name;           // -> 'Carbon'
  * getMicroResourceBySymbol('graphene')?.name;     // -> 'Graphene'
  * ```
  *
@@ -41,7 +41,8 @@
  * 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
+ * RAW_MATERIALS.filter((m) => m.grade === MaterialGrade.Rare).map((m) => m.name);
+ * // -> ['Yttrium', 'Selenium', 'Antimony', 'Tellurium', 'Technetium', 'Polonium', 'Ruthenium']
  * ```
  *
  * @packageDocumentation

package/dist/materials/index.js

@@ -1 +1 @@
-export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-OFZGNWBT.js";export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-7EWZGDWY.js";export{ALL_MICRO_RESOURCES}from"../chunk-DAQ3PJ4R.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{ITEM_MICRO_RESOURCES}from"../chunk-WHWFKHV3.js";                             export{ALL_MATERIALS}from"../chunk-KBCA4GEZ.js";export{ENCODED_MATERIALS}from"../chunk-A5TCT2AJ.js";export{MANUFACTURED_MATERIALS}from"../chunk-PF3HZ73R.js";export{RAW_MATERIALS}from"../chunk-Q6YDPREF.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-X3MXPE7G.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-ETREYN5U.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-FP2TQJZP.js";export{ENCODED_MATERIALS}from"../chunk-A5TCT2AJ.js";export{MANUFACTURED_MATERIALS}from"../chunk-PF3HZ73R.js";export{RAW_MATERIALS}from"../chunk-GZLD7RTK.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/materials/materials-all.d.ts

@@ -12,13 +12,13 @@ import { Material } from './materials.js';
  */
 
 /**
- * All 146 materials across every category, raw then manufactured then encoded.
+ * Every material across every category, raw then manufactured then encoded.
  *
  * @example
  * ```ts
  * import { ALL_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-all';
  *
- * ALL_MATERIALS.length; // -> 146
+ * ALL_MATERIALS.find((material) => material.symbol === 'Iron')?.category; // -> 'raw'
  * ```
  */
 declare const ALL_MATERIALS: readonly Material[];

package/dist/materials/materials-all.js

@@ -1 +1 @@
-export{ALL_MATERIALS}from"../chunk-KBCA4GEZ.js";                                                                                                                    //# sourceMappingURL=materials-all.js.map
+export{ALL_MATERIALS}from"../chunk-FP2TQJZP.js";                                                                                                                    //# sourceMappingURL=materials-all.js.map

package/dist/materials/materials-raw.d.ts

@@ -1,8 +1,8 @@
 import { Material } from './materials.js';
 
 /**
- * The catalogue of **raw** materials — the 28 chemical elements, in seven lines of
- * four grades (grade 1–4; raw materials have no grade 5).
+ * The catalogue of **raw** materials — the chemical elements, in seven lines of four
+ * grades (grade 1–4; raw materials have no grade 5).
  *
  * Each line is named after its grade-1 element: Carbon, Phosphorus, Sulphur, Iron,
  * Nickel, Rhenium, Lead. Search it with the query functions in `./materials`.
@@ -13,7 +13,7 @@ import { Material } from './materials.js';
  */
 
 /**
- * All 28 raw materials, sorted by line then grade.
+ * Every raw material, sorted by line then grade.
  *
  * @remarks
  * Every record has `category: 'raw'`. The array and its records are frozen.
@@ -22,7 +22,6 @@ import { Material } from './materials.js';
  * ```ts
  * import { RAW_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-raw';
  *
- * RAW_MATERIALS.length; // -> 28
  * RAW_MATERIALS.find((m) => m.name === 'Iron')?.elementSymbol; // -> 'Fe'
  * ```
  */

package/dist/materials/materials-raw.js

@@ -1 +1 @@
-export{RAW_MATERIALS}from"../chunk-Q6YDPREF.js";                             //# sourceMappingURL=materials-raw.js.map
+export{RAW_MATERIALS}from"../chunk-GZLD7RTK.js";                             //# sourceMappingURL=materials-raw.js.map

package/dist/materials/materials.d.ts

@@ -9,7 +9,7 @@
  * ({@link getMaterialBySymbol}, {@link getMaterialByName}, {@link materialsByGrade},
  * {@link materialsInLine}, …).
  *
- * **Every lookup searches all 146 materials by default** — you do not have to hand it
+ * **Every lookup searches every material by default** — you do not have to hand it
  * a catalogue:
  *
  * ```ts
@@ -20,21 +20,24 @@
  * search to a subset — one category's catalogue, or any array you have filtered
  * yourself:
  *
- * | Module | Export | Entries |
- * | --- | --- | --- |
- * | `./materials-raw` | `RAW_MATERIALS` | 28 |
- * | `./materials-manufactured` | `MANUFACTURED_MATERIALS` | 71 |
- * | `./materials-encoded` | `ENCODED_MATERIALS` | 47 |
- * | `./materials-all` | `ALL_MATERIALS` | 146 (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 |
+ * | --- | --- | --- | --- |
+ * | `./materials-raw` | `RAW_MATERIALS` | ~2 KiB | ~1 KiB |
+ * | `./materials-manufactured` | `MANUFACTURED_MATERIALS` | ~7 KiB | ~1 KiB |
+ * | `./materials-encoded` | `ENCODED_MATERIALS` | ~5 KiB | ~1 KiB |
+ * | `./materials-all` | `ALL_MATERIALS` | ~14 KiB | ~3 KiB |
  *
  * It narrows *results*, not bundle size: importing a lookup pulls all three
- * catalogues, since that is what it falls back to — ~17 KiB minified for all 146.
+ * catalogues, since that is what it falls back to — ~14 KiB minified for the set.
  * {@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
+ * same 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},
@@ -48,8 +51,8 @@
  * ```ts
  * import { getMaterialByName, materialsInCategory } from '@elite-dangerous-almanac/core/materials';
  *
- * getMaterialByName('iron')?.grade;     // -> MaterialGrade.VeryCommon (1)
- * materialsInCategory('raw').length;    // -> 28
+ * getMaterialByName('iron')?.grade;              // -> MaterialGrade.VeryCommon (1)
+ * materialsInCategory('raw')[0]?.name;           // -> 'Carbon'
  * ```
  *
  * @packageDocumentation
@@ -181,7 +184,7 @@ interface Material {
  * @param symbol - The internal symbol, e.g. `"GridResistors"`, or the lower-cased
  * form the player journal reports (`"gridresistors"`). Leading/trailing whitespace
  * and case are ignored.
- * @param materials - Optional subset to search instead of all 146 materials —
+ * @param materials - Optional subset to search instead of every material —
  * `RAW_MATERIALS`, `MANUFACTURED_MATERIALS`, `ENCODED_MATERIALS`, or any array you
  * 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
@@ -246,7 +249,7 @@ declare function getMaterialByElementSymbol(elementSymbol: string, materials?: r
  * 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.VeryRare)[0]?.category;                 // -> 'manufactured'
  * RAW_MATERIALS.filter((m) => m.grade === MaterialGrade.Rare).length;     // -> 7, one per raw line
  * ```
  */
@@ -285,8 +288,8 @@ declare function materialsInLine(line: string): Material[];
  * ```ts
  * import { materialsInCategory } from '@elite-dangerous-almanac/core/materials/materials';
  *
- * materialsInCategory('raw').length;          // -> 28
- * materialsInCategory('Encoded').length;      // -> 47; case is ignored
+ * materialsInCategory('encoded')[0]?.name;         // -> 'Anomalous Bulk Scan Data'
+ * materialsInCategory('Encoded')[0]?.name;         // -> 'Anomalous Bulk Scan Data'; case is ignored
  * ```
  */
 declare function materialsInCategory(category: string): Material[];

package/dist/materials/materials.js

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

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

@@ -13,14 +13,14 @@ import { MicroResource } from './micro-resources.js';
  */
 
 /**
- * All 226 micro resources across every category — component, then consumable, then
+ * Every micro resource across every category — component, then consumable, then
  * data, then item.
  *
  * @example
  * ```ts
  * import { ALL_MICRO_RESOURCES } from '@elite-dangerous-almanac/core/materials/micro-resources-all';
  *
- * ALL_MICRO_RESOURCES.length; // -> 226
+ * ALL_MICRO_RESOURCES.find((resource) => resource.symbol === 'graphene')?.category; // -> 'component'
  * ```
  */
 declare const ALL_MICRO_RESOURCES: readonly MicroResource[];

package/dist/materials/micro-resources-all.js

@@ -1 +1 @@
-export{ALL_MICRO_RESOURCES}from"../chunk-DAQ3PJ4R.js";                                                                                                                                                                              //# sourceMappingURL=micro-resources-all.js.map
+export{ALL_MICRO_RESOURCES}from"../chunk-GVNTKCVF.js";                                                                                                                                                                              //# sourceMappingURL=micro-resources-all.js.map

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

@@ -12,7 +12,7 @@ import { MicroResource } from './micro-resources.js';
  */
 
 /**
- * All 33 component micro resources, in Frontier's registry order.
+ * Every component micro resource, in Frontier's registry order.
  *
  * @remarks
  * Every record has `category: 'component'`. The array and its records are frozen.
@@ -21,7 +21,7 @@ import { MicroResource } from './micro-resources.js';
  * ```ts
  * import { COMPONENT_MICRO_RESOURCES } from '@elite-dangerous-almanac/core/materials/micro-resources-component';
  *
- * COMPONENT_MICRO_RESOURCES.length; // -> 33
+ * COMPONENT_MICRO_RESOURCES.find((resource) => resource.symbol === 'graphene')?.name; // -> 'Graphene'
  * ```
  */
 declare const COMPONENT_MICRO_RESOURCES: readonly MicroResource[];

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

@@ -12,7 +12,7 @@ import { MicroResource } from './micro-resources.js';
  */
 
 /**
- * All 6 consumable micro resources, in Frontier's registry order.
+ * Every consumable micro resource, in Frontier's registry order.
  *
  * @remarks
  * Every record has `category: 'consumable'`. The array and its records are frozen.
@@ -21,7 +21,7 @@ import { MicroResource } from './micro-resources.js';
  * ```ts
  * import { CONSUMABLE_MICRO_RESOURCES } from '@elite-dangerous-almanac/core/materials/micro-resources-consumable';
  *
- * CONSUMABLE_MICRO_RESOURCES.length; // -> 6
+ * CONSUMABLE_MICRO_RESOURCES.find((resource) => resource.symbol === 'healthpack')?.name; // -> 'Medkit'
  * ```
  */
 declare const CONSUMABLE_MICRO_RESOURCES: readonly MicroResource[];

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

@@ -12,7 +12,7 @@ import { MicroResource } from './micro-resources.js';
  */
 
 /**
- * All 125 data micro resources, in catalogue order.
+ * Every data micro resource, in catalogue order.
  *
  * @remarks
  * Every record has `category: 'data'`. The array and its records are frozen.
@@ -21,7 +21,7 @@ import { MicroResource } from './micro-resources.js';
  * ```ts
  * import { DATA_MICRO_RESOURCES } from '@elite-dangerous-almanac/core/materials/micro-resources-data';
  *
- * DATA_MICRO_RESOURCES.length; // -> 125
+ * DATA_MICRO_RESOURCES.find((resource) => resource.symbol === 'nocdata')?.name; // -> 'NOC Data'
  * ```
  */
 declare const DATA_MICRO_RESOURCES: readonly MicroResource[];

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

@@ -12,7 +12,7 @@ import { MicroResource } from './micro-resources.js';
  */
 
 /**
- * All 62 item micro resources, in catalogue order.
+ * Every item micro resource, in catalogue order.
  *
  * @remarks
  * Every record has `category: 'item'`. The array and its records are frozen.
@@ -21,7 +21,7 @@ import { MicroResource } from './micro-resources.js';
  * ```ts
  * import { ITEM_MICRO_RESOURCES } from '@elite-dangerous-almanac/core/materials/micro-resources-item';
  *
- * ITEM_MICRO_RESOURCES.length; // -> 62
+ * ITEM_MICRO_RESOURCES.find((resource) => resource.symbol === 'castfossil')?.name; // -> 'Cast Fossil'
  * ```
  */
 declare const ITEM_MICRO_RESOURCES: readonly MicroResource[];

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

@@ -8,7 +8,7 @@
  * ({@link getMicroResourceBySymbol}, {@link getMicroResourceByName},
  * {@link microResourcesInCategory}).
  *
- * **Every lookup searches all 226 micro resources by default** — you do not have to
+ * **Every lookup searches every micro resource by default** — you do not have to
  * hand it a catalogue:
  *
  * ```ts
@@ -18,22 +18,25 @@
  * 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 |
- * | --- | --- | --- |
- * | `./micro-resources-component` | `COMPONENT_MICRO_RESOURCES` | 33 |
- * | `./micro-resources-consumable` | `CONSUMABLE_MICRO_RESOURCES` | 6 |
- * | `./micro-resources-data` | `DATA_MICRO_RESOURCES` | 125 |
- * | `./micro-resources-item` | `ITEM_MICRO_RESOURCES` | 62 |
- * | `./micro-resources-all` | `ALL_MICRO_RESOURCES` | 226 (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 |
+ * | --- | --- | --- | --- |
+ * | `./micro-resources-component` | `COMPONENT_MICRO_RESOURCES` | ~2 KiB | ~1 KiB |
+ * | `./micro-resources-consumable` | `CONSUMABLE_MICRO_RESOURCES` | ~1 KiB | <1 KiB |
+ * | `./micro-resources-data` | `DATA_MICRO_RESOURCES` | ~7 KiB | ~2 KiB |
+ * | `./micro-resources-item` | `ITEM_MICRO_RESOURCES` | ~3 KiB | ~1 KiB |
+ * | `./micro-resources-all` | `ALL_MICRO_RESOURCES` | ~12 KiB | ~3 KiB |
  *
  * It narrows *results*, not bundle size: importing a lookup pulls all four
- * catalogues, since that is what it falls back to — ~13 KiB minified for all 226.
+ * catalogues, since that is what it falls back to — ~12 KiB minified for the set.
  * {@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
+ * which holds the same 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
@@ -89,8 +92,8 @@ interface MicroResource {
  *
  * @param symbol - The internal symbol, e.g. `"graphene"`, or the lower-cased form the
  * player journal reports. Leading/trailing whitespace and case are ignored.
- * @param microResources - Optional subset to search instead of all 226 micro
- * resources — `COMPONENT_MICRO_RESOURCES`, `CONSUMABLE_MICRO_RESOURCES`,
+ * @param microResources - Optional subset to search instead of every micro
+ * resource — `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: the indexed O(1)
  * path is taken only when the argument is omitted or is `ALL_MICRO_RESOURCES` **by
@@ -138,8 +141,8 @@ declare function getMicroResourceByName(name: string, microResources?: readonly
  * ```ts
  * import { microResourcesInCategory } from '@elite-dangerous-almanac/core/materials/micro-resources';
  *
- * microResourcesInCategory('consumable').length; // -> 6
- * microResourcesInCategory('Consumable').length; // -> 6; case is ignored
+ * microResourcesInCategory('consumable')[0]?.name;     // -> 'Medkit'
+ * microResourcesInCategory('Consumable')[0]?.name;     // -> 'Medkit'; case is ignored
  * ```
  */
 declare function microResourcesInCategory(category: string): MicroResource[];

package/dist/materials/micro-resources.js

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

package/dist/ships/ammunition.d.ts

@@ -75,10 +75,10 @@ interface AmmunitionCapacity {
  *
  * @param stats - The module's stats. A catalogue record works as-is; pass a
  * post-engineering record (`FittedModule.effectiveStats`, `effectiveModule`) to get the
- * capacity a build actually flies with. Fifteen blueprints move one figure or both — High
- * Capacity, the chaff, heat-sink and point-defence capacity recipes among them — and three
- * experimental effects move the reserve: Corrosive Shell costs a fifth of it, and Plasma
- * Slug (in both its forms) empties it, because the weapon then reloads from ship fuel.
+ * capacity a build actually flies with. Blueprints such as High Capacity and the chaff,
+ * heat-sink and point-defence capacity recipes move one figure or both, and experimental
+ * effects move the reserve: Corrosive Shell costs a fifth of it, and Plasma Slug (in both
+ * its forms) empties it, because the weapon then reloads from ship fuel.
  * @returns The {@link AmmunitionCapacity}, or `null` for a module that carries no
  * ammunition at all — the lasers, which state neither figure because they draw from the
  * weapons capacitor instead.

package/dist/ships/blueprint-costs.d.ts

@@ -14,7 +14,7 @@ import './slots.js';
  * Use {@link getBlueprintGradeCost} for that per-roll recipe or {@link getBlueprintCost}
  * for the complete weighted climb to a target grade. Both answer with a
  * {@link BlueprintCost} — the materials consumed *and* the **Merc Coin** billed beside
- * them, since 25 recipes charge a currency as well. The matching stat modifiers live in
+ * them, since some recipes charge a currency as well. The matching stat modifiers live in
  * `ships/blueprints`.
  *
  * Data from EDCD/coriolis-data (`modifications/blueprints.json`), with Operations and
@@ -85,8 +85,8 @@ declare function getBlueprintCosts(blueprintSymbol: string): BlueprintGradeCosts
  *
  * @remarks
  * Merc Coin has no credit equivalent and is not a material, so it is its own member
- * rather than an entry in `materials`. Only 25 of the catalogued blueprints charge any;
- * on every other recipe `mercCoins` is `0`, which is a real amount rather than a missing
+ * rather than an entry in `materials`. Only a minority of the catalogued blueprints charge
+ * any; on every other recipe `mercCoins` is `0`, which is a real amount rather than a missing
  * one — a step that is catalogued at all reports both halves of its cost.
  */
 interface BlueprintCost {
@@ -99,10 +99,10 @@ interface BlueprintCost {
      * The Merc Coin the step bills, already weighted for however many rolls the step
      * covers, exactly as the `materials` counts are.
      *
-     * `0` either where the recipe charges no currency — 25 blueprints do and the rest do
-     * not — or where this particular step covers no grade that charges. It is therefore
+     * `0` either where the recipe charges no currency — a minority of blueprints charge
+     * it — or where this particular step covers no grade that charges. It is therefore
      * an amount for *this* step, and reading `0` as "this blueprint never charges Merc
-     * Coin" is wrong on exactly the 25 that do.
+     * Coin" is wrong on every recipe that does.
      */
     readonly mercCoins: number;
 }
@@ -144,9 +144,9 @@ declare function getBlueprintGradeCost(blueprintSymbol: string, grade: number):
  * `currentGrade` to `grade − 1`; use {@link getBlueprintGradeCost} for one roll.
  *
  * A Mercenary article is bought at grade 1 and its recipe defines grades 2–5, so pass
- * `1` to price what an engineer can still add. The four ordinary-menu recipes that also
- * bill Merc Coin — `FuelScoop_Efficiency` and the three `*Laser_ThermalPlasmaConversion`
- * — define grades 1–5 on a stock module and climb from `0` like any other recipe.
+ * `1` to price what an engineer can still add. The ordinary-menu recipes that also bill
+ * Merc Coin, `FuelScoop_Efficiency` and the `*Laser_ThermalPlasmaConversion` recipes,
+ * define grades 1–5 on a stock module and climb from `0` like any other recipe.
  *
  * This is blueprint cost only. An experimental effect is a separate application, and it
  * costs materials alone; combine its `getExperimentalEffectCost` result with
@@ -203,11 +203,11 @@ type BlueprintMercCoinCosts = Readonly<Record<string, number>>;
  * @remarks
  * The raw catalogue behind {@link BlueprintCost.mercCoins}; reach for
  * {@link getBlueprintCost} or {@link getBlueprintGradeCost} unless you want the table
- * itself. A small subset of {@link BLUEPRINT_COSTS} — 25 of its ids, in two shapes.
- * Twenty-one are the bespoke grade-2–5 recipes that only a Mercenary article, bought
- * already at grade 1, can be taken through. The other four are ordinary
+ * itself. A small subset of {@link BLUEPRINT_COSTS}'s ids, in two shapes. Most are the
+ * bespoke grade-2–5 recipes that only a Mercenary article, bought
+ * already at grade 1, can be taken through. The others are ordinary
  * engineering-menu recipes spanning grades 1–5 that happen to bill the currency too:
- * `FuelScoop_Efficiency` and the three `*Laser_ThermalPlasmaConversion`. Every other
+ * `FuelScoop_Efficiency` and the `*Laser_ThermalPlasmaConversion` recipes. Every other
  * blueprint is absent rather than zero. Merc Coin has no credit equivalent, so it is
  * never folded into a material list.
  *

package/dist/ships/blueprint-costs.js

@@ -1 +1 @@
-export{BLUEPRINT_COSTS,BLUEPRINT_MERC_COIN_COSTS,getBlueprintCost,getBlueprintCosts,getBlueprintGradeCost}from"../chunk-ETWMPMZP.js";                                                                                                                                                 //# sourceMappingURL=blueprint-costs.js.map
+export{BLUEPRINT_COSTS,BLUEPRINT_MERC_COIN_COSTS,getBlueprintCost,getBlueprintCosts,getBlueprintGradeCost}from"../chunk-K5JK3XQB.js";                                                                                                                                                 //# sourceMappingURL=blueprint-costs.js.map