@elite-dangerous-almanac/core 0.1.0-beta.1

package/dist/chunk-Z4OUB4SJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/astro/nebulae-planetary.ts"],"names":["buildNebulaCatalogue","nebulae_planetary_default","PLANETARY_NEBULAE"],"mappings":"O,+n+YAmCO,IAAME,kBAAuCF,qBAChDC,0BACA,oBACJC"}

package/dist/chunk-ZFT56QFR.js

@@ -0,0 +1 @@
+import{findByKey}from"./chunk-S4DBNX2B.js";function distanceSquared(coords,nebula){const dx=coords.x-nebula.x;const dy=coords.y-nebula.y;const dz=coords.z-nebula.z;return dx*dx+dy*dy+dz*dz}function compareRank(a,b){return a.distanceSquared-b.distanceSquared||a.catalogueIndex-b.catalogueIndex}function withDistance({nebula:nebula,distanceSquared:distanceSquared2}){return{...nebula,distanceLy:Math.sqrt(distanceSquared2)}}function pushMaxHeap(heap,ranked){heap.push(ranked);let index=heap.length-1;while(index>0){const parent=Math.floor((index-1)/2);if(compareRank(heap[parent],heap[index])>=0)return;[heap[parent],heap[index]]=[heap[index],heap[parent]];index=parent}}function replaceMaxHeapRoot(heap,ranked){heap[0]=ranked;let index=0;while(true){const left=index*2+1;if(left>=heap.length)return;const right=left+1;const worseChild=right<heap.length&&compareRank(heap[right],heap[left])>0?right:left;if(compareRank(heap[index],heap[worseChild])>=0)return;[heap[index],heap[worseChild]]=[heap[worseChild],heap[index]];index=worseChild}}function nearestNebulae(coords,nebulae,count=3){const limit=Math.min(Math.max(Math.trunc(count),0),nebulae.length);if(!(limit>0))return[];if(limit===nebulae.length){const ranked=nebulae.map(nebula=>({nebula:nebula,distanceSquared:distanceSquared(coords,nebula)}));ranked.sort((a,b)=>a.distanceSquared-b.distanceSquared);return ranked.map(({nebula:nebula,distanceSquared:distanceSquared2})=>({...nebula,distanceLy:Math.sqrt(distanceSquared2)}))}const nearest=[];nebulae.forEach((nebula,catalogueIndex)=>{const ranked={nebula:nebula,distanceSquared:distanceSquared(coords,nebula),catalogueIndex:catalogueIndex};if(nearest.length<limit){pushMaxHeap(nearest,ranked)}else if(compareRank(ranked,nearest[0])<0){replaceMaxHeapRoot(nearest,ranked)}});nearest.sort(compareRank);return nearest.map(withDistance)}function nebulaeWithin(coords,nebulae,radiusLy){if(radiusLy<0)return[];const limit=radiusLy*radiusLy;const hits=[];for(const nebula of nebulae){const d2=distanceSquared(coords,nebula);if(d2<=limit)hits.push({...nebula,distanceLy:Math.sqrt(d2)})}hits.sort((a,b)=>a.distanceLy-b.distanceLy);return hits}function getNebulaByName(name,nebulae){return findByKey(nebulae,"name",name,"getNebulaByName: name")}export{getNebulaByName,nearestNebulae,nebulaeWithin};//# sourceMappingURL=chunk-ZFT56QFR.js.map

package/dist/chunk-ZFT56QFR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/astro/nebulae.ts"],"names":["findByKey","distanceSquared","coords","nebula","dx","x","dy","y","dz","z","compareRank","a","b","catalogueIndex","withDistance","distanceLy","Math","sqrt","pushMaxHeap","heap","ranked","push","index","length","parent","floor","replaceMaxHeapRoot","left","right","worseChild","nearestNebulae","nebulae","count","limit","min","max","trunc","map","sort","nearest","forEach","nebulaeWithin","radiusLy","hits","d2","getNebulaByName","name"],"mappings":"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"}

