@elite-dangerous-almanac/core 0.2.7 → 0.2.9

package/dist/equipment/weapons.d.ts

@@ -1,121 +1,2 @@
-import { EquipmentGrade } from './suits.js';
-
-/**
- * Odyssey handheld weapons, their journal identifiers and grade-dependent damage.
- *
- * @packageDocumentation
- */
-
-/** A weapon manufacturer's shared Pioneer grade-upgrade recipe. */
-type WeaponUpgradeGroup = 'karma' | 'takada' | 'manticore';
-/** Technology suffix used to disambiguate personal-weapon modification recipes. */
-type PersonalWeaponEngineeringType = 'kinetic' | 'laser' | 'plasma';
-/** A handheld weapon's form factor. */
-type PersonalWeaponClass = 'pistol' | 'carbine' | 'rifle' | 'shotgun' | 'sniper' | 'launcher';
-/** Which suit weapon slot accepts the weapon. */
-type PersonalWeaponSlot = 'primary' | 'secondary';
-/** The damage family relevant to resistances and some modification recipes. */
-type PersonalDamageType = 'kinetic' | 'thermal' | 'plasma' | 'explosive';
-/** A handheld weapon firing cycle. */
-type PersonalFireMode = 'automatic' | 'semi-automatic' | 'burst';
-/** Grade-dependent stats for one handheld weapon. */
-interface PersonalWeaponGrade {
-    /** Damage per projectile or pellet. */
-    readonly damage: number;
-    /** Permanent engineering-modification slots available, from `0` through `4`. */
-    readonly modificationSlots: number;
-}
-/** One handheld weapon sold by Pioneer Supplies. */
-interface PersonalWeapon {
-    /** Frontier item id reported by journal loadout events. */
-    readonly symbol: string;
-    /** English display name. */
-    readonly name: string;
-    /** Manufacturer recipe family used for grade upgrades. */
-    readonly upgradeGroup: WeaponUpgradeGroup;
-    /** Recipe suffix used when the journal omits a modification's weapon technology. */
-    readonly engineeringType: PersonalWeaponEngineeringType;
-    /** Weapon form factor. */
-    readonly class: PersonalWeaponClass;
-    /** Suit slot this weapon occupies. */
-    readonly slot: PersonalWeaponSlot;
-    /** Base damage family. */
-    readonly damageType: PersonalDamageType;
-    /** Firing cycle. */
-    readonly fireMode: PersonalFireMode;
-    /** Shots per second. */
-    readonly rateOfFire: number;
-    /** Rounds loaded in one magazine. */
-    readonly magazineSize: number;
-    /** Spare rounds carried before suit-capacity changes. */
-    readonly reserveAmmo: number;
-    /** Headshot damage multiplier (`2` means 200%). */
-    readonly headshotMultiplier: number;
-    /** Nominal effective range in metres. */
-    readonly effectiveRange: number;
-    /**
-     * 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>>;
-}
-/**
- * All eleven handheld weapons in catalogue order.
- *
- * @example
- * ```ts
- * import { PERSONAL_WEAPONS } from '@elite-dangerous-almanac/core/equipment/weapons';
- * PERSONAL_WEAPONS.length; // -> 11
- * ```
- */
-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"`,
- * 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.
- * @example
- * ```ts
- * import { getPersonalWeaponBySymbol } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponBySymbol('wpn_m_assaultrifle_kinetic_fauto')?.name; // -> 'Karma AR-50'
- * ```
- */
-declare function getPersonalWeaponBySymbol(symbol: string): PersonalWeapon | null;
-/**
- * Look up a handheld weapon by display name, case-insensitively.
- *
- * @param name - English display name such as `"Karma AR-50"`; surrounding
- * whitespace is ignored.
- * @returns The frozen weapon record, or `null` when unknown.
- * @throws {TypeError} If `name` is present and not a string. A nullish name is a miss,
- * answered like an unrecognised one.
- * @example
- * ```ts
- * import { getPersonalWeaponByName } from '@elite-dangerous-almanac/core/equipment/weapons';
- * getPersonalWeaponByName('Karma AR-50')?.symbol; // -> 'wpn_m_assaultrifle_kinetic_fauto'
- * ```
- */
-declare function getPersonalWeaponByName(name: string): PersonalWeapon | null;
-/**
- * Read one handheld weapon's stats at a grade.
- *
- * @param weapon - A catalogue weapon record.
- * @param grade - Integer grade `1`–`5`.
- * @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
- * ```
- */
-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 };
+import './engineering.js';
+export { P as PERSONAL_WEAPONS, a as PersonalDamageType, b as PersonalFireMode, e as PersonalWeapon, f as PersonalWeaponClass, g as PersonalWeaponEngineeringType, h as PersonalWeaponGrade, i as PersonalWeaponMetrics, j as PersonalWeaponSlot, R as ReloadTime, k as ScopeMagnification, W as WeaponUpgradeGroup, n as getPersonalWeaponByName, o as getPersonalWeaponBySymbol, p as getPersonalWeaponGrade, u as personalWeaponMetrics } from '../suits-B37rAORs.js';

