entangle-ui 0.3.0 → 0.5.0

package/dist/esm/components/editor/ViewportGizmo/gizmoMath.js

@@ -0,0 +1,259 @@
+// ─── Constants ───
+const DEG2RAD = Math.PI / 180;
+const RAD2DEG = 180 / Math.PI;
+// ─── Euler → Rotation Matrix ───
+/**
+ * Build a 3×3 rotation matrix from Euler angles (YXZ intrinsic order).
+ * Matches Three.js default Euler order.
+ *
+ * @param yaw  - Y-axis rotation in degrees
+ * @param pitch - X-axis rotation in degrees
+ * @param roll  - Z-axis rotation in degrees
+ * @returns [right, up, forward] basis vectors (columns of rotation matrix)
+ */
+function eulerToRotationMatrix(yaw, pitch, roll = 0) {
+    const cy = Math.cos(yaw * DEG2RAD);
+    const sy = Math.sin(yaw * DEG2RAD);
+    const cp = Math.cos(pitch * DEG2RAD);
+    const sp = Math.sin(pitch * DEG2RAD);
+    const cr = Math.cos(roll * DEG2RAD);
+    const sr = Math.sin(roll * DEG2RAD);
+    // YXZ rotation: R = Ry * Rx * Rz
+    // Column 0 (right vector)
+    const r00 = cy * cr + sy * sp * sr;
+    const r10 = cp * sr;
+    const r20 = -sy * cr + cy * sp * sr;
+    // Column 1 (up vector)
+    const r01 = -cy * sr + sy * sp * cr;
+    const r11 = cp * cr;
+    const r21 = sy * sr + cy * sp * cr;
+    // Column 2 (forward vector)
+    const r02 = sy * cp;
+    const r12 = -sp;
+    const r22 = cy * cp;
+    return [
+        { x: r00, y: r10, z: r20 }, // right
+        { x: r01, y: r11, z: r21 }, // up
+        { x: r02, y: r12, z: r22 }, // forward
+    ];
+}
+// ─── 3D → 2D Projection ───
+/**
+ * Project a 3D point to 2D canvas coordinates using orthographic projection.
+ *
+ * @param point   - 3D point to project
+ * @param orientation - Camera orientation
+ * @param center  - Canvas center in pixels
+ * @param scale   - Pixels per unit
+ * @returns Projected position { x, y, depth }
+ */
+function projectToCanvas(point, orientation, center, scale) {
+    const [right, up, forward] = eulerToRotationMatrix(orientation.yaw, orientation.pitch, orientation.roll ?? 0);
+    // Project point onto camera basis (view space)
+    const viewX = point.x * right.x + point.y * right.y + point.z * right.z;
+    const viewY = point.x * up.x + point.y * up.y + point.z * up.z;
+    const viewZ = point.x * forward.x + point.y * forward.y + point.z * forward.z;
+    return {
+        x: center.x + viewX * scale,
+        y: center.y - viewY * scale, // canvas Y is flipped
+        depth: viewZ,
+    };
+}
+/**
+ * Get all 6 axis arm endpoints projected to 2D, sorted by depth (furthest first).
+ */
+function projectAxes(orientation, center, armLength, upAxis) {
+    const axes = upAxis === 'z-up'
+        ? [
+            { x: 1, y: 0, z: 0 }, // X
+            { x: 0, y: 1, z: 0 }, // Y
+            { x: 0, y: 0, z: 1 }, // Z (up)
+        ]
+        : [
+            { x: 1, y: 0, z: 0 }, // X
+            { x: 0, y: 1, z: 0 }, // Y (up)
+            { x: 0, y: 0, z: 1 }, // Z
+        ];
+    const axisNames = ['x', 'y', 'z'];
+    const arms = [];
+    for (let i = 0; i < 3; i++) {
+        const ax = axes[i];
+        const name = axisNames[i];
+        if (!ax || !name)
+            continue;
+        // Positive arm
+        const pos = projectToCanvas({ x: ax.x, y: ax.y, z: ax.z }, orientation, center, armLength);
+        arms.push({
+            axis: name,
+            positive: true,
+            screenX: pos.x,
+            screenY: pos.y,
+            depth: pos.depth,
+        });
+        // Negative arm
+        const neg = projectToCanvas({ x: -ax.x, y: -ax.y, z: -ax.z }, orientation, center, armLength * 0.4);
+        arms.push({
+            axis: name,
+            positive: false,
+            screenX: neg.x,
+            screenY: neg.y,
+            depth: neg.depth,
+        });
+    }
+    // Sort by depth — furthest first (painter's algorithm)
+    arms.sort((a, b) => a.depth - b.depth);
+    return arms;
+}
+// ─── Hit Testing ───
+function distPointToSegment(px, py, x1, y1, x2, y2) {
+    const dx = x2 - x1;
+    const dy = y2 - y1;
+    const lenSq = dx * dx + dy * dy;
+    if (lenSq === 0)
+        return Math.sqrt((px - x1) ** 2 + (py - y1) ** 2);
+    let t = ((px - x1) * dx + (py - y1) * dy) / lenSq;
+    t = Math.max(0, Math.min(1, t));
+    const projX = x1 + t * dx;
+    const projY = y1 + t * dy;
+    return Math.sqrt((px - projX) ** 2 + (py - projY) ** 2);
+}
+/**
+ * Hit test a screen position against the gizmo geometry.
+ */
+function gizmoHitTest(px, py, orientation, center, armLength, upAxis, tolerancePx = 12, originRadius = 6) {
+    // Test origin handle first
+    const originDist = Math.sqrt((px - center.x) ** 2 + (py - center.y) ** 2);
+    if (originDist <= originRadius + tolerancePx * 0.5) {
+        return { type: 'origin', distance: originDist };
+    }
+    const arms = projectAxes(orientation, center, armLength, upAxis);
+    let closest = { type: 'none', distance: Infinity };
+    for (const arm of arms) {
+        // Check tip first (label / axis tip)
+        const tipDist = Math.sqrt((px - arm.screenX) ** 2 + (py - arm.screenY) ** 2);
+        if (tipDist <= tolerancePx) {
+            const hitType = arm.positive ? 'axis-positive' : 'axis-negative';
+            if (tipDist < closest.distance) {
+                closest = { type: hitType, axis: arm.axis, distance: tipDist };
+            }
+        }
+        // Check arm line segment
+        const segDist = distPointToSegment(px, py, center.x, center.y, arm.screenX, arm.screenY);
+        if (segDist <= tolerancePx * 0.7 && segDist < closest.distance) {
+            const hitType = arm.positive ? 'axis-positive' : 'axis-negative';
+            closest = { type: hitType, axis: arm.axis, distance: segDist };
+        }
+    }
+    // Check orbit ring
+    const ringDist = Math.abs(originDist - armLength * 1.1);
+    if (ringDist <= tolerancePx * 0.5 && ringDist < closest.distance) {
+        return { type: 'ring', distance: ringDist };
+    }
+    return closest;
+}
+// ─── Preset Views ───
+/**
+ * Convert a preset view name to Euler angles.
+ */
+function presetViewToOrientation(view, upAxis) {
+    if (upAxis === 'y-up') {
+        switch (view) {
+            case 'front':
+                return { yaw: 0, pitch: 0 };
+            case 'back':
+                return { yaw: 180, pitch: 0 };
+            case 'right':
+                return { yaw: 90, pitch: 0 };
+            case 'left':
+                return { yaw: -90, pitch: 0 };
+            case 'top':
+                return { yaw: 0, pitch: 90 };
+            case 'bottom':
+                return { yaw: 0, pitch: -90 };
+        }
+    }
+    // Z-up
+    switch (view) {
+        case 'front':
+            return { yaw: 0, pitch: 0 };
+        case 'back':
+            return { yaw: 180, pitch: 0 };
+        case 'right':
+            return { yaw: 90, pitch: 0 };
+        case 'left':
+            return { yaw: -90, pitch: 0 };
+        case 'top':
+            return { yaw: 0, pitch: 90 };
+        case 'bottom':
+            return { yaw: 0, pitch: -90 };
+    }
+}
+// ─── Quaternion ↔ Euler ───
+/**
+ * Convert quaternion [x, y, z, w] to Euler representation (YXZ order, degrees).
+ * Utility for Three.js integration where `camera.quaternion` is available.
+ */
+function quaternionToEuler(qx, qy, qz, qw) {
+    // YXZ intrinsic rotation decomposition
+    // Matrix from quaternion
+    const xx = qx * qx;
+    const yy = qy * qy;
+    const zz = qz * qz;
+    const xy = qx * qy;
+    const xz = qx * qz;
+    const yz = qy * qz;
+    const wx = qw * qx;
+    const wy = qw * qy;
+    const wz = qw * qz;
+    const m11 = 1 - 2 * (yy + zz);
+    const m13 = 2 * (xz + wy);
+    const m21 = 2 * (xy + wz);
+    const m22 = 1 - 2 * (xx + zz);
+    const m23 = 2 * (yz - wx);
+    const m31 = 2 * (xz - wy);
+    const m33 = 1 - 2 * (xx + yy);
+    // YXZ order extraction
+    const pitch = Math.asin(-Math.max(-1, Math.min(1, m23)));
+    let yaw;
+    let roll;
+    if (Math.abs(m23) < 0.9999) {
+        yaw = Math.atan2(m13, m33);
+        roll = Math.atan2(m21, m22);
+    }
+    else {
+        yaw = Math.atan2(-m31, m11);
+        roll = 0;
+    }
+    return {
+        yaw: yaw * RAD2DEG,
+        pitch: pitch * RAD2DEG,
+        roll: roll * RAD2DEG,
+    };
+}
+/**
+ * Map an axis tip click to the corresponding preset view.
+ */
+function axisToPresetView(axis, positive, upAxis) {
+    if (upAxis === 'y-up') {
+        switch (axis) {
+            case 'x':
+                return positive ? 'right' : 'left';
+            case 'y':
+                return positive ? 'top' : 'bottom';
+            case 'z':
+                return positive ? 'front' : 'back';
+        }
+    }
+    // Z-up
+    switch (axis) {
+        case 'x':
+            return positive ? 'right' : 'left';
+        case 'y':
+            return positive ? 'front' : 'back';
+        case 'z':
+            return positive ? 'top' : 'bottom';
+    }
+}
+
+export { axisToPresetView, eulerToRotationMatrix, gizmoHitTest, presetViewToOrientation, projectAxes, projectToCanvas, quaternionToEuler };
+//# sourceMappingURL=gizmoMath.js.map

