@things-factory/station 10.1.33

package/README.md

@@ -0,0 +1,124 @@
+# @things-factory/station
+
+현장 화면 저작의 **기계** 한 벌. 제품은 **선언 다섯**을 준다 (ADR-0083).
+
+공장(operato-plant)에서 먼저 섰고, 창고 · 야드 · 에너지가 같은 것을 쓴다. 베끼지 않는다 — 네 벌이
+갈라지면 합칠 수 없다.
+
+## 무엇이 여기 있나
+
+화면 정의와 그 판(spec · draft · layout · thumbnail) · 흐름 모델과 검사 · 배정 · 런타임 바인딩 ·
+저작 결재의 기계(release gate · record · signature)와 그 결재 양식 둘 · 채점표.
+
+**모듈은 제품의 엔티티를 import 하지 않는다.** 시험이 그것을 지킨다
+(`test/station-machine-boundary.test.ts`).
+
+## 제품이 주는 선언 다섯
+
+`declareStationProduct` 를 기동 경로에서 한 번 부른다. 다섯 중 하나라도 비면 **그 자리에서 말한다** —
+기본값은 없다. 기본값이 있으면 창고 화면이 공장의 문을 조용히 내놓거나, 아무것도 안 내놓고
+「이 제품에는 서비스가 없다」로 읽힌다.
+
+| | 무엇 | 왜 제품의 것인가 |
+|---|---|---|
+| 1 | **축** | 화면이 읽을 수 있는 값의 닫힌 목록. 공장은 설비 · 공정, 창고는 로케이션 · 작업 |
+| 2 | **부를 수 있는 문** | 걸음이 부를 수 있는 mutation 의 목록 |
+| 3 | **역할** | 누가 저작하고 누가 서명하나. 결재선이 어디로 가는지 |
+| 4 | **바탕을 읽는 자리** (`readGround`) | 어느 설비 · 누가 왔나 · 지금 무엇을 만드나. 공장은 작업지시와 생산실적, 창고는 작업과 주문 |
+| 5 | **기록을 남기는 자리** (`recordChange`) | 무엇이 바뀌었는지는 기계가 만들고, 그것이 **어느 이력으로 가는지**는 제품이 정한다 |
+
+```ts
+declareStationProduct({
+  product: 'operato-plant',
+  services: STATION_SERVICES,
+  readGround: async (manager, domain, stationName, at) => ({ workCenterName, routeKey, ... }),
+  recordChange: async (manager, domain, what, by) => noteFactChanges(manager, domain, what, { ...by, source: SOURCE_MANUAL })
+})
+```
+
+## 제품마다 무엇을 구성하고, 고객은 무엇을 바꾸나
+
+층이 셋이다. **아래로 갈수록 코드가 줄고 사람이 늘어난다.**
+
+### 1층 · 제품(앱)이 코드로 선언한다
+
+plant · warehouse · yms · ems 가 각자 한 번씩 한다. 기계에 기본값은 없고, 빈 자리가 있으면
+**기동 때 거절한다** — 조용히 빈 화면이 되는 쪽보다 안 서는 쪽이 낫다.
+
+```
+서버   declareStationProduct        축 · 부를 수 있는 문 · 역할 · 바탕을 읽는 자리 · 기록을 남기는 자리
+화면   declareStationClientProduct  바탕 읽기 · 스캔 판정 · 값 펴기 · 타일 목록
+타입   StationSnapshot<Ground>      제품의 바탕 모양. 기계는 들고만 다니고 안을 안 읽는다
+```
+
+### 2층 · 부품
+
+```
+공통 여섯   모듈이 든다. package.json 의 "things-scene" 과 things-scene.config.js 로
+            플랫폼 그물이 걷어 저작면 팔레트에 세운다
+제품 다섯   제품이 짓고 자기 선언으로 건다. 구조를 읽는 것들 — 작업지시 · 정비 · 자재 · 지시서 · 동작
+```
+
+가르는 잣대는 **구조를 읽는가**다. 축 값(누가 · 어디 · 오늘 얼마나)만 읽으면 어느 제품에서나 그대로
+서고, 덩어리를 읽으면 제품의 것이다. 새 부품을 더하는 자리도 여기다.
+
+### 3층 · 고객(설치본)이 코드 없이 한다 — 이것이 이 기능의 본체다
+
+```
+화면 저작    보드에 부품을 놓고 축 이름을 붙인다 (order.name · today.good)
+흐름         단계를 잇고 그 걸음이 부를 문을 고른다
+배정         어느 설비 · 공정 · 경로에 이 화면이 서는가
+발행 승인    통제 문서면 결재를 지나야 현장에 나간다
+스캔 규칙    사번 접두사 · 자릿수 · 라벨 모양 — 코드가 아니라 값
+```
+
+**고객마다 다른 것을 코드에 적으면 고객마다 화면을 새로 만들게 된다.** 사번에 접두사를 붙이는 공장이
+있고 자릿수로 가르는 공장이 있다. 그것을 화면 코드에 적는 순간 이 기능은 no-code 가 아니라 캔버스를
+앞에 세운 우리 코드가 된다. 그래서 규칙을 값으로 두고 화면은 읽기만 한다.
+
+### 아직 안 정해진 것
+
+`act()` 의 **몸통**. 동작 이름 여섯(`start` · `count` · `pause` · `unstage` · `resume` · `finish`)은
+창고에서도 서는 말인데, 그 안은 `startTask({ jobOrderName: … })` 처럼 제품의 인자 이름을 직접 짓는다.
+제품이 그것을 어떻게 갈아 끼우는지가 1층에 아직 없다.
+
+## 배정 축은 표준의 총칭이다
+
+`workCenterName` 이다 — `productionLineName` 이 아니다. 계약이 `WorkCenter` 를
+`ProcessCell` · `ProductionLine` · `ProductionUnit` · `StorageZone` 의 총칭으로 적는다. 갈래를 축 이름에
+박으면 창고 존과 야드 구역이 들어올 자리가 없다. 합집합은 두지 않는다 — 축이 늘 때마다 제품 넷이
+같이 늘기 때문이다 (ADR-0083 결정 5).
+
+## 이 판이 온 자리 (2026-09-20, ADR-0083 걸음 3)
+
+`operato-plant` 에서 **제자리에서 선을 그은 뒤**(걸음 2) 옮겼다. 옮기면서 가르면 깨졌을 때 옮겨서
+깨진 건지 갈라서 깨진 건지 알 수 없다.
+
+```
+서버 기계      26 파일   plant `server/service/station/` 에서
+저작 결재 양식  2 파일   plant `server/activities/` 에서 (ADR-0083 결정 7)
+축·흐름 검사    4 파일   plant `shared/` 에서 — 서버와 브라우저가 같은 파일을 읽는다
+시험          15 파일   124 통과
+낱말표        39 개 키  위에 주인이 있는 13 개는 안 가져왔다(마지막이 이기는 병합이라 남의 화면을 덮는다)
+```
+
+**plant 에 남는 것** — 선언 다섯의 구현(`station-context-service` 등 8 파일) · 컴포저 · 모델러 ·
+현장 화면 페이지 · 씬 컴포넌트.
+
+## 아직 안 온 것
+
+- **클라이언트.** `client/station` 55 파일 6,257 줄. 씬 열하나 중 여섯이 공통이고 다섯이 제품의 것이다.
+  그 확장점의 모양을 UX 레인이 정한다 (ADR-0083 결정 6).
+- **컴포저 · 모델러 화면.** 공용이 되는 저작 화면의 틀을 UX 레인이 본다 (ADR-0083 「열어 둔 것」).
+- **`Reversibility`.** `server/service/station/reversibility.ts` 에 네 값이 있다. 같은 어휘를 plant 의 활동
+  선언 열 개가 쓰고 worklist 가 역할 이름으로 갖고 있다 — 집을 수석 아키텍트가 정한다.
+
+## plant 가 자기 사본을 걷을 때 할 일
+
+발행 · 설치 뒤다. 그 전까지 plant 는 자기 것을 그대로 돌리고 여기 것은 안 부른다.
+
+- 옮긴 26 + 2 + 4 파일과 그 시험 15 개를 지운다
+- 낱말표에서 위 39 개 키를 지운다
+- `required-activities.ts` 에서 저작 결재 둘을 뺀다 — 이 모듈이 스스로 등록한다
+- `deletionChanges` 를 이 모듈에서 가져온다 (`activity-non-working-withdrawal` 도 쓴다)
+- `declareStationProduct` 에 `recordChange` 를 채운다 — 없으면 기동 때 거절한다

