@shipload/sdk 1.0.0-next.2 → 1.0.0-next.4

package/src/data/capability-formulas.ts

@@ -0,0 +1,68 @@
+export interface SlotConsumer {
+    capability: string
+    attribute: string
+}
+
+export type SlotConsumerKind =
+    | 'engine'
+    | 'generator'
+    | 'gatherer'
+    | 'loader'
+    | 'crafter'
+    | 'storage'
+    | 'hauler'
+    | 'warp'
+    | 'ship-t1'
+    | 'container-t1'
+    | 'warehouse-t1'
+    | 'container-t2'
+
+const ENTITY_HULL_SLOTS: Record<number, SlotConsumer> = {
+    0: {capability: 'Storage', attribute: 'capacity'},
+    1: {capability: 'Hull', attribute: 'mass'},
+    2: {capability: 'Storage', attribute: 'capacity'},
+    3: {capability: 'Storage', attribute: 'capacity'},
+}
+
+export const SLOT_FORMULAS: Record<SlotConsumerKind, Record<number, SlotConsumer>> = {
+    engine: {
+        0: {capability: 'Movement', attribute: 'thrust'},
+        1: {capability: 'Movement', attribute: 'drain'},
+    },
+    generator: {
+        0: {capability: 'Energy', attribute: 'capacity'},
+        1: {capability: 'Energy', attribute: 'recharge'},
+    },
+    gatherer: {
+        0: {capability: 'Gathering', attribute: 'yield'},
+        1: {capability: 'Gathering', attribute: 'depth'},
+        3: {capability: 'Gathering', attribute: 'drain'},
+        4: {capability: 'Gathering', attribute: 'speed'},
+    },
+    loader: {
+        0: {capability: 'Loader', attribute: 'mass'},
+        1: {capability: 'Loader', attribute: 'thrust'},
+    },
+    crafter: {
+        0: {capability: 'Crafter', attribute: 'speed'},
+        1: {capability: 'Crafter', attribute: 'drain'},
+    },
+    storage: {
+        0: {capability: 'Storage', attribute: 'bonus'},
+        1: {capability: 'Storage', attribute: 'bonus'},
+        2: {capability: 'Storage', attribute: 'bonus'},
+        3: {capability: 'Storage', attribute: 'bonus'},
+    },
+    hauler: {
+        0: {capability: 'Hauler', attribute: 'capacity'},
+        1: {capability: 'Hauler', attribute: 'efficiency'},
+        2: {capability: 'Hauler', attribute: 'drain'},
+    },
+    warp: {
+        0: {capability: 'Warp', attribute: 'range'},
+    },
+    'ship-t1': ENTITY_HULL_SLOTS,
+    'container-t1': ENTITY_HULL_SLOTS,
+    'warehouse-t1': ENTITY_HULL_SLOTS,
+    'container-t2': ENTITY_HULL_SLOTS,
+}

package/src/data/colors.ts

@@ -75,6 +75,7 @@ export const itemAbbreviations: Record<number, string> = {
     10103: 'LD',
     10104: 'MF',
     10105: 'ST',
+    10107: 'WP',
     10200: 'CT',
     10201: 'SH',
     10202: 'WH',

package/src/data/item-ids.ts

@@ -1,4 +1,4 @@
-// Synced from game/build/catalog via `make sync-catalog` — do not edit.
+// Generated by scripts/build-catalog.ts — do not edit.
 
 export const ITEM_ORE_T1 = 101
 export const ITEM_ORE_T2 = 102
@@ -67,6 +67,7 @@ export const ITEM_LOADER_T1 = 10103
 export const ITEM_CRAFTER_T1 = 10104
 export const ITEM_STORAGE_T1 = 10105
 export const ITEM_HAULER_T1 = 10106
+export const ITEM_WARP_T1 = 10107
 export const ITEM_CONTAINER_T1_PACKED = 10200
 export const ITEM_SHIP_T1_PACKED = 10201
 export const ITEM_WAREHOUSE_T1_PACKED = 10202

package/src/data/items.json

@@ -213,6 +213,13 @@
     "tier": 1,
     "subtype": "hauler"
   },
