@shipload/sdk 2.0.0-rc2 → 2.0.0-rc20

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/items.json

@@ -0,0 +1,17 @@
+[
+    {"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"}
+]

package/src/data/locations.ts

@@ -0,0 +1,53 @@
+export interface PlanetSubtypeInfo {
+    id: number
+    label: string
+    description: string
+    paletteType: string
+}
+
+const planetSubtypes: PlanetSubtypeInfo[] = [
+    {
+        id: 0,
+        label: 'Gas Giant',
+        description: 'Massive planets with thick atmospheres rich in gases',
+        paletteType: 'gasGiant',
+    },
+    {
+        id: 1,
+        label: 'Rocky',
+        description: 'Dense, mineral-rich worlds with metallic cores',
+        paletteType: 'rocky',
+    },
+    {
+        id: 2,
+        label: 'Terrestrial',
+        description: 'Earth-like planets with varied terrain and life potential',
+        paletteType: 'terrestrial',
+    },
+    {
+        id: 3,
+        label: 'Icy',
+        description: 'Frozen worlds with subsurface resources',
+        paletteType: 'ice',
+    },
+    {
+        id: 4,
+        label: 'Ocean',
+        description: 'Water worlds with dissolved minerals and organics',
+        paletteType: 'ocean',
+    },
+    {
+        id: 5,
+        label: 'Industrial',
+        description: 'Heavily processed worlds rich in refined materials',
+        paletteType: 'industrial',
+    },
+]
+
+export function getPlanetSubtypes(): PlanetSubtypeInfo[] {
+    return planetSubtypes
+}
+
+export function getPlanetSubtype(id: number): PlanetSubtypeInfo | undefined {
+    return planetSubtypes.find((s) => s.id === id)
+}