@fmsim/machine 2.0.0 → 3.0.0-beta.1

package/dist/mcs-carrier-holder.js

@@ -1,96 +1,301 @@
 import { themesColorMap, themesAnimationMap } from '@fmsim/api';
+import JSON5 from 'json5';
+import { Capacity, Holdable, ItemsDataBinding, Model, TRANSFER_SLOT_KEY, figureLegendSourcesChanged, itemTypeEntryOf, itemTypeTableOf, registerFigureCapability, registerFigureLegendResolver } from '@hatiolab/things-scene';
+import { HOLDER_ANCHOR } from '@hatiolab/figure-model';
+import { CARRIER_HOLDER, carrierHolderProperties } from '@fmsim/figure-capabilities';
 import MCSUnit from './mcs-unit.js';
-import { parseIfJsonString } from './utils/data-value';
+import { incomingFromV2 } from './utils/load-address';
 /**
- * Holder.data 변경 감지 시 carrierManager 에 전달할 4 키 묶음 + multiCarriers 배열.
- * 비교 결과 단 하나라도 다르면 carrierManager.update 호출.
- * (데이터 키는 모두 대문자 전제 — 케이스 정규화 없이 직접 읽는다)
+ * A holder's slots outside its layout (common item contract 3.4): every carrier of a holder without a layout stands in
+ * one pile, and a carrier whose address is unknown or wrong stands in the exception area beside the holder.
  */
