@shipload/sdk 2.0.0-rc5 → 2.0.0-rc7

package/src/data/colors.ts

@@ -0,0 +1,28 @@
+import type {ResourceCategory, ResourceTier} from '../types'
+
+export const categoryColors: Record<ResourceCategory, string> = {
+    metal: '#7B8D9E',
+    precious: '#D4A843',
+    gas: '#7EC8E3',
+    mineral: '#B8A9C9',
+    organic: '#6B8E5A',
+}
+
+export const tierColors: Record<ResourceTier, string> = {
+    t1: '#8b8b8b',
+    t2: '#4ade80',
+    t3: '#818cf8',
+    t4: '#c084fc',
+    t5: '#fbbf24',
+}
+
+export const categoryIcons: Record<ResourceCategory, string> = {
+    metal: '⬡',
+    precious: '◈',
+    gas: '◎',
+    mineral: '◇',
+    organic: '❋',
+}
+
+export const componentIcon = '▣'
+export const moduleIcon = '⬢'

package/src/data/items.json

@@ -1,17 +1,17 @@
 [
-    {"id": 26, "name": "Iron", "description": "A versatile metal used in hulls and structures.", "base_price": 125, "mass": 40000, "category": "metal", "tier": "t1", "color": "#B7410E"},
-    {"id": 13, "name": "Aluminum", "description": "A lightweight metal for structural components.", "base_price": 175, "mass": 27000, "category": "metal", "tier": "t2", "color": "#A8B5C2"},
-    {"id": 24, "name": "Chromium", "description": "A hard, corrosion-resistant alloy metal.", "base_price": 350, "mass": 52000, "category": "metal", "tier": "t3", "color": "#D4E6F1"},
-    {"id": 29, "name": "Copper", "description": "A conductive metal for electronics and wiring.", "base_price": 100, "mass": 60000, "category": "precious", "tier": "t1", "color": "#B87333"},
-    {"id": 47, "name": "Silver", "description": "A high-conductivity metal for precision components.", "base_price": 300, "mass": 55000, "category": "precious", "tier": "t2", "color": "#C0C0C0"},
-    {"id": 79, "name": "Gold", "description": "A corrosion-proof metal for advanced electronics.", "base_price": 500, "mass": 70000, "category": "precious", "tier": "t3", "color": "#FFD700"},
-    {"id": 1, "name": "Hydrogen", "description": "A lightweight gas used for fuel cells and propulsion.", "base_price": 50, "mass": 15000, "category": "gas", "tier": "t1", "color": "#7EC8E3"},
-    {"id": 2, "name": "Helium", "description": "An inert noble gas used in energy systems.", "base_price": 75, "mass": 2000, "category": "gas", "tier": "t2", "color": "#F5E6CC"},
-    {"id": 18, "name": "Argon", "description": "A noble gas used in industrial and energy applications.", "base_price": 250, "mass": 8000, "category": "gas", "tier": "t3", "color": "#9B59B6"},
-    {"id": 14, "name": "Silicon", "description": "A semiconductor used in sensors and computing.", "base_price": 150, "mass": 28000, "category": "mineral", "tier": "t1", "color": "#B8A9C9"},
-    {"id": 1000, "name": "Quartz", "description": "A crystalline mineral for sensors and optics.", "base_price": 200, "mass": 35000, "category": "mineral", "tier": "t2", "color": "#E8D5B7"},
-    {"id": 1001, "name": "Sapphire", "description": "A precious crystal for precision instruments.", "base_price": 400, "mass": 45000, "category": "mineral", "tier": "t3", "color": "#0F52BA"},
-    {"id": 6, "name": "Carbon", "description": "A versatile element for life support and coatings.", "base_price": 100, "mass": 12000, "category": "organic", "tier": "t1", "color": "#4A4A4A"},
-    {"id": 1003, "name": "Biomass", "description": "Organic matter for life support systems.", "base_price": 100, "mass": 30000, "category": "organic", "tier": "t2", "color": "#8B4513"},
-    {"id": 1002, "name": "Resin", "description": "A fossilized organic compound for coatings and sealants.", "base_price": 300, "mass": 25000, "category": "organic", "tier": "t3", "color": "#DAA520"}
+    {"id": 26, "name": "Iron", "description": "A versatile metal used in hulls and structures.", "mass": 30000, "category": "metal", "tier": "t1", "color": "#B7410E"},
+    {"id": 13, "name": "Aluminum", "description": "A lightweight metal for structural components.", "mass": 27000, "category": "metal", "tier": "t2", "color": "#A8B5C2"},
+    {"id": 24, "name": "Chromium", "description": "A hard, corrosion-resistant alloy metal.", "mass": 52000, "category": "metal", "tier": "t3", "color": "#D4E6F1"},
+    {"id": 29, "name": "Copper", "description": "A conductive metal for electronics and wiring.", "mass": 40000, "category": "precious", "tier": "t1", "color": "#B87333"},
+    {"id": 47, "name": "Silver", "description": "A high-conductivity metal for precision components.", "mass": 55000, "category": "precious", "tier": "t2", "color": "#C0C0C0"},
+    {"id": 79, "name": "Gold", "description": "A corrosion-proof metal for advanced electronics.", "mass": 70000, "category": "precious", "tier": "t3", "color": "#FFD700"},
+    {"id": 1, "name": "Hydrogen", "description": "A lightweight gas used for fuel cells and propulsion.", "mass": 15000, "category": "gas", "tier": "t1", "color": "#7EC8E3"},
+    {"id": 2, "name": "Helium", "description": "An inert noble gas used in energy systems.", "mass": 2000, "category": "gas", "tier": "t2", "color": "#F5E6CC"},
+    {"id": 18, "name": "Argon", "description": "A noble gas used in industrial and energy applications.", "mass": 8000, "category": "gas", "tier": "t3", "color": "#9B59B6"},
+    {"id": 14, "name": "Silicon", "description": "A semiconductor used in sensors and computing.", "mass": 22000, "category": "mineral", "tier": "t1", "color": "#B8A9C9"},
+    {"id": 1000, "name": "Quartz", "description": "A crystalline mineral for sensors and optics.", "mass": 35000, "category": "mineral", "tier": "t2", "color": "#E8D5B7"},
+    {"id": 1001, "name": "Sapphire", "description": "A precious crystal for precision instruments.", "mass": 45000, "category": "mineral", "tier": "t3", "color": "#0F52BA"},
+    {"id": 6, "name": "Carbon", "description": "A versatile element for life support and coatings.", "mass": 15000, "category": "organic", "tier": "t1", "color": "#4A4A4A"},
+    {"id": 1003, "name": "Biomass", "description": "Organic matter for life support systems.", "mass": 30000, "category": "organic", "tier": "t2", "color": "#8B4513"},
+    {"id": 1002, "name": "Resin", "description": "A fossilized organic compound for coatings and sealants.", "mass": 25000, "category": "organic", "tier": "t3", "color": "#DAA520"}
 ]

