@shipload/sdk 2.0.0-rc20 → 2.0.0-rc21

package/src/data/items.json

@@ -1,17 +1,252 @@
 [
-    {"id": 101, "name": "", "description": "", "mass": 30000, "category": "ore", "tier": "t1", "color": "#C26D3F"},
-    {"id": 102, "name": "", "description": "", "mass": 27000, "category": "ore", "tier": "t2", "color": "#C26D3F"},
-    {"id": 103, "name": "", "description": "", "mass": 52000, "category": "ore", "tier": "t3", "color": "#C26D3F"},
-    {"id": 201, "name": "", "description": "", "mass": 40000, "category": "crystal", "tier": "t1", "color": "#4ADBFF"},
-    {"id": 202, "name": "", "description": "", "mass": 55000, "category": "crystal", "tier": "t2", "color": "#4ADBFF"},
-    {"id": 203, "name": "", "description": "", "mass": 70000, "category": "crystal", "tier": "t3", "color": "#4ADBFF"},
-    {"id": 301, "name": "", "description": "", "mass": 15000, "category": "gas", "tier": "t1", "color": "#B8E4A0"},
-    {"id": 302, "name": "", "description": "", "mass": 2000, "category": "gas", "tier": "t2", "color": "#B8E4A0"},
-    {"id": 303, "name": "", "description": "", "mass": 8000, "category": "gas", "tier": "t3", "color": "#B8E4A0"},
-    {"id": 401, "name": "", "description": "", "mass": 22000, "category": "regolith", "tier": "t1", "color": "#C4A57B"},
-    {"id": 402, "name": "", "description": "", "mass": 35000, "category": "regolith", "tier": "t2", "color": "#C4A57B"},
-    {"id": 403, "name": "", "description": "", "mass": 45000, "category": "regolith", "tier": "t3", "color": "#C4A57B"},
-    {"id": 501, "name": "", "description": "", "mass": 15000, "category": "biomass", "tier": "t1", "color": "#5A8B3E"},
-    {"id": 502, "name": "", "description": "", "mass": 30000, "category": "biomass", "tier": "t2", "color": "#5A8B3E"},
-    {"id": 503, "name": "", "description": "", "mass": 25000, "category": "biomass", "tier": "t3", "color": "#5A8B3E"}
+  {
+    "id": 101,
+    "mass": 52000,
+    "type": "resource",
+    "tier": 1,
+    "category": "ore"
+  },
+  {
+    "id": 102,
+    "mass": 58000,
+    "type": "resource",
+    "tier": 2,
+    "category": "ore"
+  },
+  {
+    "id": 103,
+    "mass": 64000,
+    "type": "resource",
+    "tier": 3,
+    "category": "ore"
+  },
+  {
+    "id": 201,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 1,
+    "category": "crystal"
+  },
+  {
+    "id": 202,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 2,
+    "category": "crystal"
+  },
+  {
+    "id": 203,
+    "mass": 35000,
+    "type": "resource",
+    "tier": 3,
+    "category": "crystal"
+  },
+  {
+    "id": 301,
+    "mass": 15000,
+    "type": "resource",
+    "tier": 1,
+    "category": "gas"
+  },
+  {
+    "id": 302,
+    "mass": 13500,
+    "type": "resource",
+    "tier": 2,
+    "category": "gas"
+  },
+  {
+    "id": 303,
+    "mass": 12000,
+    "type": "resource",
+    "tier": 3,
+    "category": "gas"
+  },
+  {
+    "id": 401,
+    "mass": 22000,
+    "type": "resource",
+    "tier": 1,
+    "category": "regolith"
+  },
+  {
+    "id": 402,
+    "mass": 25000,
+    "type": "resource",
+    "tier": 2,
+    "category": "regolith"
+  },
+  {
+    "id": 403,
+    "mass": 28000,
+    "type": "resource",
+    "tier": 3,
+    "category": "regolith"
+  },
+  {
+    "id": 501,
+    "mass": 42000,
+    "type": "resource",
+    "tier": 1,
+    "category": "biomass"
+  },
+  {
+    "id": 502,
+    "mass": 37000,
+    "type": "resource",
+    "tier": 2,
+    "category": "biomass"
+  },
+  {
+    "id": 503,
+    "mass": 33000,
+    "type": "resource",
+    "tier": 3,
+    "category": "biomass"
+  },
+  {
+    "id": 10001,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10002,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10003,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10004,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10005,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10006,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10007,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10008,
+    "mass": 30000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10009,
+    "mass": 50000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10010,
+    "mass": 40000,
+    "type": "component",
+    "tier": 1
+  },
+  {
+    "id": 10100,
+    "mass": 150000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "engine"
+  },
+  {
+    "id": 10101,
+    "mass": 75000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "generator"
+  },
+  {
+    "id": 10102,
+    "mass": 145000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "gatherer"
+  },
+  {
+    "id": 10103,
+    "mass": 90000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "loader"
+  },
+  {
+    "id": 10104,
+    "mass": 120000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "crafter"
+  },
+  {
+    "id": 10105,
+    "mass": 100000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "storage"
+  },
+  {
+    "id": 10106,
+    "mass": 120000,
+    "type": "module",
+    "tier": 1,
+    "subtype": "hauler"
+  },
+  {
+    "id": 10200,
+    "mass": 80000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 10201,
+    "mass": 100000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 10202,
+    "mass": 1300000,
+    "type": "entity",
+    "tier": 1
+  },
+  {
+    "id": 20001,
+    "mass": 50000,
+    "type": "component",
+    "tier": 2
+  },
+  {
+    "id": 20002,
+    "mass": 30000,
+    "type": "component",
+    "tier": 2
+  },
+  {
+    "id": 20200,
+    "mass": 80000,
+    "type": "entity",
+    "tier": 2
+  }
 ]