package/dist/chunk-ZNCXENNB.js

@@ -0,0 +1 @@
+function mapDamageTypes(value){return{kinetic:value("kinetic"),thermal:value("thermal"),explosive:value("explosive"),caustic:value("caustic")}}function effectiveHitPoints(total,resistances){return mapDamageTypes(type=>{const resistance=resistances[type];return resistance>=1?Infinity:total/(1-resistance)})}var multiplierOf=resistance=>1-resistance;var mapIntoDiminishingRange=(min,max,now)=>max===0?min:min+(max-min)*(now/max);function shieldMultiplier(generator,boosters){const generatorMultiplier=multiplierOf(generator);const combined=boosters.reduce((product,resistance)=>product*multiplierOf(resistance),generatorMultiplier);const threshold=generatorMultiplier*.7;if(combined>=threshold)return combined;return mapIntoDiminishingRange(threshold/2,threshold,combined)}function stackShieldResistance(generator,boosters=[]){return 1-shieldMultiplier(generator,boosters)}function armourMultiplier(bulkhead,reinforcements){const multipliers=[bulkhead,...reinforcements].map(multiplierOf);const combined=multipliers.reduce((product,multiplier)=>product*multiplier,1);const threshold=Math.min(.7,...multipliers);const diminished=mapIntoDiminishingRange(.35,threshold,combined);return diminished<.7?diminished:combined}function stackArmourResistance(bulkhead,reinforcements=[]){return 1-armourMultiplier(bulkhead,reinforcements)}function systemsResistance(pips){if(!Number.isFinite(pips)||pips<0||pips>4){throw new RangeError("systemsResistance: pips must be a finite number in [0, 4]")}return Math.pow(pips,.85)*.6/Math.pow(4,.85)}export{effectiveHitPoints,mapDamageTypes,stackArmourResistance,stackShieldResistance,systemsResistance};//# sourceMappingURL=chunk-ZNCXENNB.js.map

package/dist/chunk-ZNCXENNB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ships/resistances.ts"],"names":["mapDamageTypes","value","kinetic","thermal","explosive","caustic","effectiveHitPoints","total","resistances","type","resistance","Infinity","multiplierOf","mapIntoDiminishingRange","min","max","now","shieldMultiplier","generator","boosters","generatorMultiplier","combined","reduce","product","threshold","stackShieldResistance","armourMultiplier","bulkhead","reinforcements","multipliers","map","multiplier","Math","diminished","stackArmourResistance","systemsResistance","pips","Number","isFinite","RangeError","pow"],"mappings":"AAiIO,SAASA,eAAeC,OAC3B,MAAO,CACHC,QAASD,MAAM,WACfE,QAASF,MAAM,WACfG,UAAWH,MAAM,aACjBI,QAASJ,MAAM,WAEvB,CAyBO,SAASK,mBACZC,MACAC,aAEA,OAAOR,eAAgBS,OACnB,MAAMC,WAAaF,YAAYC,MAC/B,OAAOC,YAAc,EAAIC,SAAWJ,OAAS,EAAIG,aAEzD,CAGA,IAAME,aAAgBF,YAA+B,EAAIA,WAMzD,IAAMG,wBAA0B,CAACC,IAAaC,IAAaC,MACvDD,MAAQ,EAAID,IAAMA,KAAOC,IAAMD,MAAQE,IAAMD,KAGjD,SAASE,iBAAiBC,UAAmBC,UACzC,MAAMC,oBAAsBR,aAAaM,WACzC,MAAMG,SAAWF,SAASG,OACtB,CAACC,QAASb,aAAea,QAAUX,aAAaF,YAChDU,qBAIJ,MAAMI,UAAYJ,oBAAsB,GACxC,GAAIC,UAAYG,UAAW,OAAOH,SAClC,OAAOR,wBAAwBW,UAAY,EAAGA,UAAWH,SAC7D,CAmBO,SAASI,sBAAsBP,UAAmBC,SAA8B,IACnF,OAAO,EAAIF,iBAAiBC,UAAWC,SAC3C,CAGA,SAASO,iBAAiBC,SAAkBC,gBACxC,MAAMC,YAAc,CAACF,YAAaC,gBAAgBE,IAAIlB,cACtD,MAAMS,SAAWQ,YAAYP,OAAO,CAACC,QAASQ,aAAeR,QAAUQ,WAAY,GAEnF,MAAMP,UAAYQ,KAAKlB,IAAI,MAAQe,aACnC,MAAMI,WAAapB,wBAAwB,IAAMW,UAAWH,UAG5D,OAAOY,WAAa,GAAMA,WAAaZ,QAC3C,CAkBO,SAASa,sBACZP,SACAC,eAAoC,IAEpC,OAAO,EAAIF,iBAAiBC,SAAUC,eAC1C,CAuBO,SAASO,kBAAkBC,MAC9B,IAAKC,OAAOC,SAASF,OAASA,KAAO,GAAKA,KAAO,EAAG,CAChD,MAAM,IAAIG,WAAW,4DACzB,CACA,OAAQP,KAAKQ,IAAIJ,KAAM,KAAQ,GAAOJ,KAAKQ,IAAI,EAAG,IACtD,QAAAlC,mBAAAN,eAAAkC,sBAAAT,sBAAAU"}

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

