@shipload/sdk 2.0.0-rc2 → 2.0.0-rc21

package/src/data/capabilities.ts

@@ -0,0 +1,408 @@
+export interface CapabilityAttribute {
+    capability: string
+    attribute: string
+    description: string
+}
+
+export interface StatMapping {
+    stat: string
+    capability: string
+    attribute: string
+    rationale: string
+}
+
+export const capabilityNames: string[] = [
+    'Hull',
+    'Storage',
+    'Movement',
+    'Energy',
+    'Loader',
+    'Gathering',
+    'Warp',
+    'Crafter',
+    'Launch',
+    'Hauler',
+]
+
+export const capabilityAttributes: CapabilityAttribute[] = [
+    {capability: 'Hull', attribute: 'mass', description: 'Total mass of the hull'},
+    {capability: 'Storage', attribute: 'capacity', description: 'Maximum mass that can be stored'},
+    {capability: 'Movement', attribute: 'thrust', description: 'Propulsion force'},
+    {capability: 'Movement', attribute: 'drain', description: 'Energy consumed per movement'},
+    {capability: 'Energy', attribute: 'capacity', description: 'Maximum energy storage'},
+    {capability: 'Energy', attribute: 'recharge', description: 'Energy regeneration rate'},
+    {capability: 'Loader', attribute: 'mass', description: 'Weight of the loader unit itself'},
+    {capability: 'Loader', attribute: 'thrust', description: 'Loading speed/force'},
+    {capability: 'Gathering', attribute: 'yield', description: 'Mass gathered per second'},
+    {capability: 'Gathering', attribute: 'drain', description: 'Energy consumed per gather'},
+    {capability: 'Gathering', attribute: 'depth', description: 'Maximum gather depth'},
+    {capability: 'Gathering', attribute: 'speed', description: 'Gathering speed/penetration'},
+    {capability: 'Warp', attribute: 'range', description: 'Maximum warp distance'},
+    {capability: 'Crafter', attribute: 'speed', description: 'Crafting time per item'},
+    {
+        capability: 'Crafter',
+        attribute: 'drain',
+        description: 'Energy consumed per second while crafting',
+    },
+    {capability: 'Crafter', attribute: 'quality', description: 'Modifier on output quality'},
+    {capability: 'Launch', attribute: 'range', description: 'Maximum launch distance'},
+    {capability: 'Launch', attribute: 'capacity', description: 'Maximum mass per launch'},
+    {capability: 'Launch', attribute: 'drain', description: 'Energy consumed per launch'},
+    {
+        capability: 'Hauler',
+        attribute: 'capacity',
+        description: 'Number of targets the haul beam can lock onto simultaneously',
+    },
+    {
+        capability: 'Hauler',
+        attribute: 'efficiency',
+        description: 'Thrust penalty reduction per hauled target',
+    },
+    {
+        capability: 'Hauler',
+        attribute: 'drain',
+        description: 'Energy consumed per target during haul-beam operation',
+    },
+]
+
+export const statMappings: StatMapping[] = [
+    {
+        stat: 'Strength',
+        capability: 'Gathering',
+        attribute: 'yield',
+        rationale: 'Raw mechanical force drives faster gathering',
+    },
+    {
+        stat: 'Strength',
+        capability: 'Storage',
+        attribute: 'capacity',
+        rationale: 'Stronger walls hold more capacity per mass',
+    },
+    {
+        stat: 'Strength',
+        capability: 'Launch',
+        attribute: 'capacity',
+        rationale: 'Stronger housing handles larger launch loads',
+    },
+    {
+        stat: 'Tolerance',
+        capability: 'Movement',
+        attribute: 'thrust',
+        rationale: 'Engine components that tolerate more can push harder',
+    },
+    {
+        stat: 'Tolerance',
+        capability: 'Energy',
+        attribute: 'recharge',
+        rationale: 'Generator housing withstands stress for faster recharge',
+    },
+    {
+        stat: 'Tolerance',
+        capability: 'Gathering',
+        attribute: 'depth',
+        rationale: 'Housing withstands pressure/heat at extreme depths',
+    },
+    {
+        stat: 'Tolerance',
+        capability: 'Warp',
+        attribute: 'range',
+        rationale: 'Warp drive housing withstands extreme forces',
+    },
+    {
+        stat: 'Density',
+        capability: 'Hull',
+        attribute: 'mass',
+        rationale: 'Lighter metal = lighter hull',
+    },
+    {
+        stat: 'Density',
+        capability: 'Loader',
+        attribute: 'mass',
+        rationale: 'Lighter metal = lighter loader units',
+    },
+    {
+        stat: 'Density',
+        capability: 'Movement',
+        attribute: 'drain',
+        rationale: 'Lighter components require less energy to move',
+    },
+    {
+        stat: 'Conductivity',
+        capability: 'Movement',
+        attribute: 'drain',
+        rationale: 'Efficient energy transfer reduces movement energy cost',
+    },
+    {
+        stat: 'Conductivity',
+        capability: 'Gathering',
+        attribute: 'drain',
+        rationale: 'Efficient energy transfer reduces gathering energy cost',
+    },
+    {
+        stat: 'Conductivity',
+        capability: 'Crafter',
+        attribute: 'drain',
+        rationale: 'Efficient energy transfer reduces crafting energy cost',
+    },
+    {
+        stat: 'Conductivity',
+        capability: 'Energy',
+        attribute: 'recharge',
+        rationale: 'Better conductivity speeds energy flow during recharge',
+    },
+    {
+        stat: 'Ductility',
+        capability: 'Crafter',
+        attribute: 'quality',
+        rationale: 'Precise shaping enables tighter crafting tolerances',
+    },
+    {
+        stat: 'Ductility',
+        capability: 'Gathering',
+        attribute: 'yield',
+        rationale: 'Precisely shaped conduit components gather faster',
+    },
+    {
+        stat: 'Ductility',
+        capability: 'Storage',
+        attribute: 'capacity',
+        rationale: 'Precision-formed container walls maximize volume',
+    },
+    {
+        stat: 'Ductility',
+        capability: 'Loader',
+        attribute: 'mass',
+        rationale: 'Precision-formed precious metal reduces loader unit mass',
+    },
+    {
+        stat: 'Reflectivity',
+        capability: 'Gathering',
+        attribute: 'depth',
+        rationale: 'Reflective heat shielding protects equipment at depth',
+    },
+    {
+        stat: 'Reflectivity',
+        capability: 'Launch',
+        attribute: 'range',
+        rationale: 'Reflective surfaces focus electromagnetic launch energy',
+    },
+    {
+        stat: 'Volatility',
+        capability: 'Gathering',
+        attribute: 'yield',
+        rationale: 'Energy release powers faster gathering',
+    },
+    {
+        stat: 'Volatility',
+        capability: 'Movement',
+        attribute: 'thrust',
+        rationale: 'Energy release drives propulsion force',
+    },
+    {
+        stat: 'Volatility',
+        capability: 'Loader',
+        attribute: 'thrust',
+        rationale: 'Energy release powers loader motors',
+    },
+    {
+        stat: 'Volatility',
+        capability: 'Launch',
+        attribute: 'capacity',
+        rationale: 'Energy release enables launching heavier payloads',
+    },
+    {
+        stat: 'Reactivity',
+        capability: 'Crafter',
+        attribute: 'speed',
+        rationale: 'Reactive gases accelerate chemical/thermal processing',
+    },
+    {
+        stat: 'Reactivity',
+        capability: 'Gathering',
+        attribute: 'speed',
+        rationale: 'Reactive gases manage heat/friction during gathering',
+    },
+    {
+        stat: 'Reactivity',
+        capability: 'Launch',
+        attribute: 'drain',
+        rationale: 'Reactive gas medium reduces electromagnetic resistance',
+    },
+    {
+        stat: 'Thermal',
+        capability: 'Crafter',
+        attribute: 'quality',
+        rationale: 'Precise thermal control during fabrication',
+    },
+    {
+        stat: 'Thermal',
+        capability: 'Gathering',
+        attribute: 'drain',
+        rationale: 'Thermal management reduces energy waste during gathering',
+    },
+    {
+        stat: 'Thermal',
+        capability: 'Energy',
+        attribute: 'capacity',
+        rationale: 'Thermal management enables denser energy storage',
+    },
+    {
+        stat: 'Resonance',
+        capability: 'Energy',
+        attribute: 'capacity',
+        rationale: 'Resonating crystals store energy in fields',
+    },
+    {
+        stat: 'Resonance',
+        capability: 'Warp',
+        attribute: 'range',
+        rationale: 'Resonant crystals amplify warp field projection',
+    },
+    {
+        stat: 'Resonance',
+        capability: 'Launch',
+        attribute: 'range',
+        rationale: 'Resonant crystals focus electromagnetic launch field',
+    },
+    {
+        stat: 'Resonance',
+        capability: 'Launch',
+        attribute: 'capacity',
+        rationale: 'Stronger resonant field launches heavier payloads',
+    },
+    {
+        stat: 'Hardness',
+        capability: 'Crafter',
+        attribute: 'speed',
+        rationale: 'Hard tooling surfaces cut and shape materials faster',
+    },
+    {
+        stat: 'Hardness',
+        capability: 'Launch',
+        attribute: 'drain',
+        rationale: 'Hard rail surfaces reduce friction, less energy wasted',
+    },
+    {
+        stat: 'Clarity',
+        capability: 'Energy',
+        attribute: 'recharge',
+        rationale: 'Flawless crystals enable smoother energy flow during recharge',
+    },
+    {
+        stat: 'Clarity',
+        capability: 'Crafter',
+        attribute: 'quality',
+        rationale: 'Precision optics for calibration during fabrication',
+    },
+    {
+        stat: 'Clarity',
+        capability: 'Crafter',
+        attribute: 'drain',
+        rationale: 'Precision computing optimizes energy routing in factory',
+    },
+    {
+        stat: 'Plasticity',
+        capability: 'Crafter',
+        attribute: 'speed',
+        rationale: 'Easily reshaped materials speed up processing',
+    },
+    {
+        stat: 'Plasticity',
+        capability: 'Movement',
+        attribute: 'thrust',
+        rationale: 'Flexible polymer seals reduce friction in propulsion',
+    },
+    {
+        stat: 'Plasticity',
+        capability: 'Loader',
+        attribute: 'thrust',
+        rationale: 'Flexible joints improve loader force transfer',
+    },
+    {
+        stat: 'Insulation',
+        capability: 'Movement',
+        attribute: 'drain',
+        rationale: 'Better insulation reduces energy loss during movement',
+    },
+    {
+        stat: 'Insulation',
+        capability: 'Gathering',
+        attribute: 'drain',
+        rationale: 'Better insulation reduces energy loss during gathering',
+    },
+    {
+        stat: 'Insulation',
+        capability: 'Crafter',
+        attribute: 'drain',
+        rationale: 'Better insulation reduces energy loss during crafting',
+    },
+    {
+        stat: 'Insulation',
+        capability: 'Launch',
+        attribute: 'drain',
+        rationale: 'Better insulation reduces energy loss during launch',
+    },
+    {
+        stat: 'Purity',
+        capability: 'Storage',
+        attribute: 'capacity',
+        rationale: 'Purer composites make better containers',
+    },
+    {
+        stat: 'Purity',
+        capability: 'Gathering',
+        attribute: 'speed',
+        rationale: 'Purer bio-lubricants reduce friction during gathering',
+    },
+    {
+        stat: 'Purity',
+        capability: 'Energy',
+        attribute: 'capacity',
+        rationale: 'Purer organic electrolytes store more charge',
+    },
+    {
+        stat: 'Resonance',
+        capability: 'Hauler',
+        attribute: 'capacity',
+        rationale:
+            'Resonant field strength determines how many targets the haul beam can lock onto simultaneously.',
+    },
+    {
+        stat: 'Conductivity',
+        capability: 'Hauler',
+        attribute: 'efficiency',
+        rationale: 'Energy-transfer efficiency reduces the thrust penalty from each hauled target.',
+    },
+    {
+        stat: 'Clarity',
+        capability: 'Hauler',
+        attribute: 'drain',
+        rationale:
+            'Clarity-focused energy routing reduces per-target drain during haul-beam operation.',
+    },
+]
+
+const invertedAttributes = new Set(['drain', 'mass'])
+
+export function isInvertedAttribute(attribute: string): boolean {
+    return invertedAttributes.has(attribute)
+}
+
+export function getCapabilityAttributes(capability?: string): CapabilityAttribute[] {
+    if (capability) {
+        return capabilityAttributes.filter((a) => a.capability === capability)
+    }
+    return capabilityAttributes
+}
+
+export function getStatMappings(): StatMapping[] {
+    return statMappings
+}
+
+export function getStatMappingsForStat(stat: string): StatMapping[] {
+    return statMappings.filter((m) => m.stat === stat)
+}
+
+export function getStatMappingsForCapability(capability: string): StatMapping[] {
+    return statMappings.filter((m) => m.capability === capability)
+}

