@shipload/sdk 1.0.0-next.27 → 1.0.0-next.28

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@shipload/sdk",
     "description": "SDKs for Shipload",
-    "version": "1.0.0-next.27",
+    "version": "1.0.0-next.28",
     "homepage": "https://github.com/shipload/toolkit/tree/master/packages/sdk",
     "repository": {
         "type": "git",

package/src/data/colors.ts

@@ -34,7 +34,7 @@ export const itemAbbreviations: Record<number, string> = {
     10007: 'PM',
     10008: 'CR',
     10009: 'RX',
-    10010: 'EM',
+    10010: 'RE',
     10100: 'EN',
     10101: 'GN',
     10102: 'EX',

package/src/data/item-ids.ts

@@ -59,7 +59,7 @@ export const ITEM_SENSOR = 10006
 export const ITEM_POLYMER = 10007
 export const ITEM_CERAMIC = 10008
 export const ITEM_REACTOR = 10009
-export const ITEM_EMITTER = 10010
+export const ITEM_RESIN = 10010
 export const ITEM_ENGINE_T1 = 10100
 export const ITEM_GENERATOR_T1 = 10101
 export const ITEM_GATHERER_T1 = 10102

package/src/data/metadata.ts

@@ -163,10 +163,10 @@ export const itemMetadata: Record<number, ItemMetadata> = {
         color: '#B877FF',
     },
     10010: {
-        name: 'Emitter',
+        name: 'Resin',
         description:
-            'Precision-formed crystal emitter array. Routes energy efficiently to a target lock.',
-        color: '#4ADBFF',
+            'Saturated organic binder cured from biomass. A pliable matrix for haulage and field components.',
+        color: '#5A8B3E',
     },
 
     // === Modules (T1) ===

package/src/data/recipes.json

@@ -53,8 +53,8 @@
       {
         "sources": [
           {
-            "inputIndex": 1,
-            "statIndex": 2
+            "inputIndex": 0,
+            "statIndex": 0
           }
         ]
       }
@@ -99,7 +99,7 @@
         "quantity": 6
       },
       {
-        "itemId": 501,
+        "itemId": 101,
         "quantity": 9
       }
     ],
@@ -281,11 +281,11 @@
     "outputMass": 6000,
     "inputs": [
       {
-        "itemId": 201,
+        "itemId": 501,
         "quantity": 6
       },
       {
-        "itemId": 101,
+        "itemId": 201,
         "quantity": 9
       }
     ],
@@ -294,7 +294,7 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 0
+            "statIndex": 2
           }
         ]
       },
@@ -302,7 +302,7 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 1
+            "statIndex": 0
           }
         ]
       }
@@ -553,7 +553,7 @@
         "sources": [
           {
             "inputIndex": 1,
-            "statIndex": 0
+            "statIndex": 1
           }
         ]
       },
