@shipload/sdk 1.0.0-next.61 → 1.0.0-next.63

package/src/contracts.ts

@@ -1,2 +1,3 @@
+export * as FundContract from './contracts/fund'
 export * as PlatformContract from './contracts/platform'
 export * as ServerContract from './contracts/server'

package/src/data/charters.json

@@ -0,0 +1,198 @@
+{
+  "nodes": [
+    {
+      "nodeId": 1,
+      "cost": "2000000000",
+      "prereqs": [],
+      "effect": {
+        "kind": 1,
+        "itemId": 10208,
+        "targetItemId": 0,
+        "slotMask": 0,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 2,
+      "cost": "4000000000",
+      "prereqs": [
+        1
+      ],
+      "effect": {
+        "kind": 1,
+        "itemId": 10216,
+        "targetItemId": 0,
+        "slotMask": 0,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 3,
+      "cost": "3000000000",
+      "prereqs": [
+        1
+      ],
+      "effect": {
+        "kind": 1,
+        "itemId": 10209,
+        "targetItemId": 0,
+        "slotMask": 0,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 4,
+      "cost": "2000000000",
+      "prereqs": [
+        1
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10104,
+        "targetItemId": 10208,
+        "slotMask": 0,
+        "stat": 400
+      }
+    },
+    {
+      "nodeId": 5,
+      "cost": "3000000000",
+      "prereqs": [
+        3
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10110,
+        "targetItemId": 10209,
+        "slotMask": 2,
+        "stat": 400
+      }
+    },
+    {
+      "nodeId": 6,
+      "cost": "2500000000",
+      "prereqs": [
+        1
+      ],
+      "effect": {
+        "kind": 1,
+        "itemId": 10219,
+        "targetItemId": 0,
+        "slotMask": 1,
+        "stat": 0
+      }
+    },
+    {
+      "nodeId": 7,
+      "cost": "1000000000",
+      "prereqs": [
+        6
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10105,
+        "targetItemId": 10219,
+        "slotMask": 2,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 8,
+      "cost": "1500000000",
+      "prereqs": [
+        7
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10105,
+        "targetItemId": 10219,
+        "slotMask": 4,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 9,
+      "cost": "2000000000",
+      "prereqs": [
+        8
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10105,
+        "targetItemId": 10219,
+        "slotMask": 8,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 10,
+      "cost": "2500000000",
+      "prereqs": [
+        9
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10105,
+        "targetItemId": 10219,
+        "slotMask": 16,
+        "stat": 213
+      }
+    },
+    {
+      "nodeId": 11,
+      "cost": "800000000",
+      "prereqs": [
+        6
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10103,
+        "targetItemId": 10219,
+        "slotMask": 1,
+        "stat": 100
+      }
+    },
+    {
+      "nodeId": 12,
+      "cost": "1200000000",
+      "prereqs": [
+        11
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10103,
+        "targetItemId": 10219,
+        "slotMask": 1,
+        "stat": 200
+      }
+    },
+    {
+      "nodeId": 13,
+      "cost": "1600000000",
+      "prereqs": [
+        12
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10103,
+        "targetItemId": 10219,
+        "slotMask": 1,
+        "stat": 300
+      }
+    },
+    {
+      "nodeId": 14,
+      "cost": "2000000000",
+      "prereqs": [
+        13
+      ],
+      "effect": {
+        "kind": 2,
+        "itemId": 10103,
+        "targetItemId": 10219,
+        "slotMask": 1,
+        "stat": 400
+      }
+    }
+  ]
+}

package/src/data/entities.json

@@ -313,6 +313,11 @@
     ],
     "baseHullmass": 4000000
   },
+  {
+    "entityItemId": 10216,
+    "slots": [],
+    "baseHullmass": 100000
+  },
   {
     "entityItemId": 10218,
     "slots": [
@@ -334,6 +339,37 @@
     ],
     "baseHullmass": 4000000
   },
+  {
+    "entityItemId": 10219,
+    "slots": [
+      {
+        "type": "loader",
+        "outputPct": 100,
+        "maxTier": 1
+      },
+      {
+        "type": "storage",
+        "outputPct": 100,
+        "maxTier": 1
+      },
+      {
+        "type": "storage",
+        "outputPct": 100,
+        "maxTier": 1
+      },
+      {
+        "type": "storage",
+        "outputPct": 100,
+        "maxTier": 1
+      },
+      {
+        "type": "storage",
+        "outputPct": 100,
+        "maxTier": 1
+      }
+    ],
+    "baseHullmass": 100000
+  },
   {
     "entityItemId": 11200,
     "slots": [],

package/src/data/item-ids.ts

@@ -87,7 +87,9 @@ export const ITEM_TENDER_T1A_PACKED = 10212
 export const ITEM_WRIGHT_T1A_PACKED = 10213
 export const ITEM_TUG_T1A_PACKED = 10214
 export const ITEM_PORTER_T1A_PACKED = 10215
+export const ITEM_NEXUS_T1_PACKED = 10216
 export const ITEM_SMITH_T1A_PACKED = 10218
+export const ITEM_DEPOT_T1_PACKED = 10219
 export const ITEM_PLATE_T2 = 11001
 export const ITEM_FRAME_T2 = 11002
 export const ITEM_PLASMA_CELL_T2 = 11003

package/src/data/items.json

@@ -582,12 +582,24 @@
     "type": "entity",
     "tier": 1
   },
+  {
+    "id": 10216,
+    "mass": 4800000,
+    "type": "entity",
+    "tier": 1
+  },
   {
     "id": 10218,
     "mass": 2400000,
     "type": "entity",
     "tier": 1
   },
+  {
+    "id": 10219,
+    "mass": 4800000,
+    "type": "entity",
+    "tier": 1
+  },
   {
     "id": 11001,
     "mass": 4800,

package/src/data/kind-registry.json

@@ -51,9 +51,9 @@
     },
     {
       "kind": "nexus",
-      "classification": "OrbitalVessel",
+      "classification": "OrbitalStructure",
       "capabilityFlags": 0,
-      "zCoord": 800,
+      "zCoord": 0,
       "defaultLabel": "Nexus"
     },
     {
@@ -72,7 +72,7 @@
     },
     {
       "kind": "workshop",
-      "classification": "OrbitalStructure",
+      "classification": "PlanetaryStructure",
       "capabilityFlags": 20,
       "zCoord": 0,
       "defaultLabel": "Workshop"
@@ -83,6 +83,13 @@
       "capabilityFlags": 20,
       "zCoord": 0,
       "defaultLabel": "Construction Dock"
+    },
+    {
+      "kind": "depot",
+      "classification": "PlanetaryStructure",
+      "capabilityFlags": 0,
+      "zCoord": 0,
+      "defaultLabel": "Depot"
     }
   ],
   "templates": [
@@ -176,6 +183,11 @@
       "kind": "builddock",
       "displayLabel": ""
     },
+    {
+      "itemId": 10216,
+      "kind": "nexus",
+      "displayLabel": ""
+    },
     {
       "itemId": 11212,
       "kind": "ship",
@@ -190,6 +202,11 @@
       "itemId": 11214,
       "kind": "ship",
       "displayLabel": "Dredger"
+    },
+    {
+      "itemId": 10219,
+      "kind": "depot",
+      "displayLabel": ""
     }
   ]
 }

package/src/data/kind-registry.ts

@@ -34,6 +34,7 @@ export type EntityTypeName =
     | 'mdriver'
     | 'mcatcher'
     | 'hub'
+    | 'depot'
 
 export interface KindMeta {
     kind: Name
@@ -143,6 +144,7 @@ export const ENTITY_PLOT = Name.from('plot')
 export const ENTITY_MASS_DRIVER = Name.from('mdriver')
 export const ENTITY_MASS_CATCHER = Name.from('mcatcher')
 export const ENTITY_HUB = Name.from('hub')
+export const ENTITY_DEPOT = Name.from('depot')
 
 export function isShip(entity: {type?: Name}): boolean {
     return entity.type?.equals(ENTITY_SHIP) ?? false
@@ -180,3 +182,6 @@ export function isMassCatcher(entity: {type?: Name}): boolean {
 export function isHub(entity: {type?: Name}): boolean {
     return entity.type?.equals(ENTITY_HUB) ?? false
 }
+export function isDepot(entity: {type?: Name}): boolean {
+    return entity.type?.equals(ENTITY_DEPOT) ?? false
+}

package/src/data/metadata.ts

@@ -320,12 +320,23 @@ export const itemMetadata: Record<number, ItemMetadata> = {
             'A cargo ship built around a large storage hold. The extra mass makes it slower than a Roustabout.',
         color: '#4AE898',
     },
+    10216: {
+        name: 'Nexus',
+        description:
+            'A permanent installation at a world where NFT-backed assets are wrapped, unwrapped, and deployed.',
+        color: '#FFD24C',
+    },
     10218: {
         name: 'Smith',
         description:
             'A crafting ship. One engine, one power core, and a fabricator for crafting away from home.',
         color: '#4AE898',
     },
+    10219: {
+        name: 'Depot',
+        description: 'Planetary storage facility with a loader module slot and four cargo slots.',
+        color: '#EAB308',
+    },
 
     // === Components (T2) ===
     11001: {
@@ -485,6 +496,9 @@ export const entityMetadata: Record<number, EntityMetadata> = {
         moduleSlotLabels: ['Fabricator', 'Fabricator', 'Fabricator', 'Fabricator', 'Fabricator'],
     },
     10209: {moduleSlotLabels: ['Power Core', 'Assembly Arm']},
+    10219: {
+        moduleSlotLabels: ['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']},
     11214: {moduleSlotLabels: ['Power Core', 'Engine', 'Limpet Bay', 'Cargo Hold']},

package/src/data/recipes.json

@@ -1016,54 +1016,6 @@
     ],
     "blendWeights": []
   },
-  {
-    "outputItemId": 10208,
-    "outputMass": 4800000,
-    "inputs": [
-      {
-        "itemId": 10006,
-        "quantity": 1000
-      },
-      {
-        "itemId": 10003,
-        "quantity": 1000
-      },
-      {
-        "itemId": 10007,
-        "quantity": 1000
-      }
-    ],
-    "statSlots": [
-      {
-        "sources": []
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 1,
-            "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 0,
-            "statIndex": 0
-          }
-        ]
-      },
-      {
-        "sources": [
-          {
-            "inputIndex": 2,
-            "statIndex": 0
-          }
-        ]
-      }
-    ],
-    "blendWeights": []
-  },
   {
     "outputItemId": 10209,
     "outputMass": 1900000,

package/src/derivation/capabilities.ts

@@ -233,6 +233,7 @@ export function computeBatteryCapabilities(
 
 import {
     ITEM_CONTAINER_T1_PACKED,
+    ITEM_DEPOT_T1_PACKED,
     ITEM_SHIP_T1_PACKED,
     ITEM_WAREHOUSE_T1_PACKED,
     ITEM_WORKSHOP_T1_PACKED,
@@ -315,6 +316,7 @@ export function computeGathererYield(str: number, tier: number): number {
 
 const BASE_CAPACITY_FN_BY_KIND: Record<string, (stats: Record<string, number>) => number> = {
     warehouse: (stats) => computeWarehouseHullCapabilities(stats).capacity,
+    depot: (stats) => computeDepotHullCapabilities(stats).capacity,
     workshop: (stats) => computeWorkshopHullCapabilities(stats).capacity,
     extractor: (stats) => computeContainerCapabilities(stats).capacity,
     factory: (stats) => computeContainerCapabilities(stats).capacity,
@@ -361,6 +363,18 @@ export function computeWarehouseHullCapabilities(stats: Record<string, number>):
     }
 }
 
+export function computeDepotHullCapabilities(stats: Record<string, number>): {
+    hullmass: number
+    capacity: number
+} {
+    const statSum = (stats.strength ?? 0) + (stats.hardness ?? 0)
+    const exponent = statSum / 1998.0
+    return {
+        hullmass: computeBaseHullmass(ITEM_DEPOT_T1_PACKED, stats),
+        capacity: Math.floor(50000000 * 6 ** exponent),
+    }
+}
+
 export function computeWorkshopHullCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number

package/src/derivation/recipe-usage.test.ts

@@ -15,7 +15,6 @@ import {
     ITEM_CRAFTER_T1,
     ITEM_BUILDER_T1,
     ITEM_EXTRACTOR_T1_PACKED,
-    ITEM_WORKSHOP_T1_PACKED,
     ITEM_ROUSTABOUT_T1A_PACKED,
     ITEM_PROSPECTOR_T1A_PACKED,
     ITEM_TENDER_T1A_PACKED,
@@ -37,7 +36,6 @@ test('getRecipeConsumers lists every recipe that consumes Sensor', () => {
             ITEM_CRAFTER_T1,
             ITEM_BUILDER_T1,
             ITEM_EXTRACTOR_T1_PACKED,
-            ITEM_WORKSHOP_T1_PACKED,
             ITEM_ROUSTABOUT_T1A_PACKED,
         ].sort((a, b) => a - b)
     )

package/src/format.ts

@@ -32,3 +32,12 @@ export function formatMassScaled(kg: number): string {
     if (tonnes >= 1_000) return `${sign}${trim(tonnes / 1_000)}k t`
     return formatMass(kg)
 }
+
+export function formatInfluence(atomic: bigint | number | string): string {
+    const points = BigInt(String(atomic)) / 10_000n
+    return `${points.toLocaleString('en-US')} pts`
+}
+
+export function formatNeedMultiplier(needFp: bigint | number | string): string {
+    return `×${(Number(BigInt(String(needFp))) / 10_000).toFixed(1)}`
+}

package/src/index-module.ts

@@ -51,9 +51,20 @@ export {
     computeFreeCells,
     NftManager,
     ConstructionManager,
+    JobsManager,
+    InfluenceManager,
 } from './managers'
 export type {GridCell, ClusterCell, Cluster} from './managers'
 export type {
+    CharterProgress,
+    ContributePreview,
+    ContributePreviewRow,
+    FoundedWorld,
+    InfluenceStanding,
+    PendingBallot,
+    VoteCast,
+    VoteOption,
+    VoteStandings,
     PlayerRosterEntry,
     LocationStratum,
     NftConfigForItem,
@@ -288,8 +299,15 @@ export type {
 export {taskCargoChanges} from './scheduling/task-cargo'
 export type {TaskCargoChange, TaskCargoDirection} from './scheduling/task-cargo'
 
-export {jobsToLanes, pickFabricator, socketTail, JOB_QUEUE_CAP} from './scheduling/jobs'
-export type {JobWindow, JobLane, JobLaneEntry} from './scheduling/jobs'
+export {
+    jobsToLanes,
+    pickFabricator,
+    socketTail,
+    JOB_QUEUE_CAP,
+    jobStatus,
+    splitJobCargo,
+} from './scheduling/jobs'
+export type {JobWindow, JobLane, JobLaneEntry, JobStatus, OwnedJob} from './scheduling/jobs'
 
 export {composeIdleResolve} from './scheduling/idle-resolve'
 export type {CounterpartLookup, IdleResolveTarget} from './scheduling/idle-resolve'
@@ -348,6 +366,7 @@ export {
     ENTITY_CONTAINER,
     ENTITY_NEXUS,
     ENTITY_HUB,
+    ENTITY_DEPOT,
     getEntityClass,
     getPackedEntityType,
     getKindMeta,
@@ -368,6 +387,7 @@ export {
     isNexus,
     isPlot,
     isHub,
+    isDepot,
 } from './data/kind-registry'
 export type {EntityTypeName, KindMeta, TemplateMeta} from './data/kind-registry'
 export * from './capabilities'
@@ -454,6 +474,7 @@ export {
     computeCrafterCapabilities,
     computeBuilderCapabilities,
     computeWarehouseHullCapabilities,
+    computeDepotHullCapabilities,
     computeStorageCapabilities,
     computeBatteryCapabilities,
     computeContainerCapabilities,
@@ -575,6 +596,7 @@ export {
     computeBaseHullmass,
     computeBaseCapacityShip,
     computeBaseCapacityWarehouse,
+    computeBaseCapacityDepot,
     computeBaseCapacityContainer,
     computeEngineThrust,
     computeEngineDrain,
@@ -605,7 +627,14 @@ export {
     itemTypeCode,
 } from './data/tiers'
 
-export {formatMass, formatMassDelta, formatMassScaled, formatLocation} from './format'
+export {
+    formatInfluence,
+    formatLocation,
+    formatMass,
+    formatMassDelta,
+    formatMassScaled,
+    formatNeedMultiplier,
+} from './format'
 export * from './coordinates'
 
 export {displayName, baseName, describeItem} from './resolution/display-name'
@@ -631,3 +660,5 @@ export type {
     LanePlanEntry,
     PlanTarget,
 } from './planner'
+
+export * from './influence'

package/src/influence/categories.ts

@@ -0,0 +1,32 @@
+import {categoryFromIndex} from '../data/catalog'
+import type {ResourceCategory} from '../types'
+import {
+    RESOURCE_BIOMASS,
+    RESOURCE_CATEGORY_COUNT,
+    RESOURCE_CRYSTAL,
+    RESOURCE_GAS,
+    RESOURCE_ORE,
+    RESOURCE_REGOLITH,
+} from './constants'
+
+const INDEX_BY_CATEGORY: Record<ResourceCategory, number> = {
+    ore: RESOURCE_ORE,
+    gas: RESOURCE_GAS,
+    regolith: RESOURCE_REGOLITH,
+    biomass: RESOURCE_BIOMASS,
+    crystal: RESOURCE_CRYSTAL,
+}
+
+export function categoryIndex(category: ResourceCategory): number {
+    return INDEX_BY_CATEGORY[category]
+}
+
+export function categoryAtIndex(index: number): ResourceCategory {
+    const category = categoryFromIndex(index)
+    if (!category) throw new Error(`influence: invalid resource category index ${index}`)
+    return category
+}
+
+export function allCategoryIndexes(): number[] {
+    return Array.from({length: RESOURCE_CATEGORY_COUNT}, (_, i) => i)
+}