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

package/dist/picking-station.js

@@ -0,0 +1,186 @@
+/*
+ * 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, SingleSlotHolder } 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 SingleSlotHolder()(CarrierHolder(Placeable(ContainerAbstract))) {
+    static placement = 'floor';
+    static align = 'bottom';
+    static defaultDepth = (h) => h.operation - h.floor;
+    get nature() { return NATURE; }
+    get anchors() { return []; }
+    // SingleSlotHolder hook overrides ───────────────────────────────────────────
+    _singleSlotId() { return SLOT_ID; }
+    /**
+     * SlottedHolder duck (slotIds / hasCarrierAt / canReceiveAt / occupiedSlotIds
+     * / emptySlotIds / obtainCarrier / receiveAt / accept / receive / slotTargetAt
+     * / getSlotAttachObject3d) — SingleSlotHolder mixin 제공.
+     *
+     * receiveAt 후 부가 dwell 동작은 `_onCarrierReceived` hook 으로 위임.
+     */
+    _onCarrierReceived(_carrier, _options) {
+        const procMs = this.state.processingTimeMs ?? 0;
+        if (procMs <= 0)
+            return;
+        this.setState({ status: 'processing' });
+        setTimeout(() => {
+            if (this.state.status === 'processing') {
+                this.setState({ status: 'idle' });
+            }
+        }, procMs);
+    }
+    // Phase ZT-V PR-6 ProcessStep ─────────────────────────────────────────────
+    isProcessStep = true;
+    get processingTimeMs() { return this.state.processingTimeMs ?? 0; }
+    /** 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  SingleSlotHolder,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype,\n  type ProcessStep\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\n  extends SingleSlotHolder()(CarrierHolder(Placeable(ContainerAbstract)))\n  implements ProcessStep\n{\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  // SingleSlotHolder hook overrides ───────────────────────────────────────────\n  _singleSlotId() { return SLOT_ID }\n\n  /**\n   * SlottedHolder duck (slotIds / hasCarrierAt / canReceiveAt / occupiedSlotIds\n   * / emptySlotIds / obtainCarrier / receiveAt / accept / receive / slotTargetAt\n   * / getSlotAttachObject3d) — SingleSlotHolder mixin 제공.\n   *\n   * receiveAt 후 부가 dwell 동작은 `_onCarrierReceived` hook 으로 위임.\n   */\n  _onCarrierReceived(_carrier: Component, _options?: any) {\n    const procMs = this.state.processingTimeMs ?? 0\n    if (procMs <= 0) return\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  // Phase ZT-V PR-6 ProcessStep ─────────────────────────────────────────────\n  readonly isProcessStep = true as const\n  get processingTimeMs() { return this.state.processingTimeMs ?? 0 }\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"]}

package/dist/rack-grid.d.ts

@@ -73,6 +73,10 @@ export interface RackGridState extends State {
 declare const RackGrid_base: any;
 export default class RackGrid extends RackGrid_base implements SlottedHolder {
     state: RackGridState;
+    _recordToSlotId(record: {
+        cellId: string;
+    }): string;
+    _rebuildVisual(): void;
     get isObstacle(): boolean;
     obstacleBoundingBox(): {
         left: number;
@@ -106,25 +110,6 @@ export default class RackGrid extends RackGrid_base implements SlottedHolder {
     onchange(after: Properties, _before: Properties): void;
     /** state.data 변경 시 호출 (things-scene 의 onchange<PropName>). */
     onchangeData(): void;
-    /** state.data 의 records — Plan A 의 stock 보관소. */
-    get records(): Array<{
-        cellId: string;
-        [key: string]: any;
-    }>;
-    private _legendTarget?;
-    /**
-     * Legend 컴포넌트 lookup. 우선순위:
-     *   1) state.legendTarget id 명시
-     *   2) scene 전체 의 type='legend' 첫 번째 컴포넌트 (자동 발견)
-     */
-    get legendTarget(): Component | undefined;
-    private _onLegendChanged;
-    /**
-     * record 의 legend.field 값을 ranges 와 매칭해 색상 해석.
-     *   - `range.value === recordValue` (카테고리 일치)
-     *   - `range.min ≤ Number(v) < range.max` (수치 범위)
-     *   - 매칭 없으면 `defaultColor` 또는 undefined
-     */
     get eventMap(): {
         '(self)': {
             '(self)': {
@@ -133,13 +118,10 @@ export default class RackGrid extends RackGrid_base implements SlottedHolder {
         };
     };
     private _onViewClick;
-    /** state.popupRef Popup 컴포넌트 invoke. anchor = 클릭된 cell 의 SlotTarget. */
-    private _invokePopup;
     /** raycast → 우리 RackGrid 의 어떤 mesh 가 closest hit 인지. */
     private _raycastHit;
     /** world point → cellId (col-row-shelf) 역산. */
     private _cellIdFromWorldPoint;
-    resolveLegendColor(record: any): string | undefined;
     /**
      * 새 (rows × columns) 에 맞춰 children 재구성. rack-table.buildCells 정확 클론.
      */

package/dist/rack-grid.js

@@ -32,7 +32,7 @@ import { __decorate } from "tslib";
  */
 import { Component, ContainerAbstract, Layout, Model, sceneComponent } from '@hatiolab/things-scene';
 import * as THREE from 'three';
-import { CarrierHolder, Placeable, SlotTarget } from '@operato/scene-base';
+import { CarrierHolder, Placeable, RecordStorage, SlotTarget, componentBoundingBox } from '@operato/scene-base';
 import { RackGrid3D } from './rack-grid-3d.js';
 // RackGridCell 의 refid 충돌 회피 — load 시 동적 생성되는 cell 의 refid 가 *부모
 // RackGrid + 모델 안 다른 컴포넌트* refid 와 겹치지 않도록 *높은 시작값 + monotonic
@@ -156,22 +156,28 @@ const rowControlHandler = {
 // handler 안 `this` 가 *해당 RackGrid 인스턴스* 를 가리키도록 (화살표 함수가
 // getter 의 `this` 를 capture). rack-table-cell 의 동일 패턴.
 // ─── RackGrid ─────────────────────────────────────────────────────────────────
-let RackGrid = class RackGrid extends CarrierHolder(Placeable(ContainerAbstract)) {
+let RackGrid = class RackGrid extends RecordStorage()(CarrierHolder(Placeable(ContainerAbstract))) {
+    // RecordStorage mixin hook overrides.
+    // record.cellId 가 slotId (3-segment '{col}-{row}-{shelf}' format).
+    _recordToSlotId(record) {
+        return record.cellId ?? '';
+    }
+    // 3D rebuild — rebuildStockMesh 우선, 없으면 mixin default.
+    _rebuildVisual() {
+        const ro = this._realObject;
+        if (ro?.rebuildStockMesh)
+            ro.rebuildStockMesh();
+        else if (ro?.update)
+            ro.update();
+    }
     // Phase Auto-Nav (AN-PR-2) — Obstacle 자격. AMR / mover 의 자동 path planning
     // 시 회피 대상. `state.isObstacle` 명시 false 시 override (예외 처리).
     get isObstacle() {
         return this.state?.isObstacle !== false;
     }
     obstacleBoundingBox() {
-        const s = this.state;
-        if (typeof s?.left !== 'number')
-            return null;
-        return {
-            left: s.left, top: s.top,
-            width: s.width, height: s.height,
-            y: typeof s.zPos === 'number' ? s.zPos : 0,
-            zHeight: typeof s.depth === 'number' ? s.depth : 0
-        };
+        // scene-base 의 componentBoundingBox 위임 — rotation 적용된 AABB.
+        return componentBoundingBox(this);
     }
     static placement = 'floor';
     static align = 'bottom';
@@ -306,61 +312,7 @@ let RackGrid = class RackGrid extends CarrierHolder(Placeable(ContainerAbstract)
         ;
         this._realObject?.rebuildStockMesh?.();
     }
-    /** state.data 의 records — Plan A 의 stock 보관소. */
-    get records() {
-        return this.state.data ?? [];
-    }
-    // ── Legend integration ──────────────────────────────────
-    _legendTarget;
-    /**
-     * Legend 컴포넌트 lookup. 우선순위:
-     *   1) state.legendTarget id 명시
-     *   2) scene 전체 의 type='legend' 첫 번째 컴포넌트 (자동 발견)
-     */
-    get legendTarget() {
-        if (this._legendTarget)
-            return this._legendTarget;
-        const id = this.state.legendTarget;
-        if (id) {
-            const found = this.root?.findById?.(id);
-            if (found) {
-                this._legendTarget = found;
-                found.on?.('change', this._onLegendChanged, this);
-                return found;
-            }
-        }
-        const visit = (node) => {
-            if (!node)
-                return undefined;
-            if (node.state?.type === 'legend')
-                return node;
-            const children = node.components;
-            if (children) {
-                for (const c of children) {
-                    const r = visit(c);
-                    if (r)
-                        return r;
-                }
-            }
-            return undefined;
-        };
-        const found = visit(this.root);
-        if (found) {
-            this._legendTarget = found;
-            found.on?.('change', this._onLegendChanged, this);
-        }
-        return found;
-    }
-    _onLegendChanged = () => {
-        ;
-        this._realObject?.rebuildStockMesh?.();
-    };
-    /**
-     * record 의 legend.field 값을 ranges 와 매칭해 색상 해석.
-     *   - `range.value === recordValue` (카테고리 일치)
-     *   - `range.min ≤ Number(v) < range.max` (수치 범위)
-     *   - 매칭 없으면 `defaultColor` 또는 undefined
-     */
+    // records / legendTarget / _onLegendChanged / resolveLegendColor — RecordStorage mixin 제공.
     // ── View-mode click → rack-grid-cell-click event + popup ──
     get eventMap() {
         return {
@@ -402,23 +354,12 @@ let RackGrid = class RackGrid extends CarrierHolder(Placeable(ContainerAbstract)
         }
         const payload = { cellId, record, hitPoint: hit.point, instanceId, isStock };
         this.trigger('rack-grid-cell-click', payload);
-        this._invokePopup(cellId, record);
+        if (cellId)
+            this._invokePopup(cellId, record ?? { cellId });
         // popup 외부 click 으로 인식되어 자동 close 되는 회귀 차단
         mouseEvent.stopPropagation?.();
     };
-    /** state.popupRef Popup 컴포넌트 invoke. anchor = 클릭된 cell 의 SlotTarget. */
-    _invokePopup(cellId, record) {
-        const popupRefId = this.state.popupRef;
-        if (!popupRefId || !cellId)
-            return;
-        const popupComp = this.root?.findById?.(popupRefId);
-        if (!popupComp || typeof popupComp.openPopup !== 'function') {
-            console.warn(`[rack-grid] popupRef="${popupRefId}" 가 가리키는 컴포넌트 없거나 openPopup 미지원`);
-            return;
-        }
-        const anchor = this.slotTargetAt(cellId);
-        popupComp.openPopup(record ?? { cellId }, { anchor });
-    }
+    // _invokePopup — RecordStorage mixin 제공 (signature 동일: slotId=cellId, payload=record).
     /** raycast → 우리 RackGrid 의 어떤 mesh 가 closest hit 인지. */
     _raycastHit(mouseEvent) {
         const ro = this._realObject;
@@ -489,40 +430,7 @@ let RackGrid = class RackGrid extends CarrierHolder(Placeable(ContainerAbstract)
         }
         return `${col}-${row}-${shelf}`;
     }
-    resolveLegendColor(record) {
-        const legend = this.legendTarget;
-        if (!legend)
-            return undefined;
-        const status = legend.getState?.('status') ?? legend.state?.status;
-        if (!status)
-            return undefined;
-        const field = status.field;
-        const ranges = status.ranges;
-        if (!field || !Array.isArray(ranges))
-            return undefined;
-        const value = record?.[field];
-        if (value === undefined || value === null)
-            return status.defaultColor;
-        for (const range of ranges) {
-            if (!range)
-                continue;
-            if (range.value !== undefined) {
-                if (range.value === value)
-                    return range.color;
-                continue;
-            }
-            const num = Number(value);
-            if (!Number.isFinite(num))
-                continue;
-            const min = range.min !== undefined && range.min !== '' ? Number(range.min) : undefined;
-            const max = range.max !== undefined && range.max !== '' ? Number(range.max) : undefined;
-            const minOk = min === undefined || num >= min;
-            const maxOk = max === undefined || num < max;
-            if (minOk && maxOk)
-                return range.color;
-        }
-        return status.defaultColor;
-    }
+    // resolveLegendColor — RecordStorage mixin 제공.
     /**
      * 새 (rows × columns) 에 맞춰 children 재구성. rack-table.buildCells 정확 클론.
      */
@@ -1121,7 +1029,7 @@ let RackGrid = class RackGrid extends CarrierHolder(Placeable(ContainerAbstract)
             return false;
         if (this._carrierChildAt(cellId))
             return true;
-        return this.records.some(r => r.cellId === cellId);
+        return this.records.some((r) => r.cellId === cellId);
     }
     /**
      * carrier 를 obtain — 이미 child 면 그대로, 아니면 state.data record 로 transient