package/dist/equipment/weapons.js

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

package/dist/i18n/blueprints.d.ts

@@ -4,9 +4,8 @@
  *
  * @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
- * hyphens. A regional tag falls back to its language after an exact-locale miss.
+ * @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 blueprint name; the canonical `Blueprint.name` for any English
  * tag; or `null` when the id is unknown, the locale is
  * unsupported, or the pinned source carries no value for that blueprint and locale.

package/dist/i18n/blueprints.js

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

package/dist/i18n/commodities.d.ts

@@ -0,0 +1,36 @@
+/** Localized market-commodity display names, isolated from commodity metadata. */
+/**
+ * Look up a market commodity's source-backed display name for a locale.
+ *
+ * @param symbol - Frontier's commodity symbol, such as `"LavianBrandy"`. Matching
+ * ignores case and surrounding whitespace, so the lower-cased form a market or journal
+ * line reports resolves too.
+ * @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 commodity name; the canonical `Commodity.name` for any English
+ * tag; or `null` when the symbol is unknown or the locale is not one of the six this
+ * catalogue stores.
+ * @remarks
+ * Standard and rare commodities share this one lookup, as they share one symbol space.
+ * All six stored locales are complete for this dataset, so a supported locale always
+ * answers. This function bundles names only, not categories or the `rare` flag.
+ *
+ * **This is a heavy `i18n` dataset**: six locales for every good in both commodity
+ * catalogues is ~101 KiB minified (~27 KiB gzipped). It has its own module so an application that
+ * never shows a translated commodity name does not pay for it — import it from
+ * `core/i18n/commodities` rather than the `core/i18n` barrel if you want that boundary
+ * to be explicit.
+ * @throws {TypeError} If `symbol` is present and not a string, or `locale` is not a
+ * string. A nullish `symbol` is a lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getCommodityName } from '@elite-dangerous-almanac/core/i18n/commodities';
+ *
+ * getCommodityName('LavianBrandy', 'de-DE'); // -> 'Lave-Brandy'
+ * getCommodityName('platinum', 'ru'); // -> 'Платина'
+ * getCommodityName('platinum', 'it'); // -> null
+ * ```
+ */
+declare function getCommodityName(symbol: string, locale: string): string | null;
+
+export { getCommodityName };

package/dist/i18n/commodities.js

@@ -0,0 +1 @@
+export{getCommodityName}from"../chunk-TRGHPX2O.js";                                                                                       //# sourceMappingURL=commodities.js.map

package/dist/i18n/commodities.js.map

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

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

@@ -9,12 +9,11 @@
  * question — it names the damage split or behaviour the `modifiers` list cannot
  * express — and the two are deliberately not the same string.
  *
- * **This is the heaviest `i18n` dataset**: six locales of prose for all 86 effects is
- * ~129 KiB minified (~25 KiB gzipped), more than module names cost. Every other lookup
- * on this subpath carries short display names. It has its own module so an application
- * that never shows an effect description does not pay for it — import it from
- * `core/i18n/experimental-effect-descriptions` rather than the `core/i18n` barrel if
- * you want that boundary to be explicit.
+ * **This is a heavy `i18n` dataset**: six locales of prose for every effect is ~129 KiB
+ * minified (~25 KiB gzipped), more than module names cost. It has its own module so an
+ * application that never shows an effect description does not pay for it — import it
+ * from `core/i18n/experimental-effect-descriptions` rather than the `core/i18n` barrel
+ * if you want that boundary to be explicit.
  *
  * @param experimentalEffectSymbol - Frontier's experimental-effect id. Matching ignores case and
  * surrounding whitespace.

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

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

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

