@fmsim/machine 2.0.1 → 3.0.0-beta.1

package/src/utils/load-address.ts

@@ -0,0 +1,270 @@
+/*
+ * 실시간 데이터의 적재 주소 해석과 점유 배정 (설계 02번 3.6절, 3.6.1절)
+ * Carrier 는 자리 번호에 고정된다. 주소를 못 읽으면 빈 자리에 채우지 않고 예외로 둔다.
+ * 레이아웃(층·자리)과 자리 계산은 figure-model 의 것이다(ADR-0051 4.1절 결정 8). 여기 남는 것은 MCS 의 몫이다:
+ * 실시간 레코드에서 주소를 읽는 규칙(FIELDS·PATTERN)과 점유 배정·예외.
+ */
+
+import { resolveSlot, type SlotAddress, type SlotLayout } from '@hatiolab/figure-model'
+import { AddressPatternError, LayoutIssue, issue } from './layout-issue'
+import { parseIfJsonString } from './data-value'
+
+export type LoadAddress = SlotAddress
+
+/** 실시간 데이터에서 주소를 읽는 규칙 (3.6절) */
+export type LoadAddressing =
+  | { by: 'FIELDS'; tierField?: string; slotField: string }
+  | { by: 'PATTERN'; field: string; pattern: string }
+
+/** 홀더의 적재 레이아웃: figure-model 의 층·자리에 주소 읽기 규칙을 더한 배치 값 */
+export interface LoadLayout extends SlotLayout {
+  addressing?: LoadAddressing
+}
+
+export type AddressRead =
+  | { kind: 'OK'; address: LoadAddress }
+  | { kind: 'UNKNOWN'; raw: unknown }
+  | { kind: 'ERROR'; raw: unknown; reason: AddressErrorReason }
+
+export type AddressErrorReason = 'NOT_POSITIVE_INTEGER' | 'OUT_OF_RANGE' | 'STACK_LIMIT_EXCEEDED' | 'DUPLICATE_CONFLICT'
+
+/** 양의 정수 또는 양의 정수 문자열만 받는다. 그 밖의 값은 null */
+function positiveInt(v: unknown): number | null {
+  if (typeof v === 'number') return Number.isSafeInteger(v) && v > 0 ? v : null
+  if (typeof v === 'string' && /^\d+$/.test(v.trim())) {
+    const n = Number(v.trim())
+    return Number.isSafeInteger(n) && n > 0 ? n : null
+  }
+  return null
+}
+
+const missing = (v: unknown) => v === undefined || v === null
+
+// ── PATTERN 문법 ────────────────────────────────────────────────────────────
+
+const TOKEN = /\{([A-Za-z_][A-Za-z0-9_]*)(?::(0\d+))?\}/g
+
+export interface CompiledPattern {
+  regex: RegExp
+  tierGroup?: number
+  slotGroup?: number
+}
+
+/** 위치 문자열 패턴을 정규식으로 바꾼다. 문법이 틀리면 AddressPatternError(모든 문제 목록)를 던진다 */
+export function compileAddressPattern(pattern: string): CompiledPattern {
+  if (typeof pattern !== 'string' || !pattern)
+    throw new AddressPatternError([issue('ADDRESS_PATTERN_EMPTY', 'pattern')])
+  const errors: LayoutIssue[] = []
+  let source = '^'
+  let last = 0
+  let group = 0
+  let tierGroup: number | undefined
+  let slotGroup: number | undefined
+  const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+
+  for (const m of pattern.matchAll(TOKEN)) {
+    const literal = pattern.slice(last, m.index)
+    if (/[{}]/.test(literal)) errors.push(issue('ADDRESS_PATTERN_SYNTAX', 'pattern', { text: literal }))
+    source += escape(literal)
+    const [, name, width] = m
+    group++
+    if (name === 'tier' || name === 'slot') {
+      if ((name === 'tier' ? tierGroup : slotGroup) !== undefined)
+        errors.push(issue('ADDRESS_PATTERN_TOKEN_REPEATED', 'pattern', { token: name }))
+      if (name === 'tier') tierGroup = group
+      else slotGroup = group
+      source += width ? `(\\d{${width.length}})` : '(\\d+)'
+    } else {
+      if (width) errors.push(issue('ADDRESS_PATTERN_WIDTH_NOT_ALLOWED', 'pattern', { token: name }))
+      source += '(.+?)'
+    }
+    last = m.index! + m[0].length
+  }
+  const tail = pattern.slice(last)
+  if (/[{}]/.test(tail)) errors.push(issue('ADDRESS_PATTERN_SYNTAX', 'pattern', { text: tail }))
+  source += escape(tail) + '$'
+  if (slotGroup === undefined) errors.push(issue('ADDRESS_PATTERN_SLOT_REQUIRED', 'pattern'))
+  if (errors.length) throw new AddressPatternError(errors)
+  return { regex: new RegExp(source), tierGroup, slotGroup }
+}
+
+/** 레이아웃의 addressing 설정 오류 목록. 경로는 'addressing.' 으로 시작한다. 빈 배열이면 올바르다 */
+export function validateAddressing(addressing: LoadAddressing | undefined): LayoutIssue[] {
+  if (!addressing) return []
+  if (addressing.by === 'FIELDS') return addressing.slotField ? [] : [issue('FIELD_REQUIRED', 'addressing.slotField')]
+  if (addressing.by === 'PATTERN') {
+    const errors = addressing.field ? [] : [issue('FIELD_REQUIRED', 'addressing.field')]
+    try {
+      compileAddressPattern(addressing.pattern)
+    } catch (e) {
+      if (!(e instanceof AddressPatternError)) throw e
+      errors.push(...e.issues.map(i => ({ ...i, path: `addressing.${i.path}` })))
+    }
+    return errors
+  }
+  return [issue('ADDRESSING_BY_INVALID', 'addressing.by')]
+}
+
+// ── 주소 읽기 ───────────────────────────────────────────────────────────────
+
+/**
+ * 레코드에서 주소를 읽는다. 범위 검사는 하지 않는다 (resolveOccupancy 가 한다).
+ * 필드 누락·패턴 불일치는 UNKNOWN, 0·음수·소수·빈 문자열은 ERROR.
+ * {tier} 가 없는 패턴과 tierField 를 생략한 FIELDS 는 층 1로 읽는다.
+ */
+export function readAddress(record: Record<string, unknown>, addressing: LoadAddressing | undefined): AddressRead {
+  if (!addressing) return { kind: 'UNKNOWN', raw: undefined }
+
+  if (addressing.by === 'FIELDS') {
+    const rawSlot = record?.[addressing.slotField]
+    const rawTier = addressing.tierField ? record?.[addressing.tierField] : 1
+    const raw = addressing.tierField ? { tier: rawTier, slot: rawSlot } : { slot: rawSlot }
+    if (missing(rawSlot) || missing(rawTier)) return { kind: 'UNKNOWN', raw }
+    const tier = positiveInt(rawTier)
+    const slot = positiveInt(rawSlot)
+    if (tier === null || slot === null) return { kind: 'ERROR', raw, reason: 'NOT_POSITIVE_INTEGER' }
+    return { kind: 'OK', address: { tier, slot } }
+  }
+
+  const raw = record?.[addressing.field]
+  if (typeof raw !== 'string') return { kind: 'UNKNOWN', raw }
+  const { regex, tierGroup, slotGroup } = compileAddressPattern(addressing.pattern)
+  const m = regex.exec(raw)
+  if (!m) return { kind: 'UNKNOWN', raw }
+  const tier = tierGroup ? positiveInt(m[tierGroup]) : 1
+  const slot = positiveInt(m[slotGroup!])
+  if (tier === null || slot === null) return { kind: 'ERROR', raw, reason: 'NOT_POSITIVE_INTEGER' }
+  return { kind: 'OK', address: { tier, slot } }
+}
+
+// ── 점유 배정 ───────────────────────────────────────────────────────────────
+
+export interface IncomingCarrier {
+  name: string
+  type?: string
+  /** 주소를 읽을 원본 레코드 */
+  record: Record<string, unknown>
+  /** 메시지가 주는 적층 순서 (아래가 작다). 없으면 생략 */
+  stackOrder?: number
+}
+
+export interface PlacedCarrier {
+  name: string
+  type?: string
+  address: LoadAddress
+}
+
+export interface ExceptionCarrier {
+  name: string
+  type?: string
+  raw: unknown
+  reason?: AddressErrorReason
+}
+
+export interface OccupancyResult {
+  /** 'tier:slot' → 아래에서 위로 정상 점유 */
+  slots: Map<string, PlacedCarrier[]>
+  /** 주소를 읽지 못해 예외 표시 영역에 두는 Carrier */
+  addressUnknown: ExceptionCarrier[]
+  /** 범위 밖·적층 한도 초과·중복 충돌로 예외 표시 영역에 두는 Carrier */
+  addressError: ExceptionCarrier[]
+  /** 데이터 오류 기록 (같은 이름이 두 번 온 경우 등) */
+  dataErrors: LayoutIssue[]
+}
+
+export const slotKey = (a: LoadAddress) => `${a.tier}:${a.slot}`
+
+/**
+ * v2 홀더 데이터 → 아래에서 위로 놓을 Carrier 목록 (3.6.1절, CR-11).
+ * MULTICARRIERS[] 를 배열 순서대로 아래부터, 대표 CARRIERNAME 을 맨 위에 둔다.
+ * MULTICARRIERS 는 JSON 문자열로 올 수 있다. CARRIERNAME 이 없는 항목은 건너뛴다.
+ */
+export function incomingFromV2(data: Record<string, any> | null | undefined): IncomingCarrier[] {
+  if (!data) return []
+  const out: IncomingCarrier[] = []
+  const list = parseIfJsonString(data.MULTICARRIERS)
+  if (Array.isArray(list))
+    for (const item of list)
+      if (item && typeof item === 'object' && item.CARRIERNAME)
+        out.push({ name: String(item.CARRIERNAME), type: item.CARRIERTYPE, record: item, stackOrder: out.length })
+  if (data.CARRIERNAME)
+    out.push({ name: String(data.CARRIERNAME), type: data.CARRIERTYPE, record: data, stackOrder: out.length })
+  return out
+}
+
+/**
+ * 홀더 점유 스냅샷 하나를 한 번에 배정한다.
+ * 순서: 주소 해석 → 정상 자리 배정 → 자리별 적층 한도 검사 → 예외 목록 작성.
+ * previous 는 직전 결과이며, 메시지에 적층 순서가 없을 때 기존 순서를 지키는 데 쓴다.
+ * 각 Carrier 는 slots·addressUnknown·addressError 셋 중 한 곳에만 들어간다.
+ */
+export function resolveOccupancy(layout: LoadLayout, carriers: IncomingCarrier[], previous?: OccupancyResult): OccupancyResult {
+  const result: OccupancyResult = { slots: new Map(), addressUnknown: [], addressError: [], dataErrors: [] }
+
+  // 같은 이름: 한 번만 그린다. 주소가 다르면 주소 오류
+  const byName = new Map<string, { carrier: IncomingCarrier; read: AddressRead; arrival: number }>()
+  const conflicted = new Set<string>()
+  carriers.forEach((carrier, arrival) => {
+    const read = readAddress(carrier.record, layout.addressing)
+    const seen = byName.get(carrier.name)
+    if (!seen) {
+      byName.set(carrier.name, { carrier, read, arrival })
+      return
+    }
+    result.dataErrors.push(issue('DUPLICATE_CARRIER', '', { name: carrier.name }))
+    const same =
+      seen.read.kind === read.kind &&
+      (read.kind !== 'OK' || slotKey(read.address) === slotKey((seen.read as { address: LoadAddress }).address))
+    if (!same) conflicted.add(carrier.name)
+  })
+
+  const previousOrder = new Map<string, number>()
+  previous?.slots.forEach(list => list.forEach((c, i) => previousOrder.set(c.name, i)))
+
+  const pending = new Map<string, { carrier: IncomingCarrier; arrival: number }[]>()
+  for (const [name, { carrier, read, arrival }] of byName) {
+    const exception = { name, type: carrier.type, raw: 'raw' in read ? read.raw : undefined }
+    if (conflicted.has(name)) {
+      result.addressError.push({ ...exception, raw: carrier.record, reason: 'DUPLICATE_CONFLICT' })
+    } else if (read.kind === 'UNKNOWN') {
+      result.addressUnknown.push(exception)
+    } else if (read.kind === 'ERROR') {
+      result.addressError.push({ ...exception, reason: read.reason })
+    } else if (!resolveSlot(layout, read.address)) {
+      result.addressError.push({ ...exception, raw: read.address, reason: 'OUT_OF_RANGE' })
+    } else {
+      const key = slotKey(read.address)
+      if (!pending.has(key)) pending.set(key, [])
+      pending.get(key)!.push({ carrier, arrival })
+    }
+  }
+
+  // 적층 순서: 메시지 순서 우선. 없으면 기존 순서를 지키고 새 Carrier 는 도착 순서로 위에 얹는다
+  for (const [key, list] of pending) {
+    const [tier, slot] = key.split(':').map(Number)
+    const limit = resolveSlot(layout, { tier, slot })!.stackLimit
+    const rank = (e: { carrier: IncomingCarrier; arrival: number }) => {
+      if (e.carrier.stackOrder !== undefined) return [0, e.carrier.stackOrder, e.arrival]
+      const prev = previousOrder.get(e.carrier.name)
+      return prev !== undefined ? [1, prev, e.arrival] : [2, e.arrival, 0]
+    }
+    list.sort((a, b) => {
+      const ra = rank(a)
+      const rb = rank(b)
+      return ra[0] - rb[0] || ra[1] - rb[1] || ra[2] - rb[2]
+    })
+    const placed = list
+      .slice(0, limit)
+      .map(({ carrier }) => ({ name: carrier.name, type: carrier.type, address: { tier, slot } }))
+    result.slots.set(key, placed)
+    for (const { carrier } of list.slice(limit))
+      result.addressError.push({
+        name: carrier.name,
+        type: carrier.type,
+        raw: { tier, slot },
+        reason: 'STACK_LIMIT_EXCEEDED'
+      })
+  }
+
+  return result
+}