@@ -0,0 +1,25 @@
+import { Commodity } from './commodities.js';
+
+/**
+ * Every market commodity — the standard and rare catalogues concatenated.
+ *
+ * Importing this pulls both data modules; when you only need one, import
+ * `COMMODITIES` or `RARE_COMMODITIES` from its own module so a bundler can drop the
+ * other.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All 399 commodities, standard first then rare.
+ *
+ * @example
+ * ```ts
+ * import { ALL_COMMODITIES } from '@elite-dangerous-almanac/core/commodities/commodities-all';
+ *
+ * ALL_COMMODITIES.length; // -> 399
+ * ```
+ */
+declare const ALL_COMMODITIES: readonly Commodity[];
+
+export { ALL_COMMODITIES };

package/dist/commodities/commodities-all.js

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

package/dist/commodities/commodities-all.js.map

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

package/dist/commodities/commodities-rare.d.ts

@@ -0,0 +1,34 @@
+import { Commodity } from './commodities.js';
+
+/**
+ * The catalogue of **rare** market commodities — the 142 location-specific luxury
+ * goods, each produced at a single station and worth more the further it is carried.
+ *
+ * Every record here is a rare commodity (`rare: true`); the standard market goods
+ * live in `./commodities-standard`. Search it with the query functions in
+ * `./commodities`.
+ *
+ * Data from EDCD FDevIDs (`rare_commodity.csv`); see [`data/commodities/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/commodities/SOURCES.md).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All 142 rare commodities, in Frontier's registry order.
+ *
+ * @remarks
+ * Every record has `rare: true`. The array and its records are frozen. A rare's
+ * origin station is not carried — the CSV's `market_id` is dropped, since the library
+ * has no station registry to resolve it against.
+ *
+ * @example
+ * ```ts
+ * import { RARE_COMMODITIES } from '@elite-dangerous-almanac/core/commodities/commodities-rare';
+ *
+ * RARE_COMMODITIES.length; // -> 142
+ * RARE_COMMODITIES.find((c) => c.symbol === 'LavianBrandy')?.name; // -> 'Lavian Brandy'
+ * ```
+ */
+declare const RARE_COMMODITIES: readonly Commodity[];
+
+export { RARE_COMMODITIES };

package/dist/commodities/commodities-rare.js

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

package/dist/commodities/commodities-rare.js.map

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

