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

package/dist/asrs-rack.js

@@ -2,8 +2,8 @@ import { __decorate } from "tslib";
 /*
  * Copyright © HatioLab Inc. All rights reserved.
  */
-import { ContainerAbstract, sceneComponent } from '@hatiolab/things-scene';
-import { Placeable } from '@operato/scene-base';
+import { Component, ContainerAbstract, sceneComponent } from '@hatiolab/things-scene';
+import { CellContainer, CellMap, CarrierHolder, Placeable } from '@operato/scene-base';
 import { AsrsRack3D } from './asrs-rack-3d.js';
 const NATURE = {
     mutable: false,
@@ -28,33 +28,30 @@ const NATURE = {
 // `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),
 // which forces `isHTMLElement(): true` and trips the 3D pipeline's
 // addObject DOM-skip gate. ASRS rack lives only in the 3D scene graph.
-const Base = Placeable(ContainerAbstract);
+//
+// Mixin chain: CellContainer → CarrierHolder → Placeable → ContainerAbstract
+//   CellContainer: cell topology (cellMap, cell(), findAvailableCell(), occupiedCellIds())
+//   CarrierHolder: 3D attach-point protocol (attachPointFor, containable gates)
+//   Placeable:     floor-archetype positioning
+//   ContainerAbstract: child component management
 /**
  * AsrsRack — a multi-level high-bay storage rack, the structural backbone of
  * an AS/RS (Automated Storage / Retrieval System).
  *
  * `levels` × `bays` cells form a vertical grid. Each cell holds one logistics
  * package (Pallet / Box / Parcel). A pair of AsrsRacks separated by an aisle
- * (where an AsrsCrane runs) is the typical AS/RS configuration; v1 ships the
- * single-rack unit and lets users compose multi-rack systems by placing them
- * side by side. A future `AsrsAisle` composite may bundle the pair + crane.
+ * (where an AsrsCrane runs) is the typical AS/RS configuration.
  *
- * **Placement**: `floor` archetype, full ceiling depth by default — AS/RS
- * racks typically span floor to ceiling, with levels sized to fit the tallest
- * pallet load. Users can shorten via explicit `state.depth` for warehouses
- * with smaller envelopes.
+ * **Monitoring mode** (default): pallets/boxes are direct children of the rack,
+ * placed by the WCS data binding. No RackCell children are created.
  *
- * **Container-based**. Cells host stored cargo as children — each child's
- * left/top within the rack's bounds determines which cell it occupies. The
- * stacking pass in `Placeable.computeDefaultZPos` ensures each child cargo's
- * z lands on the rack's overall bottom (parent.zPos + parent.depth = ceiling),
- * which isn't quite cell-level resolution — true per-cell z positioning is
- * a v3 concern (the cargo would need to know which cell-row it's in).
+ * **Simulation mode**: call `rack._buildCells()` after placing the rack on the
+ * scene. This creates RackCell children at the correct 3D positions. The
+ * AsrsCrane then navigates to individual RackCells for pick-and-place.
  *
- * No Legendable for v1 — racks are passive structures; their per-cell
- * occupancy state is implicit in the children, not a status flag.
+ * **Placement**: `floor` archetype, full ceiling depth by default.
  */
-let AsrsRack = class AsrsRack extends Base {
+let AsrsRack = class AsrsRack extends CellContainer(CarrierHolder(Placeable(ContainerAbstract))) {
     static placement = 'floor';
     static align = 'bottom';
     static defaultDepth = (h) => h.ceiling - h.floor;
@@ -64,13 +61,103 @@ let AsrsRack = class AsrsRack extends Base {
     get anchors() {
         return [];
     }
-    /** Operation cargo (pallets / boxes / parcels) goes in the rack's cells. */
+    // ── CellContainer ─────────────────────────────────────────────────────────
+    /**
+     * Derive the cell topology from the rack's current dimensions and bay/level
+     * counts. The CellMap is rebuilt fresh each time (state changes trigger
+     * re-reads via things-scene's invalidation pipeline).
+     *
+     * Coordinate convention (matches things-scene 3D):
+     *   X = bay axis  (left → right)
+     *   Y = level axis (floor → ceiling, the rack's `depth` state property)
+     *   Z = row axis   (front → back, the rack's `height` state property)
+     */
+    get cellMap() {
+        const bays = Math.max(1, Math.floor(this.state.bays || 5));
+        const levels = Math.max(1, Math.floor(this.state.levels || 4));
+        const width = this.state.width || 1000;
+        const rackDepth = this.state.depth || 3000; // Y: floor→ceiling
+        const rackHeight = this.state.height || 600; // Z: front→back
+        return CellMap.grid({
+            bays,
+            rows: 1,
+            levels,
+            bayWidth: width / bays,
+            rowDepth: rackHeight,
+            levelHeight: rackDepth / levels
+        });
+    }
+    /**
+     * Create RackCell child components for each cell in the CellMap.
+     *
+     * Called explicitly to enter simulation mode — monitoring-mode racks
+     * never call this (pallets are direct children, no explicit cells).
+     *
+     * Idempotent: removes existing rack-cell children first.
+     */
+    _buildCells() {
+        // Remove existing rack-cell children
+        const existing = this.components ?? [];
+        for (const child of [...existing]) {
+            if (child.state?.type === 'rack-cell') {
+                ;
+                this.removeComponent?.(child);
+            }
+        }
+        // Create a RackCell for each cell in the map
+        const RackCellClass = Component.register('rack-cell');
+        if (!RackCellClass) {
+            console.warn('AsrsRack._buildCells: rack-cell type not registered. Import rack-cell.ts first.');
+            return;
+        }
+        const context = this._app;
+        for (const cell of this.cellMap.cells) {
+            const model = {
+                type: 'rack-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
+            };
+            const rackCell = new RackCellClass(model, context);
+            this.addComponent?.(rackCell);
+        }
+    }
+    // ── Container gates ───────────────────────────────────────────────────────
+    /**
+     * Allow:
+     *   - Carriable components (pallets, boxes, parcels) — direct children in monitoring mode.
+     *   - RackCell — created by _buildCells() in simulation mode.
+     *
+     * Block:
+     *   - Everything else (sensors, labels, etc. can be siblings of the rack, not children).
+     */
     containable(component) {
+        if (component.state?.type === 'rack-cell')
+            return true;
         const archetype = component.constructor.placement;
         if (archetype === 'operation')
             return true;
         return component.isDescendible(this);
     }
+    // ── CarrierHolder — attach frame for direct carrier children ─────────────
+    /**
+     * Attach frame for carriers that are DIRECT children of the rack
+     * (monitoring mode, where pallets go directly into the rack without
+     * explicit RackCell components).
+     *
+     * In simulation mode, carriers become children of their RackCell,
+     * and each RackCell provides its own attachPointFor(). So this method
+     * is only invoked on direct-child carriers in monitoring mode — it
+     * returns the rack's own object3d as the attach frame (default behavior).
+     */
+    attachPointFor(_carrier) {
+        const root = this._realObject?.object3d;
+        if (!root)
+            return null;
+        return { attach: root };
+    }
+    // ── 2D rendering ─────────────────────────────────────────────────────────
     /**
      * 2D — top-down rectangle showing the rack footprint, with subdivisions
      * suggesting the bay layout (lines parallel to the aisle).
@@ -91,6 +178,7 @@ let AsrsRack = class AsrsRack extends Base {
     get fillStyle() {
         return '#a0a0a8';
     }
+    // ── 3D ───────────────────────────────────────────────────────────────────
     buildRealObject() {
         return new AsrsRack3D(this);
     }

package/dist/asrs-rack.js.map

@@ -1 +1 @@
-{"version":3,"file":"asrs-rack.js","sourceRoot":"","sources":["../src/asrs-rack.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA8B,iBAAiB,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAClH,OAAO,EACL,SAAS,EAIV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,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,QAAQ;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kCAAkC;SAChD;QACD;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,kCAAkC;SAChD;KACF;IACD,IAAI,EAAE,2BAA2B;CAClC,CAAA;AAED,2FAA2F;AAC3F,mEAAmE;AACnE,uEAAuE;AACvE,MAAM,IAAI,GAAG,SAAS,CAAC,iBAAiB,CAAgC,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEY,IAAM,QAAQ,GAAd,MAAM,QAAS,SAAQ,IAAI;IACxC,MAAM,CAAC,SAAS,GAAuB,OAAO,CAAA;IAC9C,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAA;IAEzD,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,4EAA4E;IAC5E,WAAW,CAAC,SAAoB;QAC9B,MAAM,SAAS,GAAI,SAAS,CAAC,WAAmB,CAAC,SAAS,CAAA;QAC1D,IAAI,SAAS,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAC1C,OAAO,SAAS,CAAC,aAAa,CAAC,IAAW,CAAC,CAAA;IAC7C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAE,IAAI,CAAC,KAAK,CAAC,IAAe,IAAI,CAAC,CAAC,CAAC,CAAA;QAEtE,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,kBAAkB;QAClB,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAClC,oCAAoC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAA;YACnC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,SAAS;QACX,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,UAAU,CAAC,IAAW,CAAC,CAAA;IACpC,CAAC;;AA7CkB,QAAQ;IAD5B,cAAc,CAAC,WAAW,CAAC;GACP,QAAQ,CA8C5B;eA9CoB,QAAQ","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  Placeable,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsRack3D } from './asrs-rack-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'number',\n      label: 'levels',\n      name: 'levels',\n      placeholder: '# of vertical levels (default 4)'\n    },\n    {\n      type: 'number',\n      label: 'bays',\n      name: 'bays',\n      placeholder: '# of horizontal bays (default 5)'\n    }\n  ],\n  help: 'scene/component/asrs-rack'\n}\n\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. ASRS rack lives only in the 3D scene graph.\nconst Base = Placeable(ContainerAbstract) as unknown as typeof Component\n\n/**\n * AsrsRack — a multi-level high-bay storage rack, the structural backbone of\n * an AS/RS (Automated Storage / Retrieval System).\n *\n * `levels` × `bays` cells form a vertical grid. Each cell holds one logistics\n * package (Pallet / Box / Parcel). A pair of AsrsRacks separated by an aisle\n * (where an AsrsCrane runs) is the typical AS/RS configuration; v1 ships the\n * single-rack unit and lets users compose multi-rack systems by placing them\n * side by side. A future `AsrsAisle` composite may bundle the pair + crane.\n *\n * **Placement**: `floor` archetype, full ceiling depth by default — AS/RS\n * racks typically span floor to ceiling, with levels sized to fit the tallest\n * pallet load. Users can shorten via explicit `state.depth` for warehouses\n * with smaller envelopes.\n *\n * **Container-based**. Cells host stored cargo as children — each child's\n * left/top within the rack's bounds determines which cell it occupies. The\n * stacking pass in `Placeable.computeDefaultZPos` ensures each child cargo's\n * z lands on the rack's overall bottom (parent.zPos + parent.depth = ceiling),\n * which isn't quite cell-level resolution — true per-cell z positioning is\n * a v3 concern (the cargo would need to know which cell-row it's in).\n *\n * No Legendable for v1 — racks are passive structures; their per-cell\n * occupancy state is implicit in the children, not a status flag.\n */\n@sceneComponent('asrs-rack')\nexport default class AsrsRack extends Base {\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** Operation cargo (pallets / boxes / parcels) goes in the rack's cells. */\n  containable(component: Component) {\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this as any)\n  }\n\n  /**\n   * 2D — top-down rectangle showing the rack footprint, with subdivisions\n   * suggesting the bay layout (lines parallel to the aisle).\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n\n    ctx.beginPath()\n    // Outer rectangle\n    ctx.rect(left, top, width, height)\n    // Bay subdivisions (vertical lines)\n    for (let i = 1; i < bays; i++) {\n      const x = left + (width * i) / bays\n      ctx.moveTo(x, top)\n      ctx.lineTo(x, top + height)\n    }\n  }\n\n  get fillStyle() {\n    return '#a0a0a8'\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsRack3D(this as any)\n  }\n}\n"]}
+{"version":3,"file":"asrs-rack.js","sourceRoot":"","sources":["../src/asrs-rack.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  CellContainer,\n  CellMap,\n  CarrierHolder,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { AsrsRack3D } from './asrs-rack-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'number',\n      label: 'levels',\n      name: 'levels',\n      placeholder: '# of vertical levels (default 4)'\n    },\n    {\n      type: 'number',\n      label: 'bays',\n      name: 'bays',\n      placeholder: '# of horizontal bays (default 5)'\n    }\n  ],\n  help: 'scene/component/asrs-rack'\n}\n\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. ASRS rack lives only in the 3D scene graph.\n//\n// Mixin chain: CellContainer → CarrierHolder → Placeable → ContainerAbstract\n//   CellContainer: cell topology (cellMap, cell(), findAvailableCell(), occupiedCellIds())\n//   CarrierHolder: 3D attach-point protocol (attachPointFor, containable gates)\n//   Placeable:     floor-archetype positioning\n//   ContainerAbstract: child component management\n/**\n * AsrsRack — a multi-level high-bay storage rack, the structural backbone of\n * an AS/RS (Automated Storage / Retrieval System).\n *\n * `levels` × `bays` cells form a vertical grid. Each cell holds one logistics\n * package (Pallet / Box / Parcel). A pair of AsrsRacks separated by an aisle\n * (where an AsrsCrane runs) is the typical AS/RS configuration.\n *\n * **Monitoring mode** (default): pallets/boxes are direct children of the rack,\n * placed by the WCS data binding. No RackCell children are created.\n *\n * **Simulation mode**: call `rack._buildCells()` after placing the rack on the\n * scene. This creates RackCell children at the correct 3D positions. The\n * AsrsCrane then navigates to individual RackCells for pick-and-place.\n *\n * **Placement**: `floor` archetype, full ceiling depth by default.\n */\n@sceneComponent('asrs-rack')\nexport default class AsrsRack extends CellContainer(CarrierHolder(Placeable(ContainerAbstract))) {\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.ceiling - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  // ── CellContainer ─────────────────────────────────────────────────────────\n\n  /**\n   * Derive the cell topology from the rack's current dimensions and bay/level\n   * counts. The CellMap is rebuilt fresh each time (state changes trigger\n   * re-reads via things-scene's invalidation pipeline).\n   *\n   * Coordinate convention (matches things-scene 3D):\n   *   X = bay axis  (left → right)\n   *   Y = level axis (floor → ceiling, the rack's `depth` state property)\n   *   Z = row axis   (front → back, the rack's `height` state property)\n   */\n  get cellMap(): CellMap {\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n    const levels = Math.max(1, Math.floor((this.state.levels as number) || 4))\n    const width = (this.state.width as number) || 1000\n    const rackDepth = (this.state.depth as number) || 3000   // Y: floor→ceiling\n    const rackHeight = (this.state.height as number) || 600  // Z: front→back\n\n    return CellMap.grid({\n      bays,\n      rows: 1,\n      levels,\n      bayWidth: width / bays,\n      rowDepth: rackHeight,\n      levelHeight: rackDepth / levels\n    })\n  }\n\n  /**\n   * Create RackCell child components for each cell in the CellMap.\n   *\n   * Called explicitly to enter simulation mode — monitoring-mode racks\n   * never call this (pallets are direct children, no explicit cells).\n   *\n   * Idempotent: removes existing rack-cell children first.\n   */\n  _buildCells(): void {\n    // Remove existing rack-cell children\n    const existing = ((this as any).components as Component[] | undefined) ?? []\n    for (const child of [...existing]) {\n      if ((child as any).state?.type === 'rack-cell') {\n        ;(this as any).removeComponent?.(child)\n      }\n    }\n\n    // Create a RackCell for each cell in the map\n    const RackCellClass = (Component as any).register('rack-cell') as (new (...args: any[]) => Component) | undefined\n    if (!RackCellClass) {\n      console.warn('AsrsRack._buildCells: rack-cell type not registered. Import rack-cell.ts first.')\n      return\n    }\n\n    const context = (this as any)._app\n    for (const cell of this.cellMap.cells) {\n      const model = {\n        type: 'rack-cell',\n        cellId: cell.id,\n        width: cell.size.width,\n        height: cell.size.depth,  // 2D height = 3D Z depth\n        depth: cell.size.height   // 3D Y = level height\n      }\n      const rackCell = new RackCellClass(model, context)\n      ;(this as any).addComponent?.(rackCell)\n    }\n  }\n\n  // ── Container gates ───────────────────────────────────────────────────────\n\n  /**\n   * Allow:\n   *   - Carriable components (pallets, boxes, parcels) — direct children in monitoring mode.\n   *   - RackCell — created by _buildCells() in simulation mode.\n   *\n   * Block:\n   *   - Everything else (sensors, labels, etc. can be siblings of the rack, not children).\n   */\n  containable(component: Component): boolean {\n    if ((component as any).state?.type === 'rack-cell') return true\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this as any)\n  }\n\n  // ── CarrierHolder — attach frame for direct carrier children ─────────────\n\n  /**\n   * Attach frame for carriers that are DIRECT children of the rack\n   * (monitoring mode, where pallets go directly into the rack without\n   * explicit RackCell components).\n   *\n   * In simulation mode, carriers become children of their RackCell,\n   * and each RackCell provides its own attachPointFor(). So this method\n   * is only invoked on direct-child carriers in monitoring mode — it\n   * returns the rack's own object3d as the attach frame (default behavior).\n   */\n  attachPointFor(_carrier: Component): AttachFrame | null {\n    const root = (this as any)._realObject?.object3d\n    if (!root) return null\n    return { attach: root }\n  }\n\n  // ── 2D rendering ─────────────────────────────────────────────────────────\n\n  /**\n   * 2D — top-down rectangle showing the rack footprint, with subdivisions\n   * suggesting the bay layout (lines parallel to the aisle).\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const bays = Math.max(1, Math.floor((this.state.bays as number) || 5))\n\n    ctx.beginPath()\n    // Outer rectangle\n    ctx.rect(left, top, width, height)\n    // Bay subdivisions (vertical lines)\n    for (let i = 1; i < bays; i++) {\n      const x = left + (width * i) / bays\n      ctx.moveTo(x, top)\n      ctx.lineTo(x, top + height)\n    }\n  }\n\n  get fillStyle() {\n    return '#a0a0a8'\n  }\n\n  // ── 3D ───────────────────────────────────────────────────────────────────\n\n  buildRealObject(): RealObject | undefined {\n    return new AsrsRack3D(this as any)\n  }\n}\n"]}

package/dist/box.d.ts

@@ -1,4 +1,4 @@
-import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { ComponentNature, RealObject } from '@hatiolab/things-scene';
 import { type Alignment, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
 /**
  * Box material — drives 3D structure and color.
@@ -12,7 +12,7 @@ import { type Alignment, type LegendBinding, type PlacementArchetype } from '@op
  * different proportions, taping, and labels that warrant a distinct class.
  */
 export type BoxMaterial = 'wood' | 'plastic';
-declare const Base: typeof Component;
+declare const Box_base: any;
 /**
  * Box — a generic stackable container for goods. Wood crate or plastic tote
  * variants distinguished by `material` prop.
@@ -21,7 +21,7 @@ declare const Base: typeof Component;
  * logistics visualization (a *case* of items inside a box is data, not
  * scene-tree). If a future use case needs nested boxes, extend Container.
  */
-export default class Box extends Base {
+export default class Box extends Box_base {
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/box.js

@@ -31,7 +31,6 @@ const NATURE = {
 };
 // Carriable: a box can be a child of any CarrierHolder (Pallet for stacking,
 // AGV deck, robot-arm gripper, Spot for staging).
-const Base = Carriable(Legendable(Placeable(RectPath(Shape))));
 /**
  * Box — a generic stackable container for goods. Wood crate or plastic tote
  * variants distinguished by `material` prop.
@@ -40,7 +39,7 @@ const Base = Carriable(Legendable(Placeable(RectPath(Shape))));
  * logistics visualization (a *case* of items inside a box is data, not
  * scene-tree). If a future use case needs nested boxes, extend Container.
  */
-let Box = class Box extends Base {
+let Box = class Box extends Carriable(Legendable(Placeable(RectPath(Shape)))) {
     static legends = {
         bodyColor: { from: 'material', legend: BODY_LEGEND }
     };

package/dist/box.js.map

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

package/dist/generic-container.d.ts

@@ -3,8 +3,8 @@ import { type Alignment, type Heights, type LegendBinding, type PlacementArchety
 import { GenericContainer3D } from './generic-container-3d.js';
 import type { ActuatorDef } from '@operato/scene-base';
 export type ContainerStatus = 'empty' | 'partial' | 'full' | 'error';
-declare const Base: typeof Component;
-export default class GenericContainer extends Base {
+declare const GenericContainer_base: any;
+export default class GenericContainer extends GenericContainer_base {
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/generic-container.js

@@ -65,8 +65,7 @@ const NATURE = {
 };
 // 합성 순서: 안쪽부터 → ContainerAbstract → Placeable → Legendable → GltfComponent
 // (GenericFacility 와 동일 패턴)
-const Base = GltfComponent(Legendable(Placeable(ContainerAbstract)));
-let GenericContainer = class GenericContainer extends Base {
+let GenericContainer = class GenericContainer extends GltfComponent(Legendable(Placeable(ContainerAbstract))) {
     static legends = {
         bodyColor: { from: 'fill', legend: BODY_LEGEND },
         lampEmissive: { from: 'fill', legend: LAMP_EMISSIVE_LEGEND }

package/dist/generic-container.js.map

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

package/dist/index.d.ts

@@ -4,6 +4,9 @@ export { default as Box } from './box.js';
 export type { BoxMaterial } from './box.js';
 export { default as Parcel } from './parcel.js';
 export { default as AsrsRack } from './asrs-rack.js';
+export { default as RackCell } from './rack-cell.js';
+export type { RackCellType } from './rack-cell.js';
+export { RackCell3D } from './rack-cell-3d.js';
 export { default as AsrsCrane } from './asrs-crane.js';
 export type { AsrsCraneStatus } from './asrs-crane.js';
 export { default as Spot } from './spot.js';

package/dist/index.js

@@ -5,6 +5,8 @@ export { default as Pallet } from './pallet.js';
 export { default as Box } from './box.js';
 export { default as Parcel } from './parcel.js';
 export { default as AsrsRack } from './asrs-rack.js';
+export { default as RackCell } from './rack-cell.js';
+export { RackCell3D } from './rack-cell-3d.js';
 export { default as AsrsCrane } from './asrs-crane.js';
 export { default as Spot } from './spot.js';
 export { Spot3D } from './spot-3d.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AAGzC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nexport { default as Pallet } from './pallet.js'\nexport type { PalletMaterial } from './pallet.js'\n\nexport { default as Box } from './box.js'\nexport type { BoxMaterial } from './box.js'\n\nexport { default as Parcel } from './parcel.js'\n\nexport { default as AsrsRack } from './asrs-rack.js'\nexport { default as AsrsCrane } from './asrs-crane.js'\nexport type { AsrsCraneStatus } from './asrs-crane.js'\n\nexport { default as Spot } from './spot.js'\nexport { Spot3D } from './spot-3d.js'\n\nexport { default as GenericContainer } from './generic-container.js'\nexport type { ContainerStatus } from './generic-container.js'\nexport { GenericContainer3D } from './generic-container-3d.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AAGzC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nexport { default as Pallet } from './pallet.js'\nexport type { PalletMaterial } from './pallet.js'\n\nexport { default as Box } from './box.js'\nexport type { BoxMaterial } from './box.js'\n\nexport { default as Parcel } from './parcel.js'\n\nexport { default as AsrsRack } from './asrs-rack.js'\nexport { default as RackCell } from './rack-cell.js'\nexport type { RackCellType } from './rack-cell.js'\nexport { RackCell3D } from './rack-cell-3d.js'\nexport { default as AsrsCrane } from './asrs-crane.js'\nexport type { AsrsCraneStatus } from './asrs-crane.js'\n\nexport { default as Spot } from './spot.js'\nexport { Spot3D } from './spot-3d.js'\n\nexport { default as GenericContainer } from './generic-container.js'\nexport type { ContainerStatus } from './generic-container.js'\nexport { GenericContainer3D } from './generic-container-3d.js'\n"]}

package/dist/pallet.d.ts

@@ -12,7 +12,7 @@ import { type Alignment, type LegendBinding, type PlacementArchetype } from '@op
  * legend + a 3D variant in pallet-3d.ts.
  */
 export type PalletMaterial = 'wood' | 'plastic';
-declare const Base: typeof Component;
+declare const Pallet_base: any;
 /**
  * Pallet — a flat transport structure that goods are stacked and stored on.
  *
@@ -39,7 +39,7 @@ declare const Base: typeof Component;
  * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the
  * detection.
  */
-export default class Pallet extends Base {
+export default class Pallet extends Pallet_base {
     static legends: Record<string, LegendBinding>;
     static placement: PlacementArchetype;
     static align: Alignment;

package/dist/pallet.js

@@ -37,7 +37,6 @@ const NATURE = {
 // `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),
 // which forces `isHTMLElement(): true` and trips the 3D pipeline's
 // addObject DOM-skip gate. Pallet renders only as a 3D mesh.
-const Base = Carriable(Legendable(Placeable(ContainerAbstract)));
 /**
  * Pallet — a flat transport structure that goods are stacked and stored on.
  *
@@ -64,7 +63,7 @@ const Base = Carriable(Legendable(Placeable(ContainerAbstract)));
  * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the
  * detection.
  */
-let Pallet = class Pallet extends Base {
+let Pallet = class Pallet extends Carriable(Legendable(Placeable(ContainerAbstract))) {
     static legends = {
         bodyColor: { from: 'material', legend: BODY_LEGEND }
     };

package/dist/pallet.js.map

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

package/dist/parcel.d.ts

@@ -1,6 +1,6 @@
-import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { ComponentNature, RealObject } from '@hatiolab/things-scene';
 import { type Alignment, type PlacementArchetype } from '@operato/scene-base';
-declare const Base: typeof Component;
+declare const Parcel_base: any;
 /**
  * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.
  *
@@ -16,7 +16,7 @@ declare const Base: typeof Component;
  * No Legendable for v1 — parcel color is fixed cardboard. Future damaged /
  * inspected indicators would add a status legend then.
  */
-export default class Parcel extends Base {
+export default class Parcel extends Parcel_base {
     static placement: PlacementArchetype;
     static align: Alignment;
     static defaultDepth: number;

package/dist/parcel.js

@@ -21,7 +21,6 @@ const NATURE = {
 // Carriable: parcel can be a child of any CarrierHolder (Spot, robot-arm
 // gripper, AGV deck, …). Mixin wraps add() so the parcel's 3D object3d
 // is reattached to the holder's chosen mount frame.
-const Base = Carriable(Placeable(RectPath(Shape)));
 /**
  * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.
  *
@@ -37,7 +36,7 @@ const Base = Carriable(Placeable(RectPath(Shape)));
  * No Legendable for v1 — parcel color is fixed cardboard. Future damaged /
  * inspected indicators would add a status legend then.
  */
-let Parcel = class Parcel extends Base {
+let Parcel = class Parcel extends Carriable(Placeable(RectPath(Shape))) {
     static placement = 'operation';
     static align = 'bottom';
     static defaultDepth = 150;

package/dist/parcel.js.map

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

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

@@ -0,0 +1,25 @@
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class RackCell3D extends RealObjectGroup {
+    build(): void;
+    updateDimension(): void;
+    updateTransform(): void;
+    updateAlpha(): void;
+    /**
+     * Position this group at the cell's localPosition within the rack's 3D space.
+     *
+     * CellMap.grid() places cell origins at:
+     *   x = b * bayWidth,  y = l * levelHeight,  z = r * rowDepth
+     * (starting from 0,0,0 at the rack's bottom-left-front corner).
+     *
+     * The rack's object3d is centered: X spans [-width/2, +width/2],
+     * Y spans [-depth/2, +depth/2], Z spans [-height/2, +height/2].
+     *
+     * So the cell centre in rack-local 3D space:
+     *   x3d = cellPos.x + bayWidth/2   - width/2
+     *   y3d = cellPos.y + levelHeight/2 - rackDepth/2
+     *   z3d = cellPos.z + rowDepth/2   - rackHeight/2
+     */
+    _repositionFromCellMap(): void;
+    private _debugBox?;
+    private _addDebugBox;
+}