package/dist-client/index.d.ts

@@ -0,0 +1,11 @@
+export * from './station/station-tile-registry.js';
+export * from './station/station-palette.js';
+export * from './station/station-board-binding.js';
+export * from './station/station-context.js';
+export * from './station/station-runtime.js';
+export * from './station/station-scene-context.js';
+export * from './station/station-screen-flow.js';
+export * from './station/station-work-runtime.js';
+export * from './station/station-work-scenarios.js';
+export * from './station/task-counts.js';
+export * from './station/scene/index.js';

package/dist-client/index.js

@@ -0,0 +1,13 @@
+export * from './station/station-tile-registry.js';
+export * from './station/station-palette.js';
+export * from './station/station-board-binding.js';
+export * from './station/station-context.js';
+export * from './station/station-runtime.js';
+export * from './station/station-scene-context.js';
+export * from './station/station-screen-flow.js';
+export * from './station/station-work-runtime.js';
+export * from './station/station-work-scenarios.js';
+export * from './station/task-counts.js';
+/* 씬 부품 — 이 import 자체가 `@sceneComponent` 등록을 돈다. 그려지려면 이것이 불려야 한다. */
+export * from './station/scene/index.js';
+//# sourceMappingURL=index.js.map

package/dist-client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAA;AAClD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,kCAAkC,CAAA;AAChD,cAAc,mCAAmC,CAAA;AACjD,cAAc,qCAAqC,CAAA;AACnD,cAAc,0BAA0B,CAAA;AAExC,qEAAqE;AACrE,cAAc,0BAA0B,CAAA","sourcesContent":["export * from './station/station-tile-registry.js'\nexport * from './station/station-palette.js'\nexport * from './station/station-board-binding.js'\nexport * from './station/station-context.js'\nexport * from './station/station-runtime.js'\nexport * from './station/station-scene-context.js'\nexport * from './station/station-screen-flow.js'\nexport * from './station/station-work-runtime.js'\nexport * from './station/station-work-scenarios.js'\nexport * from './station/task-counts.js'\n\n/* 씬 부품 — 이 import 자체가 `@sceneComponent` 등록을 돈다. 그려지려면 이것이 불려야 한다. */\nexport * from './station/scene/index.js'\n"]}

