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

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()
+    })
+  })
+})