@operato/scene-storage 10.0.0-beta.22

package/dist/pallet-3d.js

@@ -0,0 +1,162 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Pallet 3D — wood and plastic variants.
+ *
+ * LO-POLY but structurally distinguishing the two materials:
+ *
+ *   - wood:    parallel top slats with gaps between + 3 perpendicular
+ *              stringers (the classic EUR pallet silhouette) + parallel
+ *              bottom slats. The forklift entry holes between stringers are
+ *              the wood pallet's visual signature.
+ *   - plastic: solid molded top deck (with a few suggestion cutouts as visual
+ *              detail) + ribbed underside / feet. No discrete slats — the
+ *              plastic pallet's signature is the seamless one-piece look.
+ *
+ * Color comes from `state.bodyColor` (Legendable, driven by `material`).
+ * Stringer / underside colors are slightly darker tints derived from bodyColor.
+ */
+import * as THREE from 'three';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export class Pallet3D extends RealObjectGroup {
+    build() {
+        super.build();
+        const { width, height, depth = 150 } = this.component.state;
+        const material = this.component.state.material || 'wood';
+        const bodyColor = this.component.state.bodyColor || '#a87644';
+        if (material === 'plastic') {
+            this.buildPlastic(width, height, depth, bodyColor);
+        }
+        else {
+            this.buildWood(width, height, depth, bodyColor);
+        }
+    }
+    /** Wood EUR-style: 7 top slats + 3 stringers + 5 bottom slats. */
+    buildWood(width, height, depth, bodyColor) {
+        const baseY = -depth / 2;
+        const slatThickness = depth * 0.15;
+        const stringerThickness = depth * 0.45;
+        const bottomSlatThickness = depth * 0.13;
+        const woodMaterial = new THREE.MeshStandardMaterial({
+            color: bodyColor,
+            metalness: 0.0,
+            roughness: 0.85
+        });
+        const stringerColor = new THREE.Color(bodyColor).multiplyScalar(0.85);
+        const stringerMaterial = new THREE.MeshStandardMaterial({
+            color: stringerColor,
+            metalness: 0.0,
+            roughness: 0.9
+        });
+        // ── Top + bottom slats — same count, same z-positions, paired vertically ─
+        // EUR-pallet style: 5 boards on top, 5 below (under the same z ranges so
+        // they read as a single skeleton rather than two unrelated grids).
+        const slatCount = 5;
+        const slatW = width;
+        const slatD = (height * 0.92) / (slatCount + (slatCount - 1) * 0.4);
+        const gapD = slatD * 0.4;
+        const totalSpan = slatCount * slatD + (slatCount - 1) * gapD;
+        const startZ = -totalSpan / 2;
+        const slatPositions = [];
+        for (let i = 0; i < slatCount; i++) {
+            slatPositions.push(startZ + i * (slatD + gapD) + slatD / 2);
+        }
+        const topSlatGeos = [];
+        for (const z of slatPositions) {
+            const slat = new THREE.BoxGeometry(slatW, slatThickness, slatD);
+            slat.translate(0, baseY + depth - slatThickness / 2, z);
+            topSlatGeos.push(slat);
+        }
+        const topSlatMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(topSlatGeos), woodMaterial);
+        topSlatMesh.castShadow = true;
+        topSlatMesh.receiveShadow = true;
+        this.object3d.add(topSlatMesh);
+        // ── Stringers (3 perpendicular blocks between top and bottom decks) ─
+        const stringerCount = 3;
+        const stringerW = width * 0.07;
+        const stringerY = baseY + bottomSlatThickness + stringerThickness / 2;
+        const stringerGeos = [];
+        for (let i = 0; i < stringerCount; i++) {
+            const xFrac = i / (stringerCount - 1) - 0.5;
+            const x = xFrac * (width * 0.85);
+            const stringer = new THREE.BoxGeometry(stringerW, stringerThickness, height);
+            stringer.translate(x, stringerY, 0);
+            stringerGeos.push(stringer);
+        }
+        const stringerMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(stringerGeos), stringerMaterial);
+        stringerMesh.castShadow = true;
+        this.object3d.add(stringerMesh);
+        // ── Bottom slats — same z-positions as top so the deck reads as paired ─
+        const botSlatGeos = [];
+        for (const z of slatPositions) {
+            const slat = new THREE.BoxGeometry(width, bottomSlatThickness, slatD);
+            slat.translate(0, baseY + bottomSlatThickness / 2, z);
+            botSlatGeos.push(slat);
+        }
+        const botSlatMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(botSlatGeos), woodMaterial);
+        botSlatMesh.receiveShadow = true;
+        this.object3d.add(botSlatMesh);
+    }
+    /** Plastic molded: solid top deck + ribbed underside / feet. */
+    buildPlastic(width, height, depth, bodyColor) {
+        const baseY = -depth / 2;
+        const deckThickness = depth * 0.30;
+        const footH = depth * 0.55;
+        const footW = width * 0.12;
+        const deckMaterial = new THREE.MeshStandardMaterial({
+            color: bodyColor,
+            metalness: 0.1,
+            roughness: 0.55
+        });
+        const footColor = new THREE.Color(bodyColor).multiplyScalar(0.85);
+        const footMaterial = new THREE.MeshStandardMaterial({
+            color: footColor,
+            metalness: 0.1,
+            roughness: 0.65
+        });
+        // ── Solid top deck ───────────────────────────────────────────────
+        const deckGeo = new THREE.BoxGeometry(width * 0.98, deckThickness, height * 0.98);
+        const deckMesh = new THREE.Mesh(deckGeo, deckMaterial);
+        deckMesh.position.set(0, baseY + depth - deckThickness / 2, 0);
+        deckMesh.castShadow = true;
+        deckMesh.receiveShadow = true;
+        this.object3d.add(deckMesh);
+        // ── 9 feet (3×3 grid — typical plastic pallet underside) ─────────
+        const footGeos = [];
+        for (let i = -1; i <= 1; i++) {
+            for (let j = -1; j <= 1; j++) {
+                const x = i * (width * 0.4);
+                const z = j * (height * 0.4);
+                const foot = new THREE.BoxGeometry(footW, footH, footW);
+                foot.translate(x, baseY + footH / 2, z);
+                footGeos.push(foot);
+            }
+        }
+        const footMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(footGeos), footMaterial);
+        footMesh.castShadow = true;
+        this.object3d.add(footMesh);
+        // ── Cross-bracing along underside (suggests molded reinforcement) ─
+        const braceH = depth * 0.10;
+        const braceGeo = new THREE.BoxGeometry(width * 0.95, braceH, height * 0.04);
+        for (const zSign of [-1, 0, 1]) {
+            const brace = new THREE.Mesh(braceGeo.clone(), footMaterial);
+            brace.position.set(0, baseY + footH - braceH / 2, zSign * height * 0.4);
+            this.object3d.add(brace);
+        }
+    }
+    updateDimension() { }
+    onchange(after, before) {
+        if ('material' in after ||
+            'bodyColor' in after ||
+            'width' in after ||
+            'height' in after ||
+            'depth' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+    updateAlpha() { }
+}
+//# sourceMappingURL=pallet-3d.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pallet-3d.js","sourceRoot":"","sources":["../src/pallet-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Pallet 3D — wood and plastic variants.\n *\n * LO-POLY but structurally distinguishing the two materials:\n *\n *   - wood:    parallel top slats with gaps between + 3 perpendicular\n *              stringers (the classic EUR pallet silhouette) + parallel\n *              bottom slats. The forklift entry holes between stringers are\n *              the wood pallet's visual signature.\n *   - plastic: solid molded top deck (with a few suggestion cutouts as visual\n *              detail) + ribbed underside / feet. No discrete slats — the\n *              plastic pallet's signature is the seamless one-piece look.\n *\n * Color comes from `state.bodyColor` (Legendable, driven by `material`).\n * Stringer / underside colors are slightly darker tints derived from bodyColor.\n */\n\nimport * as THREE from 'three'\nimport * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nexport class Pallet3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 150 } = this.component.state\n    const material = (this.component.state.material as string) || 'wood'\n    const bodyColor = (this.component.state.bodyColor as string) || '#a87644'\n\n    if (material === 'plastic') {\n      this.buildPlastic(width, height, depth, bodyColor)\n    } else {\n      this.buildWood(width, height, depth, bodyColor)\n    }\n  }\n\n  /** Wood EUR-style: 7 top slats + 3 stringers + 5 bottom slats. */\n  private buildWood(width: number, height: number, depth: number, bodyColor: string) {\n    const baseY = -depth / 2\n    const slatThickness = depth * 0.15\n    const stringerThickness = depth * 0.45\n    const bottomSlatThickness = depth * 0.13\n\n    const woodMaterial = new THREE.MeshStandardMaterial({\n      color: bodyColor,\n      metalness: 0.0,\n      roughness: 0.85\n    })\n    const stringerColor = new THREE.Color(bodyColor).multiplyScalar(0.85)\n    const stringerMaterial = new THREE.MeshStandardMaterial({\n      color: stringerColor,\n      metalness: 0.0,\n      roughness: 0.9\n    })\n\n    // ── Top + bottom slats — same count, same z-positions, paired vertically ─\n    // EUR-pallet style: 5 boards on top, 5 below (under the same z ranges so\n    // they read as a single skeleton rather than two unrelated grids).\n    const slatCount = 5\n    const slatW = width\n    const slatD = (height * 0.92) / (slatCount + (slatCount - 1) * 0.4)\n    const gapD = slatD * 0.4\n    const totalSpan = slatCount * slatD + (slatCount - 1) * gapD\n    const startZ = -totalSpan / 2\n\n    const slatPositions: number[] = []\n    for (let i = 0; i < slatCount; i++) {\n      slatPositions.push(startZ + i * (slatD + gapD) + slatD / 2)\n    }\n\n    const topSlatGeos: THREE.BufferGeometry[] = []\n    for (const z of slatPositions) {\n      const slat = new THREE.BoxGeometry(slatW, slatThickness, slatD)\n      slat.translate(0, baseY + depth - slatThickness / 2, z)\n      topSlatGeos.push(slat)\n    }\n    const topSlatMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(topSlatGeos), woodMaterial)\n    topSlatMesh.castShadow = true\n    topSlatMesh.receiveShadow = true\n    this.object3d.add(topSlatMesh)\n\n    // ── Stringers (3 perpendicular blocks between top and bottom decks) ─\n    const stringerCount = 3\n    const stringerW = width * 0.07\n    const stringerY = baseY + bottomSlatThickness + stringerThickness / 2\n    const stringerGeos: THREE.BufferGeometry[] = []\n    for (let i = 0; i < stringerCount; i++) {\n      const xFrac = i / (stringerCount - 1) - 0.5\n      const x = xFrac * (width * 0.85)\n      const stringer = new THREE.BoxGeometry(stringerW, stringerThickness, height)\n      stringer.translate(x, stringerY, 0)\n      stringerGeos.push(stringer)\n    }\n    const stringerMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(stringerGeos), stringerMaterial)\n    stringerMesh.castShadow = true\n    this.object3d.add(stringerMesh)\n\n    // ── Bottom slats — same z-positions as top so the deck reads as paired ─\n    const botSlatGeos: THREE.BufferGeometry[] = []\n    for (const z of slatPositions) {\n      const slat = new THREE.BoxGeometry(width, bottomSlatThickness, slatD)\n      slat.translate(0, baseY + bottomSlatThickness / 2, z)\n      botSlatGeos.push(slat)\n    }\n    const botSlatMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(botSlatGeos), woodMaterial)\n    botSlatMesh.receiveShadow = true\n    this.object3d.add(botSlatMesh)\n  }\n\n  /** Plastic molded: solid top deck + ribbed underside / feet. */\n  private buildPlastic(width: number, height: number, depth: number, bodyColor: string) {\n    const baseY = -depth / 2\n    const deckThickness = depth * 0.30\n    const footH = depth * 0.55\n    const footW = width * 0.12\n\n    const deckMaterial = new THREE.MeshStandardMaterial({\n      color: bodyColor,\n      metalness: 0.1,\n      roughness: 0.55\n    })\n    const footColor = new THREE.Color(bodyColor).multiplyScalar(0.85)\n    const footMaterial = new THREE.MeshStandardMaterial({\n      color: footColor,\n      metalness: 0.1,\n      roughness: 0.65\n    })\n\n    // ── Solid top deck ───────────────────────────────────────────────\n    const deckGeo = new THREE.BoxGeometry(width * 0.98, deckThickness, height * 0.98)\n    const deckMesh = new THREE.Mesh(deckGeo, deckMaterial)\n    deckMesh.position.set(0, baseY + depth - deckThickness / 2, 0)\n    deckMesh.castShadow = true\n    deckMesh.receiveShadow = true\n    this.object3d.add(deckMesh)\n\n    // ── 9 feet (3×3 grid — typical plastic pallet underside) ─────────\n    const footGeos: THREE.BufferGeometry[] = []\n    for (let i = -1; i <= 1; i++) {\n      for (let j = -1; j <= 1; j++) {\n        const x = i * (width * 0.4)\n        const z = j * (height * 0.4)\n        const foot = new THREE.BoxGeometry(footW, footH, footW)\n        foot.translate(x, baseY + footH / 2, z)\n        footGeos.push(foot)\n      }\n    }\n    const footMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(footGeos), footMaterial)\n    footMesh.castShadow = true\n    this.object3d.add(footMesh)\n\n    // ── Cross-bracing along underside (suggests molded reinforcement) ─\n    const braceH = depth * 0.10\n    const braceGeo = new THREE.BoxGeometry(width * 0.95, braceH, height * 0.04)\n    for (const zSign of [-1, 0, 1]) {\n      const brace = new THREE.Mesh(braceGeo.clone(), footMaterial)\n      brace.position.set(0, baseY + footH - braceH / 2, zSign * height * 0.4)\n      this.object3d.add(brace)\n    }\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if (\n      'material' in after ||\n      'bodyColor' in after ||\n      'width' in after ||\n      'height' in after ||\n      'depth' in after\n    ) {\n      this.update()\n      return\n    }\n    super.onchange(after, before)\n  }\n\n  updateAlpha() {}\n}\n"]}

package/dist/pallet.d.ts

@@ -0,0 +1,56 @@
+import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { type Alignment, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
+/**
+ * Pallet material — drives both 2D fill color and 3D structure.
+ *
+ * - `wood`     — traditional EUR / EPAL pallet: parallel slats on top and
+ *                bottom, three perpendicular stringers between them.
+ * - `plastic`  — molded one-piece pallet: solid top deck with cutouts,
+ *                hollow underside with feet. Distinct ribbed underside.
+ *
+ * Adding a third material (e.g. metal, composite) is a one-line change to the
+ * legend + a 3D variant in pallet-3d.ts.
+ */
+export type PalletMaterial = 'wood' | 'plastic';
+declare const Base: typeof Component;
+/**
+ * Pallet — a flat transport structure that goods are stacked and stored on.
+ *
+ * Standard EUR pallet is 1200 × 800mm × 144mm; we don't enforce these
+ * dimensions but they're a good starting point for the catalog templates.
+ *
+ * **Container-based.** Boxes / parcels stacked on the pallet are added as
+ * children — same `containable()` archetype-filter pattern as Forklift / Agv.
+ * Visual stacking (children rendering on top of the pallet rather than at
+ * absolute operation level) is a v2 concern; see ARCHITECTURE NOTES below.
+ *
+ * **Placement = `operation`.** A pallet's *normal* state is loaded and in
+ * transit on a conveyor / AGV / forklift fork — at operation level. Empty
+ * pallets in a floor-storage area are an exceptional state where the user
+ * sets `state.zPos = 0` explicitly. Default to the common case.
+ *
+ * ## ARCHITECTURE NOTES — visual stacking
+ *
+ * When a Box (also `placement: 'operation'`) is added as a child of a
+ * Pallet, both default to z = operation_height. They overlap visually
+ * rather than the box sitting on top of the pallet. Solving this cleanly
+ * (parent-relative z derivation when the parent is a structural carrier)
+ * is a follow-up — fmsim's pattern is to detect parent type at render time
+ * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the
+ * detection.
+ */
+export default class Pallet extends Base {
+    static legends: Record<string, LegendBinding>;
+    static placement: PlacementArchetype;
+    static align: Alignment;
+    static defaultDepth: number;
+    get nature(): ComponentNature;
+    get anchors(): never[];
+    /** Accept other operation-archetype cargo (boxes, parcels, smaller pallets) as stacked children. */
+    containable(component: Component): boolean;
+    /** 2D — top-down rectangle. */
+    render(ctx: CanvasRenderingContext2D): void;
+    get fillStyle(): string;
+    buildRealObject(): RealObject | undefined;
+}
+export {};

package/dist/pallet.js

@@ -0,0 +1,99 @@
+import { __decorate } from "tslib";
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ */
+import { Container, sceneComponent } from '@hatiolab/things-scene';
+import { Carriable, Legendable, Placeable } from '@operato/scene-base';
+import { Pallet3D } from './pallet-3d.js';
+const BODY_LEGEND = {
+    wood: '#a87644',
+    plastic: '#5a6a78',
+    default: '#a87644'
+};
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: true,
+    properties: [
+        {
+            type: 'select',
+            label: 'material',
+            name: 'material',
+            property: {
+                options: [
+                    { display: 'Wood', value: 'wood' },
+                    { display: 'Plastic', value: 'plastic' }
+                ]
+            }
+        }
+    ],
+    help: 'scene/component/pallet'
+};
+// Carriable: a pallet can sit on AGV / Forklift / robot-arm gripper / Spot
+// and also accept boxes / parcels as children (Container base provides the
+// child-container behavior; Carriable only adds the holder-mount hook).
+const Base = Carriable(Legendable(Placeable(Container)));
+/**
+ * Pallet — a flat transport structure that goods are stacked and stored on.
+ *
+ * Standard EUR pallet is 1200 × 800mm × 144mm; we don't enforce these
+ * dimensions but they're a good starting point for the catalog templates.
+ *
+ * **Container-based.** Boxes / parcels stacked on the pallet are added as
+ * children — same `containable()` archetype-filter pattern as Forklift / Agv.
+ * Visual stacking (children rendering on top of the pallet rather than at
+ * absolute operation level) is a v2 concern; see ARCHITECTURE NOTES below.
+ *
+ * **Placement = `operation`.** A pallet's *normal* state is loaded and in
+ * transit on a conveyor / AGV / forklift fork — at operation level. Empty
+ * pallets in a floor-storage area are an exceptional state where the user
+ * sets `state.zPos = 0` explicitly. Default to the common case.
+ *
+ * ## ARCHITECTURE NOTES — visual stacking
+ *
+ * When a Box (also `placement: 'operation'`) is added as a child of a
+ * Pallet, both default to z = operation_height. They overlap visually
+ * rather than the box sitting on top of the pallet. Solving this cleanly
+ * (parent-relative z derivation when the parent is a structural carrier)
+ * is a follow-up — fmsim's pattern is to detect parent type at render time
+ * (machine-3d.ts:113-122). v1 accepts the visual overlap; v2 will add the
+ * detection.
+ */
+let Pallet = class Pallet extends Base {
+    static legends = {
+        bodyColor: { from: 'material', legend: BODY_LEGEND }
+    };
+    static placement = 'operation';
+    static align = 'bottom';
+    static defaultDepth = 150; // EUR pallet is 144mm; 150 is the round number convention
+    get nature() {
+        return NATURE;
+    }
+    get anchors() {
+        return [];
+    }
+    /** Accept other operation-archetype cargo (boxes, parcels, smaller pallets) as stacked children. */
+    containable(component) {
+        const archetype = component.constructor.placement;
+        if (archetype === 'operation')
+            return true;
+        return component.isDescendible(this);
+    }
+    /** 2D — top-down rectangle. */
+    render(ctx) {
+        const { width, height, left, top } = this.state;
+        ctx.beginPath();
+        ctx.rect(left, top, width, height);
+    }
+    get fillStyle() {
+        return this.state.bodyColor || '#a87644';
+    }
+    buildRealObject() {
+        return new Pallet3D(this);
+    }
+};
+Pallet = __decorate([
+    sceneComponent('pallet')
+], Pallet);
+export default Pallet;
+//# sourceMappingURL=pallet.js.map

package/dist/pallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pallet.js","sourceRoot":"","sources":["../src/pallet.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA8B,SAAS,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC1G,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EAIV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAezC,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,wBAAwB;CAC/B,CAAA;AAED,2EAA2E;AAC3E,2EAA2E;AAC3E,wEAAwE;AACxE,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAgC,CAAA;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEY,IAAM,MAAM,GAAZ,MAAM,MAAO,SAAQ,IAAI;IACtC,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,CAAC,0DAA0D;IAEpF,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,oGAAoG;IACpG,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,+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,QAAQ,CAAC,IAAW,CAAC,CAAA;IAClC,CAAC;;AArCkB,MAAM;IAD1B,cAAc,CAAC,QAAQ,CAAC;GACJ,MAAM,CAsC1B;eAtCoB,MAAM","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, Container, 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 (Container base provides the\n// child-container behavior; Carriable only adds the holder-mount hook).\nconst Base = Carriable(Legendable(Placeable(Container))) 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  /** 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 Pallet3D(this as any)\n  }\n}\n"]}

package/dist/parcel-3d.d.ts

@@ -0,0 +1,7 @@
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class Parcel3D extends RealObjectGroup {
+    build(): void;
+    updateDimension(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    updateAlpha(): void;
+}

package/dist/parcel-3d.js

@@ -0,0 +1,82 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Parcel 3D — a cardboard package.
+ *
+ * Structure:
+ *   - main body box (cardboard color)
+ *   - tape line running across the top (the visual signature — what makes
+ *     this read as a "shipping parcel" rather than a generic box)
+ *   - small label area on top (white rectangle suggesting a shipping label)
+ *
+ * Kept very simple — parcels in a logistics scene are typically present in
+ * large numbers (sortation lines, fulfillment bays), so polygon count
+ * matters more than it does for one-off equipment.
+ */
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+const CARDBOARD_COLOR = 0xc8a878;
+const TAPE_COLOR = 0xddc899;
+const LABEL_COLOR = 0xeeeeee;
+export class Parcel3D extends RealObjectGroup {
+    build() {
+        super.build();
+        const { width, height, depth = 150 } = this.component.state;
+        const baseY = -depth / 2;
+        // ── Main body ────────────────────────────────────────────────────
+        const bodyGeo = new THREE.BoxGeometry(width, depth, height);
+        const bodyMaterial = new THREE.MeshStandardMaterial({
+            color: CARDBOARD_COLOR,
+            metalness: 0,
+            roughness: 0.9
+        });
+        const bodyMesh = new THREE.Mesh(bodyGeo, bodyMaterial);
+        bodyMesh.position.set(0, 0, 0);
+        bodyMesh.castShadow = true;
+        bodyMesh.receiveShadow = true;
+        this.object3d.add(bodyMesh);
+        // ── Tape line on top (running along the long axis) ───────────────
+        const tapeW = Math.min(width, height) * 0.10;
+        const tapeT = depth * 0.02;
+        const tapeAlongLong = width >= height;
+        const tapeGeo = tapeAlongLong
+            ? new THREE.BoxGeometry(width * 1.005, tapeT, tapeW)
+            : new THREE.BoxGeometry(tapeW, tapeT, height * 1.005);
+        const tapeMaterial = new THREE.MeshStandardMaterial({
+            color: TAPE_COLOR,
+            metalness: 0.05,
+            roughness: 0.5
+        });
+        const tapeMesh = new THREE.Mesh(tapeGeo, tapeMaterial);
+        tapeMesh.position.set(0, baseY + depth + tapeT / 2 - 0.01, 0);
+        this.object3d.add(tapeMesh);
+        // ── Shipping label (small white rectangle on top) ────────────────
+        const labelW = Math.min(width, height) * 0.35;
+        const labelH = labelW * 0.6;
+        const labelGeo = new THREE.BoxGeometry(labelW, depth * 0.005, labelH);
+        const labelMaterial = new THREE.MeshStandardMaterial({
+            color: LABEL_COLOR,
+            metalness: 0,
+            roughness: 0.4
+        });
+        const labelMesh = new THREE.Mesh(labelGeo, labelMaterial);
+        // Position on top, off-center by ~25% of long axis
+        if (tapeAlongLong) {
+            labelMesh.position.set(width * 0.2, baseY + depth + depth * 0.0025, -height * 0.15);
+        }
+        else {
+            labelMesh.position.set(width * 0.15, baseY + depth + depth * 0.0025, height * 0.2);
+        }
+        this.object3d.add(labelMesh);
+    }
+    updateDimension() { }
+    onchange(after, before) {
+        if ('width' in after || 'height' in after || 'depth' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+    updateAlpha() { }
+}
+//# sourceMappingURL=parcel-3d.js.map

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

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

package/dist/parcel.d.ts

@@ -0,0 +1,30 @@
+import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { type Alignment, type PlacementArchetype } from '@operato/scene-base';
+declare const Base: typeof Component;
+/**
+ * Parcel — a cardboard package, the typical e-commerce / parcel-sortation unit.
+ *
+ * Distinct from `Box` because parcels have:
+ *   - cardboard appearance (tan/brown corrugate, not wood / plastic)
+ *   - tape line down the center (the visual signature that says "package")
+ *   - typically a label on top (where shipping info goes)
+ *   - flatter / more elongated proportions in real-world parcel networks
+ *
+ * No `material` prop — parcels are always cardboard. If a future shipping
+ * domain needs metal cases or polybags, those become separate components.
+ *
+ * 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 {
+    static placement: PlacementArchetype;
+    static align: Alignment;
+    static defaultDepth: number;
+    get nature(): ComponentNature;
+    get anchors(): never[];
+    /** 2D — top-down rectangle in cardboard tan. */
+    render(ctx: CanvasRenderingContext2D): void;
+    get fillStyle(): string;
+    buildRealObject(): RealObject | undefined;
+}
+export {};

package/dist/parcel.js

@@ -0,0 +1,67 @@
+import { __decorate } from "tslib";
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ */
+import { RectPath, Shape, sceneComponent } from '@hatiolab/things-scene';
+import { Carriable, Placeable } from '@operato/scene-base';
+import { Parcel3D } from './parcel-3d.js';
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: true,
+    properties: [
+        {
+            type: 'string',
+            label: 'tracking-id',
+            name: 'trackingId'
+        }
+    ],
+    help: 'scene/component/parcel'
+};
+// 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.
+ *
+ * Distinct from `Box` because parcels have:
+ *   - cardboard appearance (tan/brown corrugate, not wood / plastic)
+ *   - tape line down the center (the visual signature that says "package")
+ *   - typically a label on top (where shipping info goes)
+ *   - flatter / more elongated proportions in real-world parcel networks
+ *
+ * No `material` prop — parcels are always cardboard. If a future shipping
+ * domain needs metal cases or polybags, those become separate components.
+ *
+ * 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 {
+    static placement = 'operation';
+    static align = 'bottom';
+    static defaultDepth = 150;
+    get nature() {
+        return NATURE;
+    }
+    get anchors() {
+        return [];
+    }
+    /** 2D — top-down rectangle in cardboard tan. */
+    render(ctx) {
+        const { width, height, left, top } = this.state;
+        ctx.beginPath();
+        ctx.rect(left, top, width, height);
+    }
+    get fillStyle() {
+        return '#c8a878';
+    }
+    buildRealObject() {
+        return new Parcel3D(this);
+    }
+};
+Parcel = __decorate([
+    sceneComponent('parcel')
+], Parcel);
+export default Parcel;
+//# sourceMappingURL=parcel.js.map

package/dist/parcel.js.map

@@ -0,0 +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"]}

package/dist/spot-3d.d.ts

@@ -0,0 +1,30 @@
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class Spot3D extends RealObjectGroup {
+    build(): void;
+    /**
+     * Build the label as a canvas-textured quad. Uses the same `fontStyle`
+     * helper things-scene uses for its 2D text rendering, so the label
+     * here matches what the property panel previews.
+     */
+    private _buildLabel;
+    /**
+     * The sub-frame that carrier components should mount onto.
+     *
+     * Semantically Spot is a virtual cuboid SPACE — it marks "stuff goes
+     * here" — and carriers are placed INSIDE that space, resting on the
+     * cuboid's BOTTOM face. So the attach frame sits at the cuboid's
+     * bottom (`y = -d/2` in spot-local), NOT at the top of the rendered
+     * pad. The pad is just a translucent visual marker for the zone; the
+     * floor of the conceptual volume is what carriers stand on.
+     *
+     * The Spot.attachPointFor mixin lifts the carrier by its own halfDepth
+     * (in the +Y direction within this frame), placing the carrier's
+     * BOTTOM face exactly at the cuboid floor.
+     */
+    getAttachFrame(): THREE.Object3D;
+    private _attachFrame?;
+    updateDimension(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    updateAlpha(): void;
+}