@fmsim/machine 1.0.87 → 2.0.0-beta.2

package/dist/factories/machine-3d.js

@@ -0,0 +1,288 @@
+/**
+ * MCS 설비 컴포넌트 3D 팩토리
+ *
+ * 10,000+ 인스턴스를 위한 최소 폴리곤 설계:
+ *   - 컴포넌트당 단일 Mesh (draw call 최소화)
+ *   - BoxGeometry / ExtrudeGeometry(hexagon) 만 사용
+ *   - Machine: 높은 depth, 컨테이너는 반투명
+ *   - Unit: 낮은 depth, 불투명
+ */
+import * as THREE from 'three';
+import { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene';
+/**
+ * 포트 기본 높이 (절대값).
+ * 모든 이송장치의 상단 높이 = 이 값.
+ * 캐리어가 이송장치 간 높이 차 없이 이동할 수 있는 기준 높이.
+ */
+export const TRANSPORT_SURFACE_HEIGHT = 30;
+const DEFAULTS = {
+    depthRatio: 0.5,
+    opacity: 1.0,
+    metalness: 0.3,
+    roughness: 0.7,
+    defaultColor: 0xaabbcc,
+    shape: 'box',
+};
+// ── 3D 오브젝트 ──────────────────────────────────────────
+class MCSRealObject3D extends RealObjectGroup {
+    constructor(component, config) {
+        super(component);
+        this._config = config;
+    }
+    // width, height 절대값 (음수 값은 양수로 취급)
+    get absSize() {
+        const { width = 10, height = 10 } = this.component.state;
+        return { w: Math.abs(width), h: Math.abs(height) };
+    }
+    get effectiveDepth() {
+        const { depth } = this.component.state;
+        if (depth)
+            return depth;
+        if (this._config.defaultDepth)
+            return this._config.defaultDepth;
+        const { w, h } = this.absSize;
+        return Math.min(w, h) * this._config.depthRatio;
+    }
+    get syncZPosOffset() {
+        var _a, _b;
+        // Port: 이송 표면 높이에 배치
+        if (this._config.defaultZPosFromParent) {
+            return TRANSPORT_SURFACE_HEIGHT;
+        }
+        // Carrier: Port 안이면 중앙, 그 외 컨테이너면 상단 위
+        if (this._config.sizeRatio && this._config.sizeRatio < 1) {
+            const parentType = (_b = (_a = this.component.parent) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.type;
+            if (parentType === 'Port' || parentType === 'Shelf' || parentType === 'OHT' || parentType === 'Shuttle') {
+                return 0;
+            }
+            return TRANSPORT_SURFACE_HEIGHT;
+        }
+        return 0;
+    }
+    // 컴포넌트의 상태 색상(statusColor) 또는 fillStyle → Three.js 색상 변환
+    resolveColor() {
+        const comp = this.component;
+        // 1) MCSStatusMixin.statusColor (legend 기반 상태 색상)
+        //    '#F0F0F0'은 상태 미설정 시 기본 fallback — 무시하고 defaultColor 사용
+        try {
+            const sc = comp.statusColor;
+            if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0')
+                return new THREE.Color(sc).getHex();
+        }
+        catch (_a) {
+            /* statusColor 미구현 시 무시 */
+        }
+        // 2) state.fillStyle fallback
+        const { fillStyle } = this.component.state;
+        if (fillStyle && typeof fillStyle === 'string') {
+            try {
+                return new THREE.Color(fillStyle).getHex();
+            }
+            catch (_b) {
+                /* 파싱 실패 시 무시 */
+            }
+        }
+        return this._config.defaultColor;
+    }
+    // ── Geometry helpers ──
+    /**
+     * 바닥면(-Y 방향) 삼각형 제거: z-fighting 근본 해결.
+     * 바닥면이 없으면 floor grid와 겹칠 면 자체가 없어진다.
+     */
+    removeBottomFace(geometry) {
+        const posAttr = geometry.getAttribute('position');
+        const normAttr = geometry.getAttribute('normal');
+        const index = geometry.getIndex();
+        if (!posAttr || !normAttr || !index)
+            return geometry;
+        const newIndices = [];
+        const normalY = new THREE.Vector3();
+        for (let i = 0; i < index.count; i += 3) {
+            const a = index.getX(i);
+            const b = index.getX(i + 1);
+            const c = index.getX(i + 2);
+            // 세 꼭짓점 노말의 Y 성분 평균으로 방향 판단
+            const avgY = (normAttr.getY(a) + normAttr.getY(b) + normAttr.getY(c)) / 3;
+            // -Y 방향 삼각형 제거 (threshold -0.9: 거의 아래를 향하는 면만)
+            if (avgY > -0.9) {
+                newIndices.push(a, b, c);
+            }
+        }
+        geometry.setIndex(newIndices);
+        return geometry;
+    }
+    // ── Geometry builders ──
+    buildBoxGeometry(w, d, h) {
+        const geo = new THREE.BoxGeometry(w, d, h);
+        return this.removeBottomFace(geo);
+    }
+    buildHexagonGeometry(w, d, h) {
+        // Buffer의 2D 형태: 좌우 끝이 꺾인 육각형
+        const offset = Math.min(w, h) * 0.2;
+        const hw = w / 2;
+        const hh = h / 2;
+        const shape = new THREE.Shape();
+        shape.moveTo(-hw + offset, -hh);
+        shape.lineTo(hw - offset, -hh);
+        shape.lineTo(hw, 0);
+        shape.lineTo(hw - offset, hh);
+        shape.lineTo(-hw + offset, hh);
+        shape.lineTo(-hw, 0);
+        shape.closePath();
+        const geo = new THREE.ExtrudeGeometry(shape, {
+            steps: 1,
+            depth: d,
+            bevelEnabled: false,
+        });
+        // 중심 정렬 후 Y-up 좌표계 회전 (extrude 축: +Z → +Y)
+        geo.translate(0, 0, -d / 2);
+        geo.rotateX(Math.PI / 2);
+        return this.removeBottomFace(geo);
+    }
+    // ── Build ──
+    build() {
+        var _a;
+        super.build();
+        // 가시성 판정 — e.g., Carrier는 데이터 없으면 mesh 미생성
+        if (this._config.isVisible && !this._config.isVisible(this.component))
+            return;
+        const { w: rawW, h: rawH } = this.absSize;
+        const rawDepth = this.effectiveDepth;
+        if (!rawW || !rawH)
+            return;
+        const ratio = (_a = this._config.sizeRatio) !== null && _a !== void 0 ? _a : 1.0;
+        const w = rawW * ratio;
+        const h = rawH * ratio;
+        const depth = rawDepth * ratio;
+        const color = this.resolveColor();
+        const { opacity, metalness, roughness, shape } = this._config;
+        const geometry = shape === 'hexagon'
+            ? this.buildHexagonGeometry(w, depth, h)
+            : this.buildBoxGeometry(w, depth, h);
+        const material = new THREE.MeshStandardMaterial({
+            color,
+            metalness,
+            roughness,
+            opacity,
+            transparent: opacity < 1,
+            side: opacity < 1 ? THREE.DoubleSide : THREE.FrontSide,
+            depthWrite: opacity >= 0.9,
+        });
+        // z-fighting 방지: 바닥면(floor grid)보다 항상 앞에 렌더링
+        material.polygonOffset = true;
+        material.polygonOffsetFactor = -1;
+        material.polygonOffsetUnit = -1;
+        const mesh = new THREE.Mesh(geometry, material);
+        // sizeRatio < 1이면 부모 중심에 배치 (rawDepth/2), 아니면 자체 중심 (depth/2)
+        mesh.position.y = ratio < 1 ? rawDepth / 2 : depth / 2;
+        mesh.castShadow = true;
+        mesh.receiveShadow = true;
+        this.object3d.add(mesh);
+    }
+    // ── Change handling ──
+    onchange(after, before) {
+        if ('width' in after ||
+            'height' in after ||
+            'depth' in after ||
+            'fillStyle' in after ||
+            'strokeStyle' in after ||
+            'id' in after // Carrier: CARRIERNAME 변경 시 가시성 재판정
+        ) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+    // RealObjectGroup 기본 동작 비활성화 (update()에서 일괄 처리)
+    updateDimension() { }
+    updateAlpha() { }
+}
+// ── 팩토리 등록 헬퍼 ─────────────────────────────────────
+function register(type, overrides = {}) {
+    const config = Object.assign(Object.assign({}, DEFAULTS), overrides);
+    registerRealObjectFactory(type, (component) => new MCSRealObject3D(component, config));
+}
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Machine (인프라 설비) — 높은 depth, 컨테이너는 반투명
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+register('Equipment', {
+    defaultDepth: 3 * TRANSPORT_SURFACE_HEIGHT,
+    opacity: 0.5,
+    metalness: 0.4,
+    roughness: 0.6,
+    defaultColor: 0x8899aa,
+});
+register('Buffer', {
+    defaultDepth: TRANSPORT_SURFACE_HEIGHT,
+    opacity: 0.5,
+    metalness: 0.3,
+    roughness: 0.7,
+    defaultColor: 0x99aa88,
+    shape: 'hexagon',
+});
+register('AGVLine', {
+    depthRatio: 0.12,
+    metalness: 0.6,
+    roughness: 0.3,
+    defaultColor: 0x888899,
+});
+register('OHTLine', {
+    depthRatio: 0.12,
+    metalness: 0.6,
+    roughness: 0.3,
+    defaultColor: 0x888899,
+});
+register('STOCKER', {
+    defaultDepth: 5 * TRANSPORT_SURFACE_HEIGHT,
+    opacity: 0.35,
+    metalness: 0.3,
+    roughness: 0.6,
+    defaultColor: 0x8899bb,
+});
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Unit (이동체 · 홀더) — 낮은 depth, 불투명
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+register('Port', {
+    depthRatio: 0.5,
+    defaultZPosFromParent: true,
+    opacity: 0.5,
+    metalness: 0.4,
+    roughness: 0.6,
+    defaultColor: 0xb0a090,
+});
+register('Shelf', {
+    depthRatio: 0.25,
+    metalness: 0.3,
+    roughness: 0.7,
+    defaultColor: 0xaabbcc,
+});
+register('Carrier', {
+    depthRatio: 0.5,
+    metalness: 0.2,
+    roughness: 0.8,
+    defaultColor: 0x66bb66,
+    isVisible: (c) => !!c.state.id,
+    sizeRatio: 0.8,
+});
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Gauge (용량 게이지) — 얇은 바
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+register('ZoneCapacityBar', {
+    depthRatio: 0.15,
+    metalness: 0.2,
+    roughness: 0.8,
+    defaultColor: 0x44aa44,
+});
+register('StockerCapacityBar', {
+    depthRatio: 0.15,
+    metalness: 0.2,
+    roughness: 0.8,
+    defaultColor: 0x44aa44,
+});
+register('MCSGaugeCapacityBar', {
+    depthRatio: 0.15,
+    metalness: 0.2,
+    roughness: 0.8,
+    defaultColor: 0x44aa44,
+});
+//# sourceMappingURL=machine-3d.js.map

package/dist/factories/machine-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-3d.js","sourceRoot":"","sources":["../../src/factories/machine-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCS 설비 컴포넌트 3D 팩토리\n *\n * 10,000+ 인스턴스를 위한 최소 폴리곤 설계:\n *   - 컴포넌트당 단일 Mesh (draw call 최소화)\n *   - BoxGeometry / ExtrudeGeometry(hexagon) 만 사용\n *   - Machine: 높은 depth, 컨테이너는 반투명\n *   - Unit: 낮은 depth, 불투명\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene'\nimport type { Component } from '@hatiolab/things-scene'\n\n// ── 설정 타입 ────────────────────────────────────────────\n\ninterface MCS3DConfig {\n  /** state.depth 미설정 시 기본 depth.\n   *  defaultDepth > 0이면 절대값, 아니면 min(w,h) * depthRatio */\n  depthRatio: number\n  defaultDepth?: number\n  /** true이면 syncZPosOffset = TRANSPORT_SURFACE_HEIGHT */\n  defaultZPosFromParent?: boolean\n  /** 1.0 = 불투명, 0.35 = 반투명 컨테이너 */\n  opacity: number\n  metalness: number\n  roughness: number\n  /** statusColor 미사용 시 기본 색상 */\n  defaultColor: number\n  /** 'box' | 'hexagon' */\n  shape: 'box' | 'hexagon'\n  /** mesh 생성 전 가시성 판정 — false 반환 시 mesh 미생성 */\n  isVisible?: (component: Component) => boolean\n  /** 부모 대비 크기 비율 (기본 1.0). < 1이면 부모 중심에 배치. */\n  sizeRatio?: number\n}\n\n/**\n * 포트 기본 높이 (절대값).\n * 모든 이송장치의 상단 높이 = 이 값.\n * 캐리어가 이송장치 간 높이 차 없이 이동할 수 있는 기준 높이.\n */\nexport const TRANSPORT_SURFACE_HEIGHT = 30\n\nconst DEFAULTS: MCS3DConfig = {\n  depthRatio: 0.5,\n  opacity: 1.0,\n  metalness: 0.3,\n  roughness: 0.7,\n  defaultColor: 0xaabbcc,\n  shape: 'box',\n}\n\n// ── 3D 오브젝트 ──────────────────────────────────────────\n\nclass MCSRealObject3D extends RealObjectGroup {\n  private _config: MCS3DConfig\n\n  constructor(component: Component, config: MCS3DConfig) {\n    super(component)\n    this._config = config\n  }\n\n  // width, height 절대값 (음수 값은 양수로 취급)\n  private get absSize(): { w: number; h: number } {\n    const { width = 10, height = 10 } = this.component.state\n    return { w: Math.abs(width), h: Math.abs(height) }\n  }\n\n  get effectiveDepth(): number {\n    const { depth } = this.component.state\n    if (depth) return depth\n    if (this._config.defaultDepth) return this._config.defaultDepth\n    const { w, h } = this.absSize\n    return Math.min(w, h) * this._config.depthRatio\n  }\n\n  protected get syncZPosOffset(): number {\n    // Port: 이송 표면 높이에 배치\n    if (this._config.defaultZPosFromParent) {\n      return TRANSPORT_SURFACE_HEIGHT\n    }\n    // Carrier: Port 안이면 중앙, 그 외 컨테이너면 상단 위\n    if (this._config.sizeRatio && this._config.sizeRatio < 1) {\n      const parentType = this.component.parent?.state?.type\n      if (parentType === 'Port' || parentType === 'Shelf' || parentType === 'OHT' || parentType === 'Shuttle') {\n        return 0\n      }\n      return TRANSPORT_SURFACE_HEIGHT\n    }\n    return 0\n  }\n\n  // 컴포넌트의 상태 색상(statusColor) 또는 fillStyle → Three.js 색상 변환\n  private resolveColor(): number {\n    const comp = this.component as any\n\n    // 1) MCSStatusMixin.statusColor (legend 기반 상태 색상)\n    //    '#F0F0F0'은 상태 미설정 시 기본 fallback — 무시하고 defaultColor 사용\n    try {\n      const sc = comp.statusColor\n      if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0') return new THREE.Color(sc).getHex()\n    } catch {\n      /* statusColor 미구현 시 무시 */\n    }\n\n    // 2) state.fillStyle fallback\n    const { fillStyle } = this.component.state\n    if (fillStyle && typeof fillStyle === 'string') {\n      try {\n        return new THREE.Color(fillStyle).getHex()\n      } catch {\n        /* 파싱 실패 시 무시 */\n      }\n    }\n\n    return this._config.defaultColor\n  }\n\n  // ── Geometry helpers ──\n\n  /**\n   * 바닥면(-Y 방향) 삼각형 제거: z-fighting 근본 해결.\n   * 바닥면이 없으면 floor grid와 겹칠 면 자체가 없어진다.\n   */\n  private removeBottomFace(geometry: THREE.BufferGeometry): THREE.BufferGeometry {\n    const posAttr = geometry.getAttribute('position')\n    const normAttr = geometry.getAttribute('normal')\n    const index = geometry.getIndex()\n\n    if (!posAttr || !normAttr || !index) return geometry\n\n    const newIndices: number[] = []\n    const normalY = new THREE.Vector3()\n\n    for (let i = 0; i < index.count; i += 3) {\n      const a = index.getX(i)\n      const b = index.getX(i + 1)\n      const c = index.getX(i + 2)\n\n      // 세 꼭짓점 노말의 Y 성분 평균으로 방향 판단\n      const avgY = (normAttr.getY(a) + normAttr.getY(b) + normAttr.getY(c)) / 3\n\n      // -Y 방향 삼각형 제거 (threshold -0.9: 거의 아래를 향하는 면만)\n      if (avgY > -0.9) {\n        newIndices.push(a, b, c)\n      }\n    }\n\n    geometry.setIndex(newIndices)\n    return geometry\n  }\n\n  // ── Geometry builders ──\n\n  private buildBoxGeometry(w: number, d: number, h: number): THREE.BufferGeometry {\n    const geo = new THREE.BoxGeometry(w, d, h)\n    return this.removeBottomFace(geo)\n  }\n\n  private buildHexagonGeometry(w: number, d: number, h: number): THREE.BufferGeometry {\n    // Buffer의 2D 형태: 좌우 끝이 꺾인 육각형\n    const offset = Math.min(w, h) * 0.2\n    const hw = w / 2\n    const hh = h / 2\n\n    const shape = new THREE.Shape()\n    shape.moveTo(-hw + offset, -hh)\n    shape.lineTo(hw - offset, -hh)\n    shape.lineTo(hw, 0)\n    shape.lineTo(hw - offset, hh)\n    shape.lineTo(-hw + offset, hh)\n    shape.lineTo(-hw, 0)\n    shape.closePath()\n\n    const geo = new THREE.ExtrudeGeometry(shape, {\n      steps: 1,\n      depth: d,\n      bevelEnabled: false,\n    })\n\n    // 중심 정렬 후 Y-up 좌표계 회전 (extrude 축: +Z → +Y)\n    geo.translate(0, 0, -d / 2)\n    geo.rotateX(Math.PI / 2)\n\n    return this.removeBottomFace(geo)\n  }\n\n  // ── Build ──\n\n  build() {\n    super.build()\n\n    // 가시성 판정 — e.g., Carrier는 데이터 없으면 mesh 미생성\n    if (this._config.isVisible && !this._config.isVisible(this.component)) return\n\n    const { w: rawW, h: rawH } = this.absSize\n    const rawDepth = this.effectiveDepth\n    if (!rawW || !rawH) return\n\n    const ratio = this._config.sizeRatio ?? 1.0\n    const w = rawW * ratio\n    const h = rawH * ratio\n    const depth = rawDepth * ratio\n\n    const color = this.resolveColor()\n    const { opacity, metalness, roughness, shape } = this._config\n\n    const geometry =\n      shape === 'hexagon'\n        ? this.buildHexagonGeometry(w, depth, h)\n        : this.buildBoxGeometry(w, depth, h)\n\n    const material = new THREE.MeshStandardMaterial({\n      color,\n      metalness,\n      roughness,\n      opacity,\n      transparent: opacity < 1,\n      side: opacity < 1 ? THREE.DoubleSide : THREE.FrontSide,\n      depthWrite: opacity >= 0.9,\n    })\n    // z-fighting 방지: 바닥면(floor grid)보다 항상 앞에 렌더링\n    material.polygonOffset = true\n    material.polygonOffsetFactor = -1\n    material.polygonOffsetUnit = -1\n\n    const mesh = new THREE.Mesh(geometry, material)\n    // sizeRatio < 1이면 부모 중심에 배치 (rawDepth/2), 아니면 자체 중심 (depth/2)\n    mesh.position.y = ratio < 1 ? rawDepth / 2 : depth / 2\n    mesh.castShadow = true\n    mesh.receiveShadow = true\n    this.object3d.add(mesh)\n  }\n\n  // ── Change handling ──\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if (\n      'width' in after ||\n      'height' in after ||\n      'depth' in after ||\n      'fillStyle' in after ||\n      'strokeStyle' in after ||\n      'id' in after // Carrier: CARRIERNAME 변경 시 가시성 재판정\n    ) {\n      this.update()\n      return\n    }\n\n    super.onchange(after, before)\n  }\n\n  // RealObjectGroup 기본 동작 비활성화 (update()에서 일괄 처리)\n  updateDimension() {}\n  updateAlpha() {}\n}\n\n// ── 팩토리 등록 헬퍼 ─────────────────────────────────────\n\nfunction register(type: string, overrides: Partial<MCS3DConfig> = {}) {\n  const config: MCS3DConfig = { ...DEFAULTS, ...overrides }\n  registerRealObjectFactory(type, (component: Component) => new MCSRealObject3D(component, config))\n}\n\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n//  Machine (인프라 설비) — 높은 depth, 컨테이너는 반투명\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nregister('Equipment', {\n  defaultDepth: 3 * TRANSPORT_SURFACE_HEIGHT,\n  opacity: 0.5,\n  metalness: 0.4,\n  roughness: 0.6,\n  defaultColor: 0x8899aa,\n})\n\nregister('Buffer', {\n  defaultDepth: TRANSPORT_SURFACE_HEIGHT,\n  opacity: 0.5,\n  metalness: 0.3,\n  roughness: 0.7,\n  defaultColor: 0x99aa88,\n  shape: 'hexagon',\n})\n\nregister('AGVLine', {\n  depthRatio: 0.12,\n  metalness: 0.6,\n  roughness: 0.3,\n  defaultColor: 0x888899,\n})\n\nregister('OHTLine', {\n  depthRatio: 0.12,\n  metalness: 0.6,\n  roughness: 0.3,\n  defaultColor: 0x888899,\n})\n\nregister('STOCKER', {\n  defaultDepth: 5 * TRANSPORT_SURFACE_HEIGHT,\n  opacity: 0.35,\n  metalness: 0.3,\n  roughness: 0.6,\n  defaultColor: 0x8899bb,\n})\n\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n//  Unit (이동체 · 홀더) — 낮은 depth, 불투명\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nregister('Port', {\n  depthRatio: 0.5,\n  defaultZPosFromParent: true,\n  opacity: 0.5,\n  metalness: 0.4,\n  roughness: 0.6,\n  defaultColor: 0xb0a090,\n})\n\nregister('Shelf', {\n  depthRatio: 0.25,\n  metalness: 0.3,\n  roughness: 0.7,\n  defaultColor: 0xaabbcc,\n})\n\nregister('Carrier', {\n  depthRatio: 0.5,\n  metalness: 0.2,\n  roughness: 0.8,\n  defaultColor: 0x66bb66,\n  isVisible: (c: Component) => !!(c.state as any).id,\n  sizeRatio: 0.8,\n})\n\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n//  Gauge (용량 게이지) — 얇은 바\n// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\nregister('ZoneCapacityBar', {\n  depthRatio: 0.15,\n  metalness: 0.2,\n  roughness: 0.8,\n  defaultColor: 0x44aa44,\n})\n\nregister('StockerCapacityBar', {\n  depthRatio: 0.15,\n  metalness: 0.2,\n  roughness: 0.8,\n  defaultColor: 0x44aa44,\n})\n\nregister('MCSGaugeCapacityBar', {\n  depthRatio: 0.15,\n  metalness: 0.2,\n  roughness: 0.8,\n  defaultColor: 0x44aa44,\n})\n"]}

package/dist/factories/oht-3d.js

@@ -0,0 +1,151 @@
+/**
+ * OHT (Overhead Hoist Transport) 3D Factory
+ *
+ * 천장 레일에 매달려 이동하는 반송 차량. 캐리어를 호이스트로 운반.
+ * 구조 (바닥 원점, y=0~depth):
+ *   - 하단 그리퍼 바 (캐리어 집는 가로 바)
+ *   - 호이스트 암 (좌우 수직 기둥)
+ *   - 본체 하우징 (statusColor 적용)
+ *   - 상단 트롤리 (납작+넓은 레일 클램프 + 좌우 바퀴)
+ */
+import * as THREE from 'three';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js';
+import { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene';
+import { TRANSPORT_SURFACE_HEIGHT } from './machine-3d.js';
+const TROLLEY_COLOR = 0x222222;
+const FRAME_COLOR = 0x444444;
+const DEFAULT_BODY_COLOR = 0x6688cc;
+/** OHT 레일 높이: 스토커(5x) 위 */
+const OHT_RAIL_HEIGHT = 6 * TRANSPORT_SURFACE_HEIGHT;
+export class OHT3D extends RealObjectGroup {
+    get effectiveDepth() {
+        const { depth } = this.component.state;
+        return depth || TRANSPORT_SURFACE_HEIGHT;
+    }
+    /** 천장 레일 높이에 배치 */
+    get syncZPosOffset() {
+        return OHT_RAIL_HEIGHT;
+    }
+    resolveColor() {
+        const comp = this.component;
+        try {
+            const sc = comp.statusColor;
+            if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0')
+                return new THREE.Color(sc).getHex();
+        }
+        catch (_a) {
+            /* statusColor 미구현 시 무시 */
+        }
+        const { fillStyle } = this.component.state;
+        if (fillStyle && typeof fillStyle === 'string') {
+            try {
+                return new THREE.Color(fillStyle).getHex();
+            }
+            catch (_b) {
+                /* 파싱 실패 시 무시 */
+            }
+        }
+        return DEFAULT_BODY_COLOR;
+    }
+    build() {
+        super.build();
+        const { width = 10, height = 10 } = this.component.state;
+        const w = Math.abs(width);
+        const h = Math.abs(height);
+        const d = this.effectiveDepth;
+        if (!w || !h)
+            return;
+        // 높이 배분: 그리퍼 8%, 호이스트암 22%, 본체 45%, 간격 5%, 트롤리 12%, 바퀴 8%
+        const gripperBarH = d * 0.08;
+        const armH = d * 0.22;
+        const bodyH = d * 0.45;
+        const gap = d * 0.05;
+        const trolleyH = d * 0.12;
+        const wheelH = d * 0.08;
+        const armThickness = Math.min(w, h) * 0.12;
+        const bodyCornerR = Math.min(w, h, bodyH) * 0.1;
+        const frameMat = new THREE.MeshStandardMaterial({
+            color: FRAME_COLOR,
+            roughness: 0.5,
+            metalness: 0.4,
+        });
+        // ── 1. 하단 그리퍼 바 (캐리어를 집는 가로 바) ──
+        const gripperBarW = w * 0.7;
+        const gripperBarD = h * 0.15;
+        const gripperGeo = new THREE.BoxGeometry(gripperBarW, gripperBarH, gripperBarD);
+        const gripperMesh = new THREE.Mesh(gripperGeo, frameMat);
+        gripperMesh.position.y = gripperBarH / 2;
+        gripperMesh.castShadow = true;
+        this.object3d.add(gripperMesh);
+        // ── 2. 호이스트 암 (좌우 수직 기둥 + 하단 가로연결) ──
+        const armBaseY = gripperBarH;
+        const armGeometries = [];
+        // 좌우 수직 기둥
+        for (const xSign of [-1, 1]) {
+            const pillar = new THREE.BoxGeometry(armThickness, armH, armThickness);
+            pillar.translate(xSign * (w * 0.3), armBaseY + armH / 2, 0);
+            armGeometries.push(pillar);
+        }
+        // 하단 가로 연결 바 (그리퍼와 암을 잇는 수평 바)
+        const crossBarW = w * 0.6 + armThickness;
+        const crossBarH = armThickness * 0.6;
+        const crossBar = new THREE.BoxGeometry(crossBarW, crossBarH, armThickness);
+        crossBar.translate(0, armBaseY + crossBarH / 2, 0);
+        armGeometries.push(crossBar);
+        const armMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(armGeometries), frameMat);
+        armMesh.castShadow = true;
+        this.object3d.add(armMesh);
+        // ── 3. 본체 하우징 (statusColor 적용) ──
+        const bodyBaseY = armBaseY + armH;
+        const bodyColor = this.resolveColor();
+        const bodyGeo = new RoundedBoxGeometry(w, bodyH, h, 4, bodyCornerR);
+        const bodyMat = new THREE.MeshStandardMaterial({
+            color: bodyColor,
+            roughness: 0.3,
+            metalness: 0.5,
+        });
+        const bodyMesh = new THREE.Mesh(bodyGeo, bodyMat);
+        bodyMesh.position.y = bodyBaseY + bodyH / 2;
+        bodyMesh.castShadow = true;
+        bodyMesh.receiveShadow = true;
+        this.object3d.add(bodyMesh);
+        // ── 4. 상단 트롤리 플레이트 (납작하고 넓은 레일 클램프) ──
+        const trolleyBaseY = bodyBaseY + bodyH + gap;
+        const trolleyW = w * 1.15;
+        const trolleyD = h * 0.6;
+        const trolleyGeo = new THREE.BoxGeometry(trolleyW, trolleyH, trolleyD);
+        const trolleyMat = new THREE.MeshStandardMaterial({
+            color: TROLLEY_COLOR,
+            roughness: 0.6,
+            metalness: 0.3,
+        });
+        const trolleyMesh = new THREE.Mesh(trolleyGeo, trolleyMat);
+        trolleyMesh.position.y = trolleyBaseY + trolleyH / 2;
+        trolleyMesh.castShadow = true;
+        this.object3d.add(trolleyMesh);
+        // ── 5. 좌우 바퀴 (트롤리 위, 레일을 타는 원통형 바퀴) ──
+        const wheelBaseY = trolleyBaseY + trolleyH;
+        const wheelRadius = wheelH / 2;
+        const wheelDepth = h * 0.2;
+        for (const xSign of [-1, 1]) {
+            const wheelGeo = new THREE.CylinderGeometry(wheelRadius, wheelRadius, wheelDepth, 12);
+            wheelGeo.rotateX(Math.PI / 2);
+            const wheelMesh = new THREE.Mesh(wheelGeo, trolleyMat);
+            wheelMesh.position.set(xSign * (trolleyW * 0.35), wheelBaseY + wheelRadius, 0);
+            wheelMesh.castShadow = true;
+            this.object3d.add(wheelMesh);
+        }
+    }
+    updateDimension() { }
+    updateAlpha() { }
+    onchange(after, before) {
+        if ('width' in after || 'height' in after || 'depth' in after || 'fillStyle' in after || 'strokeStyle' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+}
+registerRealObjectFactory('OHT', (component) => new OHT3D(component));
+//# sourceMappingURL=oht-3d.js.map

package/dist/factories/oht-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oht-3d.js","sourceRoot":"","sources":["../../src/factories/oht-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OHT (Overhead Hoist Transport) 3D Factory\n *\n * 천장 레일에 매달려 이동하는 반송 차량. 캐리어를 호이스트로 운반.\n * 구조 (바닥 원점, y=0~depth):\n *   - 하단 그리퍼 바 (캐리어 집는 가로 바)\n *   - 호이스트 암 (좌우 수직 기둥)\n *   - 본체 하우징 (statusColor 적용)\n *   - 상단 트롤리 (납작+넓은 레일 클램프 + 좌우 바퀴)\n */\n\nimport * as THREE from 'three'\nimport * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'\nimport { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js'\nimport { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene'\nimport type { Component } from '@hatiolab/things-scene'\nimport { TRANSPORT_SURFACE_HEIGHT } from './machine-3d.js'\n\nconst TROLLEY_COLOR = 0x222222\nconst FRAME_COLOR = 0x444444\nconst DEFAULT_BODY_COLOR = 0x6688cc\n\n/** OHT 레일 높이: 스토커(5x) 위 */\nconst OHT_RAIL_HEIGHT = 6 * TRANSPORT_SURFACE_HEIGHT\n\nexport class OHT3D extends RealObjectGroup {\n  get effectiveDepth(): number {\n    const { depth } = this.component.state\n    return depth || TRANSPORT_SURFACE_HEIGHT\n  }\n\n  /** 천장 레일 높이에 배치 */\n  protected get syncZPosOffset(): number {\n    return OHT_RAIL_HEIGHT\n  }\n\n  private resolveColor(): number {\n    const comp = this.component as any\n\n    try {\n      const sc = comp.statusColor\n      if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0') return new THREE.Color(sc).getHex()\n    } catch {\n      /* statusColor 미구현 시 무시 */\n    }\n\n    const { fillStyle } = this.component.state\n    if (fillStyle && typeof fillStyle === 'string') {\n      try {\n        return new THREE.Color(fillStyle).getHex()\n      } catch {\n        /* 파싱 실패 시 무시 */\n      }\n    }\n\n    return DEFAULT_BODY_COLOR\n  }\n\n  build() {\n    super.build()\n\n    const { width = 10, height = 10 } = this.component.state\n    const w = Math.abs(width)\n    const h = Math.abs(height)\n    const d = this.effectiveDepth\n    if (!w || !h) return\n\n    // 높이 배분: 그리퍼 8%, 호이스트암 22%, 본체 45%, 간격 5%, 트롤리 12%, 바퀴 8%\n    const gripperBarH = d * 0.08\n    const armH = d * 0.22\n    const bodyH = d * 0.45\n    const gap = d * 0.05\n    const trolleyH = d * 0.12\n    const wheelH = d * 0.08\n\n    const armThickness = Math.min(w, h) * 0.12\n    const bodyCornerR = Math.min(w, h, bodyH) * 0.1\n\n    const frameMat = new THREE.MeshStandardMaterial({\n      color: FRAME_COLOR,\n      roughness: 0.5,\n      metalness: 0.4,\n    })\n\n    // ── 1. 하단 그리퍼 바 (캐리어를 집는 가로 바) ──\n    const gripperBarW = w * 0.7\n    const gripperBarD = h * 0.15\n    const gripperGeo = new THREE.BoxGeometry(gripperBarW, gripperBarH, gripperBarD)\n    const gripperMesh = new THREE.Mesh(gripperGeo, frameMat)\n    gripperMesh.position.y = gripperBarH / 2\n    gripperMesh.castShadow = true\n    this.object3d.add(gripperMesh)\n\n    // ── 2. 호이스트 암 (좌우 수직 기둥 + 하단 가로연결) ──\n    const armBaseY = gripperBarH\n    const armGeometries: THREE.BufferGeometry[] = []\n\n    // 좌우 수직 기둥\n    for (const xSign of [-1, 1]) {\n      const pillar = new THREE.BoxGeometry(armThickness, armH, armThickness)\n      pillar.translate(xSign * (w * 0.3), armBaseY + armH / 2, 0)\n      armGeometries.push(pillar)\n    }\n\n    // 하단 가로 연결 바 (그리퍼와 암을 잇는 수평 바)\n    const crossBarW = w * 0.6 + armThickness\n    const crossBarH = armThickness * 0.6\n    const crossBar = new THREE.BoxGeometry(crossBarW, crossBarH, armThickness)\n    crossBar.translate(0, armBaseY + crossBarH / 2, 0)\n    armGeometries.push(crossBar)\n\n    const armMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(armGeometries), frameMat)\n    armMesh.castShadow = true\n    this.object3d.add(armMesh)\n\n    // ── 3. 본체 하우징 (statusColor 적용) ──\n    const bodyBaseY = armBaseY + armH\n    const bodyColor = this.resolveColor()\n    const bodyGeo = new RoundedBoxGeometry(w, bodyH, h, 4, bodyCornerR)\n    const bodyMat = new THREE.MeshStandardMaterial({\n      color: bodyColor,\n      roughness: 0.3,\n      metalness: 0.5,\n    })\n    const bodyMesh = new THREE.Mesh(bodyGeo, bodyMat)\n    bodyMesh.position.y = bodyBaseY + bodyH / 2\n    bodyMesh.castShadow = true\n    bodyMesh.receiveShadow = true\n    this.object3d.add(bodyMesh)\n\n    // ── 4. 상단 트롤리 플레이트 (납작하고 넓은 레일 클램프) ──\n    const trolleyBaseY = bodyBaseY + bodyH + gap\n    const trolleyW = w * 1.15\n    const trolleyD = h * 0.6\n    const trolleyGeo = new THREE.BoxGeometry(trolleyW, trolleyH, trolleyD)\n    const trolleyMat = new THREE.MeshStandardMaterial({\n      color: TROLLEY_COLOR,\n      roughness: 0.6,\n      metalness: 0.3,\n    })\n    const trolleyMesh = new THREE.Mesh(trolleyGeo, trolleyMat)\n    trolleyMesh.position.y = trolleyBaseY + trolleyH / 2\n    trolleyMesh.castShadow = true\n    this.object3d.add(trolleyMesh)\n\n    // ── 5. 좌우 바퀴 (트롤리 위, 레일을 타는 원통형 바퀴) ──\n    const wheelBaseY = trolleyBaseY + trolleyH\n    const wheelRadius = wheelH / 2\n    const wheelDepth = h * 0.2\n    for (const xSign of [-1, 1]) {\n      const wheelGeo = new THREE.CylinderGeometry(wheelRadius, wheelRadius, wheelDepth, 12)\n      wheelGeo.rotateX(Math.PI / 2)\n      const wheelMesh = new THREE.Mesh(wheelGeo, trolleyMat)\n      wheelMesh.position.set(xSign * (trolleyW * 0.35), wheelBaseY + wheelRadius, 0)\n      wheelMesh.castShadow = true\n      this.object3d.add(wheelMesh)\n    }\n  }\n\n  updateDimension() {}\n  updateAlpha() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if ('width' in after || 'height' in after || 'depth' in after || 'fillStyle' in after || 'strokeStyle' in after) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n}\n\nregisterRealObjectFactory('OHT', (component: Component) => new OHT3D(component))\n"]}

package/dist/factories/shuttle-3d.js

@@ -0,0 +1,136 @@
+/**
+ * Shuttle 3D Factory
+ *
+ * 스토커 내부에서 캐리어를 선반↔포트 간 이송하는 포크 캐리지.
+ * 수평 레일 위를 이동하며, 포크를 밀어넣어 캐리어를 적재/하역.
+ *
+ * 구조 (바닥 원점, y=0~depth):
+ *   - 하단 베이스 플레이트 (납작, 넓음, 레일 위 주행부)
+ *   - 중앙 마스트 (좌우 수직 기둥, statusColor 적용)
+ *   - 상단 포크 (2개의 평행한 가로 암, 캐리어 적재면)
+ */
+import * as THREE from 'three';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene';
+import { TRANSPORT_SURFACE_HEIGHT } from './machine-3d.js';
+const BASE_COLOR = 0x333333;
+const FORK_COLOR = 0x777777;
+const DEFAULT_BODY_COLOR = 0x6688cc;
+export class Shuttle3D extends RealObjectGroup {
+    get effectiveDepth() {
+        const { depth } = this.component.state;
+        return depth || TRANSPORT_SURFACE_HEIGHT;
+    }
+    get syncZPosOffset() {
+        return 0;
+    }
+    resolveColor() {
+        const comp = this.component;
+        try {
+            const sc = comp.statusColor;
+            if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0')
+                return new THREE.Color(sc).getHex();
+        }
+        catch (_a) {
+            /* statusColor 미구현 시 무시 */
+        }
+        const { fillStyle } = this.component.state;
+        if (fillStyle && typeof fillStyle === 'string') {
+            try {
+                return new THREE.Color(fillStyle).getHex();
+            }
+            catch (_b) {
+                /* 파싱 실패 시 무시 */
+            }
+        }
+        return DEFAULT_BODY_COLOR;
+    }
+    build() {
+        super.build();
+        const { width = 10, height = 10 } = this.component.state;
+        const w = Math.abs(width);
+        const h = Math.abs(height);
+        const d = this.effectiveDepth;
+        if (!w || !h)
+            return;
+        // 높이 배분: 베이스 15%, 마스트 55%, 포크 30%
+        const baseH = d * 0.15;
+        const mastH = d * 0.55;
+        const forkH = d * 0.30;
+        const mastThickness = Math.min(w, h) * 0.15;
+        // ── 1. 하단 베이스 플레이트 (납작하고 넓은 주행부) ──
+        const basePad = Math.min(w, h) * 0.05;
+        const baseGeo = new THREE.BoxGeometry(w + basePad * 2, baseH, h + basePad * 2);
+        const baseMat = new THREE.MeshStandardMaterial({
+            color: BASE_COLOR,
+            roughness: 0.7,
+            metalness: 0.3,
+        });
+        const baseMesh = new THREE.Mesh(baseGeo, baseMat);
+        baseMesh.position.y = baseH / 2;
+        baseMesh.castShadow = true;
+        baseMesh.receiveShadow = true;
+        this.object3d.add(baseMesh);
+        // ── 2. 좌우 마스트 기둥 (statusColor 적용) ──
+        const mastBaseY = baseH;
+        const bodyColor = this.resolveColor();
+        const mastMat = new THREE.MeshStandardMaterial({
+            color: bodyColor,
+            roughness: 0.4,
+            metalness: 0.5,
+        });
+        const mastGeometries = [];
+        // 좌우 수직 기둥
+        for (const xSign of [-1, 1]) {
+            const pillar = new THREE.BoxGeometry(mastThickness, mastH, mastThickness);
+            pillar.translate(xSign * (w / 2 - mastThickness / 2), mastBaseY + mastH / 2, 0);
+            mastGeometries.push(pillar);
+        }
+        // 중간 가로 연결 바 (구조 강성)
+        const crossBarW = w - mastThickness;
+        const crossBarH = mastThickness * 0.5;
+        const crossBar = new THREE.BoxGeometry(crossBarW, crossBarH, mastThickness);
+        crossBar.translate(0, mastBaseY + mastH * 0.4, 0);
+        mastGeometries.push(crossBar);
+        const mastMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(mastGeometries), mastMat);
+        mastMesh.castShadow = true;
+        this.object3d.add(mastMesh);
+        // ── 3. 상단 포크 (2개의 평행 암 + 백 플레이트) ──
+        const forkBaseY = mastBaseY + mastH;
+        const forkMat = new THREE.MeshStandardMaterial({
+            color: FORK_COLOR,
+            roughness: 0.4,
+            metalness: 0.6,
+        });
+        const forkGeometries = [];
+        // 백 플레이트 (마스트 상단을 잇는 가로판)
+        const backPlateH = forkH * 0.4;
+        const backPlate = new THREE.BoxGeometry(w, backPlateH, mastThickness * 0.8);
+        backPlate.translate(0, forkBaseY + backPlateH / 2, -h * 0.35);
+        forkGeometries.push(backPlate);
+        // 2개의 포크 암 (앞으로 뻗은 평행 막대)
+        const forkArmW = mastThickness * 0.7;
+        const forkArmH = forkH * 0.25;
+        const forkArmD = h * 0.85;
+        const forkSpacing = w * 0.55;
+        for (const xSign of [-1, 1]) {
+            const arm = new THREE.BoxGeometry(forkArmW, forkArmH, forkArmD);
+            arm.translate(xSign * (forkSpacing / 2), forkBaseY + forkArmH / 2, forkArmD / 2 - h * 0.35);
+            forkGeometries.push(arm);
+        }
+        const forkMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(forkGeometries), forkMat);
+        forkMesh.castShadow = true;
+        this.object3d.add(forkMesh);
+    }
+    updateDimension() { }
+    updateAlpha() { }
+    onchange(after, before) {
+        if ('width' in after || 'height' in after || 'depth' in after || 'fillStyle' in after || 'strokeStyle' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+}
+registerRealObjectFactory('Shuttle', (component) => new Shuttle3D(component));
+//# sourceMappingURL=shuttle-3d.js.map