@operato/scene-storage 10.0.0-beta.47 → 10.0.0-beta.50

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.0.0-beta.50](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.49...v10.0.0-beta.50) (2026-05-28)
+
+
+### :rocket: New Features
+
+* **scene-base,transport:** AMR 자동 운반 — planTransfer 다중 hop + zone 좌표 정합 + slot reservation ([3474236](https://github.com/things-scene/operato-scene/commit/347423683c9814627334f134259b203117a32a69))
+* **storage,transport:** PickingStation + PickingCart — picking workflow 컴포넌트 ([8017e39](https://github.com/things-scene/operato-scene/commit/8017e39c5caeed81200b1c922bf1176cf85784b8))
+* **storage:** Stockpile + StockpileGrid — 평치 보관 컴포넌트 ([d144cb0](https://github.com/things-scene/operato-scene/commit/d144cb0e7731800569594c29e0cf49c7e2fd71d9))
+
+
+### :house: Code Refactoring
+
+* **storage:** StockpileGrid 데이터 구조 단순화 — cells → data 통일, cell override 제거 ([475e72d](https://github.com/things-scene/operato-scene/commit/475e72d4c03b562b240da00f56177af51f27b2c6))
+
+
+
+## [10.0.0-beta.48](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.47...v10.0.0-beta.48) (2026-05-26)
+
+**Note:** Version bump only for package @operato/scene-storage
+
+
+
+
+
 ## [10.0.0-beta.47](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.46...v10.0.0-beta.47) (2026-05-26)
 
 

package/dist/index.d.ts

@@ -17,6 +17,15 @@ export type { CraneState, CraneStatus } from './crane.js';
 export { Crane3D } from './crane-3d.js';
 export { default as Spot } from './spot.js';
 export { Spot3D } from './spot-3d.js';
+export { default as Stockpile } from './stockpile.js';
+export type { StockpileState, StockpileRecord, StackPattern, CarrierPreset, PickPolicy } from './stockpile.js';
+export { Stockpile3D } from './stockpile-3d.js';
+export { default as StockpileGrid } from './stockpile-grid.js';
+export type { StockpileGridState, StockpileGridCell } from './stockpile-grid.js';
+export { StockpileGrid3D } from './stockpile-grid-3d.js';
+export { default as PickingStation } from './picking-station.js';
+export type { PickingStationState, PickingStationStatus } from './picking-station.js';
+export { PickingStation3D } from './picking-station-3d.js';
 export { default as GenericContainer } from './generic-container.js';
 export type { ContainerStatus } from './generic-container.js';
 export { GenericContainer3D } from './generic-container-3d.js';

package/dist/index.js

@@ -14,6 +14,12 @@ export { default as Crane } from './crane.js';
 export { Crane3D } from './crane-3d.js';
 export { default as Spot } from './spot.js';
 export { Spot3D } from './spot-3d.js';
+export { default as Stockpile } from './stockpile.js';
+export { Stockpile3D } from './stockpile-3d.js';
+export { default as StockpileGrid } from './stockpile-grid.js';
+export { StockpileGrid3D } from './stockpile-grid-3d.js';
+export { default as PickingStation } from './picking-station.js';
+export { PickingStation3D } from './picking-station-3d.js';
 export { default as GenericContainer } from './generic-container.js';
 export { GenericContainer3D } from './generic-container-3d.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AAGzC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAE7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nexport { default as Pallet } from './pallet.js'\nexport type { PalletMaterial } from './pallet.js'\n\nexport { default as Box } from './box.js'\nexport type { BoxMaterial } from './box.js'\n\nexport { default as Parcel } from './parcel.js'\n\nexport { default as StorageRack } from './storage-rack.js'\nexport type { StorageRackState } from './storage-rack.js'\nexport { StorageRack3D } from './storage-rack-3d.js'\nexport { default as RackGrid } from './rack-grid.js'\nexport type { RackGridState, CellOverride } from './rack-grid.js'\nexport { RackGrid3D } from './rack-grid-3d.js'\nexport { default as RackGridCell } from './rack-grid-cell.js'\nexport type { RackGridCellState } from './rack-grid-cell.js'\nexport { default as MobileStorageRack } from './mobile-storage-rack.js'\nexport { default as Crane } from './crane.js'\nexport type { CraneState, CraneStatus } from './crane.js'\nexport { Crane3D } from './crane-3d.js'\n\nexport { default as Spot } from './spot.js'\nexport { Spot3D } from './spot-3d.js'\n\nexport { default as GenericContainer } from './generic-container.js'\nexport type { ContainerStatus } from './generic-container.js'\nexport { GenericContainer3D } from './generic-container-3d.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AAGzC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAE7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAIrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nexport { default as Pallet } from './pallet.js'\nexport type { PalletMaterial } from './pallet.js'\n\nexport { default as Box } from './box.js'\nexport type { BoxMaterial } from './box.js'\n\nexport { default as Parcel } from './parcel.js'\n\nexport { default as StorageRack } from './storage-rack.js'\nexport type { StorageRackState } from './storage-rack.js'\nexport { StorageRack3D } from './storage-rack-3d.js'\nexport { default as RackGrid } from './rack-grid.js'\nexport type { RackGridState, CellOverride } from './rack-grid.js'\nexport { RackGrid3D } from './rack-grid-3d.js'\nexport { default as RackGridCell } from './rack-grid-cell.js'\nexport type { RackGridCellState } from './rack-grid-cell.js'\nexport { default as MobileStorageRack } from './mobile-storage-rack.js'\nexport { default as Crane } from './crane.js'\nexport type { CraneState, CraneStatus } from './crane.js'\nexport { Crane3D } from './crane-3d.js'\n\nexport { default as Spot } from './spot.js'\nexport { Spot3D } from './spot-3d.js'\n\nexport { default as Stockpile } from './stockpile.js'\nexport type {\n  StockpileState, StockpileRecord, StackPattern, CarrierPreset, PickPolicy\n} from './stockpile.js'\nexport { Stockpile3D } from './stockpile-3d.js'\n\nexport { default as StockpileGrid } from './stockpile-grid.js'\nexport type { StockpileGridState, StockpileGridCell } from './stockpile-grid.js'\nexport { StockpileGrid3D } from './stockpile-grid-3d.js'\n\nexport { default as PickingStation } from './picking-station.js'\nexport type { PickingStationState, PickingStationStatus } from './picking-station.js'\nexport { PickingStation3D } from './picking-station-3d.js'\n\nexport { default as GenericContainer } from './generic-container.js'\nexport type { ContainerStatus } from './generic-container.js'\nexport { GenericContainer3D } from './generic-container-3d.js'\n"]}

package/dist/picking-station-3d.d.ts

@@ -0,0 +1,20 @@
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class PickingStation3D extends RealObjectGroup {
+    private _padMesh?;
+    private _padOutline?;
+    private _tableMesh?;
+    build(): void;
+    /** carrier 안착 anchor — 작업대 top face. */
+    getAttachFrame(): THREE.Object3D | undefined;
+    private _padColor;
+    private _strokeColor;
+    /** status 에 따른 작업대 색 — idle/processing/busy. */
+    private _statusColor;
+    private _applyPadColor;
+    private _applyStrokeColor;
+    private _applyStatusColor;
+    updateAlpha(): void;
+    updateDimension(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+}

package/dist/picking-station-3d.js

@@ -0,0 +1,162 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * PickingStation3D — 사람 작업 위치의 3D 시각화. pad(영역) + 작업대(가운데 box, top
+ * face 가 carrier 안착면). status 별 색 변화 (idle/processing/busy) 로 작업 진행
+ * 인지성.
+ */
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+const PAD_DEPTH = 2;
+const STATUS_TINT = {
+    idle: 0x4a7a9b, // 차분한 blue-grey
+    processing: 0xd9943a, // 작업 중 — 주황
+    busy: 0xc04040 // busy/blocked — 빨강
+};
+export class PickingStation3D extends RealObjectGroup {
+    _padMesh;
+    _padOutline;
+    _tableMesh;
+    build() {
+        super.build();
+        const state = this.component.state;
+        const w = state.width ?? 100;
+        const h = state.height ?? 100;
+        const depth = state.depth ?? 5;
+        // ── pad (영역) ─────────────────────────────────────────────
+        const padGeom = new THREE.BoxGeometry(w, PAD_DEPTH, h);
+        const padMat = new THREE.MeshStandardMaterial({
+            color: this._padColor(), roughness: 0.85, transparent: true, opacity: 0.5
+        });
+        this._padMesh = new THREE.Mesh(padGeom, padMat);
+        this._padMesh.position.y = PAD_DEPTH / 2;
+        this._padMesh.receiveShadow = true;
+        this.object3d.add(this._padMesh);
+        // pad outline
+        const outline = new THREE.LineBasicMaterial({ color: this._strokeColor() });
+        this._padOutline = new THREE.LineSegments(new THREE.EdgesGeometry(padGeom), outline);
+        this._padOutline.position.y = PAD_DEPTH / 2;
+        this.object3d.add(this._padOutline);
+        // ── 작업대 (table) — pad 위 가운데 box. top face = carrier 안착면. ──
+        const tableW = w * 0.55;
+        const tableH = h * 0.45;
+        const tableD = Math.max(8, depth); // 작업면 높이 — operation height 근사
+        const tableGeom = new THREE.BoxGeometry(tableW, tableD, tableH);
+        const tableMat = new THREE.MeshStandardMaterial({
+            color: this._statusColor(), roughness: 0.6, metalness: 0.1
+        });
+        this._tableMesh = new THREE.Mesh(tableGeom, tableMat);
+        this._tableMesh.position.y = PAD_DEPTH + tableD / 2;
+        this._tableMesh.castShadow = true;
+        this._tableMesh.receiveShadow = true;
+        this.object3d.add(this._tableMesh);
+    }
+    /** carrier 안착 anchor — 작업대 top face. */
+    getAttachFrame() {
+        return this._tableMesh ?? this._padMesh;
+    }
+    _padColor() {
+        const raw = this.component.state?.fillStyle;
+        if (typeof raw === 'string' && raw.length > 0) {
+            try {
+                return new THREE.Color(raw);
+            }
+            catch { /* fallthrough */ }
+        }
+        return new THREE.Color(0x5a8ab8);
+    }
+    _strokeColor() {
+        const raw = this.component.state?.strokeStyle;
+        if (typeof raw === 'string' && raw.length > 0) {
+            try {
+                return new THREE.Color(raw);
+            }
+            catch { /* fallthrough */ }
+        }
+        return this._padColor().clone().multiplyScalar(0.6);
+    }
+    /** status 에 따른 작업대 색 — idle/processing/busy. */
+    _statusColor() {
+        const s = this.component.state?.status;
+        return new THREE.Color(STATUS_TINT[s ?? 'idle'] ?? STATUS_TINT.idle);
+    }
+    _applyPadColor() {
+        if (this._padMesh) {
+            const m = this._padMesh.material;
+            m.color.copy(this._padColor());
+            m.needsUpdate = true;
+        }
+    }
+    _applyStrokeColor() {
+        if (this._padOutline) {
+            const m = this._padOutline.material;
+            m.color.copy(this._strokeColor());
+            m.needsUpdate = true;
+        }
+    }
+    _applyStatusColor() {
+        if (this._tableMesh) {
+            const m = this._tableMesh.material;
+            m.color.copy(this._statusColor());
+            m.needsUpdate = true;
+        }
+    }
+    updateAlpha() {
+        const alpha = typeof this.component.state.alpha === 'number'
+            ? this.component.state.alpha : 1;
+        if (this._padMesh) {
+            const m = this._padMesh.material;
+            m.opacity = 0.5 * alpha;
+            m.transparent = m.opacity < 1;
+            m.needsUpdate = true;
+        }
+    }
+    updateDimension() {
+        if (this._padMesh) {
+            const state = this.component.state;
+            const w = state.width ?? 100;
+            const h = state.height ?? 100;
+            const depth = state.depth ?? 5;
+            this._padMesh.geometry.dispose();
+            this._padMesh.geometry = new THREE.BoxGeometry(w, PAD_DEPTH, h);
+            if (this._padOutline) {
+                this._padOutline.geometry.dispose();
+                this._padOutline.geometry = new THREE.EdgesGeometry(this._padMesh.geometry);
+            }
+            if (this._tableMesh) {
+                const tableW = w * 0.55;
+                const tableH = h * 0.45;
+                const tableD = Math.max(8, depth);
+                this._tableMesh.geometry.dispose();
+                this._tableMesh.geometry = new THREE.BoxGeometry(tableW, tableD, tableH);
+                this._tableMesh.position.y = PAD_DEPTH + tableD / 2;
+            }
+        }
+    }
+    onchange(after, before) {
+        if ('width' in after || 'height' in after || 'depth' in after) {
+            this.updateDimension();
+            return;
+        }
+        if ('alpha' in after) {
+            this.updateAlpha();
+            return;
+        }
+        if ('fillStyle' in after) {
+            this._applyPadColor();
+            if (this.component.state.strokeStyle == null)
+                this._applyStrokeColor();
+            return;
+        }
+        if ('strokeStyle' in after) {
+            this._applyStrokeColor();
+            return;
+        }
+        if ('status' in after) {
+            this._applyStatusColor();
+            return;
+        }
+        super.onchange?.(after, before);
+    }
+}
+//# sourceMappingURL=picking-station-3d.js.map

package/dist/picking-station-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picking-station-3d.js","sourceRoot":"","sources":["../src/picking-station-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * PickingStation3D — 사람 작업 위치의 3D 시각화. pad(영역) + 작업대(가운데 box, top\n * face 가 carrier 안착면). status 별 색 변화 (idle/processing/busy) 로 작업 진행\n * 인지성.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nimport type PickingStation from './picking-station.js'\nimport type { PickingStationStatus } from './picking-station.js'\n\nconst PAD_DEPTH = 2\n\nconst STATUS_TINT: Record<PickingStationStatus, number> = {\n  idle: 0x4a7a9b,        // 차분한 blue-grey\n  processing: 0xd9943a,  // 작업 중 — 주황\n  busy: 0xc04040          // busy/blocked — 빨강\n}\n\nexport class PickingStation3D extends RealObjectGroup {\n  private _padMesh?: THREE.Mesh\n  private _padOutline?: THREE.LineSegments\n  private _tableMesh?: THREE.Mesh\n\n  build() {\n    super.build()\n    const state = this.component.state as any\n    const w = state.width ?? 100\n    const h = state.height ?? 100\n    const depth = state.depth ?? 5\n\n    // ── pad (영역) ─────────────────────────────────────────────\n    const padGeom = new THREE.BoxGeometry(w, PAD_DEPTH, h)\n    const padMat = new THREE.MeshStandardMaterial({\n      color: this._padColor(), roughness: 0.85, transparent: true, opacity: 0.5\n    })\n    this._padMesh = new THREE.Mesh(padGeom, padMat)\n    this._padMesh.position.y = PAD_DEPTH / 2\n    this._padMesh.receiveShadow = true\n    this.object3d.add(this._padMesh)\n\n    // pad outline\n    const outline = new THREE.LineBasicMaterial({ color: this._strokeColor() })\n    this._padOutline = new THREE.LineSegments(new THREE.EdgesGeometry(padGeom), outline)\n    this._padOutline.position.y = PAD_DEPTH / 2\n    this.object3d.add(this._padOutline)\n\n    // ── 작업대 (table) — pad 위 가운데 box. top face = carrier 안착면. ──\n    const tableW = w * 0.55\n    const tableH = h * 0.45\n    const tableD = Math.max(8, depth)   // 작업면 높이 — operation height 근사\n    const tableGeom = new THREE.BoxGeometry(tableW, tableD, tableH)\n    const tableMat = new THREE.MeshStandardMaterial({\n      color: this._statusColor(), roughness: 0.6, metalness: 0.1\n    })\n    this._tableMesh = new THREE.Mesh(tableGeom, tableMat)\n    this._tableMesh.position.y = PAD_DEPTH + tableD / 2\n    this._tableMesh.castShadow = true\n    this._tableMesh.receiveShadow = true\n    this.object3d.add(this._tableMesh)\n  }\n\n  /** carrier 안착 anchor — 작업대 top face. */\n  getAttachFrame(): THREE.Object3D | undefined {\n    return this._tableMesh ?? this._padMesh\n  }\n\n  private _padColor(): THREE.Color {\n    const raw = (this.component.state as any)?.fillStyle\n    if (typeof raw === 'string' && raw.length > 0) {\n      try { return new THREE.Color(raw) } catch { /* fallthrough */ }\n    }\n    return new THREE.Color(0x5a8ab8)\n  }\n\n  private _strokeColor(): THREE.Color {\n    const raw = (this.component.state as any)?.strokeStyle\n    if (typeof raw === 'string' && raw.length > 0) {\n      try { return new THREE.Color(raw) } catch { /* fallthrough */ }\n    }\n    return this._padColor().clone().multiplyScalar(0.6)\n  }\n\n  /** status 에 따른 작업대 색 — idle/processing/busy. */\n  private _statusColor(): THREE.Color {\n    const s = (this.component.state as any)?.status as PickingStationStatus | undefined\n    return new THREE.Color(STATUS_TINT[s ?? 'idle'] ?? STATUS_TINT.idle)\n  }\n\n  private _applyPadColor(): void {\n    if (this._padMesh) {\n      const m = this._padMesh.material as THREE.MeshStandardMaterial\n      m.color.copy(this._padColor())\n      m.needsUpdate = true\n    }\n  }\n  private _applyStrokeColor(): void {\n    if (this._padOutline) {\n      const m = this._padOutline.material as THREE.LineBasicMaterial\n      m.color.copy(this._strokeColor())\n      m.needsUpdate = true\n    }\n  }\n  private _applyStatusColor(): void {\n    if (this._tableMesh) {\n      const m = this._tableMesh.material as THREE.MeshStandardMaterial\n      m.color.copy(this._statusColor())\n      m.needsUpdate = true\n    }\n  }\n\n  updateAlpha(): void {\n    const alpha = typeof (this.component.state as any).alpha === 'number'\n      ? (this.component.state as any).alpha : 1\n    if (this._padMesh) {\n      const m = this._padMesh.material as THREE.MeshStandardMaterial\n      m.opacity = 0.5 * alpha\n      m.transparent = m.opacity < 1\n      m.needsUpdate = true\n    }\n  }\n\n  updateDimension(): void {\n    if (this._padMesh) {\n      const state = this.component.state as any\n      const w = state.width ?? 100\n      const h = state.height ?? 100\n      const depth = state.depth ?? 5\n      this._padMesh.geometry.dispose()\n      this._padMesh.geometry = new THREE.BoxGeometry(w, PAD_DEPTH, h)\n      if (this._padOutline) {\n        this._padOutline.geometry.dispose()\n        this._padOutline.geometry = new THREE.EdgesGeometry(this._padMesh.geometry)\n      }\n      if (this._tableMesh) {\n        const tableW = w * 0.55\n        const tableH = h * 0.45\n        const tableD = Math.max(8, depth)\n        this._tableMesh.geometry.dispose()\n        this._tableMesh.geometry = new THREE.BoxGeometry(tableW, tableD, tableH)\n        this._tableMesh.position.y = PAD_DEPTH + tableD / 2\n      }\n    }\n  }\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>): void {\n    if ('width' in after || 'height' in after || 'depth' in after) {\n      this.updateDimension()\n      return\n    }\n    if ('alpha' in after) { this.updateAlpha(); return }\n    if ('fillStyle' in after) {\n      this._applyPadColor()\n      if ((this.component.state as any).strokeStyle == null) this._applyStrokeColor()\n      return\n    }\n    if ('strokeStyle' in after) { this._applyStrokeColor(); return }\n    if ('status' in after) { this._applyStatusColor(); return }\n    super.onchange?.(after, before)\n  }\n}\n"]}

package/dist/picking-station.d.ts

@@ -0,0 +1,56 @@
+import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
+import { SlotTarget, type AttachFrame, type Alignment, type Heights, type PlacementArchetype } from '@operato/scene-base';
+import { PickingStation3D } from './picking-station-3d.js';
+export type PickingStationStatus = 'idle' | 'processing' | 'busy';
+export interface PickingStationState extends State {
+    /** carrier 가 머무는 처리 시간 (ms). 0/미설정이면 즉시 idle 유지. */
+    processingTimeMs?: number;
+    /** 현재 상태 (자동). */
+    status?: PickingStationStatus;
+    /** click 시 invoke 할 Popup 컴포넌트 id. */
+    popupRef?: string;
+    material3d?: Material3D;
+}
+declare const PickingStation_base: any;
+export default class PickingStation extends PickingStation_base {
+    state: PickingStationState;
+    _realObject?: PickingStation3D;
+    static placement: PlacementArchetype;
+    static align: Alignment;
+    static defaultDepth: (h: Heights) => number;
+    get nature(): ComponentNature;
+    get anchors(): never[];
+    slotIds(): ReadonlyArray<string>;
+    hasCarrierAt(slotId: string): boolean;
+    canReceiveAt(slotId: string, _carrier?: Component): boolean;
+    occupiedSlotIds(): ReadonlyArray<string>;
+    emptySlotIds(): ReadonlyArray<string>;
+    obtainCarrier(slotId: string): Component | null;
+    /**
+     * carrier 도착 — components + 3D 로 reparent (Spot 패턴). processingTimeMs > 0
+     * 이면 status='processing' 으로 전환했다가 timer 후 'idle' 로 복귀.
+     *
+     * 단순 setTimeout — frameClock 통합(view-mode/일시정지 동기) 은 추후.
+     */
+    receiveAt(_slotId: string, carrier: Component, options?: any): Promise<void>;
+    accept(carrier: Component, options?: any): Promise<void>;
+    receive(carrier: Component, options?: any): Promise<void>;
+    slotTargetAt(slotId: string): SlotTarget;
+    getSlotAttachObject3d(_slotId: string): any;
+    /** carrier 를 작업대(table) 상단에 안착. */
+    attachPointFor(carrier: Component): AttachFrame | null;
+    render(ctx: CanvasRenderingContext2D): void;
+    get eventMap(): {
+        '(self)': {
+            '(self)': {
+                click: (mouseEvent: MouseEvent) => void;
+            };
+        };
+    };
+    private _onStationClick;
+    private _invokePopup;
+    private _raycastStationHit;
+    buildRealObject(): RealObject | undefined;
+}
+export {};

package/dist/picking-station.js

@@ -0,0 +1,212 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * PickingStation — 사람(또는 자동화) 작업 위치. carrier 가 도착하면 *_processingTimeMs_*
+ * 동안 머문 뒤 status='idle' 로 자동 전환되어 다음 mover 가 가져갈 수 있다.
+ *
+ * 단일 slot SlottedHolder (Spot 비슷) + 처리 시간/상태 + popupRef + click raycast.
+ * 3D 는 pad(영역) + 작업대(가운데 box) — picking/QC 작업 자리의 인지성을 위해.
+ */
+import { __decorate } from "tslib";
+import * as THREE from 'three';
+import { ContainerAbstract, sceneComponent } from '@hatiolab/things-scene';
+import { CarrierHolder, Placeable, SlotTarget } from '@operato/scene-base';
+import { PickingStation3D } from './picking-station-3d.js';
+const SLOT_ID = 'station';
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: true,
+    properties: [
+        { type: 'number', label: 'processing-time-ms', name: 'processingTimeMs' },
+        { type: 'select', label: 'status', name: 'status',
+            property: { options: ['idle', 'processing', 'busy'] } },
+        { type: 'id-input', label: 'popup-ref', name: 'popupRef',
+            property: { component: 'popup' } }
+    ],
+    help: 'scene/component/picking-station'
+};
+let PickingStation = class PickingStation extends CarrierHolder(Placeable(ContainerAbstract)) {
+    static placement = 'floor';
+    static align = 'bottom';
+    static defaultDepth = (h) => h.operation - h.floor;
+    get nature() { return NATURE; }
+    get anchors() { return []; }
+    // ── SlottedHolder duck-type (단일 slot 'station') ─────────────
+    slotIds() { return [SLOT_ID]; }
+    hasCarrierAt(slotId) {
+        return slotId === SLOT_ID &&
+            (this.components ?? []).some((c) => c?.isCarriable);
+    }
+    canReceiveAt(slotId, _carrier) {
+        return slotId === SLOT_ID && !this.hasCarrierAt(slotId);
+    }
+    occupiedSlotIds() {
+        return this.hasCarrierAt(SLOT_ID) ? [SLOT_ID] : [];
+    }
+    emptySlotIds() {
+        return this.hasCarrierAt(SLOT_ID) ? [] : [SLOT_ID];
+    }
+    obtainCarrier(slotId) {
+        if (slotId !== SLOT_ID)
+            return null;
+        return (this.components ?? []).find((c) => c?.isCarriable) ?? null;
+    }
+    /**
+     * carrier 도착 — components + 3D 로 reparent (Spot 패턴). processingTimeMs > 0
+     * 이면 status='processing' 으로 전환했다가 timer 후 'idle' 로 복귀.
+     *
+     * 단순 setTimeout — frameClock 통합(view-mode/일시정지 동기) 은 추후.
+     */
+    async receiveAt(_slotId, carrier, options) {
+        ;
+        this.reparent?.(carrier, { ...(options ?? {}), animated: false });
+        const procMs = this.state.processingTimeMs ?? 0;
+        if (procMs > 0) {
+            this.setState({ status: 'processing' });
+            setTimeout(() => {
+                if (this.state.status === 'processing') {
+                    this.setState({ status: 'idle' });
+                }
+            }, procMs);
+        }
+    }
+    async accept(carrier, options) {
+        return this.receiveAt(SLOT_ID, carrier, options);
+    }
+    async receive(carrier, options) {
+        return this.receiveAt(SLOT_ID, carrier, options);
+    }
+    slotTargetAt(slotId) { return new SlotTarget(this, slotId); }
+    getSlotAttachObject3d(_slotId) {
+        return this._realObject?.getAttachFrame?.();
+    }
+    /** carrier 를 작업대(table) 상단에 안착. */
+    attachPointFor(carrier) {
+        const ro = this._realObject;
+        const frame = ro?.getAttachFrame?.();
+        if (!frame)
+            return null;
+        const carrierDepth = resolveDepth(carrier);
+        return { attach: frame, localPosition: { x: 0, y: carrierDepth / 2, z: 0 } };
+    }
+    // ── 2D render ───────────────────────────────────────────────
+    render(ctx) {
+        const { left = 0, top = 0, width = 100, height = 100 } = this.state;
+        const fillStyle = this.state.fillStyle || '#5a8ab8';
+        const strokeStyle = this.state.strokeStyle || '#3d6a8f';
+        const status = (this.state.status ?? 'idle');
+        // pad
+        ctx.save();
+        ctx.fillStyle = fillStyle;
+        ctx.globalAlpha = 0.15;
+        ctx.fillRect(left, top, width, height);
+        ctx.restore();
+        // outline
+        ctx.save();
+        ctx.strokeStyle = strokeStyle;
+        ctx.lineWidth = 1.5;
+        ctx.strokeRect(left + 0.75, top + 0.75, width - 1.5, height - 1.5);
+        ctx.restore();
+        // 작업대 (가운데 작은 사각)
+        const tw = width * 0.55, th = height * 0.45;
+        const tx = left + (width - tw) / 2;
+        const ty = top + (height - th) / 2;
+        ctx.save();
+        ctx.fillStyle = strokeStyle;
+        ctx.globalAlpha = 0.35;
+        ctx.fillRect(tx, ty, tw, th);
+        ctx.restore();
+        // 상태
+        ctx.save();
+        const fontSize = Math.min(width, height) * 0.16;
+        ctx.fillStyle = '#222';
+        ctx.font = `bold ${fontSize}px sans-serif`;
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.fillText(status.toUpperCase(), left + width / 2, top + height / 2);
+        ctx.restore();
+    }
+    // ── Popup + click ────────────────────────────────────────────
+    get eventMap() {
+        return { '(self)': { '(self)': { click: this._onStationClick } } };
+    }
+    _onStationClick = (mouseEvent) => {
+        if (!this.app?.isViewMode)
+            return;
+        const hit = this._raycastStationHit(mouseEvent);
+        if (!hit)
+            return;
+        this._invokePopup();
+    };
+    _invokePopup() {
+        const popupRefId = this.state.popupRef;
+        if (!popupRefId)
+            return;
+        const popupComp = this.root?.findById?.(popupRefId);
+        if (!popupComp || typeof popupComp.openPopup !== 'function')
+            return;
+        const anchor = this.slotTargetAt(SLOT_ID);
+        const carrier = this.obtainCarrier(SLOT_ID);
+        popupComp.openPopup({
+            componentId: this.state.id,
+            status: this.state.status ?? 'idle',
+            processingTimeMs: this.state.processingTimeMs,
+            currentCarrierId: carrier?.state?.id ?? null
+        }, { anchor });
+    }
+    _raycastStationHit(mouseEvent) {
+        const ro = this._realObject;
+        if (!ro?.object3d)
+            return undefined;
+        const tc = ro.threeContainer;
+        if (!tc)
+            return undefined;
+        const cap = tc._threeCapability ?? tc._capability;
+        let intersects;
+        if (cap?.getObjectsByRaycast)
+            intersects = cap.getObjectsByRaycast();
+        if (!intersects || intersects.length === 0) {
+            const scene = tc.scene3d;
+            const renderer = tc.renderer3d;
+            const camera = tc.activeCamera3d ??
+                cap?.activeCamera ??
+                cap?.camera;
+            const canvas = renderer?.domElement;
+            if (!scene || !canvas || !camera)
+                return undefined;
+            const rect = canvas.getBoundingClientRect();
+            if (rect.width === 0 || rect.height === 0)
+                return undefined;
+            const ndc = new THREE.Vector2(((mouseEvent.clientX - rect.left) / rect.width) * 2 - 1, -((mouseEvent.clientY - rect.top) / rect.height) * 2 + 1);
+            const raycaster = new THREE.Raycaster();
+            raycaster.setFromCamera(ndc, camera);
+            intersects = raycaster.intersectObjects(scene.children, true);
+        }
+        if (!intersects || intersects.length === 0)
+            return undefined;
+        const closest = intersects[0];
+        let obj = closest.object;
+        while (obj) {
+            if (obj.userData?.context === ro)
+                return closest;
+            obj = obj.parent;
+        }
+        return undefined;
+    }
+    buildRealObject() {
+        return new PickingStation3D(this);
+    }
+};
+PickingStation = __decorate([
+    sceneComponent('picking-station')
+], PickingStation);
+export default PickingStation;
+function resolveDepth(c) {
+    const eff = c._realObject?.effectiveDepth;
+    if (typeof eff === 'number' && Number.isFinite(eff))
+        return eff;
+    const d = c?.state?.depth;
+    return typeof d === 'number' && Number.isFinite(d) ? d : 0;
+}
+//# sourceMappingURL=picking-station.js.map

package/dist/picking-station.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picking-station.js","sourceRoot":"","sources":["../src/picking-station.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * PickingStation — 사람(또는 자동화) 작업 위치. carrier 가 도착하면 *_processingTimeMs_*\n * 동안 머문 뒤 status='idle' 로 자동 전환되어 다음 mover 가 가져갈 수 있다.\n *\n * 단일 slot SlottedHolder (Spot 비슷) + 처리 시간/상태 + popupRef + click raycast.\n * 3D 는 pad(영역) + 작업대(가운데 box) — picking/QC 작업 자리의 인지성을 위해.\n */\n\nimport * as THREE from 'three'\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Placeable,\n  SlotTarget,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { PickingStation3D } from './picking-station-3d.js'\n\nexport type PickingStationStatus = 'idle' | 'processing' | 'busy'\n\nexport interface PickingStationState extends State {\n  /** carrier 가 머무는 처리 시간 (ms). 0/미설정이면 즉시 idle 유지. */\n  processingTimeMs?: number\n  /** 현재 상태 (자동). */\n  status?: PickingStationStatus\n  /** click 시 invoke 할 Popup 컴포넌트 id. */\n  popupRef?: string\n  material3d?: Material3D\n}\n\nconst SLOT_ID = 'station'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    { type: 'number', label: 'processing-time-ms', name: 'processingTimeMs' },\n    { type: 'select', label: 'status', name: 'status',\n      property: { options: ['idle', 'processing', 'busy'] } },\n    { type: 'id-input', label: 'popup-ref', name: 'popupRef',\n      property: { component: 'popup' } }\n  ],\n  help: 'scene/component/picking-station'\n}\n\n@sceneComponent('picking-station')\nexport default class PickingStation extends CarrierHolder(Placeable(ContainerAbstract)) {\n  declare state: PickingStationState\n  declare _realObject?: PickingStation3D\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.operation - h.floor\n\n  get nature(): ComponentNature { return NATURE }\n  get anchors() { return [] }\n\n  // ── SlottedHolder duck-type (단일 slot 'station') ─────────────\n  slotIds(): ReadonlyArray<string> { return [SLOT_ID] }\n\n  hasCarrierAt(slotId: string): boolean {\n    return slotId === SLOT_ID &&\n      ((this as any).components ?? []).some((c: any) => c?.isCarriable)\n  }\n  canReceiveAt(slotId: string, _carrier?: Component): boolean {\n    return slotId === SLOT_ID && !this.hasCarrierAt(slotId)\n  }\n  occupiedSlotIds(): ReadonlyArray<string> {\n    return this.hasCarrierAt(SLOT_ID) ? [SLOT_ID] : []\n  }\n  emptySlotIds(): ReadonlyArray<string> {\n    return this.hasCarrierAt(SLOT_ID) ? [] : [SLOT_ID]\n  }\n  obtainCarrier(slotId: string): Component | null {\n    if (slotId !== SLOT_ID) return null\n    return ((this as any).components ?? []).find((c: any) => c?.isCarriable) ?? null\n  }\n\n  /**\n   * carrier 도착 — components + 3D 로 reparent (Spot 패턴). processingTimeMs > 0\n   * 이면 status='processing' 으로 전환했다가 timer 후 'idle' 로 복귀.\n   *\n   * 단순 setTimeout — frameClock 통합(view-mode/일시정지 동기) 은 추후.\n   */\n  async receiveAt(_slotId: string, carrier: Component, options?: any): Promise<void> {\n    ;(this as any).reparent?.(carrier, { ...(options ?? {}), animated: false })\n    const procMs = this.state.processingTimeMs ?? 0\n    if (procMs > 0) {\n      this.setState({ status: 'processing' as PickingStationStatus })\n      setTimeout(() => {\n        if ((this.state.status as PickingStationStatus) === 'processing') {\n          this.setState({ status: 'idle' as PickingStationStatus })\n        }\n      }, procMs)\n    }\n  }\n\n  async accept(carrier: Component, options?: any): Promise<void> {\n    return this.receiveAt(SLOT_ID, carrier, options)\n  }\n  async receive(carrier: Component, options?: any): Promise<void> {\n    return this.receiveAt(SLOT_ID, carrier, options)\n  }\n\n  slotTargetAt(slotId: string): SlotTarget { return new SlotTarget(this as any, slotId) }\n  getSlotAttachObject3d(_slotId: string): any {\n    return (this as any)._realObject?.getAttachFrame?.()\n  }\n\n  /** carrier 를 작업대(table) 상단에 안착. */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = this._realObject\n    const frame = ro?.getAttachFrame?.()\n    if (!frame) return null\n    const carrierDepth = resolveDepth(carrier)\n    return { attach: frame, localPosition: { x: 0, y: carrierDepth / 2, z: 0 } }\n  }\n\n  // ── 2D render ───────────────────────────────────────────────\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const fillStyle = (this.state.fillStyle as string) || '#5a8ab8'\n    const strokeStyle = (this.state.strokeStyle as string) || '#3d6a8f'\n    const status = (this.state.status ?? 'idle') as PickingStationStatus\n\n    // pad\n    ctx.save()\n    ctx.fillStyle = fillStyle\n    ctx.globalAlpha = 0.15\n    ctx.fillRect(left, top, width, height)\n    ctx.restore()\n\n    // outline\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = 1.5\n    ctx.strokeRect(left + 0.75, top + 0.75, width - 1.5, height - 1.5)\n    ctx.restore()\n\n    // 작업대 (가운데 작은 사각)\n    const tw = width * 0.55, th = height * 0.45\n    const tx = left + (width - tw) / 2\n    const ty = top + (height - th) / 2\n    ctx.save()\n    ctx.fillStyle = strokeStyle\n    ctx.globalAlpha = 0.35\n    ctx.fillRect(tx, ty, tw, th)\n    ctx.restore()\n\n    // 상태\n    ctx.save()\n    const fontSize = Math.min(width, height) * 0.16\n    ctx.fillStyle = '#222'\n    ctx.font = `bold ${fontSize}px sans-serif`\n    ctx.textAlign = 'center'\n    ctx.textBaseline = 'middle'\n    ctx.fillText(status.toUpperCase(), left + width / 2, top + height / 2)\n    ctx.restore()\n  }\n\n  // ── Popup + click ────────────────────────────────────────────\n  get eventMap() {\n    return { '(self)': { '(self)': { click: this._onStationClick } } }\n  }\n\n  private _onStationClick = (mouseEvent: MouseEvent) => {\n    if (!(this as any).app?.isViewMode) return\n    const hit = this._raycastStationHit(mouseEvent)\n    if (!hit) return\n    this._invokePopup()\n  }\n\n  private _invokePopup(): void {\n    const popupRefId = this.state.popupRef\n    if (!popupRefId) return\n    const popupComp: any = (this as any).root?.findById?.(popupRefId)\n    if (!popupComp || typeof popupComp.openPopup !== 'function') return\n    const anchor = this.slotTargetAt(SLOT_ID)\n    const carrier = this.obtainCarrier(SLOT_ID)\n    popupComp.openPopup({\n      componentId: (this.state as any).id,\n      status: this.state.status ?? 'idle',\n      processingTimeMs: this.state.processingTimeMs,\n      currentCarrierId: (carrier as any)?.state?.id ?? null\n    }, { anchor })\n  }\n\n  private _raycastStationHit(mouseEvent: MouseEvent): THREE.Intersection | undefined {\n    const ro: any = (this as any)._realObject\n    if (!ro?.object3d) return undefined\n    const tc: any = ro.threeContainer\n    if (!tc) return undefined\n    const cap: any = tc._threeCapability ?? tc._capability\n    let intersects: THREE.Intersection[] | undefined\n    if (cap?.getObjectsByRaycast) intersects = cap.getObjectsByRaycast() as THREE.Intersection[] | undefined\n    if (!intersects || intersects.length === 0) {\n      const scene = tc.scene3d as THREE.Scene | undefined\n      const renderer = tc.renderer3d as THREE.WebGLRenderer | undefined\n      const camera =\n        (tc.activeCamera3d as THREE.Camera | undefined) ??\n        (cap?.activeCamera as THREE.Camera | undefined) ??\n        (cap?.camera as THREE.Camera | undefined)\n      const canvas = renderer?.domElement\n      if (!scene || !canvas || !camera) return undefined\n      const rect = canvas.getBoundingClientRect()\n      if (rect.width === 0 || rect.height === 0) return undefined\n      const ndc = new THREE.Vector2(\n        ((mouseEvent.clientX - rect.left) / rect.width) * 2 - 1,\n        -((mouseEvent.clientY - rect.top) / rect.height) * 2 + 1\n      )\n      const raycaster = new THREE.Raycaster()\n      raycaster.setFromCamera(ndc, camera)\n      intersects = raycaster.intersectObjects(scene.children, true)\n    }\n    if (!intersects || intersects.length === 0) return undefined\n    const closest = intersects[0]\n    let obj: THREE.Object3D | null = closest.object\n    while (obj) {\n      if (obj.userData?.context === ro) return closest\n      obj = obj.parent\n    }\n    return undefined\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new PickingStation3D(this)\n  }\n}\n\nfunction resolveDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  const d = (c as any)?.state?.depth\n  return typeof d === 'number' && Number.isFinite(d) ? d : 0\n}\n"]}

package/dist/rack-capability.d.ts

@@ -0,0 +1,11 @@
+/**
+ * rack 이 *_이 mover 의 toolType_* 을 선반 적재용으로 수용하는가.
+ *
+ * rack 선반 적재는 높이 도달 mover (crane / stacker / forklift) 의 몫. 평탄 데크
+ * 차량(agv-deck)은 바닥 운반 전용 — 선반 직접 적재 불가 → 거부. 거부된 mover 는
+ * transfer planner 가 자동으로 in-port 경유(환승)를 택하게 만든다.
+ *
+ * @param moverToolType  적재하려는 mover 의 toolType (undefined 면 능력 미상 → 허용)
+ * @param blockedTools   거부 toolType 목록 (default ['agv-deck'])
+ */
+export declare function rackAcceptsMoverTool(moverToolType: string | undefined | null, blockedTools?: readonly string[]): boolean;

package/dist/rack-capability.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Rack 적재 mover 능력 판정 — *_순수 로직_* (things-scene 무관). storage-rack 의
+ * canAcceptFromMover 가 위임. mocha 환경에서 StorageRack 직접 import 불가하므로
+ * 판정 로직만 분리해 단위 검증.
+ */
+/**
+ * rack 이 *_이 mover 의 toolType_* 을 선반 적재용으로 수용하는가.
+ *
+ * rack 선반 적재는 높이 도달 mover (crane / stacker / forklift) 의 몫. 평탄 데크
+ * 차량(agv-deck)은 바닥 운반 전용 — 선반 직접 적재 불가 → 거부. 거부된 mover 는
+ * transfer planner 가 자동으로 in-port 경유(환승)를 택하게 만든다.
+ *
+ * @param moverToolType  적재하려는 mover 의 toolType (undefined 면 능력 미상 → 허용)
+ * @param blockedTools   거부 toolType 목록 (default ['agv-deck'])
+ */
+export function rackAcceptsMoverTool(moverToolType, blockedTools = ['agv-deck']) {
+    if (moverToolType == null)
+        return true;
+    if (!Array.isArray(blockedTools))
+        return true;
+    return !blockedTools.includes(moverToolType);
+}
+//# sourceMappingURL=rack-capability.js.map

package/dist/rack-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rack-capability.js","sourceRoot":"","sources":["../src/rack-capability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAwC,EACxC,eAAkC,CAAC,UAAU,CAAC;IAE9C,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7C,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;AAC9C,CAAC","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Rack 적재 mover 능력 판정 — *_순수 로직_* (things-scene 무관). storage-rack 의\n * canAcceptFromMover 가 위임. mocha 환경에서 StorageRack 직접 import 불가하므로\n * 판정 로직만 분리해 단위 검증.\n */\n\n/**\n * rack 이 *_이 mover 의 toolType_* 을 선반 적재용으로 수용하는가.\n *\n * rack 선반 적재는 높이 도달 mover (crane / stacker / forklift) 의 몫. 평탄 데크\n * 차량(agv-deck)은 바닥 운반 전용 — 선반 직접 적재 불가 → 거부. 거부된 mover 는\n * transfer planner 가 자동으로 in-port 경유(환승)를 택하게 만든다.\n *\n * @param moverToolType  적재하려는 mover 의 toolType (undefined 면 능력 미상 → 허용)\n * @param blockedTools   거부 toolType 목록 (default ['agv-deck'])\n */\nexport function rackAcceptsMoverTool(\n  moverToolType: string | undefined | null,\n  blockedTools: readonly string[] = ['agv-deck']\n): boolean {\n  if (moverToolType == null) return true\n  if (!Array.isArray(blockedTools)) return true\n  return !blockedTools.includes(moverToolType)\n}\n"]}