package/dist-client/station/scene/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 보드에서 쓸 현장 컴포넌트들 — 여기서 한 번 부르면 보드 저작면에 나온다.
+ *
+ * 호스트는 이것을 부르기만 하고, 컨텍스트는 `provideStationRuntime` 으로 따로 걸어 준다.
+ */
+import './station-context-scene';
+import './station-counts-scene';
+import './station-field-scene';
+import './station-numpad-scene';
+import './station-who-scene';
+import './station-work-panel-scene';

package/dist-client/station/scene/index.js

@@ -0,0 +1,12 @@
+/**
+ * 보드에서 쓸 현장 컴포넌트들 — 여기서 한 번 부르면 보드 저작면에 나온다.
+ *
+ * 호스트는 이것을 부르기만 하고, 컨텍스트는 `provideStationRuntime` 으로 따로 걸어 준다.
+ */
+import './station-context-scene';
+import './station-counts-scene';
+import './station-field-scene';
+import './station-numpad-scene';
+import './station-who-scene';
+import './station-work-panel-scene';
+//# sourceMappingURL=index.js.map

package/dist-client/station/scene/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../client/station/scene/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,yBAAyB,CAAA;AAChC,OAAO,wBAAwB,CAAA;AAC/B,OAAO,uBAAuB,CAAA;AAC9B,OAAO,wBAAwB,CAAA;AAC/B,OAAO,qBAAqB,CAAA;AAC5B,OAAO,4BAA4B,CAAA","sourcesContent":["/**\n * 보드에서 쓸 현장 컴포넌트들 — 여기서 한 번 부르면 보드 저작면에 나온다.\n *\n * 호스트는 이것을 부르기만 하고, 컨텍스트는 `provideStationRuntime` 으로 따로 걸어 준다.\n */\n\nimport './station-context-scene'\nimport './station-counts-scene'\nimport './station-field-scene'\nimport './station-numpad-scene'\nimport './station-who-scene'\nimport './station-work-panel-scene'\n"]}

package/dist-client/station/scene/station-context-binding.d.ts

@@ -0,0 +1,25 @@
+import type { StationSceneContext } from '../station-scene-context';
+/**
+ * Holding on to the context from inside a component — **shared by two class families.**
+ *
+ * The drawing components descend from `Shape`, the context component from `ServiceComponent`, so
+ * they cannot inherit this from a common parent. It is small enough to hand around instead.
+ *
+ * ── Looked up late, deliberately ───────────────────────────────────────────
+ * The order is fixed and unhelpful: the viewer builds the scene, adding every component, and only
+ * then does the page have a scene to register the context on. Bind once when added and every
+ * component has looked a moment too early. So this looks on every read — a `Map.get` — and starts
+ * the subscription the first time it finds something.
+ */
+export declare class StationContextBinding {
+    private owner;
+    private onChange;
+    private bound?;
+    private unsubscribe?;
+    /** `onChange` fires when the context reports new numbers — redraw, or push new data. */
+    constructor(owner: {
+        root?: any;
+    }, onChange: () => void);
+    get context(): StationSceneContext | undefined;
+    release(): void;
+}

package/dist-client/station/scene/station-context-binding.js

@@ -0,0 +1,39 @@
+import { sceneContextOf } from '../station-scene-context';
+/**
+ * Holding on to the context from inside a component — **shared by two class families.**
+ *
+ * The drawing components descend from `Shape`, the context component from `ServiceComponent`, so
+ * they cannot inherit this from a common parent. It is small enough to hand around instead.
+ *
+ * ── Looked up late, deliberately ───────────────────────────────────────────
+ * The order is fixed and unhelpful: the viewer builds the scene, adding every component, and only
+ * then does the page have a scene to register the context on. Bind once when added and every
+ * component has looked a moment too early. So this looks on every read — a `Map.get` — and starts
+ * the subscription the first time it finds something.
+ */
+export class StationContextBinding {
+    /** `onChange` fires when the context reports new numbers — redraw, or push new data. */
+    constructor(owner, onChange) {
+        this.owner = owner;
+        this.onChange = onChange;
+    }
+    get context() {
+        const found = sceneContextOf(this.owner);
+        if (found !== this.bound) {
+            this.unsubscribe?.();
+            this.bound = found;
+            this.unsubscribe = found?.subscribe(this.onChange);
+            if (found) {
+                /* Newly attached — the caller has stale nothing on screen until it hears once. */
+                this.onChange();
+            }
+        }
+        return this.bound;
+    }
+    release() {
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+        this.bound = undefined;
+    }
+}
+//# sourceMappingURL=station-context-binding.js.map

