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

package/test/test-slot-ids-enumeration.ts

@@ -0,0 +1,137 @@
+/*
+ * SlottedHolder.slotIds() — capability 기반 enumeration 검증.
+ *
+ * Phase 0 의 핵심: rack 종류 무관 (StorageRack / RackGrid) 으로 *모든 slot id 목록*
+ * 을 얻는 능력. 인접 slot 발견, simulate, audit 등의 entry point.
+ */
+
+import 'should'
+import StorageRack from '../src/storage-rack.js'
+import RackGrid from '../src/rack-grid.js'
+
+// inline duck-type — scene-base 의 src import 가 test 환경의 Component named
+// import 와 충돌 (things-scene CJS↔ESM) 회피.
+function isSlottedHolder(x: any): boolean {
+  return !!x &&
+    typeof x.hasCarrierAt === 'function' &&
+    typeof x.obtainCarrier === 'function' &&
+    typeof x.canReceiveAt === 'function' &&
+    typeof x.receiveAt === 'function' &&
+    typeof x.getSlotAttachObject3d === 'function' &&
+    typeof x.slotIds === 'function'
+}
+
+// ── Mock things-scene env — Component constructor 에 필요한 최소 _app ────────
+
+function makeApp(): any {
+  return {
+    register: () => {},
+    components: [],
+    layout: 'absolute'
+  }
+}
+
+// ──────────────────────────────────────────────────────────────────────────
+
+describe('SlottedHolder.slotIds — capability enumeration', () => {
+  describe('StorageRack', () => {
+    it('default bays=5, levels=4 → 20 slots', () => {
+      const rack = new StorageRack({ bays: 5, levels: 4 } as any, makeApp())
+      const ids = rack.slotIds()
+      ids.length.should.equal(20)
+    })
+
+    it('bays=3, levels=2 → 6 slots, "0-0-0".."2-0-1"', () => {
+      const rack = new StorageRack({ bays: 3, levels: 2 } as any, makeApp())
+      const ids = rack.slotIds()
+      ids.length.should.equal(6)
+      // bay 순회 → level 순회
+      ids.should.containEql('0-0-0')
+      ids.should.containEql('0-0-1')
+      ids.should.containEql('2-0-0')
+      ids.should.containEql('2-0-1')
+    })
+
+    it('id format = slotIdOf(bay, 1, level) → "0-based"', () => {
+      const rack = new StorageRack({ bays: 2, levels: 2 } as any, makeApp())
+      const ids = rack.slotIds()
+      ids.should.containEql(rack.slotIdOf(1, 1, 1))   // "0-0-0"
+      ids.should.containEql(rack.slotIdOf(2, 1, 2))   // "1-0-1"
+    })
+
+    it('default state (no bays/levels) → 5×4 = 20', () => {
+      const rack = new StorageRack({} as any, makeApp())
+      rack.slotIds().length.should.equal(20)
+    })
+  })
+
+  describe('RackGrid', () => {
+    it('default columns=5, rows=3, shelves=4 → 60 slots', () => {
+      const rg = new RackGrid({ columns: 5, rows: 3, shelves: 4 } as any, makeApp())
+      const ids = rg.slotIds()
+      ids.length.should.equal(60)
+    })
+
+    it('columns=2, rows=1, shelves=3 → 6 slots', () => {
+      const rg = new RackGrid({ columns: 2, rows: 1, shelves: 3 } as any, makeApp())
+      const ids = rg.slotIds()
+      ids.length.should.equal(6)
+      ids.should.containEql('0-0-0')
+      ids.should.containEql('0-0-1')
+      ids.should.containEql('0-0-2')
+      ids.should.containEql('1-0-0')
+      ids.should.containEql('1-0-1')
+      ids.should.containEql('1-0-2')
+    })
+
+    it('id format = "col-row-shelf" (0-based)', () => {
+      const rg = new RackGrid({ columns: 2, rows: 2, shelves: 2 } as any, makeApp())
+      const ids = rg.slotIds()
+      // 마지막 col, row, shelf
+      ids.should.containEql('1-1-1')
+    })
+
+    it('cellOverrides[posKey].isEmpty=true 인 bay 는 enumeration 에서 제외', () => {
+      const rg = new RackGrid({
+        columns: 2,
+        rows: 1,
+        shelves: 2,
+        cellOverrides: {
+          '1-0': { isEmpty: true }   // col=1, row=0 bay 가 isEmpty
+        }
+      } as any, makeApp())
+      const ids = rg.slotIds()
+      // col=0 만 — 2 shelves × 1 col × 1 row = 2 slots
+      ids.length.should.equal(2)
+      ids.should.containEql('0-0-0')
+      ids.should.containEql('0-0-1')
+      // col=1 의 slot 은 *없어야*
+      ids.should.not.containEql('1-0-0')
+      ids.should.not.containEql('1-0-1')
+    })
+  })
+
+  describe('isSlottedHolder duck-type 가 slotIds 도 검사', () => {
+    it('StorageRack 인스턴스는 SlottedHolder 로 인식', () => {
+      const rack = new StorageRack({ bays: 2, levels: 2 } as any, makeApp())
+      isSlottedHolder(rack).should.be.true()
+    })
+
+    it('RackGrid 인스턴스는 SlottedHolder 로 인식', () => {
+      const rg = new RackGrid({ columns: 2, rows: 1, shelves: 2 } as any, makeApp())
+      isSlottedHolder(rg).should.be.true()
+    })
+
+    it('slotIds 미구현 plain object 는 SlottedHolder 아님', () => {
+      const fake = {
+        hasCarrierAt() { return false },
+        obtainCarrier() { return null },
+        canReceiveAt() { return true },
+        receiveAt() {},
+        getSlotAttachObject3d() { return undefined }
+        // slotIds 빠짐
+      }
+      isSlottedHolder(fake).should.be.false()
+    })
+  })
+})