package/src/data/metadata.ts

@@ -0,0 +1,208 @@
+import items from './items.json'
+
+export interface ItemMetadata {
+    name: string
+    description: string
+    color: string
+}
+
+export interface EntityMetadata {
+    moduleSlotLabels?: string[]
+}
+
+export const itemMetadata: Record<number, ItemMetadata> = {
+    // === Resources (raw) ===
+    101: {name: 'Ore', description: 'Crude metallic ore.', color: '#C26D3F'},
+    102: {name: 'Ore', description: 'Refined metallic ore with improved purity.', color: '#C26D3F'},
+    103: {
+        name: 'Ore',
+        description: 'High-grade metallic ore with exceptional density.',
+        color: '#C26D3F',
+    },
+    201: {name: 'Crystal', description: 'Raw resonant crystal.', color: '#4ADBFF'},
+    202: {
+        name: 'Crystal',
+        description: 'Refined resonant crystal with improved clarity.',
+        color: '#4ADBFF',
+    },
+    203: {
+        name: 'Crystal',
+        description: 'High-grade resonant crystal with exceptional purity.',
+        color: '#4ADBFF',
+    },
+    301: {name: 'Gas', description: 'Raw volatile gas.', color: '#B8E4A0'},
+    302: {
+        name: 'Gas',
+        description: 'Refined volatile gas with improved reactivity.',
+        color: '#B8E4A0',
+    },
+    303: {
+        name: 'Gas',
+        description: 'High-grade volatile gas with exceptional energy density.',
+        color: '#B8E4A0',
+    },
+    401: {name: 'Regolith', description: 'Crude regolith dust.', color: '#C4A57B'},
+    402: {
+        name: 'Regolith',
+        description: 'Refined regolith with improved fineness.',
+        color: '#C4A57B',
+    },
+    403: {
+        name: 'Regolith',
+        description: 'High-grade regolith with exceptional uniformity.',
+        color: '#C4A57B',
+    },
+    501: {name: 'Biomass', description: 'Crude organic biomass.', color: '#5A8B3E'},
+    502: {
+        name: 'Biomass',
+        description: 'Refined biomass with improved plasticity.',
+        color: '#5A8B3E',
+    },
+    503: {
+        name: 'Biomass',
+        description: 'High-grade biomass with exceptional saturation.',
+        color: '#5A8B3E',
+    },
+
+    // === Components (T1) ===
+    10001: {
+        name: 'Hull Plates',
+        description: 'Structural plating formed from ore. Used in hulls, containers, and frames.',
+        color: '#7B8D9E',
+    },
+    10002: {
+        name: 'Cargo Lining',
+        description:
+            'Composite lining formed from fine regolith bound in biomass polymer. Dense enough to seal cargo holds, flexible enough to absorb vibration.',
+        color: '#C4A57B',
+    },
+    10003: {
+        name: 'Thruster Core',
+        description: 'High-energy propulsion component formed from volatile gases.',
+        color: '#E86344',
+    },
+    10004: {
+        name: 'Power Cell',
+        description:
+            'Crystalline energy storage matrix. Resonant lattices retain and release charge.',
+        color: '#4ADBFF',
+    },
+    10005: {
+        name: 'Matter Conduit',
+        description: 'Heavy-duty ore shaft used in gathering equipment.',
+        color: '#7B8D9E',
+    },
+    10006: {
+        name: 'Survey Probe',
+        description: 'Crystal-lattice sensor array for deep resource detection.',
+        color: '#4ADBFF',
+    },
+    10007: {
+        name: 'Cargo Arm',
+        description: 'Flexible biomass composite arm for cargo handling.',
+        color: '#5A8B3E',
+    },
+    10008: {
+        name: 'Tool Bit',
+        description: 'Dense regolith cutting head for crafting operations.',
+        color: '#C4A57B',
+    },
+    10009: {
+        name: 'Reaction Chamber',
+        description: 'Gas-pressurized vessel for controlled crafting reactions.',
+        color: '#B8E4A0',
+    },
+    10010: {
+        name: 'Focusing Array',
+        description:
+            "Precision-formed crystal lens array. Routes the haul beam's energy efficiently to the target lock.",
+        color: '#4ADBFF',
+    },
+
+    // === Modules (T1) ===
+    10100: {
+        name: 'Engine',
+        description: 'Basic propulsion system. Converts volatile gases into thrust.',
+        color: '#E86344',
+    },
+    10101: {
+        name: 'Generator',
+        description: 'Basic energy system. Stores and recharges energy from resonant crystals.',
+        color: '#4ADBFF',
+    },
+    10102: {
+        name: 'Gatherer',
+        description: 'Basic gathering system. Probes and conduits for raw resources.',
+        color: '#7B8D9E',
+    },
+    10103: {
+        name: 'Loader',
+        description: 'Basic cargo handling system. Loads and unloads cargo with articulated arms.',
+        color: '#5A8B3E',
+    },
+    10104: {
+        name: 'Crafter',
+        description:
+            'Basic crafting system. Processes materials using reaction chambers and cutting tools.',
+        color: '#B8E4A0',
+    },
+    10105: {
+        name: 'Storage',
+        description: 'Expands cargo capacity based on hull material quality.',
+        color: '#8B7355',
+    },
+    10106: {
+        name: 'Hauler',
+        description:
+            'Projects a haul beam to lock onto and transport containers or warehouses through group travel.',
+        color: '#4ADBFF',
+    },
+
+    // === Entities (packed, T1) ===
+    10200: {
+        name: 'Container',
+        description: 'Passive floating cargo storage in space. Towed by ships.',
+        color: '#7B8D9E',
+    },
+    10201: {
+        name: 'Ship',
+        description: 'General-purpose vessel with 5 module slots.',
+        color: '#4AE898',
+    },
+    10202: {
+        name: 'Warehouse',
+        description: 'Massive stationary storage facility with a single loader module slot.',
+        color: '#EAB308',
+    },
+
+    // === Components (T2) ===
+    20001: {
+        name: 'Hull Plates',
+        description: 'Advanced structural plating reinforced with tier 2 ore.',
+        color: '#9BADB8',
+    },
+    20002: {
+        name: 'Cargo Lining',
+        description:
+            'Advanced composite lining reinforced with tier 2 regolith and biomass polymer.',
+        color: '#C4A57B',
+    },
+
+    // === Entities (packed, T2) ===
+    20200: {
+        name: 'Container',
+        description: 'Advanced cargo container with improved capacity formulas.',
+        color: '#9BADB8',
+    },
+}
+
+export const entityMetadata: Record<number, EntityMetadata> = {
+    10201: {moduleSlotLabels: ['Engine', 'Generator', 'Gatherer', 'Loader', 'Storage']},
+    10202: {moduleSlotLabels: ['Loader', 'Storage', 'Storage', 'Storage', 'Storage']},
+}
+
+for (const item of items as Array<{id: number}>) {
+    if (!itemMetadata[item.id]) {
+        throw new Error(`Missing metadata for item ${item.id}. Add an entry to metadata.ts.`)
+    }
+}

