@operato/scene-storage 10.0.0-beta.48 → 10.0.0-beta.53

package/dist/stockpile-grid-3d.js

@@ -0,0 +1,301 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * StockpileGrid3D — cell × cell 의 평치 영역 3D 시각화. cell 마다 pad + records 기반
+ * 자동 적치 carrier mesh. Stockpile3D 와 같은 idiom 의 cell 별 적용.
+ *
+ * cell pad mesh 에 userData.slotId 를 심어 click raycast 가 cell 을 식별, popup
+ * tether anchor 로 동작 (storage-rack 패턴).
+ */
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+const PAD_DEPTH = 2;
+const PRESET_COLOR = {
+    box: 0xb87333,
+    pallet: 0x8b6f47,
+    drum: 0x556679,
+    sack: 0xd4c89a,
+    crate: 0x9a7548,
+    bale: 0xa89968
+};
+const PRESET_DEFAULT_SIZE = {
+    box: { w: 26, h: 26, d: 20 },
+    pallet: { w: 40, h: 30, d: 15 },
+    drum: { w: 24, h: 24, d: 30 },
+    sack: { w: 30, h: 28, d: 18 },
+    crate: { w: 30, h: 30, d: 22 },
+    bale: { w: 32, h: 30, d: 18 }
+};
+export class StockpileGrid3D extends RealObjectGroup {
+    /** cellSlotId → pad mesh (popup tether anchor 용). */
+    _padByCellId = new Map();
+    /** cellSlotId → carriers group. */
+    _carriersByCellId = new Map();
+    /** material 캐시 (color → material) — 같은 색 carrier 공유. */
+    _materialByColor = new Map();
+    /** grid 전체를 감싸는 outer group (보드 보정 등). */
+    _gridGroup;
+    build() {
+        super.build();
+        this._buildGrid();
+    }
+    update() {
+        super.update();
+        this._rebuildAll();
+    }
+    /** carrier attach anchor — slotId 가 cellId 면 그 cell pad 반환, 아니면 grid group. */
+    getAttachFrame(slotId) {
+        if (slotId) {
+            const pad = this._padByCellId.get(slotId);
+            if (pad)
+                return pad;
+        }
+        return this._gridGroup;
+    }
+    /** slotTargetAt(cellId).attachObject3d = cell pad — Stockpile.getSlotAttachObject3d 가 호출. */
+    getCellPadMesh(slotId) {
+        return this._padByCellId.get(slotId);
+    }
+    _disposeAll() {
+        if (this._gridGroup) {
+            this._disposeGroupChildren(this._gridGroup);
+            this.object3d.remove(this._gridGroup);
+            this._gridGroup = undefined;
+        }
+        this._padByCellId.clear();
+        this._carriersByCellId.clear();
+        for (const m of this._materialByColor.values())
+            m.dispose();
+        this._materialByColor.clear();
+    }
+    _disposeGroupChildren(group) {
+        while (group.children.length > 0) {
+            const child = group.children[0];
+            this._disposeGroupChildren(child);
+            group.remove(child);
+            if (child.geometry?.dispose)
+                child.geometry.dispose();
+        }
+    }
+    _rebuildAll() {
+        this._disposeAll();
+        this._buildGrid();
+    }
+    _buildGrid() {
+        const grid = this.component;
+        const cols = grid.cols;
+        const rows = grid.rows;
+        const cellW = grid.cellW;
+        const cellH = grid.cellH;
+        const state = grid.state;
+        const outline = new THREE.Color(state.strokeStyle || '#7a5a2e');
+        const fillColor = new THREE.Color(state.fillStyle || '#c89c5c');
+        this._gridGroup = new THREE.Group();
+        // grid pad 원점은 컴포넌트 중심 (left+totalW/2). state.left/top 기준 origin 0
+        // 인 사각형 좌상단 — grid local 좌표에서 cell 의 인덱스 (col, row) → cell center
+        // = (col+0.5)*cellW - totalW/2, (row+0.5)*cellH - totalH/2 (3D world 의 컴포넌트
+        // 중심 기준 local).
+        const totalW = cellW * cols;
+        const totalH = cellH * rows;
+        this.object3d.add(this._gridGroup);
+        for (let r = 0; r < rows; r++) {
+            for (let c = 0; c < cols; c++) {
+                const cellId = grid.cellIdOf(c, r);
+                const cellFill = fillColor; // cell 별 색 override 없음 — 모두 grid 공통
+                // ── cell pad ─────────────────────────────────────────
+                const padGeom = new THREE.BoxGeometry(cellW * 0.96, PAD_DEPTH, cellH * 0.96);
+                const padMat = new THREE.MeshStandardMaterial({
+                    color: cellFill, roughness: 0.85, transparent: true, opacity: 0.55
+                });
+                const pad = new THREE.Mesh(padGeom, padMat);
+                const cx = (c + 0.5) * cellW - totalW / 2;
+                const cz = (r + 0.5) * cellH - totalH / 2;
+                pad.position.set(cx, PAD_DEPTH / 2, cz);
+                pad.receiveShadow = true;
+                pad.userData.slotId = cellId;
+                this._gridGroup.add(pad);
+                this._padByCellId.set(cellId, pad);
+                // cell outline — 페인트 라인
+                const padEdges = new THREE.EdgesGeometry(padGeom);
+                const padLine = new THREE.LineSegments(padEdges, new THREE.LineBasicMaterial({ color: outline }));
+                padLine.position.copy(pad.position);
+                this._gridGroup.add(padLine);
+                // ── cell carriers ────────────────────────────────────
+                const cg = new THREE.Group();
+                cg.position.set(cx, PAD_DEPTH, cz);
+                this._gridGroup.add(cg);
+                this._carriersByCellId.set(cellId, cg);
+                this._populateCellCarriers(c, r, cg);
+            }
+        }
+    }
+    /** cell 의 records 를 stackPattern / carrierPreset 으로 배치. */
+    _populateCellCarriers(col, row, group) {
+        const grid = this.component;
+        const records = grid.recordsOf(col, row);
+        if (records.length === 0)
+            return;
+        const state = grid.state;
+        const preset = (state.carrierPreset ?? 'box');
+        const pattern = (state.stackPattern ?? 'row');
+        const def = PRESET_DEFAULT_SIZE[preset] ?? PRESET_DEFAULT_SIZE.box;
+        const cw = state.carrierWidth ?? def.w;
+        const ch = state.carrierHeight ?? def.h;
+        const cd = state.carrierDepth ?? def.d;
+        const gap = state.carrierGap ?? 10;
+        const heightLimit = state.stackHeightLimit;
+        const cellW = grid.cellW;
+        const cellH = grid.cellH;
+        const geom = this._carrierGeometry(preset, cw, ch, cd);
+        const positions = this._computeStackPositions(pattern, records.length, cellW, cellH, cw, ch, cd, gap, heightLimit);
+        const presetDefault = PRESET_COLOR[preset] ?? PRESET_COLOR.box;
+        for (let i = 0; i < positions.length; i++) {
+            const p = positions[i];
+            const record = records[i];
+            const legendColor = grid.resolveLegendColor?.(record);
+            let colorHex = presetDefault;
+            if (typeof legendColor === 'string' && legendColor.length > 0) {
+                try {
+                    colorHex = new THREE.Color(legendColor).getHex();
+                }
+                catch { /* ignore */ }
+            }
+            const mat = this._getMaterial(colorHex);
+            const mesh = new THREE.Mesh(geom, mat);
+            mesh.position.set(p.x, p.y, p.z);
+            mesh.castShadow = true;
+            mesh.receiveShadow = true;
+            mesh.userData.recordId = record.id;
+            mesh.userData.cellId = grid.cellIdOf(col, row);
+            group.add(mesh);
+        }
+    }
+    _computeStackPositions(pattern, count, areaW, areaH, cw, ch, cd, gap, heightLimit) {
+        const out = [];
+        if (pattern === 'column') {
+            const layers = heightLimit ?? count;
+            for (let i = 0; i < count; i++) {
+                const layer = Math.min(i, layers - 1);
+                out.push({ x: 0, y: layer * cd + cd / 2, z: 0 });
+            }
+            return out;
+        }
+        const stridX = cw + gap;
+        const stridZ = ch + gap;
+        const cols = Math.max(1, Math.floor((areaW + gap) / stridX));
+        const rows = Math.max(1, Math.floor((areaH + gap) / stridZ));
+        const cellsPerLayer = cols * rows;
+        if (pattern === 'pyramid') {
+            let remaining = count;
+            let layer = 0;
+            while (remaining > 0) {
+                const lcols = Math.max(1, cols - layer);
+                const lrows = Math.max(1, rows - layer);
+                const cellsThisLayer = lcols * lrows;
+                const take = Math.min(remaining, cellsThisLayer);
+                for (let i = 0; i < take; i++) {
+                    const c = i % lcols;
+                    const r = Math.floor(i / lcols);
+                    const offC = (cols - lcols) / 2;
+                    const offR = (rows - lrows) / 2;
+                    const x = -areaW / 2 + (c + offC + 0.5) * stridX;
+                    const z = -areaH / 2 + (r + offR + 0.5) * stridZ;
+                    out.push({ x, y: layer * cd + cd / 2, z });
+                }
+                remaining -= take;
+                layer++;
+                if (lcols === 1 && lrows === 1) {
+                    for (let i = 0; i < remaining; i++) {
+                        out.push({ x: 0, y: (layer + i) * cd + cd / 2, z: 0 });
+                    }
+                    break;
+                }
+                if (heightLimit && layer >= heightLimit)
+                    break;
+            }
+            return out;
+        }
+        if (pattern === 'pile') {
+            const rng = (i) => ((Math.sin(i * 12.9898) * 43758.5453) % 1 + 1) % 1;
+            for (let i = 0; i < count; i++) {
+                const layer = Math.floor(i / cellsPerLayer);
+                const idx = i % cellsPerLayer;
+                const c = idx % cols;
+                const r = Math.floor(idx / cols);
+                const jX = (rng(i * 2) - 0.5) * cw * 0.2;
+                const jZ = (rng(i * 2 + 1) - 0.5) * ch * 0.2;
+                const x = -areaW / 2 + (c + 0.5) * stridX + jX;
+                const z = -areaH / 2 + (r + 0.5) * stridZ + jZ;
+                out.push({ x, y: layer * cd + cd / 2, z });
+                if (heightLimit && layer >= heightLimit - 1 && idx === cellsPerLayer - 1)
+                    break;
+            }
+            return out;
+        }
+        // row / staggered
+        for (let i = 0; i < count; i++) {
+            const layer = Math.floor(i / cellsPerLayer);
+            if (heightLimit && layer >= heightLimit)
+                break;
+            const idx = i % cellsPerLayer;
+            const c = idx % cols;
+            const r = Math.floor(idx / cols);
+            let x = -areaW / 2 + (c + 0.5) * stridX;
+            const z = -areaH / 2 + (r + 0.5) * stridZ;
+            if (pattern === 'staggered' && layer % 2 === 1)
+                x += stridX / 2;
+            out.push({ x, y: layer * cd + cd / 2, z });
+        }
+        return out;
+    }
+    _carrierGeometry(preset, w, h, d) {
+        if (preset === 'drum') {
+            const radius = Math.min(w, h) / 2;
+            return new THREE.CylinderGeometry(radius, radius, d, 16);
+        }
+        if (preset === 'sack' || preset === 'bale') {
+            return new THREE.BoxGeometry(w * 0.92, d * 0.92, h * 0.92);
+        }
+        return new THREE.BoxGeometry(w, d, h);
+    }
+    _getMaterial(colorHex) {
+        let m = this._materialByColor.get(colorHex);
+        if (!m) {
+            m = new THREE.MeshStandardMaterial({ color: colorHex, roughness: 0.7 });
+            this._materialByColor.set(colorHex, m);
+        }
+        return m;
+    }
+    onchange(after, before) {
+        // 거의 모든 속성 변경이 grid 재구성 — 단순화.
+        const keys = [
+            'cols', 'rows', 'cellWidth', 'cellHeight',
+            'cells', 'data',
+            'stackPattern', 'carrierPreset',
+            'carrierWidth', 'carrierHeight', 'carrierDepth', 'carrierGap',
+            'capacity', 'stackHeightLimit', 'pickPolicy',
+            'fillStyle', 'strokeStyle',
+            'width', 'height'
+        ];
+        if (keys.some(k => k in after)) {
+            this._rebuildAll();
+            return;
+        }
+        super.onchange?.(after, before);
+    }
+    updateDimension() {
+        this._rebuildAll();
+    }
+    updateAlpha() {
+        const alpha = typeof this.component.state.alpha === 'number'
+            ? this.component.state.alpha : 1;
+        // pad 들의 opacity 만 (carriers 는 alpha 그대로)
+        for (const pad of this._padByCellId.values()) {
+            const m = pad.material;
+            m.opacity = 0.55 * alpha;
+            m.transparent = m.opacity < 1;
+            m.needsUpdate = true;
+        }
+    }
+}
+//# sourceMappingURL=stockpile-grid-3d.js.map