package/test/things-scene-loader-impl.mjs

@@ -0,0 +1,37 @@
+/*
+ * Things-scene loader implementation — `@hatiolab/things-scene` 의 Node resolve
+ * 를 browser ESM bundle (things-scene.mjs) 로 redirect.
+ *
+ * 이 module 은 register() 의 대상. 별 thread context 에서 Node 의 module resolution
+ * hook 으로 동작.
+ */
+
+import { pathToFileURL, fileURLToPath } from 'node:url'
+import { resolve as pathResolve, dirname } from 'node:path'
+
+// 처음 import resolve 시점에 things-scene 의 browser ESM 경로 확정.
+let cachedBrowserUrl = null
+
+function getBrowserBundle() {
+  if (cachedBrowserUrl) return cachedBrowserUrl
+  // 현재 file 의 위치 — packages/storage/test/.
+  // things-scene bundle 위치 — operato-scene/node_modules/@hatiolab/things-scene/things-scene.mjs
+  const here = fileURLToPath(import.meta.url)
+  const root = pathResolve(dirname(here), '..', '..', '..')  // operato-scene root
+  const browserBundle = pathResolve(root, 'node_modules', '@hatiolab', 'things-scene', 'things-scene.mjs')
+  cachedBrowserUrl = pathToFileURL(browserBundle).href
+  return cachedBrowserUrl
+}
+
+export async function resolve(specifier, context, nextResolve) {
+  // @hatiolab/things-scene 의 bare specifier 만 redirect.
+  // subpath 또는 deep import 는 default 동작 유지.
+  if (specifier === '@hatiolab/things-scene') {
+    return {
+      url: getBrowserBundle(),
+      format: 'module',
+      shortCircuit: true
+    }
+  }
+  return nextResolve(specifier, context)
+}

package/test/things-scene-loader.mjs

@@ -0,0 +1,24 @@
+/*
+ * Node ESM loader — @hatiolab/things-scene 의 "node" condition 우회.
+ *
+ * Issue:
+ *   things-scene package.json 의 exports 가 Node 우선 things-scene-transfer.mjs
+ *   (minimal Node bundle) — Component 가 export 되지 않음. scene-config.ts /
+ *   placeable.ts 등 SceneConfig 기반 코드 load 시 ESM error 발생.
+ *
+ * Fix:
+ *   이 loader 가 `@hatiolab/things-scene` 의 import 를 가로채 things-scene.mjs
+ *   (browser ESM, Component 포함) 로 redirect. test/setup.js 의 polyfill 들이
+ *   browser 글로벌을 대신.
+ *
+ * Activation:
+ *   mocha --node-option="import=./test/things-scene-loader.mjs" ...
+ *   또는 node --import ./test/things-scene-loader.mjs
+ */
+
+import { register } from 'node:module'
+import { pathToFileURL, fileURLToPath } from 'node:url'
+import { dirname, resolve as pathResolve } from 'node:path'
+
+const loaderUrl = new URL('./things-scene-loader-impl.mjs', import.meta.url)
+register(loaderUrl, import.meta.url)

package/translations/en.json

@@ -42,6 +42,8 @@
 
   "label.status": "status",
   "label.simulate": "simulate",
+  "label.speed": "speed",
+  "label.bound-holders": "bound holders",
   "label.carriage-position": "carriage position",
   "label.carriage-width": "carriage width",
   "label.carriage-height": "carriage height",

package/translations/ja.json

@@ -42,6 +42,8 @@
 
   "label.status": "状態",
   "label.simulate": "シミュレーション",
+  "label.speed": "速度",
+  "label.bound-holders": "バインドホルダー",
   "label.carriage-position": "キャリッジ位置",
   "label.carriage-width": "キャリッジ幅",
   "label.carriage-height": "キャリッジ高さ",

package/translations/ko.json

@@ -42,6 +42,8 @@
 
   "label.status": "상태",
   "label.simulate": "시뮬레이션",
+  "label.speed": "속도",
+  "label.bound-holders": "바인딩된 홀더",
   "label.carriage-position": "캐리지 위치",
   "label.carriage-width": "캐리지 폭",
   "label.carriage-height": "캐리지 높이",

package/translations/ms.json

@@ -42,6 +42,8 @@
 
   "label.status": "status",
   "label.simulate": "simulasi",
+  "label.speed": "kelajuan",
+  "label.bound-holders": "pemegang terikat",
   "label.carriage-position": "kedudukan pembawa",
   "label.carriage-width": "lebar pembawa",
   "label.carriage-height": "tinggi pembawa",

package/translations/zh.json

@@ -42,6 +42,8 @@
 
   "label.status": "状态",
   "label.simulate": "模拟",
+  "label.speed": "速度",
+  "label.bound-holders": "绑定的容器",
   "label.carriage-position": "载具位置",
   "label.carriage-width": "载具宽度",
   "label.carriage-height": "载具高度",