@operato/scene-transport 10.0.0-beta.22

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [10.0.0-beta.22](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.21...v10.0.0-beta.22) (2026-04-30)
+
+
+### :rocket: New Features
+
+* **scene-facility,base:** add Floor + placeholder icons + base config fix ([830d57e](https://github.com/things-scene/operato-scene/commit/830d57ee8ecd7a31e7289f7cd6fe52027aa0380a))
+* **scene-transport,storage:** rebuild Forklift3D from scratch + align Pallet decks ([83aa335](https://github.com/things-scene/operato-scene/commit/83aa33531ce24615dc15e295d28872dec85e29de))
+* **scene-transport:** add Agv (payload) + Tugger (towing) — Phase A4 ([094fd1c](https://github.com/things-scene/operato-scene/commit/094fd1caea1bfb4e6a8c581147972a491436c99b))
+* **scene-transport:** Forklift3D — sculpted side profile + aesthetic detail ([3603a62](https://github.com/things-scene/operato-scene/commit/3603a62f89763469859d96fdf6b4665ea96da7f1))
+* **scene-transport:** polish 3D models + add 2D top-view silhouettes ([9315c01](https://github.com/things-scene/operato-scene/commit/9315c01574d77ec35dc20731151b5eb8372fd545))
+* **scene:** @operato/scene-transport — Forklift + Worker (Phase A3) ([5ca4953](https://github.com/things-scene/operato-scene/commit/5ca4953b7c7cd96e608d174aa45361a92de69e9e))
+
+
+### :bug: Bug Fix
+
+* **scene-base,storage,transport:** rescale heights to scene units, clamp mast travel, operation cargo defaults to floor ([bd545d2](https://github.com/things-scene/operato-scene/commit/bd545d2ba9f41d97acc8d75b249e16aff4720258))
+
+
+### :house: Code Refactoring
+
+* **templates:** split warehouse → facility/conveyance/storage/transport + i18n ([4d0b726](https://github.com/things-scene/operato-scene/commit/4d0b7260fb515c904d6c1ebd8c37ef3193244ab8))

package/README.md

@@ -0,0 +1,55 @@
+# @operato/scene-transport
+
+**Transport** domain components for things-scene — the moving parts of smart-factory and logistics floors.
+
+## Domain context
+
+This package collects the *vehicles and operators* of a logistics line — the components that *move* across the floor between fixed conveyance and storage assets. Each component declares its placement archetype via `@operato/scene-base` (typically `floor` + `bottom`) so vertical positioning is automatic against the scene's `StandardHeights`.
+
+Initial set: Forklift, Worker. Planned: AGV (two types — towing / payload), AMR.
+
+## First package to use scene-base from scratch
+
+Conveyance was migrated retroactively. Transport is the first domain package to use `@operato/scene-base` *as designed* — components declare `static legends` and `static placement` from day one, no FILL_STYLES inline arrays to remove.
+
+<!-- AUTOGEN_BEGIN: do not edit between markers (run scripts/regenerate-readmes.mjs to update) -->
+
+## Components
+
+- `Forklift`
+- `Worker`
+- `Agv`
+- `Tugger`
+
+## Templates (things-scene catalog)
+
+| type | group | description |
+|---|---|---|
+| `forklift` | warehouse | forklift truck |
+| `worker` | warehouse | human worker |
+| `agv` | warehouse | payload AGV (unit-load, Kiva-style) |
+| `tugger` | warehouse | tugger AGV (towing tractor) |
+
+## Install
+
+```bash
+yarn add @operato/scene-transport
+```
+
+## Usage
+
+```ts
+import { Forklift, Worker, Agv, Tugger } from '@operato/scene-transport'
+```
+
+## Build
+
+```bash
+yarn build
+```
+
+Output: ESM module at `dist/index.js` (single bundle, no UMD/IE legacy).
+
+_Version: 10.0.0-beta.1_
+
+<!-- AUTOGEN_END -->

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

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

package/dist/agv-3d.js

@@ -0,0 +1,233 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Agv 3D — payload (Kiva-style) automated guided vehicle.
+ *
+ * LO-POLY but with **rounded volume** — the Kiva AGV's signature is a
+ * pill-shaped, low-slung chassis with rounded corners, not a flat box.
+ *
+ * Structure:
+ *   - rounded-box chassis (volumetric, with bevels — the visual identity)
+ *   - top deck with raised lift pad at center (Kiva-style under-shelf lift)
+ *   - LED strip running around the perimeter
+ *   - safety bumpers (front + rear, hi-vis with black corners)
+ *   - LiDAR sensor: cylindrical body + transparent dome top
+ *   - 4 wheel covers (fender bumps integrated into chassis sides)
+ *   - charging contacts at rear
+ *   - corner indicator lamps on deck
+ */
+import * as THREE from 'three';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+const CHASSIS_COLOR_DARK = 0x444444;
+const DECK_COLOR = 0x666677;
+const LIFT_PAD_COLOR = 0x4a4a55;
+const TIRE_COLOR = 0x202020;
+const WHEEL_COVER_COLOR = 0x3a3a3a;
+const LIDAR_BODY = 0x222233;
+const LIDAR_DOME = 0x445566;
+const BUMPER_COLOR = 0xeeaa00;
+const BUMPER_BLACK = 0x111111;
+const CHARGE_COPPER = 0xc77a00;
+export class Agv3D extends RealObjectGroup {
+    build() {
+        super.build();
+        const { width, height, depth = 0 } = this.component.state;
+        const bodyColor = this.component.state.bodyColor || '#999';
+        const emissiveColor = this.component.state.lampEmissive || '#222222';
+        const status = this.component.state.status;
+        const lampIntensity = status && status !== 'idle' ? 1.5 : 0.2;
+        const chassisH = depth * 0.85;
+        const deckH = depth * 0.05;
+        const wheelR = chassisH * 0.30;
+        const baseY = -depth / 2;
+        // ── Rounded chassis (volumetric — the Kiva AGV signature) ────────
+        const chassisRadius = Math.min(width, height) * 0.10;
+        const chassisGeo = new RoundedBoxGeometry(width * 0.95, chassisH, height * 0.95, 4, chassisRadius);
+        const chassisMesh = new THREE.Mesh(chassisGeo, new THREE.MeshStandardMaterial({
+            color: CHASSIS_COLOR_DARK,
+            metalness: 0.4,
+            roughness: 0.5
+        }));
+        chassisMesh.position.set(0, baseY + chassisH / 2, 0);
+        chassisMesh.castShadow = true;
+        chassisMesh.receiveShadow = true;
+        this.object3d.add(chassisMesh);
+        // ── Top deck (rounded slab) ───────────────────────────────────────
+        const deckGeo = new RoundedBoxGeometry(width * 0.95, deckH, height * 0.95, 2, chassisRadius * 0.5);
+        const deckMesh = new THREE.Mesh(deckGeo, new THREE.MeshStandardMaterial({ color: DECK_COLOR, metalness: 0.5, roughness: 0.4 }));
+        deckMesh.position.set(0, baseY + chassisH + deckH / 2, 0);
+        deckMesh.castShadow = true;
+        deckMesh.receiveShadow = true;
+        this.object3d.add(deckMesh);
+        // ── Lift mechanism (round pad — Kiva-style under-shelf lift) ─────
+        const liftR = Math.min(width, height) * 0.30;
+        const liftH = deckH * 1.5;
+        const liftGeo = new THREE.CylinderGeometry(liftR, liftR * 1.05, liftH, 24);
+        const liftMesh = new THREE.Mesh(liftGeo, new THREE.MeshStandardMaterial({ color: LIFT_PAD_COLOR, metalness: 0.6, roughness: 0.35 }));
+        liftMesh.position.set(0, baseY + chassisH + deckH + liftH / 2, 0);
+        liftMesh.castShadow = true;
+        this.object3d.add(liftMesh);
+        // Body color band on lift rim (status hint)
+        const tintH = liftH * 0.3;
+        const tintGeo = new THREE.CylinderGeometry(liftR * 1.03, liftR * 1.03, tintH, 24, 1, true);
+        const tintMesh = new THREE.Mesh(tintGeo, new THREE.MeshStandardMaterial({
+            color: bodyColor,
+            side: THREE.DoubleSide,
+            transparent: true,
+            opacity: 0.7,
+            metalness: 0.1,
+            roughness: 0.6
+        }));
+        tintMesh.position.set(0, baseY + chassisH + deckH + tintH / 2, 0);
+        this.object3d.add(tintMesh);
+        // ── LED strip (4 sides, rounded corners follow chassis bevel) ────
+        const stripH = chassisH * 0.10;
+        const stripT = Math.min(width, height) * 0.015;
+        const stripY = baseY + chassisH * 0.55;
+        const stripMaterial = new THREE.MeshStandardMaterial({
+            color: emissiveColor,
+            emissive: emissiveColor,
+            emissiveIntensity: lampIntensity,
+            metalness: 0.1,
+            roughness: 0.4
+        });
+        for (const zSign of [-1, 1]) {
+            const stripGeo = new THREE.BoxGeometry(width * 0.85, stripH, stripT);
+            const stripMesh = new THREE.Mesh(stripGeo, stripMaterial);
+            stripMesh.position.set(0, stripY, zSign * (height * 0.475 - stripT / 2));
+            this.object3d.add(stripMesh);
+        }
+        for (const xSign of [-1, 1]) {
+            const stripGeo = new THREE.BoxGeometry(stripT, stripH, height * 0.85);
+            const stripMesh = new THREE.Mesh(stripGeo, stripMaterial);
+            stripMesh.position.set(xSign * (width * 0.475 - stripT / 2), stripY, 0);
+            this.object3d.add(stripMesh);
+        }
+        // ── Safety bumpers (front + rear) ────────────────────────────────
+        const bumperH = chassisH * 0.18;
+        const bumperT = Math.min(width, height) * 0.025;
+        const bumperY = baseY + bumperH / 2 + wheelR * 0.5;
+        const bumperMaterial = new THREE.MeshStandardMaterial({
+            color: BUMPER_COLOR,
+            metalness: 0.1,
+            roughness: 0.6
+        });
+        const bumperBlackMaterial = new THREE.MeshStandardMaterial({
+            color: BUMPER_BLACK,
+            metalness: 0.2,
+            roughness: 0.7
+        });
+        for (const zSign of [-1, 1]) {
+            const yellow = new RoundedBoxGeometry(width * 0.7, bumperH, bumperT, 2, bumperT * 0.4);
+            const yMesh = new THREE.Mesh(yellow, bumperMaterial);
+            yMesh.position.set(0, bumperY, zSign * (height * 0.475 + bumperT / 2));
+            this.object3d.add(yMesh);
+            for (const xSign of [-1, 1]) {
+                const black = new RoundedBoxGeometry(width * 0.13, bumperH, bumperT, 2, bumperT * 0.4);
+                const bMesh = new THREE.Mesh(black, bumperBlackMaterial);
+                bMesh.position.set(xSign * (width * 0.7 / 2 + width * 0.065), bumperY, zSign * (height * 0.475 + bumperT / 2));
+                this.object3d.add(bMesh);
+            }
+        }
+        // ── LiDAR sensor (cylinder body + transparent dome) ──────────────
+        const lidarR = Math.min(width, height) * 0.10;
+        const lidarBodyH = lidarR * 0.7;
+        const lidarBodyGeo = new THREE.CylinderGeometry(lidarR, lidarR * 1.1, lidarBodyH, 16);
+        const lidarBodyMesh = new THREE.Mesh(lidarBodyGeo, new THREE.MeshStandardMaterial({ color: LIDAR_BODY, metalness: 0.6, roughness: 0.4 }));
+        lidarBodyMesh.position.set(0, baseY + chassisH + lidarBodyH / 2, height * 0.35);
+        lidarBodyMesh.castShadow = true;
+        this.object3d.add(lidarBodyMesh);
+        const domeGeo = new THREE.SphereGeometry(lidarR * 0.95, 24, 16, 0, Math.PI * 2, 0, Math.PI / 2);
+        const domeMesh = new THREE.Mesh(domeGeo, new THREE.MeshStandardMaterial({
+            color: LIDAR_DOME,
+            metalness: 0.3,
+            roughness: 0.2,
+            transparent: true,
+            opacity: 0.8
+        }));
+        domeMesh.position.set(0, baseY + chassisH + lidarBodyH, height * 0.35);
+        this.object3d.add(domeMesh);
+        // Status hint on LiDAR top
+        const hintR = lidarR * 0.25;
+        const hintMesh = new THREE.Mesh(new THREE.SphereGeometry(hintR, 24, 8), new THREE.MeshStandardMaterial({
+            color: emissiveColor,
+            emissive: emissiveColor,
+            emissiveIntensity: lampIntensity,
+            roughness: 0.3
+        }));
+        hintMesh.position.set(0, baseY + chassisH + lidarBodyH + lidarR * 0.85, height * 0.35);
+        this.object3d.add(hintMesh);
+        // ── Wheels with covers ───────────────────────────────────────────
+        const wheelW = width * 0.07;
+        const tireMaterial = new THREE.MeshStandardMaterial({ color: TIRE_COLOR, roughness: 0.95 });
+        const coverMaterial = new THREE.MeshStandardMaterial({
+            color: WHEEL_COVER_COLOR,
+            metalness: 0.5,
+            roughness: 0.6
+        });
+        const tireGeos = [];
+        for (const xSign of [-1, 1]) {
+            for (const zSign of [-1, 1]) {
+                const tire = new THREE.CylinderGeometry(wheelR, wheelR, wheelW, 24);
+                tire.rotateZ(Math.PI / 2);
+                tire.translate(xSign * width * 0.42, baseY + wheelR, zSign * height * 0.32);
+                tireGeos.push(tire);
+                // Rounded fender cover
+                const cover = new RoundedBoxGeometry(wheelW * 1.5, wheelR * 1.4, wheelR * 1.6, 2, wheelR * 0.25);
+                cover.translate(xSign * (width * 0.42 + wheelW * 0.4), baseY + wheelR * 1.2, zSign * height * 0.32);
+                const coverMesh = new THREE.Mesh(cover, coverMaterial);
+                coverMesh.castShadow = true;
+                this.object3d.add(coverMesh);
+            }
+        }
+        const tireMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(tireGeos), tireMaterial);
+        tireMesh.castShadow = true;
+        this.object3d.add(tireMesh);
+        // ── Charging contacts (rear) ─────────────────────────────────────
+        const chargeMaterial = new THREE.MeshStandardMaterial({
+            color: CHARGE_COPPER,
+            metalness: 0.9,
+            roughness: 0.2
+        });
+        const chargeT = wheelR * 0.15;
+        const chargeH = wheelR * 0.6;
+        const chargeW = width * 0.08;
+        for (const xSign of [-1, 1]) {
+            const chargeGeo = new RoundedBoxGeometry(chargeW, chargeH, chargeT, 1, chargeT * 0.3);
+            const chargeMesh = new THREE.Mesh(chargeGeo, chargeMaterial);
+            chargeMesh.position.set(xSign * width * 0.10, baseY + chargeH / 2 + wheelR * 0.2, -height * 0.475 - chargeT / 2);
+            this.object3d.add(chargeMesh);
+        }
+        // ── Corner indicator lamps ───────────────────────────────────────
+        const cornerR = Math.min(width, height) * 0.022;
+        for (const xSign of [-1, 1]) {
+            for (const zSign of [-1, 1]) {
+                const cornerMesh = new THREE.Mesh(new THREE.SphereGeometry(cornerR, 24, 6), new THREE.MeshStandardMaterial({
+                    color: emissiveColor,
+                    emissive: emissiveColor,
+                    emissiveIntensity: lampIntensity * 0.6,
+                    roughness: 0.3
+                }));
+                cornerMesh.position.set(xSign * (width * 0.42), baseY + chassisH + deckH + cornerR * 0.6, zSign * (height * 0.42));
+                this.object3d.add(cornerMesh);
+            }
+        }
+    }
+    updateDimension() { }
+    onchange(after, before) {
+        if ('status' in after ||
+            'bodyColor' in after ||
+            'lampEmissive' in after ||
+            'width' in after ||
+            'height' in after ||
+            'depth' in after) {
+            this.update();
+            return;
+        }
+        super.onchange(after, before);
+    }
+    updateAlpha() { }
+}
+//# sourceMappingURL=agv-3d.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agv-3d.js","sourceRoot":"","sources":["../src/agv-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Agv 3D — payload (Kiva-style) automated guided vehicle.\n *\n * LO-POLY but with **rounded volume** — the Kiva AGV's signature is a\n * pill-shaped, low-slung chassis with rounded corners, not a flat box.\n *\n * Structure:\n *   - rounded-box chassis (volumetric, with bevels — the visual identity)\n *   - top deck with raised lift pad at center (Kiva-style under-shelf lift)\n *   - LED strip running around the perimeter\n *   - safety bumpers (front + rear, hi-vis with black corners)\n *   - LiDAR sensor: cylindrical body + transparent dome top\n *   - 4 wheel covers (fender bumps integrated into chassis sides)\n *   - charging contacts at rear\n *   - corner indicator lamps on deck\n */\n\nimport * as THREE from 'three'\nimport * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js'\nimport { RoundedBoxGeometry } from 'three/examples/jsm/geometries/RoundedBoxGeometry.js'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nconst CHASSIS_COLOR_DARK = 0x444444\nconst DECK_COLOR = 0x666677\nconst LIFT_PAD_COLOR = 0x4a4a55\nconst TIRE_COLOR = 0x202020\nconst WHEEL_COVER_COLOR = 0x3a3a3a\nconst LIDAR_BODY = 0x222233\nconst LIDAR_DOME = 0x445566\nconst BUMPER_COLOR = 0xeeaa00\nconst BUMPER_BLACK = 0x111111\nconst CHARGE_COPPER = 0xc77a00\n\nexport class Agv3D extends RealObjectGroup {\n  build() {\n    super.build()\n\n    const { width, height, depth = 0 } = this.component.state\n    const bodyColor = (this.component.state.bodyColor as string) || '#999'\n    const emissiveColor = (this.component.state.lampEmissive as string) || '#222222'\n    const status = this.component.state.status\n    const lampIntensity = status && status !== 'idle' ? 1.5 : 0.2\n\n    const chassisH = depth * 0.85\n    const deckH = depth * 0.05\n    const wheelR = chassisH * 0.30\n    const baseY = -depth / 2\n\n    // ── Rounded chassis (volumetric — the Kiva AGV signature) ────────\n    const chassisRadius = Math.min(width, height) * 0.10\n    const chassisGeo = new RoundedBoxGeometry(width * 0.95, chassisH, height * 0.95, 4, chassisRadius)\n    const chassisMesh = new THREE.Mesh(\n      chassisGeo,\n      new THREE.MeshStandardMaterial({\n        color: CHASSIS_COLOR_DARK,\n        metalness: 0.4,\n        roughness: 0.5\n      })\n    )\n    chassisMesh.position.set(0, baseY + chassisH / 2, 0)\n    chassisMesh.castShadow = true\n    chassisMesh.receiveShadow = true\n    this.object3d.add(chassisMesh)\n\n    // ── Top deck (rounded slab) ───────────────────────────────────────\n    const deckGeo = new RoundedBoxGeometry(width * 0.95, deckH, height * 0.95, 2, chassisRadius * 0.5)\n    const deckMesh = new THREE.Mesh(\n      deckGeo,\n      new THREE.MeshStandardMaterial({ color: DECK_COLOR, metalness: 0.5, roughness: 0.4 })\n    )\n    deckMesh.position.set(0, baseY + chassisH + deckH / 2, 0)\n    deckMesh.castShadow = true\n    deckMesh.receiveShadow = true\n    this.object3d.add(deckMesh)\n\n    // ── Lift mechanism (round pad — Kiva-style under-shelf lift) ─────\n    const liftR = Math.min(width, height) * 0.30\n    const liftH = deckH * 1.5\n    const liftGeo = new THREE.CylinderGeometry(liftR, liftR * 1.05, liftH, 24)\n    const liftMesh = new THREE.Mesh(\n      liftGeo,\n      new THREE.MeshStandardMaterial({ color: LIFT_PAD_COLOR, metalness: 0.6, roughness: 0.35 })\n    )\n    liftMesh.position.set(0, baseY + chassisH + deckH + liftH / 2, 0)\n    liftMesh.castShadow = true\n    this.object3d.add(liftMesh)\n\n    // Body color band on lift rim (status hint)\n    const tintH = liftH * 0.3\n    const tintGeo = new THREE.CylinderGeometry(liftR * 1.03, liftR * 1.03, tintH, 24, 1, true)\n    const tintMesh = new THREE.Mesh(\n      tintGeo,\n      new THREE.MeshStandardMaterial({\n        color: bodyColor,\n        side: THREE.DoubleSide,\n        transparent: true,\n        opacity: 0.7,\n        metalness: 0.1,\n        roughness: 0.6\n      })\n    )\n    tintMesh.position.set(0, baseY + chassisH + deckH + tintH / 2, 0)\n    this.object3d.add(tintMesh)\n\n    // ── LED strip (4 sides, rounded corners follow chassis bevel) ────\n    const stripH = chassisH * 0.10\n    const stripT = Math.min(width, height) * 0.015\n    const stripY = baseY + chassisH * 0.55\n    const stripMaterial = new THREE.MeshStandardMaterial({\n      color: emissiveColor,\n      emissive: emissiveColor,\n      emissiveIntensity: lampIntensity,\n      metalness: 0.1,\n      roughness: 0.4\n    })\n    for (const zSign of [-1, 1]) {\n      const stripGeo = new THREE.BoxGeometry(width * 0.85, stripH, stripT)\n      const stripMesh = new THREE.Mesh(stripGeo, stripMaterial)\n      stripMesh.position.set(0, stripY, zSign * (height * 0.475 - stripT / 2))\n      this.object3d.add(stripMesh)\n    }\n    for (const xSign of [-1, 1]) {\n      const stripGeo = new THREE.BoxGeometry(stripT, stripH, height * 0.85)\n      const stripMesh = new THREE.Mesh(stripGeo, stripMaterial)\n      stripMesh.position.set(xSign * (width * 0.475 - stripT / 2), stripY, 0)\n      this.object3d.add(stripMesh)\n    }\n\n    // ── Safety bumpers (front + rear) ────────────────────────────────\n    const bumperH = chassisH * 0.18\n    const bumperT = Math.min(width, height) * 0.025\n    const bumperY = baseY + bumperH / 2 + wheelR * 0.5\n    const bumperMaterial = new THREE.MeshStandardMaterial({\n      color: BUMPER_COLOR,\n      metalness: 0.1,\n      roughness: 0.6\n    })\n    const bumperBlackMaterial = new THREE.MeshStandardMaterial({\n      color: BUMPER_BLACK,\n      metalness: 0.2,\n      roughness: 0.7\n    })\n    for (const zSign of [-1, 1]) {\n      const yellow = new RoundedBoxGeometry(width * 0.7, bumperH, bumperT, 2, bumperT * 0.4)\n      const yMesh = new THREE.Mesh(yellow, bumperMaterial)\n      yMesh.position.set(0, bumperY, zSign * (height * 0.475 + bumperT / 2))\n      this.object3d.add(yMesh)\n      for (const xSign of [-1, 1]) {\n        const black = new RoundedBoxGeometry(width * 0.13, bumperH, bumperT, 2, bumperT * 0.4)\n        const bMesh = new THREE.Mesh(black, bumperBlackMaterial)\n        bMesh.position.set(xSign * (width * 0.7 / 2 + width * 0.065), bumperY, zSign * (height * 0.475 + bumperT / 2))\n        this.object3d.add(bMesh)\n      }\n    }\n\n    // ── LiDAR sensor (cylinder body + transparent dome) ──────────────\n    const lidarR = Math.min(width, height) * 0.10\n    const lidarBodyH = lidarR * 0.7\n    const lidarBodyGeo = new THREE.CylinderGeometry(lidarR, lidarR * 1.1, lidarBodyH, 16)\n    const lidarBodyMesh = new THREE.Mesh(\n      lidarBodyGeo,\n      new THREE.MeshStandardMaterial({ color: LIDAR_BODY, metalness: 0.6, roughness: 0.4 })\n    )\n    lidarBodyMesh.position.set(0, baseY + chassisH + lidarBodyH / 2, height * 0.35)\n    lidarBodyMesh.castShadow = true\n    this.object3d.add(lidarBodyMesh)\n\n    const domeGeo = new THREE.SphereGeometry(lidarR * 0.95, 24, 16, 0, Math.PI * 2, 0, Math.PI / 2)\n    const domeMesh = new THREE.Mesh(\n      domeGeo,\n      new THREE.MeshStandardMaterial({\n        color: LIDAR_DOME,\n        metalness: 0.3,\n        roughness: 0.2,\n        transparent: true,\n        opacity: 0.8\n      })\n    )\n    domeMesh.position.set(0, baseY + chassisH + lidarBodyH, height * 0.35)\n    this.object3d.add(domeMesh)\n\n    // Status hint on LiDAR top\n    const hintR = lidarR * 0.25\n    const hintMesh = new THREE.Mesh(\n      new THREE.SphereGeometry(hintR, 24, 8),\n      new THREE.MeshStandardMaterial({\n        color: emissiveColor,\n        emissive: emissiveColor,\n        emissiveIntensity: lampIntensity,\n        roughness: 0.3\n      })\n    )\n    hintMesh.position.set(0, baseY + chassisH + lidarBodyH + lidarR * 0.85, height * 0.35)\n    this.object3d.add(hintMesh)\n\n    // ── Wheels with covers ───────────────────────────────────────────\n    const wheelW = width * 0.07\n    const tireMaterial = new THREE.MeshStandardMaterial({ color: TIRE_COLOR, roughness: 0.95 })\n    const coverMaterial = new THREE.MeshStandardMaterial({\n      color: WHEEL_COVER_COLOR,\n      metalness: 0.5,\n      roughness: 0.6\n    })\n\n    const tireGeos: THREE.BufferGeometry[] = []\n    for (const xSign of [-1, 1]) {\n      for (const zSign of [-1, 1]) {\n        const tire = new THREE.CylinderGeometry(wheelR, wheelR, wheelW, 24)\n        tire.rotateZ(Math.PI / 2)\n        tire.translate(xSign * width * 0.42, baseY + wheelR, zSign * height * 0.32)\n        tireGeos.push(tire)\n        // Rounded fender cover\n        const cover = new RoundedBoxGeometry(wheelW * 1.5, wheelR * 1.4, wheelR * 1.6, 2, wheelR * 0.25)\n        cover.translate(xSign * (width * 0.42 + wheelW * 0.4), baseY + wheelR * 1.2, zSign * height * 0.32)\n        const coverMesh = new THREE.Mesh(cover, coverMaterial)\n        coverMesh.castShadow = true\n        this.object3d.add(coverMesh)\n      }\n    }\n    const tireMesh = new THREE.Mesh(BufferGeometryUtils.mergeGeometries(tireGeos), tireMaterial)\n    tireMesh.castShadow = true\n    this.object3d.add(tireMesh)\n\n    // ── Charging contacts (rear) ─────────────────────────────────────\n    const chargeMaterial = new THREE.MeshStandardMaterial({\n      color: CHARGE_COPPER,\n      metalness: 0.9,\n      roughness: 0.2\n    })\n    const chargeT = wheelR * 0.15\n    const chargeH = wheelR * 0.6\n    const chargeW = width * 0.08\n    for (const xSign of [-1, 1]) {\n      const chargeGeo = new RoundedBoxGeometry(chargeW, chargeH, chargeT, 1, chargeT * 0.3)\n      const chargeMesh = new THREE.Mesh(chargeGeo, chargeMaterial)\n      chargeMesh.position.set(xSign * width * 0.10, baseY + chargeH / 2 + wheelR * 0.2, -height * 0.475 - chargeT / 2)\n      this.object3d.add(chargeMesh)\n    }\n\n    // ── Corner indicator lamps ───────────────────────────────────────\n    const cornerR = Math.min(width, height) * 0.022\n    for (const xSign of [-1, 1]) {\n      for (const zSign of [-1, 1]) {\n        const cornerMesh = new THREE.Mesh(\n          new THREE.SphereGeometry(cornerR, 24, 6),\n          new THREE.MeshStandardMaterial({\n            color: emissiveColor,\n            emissive: emissiveColor,\n            emissiveIntensity: lampIntensity * 0.6,\n            roughness: 0.3\n          })\n        )\n        cornerMesh.position.set(\n          xSign * (width * 0.42),\n          baseY + chassisH + deckH + cornerR * 0.6,\n          zSign * (height * 0.42)\n        )\n        this.object3d.add(cornerMesh)\n      }\n    }\n  }\n\n  updateDimension() {}\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    if (\n      'status' in after ||\n      'bodyColor' in after ||\n      'lampEmissive' 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/agv.d.ts

@@ -0,0 +1,57 @@
+import { Component, ComponentNature, RealObject } from '@hatiolab/things-scene';
+import { type Alignment, type Heights, type LegendBinding, type PlacementArchetype } from '@operato/scene-base';
+/**
+ * Agv status — common to both payload and towing AGVs (kept narrow on purpose).
+ *
+ * - `idle`     — parked, awaiting task
+ * - `moving`   — driving along a path / executing transport
+ * - `charging` — at a charging dock / battery station
+ * - `error`    — fault / blocked / e-stop
+ *
+ * Loaded-vs-empty distinction is *not* in the status enum because for a
+ * Kiva-style payload AGV it's already obvious from the children (cargo
+ * components) parented to it — duplicating that as a status flag would
+ * invite drift.
+ */
+export type AgvStatus = 'idle' | 'moving' | 'charging' | 'error';
+declare const Base: typeof Component;
+/**
+ * Agv — payload (unit-load) automated guided vehicle. The Kiva-style flat-deck
+ * AGV that drives under or carries cargo to/from operation surfaces.
+ *
+ * **Container-based for cargo containment.** A payload Agv has a flat top
+ * deck whose surface is at the scene's operation height. Boxes, parcels,
+ * loaded pallets (anything with `placement: 'operation'`) can be added as
+ * children — when they are, their natural archetype-derived zPos puts them
+ * exactly on the AGV's deck (since AGV depth = operation - floor).
+ *
+ * For the towing variant (no cargo deck, pulls trailers behind), see Tugger.
+ */
+export default class Agv extends Base {
+    static legends: Record<string, LegendBinding>;
+    /**
+     * AGV sits on its wheels — `floor` archetype. Default depth = operation,
+     * so the top deck lands at the scene's operation height. This is the
+     * design point of payload AGVs: the deck height matches conveyor belt
+     * height, equipment ports, and forklift fork height — cargo transfers
+     * across all of them at the same level.
+     */
+    static placement: PlacementArchetype;
+    static align: Alignment;
+    static defaultDepth: (h: Heights) => number;
+    get nature(): ComponentNature;
+    get anchors(): never[];
+    /** Accept logistics packages (placement='operation') as deck cargo. */
+    containable(component: Component): boolean;
+    /**
+     * 2D — render() sets up the rounded chassis path; the framework fills it
+     * with `fillStyle` (= bodyColor from Legendable) and strokes with
+     * `strokeStyle`. Additional top-down details (bumpers, LiDAR, lift pad,
+     * direction triangle) are drawn in `postrender()`.
+     */
+    render(ctx: CanvasRenderingContext2D): void;
+    /** Top-view accent details — bumpers, lift pad, LiDAR, direction triangle. */
+    postrender(ctx: CanvasRenderingContext2D): void;
+    buildRealObject(): RealObject | undefined;
+}
+export {};

package/dist/agv.js

@@ -0,0 +1,171 @@
+import { __decorate } from "tslib";
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ */
+import { Container, sceneComponent } from '@hatiolab/things-scene';
+import { Legendable, Placeable } from '@operato/scene-base';
+import { Agv3D } from './agv-3d.js';
+/**
+ * Body color — neutral industrial gray base, slightly modulated by status.
+ * AGVs typically have status-color LED strips rather than full body color
+ * change; the body legend stays subtle so the LED strip + lamp do the
+ * communicating.
+ */
+const BODY_LEGEND = {
+    idle: '#999',
+    moving: '#aaa',
+    charging: '#aaa',
+    error: '#c66',
+    default: '#999'
+};
+/**
+ * LED strip emissive — the dominant status indicator for AGVs (typically a
+ * color-band running around the chassis perimeter).
+ */
+const LAMP_EMISSIVE_LEGEND = {
+    idle: '#222222',
+    moving: '#44ff44', // green (operating)
+    charging: '#ffaa00', // amber (charging)
+    error: '#ff3333', // red
+    default: '#222222'
+};
+const NATURE = {
+    mutable: false,
+    resizable: true,
+    rotatable: true,
+    properties: [
+        {
+            type: 'select',
+            label: 'status',
+            name: 'status',
+            property: {
+                options: [
+                    { display: 'Idle', value: 'idle' },
+                    { display: 'Moving', value: 'moving' },
+                    { display: 'Charging', value: 'charging' },
+                    { display: 'Error', value: 'error' }
+                ]
+            }
+        },
+        {
+            type: 'number',
+            label: 'battery',
+            name: 'battery',
+            placeholder: '0..1'
+        }
+    ],
+    help: 'scene/component/agv'
+};
+const Base = Legendable(Placeable(Container));
+/**
+ * Agv — payload (unit-load) automated guided vehicle. The Kiva-style flat-deck
+ * AGV that drives under or carries cargo to/from operation surfaces.
+ *
+ * **Container-based for cargo containment.** A payload Agv has a flat top
+ * deck whose surface is at the scene's operation height. Boxes, parcels,
+ * loaded pallets (anything with `placement: 'operation'`) can be added as
+ * children — when they are, their natural archetype-derived zPos puts them
+ * exactly on the AGV's deck (since AGV depth = operation - floor).
+ *
+ * For the towing variant (no cargo deck, pulls trailers behind), see Tugger.
+ */
+let Agv = class Agv extends Base {
+    static legends = {
+        bodyColor: { from: 'status', legend: BODY_LEGEND },
+        lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }
+    };
+    /**
+     * AGV sits on its wheels — `floor` archetype. Default depth = operation,
+     * so the top deck lands at the scene's operation height. This is the
+     * design point of payload AGVs: the deck height matches conveyor belt
+     * height, equipment ports, and forklift fork height — cargo transfers
+     * across all of them at the same level.
+     */
+    static placement = 'floor';
+    static align = 'bottom';
+    static defaultDepth = (h) => h.operation - h.floor;
+    get nature() {
+        return NATURE;
+    }
+    get anchors() {
+        return [];
+    }
+    /** Accept logistics packages (placement='operation') as deck cargo. */
+    containable(component) {
+        const archetype = component.constructor.placement;
+        if (archetype === 'operation')
+            return true;
+        return component.isDescendible(this);
+    }
+    /**
+     * 2D — render() sets up the rounded chassis path; the framework fills it
+     * with `fillStyle` (= bodyColor from Legendable) and strokes with
+     * `strokeStyle`. Additional top-down details (bumpers, LiDAR, lift pad,
+     * direction triangle) are drawn in `postrender()`.
+     */
+    render(ctx) {
+        const { width, height, left, top } = this.state;
+        const radius = Math.min(width, height) * 0.12;
+        ctx.beginPath();
+        ctx.roundRect(left, top, width, height, radius);
+    }
+    /** Top-view accent details — bumpers, lift pad, LiDAR, direction triangle. */
+    postrender(ctx) {
+        super.postrender?.(ctx);
+        const { width, height, left, top } = this.state;
+        const cx = left + width / 2;
+        const cy = top + height / 2;
+        const accentColor = this.state.lampEmissive || '#44ff44';
+        ctx.save();
+        // Hi-vis bumper strips (front + rear)
+        const bumperT = Math.min(width, height) * 0.06;
+        ctx.fillStyle = '#eeaa00';
+        ctx.fillRect(left + width * 0.15, top, width * 0.7, bumperT);
+        ctx.fillRect(left + width * 0.15, top + height - bumperT, width * 0.7, bumperT);
+        ctx.fillStyle = '#111';
+        ctx.fillRect(left + width * 0.02, top, width * 0.13, bumperT);
+        ctx.fillRect(left + width * 0.85, top, width * 0.13, bumperT);
+        ctx.fillRect(left + width * 0.02, top + height - bumperT, width * 0.13, bumperT);
+        ctx.fillRect(left + width * 0.85, top + height - bumperT, width * 0.13, bumperT);
+        // Lift pad (center circle — Kiva-style under-shelf lift)
+        const padR = Math.min(width, height) * 0.22;
+        ctx.fillStyle = '#4a4a55';
+        ctx.strokeStyle = '#222';
+        ctx.lineWidth = 1;
+        ctx.beginPath();
+        ctx.ellipse(cx, cy, padR, padR, 0, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.stroke();
+        // LiDAR sensor (small filled circle near front)
+        const lidarR = Math.min(width, height) * 0.07;
+        ctx.fillStyle = '#222233';
+        ctx.beginPath();
+        ctx.ellipse(cx, top + height * 0.20, lidarR, lidarR, 0, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.stroke();
+        // Status hint on LiDAR
+        ctx.fillStyle = accentColor;
+        ctx.beginPath();
+        ctx.ellipse(cx, top + height * 0.20, lidarR * 0.4, lidarR * 0.4, 0, 0, Math.PI * 2);
+        ctx.fill();
+        // Direction-of-travel triangle
+        ctx.fillStyle = accentColor;
+        ctx.strokeStyle = '#111';
+        ctx.beginPath();
+        ctx.moveTo(cx, top + height * 0.06);
+        ctx.lineTo(cx - width * 0.06, top + height * 0.13);
+        ctx.lineTo(cx + width * 0.06, top + height * 0.13);
+        ctx.closePath();
+        ctx.fill();
+        ctx.stroke();
+        ctx.restore();
+    }
+    buildRealObject() {
+        return new Agv3D(this);
+    }
+};
+Agv = __decorate([
+    sceneComponent('agv')
+], Agv);
+export default Agv;
+//# sourceMappingURL=agv.js.map

package/dist/agv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agv.js","sourceRoot":"","sources":["../src/agv.ts"],"names":[],"mappings":";AAAA;;GAEG;AACH,OAAO,EAA8B,SAAS,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC1G,OAAO,EACL,UAAU,EACV,SAAS,EAKV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAiBnC;;;;;GAKG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;CAChB,CAAA;AAED;;;GAGG;AACH,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS,EAAG,oBAAoB;IACxC,QAAQ,EAAE,SAAS,EAAE,mBAAmB;IACxC,KAAK,EAAE,SAAS,EAAI,MAAM;IAC1B,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,QAAQ;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE;gBACR,OAAO,EAAE;oBACP,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;oBAClC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;oBACtC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;oBAC1C,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;iBACrC;aACF;SACF;QACD;YACE,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,MAAM;SACpB;KACF;IACD,IAAI,EAAE,qBAAqB;CAC5B,CAAA;AAED,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAgC,CAAA;AAE5E;;;;;;;;;;;GAWG;AAEY,IAAM,GAAG,GAAT,MAAM,GAAI,SAAQ,IAAI;IACnC,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;QAClD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE;KAC/D,CAAA;IAED;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,GAAuB,OAAO,CAAA;IAC9C,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAA;IAE3D,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED,uEAAuE;IACvE,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;;;;;OAKG;IACH,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QAC7C,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACjD,CAAC;IAED,8EAA8E;IAC9E,UAAU,CAAC,GAA6B;QACtC,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAA;QAEvB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QAC/C,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;QAC3B,MAAM,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,CAAA;QAC3B,MAAM,WAAW,GAAI,IAAI,CAAC,KAAK,CAAC,YAAuB,IAAI,SAAS,CAAA;QAEpE,GAAG,CAAC,IAAI,EAAE,CAAA;QAEV,sCAAsC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QAC9C,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,CAAA;QAC5D,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,CAAA;QAC/E,GAAG,CAAC,SAAS,GAAG,MAAM,CAAA;QACtB,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAC7D,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAC7D,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAChF,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;QAEhF,yDAAyD;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QAC3C,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,GAAG,CAAC,WAAW,GAAG,MAAM,CAAA;QACxB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAA;QACjB,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QAClD,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,gDAAgD;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QAC7C,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACvE,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,uBAAuB;QACvB,GAAG,CAAC,SAAS,GAAG,WAAW,CAAA;QAC3B,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QACnF,GAAG,CAAC,IAAI,EAAE,CAAA;QAEV,+BAA+B;QAC/B,GAAG,CAAC,SAAS,GAAG,WAAW,CAAA;QAC3B,GAAG,CAAC,WAAW,GAAG,MAAM,CAAA;QACxB,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;QACnC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;QAClD,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;QAClD,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,GAAG,CAAC,OAAO,EAAE,CAAA;IACf,CAAC;IAED,eAAe;QACb,OAAO,IAAI,KAAK,CAAC,IAAW,CAAC,CAAA;IAC/B,CAAC;;AA1GkB,GAAG;IADvB,cAAc,CAAC,KAAK,CAAC;GACD,GAAG,CA2GvB;eA3GoB,GAAG","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\nimport { Component, ComponentNature, Container, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  Legendable,\n  Placeable,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Agv3D } from './agv-3d.js'\n\n/**\n * Agv status — common to both payload and towing AGVs (kept narrow on purpose).\n *\n * - `idle`     — parked, awaiting task\n * - `moving`   — driving along a path / executing transport\n * - `charging` — at a charging dock / battery station\n * - `error`    — fault / blocked / e-stop\n *\n * Loaded-vs-empty distinction is *not* in the status enum because for a\n * Kiva-style payload AGV it's already obvious from the children (cargo\n * components) parented to it — duplicating that as a status flag would\n * invite drift.\n */\nexport type AgvStatus = 'idle' | 'moving' | 'charging' | 'error'\n\n/**\n * Body color — neutral industrial gray base, slightly modulated by status.\n * AGVs typically have status-color LED strips rather than full body color\n * change; the body legend stays subtle so the LED strip + lamp do the\n * communicating.\n */\nconst BODY_LEGEND = {\n  idle: '#999',\n  moving: '#aaa',\n  charging: '#aaa',\n  error: '#c66',\n  default: '#999'\n}\n\n/**\n * LED strip emissive — the dominant status indicator for AGVs (typically a\n * color-band running around the chassis perimeter).\n */\nconst LAMP_EMISSIVE_LEGEND = {\n  idle: '#222222',\n  moving: '#44ff44',  // green (operating)\n  charging: '#ffaa00', // amber (charging)\n  error: '#ff3333',   // red\n  default: '#222222'\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  properties: [\n    {\n      type: 'select',\n      label: 'status',\n      name: 'status',\n      property: {\n        options: [\n          { display: 'Idle', value: 'idle' },\n          { display: 'Moving', value: 'moving' },\n          { display: 'Charging', value: 'charging' },\n          { display: 'Error', value: 'error' }\n        ]\n      }\n    },\n    {\n      type: 'number',\n      label: 'battery',\n      name: 'battery',\n      placeholder: '0..1'\n    }\n  ],\n  help: 'scene/component/agv'\n}\n\nconst Base = Legendable(Placeable(Container)) as unknown as typeof Component\n\n/**\n * Agv — payload (unit-load) automated guided vehicle. The Kiva-style flat-deck\n * AGV that drives under or carries cargo to/from operation surfaces.\n *\n * **Container-based for cargo containment.** A payload Agv has a flat top\n * deck whose surface is at the scene's operation height. Boxes, parcels,\n * loaded pallets (anything with `placement: 'operation'`) can be added as\n * children — when they are, their natural archetype-derived zPos puts them\n * exactly on the AGV's deck (since AGV depth = operation - floor).\n *\n * For the towing variant (no cargo deck, pulls trailers behind), see Tugger.\n */\n@sceneComponent('agv')\nexport default class Agv extends Base {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'status', legend: BODY_LEGEND },\n    lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  /**\n   * AGV sits on its wheels — `floor` archetype. Default depth = operation,\n   * so the top deck lands at the scene's operation height. This is the\n   * design point of payload AGVs: the deck height matches conveyor belt\n   * height, equipment ports, and forklift fork height — cargo transfers\n   * across all of them at the same level.\n   */\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.operation - h.floor\n\n  get nature() {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /** Accept logistics packages (placement='operation') as deck cargo. */\n  containable(component: Component) {\n    const archetype = (component.constructor as any).placement\n    if (archetype === 'operation') return true\n    return component.isDescendible(this as any)\n  }\n\n  /**\n   * 2D — render() sets up the rounded chassis path; the framework fills it\n   * with `fillStyle` (= bodyColor from Legendable) and strokes with\n   * `strokeStyle`. Additional top-down details (bumpers, LiDAR, lift pad,\n   * direction triangle) are drawn in `postrender()`.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { width, height, left, top } = this.state\n    const radius = Math.min(width, height) * 0.12\n    ctx.beginPath()\n    ctx.roundRect(left, top, width, height, radius)\n  }\n\n  /** Top-view accent details — bumpers, lift pad, LiDAR, direction triangle. */\n  postrender(ctx: CanvasRenderingContext2D) {\n    super.postrender?.(ctx)\n\n    const { width, height, left, top } = this.state\n    const cx = left + width / 2\n    const cy = top + height / 2\n    const accentColor = (this.state.lampEmissive as string) || '#44ff44'\n\n    ctx.save()\n\n    // Hi-vis bumper strips (front + rear)\n    const bumperT = Math.min(width, height) * 0.06\n    ctx.fillStyle = '#eeaa00'\n    ctx.fillRect(left + width * 0.15, top, width * 0.7, bumperT)\n    ctx.fillRect(left + width * 0.15, top + height - bumperT, width * 0.7, bumperT)\n    ctx.fillStyle = '#111'\n    ctx.fillRect(left + width * 0.02, top, width * 0.13, bumperT)\n    ctx.fillRect(left + width * 0.85, top, width * 0.13, bumperT)\n    ctx.fillRect(left + width * 0.02, top + height - bumperT, width * 0.13, bumperT)\n    ctx.fillRect(left + width * 0.85, top + height - bumperT, width * 0.13, bumperT)\n\n    // Lift pad (center circle — Kiva-style under-shelf lift)\n    const padR = Math.min(width, height) * 0.22\n    ctx.fillStyle = '#4a4a55'\n    ctx.strokeStyle = '#222'\n    ctx.lineWidth = 1\n    ctx.beginPath()\n    ctx.ellipse(cx, cy, padR, padR, 0, 0, Math.PI * 2)\n    ctx.fill()\n    ctx.stroke()\n\n    // LiDAR sensor (small filled circle near front)\n    const lidarR = Math.min(width, height) * 0.07\n    ctx.fillStyle = '#222233'\n    ctx.beginPath()\n    ctx.ellipse(cx, top + height * 0.20, lidarR, lidarR, 0, 0, Math.PI * 2)\n    ctx.fill()\n    ctx.stroke()\n    // Status hint on LiDAR\n    ctx.fillStyle = accentColor\n    ctx.beginPath()\n    ctx.ellipse(cx, top + height * 0.20, lidarR * 0.4, lidarR * 0.4, 0, 0, Math.PI * 2)\n    ctx.fill()\n\n    // Direction-of-travel triangle\n    ctx.fillStyle = accentColor\n    ctx.strokeStyle = '#111'\n    ctx.beginPath()\n    ctx.moveTo(cx, top + height * 0.06)\n    ctx.lineTo(cx - width * 0.06, top + height * 0.13)\n    ctx.lineTo(cx + width * 0.06, top + height * 0.13)\n    ctx.closePath()\n    ctx.fill()\n    ctx.stroke()\n\n    ctx.restore()\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Agv3D(this as any)\n  }\n}\n"]}

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

@@ -0,0 +1,15 @@
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class Forklift3D extends RealObjectGroup {
+    /** Local-frame position of the fork-tip top surface — where cargo sits. */
+    get cargoMount(): {
+        x: number;
+        y: number;
+        z: number;
+        width: number;
+        depth: number;
+    };
+    build(): void;
+    updateDimension(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    updateAlpha(): void;
+}