package/src/utils/stocker-gauge.ts

@@ -11,7 +11,7 @@
  *  - abnormal : CARRIER_NORMAL / CARRIER_ABNORMAL
  */
 
-import { Legend } from '../features/mcs-status-default'
+import { Legend, legendColor, legendEntryOf } from '../features/mcs-status-default'
 
 export type StockerGaugeMode = 'capacity' | 'carrier' | 'abnormal'
 
@@ -43,11 +43,11 @@ export interface CarrierColors {
 
 /**
  * carrier legend(테마)에서 full/empty/emptyEmpty 색상 추출.
- * carrier 컴포넌트의 색 취득 로직(statusColor = legend[status] || legend.default)과 동일하게,
+ * carrier 컴포넌트의 색 취득 로직(statusColor, legendEntryOf)과 동일하게,
  * status 키(FULL/EMPTY/EMPTYEMPTY)로 직접 조회한다. 키/default 모두 없으면 CARRIER_COLORS 로 폴백.
  */
 export function carrierColorsFromLegend(legend?: Legend): CarrierColors {
-  const pick = (key: string, fallback: string) => (legend && (legend[key] || legend.default)) || fallback
+  const pick = (key: string, fallback: string) => (legend && (legendColor(legendEntryOf(key, legend)) || legendColor(legend.default))) || fallback
   return {
     full: pick('FULL', CARRIER_COLORS.full),
     empty: pick('EMPTY', CARRIER_COLORS.empty),

package/translations/en.json

@@ -74,5 +74,46 @@
   "label.bright": "bright",
   "label.coord-axis-x": "internal x axis",
   "label.coord-invert-x": "invert x origin",
-  "label.coord-invert-y": "invert y origin"
+  "label.coord-invert-y": "invert y origin",
+  "label.load-layout.addressing": "Address in live data",
+  "label.load-layout.addressing-by": "Read by",
+  "label.load-layout.addressing-fields": "Fields",
+  "label.load-layout.addressing-none": "Not read (all shown as address unknown)",
+  "label.load-layout.addressing-pattern": "Location pattern",
+  "label.load-layout.field": "Field",
+  "label.load-layout.invalid": "The saved setting is invalid. Shown as one slot until fixed.",
+  "label.load-layout.issue.ADDRESSING_BY_INVALID": "Must be fields or a location pattern",
+  "label.load-layout.issue.ADDRESS_PATTERN_EMPTY": "The pattern is empty",
+  "label.load-layout.issue.ADDRESS_PATTERN_SLOT_REQUIRED": "The pattern needs a slot token",
+  "label.load-layout.issue.ADDRESS_PATTERN_SYNTAX": "Broken token near \"{text}\"",
+  "label.load-layout.issue.ADDRESS_PATTERN_TOKEN_REPEATED": "The {token} token may appear only once",
+  "label.load-layout.issue.ADDRESS_PATTERN_WIDTH_NOT_ALLOWED": "Digits are allowed only on the tier and slot tokens, not on {token}",
+  "label.load-layout.issue.DUPLICATE_CARRIER": "The same carrier came twice: {name}",
+  "label.load-layout.issue.FIELD_REQUIRED": "A field name is required",
+  "label.load-layout.param-cols": "Columns",
+  "label.load-layout.param-rows": "Rows",
+  "label.load-layout.param-stackLimit": "Stack limit",
+  "label.load-layout.param-upperElevation": "Upper tier elevation (mm)",
+  "label.load-layout.pattern-text": "Pattern",
+  "label.load-layout.preset-agv2x2": "AGV 2×2",
+  "label.load-layout.preset-agvParallel": "AGV parallel (left/right)",
+  "label.load-layout.preset-agvTandem": "AGV tandem (front/rear)",
+  "label.load-layout.preset-bufferPort2x2": "Buffer port 2×2",
+  "label.load-layout.preset-craneTwinFork": "Crane twin fork",
+  "label.load-layout.preset-dualTierConveyor": "Dual-tier conveyor",
+  "label.load-layout.preset-floorBlock": "Floor block",
+  "label.load-layout.preset-kind": "Kind",
+  "label.load-layout.preset-multiBufferPort": "Multi-buffer port (4)",
+  "label.load-layout.preset-note": "Pitch and slot size are split evenly as starting values. Confirm them against the real equipment.",
+  "label.load-layout.preset-single": "Single slot",
+  "label.load-layout.slot-field": "Slot field",
+  "label.load-layout.source": "Source",
+  "label.load-layout.source-builtin": "Built-in default",
+  "label.load-layout.source-node": "Set on this holder",
+  "label.load-layout.source-none": "Not defined (one slot, stacked)",
+  "label.load-layout.tier-field": "Tier field",
+  "label.load-layout.tier-field-empty": "Empty = tier 1",
+  "label.load-layout.title": "Carrier load slots",
+  "label.load-layout.unit-missing": "Drawing unit is not set (mmPerUnit). Physical placement and fit checks are unavailable.",
+  "label.load-layout.unit-ok": "Drawing unit 1 = {mm} mm"
 }

package/translations/ja.json

@@ -76,5 +76,46 @@
   "label.bright": "明",
   "label.coord-axis-x": "内部X軸",
   "label.coord-invert-x": "X原点反転",
-  "label.coord-invert-y": "Y原点反転"
+  "label.coord-invert-y": "Y原点反転",
+  "label.load-layout.addressing": "Address in live data",
+  "label.load-layout.addressing-by": "Read by",
+  "label.load-layout.addressing-fields": "Fields",
+  "label.load-layout.addressing-none": "Not read (all shown as address unknown)",
+  "label.load-layout.addressing-pattern": "Location pattern",
+  "label.load-layout.field": "Field",
+  "label.load-layout.invalid": "The saved setting is invalid. Shown as one slot until fixed.",
+  "label.load-layout.issue.ADDRESSING_BY_INVALID": "Must be fields or a location pattern",
+  "label.load-layout.issue.ADDRESS_PATTERN_EMPTY": "The pattern is empty",
+  "label.load-layout.issue.ADDRESS_PATTERN_SLOT_REQUIRED": "The pattern needs a slot token",
+  "label.load-layout.issue.ADDRESS_PATTERN_SYNTAX": "Broken token near \"{text}\"",
+  "label.load-layout.issue.ADDRESS_PATTERN_TOKEN_REPEATED": "The {token} token may appear only once",
+  "label.load-layout.issue.ADDRESS_PATTERN_WIDTH_NOT_ALLOWED": "Digits are allowed only on the tier and slot tokens, not on {token}",
+  "label.load-layout.issue.DUPLICATE_CARRIER": "The same carrier came twice: {name}",
+  "label.load-layout.issue.FIELD_REQUIRED": "A field name is required",
+  "label.load-layout.param-cols": "Columns",
+  "label.load-layout.param-rows": "Rows",
+  "label.load-layout.param-stackLimit": "Stack limit",
+  "label.load-layout.param-upperElevation": "Upper tier elevation (mm)",
+  "label.load-layout.pattern-text": "Pattern",
+  "label.load-layout.preset-agv2x2": "AGV 2×2",
+  "label.load-layout.preset-agvParallel": "AGV parallel (left/right)",
+  "label.load-layout.preset-agvTandem": "AGV tandem (front/rear)",
+  "label.load-layout.preset-bufferPort2x2": "Buffer port 2×2",
+  "label.load-layout.preset-craneTwinFork": "Crane twin fork",
+  "label.load-layout.preset-dualTierConveyor": "Dual-tier conveyor",
+  "label.load-layout.preset-floorBlock": "Floor block",
+  "label.load-layout.preset-kind": "Kind",
+  "label.load-layout.preset-multiBufferPort": "Multi-buffer port (4)",
+  "label.load-layout.preset-note": "Pitch and slot size are split evenly as starting values. Confirm them against the real equipment.",
+  "label.load-layout.preset-single": "Single slot",
+  "label.load-layout.slot-field": "Slot field",
+  "label.load-layout.source": "Source",
+  "label.load-layout.source-builtin": "Built-in default",
+  "label.load-layout.source-node": "Set on this holder",
+  "label.load-layout.source-none": "Not defined (one slot, stacked)",
+  "label.load-layout.tier-field": "Tier field",
+  "label.load-layout.tier-field-empty": "Empty = tier 1",
+  "label.load-layout.title": "Carrier load slots",
+  "label.load-layout.unit-missing": "Drawing unit is not set (mmPerUnit). Physical placement and fit checks are unavailable.",
+  "label.load-layout.unit-ok": "Drawing unit 1 = {mm} mm"
 }

package/translations/ko.json

@@ -6,25 +6,25 @@
   "label.carrier-empty-empty": "이중 공 캐리어",
   "label.carrier-normal": "정상 캐리어",
   "label.carrier-abnormal": "비정상 캐리어",
-  "label.high-watermark": "고수위워터마크",
-  "label.low-watermark": "저수위워터마크",
-  "label.legend-name": "레전드",
+  "label.high-watermark": "상한 기준값",
+  "label.low-watermark": "하한 기준값",
+  "label.legend-name": "범례",
   "label.max-capacity": "최대 용량",
   "label.carrier-animation-name": "캐리어 애니메이션",
-  "label.carrier-legend-name": "캐리어 레전드",
-  "label.sc-state": "sc state",
-  "label.full-rate": "full rate",
-  "label.reserved-carrier": "reserved carrier",
-  "label.transfer-command": "transfer command",
-  "label.parent-object-id": "부모 오브젝트",
-  "label.process-type": "process type",
+  "label.carrier-legend-name": "캐리어 범례",
+  "label.sc-state": "SC 상태",
+  "label.full-rate": "적재율",
+  "label.reserved-carrier": "예약된 캐리어",
+  "label.transfer-command": "이송 명령",
+  "label.parent-object-id": "상위 오브젝트",
+  "label.process-type": "공정 유형",
   "label.show-carrier-text": "캐리어 텍스트",
   "label.show-text": "텍스트 보이기",
-  "label.sub-state": "sub state",
-  "label.banned": "banned",
-  "label.type": "type",
-  "label.inout-type": "inout type",
-  "label.manual": "manual",
+  "label.sub-state": "하위 상태",
+  "label.banned": "사용 금지",
+  "label.type": "유형",
+  "label.inout-type": "입출고 유형",
+  "label.manual": "수동",
   "label.reserved": "예약됨",
   "label.occupied": "점유됨",
   "label.orientation": "방향",
@@ -52,8 +52,8 @@
   "label.shelf-legend-name": "선반",
   "label.equipment-legend-name": "장비",
   "label.node-machine": "node machine",
-  "label.nodes": "nodes",
-  "label.vehicle-animation": "vehicle animation",
+  "label.nodes": "노드",
+  "label.vehicle-animation": "차량 애니메이션",
   "label.battery-rate-legend-name": "배터리 잔량",
   "label.conveyor-orientation": "이송방향",
   "component.backdrop": "배경",
@@ -77,5 +77,46 @@
   "label.bright": "밝음",
   "label.coord-axis-x": "내부 X축",
   "label.coord-invert-x": "X 원점 반전",
-  "label.coord-invert-y": "Y 원점 반전"
+  "label.coord-invert-y": "Y 원점 반전",
+  "label.load-layout.addressing": "실시간 데이터의 주소",
+  "label.load-layout.addressing-by": "읽는 방식",
+  "label.load-layout.addressing-fields": "필드",
+  "label.load-layout.addressing-none": "주소 해석 안 함 (모든 적재 위치 미상)",
+  "label.load-layout.addressing-pattern": "위치 문자열 패턴",
+  "label.load-layout.field": "필드",
+  "label.load-layout.invalid": "저장된 적재 위치 설정이 올바르지 않습니다. 설정을 수정할 때까지 단일 적재 위치로 표시합니다.",
+  "label.load-layout.issue.ADDRESSING_BY_INVALID": "주소 해석 방식을 필드 또는 위치 문자열 패턴으로 지정해 주세요.",
+  "label.load-layout.issue.ADDRESS_PATTERN_EMPTY": "위치 문자열 패턴을 입력해 주세요.",
+  "label.load-layout.issue.ADDRESS_PATTERN_SLOT_REQUIRED": "위치 문자열 패턴에 적재 위치 토큰을 포함해 주세요.",
+  "label.load-layout.issue.ADDRESS_PATTERN_SYNTAX": "\"{text}\" 부근의 토큰 문법이 올바르지 않습니다.",
+  "label.load-layout.issue.ADDRESS_PATTERN_TOKEN_REPEATED": "{token} 토큰은 한 번만 사용할 수 있습니다.",
+  "label.load-layout.issue.ADDRESS_PATTERN_WIDTH_NOT_ALLOWED": "자릿수는 층·적재 위치 토큰에만 지정할 수 있습니다. ({token})",
+  "label.load-layout.issue.DUPLICATE_CARRIER": "동일한 캐리어가 중복 수신되었습니다: {name}",
+  "label.load-layout.issue.FIELD_REQUIRED": "필드 이름을 입력해 주세요.",
+  "label.load-layout.param-cols": "열 수",
+  "label.load-layout.param-rows": "행 수",
+  "label.load-layout.param-stackLimit": "적층 한도",
+  "label.load-layout.param-upperElevation": "위층 높이 (mm)",
+  "label.load-layout.pattern-text": "패턴",
+  "label.load-layout.preset-agv2x2": "AGV 2×2",
+  "label.load-layout.preset-agvParallel": "AGV 병렬 (좌·우)",
+  "label.load-layout.preset-agvTandem": "AGV 직렬 (앞·뒤)",
+  "label.load-layout.preset-bufferPort2x2": "버퍼 포트 2×2",
+  "label.load-layout.preset-craneTwinFork": "크레인 트윈 포크",
+  "label.load-layout.preset-dualTierConveyor": "복층 컨베이어",
+  "label.load-layout.preset-floorBlock": "평치 블록",
+  "label.load-layout.preset-kind": "종류",
+  "label.load-layout.preset-multiBufferPort": "멀티 버퍼 포트 (4)",
+  "label.load-layout.preset-note": "간격과 적재 위치 크기의 초기값은 균등 분할로 계산됩니다. 실제 설비 규격에 맞는지 확인해 주세요.",
+  "label.load-layout.preset-single": "단일 적재 위치",
+  "label.load-layout.slot-field": "적재 위치 필드",
+  "label.load-layout.source": "값의 출처",
+  "label.load-layout.source-builtin": "내장 기본값",
+  "label.load-layout.source-node": "이 홀더의 개별 설정",
+  "label.load-layout.source-none": "정의 없음 (단일 적재 위치에 적층)",
+  "label.load-layout.tier-field": "층 필드",
+  "label.load-layout.tier-field-empty": "비우면 1층",
+  "label.load-layout.title": "캐리어 적재 위치",
+  "label.load-layout.unit-missing": "도면 단위(mmPerUnit)가 정해지지 않아 물리 배치와 적재 판정을 할 수 없습니다.",
+  "label.load-layout.unit-ok": "도면 1단위 = {mm} mm"
 }

