@operato/scene-storage 10.0.0-beta.38 → 10.0.0-beta.41

package/dist/parcel.js

@@ -59,9 +59,10 @@ let Parcel = class Parcel extends Carriable(Placeable(RectPath(Shape))) {
         return new Parcel3D(this);
     }
     /**
-     * Phase H — pickup contract. Parcel 은 위에서 vacuum gripper / suction cup 으로
-     * 집기 — Box 와 동일한 패턴이지만 cardboard 표면이라 더 큰 흡착 면 필요.
-     * tolerance 도 약간 완화 (cardboard 변형 가능성).
+     * Phase H — pickup contract. Parcel 의 pickup 방식:
+     *   - gripper (vacuum / suction): 위에서 흡착 — RobotArm
+     *   - agv-deck: AGV/Forklift 의 deck 위에 위에서 얹기 — 같은 top approach 지만
+     *     deck 자체가 운반체라 tolerance 더 완화
      */
     pickupFrames() {
         const wp = getWorldPose(this);
@@ -74,11 +75,29 @@ let Parcel = class Parcel extends Carriable(Placeable(RectPath(Shape))) {
             topApproachFrame({
                 carrierWorld: me,
                 topY: parcelDepth,
-                approachDistance: 80, // gripper hover 거리 (Box 보다 더 — vacuum 펼침)
+                approachDistance: 80,
                 toolType: 'gripper',
-                tolerance: { positionMm: 10, angleDeg: 2 }, // cardboard 변형 감안
+                tolerance: { positionMm: 10, angleDeg: 2 },
                 priority: 0,
                 id: 'top-suction'
+            }),
+            topApproachFrame({
+                carrierWorld: me,
+                topY: parcelDepth,
+                approachDistance: 60,
+                toolType: 'agv-deck',
+                tolerance: { positionMm: 20, angleDeg: 5 },
+                priority: 1,
+                id: 'top-deck'
+            }),
+            topApproachFrame({
+                carrierWorld: me,
+                topY: parcelDepth,
+                approachDistance: 100, // crane fork 가 cell 진입 hover
+                toolType: 'forklift-fork',
+                tolerance: { positionMm: 30, angleDeg: 5 }, // fork 적재 tolerance
+                priority: 2, // gripper/deck 다음
+                id: 'top-fork'
             })
         ];
     }

package/dist/parcel.js.map

@@ -1 +1 @@
-{"version":3,"file":"parcel.js","sourceRoot":"","sources":["../src/parcel.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAGL,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACf,MAAM,wBAAwB,CAAA;AAE/B,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;IAED;;;;OAIG;IACH,YAAY;QACV,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,EAAE,GAAmB;YACzB,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE;YAClE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE;SACrF,CAAA;QACD,MAAM,WAAW,GAAI,IAAI,CAAC,WAAmB,CAAC,YAAY,IAAI,GAAG,CAAA;QAEjE,OAAO;YACL,gBAAgB,CAAC;gBACf,YAAY,EAAE,EAAE;gBAChB,IAAI,EAAE,WAAW;gBACjB,gBAAgB,EAAE,EAAE,EAAa,0CAA0C;gBAC3E,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAG,kBAAkB;gBAC/D,QAAQ,EAAE,CAAC;gBACX,EAAE,EAAE,aAAa;aAClB,CAAC;SACH,CAAA;IACH,CAAC;;AAtDkB,MAAM;IAD1B,cAAc,CAAC,QAAQ,CAAC;GACJ,MAAM,CAuD1B;eAvDoB,MAAM","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport {\n  ComponentNature,\n  RealObject,\n  RectPath,\n  Shape,\n  topApproachFrame,\n  getWorldPose,\n  sceneComponent\n} from '@hatiolab/things-scene'\nimport type { State, Material3D, PickupFrame, PoseSerialized } 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  /**\n   * Phase H — pickup contract. Parcel 은 위에서 vacuum gripper / suction cup 으로\n   * 집기 — Box 와 동일한 패턴이지만 cardboard 표면이라 더 큰 흡착 면 필요.\n   * tolerance 도 약간 완화 (cardboard 변형 가능성).\n   */\n  pickupFrames(): PickupFrame[] {\n    const wp = getWorldPose(this)\n    const me: PoseSerialized = {\n      position: { x: wp.position.x, y: wp.position.y, z: wp.position.z },\n      rotation: { x: wp.rotation.x, y: wp.rotation.y, z: wp.rotation.z, w: wp.rotation.w }\n    }\n    const parcelDepth = (this.constructor as any).defaultDepth ?? 150\n\n    return [\n      topApproachFrame({\n        carrierWorld: me,\n        topY: parcelDepth,\n        approachDistance: 80,            // gripper hover 거리 (Box 보다 더 — vacuum 펼침)\n        toolType: 'gripper',\n        tolerance: { positionMm: 10, angleDeg: 2 },  // cardboard 변형 감안\n        priority: 0,\n        id: 'top-suction'\n      })\n    ]\n  }\n}\n"]}
+{"version":3,"file":"parcel.js","sourceRoot":"","sources":["../src/parcel.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport {\n  ComponentNature,\n  RealObject,\n  RectPath,\n  Shape,\n  topApproachFrame,\n  getWorldPose,\n  sceneComponent\n} from '@hatiolab/things-scene'\nimport type { State, Material3D, PickupFrame, PoseSerialized } 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  /**\n   * Phase H — pickup contract. Parcel 의 pickup 방식:\n   *   - gripper (vacuum / suction): 위에서 흡착 — RobotArm\n   *   - agv-deck: AGV/Forklift 의 deck 위에 위에서 얹기 — 같은 top approach 지만\n   *     deck 자체가 운반체라 tolerance 더 완화\n   */\n  pickupFrames(): PickupFrame[] {\n    const wp = getWorldPose(this)\n    const me: PoseSerialized = {\n      position: { x: wp.position.x, y: wp.position.y, z: wp.position.z },\n      rotation: { x: wp.rotation.x, y: wp.rotation.y, z: wp.rotation.z, w: wp.rotation.w }\n    }\n    const parcelDepth = (this.constructor as any).defaultDepth ?? 150\n\n    return [\n      topApproachFrame({\n        carrierWorld: me,\n        topY: parcelDepth,\n        approachDistance: 80,\n        toolType: 'gripper',\n        tolerance: { positionMm: 10, angleDeg: 2 },\n        priority: 0,\n        id: 'top-suction'\n      }),\n      topApproachFrame({\n        carrierWorld: me,\n        topY: parcelDepth,\n        approachDistance: 60,\n        toolType: 'agv-deck',\n        tolerance: { positionMm: 20, angleDeg: 5 },\n        priority: 1,\n        id: 'top-deck'\n      }),\n      topApproachFrame({\n        carrierWorld: me,\n        topY: parcelDepth,\n        approachDistance: 100,           // crane fork 가 cell 진입 hover\n        toolType: 'forklift-fork',\n        tolerance: { positionMm: 30, angleDeg: 5 },  // fork 적재 tolerance\n        priority: 2,                     // gripper/deck 다음\n        id: 'top-fork'\n      })\n    ]\n  }\n}\n"]}