@@ -4,9 +4,8 @@
  *
  * @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
- * hyphens. A regional tag falls back to its language after an exact-locale miss.
+ * @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 effect name; the canonical `ExperimentalEffect.name` for any
  * English tag; or `null` when
  * the id is unknown, the locale is unsupported, or the pinned source carries no value

package/dist/i18n/experimental-effects.js

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

package/dist/i18n/index.d.ts

@@ -1,13 +1,97 @@
+/**
+ * Sparse, source-backed localized display names and descriptions for Elite Dangerous
+ * outfitting, personal-equipment, engineering, material and market-commodity
+ * catalogues.
+ *
+ * Each lookup takes the identifier its owning catalogue is keyed by — a Frontier symbol,
+ * or the library id where the game publishes none, as for a suit tool — and a BCP 47
+ * locale. English is complete: for a name catalogue it is exactly the owning record's
+ * `name`, and for a description catalogue it is the game's own display prose, which no
+ * catalogue otherwise publishes.
+ * Other locales are intentionally sparse: the function returns `null` when its pinned
+ * sources carry no translation, leaving the application in control of fallback policy.
+ * A source-backed localized spelling can be identical to English; the lookup returns
+ * explicit source values verbatim but never manufactures an English fallback.
+ * The catalogues carry English, French, German, Portuguese, Russian and Spanish only,
+ * each stored under a bare language tag: a regional or script subtag is dropped
+ * (`de-DE` → `de`), and any other language is an unsupported locale.
+ *
+ * **How sparse, dataset by dataset.** Each column below is the percentage of that
+ * lookup's keys carrying a stored value for the locale, so a `0` would mean the dataset
+ * holds nothing in that language at all and the lookup returns `null` for every key:
+ * most datasets are complete in every locale, while the outfitting families the game
+ * does not name separately have no locale at all. Plan fallback per
+ * lookup rather than per application. The table is generated from the
+ * [`data/i18n/` catalogues](https://github.com/DarkSession/Elite-Dangerous-Almanac/tree/main/data/i18n),
+ * so it moves when the data does.
+ *
+ * <!-- generated by scripts/i18n-coverage.mjs -->
+ * | Lookup | Keys | en | de | es | fr | pt | ru |
+ * | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+ * | `getBlueprintName` | 107 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getCommodityName` | 412 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getExperimentalEffectDescription` | 86 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getExperimentalEffectName` | 86 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getMaterialName` | 146 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getMicroResourceName` | 226 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getModuleName` | 1203 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getPersonalModificationDescription` | 31 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getPersonalModificationName` | 31 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getPersonalToolName` | 4 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getPersonalWeaponDescription` | 11 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getSuitDescription` | 19 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getSuitName` | 19 | 100 | 100 | 100 | 100 | 100 | 100 |
+ * | `getPreEngineeredVariantName` | 76 | 100 | 92 | 89 | 89 | 100 | 100 |
+ * | `getOutfittingFamilyName` | 77 | 100 | 75 | 75 | 75 | 75 | 75 |
+ * <!-- end generated -->
+ *
+ * Each dataset lives in a separate runtime module. Import from this barrel for
+ * convenience or from the corresponding `i18n/*` subpath for an explicit bundle
+ * boundary.
+ *
+ * Structured diagnostic helpers expose their English fallback only for English
+ * locales and return `null` otherwise, so a UI never mistakes English prose for a
+ * requested translation. Stable codes and `params` remain available for applications
+ * that supply their own message catalogues.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   getBlueprintName,
+ *   getMaterialName,
+ *   getModuleName,
+ *   getOutfittingFamilyName,
+ * } from '@elite-dangerous-almanac/core/i18n';
+ *
+ * getModuleName('Int_Hyperdrive_Size6_Class5', 'de'); // -> 'Frameshiftantrieb'
+ * getBlueprintName('FSD_LongRange', 'de-DE'); // -> 'Erhöhte FSA-Reichweite'
+ * getMaterialName('GridResistors', 'de'); // -> 'Gitterwiderstände'
+ *
+ * // Sparseness is per dataset, not per locale: German module names are complete,
+ * // while no outfitting family the game does not name separately has any.
+ * getOutfittingFamilyName('shieldGenerators', 'de'); // -> 'Schildgeneratoren'
+ * getOutfittingFamilyName('xenoScanners', 'de'); // -> null
+ * ```
+ *
+ * @packageDocumentation
+ */
 export { getModuleName } from './modules.js';
 export { getOutfittingFamilyName } from './module-families.js';
 export { getBlueprintName } from './blueprints.js';
 export { getExperimentalEffectName } from './experimental-effects.js';
 export { getExperimentalEffectDescription } from './experimental-effect-descriptions.js';
