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

package/dist/parcel-3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"parcel-3d.js","sourceRoot":"","sources":["../src/parcel-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Parcel 3D — a cardboard package.\n *\n * Structure:\n *   - main body box (cardboard color)\n *   - tape line running across the top (the visual signature — what makes\n *     this read as a \"shipping parcel\" rather than a generic box)\n *   - small label area on top (white rectangle suggesting a shipping label)\n *\n * Kept very simple — parcels in a logistics scene are typically present in\n * large numbers (sortation lines, fulfillment bays), so polygon count\n * matters more than it does for one-off equipment.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nconst CARDBOARD_COLOR = 0xc8a878\nconst TAPE_COLOR = 0xddc899\nconst LABEL_COLOR = 0xeeeeee\n\nexport class Parcel3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 150 } = this.component.state\n    const baseY = -depth / 2\n\n    // ── Main body ────────────────────────────────────────────────────\n    const bodyGeo = new THREE.BoxGeometry(width, depth, height)\n    const bodyMaterial = new THREE.MeshStandardMaterial({\n      color: CARDBOARD_COLOR,\n      metalness: 0,\n      roughness: 0.9\n    })\n    const bodyMesh = new THREE.Mesh(bodyGeo, bodyMaterial)\n    bodyMesh.position.set(0, 0, 0)\n    bodyMesh.castShadow = true\n    bodyMesh.receiveShadow = true\n    this.object3d.add(bodyMesh)\n\n    // ── Tape line on top (running along the long axis) ───────────────\n    const tapeW = Math.min(width, height) * 0.10\n    const tapeT = depth * 0.02\n    const tapeAlongLong = width >= height\n    const tapeGeo = tapeAlongLong\n      ? new THREE.BoxGeometry(width * 1.005, tapeT, tapeW)\n      : new THREE.BoxGeometry(tapeW, tapeT, height * 1.005)\n    const tapeMaterial = new THREE.MeshStandardMaterial({\n      color: TAPE_COLOR,\n      metalness: 0.05,\n      roughness: 0.5\n    })\n    const tapeMesh = new THREE.Mesh(tapeGeo, tapeMaterial)\n    tapeMesh.position.set(0, baseY + depth + tapeT / 2 - 0.01, 0)\n    this.object3d.add(tapeMesh)\n\n    // ── Shipping label (small white rectangle on top) ────────────────\n    const labelW = Math.min(width, height) * 0.35\n    const labelH = labelW * 0.6\n    const labelGeo = new THREE.BoxGeometry(labelW, depth * 0.005, labelH)\n    const labelMaterial = new THREE.MeshStandardMaterial({\n      color: LABEL_COLOR,\n      metalness: 0,\n      roughness: 0.4\n    })\n    const labelMesh = new THREE.Mesh(labelGeo, labelMaterial)\n    // Position on top, off-center by ~25% of long axis\n    if (tapeAlongLong) {\n      labelMesh.position.set(width * 0.2, baseY + depth + depth * 0.0025, -height * 0.15)\n    } else {\n      labelMesh.position.set(width * 0.15, baseY + depth + depth * 0.0025, height * 0.2)\n    }\n    this.object3d.add(labelMesh)\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if ('width' in after || 'height' in after || 'depth' in after) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n\n  updateAlpha() {}\n}\n"]}
+{"version":3,"file":"parcel-3d.js","sourceRoot":"","sources":["../src/parcel-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Parcel 3D — a cardboard package.\n *\n * Structure:\n *   - main body box (cardboard color)\n *   - tape line running across the top (the visual signature — what makes\n *     this read as a \"shipping parcel\" rather than a generic box)\n *   - small label area on top (white rectangle suggesting a shipping label)\n *\n * Kept very simple — parcels in a logistics scene are typically present in\n * large numbers (sortation lines, fulfillment bays), so polygon count\n * matters more than it does for one-off equipment.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nconst CARDBOARD_COLOR = 0xc8a878\nconst TAPE_COLOR = 0xddc899\nconst LABEL_COLOR = 0xeeeeee\n\n// ── Module-level shared materials ───────────────────────────────────────────\n// Parcel 인스턴스가 수백~수천 가능. instance 별 new MeshStandardMaterial 시\n// material 개수 폭증 → GPU memory + draw call 비효율. static color 라 단일\n// instance 공유. 색 변경 시 모든 Parcel 에 자동 반영 (의도).\nconst PARCEL_BODY_MATERIAL = new THREE.MeshStandardMaterial({\n  color: CARDBOARD_COLOR,\n  metalness: 0,\n  roughness: 0.9\n})\nconst PARCEL_TAPE_MATERIAL = new THREE.MeshStandardMaterial({\n  color: TAPE_COLOR,\n  metalness: 0.05,\n  roughness: 0.5\n})\nconst PARCEL_LABEL_MATERIAL = new THREE.MeshStandardMaterial({\n  color: LABEL_COLOR,\n  metalness: 0,\n  roughness: 0.4\n})\n\nexport class Parcel3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 150 } = this.component.state\n    const baseY = -depth / 2\n\n    // ── Main body ────────────────────────────────────────────────────\n    const bodyGeo = new THREE.BoxGeometry(width, depth, height)\n    const bodyMesh = new THREE.Mesh(bodyGeo, PARCEL_BODY_MATERIAL)\n    bodyMesh.position.set(0, 0, 0)\n    bodyMesh.castShadow = true\n    bodyMesh.receiveShadow = true\n    this.object3d.add(bodyMesh)\n\n    // ── Tape line on top (running along the long axis) ───────────────\n    const tapeW = Math.min(width, height) * 0.10\n    const tapeT = depth * 0.02\n    const tapeAlongLong = width >= height\n    const tapeGeo = tapeAlongLong\n      ? new THREE.BoxGeometry(width * 1.005, tapeT, tapeW)\n      : new THREE.BoxGeometry(tapeW, tapeT, height * 1.005)\n    const tapeMesh = new THREE.Mesh(tapeGeo, PARCEL_TAPE_MATERIAL)\n    tapeMesh.position.set(0, baseY + depth + tapeT / 2 - 0.01, 0)\n    this.object3d.add(tapeMesh)\n\n    // ── Shipping label (small white rectangle on top) ────────────────\n    const labelW = Math.min(width, height) * 0.35\n    const labelH = labelW * 0.6\n    const labelGeo = new THREE.BoxGeometry(labelW, depth * 0.005, labelH)\n    const labelMesh = new THREE.Mesh(labelGeo, PARCEL_LABEL_MATERIAL)\n    // Position on top, off-center by ~25% of long axis\n    if (tapeAlongLong) {\n      labelMesh.position.set(width * 0.2, baseY + depth + depth * 0.0025, -height * 0.15)\n    } else {\n      labelMesh.position.set(width * 0.15, baseY + depth + depth * 0.0025, height * 0.2)\n    }\n    this.object3d.add(labelMesh)\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if ('width' in after || 'height' in after || 'depth' in after) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n\n  updateAlpha() {}\n}\n"]}