package/dist/commodities/commodities-standard.d.ts

@@ -0,0 +1,34 @@
+import { Commodity } from './commodities.js';
+
+/**
+ * The catalogue of **standard** market commodities — the 257 goods traded at
+ * station commodity markets, across all sixteen market groups.
+ *
+ * Every record here is a standard commodity (`rare: false`); the rare goods live in
+ * `./commodities-rare`. Search it with the query functions in `./commodities`.
+ *
+ * Data from EDCD FDevIDs (`commodity.csv`), plus one record absent from the pinned
+ * FDevIDs snapshot whose symbol and name were observed in a player journal and whose
+ * market category was verified in-game; see
+ * [`data/commodities/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/commodities/SOURCES.md).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All 257 standard commodities, in Frontier's registry order.
+ *
+ * @remarks
+ * Every record has `rare: false`. The array and its records are frozen.
+ *
+ * @example
+ * ```ts
+ * import { COMMODITIES } from '@elite-dangerous-almanac/core/commodities/commodities-standard';
+ *
+ * COMMODITIES.length; // -> 257
+ * COMMODITIES.find((c) => c.symbol === 'Gold')?.category; // -> 'Metals'
+ * ```
+ */
+declare const COMMODITIES: readonly Commodity[];
+
+export { COMMODITIES };

package/dist/commodities/commodities-standard.js

@@ -0,0 +1 @@
+export{COMMODITIES}from"../chunk-7EE5VIHR.js";                             //# sourceMappingURL=commodities-standard.js.map

package/dist/commodities/commodities-standard.js.map

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

