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

package/src/port-flow.ts

@@ -45,6 +45,11 @@ export default class PortFlow extends ParentObjectMixin(RectPath(Shape)) {
     return NATURE
   }
 
+  /** PortFlow 의 parentObject 는 Port (유닛). */
+  get parentObjectTypes(): string[] {
+    return ['Port']
+  }
+
   get hasTextProperty() {
     return this.getState('showText') || false
   }

package/src/port.ts

@@ -23,6 +23,11 @@ export default class Port extends MCSZoneMixin(MCSCarrierHolder) {
     return (this.root as any).portLegendTheme || super.getLegendFallback()
   }
 
+  /** Port 는 후보가 매우 많아 부모 머신 없이는 id 리스트를 조회하지 않는다 (machine 필수). */
+  get idLookupRequiresMachine() {
+    return true
+  }
+
   render(ctx: CanvasRenderingContext2D) {
     var { left, top, width, height } = this.bounds
 

package/src/shelf.ts

@@ -19,6 +19,11 @@ export default class Shelf extends MCSZoneMixin(MCSCarrierHolder) {
     return 'black'
   }
 
+  /** Shelf 의 parentObject 는 STOCKER. */
+  get parentObjectTypes(): string[] {
+    return ['STOCKER']
+  }
+
   getLegendFallback() {
     return (this.root as any).shelfLegendTheme || super.getLegendFallback()
   }

package/src/stocker-abnormal-bar.ts

@@ -72,6 +72,11 @@ export default class StockerAbnormalBar extends ParentObjectMixin(RectPath(Shape
     return NATURE
   }
 
+  /** StockerAbnormalBar 의 parentObject 는 STOCKER. */
+  get parentObjectTypes(): string[] {
+    return ['STOCKER']
+  }
+
   get controls() {
     var { left, top, width, round, height } = this.state
     round = round == undefined ? 0 : safeRound(round, width, height)

package/src/stocker-capacity-bar.ts

@@ -92,6 +92,11 @@ export default class StockerCapacityBar extends ParentObjectMixin(MCSStatusMixin
     return NATURE
   }
 
+  /** StockerCapacityBar / MCSGaugeCapacityBar 의 parentObject 는 STOCKER. */
+  get parentObjectTypes(): string[] {
+    return ['STOCKER']
+  }
+
   get controls() {
     var { left, top, width, round, height } = this.state
     round = round == undefined ? 0 : safeRound(round, width, height)

package/src/stocker-carrier-bar.ts

@@ -81,6 +81,11 @@ export default class StockerCarrierBar extends ParentObjectMixin(RectPath(Shape)
     return NATURE
   }
 
+  /** StockerCarrierBar 의 parentObject 는 STOCKER. */
+  get parentObjectTypes(): string[] {
+    return ['STOCKER']
+  }
+
   get controls() {
     var { left, top, width, round, height } = this.state
     round = round == undefined ? 0 : safeRound(round, width, height)

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
+}

package/src/utils/crane-position.ts

@@ -0,0 +1,115 @@
+/*
+ * 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).
+ */
+
+/** 축별 한계 (cranePosition.limit.{x|y|z}). */
+export interface AxisLimit {
+  min?: number
+  max?: number
+}
+
+/** 새 데이터 명세 — data.cranePosition. */
+export interface CranePositionData {
+  current?: { x?: number; y?: number; z?: number }
+  limit?: { x?: AxisLimit; y?: AxisLimit; z?: AxisLimit }
+}
+
+/**
+ * current 값을 limit 범위 안에서 0~1 비율로 환산.
+ * limit 누락 / 0 span / 비정상 입력 시 0 반환 (안전 fallback).
+ */
+export function axisRatio(value: unknown, lim?: AxisLimit): number {
+  const v = Number(value)
+  const min = Number(lim?.min) || 0
+  const max = Number(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: number,
+  hostH: number,
+  craneW: number,
+  craneH: number,
+  rx: number,
+  ry: number
+): { left: number; top: number } {
+  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: 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)를 대소문자 무관으로 접근하기 위한 정규화.
+ */
+export function lowerKeysDeep<T = any>(value: any): T {
+  if (Array.isArray(value)) return value.map(v => lowerKeysDeep(v)) as any
+  if (value && typeof value === 'object') {
+    const out: Record<string, any> = {}
+    for (const k of Object.keys(value)) {
+      out[k.toLowerCase()] = lowerKeysDeep(value[k])
+    }
+    return out as T
+  }
+  return value as T
+}
+
+/**
+ * raw cranePosition (키 대소문자 무관) → 캐노니컬 소문자 키 구조(CranePositionData).
+ * 이후 current.x / limit.x.min 등 소문자 키로 안전하게 접근 가능. 비객체면 undefined.
+ */
+export function normalizeCranePosition(raw: any): CranePositionData | undefined {
+  if (!raw || typeof raw !== 'object') return undefined
+  return lowerKeysDeep<CranePositionData>(raw)
+}

package/src/utils/fit-gauge-scale.ts

@@ -0,0 +1,35 @@
+/**
+ * 스토커 지붕 위 용량 게이지 바의 비례 축소 계수를 계산한다.
+ *
+ * 정책:
+ *   - 게이지 바의 *최대* 크기는 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: number,
+  h: number,
+  maxW: number,
+  maxH: number,
+  margin: number = 0.85
+): number {
+  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
+}