package/dist/parcel.d.ts

@@ -34,9 +34,10 @@ export default class Parcel extends Parcel_base {
     get fillStyle(): string;
     buildRealObject(): RealObject | undefined;
     /**
-     * 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(): PickupFrame[];
 }

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/rack-grid-3d.d.ts

@@ -1,13 +1,24 @@
+import * as THREE from 'three';
 import { RealObjectGroup } from '@hatiolab/things-scene';
-import { Rack } from './rack-column.js';
 export declare class RackGrid3D extends RealObjectGroup {
-    private _frameMaterial?;
+    private _frameGroup?;
+    private _beamGroup?;
     build(): void;
-    protected get syncZPosOffset(): number;
-    get geometricOffsetY(): number;
-    private createFrameMaterial;
-    createRacks(): void;
-    mergeAndAddRackCommonObjects(racks: Rack[]): void;
+    /** hideRackFrame / hideHorizontalFrame 변경 시 visibility 즉시 반영. */
+    applyFrameVisibility(): void;
+    private _applyFrameVisibility;
+    private _buildFrames;
+    private _stockMesh?;
+    private _emptyStockMesh?;
+    /** Public — 후속 click 핸들러 사용. */
+    get stockMesh(): THREE.InstancedMesh | undefined;
+    /**
+     * Stock 시각화 (Plan A — InstancedMesh batched).
+     *   - hideEmptyStock=true  : state.data 의 record 있는 cell 만 instance
+     *   - hideEmptyStock=false : *모든 (non-isEmpty bay) cell × shelf* 에 instance.
+     *                            record 있으면 default 색, 없으면 *백색 반투명*.
+     */
+    rebuildStockMesh(): void;
     dispose(): void;
     updateAlpha(): void;
 }

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