package/dist-client/station/scene/station-context-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-context-binding.js","sourceRoot":"","sources":["../../../client/station/scene/station-context-binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAqB;IAIhC,wFAAwF;IACxF,YACU,KAAqB,EACrB,QAAoB;QADpB,UAAK,GAAL,KAAK,CAAgB;QACrB,aAAQ,GAAR,QAAQ,CAAY;IAC3B,CAAC;IAEJ,IAAI,OAAO;QACT,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAExC,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;YACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YAClB,IAAI,CAAC,WAAW,GAAG,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAElD,IAAI,KAAK,EAAE,CAAC;gBACV,kFAAkF;gBAClF,IAAI,CAAC,QAAQ,EAAE,CAAA;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;QACpB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;IACxB,CAAC;CACF","sourcesContent":["import type { StationSceneContext } from '../station-scene-context'\nimport { sceneContextOf } from '../station-scene-context'\n\n/**\n * Holding on to the context from inside a component — **shared by two class families.**\n *\n * The drawing components descend from `Shape`, the context component from `ServiceComponent`, so\n * they cannot inherit this from a common parent. It is small enough to hand around instead.\n *\n * ── Looked up late, deliberately ───────────────────────────────────────────\n * The order is fixed and unhelpful: the viewer builds the scene, adding every component, and only\n * then does the page have a scene to register the context on. Bind once when added and every\n * component has looked a moment too early. So this looks on every read — a `Map.get` — and starts\n * the subscription the first time it finds something.\n */\nexport class StationContextBinding {\n  private bound?: StationSceneContext\n  private unsubscribe?: () => void\n\n  /** `onChange` fires when the context reports new numbers — redraw, or push new data. */\n  constructor(\n    private owner: { root?: any },\n    private onChange: () => void\n  ) {}\n\n  get context(): StationSceneContext | undefined {\n    const found = sceneContextOf(this.owner)\n\n    if (found !== this.bound) {\n      this.unsubscribe?.()\n      this.bound = found\n      this.unsubscribe = found?.subscribe(this.onChange)\n\n      if (found) {\n        /* Newly attached — the caller has stale nothing on screen until it hears once. */\n        this.onChange()\n      }\n    }\n\n    return this.bound\n  }\n\n  release() {\n    this.unsubscribe?.()\n    this.unsubscribe = undefined\n    this.bound = undefined\n  }\n}\n"]}

package/dist-client/station/scene/station-context-scene.d.ts

@@ -0,0 +1,28 @@
+import { ComponentNature, ServiceComponent } from '@hatiolab/things-scene';
+/** What the host reads off a board to decide how hard to keep it current. */
+export interface StationRefreshPolicy {
+    everyMs?: number;
+}
+/**
+ * Read the policy straight off the board model, before the scene is built.
+ *
+ * The host needs it at open time and there are no components yet, so this looks at the JSON rather
+ * than at a live component.
+ */
+export declare function stationRefreshPolicyOf(model: any): StationRefreshPolicy;
+export default class StationContextScene extends ServiceComponent {
+    get serviceName(): string;
+    /**
+     * ── Why this is not a data source ────────────────────────────────────────
+     * It published the whole context for a while, so a board could bind through `#station-context`.
+     * That door was **redundant and broken**: redundant because the host already pushes `scene.data`
+     * keyed by component id, so naming a component `directive` hands it the directive and the standard
+     * mapping editor takes it from there; broken because a `ServiceComponent` draws nothing in view
+     * mode, so its `render` never ran, so nothing ever claimed the name or published anything.
+     *
+     * Two ways to do one thing, and the second one silently did nothing. Removed rather than repaired
+     * — the door that works is the framework's own.
+     */
+    render(context: CanvasRenderingContext2D): void;
+    get nature(): ComponentNature;
+}

package/dist-client/station/scene/station-context-scene.js

