@shipload/sdk 1.0.0-next.0 → 1.0.0-next.10

package/src/data/items.json

@@ -20,6 +20,55 @@
     "tier": 3,
     "category": "ore"
   },
+  {
+    "id": 104,
+    "mass": 71000,
+    "type": "resource",
+    "tier": 4,
+    "category": "ore"
+  },
+  {
+    "id": 105,
+    "mass": 78000,
+    "type": "resource",
+    "tier": 5,
+    "category": "ore"
+  },
+  {
+    "id": 106,
+    "mass": 87000,
+    "type": "resource",
+    "tier": 6,
+    "category": "ore"
+  },
+  {
+    "id": 107,
+    "mass": 96000,
+    "type": "resource",
+    "tier": 7,
+    "category": "ore"
+  },
+  {
+    "id": 108,
+    "mass": 107000,
+    "type": "resource",
+    "tier": 8,
+    "category": "ore"
+  },
+  {
+    "id": 109,
+    "mass": 118000,
+    "type": "resource",
+    "tier": 9,
+    "category": "ore"
+  },
+  {
+    "id": 110,
+    "mass": 130000,
+    "type": "resource",
+    "tier": 10,
+    "category": "ore"
+  },
   {
     "id": 201,
     "mass": 35000,
@@ -41,6 +90,55 @@
     "tier": 3,
     "category": "crystal"
   },
+  {
+    "id": 204,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 4,
+    "category": "crystal"
+  },
+  {
+    "id": 205,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 5,
+    "category": "crystal"
+  },
+  {
+    "id": 206,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 6,
+    "category": "crystal"
+  },
+  {
+    "id": 207,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 7,
+    "category": "crystal"
+  },
+  {
+    "id": 208,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 8,
+    "category": "crystal"
+  },
+  {
+    "id": 209,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 9,
+    "category": "crystal"
+  },
+  {
+    "id": 210,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 10,
+    "category": "crystal"
+  },
   {
     "id": 301,
     "mass": 15000,
@@ -62,6 +160,55 @@
     "tier": 3,
     "category": "gas"
   },
+  {
+    "id": 304,
+    "mass": 11000,
+    "type": "resource",
+    "tier": 4,
+    "category": "gas"
+  },
+  {
+    "id": 305,
+    "mass": 10000,
+    "type": "resource",
+    "tier": 5,
+    "category": "gas"
+  },
+  {
+    "id": 306,
+    "mass": 9000,
+    "type": "resource",
+    "tier": 6,
+    "category": "gas"
+  },
+  {
+    "id": 307,
+    "mass": 8000,
+    "type": "resource",
+    "tier": 7,
+    "category": "gas"
+  },
+  {
+    "id": 308,
+    "mass": 7500,
+    "type": "resource",
+    "tier": 8,
+    "category": "gas"
+  },
+  {
+    "id": 309,
+    "mass": 6500,
+    "type": "resource",
+    "tier": 9,
+    "category": "gas"
+  },
+  {
+    "id": 310,
+    "mass": 6000,
+    "type": "resource",
+    "tier": 10,
+    "category": "gas"
+  },
   {
     "id": 401,
     "mass": 22000,
@@ -83,6 +230,55 @@
     "tier": 3,
     "category": "regolith"
   },
+  {
+    "id": 404,
+    "mass": 32000,
+    "type": "resource",
+    "tier": 4,
+    "category": "regolith"
+  },
+  {
+    "id": 405,
+    "mass": 36000,
+    "type": "resource",
+    "tier": 5,
+    "category": "regolith"
+  },
+  {
+    "id": 406,
+    "mass": 40500,
+    "type": "resource",
+    "tier": 6,
+    "category": "regolith"
+  },
+  {
+    "id": 407,
+    "mass": 46000,
+    "type": "resource",
+    "tier": 7,
+    "category": "regolith"
+  },
+  {
+    "id": 408,
+    "mass": 52000,
+    "type": "resource",
+    "tier": 8,
+    "category": "regolith"
+  },
+  {
+    "id": 409,
+    "mass": 58500,
+    "type": "resource",
+    "tier": 9,
+    "category": "regolith"
+  },
+  {
+    "id": 410,
+    "mass": 66000,
+    "type": "resource",
+    "tier": 10,
+    "category": "regolith"
+  },
   {
     "id": 501,
     "mass": 42000,
@@ -104,6 +300,55 @@
     "tier": 3,
     "category": "biomass"
   },
