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

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

@@ -0,0 +1,88 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * RackCell 3D — invisible anchor group positioned at the cell's location
+ * within the parent rack's 3D coordinate space.
+ *
+ * RackCell has no geometry of its own. Its sole 3D purpose is to provide
+ * an Object3D that carriers can be attached to (via Three.js `.attach()`),
+ * placed at the exact cell position within the rack. The position is derived
+ * from the parent AsrsRack's CellMap (by cellId), not from 2D state fields —
+ * rack cells occupy 3D levels that have no 2D analogue.
+ *
+ * updateTransform() override: things-scene's standard updateTransform
+ * reads `component.center` (2D) and flattens it to 3D. For rack cells this
+ * is wrong — we need the 3D cell position (bay x, level y, row z) from the
+ * parent rack. So we override and read it directly from the CellMap.
+ */
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export class RackCell3D extends RealObjectGroup {
+    build() {
+        super.build();
+        this._repositionFromCellMap();
+    }
+    updateDimension() {
+        // intentional no-op — size comes from the cell definition, not state
+    }
+    updateTransform() {
+        this._repositionFromCellMap();
+    }
+    updateAlpha() {
+        // invisible — no materials to update
+    }
+    /**
+     * 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() {
+        const rack = this.component.parent;
+        if (!rack?.cellMap)
+            return;
+        const cellId = this.component.state?.cellId;
+        if (!cellId)
+            return;
+        const cell = rack.cellMap.findById(cellId);
+        if (!cell)
+            return;
+        const rs = rack.state;
+        const rackWidth = rs?.width || 1000;
+        const rackDepth = rs?.depth || 3000; // Y dimension (floor→ceiling)
+        const rackHeight = rs?.height || 600; // Z dimension (front→back, 2D height)
+        const bays = Math.max(1, Math.floor(rs?.bays || 5));
+        const levels = Math.max(1, Math.floor(rs?.levels || 4));
+        const rows = 1;
+        const bayWidth = rackWidth / bays;
+        const levelHeight = rackDepth / levels;
+        const rowDepth = rackHeight / rows;
+        const x3d = cell.localPosition.x + bayWidth / 2 - rackWidth / 2;
+        const y3d = cell.localPosition.y + levelHeight / 2 - rackDepth / 2;
+        const z3d = cell.localPosition.z + rowDepth / 2 - rackHeight / 2;
+        this.object3d.position.set(x3d, y3d, z3d);
+        // Optionally visualise cells in debug mode (outline box, very faint)
+        if (process.env.NODE_ENV !== 'production' && rack.state?.debugCells) {
+            this._addDebugBox(bayWidth, levelHeight, rowDepth);
+        }
+    }
+    _debugBox;
+    _addDebugBox(w, h, d) {
+        if (this._debugBox)
+            return;
+        const geo = new THREE.BoxGeometry(w * 0.98, h * 0.98, d * 0.98);
+        const edges = new THREE.EdgesGeometry(geo);
+        this._debugBox = new THREE.LineSegments(edges, new THREE.LineBasicMaterial({ color: 0x00ff88, transparent: true, opacity: 0.2 }));
+        this.object3d.add(this._debugBox);
+    }
+}
+//# sourceMappingURL=rack-cell-3d.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rack-cell-3d.js","sourceRoot":"","sources":["../src/rack-cell-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * RackCell 3D — invisible anchor group positioned at the cell's location\n * within the parent rack's 3D coordinate space.\n *\n * RackCell has no geometry of its own. Its sole 3D purpose is to provide\n * an Object3D that carriers can be attached to (via Three.js `.attach()`),\n * placed at the exact cell position within the rack. The position is derived\n * from the parent AsrsRack's CellMap (by cellId), not from 2D state fields —\n * rack cells occupy 3D levels that have no 2D analogue.\n *\n * updateTransform() override: things-scene's standard updateTransform\n * reads `component.center` (2D) and flattens it to 3D. For rack cells this\n * is wrong — we need the 3D cell position (bay x, level y, row z) from the\n * parent rack. So we override and read it directly from the CellMap.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nexport class RackCell3D extends RealObjectGroup {\n  build() {\n    super.build()\n    this._repositionFromCellMap()\n  }\n\n  updateDimension() {\n    // intentional no-op — size comes from the cell definition, not state\n  }\n\n  updateTransform() {\n    this._repositionFromCellMap()\n  }\n\n  updateAlpha() {\n    // invisible — no materials to update\n  }\n\n  /**\n   * Position this group at the cell's localPosition within the rack's 3D space.\n   *\n   * CellMap.grid() places cell origins at:\n   *   x = b * bayWidth,  y = l * levelHeight,  z = r * rowDepth\n   * (starting from 0,0,0 at the rack's bottom-left-front corner).\n   *\n   * The rack's object3d is centered: X spans [-width/2, +width/2],\n   * Y spans [-depth/2, +depth/2], Z spans [-height/2, +height/2].\n   *\n   * So the cell centre in rack-local 3D space:\n   *   x3d = cellPos.x + bayWidth/2   - width/2\n   *   y3d = cellPos.y + levelHeight/2 - rackDepth/2\n   *   z3d = cellPos.z + rowDepth/2   - rackHeight/2\n   */\n  _repositionFromCellMap() {\n    const rack = (this.component as any).parent\n    if (!rack?.cellMap) return\n\n    const cellId = (this.component as any).state?.cellId as string | undefined\n    if (!cellId) return\n\n    const cell = rack.cellMap.findById(cellId)\n    if (!cell) return\n\n    const rs = rack.state as any\n    const rackWidth = (rs?.width as number) || 1000\n    const rackDepth = (rs?.depth as number) || 3000   // Y dimension (floor→ceiling)\n    const rackHeight = (rs?.height as number) || 600  // Z dimension (front→back, 2D height)\n    const bays = Math.max(1, Math.floor(rs?.bays || 5))\n    const levels = Math.max(1, Math.floor(rs?.levels || 4))\n    const rows = 1\n\n    const bayWidth = rackWidth / bays\n    const levelHeight = rackDepth / levels\n    const rowDepth = rackHeight / rows\n\n    const x3d = cell.localPosition.x + bayWidth / 2 - rackWidth / 2\n    const y3d = cell.localPosition.y + levelHeight / 2 - rackDepth / 2\n    const z3d = cell.localPosition.z + rowDepth / 2 - rackHeight / 2\n\n    this.object3d.position.set(x3d, y3d, z3d)\n\n    // Optionally visualise cells in debug mode (outline box, very faint)\n    if (process.env.NODE_ENV !== 'production' && (rack.state as any)?.debugCells) {\n      this._addDebugBox(bayWidth, levelHeight, rowDepth)\n    }\n  }\n\n  private _debugBox?: THREE.LineSegments\n\n  private _addDebugBox(w: number, h: number, d: number) {\n    if (this._debugBox) return\n    const geo = new THREE.BoxGeometry(w * 0.98, h * 0.98, d * 0.98)\n    const edges = new THREE.EdgesGeometry(geo)\n    this._debugBox = new THREE.LineSegments(\n      edges,\n      new THREE.LineBasicMaterial({ color: 0x00ff88, transparent: true, opacity: 0.2 })\n    )\n    this.object3d.add(this._debugBox)\n  }\n}\n"]}

package/dist/rack-cell.d.ts

@@ -0,0 +1,56 @@
+import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { type AttachFrame } from '@operato/scene-base';
+/**
+ * How many carriers a cell can hold simultaneously.
+ * - single: exactly 1 (typical pallet bay)
+ * - multi:  small stack (up to 4, e.g. a multi-deep tray)
+ * - bulk:   unlimited (e.g. a floor area measured in slots)
+ */
+export type RackCellType = 'single' | 'multi' | 'bulk';
+declare const RackCell_base: any;
+/**
+ * RackCell — single-slot storage cell inside an AsrsRack.
+ *
+ * Mixin chain: CarrierHolder(ContainerAbstract)
+ *   - CarrierHolder: publishes attachPointFor(), gates containable() to Carriables
+ *   - ContainerAbstract: manages child carrier components
+ *
+ * No Placeable mixin — RackCell3D self-positions from the parent rack's
+ * CellMap (via updateTransform override), bypassing things-scene's standard
+ * 2D→3D coordinate mapping which cannot express 3D levels.
+ */
+export default class RackCell extends RackCell_base {
+    get cellId(): string;
+    get cellType(): RackCellType;
+    /** Maximum carrier count for this cell based on cellType. */
+    get capacity(): number;
+    get nature(): ComponentNature;
+    get anchors(): [];
+    /** True when fewer carriers are currently held than capacity. */
+    canReceive(_component?: any): boolean;
+    /**
+     * Accept a carrier into this cell.
+     * Sets TRANSFER_SLOT_KEY = cellId on the carrier, then reparents.
+     * Fires 'transfer-received' so monitors can react.
+     */
+    receive(carrier: any, options?: any): Promise<void>;
+    /**
+     * Release a carrier from this cell to `target`.
+     * Delegates to `target.receive()` if available, otherwise `target.reparent()`.
+     */
+    dispatch(carrier: any, target: any, options?: any): Promise<void>;
+    /** Alias for receive() — semantic sugar for the storage domain. */
+    store(carrier: any, options?: any): Promise<void>;
+    /** Alias for dispatch() — semantic sugar for the storage domain. */
+    retrieve(carrier: any, target: any, options?: any): Promise<void>;
+    /**
+     * Return the 3D attach frame for carriers placed in this cell.
+     * Carriers are lifted by their own halfDepth so the bottom face
+     * rests at the cell's Y-center (which is levelHeight/2 above the beam).
+     */
+    attachPointFor(carrier: Component): AttachFrame | null;
+    /** RackCell has no 2D visual — the rack draws its own structure. */
+    render(_ctx: CanvasRenderingContext2D): void;
+    buildRealObject(): RealObject | undefined;
+}
+export {};

package/dist/rack-cell.js

@@ -0,0 +1,200 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * RackCell — a single storage slot within an AsrsRack.
+ *
+ * A RackCell is a virtual component: it occupies a specific (bay, row, level)
+ * coordinate within the parent rack and acts as a CarrierHolder for one carrier
+ * (or several, depending on `cellType`).
+ *
+ * The crane (AsrsCrane) navigates toward a RackCell as its `place()` destination —
+ * because the rack cell is a discrete component, Mover.moveTo() can target it
+ * directly and arrive at exactly the right bay × level position.
+ *
+ * Visual: invisible in 2D (no visible 2D footprint — rack cells don't make
+ * sense as 2D top-down boxes). In 3D, each cell is an invisible Group
+ * positioned within the rack's coordinate space (RackCell3D handles
+ * this via updateTransform override).
+ *
+ * Lifecycle: AsrsRack._buildCells() instantiates RackCell children.
+ * Do not create RackCell components manually — they are managed by the rack.
+ *
+ * Domain aliases:
+ *   cell.store(carrier)            ← cell.receive(carrier)
+ *   cell.retrieve(carrier, target) ← cell.dispatch(carrier, target)
+ */
+import { __decorate } from "tslib";
+import { ContainerAbstract, TRANSFER_SLOT_KEY, sceneComponent } from '@hatiolab/things-scene';
+import { CarrierHolder } from '@operato/scene-base';
+import { RackCell3D } from './rack-cell-3d.js';
+const NATURE = {
+    mutable: false,
+    resizable: false,
+    rotatable: false,
+    properties: [
+        {
+            type: 'string',
+            label: 'cell-id',
+            name: 'cellId',
+            placeholder: 'e.g. 0-0-0'
+        },
+        {
+            type: 'select',
+            label: 'cell-type',
+            name: 'cellType',
+            property: {
+                options: [
+                    { display: 'Single', value: 'single' },
+                    { display: 'Multi', value: 'multi' },
+                    { display: 'Bulk', value: 'bulk' }
+                ]
+            }
+        }
+    ],
+    help: 'scene/component/rack-cell'
+};
+/**
+ * RackCell — single-slot storage cell inside an AsrsRack.
+ *
+ * Mixin chain: CarrierHolder(ContainerAbstract)
+ *   - CarrierHolder: publishes attachPointFor(), gates containable() to Carriables
+ *   - ContainerAbstract: manages child carrier components
+ *
+ * No Placeable mixin — RackCell3D self-positions from the parent rack's
+ * CellMap (via updateTransform override), bypassing things-scene's standard
+ * 2D→3D coordinate mapping which cannot express 3D levels.
+ */
+let RackCell = class RackCell extends CarrierHolder(ContainerAbstract) {
+    // ── Identification ────────────────────────────────────────────────────────
+    get cellId() {
+        return this.state.cellId || '';
+    }
+    get cellType() {
+        return (this.state.cellType || 'single');
+    }
+    /** Maximum carrier count for this cell based on cellType. */
+    get capacity() {
+        switch (this.cellType) {
+            case 'single': return 1;
+            case 'multi': return 4;
+            case 'bulk': return Infinity;
+        }
+    }
+    // ── Interface ─────────────────────────────────────────────────────────────
+    get nature() {
+        return NATURE;
+    }
+    get anchors() {
+        return [];
+    }
+    // ── Transfer protocol ─────────────────────────────────────────────────────
+    /** True when fewer carriers are currently held than capacity. */
+    canReceive(_component) {
+        const occupied = this.components?.length ?? 0;
+        return occupied < this.capacity;
+    }
+    /**
+     * Accept a carrier into this cell.
+     * Sets TRANSFER_SLOT_KEY = cellId on the carrier, then reparents.
+     * Fires 'transfer-received' so monitors can react.
+     */
+    async receive(carrier, options = {}) {
+        if (!this.canReceive(carrier)) {
+            ;
+            this.trigger?.('transfer-rejected', {
+                type: 'transfer-rejected',
+                component: carrier,
+                container: this,
+                reason: 'no-slot'
+            });
+            return;
+        }
+        carrier[TRANSFER_SLOT_KEY] = this.cellId;
+        this.reparent?.(carrier, options);
+        this.trigger?.('transfer-received', {
+            type: 'transfer-received',
+            component: carrier,
+            container: this,
+            slotId: this.cellId
+        });
+    }
+    /**
+     * Release a carrier from this cell to `target`.
+     * Delegates to `target.receive()` if available, otherwise `target.reparent()`.
+     */
+    async dispatch(carrier, target, options = {}) {
+        if (target?.canReceive && !target.canReceive(carrier)) {
+            ;
+            this.trigger?.('transfer-rejected', {
+                type: 'transfer-rejected',
+                component: carrier,
+                container: this,
+                reason: 'target-full'
+            });
+            return;
+        }
+        delete carrier[TRANSFER_SLOT_KEY];
+        if (typeof target?.receive === 'function') {
+            await target.receive(carrier, options);
+        }
+        else {
+            ;
+            target.reparent?.(carrier, options);
+        }
+        ;
+        this.trigger?.('transfer-dispatched', {
+            type: 'transfer-dispatched',
+            component: carrier,
+            container: this,
+            target
+        });
+    }
+    // ── Domain aliases ────────────────────────────────────────────────────────
+    /** Alias for receive() — semantic sugar for the storage domain. */
+    store(carrier, options) {
+        return this.receive(carrier, options);
+    }
+    /** Alias for dispatch() — semantic sugar for the storage domain. */
+    retrieve(carrier, target, options) {
+        return this.dispatch(carrier, target, options);
+    }
+    // ── 3D attach frame ───────────────────────────────────────────────────────
+    /**
+     * Return the 3D attach frame for carriers placed in this cell.
+     * Carriers are lifted by their own halfDepth so the bottom face
+     * rests at the cell's Y-center (which is levelHeight/2 above the beam).
+     */
+    attachPointFor(carrier) {
+        const root = this._realObject?.object3d;
+        if (!root)
+            return null;
+        const carrierDepth = resolveCarrierDepth(carrier);
+        return {
+            attach: root,
+            localPosition: { x: 0, y: carrierDepth / 2, z: 0 }
+        };
+    }
+    // ── 2D rendering ──────────────────────────────────────────────────────────
+    /** RackCell has no 2D visual — the rack draws its own structure. */
+    render(_ctx) {
+        // intentional no-op
+    }
+    // ── 3D ───────────────────────────────────────────────────────────────────
+    buildRealObject() {
+        return new RackCell3D(this);
+    }
+};
+RackCell = __decorate([
+    sceneComponent('rack-cell')
+], RackCell);
+export default RackCell;
+function resolveCarrierDepth(c) {
+    const eff = c._realObject?.effectiveDepth;
+    if (typeof eff === 'number' && Number.isFinite(eff))
+        return eff;
+    return numOr(c?.state?.depth, 0);
+}
+function numOr(v, dflt) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : dflt;
+}
+//# sourceMappingURL=rack-cell.js.map

