@operato/scene-storage 10.0.0-beta.30 → 10.0.0-beta.31

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.0.0-beta.31](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.30...v10.0.0-beta.31) (2026-05-08)
+
+
+### :house: Code Refactoring
+
+* _realObject 캐스트 16개 제거 (Phase C Round 2 후속) ([8616c6c](https://github.com/things-scene/operato-scene/commit/8616c6c45e38a9bbcc244a77cee53479a756df85))
+* 39개 buildRealObject 캐스트 제거 (Phase D Round 4 후속) ([b86681c](https://github.com/things-scene/operato-scene/commit/b86681c07d7bf41cb93ade9855afb21902ed8186))
+* **mfg/transport/storage:** typed state Round 2 — 14개 컴포넌트 적용 ([f1765f6](https://github.com/things-scene/operato-scene/commit/f1765f62d12cf4c20ea26a2297e98069b9621a45))
+* 도메인 mixin 캐스트 추가 정리 7개 (Phase D Round 4 후속) ([1546b71](https://github.com/things-scene/operato-scene/commit/1546b7183969a38952872a5327b8329c2fa1ab7a))
+* 불필요한 (this as any) 캐스트 52개 제거 (Phase C) ([989dd11](https://github.com/things-scene/operato-scene/commit/989dd1147f4c768167fdc8b9a9e98acb0495a408))
+* 함수 인자 (this as any) 13개 제거 (Phase D Round 4 후속) ([b0a400c](https://github.com/things-scene/operato-scene/commit/b0a400c9716fdec22518cc6ad0bd1c1e69bda89d))
+
+
+
 ## [10.0.0-beta.30](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.29...v10.0.0-beta.30) (2026-05-07)
 
 

package/dist/asrs-crane.d.ts

@@ -1,6 +1,7 @@
 import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
-import type { SlotDef } from '@hatiolab/things-scene';
+import type { SlotDef, State, Material3D } from '@hatiolab/things-scene';
 import { type AttachFrame, type Alignment, type Heights, type LegendBinding, type MoveOptions, type PlacementArchetype } from '@operato/scene-base';
+import { AsrsCrane3D } from './asrs-crane-3d.js';
 /**
  * AsrsCrane status — the operating state of a stacker crane in an AS/RS aisle.
  *
@@ -12,6 +13,12 @@ import { type AttachFrame, type Alignment, type Heights, type LegendBinding, typ
  * - `error`      — fault / e-stop / collision warning
  */
 export type AsrsCraneStatus = 'idle' | 'moving' | 'loading' | 'unloading' | 'error';
+/** AsrsCrane 컴포넌트 state */
+export interface AsrsCraneState extends State {
+    status?: AsrsCraneStatus;
+    carriageHeight?: number;
+    material3d?: Material3D;
+}
 declare const AsrsCrane_base: any;
 /**
  * AsrsCrane — the stacker / retrieval crane that runs in the aisle of an
@@ -30,6 +37,8 @@ declare const AsrsCrane_base: any;
  * engage + reparent. During transit the carrier IS a child of the crane.
  */
 export default class AsrsCrane extends AsrsCrane_base {
+    state: AsrsCraneState;
+    _realObject?: AsrsCrane3D;
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/asrs-crane.js.map

@@ -1 +1 @@
-{"version":3,"file":"asrs-crane.js","sourceRoot":"","sources":["../src/asrs-crane.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, ContainerCapacity, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { SlotDef } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Legendable,\n  Mover,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type MoveOptions,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsCrane3D } from './asrs-crane-3d.js'\n\n/**\n * AsrsCrane status — the operating state of a stacker crane in an AS/RS aisle.\n *\n * - `idle`       — parked at home position\n * - `moving`     — translating along the aisle (horizontal) or along the\n *                  mast (vertical); the two motions are typically combined\n * - `loading`    — extracting a pallet from a rack cell\n * - `unloading`  — placing a pallet into a rack cell\n * - `error`      — fault / e-stop / collision warning\n */\nexport type AsrsCraneStatus = 'idle' | 'moving' | 'loading' | 'unloading' | 'error'\n\nconst BODY_LEGEND = {\n  idle: '#888',\n  moving: '#aabbcc',\n  loading: '#ffaa00',\n  unloading: '#ffaa00',\n  error: '#c66',\n  default: '#888'\n}\n\nconst LAMP_EMISSIVE_LEGEND = {\n  idle: '#222222',\n  moving: '#44ff44',\n  loading: '#ffaa00',\n  unloading: '#ffaa00',\n  error: '#ff3333',\n  default: '#222222'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'status',\n      name: 'status',\n      property: {\n        options: [\n          { display: 'Idle', value: 'idle' },\n          { display: 'Moving', value: 'moving' },\n          { display: 'Loading', value: 'loading' },\n          { display: 'Unloading', value: 'unloading' },\n          { display: 'Error', value: 'error' }\n        ]\n      }\n    },\n    {\n      type: 'number',\n      label: 'carriage-height',\n      name: 'carriageHeight',\n      placeholder: 'mm — height of carriage on mast'\n    }\n  ],\n  help: 'scene/component/asrs-crane'\n}\n\n// Mixin chain: Mover → CarrierHolder → ContainerCapacity → Legendable → Placeable → ContainerAbstract\n//\n//   Mover:             pick / place / pickAndPlace / moveTo / engage primitives\n//   CarrierHolder:     attachPointFor() — where the carrier sits on the crane (carriage fork)\n//   ContainerCapacity: receive() / dispatch() / canReceive() / slots — slot tracking +\n//                      TRANSFER_SLOT_KEY bookkeeping during transit\n//   Legendable:        status → bodyColor / lampEmissive colour mapping\n//   Placeable:         floor-archetype 3D positioning\n//   ContainerAbstract: child management — carrier becomes a child while in transit\n//\n// Note: ContainerAbstract replaces Shape. The 2D outline is drawn manually in\n// render() below (a simple top-down rectangle), matching the old Shape output\n// without the Shape base-class overhead.\n/**\n * AsrsCrane — the stacker / retrieval crane that runs in the aisle of an\n * AS/RS, moving cargo between the load port and the rack cells.\n *\n * Structure: a tall vertical mast that translates along a floor + ceiling\n * rail (the aisle), with a carriage that slides up/down the mast carrying a\n * shuttle / forks.\n *\n * **Monitoring mode**: crane status is driven by data binding\n * (`state.status`, `state.carriageHeight`). The carrier is referenced\n * via data binding — it is NOT a child of the crane in monitoring mode.\n *\n * **Simulation mode**: call `crane.pick(carrier)` / `crane.place(carrier, rackCell)`\n * (or `crane.pickAndPlace(carrier, rackCell)`). Mover handles navigation +\n * engage + reparent. During transit the carrier IS a child of the crane.\n */\n@sceneComponent('asrs-crane')\nexport default class AsrsCrane extends Mover(CarrierHolder(ContainerCapacity(Legendable(Placeable(ContainerAbstract))))) {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'status', legend: BODY_LEGEND },\n    lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  /** Yaw offset: crane model is drawn with the aisle axis along X (right = forward). */\n  static yawOffset = 0\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  // ── ContainerCapacity ─────────────────────────────────────────────────────\n\n  /** Stacker crane carries at most one load at a time on its forks. */\n  get slots(): SlotDef[] {\n    return [{ id: 'forks', maxCount: 1 }]\n  }\n\n  // ── CarrierHolder — attach frame (carriage fork position) ─────────────────\n\n  /**\n   * Return the 3D attach frame on the crane's carriage (fork tip).\n   * Carriers are attached here while the crane is in transit (pick phase).\n   *\n   * The AsrsCrane3D exposes `getCarriageFrame()` — a sub-Object3D that\n   * tracks the carriage height and sits at the fork TCP. If the 3D object\n   * isn't built yet (e.g. before scene initialization), fall back to the\n   * crane's own object3d centre.\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = (this as any)._realObject as AsrsCrane3D | undefined\n    const frame = ro?.getCarriageFrame?.()\n    if (frame) {\n      const carrierDepth = resolveCarrierDepth(carrier)\n      return { attach: frame, localPosition: { x: 0, y: carrierDepth / 2, z: 0 } }\n    }\n    const root = (this as any)._realObject?.object3d\n    if (!root) return null\n    return { attach: root }\n  }\n\n  // ── Mover overrides ───────────────────────────────────────────────────────\n\n  /**\n   * Domain-specific actuation between arrival and reparent.\n   *\n   * Simulation sequence for PICK:\n   *   1. Mover.pick() navigates crane to carrier position (moveTo).\n   *   2. engage('pick') → snap carriage height + status 'loading'.\n   *   3. Carrier is reparented to crane (becomes child).\n   *\n   * For now: set status and snap carriage height. A full ASRS simulation\n   * would tween the carriageHeight here (animate AsrsCrane3D).\n   *\n   * Status lifecycle:\n   *   idle → (moveTo running) → engage fires → loading/unloading → (reparent) → idle\n   * The 'moving' state is not set from Mover.moveTo() because TypeScript\n   * can't call super.moveTo() on an `: any`-typed mixin. WCS data binding\n   * sets 'moving' in monitoring mode; override pick()/place() to set it\n   * in full simulation environments.\n   */\n  async engage(\n    target: Component,\n    kind: 'pick' | 'place',\n    _options: MoveOptions = {}\n  ): Promise<void> {\n    if (kind === 'pick') {\n      this.setState({ status: 'loading' as AsrsCraneStatus })\n      const carrierY = resolveCarrierCenterY(target)\n      if (carrierY !== null) {\n        this.setState({ carriageHeight: carrierY })\n      }\n    } else {\n      this.setState({ status: 'unloading' as AsrsCraneStatus })\n    }\n    // In a full simulation: await carriage-motion tween here.\n  }\n\n  // ── Domain aliases ────────────────────────────────────────────────────────\n\n  /** Fetch a carrier from a rack cell (semantically = pick). */\n  fetch(carrier: Component, options?: MoveOptions): Promise<void> {\n    return (this as any).pick(carrier, options)\n  }\n\n  /** Deposit a carrier into a rack cell (semantically = place). */\n  deposit(carrier: Component, cell: Component, options?: MoveOptions): Promise<void> {\n    return (this as any).place(carrier, cell, options)\n  }\n\n  // ── 2D rendering ─────────────────────────────────────────────────────────\n\n  /**\n   * 2D — top-down rectangle showing the crane's footprint along the aisle.\n   * The crane is much taller than wide, so the 2D mark is small.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const fillColor = (this.state.bodyColor as string) || '#888'\n    ctx.save()\n    ctx.fillStyle = fillColor\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n    ctx.fill()\n    ctx.restore()\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsCrane3D(this as any)\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 resolveCarrierCenterY(c: Component): number | null {\n  const pos = (c as any).state\n  if (!pos) return null\n  // zPos is the 3D Y center of a Placeable component in things-scene\n  const zPos = numOr(pos.zPos, NaN)\n  if (!Number.isNaN(zPos)) return zPos\n  return null\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n"]}
+{"version":3,"file":"asrs-crane.js","sourceRoot":"","sources":["../src/asrs-crane.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, ContainerCapacity, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { SlotDef, State, Material3D } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Legendable,\n  Mover,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type MoveOptions,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsCrane3D } from './asrs-crane-3d.js'\n\n/**\n * AsrsCrane status — the operating state of a stacker crane in an AS/RS aisle.\n *\n * - `idle`       — parked at home position\n * - `moving`     — translating along the aisle (horizontal) or along the\n *                  mast (vertical); the two motions are typically combined\n * - `loading`    — extracting a pallet from a rack cell\n * - `unloading`  — placing a pallet into a rack cell\n * - `error`      — fault / e-stop / collision warning\n */\nexport type AsrsCraneStatus = 'idle' | 'moving' | 'loading' | 'unloading' | 'error'\n\n/** AsrsCrane 컴포넌트 state */\nexport interface AsrsCraneState extends State {\n  // ── 운영 상태 ──\n  status?: AsrsCraneStatus\n\n  // ── 액추에이터 ──\n  carriageHeight?: number\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst BODY_LEGEND = {\n  idle: '#888',\n  moving: '#aabbcc',\n  loading: '#ffaa00',\n  unloading: '#ffaa00',\n  error: '#c66',\n  default: '#888'\n}\n\nconst LAMP_EMISSIVE_LEGEND = {\n  idle: '#222222',\n  moving: '#44ff44',\n  loading: '#ffaa00',\n  unloading: '#ffaa00',\n  error: '#ff3333',\n  default: '#222222'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'status',\n      name: 'status',\n      property: {\n        options: [\n          { display: 'Idle', value: 'idle' },\n          { display: 'Moving', value: 'moving' },\n          { display: 'Loading', value: 'loading' },\n          { display: 'Unloading', value: 'unloading' },\n          { display: 'Error', value: 'error' }\n        ]\n      }\n    },\n    {\n      type: 'number',\n      label: 'carriage-height',\n      name: 'carriageHeight',\n      placeholder: 'mm — height of carriage on mast'\n    }\n  ],\n  help: 'scene/component/asrs-crane'\n}\n\n// Mixin chain: Mover → CarrierHolder → ContainerCapacity → Legendable → Placeable → ContainerAbstract\n//\n//   Mover:             pick / place / pickAndPlace / moveTo / engage primitives\n//   CarrierHolder:     attachPointFor() — where the carrier sits on the crane (carriage fork)\n//   ContainerCapacity: receive() / dispatch() / canReceive() / slots — slot tracking +\n//                      TRANSFER_SLOT_KEY bookkeeping during transit\n//   Legendable:        status → bodyColor / lampEmissive colour mapping\n//   Placeable:         floor-archetype 3D positioning\n//   ContainerAbstract: child management — carrier becomes a child while in transit\n//\n// Note: ContainerAbstract replaces Shape. The 2D outline is drawn manually in\n// render() below (a simple top-down rectangle), matching the old Shape output\n// without the Shape base-class overhead.\n/**\n * AsrsCrane — the stacker / retrieval crane that runs in the aisle of an\n * AS/RS, moving cargo between the load port and the rack cells.\n *\n * Structure: a tall vertical mast that translates along a floor + ceiling\n * rail (the aisle), with a carriage that slides up/down the mast carrying a\n * shuttle / forks.\n *\n * **Monitoring mode**: crane status is driven by data binding\n * (`state.status`, `state.carriageHeight`). The carrier is referenced\n * via data binding — it is NOT a child of the crane in monitoring mode.\n *\n * **Simulation mode**: call `crane.pick(carrier)` / `crane.place(carrier, rackCell)`\n * (or `crane.pickAndPlace(carrier, rackCell)`). Mover handles navigation +\n * engage + reparent. During transit the carrier IS a child of the crane.\n */\n@sceneComponent('asrs-crane')\nexport default class AsrsCrane extends Mover(CarrierHolder(ContainerCapacity(Legendable(Placeable(ContainerAbstract))))) {\n  declare state: AsrsCraneState\n  declare _realObject?: AsrsCrane3D\n\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'status', legend: BODY_LEGEND },\n    lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  /** Yaw offset: crane model is drawn with the aisle axis along X (right = forward). */\n  static yawOffset = 0\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  // ── ContainerCapacity ─────────────────────────────────────────────────────\n\n  /** Stacker crane carries at most one load at a time on its forks. */\n  get slots(): SlotDef[] {\n    return [{ id: 'forks', maxCount: 1 }]\n  }\n\n  // ── CarrierHolder — attach frame (carriage fork position) ─────────────────\n\n  /**\n   * Return the 3D attach frame on the crane's carriage (fork tip).\n   * Carriers are attached here while the crane is in transit (pick phase).\n   *\n   * The AsrsCrane3D exposes `getCarriageFrame()` — a sub-Object3D that\n   * tracks the carriage height and sits at the fork TCP. If the 3D object\n   * isn't built yet (e.g. before scene initialization), fall back to the\n   * crane's own object3d centre.\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = this._realObject\n    const frame = ro?.getCarriageFrame?.()\n    if (frame) {\n      const carrierDepth = resolveCarrierDepth(carrier)\n      return { attach: frame, localPosition: { x: 0, y: carrierDepth / 2, z: 0 } }\n    }\n    const root = this._realObject?.object3d\n    if (!root) return null\n    return { attach: root }\n  }\n\n  // ── Mover overrides ───────────────────────────────────────────────────────\n\n  /**\n   * Domain-specific actuation between arrival and reparent.\n   *\n   * Simulation sequence for PICK:\n   *   1. Mover.pick() navigates crane to carrier position (moveTo).\n   *   2. engage('pick') → snap carriage height + status 'loading'.\n   *   3. Carrier is reparented to crane (becomes child).\n   *\n   * For now: set status and snap carriage height. A full ASRS simulation\n   * would tween the carriageHeight here (animate AsrsCrane3D).\n   *\n   * Status lifecycle:\n   *   idle → (moveTo running) → engage fires → loading/unloading → (reparent) → idle\n   * The 'moving' state is not set from Mover.moveTo() because TypeScript\n   * can't call super.moveTo() on an `: any`-typed mixin. WCS data binding\n   * sets 'moving' in monitoring mode; override pick()/place() to set it\n   * in full simulation environments.\n   */\n  async engage(\n    target: Component,\n    kind: 'pick' | 'place',\n    _options: MoveOptions = {}\n  ): Promise<void> {\n    if (kind === 'pick') {\n      this.setState({ status: 'loading' as AsrsCraneStatus })\n      const carrierY = resolveCarrierCenterY(target)\n      if (carrierY !== null) {\n        this.setState({ carriageHeight: carrierY })\n      }\n    } else {\n      this.setState({ status: 'unloading' as AsrsCraneStatus })\n    }\n    // In a full simulation: await carriage-motion tween here.\n  }\n\n  // ── Domain aliases ────────────────────────────────────────────────────────\n\n  /** Fetch a carrier from a rack cell (semantically = pick). */\n  fetch(carrier: Component, options?: MoveOptions): Promise<void> {\n    return this.pick(carrier, options)\n  }\n\n  /** Deposit a carrier into a rack cell (semantically = place). */\n  deposit(carrier: Component, cell: Component, options?: MoveOptions): Promise<void> {\n    return this.place(carrier, cell, options)\n  }\n\n  // ── 2D rendering ─────────────────────────────────────────────────────────\n\n  /**\n   * 2D — top-down rectangle showing the crane's footprint along the aisle.\n   * The crane is much taller than wide, so the 2D mark is small.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const fillColor = (this.state.bodyColor as string) || '#888'\n    ctx.save()\n    ctx.fillStyle = fillColor\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n    ctx.fill()\n    ctx.restore()\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsCrane3D(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 resolveCarrierCenterY(c: Component): number | null {\n  const pos = (c as any).state\n  if (!pos) return null\n  // zPos is the 3D Y center of a Placeable component in things-scene\n  const zPos = numOr(pos.zPos, NaN)\n  if (!Number.isNaN(zPos)) return zPos\n  return null\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n"]}

package/dist/asrs-rack.d.ts

@@ -1,5 +1,13 @@
 import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { CellMap, type AttachFrame, type Alignment, type Heights, type PlacementArchetype } from '@operato/scene-base';
+/** AsrsRack 컴포넌트 state */
+export interface AsrsRackState extends State {
+    bays?: number;
+    levels?: number;
+    debugCells?: boolean;
+    material3d?: Material3D;
+}
 declare const AsrsRack_base: any;
 /**
  * AsrsRack — a multi-level high-bay storage rack, the structural backbone of
@@ -19,6 +27,7 @@ declare const AsrsRack_base: any;
  * **Placement**: `floor` archetype, full ceiling depth by default.
  */
 export default class AsrsRack extends AsrsRack_base {
+    state: AsrsRackState;
     static placement: PlacementArchetype;
     static align: Alignment;
     static defaultDepth: (h: Heights) => number;

package/dist/asrs-rack.js

@@ -100,8 +100,7 @@ let AsrsRack = class AsrsRack extends CellContainer(CarrierHolder(Placeable(Cont
         const existing = this.components ?? [];
         for (const child of [...existing]) {
             if (child.state?.type === 'rack-cell') {
-                ;
-                this.removeComponent?.(child);
+                this.removeComponent(child);
             }
         }
         // Create a RackCell for each cell in the map
@@ -120,7 +119,7 @@ let AsrsRack = class AsrsRack extends CellContainer(CarrierHolder(Placeable(Cont
                 depth: cell.size.height // 3D Y = level height
             };
             const rackCell = new RackCellClass(model, context);
-            this.addComponent?.(rackCell);
+            this.addComponent(rackCell);
         }
     }
     // ── Container gates ───────────────────────────────────────────────────────

package/dist/asrs-rack.js.map

@@ -1 +1 @@
-{"version":3,"file":"asrs-rack.js","sourceRoot":"","sources":["../src/asrs-rack.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  CellContainer,\n  CellMap,\n  CarrierHolder,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsRack3D } from './asrs-rack-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'number',\n      label: 'levels',\n      name: 'levels',\n      placeholder: '# of vertical levels (default 4)'\n    },\n    {\n      type: 'number',\n      label: 'bays',\n      name: 'bays',\n      placeholder: '# of horizontal bays (default 5)'\n    }\n  ],\n  help: 'scene/component/asrs-rack'\n}\n\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. ASRS rack lives only in the 3D scene graph.\n//\n// Mixin chain: CellContainer → CarrierHolder → Placeable → ContainerAbstract\n//   CellContainer: cell topology (cellMap, cell(), findAvailableCell(), occupiedCellIds())\n//   CarrierHolder: 3D attach-point protocol (attachPointFor, containable gates)\n//   Placeable:     floor-archetype positioning\n//   ContainerAbstract: child component management\n/**\n * AsrsRack — a multi-level high-bay storage rack, the structural backbone of\n * an AS/RS (Automated Storage / Retrieval System).\n *\n * `levels` × `bays` cells form a vertical grid. Each cell holds one logistics\n * package (Pallet / Box / Parcel). A pair of AsrsRacks separated by an aisle\n * (where an AsrsCrane runs) is the typical AS/RS configuration.\n *\n * **Monitoring mode** (default): pallets/boxes are direct children of the rack,\n * placed by the WCS data binding. No RackCell children are created.\n *\n * **Simulation mode**: call `rack._buildCells()` after placing the rack on the\n * scene. This creates RackCell children at the correct 3D positions. The\n * AsrsCrane then navigates to individual RackCells for pick-and-place.\n *\n * **Placement**: `floor` archetype, full ceiling depth by default.\n */\n@sceneComponent('asrs-rack')\nexport default class AsrsRack extends CellContainer(CarrierHolder(Placeable(ContainerAbstract))) {\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  // ── CellContainer ─────────────────────────────────────────────────────────\n\n  /**\n   * Derive the cell topology from the rack's current dimensions and bay/level\n   * counts. The CellMap is rebuilt fresh each time (state changes trigger\n   * re-reads via things-scene's invalidation pipeline).\n   *\n   * Coordinate convention (matches things-scene 3D):\n   *   X = bay axis  (left → right)\n   *   Y = level axis (floor → ceiling, the rack's `depth` state property)\n   *   Z = row axis   (front → back, the rack's `height` state property)\n   */\n  get cellMap(): CellMap {\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n    const levels = Math.max(1, Math.floor((this.state.levels as number) || 4))\n    const width = (this.state.width as number) || 1000\n    const rackDepth = (this.state.depth as number) || 3000   // Y: floor→ceiling\n    const rackHeight = (this.state.height as number) || 600  // Z: front→back\n\n    return CellMap.grid({\n      bays,\n      rows: 1,\n      levels,\n      bayWidth: width / bays,\n      rowDepth: rackHeight,\n      levelHeight: rackDepth / levels\n    })\n  }\n\n  /**\n   * Create RackCell child components for each cell in the CellMap.\n   *\n   * Called explicitly to enter simulation mode — monitoring-mode racks\n   * never call this (pallets are direct children, no explicit cells).\n   *\n   * Idempotent: removes existing rack-cell children first.\n   */\n  _buildCells(): void {\n    // Remove existing rack-cell children\n    const existing = ((this as any).components as Component[] | undefined) ?? []\n    for (const child of [...existing]) {\n      if ((child as any).state?.type === 'rack-cell') {\n        ;(this as any).removeComponent?.(child)\n      }\n    }\n\n    // Create a RackCell for each cell in the map\n    const RackCellClass = (Component as any).register('rack-cell') as (new (...args: any[]) => Component) | undefined\n    if (!RackCellClass) {\n      console.warn('AsrsRack._buildCells: rack-cell type not registered. Import rack-cell.ts first.')\n      return\n    }\n\n    const context = (this as any)._app\n    for (const cell of this.cellMap.cells) {\n      const model = {\n        type: 'rack-cell',\n        cellId: cell.id,\n        width: cell.size.width,\n        height: cell.size.depth,  // 2D height = 3D Z depth\n        depth: cell.size.height   // 3D Y = level height\n      }\n      const rackCell = new RackCellClass(model, context)\n      ;(this as any).addComponent?.(rackCell)\n    }\n  }\n\n  // ── Container gates ───────────────────────────────────────────────────────\n\n  /**\n   * Allow:\n   *   - Carriable components (pallets, boxes, parcels) — direct children in monitoring mode.\n   *   - RackCell — created by _buildCells() in simulation mode.\n   *\n   * Block:\n   *   - Everything else (sensors, labels, etc. can be siblings of the rack, not children).\n   */\n  containable(component: Component): boolean {\n    if ((component as any).state?.type === 'rack-cell') return true\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this as any)\n  }\n\n  // ── CarrierHolder — attach frame for direct carrier children ─────────────\n\n  /**\n   * Attach frame for carriers that are DIRECT children of the rack\n   * (monitoring mode, where pallets go directly into the rack without\n   * explicit RackCell components).\n   *\n   * In simulation mode, carriers become children of their RackCell,\n   * and each RackCell provides its own attachPointFor(). So this method\n   * is only invoked on direct-child carriers in monitoring mode — it\n   * returns the rack's own object3d as the attach frame (default behavior).\n   */\n  attachPointFor(_carrier: Component): AttachFrame | null {\n    const root = (this as any)._realObject?.object3d\n    if (!root) return null\n    return { attach: root }\n  }\n\n  // ── 2D rendering ─────────────────────────────────────────────────────────\n\n  /**\n   * 2D — top-down rectangle showing the rack footprint, with subdivisions\n   * suggesting the bay layout (lines parallel to the aisle).\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n\n    ctx.beginPath()\n    // Outer rectangle\n    ctx.rect(left, top, width, height)\n    // Bay subdivisions (vertical lines)\n    for (let i = 1; i < bays; i++) {\n      const x = left + (width * i) / bays\n      ctx.moveTo(x, top)\n      ctx.lineTo(x, top + height)\n    }\n  }\n\n  get fillStyle() {\n    return '#a0a0a8'\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsRack3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"asrs-rack.js","sourceRoot":"","sources":["../src/asrs-rack.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  CellContainer,\n  CellMap,\n  CarrierHolder,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsRack3D } from './asrs-rack-3d.js'\n\n/** AsrsRack 컴포넌트 state */\nexport interface AsrsRackState extends State {\n  // ── 토폴로지 ──\n  bays?: number\n  levels?: number\n\n  // ── 디버그 ──\n  debugCells?: boolean\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'number',\n      label: 'levels',\n      name: 'levels',\n      placeholder: '# of vertical levels (default 4)'\n    },\n    {\n      type: 'number',\n      label: 'bays',\n      name: 'bays',\n      placeholder: '# of horizontal bays (default 5)'\n    }\n  ],\n  help: 'scene/component/asrs-rack'\n}\n\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. ASRS rack lives only in the 3D scene graph.\n//\n// Mixin chain: CellContainer → CarrierHolder → Placeable → ContainerAbstract\n//   CellContainer: cell topology (cellMap, cell(), findAvailableCell(), occupiedCellIds())\n//   CarrierHolder: 3D attach-point protocol (attachPointFor, containable gates)\n//   Placeable:     floor-archetype positioning\n//   ContainerAbstract: child component management\n/**\n * AsrsRack — a multi-level high-bay storage rack, the structural backbone of\n * an AS/RS (Automated Storage / Retrieval System).\n *\n * `levels` × `bays` cells form a vertical grid. Each cell holds one logistics\n * package (Pallet / Box / Parcel). A pair of AsrsRacks separated by an aisle\n * (where an AsrsCrane runs) is the typical AS/RS configuration.\n *\n * **Monitoring mode** (default): pallets/boxes are direct children of the rack,\n * placed by the WCS data binding. No RackCell children are created.\n *\n * **Simulation mode**: call `rack._buildCells()` after placing the rack on the\n * scene. This creates RackCell children at the correct 3D positions. The\n * AsrsCrane then navigates to individual RackCells for pick-and-place.\n *\n * **Placement**: `floor` archetype, full ceiling depth by default.\n */\n@sceneComponent('asrs-rack')\nexport default class AsrsRack extends CellContainer(CarrierHolder(Placeable(ContainerAbstract))) {\n  declare state: AsrsRackState\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  // ── CellContainer ─────────────────────────────────────────────────────────\n\n  /**\n   * Derive the cell topology from the rack's current dimensions and bay/level\n   * counts. The CellMap is rebuilt fresh each time (state changes trigger\n   * re-reads via things-scene's invalidation pipeline).\n   *\n   * Coordinate convention (matches things-scene 3D):\n   *   X = bay axis  (left → right)\n   *   Y = level axis (floor → ceiling, the rack's `depth` state property)\n   *   Z = row axis   (front → back, the rack's `height` state property)\n   */\n  get cellMap(): CellMap {\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n    const levels = Math.max(1, Math.floor((this.state.levels as number) || 4))\n    const width = (this.state.width as number) || 1000\n    const rackDepth = (this.state.depth as number) || 3000   // Y: floor→ceiling\n    const rackHeight = (this.state.height as number) || 600  // Z: front→back\n\n    return CellMap.grid({\n      bays,\n      rows: 1,\n      levels,\n      bayWidth: width / bays,\n      rowDepth: rackHeight,\n      levelHeight: rackDepth / levels\n    })\n  }\n\n  /**\n   * Create RackCell child components for each cell in the CellMap.\n   *\n   * Called explicitly to enter simulation mode — monitoring-mode racks\n   * never call this (pallets are direct children, no explicit cells).\n   *\n   * Idempotent: removes existing rack-cell children first.\n   */\n  _buildCells(): void {\n    // Remove existing rack-cell children\n    const existing = (this.components as Component[] | undefined) ?? []\n    for (const child of [...existing]) {\n      if ((child as any).state?.type === 'rack-cell') {\n        this.removeComponent(child)\n      }\n    }\n\n    // Create a RackCell for each cell in the map\n    const RackCellClass = (Component as any).register('rack-cell') as (new (...args: any[]) => Component) | undefined\n    if (!RackCellClass) {\n      console.warn('AsrsRack._buildCells: rack-cell type not registered. Import rack-cell.ts first.')\n      return\n    }\n\n    const context = this._app\n    for (const cell of this.cellMap.cells) {\n      const model = {\n        type: 'rack-cell',\n        cellId: cell.id,\n        width: cell.size.width,\n        height: cell.size.depth,  // 2D height = 3D Z depth\n        depth: cell.size.height   // 3D Y = level height\n      }\n      const rackCell = new RackCellClass(model, context)\n      this.addComponent(rackCell)\n    }\n  }\n\n  // ── Container gates ───────────────────────────────────────────────────────\n\n  /**\n   * Allow:\n   *   - Carriable components (pallets, boxes, parcels) — direct children in monitoring mode.\n   *   - RackCell — created by _buildCells() in simulation mode.\n   *\n   * Block:\n   *   - Everything else (sensors, labels, etc. can be siblings of the rack, not children).\n   */\n  containable(component: Component): boolean {\n    if ((component as any).state?.type === 'rack-cell') return true\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this)\n  }\n\n  // ── CarrierHolder — attach frame for direct carrier children ─────────────\n\n  /**\n   * Attach frame for carriers that are DIRECT children of the rack\n   * (monitoring mode, where pallets go directly into the rack without\n   * explicit RackCell components).\n   *\n   * In simulation mode, carriers become children of their RackCell,\n   * and each RackCell provides its own attachPointFor(). So this method\n   * is only invoked on direct-child carriers in monitoring mode — it\n   * returns the rack's own object3d as the attach frame (default behavior).\n   */\n  attachPointFor(_carrier: Component): AttachFrame | null {\n    const root = this._realObject?.object3d\n    if (!root) return null\n    return { attach: root }\n  }\n\n  // ── 2D rendering ─────────────────────────────────────────────────────────\n\n  /**\n   * 2D — top-down rectangle showing the rack footprint, with subdivisions\n   * suggesting the bay layout (lines parallel to the aisle).\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n\n    ctx.beginPath()\n    // Outer rectangle\n    ctx.rect(left, top, width, height)\n    // Bay subdivisions (vertical lines)\n    for (let i = 1; i < bays; i++) {\n      const x = left + (width * i) / bays\n      ctx.moveTo(x, top)\n      ctx.lineTo(x, top + height)\n    }\n  }\n\n  get fillStyle() {\n    return '#a0a0a8'\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsRack3D(this)\n  }\n}\n"]}

package/dist/box.d.ts

@@ -1,4 +1,5 @@
 import { ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { type Alignment, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
 /**
  * Box material — drives 3D structure and color.
@@ -12,6 +13,11 @@ import { type Alignment, type LegendBinding, type PlacementArchetype } from '@op
  * different proportions, taping, and labels that warrant a distinct class.
  */
 export type BoxMaterial = 'wood' | 'plastic';
+/** Box 컴포넌트 state */
+export interface BoxState extends State {
+    material?: BoxMaterial;
+    material3d?: Material3D;
+}
 declare const Box_base: any;
 /**
  * Box — a generic stackable container for goods. Wood crate or plastic tote
@@ -22,6 +28,7 @@ declare const Box_base: any;
  * scene-tree). If a future use case needs nested boxes, extend Container.
  */
 export default class Box extends Box_base {
+    state: BoxState;
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/box.js.map

@@ -1 +1 @@
-{"version":3,"file":"box.js","sourceRoot":"","sources":["../src/box.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA+B,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EAIV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAenC,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;oBAClC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;iBACzC;aACF;SACF;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAA;AAED,6EAA6E;AAC7E,kDAAkD;AAClD;;;;;;;GAOG;AAEY,IAAM,GAAG,GAAT,MAAM,GAAI,SAAQ,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE;KACrD,CAAA;IAED,MAAM,CAAC,SAAS,GAAuB,WAAW,CAAA;IAClD,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAA;IAEzB,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAQ,IAAI,CAAC,KAAK,CAAC,SAAoB,IAAI,SAAS,CAAA;IACtD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,KAAK,CAAC,IAAW,CAAC,CAAA;IAC/B,CAAC;;AA9BkB,GAAG;IADvB,cAAc,CAAC,KAAK,CAAC;GACD,GAAG,CA+BvB;eA/BoB,GAAG","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { ComponentNature, RealObject, RectPath, Shape, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Legendable,\n  Placeable,\n  type Alignment,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Box3D } from './box-3d.js'\n\n/**\n * Box material — drives 3D structure and color.\n *\n * - `wood`     — wood crate: visible vertical slats, gaps between, open or\n *                semi-open top. Used for heavy / industrial parts.\n * - `plastic`  — plastic tote / bin: solid molded walls with stackable lip\n *                at top. Used for fulfillment, parts kitting.\n *\n * Cardboard parcels are a separate component (see `parcel.ts`) — they have\n * different proportions, taping, and labels that warrant a distinct class.\n */\nexport type BoxMaterial = 'wood' | 'plastic'\n\nconst BODY_LEGEND = {\n  wood: '#a87644',\n  plastic: '#3a5078',\n  default: '#a87644'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'material',\n      name: 'material',\n      property: {\n        options: [\n          { display: 'Wood', value: 'wood' },\n          { display: 'Plastic', value: 'plastic' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/box'\n}\n\n// Carriable: a box can be a child of any CarrierHolder (Pallet for stacking,\n// AGV deck, robot-arm gripper, Spot for staging).\n/**\n * Box — a generic stackable container for goods. Wood crate or plastic tote\n * variants distinguished by `material` prop.\n *\n * Shape-based (not Container) — boxes nesting other components is rare in\n * logistics visualization (a *case* of items inside a box is data, not\n * scene-tree). If a future use case needs nested boxes, extend Container.\n */\n@sceneComponent('box')\nexport default class Box extends Carriable(Legendable(Placeable(RectPath(Shape)))) {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'material', legend: BODY_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 300\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** 2D — top-down rectangle. */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  get fillStyle() {\n    return (this.state.bodyColor as string) || '#a87644'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Box3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../src/box.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA+B,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAErG,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EAIV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAwBnC,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;oBAClC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;iBACzC;aACF;SACF;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAA;AAED,6EAA6E;AAC7E,kDAAkD;AAClD;;;;;;;GAOG;AAEY,IAAM,GAAG,GAAT,MAAM,GAAI,SAAQ,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAGhF,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE;KACrD,CAAA;IAED,MAAM,CAAC,SAAS,GAAuB,WAAW,CAAA;IAClD,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAA;IAEzB,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAQ,IAAI,CAAC,KAAK,CAAC,SAAoB,IAAI,SAAS,CAAA;IACtD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;;AAhCkB,GAAG;IADvB,cAAc,CAAC,KAAK,CAAC;GACD,GAAG,CAiCvB;eAjCoB,GAAG","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { ComponentNature, RealObject, RectPath, Shape, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Legendable,\n  Placeable,\n  type Alignment,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Box3D } from './box-3d.js'\n\n/**\n * Box material — drives 3D structure and color.\n *\n * - `wood`     — wood crate: visible vertical slats, gaps between, open or\n *                semi-open top. Used for heavy / industrial parts.\n * - `plastic`  — plastic tote / bin: solid molded walls with stackable lip\n *                at top. Used for fulfillment, parts kitting.\n *\n * Cardboard parcels are a separate component (see `parcel.ts`) — they have\n * different proportions, taping, and labels that warrant a distinct class.\n */\nexport type BoxMaterial = 'wood' | 'plastic'\n\n/** Box 컴포넌트 state */\nexport interface BoxState extends State {\n  // ── 외관 ──\n  material?: BoxMaterial\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst BODY_LEGEND = {\n  wood: '#a87644',\n  plastic: '#3a5078',\n  default: '#a87644'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'material',\n      name: 'material',\n      property: {\n        options: [\n          { display: 'Wood', value: 'wood' },\n          { display: 'Plastic', value: 'plastic' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/box'\n}\n\n// Carriable: a box can be a child of any CarrierHolder (Pallet for stacking,\n// AGV deck, robot-arm gripper, Spot for staging).\n/**\n * Box — a generic stackable container for goods. Wood crate or plastic tote\n * variants distinguished by `material` prop.\n *\n * Shape-based (not Container) — boxes nesting other components is rare in\n * logistics visualization (a *case* of items inside a box is data, not\n * scene-tree). If a future use case needs nested boxes, extend Container.\n */\n@sceneComponent('box')\nexport default class Box extends Carriable(Legendable(Placeable(RectPath(Shape)))) {\n  declare state: BoxState\n\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'material', legend: BODY_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 300\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** 2D — top-down rectangle. */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  get fillStyle() {\n    return (this.state.bodyColor as string) || '#a87644'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Box3D(this)\n  }\n}\n"]}

package/dist/generic-container-3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic-container-3d.js","sourceRoot":"","sources":["../src/generic-container-3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAC1C,SAAS,CAAC,IAAS;QAC3B,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACrB,IAAI,CAAC,eAAe,EAAE,CAAA;IACxB,CAAC;IAEO,eAAe;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAY,CAAA;QACzC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAC7D,CAAC;IAED,QAAQ,CAAC,KAA8B,EAAE,MAA+B;QACtE,IAAI,gBAAgB,IAAI,KAAK,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,EAAE,CAAA;YACtB,OAAM;QACR,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC/B,CAAC;CACF","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * GenericContainer3D — RealObjectGLTF 상속, 보관소 (Stocker / Buffer / Rack 류) 의 3D 표현.\n *\n * 상속 체인:\n *   RealObjectGroup → RealObjectExternalModel → RealObjectGLTF → GenericContainer3D\n *\n * 재사용:\n *   - GLB load (`_loadExternal` + 캐시)\n *   - node index (`getNode`, `nodeNames`)\n *   - 노드 상태 매핑 (`nodes` state → color/visible/opacity)\n *   - 애니메이션 (`animations` / `playTargets`)\n *   - top-view 스냅샷 (2D 렌더용)\n *   - dispose / clear\n *\n * 추가:\n *   - actuator (state 값 → 노드 transform). rack 의 lift, shutter 열림 등 동적 표현.\n *\n * GenericTransport3D 와 차이: mount / cargo reparent 미사용 (cargo holder 가 아니라 placeholder\n * 단계의 정적 보관소). cargo 보유는 사용자가 구체 type 으로 변환 후에 부여.\n */\n\nimport { RealObjectGLTF } from '@hatiolab/things-scene'\nimport { applyActuators } from '@operato/scene-base'\n\nexport class GenericContainer3D extends RealObjectGLTF {\n  protected _onLoaded(gltf: any) {\n    super._onLoaded(gltf)\n    this._applyActuators()\n  }\n\n  private _applyActuators() {\n    const state = this.component.state as any\n    applyActuators(this, state.actuators, state.actuatorValues)\n  }\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if ('actuatorValues' in after || 'actuators' in after) {\n      this._applyActuators()\n      return\n    }\n    super.onchange(after, before)\n  }\n}\n"]}
+{"version":3,"file":"generic-container-3d.js","sourceRoot":"","sources":["../src/generic-container-3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IAC1C,SAAS,CAAC,IAAS;QAC3B,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACrB,IAAI,CAAC,eAAe,EAAE,CAAA;IACxB,CAAC;IAEO,eAAe;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAA;QAClC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;IAC7D,CAAC;IAED,QAAQ,CAAC,KAA8B,EAAE,MAA+B;QACtE,IAAI,gBAAgB,IAAI,KAAK,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,EAAE,CAAA;YACtB,OAAM;QACR,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC/B,CAAC;CACF","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * GenericContainer3D — RealObjectGLTF 상속, 보관소 (Stocker / Buffer / Rack 류) 의 3D 표현.\n *\n * 상속 체인:\n *   RealObjectGroup → RealObjectExternalModel → RealObjectGLTF → GenericContainer3D\n *\n * 재사용:\n *   - GLB load (`_loadExternal` + 캐시)\n *   - node index (`getNode`, `nodeNames`)\n *   - 노드 상태 매핑 (`nodes` state → color/visible/opacity)\n *   - 애니메이션 (`animations` / `playTargets`)\n *   - top-view 스냅샷 (2D 렌더용)\n *   - dispose / clear\n *\n * 추가:\n *   - actuator (state 값 → 노드 transform). rack 의 lift, shutter 열림 등 동적 표현.\n *\n * GenericTransport3D 와 차이: mount / cargo reparent 미사용 (cargo holder 가 아니라 placeholder\n * 단계의 정적 보관소). cargo 보유는 사용자가 구체 type 으로 변환 후에 부여.\n */\n\nimport { RealObjectGLTF } from '@hatiolab/things-scene'\nimport { applyActuators } from '@operato/scene-base'\n\nexport class GenericContainer3D extends RealObjectGLTF {\n  protected _onLoaded(gltf: any) {\n    super._onLoaded(gltf)\n    this._applyActuators()\n  }\n\n  private _applyActuators() {\n    const state = this.component.state\n    applyActuators(this, state.actuators, state.actuatorValues)\n  }\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if ('actuatorValues' in after || 'actuators' in after) {\n      this._applyActuators()\n      return\n    }\n    super.onchange(after, before)\n  }\n}\n"]}

package/dist/generic-container.d.ts

@@ -1,10 +1,20 @@
 import { Component, ComponentNature } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { type Alignment, type Heights, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
 import { GenericContainer3D } from './generic-container-3d.js';
 import type { ActuatorDef } from '@operato/scene-base';
 export type ContainerStatus = 'empty' | 'partial' | 'full' | 'error';
+export type ContainerFill = ContainerStatus;
+/** GenericContainer 컴포넌트 state */
+export interface GenericContainerState extends State {
+    fill?: ContainerFill;
+    actuators?: Record<string, ActuatorDef>;
+    actuatorValues?: Record<string, number>;
+    material3d?: Material3D;
+}
 declare const GenericContainer_base: any;
 export default class GenericContainer extends GenericContainer_base {
+    state: GenericContainerState;
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/generic-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic-container.js","sourceRoot":"","sources":["../src/generic-container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAEH,OAAO,EAGL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,UAAU,EACV,SAAS,EAKV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAK9D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV,GAAG,oBAAoB;QACvB;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;oBACpC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;oBACxC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;oBAClC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;iBACrC;aACF;SACF;KACF;IACD,IAAI,EAAE,mCAAmC;CAC1C,CAAA;AAED,2EAA2E;AAC3E,4BAA4B;AAEb,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACnG,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE;QAChD,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE;KAC7D,CAAA;IAED,MAAM,CAAC,SAAS,GAAuB,OAAO,CAAA;IAC9C,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAA;IAE3D,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,SAAS;QACX,OAAS,IAAI,CAAC,KAAa,CAAC,SAAqD,IAAI,EAAE,CAAA;IACzF,CAAC;IAED,IAAI,cAAc;QAChB,OAAS,IAAI,CAAC,KAAa,CAAC,cAAqD,IAAI,EAAE,CAAA;IACzF,CAAC;IAED,WAAW,CAAC,SAAoB;QAC9B,OAAO,SAAS,CAAC,aAAa,CAAC,IAAW,CAAC,CAAA;IAC7C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,kBAAkB,CAAC,IAAW,CAAC,CAAA;IAC5C,CAAC;;AAhCkB,gBAAgB;IADpC,cAAc,CAAC,WAAW,CAAC;GACP,gBAAgB,CAiCpC;eAjCoB,gBAAgB","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * GenericContainer — GLB 모델 기반 범용 보관소 컴포넌트.\n *\n * 합성 구조:\n *   GltfComponent  (things-scene)        — GLB 컨벤션 (src, 2D 스냅샷, ratioLock,\n *                                          gltf-* 에디터, RealObjectGLTF)\n *   ⊕ ContainerAbstract (things-scene)  — 자식 보유 (DOM-free 컨테이너)\n *   ⊕ Placeable    (scene-base)          — floor placement, depth=operation\n *   ⊕ Legendable   (scene-base)          — fill 별 bodyColor / lampEmissive\n *\n * 추가 (이 클래스 고유):\n *   - state.actuators / actuatorValues — 동적 노드 transform (rack lift, shutter 열림 등)\n *\n * 동일 컴포넌트 하나로 stocker / buffer / shelf / rack 모두 표현 가능 — 각 보관소별로\n * 다른 GLB + 다른 actuator 매핑만 다름.\n *\n * GenericTransport / GenericFacility 와의 차이:\n *   - cargo holder 가 아님 — 사용자가 구체 type (e.g. AsrsRack) 으로 변환 후에 cargo 부여\n *   - container 카테고리 (정적 보관소). 분류는 동일 floor placement 지만 의미는 다름\n *\n * board-import 의 categoryFallback 에서 container 카테고리의 default placeholder. 사용자가\n * 모델러에서 src 부착하거나 type 변경으로 도메인 type (Stocker / Buffer / AsrsRack 등) 으로 변환.\n */\n\nimport {\n  Component,\n  ComponentNature,\n  ContainerAbstract,\n  GltfComponent,\n  gltfNatureProperties,\n  sceneComponent\n} from '@hatiolab/things-scene'\nimport {\n  Legendable,\n  Placeable,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { GenericContainer3D } from './generic-container-3d.js'\nimport type { ActuatorDef } from '@operato/scene-base'\n\nexport type ContainerStatus = 'empty' | 'partial' | 'full' | 'error'\n\nconst BODY_LEGEND = {\n  empty: '#a8b8c4',\n  partial: '#7d96b0',\n  full: '#5a7c9a',\n  error: '#e9746b',\n  default: '#a8b8c4'\n}\n\nconst LAMP_EMISSIVE_LEGEND = {\n  empty: '#222222',\n  partial: '#3388cc',\n  full: '#2266aa',\n  error: '#ff3333',\n  default: '#222222'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    ...gltfNatureProperties,\n    {\n      type: 'select',\n      label: 'fill',\n      name: 'fill',\n      property: {\n        options: [\n          { display: 'Empty', value: 'empty' },\n          { display: 'Partial', value: 'partial' },\n          { display: 'Full', value: 'full' },\n          { display: 'Error', value: 'error' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/generic-container'\n}\n\n// 합성 순서: 안쪽부터 → ContainerAbstract → Placeable → Legendable → GltfComponent\n// (GenericFacility 와 동일 패턴)\n@sceneComponent('container')\nexport default class GenericContainer extends GltfComponent(Legendable(Placeable(ContainerAbstract))) {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'fill', legend: BODY_LEGEND },\n    lampEmissive: { from: 'fill', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.operation - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  get actuators(): Record<string, ActuatorDef> {\n    return ((this.state as any).actuators as Record<string, ActuatorDef> | undefined) ?? {}\n  }\n\n  get actuatorValues(): Record<string, number> {\n    return ((this.state as any).actuatorValues as Record<string, number> | undefined) ?? {}\n  }\n\n  containable(component: Component): boolean {\n    return component.isDescendible(this as any)\n  }\n\n  buildRealObject() {\n    return new GenericContainer3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"generic-container.js","sourceRoot":"","sources":["../src/generic-container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAEH,OAAO,EAGL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,UAAU,EACV,SAAS,EAKV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAmB9D,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV,GAAG,oBAAoB;QACvB;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;oBACpC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;oBACxC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;oBAClC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;iBACrC;aACF;SACF;KACF;IACD,IAAI,EAAE,mCAAmC;CAC1C,CAAA;AAED,2EAA2E;AAC3E,4BAA4B;AAEb,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAGnG,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE;QAChD,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE;KAC7D,CAAA;IAED,MAAM,CAAC,SAAS,GAAuB,OAAO,CAAA;IAC9C,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAA;IAE3D,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAA;IACnC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAA;IACxC,CAAC;IAED,WAAW,CAAC,SAAoB;QAC9B,OAAO,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;;AAlCkB,gBAAgB;IADpC,cAAc,CAAC,WAAW,CAAC;GACP,gBAAgB,CAmCpC;eAnCoB,gBAAgB","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * GenericContainer — GLB 모델 기반 범용 보관소 컴포넌트.\n *\n * 합성 구조:\n *   GltfComponent  (things-scene)        — GLB 컨벤션 (src, 2D 스냅샷, ratioLock,\n *                                          gltf-* 에디터, RealObjectGLTF)\n *   ⊕ ContainerAbstract (things-scene)  — 자식 보유 (DOM-free 컨테이너)\n *   ⊕ Placeable    (scene-base)          — floor placement, depth=operation\n *   ⊕ Legendable   (scene-base)          — fill 별 bodyColor / lampEmissive\n *\n * 추가 (이 클래스 고유):\n *   - state.actuators / actuatorValues — 동적 노드 transform (rack lift, shutter 열림 등)\n *\n * 동일 컴포넌트 하나로 stocker / buffer / shelf / rack 모두 표현 가능 — 각 보관소별로\n * 다른 GLB + 다른 actuator 매핑만 다름.\n *\n * GenericTransport / GenericFacility 와의 차이:\n *   - cargo holder 가 아님 — 사용자가 구체 type (e.g. AsrsRack) 으로 변환 후에 cargo 부여\n *   - container 카테고리 (정적 보관소). 분류는 동일 floor placement 지만 의미는 다름\n *\n * board-import 의 categoryFallback 에서 container 카테고리의 default placeholder. 사용자가\n * 모델러에서 src 부착하거나 type 변경으로 도메인 type (Stocker / Buffer / AsrsRack 등) 으로 변환.\n */\n\nimport {\n  Component,\n  ComponentNature,\n  ContainerAbstract,\n  GltfComponent,\n  gltfNatureProperties,\n  sceneComponent\n} from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  Legendable,\n  Placeable,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { GenericContainer3D } from './generic-container-3d.js'\nimport type { ActuatorDef } from '@operato/scene-base'\n\nexport type ContainerStatus = 'empty' | 'partial' | 'full' | 'error'\nexport type ContainerFill = ContainerStatus\n\n/** GenericContainer 컴포넌트 state */\nexport interface GenericContainerState extends State {\n  // ── 운영 상태 ──\n  fill?: ContainerFill\n\n  // ── GLB 동적 노드 ──\n  actuators?: Record<string, ActuatorDef>\n  actuatorValues?: Record<string, number>\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst BODY_LEGEND = {\n  empty: '#a8b8c4',\n  partial: '#7d96b0',\n  full: '#5a7c9a',\n  error: '#e9746b',\n  default: '#a8b8c4'\n}\n\nconst LAMP_EMISSIVE_LEGEND = {\n  empty: '#222222',\n  partial: '#3388cc',\n  full: '#2266aa',\n  error: '#ff3333',\n  default: '#222222'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    ...gltfNatureProperties,\n    {\n      type: 'select',\n      label: 'fill',\n      name: 'fill',\n      property: {\n        options: [\n          { display: 'Empty', value: 'empty' },\n          { display: 'Partial', value: 'partial' },\n          { display: 'Full', value: 'full' },\n          { display: 'Error', value: 'error' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/generic-container'\n}\n\n// 합성 순서: 안쪽부터 → ContainerAbstract → Placeable → Legendable → GltfComponent\n// (GenericFacility 와 동일 패턴)\n@sceneComponent('container')\nexport default class GenericContainer extends GltfComponent(Legendable(Placeable(ContainerAbstract))) {\n  declare state: GenericContainerState\n\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'fill', legend: BODY_LEGEND },\n    lampEmissive: { from: 'fill', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.operation - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  get actuators(): Record<string, ActuatorDef> {\n    return this.state.actuators ?? {}\n  }\n\n  get actuatorValues(): Record<string, number> {\n    return this.state.actuatorValues ?? {}\n  }\n\n  containable(component: Component): boolean {\n    return component.isDescendible(this)\n  }\n\n  buildRealObject() {\n    return new GenericContainer3D(this)\n  }\n}\n"]}

package/dist/pallet.d.ts

@@ -1,4 +1,5 @@
 import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { type Alignment, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
 /**
  * Pallet material — drives both 2D fill color and 3D structure.
@@ -12,6 +13,11 @@ import { type Alignment, type LegendBinding, type PlacementArchetype } from '@op
  * legend + a 3D variant in pallet-3d.ts.
  */
 export type PalletMaterial = 'wood' | 'plastic';
+/** Pallet 컴포넌트 state */
+export interface PalletState extends State {
+    material?: PalletMaterial;
+    material3d?: Material3D;
+}
 declare const Pallet_base: any;
 /**
  * Pallet — a flat transport structure that goods are stacked and stored on.
@@ -40,6 +46,7 @@ declare const Pallet_base: any;
  * detection.
  */
 export default class Pallet extends Pallet_base {
+    state: PalletState;
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/pallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"pallet.js","sourceRoot":"","sources":["../src/pallet.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Legendable,\n  Placeable,\n  type Alignment,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Pallet3D } from './pallet-3d.js'\n\n/**\n * Pallet material — drives both 2D fill color and 3D structure.\n *\n * - `wood`     — traditional EUR / EPAL pallet: parallel slats on top and\n *                bottom, three perpendicular stringers between them.\n * - `plastic`  — molded one-piece pallet: solid top deck with cutouts,\n *                hollow underside with feet. Distinct ribbed underside.\n *\n * Adding a third material (e.g. metal, composite) is a one-line change to the\n * legend + a 3D variant in pallet-3d.ts.\n */\nexport type PalletMaterial = 'wood' | 'plastic'\n\nconst BODY_LEGEND = {\n  wood: '#a87644',\n  plastic: '#5a6a78',\n  default: '#a87644'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'material',\n      name: 'material',\n      property: {\n        options: [\n          { display: 'Wood', value: 'wood' },\n          { display: 'Plastic', value: 'plastic' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/pallet'\n}\n\n// Carriable: a pallet can sit on AGV / Forklift / robot-arm gripper / Spot\n// and also accept boxes / parcels as children (ContainerAbstract base\n// provides the child-container behavior; Carriable only adds the\n// holder-mount hook).\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Pallet renders only as a 3D mesh.\n/**\n * Pallet — a flat transport structure that goods are stacked and stored on.\n *\n * Standard EUR pallet is 1200 × 800mm × 144mm; we don't enforce these\n * dimensions but they're a good starting point for the catalog templates.\n *\n * **Container-based.** Boxes / parcels stacked on the pallet are added as\n * children — same `containable()` archetype-filter pattern as Forklift / Agv.\n * Visual stacking (children rendering on top of the pallet rather than at\n * absolute operation level) is a v2 concern; see ARCHITECTURE NOTES below.\n *\n * **Placement = `operation`.** A pallet's *normal* state is loaded and in\n * transit on a conveyor / AGV / forklift fork — at operation level. Empty\n * pallets in a floor-storage area are an exceptional state where the user\n * sets `state.zPos = 0` explicitly. Default to the common case.\n *\n * ## ARCHITECTURE NOTES — visual stacking\n *\n * When a Box (also `placement: 'operation'`) is added as a child of a\n * Pallet, both default to z = operation_height. They overlap visually\n * rather than the box sitting on top of the pallet. Solving this cleanly\n * (parent-relative z derivation when the parent is a structural carrier)\n * is a follow-up — fmsim's pattern is to detect parent type at render time\n * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the\n * detection.\n */\n@sceneComponent('pallet')\nexport default class Pallet extends Carriable(Legendable(Placeable(ContainerAbstract))) {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'material', legend: BODY_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 150 // EUR pallet is 144mm; 150 is the round number convention\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** Accept other operation-archetype cargo (boxes, parcels, smaller pallets) as stacked children. */\n  containable(component: Component) {\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this as any)\n  }\n\n  /**\n   * 2D — top-down silhouette. Body is a flat rectangle (wood/plastic deck);\n   * `postrender()` adds the deck pattern + edge stroke so the pallet reads\n   * as a pallet instead of a featureless rectangle.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  /**\n   * Deck pattern + edge stroke. Wood: parallel slats with darker grooves\n   * between (typical EUR pallet deck). Plastic: cross-cutout pattern\n   * suggesting the molded reinforcement ribs.\n   *\n   * Slats run along the *short* axis of the rectangle (= along the longer\n   * stringer direction in real life), so a 1200×800 pallet shows multiple\n   * narrow slats across the 1200mm dimension — matching the EUR layout.\n   */\n  postrender(ctx: CanvasRenderingContext2D) {\n    super.postrender?.(ctx)\n\n    const { width, height, left, top } = this.state\n    const isPlastic = ((this.state as any).material as PalletMaterial) === 'plastic'\n\n    ctx.save()\n\n    if (!isPlastic) {\n      // Wood — slats. Run them along the longer axis so the grooves are\n      // perpendicular to the longer side (typical pallet appearance).\n      const longAxisHorizontal = width >= height\n      const slatCount = 5\n      const grooveColor = '#7a4f25'\n      ctx.fillStyle = grooveColor\n      if (longAxisHorizontal) {\n        // grooves vertical (X direction across the width)\n        const grooveW = Math.max(1, width * 0.012)\n        const slatW = (width - grooveW * (slatCount - 1)) / slatCount\n        for (let i = 1; i < slatCount; i++) {\n          const x = left + i * slatW + (i - 1) * grooveW\n          ctx.fillRect(x, top + height * 0.05, grooveW, height * 0.9)\n        }\n      } else {\n        const grooveH = Math.max(1, height * 0.012)\n        const slatH = (height - grooveH * (slatCount - 1)) / slatCount\n        for (let i = 1; i < slatCount; i++) {\n          const y = top + i * slatH + (i - 1) * grooveH\n          ctx.fillRect(left + width * 0.05, y, width * 0.9, grooveH)\n        }\n      }\n    } else {\n      // Plastic — cross + corner cutouts hint\n      ctx.strokeStyle = '#3a4956'\n      ctx.lineWidth = Math.max(1, Math.min(width, height) * 0.012)\n      ctx.beginPath()\n      ctx.moveTo(left + width * 0.5, top + height * 0.1)\n      ctx.lineTo(left + width * 0.5, top + height * 0.9)\n      ctx.moveTo(left + width * 0.1, top + height * 0.5)\n      ctx.lineTo(left + width * 0.9, top + height * 0.5)\n      ctx.stroke()\n    }\n\n    // Edge stroke\n    ctx.strokeStyle = isPlastic ? '#2a3946' : '#5e3818'\n    ctx.lineWidth = 1\n    ctx.strokeRect(left, top, width, height)\n\n    ctx.restore()\n  }\n\n  get fillStyle() {\n    return (this.state.bodyColor as string) || '#a87644'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Pallet3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"pallet.js","sourceRoot":"","sources":["../src/pallet.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Legendable,\n  Placeable,\n  type Alignment,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Pallet3D } from './pallet-3d.js'\n\n/**\n * Pallet material — drives both 2D fill color and 3D structure.\n *\n * - `wood`     — traditional EUR / EPAL pallet: parallel slats on top and\n *                bottom, three perpendicular stringers between them.\n * - `plastic`  — molded one-piece pallet: solid top deck with cutouts,\n *                hollow underside with feet. Distinct ribbed underside.\n *\n * Adding a third material (e.g. metal, composite) is a one-line change to the\n * legend + a 3D variant in pallet-3d.ts.\n */\nexport type PalletMaterial = 'wood' | 'plastic'\n\n/** Pallet 컴포넌트 state */\nexport interface PalletState extends State {\n  // ── 외관 ──\n  material?: PalletMaterial\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst BODY_LEGEND = {\n  wood: '#a87644',\n  plastic: '#5a6a78',\n  default: '#a87644'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'material',\n      name: 'material',\n      property: {\n        options: [\n          { display: 'Wood', value: 'wood' },\n          { display: 'Plastic', value: 'plastic' }\n        ]\n      }\n    }\n  ],\n  help: 'scene/component/pallet'\n}\n\n// Carriable: a pallet can sit on AGV / Forklift / robot-arm gripper / Spot\n// and also accept boxes / parcels as children (ContainerAbstract base\n// provides the child-container behavior; Carriable only adds the\n// holder-mount hook).\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Pallet renders only as a 3D mesh.\n/**\n * Pallet — a flat transport structure that goods are stacked and stored on.\n *\n * Standard EUR pallet is 1200 × 800mm × 144mm; we don't enforce these\n * dimensions but they're a good starting point for the catalog templates.\n *\n * **Container-based.** Boxes / parcels stacked on the pallet are added as\n * children — same `containable()` archetype-filter pattern as Forklift / Agv.\n * Visual stacking (children rendering on top of the pallet rather than at\n * absolute operation level) is a v2 concern; see ARCHITECTURE NOTES below.\n *\n * **Placement = `operation`.** A pallet's *normal* state is loaded and in\n * transit on a conveyor / AGV / forklift fork — at operation level. Empty\n * pallets in a floor-storage area are an exceptional state where the user\n * sets `state.zPos = 0` explicitly. Default to the common case.\n *\n * ## ARCHITECTURE NOTES — visual stacking\n *\n * When a Box (also `placement: 'operation'`) is added as a child of a\n * Pallet, both default to z = operation_height. They overlap visually\n * rather than the box sitting on top of the pallet. Solving this cleanly\n * (parent-relative z derivation when the parent is a structural carrier)\n * is a follow-up — fmsim's pattern is to detect parent type at render time\n * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the\n * detection.\n */\n@sceneComponent('pallet')\nexport default class Pallet extends Carriable(Legendable(Placeable(ContainerAbstract))) {\n  declare state: PalletState\n\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'material', legend: BODY_LEGEND }\n  }\n\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 150 // EUR pallet is 144mm; 150 is the round number convention\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** Accept other operation-archetype cargo (boxes, parcels, smaller pallets) as stacked children. */\n  containable(component: Component) {\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this)\n  }\n\n  /**\n   * 2D — top-down silhouette. Body is a flat rectangle (wood/plastic deck);\n   * `postrender()` adds the deck pattern + edge stroke so the pallet reads\n   * as a pallet instead of a featureless rectangle.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  /**\n   * Deck pattern + edge stroke. Wood: parallel slats with darker grooves\n   * between (typical EUR pallet deck). Plastic: cross-cutout pattern\n   * suggesting the molded reinforcement ribs.\n   *\n   * Slats run along the *short* axis of the rectangle (= along the longer\n   * stringer direction in real life), so a 1200×800 pallet shows multiple\n   * narrow slats across the 1200mm dimension — matching the EUR layout.\n   */\n  postrender(ctx: CanvasRenderingContext2D) {\n    super.postrender?.(ctx)\n\n    const { width, height, left, top } = this.state\n    const isPlastic = this.state.material === 'plastic'\n\n    ctx.save()\n\n    if (!isPlastic) {\n      // Wood — slats. Run them along the longer axis so the grooves are\n      // perpendicular to the longer side (typical pallet appearance).\n      const longAxisHorizontal = width >= height\n      const slatCount = 5\n      const grooveColor = '#7a4f25'\n      ctx.fillStyle = grooveColor\n      if (longAxisHorizontal) {\n        // grooves vertical (X direction across the width)\n        const grooveW = Math.max(1, width * 0.012)\n        const slatW = (width - grooveW * (slatCount - 1)) / slatCount\n        for (let i = 1; i < slatCount; i++) {\n          const x = left + i * slatW + (i - 1) * grooveW\n          ctx.fillRect(x, top + height * 0.05, grooveW, height * 0.9)\n        }\n      } else {\n        const grooveH = Math.max(1, height * 0.012)\n        const slatH = (height - grooveH * (slatCount - 1)) / slatCount\n        for (let i = 1; i < slatCount; i++) {\n          const y = top + i * slatH + (i - 1) * grooveH\n          ctx.fillRect(left + width * 0.05, y, width * 0.9, grooveH)\n        }\n      }\n    } else {\n      // Plastic — cross + corner cutouts hint\n      ctx.strokeStyle = '#3a4956'\n      ctx.lineWidth = Math.max(1, Math.min(width, height) * 0.012)\n      ctx.beginPath()\n      ctx.moveTo(left + width * 0.5, top + height * 0.1)\n      ctx.lineTo(left + width * 0.5, top + height * 0.9)\n      ctx.moveTo(left + width * 0.1, top + height * 0.5)\n      ctx.lineTo(left + width * 0.9, top + height * 0.5)\n      ctx.stroke()\n    }\n\n    // Edge stroke\n    ctx.strokeStyle = isPlastic ? '#2a3946' : '#5e3818'\n    ctx.lineWidth = 1\n    ctx.strokeRect(left, top, width, height)\n\n    ctx.restore()\n  }\n\n  get fillStyle() {\n    return (this.state.bodyColor as string) || '#a87644'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Pallet3D(this)\n  }\n}\n"]}

package/dist/parcel.d.ts

@@ -1,5 +1,11 @@
 import { ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { type Alignment, type PlacementArchetype } from '@operato/scene-base';
+/** Parcel 컴포넌트 state */
+export interface ParcelState extends State {
+    trackingId?: string;
+    material3d?: Material3D;
+}
 declare const Parcel_base: any;
 /**
  * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.
@@ -17,6 +23,7 @@ declare const Parcel_base: any;
  * inspected indicators would add a status legend then.
  */
 export default class Parcel extends Parcel_base {
+    state: ParcelState;
     static placement: PlacementArchetype;
     static align: Alignment;
     static defaultDepth: number;

package/dist/parcel.js.map

@@ -1 +1 @@
-{"version":3,"file":"parcel.js","sourceRoot":"","sources":["../src/parcel.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA+B,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,EACL,SAAS,EACT,SAAS,EAGV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,YAAY;SACnB;KACF;IACD,IAAI,EAAE,wBAAwB;CAC/B,CAAA;AAED,yEAAyE;AACzE,uEAAuE;AACvE,oDAAoD;AACpD;;;;;;;;;;;;;;GAcG;AAEY,IAAM,MAAM,GAAZ,MAAM,MAAO,SAAQ,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,CAAC,SAAS,GAAuB,WAAW,CAAA;IAClD,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAA;IAEzB,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,QAAQ,CAAC,IAAW,CAAC,CAAA;IAClC,CAAC;;AA1BkB,MAAM;IAD1B,cAAc,CAAC,QAAQ,CAAC;GACJ,MAAM,CA2B1B;eA3BoB,MAAM","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { ComponentNature, RealObject, RectPath, Shape, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Placeable,\n  type Alignment,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Parcel3D } from './parcel-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'string',\n      label: 'tracking-id',\n      name: 'trackingId'\n    }\n  ],\n  help: 'scene/component/parcel'\n}\n\n// Carriable: parcel can be a child of any CarrierHolder (Spot, robot-arm\n// gripper, AGV deck, …). Mixin wraps add() so the parcel's 3D object3d\n// is reattached to the holder's chosen mount frame.\n/**\n * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.\n *\n * Distinct from `Box` because parcels have:\n *   - cardboard appearance (tan/brown corrugate, not wood / plastic)\n *   - tape line down the center (the visual signature that says \"package\")\n *   - typically a label on top (where shipping info goes)\n *   - flatter / more elongated proportions in real-world parcel networks\n *\n * No `material` prop — parcels are always cardboard. If a future shipping\n * domain needs metal cases or polybags, those become separate components.\n *\n * No Legendable for v1 — parcel color is fixed cardboard. Future damaged /\n * inspected indicators would add a status legend then.\n */\n@sceneComponent('parcel')\nexport default class Parcel extends Carriable(Placeable(RectPath(Shape))) {\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 150\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** 2D — top-down rectangle in cardboard tan. */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  get fillStyle() {\n    return '#c8a878'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Parcel3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"parcel.js","sourceRoot":"","sources":["../src/parcel.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA+B,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAErG,OAAO,EACL,SAAS,EACT,SAAS,EAGV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAWzC,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,UAAU,EAAE;QACV;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,YAAY;SACnB;KACF;IACD,IAAI,EAAE,wBAAwB;CAC/B,CAAA;AAED,yEAAyE;AACzE,uEAAuE;AACvE,oDAAoD;AACpD;;;;;;;;;;;;;;GAcG;AAEY,IAAM,MAAM,GAAZ,MAAM,MAAO,SAAQ,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAGvE,MAAM,CAAC,SAAS,GAAuB,WAAW,CAAA;IAClD,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAA;IAEzB,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,gDAAgD;IAChD,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;;AA5BkB,MAAM;IAD1B,cAAc,CAAC,QAAQ,CAAC;GACJ,MAAM,CA6B1B;eA7BoB,MAAM","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { ComponentNature, RealObject, RectPath, Shape, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  Carriable,\n  Placeable,\n  type Alignment,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Parcel3D } from './parcel-3d.js'\n\n/** Parcel 컴포넌트 state */\nexport interface ParcelState extends State {\n  // ── 정체 ──\n  trackingId?: string\n\n  // ── 3D 재질 ──\n  material3d?: Material3D\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'string',\n      label: 'tracking-id',\n      name: 'trackingId'\n    }\n  ],\n  help: 'scene/component/parcel'\n}\n\n// Carriable: parcel can be a child of any CarrierHolder (Spot, robot-arm\n// gripper, AGV deck, …). Mixin wraps add() so the parcel's 3D object3d\n// is reattached to the holder's chosen mount frame.\n/**\n * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.\n *\n * Distinct from `Box` because parcels have:\n *   - cardboard appearance (tan/brown corrugate, not wood / plastic)\n *   - tape line down the center (the visual signature that says \"package\")\n *   - typically a label on top (where shipping info goes)\n *   - flatter / more elongated proportions in real-world parcel networks\n *\n * No `material` prop — parcels are always cardboard. If a future shipping\n * domain needs metal cases or polybags, those become separate components.\n *\n * No Legendable for v1 — parcel color is fixed cardboard. Future damaged /\n * inspected indicators would add a status legend then.\n */\n@sceneComponent('parcel')\nexport default class Parcel extends Carriable(Placeable(RectPath(Shape))) {\n  declare state: ParcelState\n\n  static placement: PlacementArchetype = 'operation'\n  static align: Alignment = 'bottom'\n  static defaultDepth = 150\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** 2D — top-down rectangle in cardboard tan. */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n  }\n\n  get fillStyle() {\n    return '#c8a878'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Parcel3D(this)\n  }\n}\n"]}

package/dist/rack-cell-3d.js

@@ -50,7 +50,7 @@ export class RackCell3D extends RealObjectGroup {
         const rack = this.component.parent;
         if (!rack?.cellMap)
             return;
-        const cellId = this.component.state?.cellId;
+        const cellId = this.component.state.cellId;
         if (!cellId)
             return;
         const cell = rack.cellMap.findById(cellId);

package/dist/rack-cell-3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"rack-cell-3d.js","sourceRoot":"","sources":["../src/rack-cell-3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,OAAO,UAAW,SAAQ,eAAe;IAC7C,KAAK;QACH,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,IAAI,CAAC,sBAAsB,EAAE,CAAA;IAC/B,CAAC;IAED,eAAe;QACb,qEAAqE;IACvE,CAAC;IAED,eAAe;QACb,IAAI,CAAC,sBAAsB,EAAE,CAAA;IAC/B,CAAC;IAED,WAAW;QACT,qCAAqC;IACvC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,sBAAsB;QACpB,MAAM,IAAI,GAAI,IAAI,CAAC,SAAiB,CAAC,MAAM,CAAA;QAC3C,IAAI,CAAC,IAAI,EAAE,OAAO;YAAE,OAAM;QAE1B,MAAM,MAAM,GAAI,IAAI,CAAC,SAAiB,CAAC,KAAK,EAAE,MAA4B,CAAA;QAC1E,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAY,CAAA;QAC5B,MAAM,SAAS,GAAI,EAAE,EAAE,KAAgB,IAAI,IAAI,CAAA;QAC/C,MAAM,SAAS,GAAI,EAAE,EAAE,KAAgB,IAAI,IAAI,CAAA,CAAG,8BAA8B;QAChF,MAAM,UAAU,GAAI,EAAE,EAAE,MAAiB,IAAI,GAAG,CAAA,CAAE,sCAAsC;QACxF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,CAAC,CAAA;QAEd,MAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAA;QACjC,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAA;QACtC,MAAM,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAA;QAElC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAA;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAA;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,GAAG,UAAU,GAAG,CAAC,CAAA;QAEhE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAEzC,qEAAqE;QACrE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAK,IAAI,CAAC,KAAa,EAAE,UAAU,EAAE,CAAC;YAC7E,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAEO,SAAS,CAAqB;IAE9B,YAAY,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAClD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAC1B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QAC/D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC,YAAY,CACrC,KAAK,EACL,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAClF,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACnC,CAAC;CACF","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * RackCell 3D — invisible anchor group positioned at the cell's location\n * within the parent rack's 3D coordinate space.\n *\n * RackCell has no geometry of its own. Its sole 3D purpose is to provide\n * an Object3D that carriers can be attached to (via Three.js `.attach()`),\n * placed at the exact cell position within the rack. The position is derived\n * from the parent AsrsRack's CellMap (by cellId), not from 2D state fields —\n * rack cells occupy 3D levels that have no 2D analogue.\n *\n * updateTransform() override: things-scene's standard updateTransform\n * reads `component.center` (2D) and flattens it to 3D. For rack cells this\n * is wrong — we need the 3D cell position (bay x, level y, row z) from the\n * parent rack. So we override and read it directly from the CellMap.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nexport class RackCell3D extends RealObjectGroup {\n  build() {\n    super.build()\n    this._repositionFromCellMap()\n  }\n\n  updateDimension() {\n    // intentional no-op — size comes from the cell definition, not state\n  }\n\n  updateTransform() {\n    this._repositionFromCellMap()\n  }\n\n  updateAlpha() {\n    // invisible — no materials to update\n  }\n\n  /**\n   * Position this group at the cell's localPosition within the rack's 3D space.\n   *\n   * CellMap.grid() places cell origins at:\n   *   x = b * bayWidth,  y = l * levelHeight,  z = r * rowDepth\n   * (starting from 0,0,0 at the rack's bottom-left-front corner).\n   *\n   * The rack's object3d is centered: X spans [-width/2, +width/2],\n   * Y spans [-depth/2, +depth/2], Z spans [-height/2, +height/2].\n   *\n   * So the cell centre in rack-local 3D space:\n   *   x3d = cellPos.x + bayWidth/2   - width/2\n   *   y3d = cellPos.y + levelHeight/2 - rackDepth/2\n   *   z3d = cellPos.z + rowDepth/2   - rackHeight/2\n   */\n  _repositionFromCellMap() {\n    const rack = (this.component as any).parent\n    if (!rack?.cellMap) return\n\n    const cellId = (this.component as any).state?.cellId as string | undefined\n    if (!cellId) return\n\n    const cell = rack.cellMap.findById(cellId)\n    if (!cell) return\n\n    const rs = rack.state as any\n    const rackWidth = (rs?.width as number) || 1000\n    const rackDepth = (rs?.depth as number) || 3000   // Y dimension (floor→ceiling)\n    const rackHeight = (rs?.height as number) || 600  // Z dimension (front→back, 2D height)\n    const bays = Math.max(1, Math.floor(rs?.bays || 5))\n    const levels = Math.max(1, Math.floor(rs?.levels || 4))\n    const rows = 1\n\n    const bayWidth = rackWidth / bays\n    const levelHeight = rackDepth / levels\n    const rowDepth = rackHeight / rows\n\n    const x3d = cell.localPosition.x + bayWidth / 2 - rackWidth / 2\n    const y3d = cell.localPosition.y + levelHeight / 2 - rackDepth / 2\n    const z3d = cell.localPosition.z + rowDepth / 2 - rackHeight / 2\n\n    this.object3d.position.set(x3d, y3d, z3d)\n\n    // Optionally visualise cells in debug mode (outline box, very faint)\n    if (process.env.NODE_ENV !== 'production' && (rack.state as any)?.debugCells) {\n      this._addDebugBox(bayWidth, levelHeight, rowDepth)\n    }\n  }\n\n  private _debugBox?: THREE.LineSegments\n\n  private _addDebugBox(w: number, h: number, d: number) {\n    if (this._debugBox) return\n    const geo = new THREE.BoxGeometry(w * 0.98, h * 0.98, d * 0.98)\n    const edges = new THREE.EdgesGeometry(geo)\n    this._debugBox = new THREE.LineSegments(\n      edges,\n      new THREE.LineBasicMaterial({ color: 0x00ff88, transparent: true, opacity: 0.2 })\n    )\n    this.object3d.add(this._debugBox)\n  }\n}\n"]}
+{"version":3,"file":"rack-cell-3d.js","sourceRoot":"","sources":["../src/rack-cell-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * RackCell 3D — invisible anchor group positioned at the cell's location\n * within the parent rack's 3D coordinate space.\n *\n * RackCell has no geometry of its own. Its sole 3D purpose is to provide\n * an Object3D that carriers can be attached to (via Three.js `.attach()`),\n * placed at the exact cell position within the rack. The position is derived\n * from the parent AsrsRack's CellMap (by cellId), not from 2D state fields —\n * rack cells occupy 3D levels that have no 2D analogue.\n *\n * updateTransform() override: things-scene's standard updateTransform\n * reads `component.center` (2D) and flattens it to 3D. For rack cells this\n * is wrong — we need the 3D cell position (bay x, level y, row z) from the\n * parent rack. So we override and read it directly from the CellMap.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nexport class RackCell3D extends RealObjectGroup {\n  build() {\n    super.build()\n    this._repositionFromCellMap()\n  }\n\n  updateDimension() {\n    // intentional no-op — size comes from the cell definition, not state\n  }\n\n  updateTransform() {\n    this._repositionFromCellMap()\n  }\n\n  updateAlpha() {\n    // invisible — no materials to update\n  }\n\n  /**\n   * Position this group at the cell's localPosition within the rack's 3D space.\n   *\n   * CellMap.grid() places cell origins at:\n   *   x = b * bayWidth,  y = l * levelHeight,  z = r * rowDepth\n   * (starting from 0,0,0 at the rack's bottom-left-front corner).\n   *\n   * The rack's object3d is centered: X spans [-width/2, +width/2],\n   * Y spans [-depth/2, +depth/2], Z spans [-height/2, +height/2].\n   *\n   * So the cell centre in rack-local 3D space:\n   *   x3d = cellPos.x + bayWidth/2   - width/2\n   *   y3d = cellPos.y + levelHeight/2 - rackDepth/2\n   *   z3d = cellPos.z + rowDepth/2   - rackHeight/2\n   */\n  _repositionFromCellMap() {\n    const rack = (this.component as any).parent\n    if (!rack?.cellMap) return\n\n    const cellId = this.component.state.cellId as string | undefined\n    if (!cellId) return\n\n    const cell = rack.cellMap.findById(cellId)\n    if (!cell) return\n\n    const rs = rack.state as any\n    const rackWidth = (rs?.width as number) || 1000\n    const rackDepth = (rs?.depth as number) || 3000   // Y dimension (floor→ceiling)\n    const rackHeight = (rs?.height as number) || 600  // Z dimension (front→back, 2D height)\n    const bays = Math.max(1, Math.floor(rs?.bays || 5))\n    const levels = Math.max(1, Math.floor(rs?.levels || 4))\n    const rows = 1\n\n    const bayWidth = rackWidth / bays\n    const levelHeight = rackDepth / levels\n    const rowDepth = rackHeight / rows\n\n    const x3d = cell.localPosition.x + bayWidth / 2 - rackWidth / 2\n    const y3d = cell.localPosition.y + levelHeight / 2 - rackDepth / 2\n    const z3d = cell.localPosition.z + rowDepth / 2 - rackHeight / 2\n\n    this.object3d.position.set(x3d, y3d, z3d)\n\n    // Optionally visualise cells in debug mode (outline box, very faint)\n    if (process.env.NODE_ENV !== 'production' && (rack.state as any)?.debugCells) {\n      this._addDebugBox(bayWidth, levelHeight, rowDepth)\n    }\n  }\n\n  private _debugBox?: THREE.LineSegments\n\n  private _addDebugBox(w: number, h: number, d: number) {\n    if (this._debugBox) return\n    const geo = new THREE.BoxGeometry(w * 0.98, h * 0.98, d * 0.98)\n    const edges = new THREE.EdgesGeometry(geo)\n    this._debugBox = new THREE.LineSegments(\n      edges,\n      new THREE.LineBasicMaterial({ color: 0x00ff88, transparent: true, opacity: 0.2 })\n    )\n    this.object3d.add(this._debugBox)\n  }\n}\n"]}

package/dist/rack-cell.d.ts

@@ -1,4 +1,5 @@
 import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import type { State, Material3D } from '@hatiolab/things-scene';
 import { type AttachFrame } from '@operato/scene-base';
 /**
  * How many carriers a cell can hold simultaneously.
@@ -7,6 +8,12 @@ import { type AttachFrame } from '@operato/scene-base';
  * - bulk:   unlimited (e.g. a floor area measured in slots)
  */
 export type RackCellType = 'single' | 'multi' | 'bulk';
+/** RackCell 컴포넌트 state */
+export interface RackCellState extends State {
+    cellId?: string;
+    cellType?: RackCellType;
+    material3d?: Material3D;
+}
 declare const RackCell_base: any;
 /**
  * RackCell — single-slot storage cell inside an AsrsRack.
@@ -20,6 +27,7 @@ declare const RackCell_base: any;
  * 2D→3D coordinate mapping which cannot express 3D levels.
  */
 export default class RackCell extends RackCell_base {
+    state: RackCellState;
     get cellId(): string;
     get cellType(): RackCellType;
     /** Maximum carrier count for this cell based on cellType. */

package/dist/rack-cell.js

@@ -67,10 +67,10 @@ const NATURE = {
 let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
     // ── Identification ────────────────────────────────────────────────────────
     get cellId() {
-        return this.state.cellId || '';
+        return this.state.cellId ?? '';
     }
     get cellType() {
-        return (this.state.cellType || 'single');
+        return this.state.cellType ?? 'single';
     }
     /** Maximum carrier count for this cell based on cellType. */
     get capacity() {
@@ -100,8 +100,7 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
      */
     async receive(carrier, options = {}) {
         if (!this.canReceive(carrier)) {
-            ;
-            this.trigger?.('transfer-rejected', {
+            this.trigger('transfer-rejected', {
                 type: 'transfer-rejected',
                 component: carrier,
                 container: this,
@@ -110,8 +109,8 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
             return;
         }
         carrier[TRANSFER_SLOT_KEY] = this.cellId;
-        this.reparent?.(carrier, options);
-        this.trigger?.('transfer-received', {
+        this.reparent(carrier, options);
+        this.trigger('transfer-received', {
             type: 'transfer-received',
             component: carrier,
             container: this,
@@ -124,8 +123,7 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
      */
     async dispatch(carrier, target, options = {}) {
         if (target?.canReceive && !target.canReceive(carrier)) {
-            ;
-            this.trigger?.('transfer-rejected', {
+            this.trigger('transfer-rejected', {
                 type: 'transfer-rejected',
                 component: carrier,
                 container: this,
@@ -141,8 +139,7 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
             ;
             target.reparent?.(carrier, options);
         }
-        ;
-        this.trigger?.('transfer-dispatched', {
+        this.trigger('transfer-dispatched', {
             type: 'transfer-dispatched',
             component: carrier,
             container: this,