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

package/dist/utils/crane-position.js

@@ -51,26 +51,10 @@ export function mapCraneLocalPosition(hostW, hostH, craneW, craneH, rx, ry) {
         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)를 대소문자 무관으로 접근하기 위한 정규화.
+ * 데이터 키는 모두 대문자 전제 — CRANEPOSITION 의 중첩 키(CURRENT/LIMIT/X/Y/Z/MIN/MAX)를
+ * 내부 표준형(소문자 current/limit/x/y/z/min/max)으로 변환하기 위한 정규화.
  */
 export function lowerKeysDeep(value) {
     if (Array.isArray(value))

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

@@ -1 +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"]}
+{"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 * 객체 키를 재귀적으로 소문자화한 사본 반환 (배열/원시값은 그대로, 값은 변형 안 함).\n * 데이터 키는 모두 대문자 전제 — CRANEPOSITION 의 중첩 키(CURRENT/LIMIT/X/Y/Z/MIN/MAX)를\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/package.json

@@ -2,7 +2,7 @@
   "name": "@fmsim/machine",
   "description": "Layout View를 구성하는 설비(machine)들과 유닛을 구현한 모듈입니다.",
   "author": "heartyoh",
-  "version": "2.0.0-beta.89",
+  "version": "2.0.0-beta.92",
   "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.88",
+    "@fmsim/api": "^2.0.0-beta.92",
     "@hatiolab/things-scene": "^10.0.0-beta.1"
   },
   "devDependencies": {
@@ -55,5 +55,5 @@
       "prettier --write"
     ]
   },
-  "gitHead": "e65994c03e8dc1c33b4466a61f12e9135f1bc59f"
+  "gitHead": "82db9032ea3045b862bc22f901bc5dba3c98f34b"
 }

package/src/carrier-manager.ts

@@ -1,7 +1,6 @@
 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 시나리오 (= 같은
@@ -58,11 +57,6 @@ 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)
 
