@shipload/sdk 1.0.0-next.42 → 1.0.0-next.44

package/src/data/recipes.json

@@ -24,6 +24,14 @@
             "statIndex": 2
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -57,6 +65,22 @@
             "statIndex": 0
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 2
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 2
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -86,6 +110,14 @@
             "statIndex": 2
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -119,6 +151,14 @@
             "statIndex": 2
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 0
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -152,6 +192,14 @@
             "statIndex": 1
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 2
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -181,6 +229,14 @@
             "statIndex": 2
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -210,6 +266,14 @@
             "statIndex": 1
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 2
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -272,6 +336,22 @@
             "statIndex": 2
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 2
+          }
+        ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 1,
+            "statIndex": 0
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -305,6 +385,14 @@
             "statIndex": 0
           }
         ]
+      },
+      {
+        "sources": [
+          {
+            "inputIndex": 0,
+            "statIndex": 1
+          }
+        ]
       }
     ],
     "blendWeights": []
@@ -324,6 +412,10 @@
           {
             "inputIndex": 0,
             "statIndex": 0
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 2
           }
         ]
       },
@@ -336,7 +428,9 @@
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1
+    ]
   },
   {
     "outputItemId": 10101,
@@ -353,6 +447,10 @@
           {
             "inputIndex": 0,
             "statIndex": 0
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 2
           }
         ]
       },
@@ -365,7 +463,9 @@
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1
+    ]
   },
   {
     "outputItemId": 10102,
@@ -376,7 +476,7 @@
         "quantity": 300
       },
       {
-        "itemId": 10010,
+        "itemId": 10002,
         "quantity": 300
       }
     ],
@@ -386,14 +486,10 @@
           {
             "inputIndex": 0,
             "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
+          },
           {
             "inputIndex": 0,
-            "statIndex": 1
+            "statIndex": 2
           }
         ]
       },
@@ -402,6 +498,10 @@
           {
             "inputIndex": 1,
             "statIndex": 0
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 1
           }
         ]
       },
@@ -409,12 +509,15 @@
         "sources": [
           {
             "inputIndex": 1,
-            "statIndex": 1
+            "statIndex": 3
           }
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1,
+      1
+    ]
   },
   {
     "outputItemId": 10103,
@@ -439,11 +542,17 @@
           {
             "inputIndex": 0,
             "statIndex": 0
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 2
           }
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1
+    ]
   },
   {
     "outputItemId": 10104,
@@ -463,7 +572,11 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 0
+            "statIndex": 2
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 3
           }
         ]
       },
@@ -476,7 +589,10 @@
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1,
+      1
+    ]
   },
   {
     "outputItemId": 10105,
@@ -546,6 +662,10 @@
           {
             "inputIndex": 0,
             "statIndex": 0
+          },
+          {
+            "inputIndex": 0,
+            "statIndex": 1
           }
         ]
       },
@@ -561,12 +681,15 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 1
+            "statIndex": 2
           }
         ]
       }
     ],
-    "blendWeights": []
+    "blendWeights": [
+      1,
+      1
+    ]
   },
   {
     "outputItemId": 10107,
@@ -586,11 +709,11 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 0
+            "statIndex": 1
           },
           {
-            "inputIndex": 1,
-            "statIndex": 1
+            "inputIndex": 0,
+            "statIndex": 2
           }
         ]
       }
