@operato/scene-manufacturing 10.0.0-beta.2 → 10.0.0-beta.24

package/dist/robot-arm.js

@@ -0,0 +1,544 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Robot Arm — generalized articulated manipulator component.
+ *
+ * Designed to cover the visualization needs of robot arms WITHOUT a
+ * specific URDF model. Configurable kinematic chain, link shape, joint
+ * housing, gripper type — same component renders as a sleek cobot, a
+ * heavy industrial 6-axis, a SCARA, or a minimal educational arm.
+ *
+ * State schema (all top-level properties optional except width/height):
+ *
+ *   {
+ *     // structure
+ *     style?: 'industrial' | 'cobot' | 'scara' | 'minimal',
+ *     chainPreset?: '6-axis-industrial' | 'cobot-6-axis' | 'scara-4-axis' | 'pick-and-place-3-axis',
+ *     chain?: ChainElement[],          // overrides preset
+ *     joints?: number[] | { [i]: number },  // current joint values
+ *
+ *     // styling overrides
+ *     linkShape?, jointHousing?, linkRadius?, color?, accentColor?,
+ *
+ *     // gripper
+ *     gripper?: GripperConfig,
+ *
+ *     // IK target (TCP world position relative to component center, in
+ *     // 3D-z-up convention used by IK module)
+ *     target?: { x: number, y: number, z: number },
+ *
+ *     // visualization
+ *     showReachSphere?: boolean
+ *   }
+ */
+import { __decorate } from "tslib";
+import * as THREE from 'three';
+import { ContainerAbstract, sceneComponent } from '@hatiolab/things-scene';
+import { CarrierHolder, Legendable, Mover, Placeable } from '@operato/scene-base';
+import { RobotArm3D } from './robot-arm-3d.js';
+import { CHAIN_PRESETS } from './robot-arm-styles.js';
+const BODY_LEGEND = {
+    idle: '#ccc',
+    moving: '#afd0f1',
+    gripping: '#cfe6c8',
+    warn: '#ffba00',
+    error: '#e9746b',
+    default: '#ccc'
+};
+const BORDER_LEGEND = {
+    idle: '#888',
+    moving: '#87b1db',
+    gripping: '#7aa274',
+    warn: '#d96f21',
+    error: '#a73928',
+    default: '#888'
+};
+const LAMP_EMISSIVE_LEGEND = {
+    idle: '#333333',
+    moving: '#44aaff',
+    gripping: '#33aa44',
+    warn: '#ffaa00',
+    error: '#ff3333',
+    default: '#333333'
+};
+const STATIC_PROPERTIES = [
+    {
+        type: 'select',
+        label: 'style',
+        name: 'style',
+        property: {
+            options: [
+                { display: 'Industrial', value: 'industrial' },
+                { display: 'Cobot', value: 'cobot' },
+                { display: 'SCARA', value: 'scara' },
+                { display: 'Minimal', value: 'minimal' }
+            ]
+        }
+    },
+    {
+        type: 'select',
+        label: 'chain-preset',
+        name: 'chainPreset',
+        property: {
+            options: [
+                { display: '6-Axis Industrial', value: '6-axis-industrial' },
+                { display: 'Cobot 6-Axis', value: 'cobot-6-axis' },
+                { display: 'SCARA 4-Axis', value: 'scara-4-axis' },
+                { display: 'Pick & Place 3-Axis', value: 'pick-and-place-3-axis' }
+            ]
+        }
+    },
+    { type: 'number', label: 'link-radius', name: 'linkRadius' },
+    {
+        type: 'select',
+        label: 'gripper-type',
+        name: 'gripperType',
+        property: {
+            options: [
+                { display: 'Parallel', value: 'parallel' },
+                { display: 'Suction', value: 'suction' },
+                { display: 'Magnetic', value: 'magnetic' },
+                { display: 'Three-Finger', value: 'three-finger' },
+                { display: 'None', value: 'none' }
+            ]
+        }
+    },
+    { type: 'checkbox', label: 'show-reach-sphere', name: 'showReachSphere' },
+    {
+        type: 'select',
+        label: 'status',
+        name: 'status',
+        property: {
+            options: [
+                { display: 'Idle', value: 'idle' },
+                { display: 'Moving', value: 'moving' },
+                { display: 'Gripping', value: 'gripping' },
+                { display: 'Warn', value: 'warn' },
+                { display: 'Error', value: 'error' }
+            ]
+        }
+    }
+];
+// CarrierHolder + ContainerAbstract: the arm needs the container's child-list
+// machinery (addComponent / reparent / events) AND CarrierHolder's
+// attachPointFor hook. CarrierHolder mixin alone only publishes the attach
+// policy; it doesn't add child management. RectPath(Shape) was wrong here —
+// Shape is a leaf so reparent silently failed. ContainerAbstract provides
+// the missing piece.
+//
+// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),
+// which forces `isHTMLElement(): true` and trips the 3D pipeline's
+// addObject DOM-skip gate. Robot arm exists purely in the 3D scene graph
+// (URDF/IK joints, no DOM overlay), so the bare logical container is correct.
+//
+// Mover wraps the chain to publish pick/place/pickAndPlace primitives. It
+// must sit OUTSIDE CarrierHolder because Mover's defaults call this.reparent,
+// which CarrierHolder provides (overrides the base ContainerAbstract
+// version with the attach-frame-aware variant).
+//
+// The instance type cast surfaces Mover's API on `this` so subclass
+// `override` keywords compile and `this.pickAndPlace(...)` resolves —
+// without it, the `as unknown as typeof Component` cast erases all
+// mixin contributions to the static side.
+const Base = Mover(CarrierHolder(Legendable(Placeable(ContainerAbstract))));
+let RobotArm = class RobotArm extends Base {
+    static legends = {
+        bodyColor: { from: 'status', legend: BODY_LEGEND },
+        borderColor: { from: 'status', legend: BORDER_LEGEND },
+        lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }
+    };
+    /**
+     * Robot arms sit on the floor (or mount to a ceiling/wall — that's a
+     * v2 feature). Default depth = operation - floor like other floor-
+     * mounted equipment, so the chain reach scales with the configured
+     * facility height.
+     */
+    static placement = 'floor';
+    static align = 'bottom';
+    static defaultDepth = (h) => h.operation - h.floor;
+    /**
+     * Dynamic nature — appends one number property per joint in the active
+     * chain. Each property uses the joint's range as `min`/`max` so the
+     * property panel can render a constrained slider/spinner. The chain
+     * preset can change at runtime, and `get nature()` is re-evaluated
+     * whenever the property panel queries it, so the joint count stays in
+     * sync with the active preset.
+     *
+     * For revolute joints the value is in radians; for prismatic, scene units.
+     */
+    get nature() {
+        const chain = this._activeChain;
+        // Joint values: revolute = degrees (range usually ±180), prismatic =
+        // scene length units. CHAIN_PRESETS already encode revolute ranges in
+        // degrees; the 3D side converts to radians at the math boundary.
+        const jointProps = chain.map((c, i) => ({
+            type: 'number',
+            label: `joint-${i + 1}`,
+            name: `joint${i}`,
+            property: {
+                min: c.range[0],
+                max: c.range[1],
+                step: c.type === 'revolute' ? 1 : 1
+            }
+        }));
+        return {
+            mutable: false,
+            resizable: true,
+            rotatable: true,
+            properties: [...STATIC_PROPERTIES, ...jointProps],
+            help: 'scene/component/robot-arm'
+        };
+    }
+    /**
+     * Resolve the active chain for property-panel introspection. Mirrors
+     * the resolution in robot-arm-3d.ts (state.chain wins, else preset,
+     * else default 6-axis-industrial). Kept simple — the 3D side does the
+     * same logic with depth-based scaling, but for property labeling we
+     * only need the structure (axis count + ranges), not absolute lengths.
+     */
+    get _activeChain() {
+        const state = this.state;
+        if (Array.isArray(state.chain) && state.chain.length > 0)
+            return state.chain;
+        const presetName = (state.chainPreset ?? '6-axis-industrial');
+        return CHAIN_PRESETS[presetName] ?? CHAIN_PRESETS['6-axis-industrial'];
+    }
+    get anchors() {
+        return [];
+    }
+    /**
+     * 2D — base rectangle + a stylized arm silhouette pointing toward the
+     * top-right. Just enough to identify the component as a robot arm in
+     * plan view; the real visual lives in 3D.
+     */
+    render(ctx) {
+        const { left = 0, top = 0, width = 100, height = 100 } = this.state;
+        const bodyFill = pickColor(this.state.fillStyle, this.state.bodyColor, BODY_LEGEND.default);
+        const borderColor = pickColor(this.state.strokeStyle, this.state.borderColor, BORDER_LEGEND.default);
+        const lineWidth = numOr(this.state.lineWidth, 1);
+        ctx.beginPath();
+        ctx.rect(left, top, width, height);
+        ctx.fillStyle = bodyFill;
+        ctx.fill();
+        ctx.strokeStyle = borderColor;
+        ctx.lineWidth = lineWidth;
+        ctx.stroke();
+        // Stylized arm silhouette: base square at center → up → bent right.
+        const cx = left + width / 2;
+        const cy = top + height / 2;
+        const r = Math.min(width, height) * 0.32;
+        ctx.save();
+        ctx.strokeStyle = borderColor;
+        ctx.lineWidth = Math.max(lineWidth, Math.min(width, height) * 0.025);
+        // Base pedestal
+        ctx.fillStyle = borderColor;
+        ctx.fillRect(cx - r * 0.5, cy + r * 0.6, r, r * 0.3);
+        // Upper arm
+        ctx.beginPath();
+        ctx.moveTo(cx, cy + r * 0.6);
+        ctx.lineTo(cx, cy - r * 0.2);
+        ctx.stroke();
+        // Forearm
+        ctx.beginPath();
+        ctx.moveTo(cx, cy - r * 0.2);
+        ctx.lineTo(cx + r * 0.7, cy - r * 0.7);
+        ctx.stroke();
+        // Joint dots
+        ctx.fillStyle = borderColor;
+        ctx.beginPath();
+        ctx.arc(cx, cy - r * 0.2, Math.max(2, r * 0.1), 0, Math.PI * 2);
+        ctx.fill();
+        ctx.beginPath();
+        ctx.arc(cx + r * 0.7, cy - r * 0.7, Math.max(1.5, r * 0.08), 0, Math.PI * 2);
+        ctx.fill();
+        ctx.restore();
+    }
+    onchange(after, before) {
+        // Per-joint number properties (joint0 … jointN-1) are dynamic; treat
+        // any key matching the pattern as a joint update.
+        const hasJoint = Object.keys(after).some(k => /^joint\d+$/.test(k));
+        if (hasJoint ||
+            'style' in after ||
+            'chainPreset' in after ||
+            'chain' in after ||
+            'joints' in after ||
+            'linkShape' in after ||
+            'jointHousing' in after ||
+            'linkRadius' in after ||
+            'color' in after ||
+            'accentColor' in after ||
+            'fillStyle' in after ||
+            'strokeStyle' in after ||
+            'lineWidth' in after ||
+            'alpha' in after ||
+            'material3d' in after ||
+            'gripper' in after ||
+            'gripperType' in after ||
+            'target' in after ||
+            'showReachSphere' in after ||
+            'status' in after ||
+            'bodyColor' in after ||
+            'borderColor' in after) {
+            ;
+            this.clearCache?.('fillStyle');
+            this.invalidate();
+        }
+        super.onchange(after, before);
+    }
+    buildRealObject() {
+        return new RobotArm3D(this);
+    }
+    /**
+     * CarrierHolder hook — return the gripper TCP frame so any Carriable
+     * child (parcel/box/pallet/...) mounts onto the moving end-effector.
+     * IK rotation propagates to the carrier through Three.js scene-graph.
+     *
+     * Pose convention (real-world pick-and-place: gripper pointing toward
+     * the work, carrier hanging *beyond* the gripper tip):
+     *
+     *   - Frame: TCP (gripper working point — between finger tips for
+     *     jaws, contact face for suction/magnetic). Built by
+     *     `RobotArm3D._buildGripper`. TCP's +Z = gripper-forward direction
+     *     (away from the wrist).
+     *
+     *   - Rotation: x:-π/2 — maps carrier's local +Y axis ("up" in the
+     *     carrier's authored frame) to TCP's -Z direction. With the gripper
+     *     pointing down (typical work pose), TCP +Z = world -Y (down), so
+     *     TCP -Z = world +Y (up). Result: carrier's "up" stays world-up
+     *     during transit, and the carrier's body extends from TCP origin
+     *     in TCP +Z direction (down in world) — i.e. hanging BELOW the
+     *     gripper, not buried inside it.
+     *
+     *   - Position: z = +halfDepth — places the carrier's TOP face center
+     *     at the TCP origin (where the fingers grip). Carrier's local +Y
+     *     extent (top) = halfDepth, which after x:-π/2 rotation maps to
+     *     TCP -halfDepth Z. Shifting carrier center to TCP +halfDepth Z
+     *     puts that top point exactly at TCP origin. Carrier body then
+     *     extends through TCP +Z, ending at TCP +depth (bottom face).
+     *
+     * Earlier (x:+π/2, z:-halfDepth) inverted the carrier's body direction
+     * — body extended back into the wrist, leaving the box visually inside
+     * the finger area. The current convention pushes the body OUT past the
+     * fingertips, where a real gripper would hold it.
+     */
+    attachPointFor(carrier) {
+        const ro = this._realObject;
+        const frame = ro?.getGripperFrame?.();
+        if (!frame)
+            return undefined;
+        const halfDepth = resolveDepth(carrier) / 2;
+        return {
+            attach: frame,
+            localPosition: { x: 0, y: 0, z: halfDepth },
+            localRotation: { x: -Math.PI / 2, y: 0, z: 0 }
+        };
+    }
+    /**
+     * Pick: TCP descends vertically onto the carrier's top face, gripper
+     * closes, carrier becomes our child.
+     *
+     *   1. TCP → APPROACH above pick (carrier's xy, +clearance in world Y)
+     *   2. TCP → pick (descend straight down to carrier's top face)
+     *   3. close gripper + reparent(carrier → this)
+     *
+     * The approach waypoint exists so the FINAL leg is a clean vertical
+     * descent — the gripper enters the carrier from straight above, not a
+     * sideways sweep that could clip or grab at a wrong angle.
+     *
+     * Pose resolution: TCP lands on the CARRIER'S TOP FACE (carrier.world.y +
+     * carrier.depth/2). After grip, `attachPointFor`'s `localPosition.z =
+     * +halfDepth` keeps the carrier's top at TCP origin during transit —
+     * exact, no offset drift.
+     *
+     * Each waypoint includes the carrier's world yaw so IK can spin joint 5
+     * (tool roll) to align the gripper's "side" with the carrier's. Without
+     * it, reparent at pick instantly snaps the carrier to the gripper's
+     * axis, visibly twisting it 0° → up to 360° in one frame.
+     *
+     * @param options.approachClearance  Vertical offset (world units)
+     *   between approach and pick targets. Default 10.
+     * @param options.timeoutMs  Per-segment IK timeout (default 15000ms).
+     * @param options.reparentDuration  Animation duration for reparent (default 800ms).
+     */
+    async pick(carrier, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 15000;
+        const reparentDuration = options.reparentDuration ?? 800;
+        const clearance = options.approachClearance ?? 10;
+        // Read carrier height via _realObject.effectiveDepth — `state.depth`
+        // is often not explicitly set (carriers like Box rely on
+        // `static defaultDepth`), and reading state alone returns 0, which
+        // collapses every Y offset and drives the gripper into the carrier's
+        // volumetric center instead of its top face.
+        const carrierDepth = resolveDepth(carrier);
+        const halfDepth = carrierDepth / 2;
+        const yaw = this._yawOf(carrier);
+        const target = this._targetFor(carrier, halfDepth, yaw);
+        const approach = this._targetFor(carrier, halfDepth + clearance, yaw);
+        this.set('target', approach);
+        await waitForTcpReached(this, timeoutMs);
+        this.set('target', target);
+        await waitForTcpReached(this, timeoutMs);
+        this.reparent?.(carrier, { animated: true, duration: reparentDuration });
+        this.set('gripper', { ...(this.state.gripper ?? {}), state: 1 });
+        await sleep(reparentDuration);
+    }
+    /**
+     * Place: TCP descends vertically over the holder, gripper opens,
+     * carrier becomes the holder's child.
+     *
+     *   1. TCP → APPROACH above place (carrier's xy, +clearance)
+     *   2. TCP → place (descend straight down to drop point)
+     *   3. open gripper + reparent(carrier → holder)
+     *
+     * Pose resolution: TCP lands at where the carrier's top WILL BE after
+     * the drop, so the carrier lands with its bottom on the holder's attach
+     * surface. Computed as `holder.attachFrame.world.y + carrier.depth` (so
+     * yOffset = carrierDepth, not halfDepth like pick).
+     *
+     * @see pick — same option semantics.
+     */
+    async place(carrier, holder, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 15000;
+        const reparentDuration = options.reparentDuration ?? 800;
+        const clearance = options.approachClearance ?? 10;
+        const carrierDepth = resolveDepth(carrier);
+        const yaw = this._yawOf(holder);
+        const target = this._targetFor(holder, carrierDepth, yaw); // top-of-carrier after drop
+        const approach = this._targetFor(holder, carrierDepth + clearance, yaw);
+        this.set('target', approach);
+        await waitForTcpReached(this, timeoutMs);
+        this.set('target', target);
+        await waitForTcpReached(this, timeoutMs);
+        holder.reparent?.(carrier, { animated: true, duration: reparentDuration });
+        this.set('gripper', { ...(this.state.gripper ?? {}), state: 0 });
+        await sleep(reparentDuration);
+    }
+    /**
+     * `pickAndPlace` is inherited from the `Mover` mixin default — runs
+     * `pick(carrier)` then `place(carrier, holder)` sequentially. The
+     * decomposition is safe: the carrier's world position only matters
+     * during pick (carrier-relative waypoints), and after pick the carrier
+     * is the TCP's child (so re-querying it would chase its own tail —
+     * which we don't, since place uses holder-relative waypoints only).
+     *
+     * @example
+     * ```ts
+     * await robotArm.pickAndPlace(box, spotB)
+     * await robotArm.pnp(parcel, palletA, { approachClearance: 30 })
+     * ```
+     */
+    /** Short alias for `pickAndPlace`. Same arguments, same behavior. */
+    pnp(carrier, placeHolder, options) {
+        return this.pickAndPlace(carrier, placeHolder, options);
+    }
+    /**
+     * Resolve a TCP position in this arm's chain-local frame.
+     *
+     * For a CarrierHolder (has `attachPointFor`), uses the holder's own
+     * attach frame as the base — that's the canonical "where carriers
+     * sit on me" point (top of Spot's pad, gripper TCP for another arm,
+     * etc.). For a plain carrier, uses its world center.
+     *
+     * `worldYOffset` is added to the resolved world Y before projecting
+     * back to chain-local — used by pickAndPlace to lift the TCP above
+     * the target (approach waypoints) and to land it on the carrier's
+     * top face rather than its volumetric center.
+     */
+    _targetFor(component, worldYOffset = 0, yaw) {
+        const ro3d = this._realObject;
+        let baseWp;
+        // Prefer holder's attach frame when available.
+        const attachPointFor = component.attachPointFor;
+        if (typeof attachPointFor === 'function') {
+            const point = attachPointFor.call(component, this);
+            if (point?.attach) {
+                point.attach.updateWorldMatrix?.(true, false);
+                baseWp = point.attach.getWorldPosition?.(new THREE.Vector3());
+            }
+        }
+        if (!baseWp) {
+            const obj = component._realObject?.object3d;
+            if (obj) {
+                obj.updateWorldMatrix(true, false);
+                baseWp = obj.getWorldPosition(new THREE.Vector3());
+            }
+        }
+        if (!ro3d || !baseWp) {
+            // Final fallback: 2D bounds center — only before 3D builds.
+            const c = component.center;
+            return { x: c.x, y: worldYOffset, z: c.y, yaw };
+        }
+        const local = ro3d.worldToChainLocal(baseWp.x, baseWp.y + worldYOffset, baseWp.z);
+        return { x: local.x, y: local.y, z: local.z, yaw };
+    }
+    /**
+     * Extract a component's world yaw (rotation around world +Y) from its
+     * 3D object's world matrix. Returns 0 if the object isn't built yet.
+     * Used by `pickAndPlace` so the gripper can match the carrier's /
+     * placeHolder's current orientation — preventing a yaw snap at the
+     * moment of reparent.
+     */
+    _yawOf(component) {
+        const obj = component._realObject?.object3d;
+        if (!obj)
+            return 0;
+        obj.updateWorldMatrix(true, false);
+        const q = new THREE.Quaternion();
+        obj.getWorldQuaternion(q);
+        const e = new THREE.Euler().setFromQuaternion(q, 'YXZ');
+        return e.y;
+    }
+};
+RobotArm = __decorate([
+    sceneComponent('robot-arm')
+], RobotArm);
+export default RobotArm;
+/**
+ * Resolve when the robot arm fires `tcp-reached`, reject on timeout.
+ * The 3D side fires this event on smoothing completion (last joint
+ * value within threshold of its target).
+ */
+function waitForTcpReached(component, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let timer;
+        const onReached = () => {
+            clearTimeout(timer);
+            component.off?.('tcp-reached', onReached);
+            resolve();
+        };
+        timer = setTimeout(() => {
+            ;
+            component.off?.('tcp-reached', onReached);
+            reject(new Error('TCP reach timeout'));
+        }, timeoutMs);
+        component.on?.('tcp-reached', onReached);
+    });
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function numOr(v, dflt) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : dflt;
+}
+/**
+ * Resolve a component's 3D height. things-scene v10 carriers (Box, Pallet,
+ * etc.) typically declare `static defaultDepth` rather than setting
+ * `state.depth`, so reading state alone returns 0 — wrong for a
+ * default-sized box. The framework resolves the actual value into
+ * `_realObject.effectiveDepth`. Falls back to `state.depth` for
+ * components built before their RealObject exists.
+ */
+function resolveDepth(c) {
+    const eff = c?._realObject?.effectiveDepth;
+    if (typeof eff === 'number' && Number.isFinite(eff))
+        return eff;
+    return numOr(c?.state?.depth, 0);
+}
+function pickColor(...candidates) {
+    for (const c of candidates) {
+        if (typeof c === 'string' && c && c !== 'transparent')
+            return c;
+    }
+    return '#888';
+}
+//# sourceMappingURL=robot-arm.js.map

