@fmsim/machine 3.0.0-beta.3 → 3.0.0-beta.5

package/src/features/vehicle-travel.ts

@@ -0,0 +1,97 @@
+import { ceilingZPos } from '@hatiolab/things-scene'
+import type Node from '../node'
+import { ohtRailTop } from './oht-rail'
+
+/** The node a vehicle's data names: a `Node` of the board with that id and node machine. */
+function findNode(vehicle: any, nodeId: string, nodeMachine: string): Node | null {
+  if (!nodeId || !nodeMachine) {
+    return null
+  }
+
+  const nodes = (vehicle.root.findAllById?.(nodeId) || []).filter((node: any) => node.state.type == 'Node') as Node[]
+
+  return nodes.find((node: Node) => node.nodeMachine === nodeMachine) ?? null
+}
+
+/**
+ * A vehicle's travel between the nodes of the board (`fmsim.Vehicle`, ADR-0167 decision 18): it goes to the centre of
+ * the Node its NODEID and NODEMACHINE name, turned the way it came, or -- the board's vehicle animation on -- it is drawn
+ * on the way (waypoint). One mixin worn by fmsim's own AGV and OHT and by a figure alike. A figure's front need not be
+ * its travel's: `vehicleHeading` (degrees) turns it, 0 for fmsim's own.
+ */
+export function VehicleTravel<T extends new (...args: any[]) => any>(Base: T) {
+  return class extends Base {
+    _lastWaypoint: { NodeId: string; NodeMachine: string } | null = null
+
+    /**
+     * Where a figure hung from the ceiling (an OHT) stands: its top at the rail of the line it runs on, as fmsim's own
+     * OHT -- not the ceiling. Things-scene takes it before the ceiling (a written zPos still wins); others say nothing.
+     */
+    get effectiveZPos(): number | undefined {
+      const own = super.effectiveZPos
+      if ((this as any).constructor?.placement !== 'ceiling') return own
+      const ro = (this as any)._realObject
+      if (!ro || !Number.isFinite(ro.effectiveDepth)) return own
+      return ceilingZPos(ro.placementMode, ohtRailTop(this), ro.effectiveDepth)
+    }
+
+    /** The angle, in radians, the vehicle's front makes with the way it travels. */
+    get travelHeading(): number {
+      return ((Number((this as any).state?.vehicleHeading) || 0) * Math.PI) / 180
+    }
+
+    onchangeData(after: Record<string, any>, before: Record<string, any>): void {
+      super.onchangeData(after, before)
+
+      const { NODEID: beforeNodeId, NODEMACHINE: beforeNodeMachine } = before.data || {}
+      const { NODEID: NodeId, NODEMACHINE: NodeMachine } = after.data || {}
+
+      if (
+        NodeId === undefined ||
+        NodeMachine === undefined ||
+        (beforeNodeId === NodeId && beforeNodeMachine === NodeMachine) ||
+        (this._lastWaypoint && this._lastWaypoint.NodeId === NodeId && this._lastWaypoint.NodeMachine === NodeMachine)
+      ) {
+        return // not changed
+      }
+
+      const afterNode = findNode(this, NodeId, NodeMachine)
+      if (!afterNode) {
+        // 보드는 전체 노드의 부분 뷰 — 모든 노드를 그리지 않는다. 위치 NODEID 가 이 보드에
+        // 없는 노드를 가리키는 건 오류가 아니라 정상(그 노드는 이 보드에 미표시)이므로,
+        // 경고 없이 조용히 배치를 생략한다. (데이터 갱신마다 도는 hot path — 거짓 경보 방지.)
+        return
+      }
+
+      const beforeNode = this._lastWaypoint ? findNode(this, this._lastWaypoint.NodeId, this._lastWaypoint.NodeMachine) : afterNode
+
+      // 실제 존재하는 노드 중 가장 최근에 이동한 노드
+      this._lastWaypoint = { NodeId, NodeMachine }
+
+      if ((this as any).root.vehicleAnimation) {
+        ;(this as any).trigger('waypoint', {
+          from: beforeNode || afterNode,
+          to: afterNode,
+          duration: 5000,
+          yawOffset: Math.PI / 2 + this.travelHeading
+        })
+      } else if (beforeNode) {
+        const fromCenter = beforeNode.center
+        const toCenter = afterNode.center
+
+        const { x: startX, y: startY } = beforeNode.transcoordS2T(fromCenter.x, fromCenter.y)
+        const { x: endX, y: endY } = afterNode.transcoordS2T(toCenter.x, toCenter.y)
+
+        const theta = Math.atan2(endY - startY, endX - startX) + Math.PI / 2
+
+        ;(this as any).location = { x: endX, y: endY }
+        ;(this as any).setState('rotation', theta + this.travelHeading)
+      } else {
+        // beforeNode 없음: afterNode 위치로 즉시 이동
+        const toCenter = afterNode.center
+        const { x, y } = afterNode.transcoordS2T(toCenter.x, toCenter.y)
+        ;(this as any).location = { x, y }
+      }
+    }
+  }
+}