package/dist/esm/components/editor/ViewportGizmo/gizmoMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gizmoMath.js","sources":["../../../../../../src/components/editor/ViewportGizmo/gizmoMath.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/components/editor/ViewportGizmo/useGizmoInteraction.js

@@ -0,0 +1,250 @@
+"use client";
+import { useState, useRef, useCallback } from 'react';
+import { clamp } from '../../../utils/mathUtils.js';
+import { gizmoHitTest, axisToPresetView } from './gizmoMath.js';
+
+const NONE_HIT = { type: 'none', distance: Infinity };
+const ORBIT_KEY_STEP = 15;
+const ORBIT_FINE_STEP = 5;
+function useGizmoInteraction(options) {
+    const { orientation, canvasRef, diameter, upAxis, interactionMode, orbitSpeed, constrainPitch, disabled, onOrbit, onOrbitEnd, onSnapToView, onAxisClick, onOriginClick, } = options;
+    const [hoveredRegion, setHoveredRegion] = useState(NONE_HIT);
+    const isDraggingRef = useRef(false);
+    const [, setForceUpdate] = useState(0);
+    const lastPointerRef = useRef({ x: 0, y: 0 });
+    const startPointerRef = useRef({ x: 0, y: 0 });
+    const hasDraggedRef = useRef(false);
+    const allowSnap = interactionMode === 'full' || interactionMode === 'snap-only';
+    const allowOrbit = interactionMode === 'full' || interactionMode === 'orbit-only';
+    const armLength = (diameter / 2) * 0.65;
+    const center = { x: diameter / 2, y: diameter / 2 };
+    const getPointerPos = useCallback((e) => {
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return { px: 0, py: 0 };
+        const rect = canvas.getBoundingClientRect();
+        return { px: e.clientX - rect.left, py: e.clientY - rect.top };
+    }, [canvasRef]);
+    const onPointerDown = useCallback((e) => {
+        if (disabled || interactionMode === 'display-only' || e.button !== 0)
+            return;
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return;
+        const { px, py } = getPointerPos(e);
+        isDraggingRef.current = true;
+        hasDraggedRef.current = false;
+        lastPointerRef.current = { x: e.clientX, y: e.clientY };
+        startPointerRef.current = { x: e.clientX, y: e.clientY };
+        setForceUpdate(n => n + 1);
+        canvas.setPointerCapture(e.pointerId);
+        // Store hit for click detection on pointer up
+        const hit = gizmoHitTest(px, py, orientation, center, armLength, upAxis);
+        setHoveredRegion(hit);
+    }, [
+        disabled,
+        interactionMode,
+        canvasRef,
+        getPointerPos,
+        orientation,
+        center,
+        armLength,
+        upAxis,
+    ]);
+    const onPointerMove = useCallback((e) => {
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return;
+        if (isDraggingRef.current && allowOrbit) {
+            const dx = e.clientX - lastPointerRef.current.x;
+            const dy = e.clientY - lastPointerRef.current.y;
+            // Only count as drag if moved > 3px from start
+            const totalDx = e.clientX - startPointerRef.current.x;
+            const totalDy = e.clientY - startPointerRef.current.y;
+            if (Math.sqrt(totalDx ** 2 + totalDy ** 2) > 3) {
+                hasDraggedRef.current = true;
+            }
+            if (hasDraggedRef.current) {
+                const deltaYaw = dx * orbitSpeed * 0.5;
+                let deltaPitch = -dy * orbitSpeed * 0.5;
+                if (constrainPitch) {
+                    const newPitch = orientation.pitch + deltaPitch;
+                    deltaPitch = clamp(newPitch, -90, 90) - orientation.pitch;
+                }
+                onOrbit?.({ deltaYaw, deltaPitch });
+            }
+            lastPointerRef.current = { x: e.clientX, y: e.clientY };
+            return;
+        }
+        // Hover detection
+        if (interactionMode === 'display-only')
+            return;
+        const { px, py } = getPointerPos(e);
+        const hit = gizmoHitTest(px, py, orientation, center, armLength, upAxis);
+        setHoveredRegion(hit);
+        // Cursor
+        if (disabled) {
+            canvas.style.cursor = 'default';
+        }
+        else if (hit.type === 'axis-positive' || hit.type === 'origin') {
+            canvas.style.cursor = 'pointer';
+        }
+        else if (allowOrbit) {
+            canvas.style.cursor = isDraggingRef.current ? 'grabbing' : 'grab';
+        }
+        else {
+            canvas.style.cursor = 'default';
+        }
+    }, [
+        canvasRef,
+        allowOrbit,
+        orbitSpeed,
+        constrainPitch,
+        orientation,
+        interactionMode,
+        disabled,
+        getPointerPos,
+        center,
+        armLength,
+        upAxis,
+        onOrbit,
+    ]);
+    const onPointerUp = useCallback((e) => {
+        const canvas = canvasRef.current;
+        if (!canvas)
+            return;
+        if (isDraggingRef.current) {
+            isDraggingRef.current = false;
+            setForceUpdate(n => n + 1);
+            canvas.releasePointerCapture(e.pointerId);
+            if (hasDraggedRef.current) {
+                // Finished orbit drag
+                onOrbitEnd?.(orientation);
+            }
+            else if (allowSnap) {
+                // Click (no drag) — check hit
+                const { px, py } = getPointerPos(e);
+                const hit = gizmoHitTest(px, py, orientation, center, armLength, upAxis);
+                if (hit.type === 'origin') {
+                    onOriginClick?.();
+                }
+                else if (hit.type === 'axis-positive' && hit.axis) {
+                    onAxisClick?.(hit.axis, true);
+                    const view = axisToPresetView(hit.axis, true, upAxis);
+                    if (view)
+                        onSnapToView?.(view);
+                }
+                else if (hit.type === 'axis-negative' && hit.axis) {
+                    onAxisClick?.(hit.axis, false);
+                    const view = axisToPresetView(hit.axis, false, upAxis);
+                    if (view)
+                        onSnapToView?.(view);
+                }
+            }
+        }
+    }, [
+        canvasRef,
+        allowSnap,
+        getPointerPos,
+        orientation,
+        center,
+        armLength,
+        upAxis,
+        onOrbitEnd,
+        onOriginClick,
+        onAxisClick,
+        onSnapToView,
+    ]);
+    const onKeyDown = useCallback((e) => {
+        if (disabled || interactionMode === 'display-only')
+            return;
+        const fine = e.shiftKey;
+        const step = fine ? ORBIT_FINE_STEP : ORBIT_KEY_STEP;
+        let handled = false;
+        switch (e.key) {
+            case 'ArrowLeft':
+                if (allowOrbit) {
+                    onOrbit?.({ deltaYaw: -step, deltaPitch: 0 });
+                    handled = true;
+                }
+                break;
+            case 'ArrowRight':
+                if (allowOrbit) {
+                    onOrbit?.({ deltaYaw: step, deltaPitch: 0 });
+                    handled = true;
+                }
+                break;
+            case 'ArrowUp':
+                if (allowOrbit) {
+                    let deltaPitch = step;
+                    if (constrainPitch) {
+                        deltaPitch =
+                            clamp(orientation.pitch + step, -90, 90) - orientation.pitch;
+                    }
+                    onOrbit?.({ deltaYaw: 0, deltaPitch });
+                    handled = true;
+                }
+                break;
+            case 'ArrowDown':
+                if (allowOrbit) {
+                    let deltaPitch = -step;
+                    if (constrainPitch) {
+                        deltaPitch =
+                            clamp(orientation.pitch - step, -90, 90) - orientation.pitch;
+                    }
+                    onOrbit?.({ deltaYaw: 0, deltaPitch });
+                    handled = true;
+                }
+                break;
+            case '1':
+                if (allowSnap) {
+                    onSnapToView?.(e.ctrlKey ? 'back' : 'front');
+                    handled = true;
+                }
+                break;
+            case '3':
+                if (allowSnap) {
+                    onSnapToView?.(e.ctrlKey ? 'left' : 'right');
+                    handled = true;
+                }
+                break;
+            case '7':
+                if (allowSnap) {
+                    onSnapToView?.(e.ctrlKey ? 'bottom' : 'top');
+                    handled = true;
+                }
+                break;
+            case '5':
+            case 'Home':
+                onOriginClick?.();
+                handled = true;
+                break;
+        }
+        if (handled) {
+            e.preventDefault();
+        }
+    }, [
+        disabled,
+        interactionMode,
+        allowOrbit,
+        allowSnap,
+        constrainPitch,
+        orientation,
+        onOrbit,
+        onSnapToView,
+        onOriginClick,
+    ]);
+    return {
+        isDragging: isDraggingRef.current,
+        hoveredRegion,
+        handlers: {
+            onPointerDown,
+            onPointerMove,
+            onPointerUp,
+            onKeyDown,
+        },
+    };
+}
+
+export { useGizmoInteraction };
+//# sourceMappingURL=useGizmoInteraction.js.map