package/src/data/recipes-runtime.ts

@@ -0,0 +1,65 @@
+import items from './items.json'
+import recipes from './recipes.json'
+import entities from './entities.json'
+
+import {getItem} from '../market/items'
+import {Item, ModuleType, ResourceCategory} from '../types'
+
+export interface RecipeInputItemId {
+    itemId: number
+    quantity: number
+}
+export interface RecipeInputCategory {
+    category: ResourceCategory
+    tier: number
+    quantity: number
+}
+export type RecipeInput = RecipeInputItemId | RecipeInputCategory
+
+export interface StatSlot {
+    sources: {inputIndex: number; statIndex: number}[]
+}
+
+export interface Recipe {
+    outputItemId: number
+    outputMass: number
+    inputs: RecipeInput[]
+    statSlots: StatSlot[]
+    blendWeights: number[]
+}
+
+export interface EntitySlot {
+    type: ModuleType
+}
+
+export interface EntityLayout {
+    entityItemId: number
+    slots: EntitySlot[]
+}
+
+const recipesById = new Map<number, Recipe>()
+for (const r of recipes as any[]) recipesById.set(r.outputItemId, r as Recipe)
+
+const entitiesById = new Map<number, EntityLayout>()
+for (const e of entities as any[]) entitiesById.set(e.entityItemId, e as EntityLayout)
+
+const resourceByCategoryTier = new Map<string, Item>()
+for (const raw of items as any[]) {
+    if (raw.type === 'resource') {
+        resourceByCategoryTier.set(`${raw.category}:${raw.tier}`, getItem(raw.id))
+    }
+}
+
+export function getRecipe(outputItemId: number): Recipe | undefined {
+    return recipesById.get(outputItemId)
+}
+
+export function getEntityLayout(entityItemId: number): EntityLayout | undefined {
+    return entitiesById.get(entityItemId)
+}
+
+export function findItemByCategoryAndTier(category: ResourceCategory, tier: number): Item {
+    const item = resourceByCategoryTier.get(`${category}:${tier}`)
+    if (!item) throw new Error(`No resource found for category=${category} tier=${tier}`)
+    return item
+}