package/dist/commodities/commodities.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Market-commodity types and lookups.
+ *
+ * Elite Dangerous trades goods at station commodity markets. Frontier splits them
+ * into two registries: the ~257 **standard** commodities on every market, and the
+ * ~142 **rare** commodities each produced at a single station. This module holds the
+ * {@link Commodity} record shape and the functions that find one
+ * ({@link getCommodityBySymbol}, {@link getCommodityByName},
+ * {@link commoditiesInCategory}).
+ *
+ * **Every lookup searches all 399 commodities by default** — standard and rare — so
+ * you do not have to know which registry a good belongs to before you can find it:
+ *
+ * ```ts
+ * getCommodityByName('lavian brandy')?.rare; // -> true
+ * ```
+ *
+ * Each lookup takes an optional second argument to **narrow** the search to a
+ * subset — one registry's catalogue, or any array you have filtered yourself:
+ *
+ * | Module | Export | Entries |
+ * | --- | --- | --- |
+ * | `./commodities-standard` | `COMMODITIES` | 257 |
+ * | `./commodities-rare` | `RARE_COMMODITIES` | 142 |
+ * | `./commodities-all` | `ALL_COMMODITIES` | 399 (the default) |
+ *
+ * It narrows *results*, not bundle size: importing a lookup pulls both catalogues,
+ * since that is what it falls back to — 29.5 KiB minified for all 399. Every record
+ * carries a {@link Commodity.rare} flag, so a subset is one `.filter()` away.
+ *
+ * @example
+ * ```ts
+ * import { getCommodityBySymbol } from '@elite-dangerous-almanac/core/commodities';
+ *
+ * getCommodityBySymbol('platinum')?.category; // -> 'Metals'
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * A market group — the shelf a commodity sits on at the commodity market.
+ *
+ * @remarks
+ * These are Frontier's own category strings (spelled with spaces where the game
+ * spells them so, e.g. `"Consumer Items"`). Both standard and rare commodities draw
+ * from the same set; the rare registry uses only a subset of these groups.
+ * `"NonMarketable"` is Frontier's group for goods that are not freely traded (its one
+ * member is Limpets).
+ */
+type CommodityCategory = 'Chemicals' | 'Consumer Items' | 'Foods' | 'Industrial Materials' | 'Legal Drugs' | 'Machinery' | 'Medicines' | 'Metals' | 'Minerals' | 'NonMarketable' | 'Salvage' | 'Slavery' | 'Technology' | 'Textiles' | 'Waste' | 'Weapons';
+/**
+ * One tradable commodity in Frontier's market registry.
+ *
+ * @remarks
+ * A pure id/name/category record — this is the commodity registry, not a price
+ * sheet, so it carries no buy/sell price, supply, demand or producing station.
+ * Whether it is a rare good is the {@link Commodity.rare} flag; a rare's origin
+ * station is not carried (the library has no station registry to key it against).
+ */
+interface Commodity {
+    /**
+     * Frontier's internal symbol, e.g. `"Platinum"` — the id the market and player
+     * journal report (case-insensitively, so `"platinum"` matches). This is the same
+     * field, with the same meaning, as `symbol` on a ship, module or material, and is
+     * the commodity's key.
+     */
+    readonly symbol: string;
+    /** Display name, e.g. `"Platinum"`. */
+    readonly name: string;
+    /** The market group this commodity is sold under. */
+    readonly category: CommodityCategory;
+    /**
+     * Whether this is a **rare** commodity — a location-specific luxury good produced
+     * at a single station — rather than a standard market good.
+     *
+     * @remarks
+     * Derived from the catalogue the record lives in: every {@link RARE_COMMODITIES}
+     * record is `true`, every {@link COMMODITIES} record is `false`.
+     */
+    readonly rare: boolean;
+}
+/**
+ * Look up a commodity by its Frontier symbol / journal id (case-insensitive).
+ *
+ * Here, `symbol` is Frontier's internal item id for the commodity.
+ *
+ * @param symbol - The internal symbol, e.g. `"Platinum"`, or the lower-cased form the
+ * market/journal reports (`"platinum"`). Leading/trailing whitespace is ignored.
+ * @param commodities - Optional subset to search instead of all 399 commodities —
+ * `COMMODITIES` (standard only), `RARE_COMMODITIES`, or any array you have filtered
+ * yourself. Omit it unless you specifically want to exclude the other registry.
+ * @returns The matching {@link Commodity}, or `null` if no commodity 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.
+ * @example
+ * ```ts
+ * import { getCommodityBySymbol } from '@elite-dangerous-almanac/core/commodities/commodities';
+ *
+ * getCommodityBySymbol('lavianbrandy')?.name; // -> 'Lavian Brandy'
+ * ```
+ */
+declare function getCommodityBySymbol(symbol: string, commodities?: readonly Commodity[]): Commodity | null;
+/**
+ * Look up a commodity by its display name (case-insensitive).
+ *
+ * @param name - The display name as the market spells it, e.g. `"Lavian Brandy"`.
+ * Leading/trailing whitespace and case are ignored, but matching is otherwise exact.
+ * @param commodities - Optional subset to search (see {@link getCommodityBySymbol}).
+ * @returns The matching {@link Commodity}, or `null` if no commodity has that name.
+ * @throws {TypeError} If `name` is present and not a string. A nullish
+ * `name` is a miss, answered the way an unrecognised one is.
+ * @example
+ * ```ts
+ * import { getCommodityByName } from '@elite-dangerous-almanac/core/commodities/commodities';
+ *
+ * getCommodityByName('platinum')?.category; // -> 'Metals'
+ * ```
+ */
+declare function getCommodityByName(name: string, commodities?: readonly Commodity[]): Commodity | null;
+/**
+ * Every commodity in a given market group, in catalogue order.
+ *
+ * @param category - The market group to match, e.g. `"Metals"`. Leading/trailing
+ * whitespace and case are ignored, like every other lookup here, so a group name
+ * that arrived from a market payload or a user's dropdown resolves without
+ * re-casing it first.
+ * @param commodities - Optional subset to search (see {@link getCommodityBySymbol}).
+ * @returns A new array of matches (possibly empty). The input is not modified.
+ * @throws {TypeError} If `category` is present and not a string. A nullish
+ * `category` is a miss, answered the way an unrecognised one is.
+ * @example
+ * ```ts
+ * import { commoditiesInCategory } from '@elite-dangerous-almanac/core/commodities/commodities';
+ * import { COMMODITIES } from '@elite-dangerous-almanac/core/commodities/commodities-standard';
+ *
+ * commoditiesInCategory('Metals').length;            // -> every metal, standard and rare
+ * commoditiesInCategory('metals', COMMODITIES).length; // -> the standard ones only
+ * ```
+ */
+declare function commoditiesInCategory(category: string, commodities?: readonly Commodity[]): Commodity[];
+
+export { type Commodity, type CommodityCategory, commoditiesInCategory, getCommodityByName, getCommodityBySymbol };

package/dist/commodities/commodities.js

@@ -0,0 +1 @@
+export{commoditiesInCategory,getCommodityByName,getCommodityBySymbol}from"../chunk-KMFUCORC.js";                                                                                                                                                                              //# sourceMappingURL=commodities.js.map

package/dist/commodities/commodities.js.map

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

package/dist/commodities/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Elite Dangerous market commodities — the goods traded at station commodity
+ * markets, standard and rare.
+ *
+ * Every lookup searches both registries by default — import the function and call
+ * it:
+ *
+ * ```ts
+ * import { getCommodityByName, commoditiesInCategory } from '@elite-dangerous-almanac/core/commodities';
+ *
+ * getCommodityByName('gold')?.category;   // -> 'Metals'
+ * commoditiesInCategory('Metals').length; // -> every metal, standard and rare
+ * ```
+ *
+ * Every lookup also takes an optional trailing argument to **narrow** the search to
+ * one registry, or to an array you have filtered yourself:
+ *
+ * ```ts
+ * import { commoditiesInCategory } from '@elite-dangerous-almanac/core/commodities';
+ * import { COMMODITIES } from '@elite-dangerous-almanac/core/commodities/commodities-standard';
+ *
+ * commoditiesInCategory('Metals', COMMODITIES).length; // -> the standard ones only
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Commodity, CommodityCategory, commoditiesInCategory, getCommodityByName, getCommodityBySymbol } from './commodities.js';
+export { COMMODITIES } from './commodities-standard.js';
+export { RARE_COMMODITIES } from './commodities-rare.js';
+export { ALL_COMMODITIES } from './commodities-all.js';

