@fmsim/machine 2.0.0-beta.3 → 2.0.0-beta.30

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

@@ -8,7 +8,10 @@
  *   - Unit: 낮은 depth, 불투명
  */
 import * as THREE from 'three';
-import { RealObjectGroup, registerRealObjectFactory } from '@hatiolab/things-scene';
+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';
 /**
  * 포트 기본 높이 (절대값).
  * 모든 이송장치의 상단 높이 = 이 값.
@@ -27,6 +30,8 @@ const DEFAULTS = {
 class MCSRealObject3D extends RealObjectGroup {
     constructor(component, config) {
         super(component);
+        // ── Change handling ──
+        this._updatePending = false;
         this._config = config;
     }
     // width, height 절대값 (음수 값은 양수로 취급)
@@ -45,14 +50,22 @@ class MCSRealObject3D extends RealObjectGroup {
     }
     get syncZPosOffset() {
         var _a, _b;
+        // zPosOverride: 고정 높이 (OHTLine 등)
+        if (this._config.zPosOverride != null) {
+            return this._config.zPosOverride;
+        }
         // Port: 이송 표면 높이에 배치
         if (this._config.defaultZPosFromParent) {
             return TRANSPORT_SURFACE_HEIGHT;
         }
-        // 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') {
+            // OHT: 그리퍼 아래에 매달림 (캐리어 상단이 OHT 하단에 붙음)
+            if (parentType === 'OHT') {
+                return -this.effectiveDepth;
+            }
+            if (parentType === 'Port' || parentType === 'Shelf' || parentType === 'Shuttle') {
                 return 0;
             }
             return TRANSPORT_SURFACE_HEIGHT;
@@ -66,7 +79,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) {
@@ -74,7 +87,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();
             }
@@ -114,7 +127,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 형태: 좌우 끝이 꺾인 육각형
@@ -139,7 +152,11 @@ class MCSRealObject3D extends RealObjectGroup {
         geo.rotateX(Math.PI / 2);
         return this.removeBottomFace(geo);
     }
-    // ── Build ──
+    buildPlaneGeometry(w, h) {
+        const geo = new THREE.PlaneGeometry(w, h);
+        geo.rotateX(-Math.PI / 2);
+        return geo;
+    }
     build() {
         var _a;
         super.build();
@@ -156,46 +173,164 @@ 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)
+                : 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;
         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 ──
+        // BoxGeometry material groups: +x(0), -x(1), +y(2), -y(3), +z(4), -z(5)
+        let meshMaterial = material;
+        if (shape === 'box') {
+            if (this._config.openTop) {
+                // 상단면 제거 → 5면 개방 박스
+                const invisible = new THREE.MeshBasicMaterial({ visible: false });
+                meshMaterial = [material, material, invisible, material, material, material];
+            }
+            else if (this._config.texturedTop) {
+                // 상판에 2D 렌더링 텍스처
+                const topMat = this.buildTopTexture(w, h);
+                meshMaterial = [material, material, topMat, material, material, material];
+            }
+            else if (this._config.matteTop) {
+                // 상판만 무반사
+                const matte = new THREE.MeshBasicMaterial({ color, opacity, transparent: opacity < 1 });
+                meshMaterial = [material, material, matte, material, material, material];
+            }
+        }
+        this._ownMesh = new THREE.Mesh(geometry, meshMaterial);
+        // sizeRatio < 1이면 부모 중심에 배치 (rawDepth/2), plane은 살짝 띄움
+        this._ownMesh.position.y = isPlane ? 1 : ratio < 1 ? rawDepth / 2 : depth / 2;
+        this._ownMesh.castShadow = !isPlane;
+        this._ownMesh.receiveShadow = true;
+        this.object3d.add(this._ownMesh);
+    }
     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();
+            'id' in after ||
+            'EMPTYTYPE' in after ||
+            'CARRIERSTATUS' in after) {
+            // 연속 setState에 의한 다중 rebuild 방지: 한 프레임에 한 번만 실행
+            if (!this._updatePending) {
+                this._updatePending = true;
+                queueMicrotask(() => {
+                    this._updatePending = false;
+                    this.update();
+                });
+            }
             return;
         }
         super.onchange(after, before);
     }
-    // RealObjectGroup 기본 동작 비활성화 (update()에서 일괄 처리)
+    /**
+     * 상판 텍스처: 컴포넌트의 2D render()를 캔버스에 그려서 텍스처로 사용
+     */
+    buildTopTexture(w, h) {
+        var _a;
+        const scale = 4;
+        const cw = this.nextPow2(w * scale);
+        const ch = this.nextPow2(h * scale);
+        const canvas = document.createElement('canvas');
+        canvas.width = cw;
+        canvas.height = ch;
+        const ctx = canvas.getContext('2d');
+        const statusColor = '#' + this.resolveColor().toString(16).padStart(6, '0');
+        const emptyType = ((_a = this.component.state) === null || _a === void 0 ? void 0 : _a.EMPTYTYPE) || '';
+        const text = emptyType === 'FULL' ? 'F' : emptyType === 'EMPTY' ? 'E' : emptyType === 'EMPTYEMPTY' ? 'X' : '';
+        // 실제 사용 영역 (nextPow2 이전 크기)
+        const usedW = w * scale;
+        const usedH = h * scale;
+        // 바탕: 캐리어 상태 색상 (사용 영역만)
+        ctx.fillStyle = statusColor;
+        ctx.fillRect(0, 0, usedW, usedH);
+        // 텍스트 (사용 영역 중앙)
+        if (text) {
+            const fontSize = Math.round(Math.min(usedW, usedH) * 0.7);
+            ctx.font = `bold ${fontSize}px Arial`;
+            ctx.textAlign = 'center';
+            ctx.textBaseline = 'middle';
+            ctx.fillStyle = '#000000';
+            ctx.fillText(text, usedW / 2, usedH / 2);
+        }
+        const texture = new THREE.CanvasTexture(canvas);
+        texture.offset.set(0, 1 - usedH / ch);
+        texture.repeat.set(usedW / cw, usedH / ch);
+        texture.colorSpace = THREE.SRGBColorSpace;
+        return new THREE.MeshBasicMaterial({
+            map: texture,
+            transparent: true,
+            side: THREE.DoubleSide,
+        });
+    }
+    nextPow2(n) {
+        if (!(n > 0))
+            return 1;
+        let v = Math.ceil(n);
+        v--;
+        v |= v >> 1;
+        v |= v >> 2;
+        v |= v >> 4;
+        v |= v >> 8;
+        v |= v >> 16;
+        return v + 1;
+    }
+    /**
+     * 자신의 mesh만 제거 후 rebuild.
+     * 기본 update()는 clear()로 object3d의 모든 children을 제거하는데,
+     * 컨테이너(Port 등)의 경우 자식 컴포넌트(Carrier 등)의 3D 오브젝트도 함께 제거됨.
+     * 이를 방지하기 위해 자신이 생성한 mesh만 제거한다.
+     */
+    update() {
+        // 자신의 mesh만 제거 (자식 컴포넌트 3D 오브젝트 보존)
+        if (this._ownMesh) {
+            this.object3d.remove(this._ownMesh);
+            disposeObject3D(this._ownMesh);
+            this._ownMesh = undefined;
+        }
+        this.build();
+        this.updateTransform();
+        this.updateAlpha();
+        this.updateHidden();
+    }
+    // RealObjectGroup 기본 동작 비활성화
     updateDimension() { }