@@ -877,135 +1000,21 @@
     "blendWeights": []
   },
   {
-    "outputItemId": 20001,
-    "outputMass": 500,
-    "inputs": [
-      {
-        "itemId": 10001,
-        "quantity": 200
-      },
-      {
-        "itemId": 102,
-        "quantity": 15
-      }
-    ],
-    "statSlots": [
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 0
-          },
-          {
-            "inputIndex": 1,
-            "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 1
-          },
-          {
-            "inputIndex": 1,
-            "statIndex": 2
-          }
-        ]
-      }
-    ],
-    "blendWeights": [
-      1,
-      1
-    ]
-  },
-  {
-    "outputItemId": 20002,
-    "outputMass": 300,
+    "outputItemId": 10207,
+    "outputMass": 2400000,
     "inputs": [
       {
-        "itemId": 10002,
+        "itemId": 10005,
         "quantity": 200
       },
       {
-        "itemId": 402,
-        "quantity": 10
-      },
-      {
-        "itemId": 502,
-        "quantity": 20
-      }
-    ],
-    "statSlots": [
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 0
-          },
-          {
-            "inputIndex": 1,
-            "statIndex": 1
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 1
-          },
-          {
-            "inputIndex": 2,
-            "statIndex": 2
-          }
-        ]
-      }
-    ],
-    "blendWeights": [
-      1,
-      1,
-      1
-    ]
-  },
-  {
-    "outputItemId": 20200,
-    "outputMass": 80000,
-    "inputs": [
-      {
-        "itemId": 20001,
-        "quantity": 600
-      },
-      {
-        "itemId": 20002,
+        "itemId": 10010,
         "quantity": 200
       }
     ],
     "statSlots": [
       {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 1
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 1,
-            "statIndex": 0
-          }
-        ]
+        "sources": []
       },
       {
         "sources": [

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

@@ -0,0 +1,13 @@
+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'
+
+describe('availableBuildMethods', () => {
+    test('orbital structures build via craft+deploy or plot', () => {
+        expect(availableBuildMethods(ITEM_WAREHOUSE_T1_PACKED)).toEqual(['craft+deploy', 'plot'])
+    })
+
+    test('hub is craft+deploy only — excluded from the plot path', () => {
+        expect(availableBuildMethods(ITEM_HUB_T1_PACKED)).toEqual(['craft+deploy'])
+    })
+})

package/src/derivation/build-methods.ts

@@ -1,4 +1,4 @@
-import {EntityClass, getKindMeta, getTemplateMeta} from '../data/kind-registry'
+import {ENTITY_HUB, EntityClass, getKindMeta, getTemplateMeta} from '../data/kind-registry'
 import {getRecipe} from '../data/recipes-runtime'
 import {getItems} from '../data/catalog'
 import type {Item} from '../types'
@@ -15,7 +15,10 @@ export function availableBuildMethods(itemId: number): BuildMethod[] {
     const kindMeta = getKindMeta(template.kind)
     if (!kindMeta) return ['craft+deploy']
 
-    if (kindMeta.classification === EntityClass.PlanetaryStructure) {
+    if (
+        kindMeta.classification === EntityClass.OrbitalStructure &&
+        !kindMeta.kind.equals(ENTITY_HUB)
+    ) {
         return ['craft+deploy', 'plot']
     }
     return ['craft+deploy']

package/src/derivation/capabilities.ts

@@ -78,12 +78,12 @@ export function computeGathererCapabilities(
 } {
     const str = stats.strength
     const con = stats.saturation
-    const tol = stats.tolerance
+    const hrd = stats.hardness
 
     return {
         yield: 200 + str,
         drain: 2 * Math.max(250, 1250 - Math.floor((con * 25) / 20)),
-        depth: gathererDepthForTier(tol, tier),
+        depth: gathererDepthForTier(hrd, tier),
     }
 }
 
@@ -106,11 +106,11 @@ export function computeCrafterCapabilities(stats: Record<string, number>): {
     speed: number
     drain: number
 } {
-    const rea = stats.reactivity
+    const fin = stats.fineness
     const con = stats.conductivity
 
     return {
-        speed: 100 + Math.floor((rea * 4) / 5),
+        speed: 100 + Math.floor((fin * 4) / 5),
         drain: Math.max(5, 30 - Math.floor(con / 33)),
     }
 }
@@ -122,12 +122,12 @@ export function computeHaulerCapabilities(stats: Record<string, number>): {
 } {
     const resonance = stats.resonance
     const plasticity = stats.plasticity
-    const reflectivity = stats.reflectivity
+    const conductivity = stats.conductivity
 
     return {
         capacity: Math.max(1, 1 + Math.floor(resonance / 400)),
         efficiency: 2000 + plasticity * 6,
-        drain: Math.max(3, 15 - Math.floor(reflectivity / 80)),
+        drain: Math.max(3, 15 - Math.floor(conductivity / 80)),
     }
 }
 
@@ -224,8 +224,8 @@ export function computeBaseCapacity(itemId: number, stats: Record<string, number
 export function computeWarpCapabilities(stats: Record<string, number>): {
     range: number
 } {
-    const resonance = stats.resonance
-    return {range: 100 + resonance * 3}
+    const reflectivity = stats.reflectivity
+    return {range: 100 + reflectivity * 3}
 }
 
 export function computeWarehouseHullCapabilities(stats: Record<string, number>): {

package/src/derivation/capability-mappings.ts

@@ -18,7 +18,8 @@ import {
     ITEM_WAREHOUSE_T1_PACKED,
     ITEM_CONTAINER_T2_PACKED,
 } from '../data/item-ids'
-import type {StatMapping} from '../data/capabilities'
+import type {StatMapping, CapabilityAttributeRow} from '../data/capabilities'
+import {capabilityAttributes} from '../data/capabilities'
 
 export const KIND_TO_ITEM_ID: Record<SlotConsumerKind, number> = {
     engine: ITEM_ENGINE_T1,
@@ -69,6 +70,12 @@ function traceToRawCategoryStat(
     return traceToRawCategoryStat(subRecipe, subSource, nextVisited)
 }
 
+// Producing role for a capability·attribute: entity hull slots all roll up to "Hull"; modules use their own name.
+export function sourceLabelForOutput(itemId: number): string {
+    const item = getItem(itemId)
+    return item.type === 'entity' ? 'Hull' : item.name
+}
+
 let cached: StatMapping[] | undefined
 
 export function deriveStatMappings(): StatMapping[] {
@@ -82,20 +89,22 @@ export function deriveStatMappings(): StatMapping[] {
         const itemId = KIND_TO_ITEM_ID[kind]
         const recipe = getRecipe(itemId)
         if (!recipe) continue
+        const source = sourceLabelForOutput(itemId)
         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)
+            for (const src of slot.sources) {
+                const stat = traceToRawCategoryStat(recipe, src)
                 if (!stat) continue
-                const key = `${stat.label}|${consumer.capability}|${consumer.attribute}`
+                const key = `${stat.label}|${consumer.capability}|${consumer.attribute}|${source}`
                 if (seen.has(key)) continue
                 seen.add(key)
                 out.push({
                     stat: stat.label,
                     capability: consumer.capability,
                     attribute: consumer.attribute,
+                    source,
                 })
             }
         }
@@ -115,3 +124,39 @@ export function getStatMappingsForStat(stat: string): StatMapping[] {
 export function getStatMappingsForCapability(capability: string): StatMapping[] {
     return deriveStatMappings().filter((m) => m.capability === capability)
 }
+
+export function getProducersForAttribute(capability: string, attribute: string): string[] {
+    const seen = new Set<string>()
+    const out: string[] = []
+    for (const m of deriveStatMappings()) {
+        if (m.capability !== capability || m.attribute !== attribute) continue
+        if (seen.has(m.source)) continue
+        seen.add(m.source)
+        out.push(m.source)
+    }
+    return out
+}
+
+export function getCapabilityAttributeRows(): CapabilityAttributeRow[] {
+    const rows: CapabilityAttributeRow[] = []
+    for (const ca of capabilityAttributes) {
+        const producers = getProducersForAttribute(ca.capability, ca.attribute)
+        if (producers.length === 0) {
+            rows.push({
+                capability: ca.capability,
+                attribute: ca.attribute,
+                description: ca.description,
+            })
+            continue
+        }
+        for (const source of producers) {
+            rows.push({
+                capability: ca.capability,
+                attribute: ca.attribute,
+                description: ca.description,
+                source,
+            })
+        }
+    }
+    return rows
+}

package/src/index-module.ts

@@ -46,9 +46,12 @@ export {
     LocationsManager,
     EpochsManager,
     ActionsManager,
+    ClusterManager,
+    computeFreeCells,
     NftManager,
     ConstructionManager,
 } from './managers'
+export type {GridCell, ClusterCell, Cluster} from './managers'
 export type {
     PlayerRosterEntry,
     LocationStratum,
@@ -283,6 +286,17 @@ export type {
     CancelEligibilityInput,
 } from './scheduling/cancel'
 
+export {
+    derivedLoaders,
+    estimateUnwrapDuration,
+    incomingHoldMass,
+    projectedPeakCargomass,
+    receiveFits,
+    unwrapLoadDuration,
+    unwrapTransitDuration,
+} from './scheduling/unwrap'
+export type {DerivedLoaders, UnwrapDestination, UnwrapItem} from './scheduling/unwrap'
+
 export {
     projectedCargoAvailableAt,
     availableForItem,
@@ -304,6 +318,7 @@ export {
     ENTITY_FACTORY,
     ENTITY_CONTAINER,
     ENTITY_NEXUS,
+    ENTITY_HUB,
     getEntityClass,
     getPackedEntityType,
     getKindMeta,
@@ -321,6 +336,7 @@ export {
     isContainer,
     isNexus,
     isPlot,
+    isHub,
 } from './data/kind-registry'
 export type {EntityTypeName, KindMeta, TemplateMeta} from './data/kind-registry'
 export * from './capabilities'
@@ -348,13 +364,16 @@ export {
     isInvertedAttribute,
     getCapabilityAttributes,
 } from './data/capabilities'
-export type {CapabilityAttribute, StatMapping} from './data/capabilities'
+export type {CapabilityAttribute, StatMapping, CapabilityAttributeRow} from './data/capabilities'
 
 export {
     deriveStatMappings,
     getStatMappings,
     getStatMappingsForStat,
     getStatMappingsForCapability,
+    getProducersForAttribute,
+    getCapabilityAttributeRows,
+    sourceLabelForOutput,
 } from './derivation/capability-mappings'
 export {SLOT_FORMULAS} from './data/capability-formulas'
 export type {SlotConsumer, SlotConsumerKind} from './data/capability-formulas'
@@ -422,6 +441,7 @@ export {
     feistelInv,
     regionOf,
     partnerRegion,
+    nearbyWormholes,
     wormholeAt,
     wormholeAtRegionEndpoint,
     isValidWormholePair,