+  {
+    "id": 504,
+    "mass": 29000,
+    "type": "resource",
+    "tier": 4,
+    "category": "biomass"
+  },
+  {
+    "id": 505,
+    "mass": 26000,
+    "type": "resource",
+    "tier": 5,
+    "category": "biomass"
+  },
+  {
+    "id": 506,
+    "mass": 23000,
+    "type": "resource",
+    "tier": 6,
+    "category": "biomass"
+  },
+  {
+    "id": 507,
+    "mass": 20000,
+    "type": "resource",
+    "tier": 7,
+    "category": "biomass"
+  },
+  {
+    "id": 508,
+    "mass": 18000,
+    "type": "resource",
+    "tier": 8,
+    "category": "biomass"
+  },
+  {
+    "id": 509,
+    "mass": 16000,
+    "type": "resource",
+    "tier": 9,
+    "category": "biomass"
+  },
+  {
+    "id": 510,
+    "mass": 14000,
+    "type": "resource",
+    "tier": 10,
+    "category": "biomass"
+  },
   {
     "id": 10001,
     "mass": 50000,
@@ -213,6 +458,13 @@
     "tier": 1,
     "subtype": "hauler"
   },
+  {
+    "id": 10107,
+    "mass": 180000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "warp"
+  },
   {
     "id": 10200,
     "mass": 80000,
@@ -231,6 +483,12 @@
     "type": "entity",
     "tier": 1
   },