package/dist/esm/components/editor/ViewportGizmo/useGizmoInteraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGizmoInteraction.js","sources":["../../../../../../src/components/editor/ViewportGizmo/useGizmoInteraction.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAyCA;AAEA;AACA;AAEM;AAGJ;;AAiBA;;AAEA;AACA;AACA;;;;AAQA;AAEA;AAEI;AACA;;AACA;;AAEF;AAIF;;;AAII;AACA;;;AAIA;AACA;AACA;AACA;;AAEA;;AAGA;;AAEF;;;;;;;;;AAUC;AAGH;AAEI;AACA;;AAEA;;;;;;AAOE;AACE;;AAGF;AACE;;;AAIE;AACA;;;;AAMJ;;;;;;;AAOF;;;;AAKE;;AACK;AACL;;;AAEA;;;AAEA;;AAEJ;;;;;;;;;;;;;AAcC;AAGH;AAEI;AACA;;AAEA;AACE;;AAEA;AAEA;;AAEE;;;;;AAIA;AASA;;;;;AAIE;AACA;AAAU;;;;AAGV;AACA;AAAU;;;;AAIlB;;;;;;;;;;;;AAaC;AAGH;AAEI;;AAEA;;;AAIA;AACE;;AAEI;;;;AAIJ;;AAEI;;;;AAIJ;;;;;AAKQ;;;;;;AAMR;;AAEI;;;AAGI;;;;;;AAMR;;AAEI;;;;AAIJ;;AAEI;;;;AAIJ;;AAEI;;;;AAIJ;AACA;;;;;;;;AASJ;;;;;;;;;;AAWC;;;;AAMD;;;;;AAKC;;AAEL;;"}