package/src/data/categories.ts

@@ -0,0 +1,55 @@
+import type {ResourceCategory} from '../types'
+import {categoryColors} from './colors'
+
+export interface CategoryInfo {
+    id: ResourceCategory
+    name: string
+    label: string
+    description: string
+    color: string
+}
+
+const categories: CategoryInfo[] = [
+    {
+        id: 'ore',
+        name: 'Ore',
+        label: 'Ore',
+        description: 'Structural metal-bearing rock — hulls, frames, load-bearing components',
+        color: categoryColors.ore,
+    },
+    {
+        id: 'crystal',
+        name: 'Crystal',
+        label: 'Crystal',
+        description: 'Crystalline lattice — conductors, energy storage, resonant systems',
+        color: categoryColors.crystal,
+    },
+    {
+        id: 'gas',
+        name: 'Gas',
+        label: 'Gas',
+        description: 'Atmospheric volatile — propulsion, thermal processing, chemical reactions',
+        color: categoryColors.gas,
+    },
+    {
+        id: 'regolith',
+        name: 'Regolith',
+        label: 'Regolith',
+        description: 'Surface mineral dust — sensors, optics, computation, cutting surfaces',
+        color: categoryColors.regolith,
+    },
+    {
+        id: 'biomass',
+        name: 'Biomass',
+        label: 'Biomass',
+        description: 'Organic polymer — insulation, composites, bio-processes',
+        color: categoryColors.biomass,
+    },
+]
+
+export function getCategoryInfo(): CategoryInfo[]
+export function getCategoryInfo(id: ResourceCategory): CategoryInfo | undefined
+export function getCategoryInfo(id?: ResourceCategory): CategoryInfo[] | CategoryInfo | undefined {
+    if (id === undefined) return categories
+    return categories.find((c) => c.id === id)
+}

