@shipload/sdk 1.0.0-next.65 → 1.0.0-next.67

package/src/data/kind-registry.json

@@ -73,21 +73,21 @@
     {
       "kind": "workshop",
       "classification": "PlanetaryStructure",
-      "capabilityFlags": 20,
+      "capabilityFlags": 0,
       "zCoord": 0,
       "defaultLabel": "Workshop"
     },
     {
       "kind": "builddock",
       "classification": "OrbitalStructure",
-      "capabilityFlags": 20,
+      "capabilityFlags": 0,
       "zCoord": 0,
       "defaultLabel": "Construction Dock"
     },
     {
       "kind": "depot",
       "classification": "PlanetaryStructure",
-      "capabilityFlags": 0,
+      "capabilityFlags": 32,
       "zCoord": 0,
       "defaultLabel": "Depot"
     }

package/src/data/kind-registry.ts

@@ -6,6 +6,7 @@ export const CAP_UNDEPLOY = 0x02
 export const CAP_DEMOLISH = 0x04
 export const CAP_CATCH = 0x08
 export const CAP_MODULES = 0x10
+export const CAP_STORE_CARGO = 0x20
 
 export enum EntityClass {
     OrbitalVessel = 0,
@@ -126,6 +127,10 @@ export function canCatch(kind: NameType | EntityTypeName): boolean {
     return kindCan(kind, CAP_CATCH)
 }
 
+export function canStoreCargo(kind: NameType | EntityTypeName): boolean {
+    return kindCan(kind, CAP_STORE_CARGO)
+}
+
 export function getEntityClass(kind: NameType | EntityTypeName): EntityClass {
     const m = KIND_META.get(nameKey(kind))
     if (!m) throw new Error(`Entity type has no class: ${nameKey(kind)}`)

package/src/data/metadata.ts

@@ -334,7 +334,7 @@ export const itemMetadata: Record<number, ItemMetadata> = {
     },
     10219: {
         name: 'Depot',
-        description: 'Planetary storage facility with a loader module slot and four cargo slots.',
+        description: 'Planetary storage facility with two shuttle bays and four cargo slots.',
         color: '#EAB308',
     },
 
@@ -497,7 +497,14 @@ export const entityMetadata: Record<number, EntityMetadata> = {
     },
     10209: {moduleSlotLabels: ['Power Core', 'Assembly Arm']},
     10219: {
-        moduleSlotLabels: ['Shuttle Bay', 'Cargo Hold', 'Cargo Hold', 'Cargo Hold', 'Cargo Hold'],
+        moduleSlotLabels: [
+            'Shuttle Bay',
+            'Shuttle Bay',
+            'Cargo Hold',
+            'Cargo Hold',
+            'Cargo Hold',
+            'Cargo Hold',
+        ],
     },
     11212: {moduleSlotLabels: ['Power Core', 'Engine', 'Limpet Bay']},
     11213: {moduleSlotLabels: ['Power Core', 'Engine', 'Auxiliary System', 'Limpet Bay']},

package/src/data/recipes.json

@@ -1,7 +1,7 @@
 [
   {
     "outputItemId": 10001,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 101,
@@ -38,7 +38,7 @@
   },
   {
     "outputItemId": 10002,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 401,
@@ -87,7 +87,7 @@
   },
   {
     "outputItemId": 10003,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 301,
@@ -124,7 +124,7 @@
   },
   {
     "outputItemId": 10004,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 201,
@@ -165,7 +165,7 @@
   },
   {
     "outputItemId": 10005,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 101,
@@ -206,7 +206,7 @@
   },
   {
     "outputItemId": 10006,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 201,
@@ -243,7 +243,7 @@
   },
   {
     "outputItemId": 10007,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 501,
@@ -280,7 +280,7 @@
   },
   {
     "outputItemId": 10008,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 401,
@@ -309,7 +309,7 @@
   },
   {
     "outputItemId": 10009,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 301,
@@ -358,7 +358,7 @@
   },
   {
     "outputItemId": 10010,
-    "outputMass": 4000,
+    "outputMass": 40,
     "inputs": [
       {
         "itemId": 501,
@@ -399,7 +399,7 @@
   },
   {
     "outputItemId": 10100,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10003,
@@ -434,7 +434,7 @@
   },
   {
     "outputItemId": 10101,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10004,
@@ -469,7 +469,7 @@
   },
   {
     "outputItemId": 10102,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10005,
@@ -521,7 +521,7 @@
   },
   {
     "outputItemId": 10103,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10007,
@@ -556,7 +556,7 @@
   },
   {
     "outputItemId": 10104,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10009,
@@ -596,7 +596,7 @@
   },
   {
     "outputItemId": 10105,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10001,
@@ -645,7 +645,7 @@
   },
   {
     "outputItemId": 10106,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10004,
@@ -693,7 +693,7 @@
   },
   {
     "outputItemId": 10107,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10004,
@@ -725,7 +725,7 @@
   },
   {
     "outputItemId": 10108,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10003,
@@ -774,7 +774,7 @@
   },
   {
     "outputItemId": 10110,
-    "outputMass": 960000,
+    "outputMass": 9600,
     "inputs": [
       {
         "itemId": 10006,
@@ -814,7 +814,7 @@
   },
   {
     "outputItemId": 10200,
-    "outputMass": 1900000,
+    "outputMass": 19000,
     "inputs": [
       {
         "itemId": 10001,
@@ -863,7 +863,7 @@
   },
   {
     "outputItemId": 10202,
-    "outputMass": 3200000,
+    "outputMass": 32000,
     "inputs": [
       {
         "itemId": 10001,
@@ -912,7 +912,7 @@
   },
   {
     "outputItemId": 10203,
-    "outputMass": 1900000,
+    "outputMass": 19000,
     "inputs": [
       {
         "itemId": 10008,
@@ -951,7 +951,7 @@
   },
   {
     "outputItemId": 10204,
-    "outputMass": 1900000,
+    "outputMass": 19000,
     "inputs": [
       {
         "itemId": 10008,
@@ -990,7 +990,7 @@
   },
   {
     "outputItemId": 10207,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1016,48 +1016,9 @@
     ],
     "blendWeights": []
   },
-  {
-    "outputItemId": 10209,
-    "outputMass": 1900000,
-    "inputs": [
-      {
-        "itemId": 10001,
-        "quantity": 600
-      },
-      {
-        "itemId": 10003,
-        "quantity": 600
-      }
-    ],
-    "statSlots": [
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 1
-          }
-        ]
-      },
-      {
-        "sources": []
-      },
-      {
-        "sources": []
-      }
-    ],
-    "blendWeights": []
-  },
   {
     "outputItemId": 10210,
-    "outputMass": 1600000,
+    "outputMass": 16000,
     "inputs": [
       {
         "itemId": 10001,
@@ -1126,7 +1087,7 @@
   },
   {
     "outputItemId": 10211,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1220,7 +1181,7 @@
   },
   {
     "outputItemId": 10212,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1314,7 +1275,7 @@
   },
   {
     "outputItemId": 10213,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1408,7 +1369,7 @@
   },
   {
     "outputItemId": 10214,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1502,7 +1463,7 @@
   },
   {
     "outputItemId": 10215,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1596,7 +1557,7 @@
   },
   {
     "outputItemId": 10218,
-    "outputMass": 2400000,
+    "outputMass": 24000,
     "inputs": [
       {
         "itemId": 10005,
@@ -1690,7 +1651,7 @@
   },
   {
     "outputItemId": 11001,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 102,
@@ -1727,7 +1688,7 @@
   },
   {
     "outputItemId": 11002,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 402,
@@ -1776,7 +1737,7 @@
   },
   {
     "outputItemId": 11003,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 302,
@@ -1813,7 +1774,7 @@
   },
   {
     "outputItemId": 11004,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 202,
@@ -1854,7 +1815,7 @@
   },
   {
     "outputItemId": 11005,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 102,
@@ -1895,7 +1856,7 @@
   },
   {
     "outputItemId": 11006,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 202,
@@ -1932,7 +1893,7 @@
   },
   {
     "outputItemId": 11007,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 502,
@@ -1969,7 +1930,7 @@
   },
   {
     "outputItemId": 11008,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 402,
@@ -1998,7 +1959,7 @@
   },
   {
     "outputItemId": 11009,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 302,
@@ -2047,7 +2008,7 @@
   },
   {
     "outputItemId": 11010,
-    "outputMass": 4800,
+    "outputMass": 48,
     "inputs": [
       {
         "itemId": 502,
@@ -2088,7 +2049,7 @@
   },
   {
     "outputItemId": 11100,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11003,
@@ -2129,7 +2090,7 @@
   },
   {
     "outputItemId": 11101,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11004,
@@ -2170,7 +2131,7 @@
   },
   {
     "outputItemId": 11102,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11005,
@@ -2227,7 +2188,7 @@
   },
   {
     "outputItemId": 11103,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11007,
@@ -2268,7 +2229,7 @@
   },
   {
     "outputItemId": 11104,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11009,
@@ -2313,7 +2274,7 @@
   },
   {
     "outputItemId": 11105,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11001,
@@ -2382,7 +2343,7 @@
   },
   {
     "outputItemId": 11106,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11004,
@@ -2439,7 +2400,7 @@
   },
   {
     "outputItemId": 11107,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11004,
@@ -2472,7 +2433,7 @@
   },
   {
     "outputItemId": 11108,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11003,
@@ -2541,7 +2502,7 @@
   },
   {
     "outputItemId": 11110,
-    "outputMass": 1536000,
+    "outputMass": 15360,
     "inputs": [
       {
         "itemId": 11006,
@@ -2586,7 +2547,7 @@
   },
   {
     "outputItemId": 11200,
-    "outputMass": 3100000,
+    "outputMass": 31000,
     "inputs": [
       {
         "itemId": 11001,
@@ -2656,7 +2617,7 @@
   },
   {
     "outputItemId": 11212,
-    "outputMass": 4320000,
+    "outputMass": 43200,
     "inputs": [
       {
         "itemId": 11001,
@@ -2750,7 +2711,7 @@
   },
   {
     "outputItemId": 11213,
-    "outputMass": 5760000,
+    "outputMass": 57600,
     "inputs": [
       {
         "itemId": 11005,
@@ -2844,7 +2805,7 @@
   },
   {
     "outputItemId": 11214,
-    "outputMass": 5760000,
+    "outputMass": 57600,
     "inputs": [
       {
         "itemId": 11005,

package/src/derivation/build-methods.test.ts

@@ -1,6 +1,32 @@
 import {describe, expect, test} from 'bun:test'
 import {availableBuildMethods} from './build-methods'
-import {ITEM_HUB_T1_PACKED, ITEM_WAREHOUSE_T1_PACKED} from '../data/item-ids'
+import {getItems} from '../data/catalog'
+import {
+    CAP_UNDEPLOY,
+    CAP_WRAP,
+    EntityClass,
+    getKindMeta,
+    getTemplateMeta,
+} from '../data/kind-registry'
+import {getRecipe} from '../data/recipes-runtime'
+import {
+    ITEM_DEPOT_T1_PACKED,
+    ITEM_HUB_T1_PACKED,
+    ITEM_WAREHOUSE_T1_PACKED,
+    ITEM_WORKSHOP_T1_PACKED,
+} from '../data/item-ids'
+
+function planetaryStructures(): {itemId: number; capabilityFlags: number}[] {
+    const out: {itemId: number; capabilityFlags: number}[] = []
+    for (const item of getItems()) {
+        const template = getTemplateMeta(item.id)
+        if (!template) continue
+        const kindMeta = getKindMeta(template.kind)
+        if (kindMeta?.classification !== EntityClass.PlanetaryStructure) continue
+        out.push({itemId: item.id, capabilityFlags: kindMeta.capabilityFlags})
+    }
+    return out
+}
 
 describe('availableBuildMethods', () => {
     test('orbital structures build via craft+deploy or plot', () => {
@@ -10,4 +36,36 @@ describe('availableBuildMethods', () => {
     test('hub is craft+deploy only — excluded from the plot path', () => {
         expect(availableBuildMethods(ITEM_HUB_T1_PACKED)).toEqual(['craft+deploy'])
     })
+
+    test('planetary structures are charter-granted and carry no build method', () => {
+        expect(availableBuildMethods(ITEM_WORKSHOP_T1_PACKED)).toEqual([])
+        expect(availableBuildMethods(ITEM_DEPOT_T1_PACKED)).toEqual([])
+    })
+})
+
+describe('planetary structures are civic hulls', () => {
+    test('the registry classifies the Workshop and the Depot hulls as planetary', () => {
+        const ids = planetaryStructures().map((s) => s.itemId)
+        expect(ids).toContain(ITEM_WORKSHOP_T1_PACKED)
+        expect(ids).toContain(ITEM_DEPOT_T1_PACKED)
+    })
+
+    test('no planetary structure has a recipe', () => {
+        for (const structure of planetaryStructures()) {
+            expect(getRecipe(structure.itemId)).toBeUndefined()
+        }
+    })
+
+    test('the Workshop and the Depot kinds are still classified planetary', () => {
+        for (const kind of ['workshop', 'depot']) {
+            expect(getKindMeta(kind)?.classification).toBe(EntityClass.PlanetaryStructure)
+        }
+    })
+
+    test('no planetary-structure kind can wrap or undeploy', () => {
+        for (const kind of ['workshop', 'depot']) {
+            const meta = getKindMeta(kind)!
+            expect(meta.capabilityFlags & (CAP_WRAP | CAP_UNDEPLOY)).toBe(0)
+        }
+    })
 })

package/src/derivation/build-methods.ts

@@ -15,6 +15,8 @@ export function availableBuildMethods(itemId: number): BuildMethod[] {
     const kindMeta = getKindMeta(template.kind)
     if (!kindMeta) return ['craft+deploy']
 
+    if (kindMeta.classification === EntityClass.PlanetaryStructure) return []
+
     if (
         kindMeta.classification === EntityClass.OrbitalStructure &&
         !kindMeta.kind.equals(ENTITY_HUB)