package/dist/commodities/index.js

@@ -0,0 +1 @@
+export{commoditiesInCategory,getCommodityByName,getCommodityBySymbol}from"../chunk-KMFUCORC.js";export{ALL_COMMODITIES}from"../chunk-JQG4C67D.js";export{RARE_COMMODITIES}from"../chunk-EYGVDJ2I.js";export{COMMODITIES}from"../chunk-7EE5VIHR.js";                                                                                       //# sourceMappingURL=index.js.map

package/dist/commodities/index.js.map

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

package/dist/galactic-position-shLkm4Qg.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared galactic position type.
+ *
+ * A single point in the Elite Dangerous galaxy, in **light-years with Sol at the
+ * origin** — the same frame the game journal and community APIs (EDSM, Spansh)
+ * report system positions in. Several astro features consume it, so it lives in
+ * its own module rather than being owned by any one of them.
+ *
+ * @packageDocumentation
+ */
+/**
+ * A point in the galaxy, in light-years, with Sol at the origin.
+ *
+ * @example
+ * ```ts
+ * import type { GalacticPosition } from '@elite-dangerous-almanac/core/astro';
+ *
+ * const position: GalacticPosition = { x: 751, y: -179, z: -91 };
+ * ```
+ */
+interface GalacticPosition {
+    /** Galactic X in light-years (Sol at origin). */
+    readonly x: number;
+    /** Galactic Y in light-years (Sol at origin). */
+    readonly y: number;
+    /** Galactic Z in light-years (Sol at origin). */
+    readonly z: number;
+}
+
+export type { GalacticPosition as G };