@@ -0,0 +1,138 @@
+import { __decorate } from "tslib";
+import { ServiceComponent, sceneComponent } from '@hatiolab/things-scene';
+import { stationBindingNames } from '../station-board-binding';
+import { STATION_COLOR } from './station-scene-style';
+import { STATION_SERVICE } from '../station-scene-context';
+/**
+ * On a board · **the data source the whole screen binds off.**
+ *
+ * ── What it is for ─────────────────────────────────────────────────────────
+ * Values reach any component whose id is a context name, and structured branches reach any component
+ * whose id is a branch name (`order`, `directive`, `route`, …). Both work, and both are invisible
+ * while a board is being drawn — nothing on the property panel says such an id means anything, so an
+ * author has to be told, and there are three dozen names.
+ *
+ * This lists them on the canvas while editing, and records in the board model that this board is a
+ * station screen. It also carries the refresh policy, which the host reads off the model when it
+ * opens the board.
+ *
+ * ── What is not here ───────────────────────────────────────────────────────
+ * It is **not** where the context comes from. The page registers that when it opens the board,
+ * present or not. Hanging the context off a component would mean a board drawn without one shows a
+ * screenful of nothing, silently, and a shop-floor screen is the last place that can happen.
+ *
+ * ── Times in `data` are raw ────────────────────────────────────────────────
+ * The object here is the snapshot, so `task.since` is milliseconds. Words come from the label doors
+ * (`station-field`, or an id binding), which run through the app's own time formatting. A board that
+ * wants a readable time takes it from there, not by formatting one here.
+ *
+ * ── Invisible to the operator ──────────────────────────────────────────────
+ * `ServiceComponent` draws an icon in edit mode and nothing in view mode. The author sees it, the
+ * floor does not.
+ */
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: false,
+    properties: [
+        {
+            type: 'checkbox',
+            label: 'list the fields while editing',
+            name: 'showFields',
+            property: 'showFields'
+        },
+        {
+            /*
+             * How often to re-read, in seconds. Empty means only when this tablet does something.
+             *
+             * A policy and not a subscription: the clock belongs to the screen, one for the whole board.
+             * Per-component it would be one timer per label, and deleting the wrong box would stop the
+             * screen updating with nothing to say so.
+             */
+            type: 'number',
+            label: 'refresh every (seconds)',
+            name: 'refreshSeconds',
+            property: 'refreshSeconds'
+        }
+    ]
+};
+/**
+ * Read the policy straight off the board model, before the scene is built.
+ *
+ * The host needs it at open time and there are no components yet, so this looks at the JSON rather
+ * than at a live component.
+ */
+export function stationRefreshPolicyOf(model) {
+    const declared = (model?.components ?? []).find((component) => component?.type === 'station-context');
+    const seconds = Number(declared?.refreshSeconds);
+    return Number.isFinite(seconds) && seconds > 0 ? { everyMs: seconds * 1000 } : {};
+}
+/** What this component registers itself as, so a host can ask whether a board is a station screen. */
+const DECLARATION_SERVICE = `${STATION_SERVICE}-declaration`;
+let StationContextScene = class StationContextScene extends ServiceComponent {
+    get serviceName() {
+        return DECLARATION_SERVICE;
+    }
+    /**
+     * ── Why this is not a data source ────────────────────────────────────────
+     * It published the whole context for a while, so a board could bind through `#station-context`.
+     * That door was **redundant and broken**: redundant because the host already pushes `scene.data`
+     * keyed by component id, so naming a component `directive` hands it the directive and the standard
+     * mapping editor takes it from there; broken because a `ServiceComponent` draws nothing in view
+     * mode, so its `render` never ran, so nothing ever claimed the name or published anything.
+     *
+     * Two ways to do one thing, and the second one silently did nothing. Removed rather than repaired
+     * — the door that works is the framework's own.
+     */
+    render(context) {
+        /* View mode draws the icon and nothing else — the base already returns early there. */
+        super.render(context);
+        const state = this.state;
+        if (this.app?.isViewMode || !state.showFields) {
+            return;
+        }
+        const { left, top, width, height } = state;
+        const names = stationBindingNames();
+        context.save();
+        context.beginPath();
+        context.rect(left, top, width, height);
+        context.clip();
+        context.fillStyle = STATION_COLOR.paper;
+        context.globalAlpha = 0.92;
+        context.fill();
+        context.globalAlpha = 1;
+        context.strokeStyle = STATION_COLOR.action;
+        context.stroke();
+        context.textBaseline = 'top';
+        context.textAlign = 'left';
+        context.fillStyle = STATION_COLOR.action;
+        context.font = 'bold 11px sans-serif';
+        context.fillText('station context — put one of these in a component id', left + 8, top + 8);
+        /*
+         * Down the columns, as many as fit. Truncating is fine and paging is not worth it — the point is
+         * that the names exist and roughly what they look like, not to be a reference card.
+         */
+        const lineHeight = 13;
+        const rows = Math.max(1, Math.floor((height - 30) / lineHeight));
+        const columnWidth = 130;
+        context.font = '10px sans-serif';
+        context.fillStyle = STATION_COLOR.ink;
+        names.forEach((name, index) => {
+            const x = left + 8 + Math.floor(index / rows) * columnWidth;
+            const y = top + 26 + (index % rows) * lineHeight;
+            if (x + columnWidth <= left + width + columnWidth) {
+                context.fillText(name, x, y);
+            }
+        });
+        context.textBaseline = 'alphabetic';
+        context.restore();
+    }
+    get nature() {
+        return NATURE;
+    }
+};
+StationContextScene = __decorate([
+    sceneComponent('station-context')
+], StationContextScene);
+export default StationContextScene;
+//# sourceMappingURL=station-context-scene.js.map