@@ -573,7 +573,7 @@
     "outputMass": 1400000,
     "inputs": [
       {
-        "itemId": 10010,
+        "itemId": 10004,
         "quantity": 300
       },
       {
@@ -586,7 +586,7 @@
         "sources": [
           {
             "inputIndex": 0,
-            "statIndex": 1
+            "statIndex": 0
           },
           {
             "inputIndex": 1,

package/src/derivation/capabilities.ts

@@ -6,7 +6,7 @@ export function computeShipHullCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const statSum = stats.strength + stats.hardness + stats.saturation
+    const statSum = stats.strength + stats.hardness + stats.cohesion
     const exponent = statSum / 2997.0
     return {
         hullmass: computeBaseHullmass(stats),
@@ -121,12 +121,12 @@ export function computeHaulerCapabilities(stats: Record<string, number>): {
     drain: number
 } {
     const resonance = stats.resonance
-    const conductivity = stats.conductivity
+    const plasticity = stats.plasticity
     const reflectivity = stats.reflectivity
 
     return {
         capacity: Math.max(1, 1 + Math.floor(resonance / 400)),
-        efficiency: 2000 + conductivity * 6,
+        efficiency: 2000 + plasticity * 6,
         drain: Math.max(3, 15 - Math.floor(reflectivity / 80)),
     }
 }
@@ -140,9 +140,9 @@ export function computeStorageCapabilities(
     const strength = stats.strength
     const density = stats.density
     const hardness = stats.hardness
-    const saturation = stats.saturation
+    const cohesion = stats.cohesion
 
-    const statSum = strength + density + hardness + saturation
+    const statSum = strength + density + hardness + cohesion
     const capacityBonus = Math.floor(
         (baseCapacity * (10 + Math.floor((statSum * 10) / 2997))) / 100
     )
@@ -201,15 +201,15 @@ export function computeBaseCapacity(itemId: number, stats: Record<string, number
 export function computeWarpCapabilities(stats: Record<string, number>): {
     range: number
 } {
-    const res = stats.resonance
-    return {range: 100 + res * 3}
+    const resonance = stats.resonance
+    return {range: 100 + resonance * 3}
 }
 
 export function computeWarehouseHullCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const statSum = stats.strength + stats.hardness + stats.saturation
+    const statSum = stats.strength + stats.hardness + stats.cohesion
     const exponent = statSum / 2997.0
     return {
         hullmass: computeBaseHullmass(stats),
@@ -388,7 +388,7 @@ export function computeContainerCapabilities(stats: Record<string, number>): {
     hullmass: number
     capacity: number
 } {
-    const statSum = stats.strength + stats.hardness + stats.saturation
+    const statSum = stats.strength + stats.hardness + stats.cohesion
     const exponent = statSum / 2997.0
     return {
         hullmass: computeBaseHullmass(stats),
@@ -403,11 +403,11 @@ export function computeContainerT2Capabilities(stats: Record<string, number>): {
     const strength = stats.strength
     const density = stats.density
     const hardness = stats.hardness
-    const saturation = stats.saturation
+    const cohesion = stats.cohesion
 
     const hullmass = 70000 - 50 * density
 
-    const statSum = strength + hardness + saturation
+    const statSum = strength + hardness + cohesion
     const exponent = statSum / 2947
     const capacity = Math.floor(24000000 * 6 ** exponent)
 

package/src/derivation/index.ts

@@ -36,3 +36,12 @@ export type {EffectiveReserveInput} from './reserve-regen'
 
 export * from './stats'
 export * from './crafting'
+
+export {
+    STAR_STEP,
+    MAX_STARS_PER_STAT,
+    MAX_STAR_RATING,
+    starsForStat,
+    starRating,
+    statMagnitude,
+} from './stars'

package/src/derivation/stars.test.ts

@@ -0,0 +1,51 @@
+import {expect, test} from 'bun:test'
+import {
+    MAX_STARS_PER_STAT,
+    MAX_STAR_RATING,
+    starRating,
+    starsForStat,
+    statMagnitude,
+    STAR_STEP,
+} from './stars'
+
+test('starsForStat bands at the 250 boundaries', () => {
+    expect(starsForStat(0)).toBe(0)
+    expect(starsForStat(1)).toBe(0)
+    expect(starsForStat(249)).toBe(0)
+    expect(starsForStat(250)).toBe(1)
+    expect(starsForStat(499)).toBe(1)
+    expect(starsForStat(500)).toBe(2)
+    expect(starsForStat(749)).toBe(2)
+    expect(starsForStat(750)).toBe(3)
+})
+
+test('starsForStat clamps to MAX_STARS_PER_STAT', () => {
+    expect(starsForStat(999)).toBe(MAX_STARS_PER_STAT)
+    expect(starsForStat(1000)).toBe(MAX_STARS_PER_STAT)
+    expect(starsForStat(10_000)).toBe(MAX_STARS_PER_STAT)
+})
+
+test('starsForStat never goes negative', () => {
+    expect(starsForStat(-50)).toBe(0)
+})
+
+test('starRating sums per-stat stars to a 0-9 grade', () => {
+    expect(starRating(0, 0, 0)).toBe(0)
+    expect(starRating(250, 0, 0)).toBe(1)
+    expect(starRating(750, 750, 750)).toBe(MAX_STAR_RATING)
+    expect(starRating(999, 999, 999)).toBe(MAX_STAR_RATING)
+    expect(starRating(599, 599, 599)).toBe(6)
+    expect(starRating(251, 251, 251)).toBe(3)
+})
+
+test('statMagnitude sums raw values for tiebreaking', () => {
+    expect(statMagnitude(599, 599, 599)).toBe(1797)
+    expect(statMagnitude(251, 251, 251)).toBe(753)
+    expect(statMagnitude(599, 599, 599)).toBeGreaterThan(statMagnitude(251, 251, 251))
+})
+
+test('constants hold their documented values', () => {
+    expect(STAR_STEP).toBe(250)
+    expect(MAX_STARS_PER_STAT).toBe(3)
+    expect(MAX_STAR_RATING).toBe(9)
+})

package/src/derivation/stars.ts

@@ -0,0 +1,15 @@
+export const STAR_STEP = 250
+export const MAX_STARS_PER_STAT = 3
+export const MAX_STAR_RATING = MAX_STARS_PER_STAT * 3
+
+export function starsForStat(value: number): number {
+    return Math.max(0, Math.min(MAX_STARS_PER_STAT, Math.floor(value / STAR_STEP)))
+}
+
+export function starRating(stat1: number, stat2: number, stat3: number): number {
+    return starsForStat(stat1) + starsForStat(stat2) + starsForStat(stat3)
+}
+
+export function statMagnitude(stat1: number, stat2: number, stat3: number): number {
+    return stat1 + stat2 + stat3
+}

package/src/derivation/stats.ts

@@ -73,10 +73,11 @@ const GAS_STATS: StatDefinition[] = [
 
 const REGOLITH_STATS: StatDefinition[] = [
     {
-        key: 'composition',
-        label: 'Composition',
-        abbreviation: 'COM',
-        purpose: 'Mineral/metal mix — drives sensor, chip, and optic crafting quality',
+        key: 'cohesion',
+        label: 'Cohesion',
+        abbreviation: 'COH',
+        purpose:
+            'Binding strength of the loose aggregate; higher cohesion yields more rigid frames and hulls',
     },
     {
         key: 'hardness',

package/src/entities/makers.ts

@@ -75,7 +75,7 @@ const ZERO_HULL_STATS: Record<string, number> = {
     density: 0,
     strength: 0,
     hardness: 0,
-    saturation: 0,
+    cohesion: 0,
 }
 
 export function makeEntity(packedItemId: number, state: EntityStateInput): Entity {

package/src/index-module.ts

@@ -133,6 +133,15 @@ export type {EffectiveReserveInput} from './derivation'
 export {getStatDefinitions, getStatName, resolveStats} from './derivation'
 export type {StatDefinition, NamedStats} from './derivation'
 
+export {
+    STAR_STEP,
+    MAX_STARS_PER_STAT,
+    MAX_STAR_RATING,
+    starsForStat,
+    starRating,
+    statMagnitude,
+} from './derivation'
+
 export {hash, hash512} from './utils/hash'
 
 export {

package/src/nft/buildImmutableData.ts

@@ -224,21 +224,23 @@ export function buildModuleImmutable(
         }
         case MODULE_CRAFTER: {
             const rea = decodeStat(stats, 0)
-            const com = decodeStat(stats, 1)
+            const fin = decodeStat(stats, 1)
             base.push({first: 'reactivity', second: ['uint16', rea]})
-            base.push({first: 'composition', second: ['uint16', com]})
+            base.push({first: 'fineness', second: ['uint16', fin]})
             base.push({first: 'speed', second: ['uint16', computeCrafterSpeed(rea)]})
-            base.push({first: 'drain', second: ['uint16', computeCrafterDrain(com)]})
+            base.push({first: 'drain', second: ['uint16', computeCrafterDrain(fin)]})
             break
         }
         case MODULE_STORAGE: {
             const str = decodeStat(stats, 0)
-            const fin = decodeStat(stats, 1)
-            const sat = decodeStat(stats, 2)
-            const sum = str + fin + sat
+            const den = decodeStat(stats, 1)
+            const hrd = decodeStat(stats, 2)
+            const com = decodeStat(stats, 3)
+            const sum = str + den + hrd + com
             base.push({first: 'strength', second: ['uint16', str]})
-            base.push({first: 'fineness', second: ['uint16', fin]})
-            base.push({first: 'saturation', second: ['uint16', sat]})
+            base.push({first: 'density', second: ['uint16', den]})
+            base.push({first: 'hardness', second: ['uint16', hrd]})
+            base.push({first: 'cohesion', second: ['uint16', com]})
             base.push({
                 first: 'capacity_bonus_pct',
                 second: ['uint16', 10 + Math.floor((sum * 10) / 2997)],
@@ -247,13 +249,13 @@ export function buildModuleImmutable(
         }
         case MODULE_HAULER: {
             const res = decodeStat(stats, 0)
-            const con = decodeStat(stats, 1)
+            const pla = decodeStat(stats, 1)
             const ref = decodeStat(stats, 2)
             base.push({first: 'resonance', second: ['uint16', res]})
-            base.push({first: 'conductivity', second: ['uint16', con]})
+            base.push({first: 'plasticity', second: ['uint16', pla]})
             base.push({first: 'reflectivity', second: ['uint16', ref]})
             base.push({first: 'capacity', second: ['uint8', computeHaulerCapacity(res)]})
-            base.push({first: 'efficiency', second: ['uint16', computeHaulerEfficiency(con)]})
+            base.push({first: 'efficiency', second: ['uint16', computeHaulerEfficiency(pla)]})
             base.push({first: 'drain', second: ['uint16', computeHaulerDrain(ref)]})
             break
         }

package/src/nft/description.ts

@@ -162,9 +162,9 @@ export function formatModuleLine(slot: number, itemId: number, stats: bigint): s
         }
         case MODULE_HAULER: {
             const res = decodeStat(stats, 0)
-            const con = decodeStat(stats, 1)
+            const pla = decodeStat(stats, 1)
             const ref = decodeStat(stats, 2)
-            out += `  Capacity ${computeHaulerCapacity(res)}  Efficiency ${computeHaulerEfficiency(con)}  Drain ${computeHaulerDrain(ref)}`
+            out += `  Capacity ${computeHaulerCapacity(res)}  Efficiency ${computeHaulerEfficiency(pla)}  Drain ${computeHaulerDrain(ref)}`
             break
         }
         case MODULE_WARP: {

package/src/resolution/resolve-item.ts

@@ -222,8 +222,8 @@ function computeCapabilityGroup(
             const str = stats.strength
             const den = stats.density
             const hrd = stats.hardness
-            const sat = stats.saturation
-            const statSum = str + den + hrd + sat
+            const com = stats.cohesion
+            const statSum = str + den + hrd + com
             const pct = 10 + Math.floor((statSum * 10) / 2997)
             return {capability: 'Storage', attributes: [{label: 'Capacity Bonus', value: pct}]}
         }