@@ -133,17 +127,17 @@ export default class CarrierManager {
   }
 
   /**
-   * data.CARRIERNAME (대표) + data.multiCarriers[] 를 하나의 stack list 로 정규화.
+   * 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[MULTI_CARRIER_KEY])) {
-      for (const a of data[MULTI_CARRIER_KEY]) {
+    if (Array.isArray(data.MULTICARRIERS)) {
+      for (const a of data.MULTICARRIERS) {
         if (a && typeof a === 'object' && a.CARRIERNAME) {
           // 항목 *원본 그대로* — 외부 시스템이 임의 키를 추가로 보낼 수 있고,
           // 누락된 4 키는 default 없이 그대로 비워둔다 (carrier.data 에 흘리는

package/src/crane.ts

@@ -4,7 +4,6 @@ import { LEGEND_CRANE } from './features/mcs-status-default'
 import {
   axisRatio,
   mapCraneLocalPosition,
-  ciGet,
   normalizeCranePosition,
   type CranePositionData
 } from './utils/crane-position'
@@ -73,12 +72,13 @@ export default class Crane extends MCSVehicle {
    */
   onchangeData(after: Record<string, any>, before: Record<string, any>): void {
     const afterData = after?.data
-    // 데이터 명세 키 대소문자 무관: cranePosition / DURATION_MS 및 중첩 키(current/limit/x/y/z/min/max).
-    const afterCP = normalizeCranePosition(ciGet(afterData, 'cranePosition'))
+    // 데이터 키는 모두 대문자 전제. CRANEPOSITION 의 중첩 키(CURRENT/LIMIT/X/Y/Z/MIN/MAX)는
+    // normalizeCranePosition 이 내부 표준형(소문자)으로 변환. DURATION_MS 는 사용하지 않음.
+    const afterCP = normalizeCranePosition(afterData?.CRANEPOSITION)
     if (afterCP) {
-      const beforeCP = normalizeCranePosition(ciGet(before?.data, 'cranePosition'))
+      const beforeCP = normalizeCranePosition(before?.data?.CRANEPOSITION)
       if (this._cranePositionChanged(afterCP, beforeCP)) {
-        this._startPositionAnimation(afterCP, ciGet(afterData, 'DURATION_MS'))
+        this._startPositionAnimation(afterCP)
       }
     }
     super.onchangeData(after, before)

package/src/mcs-carrier-holder.ts

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

package/src/node.ts

@@ -31,8 +31,14 @@ export default class Node extends Shape {
     return true
   }
 
-  isDescendible() {
-    return false
+  /**
+   * Node 는 기본적으로 컨테이너 드롭 입양 불가 — 라인 머신(AGVLine/OHTLine/CraneRail)만
+   * 자기 containable 화이트리스트로 Node 를 받는다. 단 FloorPlate 에는 들어갈 수 있게 허용.
+   * FloorPlate 는 things-scene 코어 컨테이너라 거기에 'Node' 를 명시할 수 없으므로
+   * Node 측에서 해결한다 (FloorPlate 의 기본 containable = component.isDescendible(this)).
+   */
+  isDescendible(container?: any) {
+    return container?.state?.type === 'floor-plate'
   }
 
   render(context) {

package/src/utils/crane-position.ts

@@ -74,24 +74,10 @@ export function mapCraneLocalPosition(
   }
 }
 
-/**
- * 객체에서 key 를 **대소문자 무관**으로 찾아 값 반환 (정확 매치 우선, 없으면 소문자 비교).
- * 데이터 명세의 키 대소문자가 흔들려도(cranePosition / CRANEPOSITION / DURATION_MS …)
- * 동일하게 읽기 위함. 매치 없으면 undefined.
- */
-export function ciGet(obj: any, key: string): any {
-  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)를 대소문자 무관으로 접근하기 위한 정규화.
+ * 데이터 키는 모두 대문자 전제 — CRANEPOSITION 의 중첩 키(CURRENT/LIMIT/X/Y/Z/MIN/MAX)를
+ * 내부 표준형(소문자 current/limit/x/y/z/min/max)으로 변환하기 위한 정규화.
  */
 export function lowerKeysDeep<T = any>(value: any): T {
   if (Array.isArray(value)) return value.map(v => lowerKeysDeep(v)) as any

package/dist/utils/carrier-data.js

@@ -1,55 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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/src/utils/carrier-data.ts

@@ -1,57 +0,0 @@
-/*
- * 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'] as const
-const FIELD_BY_LOWER = new Map(CARRIER_FIELDS.map(f => [f.toLowerCase(), f]))
-
-/**
- * carrier 객체의 키를 캐노니컬(대문자)로 승격 — 식별 4 키만 매핑하고 값/기타 키는 보존.
- * 대소문자 무관 (carrierName → CARRIERNAME). 비객체면 그대로 반환.
- */
-export function normalizeCarrierItem(raw: any): any {
-  if (!raw || typeof raw !== 'object') return raw
-  const out: any = {}
-  for (const k of Object.keys(raw)) {
-    out[FIELD_BY_LOWER.get(k.toLowerCase()) ?? k] = raw[k]
-  }
-  return out
-}
-
-/**
- * holder.data 정규화 (진입 경계 1회):
- *  - 대표 carrier 4 키를 캐노니컬로 승격
- *  - 다중 carrier 배열을 캐노니컬 키 `multiCarriers` 로 통일 (대소문자 무관), 각 항목도 정규화
- *
- * 비객체면 그대로 반환. 정규화 결과는 idempotent (이미 캐노니컬이면 동일 형태).
- */
-export function normalizeCarrierData(raw: any): any {
-  if (!raw || typeof raw !== 'object') return raw
-
-  const multiLower = MULTI_CARRIER_KEY.toLowerCase()
-  const out: any = {}
-  for (const k of Object.keys(raw)) {
-    // 다중 carrier 배열 키는 아래에서 캐노니컬로 통일 처리하므로 여기선 건너뜀.
-    if (k.toLowerCase() === multiLower) continue
-    out[FIELD_BY_LOWER.get(k.toLowerCase()) ?? k] = raw[k]
-  }
-
-  const list = ciGet(raw, MULTI_CARRIER_KEY)
-  if (Array.isArray(list)) {
-    out[MULTI_CARRIER_KEY] = list.map(normalizeCarrierItem)
-  }
-
-  return out
-}