package/dist-client/station/scene/station-context-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-context-scene.js","sourceRoot":"","sources":["../../../client/station/scene/station-context-scene.ts"],"names":[],"mappings":"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","sourcesContent":["import { ComponentNature, ServiceComponent, sceneComponent } from '@hatiolab/things-scene'\n\nimport { stationBindingNames } from '../station-board-binding'\nimport { STATION_COLOR } from './station-scene-style'\nimport { STATION_SERVICE } from '../station-scene-context'\n\n/**\n * On a board · **the data source the whole screen binds off.**\n *\n * ── What it is for ─────────────────────────────────────────────────────────\n * Values reach any component whose id is a context name, and structured branches reach any component\n * whose id is a branch name (`order`, `directive`, `route`, …). Both work, and both are invisible\n * while a board is being drawn — nothing on the property panel says such an id means anything, so an\n * author has to be told, and there are three dozen names.\n *\n * This lists them on the canvas while editing, and records in the board model that this board is a\n * station screen. It also carries the refresh policy, which the host reads off the model when it\n * opens the board.\n *\n * ── What is not here ───────────────────────────────────────────────────────\n * It is **not** where the context comes from. The page registers that when it opens the board,\n * present or not. Hanging the context off a component would mean a board drawn without one shows a\n * screenful of nothing, silently, and a shop-floor screen is the last place that can happen.\n *\n * ── Times in `data` are raw ────────────────────────────────────────────────\n * The object here is the snapshot, so `task.since` is milliseconds. Words come from the label doors\n * (`station-field`, or an id binding), which run through the app's own time formatting. A board that\n * wants a readable time takes it from there, not by formatting one here.\n *\n * ── Invisible to the operator ──────────────────────────────────────────────\n * `ServiceComponent` draws an icon in edit mode and nothing in view mode. The author sees it, the\n * floor does not.\n */\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: false,\n  properties: [\n    {\n      type: 'checkbox',\n      label: 'list the fields while editing',\n      name: 'showFields',\n      property: 'showFields'\n    },\n    {\n      /*\n       * How often to re-read, in seconds. Empty means only when this tablet does something.\n       *\n       * A policy and not a subscription: the clock belongs to the screen, one for the whole board.\n       * Per-component it would be one timer per label, and deleting the wrong box would stop the\n       * screen updating with nothing to say so.\n       */\n      type: 'number',\n      label: 'refresh every (seconds)',\n      name: 'refreshSeconds',\n      property: 'refreshSeconds'\n    }\n  ]\n}\n\n/** What the host reads off a board to decide how hard to keep it current. */\nexport interface StationRefreshPolicy {\n  everyMs?: number\n}\n\n/**\n * Read the policy straight off the board model, before the scene is built.\n *\n * The host needs it at open time and there are no components yet, so this looks at the JSON rather\n * than at a live component.\n */\nexport function stationRefreshPolicyOf(model: any): StationRefreshPolicy {\n  const declared = (model?.components ?? []).find((component: any) => component?.type === 'station-context')\n  const seconds = Number(declared?.refreshSeconds)\n\n  return Number.isFinite(seconds) && seconds > 0 ? { everyMs: seconds * 1000 } : {}\n}\n\n/** What this component registers itself as, so a host can ask whether a board is a station screen. */\nconst DECLARATION_SERVICE = `${STATION_SERVICE}-declaration`\n\n@sceneComponent('station-context')\nexport default class StationContextScene extends ServiceComponent {\n  get serviceName() {\n    return DECLARATION_SERVICE\n  }\n\n  /**\n   * ── Why this is not a data source ────────────────────────────────────────\n   * It published the whole context for a while, so a board could bind through `#station-context`.\n   * That door was **redundant and broken**: redundant because the host already pushes `scene.data`\n   * keyed by component id, so naming a component `directive` hands it the directive and the standard\n   * mapping editor takes it from there; broken because a `ServiceComponent` draws nothing in view\n   * mode, so its `render` never ran, so nothing ever claimed the name or published anything.\n   *\n   * Two ways to do one thing, and the second one silently did nothing. Removed rather than repaired\n   * — the door that works is the framework's own.\n   */\n\n  render(context: CanvasRenderingContext2D) {\n    /* View mode draws the icon and nothing else — the base already returns early there. */\n    super.render(context as any)\n\n    const state: any = this.state\n\n    if ((this as any).app?.isViewMode || !state.showFields) {\n      return\n    }\n\n    const { left, top, width, height } = state\n    const names = stationBindingNames()\n\n    context.save()\n    context.beginPath()\n    context.rect(left, top, width, height)\n    context.clip()\n\n    context.fillStyle = STATION_COLOR.paper\n    context.globalAlpha = 0.92\n    context.fill()\n    context.globalAlpha = 1\n    context.strokeStyle = STATION_COLOR.action\n    context.stroke()\n\n    context.textBaseline = 'top'\n    context.textAlign = 'left'\n    context.fillStyle = STATION_COLOR.action\n    context.font = 'bold 11px sans-serif'\n    context.fillText('station context — put one of these in a component id', left + 8, top + 8)\n\n    /*\n     * Down the columns, as many as fit. Truncating is fine and paging is not worth it — the point is\n     * that the names exist and roughly what they look like, not to be a reference card.\n     */\n    const lineHeight = 13\n    const rows = Math.max(1, Math.floor((height - 30) / lineHeight))\n    const columnWidth = 130\n\n    context.font = '10px sans-serif'\n    context.fillStyle = STATION_COLOR.ink\n\n    names.forEach((name, index) => {\n      const x = left + 8 + Math.floor(index / rows) * columnWidth\n      const y = top + 26 + (index % rows) * lineHeight\n\n      if (x + columnWidth <= left + width + columnWidth) {\n        context.fillText(name, x, y)\n      }\n    })\n\n    context.textBaseline = 'alphabetic'\n    context.restore()\n  }\n\n  get nature() {\n    return NATURE\n  }\n}\n"]}

package/dist-client/station/scene/station-counts-scene.d.ts

@@ -0,0 +1,6 @@
+import { ComponentNature } from '@hatiolab/things-scene';
+import { StationScene } from './station-scene';
+export default class StationCountsScene extends StationScene {
+    render(context: CanvasRenderingContext2D): void;
+    get nature(): ComponentNature;
+}

package/dist-client/station/scene/station-counts-scene.js

@@ -0,0 +1,51 @@
+import { __decorate } from "tslib";
+import { sceneComponent } from '@hatiolab/things-scene';
+import { STATION_COLOR, drawCard, drawDetached, drawHeading } from './station-scene-style';
+import { StationScene } from './station-scene';
+/**
+ * 보드용 · 오늘 얼마나 나왔나.
+ *
+ * 진척(%)은 그리지 않는다 — 아무도 그 값을 계산하지 않는다(아키텍트 확인, 2026-08-31). 0% 로 그리면
+ * 시작도 안 한 작업으로 보인다.
+ */
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: false,
+    properties: [
+        { type: 'string', label: 'equipment', name: 'equipment', property: 'equipment' },
+        { type: 'string', label: 'label', name: 'label', property: 'label' }
+    ]
+};
+let StationCountsScene = class StationCountsScene extends StationScene {
+    render(context) {
+        const state = this.state;
+        const { left, top, width, height } = state;
+        const snapshot = this.snapshot;
+        if (!snapshot) {
+            drawDetached(context, 'not connected', left, top, width, height);
+            return;
+        }
+        const today = snapshot.today;
+        drawCard(context, left, top, width, height);
+        const y = drawHeading(context, state.label || 'today', left, top, width);
+        const half = width / 2;
+        context.font = 'bold 28px sans-serif';
+        context.fillStyle = STATION_COLOR.good;
+        context.fillText(String(today.good), left + 8, y + 4);
+        context.fillStyle = STATION_COLOR.scrap;
+        context.fillText(String(today.scrap), left + half + 4, y + 4);
+        context.font = '10px sans-serif';
+        context.fillStyle = STATION_COLOR.quiet;
+        context.fillText('good', left + 8, y + 36);
+        context.fillText('scrap', left + half + 4, y + 36);
+    }
+    get nature() {
+        return NATURE;
+    }
+};
+StationCountsScene = __decorate([
+    sceneComponent('station-counts')
+], StationCountsScene);
+export default StationCountsScene;
+//# sourceMappingURL=station-counts-scene.js.map