package/translations/ms.json

@@ -76,5 +76,46 @@
   "label.bright": "cerah",
   "label.coord-axis-x": "internal x axis",
   "label.coord-invert-x": "invert x origin",
-  "label.coord-invert-y": "invert y origin"
+  "label.coord-invert-y": "invert y origin",
+  "label.load-layout.addressing": "Address in live data",
+  "label.load-layout.addressing-by": "Read by",
+  "label.load-layout.addressing-fields": "Fields",
+  "label.load-layout.addressing-none": "Not read (all shown as address unknown)",
+  "label.load-layout.addressing-pattern": "Location pattern",
+  "label.load-layout.field": "Field",
+  "label.load-layout.invalid": "The saved setting is invalid. Shown as one slot until fixed.",
+  "label.load-layout.issue.ADDRESSING_BY_INVALID": "Must be fields or a location pattern",
+  "label.load-layout.issue.ADDRESS_PATTERN_EMPTY": "The pattern is empty",
+  "label.load-layout.issue.ADDRESS_PATTERN_SLOT_REQUIRED": "The pattern needs a slot token",
+  "label.load-layout.issue.ADDRESS_PATTERN_SYNTAX": "Broken token near \"{text}\"",
+  "label.load-layout.issue.ADDRESS_PATTERN_TOKEN_REPEATED": "The {token} token may appear only once",
+  "label.load-layout.issue.ADDRESS_PATTERN_WIDTH_NOT_ALLOWED": "Digits are allowed only on the tier and slot tokens, not on {token}",
+  "label.load-layout.issue.DUPLICATE_CARRIER": "The same carrier came twice: {name}",
+  "label.load-layout.issue.FIELD_REQUIRED": "A field name is required",
+  "label.load-layout.param-cols": "Columns",
+  "label.load-layout.param-rows": "Rows",
+  "label.load-layout.param-stackLimit": "Stack limit",
+  "label.load-layout.param-upperElevation": "Upper tier elevation (mm)",
+  "label.load-layout.pattern-text": "Pattern",
+  "label.load-layout.preset-agv2x2": "AGV 2×2",
+  "label.load-layout.preset-agvParallel": "AGV parallel (left/right)",
+  "label.load-layout.preset-agvTandem": "AGV tandem (front/rear)",
+  "label.load-layout.preset-bufferPort2x2": "Buffer port 2×2",
+  "label.load-layout.preset-craneTwinFork": "Crane twin fork",
+  "label.load-layout.preset-dualTierConveyor": "Dual-tier conveyor",
+  "label.load-layout.preset-floorBlock": "Floor block",
+  "label.load-layout.preset-kind": "Kind",
+  "label.load-layout.preset-multiBufferPort": "Multi-buffer port (4)",
+  "label.load-layout.preset-note": "Pitch and slot size are split evenly as starting values. Confirm them against the real equipment.",
+  "label.load-layout.preset-single": "Single slot",
+  "label.load-layout.slot-field": "Slot field",
+  "label.load-layout.source": "Source",
+  "label.load-layout.source-builtin": "Built-in default",
+  "label.load-layout.source-node": "Set on this holder",
+  "label.load-layout.source-none": "Not defined (one slot, stacked)",
+  "label.load-layout.tier-field": "Tier field",
+  "label.load-layout.tier-field-empty": "Empty = tier 1",
+  "label.load-layout.title": "Carrier load slots",
+  "label.load-layout.unit-missing": "Drawing unit is not set (mmPerUnit). Physical placement and fit checks are unavailable.",
+  "label.load-layout.unit-ok": "Drawing unit 1 = {mm} mm"
 }

