@things-factory/station 10.1.41 → 10.1.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/station",
-  "version": "10.1.41",
+  "version": "10.1.44",
   "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.40",
-    "@things-factory/board-service": "^10.1.41",
-    "@things-factory/ops-master": "^10.1.41",
-    "@things-factory/shell": "^10.1.40",
-    "@things-factory/worklist": "^10.1.41",
+    "@things-factory/auth-base": "^10.1.44",
+    "@things-factory/board-service": "^10.1.44",
+    "@things-factory/ops-master": "^10.1.44",
+    "@things-factory/shell": "^10.1.44",
+    "@things-factory/worklist": "^10.1.44",
     "i18next": "^24.2.1"
   },
-  "gitHead": "4f41243edca4c965bc6992a10fb52d75a58fd3a9"
+  "gitHead": "7c95c4e75e155e51c714409e865d96f317232c23"
 }

package/shared/station-axes.d.ts

@@ -1,9 +1,9 @@
-/** The closed set of context axis names a station screen may read. Declared once; see the .js. */
+/** The machine's own context axes — the core. A product adds its own by declaration; see the .js. */
 export const STATION_AXES: readonly 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[]
+/** What is wrong with a product's axis declaration — bad shape, already the machine's, repeated. Empty when right. */
+export function wrongDeclaredAxes(axes?: readonly string[]): 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

@@ -35,10 +35,15 @@
 /*
  * ── 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.
+ * where it is, the task in hand, how many this window, the order at its plainest, and whether it is
+ * paused. The module owns it. Anything else is a product's word and the product declares it — on
+ * the server in `StationProduct.axes`, in the browser with `registerStationAxes`, both from one list
+ * the product keeps. The closed set a screen is checked against is the core and that declaration.
+ *
+ * ── The transitional list is gone (2026-09-24, ruling on moving it) ──────────────────────────
+ * operato-plant's thirty-two words sat here until plant could declare them. Plant declares them now.
+ * Three of them came back to the core instead: `paused.at` · `paused.reason` · `paused.detail`. The
+ * pause ledger is the machine's (3-da condition 4), so the axes that show it are too.
  */
 const STATION_CORE_AXES = [
   'station.equipment',
@@ -63,52 +68,14 @@ const STATION_CORE_AXES = [
   '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',
-  'route.key',
-  'route.steps',
-  'route.stepNumber',
-  'route.stepCount',
-  'route.nextStep',
-  'directive.name',
-  'directive.version',
-  'directive.description',
-  'directive.steps',
-  'directive.stepCount',
-  'operation.name',
-  'operation.description',
-  'operation.duration',
+  'window.tasks',
   'paused.at',
   'paused.reason',
-  'paused.detail',
-  'window.good',
-  'window.scrap',
-  'state.status',
-  'state.knownUntil',
-  'state.reason',
-  'staged.count',
-  'candidates.count',
-  'maintenance.count'
+  'paused.detail'
 ]
 
-const STATION_AXES = [...STATION_CORE_AXES, ...STATION_TRANSITIONAL_AXES]
+/** The machine's own axes. A product's are added to these, never mixed into them. */
+const STATION_AXES = STATION_CORE_AXES
 
 const KNOWN = new Set(STATION_AXES)
 
@@ -117,11 +84,25 @@ function isStationAxis(axis, declared = []) {
   return KNOWN.has(axis) || declared.includes(axis)
 }
 
+/*
+ * What is wrong with a product's axis declaration — **one rule, for the server and the browser.**
+ *
+ * A misspelt axis would pass every screen that reads it and stay blank on the bench; one the machine
+ * already has is two owners of one name; a repeat is harmless but says the list was not read. The
+ * server refuses at boot. The browser has to refuse the same things, or it offers a name the server
+ * will turn away and says nothing (ruling on moving the axes, 2026-09-24).
+ */
+const AXIS_SHAPE = /^[a-z][A-Za-z0-9]*\.[a-z][A-Za-z0-9]*$/
+
+function wrongDeclaredAxes(axes = []) {
+  return axes.filter((axis, at) => !AXIS_SHAPE.test(axis ?? '') || KNOWN.has(axis) || axes.indexOf(axis) !== at)
+}
+
 /*
  * The closest names to one that was not recognised.
  *
  * A screen that says «no such axis» and stops has told the author they are wrong without telling
- * them what is right, and with fifty-five names that is most of the work left undone. One
+ * them what is right, and with dozens of 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, declared = []) {
@@ -139,7 +120,7 @@ function nearestAxes(said, howMany = 3, declared = []) {
     .map(one => one.axis)
 }
 
-/* Levenshtein, two rows. Fifty-five short strings — nothing here needs to be cleverer. */
+/* Levenshtein, two rows. A few dozen short strings — nothing here needs to be cleverer. */
 function distance(a, b) {
   let previous = Array.from({ length: b.length + 1 }, (_, at) => at)
 
@@ -158,6 +139,6 @@ function distance(a, b) {
 
 exports.STATION_AXES = STATION_AXES
 exports.STATION_CORE_AXES = STATION_CORE_AXES
-exports.STATION_TRANSITIONAL_AXES = STATION_TRANSITIONAL_AXES
+exports.wrongDeclaredAxes = wrongDeclaredAxes
 exports.isStationAxis = isStationAxis
 exports.nearestAxes = nearestAxes