+export { getCommodityName } from './commodities.js';
 export { getMaterialName } from './materials.js';
 export { getMicroResourceName } from './micro-resources.js';
+export { getPersonalMountName, getSuitDescription, getSuitName } from './suits.js';
+export { getPersonalToolName } from './personal-tools.js';
+export { getPersonalWeaponDescription } from './personal-weapons.js';
+export { getPersonalModificationDescription, getPersonalModificationName } from './personal-modifications.js';
 export { getLoadoutSlotName, getSlotRestrictionLabel } from './slots.js';
 export { getCalculationIssueMessage, getLoadoutEditErrorMessage, getLoadoutIssueMessage, getSlefDiagnosticMessage } from './diagnostics.js';
 export { PreEngineeredVariantIdentity, getPreEngineeredVariantName } from './pre-engineered.js';
+import '../suits-B37rAORs.js';
+import '../equipment/engineering.js';
 import '../ships/slots.js';
 import '../ships/loadout-calculations.js';
 import '../ships/loadout-validation.js';
@@ -28,7 +112,9 @@ import '../ships/source-purchase.js';
  * Almanac. Every other locale is sparse and source-dependent. A lookup accepts any
  * string rather than only this union so callers can pass their application locale
  * directly: a regional tag such as `de-DE` falls back to `de`, while an unsupported tag
- * or a missing translation returns `null`.
+ * or a missing translation returns `null`. Matching is case-insensitive and accepts an
+ * underscore in place of a hyphen; a regional or script subtag is dropped rather than
+ * matched, since every stored locale is a bare language tag.
  * A source may explicitly publish a localized value whose spelling equals the canonical
  * English name. Lookups return that source value verbatim; they never generate an
  * English fallback for a missing locale.

package/dist/i18n/index.js

@@ -1 +1 @@
-export{getExperimentalEffectName}from"../chunk-BMQM4JBL.js";export{getMaterialName}from"../chunk-IZIIGK3W.js";export{getMicroResourceName}from"../chunk-XFDMCPDW.js";export{getOutfittingFamilyName}from"../chunk-SD6GNFDX.js";export{getModuleName}from"../chunk-QJECDMQQ.js";export{getPreEngineeredVariantName}from"../chunk-T7IQHFQ2.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getBlueprintName}from"../chunk-DBDCOHI4.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getExperimentalEffectDescription}from"../chunk-MRLUWHGI.js";                                                                                                                    //# sourceMappingURL=index.js.map
+export{getPersonalModificationDescription,getPersonalModificationName}from"../chunk-SS7HVNP5.js";export{getPersonalToolName}from"../chunk-E2HDF6PJ.js";export{getPersonalWeaponDescription}from"../chunk-7C7NJWCF.js";export{getPreEngineeredVariantName}from"../chunk-T7IQHFQ2.js";export{getLoadoutSlotName,getSlotRestrictionLabel}from"../chunk-ZRG35JSH.js";                                                          export{getPersonalMountName,getSuitDescription,getSuitName}from"../chunk-RA4YJBU5.js";export{getCalculationIssueMessage,getLoadoutEditErrorMessage,getLoadoutIssueMessage,getSlefDiagnosticMessage}from"../chunk-6G6TYW2D.js";export{getExperimentalEffectDescription}from"../chunk-RJ3ZLQRB.js";export{getExperimentalEffectName}from"../chunk-QPT2WJYN.js";export{getMaterialName}from"../chunk-UE22QU7A.js";export{getMicroResourceName}from"../chunk-WZIBBJHA.js";export{getOutfittingFamilyName}from"../chunk-YBE5M27G.js";export{getModuleName}from"../chunk-URRPEUIK.js";export{getBlueprintName}from"../chunk-UI5RROGI.js";export{getCommodityName}from"../chunk-TRGHPX2O.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/i18n/materials.d.ts