package/src/index.ts

@@ -93,6 +93,10 @@ export { default as Crane } from './crane'
 export { default as Shelf } from './shelf'
 export { default as Carrier } from './carrier'
 export { CARRIER_HOLDER_PROPERTIES, CarrierHolder, carrierHolderLegend } from './mcs-carrier-holder'
+export { LVMachine, LVUnit, LVVehicle, StatusFigure, statusAsCode, statusLegend } from './features/lv-figures'
+export { MACHINE_HEIGHTS, TRANSPORT_SURFACE_HEIGHT } from './features/lv-heights'
+export { boardLegendOf, boardLegendOfRow, legendRowsOnBoard } from './features/legend-rows'
+export { legendPanel } from './features/legend-panel'
 
 // ── topology ──
 export { default as Node } from './node'

package/src/mcs-carrier-holder.ts

@@ -9,12 +9,12 @@ import {
   figureLegendSourcesChanged,
   itemTypeEntryOf,
   itemTypeTableOf,
-  registerFigureCapability,
   registerFigureLegendResolver,
   type ItemType
 } from '@hatiolab/things-scene'
+import { colourAndEffect } from './features/legend-rows'
 import { HOLDER_ANCHOR, type ItemDims, type ResolvedSlot } from '@hatiolab/figure-model'
-import { CARRIER_HOLDER, carrierHolderProperties } from '@fmsim/figure-capabilities'
+import { carrierHolderProperties } from '@fmsim/figure-capabilities'
 import MCSUnit from './mcs-unit.js'
 import { incomingFromV2 } from './utils/load-address'
 
@@ -56,6 +56,11 @@ export function CarrierHolder<T extends new (...args: any[]) => any>(Base: T) {
       return true
     }
 
+    /** The board legend rows its carriers follow, with whatever else it follows (ADR-0167 decision 20) */
+    get legendRowsUsed(): string[] {
+      return [...((super.legendRowsUsed as string[] | undefined) ?? []), 'carrier', 'carrier-animation']
+    }
+
     /** The records the reconcile took last, as JSON: the same again is not reconciled */
     _carrierRecordsTaken?: string
 