package/dist/stockpile-grid-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stockpile-grid-3d.js","sourceRoot":"","sources":["../src/stockpile-grid-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * StockpileGrid3D — cell × cell 의 평치 영역 3D 시각화. cell 마다 pad + records 기반\n * 자동 적치 carrier mesh. Stockpile3D 와 같은 idiom 의 cell 별 적용.\n *\n * cell pad mesh 에 userData.slotId 를 심어 click raycast 가 cell 을 식별, popup\n * tether anchor 로 동작 (storage-rack 패턴).\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nimport type StockpileGrid from './stockpile-grid.js'\nimport type { StackPattern, CarrierPreset } from './stockpile.js'\n\nconst PAD_DEPTH = 2\n\nconst PRESET_COLOR: Record<CarrierPreset, number> = {\n  box: 0xb87333,\n  pallet: 0x8b6f47,\n  drum: 0x556679,\n  sack: 0xd4c89a,\n  crate: 0x9a7548,\n  bale: 0xa89968\n}\n\nconst PRESET_DEFAULT_SIZE: Record<CarrierPreset, { w: number; h: number; d: number }> = {\n  box: { w: 26, h: 26, d: 20 },\n  pallet: { w: 40, h: 30, d: 15 },\n  drum: { w: 24, h: 24, d: 30 },\n  sack: { w: 30, h: 28, d: 18 },\n  crate: { w: 30, h: 30, d: 22 },\n  bale: { w: 32, h: 30, d: 18 }\n}\n\nexport class StockpileGrid3D extends RealObjectGroup {\n  /** cellSlotId → pad mesh (popup tether anchor 용). */\n  private _padByCellId: Map<string, THREE.Mesh> = new Map()\n  /** cellSlotId → carriers group. */\n  private _carriersByCellId: Map<string, THREE.Group> = new Map()\n  /** material 캐시 (color → material) — 같은 색 carrier 공유. */\n  private _materialByColor: Map<number, THREE.MeshStandardMaterial> = new Map()\n  /** grid 전체를 감싸는 outer group (보드 보정 등). */\n  private _gridGroup?: THREE.Group\n\n  build() {\n    super.build()\n    this._buildGrid()\n  }\n\n  update() {\n    super.update()\n    this._rebuildAll()\n  }\n\n  /** carrier attach anchor — slotId 가 cellId 면 그 cell pad 반환, 아니면 grid group. */\n  getAttachFrame(slotId?: string): THREE.Object3D | undefined {\n    if (slotId) {\n      const pad = this._padByCellId.get(slotId)\n      if (pad) return pad\n    }\n    return this._gridGroup\n  }\n  /** slotTargetAt(cellId).attachObject3d = cell pad — Stockpile.getSlotAttachObject3d 가 호출. */\n  getCellPadMesh(slotId: string): THREE.Mesh | undefined {\n    return this._padByCellId.get(slotId)\n  }\n\n  private _disposeAll(): void {\n    if (this._gridGroup) {\n      this._disposeGroupChildren(this._gridGroup)\n      this.object3d.remove(this._gridGroup)\n      this._gridGroup = undefined\n    }\n    this._padByCellId.clear()\n    this._carriersByCellId.clear()\n    for (const m of this._materialByColor.values()) m.dispose()\n    this._materialByColor.clear()\n  }\n\n  private _disposeGroupChildren(group: THREE.Object3D): void {\n    while (group.children.length > 0) {\n      const child = group.children[0]\n      this._disposeGroupChildren(child)\n      group.remove(child)\n      if ((child as any).geometry?.dispose) (child as any).geometry.dispose()\n    }\n  }\n\n  private _rebuildAll(): void {\n    this._disposeAll()\n    this._buildGrid()\n  }\n\n  private _buildGrid(): void {\n    const grid = this.component as unknown as StockpileGrid\n    const cols = grid.cols\n    const rows = grid.rows\n    const cellW = grid.cellW\n    const cellH = grid.cellH\n    const state = grid.state as any\n\n    const outline = new THREE.Color((state.strokeStyle as string) || '#7a5a2e')\n    const fillColor = new THREE.Color((state.fillStyle as string) || '#c89c5c')\n\n    this._gridGroup = new THREE.Group()\n    // grid pad 원점은 컴포넌트 중심 (left+totalW/2). state.left/top 기준 origin 0\n    // 인 사각형 좌상단 — grid local 좌표에서 cell 의 인덱스 (col, row) → cell center\n    // = (col+0.5)*cellW - totalW/2, (row+0.5)*cellH - totalH/2 (3D world 의 컴포넌트\n    // 중심 기준 local).\n    const totalW = cellW * cols\n    const totalH = cellH * rows\n    this.object3d.add(this._gridGroup)\n\n    for (let r = 0; r < rows; r++) {\n      for (let c = 0; c < cols; c++) {\n        const cellId = grid.cellIdOf(c, r)\n        const cellFill = fillColor   // cell 별 색 override 없음 — 모두 grid 공통\n\n        // ── cell pad ─────────────────────────────────────────\n        const padGeom = new THREE.BoxGeometry(cellW * 0.96, PAD_DEPTH, cellH * 0.96)\n        const padMat = new THREE.MeshStandardMaterial({\n          color: cellFill, roughness: 0.85, transparent: true, opacity: 0.55\n        })\n        const pad = new THREE.Mesh(padGeom, padMat)\n        const cx = (c + 0.5) * cellW - totalW / 2\n        const cz = (r + 0.5) * cellH - totalH / 2\n        pad.position.set(cx, PAD_DEPTH / 2, cz)\n        pad.receiveShadow = true\n        pad.userData.slotId = cellId\n        this._gridGroup.add(pad)\n        this._padByCellId.set(cellId, pad)\n\n        // cell outline — 페인트 라인\n        const padEdges = new THREE.EdgesGeometry(padGeom)\n        const padLine = new THREE.LineSegments(padEdges, new THREE.LineBasicMaterial({ color: outline }))\n        padLine.position.copy(pad.position)\n        this._gridGroup.add(padLine)\n\n        // ── cell carriers ────────────────────────────────────\n        const cg = new THREE.Group()\n        cg.position.set(cx, PAD_DEPTH, cz)\n        this._gridGroup.add(cg)\n        this._carriersByCellId.set(cellId, cg)\n        this._populateCellCarriers(c, r, cg)\n      }\n    }\n  }\n\n  /** cell 의 records 를 stackPattern / carrierPreset 으로 배치. */\n  private _populateCellCarriers(col: number, row: number, group: THREE.Group): void {\n    const grid = this.component as unknown as StockpileGrid\n    const records = grid.recordsOf(col, row)\n    if (records.length === 0) return\n\n    const state = grid.state as any\n    const preset = (state.carrierPreset ?? 'box') as CarrierPreset\n    const pattern = (state.stackPattern ?? 'row') as StackPattern\n    const def = PRESET_DEFAULT_SIZE[preset] ?? PRESET_DEFAULT_SIZE.box\n    const cw = state.carrierWidth ?? def.w\n    const ch = state.carrierHeight ?? def.h\n    const cd = state.carrierDepth ?? def.d\n    const gap = state.carrierGap ?? 10\n    const heightLimit = state.stackHeightLimit as number | undefined\n\n    const cellW = grid.cellW\n    const cellH = grid.cellH\n    const geom = this._carrierGeometry(preset, cw, ch, cd)\n\n    const positions = this._computeStackPositions(pattern, records.length, cellW, cellH, cw, ch, cd, gap, heightLimit)\n    const presetDefault = PRESET_COLOR[preset] ?? PRESET_COLOR.box\n    for (let i = 0; i < positions.length; i++) {\n      const p = positions[i]\n      const record = records[i]\n      const legendColor = (grid as any).resolveLegendColor?.(record)\n      let colorHex = presetDefault\n      if (typeof legendColor === 'string' && legendColor.length > 0) {\n        try { colorHex = new THREE.Color(legendColor).getHex() } catch { /* ignore */ }\n      }\n      const mat = this._getMaterial(colorHex)\n      const mesh = new THREE.Mesh(geom, mat)\n      mesh.position.set(p.x, p.y, p.z)\n      mesh.castShadow = true\n      mesh.receiveShadow = true\n      mesh.userData.recordId = record.id\n      mesh.userData.cellId = grid.cellIdOf(col, row)\n      group.add(mesh)\n    }\n  }\n\n  private _computeStackPositions(\n    pattern: StackPattern,\n    count: number,\n    areaW: number, areaH: number,\n    cw: number, ch: number, cd: number,\n    gap: number,\n    heightLimit?: number\n  ): Array<{ x: number; y: number; z: number }> {\n    const out: Array<{ x: number; y: number; z: number }> = []\n    if (pattern === 'column') {\n      const layers = heightLimit ?? count\n      for (let i = 0; i < count; i++) {\n        const layer = Math.min(i, layers - 1)\n        out.push({ x: 0, y: layer * cd + cd / 2, z: 0 })\n      }\n      return out\n    }\n    const stridX = cw + gap\n    const stridZ = ch + gap\n    const cols = Math.max(1, Math.floor((areaW + gap) / stridX))\n    const rows = Math.max(1, Math.floor((areaH + gap) / stridZ))\n    const cellsPerLayer = cols * rows\n    if (pattern === 'pyramid') {\n      let remaining = count\n      let layer = 0\n      while (remaining > 0) {\n        const lcols = Math.max(1, cols - layer)\n        const lrows = Math.max(1, rows - layer)\n        const cellsThisLayer = lcols * lrows\n        const take = Math.min(remaining, cellsThisLayer)\n        for (let i = 0; i < take; i++) {\n          const c = i % lcols\n          const r = Math.floor(i / lcols)\n          const offC = (cols - lcols) / 2\n          const offR = (rows - lrows) / 2\n          const x = -areaW / 2 + (c + offC + 0.5) * stridX\n          const z = -areaH / 2 + (r + offR + 0.5) * stridZ\n          out.push({ x, y: layer * cd + cd / 2, z })\n        }\n        remaining -= take\n        layer++\n        if (lcols === 1 && lrows === 1) {\n          for (let i = 0; i < remaining; i++) {\n            out.push({ x: 0, y: (layer + i) * cd + cd / 2, z: 0 })\n          }\n          break\n        }\n        if (heightLimit && layer >= heightLimit) break\n      }\n      return out\n    }\n    if (pattern === 'pile') {\n      const rng = (i: number) => ((Math.sin(i * 12.9898) * 43758.5453) % 1 + 1) % 1\n      for (let i = 0; i < count; i++) {\n        const layer = Math.floor(i / cellsPerLayer)\n        const idx = i % cellsPerLayer\n        const c = idx % cols\n        const r = Math.floor(idx / cols)\n        const jX = (rng(i * 2) - 0.5) * cw * 0.2\n        const jZ = (rng(i * 2 + 1) - 0.5) * ch * 0.2\n        const x = -areaW / 2 + (c + 0.5) * stridX + jX\n        const z = -areaH / 2 + (r + 0.5) * stridZ + jZ\n        out.push({ x, y: layer * cd + cd / 2, z })\n        if (heightLimit && layer >= heightLimit - 1 && idx === cellsPerLayer - 1) break\n      }\n      return out\n    }\n    // row / staggered\n    for (let i = 0; i < count; i++) {\n      const layer = Math.floor(i / cellsPerLayer)\n      if (heightLimit && layer >= heightLimit) break\n      const idx = i % cellsPerLayer\n      const c = idx % cols\n      const r = Math.floor(idx / cols)\n      let x = -areaW / 2 + (c + 0.5) * stridX\n      const z = -areaH / 2 + (r + 0.5) * stridZ\n      if (pattern === 'staggered' && layer % 2 === 1) x += stridX / 2\n      out.push({ x, y: layer * cd + cd / 2, z })\n    }\n    return out\n  }\n\n  private _carrierGeometry(preset: CarrierPreset, w: number, h: number, d: number): THREE.BufferGeometry {\n    if (preset === 'drum') {\n      const radius = Math.min(w, h) / 2\n      return new THREE.CylinderGeometry(radius, radius, d, 16)\n    }\n    if (preset === 'sack' || preset === 'bale') {\n      return new THREE.BoxGeometry(w * 0.92, d * 0.92, h * 0.92)\n    }\n    return new THREE.BoxGeometry(w, d, h)\n  }\n\n  private _getMaterial(colorHex: number): THREE.MeshStandardMaterial {\n    let m = this._materialByColor.get(colorHex)\n    if (!m) {\n      m = new THREE.MeshStandardMaterial({ color: colorHex, roughness: 0.7 })\n      this._materialByColor.set(colorHex, m)\n    }\n    return m\n  }\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>): void {\n    // 거의 모든 속성 변경이 grid 재구성 — 단순화.\n    const keys = [\n      'cols', 'rows', 'cellWidth', 'cellHeight',\n      'cells', 'data',\n      'stackPattern', 'carrierPreset',\n      'carrierWidth', 'carrierHeight', 'carrierDepth', 'carrierGap',\n      'capacity', 'stackHeightLimit', 'pickPolicy',\n      'fillStyle', 'strokeStyle',\n      'width', 'height'\n    ]\n    if (keys.some(k => k in after)) {\n      this._rebuildAll()\n      return\n    }\n    super.onchange?.(after, before)\n  }\n\n  updateDimension(): void {\n    this._rebuildAll()\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    // pad 들의 opacity 만 (carriers 는 alpha 그대로)\n    for (const pad of this._padByCellId.values()) {\n      const m = pad.material as THREE.MeshStandardMaterial\n      m.opacity = 0.55 * alpha\n      m.transparent = m.opacity < 1\n      m.needsUpdate = true\n    }\n  }\n}\n"]}

package/dist/stockpile-grid.d.ts

@@ -0,0 +1,85 @@
+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 { StockpileGrid3D } from './stockpile-grid-3d.js';
+import type { StackPattern, CarrierPreset, StockpileRecord, PickPolicy } from './stockpile.js';
+/** grid 의 한 cell — 위치 + 그 cell 의 records. */
+export interface StockpileGridCell {
+    col: number;
+    row: number;
+    data?: StockpileRecord[];
+}
+export interface StockpileGridState extends State {
+    cols?: number;
+    rows?: number;
+    /** 한 cell 의 평면 크기 (전체 width/height = cellWidth*cols, cellHeight*rows). */
+    cellWidth?: number;
+    cellHeight?: number;
+    /** grid 의 cell 들 — 각 cell 은 { col, row, data: Record[] }. */
+    data?: StockpileGridCell[];
+    stackPattern?: StackPattern;
+    carrierPreset?: CarrierPreset;
+    carrierWidth?: number;
+    carrierHeight?: number;
+    carrierDepth?: number;
+    carrierGap?: number;
+    capacity?: number;
+    stackHeightLimit?: number;
+    pickPolicy?: PickPolicy;
+    popupRef?: string;
+    legendTarget?: string;
+    material3d?: Material3D;
+}
+declare const StockpileGrid_base: any;
+export default class StockpileGrid extends StockpileGrid_base {
+    state: StockpileGridState;
+    _realObject?: StockpileGrid3D;
+    static placement: PlacementArchetype;
+    static align: Alignment;
+    static defaultDepth: (_h: Heights) => number;
+    get nature(): ComponentNature;
+    get anchors(): never[];
+    _rebuildVisual(): void;
+    get cols(): number;
+    get rows(): number;
+    get cellW(): number;
+    get cellH(): number;
+    cellIdOf(col: number, row: number): string;
+    parseCellId(slotId: string): {
+        col: number;
+        row: number;
+    } | null;
+    /** state.data 에서 (col,row) cell 찾기. */
+    private _findCell;
+    /** cell 의 records (없으면 빈 배열). */
+    recordsOf(col: number, row: number): ReadonlyArray<StockpileRecord>;
+    /** capacity 는 모든 cell 공통. */
+    capacityOf(_col: number, _row: number): number | undefined;
+    slotIds(): ReadonlyArray<string>;
+    hasCarrierAt(slotId: string): boolean;
+    canReceiveAt(slotId: string, _carrier?: Component): boolean;
+    occupiedSlotIds(): ReadonlyArray<string>;
+    emptySlotIds(): ReadonlyArray<string>;
+    obtainCarrier(slotId: string): Component | null;
+    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;
+    attachPointFor(carrier: Component): AttachFrame | null;
+    private _setCellRecords;
+    private _materializeCarrier;
+    get eventMap(): {
+        '(self)': {
+            '(self)': {
+                click: (mouseEvent: MouseEvent) => void;
+            };
+        };
+    };
+    private _onGridClick;
+    private _dispatchCellPopup;
+    private _raycastHit;
+    render(ctx: CanvasRenderingContext2D): void;
+    buildRealObject(): RealObject | undefined;
+}
+export {};