@trace.market/types 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.4.0] - 2026-01-19
+
+### ⚠ BREAKING CHANGES
+- **Transport**: `weight` definition changed from "share (0-1)" to "Total vehicle payload in tonnes". This requires data migration for existing records.
+
+### Features
+- **Process Types**: Added `PyrolysisProcess` and `DistillationProcess`.
+- **ToolInstance**: Added `specs` (flexible map for capacity, material, etc.) and `components` (nested tools) to support complex equipment hierarchies like pyrolysis reactors.
+- **Process**: Added `parameters` to `GenericProcess` for capturing real-time or run-specific data (pressure, speed, etc.).
+- **Icons**: Added icons for new processes (`local_fire_department` for Pyrolysis, `science` for Distillation).
+
 ## [0.3.0] - 2026-01-19
 
 ### ⚠ BREAKING CHANGES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trace.market/types",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "TypeScript type definitions for Trace Market food supply chain data",
   "author": "Trace Market Team",
   "license": "MIT",

package/src/descriptions.json

@@ -340,12 +340,12 @@
         ]
       },
       "weight": {
-        "label": "Share",
-        "description": "Percentage (0-1) of vehicle capacity used by this product - shown as \"Share: X%\"",
+        "label": "Total Payload (t)",
+        "description": "Total payload capacity of the vehicle in tonnes",
         "examples": [
-          "0.25 (25%)",
-          "0.5 (50%)",
-          "1.0 (100%)"
+          "3.5",
+          "24.0",
+          "40.0"
         ]
       },
       "deparetureTime": {
@@ -415,6 +415,10 @@
         "label": "HR",
         "description": "Human resources assigned to this process"
       },
+      "parameters": {
+        "label": "Parameters",
+        "description": "Process-specific operating parameters (pressure, speed, etc.)"
+      },
       "knowHow": {
         "label": "Know-How",
         "description": "Recipe or process instructions - can be full data or token ID reference"
@@ -528,6 +532,34 @@
       }
     }
   },
+  "PyrolysisProcess": {
+    "name": "Pyrolysis",
+    "header": "Thermal decomposition of organic material in the absence of oxygen",
+    "fields": {
+      "toolInstance": {
+        "label": "Reactor System",
+        "description": "Pyrolysis equipment setup"
+      },
+      "knowHow": {
+        "label": "Protocol",
+        "description": "Pyrolysis operating parameters"
+      }
+    }
+  },
+  "DistillationProcess": {
+    "name": "Distillation",
+    "header": "Separation of components based on boiling points",
+    "fields": {
+      "toolInstance": {
+        "label": "Distiller",
+        "description": "Distillation column or reactor"
+      },
+      "knowHow": {
+        "label": "Protocol",
+        "description": "Distillation operating parameters"
+      }
+    }
+  },
   "Facility": {
     "name": "Facility",
     "header": "A physical location where processing occurs - shown on interactive map",
@@ -673,6 +705,19 @@
       "hash": {
         "label": "Hash",
         "description": "Unique hash identifier for the tool"
+      },
+      "specs": {
+        "label": "Specifications",
+        "description": "Technical specifications (material, capacity, pressure, etc.)",
+        "examples": [
+          "Material: Steel",
+          "Max Pressure: 5 bar",
+          "Capacity: 500kg"
+        ]
+      },
+      "components": {
+        "label": "Components",
+        "description": "Sub-components of the tool system (e.g. burners, pumps)"
       }
     }
   },

package/src/descriptions.ts

@@ -234,9 +234,9 @@ export const typeDescriptions: Record<string, TypeDescription> = {
         examples: ['hydrogen', 'electric', 'diesel', 'petrol', 'kerosene'],
       },
       weight: {
-        label: 'Share',
-        description: 'Percentage (0-1) of vehicle capacity used by this product - shown as "Share: X%"',
-        examples: ['0.25 (25%)', '0.5 (50%)', '1.0 (100%)'],
+        label: 'Total Payload (t)',
+        description: 'Total payload capacity of the vehicle in tonnes',
+        examples: ['3.5', '24.0', '40.0'],
       },
       deparetureTime: {
         label: 'Departure Time',
@@ -297,6 +297,10 @@ export const typeDescriptions: Record<string, TypeDescription> = {
         label: 'HR',
         description: 'Human resources assigned to this process',
       },
+      parameters: {
+        label: 'Parameters',
+        description: 'Process-specific operating parameters (pressure, speed, etc.)',
+      },
       knowHow: {
         label: 'Know-How',
         description: 'Recipe or process instructions - can be full data or token ID reference',
@@ -406,6 +410,34 @@ export const typeDescriptions: Record<string, TypeDescription> = {
       },
     },
   },