+  {
+    "id": 10203,
+    "mass": 800000,
+    "type": "entity",
+    "tier": 1
+  },
   {
     "id": 20001,
     "mass": 50000,

package/src/data/metadata.ts

@@ -11,7 +11,7 @@ export interface EntityMetadata {
 }
 
 export const itemMetadata: Record<number, ItemMetadata> = {
-    // === Resources (raw) ===
+    // === Resources / Ore ===
     101: {name: 'Ore', description: 'Crude metallic ore.', color: '#C26D3F'},
     102: {name: 'Ore', description: 'Refined metallic ore with improved purity.', color: '#C26D3F'},
     103: {
@@ -19,6 +19,15 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'High-grade metallic ore with exceptional density.',
         color: '#C26D3F',
     },
+    104: {name: 'Ore', description: '', color: '#C26D3F'},
+    105: {name: 'Ore', description: '', color: '#C26D3F'},
+    106: {name: 'Ore', description: '', color: '#C26D3F'},
+    107: {name: 'Ore', description: '', color: '#C26D3F'},
+    108: {name: 'Ore', description: '', color: '#C26D3F'},
+    109: {name: 'Ore', description: '', color: '#C26D3F'},
+    110: {name: 'Ore', description: '', color: '#C26D3F'},
+
+    // === Resources / Crystal ===
     201: {name: 'Crystal', description: 'Raw resonant crystal.', color: '#4ADBFF'},
     202: {
         name: 'Crystal',
@@ -30,6 +39,15 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'High-grade resonant crystal with exceptional purity.',
         color: '#4ADBFF',
     },
+    204: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    205: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    206: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    207: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    208: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    209: {name: 'Crystal', description: '', color: '#4ADBFF'},
+    210: {name: 'Crystal', description: '', color: '#4ADBFF'},
+
+    // === Resources / Gas ===
     301: {name: 'Gas', description: 'Raw volatile gas.', color: '#B8E4A0'},
     302: {
         name: 'Gas',
@@ -41,6 +59,15 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'High-grade volatile gas with exceptional energy density.',
         color: '#B8E4A0',
     },
+    304: {name: 'Gas', description: '', color: '#B8E4A0'},
+    305: {name: 'Gas', description: '', color: '#B8E4A0'},
+    306: {name: 'Gas', description: '', color: '#B8E4A0'},
+    307: {name: 'Gas', description: '', color: '#B8E4A0'},
+    308: {name: 'Gas', description: '', color: '#B8E4A0'},
+    309: {name: 'Gas', description: '', color: '#B8E4A0'},
+    310: {name: 'Gas', description: '', color: '#B8E4A0'},
+
+    // === Resources / Regolith ===
     401: {name: 'Regolith', description: 'Crude regolith dust.', color: '#C4A57B'},
     402: {
         name: 'Regolith',
@@ -52,6 +79,15 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'High-grade regolith with exceptional uniformity.',
         color: '#C4A57B',
     },
+    404: {name: 'Regolith', description: '', color: '#C4A57B'},
+    405: {name: 'Regolith', description: '', color: '#C4A57B'},
+    406: {name: 'Regolith', description: '', color: '#C4A57B'},
+    407: {name: 'Regolith', description: '', color: '#C4A57B'},
+    408: {name: 'Regolith', description: '', color: '#C4A57B'},
+    409: {name: 'Regolith', description: '', color: '#C4A57B'},
+    410: {name: 'Regolith', description: '', color: '#C4A57B'},
+
+    // === Resources / Biomass ===
     501: {name: 'Biomass', description: 'Crude organic biomass.', color: '#5A8B3E'},
     502: {
         name: 'Biomass',
@@ -63,6 +99,13 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'High-grade biomass with exceptional saturation.',
         color: '#5A8B3E',
     },
+    504: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    505: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    506: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    507: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    508: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    509: {name: 'Biomass', description: '', color: '#5A8B3E'},
+    510: {name: 'Biomass', description: '', color: '#5A8B3E'},
 
     // === Components (T1) ===
     10001: {
@@ -157,6 +200,12 @@ export const itemMetadata: Record<number, ItemMetadata> = {
             'Projects a haul beam to lock onto and transport containers or warehouses through group travel.',
         color: '#4ADBFF',
     },
+    10107: {
+        name: 'Warp',
+        description:
+            'Folds local space-time around the hull, projecting the ship across vast distances in a single discharge of the entire energy reserve.',
+        color: '#9be4ff',
+    },
 
     // === Entities (packed, T1) ===
     10200: {
@@ -174,6 +223,12 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         description: 'Massive stationary storage facility with a single loader module slot.',
         color: '#EAB308',
     },
+    10203: {
+        name: 'Extractor',
+        description:
+            'Planetary resource extraction facility with generator and gatherer module slots.',
+        color: '#D4726F',
+    },
 
     // === Components (T2) ===
     20001: {
@@ -199,6 +254,7 @@ export const itemMetadata: Record<number, ItemMetadata> = {
 export const entityMetadata: Record<number, EntityMetadata> = {
     10201: {moduleSlotLabels: ['Engine', 'Generator', 'Gatherer', 'Loader', 'Storage']},
     10202: {moduleSlotLabels: ['Loader', 'Storage', 'Storage', 'Storage', 'Storage']},
+    10203: {moduleSlotLabels: ['Generator', 'Gatherer']},
 }
 
 for (const item of items as Array<{id: number}>) {

package/src/data/recipes-runtime.ts

@@ -30,6 +30,7 @@ export interface Recipe {
 
 export interface EntitySlot {
     type: ModuleType
+    outputPct: number
 }
 
 export interface EntityLayout {

package/src/data/recipes.json

@@ -393,12 +393,7 @@
         ]
       },
       {
-        "sources": [
-          {
-            "inputIndex": 1,
-            "statIndex": 1
-          }
-        ]
+        "sources": []
       },
       {
         "sources": [
@@ -436,8 +431,8 @@
       {
         "sources": [
           {
-            "inputIndex": 0,
-            "statIndex": 0
+            "inputIndex": 1,
+            "statIndex": 1
           }
         ]
       },
@@ -552,7 +547,7 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 0
+            "statIndex": 1
           }
         ]
       },
@@ -568,12 +563,36 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 1
+            "statIndex": 0
           }
         ]
       },
+      {
+        "sources": []
+      }
+    ],
+    "blendWeights": []
+  },
+  {
+    "outputItemId": 10107,
+    "outputMass": 180000,
+    "inputs": [
+      {
+        "itemId": 10010,
+        "quantity": 6
+      },
+      {
+        "itemId": 10009,
+        "quantity": 4
+      }
+    ],
+    "statSlots": [
       {
         "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          },
           {
             "inputIndex": 1,
             "statIndex": 1
@@ -581,7 +600,10 @@
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1,
+      1
+    ]
   },
   {
     "outputItemId": 10200,
@@ -730,6 +752,55 @@
     ],
     "blendWeights": []
   },
+  {
+    "outputItemId": 10203,
+    "outputMass": 800000,
+    "inputs": [
+      {
+        "itemId": 10001,
+        "quantity": 15
+      },
+      {
+        "itemId": 10002,
+        "quantity": 8
+      }
+    ],
+    "statSlots": [
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 0
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 0
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 1
+          }
+        ]
+      }
+    ],
+    "blendWeights": []
+  },
   {
     "outputItemId": 20001,
     "outputMass": 50000,

package/src/derivation/capability-mappings.ts

@@ -0,0 +1,122 @@
+import {SLOT_FORMULAS, type SlotConsumerKind} from '../data/capability-formulas'
+import {getStatDefinitions, type StatDefinition} from './stats'
+import {
+    getRecipe,
+    type Recipe,
+    type RecipeInput,
+    type RecipeInputCategory,
+} from '../data/recipes-runtime'
+import {
+    ITEM_ENGINE_T1,
+    ITEM_EXTRACTOR_T1_PACKED,
+    ITEM_GENERATOR_T1,
+    ITEM_GATHERER_T1,
+    ITEM_LOADER_T1,
+    ITEM_CRAFTER_T1,
+    ITEM_STORAGE_T1,
+    ITEM_HAULER_T1,
+    ITEM_WARP_T1,
+    ITEM_SHIP_T1_PACKED,
+    ITEM_CONTAINER_T1_PACKED,
+    ITEM_WAREHOUSE_T1_PACKED,
+    ITEM_CONTAINER_T2_PACKED,
+} from '../data/item-ids'
+import type {StatMapping} from '../data/capabilities'
+
+export const KIND_TO_ITEM_ID: Record<SlotConsumerKind, number> = {
+    engine: ITEM_ENGINE_T1,
+    generator: ITEM_GENERATOR_T1,
+    gatherer: ITEM_GATHERER_T1,
+    loader: ITEM_LOADER_T1,
+    crafter: ITEM_CRAFTER_T1,
+    storage: ITEM_STORAGE_T1,
+    hauler: ITEM_HAULER_T1,
+    warp: ITEM_WARP_T1,
+    'ship-t1': ITEM_SHIP_T1_PACKED,
+    'container-t1': ITEM_CONTAINER_T1_PACKED,
+    'warehouse-t1': ITEM_WAREHOUSE_T1_PACKED,
+    'extractor-t1': ITEM_EXTRACTOR_T1_PACKED,
+    'container-t2': ITEM_CONTAINER_T2_PACKED,
+}
+
+function isCategoryInput(input: RecipeInput): input is RecipeInputCategory {
+    return 'category' in input
+}
+
+/**
+ * Walk a recipe's slot source down to the raw category stat that ultimately
+ * lands in that slot. Returns the StatDefinition or undefined if the trace
+ * dead-ends (unknown sub-component, missing slot, etc.).
+ *
+ * Multi-source sub-slots collapse to `sources[0]`; top-level multi-source slots
+ * are expanded by the caller (`deriveStatMappings`).
+ */
+function traceToRawCategoryStat(
+    recipe: Recipe,
+    source: {inputIndex: number; statIndex: number},
+    visited: Set<number> = new Set()
+): StatDefinition | undefined {
+    const input = recipe.inputs[source.inputIndex]
+    if (!input) return undefined
+    if (isCategoryInput(input)) {
+        const defs = getStatDefinitions(input.category)
+        return defs[source.statIndex]
+    }
+    if (visited.has(input.itemId)) return undefined
+    const subRecipe = getRecipe(input.itemId)
+    if (!subRecipe) return undefined
+    const subSlot = subRecipe.statSlots[source.statIndex]
+    if (!subSlot) return undefined
+    const subSource = subSlot.sources[0]
+    if (!subSource) return undefined
+    const nextVisited = new Set(visited)
+    nextVisited.add(input.itemId)
+    return traceToRawCategoryStat(subRecipe, subSource, nextVisited)
+}
+
+let cached: StatMapping[] | undefined
+
+export function deriveStatMappings(): StatMapping[] {
+    if (cached) return cached
+    const out: StatMapping[] = []
+    const seen = new Set<string>()
+    for (const [kind, slots] of Object.entries(SLOT_FORMULAS) as [
+        SlotConsumerKind,
+        Record<number, {capability: string; attribute: string}>,
+    ][]) {
+        const itemId = KIND_TO_ITEM_ID[kind]
+        const recipe = getRecipe(itemId)
+        if (!recipe) continue
+        for (const [slotIdxStr, consumer] of Object.entries(slots)) {
+            const slotIdx = Number(slotIdxStr)
+            const slot = recipe.statSlots[slotIdx]
+            if (!slot) continue
+            for (const source of slot.sources) {
+                const stat = traceToRawCategoryStat(recipe, source)
+                if (!stat) continue
+                const key = `${stat.label}|${consumer.capability}|${consumer.attribute}`
+                if (seen.has(key)) continue
+                seen.add(key)
+                out.push({
+                    stat: stat.label,
+                    capability: consumer.capability,
+                    attribute: consumer.attribute,
+                })
+            }
+        }
+    }
+    cached = out
+    return out
+}
+
+export function getStatMappings(): StatMapping[] {
+    return deriveStatMappings()
+}
+
+export function getStatMappingsForStat(stat: string): StatMapping[] {
+    return deriveStatMappings().filter((m) => m.stat === stat)
+}
+
+export function getStatMappingsForCapability(capability: string): StatMapping[] {
+    return deriveStatMappings().filter((m) => m.capability === capability)
+}

package/src/derivation/index.ts

@@ -7,6 +7,7 @@ export {
     getEligibleResources,
     getResourceWeight,
     getLocationCandidates,
+    getLocationProfile,
     getDepthThreshold,
     getResourceTier,
     DEPTH_THRESHOLD_T1,