@fmsim/machine 2.0.0-beta.88 → 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/package.json

@@ -2,7 +2,7 @@
   "name": "@fmsim/machine",
   "description": "Layout View를 구성하는 설비(machine)들과 유닛을 구현한 모듈입니다.",
   "author": "heartyoh",
-  "version": "2.0.0-beta.88",
+  "version": "2.0.0-beta.89",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "things-scene": true,
@@ -55,5 +55,5 @@
       "prettier --write"
     ]
   },
-  "gitHead": "a85bfc6794b783dd619448e2cc07cca8eafbb467"
+  "gitHead": "e65994c03e8dc1c33b4466a61f12e9135f1bc59f"
 }

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/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/utils/carrier-data.ts

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