@@ -4,10 +4,8 @@
  *
  * @param symbol - Frontier's material symbol, such as `"GridResistors"`. 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 material name; the canonical `Material.name` for any English
  * tag; or `null` when the symbol is unknown or the locale is not one of the six this
  * catalogue stores.

package/dist/i18n/materials.js

@@ -1 +1 @@
-export{getMaterialName}from"../chunk-IZIIGK3W.js";                                                                                       //# sourceMappingURL=materials.js.map
+export{getMaterialName}from"../chunk-UE22QU7A.js";                                                                                       //# sourceMappingURL=materials.js.map

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

@@ -4,10 +4,8 @@
  *
  * @param symbol - Frontier's micro-resource symbol, such as `"graphene"`. 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 micro-resource name; the canonical `MicroResource.name` for
  * any English tag; or `null` when the symbol is unknown or the locale is not one of the
  * six this catalogue stores.

package/dist/i18n/micro-resources.js

@@ -1 +1 @@
-export{getMicroResourceName}from"../chunk-XFDMCPDW.js";                                                                                       //# sourceMappingURL=micro-resources.js.map
+export{getMicroResourceName}from"../chunk-WZIBBJHA.js";                                                                                       //# sourceMappingURL=micro-resources.js.map

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

@@ -4,17 +4,15 @@
  *
  * @param familyId - The stable family id carried by `OutfittingModuleIdentity.familyId`,
  * such as `"shieldGenerators"`. 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 family name; the canonical `OUTFITTING_FAMILIES` name for any
  * English tag; or `null` when the family is unknown, the locale is unsupported, or the
  * pinned source carries no category label for that family and locale.
  * @remarks
  * Every module carries a family, so an outfitting list can group and label every choice
  * `ShipLoadout.modulesForSlot()` returns from this lookup alone. The table bundles no
