@operato/scene-storage 10.0.0-beta.40 → 10.0.0-beta.42

package/dist/storage-cell.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-cell.js","sourceRoot":"","sources":["../src/storage-cell.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * RackCell — a single storage slot within an Rack.\n *\n * A RackCell is a virtual component: it occupies a specific (bay, row, level)\n * coordinate within the parent rack and acts as a CarrierHolder for one carrier\n * (or several, depending on `cellType`).\n *\n * The crane (or any picker) navigates toward a RackCell as its `place()` destination —\n * because the rack cell is a discrete component, Mover.moveTo() can target it\n * directly and arrive at exactly the right bay × level position.\n *\n * Visual: invisible in 2D (no visible 2D footprint — rack cells don't make\n * sense as 2D top-down boxes). In 3D, each cell is an invisible Group\n * positioned within the rack's coordinate space (RackCell3D handles\n * this via updateTransform override).\n *\n * Lifecycle: Rack._buildCells() instantiates RackCell children.\n * Do not create RackCell components manually — they are managed by the rack.\n *\n * Domain aliases:\n *   cell.store(carrier)            ← cell.receive(carrier)\n *   cell.retrieve(carrier, target) ← cell.dispatch(carrier, target)\n */\n\nimport {\n  Component,\n  ComponentNature,\n  ContainerAbstract,\n  RealObject,\n  TRANSFER_SLOT_KEY,\n  sceneComponent\n} from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport { CarrierHolder, type AttachFrame } from '@operato/scene-base'\n\nimport { StorageCell3D } from './storage-cell-3d.js'\n\n/**\n * How many carriers a cell can hold simultaneously.\n * - single: exactly 1 (typical pallet bay)\n * - multi:  small stack (up to 4, e.g. a multi-deep tray)\n * - bulk:   unlimited (e.g. a floor area measured in slots)\n */\nexport type StorageCellType = 'single' | 'multi' | 'bulk'\n\n/** RackCell 컴포넌트 state */\nexport interface StorageCellState extends State {\n  // ── 식별 ──\n  cellId?: string\n  cellType?: StorageCellType\n  /**\n   * 자동 할당된 location ID — RackTable.assignLocations() 가 set. 외부 시스템\n   * (WMS, picker 명령 등) 이 cell 을 지칭하는 사람-친화 ID. RackTable 없이\n   * 단독으로 Rack 을 사용할 땐 unset.\n   */\n  locationId?: string\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: false,\n  rotatable: false,\n  properties: [\n    {\n      type: 'string',\n      label: 'cell-id',\n      name: 'cellId',\n      placeholder: 'e.g. 0-0-0'\n    },\n    {\n      type: 'select',\n      label: 'cell-type',\n      name: 'cellType',\n      property: {\n        options: [\n          { display: 'Single', value: 'single' },\n          { display: 'Multi', value: 'multi' },\n          { display: 'Bulk', value: 'bulk' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/storage-cell'\n}\n\n/**\n * RackCell — single-slot storage cell inside an Rack.\n *\n * Mixin chain: CarrierHolder(ContainerAbstract)\n *   - CarrierHolder: publishes attachPointFor(), gates containable() to Carriables\n *   - ContainerAbstract: manages child carrier components\n *\n * No Placeable mixin — RackCell3D self-positions from the parent rack's\n * CellMap (via updateTransform override), bypassing things-scene's standard\n * 2D→3D coordinate mapping which cannot express 3D levels.\n */\n@sceneComponent('storage-cell')\nexport default class RackCell extends CarrierHolder(ContainerAbstract) {\n  declare state: StorageCellState\n\n  // ── Identification ────────────────────────────────────────────────────────\n\n  get cellId(): string {\n    return this.state.cellId ?? ''\n  }\n\n  get cellType(): StorageCellType {\n    return this.state.cellType ?? 'single'\n  }\n\n  /** Maximum carrier count for this cell based on cellType. */\n  get capacity(): number {\n    switch (this.cellType) {\n      case 'single': return 1\n      case 'multi': return 4\n      case 'bulk': return Infinity\n    }\n  }\n\n  // ── Interface ─────────────────────────────────────────────────────────────\n\n  get nature(): ComponentNature {\n    return NATURE\n  }\n\n  get anchors(): [] {\n    return []\n  }\n\n  // ── Transfer protocol ─────────────────────────────────────────────────────\n\n  /** True when fewer carriers are currently held than capacity. */\n  canReceive(_component?: any): boolean {\n    const occupied = (this.components as Component[] | undefined)?.length ?? 0\n    return occupied < this.capacity\n  }\n\n  /**\n   * Accept a carrier into this cell.\n   * Sets TRANSFER_SLOT_KEY = cellId on the carrier, then reparents.\n   * Fires 'transfer-received' so monitors can react.\n   */\n  async receive(carrier: any, options: any = {}): Promise<void> {\n    if (!this.canReceive(carrier)) {\n      this.trigger('transfer-rejected', {\n        type: 'transfer-rejected',\n        component: carrier,\n        container: this,\n        reason: 'no-slot'\n      })\n      return\n    }\n    carrier[TRANSFER_SLOT_KEY] = this.cellId\n    this.reparent(carrier, options)\n    this.trigger('transfer-received', {\n      type: 'transfer-received',\n      component: carrier,\n      container: this,\n      slotId: this.cellId\n    })\n  }\n\n  /**\n   * Release a carrier from this cell to `target`.\n   * Delegates to `target.receive()` if available, otherwise `target.reparent()`.\n   */\n  async dispatch(carrier: any, target: any, options: any = {}): Promise<void> {\n    if (target?.canReceive && !target.canReceive(carrier)) {\n      this.trigger('transfer-rejected', {\n        type: 'transfer-rejected',\n        component: carrier,\n        container: this,\n        reason: 'target-full'\n      })\n      return\n    }\n    delete carrier[TRANSFER_SLOT_KEY]\n    if (typeof target?.receive === 'function') {\n      await target.receive(carrier, options)\n    } else {\n      ;(target as any).reparent?.(carrier, options)\n    }\n    this.trigger('transfer-dispatched', {\n      type: 'transfer-dispatched',\n      component: carrier,\n      container: this,\n      target\n    })\n  }\n\n  // ── Domain aliases ────────────────────────────────────────────────────────\n\n  /** Alias for receive() — semantic sugar for the storage domain. */\n  store(carrier: any, options?: any): Promise<void> {\n    return this.receive(carrier, options)\n  }\n\n  /** Alias for dispatch() — semantic sugar for the storage domain. */\n  retrieve(carrier: any, target: any, options?: any): Promise<void> {\n    return this.dispatch(carrier, target, options)\n  }\n\n  // ── 3D attach frame ───────────────────────────────────────────────────────\n\n  /**\n   * Return the 3D attach frame for carriers placed in this cell.\n   * Carriers are lifted by their own halfDepth so the bottom face\n   * rests at the cell's Y-center (which is levelHeight/2 above the beam).\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const root = this._realObject?.object3d\n    if (!root) return null\n    const carrierDepth = resolveCarrierDepth(carrier)\n    return {\n      attach: root,\n      localPosition: { x: 0, y: carrierDepth / 2, z: 0 }\n    }\n  }\n\n  // ── 2D rendering ──────────────────────────────────────────────────────────\n\n  /** RackCell has no 2D visual — the rack draws its own structure. */\n  render(_ctx: CanvasRenderingContext2D) {\n    // intentional no-op\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new StorageCell3D(this)\n  }\n}\n\nfunction resolveCarrierDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  return numOr((c as any)?.state?.depth, 0)\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n"]}

package/src/rack-column.ts

@@ -1,340 +0,0 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- */
-
-import * as THREE from 'three'
-import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'
-
-import { RealObject } from '@hatiolab/things-scene'
-import { Stock } from './stock.js'
-import RackGrid from './rack-grid.js'
-
-
-const _color = new THREE.Color()
-const _matrix = new THREE.Matrix4()
-const _position = new THREE.Vector3()
-const _quaternion = new THREE.Quaternion()
-const _scale = new THREE.Vector3()
-
-export class Rack extends RealObject {
-  private _frame?: THREE.BufferGeometry
-  private _board?: THREE.BufferGeometry
-  private _instancedMesh?: THREE.InstancedMesh
-  private _stocks: Stock[] = []
-
-  static rackFrameGeometry = new THREE.BoxGeometry(1, 1, 1)
-  static boardGeometry = new THREE.PlaneGeometry(1, 1, 1, 1)
-
-  private static _boardMaterial?: THREE.MeshStandardMaterial
-  private static _stockMaterial?: THREE.MeshStandardMaterial
-
-  get visualizer(): any | undefined {
-    var component = this.component
-
-    while (component) {
-      if (component.state.type == 'visualizer') {
-        return component as any
-      }
-      component = component.parent
-    }
-  }
-
-  /**
-   * Stock 등록 대상: 1순위 조상 Visualizer(하위호환), 2순위 서비스 레지스트리의 stock-hub
-   */
-  get stockRegistry(): { putObject(id: string, obj: RealObject): void } | undefined {
-    const vis = this.visualizer
-    if (vis) return vis
-    return (this.component.root as any)?.getService?.('stock')
-  }
-
-  get rackTable(): RackGrid | undefined {
-    var component = this.component
-
-    while (component) {
-      if (component.state.type == 'rack-grid') {
-        return component as unknown as RackGrid
-      }
-      component = component.parent
-    }
-  }
-
-  get cz() {
-    var { shelves = 1, depth = 1 } = this.rackTable!.state
-
-    return 0.5 * depth * shelves
-  }
-
-  static get boardMaterial() {
-    if (!Rack._boardMaterial) {
-      Rack._boardMaterial = new THREE.MeshStandardMaterial({
-        color: '#dedede',
-        side: THREE.DoubleSide,
-        polygonOffset: true,
-        polygonOffsetFactor: -0.1
-      })
-    }
-
-    return Rack._boardMaterial
-  }
-
-  static get stockMaterial() {
-    if (!Rack._stockMaterial) {
-      Rack._stockMaterial = new THREE.MeshStandardMaterial({
-        color: 0xffffff,
-        side: THREE.FrontSide,
-        metalness: 0,
-        roughness: 1,
-        envMapIntensity: 0
-      })
-    }
-    return Rack._stockMaterial
-  }
-
-  get frame() {
-    return this._frame
-  }
-
-  get board() {
-    return this._board
-  }
-
-  get instancedMesh() {
-    return this._instancedMesh
-  }
-
-  get stocks() {
-    return this._stocks
-  }
-
-  build() {
-    super.build()
-
-    var { depth, hideRackFrame, shelves = 1, shelfLocations: commonShelfLocation, stockScale = 0.7 } = this.rackTable!.state
-
-    var { width, height, shelfLocations = commonShelfLocation, binLocations = '' } = this.component.state
-
-    let scale = stockScale
-
-    var shelfLocIds
-
-    if (!shelfLocations) {
-      shelfLocIds = []
-      for (var i = 0; i < shelves; i++) shelfLocIds.push(i + 1)
-    } else shelfLocIds = shelfLocations.split(/\s*,\s*/)
-
-    var shelfBins = binLocations.trim().split('\n').reverse()
-
-    if (!hideRackFrame) {
-      this._frame = this.createRackFrame(width, height, depth * shelves)
-      this._board = this.createRackBoards(shelves, width, height, depth, shelfLocIds)
-    }
-
-    // Stock 인스턴스 정보 수집
-    const stockEntries: { stock: Stock; x: number; y: number; z: number; w: number; h: number; d: number; name: string }[] = []
-
-    for (var i = 0; i < shelves; i++) {
-      let bottom = -depth * shelves * 0.5
-      if (shelfLocIds[i] == '') {
-        continue
-      }
-
-      var bins = (shelfBins[i] || '').trim().split(/\s*,\s*/)
-
-      var binWidth = width / (bins.length || 1)
-      for (var b = 0; b < bins.length; b++) {
-        let sw = binWidth * scale
-        let sh = height * scale
-        let sd = depth * scale
-
-        let stock = new Stock(this.component, { width: sw, height: sh, depth: sd })
-
-        let x = (width / 2) * ((2 * b - (bins.length - 1)) / bins.length)
-        let y = bottom + depth * i + sd * 0.5
-        let z = 0
-
-        var binCode = (bins[b] || '').replace('.', '')
-        let name = `${this.makeLocationString(shelfLocIds[i])}${binCode}`
-
-        stockEntries.push({ stock, x, y, z, w: sw, h: sh, d: sd, name })
-      }
-    }
-
-    // InstancedMesh 생성 (전체 Stock을 1개 draw call로)
-    if (stockEntries.length > 0) {
-      const instMesh = new THREE.InstancedMesh(
-        Stock.stockGeometry,
-        Rack.stockMaterial,
-        stockEntries.length
-      )
-
-      // instanceColor 초기화
-      const defaultColor = new THREE.Color(Stock.defaultMaterial.color)
-      for (let idx = 0; idx < stockEntries.length; idx++) {
-        const { stock, x, y, z, w, h, d, name } = stockEntries[idx]
-
-        _matrix.compose(
-          _position.set(x, y, z),
-          _quaternion.identity(),
-          _scale.set(w, d, h)
-        )
-        instMesh.setMatrixAt(idx, _matrix)
-        instMesh.setColorAt(idx, defaultColor)
-
-        // Stock에 instanced 참조 설정
-        stock._instancedMesh = instMesh
-        stock._instanceIndex = idx
-        stock._basePosition = { x, y, z }
-        stock._baseScale = { x: w, y: d, z: h }
-
-        // name 기반 lookup 유지
-        this._stocks.push(stock)
-        this.stockRegistry?.putObject(name, stock)
-      }
-
-      instMesh.instanceMatrix.needsUpdate = true
-      instMesh.instanceColor!.needsUpdate = true
-      instMesh.receiveShadow = true
-
-      // focused stock 회전 애니메이션
-      const self = this
-      instMesh.onBeforeRender = () => {
-        let needsUpdate = false
-        let hasFocused = false
-        for (const stock of self._stocks) {
-          if (stock._focused && stock._focusedAt != null) {
-            const elapsed = performance.now() - stock._focusedAt
-            const angle = 2 * Math.PI * (elapsed / 2000)
-            _quaternion.setFromAxisAngle(_position.set(0, 1, 0), angle)
-            _matrix.compose(
-              _position.set(stock._basePosition!.x, stock._basePosition!.y, stock._basePosition!.z),
-              _quaternion,
-              _scale.set(stock._baseScale!.x, stock._baseScale!.y, stock._baseScale!.z)
-            )
-            instMesh.setMatrixAt(stock._instanceIndex, _matrix)
-            needsUpdate = true
-            hasFocused = true
-          } else if (stock._focusedAt != null) {
-            delete stock._focusedAt
-            _matrix.compose(
-              _position.set(stock._basePosition!.x, stock._basePosition!.y, stock._basePosition!.z),
-              _quaternion.identity(),
-              _scale.set(stock._baseScale!.x, stock._baseScale!.y, stock._baseScale!.z)
-            )
-            instMesh.setMatrixAt(stock._instanceIndex, _matrix)
-            needsUpdate = true
-          }
-        }
-        if (needsUpdate) {
-          instMesh.instanceMatrix.needsUpdate = true
-        }
-        if (hasFocused) {
-          self.component.invalidate()
-        }
-      }
-
-      this.object3d.add(instMesh)
-      this._instancedMesh = instMesh
-    }
-  }
-
-  createRackFrame(w: number, h: number, d: number): THREE.BufferGeometry {
-    const frameWeight = Math.round(Math.min(w, h) / 10)
-    const geometries = []
-
-    for (let i = 0; i < 4; i++) {
-      const geometry = Rack.rackFrameGeometry.clone()
-      geometry.scale(frameWeight, d, frameWeight)
-
-      switch (i) {
-        case 0:
-          geometry.translate(w / 2, 0, h / 2)
-          break
-        case 1:
-          geometry.translate(w / 2, 0, -h / 2)
-          break
-        case 2:
-          geometry.translate(-w / 2, 0, h / 2)
-          break
-        case 3:
-          geometry.translate(-w / 2, 0, -h / 2)
-          break
-      }
-
-      geometries.push(geometry)
-    }
-
-    return BufferGeometryUtils.mergeGeometries(geometries)
-  }
-
-  createRackBoards(
-    shelves: number,
-    width: number,
-    height: number,
-    depth: number,
-    shelfLocIds: string[]
-  ): THREE.BufferGeometry {
-    let bottom = -depth * shelves * 0.5
-    const geometries = []
-
-    for (let i = 1; i < shelves; i++) {
-      if (shelfLocIds[i] === '') {
-        continue
-      }
-
-      const geometry = Rack.boardGeometry.clone()
-
-      geometry.scale(width, height, 1)
-      geometry.rotateX(Math.PI / 2)
-      geometry.translate(0, bottom + depth * i, 0)
-
-      geometries.push(geometry)
-    }
-
-    return BufferGeometryUtils.mergeGeometries(geometries)
-  }
-
-  makeLocationString(shelfString: string) {
-    var { section = '', unit = '' } = this.component.state
-    var { locPattern = '{z}{s}-{u}-{sh}', zone = '' } = this.rackTable!.state
-
-    var locationString = locPattern
-
-    locationString = locationString.replace(/{z}/i, zone)
-    locationString = locationString.replace(/{s}/i, section)
-    locationString = locationString.replace(/{u}/i, unit)
-    locationString = locationString.replace(/{sh}/i, shelfString)
-
-    return locationString
-  }
-
-  makeShelfString(pattern: string, shelf: number, length: number) {
-    /**
-     *  pattern #: 숫자
-     *  pattern 0: 고정 자리수
-     *  pattern -: 역순
-     */
-
-    if (!pattern || !shelf || !length) return
-
-    var isReverse = /^\-/.test(pattern)
-    pattern = pattern.replace(/#+/, '#')
-
-    var fixedLength = (pattern.match(/0/g) || []).length || 0
-    var shelfString = String(isReverse ? length - shelf + 1 : shelf)
-
-    if (shelfString.length > fixedLength && fixedLength > 0) {
-      shelfString = shelfString.substring(shelfString.length - fixedLength)
-    } else {
-      var prefix = ''
-      for (var i = 0; i < fixedLength - shelfString.length; i++) {
-        prefix += '0'
-      }
-      shelfString = prefix + shelfString
-    }
-
-    return shelfString
-  }
-
-  updateAlpha() {}
-}

package/src/rack-grid-helpers.ts

@@ -1,77 +0,0 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- *
- * RackTable pure helpers — separated for unit-testability (no scene-base /
- * things-scene runtime deps).
- */
-
-/**
- * Parse shelf-labels string into an array of length `levels`.
- *
- * Format: comma-separated. Empty positions fall back to `String(level + 1)`.
- *   ',,,04' over 4 levels → ['1', '2', '3', '04']
- *   '1,2,3'  over 4 levels → ['1', '2', '3', '4']
- */
-export function parseShelfLabels(input: string | undefined, levels: number): string[] {
-  const out: string[] = []
-  const parts = (input || '').split(',')
-  for (let i = 0; i < levels; i++) {
-    const p = parts[i]
-    out[i] = p && p.trim().length > 0 ? p.trim() : String(i + 1)
-  }
-  return out
-}
-
-/**
- * Apply a location pattern with the four standard placeholders.
- *
- *   {z}  → zone
- *   {s}  → section (zero-padded outside)
- *   {u}  → unit (zero-padded outside)
- *   {sh} → shelf
- *
- * Caller is responsible for the zero-padding of section/unit (the digit
- * widths are state-driven, not part of the pattern itself).
- */
-export function formatLocationId(
-  zone: string,
-  section: string,
-  unit: string,
-  shelf: string,
-  pattern: string
-): string {
-  return pattern
-    .replace(/\{z\}/g, zone)
-    .replace(/\{s\}/g, section)
-    .replace(/\{u\}/g, unit)
-    .replace(/\{sh\}/g, shelf)
-}
-
-/**
- * Distribute `total` over `n` slots, honoring per-slot declared sizes when
- * present. Unspecified slots share the remaining space evenly.
- *
- *   distribute(1000, 4, [200, undefined, 300, undefined]) → [200, 250, 300, 250]
- *   distribute(1000, 4, []) → [250, 250, 250, 250]
- */
-export function distribute(total: number, n: number, declared: (number | undefined)[] = []): number[] {
-  const out: number[] = []
-  let assigned = 0
-  let auto = 0
-  for (let i = 0; i < n; i++) {
-    const v = declared[i]
-    if (typeof v === 'number' && Number.isFinite(v)) {
-      out[i] = v
-      assigned += v
-    } else {
-      out[i] = -1
-      auto++
-    }
-  }
-  const remaining = Math.max(0, total - assigned)
-  const autoSize = auto > 0 ? remaining / auto : 0
-  for (let i = 0; i < n; i++) {
-    if (out[i] === -1) out[i] = autoSize
-  }
-  return out
-}