@@ -225,12 +230,13 @@ export function CarrierHolder<T extends new (...args: any[]) => any>(Base: T) {
     // ── 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.
+     * Where a figure holder's carriers rest, in coordinates above the holder's bottom, and whether they stand on it or
+     * hang from it, as its `carrierMount` says (ADR-0167 decision 18): on top of its body, or below it. fmsim's own
+     * holders say their own (MCSCarrierHolder and those over it).
      */
     get carrierRest(): { height: number; mount: 'ON' | 'HANG' } {
-      return { height: 30, mount: 'ON' }
+      if ((this as any).state?.carrierMount === 'HANG') return { height: 0, mount: 'HANG' }
+      return { height: Number((this as any)._realObject?.effectiveDepth) || 0, 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) */
@@ -290,6 +296,11 @@ class MCSCarrierHolder extends CarrierHolder(ItemsDataBinding(Holdable(Capacity(
   static get properties(): any {
     return [...MCSUnit.properties, ...CARRIER_HOLDER_PROPERTIES]
   }
+
+  /** 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(): { height: number; mount: 'ON' | 'HANG' } {
+    return { height: 30, mount: 'ON' }
+  }
 }
 
 export default MCSCarrierHolder
@@ -323,24 +334,4 @@ export function carrierHolderLegend({ component, role }: { component: any; role:
   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: Record<string, unknown>): Record<string, unknown> {
-  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 {
-          return [code, raw]
-        }
-      }
-      if (!entry || typeof entry !== 'object') return [code, entry]
-      const { color, effect } = entry as { color?: unknown; effect?: unknown }
-      return [code, { ...(color !== undefined ? { color } : {}), ...(effect !== undefined ? { effect } : {}) }]
-    })
-  )
-}
-
 registerFigureLegendResolver(carrierHolderLegend)
-registerFigureCapability({ ...CARRIER_HOLDER, properties: CARRIER_HOLDER_PROPERTIES as never }, base => CarrierHolder(base) as never)

package/src/mcs-machine.ts

@@ -4,6 +4,7 @@ import { getPopupData } from '@fmsim/api'
 import { MCSStatusMixin, MCSStatusMixinProperties } from './features/mcs-status-mixin'
 
 import { LEGEND_MACHINE, Legend } from './features/mcs-status-default'
+import { boardLegendOfRow } from './features/legend-rows'
 
 /**
  * MCS Machine의 공통 속성을 정의한 최상위 오브젝트
@@ -68,7 +69,17 @@ export default class MCSMachine extends MCSStatusMixin(ContainerAbstract) {
   }
 
   get legend(): Legend {
-    return this.getTheme() || this.getLegendFallback()
+    return this.getTheme() || boardLegendOfRow(this, this.statusLegendRow) || this.getLegendFallback()
+  }
+
+  /** The board legend row its STATUS colour follows when it chose no legend of its own (ADR-0167 decision 20); none here */
+  get statusLegendRow(): string | undefined {
+    return undefined
+  }
+
+  /** The board legend rows it follows: what the board's LEGENDS panel shows first */
+  get legendRowsUsed(): string[] {
+    return this.statusLegendRow ? [this.statusLegendRow] : []
   }
 
   get auxLegend() {

package/src/mcs-unit.ts

@@ -3,6 +3,7 @@ import { getPopupData } from '@fmsim/api'
 
 import { MCSStatusMixin, MCSStatusMixinProperties } from './features/mcs-status-mixin'
 import { LEGEND_UNIT, Legend } from './features/mcs-status-default'
+import { boardLegendOfRow } from './features/legend-rows'
 import { ParentObjectMixin, ParentObjectMixinProperties } from './features/parent-object-mixin'
 
 /**
@@ -50,7 +51,17 @@ export default class MCSUnit extends MCSStatusMixin(ParentObjectMixin(ContainerA
   }
 
   get legend(): Legend {
-    return this.getTheme() || this.getLegendFallback()
+    return this.getTheme() || boardLegendOfRow(this, this.statusLegendRow) || this.getLegendFallback()
+  }
+
+  /** The board legend row its STATUS colour follows when it chose no legend of its own (ADR-0167 decision 20); none here */
+  get statusLegendRow(): string | undefined {
+    return undefined
+  }
+
+  /** The board legend rows it follows: what the board's LEGENDS panel shows first */
+  get legendRowsUsed(): string[] {
+    return this.statusLegendRow ? [this.statusLegendRow] : []
   }
 
   get auxLegend() {

package/src/mcs-vehicle.ts

@@ -1,25 +1,13 @@
 import { LEGEND_VEHICLE, Legend } from './features/mcs-status-default'
+import { VehicleTravel } from './features/vehicle-travel'
 import MCSCarrierHolder from './mcs-carrier-holder'
-import Node from './node'
 
 const DIRECTION_GAP = 3
 
-function findNode(vehicle: MCSVehicle, nodeId: string, nodeMachine: string) {
-  if (!nodeId || !nodeMachine) {
-    return null
-  }
-
-  const nodes = (vehicle.root.findAllById?.(nodeId) || []).filter(node => node.state.type == 'Node') as Node[]
-
-  return nodes.find((node: Node) => {
-    return node.nodeMachine === nodeMachine
-  })
-}
-
 /**
  * MCS용 Unit > Transport들의 공통 속성을 정의한 오브젝트
  */
-export default class MCSVehicle extends MCSCarrierHolder {
+export default class MCSVehicle extends VehicleTravel(MCSCarrierHolder) {
   static get properties(): any {
     return [
       ...MCSCarrierHolder.properties,
@@ -34,8 +22,6 @@ export default class MCSVehicle extends MCSCarrierHolder {
     ]
   }
 
-  private lastWaypoint: { NodeId: string; NodeMachine: string } | null = null
-
   getLegendFallback(): Legend {
     return LEGEND_VEHICLE
   }
@@ -92,59 +78,5 @@ export default class MCSVehicle extends MCSCarrierHolder {
     super.postrender(ctx)
     // this.renderDirection(ctx)
   }
-
-  onchangeData(after: Record<string, any>, before: Record<string, any>): void {
-    super.onchangeData(after, before)
-
-    const { NODEID: beforeNodeId, NODEMACHINE: beforeNodeMachine } = before.data || {}
-    const { NODEID: NodeId, NODEMACHINE: NodeMachine } = after.data || {}
-
-    if (
-      NodeId === undefined ||
-      NodeMachine === undefined ||
-      (beforeNodeId === NodeId && beforeNodeMachine === NodeMachine) ||
-      (this.lastWaypoint && this.lastWaypoint.NodeId === NodeId && this.lastWaypoint.NodeMachine === NodeMachine)
-    ) {
-      return // not changed
-    }
-
-    const afterNode = findNode(this, NodeId, NodeMachine)
-    if (!afterNode) {
-      // 보드는 전체 노드의 부분 뷰 — 모든 노드를 그리지 않는다. 위치 NODEID 가 이 보드에
-      // 없는 노드를 가리키는 건 오류가 아니라 정상(그 노드는 이 보드에 미표시)이므로,
-      // 경고 없이 조용히 배치를 생략한다. (데이터 갱신마다 도는 hot path — 거짓 경보 방지.)
-      return
-    }
-
-    const beforeNode = this.lastWaypoint
-      ? findNode(this, this.lastWaypoint.NodeId, this.lastWaypoint.NodeMachine)
-      : afterNode
-
-    // 실제 존재하는 노드 중 가장 최근에 이동한 노드
-    this.lastWaypoint = { NodeId, NodeMachine }
-
-    if ((this.root as any).vehicleAnimation) {
-      this.trigger('waypoint', {
-        from: beforeNode || afterNode,
-        to: afterNode,
-        duration: 5000
-      })
-    } else if (beforeNode) {
-      const fromCenter = beforeNode.center
-      const toCenter = afterNode.center
-
-      const { x: startX, y: startY } = beforeNode.transcoordS2T(fromCenter.x, fromCenter.y)
-      const { x: endX, y: endY } = afterNode.transcoordS2T(toCenter.x, toCenter.y)
-
-      const theta = Math.atan2(endY - startY, endX - startX) + Math.PI / 2
-
-      this.location = { x: endX, y: endY }
-      this.setState('rotation', theta)
-    } else {
-      // beforeNode 없음: afterNode 위치로 즉시 이동
-      const toCenter = afterNode.center
-      const { x, y } = afterNode.transcoordS2T(toCenter.x, toCenter.y)
-      this.location = { x, y }
-    }
-  }
 }
+

package/src/oht-line.ts

@@ -5,7 +5,11 @@ const NATURE: ComponentNature = {
   mutable: false,
   resizable: true,
   rotatable: true,
-  properties: [...MCSTransport.properties]
+  properties: [
+    ...MCSTransport.properties,
+    /* 레일 윗면이 작업환경 천장에서 내려온 길이(mm). 레일과 그 위를 다니는 OHT 가 천장을 따라 움직인다 */
+    { type: 'number', label: 'rail-hang', name: 'railHang', property: { min: 0, step: 100 } }
+  ]
 }
 
 @sceneComponent('OHTLine')
@@ -18,8 +22,8 @@ export default class OHTLine extends MCSTransport {
     return '#333'
   }
 
-  getLegendFallback() {
-    return (this.root as any).ohtlineLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'ohtline'
   }
 
   containable(component: Component) {

package/src/oht.ts

@@ -30,8 +30,8 @@ export default class OHT extends MCSVehicle {
     return ['OHTLine']
   }
 
-  getLegendFallback() {
-    return (this.root as any).ohtLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'oht'
   }
 
   render(ctx: CanvasRenderingContext2D) {

package/src/port.ts

@@ -25,8 +25,8 @@ export default class Port extends LoadLayoutHolder(MCSZoneMixin(MCSCarrierHolder
     return 'black'
   }
 
-  getLegendFallback() {
-    return (this.root as any).portLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'port'
   }
 
   /** Port 는 후보가 매우 많아 부모 머신 없이는 id 리스트를 조회하지 않는다 (machine 필수). */

package/src/scene/root-container-override.ts

@@ -1,6 +1,7 @@
 import { Component, RootContainer, figureLegendSourcesChanged } from '@hatiolab/things-scene'
-import { themesColorMap, themesColorRange, themesAnimationMap } from '@fmsim/api'
-import { Legend } from '../features/mcs-status-default'
+import { FMSIM_LEGEND_ROWS, legendRows } from '@fmsim/figure-capabilities'
+import { boardLegendOf } from '../features/legend-rows'
+import { legendPanel } from '../features/legend-panel'
 
 // RootContainer 클래스 타입 확장
 declare module '@hatiolab/things-scene' {
@@ -58,158 +59,7 @@ Object.defineProperty(ModelLayer.prototype, 'nature', {
           label: 'vehicle-animation',
           name: 'vehicleAnimation'
         },
-        {
-          type: 'legend',
-          label: '',
-          name: 'LEGENDS',
-          property: {
-            label: 'LEGENDS'
-          }
-        },
-        {
-          type: 'select',
-          label: 'equipment-legend-name',
-          name: 'equipmentLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'buffer-legend-name',
-          name: 'bufferLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'agvline-legend-name',
-          name: 'agvlineLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'ohtline-legend-name',
-          name: 'ohtlineLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'conveyor-legend-name',
-          name: 'conveyorLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'stoker-legend-name',
-          name: 'stokerLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'port-legend-name',
-          name: 'portLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'agv-legend-name',
-          name: 'agvLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'oht-legend-name',
-          name: 'ohtLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'shuttle-legend-name',
-          name: 'shuttleLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'crane-legend-name',
-          name: 'craneLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'port-legend-name',
-          name: 'portLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'shelf-legend-name',
-          name: 'shelfLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'carrier-legend-name',
-          name: 'carrierLegendName',
-          property: {
-            options: themesColorMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'carrier-animation-name',
-          name: 'carrierAnimationName',
-          property: {
-            options: themesAnimationMap
-          }
-        },
-        {
-          type: 'select',
-          label: 'stocker-capacity-legend-name',
-          name: 'stockerCapacityLegendName',
-          property: {
-            options: themesColorRange
-          }
-        },
-        {
-          type: 'select',
-          label: 'zone-capacity-legend-name',
-          name: 'zoneCapacityLegendName',
-          property: {
-            options: themesColorRange
-          }
-        },
-        {
-          type: 'select',
-          label: 'battery-rate-legend-name',
-          name: 'batteryRateLegendName',
-          property: {
-            options: themesColorRange
-          }
-        },
+        ...legendPanel(this),
         {
           type: 'legend',
           label: '',
@@ -260,65 +110,23 @@ ModelLayer.prototype.onchange = function (after: any) {
       })
     }
   }
-  /* 보드의 Carrier 범례가 바뀌었다: Carrier 피규어들이 범례를 다시 고른다 (ADR-0166 결정 12) */
-  if (after && ['carrierLegendName', 'carrierAnimationName'].some(k => Object.prototype.hasOwnProperty.call(after, k))) figureLegendSourcesChanged()
+  /* 보드의 범례 줄이 바뀌었다: 피규어들이 범례를 다시 고른다 (ADR-0166 결정 12 · ADR-0167 결정 20) */
+  if (after && legendRows().some(row => Object.prototype.hasOwnProperty.call(after, row.property))) figureLegendSourcesChanged()
   return _origModelLayerOnchange.call(this, after)
 }
 
-// === LegendTheme / AnimationTheme value resolve ===
-//
-// rootModel.state.style[name] 에 저장된 legend/animation 값은 보드 직렬화
-// 형태에 따라 (a) 정상 object 또는 (b) JSON 문자열 둘 다로 나타난다 (2026-06-09
-// 진단 — consumer 인 carrier.ts:animationPreset 이 같은 이유로 typeof string
-// 분기 + JSON5.parse 처리하는 선례 존재). LegendTheme getter 들이 이 분기를
-// 두지 않아 string 통과 → 구간 조회 매칭 실패 → 3D gauge 의 색상이
-// fallback 으로만 결정되던 증상.
+// === 범례 줄의 보드 속성 → 범례 (ADR-0167 결정 20) ===
 //
-// fix 는 getter 한 곳에서 lazy parse. WeakMap<state, Map<rawString, parsed>>
-// 으로 *raw string 자체를 key* — 보드 편집으로 raw 가 바뀌면 자연 무효화,
-// 같은 raw 의 반복 lookup 은 O(1). root 가 GC 되면 cache 도 같이 GC.
-const _legendParseCache = new WeakMap<object, Map<string, any>>()
-
-function parseLegendIfString(state: any, raw: any): any {
-  if (typeof raw !== 'string') return raw
-  let cache = _legendParseCache.get(state)
-  if (!cache) {
-    cache = new Map()
-    _legendParseCache.set(state, cache)
-  }
-  if (cache.has(raw)) return cache.get(raw)
-  let parsed: any
-  try { parsed = JSON.parse(raw) } catch { parsed = raw } // parse 실패 시 raw 보존
-  cache.set(raw, parsed)
-  return parsed
-}
-
-function legendThemeGetter(stateKey: string) {
-  return function (this: any) {
-    const name = this.rootModel.state[stateKey]
-    const raw = name && this.state.style[name]
-    return parseLegendIfString(this.state, raw)
-  }
+// 줄마다 손으로 적던 getter 대신 등록된 줄에서 만든다: 보드 속성 `<x>Name` 의 범례를 `<x>Theme` 로 읽는다
+// (equipmentLegendName → equipmentLegendTheme, carrierAnimationName → carrierAnimationTheme). 문자열 범례는 legend-rows 가 한 번 읽는다.
+for (const row of FMSIM_LEGEND_ROWS) {
+  Object.defineProperty(RootContainer.prototype, row.property.replace(/Name$/, 'Theme'), {
+    get: function (this: any) {
+      return boardLegendOf(this, row.property)
+    }
+  })
 }
 
-Object.defineProperty(RootContainer.prototype, 'equipmentLegendTheme', { get: legendThemeGetter('equipmentLegendName') })
-Object.defineProperty(RootContainer.prototype, 'bufferLegendTheme', { get: legendThemeGetter('bufferLegendName') })
-Object.defineProperty(RootContainer.prototype, 'agvlineLegendTheme', { get: legendThemeGetter('agvlineLegendName') })
-Object.defineProperty(RootContainer.prototype, 'ohtlineLegendTheme', { get: legendThemeGetter('ohtlineLegendName') })
-Object.defineProperty(RootContainer.prototype, 'conveyorLegendTheme', { get: legendThemeGetter('conveyorLegendName') })
-Object.defineProperty(RootContainer.prototype, 'stokerLegendTheme', { get: legendThemeGetter('stokerLegendName') })
-Object.defineProperty(RootContainer.prototype, 'agvLegendTheme', { get: legendThemeGetter('agvLegendName') })
-Object.defineProperty(RootContainer.prototype, 'ohtLegendTheme', { get: legendThemeGetter('ohtLegendName') })
-Object.defineProperty(RootContainer.prototype, 'shuttleLegendTheme', { get: legendThemeGetter('shuttleLegendName') })
-Object.defineProperty(RootContainer.prototype, 'craneLegendTheme', { get: legendThemeGetter('craneLegendName') })
-Object.defineProperty(RootContainer.prototype, 'shelfLegendTheme', { get: legendThemeGetter('shelfLegendName') })
-Object.defineProperty(RootContainer.prototype, 'portLegendTheme', { get: legendThemeGetter('portLegendName') })
-Object.defineProperty(RootContainer.prototype, 'carrierLegendTheme', { get: legendThemeGetter('carrierLegendName') })
-Object.defineProperty(RootContainer.prototype, 'carrierAnimationTheme', { get: legendThemeGetter('carrierAnimationName') })
-Object.defineProperty(RootContainer.prototype, 'stockerCapacityLegendTheme', { get: legendThemeGetter('stockerCapacityLegendName') })
-Object.defineProperty(RootContainer.prototype, 'zoneCapacityLegendTheme', { get: legendThemeGetter('zoneCapacityLegendName') })
-Object.defineProperty(RootContainer.prototype, 'batteryRateLegendTheme', { get: legendThemeGetter('batteryRateLegendName') })
-
 Object.defineProperty(RootContainer.prototype, 'vehicleAnimation', {
   get: function () {
     const { vehicleAnimation } = this.rootModel.state

package/src/shelf.ts

@@ -29,8 +29,8 @@ export default class Shelf extends MCSZoneMixin(MCSCarrierHolder) {
     return ['STOCKER']
   }
 
-  getLegendFallback() {
-    return (this.root as any).shelfLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'shelf'
   }
 
   render(ctx: CanvasRenderingContext2D) {

package/src/shuttle.ts

@@ -24,8 +24,8 @@ export default class Shuttle extends MCSVehicle {
     return 'black'
   }
 
-  getLegendFallback() {
-    return (this.root as any).shuttleLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'shuttle'
   }
 
   render(ctx: CanvasRenderingContext2D) {

package/src/stocker.ts

@@ -61,8 +61,8 @@ export default class Stocker extends MCSTransport {
     return NATURE
   }
 
-  getLegendFallback() {
-    return (this.root as any).stokerLegendTheme || super.getLegendFallback()
+  get statusLegendRow(): string {
+    return 'stocker'
   }
 
   containable(component: Component) {