-const CARRIER_DATA_KEYS = ['CARRIERNAME', 'CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'];
-function multiCarriersChanged(a, b) {
-    var _a, _b;
-    // MULTICARRIERS 값이 JSON 문자열로 올 수 있어 파싱 후 비교. shallow JSON 비교로 충분 —
-    // 각 항목이 4 키 primitive 만 가짐. 빈/누락은 같은 '[]' 직렬화로 동치 취급.
-    return (JSON.stringify((_a = parseIfJsonString(a === null || a === void 0 ? void 0 : a.MULTICARRIERS)) !== null && _a !== void 0 ? _a : []) !==
-        JSON.stringify((_b = parseIfJsonString(b === null || b === void 0 ? void 0 : b.MULTICARRIERS)) !== null && _b !== void 0 ? _b : []));
-}
-export default class MCSCarrierHolder extends MCSUnit {
-    static get properties() {
-        return [
-            ...MCSUnit.properties,
-            {
-                type: 'select',
-                label: 'carrier-legend-name',
-                name: 'carrierLegendName',
-                property: {
-                    options: themesColorMap
-                }
-            },
-            {
-                type: 'select',
-                label: 'carrier-animation-name',
-                name: 'carrierAnimationName',
-                property: {
-                    options: themesAnimationMap
-                }
-            },
-            {
-                type: 'boolean',
-                label: 'show-carrier-text',
-                name: 'showCarrierText'
+export const PILE_SLOT = 'pile';
+export const EXCEPTION_SLOT = 'exception';
+/** Where the exception area starts, past the holder's +X edge: a gap of this much of the holder's width */
+const EXCEPTION_GAP_RATIO = 0.1;
+/** A carrier shown in a pile is this much of its holder's plan, and half its smaller side high (fmsim v2) */
+const PILE_PLAN_RATIO = 0.8;
+const PILE_HEIGHT_RATIO = 0.5;
+/** The properties a carrier holder adds, offering the legends this board has (ADR-0167 decision 11, 미결 1) */
+export const CARRIER_HOLDER_PROPERTIES = carrierHolderProperties({ legends: themesColorMap, animations: themesAnimationMap });
+/**
+ * A holder of MCS carriers, as a mixin over what holds things (`fmsim.CarrierHolder`). What it holds is the common item
+ * contract's: carriers are its items (`_items`), found by their CARRIERNAME in the root (itemById), made, moved between
+ * holders and let go by the one reconcile by id. MCS's part is here: reading the holder data into one record per
+ * carrier, looking its CARRIERTYPE up in the domain's carrier type table (ADR-0155, theme carrier-types), and how a
+ * carrier -- whose size MCS does not say -- is shown.
+ */
+export function CarrierHolder(Base) {
+    return class extends Base {
+        /** Whatever wears this is a carrier holder: the legend resolver finds it up a carrier's parents. */
+        get isCarrierHolder() {
+            return true;
+        }
+        get showOverflow() {
+            return true;
+        }
+        get hierarchy() {
+            return Object.assign(Object.assign({}, super.hierarchy), { components: [] });
+        }
+        // ── items: the holder data is the holder's, the records are worked out from it ─────────────
+        _itemsFromData() {
+            return false;
+        }
+        _keyedById() {
+            return true;
+        }
+        /** A carrier the data moves here from another holder travels for two seconds */
+        itemMoveAnimation() {
+            return { duration: 2000, ease: 'inout' };
+        }
+        _createItemFromRecord(record) {
+            var _a;
+            const { width, height } = this.state;
+            return Model.compile(Object.assign({ id: record.itemId, type: 'Carrier', left: 0, top: 0, width, height }, record.itemState), (_a = this.root) === null || _a === void 0 ? void 0 : _a.app);
+        }
+        /**
+         * One record per carrier the data names, bottom first: MULTICARRIERS in order, then the representative. Without a
+         * layout they all stand in the pile. A carrier is told its own keys and whether to show its text.
+         */
+        carrierRecords(data) {
+            return incomingFromV2(data).map(c => ({
+                slotId: PILE_SLOT,
+                itemId: c.name,
+                itemState: this.carrierStateOf(c.record, c.record === data)
+            }));
+        }
+        /** What a carrier is told: its own keys (the representative's are picked out of the holder data), and its text */
+        carrierStateOf(record, representative) {
+            let data = Object.assign({}, record);
+            if (representative) {
+                data = { CARRIERNAME: record.CARRIERNAME };
+                for (const k of ['CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'])
+                    if (k in record)
+                        data[k] = record[k];
             }
-            // 적층 두께는 carrier 측 (Carrier.added) 에서 자기 default depth 를 결정.
-            // holder 측에는 별도 carrierDepth 속성을 두지 않는다.
-        ];
-    }
-    get showOverflow() {
-        return true;
-    }
-    get hierarchy() {
-        return Object.assign(Object.assign({}, super.hierarchy), { components: [] });
-    }
-    dispose() {
-        var _a, _b;
-        ;
-        (_b = (_a = this.root) === null || _a === void 0 ? void 0 : _a.carrierManager) === null || _b === void 0 ? void 0 : _b.update(this, {}, this.data);
-        super.dispose();
-    }
-    async ready() {
-        super.ready();
-        if (this._hasCarrierData(this.data)) {
-            ;
-            this.root.carrierManager.update(this, this.data || {}, undefined);
+            return { data, showText: !!this.getState('showCarrierText') };
         }
-    }
-    onchangeData(after, before) {
-        const afterData = after.data || {};
-        const beforeData = before.data || {};
-        let changed = false;
-        for (const k of CARRIER_DATA_KEYS) {
-            if (afterData[k] !== beforeData[k]) {
-                changed = true;
-                break;
+        /**
+         * The carrier 2D draws (fmsim v2, a rule of position): the top of the data's stack -- MULTICARRIERS bottom first, the
+         * holder's own CARRIERNAME last -- when the holder holds it, else the last it holds.
+         */
+        get topCarrier() {
+            const items = this._items;
+            const names = incomingFromV2(this.data).map(c => c.name);
+            for (let i = names.length - 1; i >= 0; i--) {
+                const held = items.find(c => c.state.id === names[i]);
+                if (held)
+                    return held;
+            }
+            return items[items.length - 1];
+        }
+        /** The holder's carriers made to be what its data says now. Records the same as last time change nothing */
+        syncCarriers(data) {
+            const records = this.carrierRecords(data);
+            const taken = JSON.stringify(records);
+            if (taken === this._carrierRecordsTaken)
+                return;
+            this._carrierRecordsTaken = taken;
+            this._reconcileItems(records);
+        }
+        async ready() {
+            await super.ready();
+            this.syncCarriers(this.data);
+        }
+        onchange(after, before) {
+            super.onchange(after, before);
+            /* Its size moves its bottom and changes the size a pile shows carriers at: they take its plan, made and seated again. */
+            if ('width' in after || 'height' in after || 'depth' in after) {
+                const { width, height } = this.state;
+                for (const carrier of this._items)
+                    if (width && height)
+                        carrier.set({ width, height });
+                this._carriersSeatedAgain();
+            }
+            /* 이 홀더의 Carrier 들이 물려받는 범례가 바뀌었다: 그 피규어들이 범례를 다시 고른다 (ADR-0166 결정 12) */
+            if ('carrierLegendName' in after || 'carrierAnimationName' in after)
+                figureLegendSourcesChanged(this);
+            if ('showCarrierText' in after || 'slotLayout' in after) {
+                this._carrierRecordsTaken = undefined;
+                this.syncCarriers(this.data);
+                if ('slotLayout' in after)
+                    this._carriersSeatedAgain();
             }
         }
-        if (!changed) {
-            changed = multiCarriersChanged(afterData, beforeData);
+        onchangeData(after, before) {
+            this.syncCarriers(after.data || {});
+            super.onchangeData(after, before);
+        }
+        // ── the domain's item types ────────────────────────────────────────────────
+        /**
+         * A carrier's type (ADR-0155): the code it says (its CARRIERTYPE, trimmed and upper-cased -- doc 01, 6.8), in the
+         * domain's carrier type table the scene was given when it opened. None when the table does not have it, or the scene
+         * was given none.
+         */
+        carrierItemType(carrier) {
+            const table = itemTypeTableOf(this);
+            return (table && itemTypeEntryOf(table, carrier)) || null;
+        }
+        /** A carrier's item type: its code, when the domain's table has it; else null */
+        itemTypeOf(carrier) {
+            var _a, _b;
+            return (_b = (_a = this.carrierItemType(carrier)) === null || _a === void 0 ? void 0 : _a.code) !== null && _b !== void 0 ? _b : null;
+        }
+        /**
+         * A carrier's size in mm, as judged: none. MCS data does not say a carrier's size and a carrier type has none
+         * (ADR-0155 amendment 1 C); a carrier is shown at the size of the place it stands in (itemShownDimsOf).
+         */
+        itemDimsOf(_carrier) {
+            return null;
+        }
+        /**
+         * The size a carrier of unknown size is shown at, in mm (for showing only, never judged). In the pile, most of the
+         * holder's plan and half its smaller side high; elsewhere the box filling its slot, its height shared by the stack.
+         */
+        itemShownDimsOf(_carrier, slot, slotId) {
+            /* Elsewhere outside the layout, a holder that keeps carriers there says (the exception area: LoadLayoutHolder). */
+            if (slotId === PILE_SLOT) {
+                const k = this.mmPerSceneUnit;
+                const { width = 0, height = 0 } = this.state;
+                const w = Math.abs(width) * PILE_PLAN_RATIO;
+                const d = Math.abs(height) * PILE_PLAN_RATIO;
+                return w > 0 && d > 0 ? { width: w * k, depth: d * k, height: Math.min(w, d) * PILE_HEIGHT_RATIO * k } : null;
+            }
+            const layers = Number.isFinite(slot.stackLimit) && slot.stackLimit > 0 ? slot.stackLimit : 1;
+            return Number.isFinite(slot.allowed.width)
+                ? { width: slot.allowed.width, depth: slot.allowed.depth, height: slot.allowed.height / layers }
+                : null;
+        }
+        /** A carrier's size as it is shown, in mm: its own, or the size its slot shows an unknown one at (its seat's) */
+        carrierShownDimsOf(carrier) {
+            var _a, _b;
+            return (_b = (_a = this.itemSeatOf(carrier)) === null || _a === void 0 ? void 0 : _a.dims) !== null && _b !== void 0 ? _b : null;
+        }
+        /** Every carrier made again at the size it is shown at, and every slot seated again */
+        _carriersSeatedAgain() {
+            var _a, _b;
+            const items = this._items;
+            for (const carrier of items)
+                (_b = (_a = carrier._realObject) === null || _a === void 0 ? void 0 : _a.update) === null || _b === void 0 ? void 0 : _b.call(_a);
+            const slots = new Set(items.map(c => c[TRANSFER_SLOT_KEY]));
+            for (const slotId of slots)
+                this._reseatSlot(slotId);
+        }
+        // ── where carriers stand ──────────────────────────────────────────────────
+        /**
+         * Where a holder's carriers rest, in coordinates above the holder's bottom, and whether they stand on it or hang from
+         * it: on the transport surface by default (fmsim v2). A Port, Shelf or Shuttle holds them at its bottom; an OHT hangs
+         * them below.
+         */
+        get carrierRest() {
+            return { height: 30, mount: 'ON' };
+        }
+        /** The pile, and the exception area beside the holder's +X edge. Frames in mm on the holder's own anchor (its bottom) */
+        outsideSlots() {
+            const k = this.mmPerSceneUnit;
+            const { width = 0 } = this.state;
+            const w = Math.abs(width);
+            const rest = this.carrierRest;
+            return [
+                {
+                    id: PILE_SLOT,
+                    anchorId: HOLDER_ANCHOR,
+                    frame: { position: { x: 0, y: rest.height * k, z: 0 }, rotation: 0 },
+                    mount: rest.mount
+                },
+                {
+                    id: EXCEPTION_SLOT,
+                    anchorId: HOLDER_ANCHOR,
+                    frame: {
+                        position: { x: (w / 2 + w * EXCEPTION_GAP_RATIO) * k + this.exceptionHalfWidth, y: 0, z: 0 },
+                        rotation: 0
+                    }
+                }
+            ];
+        }
+        /** Half the width of a carrier in the exception area, in mm: its edge stands past the gap */
+        get exceptionHalfWidth() {
+            return 0;
         }
-        if (changed) {
-            ;
-            this.root.carrierManager.update(this, afterData, beforeData);
+        /**
+         * The holder's own anchor is its bottom's centre: a node on the frame at its 3D's origin (the box centre), half its
+         * 3D's depth down, turned and moved with it. Others by the layer below.
+         */
+        anchorObject3D(anchorId) {
+            var _a;
+            const frame = super.anchorObject3D(anchorId);
+            if (anchorId !== HOLDER_ANCHOR || !frame)
+                return frame;
+            let node = frame.userData.carrierAnchor;
+            if (!node || node.parent !== frame) {
+                node = new frame.constructor();
+                node.name = 'carrier-anchor';
+                frame.add(node);
+                frame.userData.carrierAnchor = node;
+            }
+            node.position.set(0, -(Number((_a = this._realObject) === null || _a === void 0 ? void 0 : _a.effectiveDepth) || 0) / 2, 0);
+            return node;
         }
-        super.onchangeData(after, before);
+    };
+}
+/** fmsim's own carrier holder: an MCS unit that holds things, wearing `fmsim.CarrierHolder`. */
+class MCSCarrierHolder extends CarrierHolder(ItemsDataBinding(Holdable(Capacity(MCSUnit)))) {
+    static get properties() {
+        return [...MCSUnit.properties, ...CARRIER_HOLDER_PROPERTIES];
     }
-    /** data 안에 carrier 정보 (대표 또는 multiCarriers) 가 하나라도 있는지. */
-    _hasCarrierData(data) {
-        if (!data)
-            return false;
-        if (data.CARRIERNAME)
-            return true;
-        const list = parseIfJsonString(data.MULTICARRIERS);
-        if (Array.isArray(list) && list.some((a) => a === null || a === void 0 ? void 0 : a.CARRIERNAME))
-            return true;
-        return false;
+}
+export default MCSCarrierHolder;
+/*
+  The legend a carrier figure shows its tables by (ADR-0166 7, 12; ADR-0167 11): the nearest carrier holder up its
+  parents that chose one for the role -- carrier-legend its carrier legend, carrier-animation its carrier animation --
+  then the board root's same choice; none chosen, no answer (the figure's own table, fmsim's default). Colour and effect
+  only: a carrier figure's thickness is its own fixed table (ADR-0167 12).
+*/
+const ROLE_PROPERTY = {
+    'carrier-legend': 'carrierLegendName',
+    'carrier-animation': 'carrierAnimationName'
+};
+export function carrierHolderLegend({ component, role }) {
+    var _a, _b, _c, _d, _e, _f;
+    const property = ROLE_PROPERTY[role];
+    if (!property)
+        return undefined;
+    let name;
+    for (let at = component === null || component === void 0 ? void 0 : component.parent; at && !name; at = at.parent)
+        if (at.isCarrierHolder)
+            name = (_a = at.state) === null || _a === void 0 ? void 0 : _a[property];
+    name || (name = (_d = (_c = (_b = component === null || component === void 0 ? void 0 : component.root) === null || _b === void 0 ? void 0 : _b.rootModel) === null || _c === void 0 ? void 0 : _c.state) === null || _d === void 0 ? void 0 : _d[property]);
+    if (typeof name !== 'string' || !name)
+        return undefined;
+    let legend = (_f = (_e = component === null || component === void 0 ? void 0 : component.root) === null || _e === void 0 ? void 0 : _e.style) === null || _f === void 0 ? void 0 : _f[name];
+    if (typeof legend === 'string') {
+        try {
+            legend = JSON5.parse(legend);
+        }
+        catch (_g) {
+            return undefined;
+        }
     }
+    return legend && typeof legend === 'object' ? colourAndEffect(legend) : undefined;
+}
+/** A legend as a figure takes it from fmsim: each entry's colour and effect; a colour alone stays the colour; an entry's JSON5 text read. */
+function colourAndEffect(legend) {
+    return Object.fromEntries(Object.entries(legend).map(([code, raw]) => {
+        let entry = raw;
+        if (typeof entry === 'string' && entry.trim().startsWith('{')) {
+            try {
+                entry = JSON5.parse(entry);
+            }
+            catch (_a) {
+                return [code, raw];
+            }
+        }
+        if (!entry || typeof entry !== 'object')
+            return [code, entry];
+        const { color, effect } = entry;
+        return [code, Object.assign(Object.assign({}, (color !== undefined ? { color } : {})), (effect !== undefined ? { effect } : {}))];
+    }));
 }
+registerFigureLegendResolver(carrierHolderLegend);
+registerFigureCapability(Object.assign(Object.assign({}, CARRIER_HOLDER), { properties: CARRIER_HOLDER_PROPERTIES }), base => CarrierHolder(base));
 //# sourceMappingURL=mcs-carrier-holder.js.map

package/dist/mcs-carrier-holder.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcs-carrier-holder.js","sourceRoot":"","sources":["../src/mcs-carrier-holder.ts"],"names":[],"mappings":"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","sourcesContent":["import { themesColorMap, themesAnimationMap } from '@fmsim/api'\nimport MCSUnit from './mcs-unit.js'\nimport { parseIfJsonString } from './utils/data-value'\n\n/**\n * Holder.data 변경 감지 시 carrierManager 에 전달할 4 키 묶음 + multiCarriers 배열.\n * 비교 결과 단 하나라도 다르면 carrierManager.update 호출.\n * (데이터 키는 모두 대문자 전제 — 케이스 정규화 없이 직접 읽는다)\n */\nconst CARRIER_DATA_KEYS = ['CARRIERNAME', 'CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'] as const\n\nfunction multiCarriersChanged(a: any, b: any): boolean {\n  // MULTICARRIERS 값이 JSON 문자열로 올 수 있어 파싱 후 비교. shallow JSON 비교로 충분 —\n  // 각 항목이 4 키 primitive 만 가짐. 빈/누락은 같은 '[]' 직렬화로 동치 취급.\n  return (\n    JSON.stringify(parseIfJsonString(a?.MULTICARRIERS) ?? []) !==\n    JSON.stringify(parseIfJsonString(b?.MULTICARRIERS) ?? [])\n  )\n}\n\nexport default class MCSCarrierHolder extends MCSUnit {\n  static get properties(): any {\n    return [\n      ...MCSUnit.properties,\n      {\n        type: 'select',\n        label: 'carrier-legend-name',\n        name: 'carrierLegendName',\n        property: {\n          options: themesColorMap\n        }\n      },\n      {\n        type: 'select',\n        label: 'carrier-animation-name',\n        name: 'carrierAnimationName',\n        property: {\n          options: themesAnimationMap\n        }\n      },\n      {\n        type: 'boolean',\n        label: 'show-carrier-text',\n        name: 'showCarrierText'\n      }\n      // 적층 두께는 carrier 측 (Carrier.added) 에서 자기 default depth 를 결정.\n      // holder 측에는 별도 carrierDepth 속성을 두지 않는다.\n    ]\n  }\n\n  get showOverflow() {\n    return true\n  }\n\n  get hierarchy() {\n    return {\n      ...super.hierarchy,\n      components: []\n    }\n  }\n\n  dispose(): void {\n    ;(this.root as any)?.carrierManager?.update(this, {}, this.data)\n    super.dispose()\n  }\n\n  async ready() {\n    super.ready()\n\n    if (this._hasCarrierData(this.data)) {\n      ;(this.root as any).carrierManager.update(this, this.data || {}, undefined)\n    }\n  }\n\n  onchangeData(after: Record<string, any>, before: Record<string, any>): void {\n    const afterData = after.data || {}\n    const beforeData = before.data || {}\n\n    let changed = false\n    for (const k of CARRIER_DATA_KEYS) {\n      if (afterData[k] !== beforeData[k]) {\n        changed = true\n        break\n      }\n    }\n    if (!changed) {\n      changed = multiCarriersChanged(afterData, beforeData)\n    }\n\n    if (changed) {\n      ;(this.root as any).carrierManager.update(this, afterData, beforeData)\n    }\n\n    super.onchangeData(after, before)\n  }\n\n  /** data 안에 carrier 정보 (대표 또는 multiCarriers) 가 하나라도 있는지. */\n  private _hasCarrierData(data: any): boolean {\n    if (!data) return false\n    if (data.CARRIERNAME) return true\n    const list = parseIfJsonString(data.MULTICARRIERS)\n    if (Array.isArray(list) && list.some((a: any) => a?.CARRIERNAME)) return true\n    return false\n  }\n}\n"]}
+{"version":3,"file":"mcs-carrier-holder.js","sourceRoot":"","sources":["../src/mcs-carrier-holder.ts"],"names":[],"mappings":"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","sourcesContent":["import { themesColorMap, themesAnimationMap } from '@fmsim/api'\nimport JSON5 from 'json5'\nimport {\n  Capacity,\n  Holdable,\n  ItemsDataBinding,\n  Model,\n  TRANSFER_SLOT_KEY,\n  figureLegendSourcesChanged,\n  itemTypeEntryOf,\n  itemTypeTableOf,\n  registerFigureCapability,\n  registerFigureLegendResolver,\n  type ItemType\n} from '@hatiolab/things-scene'\nimport { HOLDER_ANCHOR, type ItemDims, type ResolvedSlot } from '@hatiolab/figure-model'\nimport { CARRIER_HOLDER, carrierHolderProperties } from '@fmsim/figure-capabilities'\nimport MCSUnit from './mcs-unit.js'\nimport { incomingFromV2 } from './utils/load-address'\n\n/**\n * A holder's slots outside its layout (common item contract 3.4): every carrier of a holder without a layout stands in\n * one pile, and a carrier whose address is unknown or wrong stands in the exception area beside the holder.\n */\nexport const PILE_SLOT = 'pile'\nexport const EXCEPTION_SLOT = 'exception'\n\n/** Where the exception area starts, past the holder's +X edge: a gap of this much of the holder's width */\nconst EXCEPTION_GAP_RATIO = 0.1\n\n/** A carrier shown in a pile is this much of its holder's plan, and half its smaller side high (fmsim v2) */\nconst PILE_PLAN_RATIO = 0.8\nconst PILE_HEIGHT_RATIO = 0.5\n\n/** The record of one carrier the holder's data names: its id, the slot it stands in, what it is told */\nexport interface CarrierRecord {\n  slotId: string\n  itemId: string\n  itemState: { data: Record<string, any>; showText: boolean }\n}\n\n/** The properties a carrier holder adds, offering the legends this board has (ADR-0167 decision 11, 미결 1) */\nexport const CARRIER_HOLDER_PROPERTIES = carrierHolderProperties({ legends: themesColorMap, animations: themesAnimationMap })\n\n/**\n * A holder of MCS carriers, as a mixin over what holds things (`fmsim.CarrierHolder`). What it holds is the common item\n * contract's: carriers are its items (`_items`), found by their CARRIERNAME in the root (itemById), made, moved between\n * holders and let go by the one reconcile by id. MCS's part is here: reading the holder data into one record per\n * carrier, looking its CARRIERTYPE up in the domain's carrier type table (ADR-0155, theme carrier-types), and how a\n * carrier -- whose size MCS does not say -- is shown.\n */\nexport function CarrierHolder<T extends new (...args: any[]) => any>(Base: T) {\n  return class extends Base {\n    /** Whatever wears this is a carrier holder: the legend resolver finds it up a carrier's parents. */\n    get isCarrierHolder(): true {\n      return true\n    }\n\n    /** The records the reconcile took last, as JSON: the same again is not reconciled */\n    _carrierRecordsTaken?: string\n\n    get showOverflow() {\n      return true\n    }\n\n    get hierarchy() {\n      return {\n        ...super.hierarchy,\n        components: []\n      }\n    }\n\n    // ── items: the holder data is the holder's, the records are worked out from it ─────────────\n\n    _itemsFromData(): boolean {\n      return false\n    }\n\n    _keyedById(): boolean {\n      return true\n    }\n\n    /** A carrier the data moves here from another holder travels for two seconds */\n    itemMoveAnimation() {\n      return { duration: 2000, ease: 'inout' }\n    }\n\n    _createItemFromRecord(record: CarrierRecord): any {\n      const { width, height } = (this as any).state\n      return Model.compile(\n        { id: record.itemId, type: 'Carrier', left: 0, top: 0, width, height, ...record.itemState },\n        (this as any).root?.app\n      )\n    }\n\n    /**\n     * One record per carrier the data names, bottom first: MULTICARRIERS in order, then the representative. Without a\n     * layout they all stand in the pile. A carrier is told its own keys and whether to show its text.\n     */\n    carrierRecords(data: Record<string, any> | undefined): CarrierRecord[] {\n      return incomingFromV2(data).map(c => ({\n        slotId: PILE_SLOT,\n        itemId: c.name,\n        itemState: this.carrierStateOf(c.record, c.record === data)\n      }))\n    }\n\n    /** What a carrier is told: its own keys (the representative's are picked out of the holder data), and its text */\n    carrierStateOf(record: Record<string, any>, representative: boolean): CarrierRecord['itemState'] {\n      let data: Record<string, any> = { ...record }\n      if (representative) {\n        data = { CARRIERNAME: record.CARRIERNAME }\n        for (const k of ['CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS']) if (k in record) data[k] = record[k]\n      }\n      return { data, showText: !!(this as any).getState('showCarrierText') }\n    }\n\n    /**\n     * The carrier 2D draws (fmsim v2, a rule of position): the top of the data's stack -- MULTICARRIERS bottom first, the\n     * holder's own CARRIERNAME last -- when the holder holds it, else the last it holds.\n     */\n    get topCarrier(): any {\n      const items: any[] = (this as any)._items\n      const names = incomingFromV2((this as any).data).map(c => c.name)\n      for (let i = names.length - 1; i >= 0; i--) {\n        const held = items.find(c => c.state.id === names[i])\n        if (held) return held\n      }\n      return items[items.length - 1]\n    }\n\n    /** The holder's carriers made to be what its data says now. Records the same as last time change nothing */\n    syncCarriers(data: Record<string, any> | undefined) {\n      const records = this.carrierRecords(data)\n      const taken = JSON.stringify(records)\n      if (taken === this._carrierRecordsTaken) return\n      this._carrierRecordsTaken = taken\n      ;(this as any)._reconcileItems(records)\n    }\n\n    async ready() {\n      await super.ready()\n      this.syncCarriers((this as any).data)\n    }\n\n    onchange(after: Record<string, any>, before: Record<string, any>): void {\n      super.onchange(after, before)\n      /* Its size moves its bottom and changes the size a pile shows carriers at: they take its plan, made and seated again. */\n      if ('width' in after || 'height' in after || 'depth' in after) {\n        const { width, height } = (this as any).state\n        for (const carrier of (this as any)._items) if (width && height) carrier.set({ width, height })\n        this._carriersSeatedAgain()\n      }\n      /* 이 홀더의 Carrier 들이 물려받는 범례가 바뀌었다: 그 피규어들이 범례를 다시 고른다 (ADR-0166 결정 12) */\n      if ('carrierLegendName' in after || 'carrierAnimationName' in after) figureLegendSourcesChanged(this)\n      if ('showCarrierText' in after || 'slotLayout' in after) {\n        this._carrierRecordsTaken = undefined\n        this.syncCarriers((this as any).data)\n        if ('slotLayout' in after) this._carriersSeatedAgain()\n      }\n    }\n\n    onchangeData(after: Record<string, any>, before: Record<string, any>): void {\n      this.syncCarriers(after.data || {})\n      super.onchangeData(after, before)\n    }\n\n    // ── the domain's item types ────────────────────────────────────────────────\n\n    /**\n     * A carrier's type (ADR-0155): the code it says (its CARRIERTYPE, trimmed and upper-cased -- doc 01, 6.8), in the\n     * domain's carrier type table the scene was given when it opened. None when the table does not have it, or the scene\n     * was given none.\n     */\n    carrierItemType(carrier: any): ItemType | null {\n      const table = itemTypeTableOf(this)\n      return (table && itemTypeEntryOf(table, carrier)) || null\n    }\n\n    /** A carrier's item type: its code, when the domain's table has it; else null */\n    itemTypeOf(carrier: any): string | null {\n      return this.carrierItemType(carrier)?.code ?? null\n    }\n\n    /**\n     * A carrier's size in mm, as judged: none. MCS data does not say a carrier's size and a carrier type has none\n     * (ADR-0155 amendment 1 C); a carrier is shown at the size of the place it stands in (itemShownDimsOf).\n     */\n    itemDimsOf(_carrier: any): ItemDims | null {\n      return null\n    }\n\n    /**\n     * The size a carrier of unknown size is shown at, in mm (for showing only, never judged). In the pile, most of the\n     * holder's plan and half its smaller side high; elsewhere the box filling its slot, its height shared by the stack.\n     */\n    itemShownDimsOf(_carrier: any, slot: ResolvedSlot, slotId: string): ItemDims | null {\n      /* Elsewhere outside the layout, a holder that keeps carriers there says (the exception area: LoadLayoutHolder). */\n      if (slotId === PILE_SLOT) {\n        const k = (this as any).mmPerSceneUnit\n        const { width = 0, height = 0 } = (this as any).state\n        const w = Math.abs(width) * PILE_PLAN_RATIO\n        const d = Math.abs(height) * PILE_PLAN_RATIO\n        return w > 0 && d > 0 ? { width: w * k, depth: d * k, height: Math.min(w, d) * PILE_HEIGHT_RATIO * k } : null\n      }\n      const layers = Number.isFinite(slot.stackLimit) && slot.stackLimit > 0 ? slot.stackLimit : 1\n      return Number.isFinite(slot.allowed.width)\n        ? { width: slot.allowed.width, depth: slot.allowed.depth, height: slot.allowed.height / layers }\n        : null\n    }\n\n    /** A carrier's size as it is shown, in mm: its own, or the size its slot shows an unknown one at (its seat's) */\n    carrierShownDimsOf(carrier: any): ItemDims | null {\n      return (this as any).itemSeatOf(carrier)?.dims ?? null\n    }\n\n    /** Every carrier made again at the size it is shown at, and every slot seated again */\n    _carriersSeatedAgain() {\n      const items: any[] = (this as any)._items\n      for (const carrier of items) carrier._realObject?.update?.()\n      const slots = new Set(items.map(c => c[TRANSFER_SLOT_KEY]))\n      for (const slotId of slots) (this as any)._reseatSlot(slotId)\n    }\n\n    // ── where carriers stand ──────────────────────────────────────────────────\n\n    /**\n     * Where a holder's carriers rest, in coordinates above the holder's bottom, and whether they stand on it or hang from\n     * it: on the transport surface by default (fmsim v2). A Port, Shelf or Shuttle holds them at its bottom; an OHT hangs\n     * them below.\n     */\n    get carrierRest(): { height: number; mount: 'ON' | 'HANG' } {\n      return { height: 30, mount: 'ON' }\n    }\n\n    /** The pile, and the exception area beside the holder's +X edge. Frames in mm on the holder's own anchor (its bottom) */\n    outsideSlots() {\n      const k = (this as any).mmPerSceneUnit\n      const { width = 0 } = (this as any).state\n      const w = Math.abs(width)\n      const rest = this.carrierRest\n      return [\n        {\n          id: PILE_SLOT,\n          anchorId: HOLDER_ANCHOR,\n          frame: { position: { x: 0, y: rest.height * k, z: 0 }, rotation: 0 },\n          mount: rest.mount\n        },\n        {\n          id: EXCEPTION_SLOT,\n          anchorId: HOLDER_ANCHOR,\n          frame: {\n            position: { x: (w / 2 + w * EXCEPTION_GAP_RATIO) * k + this.exceptionHalfWidth, y: 0, z: 0 },\n            rotation: 0\n          }\n        }\n      ]\n    }\n\n    /** Half the width of a carrier in the exception area, in mm: its edge stands past the gap */\n    get exceptionHalfWidth(): number {\n      return 0\n    }\n\n    /**\n     * The holder's own anchor is its bottom's centre: a node on the frame at its 3D's origin (the box centre), half its\n     * 3D's depth down, turned and moved with it. Others by the layer below.\n     */\n    anchorObject3D(anchorId: string): any {\n      const frame = super.anchorObject3D(anchorId)\n      if (anchorId !== HOLDER_ANCHOR || !frame) return frame\n      let node = frame.userData.carrierAnchor\n      if (!node || node.parent !== frame) {\n        node = new frame.constructor()\n        node.name = 'carrier-anchor'\n        frame.add(node)\n        frame.userData.carrierAnchor = node\n      }\n      node.position.set(0, -(Number((this as any)._realObject?.effectiveDepth) || 0) / 2, 0)\n      return node\n    }\n  }\n}\n\n/* The mixins of things-scene are typed loosely: the holder is still an MCSUnit. */\ninterface MCSCarrierHolder extends MCSUnit {}\n\n/** fmsim's own carrier holder: an MCS unit that holds things, wearing `fmsim.CarrierHolder`. */\nclass MCSCarrierHolder extends CarrierHolder(ItemsDataBinding(Holdable(Capacity(MCSUnit as any)))) {\n  static get properties(): any {\n    return [...MCSUnit.properties, ...CARRIER_HOLDER_PROPERTIES]\n  }\n}\n\nexport default MCSCarrierHolder\n\n/*\n  The legend a carrier figure shows its tables by (ADR-0166 7, 12; ADR-0167 11): the nearest carrier holder up its\n  parents that chose one for the role -- carrier-legend its carrier legend, carrier-animation its carrier animation --\n  then the board root's same choice; none chosen, no answer (the figure's own table, fmsim's default). Colour and effect\n  only: a carrier figure's thickness is its own fixed table (ADR-0167 12).\n*/\nconst ROLE_PROPERTY: Record<string, string> = {\n  'carrier-legend': 'carrierLegendName',\n  'carrier-animation': 'carrierAnimationName'\n}\n\nexport function carrierHolderLegend({ component, role }: { component: any; role: string }): unknown {\n  const property = ROLE_PROPERTY[role]\n  if (!property) return undefined\n  let name: unknown\n  for (let at = component?.parent; at && !name; at = at.parent) if (at.isCarrierHolder) name = at.state?.[property]\n  name ||= component?.root?.rootModel?.state?.[property]\n  if (typeof name !== 'string' || !name) return undefined\n  let legend = component?.root?.style?.[name]\n  if (typeof legend === 'string') {\n    try {\n      legend = JSON5.parse(legend)\n    } catch {\n      return undefined\n    }\n  }\n  return legend && typeof legend === 'object' ? colourAndEffect(legend) : undefined\n}\n\n/** A legend as a figure takes it from fmsim: each entry's colour and effect; a colour alone stays the colour; an entry's JSON5 text read. */\nfunction colourAndEffect(legend: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(legend).map(([code, raw]) => {\n      let entry = raw\n      if (typeof entry === 'string' && entry.trim().startsWith('{')) {\n        try {\n          entry = JSON5.parse(entry)\n        } catch {\n          return [code, raw]\n        }\n      }\n      if (!entry || typeof entry !== 'object') return [code, entry]\n      const { color, effect } = entry as { color?: unknown; effect?: unknown }\n      return [code, { ...(color !== undefined ? { color } : {}), ...(effect !== undefined ? { effect } : {}) }]\n    })\n  )\n}\n\nregisterFigureLegendResolver(carrierHolderLegend)\nregisterFigureCapability({ ...CARRIER_HOLDER, properties: CARRIER_HOLDER_PROPERTIES as never }, base => CarrierHolder(base) as never)\n"]}

package/dist/oht.js

@@ -12,6 +12,10 @@ let OHT = class OHT extends MCSVehicle {
     static get nature() {
         return NATURE;
     }
+    /** Carriers hang below the OHT's bottom, the gripper's (fmsim v2) */
+    get carrierRest() {
+        return { height: 0, mount: 'HANG' };
+    }
     get auxColor() {
         return 'black';
     }

package/dist/oht.js.map

@@ -1 +1 @@
-{"version":3,"file":"oht.js","sourceRoot":"","sources":["../src/oht.ts"],"names":[],"mappings":";AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,UAAU,MAAM,eAAe,CAAA;AAEtC,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC;CACvC,CAAA;AAED,MAAM,GAAG,GAAG,CAAC,CAAA;AAGE,IAAM,GAAG,GAAT,MAAM,GAAI,SAAQ,UAAU;IACzC,MAAM,KAAK,MAAM;QACf,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,oCAAoC;IACpC,IAAI,iBAAiB;QACnB,OAAO,CAAC,SAAS,CAAC,CAAA;IACpB,CAAC;IAED,iBAAiB;QACf,OAAQ,IAAI,CAAC,IAAY,CAAC,cAAc,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACvE,CAAC;IAED,MAAM,CAAC,GAA6B;QAClC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAE9C,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACxB,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC/B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,WAAY,CAAA;QACjC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACrB,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAEnB,oBAAoB;QACpB,2DAA2D;QAC3D,6CAA6C;QAC7C,yEAAyE;QACzE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAC7B,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;QAErD,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAA;QACpB,GAAG,CAAC,WAAW,GAAG,OAAO,CAAA;QACzB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;QAEvC,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF,CAAA;AApDoB,GAAG;IADvB,cAAc,CAAC,KAAK,CAAC;GACD,GAAG,CAoDvB;eApDoB,GAAG","sourcesContent":["import { Component, ComponentNature, sceneComponent } from '@hatiolab/things-scene'\nimport MCSVehicle from './mcs-vehicle'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [...MCSVehicle.properties]\n}\n\nconst GAP = 2\n\n@sceneComponent('OHT')\nexport default class OHT extends MCSVehicle {\n  static get nature() {\n    return NATURE\n  }\n\n  get auxColor() {\n    return 'black'\n  }\n\n  /** OHT 의 parentObject 는 OHTLine. */\n  get parentObjectTypes(): string[] {\n    return ['OHTLine']\n  }\n\n  getLegendFallback() {\n    return (this.root as any).ohtLegendTheme || super.getLegendFallback()\n  }\n\n  render(ctx: CanvasRenderingContext2D) {\n    var { left, top, width, height } = this.bounds\n\n    ctx.translate(left, top)\n    ctx.beginPath()\n\n    ctx.strokeStyle = this.auxColor\n    ctx.fillStyle = this.statusColor!\n    ctx.lineWidth = 1\n    ctx.lineCap = 'round'\n    ctx.setLineDash([])\n\n    // Performance aware\n    // const radius = Math.round(Math.min(width, height) * 0.1)\n    // ctx.roundRect(0, 0, width, height, radius)\n    // ctx.roundRect(GAP, GAP, width - GAP * 2, height - GAP * 2, radius - 1)\n    ctx.rect(0, 0, width, height)\n    ctx.rect(GAP, GAP, width - GAP * 2, height - GAP * 2)\n\n    ctx.fill()\n    ctx.stroke()\n\n    ctx.beginPath()\n\n    ctx.lineCap = 'butt'\n    ctx.strokeStyle = 'black'\n    ctx.lineWidth = 3\n    ctx.moveTo(width / 2, GAP * 2)\n    ctx.lineTo(width / 2, height - GAP * 2)\n\n    ctx.stroke()\n\n    ctx.translate(-left, -top)\n  }\n}\n"]}
+{"version":3,"file":"oht.js","sourceRoot":"","sources":["../src/oht.ts"],"names":[],"mappings":";AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,UAAU,MAAM,eAAe,CAAA;AAEtC,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC;CACvC,CAAA;AAED,MAAM,GAAG,GAAG,CAAC,CAAA;AAGE,IAAM,GAAG,GAAT,MAAM,GAAI,SAAQ,UAAU;IACzC,MAAM,KAAK,MAAM;QACf,OAAO,MAAM,CAAA;IACf,CAAC;IAED,qEAAqE;IACrE,IAAI,WAAW;QACb,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IACrC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,oCAAoC;IACpC,IAAI,iBAAiB;QACnB,OAAO,CAAC,SAAS,CAAC,CAAA;IACpB,CAAC;IAED,iBAAiB;QACf,OAAQ,IAAI,CAAC,IAAY,CAAC,cAAc,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACvE,CAAC;IAED,MAAM,CAAC,GAA6B;QAClC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAE9C,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACxB,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC/B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,WAAY,CAAA;QACjC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACrB,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAEnB,oBAAoB;QACpB,2DAA2D;QAC3D,6CAA6C;QAC7C,yEAAyE;QACzE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAC7B,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;QAErD,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,GAAG,CAAC,OAAO,GAAG,MAAM,CAAA;QACpB,GAAG,CAAC,WAAW,GAAG,OAAO,CAAA;QACzB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QAC9B,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;QAEvC,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF,CAAA;AAzDoB,GAAG;IADvB,cAAc,CAAC,KAAK,CAAC;GACD,GAAG,CAyDvB;eAzDoB,GAAG","sourcesContent":["import { Component, ComponentNature, sceneComponent } from '@hatiolab/things-scene'\nimport MCSVehicle from './mcs-vehicle'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [...MCSVehicle.properties]\n}\n\nconst GAP = 2\n\n@sceneComponent('OHT')\nexport default class OHT extends MCSVehicle {\n  static get nature() {\n    return NATURE\n  }\n\n  /** Carriers hang below the OHT's bottom, the gripper's (fmsim v2) */\n  get carrierRest(): { height: number; mount: 'ON' | 'HANG' } {\n    return { height: 0, mount: 'HANG' }\n  }\n\n  get auxColor() {\n    return 'black'\n  }\n\n  /** OHT 의 parentObject 는 OHTLine. */\n  get parentObjectTypes(): string[] {\n    return ['OHTLine']\n  }\n\n  getLegendFallback() {\n    return (this.root as any).ohtLegendTheme || super.getLegendFallback()\n  }\n\n  render(ctx: CanvasRenderingContext2D) {\n    var { left, top, width, height } = this.bounds\n\n    ctx.translate(left, top)\n    ctx.beginPath()\n\n    ctx.strokeStyle = this.auxColor\n    ctx.fillStyle = this.statusColor!\n    ctx.lineWidth = 1\n    ctx.lineCap = 'round'\n    ctx.setLineDash([])\n\n    // Performance aware\n    // const radius = Math.round(Math.min(width, height) * 0.1)\n    // ctx.roundRect(0, 0, width, height, radius)\n    // ctx.roundRect(GAP, GAP, width - GAP * 2, height - GAP * 2, radius - 1)\n    ctx.rect(0, 0, width, height)\n    ctx.rect(GAP, GAP, width - GAP * 2, height - GAP * 2)\n\n    ctx.fill()\n    ctx.stroke()\n\n    ctx.beginPath()\n\n    ctx.lineCap = 'butt'\n    ctx.strokeStyle = 'black'\n    ctx.lineWidth = 3\n    ctx.moveTo(width / 2, GAP * 2)\n    ctx.lineTo(width / 2, height - GAP * 2)\n\n    ctx.stroke()\n\n    ctx.translate(-left, -top)\n  }\n}\n"]}

package/dist/port.js

@@ -2,16 +2,21 @@ import { __decorate } from "tslib";
 import { sceneComponent } from '@hatiolab/things-scene';
 import { MCSZoneMixin, MCSZoneMixinProperties } from './features/mcs-zone-mixin';
 import MCSCarrierHolder from './mcs-carrier-holder';
+import { LoadLayoutHolder } from './features/load-layout-holder';
 const NATURE = {
     mutable: false,
     resizable: true,
     rotatable: true,
     properties: [...MCSZoneMixinProperties, ...MCSCarrierHolder.properties]
 };
-let Port = class Port extends MCSZoneMixin(MCSCarrierHolder) {
+let Port = class Port extends LoadLayoutHolder(MCSZoneMixin(MCSCarrierHolder)) {
     static get nature() {
         return NATURE;
     }
+    /** Carriers stand at the Port's bottom (fmsim v2) */
+    get carrierRest() {
+        return { height: 0, mount: 'ON' };
+    }
     get auxColor() {
         return 'black';
     }

package/dist/port.js.map

@@ -1 +1 @@
-{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":";AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,gBAAgB,MAAM,sBAAsB,CAAA;AAEnD,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC,GAAG,sBAAsB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC;CACxE,CAAA;AAGc,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAC9D,MAAM,KAAK,MAAM;QACf,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,iBAAiB;QACf,OAAQ,IAAI,CAAC,IAAY,CAAC,eAAe,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACxE,CAAC;IAED,gEAAgE;IAChE,IAAI,uBAAuB;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,GAA6B;QAClC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAE9C,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC/B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,WAAY,CAAA;QACjC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACrB,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAEnB,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,oBAAoB;QACpB,2DAA2D;QAC3D,kDAAkD;QAClD,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAElC,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;IACd,CAAC;CACF,CAAA;AArCoB,IAAI;IADxB,cAAc,CAAC,MAAM,CAAC;GACF,IAAI,CAqCxB;eArCoB,IAAI","sourcesContent":["import { Component, ComponentNature, sceneComponent } from '@hatiolab/things-scene'\nimport { MCSZoneMixin, MCSZoneMixinProperties } from './features/mcs-zone-mixin'\nimport MCSCarrierHolder from './mcs-carrier-holder'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [...MCSZoneMixinProperties, ...MCSCarrierHolder.properties]\n}\n\n@sceneComponent('Port')\nexport default class Port extends MCSZoneMixin(MCSCarrierHolder) {\n  static get nature() {\n    return NATURE\n  }\n\n  get auxColor() {\n    return 'black'\n  }\n\n  getLegendFallback() {\n    return (this.root as any).portLegendTheme || super.getLegendFallback()\n  }\n\n  /** Port 는 후보가 매우 많아 부모 머신 없이는 id 리스트를 조회하지 않는다 (machine 필수). */\n  get idLookupRequiresMachine() {\n    return true\n  }\n\n  render(ctx: CanvasRenderingContext2D) {\n    var { left, top, width, height } = this.bounds\n\n    ctx.strokeStyle = this.auxColor\n    ctx.fillStyle = this.statusColor!\n    ctx.lineWidth = 1\n    ctx.lineCap = 'round'\n    ctx.setLineDash([])\n\n    ctx.beginPath()\n\n    // Performance aware\n    // const radius = Math.round(Math.min(width, height) * 0.1)\n    // ctx.roundRect(left, top, width, height, radius)\n    ctx.rect(left, top, width, height)\n\n    ctx.fill()\n    ctx.stroke()\n  }\n}\n"]}
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":";AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,gBAAgB,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAEhE,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC,GAAG,sBAAsB,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC;CACxE,CAAA;AAGc,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,gBAAgB,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAChF,MAAM,KAAK,MAAM;QACf,OAAO,MAAM,CAAA;IACf,CAAC;IAED,qDAAqD;IACrD,IAAI,WAAW;QACb,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACnC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,iBAAiB;QACf,OAAQ,IAAI,CAAC,IAAY,CAAC,eAAe,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACxE,CAAC;IAED,gEAAgE;IAChE,IAAI,uBAAuB;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,CAAC,GAA6B;QAClC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAE9C,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC/B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,WAAY,CAAA;QACjC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACrB,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAEnB,GAAG,CAAC,SAAS,EAAE,CAAA;QAEf,oBAAoB;QACpB,2DAA2D;QAC3D,kDAAkD;QAClD,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAElC,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;IACd,CAAC;CACF,CAAA;AA1CoB,IAAI;IADxB,cAAc,CAAC,MAAM,CAAC;GACF,IAAI,CA0CxB;eA1CoB,IAAI","sourcesContent":["import { Component, ComponentNature, sceneComponent } from '@hatiolab/things-scene'\nimport { MCSZoneMixin, MCSZoneMixinProperties } from './features/mcs-zone-mixin'\nimport MCSCarrierHolder from './mcs-carrier-holder'\nimport { LoadLayoutHolder } from './features/load-layout-holder'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [...MCSZoneMixinProperties, ...MCSCarrierHolder.properties]\n}\n\n@sceneComponent('Port')\nexport default class Port extends LoadLayoutHolder(MCSZoneMixin(MCSCarrierHolder)) {\n  static get nature() {\n    return NATURE\n  }\n\n  /** Carriers stand at the Port's bottom (fmsim v2) */\n  get carrierRest(): { height: number; mount: 'ON' | 'HANG' } {\n    return { height: 0, mount: 'ON' }\n  }\n\n  get auxColor() {\n    return 'black'\n  }\n\n  getLegendFallback() {\n    return (this.root as any).portLegendTheme || super.getLegendFallback()\n  }\n\n  /** Port 는 후보가 매우 많아 부모 머신 없이는 id 리스트를 조회하지 않는다 (machine 필수). */\n  get idLookupRequiresMachine() {\n    return true\n  }\n\n  render(ctx: CanvasRenderingContext2D) {\n    var { left, top, width, height } = this.bounds\n\n    ctx.strokeStyle = this.auxColor\n    ctx.fillStyle = this.statusColor!\n    ctx.lineWidth = 1\n    ctx.lineCap = 'round'\n    ctx.setLineDash([])\n\n    ctx.beginPath()\n\n    // Performance aware\n    // const radius = Math.round(Math.min(width, height) * 0.1)\n    // ctx.roundRect(left, top, width, height, radius)\n    ctx.rect(left, top, width, height)\n\n    ctx.fill()\n    ctx.stroke()\n  }\n}\n"]}

package/dist/scene/root-container-override.js

@@ -1,6 +1,5 @@
-import { Component, RootContainer } from '@hatiolab/things-scene';
+import { Component, RootContainer, figureLegendSourcesChanged } from '@hatiolab/things-scene';
 import { themesColorMap, themesColorRange, themesAnimationMap } from '@fmsim/api';
-import CarrierManager from '../carrier-manager';
 /**
  * 스토커 적재율 게이지 표시 모드 — 런타임 선택지.
  * value 는 엔진 canonical(2D StockerCapacityBar / 3D buildGauge 공통), label 은 표시명.
@@ -224,6 +223,9 @@ ModelLayer.prototype.onchange = function (after) {
             });
         }
     }
+    /* 보드의 Carrier 범례가 바뀌었다: Carrier 피규어들이 범례를 다시 고른다 (ADR-0166 결정 12) */
+    if (after && ['carrierLegendName', 'carrierAnimationName'].some(k => Object.prototype.hasOwnProperty.call(after, k)))
+        figureLegendSourcesChanged();
     return _origModelLayerOnchange.call(this, after);
 };
 // === LegendTheme / AnimationTheme value resolve ===
@@ -232,7 +234,7 @@ ModelLayer.prototype.onchange = function (after) {
 // 형태에 따라 (a) 정상 object 또는 (b) JSON 문자열 둘 다로 나타난다 (2026-06-09
 // 진단 — consumer 인 carrier.ts:animationPreset 이 같은 이유로 typeof string
 // 분기 + JSON5.parse 처리하는 선례 존재). LegendTheme getter 들이 이 분기를
-// 두지 않아 string 통과 → getValueOnRanges 매칭 실패 → 3D gauge 의 색상이
+// 두지 않아 string 통과 → 구간 조회 매칭 실패 → 3D gauge 의 색상이
 // fallback 으로만 결정되던 증상.
 //
 // fix 는 getter 한 곳에서 lazy parse. WeakMap<state, Map<rawString, parsed>>
@@ -289,14 +291,6 @@ Object.defineProperty(RootContainer.prototype, 'vehicleAnimation', {
         return !!vehicleAnimation;
     }
 });
-Object.defineProperty(RootContainer.prototype, 'carrierManager', {
-    get: function () {
-        if (!this._carrierManager) {
-            this._carrierManager = new CarrierManager(this);
-        }
-        return this._carrierManager;
-    }
-});
 // === 스토커 게이지 표시 모드 (런타임 전용 transient) ===
 //
 // 모델(state)에 저장하지 않는다 — nature 속성이 아니므로 보드 직렬화에 포함되지 않고,