@fmsim/machine 2.0.0-beta.7 → 2.0.0-beta.75

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

@@ -8,9 +8,10 @@
  *   - Unit: 낮은 depth, 불투명
  */
 import * as THREE from 'three';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
 import { RealObjectGroup, registerRealObjectFactory, disposeObject3D } from '@hatiolab/things-scene';
 import { LEGEND_CAPACITY } from '../features/mcs-status-default';
-import { getVaueOnRanges } from '../utils/get-value-on-ranges';
+import { getValueOnRanges } from '../utils/get-value-on-ranges';
 /**
  * 포트 기본 높이 (절대값).
  * 모든 이송장치의 상단 높이 = 이 값.
@@ -33,15 +34,28 @@ class MCSRealObject3D extends RealObjectGroup {
         this._updatePending = false;
         this._config = config;
     }
-    // width, height 절대값 (음수 값은 양수로 취급)
+    // width, height 절대값 (음수 값은 양수로 취급).
+    // `resizable:false` 컴포넌트(예: Scanner)는 state.width/height 가 없고
+    // bounds 만 있을 수 있으므로 bounds 를 fallback 으로 사용.
+    //
+    // `??` only catches null/undefined — a property-panel input that produced
+    // NaN would slip through and corrupt every downstream Math.* call. Use a
+    // finite check so NaN falls through to bounds → 10 like missing values do.
     get absSize() {
-        const { width = 10, height = 10 } = this.component.state;
+        const state = (this.component.state || {});
+        const bounds = (this.component.bounds || {});
+        const width = pickFinite(state.width, bounds.width, 10);
+        const height = pickFinite(state.height, bounds.height, 10);
         return { w: Math.abs(width), h: Math.abs(height) };
     }
     get effectiveDepth() {
         const { depth } = this.component.state;
-        if (depth)
+        // Truthy `if (depth)` already rejected NaN/0/undefined, but be explicit
+        // so the intent (and the resolution chain) reads cleanly: only an
+        // explicit positive finite number wins; everything else → defaults.
+        if (typeof depth === 'number' && Number.isFinite(depth) && depth > 0) {
             return depth;
+        }
         if (this._config.defaultDepth)
             return this._config.defaultDepth;
         const { w, h } = this.absSize;
@@ -49,20 +63,33 @@ class MCSRealObject3D extends RealObjectGroup {
     }
     get syncZPosOffset() {
         var _a, _b;
+        // syncZPosOffset = placement + geometric (center origin = effectiveDepth/2)
+        // 중첩 보정(parent shift 상쇄)은 base RealObject.cz가 parent.geometricOffsetY를
+        // 빼는 방식으로 처리하므로 여기선 placement + 본인 geometric만 반환
+        const halfD = this.effectiveDepth / 2;
+        // zPosOverride: 고정 높이 (OHTLine 등)
+        if (this._config.zPosOverride != null) {
+            return this._config.zPosOverride + halfD;
+        }
         // Port: 이송 표면 높이에 배치
         if (this._config.defaultZPosFromParent) {
-            return TRANSPORT_SURFACE_HEIGHT;
+            return TRANSPORT_SURFACE_HEIGHT + halfD;
         }
-        // Carrier: Port 안이면 중앙, 그 외 컨테이너면 상단 위
+        // Carrier: 부모 유형에 따라 배치 위치 결정
         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;
+            // OHT: 그리퍼 아래에 매달림 — placement = -effectiveDepth(carrier top이 OHT bottom)
+            if (parentType === 'OHT') {
+                return -this.effectiveDepth + halfD;
+            }
+            if (parentType === 'Port' || parentType === 'Shelf' || parentType === 'Shuttle') {
+                return halfD;
             }
-            return TRANSPORT_SURFACE_HEIGHT;
+            return TRANSPORT_SURFACE_HEIGHT + halfD;
         }
-        return 0;
+        return halfD;
     }
+    // geometric 부분(center origin: depth/2)은 base 기본값 사용 — override 불필요
     // 컴포넌트의 상태 색상(statusColor) 또는 fillStyle → Three.js 색상 변환
     resolveColor() {
         const comp = this.component;
@@ -70,7 +97,7 @@ class MCSRealObject3D extends RealObjectGroup {
         //    '#F0F0F0'은 상태 미설정 시 기본 fallback — 무시하고 defaultColor 사용
         try {
             const sc = comp.statusColor;
-            if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0')
+            if (typeof sc === 'string' && sc && sc.toUpperCase() !== '#F0F0F0' && sc !== 'transparent')
                 return new THREE.Color(sc).getHex();
         }
         catch (_a) {
@@ -78,7 +105,7 @@ class MCSRealObject3D extends RealObjectGroup {
         }
         // 2) state.fillStyle fallback
         const { fillStyle } = this.component.state;
-        if (fillStyle && typeof fillStyle === 'string') {
+        if (fillStyle && typeof fillStyle === 'string' && fillStyle !== 'transparent') {
             try {
                 return new THREE.Color(fillStyle).getHex();
             }
@@ -118,7 +145,7 @@ class MCSRealObject3D extends RealObjectGroup {
     // ── Geometry builders ──
     buildBoxGeometry(w, d, h) {
         const geo = new THREE.BoxGeometry(w, d, h);
-        return this.removeBottomFace(geo);
+        return this._config.keepBottomFace ? geo : this.removeBottomFace(geo);
     }
     buildHexagonGeometry(w, d, h) {
         // Buffer의 2D 형태: 좌우 끝이 꺾인 육각형
@@ -143,6 +170,37 @@ class MCSRealObject3D extends RealObjectGroup {
         geo.rotateX(Math.PI / 2);
         return this.removeBottomFace(geo);
     }
+    buildPlaneGeometry(w, h) {
+        const geo = new THREE.PlaneGeometry(w, h);
+        geo.rotateX(-Math.PI / 2);
+        return geo;
+    }
+    /**
+     * 삼각형 prism — 2D Triangle 의 꼭짓점(state.x1/y1, x2/y2, x3/y3) 을 그대로 사용.
+     * things-scene 의 TriangleExtrude 와 동일한 방식 — 각 Scanner 인스턴스의
+     * 실제 정점 배치(방향, 비대칭 등) 가 3D 에 반영된다.
+     *
+     * `geometry.center()` 로 로컬 원점을 bounding-box 중심으로 맞추므로
+     * 후속 placement 와 정합.
+     */
+    buildTriangleGeometry(d) {
+        const state = (this.component.state || {});
+        const { x1 = 0, y1 = 0, x2 = 0, y2 = 0, x3 = 0, y3 = 0 } = state;
+        const shape = new THREE.Shape();
+        shape.moveTo(x1, y1);
+        shape.lineTo(x2, y2);
+        shape.lineTo(x3, y3);
+        shape.closePath();
+        const geo = new THREE.ExtrudeGeometry(shape, {
+            steps: 1,
+            depth: d,
+            bevelEnabled: false,
+        });
+        // bounding box 중심으로 원점 정렬 후 Y-up 좌표계로 회전
+        geo.center();
+        geo.rotateX(Math.PI / 2);
+        return this.removeBottomFace(geo);
+    }
     build() {
         var _a;
         super.build();
@@ -159,18 +217,25 @@ class MCSRealObject3D extends RealObjectGroup {
         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,
-        });
+        const geometry = shape === 'plane'
+            ? this.buildPlaneGeometry(w, h)
+            : shape === 'hexagon'
+                ? this.buildHexagonGeometry(w, depth, h)
+                : shape === 'triangle'
+                    ? this.buildTriangleGeometry(depth)
+                    : this.buildBoxGeometry(w, depth, h);
+        const isPlane = shape === 'plane';
+        const material = isPlane
+            ? new THREE.MeshBasicMaterial({
+                color,
+                opacity,
+                transparent: opacity < 1,
+                side: THREE.DoubleSide,
+            })
+            : new THREE.MeshStandardMaterial(Object.assign({ color,
+                metalness,
+                roughness,
+                opacity, transparent: opacity < 1, side: opacity < 1 ? THREE.DoubleSide : THREE.FrontSide }, (this._config.emissiveIntensity ? { emissive: color, emissiveIntensity: this._config.emissiveIntensity } : {})));
         // z-fighting 방지: 바닥면(floor grid)보다 항상 앞에 렌더링
         material.polygonOffset = true;
         material.polygonOffsetFactor = -1;