- * module stats. Missing translations never silently fall back to English: 19 of the 77
+ * module stats. Missing translations never silently fall back to English: some
  * families have no source-backed label in any locale, tracked by
  * [#320](https://github.com/DarkSession/Elite-Dangerous-Almanac/issues/320).
  * @throws {TypeError} If `familyId` is present and not a string, or `locale` is not a

package/dist/i18n/module-families.js

@@ -1 +1 @@
-export{getOutfittingFamilyName}from"../chunk-SD6GNFDX.js";                                                                                       //# sourceMappingURL=module-families.js.map
+export{getOutfittingFamilyName}from"../chunk-YBE5M27G.js";                                                                                       //# sourceMappingURL=module-families.js.map

package/dist/i18n/modules.d.ts

@@ -4,10 +4,8 @@
  *
  * @param symbol - Frontier's module symbol, such as `"Int_Hyperdrive_Size6_Class5"`.
  * 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 outfitting name; the canonical `OutfittingModule.name` for any
  * English tag; or `null` when the symbol is unknown or the locale is not one of the six
  * this catalogue stores.
@@ -16,8 +14,7 @@
  * answers. The table deduplicates modules that share one name in every locale, which is
  * finer than sharing one canonical English name: the game distinguishes the singular and
  * plural hull alloys, for instance, where English spells both the same. It does not
- * bundle any module stats, so this lookup avoids the 1,194-record `ALL_MODULES`
- * catalogue.
+ * bundle any module stats, so this lookup avoids the `ALL_MODULES` catalogue.
  * @throws {TypeError} If `symbol` is present and not a string, or `locale` is not a
  * string. A nullish `symbol` is a lookup miss and returns `null`.
  * @example

package/dist/i18n/modules.js

@@ -1 +1 @@
-export{getModuleName}from"../chunk-QJECDMQQ.js";                                                                                       //# sourceMappingURL=modules.js.map
+export{getModuleName}from"../chunk-URRPEUIK.js";                                                                                       //# sourceMappingURL=modules.js.map

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

@@ -0,0 +1,66 @@
+/**
+ * Localized personal-equipment modification names and descriptions, isolated from the
+ * recipes' modifiers and material costs.
+ */
+/**
+ * Look up an engineer-applied personal-equipment modification's source-backed display
+ * name for a locale.
+ *
+ * @param modificationSymbol - The recipe symbol `PERSONAL_MODIFICATIONS` is keyed by,
+ * such as `"suit_increasedmeleedamage"` or the technology-specific
+ * `"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"` 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.
+ * @remarks
+ * All six stored locales are complete for this dataset, so a supported locale always
+ * answers. The game offers Greater Range, Headshot Damage and Improved Hip Fire Accuracy
+ * as one menu entry each, so the three Kinetic, Laser and Plasma recipes this repository
+ * keys separately share that entry's record rather than storing it three times.
+ * @throws {TypeError} If `modificationSymbol` is present and not a string, or `locale`
+ * is not a string. A nullish `modificationSymbol` is a lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getPersonalModificationName } from '@elite-dangerous-almanac/core/i18n/personal-modifications';
+ *
+ * getPersonalModificationName('suit_nightvision', 'de'); // -> 'Nachtsicht'
+ * getPersonalModificationName('weapon_range_laser', 'fr'); // -> 'Portée améliorée'
+ * getPersonalModificationName('suit_nightvision', 'it'); // -> null
+ * ```
+ */
+declare function getPersonalModificationName(modificationSymbol: string, locale: string): string | null;
+/**
+ * Look up an engineer-applied personal-equipment modification's display description —
+ * the prose the game shows a player, in all six stored locales.
+ *
+ * @param modificationSymbol - The recipe symbol `PERSONAL_MODIFICATIONS` is keyed by,
+ * exactly as {@link getPersonalModificationName} accepts. Matching ignores case and
+ * surrounding whitespace.
+ * @param locale - A BCP 47 locale. All six stored locales are complete for this dataset.
+ * @returns The localized description, or `null` when the recipe is unknown or the
+ * requested locale is not one this catalogue stores.
+ * @remarks
+ * 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 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.
+ * @example
+ * ```ts
+ * import { getPersonalModificationDescription } from '@elite-dangerous-almanac/core/i18n/personal-modifications';
+ *
+ * getPersonalModificationDescription('suit_nightvision', 'en');
+ * // -> 'Adds Night Vision capabilities to the suit.'
+ * getPersonalModificationDescription('suit_nightvision', 'ja'); // -> null
+ * ```
+ */
+declare function getPersonalModificationDescription(modificationSymbol: string, locale: string): string | null;
+
+export { getPersonalModificationDescription, getPersonalModificationName };

package/dist/i18n/personal-modifications.js

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

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

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

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

@@ -0,0 +1,32 @@
+/** Localized handheld-weapon descriptions, isolated from weapon combat stats. */
+/**
+ * Look up a handheld weapon's display description — the prose the game shows a player,
+ * in all six stored locales.
+ *
+ * @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"` 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
+ * **There is no matching name lookup, and that is not a gap.** A handheld weapon's name
+ * is a product name — "Karma P-15", "TK Aphelion" — that the game leaves in English in
+ * every locale, so `PersonalWeapon.name` is the name in all six. This is display prose
+ * and not a statement of the weapon's mechanics: it names no damage figure, rate of fire
+ * or effective range, which are the stats `PERSONAL_WEAPONS` carries.
+ * @throws {TypeError} If `symbol` is present and not a string, or `locale` is not a
+ * string. A nullish `symbol` is a lookup miss and returns `null`.
+ * @example
+ * ```ts
+ * import { getPersonalWeaponDescription } from '@elite-dangerous-almanac/core/i18n/personal-weapons';
+ *
+ * getPersonalWeaponDescription('wpn_m_sniper_plasma_charged', 'en');
+ * // -> 'A semi-automatic, long-range plasma rifle with high damage output and a low rate of fire.'
+ * getPersonalWeaponDescription('wpn_m_sniper_plasma_charged', 'it'); // -> null
+ * ```
+ */
+declare function getPersonalWeaponDescription(symbol: string, locale: string): string | null;
+
+export { getPersonalWeaponDescription };

package/dist/i18n/personal-weapons.js

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

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

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

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.