@fmsim/machine 2.0.0-beta.87 → 2.0.0-beta.89

package/dist/utils/carrier-data.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Carrier 데이터 키 정규화 — 데이터 명세의 키 대소문자가 흔들려도(CARRIERNAME /
+ * carrierName / multiCarriers / MULTICARRIERS …) 동일하게 읽기 위함.
+ *
+ * 성능: 케이스 무관 처리를 "매 읽기"가 아니라 **데이터 진입 경계에서 1회**만 수행.
+ * 이후 다운스트림은 캐노니컬(대문자) 키를 평범한 O(1) 직접 접근으로 읽는다.
+ */
+import { ciGet } from './crane-position';
+/** 다중 carrier 배열의 캐노니컬 키. (구 명세의 ADDITIONS 는 더 이상 지원하지 않음) */
+export const MULTI_CARRIER_KEY = 'multiCarriers';
+/** carrier 식별 4 키 — 캐노니컬(대문자) 표기. */
+const CARRIER_FIELDS = ['CARRIERNAME', 'CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'];
+const FIELD_BY_LOWER = new Map(CARRIER_FIELDS.map(f => [f.toLowerCase(), f]));
+/**
+ * carrier 객체의 키를 캐노니컬(대문자)로 승격 — 식별 4 키만 매핑하고 값/기타 키는 보존.
+ * 대소문자 무관 (carrierName → CARRIERNAME). 비객체면 그대로 반환.
+ */
+export function normalizeCarrierItem(raw) {
+    var _a;
+    if (!raw || typeof raw !== 'object')
+        return raw;
+    const out = {};
+    for (const k of Object.keys(raw)) {
+        out[(_a = FIELD_BY_LOWER.get(k.toLowerCase())) !== null && _a !== void 0 ? _a : k] = raw[k];
+    }
+    return out;
+}
+/**
+ * holder.data 정규화 (진입 경계 1회):
+ *  - 대표 carrier 4 키를 캐노니컬로 승격
+ *  - 다중 carrier 배열을 캐노니컬 키 `multiCarriers` 로 통일 (대소문자 무관), 각 항목도 정규화
+ *
+ * 비객체면 그대로 반환. 정규화 결과는 idempotent (이미 캐노니컬이면 동일 형태).
+ */
+export function normalizeCarrierData(raw) {
+    var _a;
+    if (!raw || typeof raw !== 'object')
+        return raw;
+    const multiLower = MULTI_CARRIER_KEY.toLowerCase();
+    const out = {};
+    for (const k of Object.keys(raw)) {
+        // 다중 carrier 배열 키는 아래에서 캐노니컬로 통일 처리하므로 여기선 건너뜀.
+        if (k.toLowerCase() === multiLower)
+            continue;
+        out[(_a = FIELD_BY_LOWER.get(k.toLowerCase())) !== null && _a !== void 0 ? _a : k] = raw[k];
+    }
+    const list = ciGet(raw, MULTI_CARRIER_KEY);
+    if (Array.isArray(list)) {
+        out[MULTI_CARRIER_KEY] = list.map(normalizeCarrierItem);
+    }
+    return out;
+}
+//# sourceMappingURL=carrier-data.js.map

package/dist/utils/carrier-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carrier-data.js","sourceRoot":"","sources":["../../src/utils/carrier-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAExC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAA;AAEhD,qCAAqC;AACrC,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,CAAU,CAAA;AAC5F,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAE7E;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAQ;;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAC/C,MAAM,GAAG,GAAQ,EAAE,CAAA;IACnB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,MAAA,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,mCAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAQ;;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAE/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAA;IAClD,MAAM,GAAG,GAAQ,EAAE,CAAA;IACnB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,gDAAgD;QAChD,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU;YAAE,SAAQ;QAC5C,GAAG,CAAC,MAAA,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,mCAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAA;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Carrier 데이터 키 정규화 — 데이터 명세의 키 대소문자가 흔들려도(CARRIERNAME /\n * carrierName / multiCarriers / MULTICARRIERS …) 동일하게 읽기 위함.\n *\n * 성능: 케이스 무관 처리를 \"매 읽기\"가 아니라 **데이터 진입 경계에서 1회**만 수행.\n * 이후 다운스트림은 캐노니컬(대문자) 키를 평범한 O(1) 직접 접근으로 읽는다.\n */\n\nimport { ciGet } from './crane-position'\n\n/** 다중 carrier 배열의 캐노니컬 키. (구 명세의 ADDITIONS 는 더 이상 지원하지 않음) */\nexport const MULTI_CARRIER_KEY = 'multiCarriers'\n\n/** carrier 식별 4 키 — 캐노니컬(대문자) 표기. */\nconst CARRIER_FIELDS = ['CARRIERNAME', 'CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'] as const\nconst FIELD_BY_LOWER = new Map(CARRIER_FIELDS.map(f => [f.toLowerCase(), f]))\n\n/**\n * carrier 객체의 키를 캐노니컬(대문자)로 승격 — 식별 4 키만 매핑하고 값/기타 키는 보존.\n * 대소문자 무관 (carrierName → CARRIERNAME). 비객체면 그대로 반환.\n */\nexport function normalizeCarrierItem(raw: any): any {\n  if (!raw || typeof raw !== 'object') return raw\n  const out: any = {}\n  for (const k of Object.keys(raw)) {\n    out[FIELD_BY_LOWER.get(k.toLowerCase()) ?? k] = raw[k]\n  }\n  return out\n}\n\n/**\n * holder.data 정규화 (진입 경계 1회):\n *  - 대표 carrier 4 키를 캐노니컬로 승격\n *  - 다중 carrier 배열을 캐노니컬 키 `multiCarriers` 로 통일 (대소문자 무관), 각 항목도 정규화\n *\n * 비객체면 그대로 반환. 정규화 결과는 idempotent (이미 캐노니컬이면 동일 형태).\n */\nexport function normalizeCarrierData(raw: any): any {\n  if (!raw || typeof raw !== 'object') return raw\n\n  const multiLower = MULTI_CARRIER_KEY.toLowerCase()\n  const out: any = {}\n  for (const k of Object.keys(raw)) {\n    // 다중 carrier 배열 키는 아래에서 캐노니컬로 통일 처리하므로 여기선 건너뜀.\n    if (k.toLowerCase() === multiLower) continue\n    out[FIELD_BY_LOWER.get(k.toLowerCase()) ?? k] = raw[k]\n  }\n\n  const list = ciGet(raw, MULTI_CARRIER_KEY)\n  if (Array.isArray(list)) {\n    out[MULTI_CARRIER_KEY] = list.map(normalizeCarrierItem)\n  }\n\n  return out\n}\n"]}