package/dist/rack-cell.js.map

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

package/dist/spot.d.ts

@@ -1,7 +1,7 @@
 import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
-import { type Alignment, type Heights, type PlacementArchetype } from '@operato/scene-base';
-declare const Base: typeof Component;
-export default class Spot extends Base {
+import { type AttachFrame, type Alignment, type Heights, type PlacementArchetype } from '@operato/scene-base';
+declare const Spot_base: any;
+export default class Spot extends Spot_base {
     static placement: PlacementArchetype;
     static align: Alignment;
     static defaultDepth: (_h: Heights) => number;
@@ -29,13 +29,6 @@ export default class Spot extends Base {
      * falling back to raw `state.depth` for components built before
      * RealObject creation.
      */
-    attachPointFor(carrier: Component): {
-        attach: import("three").Object3D<import("three").Object3DEventMap>;
-        localPosition: {
-            x: number;
-            y: number;
-            z: number;
-        };
-    } | undefined;
+    attachPointFor(carrier: Component): AttachFrame | null;
 }
 export {};

package/dist/spot.js

@@ -49,8 +49,7 @@ const NATURE = {
 // `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),
 // which forces `isHTMLElement(): true` and trips the 3D pipeline's
 // addObject DOM-skip gate. Spot is purely 3D.
-const Base = CarrierHolder(Placeable(ContainerAbstract));
-let Spot = class Spot extends Base {
+let Spot = class Spot extends CarrierHolder(Placeable(ContainerAbstract)) {
     static placement = 'floor';
     static align = 'bottom';
     static defaultDepth = (_h) => 2; // a thin pad
@@ -127,7 +126,7 @@ let Spot = class Spot extends Base {
         const ro = this._realObject;
         const frame = ro?.getAttachFrame?.();
         if (!frame)
-            return undefined;
+            return null;
         const carrierDepth = resolveDepth(carrier);
         return {
             attach: frame,

package/dist/spot.js.map

@@ -1 +1 @@
-{"version":3,"file":"spot.js","sourceRoot":"","sources":["../src/spot.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Spot — virtual pickup / drop zone.\n *\n * A modeling-time anchor for \"this is where things land\" — the destination\n * of a robot arm pick-and-place, the slot of an AGV stop, the staging\n * zone next to a conveyor. Spot itself does not move and does\n * not perform any logistics action; it only marks a location and accepts\n * carrier components as children.\n *\n * Visual identity:\n *   - 2D: outlined rectangle with corner \"L\" marks (so it reads as a\n *     virtual zone, not a solid object).\n *   - 3D: a thin translucent floor pad — only the floor of the conceptual\n *     box is rendered, the side walls are absent.\n *\n * Standard things-scene properties used (no component-specific extras —\n * keep the property-panel UX uniform with other components):\n *   - `fillStyle`               — pad / outline color (sole color source)\n *   - `strokeStyle`             — outline color override (defaults to fillStyle)\n *   - `lineWidth` / `lineDash`  — outline stroke style\n *   - `alpha`                   — overall transparency, framework-applied\n *   - `text` / `fontColor` / `fontSize` / `fontFamily` / `bold` / `italic`\n *                               — label rendered by the standard text pipeline\n *   - `material3d` (3D)         — metalness / roughness / castShadow / receiveShadow\n *\n * Role: `CarrierHolder` — accepts any Carrier as a child and lays it on\n * the top face of the pad (overrides default attachPointFor).\n */\n\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Placeable,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Spot3D } from './spot-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  // No component-specific properties — fillStyle / strokeStyle / lineWidth /\n  // alpha / text / font* are framework-standard, surfaced by the property\n  // panel automatically.\n  properties: [],\n  help: 'scene/component/spot'\n}\n\n// ContainerAbstract base — Spot accepts carrier children (parcel/box/pallet/...).\n// CarrierHolder mixin only publishes the attach-point hook; the actual\n// child-list management comes from things-scene's container abstract.\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Spot is purely 3D.\nconst Base = CarrierHolder(Placeable(ContainerAbstract)) as unknown as typeof Component\n\n@sceneComponent('spot')\nexport default class Spot extends Base {\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (_h: Heights) => 2 // a thin pad\n\n  get nature(): ComponentNature {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /**\n   * 2D — outlined rectangle + corner L marks. The pad body is drawn with a\n   * fixed low alpha (0.15) on top of the user's `fillStyle` so the zone reads\n   * as virtual even when fillStyle is fully opaque. Outline + corner marks\n   * use `strokeStyle` (or fall back to `fillStyle`) at the user's `lineWidth`\n   * and `lineDash`. The text label is drawn by the framework's standard\n   * postrender pipeline using `text` / `fontColor` / `fontSize` / etc.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const fillStyle = (this.state.fillStyle as string) || '#3a8fbd'\n    const strokeStyle = (this.state.strokeStyle as string) || fillStyle\n    const lineWidth = numOr(this.state.lineWidth, 1)\n    const lineDashStyle = String(this.state.lineDash ?? 'dash')\n\n    // ── Pad body (fixed-low-alpha tint of fillStyle) ───────────────────\n    ctx.save()\n    ctx.fillStyle = fillStyle\n    ctx.globalAlpha = 0.15\n    ctx.fillRect(left, top, width, height)\n    ctx.restore()\n\n    // ── Outline ────────────────────────────────────────────────────────\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = lineWidth\n    applyLineDash(ctx, lineDashStyle, lineWidth)\n    ctx.strokeRect(\n      left + lineWidth / 2,\n      top + lineWidth / 2,\n      width - lineWidth,\n      height - lineWidth\n    )\n    ctx.setLineDash([])\n    ctx.restore()\n\n    // ── Corner L marks (solid, slightly heavier than outline) ──────────\n    const ml = Math.min(width, height) * 0.18\n    const cornerW = Math.max(lineWidth * 1.5, 1.5)\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = cornerW\n    for (const [cx, cy, sx, sy] of [\n      [left, top, 1, 1],\n      [left + width, top, -1, 1],\n      [left + width, top + height, -1, -1],\n      [left, top + height, 1, -1]\n    ] as [number, number, number, number][]) {\n      ctx.beginPath()\n      ctx.moveTo(cx + sx * ml, cy)\n      ctx.lineTo(cx, cy)\n      ctx.lineTo(cx, cy + sy * ml)\n      ctx.stroke()\n    }\n    ctx.restore()\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Spot3D(this as any)\n  }\n\n  /**\n   * Mount carriers on the TOP of the pad (Spot3D's `getAttachFrame` is\n   * already at pad-top in spot-local). Then lift the carrier by its\n   * own halfDepth so the carrier's BOTTOM rests ON the pad surface, not\n   * its volumetric center — without this lift, half the carrier would\n   * sink below the pad / floor.\n   *\n   * Reads `_realObject.effectiveDepth` first (the framework-resolved\n   * value, accounting for `static defaultDepth` and parent context),\n   * falling back to raw `state.depth` for components built before\n   * RealObject creation.\n   */\n  attachPointFor(carrier: Component) {\n    const ro = (this as any)._realObject as Spot3D | undefined\n    const frame = ro?.getAttachFrame?.()\n    if (!frame) return undefined\n    const carrierDepth = resolveDepth(carrier)\n    return {\n      attach: frame,\n      localPosition: { x: 0, y: carrierDepth / 2, z: 0 }\n    }\n  }\n}\n\nfunction resolveDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  return numOr((c as any)?.state?.depth, 0)\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n\n/**\n * Map a things-scene `lineDash` string to a Canvas dash pattern. Mirrors\n * the keys understood by things-scene's `drawer/stroke.ts` so users see\n * consistent options across components. Unknown strings fall through to\n * a plain dashed pattern instead of throwing on setLineDash.\n */\nfunction applyLineDash(ctx: CanvasRenderingContext2D, style: string, lw: number) {\n  switch (style) {\n    case 'solid':\n      ctx.setLineDash([])\n      return\n    case 'round-dot':\n      ctx.setLineDash([0.1, lw * 2])\n      ctx.lineCap = 'round'\n      return\n    case 'square-dot':\n      ctx.setLineDash([lw, lw])\n      return\n    case 'long-dash':\n      ctx.setLineDash([lw * 6, lw * 3])\n      return\n    case 'dash-dot':\n      ctx.setLineDash([lw * 4, lw * 2, lw, lw * 2])\n      return\n    case 'dash':\n    default:\n      ctx.setLineDash([lw * 4, lw * 1.5])\n      return\n  }\n}\n"]}
+{"version":3,"file":"spot.js","sourceRoot":"","sources":["../src/spot.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Spot — virtual pickup / drop zone.\n *\n * A modeling-time anchor for \"this is where things land\" — the destination\n * of a robot arm pick-and-place, the slot of an AGV stop, the staging\n * zone next to a conveyor. Spot itself does not move and does\n * not perform any logistics action; it only marks a location and accepts\n * carrier components as children.\n *\n * Visual identity:\n *   - 2D: outlined rectangle with corner \"L\" marks (so it reads as a\n *     virtual zone, not a solid object).\n *   - 3D: a thin translucent floor pad — only the floor of the conceptual\n *     box is rendered, the side walls are absent.\n *\n * Standard things-scene properties used (no component-specific extras —\n * keep the property-panel UX uniform with other components):\n *   - `fillStyle`               — pad / outline color (sole color source)\n *   - `strokeStyle`             — outline color override (defaults to fillStyle)\n *   - `lineWidth` / `lineDash`  — outline stroke style\n *   - `alpha`                   — overall transparency, framework-applied\n *   - `text` / `fontColor` / `fontSize` / `fontFamily` / `bold` / `italic`\n *                               — label rendered by the standard text pipeline\n *   - `material3d` (3D)         — metalness / roughness / castShadow / receiveShadow\n *\n * Role: `CarrierHolder` — accepts any Carrier as a child and lays it on\n * the top face of the pad (overrides default attachPointFor).\n */\n\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Spot3D } from './spot-3d.js'\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  // No component-specific properties — fillStyle / strokeStyle / lineWidth /\n  // alpha / text / font* are framework-standard, surfaced by the property\n  // panel automatically.\n  properties: [],\n  help: 'scene/component/spot'\n}\n\n// ContainerAbstract base — Spot accepts carrier children (parcel/box/pallet/...).\n// CarrierHolder mixin only publishes the attach-point hook; the actual\n// child-list management comes from things-scene's container abstract.\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Spot is purely 3D.\n@sceneComponent('spot')\nexport default class Spot extends CarrierHolder(Placeable(ContainerAbstract)) {\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (_h: Heights) => 2 // a thin pad\n\n  get nature(): ComponentNature {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /**\n   * 2D — outlined rectangle + corner L marks. The pad body is drawn with a\n   * fixed low alpha (0.15) on top of the user's `fillStyle` so the zone reads\n   * as virtual even when fillStyle is fully opaque. Outline + corner marks\n   * use `strokeStyle` (or fall back to `fillStyle`) at the user's `lineWidth`\n   * and `lineDash`. The text label is drawn by the framework's standard\n   * postrender pipeline using `text` / `fontColor` / `fontSize` / etc.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const fillStyle = (this.state.fillStyle as string) || '#3a8fbd'\n    const strokeStyle = (this.state.strokeStyle as string) || fillStyle\n    const lineWidth = numOr(this.state.lineWidth, 1)\n    const lineDashStyle = String(this.state.lineDash ?? 'dash')\n\n    // ── Pad body (fixed-low-alpha tint of fillStyle) ───────────────────\n    ctx.save()\n    ctx.fillStyle = fillStyle\n    ctx.globalAlpha = 0.15\n    ctx.fillRect(left, top, width, height)\n    ctx.restore()\n\n    // ── Outline ────────────────────────────────────────────────────────\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = lineWidth\n    applyLineDash(ctx, lineDashStyle, lineWidth)\n    ctx.strokeRect(\n      left + lineWidth / 2,\n      top + lineWidth / 2,\n      width - lineWidth,\n      height - lineWidth\n    )\n    ctx.setLineDash([])\n    ctx.restore()\n\n    // ── Corner L marks (solid, slightly heavier than outline) ──────────\n    const ml = Math.min(width, height) * 0.18\n    const cornerW = Math.max(lineWidth * 1.5, 1.5)\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = cornerW\n    for (const [cx, cy, sx, sy] of [\n      [left, top, 1, 1],\n      [left + width, top, -1, 1],\n      [left + width, top + height, -1, -1],\n      [left, top + height, 1, -1]\n    ] as [number, number, number, number][]) {\n      ctx.beginPath()\n      ctx.moveTo(cx + sx * ml, cy)\n      ctx.lineTo(cx, cy)\n      ctx.lineTo(cx, cy + sy * ml)\n      ctx.stroke()\n    }\n    ctx.restore()\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Spot3D(this as any)\n  }\n\n  /**\n   * Mount carriers on the TOP of the pad (Spot3D's `getAttachFrame` is\n   * already at pad-top in spot-local). Then lift the carrier by its\n   * own halfDepth so the carrier's BOTTOM rests ON the pad surface, not\n   * its volumetric center — without this lift, half the carrier would\n   * sink below the pad / floor.\n   *\n   * Reads `_realObject.effectiveDepth` first (the framework-resolved\n   * value, accounting for `static defaultDepth` and parent context),\n   * falling back to raw `state.depth` for components built before\n   * RealObject creation.\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = (this as any)._realObject as Spot3D | undefined\n    const frame = ro?.getAttachFrame?.()\n    if (!frame) return null\n    const carrierDepth = resolveDepth(carrier)\n    return {\n      attach: frame,\n      localPosition: { x: 0, y: carrierDepth / 2, z: 0 }\n    }\n  }\n}\n\nfunction resolveDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  return numOr((c as any)?.state?.depth, 0)\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n\n/**\n * Map a things-scene `lineDash` string to a Canvas dash pattern. Mirrors\n * the keys understood by things-scene's `drawer/stroke.ts` so users see\n * consistent options across components. Unknown strings fall through to\n * a plain dashed pattern instead of throwing on setLineDash.\n */\nfunction applyLineDash(ctx: CanvasRenderingContext2D, style: string, lw: number) {\n  switch (style) {\n    case 'solid':\n      ctx.setLineDash([])\n      return\n    case 'round-dot':\n      ctx.setLineDash([0.1, lw * 2])\n      ctx.lineCap = 'round'\n      return\n    case 'square-dot':\n      ctx.setLineDash([lw, lw])\n      return\n    case 'long-dash':\n      ctx.setLineDash([lw * 6, lw * 3])\n      return\n    case 'dash-dot':\n      ctx.setLineDash([lw * 4, lw * 2, lw, lw * 2])\n      return\n    case 'dash':\n    default:\n      ctx.setLineDash([lw * 4, lw * 1.5])\n      return\n  }\n}\n"]}

package/dist/templates/index.d.ts

@@ -36,6 +36,7 @@ declare const _default: ({
         bays?: undefined;
         status?: undefined;
         carriageHeight?: undefined;
+        components?: undefined;
     };
 } | {
     type: string;
@@ -53,6 +54,7 @@ declare const _default: ({
         bays?: undefined;
         status?: undefined;
         carriageHeight?: undefined;
+        components?: undefined;
     };
 } | {
     type: string;
@@ -70,6 +72,7 @@ declare const _default: ({
         material?: undefined;
         status?: undefined;
         carriageHeight?: undefined;
+        components?: undefined;
     };
 } | {
     type: string;
@@ -87,6 +90,45 @@ declare const _default: ({
         material?: undefined;
         levels?: undefined;
         bays?: undefined;
+        components?: undefined;
+    };
+} | {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        components: ({
+            type: string;
+            top: number;
+            left: number;
+            width: number;
+            height: number;
+            levels: number;
+            bays: number;
+            status?: undefined;
+            carriageHeight?: undefined;
+        } | {
+            type: string;
+            top: number;
+            left: number;
+            width: number;
+            height: number;
+            status: string;
+            carriageHeight: number;
+            levels?: undefined;
+            bays?: undefined;
+        })[];
+        material?: undefined;
+        levels?: undefined;
+        bays?: undefined;
+        status?: undefined;
+        carriageHeight?: undefined;
     };
 })[];
 export default _default;

package/dist/templates/index.js

@@ -1,6 +1,6 @@
 /*
  * things-scene catalog templates for the storage domain — pallet/box/parcel
- * variants, ASRS rack/crane, and the virtual `spot` placement marker.
+ * variants, ASRS rack/crane, ASRS aisle composite, and the virtual `spot` placement marker.
  */
 import spot from './spot.js';
 const pallet = new URL('../../icons/pallet.png', import.meta.url).href;
@@ -108,6 +108,48 @@ export default [
             carriageHeight: 100
         }
     },
+    {
+        type: 'group',
+        description: 'AS/RS aisle — 4-level rack pair + stacker crane',
+        group: 'storage',
+        icon: asrsRack,
+        model: {
+            type: 'group',
+            top: 100,
+            left: 100,
+            width: 840,
+            height: 220,
+            components: [
+                {
+                    type: 'asrs-rack',
+                    top: 100,
+                    left: 100,
+                    width: 800,
+                    height: 80,
+                    levels: 4,
+                    bays: 8
+                },
+                {
+                    type: 'asrs-crane',
+                    top: 140,
+                    left: 420,
+                    width: 60,
+                    height: 220,
+                    status: 'idle',
+                    carriageHeight: 0
+                },
+                {
+                    type: 'asrs-rack',
+                    top: 320,
+                    left: 100,
+                    width: 800,
+                    height: 80,
+                    levels: 4,
+                    bays: 8
+                }
+            ]
+        }
+    },
     spot
 ];
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * things-scene catalog templates for the storage domain — pallet/box/parcel\n * variants, ASRS rack/crane, and the virtual `spot` placement marker.\n */\nimport spot from './spot.js'\nconst pallet = new URL('../../icons/pallet.png', import.meta.url).href\nconst box = new URL('../../icons/box.png', import.meta.url).href\nconst parcel = new URL('../../icons/parcel.png', import.meta.url).href\nconst asrsRack = new URL('../../icons/asrs-rack.png', import.meta.url).href\nconst asrsCrane = new URL('../../icons/asrs-crane.png', import.meta.url).href\n\nexport default [\n  {\n    type: 'pallet',\n    description: 'wood pallet (EUR / EPAL)',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 100,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'pallet',\n    description: 'plastic pallet',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 250,\n      width: 80,\n      height: 80,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'box',\n    description: 'wood crate',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 400,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'box',\n    description: 'plastic tote',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 520,\n      width: 80,\n      height: 80,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'parcel',\n    description: 'cardboard parcel',\n    group: 'storage',\n    icon: parcel,\n    model: {\n      type: 'parcel',\n      top: 100,\n      left: 640,\n      width: 60,\n      height: 80\n    }\n  },\n  {\n    type: 'asrs-rack',\n    description: 'AS/RS storage rack (multi-level)',\n    group: 'storage',\n    icon: asrsRack,\n    model: {\n      type: 'asrs-rack',\n      top: 300,\n      left: 100,\n      width: 800,\n      height: 200,\n      levels: 4,\n      bays: 5\n    }\n  },\n  {\n    type: 'asrs-crane',\n    description: 'AS/RS stacker crane',\n    group: 'storage',\n    icon: asrsCrane,\n    model: {\n      type: 'asrs-crane',\n      top: 550,\n      left: 400,\n      width: 100,\n      height: 200,\n      status: 'idle',\n      carriageHeight: 100\n    }\n  },\n  spot\n]\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * things-scene catalog templates for the storage domain — pallet/box/parcel\n * variants, ASRS rack/crane, ASRS aisle composite, and the virtual `spot` placement marker.\n */\nimport spot from './spot.js'\nconst pallet = new URL('../../icons/pallet.png', import.meta.url).href\nconst box = new URL('../../icons/box.png', import.meta.url).href\nconst parcel = new URL('../../icons/parcel.png', import.meta.url).href\nconst asrsRack = new URL('../../icons/asrs-rack.png', import.meta.url).href\nconst asrsCrane = new URL('../../icons/asrs-crane.png', import.meta.url).href\n\nexport default [\n  {\n    type: 'pallet',\n    description: 'wood pallet (EUR / EPAL)',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 100,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'pallet',\n    description: 'plastic pallet',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 250,\n      width: 80,\n      height: 80,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'box',\n    description: 'wood crate',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 400,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'box',\n    description: 'plastic tote',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 520,\n      width: 80,\n      height: 80,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'parcel',\n    description: 'cardboard parcel',\n    group: 'storage',\n    icon: parcel,\n    model: {\n      type: 'parcel',\n      top: 100,\n      left: 640,\n      width: 60,\n      height: 80\n    }\n  },\n  {\n    type: 'asrs-rack',\n    description: 'AS/RS storage rack (multi-level)',\n    group: 'storage',\n    icon: asrsRack,\n    model: {\n      type: 'asrs-rack',\n      top: 300,\n      left: 100,\n      width: 800,\n      height: 200,\n      levels: 4,\n      bays: 5\n    }\n  },\n  {\n    type: 'asrs-crane',\n    description: 'AS/RS stacker crane',\n    group: 'storage',\n    icon: asrsCrane,\n    model: {\n      type: 'asrs-crane',\n      top: 550,\n      left: 400,\n      width: 100,\n      height: 200,\n      status: 'idle',\n      carriageHeight: 100\n    }\n  },\n  {\n    type: 'group',\n    description: 'AS/RS aisle — 4-level rack pair + stacker crane',\n    group: 'storage',\n    icon: asrsRack,\n    model: {\n      type: 'group',\n      top: 100,\n      left: 100,\n      width: 840,\n      height: 220,\n      components: [\n        {\n          type: 'asrs-rack',\n          top: 100,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        },\n        {\n          type: 'asrs-crane',\n          top: 140,\n          left: 420,\n          width: 60,\n          height: 220,\n          status: 'idle',\n          carriageHeight: 0\n        },\n        {\n          type: 'asrs-rack',\n          top: 320,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        }\n      ]\n    }\n  },\n  spot\n]\n"]}