@@ -1,92 +1,395 @@
 /*
  * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * RackGrid3D — *공유 corner posts + bay 별 beams + shelf planes*.
+ *
+ * Post (수직 기둥):
+ *   - (cols+1) × (rows+1) 의 grid corner 위치마다 *공유 post* 1 개.
+ *   - 인접 4 bay 중 *최소 1개 non-empty* 면 post 만듦. 모두 empty 면 skip.
+ *   - 옆 bay 와 *공유* → 두 post 겹침 X.
+ *
+ * Beam (수평 부재):
+ *   - non-empty bay 마다 front + back beam (각 shelf level).
+ *
+ * Shelf (반투명 판):
+ *   - non-empty bay 의 각 level 의 frame 안쪽.
+ *
+ * isEmpty source of truth: RackGrid.isBayEmpty(col, row) — cell.state.isEmpty 우선.
  */
 import * as THREE from 'three';
 import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
 import { RealObjectGroup } from '@hatiolab/things-scene';
-import { Rack } from './rack-column.js';
-const DEFAULT_FRAME_COLOR = 0x8a8a8a;
+import { POST_MATERIAL, BEAM_MATERIAL, SHELF_MATERIAL, STOCK_MATERIAL, EMPTY_STOCK_MATERIAL } from './rack-materials.js';
 export class RackGrid3D extends RealObjectGroup {
-    _frameMaterial;
+    _frameGroup; // post + beam 묶음 (hideRackFrame 시 hidden)
+    _beamGroup; // beam 만 (hideHorizontalFrame 시 hidden)
     build() {
         super.build();
-        this.createRacks();
+        this._buildFrames();
+        this._applyFrameVisibility();
     }
-    // bottom origin: object3d가 zPos(바닥)에 위치 (내부 mesh는 center-local 좌표로 쌓임)
-    get syncZPosOffset() {
-        return 0;
+    /** hideRackFrame / hideHorizontalFrame 변경 시 visibility 즉시 반영. */
+    applyFrameVisibility() {
+        this._applyFrameVisibility();
     }
-    get geometricOffsetY() {
-        return 0;
+    _applyFrameVisibility() {
+        const rs = this.component.state;
+        const hideFrame = !!rs?.hideRackFrame;
+        const hideBeams = !!rs?.hideHorizontalFrame;
+        if (this._frameGroup)
+            this._frameGroup.visible = !hideFrame;
+        // beam group 은 frame group 안에 nested — frame 이 hidden 일 때는 beam 도 자연히 hidden.
+        // frame visible + beam toggle 따로
+        if (this._beamGroup)
+            this._beamGroup.visible = !hideBeams;
     }
-    createFrameMaterial() {
-        this._frameMaterial?.dispose();
-        const { strokeStyle } = this.component.state;
-        const color = strokeStyle && typeof strokeStyle === 'string' ? strokeStyle : DEFAULT_FRAME_COLOR;
-        this._frameMaterial = new THREE.MeshStandardMaterial({
-            color,
-            roughness: 0.35,
-            metalness: 0.85
-        });
-        return this._frameMaterial;
-    }
-    createRacks() {
-        const { rotation = 0, shelfLocations, shelves = 1 } = this.component.state;
-        this.object3d.rotation.y = -rotation;
-        const racks = this.component.components
-            .map((cell) => {
-            const { shelfLocations: shelfLoc = shelfLocations, isEmpty } = cell.state;
-            if (!isEmpty) {
-                cell.setState('shelfLocations', shelfLoc);
-                const rack = new Rack(cell);
-                cell._realObject = rack; // 중복 생성 방지: addObject 재귀에서 skip
-                rack.update();
-                this.object3d.add(rack.object3d);
-                return rack;
+    _buildFrames() {
+        const comp = this.component;
+        const rs = comp.state;
+        // frame group — post + beamGroup 담음. hideRackFrame 시 frame group.visible=false.
+        // beam group — 가로 frame 만 (hideHorizontalFrame 시 따로 토글).
+        this._frameGroup = new THREE.Group();
+        this._beamGroup = new THREE.Group();
+        this._frameGroup.add(this._beamGroup);
+        this.object3d.add(this._frameGroup);
+        const width = rs?.width ?? 400; // 3D X
+        const height = rs?.depth ?? 2000; // 3D Y (floor → ceiling)
+        const depth = rs?.height ?? 200; // 3D Z (front → back)
+        const cols = comp.columns;
+        const rows = comp.rackRows;
+        const shelves = comp.shelves;
+        const shelfBase = Math.max(0, Math.min(rs?.shelfBaseHeight || 0, height * 0.9));
+        const shelfZone = height - shelfBase;
+        const bayW = width / cols;
+        const bayD = depth / rows;
+        const baseY = -height / 2;
+        const shelfBaseY = baseY + shelfBase;
+        // Frame 굵기 — storage-rack 과 동일 비율 (공유 post / 공유 beam 적용 후엔
+        // 겹침 없으므로 같은 비율 사용 가능).
+        const postW = Math.min(bayW, bayD) * 0.06;
+        const beamH = postW * 1.2;
+        const isEmpty = (col, row) => {
+            if (col < 0 || col >= cols || row < 0 || row >= rows)
+                return true;
+            return comp.isBayEmpty(col, row);
+        };
+        // ── 1. 공유 corner posts (hideRackFrame 면 skip) ───────
+        //
+        // (cols+1) × (rows+1) 의 모든 corner 위치. 4 인접 bay 중 *하나라도 non-empty*
+        // 이면 post 생성. 인접 bay 가 모두 empty → post skip.
+        const postGeos = [];
+        for (let c = 0; c <= cols; c++) {
+            for (let r = 0; r <= rows; r++) {
+                // 이 corner 에 인접한 4 bay (없는 위치는 isEmpty 처리)
+                const anyActive = !isEmpty(c - 1, r - 1) ||
+                    !isEmpty(c, r - 1) ||
+                    !isEmpty(c - 1, r) ||
+                    !isEmpty(c, r);
+                if (!anyActive)
+                    continue;
+                const x = (c - cols / 2) * bayW;
+                const z = (r - rows / 2) * bayD;
+                const post = new THREE.BoxGeometry(postW, height, postW);
+                post.translate(x, 0, z);
+                postGeos.push(post);
             }
-            return;
-        })
-            .filter((rack) => !!rack);
-        this.mergeAndAddRackCommonObjects(racks);
-    }
-    mergeAndAddRackCommonObjects(racks) {
-        const framesGeometries = [];
-        const boardsGeometries = [];
-        if (racks.length > 0) {
-            racks.forEach(rack => {
-                const geometry = rack.frame;
-                if (!geometry) {
-                    return;
+        }
+        // ── 2. Horizontal beams (X 축 외곽 wall 만 — storage-rack 일관) ────
+        //
+        // storage-rack 처럼 *front + back 의 X 축 beam* 만. 내부 행 경계 beam +
+        // Z 축 (좌우 side) beam 모두 제거 — *깔끔한 wall-frame 시각*.
+        // 각 level 마다 front (zEdge=0) + back (zEdge=rows) 두 줄. 각 줄은 *연속
+        // non-empty col 구간* 공유 통합.
+        const beamGeos = [];
+        // 외곽 wall 의 가로 frame — *연속 non-empty bay 구간*만. isEmpty bay 영역엔
+        // frame 없음. *내부 cross frame 은 항상 제외* — 깔끔함 유지.
+        // X 축 beam (front + back, 각 level) — non-empty col segment 별 단일 beam
+        for (const zEdge of [0, rows]) {
+            const zPos = (zEdge - rows / 2) * bayD;
+            const adjacentRow = zEdge === 0 ? 0 : rows - 1;
+            for (let lv = 0; lv <= shelves; lv++) {
+                const yFrac = lv / shelves;
+                const y = shelfBaseY + yFrac * shelfZone - beamH / 2 + (lv === 0 ? beamH : 0);
+                let segStart = -1;
+                for (let col = 0; col <= cols; col++) {
+                    const active = col < cols && !isEmpty(col, adjacentRow);
+                    if (active && segStart === -1)
+                        segStart = col;
+                    if (!active && segStart !== -1) {
+                        const startX = (segStart - cols / 2) * bayW;
+                        const endX = (col - cols / 2) * bayW;
+                        const beamLen = endX - startX;
+                        const beamCenterX = (startX + endX) / 2;
+                        const beam = new THREE.BoxGeometry(beamLen, beamH, beamH);
+                        beam.translate(beamCenterX, y, zPos);
+                        beamGeos.push(beam);
+                        segStart = -1;
+                    }
+                }
+            }
+        }
+        // Z 축 beam (좌우 side) — *모든 level*, isEmpty row 제외 segment.
+        for (const xEdge of [0, cols]) {
+            const xPos = (xEdge - cols / 2) * bayW;
+            const adjacentCol = xEdge === 0 ? 0 : cols - 1;
+            for (let lv = 0; lv <= shelves; lv++) {
+                const yFrac = lv / shelves;
+                const y = shelfBaseY + yFrac * shelfZone - beamH / 2 + (lv === 0 ? beamH : 0);
+                let segStart = -1;
+                for (let row = 0; row <= rows; row++) {
+                    const active = row < rows && !isEmpty(adjacentCol, row);
+                    if (active && segStart === -1)
+                        segStart = row;
+                    if (!active && segStart !== -1) {
+                        const startZ = (segStart - rows / 2) * bayD;
+                        const endZ = (row - rows / 2) * bayD;
+                        const beamLen = endZ - startZ;
+                        const beamCenterZ = (startZ + endZ) / 2;
+                        const beam = new THREE.BoxGeometry(beamH, beamH, beamLen);
+                        beam.translate(xPos, y, beamCenterZ);
+                        beamGeos.push(beam);
+                        segStart = -1;
+                    }
+                }
+            }
+        }
+        // 천장 (lv=shelves) 내부 cross beam — *isEmpty 영역 제외 segment*.
+        {
+            const lv = shelves;
+            const yFrac = lv / shelves;
+            const y = shelfBaseY + yFrac * shelfZone - beamH / 2 + (lv === 0 ? beamH : 0);
+            // 내부 col 경계 의 Z 축 beam (col 사이, Z 방향) — 인접 2 col 중 *해당 row* 가 non-empty
+            for (let xEdge = 1; xEdge < cols; xEdge++) {
+                const xPos = (xEdge - cols / 2) * bayW;
+                let segStart = -1;
+                for (let row = 0; row <= rows; row++) {
+                    const active = row < rows && (!isEmpty(xEdge - 1, row) || !isEmpty(xEdge, row));
+                    if (active && segStart === -1)
+                        segStart = row;
+                    if (!active && segStart !== -1) {
+                        const startZ = (segStart - rows / 2) * bayD;
+                        const endZ = (row - rows / 2) * bayD;
+                        const beamLen = endZ - startZ;
+                        const beamCenterZ = (startZ + endZ) / 2;
+                        const beam = new THREE.BoxGeometry(beamH, beamH, beamLen);
+                        beam.translate(xPos, y, beamCenterZ);
+                        beamGeos.push(beam);
+                        segStart = -1;
+                    }
+                }
+            }
+            // 내부 row 경계 의 X 축 beam (row 사이, X 방향) — 인접 2 row 중 *해당 col* 가 non-empty
+            for (let zEdge = 1; zEdge < rows; zEdge++) {
+                const zPos = (zEdge - rows / 2) * bayD;
+                let segStart = -1;
+                for (let col = 0; col <= cols; col++) {
+                    const active = col < cols && (!isEmpty(col, zEdge - 1) || !isEmpty(col, zEdge));
+                    if (active && segStart === -1)
+                        segStart = col;
+                    if (!active && segStart !== -1) {
+                        const startX = (segStart - cols / 2) * bayW;
+                        const endX = (col - cols / 2) * bayW;
+                        const beamLen = endX - startX;
+                        const beamCenterX = (startX + endX) / 2;
+                        const beam = new THREE.BoxGeometry(beamLen, beamH, beamH);
+                        beam.translate(beamCenterX, y, zPos);
+                        beamGeos.push(beam);
+                        segStart = -1;
+                    }
+                }
+            }
+        }
+        // ── 3. Shelf planes — *단일 InstancedMesh* (성능). 이전엔 cols × rows × shelves
+        //   개별 Mesh (각 draw call) — 큰 grid 에서 수천 draw call. 이제 1 mesh / 1 draw call.
+        const shelfW = Math.max(0, bayW - 2 * postW);
+        const shelfDD = Math.max(0, bayD - 2 * beamH);
+        if (shelfW > 0 && shelfDD > 0) {
+            const positions = [];
+            for (let col = 0; col < cols; col++) {
+                for (let row = 0; row < rows; row++) {
+                    if (isEmpty(col, row))
+                        continue;
+                    const bayCenterX = (col - cols / 2 + 0.5) * bayW;
+                    const bayCenterZ = (row - rows / 2 + 0.5) * bayD;
+                    for (let lv = 0; lv < shelves; lv++) {
+                        const yFrac = lv / shelves;
+                        const y = shelfBaseY + yFrac * shelfZone + (lv === 0 ? beamH : 0);
+                        positions.push({ x: bayCenterX, y, z: bayCenterZ });
+                    }
+                }
+            }
+            if (positions.length > 0) {
+                const shelfGeo = new THREE.PlaneGeometry(shelfW, shelfDD);
+                shelfGeo.rotateX(-Math.PI / 2);
+                const shelfMesh = new THREE.InstancedMesh(shelfGeo, SHELF_MATERIAL, positions.length);
+                shelfMesh.receiveShadow = true;
+                shelfMesh.frustumCulled = false;
+                const m = new THREE.Matrix4();
+                const pos = new THREE.Vector3();
+                const q = new THREE.Quaternion();
+                const s = new THREE.Vector3(1, 1, 1);
+                for (let i = 0; i < positions.length; i++) {
+                    pos.set(positions[i].x, positions[i].y, positions[i].z);
+                    m.compose(pos, q, s);
+                    shelfMesh.setMatrixAt(i, m);
                 }
-                geometry.translate(rack.position.x, rack.position.y, rack.position.z);
-                geometry.scale(rack.scale.x, rack.scale.y, rack.scale.z);
-                framesGeometries.push(geometry);
-            });
-            if (framesGeometries.length > 0) {
-                const frameMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(framesGeometries), this.createFrameMaterial());
-                this.object3d.add(frameMesh);
+                shelfMesh.instanceMatrix.needsUpdate = true;
+                shelfMesh.computeBoundingSphere();
+                this.object3d.add(shelfMesh);
             }
-            racks.forEach(rack => {
-                const geometry = rack.board;
-                if (!geometry) {
-                    return;
+        }
+        // ── Merge — post + beam ─────────────────────────────────
+        if (postGeos.length > 0) {
+            const merged = BufferGeometryUtils.mergeGeometries(postGeos);
+            const mesh = new THREE.Mesh(merged, POST_MATERIAL);
+            mesh.castShadow = true;
+            mesh.receiveShadow = true;
+            this._frameGroup.add(mesh);
+        }
+        if (beamGeos.length > 0) {
+            const merged = BufferGeometryUtils.mergeGeometries(beamGeos);
+            const mesh = new THREE.Mesh(merged, BEAM_MATERIAL);
+            mesh.castShadow = true;
+            mesh.receiveShadow = true;
+            this._beamGroup.add(mesh);
+        }
+        // ── 4. Stock InstancedMesh — state.data 의 record + hideEmptyStock 분기 ────
+        this.rebuildStockMesh();
+    }
+    // ── Stock visualization ─────────────────────────────────
+    _stockMesh; // record 있는 stock (불투명, 색)
+    _emptyStockMesh; // record 없는 stock (반투명 회색)
+    /** Public — 후속 click 핸들러 사용. */
+    get stockMesh() {
+        return this._stockMesh;
+    }
+    /**
+     * Stock 시각화 (Plan A — InstancedMesh batched).
+     *   - hideEmptyStock=true  : state.data 의 record 있는 cell 만 instance
+     *   - hideEmptyStock=false : *모든 (non-isEmpty bay) cell × shelf* 에 instance.
+     *                            record 있으면 default 색, 없으면 *백색 반투명*.
+     */
+    rebuildStockMesh() {
+        // 기존 두 mesh 모두 제거
+        if (this._stockMesh) {
+            this.object3d.remove(this._stockMesh);
+            this._stockMesh.dispose?.();
+            this._stockMesh = undefined;
+        }
+        if (this._emptyStockMesh) {
+            this.object3d.remove(this._emptyStockMesh);
+            this._emptyStockMesh.dispose?.();
+            this._emptyStockMesh = undefined;
+        }
+        const comp = this.component;
+        const rs = comp.state;
+        const cols = comp.columns;
+        const rows = comp.rackRows;
+        const shelves = comp.shelves;
+        const width = rs?.width ?? 400;
+        const height = rs?.depth ?? 2000;
+        const depth = rs?.height ?? 200;
+        const shelfBase = Math.max(0, Math.min(rs?.shelfBaseHeight || 0, height * 0.9));
+        const shelfZone = height - shelfBase;
+        const bayW = width / cols;
+        const bayD = depth / rows;
+        const cellY = shelfZone / shelves;
+        const baseY = -height / 2;
+        const shelfBaseY = baseY + shelfBase;
+        const stockW = bayW * 0.85;
+        const stockD = cellY * 0.7;
+        const stockH = bayD * 0.85;
+        const records = comp.records;
+        const recordsByCell = new Map();
+        for (const r of records) {
+            if (r?.cellId)
+                recordsByCell.set(r.cellId, r);
+        }
+        const hideEmpty = !!rs?.hideEmptyStock;
+        // 두 그룹 분리: record 있는 stock (불투명, 색) vs empty stock (반투명 회색)
+        const filled = [];
+        const empties = [];
+        for (let col = 0; col < cols; col++) {
+            for (let row = 0; row < rows; row++) {
+                if (comp.isBayEmpty(col, row))
+                    continue;
+                for (let shelf = 0; shelf < shelves; shelf++) {
+                    const cellId = `${col}-${row}-${shelf}`;
+                    const record = recordsByCell.get(cellId);
+                    if (record) {
+                        filled.push({ col, row, shelf, record });
+                    }
+                    else if (!hideEmpty) {
+                        empties.push({ col, row, shelf });
+                    }
                 }
-                geometry.translate(rack.position.x, rack.position.y, rack.position.z);
-                geometry.scale(rack.scale.x, rack.scale.y, rack.scale.z);
-                boardsGeometries.push(geometry);
-            });
-            if (boardsGeometries.length > 0) {
-                const material = Rack.boardMaterial;
-                material.opacity = 0.5;
-                material.transparent = true;
-                const boardMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(boardsGeometries), material);
-                this.object3d.add(boardMesh);
             }
         }
+        const matrixFor = (col, row, shelf, target) => {
+            const cx = (col - cols / 2 + 0.5) * bayW;
+            const cellBottomY = shelfBaseY + shelf * cellY;
+            const cy = cellBottomY + stockD / 2;
+            const cz = (row - rows / 2 + 0.5) * bayD;
+            target.compose(new THREE.Vector3(cx, cy, cz), new THREE.Quaternion(), new THREE.Vector3(1, 1, 1));
+        };
+        // ── 1. Filled stock — 불투명, legend/default 색 ──────
+        if (filled.length > 0) {
+            const STOCK_COLOR_DEFAULT = '#c8a878'; // cardboard
+            const geo = new THREE.BoxGeometry(stockW, stockD, stockH);
+            const mesh = new THREE.InstancedMesh(geo, STOCK_MATERIAL, filled.length);
+            mesh.frustumCulled = false;
+            mesh.userData.context = this;
+            mesh.userData._records = filled.map(i => i.record);
+            const m = new THREE.Matrix4();
+            const c = new THREE.Color();
+            for (let i = 0; i < filled.length; i++) {
+                const { col, row, shelf, record } = filled[i];
+                matrixFor(col, row, shelf, m);
+                mesh.setMatrixAt(i, m);
+                const resolved = comp.resolveLegendColor?.(record) ?? STOCK_COLOR_DEFAULT;
+                c.set(resolved);
+                mesh.setColorAt(i, c);
+            }
+            mesh.instanceMatrix.needsUpdate = true;
+            if (mesh.instanceColor)
+                mesh.instanceColor.needsUpdate = true;
+            mesh.computeBoundingSphere();
+            mesh.computeBoundingBox?.();
+            this.object3d.add(mesh);
+            this._stockMesh = mesh;
+        }
+        // ── 2. Empty stock — 반투명 회색 (hideEmptyStock=off 시만) ────
+        if (empties.length > 0) {
+            const geo = new THREE.BoxGeometry(stockW, stockD, stockH);
+            const mesh = new THREE.InstancedMesh(geo, EMPTY_STOCK_MATERIAL, empties.length);
+            mesh.frustumCulled = false;
+            mesh.userData.context = this;
+            const m = new THREE.Matrix4();
+            for (let i = 0; i < empties.length; i++) {
+                const { col, row, shelf } = empties[i];
+                matrixFor(col, row, shelf, m);
+                mesh.setMatrixAt(i, m);
+            }
+            mesh.instanceMatrix.needsUpdate = true;
+            mesh.computeBoundingSphere();
+            mesh.computeBoundingBox?.();
+            this.object3d.add(mesh);
+            this._emptyStockMesh = mesh;
+        }
     }
     dispose() {
-        this._frameMaterial?.dispose();
-        this._frameMaterial = undefined;
+        // Material 은 module-level singleton 이라 dispose 안 함 (전체 application
+        // lifecycle 동안 살아있음). InstancedMesh / Group 의 geometry 만 정리.
+        if (this._stockMesh) {
+            this.object3d.remove(this._stockMesh);
+            this._stockMesh.dispose?.();
+            this._stockMesh = undefined;
+        }
+        if (this._emptyStockMesh) {
+            this.object3d.remove(this._emptyStockMesh);
+            this._emptyStockMesh.dispose?.();
+            this._emptyStockMesh = undefined;
+        }
         super.dispose();
     }
     updateAlpha() { }