package/dist/materials/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Elite Dangerous materials — the ship-side engineering **materials** (raw,
+ * manufactured and encoded, each with a grade and in-game line) and the on-foot
+ * Odyssey **micro resources** (component, consumable, data and item, each a plain
+ * symbol/name registry record).
+ *
+ * Every lookup searches the whole registry by default — import the function and
+ * call it:
+ *
+ * ```ts
+ * import {
+ *   getMaterialByName,
+ *   materialsByGrade,
+ *   materialsInCategory,
+ *   getMicroResourceBySymbol,
+ *   MaterialGrade,
+ * } from '@elite-dangerous-almanac/core/materials';
+ *
+ * getMaterialByName('iron')?.grade;               // -> MaterialGrade.VeryCommon
+ * materialsByGrade(MaterialGrade.Rare).length;    // -> across every category
+ * materialsInCategory('raw').length;              // -> 28
+ * 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:
+ *
+ * ```ts
+ * import { materialsByGrade } 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
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Material, MaterialCategory, MaterialGrade, MaterialLine, getMaterialByElementSymbol, getMaterialByName, getMaterialBySymbol, materialsByGrade, materialsInCategory, materialsInLine } from './materials.js';
+export { RAW_MATERIALS } from './materials-raw.js';
+export { MANUFACTURED_MATERIALS } from './materials-manufactured.js';
+export { ENCODED_MATERIALS } from './materials-encoded.js';
+export { ALL_MATERIALS } from './materials-all.js';
+export { MicroResource, MicroResourceCategory, getMicroResourceByName, getMicroResourceBySymbol, microResourcesInCategory } from './micro-resources.js';
+export { COMPONENT_MICRO_RESOURCES } from './micro-resources-component.js';
+export { CONSUMABLE_MICRO_RESOURCES } from './micro-resources-consumable.js';
+export { DATA_MICRO_RESOURCES } from './micro-resources-data.js';
+export { ITEM_MICRO_RESOURCES } from './micro-resources-item.js';
+export { ALL_MICRO_RESOURCES } from './micro-resources-all.js';

package/dist/materials/index.js

@@ -0,0 +1 @@
+export{getMicroResourceByName,getMicroResourceBySymbol,microResourcesInCategory}from"../chunk-ELIZXUMI.js";export{MaterialGrade,MaterialLine,getMaterialByElementSymbol,getMaterialByName,getMaterialBySymbol,materialsByGrade,materialsInCategory,materialsInLine}from"../chunk-Q22LXT53.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";                             export{ALL_MICRO_RESOURCES}from"../chunk-5H74FKY7.js";export{COMPONENT_MICRO_RESOURCES}from"../chunk-HTB52N6S.js";export{CONSUMABLE_MICRO_RESOURCES}from"../chunk-K7L7SMIR.js";export{DATA_MICRO_RESOURCES}from"../chunk-RIT6MOO5.js";export{ITEM_MICRO_RESOURCES}from"../chunk-CI3ACMRA.js";                                                                                                                    //# sourceMappingURL=index.js.map

package/dist/materials/index.js.map

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

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

@@ -0,0 +1,26 @@
+import { Material } from './materials.js';
+
+/**
+ * Every engineering material — the raw, manufactured and encoded catalogues
+ * concatenated.
+ *
+ * Importing this pulls all three data modules; when you only need one category,
+ * import `RAW_MATERIALS`, `MANUFACTURED_MATERIALS` or `ENCODED_MATERIALS` from their
+ * own module so a bundler can drop the rest.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All 146 materials 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
+ * ```
+ */
+declare const ALL_MATERIALS: readonly Material[];
+
+export { ALL_MATERIALS };