package/dist-client/station/scene/station-counts-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-counts-scene.js","sourceRoot":"","sources":["../../../client/station/scene/station-counts-scene.ts"],"names":[],"mappings":";AAAA,OAAO,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAExE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE;QAChF,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE;KACrE;CACF,CAAA;AAGc,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,YAAY;IAC1D,MAAM,CAAC,OAAiC;QACtC,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAA;QAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAE9B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;YAChE,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;QAE5B,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAE3C,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QACxE,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;QAEtB,OAAO,CAAC,IAAI,GAAG,sBAAsB,CAAA;QACrC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAA;QACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAErD,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,KAAK,CAAA;QACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAE7D,OAAO,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAChC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,KAAK,CAAA;QACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAA;QAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AAlCoB,kBAAkB;IADtC,cAAc,CAAC,gBAAgB,CAAC;GACZ,kBAAkB,CAkCtC;eAlCoB,kBAAkB","sourcesContent":["import { ComponentNature, sceneComponent } from '@hatiolab/things-scene'\n\nimport { STATION_COLOR, drawCard, drawDetached, drawHeading } from './station-scene-style'\nimport { StationScene } from './station-scene'\n\n/**\n * 보드용 · 오늘 얼마나 나왔나.\n *\n * 진척(%)은 그리지 않는다 — 아무도 그 값을 계산하지 않는다(아키텍트 확인, 2026-08-31). 0% 로 그리면\n * 시작도 안 한 작업으로 보인다.\n */\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: false,\n  properties: [\n    { type: 'string', label: 'equipment', name: 'equipment', property: 'equipment' },\n    { type: 'string', label: 'label', name: 'label', property: 'label' }\n  ]\n}\n\n@sceneComponent('station-counts')\nexport default class StationCountsScene extends StationScene {\n  render(context: CanvasRenderingContext2D) {\n    const state: any = this.state\n    const { left, top, width, height } = state\n    const snapshot = this.snapshot\n\n    if (!snapshot) {\n      drawDetached(context, 'not connected', left, top, width, height)\n      return\n    }\n\n    const today = snapshot.today\n\n    drawCard(context, left, top, width, height)\n\n    const y = drawHeading(context, state.label || 'today', left, top, width)\n    const half = width / 2\n\n    context.font = 'bold 28px sans-serif'\n    context.fillStyle = STATION_COLOR.good\n    context.fillText(String(today.good), left + 8, y + 4)\n\n    context.fillStyle = STATION_COLOR.scrap\n    context.fillText(String(today.scrap), left + half + 4, y + 4)\n\n    context.font = '10px sans-serif'\n    context.fillStyle = STATION_COLOR.quiet\n    context.fillText('good', left + 8, y + 36)\n    context.fillText('scrap', left + half + 4, y + 36)\n  }\n\n  get nature() {\n    return NATURE\n  }\n}\n"]}

package/dist-client/station/scene/station-field-scene.d.ts

@@ -0,0 +1,6 @@
+import { ComponentNature } from '@hatiolab/things-scene';
+import { StationScene } from './station-scene';
+export default class StationFieldScene extends StationScene {
+    render(context: CanvasRenderingContext2D): void;
+    get nature(): ComponentNature;
+}

package/dist-client/station/scene/station-field-scene.js

@@ -0,0 +1,89 @@
+import { __decorate } from "tslib";
+import { sceneComponent } from '@hatiolab/things-scene';
+import { stationBindingNames } from '../station-board-binding';
+import { STATION_COLOR, drawDetached, withinBox } from './station-scene-style';
+import { StationScene } from './station-scene';
+/**
+ * On a board · one thing from the context, **chosen from a list.**
+ *
+ * ── Why this exists at all ─────────────────────────────────────────────────
+ * Values already reach any plain text component whose id is a context name — set the id to
+ * `order.name` and the job order appears. That works, and it is also magic: nothing on the property
+ * panel says that particular id means anything, so an author has to be told, and a typo is
+ * indistinguishable from a name that was never offered.
+ *
+ * This component takes the same names and makes them a **dropdown**. The list comes out of
+ * `stationBindingNames()`, so it cannot drift from what is actually pushed. An author drops one of
+ * these, opens the field list, and reads what a station can tell them.
+ *
+ * The magic id still works. It is the shorter path for someone who knows the names, and drawing a
+ * whole line map out of these boxes would be tedious. This is the path for someone who does not.
+ *
+ * ── It shows the name while being drawn ────────────────────────────────────
+ * There is no runtime in the board modeller, so in edit mode this draws the field name where the
+ * value will be. An empty box during authoring is how a board ends up shipped with a field nobody
+ * ever bound.
+ */
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: false,
+    properties: [
+        {
+            type: 'select',
+            label: 'field',
+            name: 'field',
+            /* Straight out of the projection — a name here that is not pushed cannot happen. */
+            property: { options: stationBindingNames() }
+        },
+        { type: 'string', label: 'label', name: 'label', property: 'label' },
+        { type: 'number', label: 'text size', name: 'valueSize', property: 'valueSize' }
+    ]
+};
+let StationFieldScene = class StationFieldScene extends StationScene {
+    render(context) {
+        const state = this.state;
+        const { left, top, width, height } = state;
+        const field = String(state.field || '');
+        if (!field) {
+            /* Nothing chosen yet. Say which box it is, so the author can find it on a busy board. */
+            drawDetached(context, 'pick a field', left, top, width, height);
+            return;
+        }
+        const bound = this.context;
+        withinBox(context, left, top, width, height, () => {
+            /*
+             * The caption. Falls back to the field name rather than to nothing — a bare number on a
+             * shop-floor screen is the thing operators most often read as the wrong quantity.
+             */
+            context.textBaseline = 'top';
+            context.textAlign = 'left';
+            context.fillStyle = STATION_COLOR.quiet;
+            context.font = 'bold 11px sans-serif';
+            context.fillText(String(state.label || field), left + 2, top + 2);
+            const size = Number(state.valueSize) > 0 ? Number(state.valueSize) : Math.max(14, Math.min(40, height * 0.45));
+            context.font = `bold ${size}px sans-serif`;
+            if (!bound) {
+                /*
+                 * No context: the modeller, or a screen that has not attached yet. Draw the name of what
+                 * will land here, greyed — never a zero, which would read as a real count.
+                 */
+                context.fillStyle = STATION_COLOR.line;
+                context.fillText(field, left + 2, top + 18);
+                return;
+            }
+            const value = bound.values[field];
+            context.fillStyle = STATION_COLOR.ink;
+            context.fillText(value === undefined ? '' : String(value), left + 2, top + 18);
+            context.textBaseline = 'alphabetic';
+        });
+    }
+    get nature() {
+        return NATURE;
+    }
+};
+StationFieldScene = __decorate([
+    sceneComponent('station-field')
+], StationFieldScene);
+export default StationFieldScene;
+//# sourceMappingURL=station-field-scene.js.map