+  {
+    "id": 10107,
+    "mass": 180000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "warp"
+  },
   {
     "id": 10200,
     "mass": 80000,

package/src/data/metadata.ts

@@ -157,6 +157,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: {

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,

package/src/derivation/capability-mappings.ts

@@ -0,0 +1,120 @@
+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_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,
+    '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/entities/container.ts

@@ -75,10 +75,10 @@ export function computeContainerCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const density = stats['density'] ?? 500
-    const strength = stats['strength'] ?? 500
-    const hardness = stats['hardness'] ?? 500
-    const saturation = stats['saturation'] ?? 500
+    const density = stats.density
+    const strength = stats.strength
+    const hardness = stats.hardness
+    const saturation = stats.saturation
 
     const hullmass = 25000 + 75 * density
 
@@ -93,10 +93,10 @@ export function computeContainerT2Capabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const strength = stats['strength'] ?? 0
-    const density = stats['density'] ?? 0
-    const hardness = stats['hardness'] ?? 0
-    const saturation = stats['saturation'] ?? 0
+    const strength = stats.strength
+    const density = stats.density
+    const hardness = stats.hardness
+    const saturation = stats.saturation
 
     const hullmass = 20000 + 50 * density
 

package/src/entities/ship-deploy.ts

@@ -13,10 +13,10 @@ export function computeShipHullCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const density = stats.density ?? 500
-    const strength = stats.strength ?? 500
-    const hardness = stats.hardness ?? 500
-    const saturation = stats.saturation ?? 500
+    const density = stats.density
+    const strength = stats.strength
+    const hardness = stats.hardness
+    const saturation = stats.saturation
 
     const hullmass = 25000 + 75 * density
     const statSum = strength + hardness + saturation
@@ -30,8 +30,8 @@ export function computeEngineCapabilities(stats: Record<string, number>): {
     thrust: number
     drain: number
 } {
-    const vol = stats.volatility ?? 500
-    const thm = stats.thermal ?? 500
+    const vol = stats.volatility
+    const thm = stats.thermal
 
     return {
         thrust: 400 + Math.floor((vol * 3) / 4),
@@ -43,12 +43,12 @@ export function computeGeneratorCapabilities(stats: Record<string, number>): {
     capacity: number
     recharge: number
 } {
-    const res = stats.resonance ?? 500
-    const ref = stats.reflectivity ?? 500
+    const com = stats.composition
+    const fin = stats.fineness
 
     return {
-        capacity: 300 + Math.floor(res / 6),
-        recharge: 1 + Math.floor((ref * 3) / 1000),
+        capacity: 300 + Math.floor(com / 6),
+        recharge: 1 + Math.floor((fin * 3) / 1000),
     }
 }
 
@@ -58,10 +58,10 @@ export function computeGathererCapabilities(stats: Record<string, number>): {
     depth: number
     speed: number
 } {
-    const str = stats.strength ?? 500
-    const con = stats.conductivity ?? 500
-    const ref = stats.reflectivity ?? 500
-    const tol = stats.tolerance ?? 500
+    const str = stats.strength
+    const con = stats.conductivity
+    const ref = stats.reflectivity
+    const tol = stats.tolerance
 
     return {
         yield: 200 + str,
@@ -76,12 +76,12 @@ export function computeLoaderCapabilities(stats: Record<string, number>): {
     thrust: number
     quantity: number
 } {
-    const hrd = stats.hardness ?? 500
-    const pla = stats.plasticity ?? 500
+    const insulation = stats.insulation
+    const plasticity = stats.plasticity
 
     return {
-        mass: Math.max(200, 2000 - Math.floor(hrd * 2)),
-        thrust: 1 + Math.floor(pla / 500),
+        mass: Math.max(200, 2000 - Math.floor(insulation * 2)),
+        thrust: 1 + Math.floor(plasticity / 500),
         quantity: 1,
     }
 }
@@ -90,12 +90,12 @@ export function computeCrafterCapabilities(stats: Record<string, number>): {
     speed: number
     drain: number
 } {
-    const rea = stats.reactivity ?? 500
-    const com = stats.composition ?? 500
+    const rea = stats.reactivity
+    const fin = stats.fineness
 
     return {
         speed: 100 + Math.floor((rea * 4) / 5),
-        drain: Math.max(5, 30 - Math.floor(com / 33)),
+        drain: Math.max(5, 30 - Math.floor(fin / 33)),
     }
 }
 
@@ -104,14 +104,14 @@ export function computeHaulerCapabilities(stats: Record<string, number>): {
     efficiency: number
     drain: number
 } {
-    const res = stats.resonance ?? 500
-    const con = stats.conductivity ?? 500
-    const ref = stats.reflectivity ?? 500
+    const fineness = stats.fineness
+    const conductivity = stats.conductivity
+    const composition = stats.composition
 
     return {
-        capacity: Math.max(1, 1 + Math.floor(res / 400)),
-        efficiency: 2000 + con * 6,
-        drain: Math.max(3, 15 - Math.floor(ref / 80)),
+        capacity: Math.max(1, 1 + Math.floor(fineness / 400)),
+        efficiency: 2000 + conductivity * 6,
+        drain: Math.max(3, 15 - Math.floor(composition / 80)),
     }
 }
 
@@ -121,11 +121,12 @@ export function computeStorageCapabilities(
 ): {
     capacityBonus: number
 } {
-    const strength = stats.strength ?? 500
-    const hardness = stats.hardness ?? 500
-    const saturation = stats.saturation ?? 500
+    const strength = stats.strength
+    const density = stats.density
+    const hardness = stats.hardness
+    const saturation = stats.saturation
 
-    const statSum = strength + hardness + saturation
+    const statSum = strength + density + hardness + saturation
     const capacityBonus = Math.floor(
         (baseCapacity * (10 + Math.floor((statSum * 10) / 2997))) / 100
     )
@@ -137,10 +138,10 @@ export function computeWarehouseHullCapabilities(stats: Record<string, number>):
     hullmass: number
     capacity: number
 } {
-    const density = stats.density ?? 500
-    const strength = stats.strength ?? 500
-    const hardness = stats.hardness ?? 500
-    const saturation = stats.saturation ?? 500
+    const density = stats.density
+    const strength = stats.strength
+    const hardness = stats.hardness
+    const saturation = stats.saturation
 
     const hullmass = 25000 + 75 * density
     const statSum = strength + hardness + saturation

package/src/index-module.ts

@@ -202,14 +202,19 @@ export type {PlanetSubtypeInfo} from './data/locations'
 export {
     capabilityNames,
     capabilityAttributes,
-    statMappings,
     isInvertedAttribute,
     getCapabilityAttributes,
+} from './data/capabilities'
+export type {CapabilityAttribute, StatMapping} from './data/capabilities'
+
+export {
+    deriveStatMappings,
     getStatMappings,
     getStatMappingsForStat,
     getStatMappingsForCapability,
-} from './data/capabilities'
-export type {CapabilityAttribute, StatMapping} from './data/capabilities'
+} from './derivation/capability-mappings'
+export {SLOT_FORMULAS} from './data/capability-formulas'
+export type {SlotConsumer, SlotConsumerKind} from './data/capability-formulas'
 
 export {
     encodeStats,
@@ -302,6 +307,7 @@ export {
     computeLoaderThrust,
     computeCrafterSpeed,
     computeCrafterDrain,
+    computeWarpRange,
 } from './nft/description'
 
 export {

package/src/nft/description.ts

@@ -6,6 +6,7 @@ import {
     MODULE_GENERATOR,
     MODULE_LOADER,
     MODULE_STORAGE,
+    MODULE_WARP,
 } from '../capabilities/modules'
 import {
     ITEM_CONTAINER_T1_PACKED,
@@ -18,6 +19,7 @@ import {
     ITEM_SHIP_T1_PACKED,
     ITEM_STORAGE_T1,
     ITEM_WAREHOUSE_T1_PACKED,
+    ITEM_WARP_T1,
 } from '../data/item-ids'
 import {decodeStat} from '../derivation/crafting'
 
@@ -42,17 +44,18 @@ export function computeBaseCapacityWarehouse(stats: bigint): number {
 
 export const computeEngineThrust = (vol: number): number => 400 + idiv(vol * 3, 4)
 export const computeEngineDrain = (thm: number): number => Math.max(30, 50 - idiv(thm, 70))
-export const computeGeneratorCap = (res: number): number => 300 + idiv(res, 6)
-export const computeGeneratorRech = (ref: number): number => 1 + idiv(ref * 3, 1000)
+export const computeGeneratorCap = (com: number): number => 300 + idiv(com, 6)
+export const computeGeneratorRech = (fin: number): number => 1 + idiv(fin * 3, 1000)
 export const computeGathererYield = (str: number): number => 200 + str
 export const computeGathererDrain = (con: number): number =>
     Math.max(250, 1250 - idiv(con * 25, 20))
 export const computeGathererDepth = (tol: number): number => 200 + idiv(tol * 3, 2)
 export const computeGathererSpeed = (ref: number): number => 100 + idiv(ref * 4, 5)
-export const computeLoaderMass = (fin: number): number => Math.max(200, 2000 - fin * 2)
+export const computeLoaderMass = (ins: number): number => Math.max(200, 2000 - ins * 2)
 export const computeLoaderThrust = (pla: number): number => 1 + idiv(pla, 500)
 export const computeCrafterSpeed = (rea: number): number => 100 + idiv(rea * 4, 5)
-export const computeCrafterDrain = (com: number): number => Math.max(5, 30 - idiv(com, 33))
+export const computeCrafterDrain = (fin: number): number => Math.max(5, 30 - idiv(fin, 33))
+export const computeWarpRange = (stat: number): number => 100 + stat * 3
 
 export function entityDisplayName(itemId: number): string {
     switch (itemId) {
@@ -83,6 +86,8 @@ export function moduleDisplayName(itemId: number): string {
             return 'Crafter'
         case ITEM_STORAGE_T1:
             return 'Storage'
+        case ITEM_WARP_T1:
+            return 'Warp'
         default:
             return 'Module'
     }
@@ -142,6 +147,11 @@ export function formatModuleLine(slot: number, itemId: number, stats: bigint): s
             out += `  +${pct}% capacity`
             break
         }
+        case MODULE_WARP: {
+            const stat = decodeStat(stats, 0)
+            out += `  Range ${computeWarpRange(stat)}`
+            break
+        }
     }
     return out
 }

package/src/resolution/resolve-item.ts

@@ -223,10 +223,11 @@ function computeCapabilityGroup(
             }
         }
         case MODULE_STORAGE: {
-            const str = stats.strength ?? 500
-            const hrd = stats.hardness ?? 500
-            const sat = stats.saturation ?? 500
-            const statSum = str + hrd + sat
+            const str = stats.strength
+            const den = stats.density
+            const hrd = stats.hardness
+            const sat = stats.saturation
+            const statSum = str + den + hrd + sat
             const pct = 10 + Math.floor((statSum * 10) / 2997)
             return {capability: 'Storage', attributes: [{label: 'Capacity Bonus', value: pct}]}
         }