+  PyrolysisProcess: {
+    name: 'Pyrolysis',
+    header: 'Thermal decomposition of organic material in the absence of oxygen',
+    fields: {
+      toolInstance: {
+        label: 'Reactor System',
+        description: 'Pyrolysis equipment setup',
+      },
+      knowHow: {
+        label: 'Protocol',
+        description: 'Pyrolysis operating parameters',
+      },
+    },
+  },
+  DistillationProcess: {
+    name: 'Distillation',
+    header: 'Separation of components based on boiling points',
+    fields: {
+      toolInstance: {
+        label: 'Distiller',
+        description: 'Distillation column or reactor',
+      },
+      knowHow: {
+        label: 'Protocol',
+        description: 'Distillation operating parameters',
+      },
+    },
+  },
   Facility: {
     name: 'Facility',
     header: 'A physical location where processing occurs - shown on interactive map',
@@ -507,6 +539,15 @@ export const typeDescriptions: Record<string, TypeDescription> = {
         label: 'Hash',
         description: 'Unique hash identifier for the tool',
       },
+      specs: {
+        label: 'Specifications',
+        description: 'Technical specifications (material, capacity, pressure, etc.)',
+        examples: ['Material: Steel', 'Max Pressure: 5 bar', 'Capacity: 500kg'],
+      },
+      components: {
+        label: 'Components',
+        description: 'Sub-components of the tool system (e.g. burners, pumps)',
+      },
     },
   },
   Hr: {
@@ -691,6 +732,8 @@ export function getProcessIcon(processType: string): string {
     milling: 'deblur',
     freezedrying: 'ac_unit',
     harvest: 'agriculture',
+    pyrolysis: 'local_fire_department',
+    distillation: 'science',
   };
   return icons[processType] || 'question_mark';
 }
@@ -708,6 +751,8 @@ export function getProcessLabel(processType: string): string {
     milling: 'Milling',
     freezedrying: 'Freeze-drying',
     harvest: 'Harvesting',
+    pyrolysis: 'Pyrolysis',
+    distillation: 'Distillation',
   };
   return labels[processType] || 'Unknown process';
 }

package/src/index.d.ts

@@ -61,7 +61,9 @@ export type Process =
   | BlendingProcess
   | SaleProcess
   | HarvestProcess
-  | CookingProcess;
+  | CookingProcess
+  | PyrolysisProcess
+  | DistillationProcess;
 
 export interface GenericProcess {
   timestamp: number;
@@ -72,6 +74,7 @@ export interface GenericProcess {
   impacts?: Impact[];
   price?: Price;
   hr?: Hr;
+  parameters?: Record<string, string | number | boolean>; // Flexible process parameters (pressure, speed, etc.)
 }
 
 export interface PrintingProcess extends GenericProcess {
@@ -115,6 +118,18 @@ export interface CookingProcess extends GenericProcess {
   knowHow?: TokenIdOr<KnowHow>;
 }
 
+export interface PyrolysisProcess extends GenericProcess {
+  type: "pyrolysis";
+  toolInstance?: TokenIdOr<ToolInstance>;
+  knowHow?: TokenIdOr<KnowHow>;
+}
+
+export interface DistillationProcess extends GenericProcess {
+  type: "distillation";
+  toolInstance?: TokenIdOr<ToolInstance>;
+  knowHow?: TokenIdOr<KnowHow>;
+}
+
 export interface Price {
   amount: number;
   currency: string;
@@ -139,7 +154,7 @@ export type InputInstance = LocalInputInstance | TransportedInputInstance;
 export interface Transport {
   method: TransportMethod;
   fuelType: "hydrogen" | "electric" | "diesel" | "petrol" | "kerosene";
-  weight: number;
+  weight: number; // Total vehicle payload capacity in tonnes
   deparetureTime: number;
   duration: number;
 }
@@ -200,6 +215,8 @@ export interface ToolInstance {
   ratedPowerKW?: number;
   providerSDomain: string;
   hash: string;
+  specs?: Record<string, string | number | boolean>; // Flexible specs (material, capacity, pressure)
+  components?: TokenIdOr<ToolInstance>[]; // Sub-components (burners, sensors)
 }
 
 export interface Hr {