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

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, componentBoundingBox } 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,7 +156,20 @@ 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() {
@@ -299,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 {
@@ -395,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;
@@ -482,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 정확 클론.
      */
@@ -1114,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