@3driseai/3drise-viewer 0.1.4 → 0.1.6

package/dist/hooks/useCameraAnimation.js

@@ -33,14 +33,11 @@ export const useCameraAnimation = (options = {}, cameraState = {}) => {
     // Animate camera to target values
     const animateCamera = (target, duration = defaultDuration, ease = defaultEase, lookAtTarget) => {
         const cam = cameraRef.current;
-        // console.log("animateCamera called with cam:", cam);
         if (!cam)
             return Promise.resolve();
         // Kill any existing animation
         killAnimation();
-        // console.log('animateCamera', duration, ease)
         return new Promise((resolve) => {
-            // console.log("Animating camera with target:", target, "duration:", duration, "ease:", ease);
             const timeline = gsap.timeline({
                 onStart: () => {
                     isAnimatingRef.current = true;
@@ -62,7 +59,6 @@ export const useCameraAnimation = (options = {}, cameraState = {}) => {
             });
             // Animate position
             if (target.position) {
-                console.log("Animating camera to position:", target.position, duration, ease);
                 timeline.to(cam.position, {
                     x: target.position[0],
                     y: target.position[1],
@@ -122,7 +118,6 @@ export const useCameraAnimation = (options = {}, cameraState = {}) => {
                 }, 0);
             }
             // If lookAt target provided, animate the controls.target
-            // console.log("Animating camera with lookAtTarget:", lookAtTarget, orbitControls);
             if (lookAtTarget && orbitControls) {
                 timeline.to(orbitControls.target, {
                     x: lookAtTarget[0],

package/dist/hooks/useContinuousEffects.d.ts

@@ -1,5 +1,5 @@
 import type { CreatedObjectSettings, EffectState } from '@3driseai/3drise-core';
-import { Object3D } from "three";
+import type { Object3DSource } from "../utils/resolveObject3D";
 export interface UseContinuousEffectsOptions {
     enabled?: boolean;
     animateMaterial?: boolean;
@@ -9,7 +9,6 @@ export interface UseContinuousEffectsResult {
     isPathAnimating: () => boolean;
     effectStateRef: React.MutableRefObject<EffectState | null>;
 }
-export declare const DEBUG_CONTINUOUS_EFFECTS = false;
-export declare const useContinuousEffects: (objectSettings: CreatedObjectSettings | null, options: UseContinuousEffectsOptions, object: Object3D) => UseContinuousEffectsResult;
+export declare const useContinuousEffects: (objectSettings: CreatedObjectSettings | null, options?: UseContinuousEffectsOptions, objectSource?: Object3DSource) => UseContinuousEffectsResult;
 export default useContinuousEffects;
 //# sourceMappingURL=useContinuousEffects.d.ts.map

package/dist/hooks/useContinuousEffects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useContinuousEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useContinuousEffects.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D;AAMD,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAM9C,eAAO,MAAM,oBAAoB,GAEjC,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,SAAS,2BAAgC,EAAE,QAAQ,QAAQ,KAAG,0BAgK3G,CAAC;AACF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"useContinuousEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useContinuousEffects.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D;AAGD,eAAO,MAAM,oBAAoB,GAEjC,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,UAAS,2BAAgC,EAAE,eAAe,cAAc,KAAG,0BAgIxH,CAAC;AACF,eAAe,oBAAoB,CAAC"}

package/dist/hooks/useContinuousEffects.js

@@ -2,29 +2,14 @@ import { useRef, useEffect } from "react";
 import { useFrame } from "@react-three/fiber";
 import { animateUniforms, cacheChildrenWithMaterials, handleEdgesAnimations, handleMaterialAnimations, handleMaterialEffects, handleTransformAnimations, handleTransformEffect } from "@3driseai/3drise-core";
 import usePathAnimation from "./usePathAnimation.js";
-// ═══════════════════════════════════════════════════════════════════════════════
-// DEBUG LOGGING
-// ═══════════════════════════════════════════════════════════════════════════════
-export const DEBUG_CONTINUOUS_EFFECTS = false;
-const log = (message, ...args) => {
-    if (DEBUG_CONTINUOUS_EFFECTS) {
-        console.log(`[ObjectAnimations] ${message}`, ...args);
-    }
-};
+import { resolveObject3D } from "../utils/resolveObject3D.js";
 export const useContinuousEffects = (
 // object: Object3D | null,
-objectSettings, options = {}, object) => {
+objectSettings, options = {}, objectSource) => {
     const { enabled = true, animateMaterial = true, hovered = false } = options;
-    // console.log("useObjectAnimation called with:", {
-    //     object
-    // });
     // const { object } = ref || {};
     // Path animation hook for animations with pathId
     const { startPathAnimation, updatePathAnimation, isAnimating: isPathAnimating, stopPathAnimation, } = usePathAnimation();
-    // ─────────────────────────────────────────────────────────────────────────────
-    // REFS
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Track which path animation is currently active
     const activePathIdRef = useRef(null);
     const effectStateRef = useRef(null);
     // Cache children with materials to avoid traverse() every frame
@@ -34,10 +19,6 @@ objectSettings, options = {}, object) => {
     const startValuesRef = useRef({});
     // Cache start values for edges animations
     const edgesStartValuesRef = useRef({});
-    // ─────────────────────────────────────────────────────────────────────────────
-    // DERIVED STATE (read from new continuous structure)
-    // ─────────────────────────────────────────────────────────────────────────────
-    // Transform domain - now supports multiple effects (one per category)
     const transformAnimations = objectSettings?.animations?.transform?.animations || [];
     const transformEffects = objectSettings?.animations?.transform?.effects || [];
     const enabledTransformEffects = transformEffects.filter(effect => effect.enabled);
@@ -63,26 +44,11 @@ objectSettings, options = {}, object) => {
     const hasAnimations = hasTransformAnimations || hasMaterialAnimations;
     // Continuous effects config
     const applyToChildren = false;
-    // ─────────────────────────────────────────────────────────────────────────────
-    // CACHE CHILDREN WITH MATERIALS
-    // ─────────────────────────────────────────────────────────────────────────────
-    useEffect(() => {
-        if (!object || object === lastObjectRef.current)
-            return;
-        lastObjectRef.current = object;
-        childrenWithMaterialsRef.current = cacheChildrenWithMaterials(object);
-        log('cached children with materials', {
-            count: childrenWithMaterialsRef.current.length,
-            objectName: object.name
-        });
-        // Reset start values cache when object changes
-        startValuesRef.current = {};
-        edgesStartValuesRef.current = {};
-    }, [object]);
-    // ─────────────────────────────────────────────────────────────────────────────
-    // PATH ANIMATION LIFECYCLE
-    // ─────────────────────────────────────────────────────────────────────────────
+    // Done lazily inside the frame loop instead of in an effect: the ref only
+    // attaches after render, so an effect keyed on the object would miss the
+    // first (and often the only) chance to see it. See the swap check below.
     useEffect(() => {
+        const object = resolveObject3D(objectSource);
         if (!enabled || !object)
             return;
         // Path animations come from transform.animations
@@ -92,7 +58,6 @@ objectSettings, options = {}, object) => {
             // Start path animation if not already active or if pathId changed
             if (activePathIdRef.current !== pathAnimation.pathId) {
                 activePathIdRef.current = pathAnimation.pathId;
-                log('starting path animation', { pathId: pathAnimation.pathId, duration: pathAnimation.duration });
                 startPathAnimation(pathAnimation.pathId, pathAnimation.duration / 1000, {
                     ease: pathAnimation.ease,
                     loop: pathAnimation.loop,
@@ -105,20 +70,22 @@ objectSettings, options = {}, object) => {
         }
         else if (activePathIdRef.current) {
             // Stop path animation if no longer active
-            // log('stopping path animation', { pathId: activePathIdRef.current });
             stopPathAnimation();
             activePathIdRef.current = null;
         }
-    }, [enabled, objectSettings?.animations?.transform?.animations, object, startPathAnimation, stopPathAnimation]);
-    // console.log(objectSettings?.meshSettings.name, hovered)
+    }, [enabled, objectSettings?.animations?.transform?.animations, objectSource, startPathAnimation, stopPathAnimation]);
     useFrame((state, delta) => {
-        // console.log({
-        //   enabled,
-        //   object,
-        //   objectSettings,
-        // })
+        const object = resolveObject3D(objectSource);
         if (!enabled || !object || !objectSettings)
             return;
+        // Cache the object's materials the first frame we actually see it, and
+        // again if the caller swaps the object underneath us.
+        if (object !== lastObjectRef.current) {
+            lastObjectRef.current = object;
+            childrenWithMaterialsRef.current = cacheChildrenWithMaterials(object);
+            startValuesRef.current = {};
+            edgesStartValuesRef.current = {};
+        }
         const time = state.clock.getElapsedTime();
         const mouse = state.pointer;
         const currentTime = Date.now();
@@ -127,9 +94,6 @@ objectSettings, options = {}, object) => {
         if (pathIsActive) {
             updatePathAnimation(delta, object);
         }
-        // ─────────────────────────────────────────────────────────────────────────
-        // TRANSFORM DOMAIN
-        // ─────────────────────────────────────────────────────────────────────────
         if (hasTransformAnimations) {
             handleTransformAnimations({
                 object,
@@ -144,9 +108,6 @@ objectSettings, options = {}, object) => {
         if (hasEdgesAnimations) {
             handleEdgesAnimations({ object, startValuesCache: edgesStartValuesRef.current }, edgesAnimations, currentTime, hovered);
         }
-        // ─────────────────────────────────────────────────────────────────────────
-        // MATERIAL DOMAIN
-        // ─────────────────────────────────────────────────────────────────────────
         if (animateMaterial) {
             // Handle material animations (any material property)
             if (hasMaterialAnimations) {
@@ -160,13 +121,7 @@ objectSettings, options = {}, object) => {
             if (enabledMaterialEffects.length > 0) {
                 handleMaterialEffects(object, enabledMaterialEffects, time, delta, effectStateRef, applyToChildren);
             }
-            // ─────────────────────────────────────────────────────────────────────────
-            // EDGES DOMAIN
-            // ─────────────────────────────────────────────────────────────────────────
-            // Animate uniforms (u_time, u_mouse, u_camera_position)
-            // console.log(time)
         }
-        // console.log(enabled)
         animateUniforms(childrenWithMaterialsRef.current, time * speed, mouse, state.camera.position);
     });
     return {

package/dist/hooks/useFrameAnimations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFrameAnimations.d.ts","sourceRoot":"","sources":["../../src/hooks/useFrameAnimations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,UAAU,qBAAqB;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AASD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,WAAW,KAAG;IACzD,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/E,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/E,wBAAwB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5F,sBAAsB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACzD,wBAAwB,EAAE,MAAM,IAAI,CAAC;CAyM5C,CAAC;AACF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"useFrameAnimations.d.ts","sourceRoot":"","sources":["../../src/hooks/useFrameAnimations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,UAAU,qBAAqB;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AASD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,WAAW,KAAG;IACzD,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/E,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC/E,wBAAwB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5F,sBAAsB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACzD,wBAAwB,EAAE,MAAM,IAAI,CAAC;CAqM5C,CAAC;AACF,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useFrameAnimations.js

@@ -48,7 +48,6 @@ export const useFrameAnimations = (cameraSettings) => {
         const opts = { ...DEFAULT_OPTIONS, ...options };
         const original = originalCameraStateRef.current;
         if (!original) {
-            console.warn("No original camera state found");
             return;
         }
         // Animate camera back to original position
@@ -84,7 +83,6 @@ export const useFrameAnimations = (cameraSettings) => {
         const opts = { ...DEFAULT_OPTIONS, ...options };
         const original = originalTransforms.get(object.uuid);
         if (!original) {
-            console.warn("No original transform found for object", object.uuid);
             return;
         }
         // Animate back to original transform
@@ -116,7 +114,6 @@ export const useFrameAnimations = (cameraSettings) => {
         const cameraPos = cameraManager.getPosition();
         const cameraDirection = cameraManager.getWorldDirection();
         if (!cameraPos || !cameraDirection) {
-            console.warn("Camera not available for moveToFront animation");
             return;
         }
         // Calculate target position in world space (in front of camera)
@@ -169,7 +166,6 @@ export const useFrameAnimations = (cameraSettings) => {
         // Get current camera position
         const cameraPos = cameraManager.getPosition();
         if (!cameraPos) {
-            console.warn("Camera not available for zoomToFrame animation");
             return;
         }
         // Get frame's world position

package/dist/hooks/useGridSurface.d.ts

@@ -0,0 +1,46 @@
+import type { RefObject } from 'react';
+import * as THREE from 'three';
+/**
+ * The uniforms every shader-plane grid in this package drives from the host
+ * rather than from the config: elapsed time, the pointer in NDC, the focus
+ * point that ripples and pings radiate from, and the assemble/dissolve amount.
+ */
+export interface GridSurfaceUniforms {
+    u_time: number;
+    u_mouse: THREE.Vector2;
+    u_focus: THREE.Vector2;
+    u_reveal: number;
+}
+export interface GridSurfaceOptions {
+    /** project the pointer onto the plane and write it into u_focus */
+    followMouse?: boolean;
+    /** 0..1 target assemble amount; 1 is fully built, 0 is gone */
+    reveal?: number;
+    /**
+     * Seconds to travel the full 0..1 range toward `reveal`. 0 applies the
+     * target immediately, which is the default — a grid does not animate itself
+     * in unless it is asked to.
+     */
+    revealDuration?: number;
+}
+/**
+ * Per-frame plumbing shared by every shader-plane grid in this package.
+ *
+ * Advances `u_time` with the raw clock (each shader applies its own
+ * `u_animSpeed`, matching MyGridMaterial), mirrors the pointer into `u_mouse`
+ * as NDC — the 3drise convention — projects the pointer onto the grid's own
+ * plane for `u_focus` when `followMouse` is on, and drives `u_reveal` toward
+ * its target.
+ *
+ * The pick plane is derived from the mesh's world matrix rather than hard-coded
+ * to XZ, so the projection stays correct whether the grid lies flat or stands
+ * upright, and whether or not the host applied a transform above it.
+ *
+ * Reveal is driven at a constant *rate* rather than by replaying a fixed
+ * timeline, so retargeting mid-flight — the dissolve that starts while the
+ * build is still running — continues smoothly from wherever it had got to
+ * instead of snapping back to the start.
+ */
+export declare function useGridSurface(materialRef: RefObject<GridSurfaceUniforms | null>, meshRef: RefObject<THREE.Object3D | null>, options?: GridSurfaceOptions): void;
+export default useGridSurface;
+//# sourceMappingURL=useGridSurface.d.ts.map

package/dist/hooks/useGridSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridSurface.d.ts","sourceRoot":"","sources":["../../src/hooks/useGridSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,WAAW,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAClD,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,EACzC,OAAO,GAAE,kBAAuB,GACjC,IAAI,CAgDN;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks/useGridSurface.js

@@ -0,0 +1,66 @@
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+/**
+ * Per-frame plumbing shared by every shader-plane grid in this package.
+ *
+ * Advances `u_time` with the raw clock (each shader applies its own
+ * `u_animSpeed`, matching MyGridMaterial), mirrors the pointer into `u_mouse`
+ * as NDC — the 3drise convention — projects the pointer onto the grid's own
+ * plane for `u_focus` when `followMouse` is on, and drives `u_reveal` toward
+ * its target.
+ *
+ * The pick plane is derived from the mesh's world matrix rather than hard-coded
+ * to XZ, so the projection stays correct whether the grid lies flat or stands
+ * upright, and whether or not the host applied a transform above it.
+ *
+ * Reveal is driven at a constant *rate* rather than by replaying a fixed
+ * timeline, so retargeting mid-flight — the dissolve that starts while the
+ * build is still running — continues smoothly from wherever it had got to
+ * instead of snapping back to the start.
+ */
+export function useGridSurface(materialRef, meshRef, options = {}) {
+    const { followMouse = false, reveal = 1, revealDuration = 0 } = options;
+    const scratch = useMemo(() => ({
+        ray: new THREE.Raycaster(),
+        plane: new THREE.Plane(),
+        hit: new THREE.Vector3(),
+        origin: new THREE.Vector3(),
+        normal: new THREE.Vector3(),
+    }), []);
+    // Starts at 0 when it has a duration to travel, so the first frame is the
+    // beginning of the build rather than a flash of the finished grid.
+    const revealNow = useRef(revealDuration > 0 ? 0 : reveal);
+    useFrame((state, delta) => {
+        const material = materialRef.current;
+        if (!material)
+            return;
+        material.u_time = state.clock.elapsedTime;
+        material.u_mouse.copy(state.pointer);
+        const target = THREE.MathUtils.clamp(reveal, 0, 1);
+        if (revealDuration > 0) {
+            const step = delta / revealDuration;
+            const remaining = target - revealNow.current;
+            revealNow.current += Math.sign(remaining) * Math.min(Math.abs(remaining), step);
+        }
+        else {
+            revealNow.current = target;
+        }
+        material.u_reveal = revealNow.current;
+        const mesh = meshRef.current;
+        if (!followMouse || !mesh)
+            return;
+        const { ray, plane, hit, origin, normal } = scratch;
+        mesh.updateWorldMatrix(true, false);
+        // A PlaneGeometry lives in local XY, so local +Z is its normal.
+        normal.set(0, 0, 1).transformDirection(mesh.matrixWorld).normalize();
+        origin.setFromMatrixPosition(mesh.matrixWorld);
+        plane.setFromNormalAndCoplanarPoint(normal, origin);
+        ray.setFromCamera(state.pointer, state.camera);
+        if (ray.ray.intersectPlane(plane, hit)) {
+            mesh.worldToLocal(hit);
+            material.u_focus.set(hit.x, hit.y);
+        }
+    });
+}
+export default useGridSurface;

package/dist/hooks/useGsapAnimation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGsapAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useGsapAnimation.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C7B,CAAC;AACF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,eAAc,GAAG,EAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwPxD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"useGsapAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useGsapAnimation.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C7B,CAAC;AACF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,eAAc,GAAG,EAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqPxD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/hooks/useGsapAnimation.js

@@ -75,7 +75,6 @@ export const useGsapAnimation = (dependencies = []) => {
      * Animates multiple 3D objects with the given settings
      */
     const animateObjects = (objects, settings = DEFAULT_SETTINGS) => {
-        console.log("Animating objects with settings:", settings, objects);
         const finalSettings = { ...DEFAULT_SETTINGS, ...settings };
         objects.forEach((object, index) => {
             const targetPosition = new THREE.Vector3(...(finalSettings.position || [0, 0, 0]));
@@ -217,10 +216,8 @@ export const useGsapAnimation = (dependencies = []) => {
      * Pulses objects (scale up and down)
      */
     const animatePulse = useCallback((objects, settings = {}) => {
-        console.log("Animating pulse for objects", objects, "with settings", settings);
         objects.forEach((object, index) => {
             const delay = (settings.delay || 0) + (index * 0.1);
-            console.log("Animating pulse for object", object, "with delay", delay);
             gsap.to(object.scale, {
                 x: 2.2,
                 y: 2.2,

package/dist/hooks/useInteraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInteraction.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteraction.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAA4B,MAAM,uBAAuB,CAAC;AAatG,wBAAgB,cAAc,CAAC,EAE/B,cAAc,EAAE,SAAS,GAAG,EAAE;IAClB,cAAc,EAAE,WAAW,CAAC;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAClC;;;;;EAwPR;AACD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"useInteraction.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteraction.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAA4B,MAAM,uBAAuB,CAAC;AAatG,wBAAgB,cAAc,CAAC,EAE/B,cAAc,EAAE,SAAS,GAAG,EAAE;IAClB,cAAc,EAAE,WAAW,CAAC;IAC5B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAClC;;;;;EA+NR;AACD,eAAe,cAAc,CAAC"}

package/dist/hooks/useInteraction.js

@@ -42,7 +42,6 @@ cameraSettings, sequences, }) {
         if (!targetIds || targetIds.length === 0) {
             return [currentRef];
         }
-        console.log('[useInteraction] resolveTargets:', { targetIds, targetMode });
         const targetRefs = [];
         // Add current object if mode is 'add'
         if (targetMode === 'add') {
@@ -54,9 +53,6 @@ cameraSettings, sequences, }) {
             if (obj) {
                 targetRefs.push(obj);
             }
-            else {
-                console.warn(`[useInteraction] Target not found: ${id}`);
-            }
         });
         return targetRefs.length > 0 ? targetRefs : [currentRef];
     }, []);
@@ -66,16 +62,11 @@ cameraSettings, sequences, }) {
     const triggerAnimations = useCallback((animationIds) => {
         if (!animationIds || animationIds.length === 0)
             return;
-        console.log('[useInteraction] triggerAnimations:', animationIds);
-        console.log('Available sequences:', sequences.map(s => s.id));
         animationIds.forEach(animationId => {
             const sequence = sequences.find(s => s.id === animationId);
             if (sequence) {
                 AnimationsManager.playSequence(sequence);
             }
-            else {
-                console.warn(`[useInteraction] Sequence not found: ${animationId}`);
-            }
         });
     }, [sequences]);
     // ===========================================================================
@@ -89,7 +80,6 @@ cameraSettings, sequences, }) {
         const defaultDistance = 2.0;
         const isCurrentlySelected = currentAnimatedRef.current !== null;
         const isSameObject = currentAnimatedRef.current?.uuid === ref.uuid;
-        console.log('[useInteraction] executeOperation:', operation);
         switch (operation) {
             case 'vanish': {
                 if (isVanished(ref.uuid)) {
@@ -188,7 +178,6 @@ cameraSettings, sequences, }) {
                         mat.needsUpdate = true;
                     }
                     catch (err) {
-                        console.error('[useInteraction] Failed to load texture:', err);
                     }
                 }
                 break;
@@ -198,10 +187,7 @@ cameraSettings, sequences, }) {
             case 'delete':
             case 'toggle':
             case 'loadProject':
-                console.log(`[useInteraction] ${operation} - not implemented for scene interactions`);
                 break;
-            default:
-                console.warn(`[useInteraction] Unknown operation: ${operation}`);
         }
     }, [
         isVanished,
@@ -222,7 +208,6 @@ cameraSettings, sequences, }) {
     const executeOperations = useCallback((operations, ref, createdObject, textureUrl) => {
         if (!operations || operations.length === 0)
             return;
-        console.log('[useInteraction] executeOperations:', operations);
         operations.forEach(operation => {
             executeOperation(operation, ref, createdObject, textureUrl);
         });
@@ -234,19 +219,9 @@ cameraSettings, sequences, }) {
         const { interaction, ref, createdObject } = params;
         if (!interaction.enabled)
             return;
-        console.log('[useInteraction] executeInteraction:', {
-            mouseEvent: interaction.mouseEvent,
-            operations: interaction.operations,
-            targetIds: interaction.targetIds,
-            animationIds: interaction.animationIds
-        });
         let textureUrl = undefined;
         if (interaction.operations?.includes('displayImage')) {
-            console.log('Display Image interaction triggered:', {
-                ref,
-            });
             textureUrl = ref.userData?.url;
-            console.log('Texture URL:', textureUrl);
         }
         // 1. Resolve target objects
         const targets = resolveTargets(interaction, ref);

package/dist/hooks/useInteractionEffects.d.ts

@@ -1,11 +1,11 @@
 import type { CreatedObjectSettings } from '@3driseai/3drise-core';
-import { Object3D } from "three";
+import type { Object3DSource } from "../utils/resolveObject3D";
 export interface UseInteractionEffectsOptions {
     enabled?: boolean;
     animateMaterial?: boolean;
 }
 export interface UseInteractionEffectsResult {
 }
-export declare const useMouseMove: (objectSettings: CreatedObjectSettings | null, options: UseInteractionEffectsOptions, object: Object3D) => UseInteractionEffectsResult;
+export declare const useMouseMove: (objectSettings: CreatedObjectSettings | null, options?: UseInteractionEffectsOptions, objectSource?: Object3DSource) => UseInteractionEffectsResult;
 export default useMouseMove;
 //# sourceMappingURL=useInteractionEffects.d.ts.map

package/dist/hooks/useInteractionEffects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInteractionEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteractionEffects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,MAAM,WAAW,4BAA4B;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;CAC3C;AAqDD,eAAO,MAAM,YAAY,GAAI,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,SAAS,4BAAiC,EAAE,QAAQ,QAAQ,KAAG,2BAoBzI,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"useInteractionEffects.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteractionEffects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,MAAM,WAAW,4BAA4B;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;CAC3C;AAqDD,eAAO,MAAM,YAAY,GAAI,gBAAgB,qBAAqB,GAAG,IAAI,EAAE,UAAS,4BAAiC,EAAE,eAAe,cAAc,KAAG,2BAqBtJ,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/hooks/useInteractionEffects.js

@@ -1,5 +1,6 @@
 import { useFrame } from "@react-three/fiber";
 import { detectAnimatableDomain, handleEdgesMouseMove, handleMaterialMouseMove, handleTransformMouseMove, } from '@3driseai/3drise-core';
+import { resolveObject3D } from "../utils/resolveObject3D.js";
 // =============================================================================
 // FLAT-SHAPE BACK COMPAT
 // =============================================================================
@@ -50,9 +51,10 @@ function resolveDomains(settings) {
 // =============================================================================
 // useMouseMove
 // =============================================================================
-export const useMouseMove = (objectSettings, options = {}, object) => {
+export const useMouseMove = (objectSettings, options = {}, objectSource) => {
     const { enabled = true, animateMaterial = true } = options;
     useFrame((state) => {
+        const object = resolveObject3D(objectSource);
         if (!enabled || !object || !objectSettings)
             return;
         const domains = resolveDomains(objectSettings);

package/dist/hooks/useMaterialApplication.d.ts

@@ -1,4 +1,4 @@
 import type { MaterialSettings } from '@3driseai/3drise-core';
-import { Object3D } from "three";
-export declare const useMaterialApplication: (obj: Object3D | null | undefined, materialSettings: MaterialSettings, shouldApply3driseMaterial?: boolean, onApplied?: () => void) => void;
+import type { Object3DSource } from "../utils/resolveObject3D";
+export declare const useMaterialApplication: (source: Object3DSource, materialSettings: MaterialSettings, shouldApply3driseMaterial?: boolean, onApplied?: () => void) => void;
 //# sourceMappingURL=useMaterialApplication.d.ts.map

package/dist/hooks/useMaterialApplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMaterialApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialApplication.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjC,eAAO,MAAM,sBAAsB,GAAI,KAAK,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,kBAAkB,gBAAgB,EAAE,4BAA4B,OAAO,EAAE,YAAY,MAAM,IAAI,KAAG,IAiJ1K,CAAC"}
+{"version":3,"file":"useMaterialApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialApplication.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,eAAO,MAAM,sBAAsB,GAAI,QAAQ,cAAc,EAAE,kBAAkB,gBAAgB,EAAE,4BAA4B,OAAO,EAAE,YAAY,MAAM,IAAI,KAAG,IAqIhK,CAAC"}