@things-factory/station 10.1.39 → 10.1.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/station",
-  "version": "10.1.39",
+  "version": "10.1.40",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -33,12 +33,12 @@
     "@hatiolab/things-scene": "^10.0.0",
     "@operato/i18n": "^10.0.0",
     "@operato/styles": "^10.0.0",
-    "@things-factory/auth-base": "^10.1.39",
-    "@things-factory/board-service": "^10.1.39",
-    "@things-factory/ops-master": "^10.1.39",
-    "@things-factory/shell": "^10.1.39",
-    "@things-factory/worklist": "^10.1.39",
+    "@things-factory/auth-base": "^10.1.40",
+    "@things-factory/board-service": "^10.1.40",
+    "@things-factory/ops-master": "^10.1.40",
+    "@things-factory/shell": "^10.1.40",
+    "@things-factory/worklist": "^10.1.40",
     "i18next": "^24.2.1"
   },
-  "gitHead": "fe5257ad8995fe7e79275e287f36e95b5fd32d1c"
+  "gitHead": "51c5d804c14ad8fcc6d4707e6ef80c9deede2766"
 }

package/shared/station-axes.d.ts

@@ -1,4 +1,9 @@
 /** The closed set of context axis names a station screen may read. Declared once; see the .js. */
 export const STATION_AXES: readonly string[]
-export function isStationAxis(axis: string): boolean
-export function nearestAxes(said: string, howMany?: number): string[]
+/** The axes any product's bench answers - the module owns them (ADR-0083 ruling ①). */
+export const STATION_CORE_AXES: readonly string[]
+/** operato-plant's own axes, held here until plant declares them itself. */
+export const STATION_TRANSITIONAL_AXES: readonly string[]
+/** `declared` is what the product added in `StationProduct.axes`. */
+export function isStationAxis(axis: string, declared?: readonly string[]): boolean
+export function nearestAxes(said: string, howMany?: number, declared?: readonly string[]): string[]

package/shared/station-axes.js

@@ -32,8 +32,15 @@
  * ──────────────────────────────────────────────────────────────────────────────────────────
  */
 
-const STATION_AXES = [
-  /* Where the operator is standing, and when. */
+/*
+ * ── The core, and what a product adds (ADR-0083 ruling ①, 2026-09-24) ─────────────────────────
+ * The core is what any product's bench answers: where the station stands and when, who scanned in,
+ * where it is, the task in hand, how many this window, and the order at its plainest. The module
+ * owns it. Anything else is a product's word and the product declares it (`StationProduct.axes`);
+ * the closed set a screen is checked against is the core, the transitional list below, and that
+ * declaration.
+ */
+const STATION_CORE_AXES = [
   'station.equipment',
   'station.operation',
   'station.shift',
@@ -44,31 +51,37 @@ const STATION_AXES = [
   'station.problem',
   'station.readAt',
   'station.live',
-
   'location.name',
   'location.type',
   'location.level',
-  'productionLine.name',
-
-  /* Who scanned in. Until this is filled nothing else is attributable. */
   'operator.name',
   'operator.personnelClassIds',
   'operator.scannedAt',
-
-  /* What is being made. */
   'order.name',
-  'order.material',
   'order.quantity',
   'order.uom',
   'order.status',
+  'task.name',
+  'task.since',
+  'window.tasks'
+]
+
+/*
+ * ── Transitional: operato-plant's own words, still held here ─────────────────────────────────
+ * These are a factory's - its line, its directives and routes, good and scrap, its equipment state.
+ * They stay in the module until plant declares them in its own `axes` (ruling ①: taking them out
+ * first would break plant's screens). Until then a second product's authoring tool offers them too,
+ * which the ruling accepts as noise. When plant has moved them this list is empty and goes.
+ */
+const STATION_TRANSITIONAL_AXES = [
+  'productionLine.name',
+  'order.material',
   'order.directive',
   'order.directiveVersion',
   'order.route',
   'materialDefinition.name',
   'materialDefinition.description',
   'materialDefinition.materialClassIds',
-
-  /* How it is made. */
   'route.key',
   'route.steps',
   'route.stepNumber',
@@ -82,34 +95,26 @@ const STATION_AXES = [
   'operation.name',
   'operation.description',
   'operation.duration',
-
-  /* What is happening right now. */
-  'task.name',
-  'task.since',
   'paused.at',
   'paused.reason',
   'paused.detail',
-
-  /* How much, this window. */
   'window.good',
   'window.scrap',
-  'window.tasks',
-
-  /* The equipment's own state. */
   'state.status',
   'state.knownUntil',
   'state.reason',
-
-  /* Counts of things waiting. */
   'staged.count',
   'candidates.count',
   'maintenance.count'
 ]
 
+const STATION_AXES = [...STATION_CORE_AXES, ...STATION_TRANSITIONAL_AXES]
+
 const KNOWN = new Set(STATION_AXES)
 
-function isStationAxis(axis) {
-  return KNOWN.has(axis)
+/** Is this a name a screen may read — the machine's own, or one the product declared. */
+function isStationAxis(axis, declared = []) {
+  return KNOWN.has(axis) || declared.includes(axis)
 }
 
 /*
@@ -119,14 +124,15 @@ function isStationAxis(axis) {
  * them what is right, and with fifty-five names that is most of the work left undone. One
  * character out is the common case, so it is the case worth answering.
  */
-function nearestAxes(said, howMany = 3) {
+function nearestAxes(said, howMany = 3, declared = []) {
   const asked = String(said ?? '').trim().toLowerCase()
 
   if (!asked) {
     return []
   }
 
-  return STATION_AXES.map(axis => ({ axis, far: distance(asked, axis.toLowerCase()) }))
+  /* A product's own axes are the likeliest thing its author meant, so they are in the running. */
+  return [...STATION_AXES, ...declared].map(axis => ({ axis, far: distance(asked, axis.toLowerCase()) }))
     .sort((a, b) => a.far - b.far)
     .slice(0, howMany)
     .filter(one => one.far <= Math.max(3, Math.floor(asked.length / 3)))
@@ -151,5 +157,7 @@ function distance(a, b) {
 }
 
 exports.STATION_AXES = STATION_AXES
+exports.STATION_CORE_AXES = STATION_CORE_AXES
+exports.STATION_TRANSITIONAL_AXES = STATION_TRANSITIONAL_AXES
 exports.isStationAxis = isStationAxis
 exports.nearestAxes = nearestAxes