package/dist/storage-cell.d.ts

@@ -59,8 +59,11 @@ export default class RackCell extends RackCell_base {
     retrieve(carrier: any, target: any, options?: any): Promise<void>;
     /**
      * Return the 3D attach frame for carriers placed in this cell.
-     * Carriers are lifted by their own halfDepth so the bottom face
-     * rests at the cell's Y-center (which is levelHeight/2 above the beam).
+     *
+     * Center-origin convention: cell 의 *local origin* 은 cell 의 center
+     * (= levelHeight/2 above the shelf beam). carrier 의 *bottom face* 가 cell
+     * 의 *bottom* (= local Y -cellDepth/2) 에 닿도록 carrier center =
+     * -cellDepth/2 + carrierDepth/2.
      */
     attachPointFor(carrier: Component): AttachFrame | null;
     /** RackCell has no 2D visual — the rack draws its own structure. */

package/dist/storage-cell.js

@@ -110,6 +110,20 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
         }
         carrier[TRANSFER_SLOT_KEY] = this.cellId;
         this.reparent(carrier, options);
+        // carrier.state.left/top/zPos 을 *cell-local center* 로 명시. 이전 holder
+        // 의 state (예: crane-local center) 가 그대로 남으면 *다음 pick 시
+        // moveTo(carrier) 의 target.center 계산이 *잘못된 좌표* 로 → 엉뚱한 위치
+        // 이동 결함. transient placement 'carried' 라 3D obj3d.position 영향 X,
+        // 2D render 와 moveTo 의 center 계산에만 영향.
+        const cw = numOr(this.state?.width, 0);
+        const ch = numOr(this.state?.height, 0);
+        const carrierW = numOr(carrier?.state?.width, 0);
+        const carrierH = numOr(carrier?.state?.height, 0);
+        carrier.setState?.({
+            left: (cw - carrierW) / 2,
+            top: (ch - carrierH) / 2,
+            zPos: 0
+        });
         this.trigger('transfer-received', {
             type: 'transfer-received',
             component: carrier,
@@ -158,17 +172,21 @@ let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
     // ── 3D attach frame ───────────────────────────────────────────────────────
     /**
      * Return the 3D attach frame for carriers placed in this cell.
-     * Carriers are lifted by their own halfDepth so the bottom face
-     * rests at the cell's Y-center (which is levelHeight/2 above the beam).
+     *
+     * Center-origin convention: cell 의 *local origin* 은 cell 의 center
+     * (= levelHeight/2 above the shelf beam). carrier 의 *bottom face* 가 cell
+     * 의 *bottom* (= local Y -cellDepth/2) 에 닿도록 carrier center =
+     * -cellDepth/2 + carrierDepth/2.
      */
     attachPointFor(carrier) {
         const root = this._realObject?.object3d;
         if (!root)
             return null;
         const carrierDepth = resolveCarrierDepth(carrier);
+        const cellDepth = numOr(this.state?.depth, 0);
         return {
             attach: root,
-            localPosition: { x: 0, y: carrierDepth / 2, z: 0 }
+            localPosition: { x: 0, y: -cellDepth / 2 + carrierDepth / 2, z: 0 }
         };
     }
     // ── 2D rendering ──────────────────────────────────────────────────────────

package/dist/storage-cell.js.map

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

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

@@ -30,9 +30,13 @@ export class StorageRack3D extends RealObjectGroup {
         const { width, height, depth = 3000 } = this.component.state;
         const levels = Math.max(1, Math.floor(this.component.state.levels || 4));
         const bays = Math.max(1, Math.floor(this.component.state.bays || 5));
-        const baseY = -depth / 2;
+        const shelfBase = Math.max(0, Math.min(this.component.state.shelfBaseHeight || 0, depth * 0.9));
+        const shelfZone = depth - shelfBase; // 실제 shelf 가 차지하는 Y
+        const baseY = -depth / 2; // rack 바닥 (3D Y 의 최저)
+        const shelfBaseY = baseY + shelfBase; // 첫 shelf 의 시작 (= level 1 의 바닥)
         const postW = Math.min(width / bays, height) * 0.06;
-        const beamH = depth * 0.025;
+        // beam 두께 = post 와 비슷 (산업 beam 이 post 보다 약간 두꺼움 — 1.2배)
+        const beamH = postW * 1.2;
         const braceT = postW * 0.6;
         const postMaterial = new THREE.MeshStandardMaterial({
             color: POST_COLOR,
@@ -67,11 +71,11 @@ export class StorageRack3D extends RealObjectGroup {
         postMesh.receiveShadow = true;
         this.object3d.add(postMesh);
         // ── Horizontal beams (front + back faces at each level) ──────────
-        // levels + 1 vertical positions (level 0 = ground, level N = top).
+        // shelf zone 안 levels+1 위치 (level 0 = shelfBase, level N = 천장).
         const beamGeos = [];
         for (let lv = 0; lv <= levels; lv++) {
             const yFrac = lv / levels;
-            const y = baseY + yFrac * depth - beamH / 2 + (lv === 0 ? beamH : 0);
+            const y = shelfBaseY + yFrac * shelfZone - beamH / 2 + (lv === 0 ? beamH : 0);
             for (const zSign of [-1, 1]) {
                 const beam = new THREE.BoxGeometry(width, beamH, beamH);
                 beam.translate(0, y, zSign * (height / 2 - beamH / 2));
@@ -87,7 +91,7 @@ export class StorageRack3D extends RealObjectGroup {
         // bay-tall cell. Visual signature of a load-bearing rack.
         const braceGeos = [];
         const cellW = width / bays;
-        const cellH = depth / levels;
+        const cellH = shelfZone / levels; // cell 높이 (shelf zone 안)
         const braceLen = Math.sqrt(cellW * cellW + cellH * cellH);
         const braceAngle = Math.atan2(cellH, cellW);
         const backZ = height / 2 - postW * 0.6;
@@ -97,7 +101,7 @@ export class StorageRack3D extends RealObjectGroup {
                 continue;
             const cellCenterX = (bay - bays / 2 + 0.5) * cellW;
             for (let lv = 0; lv < levels; lv++) {
-                const cellCenterY = baseY + (lv + 0.5) * cellH;
+                const cellCenterY = shelfBaseY + (lv + 0.5) * cellH;
                 for (const sign of [-1, 1]) {
                     const brace = new THREE.BoxGeometry(braceLen, braceT, braceT);
                     brace.rotateZ(sign * braceAngle);
@@ -111,6 +115,36 @@ export class StorageRack3D extends RealObjectGroup {
             braceMesh.castShadow = true;
             this.object3d.add(braceMesh);
         }
+        // ── Shelf planes (level 별 반투명 무볼륨 판) ────────────────────────────
+        // 각 level 의 *바닥 면* 에 plane — cell 위치 시각 인식. carrier 가 그 위
+        // 에 놓이는 *지지면*. 반투명.
+        //
+        // X-Z 넓이를 *frame 안쪽* 으로 줄여 mesh 겹침 자체 제거 (Z-fight 회피).
+        //   X: 양 옆 corner post 안쪽 (-postW 양쪽)
+        //   Z: 앞/뒤 beam 안쪽 (-beamH 양쪽)
+        const shelfW = Math.max(0, width - 2 * postW);
+        const shelfD = Math.max(0, height - 2 * beamH);
+        const shelfGeo = new THREE.PlaneGeometry(shelfW, shelfD);
+        shelfGeo.rotateX(-Math.PI / 2); // X-Y plane → X-Z plane (= horizontal)
+        const shelfMaterial = new THREE.MeshStandardMaterial({
+            color: BEAM_COLOR,
+            metalness: 0.3,
+            roughness: 0.6,
+            transparent: true,
+            opacity: 0.25,
+            side: THREE.DoubleSide
+        });
+        for (let lv = 0; lv < levels; lv++) {
+            // shelf plane Y = 해당 level 의 *load beam top* 정확 일치 (cell 바닥 면).
+            //   beam center Y = shelfBaseY + yFrac*shelfZone - beamH/2 + (lv===0 ? beamH : 0)
+            //   beam top    Y = beam center + beamH/2 = shelfBaseY + yFrac*shelfZone + (lv===0 ? beamH : 0)
+            const yFrac = lv / levels;
+            const y = shelfBaseY + yFrac * shelfZone + (lv === 0 ? beamH : 0);
+            const shelf = new THREE.Mesh(shelfGeo, shelfMaterial);
+            shelf.position.set(0, y, 0);
+            shelf.receiveShadow = true;
+            this.object3d.add(shelf);
+        }
     }
     updateDimension() { }
     onchange(after, before) {
@@ -118,7 +152,8 @@ export class StorageRack3D extends RealObjectGroup {
             'bays' in after ||
             'width' in after ||
             'height' in after ||
-            'depth' in after) {
+            'depth' in after ||
+            'shelfBaseHeight' in after) {
             this.update();
             return;
         }

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

@@ -1 +1 @@
-{"version":3,"file":"storage-rack-3d.js","sourceRoot":"","sources":["../src/storage-rack-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Rack 3D — multi-level storage shelf system.\n *\n * LO-POLY but visually unambiguous as a rack. The signature parts:\n *\n *   - 4 corner uprights (vertical posts running floor → top)\n *   - intermediate uprights between bays (one between each adjacent bay pair)\n *   - horizontal beams at each level on both front and back faces (defining\n *     the cell decks)\n *   - diagonal cross-bracing on the back face (the \"X\" pattern that says\n *     this is a load-bearing storage rack, not just a generic frame)\n *\n * No floor / ceiling panels — the rack is open by design (cells are accessed\n * by a picker from the front side).\n *\n * Cargo (pallets, boxes) added as children render at their own z position.\n * The rack itself is purely structural geometry.\n */\n\nimport * as THREE from 'three'\nimport * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nconst POST_COLOR = 0x6a7080\nconst BEAM_COLOR = 0x556070\nconst BRACE_COLOR = 0x556070\n\nexport class StorageRack3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 3000 } = this.component.state\n    const levels = Math.max(1, Math.floor((this.component.state.levels as number) || 4))\n    const bays = Math.max(1, Math.floor((this.component.state.bays as number) || 5))\n\n    const baseY = -depth / 2\n    const postW = Math.min(width / bays, height) * 0.06\n    const beamH = depth * 0.025\n    const braceT = postW * 0.6\n\n    const postMaterial = new THREE.MeshStandardMaterial({\n      color: POST_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n    const beamMaterial = new THREE.MeshStandardMaterial({\n      color: BEAM_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n    const braceMaterial = new THREE.MeshStandardMaterial({\n      color: BRACE_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n\n    // ── Uprights (vertical posts at every bay boundary) ──────────────\n    // bays + 1 vertical positions; for each, one front post + one back post.\n    const postGeos: THREE.BufferGeometry[] = []\n    for (let i = 0; i <= bays; i++) {\n      const xFrac = i / bays - 0.5\n      const x = xFrac * width\n      // Front + back posts\n      for (const zSign of [-1, 1]) {\n        const post = new THREE.BoxGeometry(postW, depth, postW)\n        post.translate(x, 0, zSign * (height / 2 - postW / 2))\n        postGeos.push(post)\n      }\n    }\n    const postMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(postGeos), postMaterial)\n    postMesh.castShadow = true\n    postMesh.receiveShadow = true\n    this.object3d.add(postMesh)\n\n    // ── Horizontal beams (front + back faces at each level) ──────────\n    // levels + 1 vertical positions (level 0 = ground, level N = top).\n    const beamGeos: THREE.BufferGeometry[] = []\n    for (let lv = 0; lv <= levels; lv++) {\n      const yFrac = lv / levels\n      const y = baseY + yFrac * depth - beamH / 2 + (lv === 0 ? beamH : 0)\n\n      for (const zSign of [-1, 1]) {\n        const beam = new THREE.BoxGeometry(width, beamH, beamH)\n        beam.translate(0, y, zSign * (height / 2 - beamH / 2))\n        beamGeos.push(beam)\n      }\n    }\n    const beamMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(beamGeos), beamMaterial)\n    beamMesh.castShadow = true\n    beamMesh.receiveShadow = true\n    this.object3d.add(beamMesh)\n\n    // ── Diagonal cross-bracing on the back face (the \"X\" pattern) ────\n    // Two diagonals per level — \"/\" and \"\\\" — making an X across each\n    // bay-tall cell. Visual signature of a load-bearing rack.\n    const braceGeos: THREE.BufferGeometry[] = []\n    const cellW = width / bays\n    const cellH = depth / levels\n    const braceLen = Math.sqrt(cellW * cellW + cellH * cellH)\n    const braceAngle = Math.atan2(cellH, cellW)\n    const backZ = height / 2 - postW * 0.6\n\n    for (let bay = 0; bay < bays; bay++) {\n      // Brace only every other bay to keep things visually open\n      if (bay % 2 !== 0) continue\n\n      const cellCenterX = (bay - bays / 2 + 0.5) * cellW\n\n      for (let lv = 0; lv < levels; lv++) {\n        const cellCenterY = baseY + (lv + 0.5) * cellH\n\n        for (const sign of [-1, 1]) {\n          const brace = new THREE.BoxGeometry(braceLen, braceT, braceT)\n          brace.rotateZ(sign * braceAngle)\n          brace.translate(cellCenterX, cellCenterY, backZ)\n          braceGeos.push(brace)\n        }\n      }\n    }\n    if (braceGeos.length > 0) {\n      const braceMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(braceGeos), braceMaterial)\n      braceMesh.castShadow = true\n      this.object3d.add(braceMesh)\n    }\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if (\n      'levels' in after ||\n      'bays' in after ||\n      'width' in after ||\n      'height' in after ||\n      'depth' in after\n    ) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n\n  updateAlpha() {}\n}\n"]}
+{"version":3,"file":"storage-rack-3d.js","sourceRoot":"","sources":["../src/storage-rack-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Rack 3D — multi-level storage shelf system.\n *\n * LO-POLY but visually unambiguous as a rack. The signature parts:\n *\n *   - 4 corner uprights (vertical posts running floor → top)\n *   - intermediate uprights between bays (one between each adjacent bay pair)\n *   - horizontal beams at each level on both front and back faces (defining\n *     the cell decks)\n *   - diagonal cross-bracing on the back face (the \"X\" pattern that says\n *     this is a load-bearing storage rack, not just a generic frame)\n *\n * No floor / ceiling panels — the rack is open by design (cells are accessed\n * by a picker from the front side).\n *\n * Cargo (pallets, boxes) added as children render at their own z position.\n * The rack itself is purely structural geometry.\n */\n\nimport * as THREE from 'three'\nimport * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nconst POST_COLOR = 0x6a7080\nconst BEAM_COLOR = 0x556070\nconst BRACE_COLOR = 0x556070\n\nexport class StorageRack3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 3000 } = this.component.state\n    const levels = Math.max(1, Math.floor((this.component.state.levels as number) || 4))\n    const bays = Math.max(1, Math.floor((this.component.state.bays as number) || 5))\n    const shelfBase = Math.max(0, Math.min(\n      (this.component.state.shelfBaseHeight as number) || 0,\n      depth * 0.9\n    ))\n    const shelfZone = depth - shelfBase    // 실제 shelf 가 차지하는 Y\n\n    const baseY = -depth / 2               // rack 바닥 (3D Y 의 최저)\n    const shelfBaseY = baseY + shelfBase   // 첫 shelf 의 시작 (= level 1 의 바닥)\n    const postW = Math.min(width / bays, height) * 0.06\n    // beam 두께 = post 와 비슷 (산업 beam 이 post 보다 약간 두꺼움 — 1.2배)\n    const beamH = postW * 1.2\n    const braceT = postW * 0.6\n\n    const postMaterial = new THREE.MeshStandardMaterial({\n      color: POST_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n    const beamMaterial = new THREE.MeshStandardMaterial({\n      color: BEAM_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n    const braceMaterial = new THREE.MeshStandardMaterial({\n      color: BRACE_COLOR,\n      metalness: 0.7,\n      roughness: 0.4\n    })\n\n    // ── Uprights (vertical posts at every bay boundary) ──────────────\n    // bays + 1 vertical positions; for each, one front post + one back post.\n    const postGeos: THREE.BufferGeometry[] = []\n    for (let i = 0; i <= bays; i++) {\n      const xFrac = i / bays - 0.5\n      const x = xFrac * width\n      // Front + back posts\n      for (const zSign of [-1, 1]) {\n        const post = new THREE.BoxGeometry(postW, depth, postW)\n        post.translate(x, 0, zSign * (height / 2 - postW / 2))\n        postGeos.push(post)\n      }\n    }\n    const postMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(postGeos), postMaterial)\n    postMesh.castShadow = true\n    postMesh.receiveShadow = true\n    this.object3d.add(postMesh)\n\n    // ── Horizontal beams (front + back faces at each level) ──────────\n    // shelf zone 안 levels+1 위치 (level 0 = shelfBase, level N = 천장).\n    const beamGeos: THREE.BufferGeometry[] = []\n    for (let lv = 0; lv <= levels; lv++) {\n      const yFrac = lv / levels\n      const y = shelfBaseY + yFrac * shelfZone - beamH / 2 + (lv === 0 ? beamH : 0)\n\n      for (const zSign of [-1, 1]) {\n        const beam = new THREE.BoxGeometry(width, beamH, beamH)\n        beam.translate(0, y, zSign * (height / 2 - beamH / 2))\n        beamGeos.push(beam)\n      }\n    }\n    const beamMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(beamGeos), beamMaterial)\n    beamMesh.castShadow = true\n    beamMesh.receiveShadow = true\n    this.object3d.add(beamMesh)\n\n    // ── Diagonal cross-bracing on the back face (the \"X\" pattern) ────\n    // Two diagonals per level — \"/\" and \"\\\" — making an X across each\n    // bay-tall cell. Visual signature of a load-bearing rack.\n    const braceGeos: THREE.BufferGeometry[] = []\n    const cellW = width / bays\n    const cellH = shelfZone / levels                          // cell 높이 (shelf zone 안)\n    const braceLen = Math.sqrt(cellW * cellW + cellH * cellH)\n    const braceAngle = Math.atan2(cellH, cellW)\n    const backZ = height / 2 - postW * 0.6\n\n    for (let bay = 0; bay < bays; bay++) {\n      // Brace only every other bay to keep things visually open\n      if (bay % 2 !== 0) continue\n\n      const cellCenterX = (bay - bays / 2 + 0.5) * cellW\n\n      for (let lv = 0; lv < levels; lv++) {\n        const cellCenterY = shelfBaseY + (lv + 0.5) * cellH\n\n        for (const sign of [-1, 1]) {\n          const brace = new THREE.BoxGeometry(braceLen, braceT, braceT)\n          brace.rotateZ(sign * braceAngle)\n          brace.translate(cellCenterX, cellCenterY, backZ)\n          braceGeos.push(brace)\n        }\n      }\n    }\n    if (braceGeos.length > 0) {\n      const braceMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(braceGeos), braceMaterial)\n      braceMesh.castShadow = true\n      this.object3d.add(braceMesh)\n    }\n\n    // ── Shelf planes (level 별 반투명 무볼륨 판) ────────────────────────────\n    // 각 level 의 *바닥 면* 에 plane — cell 위치 시각 인식. carrier 가 그 위\n    // 에 놓이는 *지지면*. 반투명.\n    //\n    // X-Z 넓이를 *frame 안쪽* 으로 줄여 mesh 겹침 자체 제거 (Z-fight 회피).\n    //   X: 양 옆 corner post 안쪽 (-postW 양쪽)\n    //   Z: 앞/뒤 beam 안쪽 (-beamH 양쪽)\n    const shelfW = Math.max(0, width - 2 * postW)\n    const shelfD = Math.max(0, height - 2 * beamH)\n    const shelfGeo = new THREE.PlaneGeometry(shelfW, shelfD)\n    shelfGeo.rotateX(-Math.PI / 2)  // X-Y plane → X-Z plane (= horizontal)\n    const shelfMaterial = new THREE.MeshStandardMaterial({\n      color: BEAM_COLOR,\n      metalness: 0.3,\n      roughness: 0.6,\n      transparent: true,\n      opacity: 0.25,\n      side: THREE.DoubleSide\n    })\n    for (let lv = 0; lv < levels; lv++) {\n      // shelf plane Y = 해당 level 의 *load beam top* 정확 일치 (cell 바닥 면).\n      //   beam center Y = shelfBaseY + yFrac*shelfZone - beamH/2 + (lv===0 ? beamH : 0)\n      //   beam top    Y = beam center + beamH/2 = shelfBaseY + yFrac*shelfZone + (lv===0 ? beamH : 0)\n      const yFrac = lv / levels\n      const y = shelfBaseY + yFrac * shelfZone + (lv === 0 ? beamH : 0)\n      const shelf = new THREE.Mesh(shelfGeo, shelfMaterial)\n      shelf.position.set(0, y, 0)\n      shelf.receiveShadow = true\n      this.object3d.add(shelf)\n    }\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if (\n      'levels' in after ||\n      'bays' in after ||\n      'width' in after ||\n      'height' in after ||\n      'depth' in after ||\n      'shelfBaseHeight' in after\n    ) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n\n  updateAlpha() {}\n}\n"]}

package/dist/storage-rack.d.ts

@@ -5,6 +5,12 @@ import { CellMap, type AttachFrame, type Alignment, type Heights, type Placement
 export interface StorageRackState extends State {
     bays?: number;
     levels?: number;
+    /**
+     * Level 1 (첫 shelf) 의 *시작 높이* (mm, rack 의 3D Y 축, 바닥부터). 미명시 0
+     * (바닥 = 첫 shelf). 양수 시 그만큼 위로 올라가 stocker port / conveyor 같은
+     * 컴포넌트가 들어갈 *빈 공간* 확보. Frame uprights 는 바닥 ~ 천장 그대로.
+     */
+    shelfBaseHeight?: number;
     debugCells?: boolean;
     material3d?: Material3D;
 }
@@ -39,6 +45,23 @@ export default class Rack extends Rack_base {
     static defaultDepth: (h: Heights) => number;
     get nature(): ComponentNature;
     get anchors(): never[];
+    /**
+     * Model serialization — storage-cell 자식 자동 제외. cells 는 _buildCells() 가
+     * runtime 재생성 (added() 호출 시점). 저장하면 *redundant 모델 크기 폭증* +
+     * load 시 _buildCells 와 중복. rack 의 bays/levels/shelfBaseHeight 만 저장,
+     * cells 는 derive.
+     */
+    get hierarchy(): Record<string, any>;
+    /**
+     * Lifecycle — RackCell child 자동 build. Rack 은 항상 cells 가짐.
+     */
+    added(parent: any): void;
+    /**
+     * Runtime — bays / levels 변경 시 RackCell child 재구성. _buildCells() 는
+     * 기존 cell 제거 후 재생성 (idempotent), 단 carrier 보유 시 결함 위험 —
+     * application 책임.
+     */
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
     /**
      * Derive the cell topology from the rack's current dimensions and bay/level
      * counts. The CellMap is rebuilt fresh each time (state changes trigger
@@ -80,8 +103,9 @@ export default class Rack extends Rack_base {
      */
     attachPointFor(_carrier: Component): AttachFrame | null;
     /**
-     * 2D — top-down rectangle showing the rack footprint, with subdivisions
-     * suggesting the bay layout.
+     * 2D — top-down rectangle showing the rack footprint with bay subdivisions.
+     * 편집/배치 가 가능하도록 *명시 fill + stroke* — pipeline 분기 무관하게 항상
+     * 보임. fill 은 반투명 (carrier / cell 위 overlay).
      */
     render(ctx: CanvasRenderingContext2D): void;
     get fillStyle(): string;

package/dist/storage-rack.js

@@ -21,6 +21,12 @@ const NATURE = {
             label: 'bays',
             name: 'bays',
             placeholder: '# of horizontal bays (default 5)'
+        },
+        {
+            type: 'number',
+            label: 'shelf-base-height',
+            name: 'shelfBaseHeight',
+            placeholder: 'mm — level 1 시작 높이 (바닥부터). stocker port / conveyor 공간.'
         }
     ],
     help: 'scene/component/rack'
@@ -67,6 +73,44 @@ let Rack = class Rack extends CellContainer(CarrierHolder(Placeable(ContainerAbs
     get anchors() {
         return [];
     }
+    /**
+     * Model serialization — storage-cell 자식 자동 제외. cells 는 _buildCells() 가
+     * runtime 재생성 (added() 호출 시점). 저장하면 *redundant 모델 크기 폭증* +
+     * load 시 _buildCells 와 중복. rack 의 bays/levels/shelfBaseHeight 만 저장,
+     * cells 는 derive.
+     */
+    get hierarchy() {
+        const base = super.hierarchy;
+        if (base?.components && Array.isArray(base.components)) {
+            base.components = base.components.filter((c) => c?.type !== 'storage-cell');
+            if (base.components.length === 0)
+                delete base.components;
+        }
+        return base;
+    }
+    /**
+     * Lifecycle — RackCell child 자동 build. Rack 은 항상 cells 가짐.
+     */
+    added(parent) {
+        super.added?.(parent);
+        this._buildCells();
+    }
+    /**
+     * Runtime — bays / levels 변경 시 RackCell child 재구성. _buildCells() 는
+     * 기존 cell 제거 후 재생성 (idempotent), 단 carrier 보유 시 결함 위험 —
+     * application 책임.
+     */
+    onchange(after, before) {
+        super.onchange?.(after, before);
+        if ('bays' in after ||
+            'levels' in after ||
+            'shelfBaseHeight' in after ||
+            'width' in after ||
+            'height' in after ||
+            'depth' in after) {
+            this._buildCells();
+        }
+    }
     // ── CellContainer ─────────────────────────────────────────────────────────
     /**
      * Derive the cell topology from the rack's current dimensions and bay/level
@@ -84,13 +128,17 @@ let Rack = class Rack extends CellContainer(CarrierHolder(Placeable(ContainerAbs
         const width = this.state.width || 1000;
         const rackDepth = this.state.depth || 3000; // Y: floor→ceiling
         const rackHeight = this.state.height || 600; // Z: front→back
+        const shelfBase = Math.max(0, Math.min(this.state.shelfBaseHeight || 0, rackDepth * 0.9 // clamp ≤ 90% — 최소 shelf zone
+        ));
+        const shelfZone = rackDepth - shelfBase; // 실제 shelf 가 차지하는 Y 영역
         return CellMap.grid({
             bays,
             rows: 1,
             levels,
             bayWidth: width / bays,
             rowDepth: rackHeight,
-            levelHeight: rackDepth / levels
+            levelHeight: shelfZone / levels,
+            origin: { x: 0, y: shelfBase, z: 0 } // 첫 cell 의 Y = shelfBase
         });
     }
     /**
@@ -115,14 +163,33 @@ let Rack = class Rack extends CellContainer(CarrierHolder(Placeable(ContainerAbs
             console.warn('Rack._buildCells: rack-cell type not registered. Import rack-cell.ts first.');
             return;
         }
+        // cell 의 state.left/top 는 *rack-local* (= parent-relative). things-scene
+        // 의 toScene() 이 parent chain 따라 board-absolute 변환 자동. 이전 board-
+        // absolute 설정은 *이중 변환* 결함 (rack.left 와 cell.left 둘 다 rack.transform
+        // 적용 받아 dx 폭증 → carriagePos clamp → carriage 안 움직임).
+        const rackWidth = this.state.width ?? 1000;
+        const rackHeight = this.state.height ?? 100;
+        const bays = Math.max(1, Math.floor(this.state.bays || 5));
+        const bayWidth = rackWidth / bays;
         const context = this._app;
         for (const cell of this.cellMap.cells) {
+            // cell.bay / row 는 1-based. storage-rack 은 rows=1 라 모든 cell 이 같은 2D
+            // top. level (수직) 은 2D 표현 안 함 — Crane.engage 의 carriageHeight 가 처리.
+            const bayIdx = cell.bay - 1; // 0-based
+            const cellW = cell.size.width;
+            const cellH = cell.size.depth; // 2D height = 3D Z (rack depth axis)
+            // rack-local 좌표 (rack 의 origin = rack.left/top, things-scene 의 자식 좌표)
+            const cellLeft = bayIdx * bayWidth + (bayWidth - cellW) / 2;
+            const cellTop = (rackHeight - cellH) / 2;
             const model = {
                 type: 'storage-cell',
                 cellId: cell.id,
-                width: cell.size.width,
-                height: cell.size.depth, // 2D height = 3D Z depth
-                depth: cell.size.height // 3D Y = level height
+                left: cellLeft,
+                top: cellTop,
+                width: cellW,
+                height: cellH,
+                depth: cell.size.height, // 3D Y = level height
+                zPos: cell.localPosition.y // ← 3D Y 위치 (level 따라 다름)
             };
             const rackCell = new RackCellClass(model, context);
             this.addComponent(rackCell);
@@ -164,21 +231,36 @@ let Rack = class Rack extends CellContainer(CarrierHolder(Placeable(ContainerAbs
     }
     // ── 2D rendering ─────────────────────────────────────────────────────────
     /**
-     * 2D — top-down rectangle showing the rack footprint, with subdivisions
-     * suggesting the bay layout.
+     * 2D — top-down rectangle showing the rack footprint with bay subdivisions.
+     * 편집/배치 가 가능하도록 *명시 fill + stroke* — pipeline 분기 무관하게 항상
+     * 보임. fill 은 반투명 (carrier / cell 위 overlay).
      */
     render(ctx) {
-        const { width, height, left, top } = this.state;
+        const left = this.state.left ?? 0;
+        const top = this.state.top ?? 0;
+        const width = this.state.width ?? 400;
+        const height = this.state.height ?? 100;
         const bays = Math.max(1, Math.floor(this.state.bays || 5));
+        const fill = this.state.fillStyle || '#a0a0a8';
+        const stroke = this.state.strokeStyle || '#555';
+        const lineWidth = this.state.lineWidth || 1;
+        // Fill (반투명)
+        ctx.save();
+        ctx.fillStyle = fill;
+        ctx.globalAlpha = 0.2;
+        ctx.fillRect(left, top, width, height);
+        ctx.restore();
+        // Stroke — outer + bay subdivisions
+        ctx.strokeStyle = stroke;
+        ctx.lineWidth = lineWidth;
+        ctx.strokeRect(left, top, width, height);
         ctx.beginPath();
-        // Outer rectangle
-        ctx.rect(left, top, width, height);
-        // Bay subdivisions (vertical lines)
         for (let i = 1; i < bays; i++) {
             const x = left + (width * i) / bays;
             ctx.moveTo(x, top);
             ctx.lineTo(x, top + height);
         }
+        ctx.stroke();
     }
     get fillStyle() {
         return '#a0a0a8';