package/src/data/colors.ts

@@ -0,0 +1,71 @@
+import type {ResourceCategory, ResourceTier} from '../types'
+
+export const categoryColors: Record<ResourceCategory, string> = {
+    ore: '#C26D3F',
+    crystal: '#4ADBFF',
+    gas: '#B8E4A0',
+    regolith: '#C4A57B',
+    biomass: '#5A8B3E',
+}
+
+export const tierColors: Record<ResourceTier, string> = {
+    t1: '#8b8b8b',
+    t2: '#4ade80',
+    t3: '#818cf8',
+    t4: '#c084fc',
+    t5: '#fbbf24',
+}
+
+export const tierLabels: Record<ResourceTier, string> = {
+    t1: 'Common',
+    t2: 'Uncommon',
+    t3: 'Rare',
+    t4: 'Epic',
+    t5: 'Legendary',
+}
+
+export const categoryIcons: Record<ResourceCategory, string> = {
+    ore: '⬡',
+    crystal: '◈',
+    gas: '◎',
+    regolith: '■',
+    biomass: '❋',
+}
+
+export type CategoryIconShape = 'hex' | 'diamond' | 'star' | 'circle' | 'square'
+
+export const categoryIconShapes: Record<ResourceCategory, CategoryIconShape> = {
+    ore: 'hex',
+    crystal: 'diamond',
+    gas: 'circle',
+    regolith: 'square',
+    biomass: 'star',
+}
+
+export const componentIcon = '▣'
+export const moduleIcon = '⬢'
+
+export const itemAbbreviations: Record<number, string> = {
+    10001: 'HP',
+    10002: 'CL',
+    10003: 'TC',
+    10004: 'PC',
+    10005: 'DS',
+    10006: 'EP',
+    10007: 'CA',
+    10008: 'TB',
+    10009: 'RC',
+    10010: 'FA',
+    10100: 'EN',
+    10101: 'GN',
+    10102: 'EX',
+    10103: 'LD',
+    10104: 'MF',
+    10105: 'ST',
+    10200: 'CT',
+    10201: 'SH',
+    10202: 'WH',
+    20001: 'HP',
+    20002: 'CL',
+    20200: 'CT',
+}