package/dist-client/station/scene/station-field-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-field-scene.js","sourceRoot":"","sources":["../../../client/station/scene/station-field-scene.ts"],"names":[],"mappings":"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","sourcesContent":["import { ComponentNature, sceneComponent } from '@hatiolab/things-scene'\n\nimport { stationBindingNames } from '../station-board-binding'\nimport { STATION_COLOR, drawDetached, withinBox } from './station-scene-style'\nimport { StationScene } from './station-scene'\n\n/**\n * On a board · one thing from the context, **chosen from a list.**\n *\n * ── Why this exists at all ─────────────────────────────────────────────────\n * Values already reach any plain text component whose id is a context name — set the id to\n * `order.name` and the job order appears. That works, and it is also magic: nothing on the property\n * panel says that particular id means anything, so an author has to be told, and a typo is\n * indistinguishable from a name that was never offered.\n *\n * This component takes the same names and makes them a **dropdown**. The list comes out of\n * `stationBindingNames()`, so it cannot drift from what is actually pushed. An author drops one of\n * these, opens the field list, and reads what a station can tell them.\n *\n * The magic id still works. It is the shorter path for someone who knows the names, and drawing a\n * whole line map out of these boxes would be tedious. This is the path for someone who does not.\n *\n * ── It shows the name while being drawn ────────────────────────────────────\n * There is no runtime in the board modeller, so in edit mode this draws the field name where the\n * value will be. An empty box during authoring is how a board ends up shipped with a field nobody\n * ever bound.\n */\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: false,\n  properties: [\n    {\n      type: 'select',\n      label: 'field',\n      name: 'field',\n      /* Straight out of the projection — a name here that is not pushed cannot happen. */\n      property: { options: stationBindingNames() }\n    },\n    { type: 'string', label: 'label', name: 'label', property: 'label' },\n    { type: 'number', label: 'text size', name: 'valueSize', property: 'valueSize' }\n  ]\n}\n\n@sceneComponent('station-field')\nexport default class StationFieldScene extends StationScene {\n  render(context: CanvasRenderingContext2D) {\n    const state: any = this.state\n    const { left, top, width, height } = state\n    const field = String(state.field || '')\n\n    if (!field) {\n      /* Nothing chosen yet. Say which box it is, so the author can find it on a busy board. */\n      drawDetached(context, 'pick a field', left, top, width, height)\n      return\n    }\n\n    const bound = this.context\n\n    withinBox(context, left, top, width, height, () => {\n      /*\n       * The caption. Falls back to the field name rather than to nothing — a bare number on a\n       * shop-floor screen is the thing operators most often read as the wrong quantity.\n       */\n      context.textBaseline = 'top'\n      context.textAlign = 'left'\n      context.fillStyle = STATION_COLOR.quiet\n      context.font = 'bold 11px sans-serif'\n      context.fillText(String(state.label || field), left + 2, top + 2)\n\n      const size = Number(state.valueSize) > 0 ? Number(state.valueSize) : Math.max(14, Math.min(40, height * 0.45))\n\n      context.font = `bold ${size}px sans-serif`\n\n      if (!bound) {\n        /*\n         * No context: the modeller, or a screen that has not attached yet. Draw the name of what\n         * will land here, greyed — never a zero, which would read as a real count.\n         */\n        context.fillStyle = STATION_COLOR.line\n        context.fillText(field, left + 2, top + 18)\n        return\n      }\n\n      const value = bound.values[field]\n\n      context.fillStyle = STATION_COLOR.ink\n      context.fillText(value === undefined ? '' : String(value), left + 2, top + 18)\n      context.textBaseline = 'alphabetic'\n    })\n  }\n\n  get nature() {\n    return NATURE\n  }\n}\n"]}