-    updateAlpha() { }
+    updateAlpha() {
+        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;
+            const materials = Array.isArray(o.material) ? o.material : [o.material];
+            for (const m of materials) {
+                if (!m.visible)
+                    continue; // openTop invisible face 무시
+                if (m.map)
+                    continue; // 텍스처 material은 자체 transparent 유지
+                m.opacity = effective;
+                m.transparent = effective < 1;
+            }
+        });
+    }
 }
 // ── 팩토리 등록 헬퍼 ─────────────────────────────────────
 function register(type, overrides = {}) {
@@ -207,82 +342,469 @@ function register(type, overrides = {}) {
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 register('Equipment', {
     defaultDepth: 3 * TRANSPORT_SURFACE_HEIGHT,
-    opacity: 0.5,
+    opacity: 0.75,
     metalness: 0.4,
     roughness: 0.6,
     defaultColor: 0x8899aa,
 });
 register('Buffer', {
     defaultDepth: TRANSPORT_SURFACE_HEIGHT,
-    opacity: 0.5,
+    opacity: 1.0,
     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,
+    depthRatio: 0,
+    defaultDepth: 0.1,
     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,
-});
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  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 {
+    constructor(component) {
+        super(component, STOCKER_CONFIG);
+    }
+    build() {
+        super.build();
+        this.buildGauge();
+    }
+    buildGauge() {
+        var _a, _b;
+        const comp = this.component;
+        const data = comp.data || {};
+        const gaugeMode = ((_b = (_a = comp.root) === null || _a === void 0 ? void 0 : _a.style) === null || _b === void 0 ? void 0 : _b.stockerGaugeMode) || 'capacity';
+        const gauge = this.resolveGauge(data, gaugeMode);
+        // 테두리는 스토커의 상태 색상 (machine status)
+        const statusColor = comp.statusColor;
+        if (statusColor && statusColor.toUpperCase() !== '#F0F0F0') {
+            gauge.borderColor = statusColor;
+        }
+        const { w, h } = this.absSize;
+        const depth = this.effectiveDepth;
+        const isWidthLonger = w >= h;
+        // 게이지 캔버스 (고해상도)
+        const barW = 130;
+        const barH = 26;
+        const scale = 4;
+        const canvasW = barW * scale;
+        const canvasH = barH * scale;
+        const canvas = document.createElement('canvas');
+        canvas.width = canvasW;
+        canvas.height = canvasH;
+        const ctx = canvas.getContext('2d');
+        const pad = 12;
+        // 배경 + 테두리
+        ctx.fillStyle = '#dddddd';
+        ctx.fillRect(0, 0, canvasW, canvasH);
+        ctx.strokeStyle = gauge.borderColor;
+        ctx.lineWidth = 12;
+        ctx.strokeRect(6, 6, canvasW - 12, canvasH - 12);
+        // 세그먼트 채움 (왼→오)
+        const innerW = canvasW - pad * 2;
+        const innerH = canvasH - pad * 2;
+        let x = pad;
+        for (const seg of gauge.segments) {
+            const segW = Math.max(innerW * seg.ratio, seg.ratio > 0 ? 1 : 0);
+            if (segW <= 0)
+                continue;
+            ctx.fillStyle = seg.color;
+            ctx.fillRect(x, pad, segW, innerH);
+            x += segW;
+        }
+        // 텍스트
+        ctx.font = `bold ${10 * scale}px sans-serif`;
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.fillStyle = '#333333';
+        ctx.fillText(gauge.label, canvasW / 2, canvasH / 2);
+        // 텍스처 → Plane
+        const texture = new THREE.CanvasTexture(canvas);
+        texture.colorSpace = THREE.SRGBColorSpace;
+        const geo = new THREE.PlaneGeometry(barW, barH);
+        geo.rotateX(-Math.PI / 2); // 수평 (지붕 위)
+        if (!isWidthLonger)
+            geo.rotateY(Math.PI / 2);
+        const mat = new THREE.MeshBasicMaterial({
+            map: texture,
+            transparent: true,
+            side: THREE.DoubleSide,
+        });
+        mat.polygonOffset = true;
+        mat.polygonOffsetFactor = -2;
+        mat.polygonOffsetUnit = -2;
+        this.gaugeMesh = new THREE.Mesh(geo, mat);
+        this.gaugeMesh.position.set(0, depth + 0.5, 0);
+        this.object3d.add(this.gaugeMesh);
+    }
+    resolveGauge(data, mode) {
+        var _a, _b;
+        switch (mode) {
+            case 'carrier': {
+                const full = Number(data.FULL_CNT) || 0;
+                const empty = Number(data.EMPTY_CNT) || 0;
+                const emptyEmpty = Number(data.EMPTYEMPTY_CNT) || 0;
+                const total = full + empty + emptyEmpty;
+                const segments = total > 0
+                    ? [
+                        { ratio: full / total, color: '#4AA7FE' },
+                        { ratio: empty / total, color: '#8BDA5B' },
+                        { ratio: emptyEmpty / total, color: '#019D59' },
+                    ]
+                    : [{ ratio: 1, color: '#dddddd' }];
+                return {
+                    segments,
+                    borderColor: '#4AA7FE',
+                    label: total > 0 ? `F${full} E${empty} EE${emptyEmpty}` : '',
+                };
+            }
+            case 'abnormal': {
+                const normal = Number(data.CARRIER_NORMAL) || 0;
+                const abnormal = Number(data.CARRIER_ABNORMAL) || 0;
+                const total = normal + abnormal;
+                const segments = total > 0
+                    ? [
+                        { ratio: normal / total, color: '#8BDA5B' },
+                        { ratio: abnormal / total, color: '#F4B4B4' },
+                    ]
+                    : [{ ratio: 1, color: '#dddddd' }];
+                return {
+                    segments,
+                    borderColor: abnormal > 0 ? '#F4B4B4' : '#8BDA5B',
+                    label: total > 0 ? `N${normal} A${abnormal}` : '',
+                };
+            }
+            default: { // capacity
+                const cur = Number(data.CURRENTCAPACITY) || 0;
+                const max = Number(data.MAXCAPACITY) || 100;
+                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');
+                return {
+                    segments: [{ ratio: usage / 100, color }],
+                    borderColor: color,
+                    label: `${usage}%`,
+                };
+            }
+        }
+    }
+    onchange(after, before) {
+        if ('data' in after) {
+            this.clearGauge();
+            this.buildGauge();
+        }
+        super.onchange(after, before);
+    }
+    clear() {
+        this.clearGauge();
+        return super.clear();
+    }
+    clearGauge() {
+        var _a, _b;
+        if (this.gaugeMesh) {
+            this.object3d.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();
+            mat === null || mat === void 0 ? void 0 : mat.dispose();
+            this.gaugeMesh = undefined;
+        }
+    }
+}
+registerRealObjectFactory('STOCKER', (component) => new StockerRealObject3D(component));
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 //  Unit (이동체 · 홀더) — 낮은 depth, 불투명
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-register('Port', {
-    depthRatio: 0.5,
-    defaultZPosFromParent: true,
-    opacity: 0.5,
-    metalness: 0.4,
-    roughness: 0.6,
-    defaultColor: 0xb0a090,
-});
+// 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,
     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,
-});
+// Carrier: CARRIERSTATUS에 따른 3D 애니메이션 지원
+const CARRIER_CONFIG = Object.assign(Object.assign({}, DEFAULTS), { depthRatio: 0.5, metalness: 0, roughness: 1, defaultColor: 0x66bb66, isVisible: (c) => !!c.state.id, sizeRatio: 0.8, texturedTop: true });
+class CarrierRealObject3D extends MCSRealObject3D {
+    constructor(component) {
+        super(component, CARRIER_CONFIG);
+    }
+}
+registerRealObjectFactory('Carrier', (component) => new CarrierRealObject3D(component));
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 //  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,
-});
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Gauge (용량 게이지) — 2D 렌더링을 Plane 텍스처로 3D 표시
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// Gauge 컴포넌트 (StockerCapacityBar, ZoneCapacityBar, MCSGaugeCapacityBar)는
+// 3D에서 표시하지 않음. 대신 부모(STOCKER 등)의 3D 모델에서 직접 게이지를 렌더링.
+registerRealObjectFactory('StockerCapacityBar', () => null);
+registerRealObjectFactory('MCSGaugeCapacityBar', () => null);
+registerRealObjectFactory('ZoneCapacityBar', () => null);
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  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();
+        const { width = 10, height = 10 } = this.component.state;
+        const w = Math.abs(width);
+        const h = Math.abs(height);
+        if (!w || !h)
+            return;
+        // 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 'bottom':
+                    padBottom = Math.max(padBottom, fontSize + 4);
+                    break;
+                case 'left':
+                    padLeft = Math.max(padLeft, fontSize * 4 + 4);
+                    break;
+                case 'right':
+                    padRight = Math.max(padRight, fontSize * 4 + 4);
+                    break;
+            }
+        }
+        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);
+            }
+        }
+        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() {
+        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 ('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('PortFlow', (component) => new PortFlowRealObject3D(component));
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+//  Node — 2D render를 바닥 Plane 텍스처로 3D 표시
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+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 — 이송 표면 높이의 기둥 형태
+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: 'box' });
+registerRealObjectFactory('Scanner', (component) => new MCSRealObject3D(component, SCANNER_CONFIG));
 //# sourceMappingURL=machine-3d.js.map