package/src/data/entities.json

@@ -0,0 +1,50 @@
+[
+  {
+    "entityItemId": 10200,
+    "slots": []
+  },
+  {
+    "entityItemId": 10201,
+    "slots": [
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      },
+      {
+        "type": "any"
+      }
+    ]
+  },
+  {
+    "entityItemId": 10202,
+    "slots": [
+      {
+        "type": "loader"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      },
+      {
+        "type": "storage"
+      }
+    ]
+  },
+  {
+    "entityItemId": 20200,
+    "slots": []
+  }
+]

package/src/data/item-ids.ts

@@ -0,0 +1,75 @@
+// Synced from game/build/catalog via `make sync-catalog` — do not edit.
+
+export const ITEM_ORE_T1 = 101
+export const ITEM_ORE_T2 = 102
+export const ITEM_ORE_T3 = 103
+export const ITEM_ORE_T4 = 104
+export const ITEM_ORE_T5 = 105
+export const ITEM_ORE_T6 = 106
+export const ITEM_ORE_T7 = 107
+export const ITEM_ORE_T8 = 108
+export const ITEM_ORE_T9 = 109
+export const ITEM_ORE_T10 = 110
+export const ITEM_CRYSTAL_T1 = 201
+export const ITEM_CRYSTAL_T2 = 202
+export const ITEM_CRYSTAL_T3 = 203
+export const ITEM_CRYSTAL_T4 = 204
+export const ITEM_CRYSTAL_T5 = 205
+export const ITEM_CRYSTAL_T6 = 206
+export const ITEM_CRYSTAL_T7 = 207
+export const ITEM_CRYSTAL_T8 = 208
+export const ITEM_CRYSTAL_T9 = 209
+export const ITEM_CRYSTAL_T10 = 210
+export const ITEM_GAS_T1 = 301
+export const ITEM_GAS_T2 = 302
+export const ITEM_GAS_T3 = 303
+export const ITEM_GAS_T4 = 304
+export const ITEM_GAS_T5 = 305
+export const ITEM_GAS_T6 = 306
+export const ITEM_GAS_T7 = 307
+export const ITEM_GAS_T8 = 308
+export const ITEM_GAS_T9 = 309
+export const ITEM_GAS_T10 = 310
+export const ITEM_REGOLITH_T1 = 401
+export const ITEM_REGOLITH_T2 = 402
+export const ITEM_REGOLITH_T3 = 403
+export const ITEM_REGOLITH_T4 = 404
+export const ITEM_REGOLITH_T5 = 405
+export const ITEM_REGOLITH_T6 = 406
+export const ITEM_REGOLITH_T7 = 407
+export const ITEM_REGOLITH_T8 = 408
+export const ITEM_REGOLITH_T9 = 409
+export const ITEM_REGOLITH_T10 = 410
+export const ITEM_BIOMASS_T1 = 501
+export const ITEM_BIOMASS_T2 = 502
+export const ITEM_BIOMASS_T3 = 503
+export const ITEM_BIOMASS_T4 = 504
+export const ITEM_BIOMASS_T5 = 505
+export const ITEM_BIOMASS_T6 = 506
+export const ITEM_BIOMASS_T7 = 507
+export const ITEM_BIOMASS_T8 = 508
+export const ITEM_BIOMASS_T9 = 509
+export const ITEM_BIOMASS_T10 = 510
+export const ITEM_HULL_PLATES = 10001
+export const ITEM_CARGO_LINING = 10002
+export const ITEM_THRUSTER_CORE = 10003
+export const ITEM_POWER_CELL = 10004
+export const ITEM_MATTER_CONDUIT = 10005
+export const ITEM_SURVEY_PROBE = 10006
+export const ITEM_CARGO_ARM = 10007
+export const ITEM_TOOL_BIT = 10008
+export const ITEM_REACTION_CHAMBER = 10009
+export const ITEM_FOCUSING_ARRAY = 10010
+export const ITEM_ENGINE_T1 = 10100
+export const ITEM_GENERATOR_T1 = 10101
+export const ITEM_GATHERER_T1 = 10102
+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_CONTAINER_T1_PACKED = 10200
+export const ITEM_SHIP_T1_PACKED = 10201
+export const ITEM_WAREHOUSE_T1_PACKED = 10202
+export const ITEM_HULL_PLATES_T2 = 20001
+export const ITEM_CARGO_LINING_T2 = 20002
+export const ITEM_CONTAINER_T2_PACKED = 20200