package/dist/materials/materials-all.js

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

package/dist/materials/materials-all.js.map

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

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

@@ -0,0 +1,31 @@
+import { Material } from './materials.js';
+
+/**
+ * The catalogue of **encoded** materials (data) — the six standard five-grade
+ * lines (Emission Data, Wake Scans, Shield Data, Encryption Files, Data Archives,
+ * Encoded Firmware) plus the Guardian and Thargoid data materials.
+ *
+ * Search it with the query functions in `./materials`.
+ *
+ * Data from EDCD FDevIDs, with Thargoid materials absent from that pinned source
+ * graded by INARA; see [`data/materials/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/materials/SOURCES.md).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All encoded materials, sorted by line then grade.
+ *
+ * @remarks
+ * Every record has `category: 'encoded'`. The array and its records are frozen.
+ *
+ * @example
+ * ```ts
+ * import { ENCODED_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-encoded';
+ *
+ * ENCODED_MATERIALS.find((m) => m.name === 'Datamined Wake Exceptions')?.grade; // -> 5
+ * ```
+ */
+declare const ENCODED_MATERIALS: readonly Material[];
+
+export { ENCODED_MATERIALS };

package/dist/materials/materials-encoded.js

@@ -0,0 +1 @@
+export{ENCODED_MATERIALS}from"../chunk-Q5XOGATC.js";                             //# sourceMappingURL=materials-encoded.js.map

package/dist/materials/materials-encoded.js.map

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

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

@@ -0,0 +1,32 @@
+import { Material } from './materials.js';
+
+/**
+ * The catalogue of **manufactured** materials — the ten standard five-grade lines
+ * (Chemical, Thermic, Heat, Conductive, Mechanical Components, Capacitors,
+ * Shielding, Composite, Crystals, Alloys) plus the Guardian and Thargoid materials.
+ *
+ * Search it with the query functions in `./materials`.
+ *
+ * Data from EDCD FDevIDs, with Thargoid materials absent from that pinned source
+ * graded by INARA; see [`data/materials/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/materials/SOURCES.md).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All manufactured materials, sorted by line then grade.
+ *
+ * @remarks
+ * Every record has `category: 'manufactured'`. The array and its records are frozen.
+ *
+ * @example
+ * ```ts
+ * import { MANUFACTURED_MATERIALS } from '@elite-dangerous-almanac/core/materials/materials-manufactured';
+ *
+ * MANUFACTURED_MATERIALS.find((m) => m.name === 'Imperial Shielding')?.grade;
+ * // -> MaterialGrade.VeryRare (5)
+ * ```
+ */
+declare const MANUFACTURED_MATERIALS: readonly Material[];
+
+export { MANUFACTURED_MATERIALS };

package/dist/materials/materials-manufactured.js

@@ -0,0 +1 @@
+export{MANUFACTURED_MATERIALS}from"../chunk-HKXXFIRI.js";                             //# sourceMappingURL=materials-manufactured.js.map

package/dist/materials/materials-manufactured.js.map

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

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

@@ -0,0 +1,31 @@
+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).
+ *
+ * Each line is named after its grade-1 element: Carbon, Phosphorus, Sulphur, Iron,
+ * Nickel, Rhenium, Lead. Search it with the query functions in `./materials`.
+ *
+ * Data from EDCD FDevIDs; see [`data/materials/SOURCES.md`](https://github.com/DarkSession/Elite-Dangerous-Almanac/blob/main/data/materials/SOURCES.md).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All 28 raw materials, sorted by line then grade.
+ *
+ * @remarks
+ * Every record has `category: 'raw'`. The array and its records are frozen.
+ *
+ * @example
+ * ```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'
+ * ```
+ */
+declare const RAW_MATERIALS: readonly Material[];
+
+export { RAW_MATERIALS };

package/dist/materials/materials-raw.js

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

package/dist/materials/materials-raw.js.map

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