package/dist/utils/crane-position.js

@@ -0,0 +1,96 @@
+/*
+ * Crane 위치 데이터 (data.cranePosition) 변환 유틸.
+ *
+ * 명세:
+ *   {
+ *     cranePosition: {
+ *       current: { x, y, z },               // 실 좌표값
+ *       limit: { x:{min,max}, y:{min,max}, z:{min,max} }  // 각 축 한계
+ *     }
+ *   }
+ *
+ * current 를 limit 범위 안의 0~1 비율로 환산한 뒤 host(부모) footprint 에 매핑한다.
+ * x → host 긴쪽, y → 짧은쪽, z → 포크 높이(forkZ 0~100).
+ */
+/**
+ * current 값을 limit 범위 안에서 0~1 비율로 환산.
+ * limit 누락 / 0 span / 비정상 입력 시 0 반환 (안전 fallback).
+ */
+export function axisRatio(value, lim) {
+    const v = Number(value);
+    const min = Number(lim === null || lim === void 0 ? void 0 : lim.min) || 0;
+    const max = Number(lim === null || lim === void 0 ? void 0 : lim.max);
+    if (!Number.isFinite(v) || !Number.isFinite(max) || max === min)
+        return 0;
+    return Math.max(0, Math.min(1, (v - min) / (max - min)));
+}
+/**
+ * host(부모) footprint 안에서 0~1 비율 (rx,ry) → 크레인 top-left 로컬 좌표.
+ *
+ * **스토커 안쪽 오프셋**: 크레인의 폭/두께를 감안해, 크레인 *전체* 가 host 안에
+ * 머무르도록 top-left 좌표를 [0, hostLen - craneLen] 범위로 매핑한다 (= 양끝에서
+ * craneLen/2 만큼 inset 된 중심선 위를 움직임). 크레인이 host 보다 크면 span 0
+ * 으로 떨어져 host 모서리에 정렬.
+ *
+ * x(rx) 는 host 의 긴쪽, y(ry) 는 짧은쪽에 매핑 (가상 rail 은 host 긴쪽 방향).
+ */
+export function mapCraneLocalPosition(hostW, hostH, craneW, craneH, rx, ry) {
+    const longIsWidth = hostW >= hostH;
+    const longLen = longIsWidth ? hostW : hostH;
+    const shortLen = longIsWidth ? hostH : hostW;
+    const craneLongSize = longIsWidth ? craneW : craneH;
+    const craneShortSize = longIsWidth ? craneH : craneW;
+    // 크레인 크기를 뺀 inset 가용 span. top-left = ratio * span 이므로 크레인
+    // 전체가 host [0, hostLen] 안에 들어온다.
+    const longSpan = Math.max(0, longLen - craneLongSize);
+    const shortSpan = Math.max(0, shortLen - craneShortSize);
+    const longPos = rx * longSpan;
+    const shortPos = ry * shortSpan;
+    return {
+        left: longIsWidth ? longPos : shortPos,
+        top: longIsWidth ? shortPos : longPos
+    };
+}
+/**
+ * 객체에서 key 를 **대소문자 무관**으로 찾아 값 반환 (정확 매치 우선, 없으면 소문자 비교).
+ * 데이터 명세의 키 대소문자가 흔들려도(cranePosition / CRANEPOSITION / DURATION_MS …)
+ * 동일하게 읽기 위함. 매치 없으면 undefined.
+ */
+export function ciGet(obj, key) {
+    if (!obj || typeof obj !== 'object')
+        return undefined;
+    if (key in obj)
+        return obj[key];
+    const lower = key.toLowerCase();
+    for (const k of Object.keys(obj)) {
+        if (k.toLowerCase() === lower)
+            return obj[k];
+    }
+    return undefined;
+}
+/**
+ * 객체 키를 재귀적으로 소문자화한 사본 반환 (배열/원시값은 그대로, 값은 변형 안 함).
+ * 중첩 키(current/limit/x/y/z/min/max)를 대소문자 무관으로 접근하기 위한 정규화.
+ */
+export function lowerKeysDeep(value) {
+    if (Array.isArray(value))
+        return value.map(v => lowerKeysDeep(v));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const k of Object.keys(value)) {
+            out[k.toLowerCase()] = lowerKeysDeep(value[k]);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * raw cranePosition (키 대소문자 무관) → 캐노니컬 소문자 키 구조(CranePositionData).
+ * 이후 current.x / limit.x.min 등 소문자 키로 안전하게 접근 가능. 비객체면 undefined.
+ */
+export function normalizeCranePosition(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    return lowerKeysDeep(raw);
+}
+//# sourceMappingURL=crane-position.js.map

package/dist/utils/crane-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crane-position.js","sourceRoot":"","sources":["../../src/utils/crane-position.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Crane 위치 데이터 (data.cranePosition) 변환 유틸.\n *\n * 명세:\n *   {\n *     cranePosition: {\n *       current: { x, y, z },               // 실 좌표값\n *       limit: { x:{min,max}, y:{min,max}, z:{min,max} }  // 각 축 한계\n *     }\n *   }\n *\n * current 를 limit 범위 안의 0~1 비율로 환산한 뒤 host(부모) footprint 에 매핑한다.\n * x → host 긴쪽, y → 짧은쪽, z → 포크 높이(forkZ 0~100).\n */\n\n/** 축별 한계 (cranePosition.limit.{x|y|z}). */\nexport interface AxisLimit {\n  min?: number\n  max?: number\n}\n\n/** 새 데이터 명세 — data.cranePosition. */\nexport interface CranePositionData {\n  current?: { x?: number; y?: number; z?: number }\n  limit?: { x?: AxisLimit; y?: AxisLimit; z?: AxisLimit }\n}\n\n/**\n * current 값을 limit 범위 안에서 0~1 비율로 환산.\n * limit 누락 / 0 span / 비정상 입력 시 0 반환 (안전 fallback).\n */\nexport function axisRatio(value: unknown, lim?: AxisLimit): number {\n  const v = Number(value)\n  const min = Number(lim?.min) || 0\n  const max = Number(lim?.max)\n  if (!Number.isFinite(v) || !Number.isFinite(max) || max === min) return 0\n  return Math.max(0, Math.min(1, (v - min) / (max - min)))\n}\n\n/**\n * host(부모) footprint 안에서 0~1 비율 (rx,ry) → 크레인 top-left 로컬 좌표.\n *\n * **스토커 안쪽 오프셋**: 크레인의 폭/두께를 감안해, 크레인 *전체* 가 host 안에\n * 머무르도록 top-left 좌표를 [0, hostLen - craneLen] 범위로 매핑한다 (= 양끝에서\n * craneLen/2 만큼 inset 된 중심선 위를 움직임). 크레인이 host 보다 크면 span 0\n * 으로 떨어져 host 모서리에 정렬.\n *\n * x(rx) 는 host 의 긴쪽, y(ry) 는 짧은쪽에 매핑 (가상 rail 은 host 긴쪽 방향).\n */\nexport function mapCraneLocalPosition(\n  hostW: number,\n  hostH: number,\n  craneW: number,\n  craneH: number,\n  rx: number,\n  ry: number\n): { left: number; top: number } {\n  const longIsWidth = hostW >= hostH\n  const longLen = longIsWidth ? hostW : hostH\n  const shortLen = longIsWidth ? hostH : hostW\n  const craneLongSize = longIsWidth ? craneW : craneH\n  const craneShortSize = longIsWidth ? craneH : craneW\n\n  // 크레인 크기를 뺀 inset 가용 span. top-left = ratio * span 이므로 크레인\n  // 전체가 host [0, hostLen] 안에 들어온다.\n  const longSpan = Math.max(0, longLen - craneLongSize)\n  const shortSpan = Math.max(0, shortLen - craneShortSize)\n  const longPos = rx * longSpan\n  const shortPos = ry * shortSpan\n\n  return {\n    left: longIsWidth ? longPos : shortPos,\n    top: longIsWidth ? shortPos : longPos\n  }\n}\n\n/**\n * 객체에서 key 를 **대소문자 무관**으로 찾아 값 반환 (정확 매치 우선, 없으면 소문자 비교).\n * 데이터 명세의 키 대소문자가 흔들려도(cranePosition / CRANEPOSITION / DURATION_MS …)\n * 동일하게 읽기 위함. 매치 없으면 undefined.\n */\nexport function ciGet(obj: any, key: string): any {\n  if (!obj || typeof obj !== 'object') return undefined\n  if (key in obj) return obj[key]\n  const lower = key.toLowerCase()\n  for (const k of Object.keys(obj)) {\n    if (k.toLowerCase() === lower) return obj[k]\n  }\n  return undefined\n}\n\n/**\n * 객체 키를 재귀적으로 소문자화한 사본 반환 (배열/원시값은 그대로, 값은 변형 안 함).\n * 중첩 키(current/limit/x/y/z/min/max)를 대소문자 무관으로 접근하기 위한 정규화.\n */\nexport function lowerKeysDeep<T = any>(value: any): T {\n  if (Array.isArray(value)) return value.map(v => lowerKeysDeep(v)) as any\n  if (value && typeof value === 'object') {\n    const out: Record<string, any> = {}\n    for (const k of Object.keys(value)) {\n      out[k.toLowerCase()] = lowerKeysDeep(value[k])\n    }\n    return out as T\n  }\n  return value as T\n}\n\n/**\n * raw cranePosition (키 대소문자 무관) → 캐노니컬 소문자 키 구조(CranePositionData).\n * 이후 current.x / limit.x.min 등 소문자 키로 안전하게 접근 가능. 비객체면 undefined.\n */\nexport function normalizeCranePosition(raw: any): CranePositionData | undefined {\n  if (!raw || typeof raw !== 'object') return undefined\n  return lowerKeysDeep<CranePositionData>(raw)\n}\n"]}

package/dist/utils/fit-gauge-scale.js

@@ -0,0 +1,28 @@
+/**
+ * 스토커 지붕 위 용량 게이지 바의 비례 축소 계수를 계산한다.
+ *
+ * 정책:
+ *   - 게이지 바의 *최대* 크기는 maxW × maxH. 스토커가 충분히 크면 이 크기 그대로 (계수 1).
+ *   - 스토커가 그보다 작으면 지붕 footprint 안에 들어오도록 *비례* 축소 (uniform).
+ *   - *확대는 하지 않는다* (계수 상한 1) — 현재 크기가 상한이라는 요구사항.
+ *
+ * 방향 매핑: 바의 가로축(maxW)은 스토커의 *장축*에 정렬된다 (buildGauge 의
+ * `isWidthLonger ? geo.rotateY` 처리와 일치). 따라서 가용 치수도 그 기준으로 매칭한다.
+ *
+ * @param w 스토커 footprint 가로 (월드 단위)
+ * @param h 스토커 footprint 세로 (월드 단위)
+ * @param maxW 게이지 바 최대 가로
+ * @param maxH 게이지 바 최대 세로
+ * @param margin 지붕 가장자리 여백 비율 (0~1, 기본 0.85)
+ * @returns 0 < scale <= 1
+ */
+export function fitGaugeScale(w, h, maxW, maxH, margin = 0.85) {
+    const isWidthLonger = w >= h;
+    // 바 가로축(maxW)이 정렬되는 스토커 치수 = 장축, 세로축(maxH) = 단축
+    const availAlongW = isWidthLonger ? w : h;
+    const availAlongH = isWidthLonger ? h : w;
+    const scale = Math.min(1, (availAlongW * margin) / maxW, (availAlongH * margin) / maxH);
+    // 음수/NaN 방어 — 0 이하로 떨어지면 안 됨
+    return scale > 0 && Number.isFinite(scale) ? scale : 1;
+}
+//# sourceMappingURL=fit-gauge-scale.js.map

package/dist/utils/fit-gauge-scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-gauge-scale.js","sourceRoot":"","sources":["../../src/utils/fit-gauge-scale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAC3B,CAAS,EACT,CAAS,EACT,IAAY,EACZ,IAAY,EACZ,SAAiB,IAAI;IAErB,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,CAAA;IAC5B,gDAAgD;IAChD,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IAEvF,6BAA6B;IAC7B,OAAO,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACxD,CAAC","sourcesContent":["/**\n * 스토커 지붕 위 용량 게이지 바의 비례 축소 계수를 계산한다.\n *\n * 정책:\n *   - 게이지 바의 *최대* 크기는 maxW × maxH. 스토커가 충분히 크면 이 크기 그대로 (계수 1).\n *   - 스토커가 그보다 작으면 지붕 footprint 안에 들어오도록 *비례* 축소 (uniform).\n *   - *확대는 하지 않는다* (계수 상한 1) — 현재 크기가 상한이라는 요구사항.\n *\n * 방향 매핑: 바의 가로축(maxW)은 스토커의 *장축*에 정렬된다 (buildGauge 의\n * `isWidthLonger ? geo.rotateY` 처리와 일치). 따라서 가용 치수도 그 기준으로 매칭한다.\n *\n * @param w 스토커 footprint 가로 (월드 단위)\n * @param h 스토커 footprint 세로 (월드 단위)\n * @param maxW 게이지 바 최대 가로\n * @param maxH 게이지 바 최대 세로\n * @param margin 지붕 가장자리 여백 비율 (0~1, 기본 0.85)\n * @returns 0 < scale <= 1\n */\nexport function fitGaugeScale(\n  w: number,\n  h: number,\n  maxW: number,\n  maxH: number,\n  margin: number = 0.85\n): number {\n  const isWidthLonger = w >= h\n  // 바 가로축(maxW)이 정렬되는 스토커 치수 = 장축, 세로축(maxH) = 단축\n  const availAlongW = isWidthLonger ? w : h\n  const availAlongH = isWidthLonger ? h : w\n\n  const scale = Math.min(1, (availAlongW * margin) / maxW, (availAlongH * margin) / maxH)\n\n  // 음수/NaN 방어 — 0 이하로 떨어지면 안 됨\n  return scale > 0 && Number.isFinite(scale) ? scale : 1\n}\n"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fmsim/machine",
   "description": "Layout View를 구성하는 설비(machine)들과 유닛을 구현한 모듈입니다.",
   "author": "heartyoh",
-  "version": "2.0.0-beta.87",
+  "version": "2.0.0-beta.89",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "things-scene": true,
@@ -26,7 +26,7 @@
     "migration": "things-factory-migration"
   },
   "dependencies": {
-    "@fmsim/api": "^2.0.0-beta.84",
+    "@fmsim/api": "^2.0.0-beta.88",
     "@hatiolab/things-scene": "^10.0.0-beta.1"
   },
   "devDependencies": {
@@ -55,5 +55,5 @@
       "prettier --write"
     ]
   },
-  "gitHead": "3d1cc31e42d90dc514506aa1e85b34660144d89f"
+  "gitHead": "e65994c03e8dc1c33b4466a61f12e9135f1bc59f"
 }

package/src/agv.ts

@@ -33,6 +33,11 @@ export default class AGV extends MCSVehicle {
     return 'black'
   }
 
+  /** AGV 의 parentObject 는 AGVLine. */
+  get parentObjectTypes(): string[] {
+    return ['AGVLine']
+  }
+
   getLegendFallback() {
     return (this.root as any).agvLegendTheme || super.getLegendFallback()
   }

package/src/carrier-manager.ts

@@ -1,6 +1,7 @@
 import { Model } from '@hatiolab/things-scene'
 import type Carrier from './carrier'
 import type MCSCarrierHolder from './mcs-carrier-holder'
+import { normalizeCarrierData, MULTI_CARRIER_KEY } from './utils/carrier-data'
 
 // 사라진 carrier 의 dispose 지연. 같은 macrotask 안에서 holder A 의 사라짐
 // 보고와 holder B 의 등장 보고가 순차로 들어오는 reparent 시나리오 (= 같은
@@ -57,6 +58,11 @@ export default class CarrierManager {
    *     holder 가 같은 이름을 보고하면 cancel 되어 reparent 로 전환.
    */
   update(holder: MCSCarrierHolder, after: Record<string, any>, before: Record<string, any>): void {
+    // 진입 경계 1회 정규화 — 키 대소문자 무관 + multiCarriers 통일 (idempotent).
+    // 이후 _buildStack / diffing 은 캐노니컬 키를 O(1) 직접 접근으로 읽는다.
+    after = normalizeCarrierData(after)
+    before = normalizeCarrierData(before)
+
     const afterStack = this._buildStack(after)
     const beforeStack = this._buildStack(before)
 
@@ -127,16 +133,17 @@ export default class CarrierManager {
   }
 
   /**
-   * data.CARRIERNAME (대표) + data.ADDITIONS[] 를 하나의 stack list 로 정규화.
-   * 적층 순서: ADDITIONS[0..n-1] (bottom → up) + 대표 (top, 맨 마지막).
+   * data.CARRIERNAME (대표) + data.multiCarriers[] 를 하나의 stack list 로 정규화.
+   * 적층 순서: multiCarriers[0..n-1] (bottom → up) + 대표 (top, 맨 마지막).
+   * (data 는 update() 에서 이미 정규화되어 캐노니컬 키 + multiCarriers 로 통일된 상태)
    */
   private _buildStack(data: any): CarrierStackItem[] {
     if (!data) return []
 
     const stack: CarrierStackItem[] = []
 
-    if (Array.isArray(data.ADDITIONS)) {
-      for (const a of data.ADDITIONS) {
+    if (Array.isArray(data[MULTI_CARRIER_KEY])) {
+      for (const a of data[MULTI_CARRIER_KEY]) {
         if (a && typeof a === 'object' && a.CARRIERNAME) {
           // 항목 *원본 그대로* — 외부 시스템이 임의 키를 추가로 보낼 수 있고,
           // 누락된 4 키는 default 없이 그대로 비워둔다 (carrier.data 에 흘리는

package/src/crane.ts

@@ -1,6 +1,13 @@
 import { Component, ComponentNature, sceneComponent, frameClock } from '@hatiolab/things-scene'
 import MCSVehicle from './mcs-vehicle'
 import { LEGEND_CRANE } from './features/mcs-status-default'
+import {
+  axisRatio,
+  mapCraneLocalPosition,
+  ciGet,
+  normalizeCranePosition,
+  type CranePositionData
+} from './utils/crane-position'
 
 const NATURE: ComponentNature = {
   mutable: false,
@@ -14,10 +21,6 @@ const GAP = 2
 /** 좌표 보간 기본 duration (ms). data.DURATION_MS 가 없으면 이 값 사용. */
 const DEFAULT_DURATION_MS = 1000
 
-function clamp01(v: number): number {
-  return Math.max(0, Math.min(100, Number(v) || 0))
-}
-
 function lerp(a: number, b: number, t: number): number {
   return a + (b - a) * t
 }
@@ -48,6 +51,11 @@ export default class Crane extends MCSVehicle {
     return 'black'
   }
 
+  /** Crane 의 parentObject 는 STOCKER. */
+  get parentObjectTypes(): string[] {
+    return ['STOCKER']
+  }
+
   getLegendFallback() {
     return (this.root as any).craneLegendTheme || super.getLegendFallback()
   }
@@ -55,29 +63,36 @@ export default class Crane extends MCSVehicle {
   private _posAnimator?: CranePositionAnimator
 
   /**
-   * data.POSITION = { X, Y, Z } (각 0~100 정규화) 분기. Stocker 부모 기준으로
-   * 실 좌표 (state.left/top) 와 forkZ 로 변환해 lerp 시작. 보간 중 새 값이
-   * 들어오면 *현재 보간 위치* 를 from 으로 잡고 새 target 으로 새 lerp 시작.
-   * NODEID 경로는 super (MCSVehicle.onchangeData) 가 처리 — POSITION 만 있는
+   * data.cranePosition = { current: {x,y,z}, limit: {x|y|z:{min,max}} } 분기.
+   * current 를 limit 범위 안의 0~1 비율로 환산한 뒤, 부모 (보통 Stocker) 기준으로
+   * 실 좌표 (state.left/top) 와 forkZ 로 변환해 lerp 시작. x→host 긴쪽, y→짧은쪽,
+   * z→포크 높이. 보간 중 새 값이 들어오면 *현재 보간 위치* 를 from 으로 잡고 새
+   * target 으로 새 lerp 시작.
+   * NODEID 경로는 super (MCSVehicle.onchangeData) 가 처리 — cranePosition 만 있는
    * 데이터에선 NODEID 가 없어 자연스럽게 noop.
    */
   onchangeData(after: Record<string, any>, before: Record<string, any>): void {
     const afterData = after?.data
-    const beforeData = before?.data
-    const afterPos = afterData?.POSITION
-    if (afterPos && typeof afterPos === 'object') {
-      const beforePos = beforeData?.POSITION
-      const changed =
-        afterPos.X !== beforePos?.X ||
-        afterPos.Y !== beforePos?.Y ||
-        afterPos.Z !== beforePos?.Z
-      if (changed) {
-        this._startPositionAnimation(afterPos, afterData?.DURATION_MS)
+    // 데이터 명세 키 대소문자 무관: cranePosition / DURATION_MS 및 중첩 키(current/limit/x/y/z/min/max).
+    const afterCP = normalizeCranePosition(ciGet(afterData, 'cranePosition'))
+    if (afterCP) {
+      const beforeCP = normalizeCranePosition(ciGet(before?.data, 'cranePosition'))
+      if (this._cranePositionChanged(afterCP, beforeCP)) {
+        this._startPositionAnimation(afterCP, ciGet(afterData, 'DURATION_MS'))
       }
     }
     super.onchangeData(after, before)
   }
 
+  /** current 또는 limit 중 하나라도 바뀌면 재계산 필요 (limit 변화도 실 위치를 바꿈). */
+  private _cranePositionChanged(a: CranePositionData, b?: CranePositionData): boolean {
+    if (!b) return true
+    return (
+      JSON.stringify(a?.current ?? null) !== JSON.stringify(b?.current ?? null) ||
+      JSON.stringify(a?.limit ?? null) !== JSON.stringify(b?.limit ?? null)
+    )
+  }
+
   dispose() {
     if (this._posAnimator) {
       this._posAnimator.unsubscribe()
@@ -86,12 +101,9 @@ export default class Crane extends MCSVehicle {
     super.dispose()
   }
 
-  private _startPositionAnimation(
-    pos: { X: number; Y: number; Z: number },
-    durationMs?: number
-  ): void {
-    const target = this._normalizedToReal(pos)
-    if (!target) return // 부모가 Stocker 아니면 변환 skip
+  private _startPositionAnimation(cranePosition: CranePositionData, durationMs?: number): void {
+    const target = this._ratioToReal(cranePosition)
+    if (!target) return // 부모(host) 없거나 크기 0 이면 변환 skip
 
     const now = frameClock.simTime
     const duration = Math.max(1, Number(durationMs) || DEFAULT_DURATION_MS)
@@ -150,20 +162,26 @@ export default class Crane extends MCSVehicle {
   }
 
   /**
-   * 0~100 정규화 좌표 → state.left/top + forkZ.
+   * cranePosition (current + limit) → state.left/top + forkZ.
    *
    * 부모 오브젝트 (보통은 Stocker 이지만 다른 컨테이너일 수도) 의 width/height
-   * 만 사용해 좌표 매핑 — 타입 무관 일반화. 가상 rail 은 host 의 긴쪽 중심부
-   * 가정:
-   *   - 데이터.X → host 의 긴쪽 (자동 판별: max(width, height))
-   *   - 데이터.Y → 짧은쪽 (rail 중심 = 50 근처가 일반적)
-   *   - 데이터.Z → forkZ (state 에 0~100 그대로 저장, 3D 측에서 mast 비율로 매핑)
+   * 만 사용해 좌표 매핑 — 타입 무관 일반화. 가상 rail 은 host 의 긴쪽:
+   *   - current.x → host 의 긴쪽 (자동 판별: max(width, height))
+   *   - current.y → 짧은쪽
+   *   - current.z → forkZ (state 에 0~100 으로 저장, 3D 측에서 mast 비율로 매핑)
+   *
+   * 각 축 비율 = (current - limit.min) / (limit.max - limit.min) ∈ [0,1].
+   *
+   * **스토커 안쪽 오프셋**: 크레인의 폭/두께를 감안해, 크레인 *전체* 가 host 안에
+   * 머무르도록 top-left 좌표를 [0, hostLen - craneLen] 범위로 매핑한다 (= 양끝에서
+   * craneLen/2 만큼 inset 된 중심선 위를 움직임). 크레인이 host 보다 크면 span 0
+   * 으로 떨어져 host 모서리에 정렬.
    *
    * 참조는 ParentObjectMixin 이 제공하는 `parentObject` 사용 —
    * state.parentObjectId 명시 시 그것, 미명시 시 this.parent 자동 fallback.
    */
-  private _normalizedToReal(
-    pos: { X: number; Y: number; Z: number }
+  private _ratioToReal(
+    cp: CranePositionData
   ): { left: number; top: number; forkZ: number } | undefined {
     const host: any = (this as any).parentObject
     if (!host) return undefined
@@ -174,24 +192,16 @@ export default class Crane extends MCSVehicle {
     const ch = Number(this.state.height) || 0
     if (!hw || !hh) return undefined
 
-    const longIsWidth = hw >= hh
-    const longLen = longIsWidth ? hw : hh
-    const shortLen = longIsWidth ? hh : hw
-    const craneLongSize = longIsWidth ? cw : ch
-    const craneShortSize = longIsWidth ? ch : cw
-
-    const X = clamp01(pos.X)
-    const Y = clamp01(pos.Y)
+    const rx = axisRatio(cp.current?.x, cp.limit?.x)
+    const ry = axisRatio(cp.current?.y, cp.limit?.y)
+    const rz = axisRatio(cp.current?.z, cp.limit?.z)
 
-    // crane 의 *center* 가 (X/100)*longLen, (Y/100)*shortLen 에 오도록.
-    // state.left/top 은 top-left 기준이므로 size/2 차감.
-    const longPos = (X / 100) * longLen - craneLongSize / 2
-    const shortPos = (Y / 100) * shortLen - craneShortSize / 2
+    const { left, top } = mapCraneLocalPosition(hw, hh, cw, ch, rx, ry)
 
     return {
-      left: longIsWidth ? longPos : shortPos,
-      top: longIsWidth ? shortPos : longPos,
-      forkZ: clamp01(pos.Z)
+      left,
+      top,
+      forkZ: rz * 100 // forkZ 0~100, 3D 측 (crane-3d) 에서 mast 비율로 매핑
     }
   }
 

package/src/factories/machine-3d.ts

@@ -14,6 +14,7 @@ import { RealObjectGroup, registerRealObjectFactory, disposeObject3D } from '@ha
 import type { Component } from '@hatiolab/things-scene'
 import { LEGEND_CAPACITY } from '../features/mcs-status-default'
 import { getValueOnRanges } from '../utils/get-value-on-ranges'
+import { fitGaugeScale } from '../utils/fit-gauge-scale'
 import { Z_FMSIM } from './z-priority'
 
 // ── 설정 타입 ────────────────────────────────────────────
@@ -667,12 +668,20 @@ class StockerRealObject3D extends MCSRealObject3D {
     const depth = this.effectiveDepth
     const isWidthLonger = w >= h
 
-    // 게이지 캔버스 (고해상도)
-    const barW = 130
-    const barH = 26
+    // 게이지 최대 크기 (스토커가 충분히 크면 이 크기 그대로 사용).
+    const MAX_BAR_W = 130
+    const MAX_BAR_H = 26
+
+    // 스토커 지붕 footprint 에 맞춰 비례 축소 (확대는 안 함 — 현재 크기가 상한).
+    const fit = fitGaugeScale(w, h, MAX_BAR_W, MAX_BAR_H)
+
+    // PlaneGeometry 의 월드 크기는 clamp, 텍스처 캔버스 해상도는 최대 크기 기준 고정
+    // (축소되어도 선명도 유지).
+    const barW = MAX_BAR_W * fit
+    const barH = MAX_BAR_H * fit
     const scale = 4
-    const canvasW = barW * scale
-    const canvasH = barH * scale
+    const canvasW = MAX_BAR_W * scale
+    const canvasH = MAX_BAR_H * scale
     const canvas = document.createElement('canvas')
     canvas.width = canvasW
     canvas.height = canvasH

package/src/features/parent-object-mixin.ts

@@ -4,13 +4,12 @@ import { Component } from '@hatiolab/things-scene'
 import MCSMachine from '../mcs-machine'
 import MCSUnit from '../mcs-unit'
 
-export const ParentObjectMixinProperties = [
-  {
-    type: 'string',
-    label: 'parent-object-id',
-    name: 'parentObjectId'
-  }
-]
+/**
+ * parentObjectId 는 generic property builder 가 아니라 property-sidebar 의 모델 참조
+ * 룩업(ox-input-entity-id, parentObjectTypes 기준 씬 머신/유닛 선택)으로 렌더한다.
+ * 따라서 NATURE 속성 목록에서는 제외 — 빈 배열.
+ */
+export const ParentObjectMixinProperties: any[] = []
 
 export function ParentObjectMixin<TBase extends Constructor<Component>>(Base: TBase): any {
   return class extends Base {
@@ -32,5 +31,15 @@ export function ParentObjectMixin<TBase extends Constructor<Component>>(Base: TB
         return parent
       }
     }
+
+    /**
+     * parentObjectId 가 참조하는 모델 컴포넌트 타입들 — parentObject 후보를 모델(씬)에서
+     * 수집할 때 이 타입들로 거른다 (머신/유닛 무관, 복수 허용).
+     * 빈 배열(기본) 이면 모델의 모든 머신 (폴백). 참조 타입이 정해진 컴포넌트는 override:
+     *   AGV→['AGVLine'], OHT→['OHTLine'], Crane/Shelf→['STOCKER'], PortFlow→['Port'].
+     */
+    get parentObjectTypes(): string[] {
+      return []
+    }
   }
 }

package/src/mcs-carrier-holder.ts

@@ -1,16 +1,17 @@
 import { themesColorMap, themesAnimationMap } from '@fmsim/api'
 import MCSUnit from './mcs-unit.js'
+import { normalizeCarrierData, MULTI_CARRIER_KEY } from './utils/carrier-data'
 
 /**
- * Holder.data 변경 감지 시 carrierManager 에 전달할 4 키 묶음 + ADDITIONS 배열.
- * 비교 결과 단 하나라도 다르면 carrierManager.update 호출.
+ * Holder.data 변경 감지 시 carrierManager 에 전달할 4 키 묶음 + multiCarriers 배열.
+ * 비교 결과 단 하나라도 다르면 carrierManager.update 호출. (정규화된 캐노니컬 데이터로 비교)
  */
 const CARRIER_DATA_KEYS = ['CARRIERNAME', 'CARRIERTYPE', 'EMPTYTYPE', 'CARRIERSTATUS'] as const
 
-function additionsChanged(a: any, b: any): boolean {
+function multiCarriersChanged(a: any, b: any): boolean {
   // shallow JSON 비교로 충분 — 각 항목이 4 키 primitive 만 가짐. 깊은 ref 비교
   // 보다 빠르고 정확. 빈/누락은 같은 '[]' 직렬화로 동치 취급.
-  return JSON.stringify(a?.ADDITIONS ?? []) !== JSON.stringify(b?.ADDITIONS ?? [])
+  return JSON.stringify(a?.[MULTI_CARRIER_KEY] ?? []) !== JSON.stringify(b?.[MULTI_CARRIER_KEY] ?? [])
 }
 
 export default class MCSCarrierHolder extends MCSUnit {
@@ -68,8 +69,9 @@ export default class MCSCarrierHolder extends MCSUnit {
   }
 
   onchangeData(after: Record<string, any>, before: Record<string, any>): void {
-    const afterData = after.data || {}
-    const beforeData = before.data || {}
+    // 진입 경계 1회 정규화 — 키 대소문자 무관 + multiCarriers 통일. 이후 비교/update 는 캐노니컬 O(1).
+    const afterData = normalizeCarrierData(after.data || {})
+    const beforeData = normalizeCarrierData(before.data || {})
 
     let changed = false
     for (const k of CARRIER_DATA_KEYS) {
@@ -79,7 +81,7 @@ export default class MCSCarrierHolder extends MCSUnit {
       }
     }
     if (!changed) {
-      changed = additionsChanged(afterData, beforeData)
+      changed = multiCarriersChanged(afterData, beforeData)
     }
 
     if (changed) {
@@ -89,11 +91,12 @@ export default class MCSCarrierHolder extends MCSUnit {
     super.onchangeData(after, before)
   }
 
-  /** data 안에 carrier 정보 (대표 또는 ADDITIONS) 가 하나라도 있는지. */
-  private _hasCarrierData(data: any): boolean {
+  /** data 안에 carrier 정보 (대표 또는 multiCarriers) 가 하나라도 있는지. (정규화 후 판정) */
+  private _hasCarrierData(raw: any): boolean {
+    const data = normalizeCarrierData(raw)
     if (!data) return false
     if (data.CARRIERNAME) return true
-    if (Array.isArray(data.ADDITIONS) && data.ADDITIONS.some((a: any) => a?.CARRIERNAME)) return true
+    if (Array.isArray(data[MULTI_CARRIER_KEY]) && data[MULTI_CARRIER_KEY].some((a: any) => a?.CARRIERNAME)) return true
     return false
   }
 }

package/src/mcs-machine.ts

@@ -26,6 +26,19 @@ export default class MCSMachine extends MCSStatusMixin(ContainerAbstract) {
     return false
   }
 
+  /**
+   * id 후보를 조회할 때 백엔드에 보낼 타입명. 값이 있으면 검색(lookup) 대상.
+   * 기본은 자기 타입. 자기 타입과 다른 타입으로 조회해야 하는 특수 케이스는 override.
+   */
+  get idLookupType(): string | undefined {
+    return this.state.type
+  }
+
+  /** MCS 머신 — parentObject(부모 머신) 후보 수집 시 머신으로 식별. */
+  get isMcsMachine(): boolean {
+    return true
+  }
+
   containable(component: Component) {
     return ['rect', 'ellipse'].includes(component.state.type)
   }

package/src/mcs-unit.ts

@@ -13,6 +13,18 @@ export default class MCSUnit extends MCSStatusMixin(ParentObjectMixin(ContainerA
     return [...MCSStatusMixinProperties, ...ParentObjectMixinProperties]
   }
 
+  get showMoveHandle() {
+    return false
+  }
+
+  /**
+   * id 후보를 조회할 때 백엔드에 보낼 타입명. 값이 있으면 검색(lookup) 대상.
+   * 기본은 자기 타입. 특수 케이스는 override.
+   */
+  get idLookupType(): string | undefined {
+    return this.state.type
+  }
+
   get hasTextProperty() {
     return true
   }

package/src/oht.ts

@@ -20,6 +20,11 @@ export default class OHT extends MCSVehicle {
     return 'black'
   }
 
+  /** OHT 의 parentObject 는 OHTLine. */
+  get parentObjectTypes(): string[] {
+    return ['OHTLine']
+  }
+
   getLegendFallback() {
     return (this.root as any).ohtLegendTheme || super.getLegendFallback()
   }