package/dist/robot-arm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robot-arm.js","sourceRoot":"","sources":["../src/robot-arm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAA8B,iBAAiB,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAClH,OAAO,EACL,aAAa,EACb,UAAU,EACV,KAAK,EACL,SAAS,EAMV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAwB,MAAM,uBAAuB,CAAA;AAK3E,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,MAAM;CAChB,CAAA;AAED,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,MAAM;CAChB,CAAA;AAED,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,iBAAiB,GAAG;IACxB;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE;YACR,OAAO,EAAE;gBACP,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;gBAC9C,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBACpC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBACpC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;aACzC;SACF;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE;YACR,OAAO,EAAE;gBACP,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE;gBAC5D,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;gBAClD,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;gBAClD,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,uBAAuB,EAAE;aACnE;SACF;KACF;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE;IAC5D;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE;YACR,OAAO,EAAE;gBACP,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;gBAC1C,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACxC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;gBAC1C,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;gBAClD,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aACnC;SACF;KACF;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACzE;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE;YACR,OAAO,EAAE;gBACP,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAClC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACtC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;gBAC1C,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;gBAClC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;aACrC;SACF;KACF;CACF,CAAA;AAED,8EAA8E;AAC9E,mEAAmE;AACnE,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,qBAAqB;AACrB,EAAE;AACF,2FAA2F;AAC3F,mEAAmE;AACnE,yEAAyE;AACzE,8EAA8E;AAC9E,EAAE;AACF,0EAA0E;AAC1E,8EAA8E;AAC9E,qEAAqE;AACrE,gDAAgD;AAChD,EAAE;AACF,oEAAoE;AACpE,sEAAsE;AACtE,mEAAmE;AACnE,0CAA0C;AAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAOzE,CAAA;AAGc,IAAM,QAAQ,GAAd,MAAM,QAAS,SAAQ,IAAI;IACxC,MAAM,CAAC,OAAO,GAAkC;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;QAClD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE;QACtD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE;KAC/D,CAAA;IAED;;;;;OAKG;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;;;;;;;;;OASG;IACH,IAAI,MAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAA;QAC/B,qEAAqE;QACrE,sEAAsE;QACtE,iEAAiE;QACjE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE;YACvB,IAAI,EAAE,QAAQ,CAAC,EAAE;YACjB,QAAQ,EAAE;gBACR,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACf,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACf,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACpC;SACF,CAAC,CAAC,CAAA;QACH,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,CAAC,GAAG,iBAAiB,EAAE,GAAG,UAAU,CAAQ;YACxD,IAAI,EAAE,2BAA2B;SAClC,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,IAAY,YAAY;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAY,CAAA;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAA;QAC5E,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,mBAAmB,CAAoB,CAAA;QAChF,OAAO,aAAa,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACxE,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QACnE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAG,IAAI,CAAC,KAAa,CAAC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;QACpG,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAG,IAAI,CAAC,KAAa,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QAC7G,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAEhD,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAClC,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAA;QACxB,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;QAC7B,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,GAAG,CAAC,MAAM,EAAE,CAAA;QAEZ,oEAAoE;QACpE,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;QAC3B,MAAM,EAAE,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,CAAA;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QACxC,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;QAC7B,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAA;QAEpE,gBAAgB;QAChB,GAAG,CAAC,SAAS,GAAG,WAAW,CAAA;QAC3B,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAA;QACpD,YAAY;QACZ,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;QAC5B,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;QAC5B,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,UAAU;QACV,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;QAC5B,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;QACtC,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,aAAa;QACb,GAAG,CAAC,SAAS,GAAG,WAAqB,CAAA;QACrC,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QAC/D,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,SAAS,EAAE,CAAA;QACf,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QAC5E,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,OAAO,EAAE,CAAA;IACf,CAAC;IAED,QAAQ,CAAC,KAA8B,EAAE,MAA+B;QACtE,qEAAqE;QACrE,kDAAkD;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACnE,IACE,QAAQ;YACR,OAAO,IAAI,KAAK;YAChB,aAAa,IAAI,KAAK;YACtB,OAAO,IAAI,KAAK;YAChB,QAAQ,IAAI,KAAK;YACjB,WAAW,IAAI,KAAK;YACpB,cAAc,IAAI,KAAK;YACvB,YAAY,IAAI,KAAK;YACrB,OAAO,IAAI,KAAK;YAChB,aAAa,IAAI,KAAK;YACtB,WAAW,IAAI,KAAK;YACpB,aAAa,IAAI,KAAK;YACtB,WAAW,IAAI,KAAK;YACpB,OAAO,IAAI,KAAK;YAChB,YAAY,IAAI,KAAK;YACrB,SAAS,IAAI,KAAK;YAClB,aAAa,IAAI,KAAK;YACtB,QAAQ,IAAI,KAAK;YACjB,iBAAiB,IAAI,KAAK;YAC1B,QAAQ,IAAI,KAAK;YACjB,WAAW,IAAI,KAAK;YACpB,aAAa,IAAI,KAAK,EACtB,CAAC;YACD,CAAC;YAAC,IAAY,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,CAAA;YACxC,IAAI,CAAC,UAAU,EAAE,CAAA;QACnB,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC/B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,UAAU,CAAC,IAAW,CAAC,CAAA;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,cAAc,CAAC,OAAkB;QAC/B,MAAM,EAAE,GAAI,IAAY,CAAC,WAAqC,CAAA;QAC9D,MAAM,KAAK,GAAG,EAAE,EAAE,eAAe,EAAE,EAAE,CAAA;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAA;QAC5B,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3C,OAAO;YACL,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE;YAC3C,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;SAC/C,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACM,KAAK,CAAC,IAAI,CAAC,OAAkB,EAAE,UAAuB,EAAE;QAC/D,MAAM,SAAS,GAAI,OAAO,CAAC,SAAgC,IAAI,KAAK,CAAA;QACpE,MAAM,gBAAgB,GAAI,OAAO,CAAC,gBAAuC,IAAI,GAAG,CAAA;QAChF,MAAM,SAAS,GAAI,OAAO,CAAC,iBAAwC,IAAI,EAAE,CAAA;QACzE,qEAAqE;QACrE,yDAAyD;QACzD,mEAAmE;QACnE,qEAAqE;QACrE,6CAA6C;QAC7C,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAA;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,CAAA;QAErE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC5B,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAExC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1B,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAEvC;QAAC,IAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAA;QAClF,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAE,IAAI,CAAC,KAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACzE,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACM,KAAK,CAAC,KAAK,CAAC,OAAkB,EAAE,MAAiB,EAAE,UAAuB,EAAE;QACnF,MAAM,SAAS,GAAI,OAAO,CAAC,SAAgC,IAAI,KAAK,CAAA;QACpE,MAAM,gBAAgB,GAAI,OAAO,CAAC,gBAAuC,IAAI,GAAG,CAAA;QAChF,MAAM,SAAS,GAAI,OAAO,CAAC,iBAAwC,IAAI,EAAE,CAAA;QACzE,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,CAAA,CAAC,4BAA4B;QACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,GAAG,CAAC,CAAA;QAEvE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC5B,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAExC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1B,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAEvC;QAAC,MAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAA;QACpF,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,CAAE,IAAI,CAAC,KAAa,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACzE,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,qEAAqE;IACrE,GAAG,CAAC,OAAkB,EAAE,WAAsB,EAAE,OAAqB;QACnE,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,UAAU,CAChB,SAAoB,EACpB,YAAY,GAAG,CAAC,EAChB,GAAY;QAEZ,MAAM,IAAI,GAAI,IAAY,CAAC,WAAqC,CAAA;QAEhE,IAAI,MAAiC,CAAA;QACrC,+CAA+C;QAC/C,MAAM,cAAc,GAAI,SAAiB,CAAC,cAAc,CAAA;QACxD,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAClD,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC;gBAClB,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBAC7C,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAC/D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAI,SAAiB,CAAC,WAAW,EAAE,QAAQ,CAAA;YACpD,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBAClC,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YACpD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,4DAA4D;YAC5D,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAA;YAC1B,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAA;QACjD,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QACjF,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAA;IACpD,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,SAAoB;QACjC,MAAM,GAAG,GAAI,SAAiB,CAAC,WAAW,EAAE,QAAQ,CAAA;QACpD,IAAI,CAAC,GAAG;YAAE,OAAO,CAAC,CAAA;QAClB,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAA;QAChC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACzB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACvD,OAAO,CAAC,CAAC,CAAC,CAAA;IACZ,CAAC;;AAnXkB,QAAQ;IAD5B,cAAc,CAAC,WAAW,CAAC;GACP,QAAQ,CAoX5B;eApXoB,QAAQ;AAsX7B;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,SAAoB,EAAE,SAAiB;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,KAAU,CAAA;QACd,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,YAAY,CAAC,KAAK,CAAC,CAClB;YAAC,SAAiB,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;YACnD,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QACD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,CAAC;YAAC,SAAiB,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;YACnD,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAA;QACxC,CAAC,EAAE,SAAS,CAAC,CACZ;QAAC,SAAiB,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,CAAU,EAAE,IAAY;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,CAAY;IAChC,MAAM,GAAG,GAAI,CAAS,EAAE,WAAW,EAAE,cAAc,CAAA;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IAC/D,OAAO,KAAK,CAAE,CAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,GAAG,UAAqB;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,aAAa;YAAE,OAAO,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Robot Arm — generalized articulated manipulator component.\n *\n * Designed to cover the visualization needs of robot arms WITHOUT a\n * specific URDF model. Configurable kinematic chain, link shape, joint\n * housing, gripper type — same component renders as a sleek cobot, a\n * heavy industrial 6-axis, a SCARA, or a minimal educational arm.\n *\n * State schema (all top-level properties optional except width/height):\n *\n *   {\n *     // structure\n *     style?: 'industrial' | 'cobot' | 'scara' | 'minimal',\n *     chainPreset?: '6-axis-industrial' | 'cobot-6-axis' | 'scara-4-axis' | 'pick-and-place-3-axis',\n *     chain?: ChainElement[],          // overrides preset\n *     joints?: number[] | { [i]: number },  // current joint values\n *\n *     // styling overrides\n *     linkShape?, jointHousing?, linkRadius?, color?, accentColor?,\n *\n *     // gripper\n *     gripper?: GripperConfig,\n *\n *     // IK target (TCP world position relative to component center, in\n *     // 3D-z-up convention used by IK module)\n *     target?: { x: number, y: number, z: number },\n *\n *     // visualization\n *     showReachSphere?: boolean\n *   }\n */\n\nimport * as THREE from 'three'\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Legendable,\n  Mover,\n  Placeable,\n  type Alignment,\n  type Heights,\n  type LegendBinding,\n  type MoveOptions,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { RobotArm3D } from './robot-arm-3d.js'\nimport { CHAIN_PRESETS, type ChainPresetName } from './robot-arm-styles.js'\nimport type { ChainElement } from './robot-arm-ik.js'\n\nexport type RobotArmStatus = 'idle' | 'moving' | 'gripping' | 'warn' | 'error'\n\nconst BODY_LEGEND = {\n  idle: '#ccc',\n  moving: '#afd0f1',\n  gripping: '#cfe6c8',\n  warn: '#ffba00',\n  error: '#e9746b',\n  default: '#ccc'\n}\n\nconst BORDER_LEGEND = {\n  idle: '#888',\n  moving: '#87b1db',\n  gripping: '#7aa274',\n  warn: '#d96f21',\n  error: '#a73928',\n  default: '#888'\n}\n\nconst LAMP_EMISSIVE_LEGEND = {\n  idle: '#333333',\n  moving: '#44aaff',\n  gripping: '#33aa44',\n  warn: '#ffaa00',\n  error: '#ff3333',\n  default: '#333333'\n}\n\nconst STATIC_PROPERTIES = [\n  {\n    type: 'select',\n    label: 'style',\n    name: 'style',\n    property: {\n      options: [\n        { display: 'Industrial', value: 'industrial' },\n        { display: 'Cobot', value: 'cobot' },\n        { display: 'SCARA', value: 'scara' },\n        { display: 'Minimal', value: 'minimal' }\n      ]\n    }\n  },\n  {\n    type: 'select',\n    label: 'chain-preset',\n    name: 'chainPreset',\n    property: {\n      options: [\n        { display: '6-Axis Industrial', value: '6-axis-industrial' },\n        { display: 'Cobot 6-Axis', value: 'cobot-6-axis' },\n        { display: 'SCARA 4-Axis', value: 'scara-4-axis' },\n        { display: 'Pick & Place 3-Axis', value: 'pick-and-place-3-axis' }\n      ]\n    }\n  },\n  { type: 'number', label: 'link-radius', name: 'linkRadius' },\n  {\n    type: 'select',\n    label: 'gripper-type',\n    name: 'gripperType',\n    property: {\n      options: [\n        { display: 'Parallel', value: 'parallel' },\n        { display: 'Suction', value: 'suction' },\n        { display: 'Magnetic', value: 'magnetic' },\n        { display: 'Three-Finger', value: 'three-finger' },\n        { display: 'None', value: 'none' }\n      ]\n    }\n  },\n  { type: 'checkbox', label: 'show-reach-sphere', name: 'showReachSphere' },\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: 'Gripping', value: 'gripping' },\n        { display: 'Warn', value: 'warn' },\n        { display: 'Error', value: 'error' }\n      ]\n    }\n  }\n]\n\n// CarrierHolder + ContainerAbstract: the arm needs the container's child-list\n// machinery (addComponent / reparent / events) AND CarrierHolder's\n// attachPointFor hook. CarrierHolder mixin alone only publishes the attach\n// policy; it doesn't add child management. RectPath(Shape) was wrong here —\n// Shape is a leaf so reparent silently failed. ContainerAbstract provides\n// the missing piece.\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Robot arm exists purely in the 3D scene graph\n// (URDF/IK joints, no DOM overlay), so the bare logical container is correct.\n//\n// Mover wraps the chain to publish pick/place/pickAndPlace primitives. It\n// must sit OUTSIDE CarrierHolder because Mover's defaults call this.reparent,\n// which CarrierHolder provides (overrides the base ContainerAbstract\n// version with the attach-frame-aware variant).\n//\n// The instance type cast surfaces Mover's API on `this` so subclass\n// `override` keywords compile and `this.pickAndPlace(...)` resolves —\n// without it, the `as unknown as typeof Component` cast erases all\n// mixin contributions to the static side.\nconst Base = Mover(CarrierHolder(Legendable(Placeable(ContainerAbstract)))) as unknown as typeof Component & {\n  new (...args: any[]): Component & {\n    isMover: boolean\n    pick(carrier: Component, options?: MoveOptions): Promise<void>\n    place(carrier: Component, holder: Component, options?: MoveOptions): Promise<void>\n    pickAndPlace(carrier: Component, holder: Component, options?: MoveOptions): Promise<void>\n  }\n}\n\n@sceneComponent('robot-arm')\nexport default class RobotArm extends Base {\n  static legends: Record<string, LegendBinding> = {\n    bodyColor: { from: 'status', legend: BODY_LEGEND },\n    borderColor: { from: 'status', legend: BORDER_LEGEND },\n    lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }\n  }\n\n  /**\n   * Robot arms sit on the floor (or mount to a ceiling/wall — that's a\n   * v2 feature). Default depth = operation - floor like other floor-\n   * mounted equipment, so the chain reach scales with the configured\n   * facility height.\n   */\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (h: Heights) => h.operation - h.floor\n\n  /**\n   * Dynamic nature — appends one number property per joint in the active\n   * chain. Each property uses the joint's range as `min`/`max` so the\n   * property panel can render a constrained slider/spinner. The chain\n   * preset can change at runtime, and `get nature()` is re-evaluated\n   * whenever the property panel queries it, so the joint count stays in\n   * sync with the active preset.\n   *\n   * For revolute joints the value is in radians; for prismatic, scene units.\n   */\n  get nature(): ComponentNature {\n    const chain = this._activeChain\n    // Joint values: revolute = degrees (range usually ±180), prismatic =\n    // scene length units. CHAIN_PRESETS already encode revolute ranges in\n    // degrees; the 3D side converts to radians at the math boundary.\n    const jointProps = chain.map((c, i) => ({\n      type: 'number',\n      label: `joint-${i + 1}`,\n      name: `joint${i}`,\n      property: {\n        min: c.range[0],\n        max: c.range[1],\n        step: c.type === 'revolute' ? 1 : 1\n      }\n    }))\n    return {\n      mutable: false,\n      resizable: true,\n      rotatable: true,\n      properties: [...STATIC_PROPERTIES, ...jointProps] as any,\n      help: 'scene/component/robot-arm'\n    }\n  }\n\n  /**\n   * Resolve the active chain for property-panel introspection. Mirrors\n   * the resolution in robot-arm-3d.ts (state.chain wins, else preset,\n   * else default 6-axis-industrial). Kept simple — the 3D side does the\n   * same logic with depth-based scaling, but for property labeling we\n   * only need the structure (axis count + ranges), not absolute lengths.\n   */\n  private get _activeChain(): ChainElement[] {\n    const state = this.state as any\n    if (Array.isArray(state.chain) && state.chain.length > 0) return state.chain\n    const presetName = (state.chainPreset ?? '6-axis-industrial') as ChainPresetName\n    return CHAIN_PRESETS[presetName] ?? CHAIN_PRESETS['6-axis-industrial']\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /**\n   * 2D — base rectangle + a stylized arm silhouette pointing toward the\n   * top-right. Just enough to identify the component as a robot arm in\n   * plan view; the real visual lives in 3D.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const bodyFill = pickColor(this.state.fillStyle, (this.state as any).bodyColor, BODY_LEGEND.default)\n    const borderColor = pickColor(this.state.strokeStyle, (this.state as any).borderColor, BORDER_LEGEND.default)\n    const lineWidth = numOr(this.state.lineWidth, 1)\n\n    ctx.beginPath()\n    ctx.rect(left, top, width, height)\n    ctx.fillStyle = bodyFill\n    ctx.fill()\n    ctx.strokeStyle = borderColor\n    ctx.lineWidth = lineWidth\n    ctx.stroke()\n\n    // Stylized arm silhouette: base square at center → up → bent right.\n    const cx = left + width / 2\n    const cy = top + height / 2\n    const r = Math.min(width, height) * 0.32\n    ctx.save()\n    ctx.strokeStyle = borderColor\n    ctx.lineWidth = Math.max(lineWidth, Math.min(width, height) * 0.025)\n\n    // Base pedestal\n    ctx.fillStyle = borderColor\n    ctx.fillRect(cx - r * 0.5, cy + r * 0.6, r, r * 0.3)\n    // Upper arm\n    ctx.beginPath()\n    ctx.moveTo(cx, cy + r * 0.6)\n    ctx.lineTo(cx, cy - r * 0.2)\n    ctx.stroke()\n    // Forearm\n    ctx.beginPath()\n    ctx.moveTo(cx, cy - r * 0.2)\n    ctx.lineTo(cx + r * 0.7, cy - r * 0.7)\n    ctx.stroke()\n    // Joint dots\n    ctx.fillStyle = borderColor as string\n    ctx.beginPath()\n    ctx.arc(cx, cy - r * 0.2, Math.max(2, r * 0.1), 0, Math.PI * 2)\n    ctx.fill()\n    ctx.beginPath()\n    ctx.arc(cx + r * 0.7, cy - r * 0.7, Math.max(1.5, r * 0.08), 0, Math.PI * 2)\n    ctx.fill()\n    ctx.restore()\n  }\n\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>) {\n    // Per-joint number properties (joint0 … jointN-1) are dynamic; treat\n    // any key matching the pattern as a joint update.\n    const hasJoint = Object.keys(after).some(k => /^joint\\d+$/.test(k))\n    if (\n      hasJoint ||\n      'style' in after ||\n      'chainPreset' in after ||\n      'chain' in after ||\n      'joints' in after ||\n      'linkShape' in after ||\n      'jointHousing' in after ||\n      'linkRadius' in after ||\n      'color' in after ||\n      'accentColor' in after ||\n      'fillStyle' in after ||\n      'strokeStyle' in after ||\n      'lineWidth' in after ||\n      'alpha' in after ||\n      'material3d' in after ||\n      'gripper' in after ||\n      'gripperType' in after ||\n      'target' in after ||\n      'showReachSphere' in after ||\n      'status' in after ||\n      'bodyColor' in after ||\n      'borderColor' in after\n    ) {\n      ;(this as any).clearCache?.('fillStyle')\n      this.invalidate()\n    }\n    super.onchange(after, before)\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new RobotArm3D(this as any)\n  }\n\n  /**\n   * CarrierHolder hook — return the gripper TCP frame so any Carriable\n   * child (parcel/box/pallet/...) mounts onto the moving end-effector.\n   * IK rotation propagates to the carrier through Three.js scene-graph.\n   *\n   * Pose convention (real-world pick-and-place: gripper pointing toward\n   * the work, carrier hanging *beyond* the gripper tip):\n   *\n   *   - Frame: TCP (gripper working point — between finger tips for\n   *     jaws, contact face for suction/magnetic). Built by\n   *     `RobotArm3D._buildGripper`. TCP's +Z = gripper-forward direction\n   *     (away from the wrist).\n   *\n   *   - Rotation: x:-π/2 — maps carrier's local +Y axis (\"up\" in the\n   *     carrier's authored frame) to TCP's -Z direction. With the gripper\n   *     pointing down (typical work pose), TCP +Z = world -Y (down), so\n   *     TCP -Z = world +Y (up). Result: carrier's \"up\" stays world-up\n   *     during transit, and the carrier's body extends from TCP origin\n   *     in TCP +Z direction (down in world) — i.e. hanging BELOW the\n   *     gripper, not buried inside it.\n   *\n   *   - Position: z = +halfDepth — places the carrier's TOP face center\n   *     at the TCP origin (where the fingers grip). Carrier's local +Y\n   *     extent (top) = halfDepth, which after x:-π/2 rotation maps to\n   *     TCP -halfDepth Z. Shifting carrier center to TCP +halfDepth Z\n   *     puts that top point exactly at TCP origin. Carrier body then\n   *     extends through TCP +Z, ending at TCP +depth (bottom face).\n   *\n   * Earlier (x:+π/2, z:-halfDepth) inverted the carrier's body direction\n   * — body extended back into the wrist, leaving the box visually inside\n   * the finger area. The current convention pushes the body OUT past the\n   * fingertips, where a real gripper would hold it.\n   */\n  attachPointFor(carrier: Component) {\n    const ro = (this as any)._realObject as RobotArm3D | undefined\n    const frame = ro?.getGripperFrame?.()\n    if (!frame) return undefined\n    const halfDepth = resolveDepth(carrier) / 2\n    return {\n      attach: frame,\n      localPosition: { x: 0, y: 0, z: halfDepth },\n      localRotation: { x: -Math.PI / 2, y: 0, z: 0 }\n    }\n  }\n\n  /**\n   * Pick: TCP descends vertically onto the carrier's top face, gripper\n   * closes, carrier becomes our child.\n   *\n   *   1. TCP → APPROACH above pick (carrier's xy, +clearance in world Y)\n   *   2. TCP → pick (descend straight down to carrier's top face)\n   *   3. close gripper + reparent(carrier → this)\n   *\n   * The approach waypoint exists so the FINAL leg is a clean vertical\n   * descent — the gripper enters the carrier from straight above, not a\n   * sideways sweep that could clip or grab at a wrong angle.\n   *\n   * Pose resolution: TCP lands on the CARRIER'S TOP FACE (carrier.world.y +\n   * carrier.depth/2). After grip, `attachPointFor`'s `localPosition.z =\n   * +halfDepth` keeps the carrier's top at TCP origin during transit —\n   * exact, no offset drift.\n   *\n   * Each waypoint includes the carrier's world yaw so IK can spin joint 5\n   * (tool roll) to align the gripper's \"side\" with the carrier's. Without\n   * it, reparent at pick instantly snaps the carrier to the gripper's\n   * axis, visibly twisting it 0° → up to 360° in one frame.\n   *\n   * @param options.approachClearance  Vertical offset (world units)\n   *   between approach and pick targets. Default 10.\n   * @param options.timeoutMs  Per-segment IK timeout (default 15000ms).\n   * @param options.reparentDuration  Animation duration for reparent (default 800ms).\n   */\n  override async pick(carrier: Component, options: MoveOptions = {}): Promise<void> {\n    const timeoutMs = (options.timeoutMs as number | undefined) ?? 15000\n    const reparentDuration = (options.reparentDuration as number | undefined) ?? 800\n    const clearance = (options.approachClearance as number | undefined) ?? 10\n    // Read carrier height via _realObject.effectiveDepth — `state.depth`\n    // is often not explicitly set (carriers like Box rely on\n    // `static defaultDepth`), and reading state alone returns 0, which\n    // collapses every Y offset and drives the gripper into the carrier's\n    // volumetric center instead of its top face.\n    const carrierDepth = resolveDepth(carrier)\n    const halfDepth = carrierDepth / 2\n    const yaw = this._yawOf(carrier)\n    const target = this._targetFor(carrier, halfDepth, yaw)\n    const approach = this._targetFor(carrier, halfDepth + clearance, yaw)\n\n    this.set('target', approach)\n    await waitForTcpReached(this, timeoutMs)\n\n    this.set('target', target)\n    await waitForTcpReached(this, timeoutMs)\n\n    ;(this as any).reparent?.(carrier, { animated: true, duration: reparentDuration })\n    this.set('gripper', { ...((this.state as any).gripper ?? {}), state: 1 })\n    await sleep(reparentDuration)\n  }\n\n  /**\n   * Place: TCP descends vertically over the holder, gripper opens,\n   * carrier becomes the holder's child.\n   *\n   *   1. TCP → APPROACH above place (carrier's xy, +clearance)\n   *   2. TCP → place (descend straight down to drop point)\n   *   3. open gripper + reparent(carrier → holder)\n   *\n   * Pose resolution: TCP lands at where the carrier's top WILL BE after\n   * the drop, so the carrier lands with its bottom on the holder's attach\n   * surface. Computed as `holder.attachFrame.world.y + carrier.depth` (so\n   * yOffset = carrierDepth, not halfDepth like pick).\n   *\n   * @see pick — same option semantics.\n   */\n  override async place(carrier: Component, holder: Component, options: MoveOptions = {}): Promise<void> {\n    const timeoutMs = (options.timeoutMs as number | undefined) ?? 15000\n    const reparentDuration = (options.reparentDuration as number | undefined) ?? 800\n    const clearance = (options.approachClearance as number | undefined) ?? 10\n    const carrierDepth = resolveDepth(carrier)\n    const yaw = this._yawOf(holder)\n    const target = this._targetFor(holder, carrierDepth, yaw) // top-of-carrier after drop\n    const approach = this._targetFor(holder, carrierDepth + clearance, yaw)\n\n    this.set('target', approach)\n    await waitForTcpReached(this, timeoutMs)\n\n    this.set('target', target)\n    await waitForTcpReached(this, timeoutMs)\n\n    ;(holder as any).reparent?.(carrier, { animated: true, duration: reparentDuration })\n    this.set('gripper', { ...((this.state as any).gripper ?? {}), state: 0 })\n    await sleep(reparentDuration)\n  }\n\n  /**\n   * `pickAndPlace` is inherited from the `Mover` mixin default — runs\n   * `pick(carrier)` then `place(carrier, holder)` sequentially. The\n   * decomposition is safe: the carrier's world position only matters\n   * during pick (carrier-relative waypoints), and after pick the carrier\n   * is the TCP's child (so re-querying it would chase its own tail —\n   * which we don't, since place uses holder-relative waypoints only).\n   *\n   * @example\n   * ```ts\n   * await robotArm.pickAndPlace(box, spotB)\n   * await robotArm.pnp(parcel, palletA, { approachClearance: 30 })\n   * ```\n   */\n  /** Short alias for `pickAndPlace`. Same arguments, same behavior. */\n  pnp(carrier: Component, placeHolder: Component, options?: MoveOptions): Promise<void> {\n    return this.pickAndPlace(carrier, placeHolder, options)\n  }\n\n  /**\n   * Resolve a TCP position in this arm's chain-local frame.\n   *\n   * For a CarrierHolder (has `attachPointFor`), uses the holder's own\n   * attach frame as the base — that's the canonical \"where carriers\n   * sit on me\" point (top of Spot's pad, gripper TCP for another arm,\n   * etc.). For a plain carrier, uses its world center.\n   *\n   * `worldYOffset` is added to the resolved world Y before projecting\n   * back to chain-local — used by pickAndPlace to lift the TCP above\n   * the target (approach waypoints) and to land it on the carrier's\n   * top face rather than its volumetric center.\n   */\n  private _targetFor(\n    component: Component,\n    worldYOffset = 0,\n    yaw?: number\n  ): { x: number; y: number; z: number; yaw?: number } {\n    const ro3d = (this as any)._realObject as RobotArm3D | undefined\n\n    let baseWp: THREE.Vector3 | undefined\n    // Prefer holder's attach frame when available.\n    const attachPointFor = (component as any).attachPointFor\n    if (typeof attachPointFor === 'function') {\n      const point = attachPointFor.call(component, this)\n      if (point?.attach) {\n        point.attach.updateWorldMatrix?.(true, false)\n        baseWp = point.attach.getWorldPosition?.(new THREE.Vector3())\n      }\n    }\n    if (!baseWp) {\n      const obj = (component as any)._realObject?.object3d\n      if (obj) {\n        obj.updateWorldMatrix(true, false)\n        baseWp = obj.getWorldPosition(new THREE.Vector3())\n      }\n    }\n    if (!ro3d || !baseWp) {\n      // Final fallback: 2D bounds center — only before 3D builds.\n      const c = component.center\n      return { x: c.x, y: worldYOffset, z: c.y, yaw }\n    }\n    const local = ro3d.worldToChainLocal(baseWp.x, baseWp.y + worldYOffset, baseWp.z)\n    return { x: local.x, y: local.y, z: local.z, yaw }\n  }\n\n  /**\n   * Extract a component's world yaw (rotation around world +Y) from its\n   * 3D object's world matrix. Returns 0 if the object isn't built yet.\n   * Used by `pickAndPlace` so the gripper can match the carrier's /\n   * placeHolder's current orientation — preventing a yaw snap at the\n   * moment of reparent.\n   */\n  private _yawOf(component: Component): number {\n    const obj = (component as any)._realObject?.object3d\n    if (!obj) return 0\n    obj.updateWorldMatrix(true, false)\n    const q = new THREE.Quaternion()\n    obj.getWorldQuaternion(q)\n    const e = new THREE.Euler().setFromQuaternion(q, 'YXZ')\n    return e.y\n  }\n}\n\n/**\n * Resolve when the robot arm fires `tcp-reached`, reject on timeout.\n * The 3D side fires this event on smoothing completion (last joint\n * value within threshold of its target).\n */\nfunction waitForTcpReached(component: Component, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    let timer: any\n    const onReached = () => {\n      clearTimeout(timer)\n      ;(component as any).off?.('tcp-reached', onReached)\n      resolve()\n    }\n    timer = setTimeout(() => {\n      ;(component as any).off?.('tcp-reached', onReached)\n      reject(new Error('TCP reach timeout'))\n    }, timeoutMs)\n    ;(component as any).on?.('tcp-reached', onReached)\n  })\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n\n/**\n * Resolve a component's 3D height. things-scene v10 carriers (Box, Pallet,\n * etc.) typically declare `static defaultDepth` rather than setting\n * `state.depth`, so reading state alone returns 0 — wrong for a\n * default-sized box. The framework resolves the actual value into\n * `_realObject.effectiveDepth`. Falls back to `state.depth` for\n * components built before their RealObject exists.\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 pickColor(...candidates: unknown[]): string {\n  for (const c of candidates) {\n    if (typeof c === 'string' && c && c !== 'transparent') return c\n  }\n  return '#888'\n}\n"]}

package/dist/templates/index.d.ts

@@ -1,4 +1,4 @@
-declare const _default: {
+declare const _default: ({
     type: string;
     description: string;
     group: string;
@@ -22,5 +22,31 @@ declare const _default: {
         underThresholdColor: string;
         progressThreshold: number;
     };
-}[];
+} | {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        linkRadius: number;
+        joint0: number;
+        joint1: number;
+        joint2: number;
+        joint3: number;
+        joint4: number;
+        joint5: number;
+        style: string;
+        chainPreset: string;
+        gripperType: string;
+        showReachSphere: boolean;
+        status: string;
+    };
+})[];
 export default _default;

package/dist/templates/index.js

@@ -1,3 +1,4 @@
 import tactTimer from './tact-timer.js';
-export default [tactTimer];
+import robotArm from './robot-arm.js';
+export default [tactTimer, robotArm];
 //# sourceMappingURL=index.js.map