package/translations/zh.json

@@ -76,5 +76,46 @@
   "label.bright": "明亮",
   "label.coord-axis-x": "内部X轴",
   "label.coord-invert-x": "X原点反转",
-  "label.coord-invert-y": "Y原点反转"
+  "label.coord-invert-y": "Y原点反转",
+  "label.load-layout.addressing": "Address in live data",
+  "label.load-layout.addressing-by": "Read by",
+  "label.load-layout.addressing-fields": "Fields",
+  "label.load-layout.addressing-none": "Not read (all shown as address unknown)",
+  "label.load-layout.addressing-pattern": "Location pattern",
+  "label.load-layout.field": "Field",
+  "label.load-layout.invalid": "The saved setting is invalid. Shown as one slot until fixed.",
+  "label.load-layout.issue.ADDRESSING_BY_INVALID": "Must be fields or a location pattern",
+  "label.load-layout.issue.ADDRESS_PATTERN_EMPTY": "The pattern is empty",
+  "label.load-layout.issue.ADDRESS_PATTERN_SLOT_REQUIRED": "The pattern needs a slot token",
+  "label.load-layout.issue.ADDRESS_PATTERN_SYNTAX": "Broken token near \"{text}\"",
+  "label.load-layout.issue.ADDRESS_PATTERN_TOKEN_REPEATED": "The {token} token may appear only once",
+  "label.load-layout.issue.ADDRESS_PATTERN_WIDTH_NOT_ALLOWED": "Digits are allowed only on the tier and slot tokens, not on {token}",
+  "label.load-layout.issue.DUPLICATE_CARRIER": "The same carrier came twice: {name}",
+  "label.load-layout.issue.FIELD_REQUIRED": "A field name is required",
+  "label.load-layout.param-cols": "Columns",
+  "label.load-layout.param-rows": "Rows",
+  "label.load-layout.param-stackLimit": "Stack limit",
+  "label.load-layout.param-upperElevation": "Upper tier elevation (mm)",
+  "label.load-layout.pattern-text": "Pattern",
+  "label.load-layout.preset-agv2x2": "AGV 2×2",
+  "label.load-layout.preset-agvParallel": "AGV parallel (left/right)",
+  "label.load-layout.preset-agvTandem": "AGV tandem (front/rear)",
+  "label.load-layout.preset-bufferPort2x2": "Buffer port 2×2",
+  "label.load-layout.preset-craneTwinFork": "Crane twin fork",
+  "label.load-layout.preset-dualTierConveyor": "Dual-tier conveyor",
+  "label.load-layout.preset-floorBlock": "Floor block",
+  "label.load-layout.preset-kind": "Kind",
+  "label.load-layout.preset-multiBufferPort": "Multi-buffer port (4)",
+  "label.load-layout.preset-note": "Pitch and slot size are split evenly as starting values. Confirm them against the real equipment.",
+  "label.load-layout.preset-single": "Single slot",
+  "label.load-layout.slot-field": "Slot field",
+  "label.load-layout.source": "Source",
+  "label.load-layout.source-builtin": "Built-in default",
+  "label.load-layout.source-node": "Set on this holder",
+  "label.load-layout.source-none": "Not defined (one slot, stacked)",
+  "label.load-layout.tier-field": "Tier field",
+  "label.load-layout.tier-field-empty": "Empty = tier 1",
+  "label.load-layout.title": "Carrier load slots",
+  "label.load-layout.unit-missing": "Drawing unit is not set (mmPerUnit). Physical placement and fit checks are unavailable.",
+  "label.load-layout.unit-ok": "Drawing unit 1 = {mm} mm"
 }