package/src/data/recipes.ts

@@ -0,0 +1,351 @@
+import {MODULE_ENGINE, MODULE_GENERATOR, MODULE_EXTRACTOR, MODULE_LOADER, MODULE_CRAFTER, ITEM_ENGINE_T1, ITEM_GENERATOR_T1, ITEM_EXTRACTOR_T1, ITEM_LOADER_T1, ITEM_MANUFACTURING_T1} from '../capabilities/modules'
+import type {ResourceCategory} from '../types'
+
+export {ITEM_ENGINE_T1, ITEM_GENERATOR_T1, ITEM_EXTRACTOR_T1, ITEM_LOADER_T1, ITEM_MANUFACTURING_T1}
+
+export const ITEM_DRILL_SHAFT = 10009
+export const ITEM_EXTRACTION_PROBE = 10010
+export const ITEM_CARGO_ARM = 10011
+export const ITEM_TOOL_BIT = 10012
+export const ITEM_REACTION_CHAMBER = 10013
+
+export const ITEM_HULL_PLATES = 10001
+export const ITEM_CARGO_LINING = 10002
+export const ITEM_CONTAINER_PACKED = 10003
+export const ITEM_THRUSTER_CORE = 10004
+export const ITEM_POWER_CELL = 10005
+export const ITEM_SHIP_T1_PACKED = 10008
+
+export interface RecipeInput {
+	category?: ResourceCategory
+	itemId?: number
+	quantity: number
+}
+
+export interface ComponentStat {
+	key: string
+	source: ResourceCategory
+}
+
+export interface ComponentDefinition {
+	id: number
+	name: string
+	description: string
+	color: string
+	mass: number
+	stats: ComponentStat[]
+	recipe: RecipeInput[]
+	usedIn: {type: 'entity' | 'module'; name: string}[]
+}
+
+export interface EntityRecipe {
+	id: string
+	name: string
+	description: string
+	color: string
+	packedItemId: number
+	recipe: RecipeInput[]
+	stats: {key: string; sourceComponentId: number; sourceStatKey: string}[]
+}
+
+export interface CraftableItem {
+	type: 'component' | 'entity' | 'module'
+	id: number | string
+	name: string
+	description: string
+	color: string
+}
+
+export const components: ComponentDefinition[] = [
+	{
+		id: ITEM_HULL_PLATES,
+		name: 'Hull Plates',
+		description: 'Structural plating formed from metal. Used in hulls, containers, and frames.',
+		color: '#7B8D9E',
+		mass: 50000,
+		stats: [
+			{key: 'strength', source: 'metal'},
+			{key: 'density', source: 'metal'},
+		],
+		recipe: [{category: 'metal', quantity: 15}],
+		usedIn: [{type: 'entity', name: 'Container'}, {type: 'entity', name: 'Ship T1'}],
+	},
+	{
+		id: ITEM_CARGO_LINING,
+		name: 'Cargo Lining',
+		description:
+			'Precision-formed composite lining for cargo storage. Combines precious metal shaping with organic sealing.',
+		color: '#D4A843',
+		mass: 30000,
+		stats: [
+			{key: 'ductility', source: 'precious'},
+			{key: 'purity', source: 'organic'},
+		],
+		recipe: [
+			{category: 'precious', quantity: 6},
+			{category: 'organic', quantity: 14},
+		],
+		usedIn: [{type: 'entity', name: 'Container'}, {type: 'entity', name: 'Ship T1'}],
+	},
+	{
+		id: ITEM_THRUSTER_CORE,
+		name: 'Thruster Core',
+		description: 'High-energy propulsion component formed from volatile gases.',
+		color: '#E86344',
+		mass: 50000,
+		stats: [
+			{key: 'volatility', source: 'gas'},
+			{key: 'thermal', source: 'gas'},
+		],
+		recipe: [{category: 'gas' as ResourceCategory, quantity: 32}],
+		usedIn: [{type: 'module', name: 'Engine Module T1'}],
+	},
+	{
+		id: ITEM_POWER_CELL,
+		name: 'Power Cell',
+		description: 'Crystalline energy storage matrix formed from resonant minerals.',
+		color: '#7B5AE8',
+		mass: 30000,
+		stats: [
+			{key: 'resonance', source: 'mineral'},
+			{key: 'clarity', source: 'mineral'},
+		],
+		recipe: [{category: 'mineral' as ResourceCategory, quantity: 20}],
+		usedIn: [{type: 'module', name: 'Generator Module T1'}],
+	},
+	{
+		id: ITEM_DRILL_SHAFT,
+		name: 'Drill Shaft',
+		description: 'Heavy-duty metal shaft used in extraction equipment.',
+		color: '#7B8D9E',
+		mass: 50000,
+		stats: [
+			{key: 'strength', source: 'metal'},
+			{key: 'tolerance', source: 'metal'},
+		],
+		recipe: [{category: 'metal' as ResourceCategory, quantity: 15}],
+		usedIn: [{type: 'module', name: 'Extractor Module T1'}],
+	},
+	{
+		id: ITEM_EXTRACTION_PROBE,
+		name: 'Extraction Probe',
+		description: 'Precious metal sensor array for deep resource detection.',
+		color: '#D4A843',
+		mass: 30000,
+		stats: [
+			{key: 'conductivity', source: 'precious'},
+			{key: 'reflectivity', source: 'precious'},
+		],
+		recipe: [{category: 'precious' as ResourceCategory, quantity: 10}],
+		usedIn: [{type: 'module', name: 'Extractor Module T1'}],
+	},
+	{
+		id: ITEM_CARGO_ARM,
+		name: 'Cargo Arm',
+		description: 'Flexible organic composite arm for cargo handling.',
+		color: '#6B8E5A',
+		mass: 30000,
+		stats: [
+			{key: 'plasticity', source: 'organic'},
+			{key: 'insulation', source: 'organic'},
+		],
+		recipe: [{category: 'organic' as ResourceCategory, quantity: 32}],
+		usedIn: [{type: 'module', name: 'Loader Module T1'}],
+	},
+	{
+		id: ITEM_TOOL_BIT,
+		name: 'Tool Bit',
+		description: 'Dense mineral cutting head for manufacturing operations.',
+		color: '#B8A9C9',
+		mass: 30000,
+		stats: [
+			{key: 'hardness', source: 'mineral'},
+			{key: 'clarity', source: 'mineral'},
+		],
+		recipe: [{category: 'mineral' as ResourceCategory, quantity: 20}],
+		usedIn: [{type: 'module', name: 'Manufacturing Module T1'}],
+	},
+	{
+		id: ITEM_REACTION_CHAMBER,
+		name: 'Reaction Chamber',
+		description: 'Gas-pressurized vessel for controlled manufacturing reactions.',
+		color: '#7EC8E3',
+		mass: 50000,
+		stats: [
+			{key: 'reactivity', source: 'gas'},
+			{key: 'thermal', source: 'gas'},
+		],
+		recipe: [{category: 'gas' as ResourceCategory, quantity: 32}],
+		usedIn: [{type: 'module', name: 'Manufacturing Module T1'}],
+	},
+]
+
+export const entityRecipes: EntityRecipe[] = [
+	{
+		id: 'container',
+		name: 'Container',
+		description: 'Passive floating cargo storage in space. Towed by ships.',
+		color: '#7B8D9E',
+		packedItemId: ITEM_CONTAINER_PACKED,
+		recipe: [
+			{itemId: ITEM_HULL_PLATES, quantity: 6},
+			{itemId: ITEM_CARGO_LINING, quantity: 2},
+		],
+		stats: [
+			{key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
+			{key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
+			{key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
+			{key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
+		],
+	},
+	{
+		id: 'ship-t1',
+		name: 'Ship T1',
+		description: 'General-purpose vessel with 5 module slots.',
+		color: '#4AE898',
+		packedItemId: ITEM_SHIP_T1_PACKED,
+		recipe: [
+			{itemId: ITEM_HULL_PLATES, quantity: 8},
+			{itemId: ITEM_CARGO_LINING, quantity: 4},
+		],
+		stats: [
+			{key: 'strength', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'strength'},
+			{key: 'density', sourceComponentId: ITEM_HULL_PLATES, sourceStatKey: 'density'},
+			{key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
+			{key: 'purity', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'purity'},
+		],
+	},
+]
+
+export interface ModuleRecipe {
+	id: string
+	name: string
+	description: string
+	color: string
+	itemId: number
+	moduleType: number
+	recipe: RecipeInput[]
+	stats: {key: string; sourceComponentId: number; sourceStatKey: string}[]
+}
+
+export const moduleRecipes: ModuleRecipe[] = [
+	{
+		id: 'engine-t1',
+		name: 'Engine Module T1',
+		description: 'Basic propulsion system. Converts volatile gases into thrust.',
+		color: '#E86344',
+		itemId: ITEM_ENGINE_T1,
+		moduleType: MODULE_ENGINE,
+		recipe: [{itemId: ITEM_THRUSTER_CORE, quantity: 6}],
+		stats: [
+			{key: 'volatility', sourceComponentId: ITEM_THRUSTER_CORE, sourceStatKey: 'volatility'},
+			{key: 'thermal', sourceComponentId: ITEM_THRUSTER_CORE, sourceStatKey: 'thermal'},
+		],
+	},
+	{
+		id: 'generator-t1',
+		name: 'Generator Module T1',
+		description: 'Basic energy system. Stores and recharges energy from resonant minerals.',
+		color: '#7B5AE8',
+		itemId: ITEM_GENERATOR_T1,
+		moduleType: MODULE_GENERATOR,
+		recipe: [{itemId: ITEM_POWER_CELL, quantity: 5}],
+		stats: [
+			{key: 'resonance', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'resonance'},
+			{key: 'clarity', sourceComponentId: ITEM_POWER_CELL, sourceStatKey: 'clarity'},
+		],
+	},
+	{
+		id: 'extractor-t1',
+		name: 'Extractor Module T1',
+		description: 'Basic extraction system. Drills and probes for raw resources.',
+		color: '#7B8D9E',
+		itemId: ITEM_EXTRACTOR_T1,
+		moduleType: MODULE_EXTRACTOR,
+		recipe: [
+			{itemId: ITEM_DRILL_SHAFT, quantity: 4},
+			{itemId: ITEM_EXTRACTION_PROBE, quantity: 3},
+		],
+		stats: [
+			{key: 'strength', sourceComponentId: ITEM_DRILL_SHAFT, sourceStatKey: 'strength'},
+			{key: 'tolerance', sourceComponentId: ITEM_DRILL_SHAFT, sourceStatKey: 'tolerance'},
+			{key: 'reflectivity', sourceComponentId: ITEM_EXTRACTION_PROBE, sourceStatKey: 'reflectivity'},
+			{key: 'conductivity', sourceComponentId: ITEM_EXTRACTION_PROBE, sourceStatKey: 'conductivity'},
+			{key: 'reflectivity_drill', sourceComponentId: ITEM_EXTRACTION_PROBE, sourceStatKey: 'reflectivity'},
+		],
+	},
+	{
+		id: 'loader-t1',
+		name: 'Loader Module T1',
+		description: 'Basic cargo handling system. Loads and unloads cargo with articulated arms.',
+		color: '#6B8E5A',
+		itemId: ITEM_LOADER_T1,
+		moduleType: MODULE_LOADER,
+		recipe: [
+			{itemId: ITEM_CARGO_LINING, quantity: 3},
+			{itemId: ITEM_CARGO_ARM, quantity: 3},
+		],
+		stats: [
+			{key: 'ductility', sourceComponentId: ITEM_CARGO_LINING, sourceStatKey: 'ductility'},
+			{key: 'plasticity', sourceComponentId: ITEM_CARGO_ARM, sourceStatKey: 'plasticity'},
+		],
+	},
+	{
+		id: 'manufacturing-t1',
+		name: 'Manufacturing Module T1',
+		description: 'Basic crafting system. Processes materials using reaction chambers and cutting tools.',
+		color: '#7EC8E3',
+		itemId: ITEM_MANUFACTURING_T1,
+		moduleType: MODULE_CRAFTER,
+		recipe: [
+			{itemId: ITEM_TOOL_BIT, quantity: 3},
+			{itemId: ITEM_REACTION_CHAMBER, quantity: 3},
+		],
+		stats: [
+			{key: 'reactivity', sourceComponentId: ITEM_REACTION_CHAMBER, sourceStatKey: 'reactivity'},
+			{key: 'clarity', sourceComponentId: ITEM_TOOL_BIT, sourceStatKey: 'clarity'},
+		],
+	},
+]
+
+export function getModuleRecipe(id: string): ModuleRecipe | undefined {
+	return moduleRecipes.find((r) => r.id === id)
+}
+
+export function getModuleRecipeByItemId(itemId: number): ModuleRecipe | undefined {
+	return moduleRecipes.find((r) => r.itemId === itemId)
+}
+
+export function getComponentById(id: number): ComponentDefinition | undefined {
+	return components.find((c) => c.id === id)
+}
+
+export function getEntityRecipe(id: string): EntityRecipe | undefined {
+	return entityRecipes.find((r) => r.id === id)
+}
+
+export function getEntityRecipeByItemId(itemId: number): EntityRecipe | undefined {
+	return entityRecipes.find((r) => r.packedItemId === itemId)
+}
+
+export function getAllCraftableItems(): CraftableItem[] {
+	const items: CraftableItem[] = []
+	for (const comp of components) {
+		items.push({type: 'component', id: comp.id, name: comp.name, description: comp.description, color: comp.color})
+	}
+	for (const entity of entityRecipes) {
+		items.push({type: 'entity', id: entity.id, name: entity.name, description: entity.description, color: entity.color})
+	}
+	for (const mod of moduleRecipes) {
+		items.push({type: 'module', id: mod.id, name: mod.name, description: mod.description, color: mod.color})
+	}
+	return items
+}
+
+export function getComponentsForCategory(category: ResourceCategory): ComponentDefinition[] {
+	return components.filter((c) => c.recipe.some((r) => r.category === category))
+}
+
+export function getComponentsForStat(statKey: string): ComponentDefinition[] {
+	return components.filter((c) => c.stats.some((s) => s.key === statKey))
+}

package/src/derivation/crafting.ts

@@ -0,0 +1,142 @@
+import {UInt64} from '@wharfkit/antelope'
+import type {ResourceCategory} from '../types'
+import {
+	entityRecipes,
+	getComponentById,
+	getEntityRecipe,
+	getModuleRecipe,
+	moduleRecipes,
+} from '../data/recipes'
+import {deriveResourceStats} from './stratum'
+
+export interface StackInput {
+	quantity: number
+	stats: Record<string, number>
+}
+
+export interface CategoryStacks {
+	category: ResourceCategory
+	stacks: StackInput[]
+}
+
+export function encodeStats(values: number[]): bigint {
+	let seed = 0n
+	for (let i = 0; i < values.length && i < 6; i++) {
+		seed |= BigInt(values[i] & 0x3ff) << BigInt(i * 10)
+	}
+	return seed
+}
+
+export function decodeStats(seed: bigint, count: number): number[] {
+	const stats: number[] = []
+	for (let i = 0; i < count; i++) {
+		stats.push(Number((seed >> BigInt(i * 10)) & 0x3ffn))
+	}
+	return stats
+}
+
+function mapStatsToKeys(seed: bigint, statDefs: {key: string}[]): Record<string, number> {
+	const values = decodeStats(seed, statDefs.length)
+	const result: Record<string, number> = {}
+	for (let i = 0; i < statDefs.length; i++) {
+		result[statDefs[i].key] = values[i]
+	}
+	return result
+}
+
+export function decodeCraftedItemStats(itemId: number, seed: bigint): Record<string, number> {
+	const comp = getComponentById(itemId)
+	if (comp) return mapStatsToKeys(seed, comp.stats)
+
+	const entityRecipe = entityRecipes.find((r) => r.packedItemId === itemId)
+	if (entityRecipe) return mapStatsToKeys(seed, entityRecipe.stats)
+
+	const moduleRecipe = moduleRecipes.find((r) => r.itemId === itemId)
+	if (moduleRecipe) return mapStatsToKeys(seed, moduleRecipe.stats)
+
+	return {}
+}
+
+export function blendStacks(stacks: StackInput[], statKey: string): number {
+	let totalQty = 0
+	let weightedSum = 0
+	for (const stack of stacks) {
+		const val = stack.stats[statKey] ?? 0
+		weightedSum += val * stack.quantity
+		totalQty += stack.quantity
+	}
+	if (totalQty === 0) return 0
+	return Math.floor(weightedSum / totalQty)
+}
+
+export function computeComponentStats(
+	componentId: number,
+	categoryStacks: CategoryStacks[]
+): {key: string; value: number}[] {
+	const comp = getComponentById(componentId)
+	if (!comp) return []
+
+	return comp.stats.map((statDef) => {
+		const matching = categoryStacks.find((cs) => cs.category === statDef.source)
+		const value = matching ? blendStacks(matching.stacks, statDef.key) : 0
+		return {key: statDef.key, value: Math.max(1, Math.min(999, value))}
+	})
+}
+
+export function blendComponentStacks(
+	stacks: {quantity: number; stats: Record<string, number>}[]
+): Record<string, number> {
+	if (stacks.length === 0) return {}
+	const allKeys = new Set<string>()
+	for (const s of stacks) {
+		for (const k of Object.keys(s.stats)) allKeys.add(k)
+	}
+	const result: Record<string, number> = {}
+	for (const key of allKeys) {
+		result[key] = blendStacks(
+			stacks.map((s) => ({quantity: s.quantity, stats: s.stats})),
+			key
+		)
+	}
+	return result
+}
+
+export function computeEntityStats(
+	entityRecipeId: string,
+	componentStacks: Record<number, {quantity: number; stats: Record<string, number>}[]>
+): {key: string; value: number}[] {
+	const recipe = getEntityRecipe(entityRecipeId) ?? getModuleRecipe(entityRecipeId)
+	if (!recipe) return []
+
+	const blendedByComponent: Record<number, Record<string, number>> = {}
+	for (const [compId, stacks] of Object.entries(componentStacks)) {
+		blendedByComponent[Number(compId)] = blendComponentStacks(stacks)
+	}
+
+	return recipe.stats.map((stat) => {
+		const blended = blendedByComponent[stat.sourceComponentId] ?? {}
+		const value = blended[stat.sourceStatKey] ?? 0
+		return {key: stat.key, value: Math.max(1, Math.min(999, value))}
+	})
+}
+
+function decodeStackStats(itemId: number, seed: UInt64): Record<string, number> {
+	if (itemId >= 10000) {
+		return decodeCraftedItemStats(itemId, BigInt(seed.toString()))
+	}
+	const raw = deriveResourceStats(BigInt(seed.toString()))
+	return {stat1: raw.stat1, stat2: raw.stat2, stat3: raw.stat3}
+}
+
+export function blendCargoStacks(
+	itemId: number,
+	stacks: {quantity: number; seed: UInt64}[]
+): UInt64 {
+	const decoded = stacks.map((s) => ({
+		quantity: s.quantity,
+		stats: decodeStackStats(itemId, s.seed),
+	}))
+	const allKeys = Object.keys(decoded[0]?.stats ?? {})
+	const blended = allKeys.map((key) => Math.max(1, Math.min(999, blendStacks(decoded, key))))
+	return UInt64.from(encodeStats(blended))
+}

package/src/derivation/index.ts

@@ -25,3 +25,4 @@ export {
 } from './resources'
 
 export * from './stats'
+export * from './crafting'