@@ -195,11 +260,14 @@ class MCSRealObject3D extends RealObjectGroup {
             }
         }
         this._ownMesh = new THREE.Mesh(geometry, meshMaterial);
-        // sizeRatio < 1이면 부모 중심에 배치 (rawDepth/2), 아니면 자체 중심 (depth/2)
-        this._ownMesh.position.y = ratio < 1 ? rawDepth / 2 : depth / 2;
-        this._ownMesh.castShadow = true;
+        // ownGroup 기준(bottom-up): mesh 바닥을 y=0에 맞추고 ownGroup이 -d/2로 shift해
+        // center-origin object3d에 정렬됨.
+        //   box/hexagon (center-local geometry): y=rawDepth/2 (바닥을 0에 맞춤)
+        //   plane: y=1 (바닥 살짝 띄움)
+        this._ownMesh.position.y = isPlane ? 1 : rawDepth / 2;
+        this._ownMesh.castShadow = !isPlane;
         this._ownMesh.receiveShadow = true;
-        this.object3d.add(this._ownMesh);
+        this.components3D.add(this._ownMesh);
     }
     onchange(after, before) {
         if ('width' in after ||
@@ -283,7 +351,7 @@ class MCSRealObject3D extends RealObjectGroup {
     update() {
         // 자신의 mesh만 제거 (자식 컴포넌트 3D 오브젝트 보존)
         if (this._ownMesh) {
-            this.object3d.remove(this._ownMesh);
+            this.components3D.remove(this._ownMesh);
             disposeObject3D(this._ownMesh);
             this._ownMesh = undefined;
         }
@@ -295,9 +363,9 @@ class MCSRealObject3D extends RealObjectGroup {
     // RealObjectGroup 기본 동작 비활성화
     updateDimension() { }
     updateAlpha() {
-        const { alpha = 1 } = this.component.state;
-        const configOpacity = this._config.opacity;
-        const effective = configOpacity * alpha;
+        const state = this.component.state;
+        // alpha가 명시적으로 설정되어 있으면 그 값을 사용, 없으면 config 기본값 적용
+        const effective = ('alpha' in state) ? state.alpha : this._config.opacity;
         this.object3d.traverse((o) => {
             if (!o.material)
                 return;
@@ -313,6 +381,19 @@ class MCSRealObject3D extends RealObjectGroup {
         });
     }
 }
+// ── 헬퍼 ────────────────────────────────────────────────
+/**
+ * Returns the first argument that is a finite number. NaN slips past `??`
+ * (which only catches null/undefined), so without this a property-panel
+ * input producing NaN would corrupt absSize and cascade through Math.*.
+ */
+function pickFinite(...candidates) {
+    for (const c of candidates) {
+        if (typeof c === 'number' && Number.isFinite(c))
+            return c;
+    }
+    return 0;
+}
 // ── 팩토리 등록 헬퍼 ─────────────────────────────────────
 function register(type, overrides = {}) {
     const config = Object.assign(Object.assign({}, DEFAULTS), overrides);
@@ -337,17 +418,89 @@ register('Buffer', {
     shape: 'hexagon',
 });
 register('AGVLine', {
-    depthRatio: 0.12,
-    metalness: 0.6,
-    roughness: 0.3,
-    defaultColor: 0x888899,
-});
-register('OHTLine', {
-    depthRatio: 0.12,
+    depthRatio: 0,
+    defaultDepth: 0.1,
     metalness: 0.6,
     roughness: 0.3,
     defaultColor: 0x888899,
 });
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  OHTLine — 천장 I-beam 레일
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+const OHT_LINE_RAIL_COLOR = 0xcccccc;
+const OHT_LINE_HEIGHT = 7 * TRANSPORT_SURFACE_HEIGHT; // OHT 상단과 일치
+class OHTLineRealObject3D extends RealObjectGroup {
+    get effectiveDepth() { return 0; }
+    get syncZPosOffset() { return OHT_LINE_HEIGHT; }
+    build() {
+        super.build();
+        const { width = 10, height = 10 } = this.component.state;
+        const w = Math.abs(width);
+        const h = Math.abs(height);
+        if (!w || !h)
+            return;
+        // I-beam 치수: 이송 방향 = 긴 변, 폭은 2D의 1/2
+        const isVertical = w < h;
+        const shortSide = isVertical ? w : h; // 2D 원본 짧은 쪽 폭
+        const beltW = shortSide * 0.25; // I-beam 폭: 원본의 1/4
+        const beamH = Math.max(beltW * 0.5, 3); // I-beam 전체 높이
+        const inset = shortSide * 0.5; // 양끝 여백: 원본 폭의 1/2
+        const railLen = (isVertical ? h : w) - inset * 2;
+        const flangeH = beamH * 0.2; // 플랜지 두께
+        const flangeW = beltW * 0.8; // 플랜지 폭
+        const webH = beamH - flangeH * 2; // 웹 높이
+        const webW = Math.max(flangeW * 0.25, 1); // 웹 두께
+        const mat = new THREE.MeshStandardMaterial({
+            color: OHT_LINE_RAIL_COLOR,
+            metalness: 0.5,
+            roughness: 0.4,
+        });
+        const geoms = [];
+        // 상부 플랜지
+        const topFlange = isVertical
+            ? new THREE.BoxGeometry(flangeW, flangeH, railLen)
+            : new THREE.BoxGeometry(railLen, flangeH, flangeW);
+        topFlange.translate(0, -flangeH / 2, 0);
+        geoms.push(topFlange);
+        // 웹 (수직판)
+        const web = isVertical
+            ? new THREE.BoxGeometry(webW, webH, railLen)
+            : new THREE.BoxGeometry(railLen, webH, webW);
+        web.translate(0, -flangeH - webH / 2, 0);
+        geoms.push(web);
+        // 하부 플랜지
+        const botFlange = isVertical
+            ? new THREE.BoxGeometry(flangeW, flangeH, railLen)
+            : new THREE.BoxGeometry(railLen, flangeH, flangeW);
+        botFlange.translate(0, -flangeH - webH - flangeH / 2, 0);
+        geoms.push(botFlange);
+        this._mesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(geoms), mat);
+        this._mesh.castShadow = true;
+        this.object3d.add(this._mesh);
+    }
+    update() {
+        if (this._mesh) {
+            this.object3d.remove(this._mesh);
+            this._mesh.geometry.dispose();
+            this._mesh.material.dispose();
+            this._mesh = undefined;
+        }
+        this.build();
+        this.updateTransform();
+        this.updateHidden();
+    }
+    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);
+    }
+    updateDimension() { }
+    updateAlpha() { }
+}
+registerRealObjectFactory('OHTLine', (component) => new OHTLineRealObject3D(component));
 // STOCKER: 벽면에 용량 게이지 바를 포함하는 커스텀 3D 오브젝트
 const STOCKER_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { defaultDepth: 5 * TRANSPORT_SURFACE_HEIGHT, opacity: 0.75, metalness: 0.3, roughness: 0.6, defaultColor: 0x8899bb });
 class StockerRealObject3D extends MCSRealObject3D {
@@ -423,8 +576,9 @@ class StockerRealObject3D extends MCSRealObject3D {
         mat.polygonOffsetFactor = -2;
         mat.polygonOffsetUnit = -2;
         this.gaugeMesh = new THREE.Mesh(geo, mat);
+        // ownGroup 기준(bottom-up): 볼륨 상단 = +depth. 그 위로 0.5 띄움.
         this.gaugeMesh.position.set(0, depth + 0.5, 0);
-        this.object3d.add(this.gaugeMesh);
+        this.components3D.add(this.gaugeMesh);
     }
     resolveGauge(data, mode) {
         var _a, _b;
@@ -469,7 +623,7 @@ class StockerRealObject3D extends MCSRealObject3D {
                 const fullup = data.FULLUP === 'T';
                 const usage = Math.round((cur / max) * 100);
                 const legend = ((_b = (_a = this.component.root) === null || _a === void 0 ? void 0 : _a.style) === null || _b === void 0 ? void 0 : _b.LEGEND_CAPACITY) || LEGEND_CAPACITY;
-                const color = fullup ? 'red' : (getVaueOnRanges(usage, legend) || '#44aa44');
+                const color = fullup ? 'red' : (getValueOnRanges(usage, legend) || '#44aa44');
                 return {
                     segments: [{ ratio: usage / 100, color }],
                     borderColor: color,
@@ -478,6 +632,10 @@ class StockerRealObject3D extends MCSRealObject3D {
             }
         }
     }
+    update() {
+        this.clearGauge();
+        super.update();
+    }
     onchange(after, before) {
         if ('data' in after) {
             this.clearGauge();
@@ -492,7 +650,7 @@ class StockerRealObject3D extends MCSRealObject3D {
     clearGauge() {
         var _a, _b;
         if (this.gaugeMesh) {
-            this.object3d.remove(this.gaugeMesh);
+            this.components3D.remove(this.gaugeMesh);
             (_a = this.gaugeMesh.geometry) === null || _a === void 0 ? void 0 : _a.dispose();
             const mat = this.gaugeMesh.material;
             (_b = mat === null || mat === void 0 ? void 0 : mat.map) === null || _b === void 0 ? void 0 : _b.dispose();
@@ -505,8 +663,8 @@ registerRealObjectFactory('STOCKER', (component) => new StockerRealObject3D(comp
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 //  Unit (이동체 · 홀더) — 낮은 depth, 불투명
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Port: 상부 개방 5면 박스
-const PORT_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { depthRatio: 0.5, defaultZPosFromParent: true, opacity: 0.5, metalness: 0.4, roughness: 0.6, defaultColor: 0xb0a090, openTop: true });
+// Port: 바닥판 (PlaneGeometry)
+const PORT_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { depthRatio: 0.01, defaultZPosFromParent: true, opacity: 0.1, metalness: 0.3, roughness: 0.8, defaultColor: 0xb0a090, shape: 'plane' });
 registerRealObjectFactory('Port', (component) => new MCSRealObject3D(component, PORT_CONFIG));
 register('Shelf', {
     depthRatio: 0.25,
@@ -515,113 +673,206 @@ register('Shelf', {
     defaultColor: 0xaabbcc,
 });
 // Carrier: CARRIERSTATUS에 따른 3D 애니메이션 지원
-const CARRIER_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { depthRatio: 0.5, metalness: 0.2, roughness: 0.8, defaultColor: 0x66bb66, isVisible: (c) => !!c.state.id, sizeRatio: 0.8, texturedTop: true });
+const CARRIER_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { depthRatio: 0.5, metalness: 0, roughness: 1, defaultColor: 0xf0f0f0, isVisible: (c) => !!c.state.id, sizeRatio: 0.8, texturedTop: true });
 class CarrierRealObject3D extends MCSRealObject3D {
     constructor(component) {
         super(component, CARRIER_CONFIG);
-        this._animRaf = null;
-        this._animStartTime = 0;
+    }
+}
+registerRealObjectFactory('Carrier', (component) => new CarrierRealObject3D(component));
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Gauge (용량 게이지) — 얇은 바
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Gauge (용량 게이지) — 2D 렌더링을 Plane 텍스처로 3D 표시
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// Gauge 컴포넌트는 3D에서 표시하지 않음 (부모 STOCKER의 3D 모델에서 직접 게이지 렌더링)
+// null 반환으로 3D 오브젝트 생성을 억제하고, default factory fallback도 방지
+registerRealObjectFactory('StockerCapacityBar', () => undefined);
+registerRealObjectFactory('MCSGaugeCapacityBar', () => undefined);
+registerRealObjectFactory('ZoneCapacityBar', () => undefined);
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  PortFlow — 2D render를 Plane 텍스처로 3D 표시
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+class PortFlowRealObject3D extends RealObjectGroup {
+    get effectiveDepth() { return 0; }
+    get syncZPosOffset() {
+        var _a;
+        // 부모 Port/Conveyor의 zPos와 동일하게
+        const parent = this.component.parentObject;
+        if (((_a = parent === null || parent === void 0 ? void 0 : parent.state) === null || _a === void 0 ? void 0 : _a.zPos) != null)
+            return parent.state.zPos;
+        return TRANSPORT_SURFACE_HEIGHT;
     }
     build() {
         super.build();
-        this.startCarrierAnimation();
-    }
-    /**
-     * CARRIERSTATUS의 애니메이션 설정을 읽어 3D에서 직접 실행.
-     * things-scene의 delta 시스템과 독립적으로 동작.
-     */
-    startCarrierAnimation() {
-        var _a, _b, _c;
-        this.stopCarrierAnimation();
-        const comp = this.component;
-        if (!((_a = comp.app) === null || _a === void 0 ? void 0 : _a.isViewMode))
-            return;
-        const carrierStatus = (_b = comp.state) === null || _b === void 0 ? void 0 : _b.CARRIERSTATUS;
-        if (!carrierStatus)
-            return;
-        // 애니메이션 설정 가져오기
-        const config = (_c = comp.getAnimationConfig) === null || _c === void 0 ? void 0 : _c.call(comp, carrierStatus);
-        if (!(config === null || config === void 0 ? void 0 : config.animation))
-            return;
-        const { type, duration = 2000, scale: animScale = 1.3 } = config.animation;
-        if (!type)
+        const { width = 10, height = 10 } = this.component.state;
+        const w = Math.abs(width);
+        const h = Math.abs(height);
+        if (!w || !h)
             return;
-        this._animStartTime = performance.now();
-        // 애니메이션 대상: group(object3d) — mesh 개별 변환 대신 group 전체를 변환하여
-        // 회전/스케일 중심이 component의 3D 위치(= 2D 중심)와 정확히 일치하도록 함
-        const obj = this.object3d;
-        const animate = () => {
-            var _a;
-            if (!this._ownMesh)
-                return;
-            const elapsed = performance.now() - this._animStartTime;
-            const progress = (elapsed % duration) / duration; // 0~1 반복
-            switch (type) {
-                case 'heartbeat': {
-                    const t = progress < 0.5 ? progress * 2 : (1 - progress) * 2;
-                    const s = 1 + (animScale - 1) * t;
-                    obj.scale.set(s, 1, s);
+        // 2D render를 캔버스에 캡처
+        // 화살표 날개 + 텍스트 영역이 bounds 밖으로 나가므로 전체 영역 계산
+        const { left, top } = this.component.bounds;
+        const { fontSize = 24, labelPosition = 'top' } = this.component.state;
+        const arrowPad = Math.min(w, h) * 0.4;
+        // 텍스트 영역 확장
+        let padLeft = arrowPad, padRight = arrowPad, padTop = arrowPad, padBottom = arrowPad;
+        if (this.component.hasTextProperty) {
+            switch (labelPosition) {
+                case 'top':
+                    padTop = Math.max(padTop, fontSize + 4);
                     break;
-                }
-                case 'rotation': {
-                    obj.rotation.y = progress * Math.PI * 2;
+                case 'bottom':
+                    padBottom = Math.max(padBottom, fontSize + 4);
                     break;
-                }
-                case 'vibration': {
-                    const theta = (_a = config.animation.theta) !== null && _a !== void 0 ? _a : 0.26;
-                    const current = Math.sin(progress * Math.PI * 2) * theta;
-                    obj.rotation.y = current;
+                case 'left':
+                    padLeft = Math.max(padLeft, fontSize * 4 + 4);
                     break;
-                }
-                case 'fade': {
-                    const alpha = 0.3 + 0.7 * (progress < 0.5 ? progress * 2 : (1 - progress) * 2);
-                    obj.traverse((o) => {
-                        if (o.material && !o.material.map) {
-                            o.material.opacity = alpha;
-                            o.material.transparent = true;
-                        }
-                    });
+                case 'right':
+                    padRight = Math.max(padRight, fontSize * 4 + 4);
                     break;
-                }
             }
-            this._animRaf = requestAnimationFrame(animate);
-        };
-        this._animRaf = requestAnimationFrame(animate);
-    }
-    // 자체 애니메이션이 실행 중이면 things-scene의 syncAnimationDelta 비활성화
-    syncAnimationDelta() {
-        if (!this._animRaf) {
-            super.syncAnimationDelta();
         }
-    }
-    stopCarrierAnimation() {
-        if (this._animRaf) {
-            cancelAnimationFrame(this._animRaf);
-            this._animRaf = null;
+        const totalW = w + padLeft + padRight;
+        const totalH = h + padTop + padBottom;
+        const scale = 2;
+        const canvas = document.createElement('canvas');
+        canvas.width = totalW * scale;
+        canvas.height = totalH * scale;
+        const ctx = canvas.getContext('2d');
+        ctx.save();
+        ctx.scale(scale, scale);
+        ctx.translate(-left + padLeft, -top + padTop);
+        try {
+            // 화살표 렌더
+            this.component.render(ctx);
+            ctx.fillStyle = this.component.state.strokeStyle || '#666666';
+            ctx.fill();
+            // 텍스트 렌더
+            if (this.component.hasTextProperty && this.component.drawText) {
+                ;
+                this.component.drawText(ctx);
+            }
         }
-        // group 스케일/회전 초기화
-        this.object3d.scale.set(1, 1, 1);
-        this.object3d.rotation.y = 0;
+        catch ( /* render 실패 시 빈 텍스처 */_a) { /* render 실패 시 빈 텍스처 */ }
+        ctx.restore();
+        this._texture = new THREE.CanvasTexture(canvas);
+        this._texture.colorSpace = THREE.SRGBColorSpace;
+        const geo = new THREE.PlaneGeometry(totalW, totalH);
+        geo.rotateX(-Math.PI / 2);
+        const mat = new THREE.MeshBasicMaterial({
+            map: this._texture,
+            alphaTest: 0.1,
+            side: THREE.DoubleSide,
+        });
+        this._mesh = new THREE.Mesh(geo, mat);
+        // 비대칭 패딩 보정: 플레인 센터를 컴포넌트 bounds 센터에 맞춤
+        this._mesh.position.x = (padRight - padLeft) / 2;
+        this._mesh.position.y = 1;
+        this._mesh.position.z = (padBottom - padTop) / 2;
+        this.object3d.add(this._mesh);
     }
     update() {
-        this.stopCarrierAnimation();
-        super.update();
+        var _a;
+        if (this._mesh) {
+            this.object3d.remove(this._mesh);
+            this._mesh.geometry.dispose();
+            this._mesh.material.dispose();
+            (_a = this._texture) === null || _a === void 0 ? void 0 : _a.dispose();
+            this._mesh = undefined;
+            this._texture = undefined;
+        }
+        this.build();
+        this.updateTransform();
+        this.updateHidden();
     }
-    clear() {
-        this.stopCarrierAnimation();
-        return super.clear();
+    onchange(after, before) {
+        if ('width' in after || 'height' in after || 'orientation' in after ||
+            'direction' in after || 'strokeStyle' in after || 'INOUTTYPE' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
     }
+    updateDimension() { }
+    updateAlpha() { }
 }
-registerRealObjectFactory('Carrier', (component) => new CarrierRealObject3D(component));
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-//  Gauge (용량 게이지) — 얇은 바
+registerRealObjectFactory('PortFlow', (component) => new PortFlowRealObject3D(component));
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Node — 2D render를 바닥 Plane 텍스처로 3D 표시
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-//  Gauge (용량 게이지) — 2D 렌더링을 Plane 텍스처로 3D 표시
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// Gauge 컴포넌트 (StockerCapacityBar, ZoneCapacityBar, MCSGaugeCapacityBar)는
-// 3D에서 표시하지 않음. 대신 부모(STOCKER 등)의 3D 모델에서 직접 게이지를 렌더링.
-registerRealObjectFactory('StockerCapacityBar', () => null);
-registerRealObjectFactory('MCSGaugeCapacityBar', () => null);
-registerRealObjectFactory('ZoneCapacityBar', () => null);
+class NodeRealObject3D extends RealObjectGroup {
+    get effectiveDepth() { return 0; }
+    get syncZPosOffset() { return 0; }
+    build() {
+        super.build();
+        const { cx, cy } = this.component.state;
+        const radius = 8;
+        const size = radius * 2;
+        const scale = 2;
+        const pad = 2;
+        const canvas = document.createElement('canvas');
+        canvas.width = (size + pad * 2) * scale;
+        canvas.height = (size + pad * 2) * scale;
+        const ctx = canvas.getContext('2d');
+        ctx.save();
+        ctx.scale(scale, scale);
+        ctx.translate(-cx + radius + pad, -cy + radius + pad);
+        try {
+            this.component.render(ctx);
+            const { fillStyle = '#888888' } = this.component.state;
+            ctx.fillStyle = typeof fillStyle === 'string' ? fillStyle : '#888888';
+            ctx.fill();
+            const { strokeStyle } = this.component.state;
+            if (strokeStyle && typeof strokeStyle === 'string') {
+                ctx.strokeStyle = strokeStyle;
+                ctx.lineWidth = 1;
+                ctx.stroke();
+            }
+        }
+        catch ( /* render 실패 시 빈 텍스처 */_a) { /* render 실패 시 빈 텍스처 */ }
+        ctx.restore();
+        this._texture = new THREE.CanvasTexture(canvas);
+        this._texture.colorSpace = THREE.SRGBColorSpace;
+        const geo = new THREE.PlaneGeometry(size + pad * 2, size + pad * 2);
+        geo.rotateX(-Math.PI / 2);
+        const mat = new THREE.MeshBasicMaterial({
+            map: this._texture,
+            alphaTest: 0.1,
+            side: THREE.DoubleSide,
+        });
+        this._mesh = new THREE.Mesh(geo, mat);
+        this._mesh.position.y = 1;
+        this.object3d.add(this._mesh);
+    }
+    update() {
+        var _a;
+        if (this._mesh) {
+            this.object3d.remove(this._mesh);
+            this._mesh.geometry.dispose();
+            this._mesh.material.dispose();
+            (_a = this._texture) === null || _a === void 0 ? void 0 : _a.dispose();
+            this._mesh = undefined;
+            this._texture = undefined;
+        }
+        this.build();
+        this.updateTransform();
+        this.updateHidden();
+    }
+    onchange(after, before) {
+        if ('fillStyle' in after || 'strokeStyle' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+    updateDimension() { }
+    updateAlpha() { }
+}
+registerRealObjectFactory('Node', (component) => new NodeRealObject3D(component));
+// Scanner — 2D Triangle 실루엣과 정합되는 삼각형 prism.
+// 이송 표면 높이의 0.2배(=6) 얇은 기둥 — 원래 값 유지, shape 만 'box' → 'triangle'.
+const SCANNER_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { defaultDepth: TRANSPORT_SURFACE_HEIGHT * 0.2, defaultZPosFromParent: true, opacity: 1, metalness: 0.3, roughness: 0.7, defaultColor: 0x888888, shape: 'triangle' });
+registerRealObjectFactory('Scanner', (component) => new MCSRealObject3D(component, SCANNER_CONFIG));
 //# sourceMappingURL=machine-3d.js.map