@3driseai/3drise-viewer 0.1.2 → 0.1.4

package/dist/components/effects/Flares.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { useFrame, useThree } from "@react-three/fiber";
+import { WebGLRenderTarget, MeshBasicMaterial, AdditiveBlending, Box3, Sphere, Vector3, Vector2, Quaternion, Color, Object3D } from "three";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+const tmpBox = new Box3();
+const tmpSphere = new Sphere();
+const tmpVec = new Vector3();
+const tmpVec2 = new Vector2();
+const tmpQuat = new Quaternion();
+const tmpRight = new Vector3();
+const tmpColor = new Color();
+export default function Flares({ hostRef, config, uniforms, animations, onObjectReady, onObjectDispose }) {
+    const { gl, scene } = useThree();
+    const anchorRef = useRef(null);
+    useObjectReady(anchorRef, config, onObjectReady, onObjectDispose);
+    const meshRef = useRef(null);
+    const matRef = useRef(null);
+    const { radius, padding = 1.2, fitKey, shooting, maskResolution = 512, maskLayer = 31 } = config;
+    const maskTarget = useMemo(() => hostRef
+        ? new WebGLRenderTarget(maskResolution, maskResolution, {
+            depthBuffer: true,
+            stencilBuffer: false,
+            samples: 4 // MSAA mask (WebGL2) -> smooth silhouette edges
+        })
+        : null, [hostRef, maskResolution]);
+    const maskMaterial = useMemo(() => new MeshBasicMaterial({ color: 0xffffff }), []);
+    useEffect(() => () => maskTarget?.dispose(), [maskTarget]);
+    // Fit the billboard to the host object + tag the host for the mask pass.
+    useEffect(() => {
+        const anchor = anchorRef.current;
+        const mesh = meshRef.current;
+        if (!anchor || !mesh)
+            return;
+        const host = hostRef && hostRef instanceof Object3D ? hostRef : anchor;
+        // Silhouette mode: tag every host node (except us) with the mask layer.
+        if (hostRef && host) {
+            host.traverse((o) => o.layers.enable(maskLayer));
+            anchor.traverse((o) => o.layers.disable(maskLayer));
+        }
+        if (radius !== undefined) {
+            anchor.position.set(0, 0, 0);
+            mesh.scale.setScalar(radius * padding);
+            return;
+        }
+        if (!host)
+            return;
+        // Bounding box of every sibling except ourselves (world space).
+        tmpBox.makeEmpty();
+        let hasGeometry = false;
+        for (const child of host.children) {
+            if (child === anchor)
+                continue;
+            const childBox = new Box3().setFromObject(child);
+            if (!childBox.isEmpty()) {
+                tmpBox.union(childBox);
+                hasGeometry = true;
+            }
+        }
+        // Host itself may be a mesh (Flares nested directly inside it).
+        if (host.geometry) {
+            const g = host.geometry;
+            if (!g.boundingBox)
+                g.computeBoundingBox();
+            if (g.boundingBox) {
+                tmpBox.union(g.boundingBox.clone().applyMatrix4(host.matrixWorld));
+                hasGeometry = true;
+            }
+        }
+        if (!hasGeometry)
+            return;
+        tmpBox.getBoundingSphere(tmpSphere);
+        host.updateWorldMatrix(true, false);
+        const localCenter = host.worldToLocal(tmpSphere.center.clone());
+        host.getWorldScale(tmpVec);
+        const worldScale = Math.max(tmpVec.x, tmpVec.y, tmpVec.z) || 1;
+        anchor.position.copy(localCenter);
+        mesh.scale.setScalar((tmpSphere.radius / worldScale) * padding);
+    }, [radius, padding, fitKey, hostRef, maskLayer]);
+    useFrame(({ camera: cam }, delta) => {
+        const mat = matRef.current;
+        const mesh = meshRef.current;
+        if (mat)
+            mat.u_time += delta;
+        // World-space billboard: compensate for inherited rotation.
+        if (mesh && hostRef) {
+            hostRef.getWorldQuaternion(tmpQuat).invert();
+            mesh.quaternion.copy(tmpQuat).multiply(cam.quaternion);
+        }
+        // --- Silhouette mask pass: render only the host, white on black. ---
+        if (hostRef && maskTarget && mat && mesh) {
+            const prevOverride = scene.overrideMaterial;
+            const prevBackground = scene.background;
+            const prevTarget = gl.getRenderTarget();
+            const prevLayers = cam.layers.mask;
+            gl.getClearColor(tmpColor);
+            const prevClearAlpha = gl.getClearAlpha();
+            scene.overrideMaterial = maskMaterial;
+            scene.background = null;
+            cam.layers.set(maskLayer);
+            gl.setRenderTarget(maskTarget);
+            gl.setClearColor(0x000000, 1);
+            gl.clear();
+            gl.render(scene, cam);
+            gl.setRenderTarget(prevTarget);
+            gl.setClearColor(tmpColor, prevClearAlpha);
+            scene.overrideMaterial = prevOverride;
+            scene.background = prevBackground;
+            cam.layers.mask = prevLayers;
+            // Feed the shader: mask, buffer size, host center in screen UV.
+            mat.u_mask = maskTarget.texture;
+            gl.getDrawingBufferSize(tmpVec2);
+            mat.u_resolution.set(tmpVec2.x, tmpVec2.y);
+            const anchor = anchorRef.current;
+            anchor.getWorldPosition(tmpVec).project(cam);
+            const cx = tmpVec.x * 0.5 + 0.5;
+            const cy = tmpVec.y * 0.5 + 0.5;
+            mat.u_center.set(cx, cy);
+            // Bounding-silhouette radius in aspect-corrected screen UV: project a
+            // point one limb-unit to the camera's right of the center.
+            mesh.getWorldScale(tmpVec);
+            const worldLimb = Math.max(tmpVec.x, tmpVec.y, tmpVec.z);
+            tmpRight.setFromMatrixColumn(cam.matrixWorld, 0).multiplyScalar(worldLimb);
+            anchor.getWorldPosition(tmpVec).add(tmpRight).project(cam);
+            const aspect = tmpVec2.x / tmpVec2.y;
+            const dx = (tmpVec.x * 0.5 + 0.5 - cx) * aspect;
+            const dy = tmpVec.y * 0.5 + 0.5 - cy;
+            mat.u_limbScreen = Math.max(Math.hypot(dx, dy), 1e-4);
+            mat.u_maskEnabled = 1;
+        }
+        else if (mat) {
+            mat.u_maskEnabled = 0;
+        }
+    });
+    return (_jsx("group", { ref: anchorRef, children: _jsxs("mesh", { ref: meshRef, renderOrder: 2, children: [_jsx("planeGeometry", { args: [4.4, 4.4] }), _jsx("flareMaterial", { ref: matRef, transparent: true, depthWrite: false, depthTest: !hostRef && !shooting, blending: AdditiveBlending, u_shootEnabled: shooting ? 1 : 0, ...uniforms })] }) }));
+}

package/dist/components/effects/ForcefieldEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ForcefieldConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface ForcefieldEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface ForcefieldEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: ForcefieldConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/ForcefieldEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForcefieldEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ForcefieldEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,UAAU,qBAAqB;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"ForcefieldEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ForcefieldEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoDrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/effects/ForcefieldEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 const shieldVert = /* glsl */ `
   varying vec3 vNormal;
   varying vec3 vWorldPos;
@@ -77,10 +78,11 @@ const shieldFrag = /* glsl */ `
     gl_FragColor = vec4(col + uRimColor * ripple * 0.3, alpha);
   }
 `;
-const ForcefieldEffect = ({ boundingRadius, config, animations }) => {
+const ForcefieldEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { hexSize, rippleEnabled, shieldColor, rimColor, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
     const meshRef = useRef(null);
+    useObjectReady(meshRef, config, onObjectReady, onObjectDispose);
     const hitSlot = useRef(0);
     const nextHit = useRef(0);
     const mat = useMemo(() => {

package/dist/components/effects/HologramEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { HologramConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface HologramEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface HologramEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: HologramConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/HologramEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HologramEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/HologramEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,UAAU,mBAAmB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAsDjD,CAAC;AACF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"HologramEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/HologramEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqFD,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAwDjD,CAAC;AACF,eAAe,cAAc,CAAC"}

package/dist/components/effects/HologramEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Single rich shader handles scanlines, grid, RGB aberration, interference fringes, flicker
 const vertexShader = /* glsl */ `
   varying vec2 vUv;
@@ -85,9 +86,11 @@ const fragmentShader = /* glsl */ `
     gl_FragColor = vec4(hologramColor + uColor * fringe, intensity * uOpacity);
   }
 `;
-const HologramEffect = ({ boundingRadius, config, animations }) => {
+const HologramEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { scanlineCount, scanSpeed, scanColor, gridEnabled, flickerAmount, glitchEnabled, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const meshRefs = useRef([]);
     const colorVec = useMemo(() => {
         const c = new THREE.Color(scanColor);
@@ -135,7 +138,7 @@ const HologramEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations(materials, animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsx("group", { children: Array.from({ length: scanlineCount }, (_, i) => {
+    return (_jsx("group", { ref: rootRef, children: Array.from({ length: scanlineCount }, (_, i) => {
             const y = -boundingRadius * 1.25 + i * stepY;
             return (_jsx("mesh", { ref: el => { meshRefs.current[i] = el; }, material: materials[i], position: [0, y, 0], rotation: [-Math.PI / 2, 0, 0], children: _jsx("planeGeometry", { args: [planeSize, planeSize, 2, 2] }) }, i));
         }) }));

package/dist/components/effects/IceCrystalsEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { IceCrystalsConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface IceCrystalsEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface IceCrystalsEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: IceCrystalsConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/IceCrystalsEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IceCrystalsEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/IceCrystalsEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,UAAU,sBAAsB;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAmED,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAuHvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"IceCrystalsEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/IceCrystalsEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,sBAAuB,SAAQ,gBAAgB;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAmED,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAwHvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}

package/dist/components/effects/IceCrystalsEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Crystal spike shader ──────────────────────────────────────────────────────
 const spikeVert = /* glsl */ `
   varying vec3 vNormal;
@@ -67,10 +68,11 @@ const frostFrag = /* glsl */ `
     gl_FragColor = vec4(0.85, 0.95, 1.0, g * vA * uOpacity);
   }
 `;
-const IceCrystalsEffect = ({ boundingRadius, config, animations }) => {
+const IceCrystalsEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { spikeCount, spikeLength, frostEnabled, iceColor, pulseSpeed, opacity, intensity } = config;
     const startValuesCacheRef = useRef({});
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const timeRef = useRef(0);
     const r = boundingRadius;
     const N = Math.max(10, Math.min(spikeCount, 60));

package/dist/components/effects/LightningEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { LightningConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface LightningEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface LightningEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: LightningConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/LightningEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LightningEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/LightningEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,UAAU,oBAAoB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAsDD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAsLnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"LightningEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/LightningEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAsDD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwLnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/LightningEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Seeded LCG RNG — deterministic, no Math.random ───────────────────────────
 function makeRng(seed) {
     let s = (seed * 1664525 + 1013904223) >>> 0;
@@ -54,9 +55,11 @@ const glowFrag = /* glsl */ `
   }
 `;
 const FADE_DUR = 0.22;
-const LightningEffect = ({ boundingRadius, config, animations }) => {
+const LightningEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { boltCount, branchDepth, color, glowColor, opacity, speed, intensity, strikeRadius } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const depth = Math.min(Math.max(branchDepth, 2), 6);
     const N = Math.pow(2, depth) + 1; // vertex count: 5, 9, 17, 33, 65
     const coreCol = useMemo(() => new THREE.Color(color), [color]);
@@ -235,6 +238,6 @@ const LightningEffect = ({ boundingRadius, config, animations }) => {
     const lineObjects = useMemo(() => bolts.map(bolt => new THREE.Line(bolt.lineGeo, lineMat)), 
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [bolts, lineMat]);
-    return (_jsx("group", { children: lineObjects.map((lineObj, bi) => (_jsxs("group", { children: [_jsx("primitive", { object: lineObj }), _jsx("points", { geometry: bolts[bi].pointGeo, material: glowMats[bi] })] }, bi))) }));
+    return (_jsx("group", { ref: rootRef, children: lineObjects.map((lineObj, bi) => (_jsxs("group", { children: [_jsx("primitive", { object: lineObj }), _jsx("points", { geometry: bolts[bi].pointGeo, material: glowMats[bi] })] }, bi))) }));
 };
 export default LightningEffect;

package/dist/components/effects/MoleculesEffect.d.ts

@@ -1,6 +1,7 @@
 import type { MoleculesConfig, AnimationOptions } from '@3driseai/3drise-core';
 import React from "react";
-interface MoleculesEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface MoleculesEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: MoleculesConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/MoleculesEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MoleculesEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/MoleculesEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,UAAU,oBAAoB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA+CD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAyHnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"MoleculesEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/MoleculesEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA+CD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2HnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/MoleculesEffect.js

@@ -4,6 +4,7 @@ import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { getShaderByName } from '@3driseai/3drise-core';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Glowing node points at each atom position
 // const nodeVertShader = /* glsl */`
 //   attribute float aPhase;
@@ -48,9 +49,11 @@ import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAn
 //     gl_FragColor = vec4(col, vAlpha * uOpacity * (glow + spike * 0.6 + core));
 //   }
 // `;
-const MoleculesEffect = ({ boundingRadius, config, animations }) => {
+const MoleculesEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { atomCount, orbitRadius, atomSize, showBonds, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const shaderData = getShaderByName('Molecules');
     const tRef = useRef(new Float32Array(atomCount));
     const r = boundingRadius * orbitRadius;
@@ -168,6 +171,6 @@ const MoleculesEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([nodeMat, bondMat], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsxs("group", { name: "MoleculesEffect", children: [_jsx("points", { geometry: nodeGeo, material: nodeMat }), showBonds && (_jsx("lineSegments", { geometry: bondGeo, material: bondMat }))] }));
+    return (_jsxs("group", { ref: rootRef, name: "MoleculesEffect", children: [_jsx("points", { geometry: nodeGeo, material: nodeMat }), showBonds && (_jsx("lineSegments", { geometry: bondGeo, material: bondMat }))] }));
 };
 export default MoleculesEffect;

package/dist/components/effects/NeuralNetworkEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { NeuralNetworkConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface NeuralNetworkEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface NeuralNetworkEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: NeuralNetworkConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/NeuralNetworkEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NeuralNetworkEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/NeuralNetworkEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnF,UAAU,wBAAwB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6BD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA2J3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"NeuralNetworkEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/NeuralNetworkEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,wBAAyB,SAAQ,gBAAgB;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6BD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA4J3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/NeuralNetworkEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Glow sprite for pulse signals and node flashes
 const pulseVert = /* glsl */ `
   attribute float aBright;
@@ -29,10 +30,11 @@ const pulseFrag = /* glsl */ `
   }
 `;
 const MAX_PULSES = 4;
-const NeuralNetworkEffect = ({ boundingRadius, config, animations }) => {
+const NeuralNetworkEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { nodeCount, signalSpeed, nodeColor, pulseColor, orbitSpeed, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     // Node orbit state
     const orbitAngles = useRef(new Float32Array(0));
     const pulses = useRef([]);

package/dist/components/effects/OrbEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { OrbConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface OrbEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface OrbEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: OrbConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/OrbEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OrbEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/OrbEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,UAAU,cAAc;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqLD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA0GvC,CAAC;AACF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"OrbEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/OrbEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,cAAe,SAAQ,gBAAgB;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAqLD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA4GvC,CAAC;AACF,eAAe,SAAS,CAAC"}

package/dist/components/effects/OrbEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Shared vert (normal + viewDir) ────────────────────────────────────────────
 const sharedVert = /* glsl */ `
   varying vec3 vNormal;
@@ -181,9 +182,11 @@ const coronaFrag = /* glsl */ `
     gl_FragColor = vec4(col * (1.0 + pulse), alpha);
   }
 `;
-const OrbEffect = ({ boundingRadius, config, animations }) => {
+const OrbEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { coreSize, glowLayers, innerColor, outerColor, coronaEnabled, coronaColor, noiseAmount, pulseSpeed, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const innerColorVec = useMemo(() => { const c = new THREE.Color(innerColor); return new THREE.Vector3(c.r, c.g, c.b); }, [innerColor]);
     const outerColorVec = useMemo(() => { const c = new THREE.Color(outerColor); return new THREE.Vector3(c.r, c.g, c.b); }, [outerColor]);
     const coronaColorVec = useMemo(() => { const c = new THREE.Color(coronaColor); return new THREE.Vector3(c.r, c.g, c.b); }, [coronaColor]);
@@ -282,7 +285,7 @@ const OrbEffect = ({ boundingRadius, config, animations }) => {
         }
     });
     const glowR = coreR * (3.5 + glowLayers * 0.6);
-    return (_jsxs("group", { children: [_jsx("mesh", { material: coreMat, children: _jsx("sphereGeometry", { args: [coreR, 48, 48] }) }), Array.from({ length: glowLayers }, (_, i) => {
+    return (_jsxs("group", { ref: rootRef, children: [_jsx("mesh", { material: coreMat, children: _jsx("sphereGeometry", { args: [coreR, 48, 48] }) }), Array.from({ length: glowLayers }, (_, i) => {
                 const layerT = glowLayers > 1 ? i / (glowLayers - 1) : 0;
                 const r = coreR * (1.35 + layerT * layerT * 1.8);
                 return (_jsx("mesh", { material: shellMats[i], children: _jsx("sphereGeometry", { args: [r, 40, 40] }) }, i));

package/dist/components/effects/PortalEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { PortalConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface PortalEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface PortalEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: PortalConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/PortalEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PortalEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/PortalEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,UAAU,iBAAiB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAgHD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA2E7C,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"PortalEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/PortalEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,iBAAkB,SAAQ,gBAAgB;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAgHD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6E7C,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/effects/PortalEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Multi-layer vortex disc
 const discVertShader = /* glsl */ `
   varying vec2 vUv;
@@ -112,9 +113,11 @@ const dustFragShader = /* glsl */ `
     gl_FragColor = vec4(uColor, vAlpha * uOpacity * glow);
   }
 `;
-const PortalEffect = ({ boundingRadius, config, animations }) => {
+const PortalEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { radius, spiralTurns, innerGlowColor, outerGlowColor, rotationSpeed, particleRingEnabled, particleCount, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius * radius;
     const innerColorVec = useMemo(() => { const c = new THREE.Color(innerGlowColor); return new THREE.Vector3(c.r, c.g, c.b); }, [innerGlowColor]);
     const outerColorVec = useMemo(() => { const c = new THREE.Color(outerGlowColor); return new THREE.Vector3(c.r, c.g, c.b); }, [outerGlowColor]);
@@ -186,6 +189,6 @@ const PortalEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([discMaterial, dustMat], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsxs("group", { rotation: [-Math.PI / 2, 0, 0], position: [0, -boundingRadius * 0.75, 0], children: [_jsx("mesh", { material: discMaterial, children: _jsx("circleGeometry", { args: [r, 80] }) }), particleRingEnabled && (_jsx("points", { geometry: dustGeo, material: dustMat }))] }));
+    return (_jsxs("group", { ref: rootRef, rotation: [-Math.PI / 2, 0, 0], position: [0, -boundingRadius * 0.75, 0], children: [_jsx("mesh", { material: discMaterial, children: _jsx("circleGeometry", { args: [r, 80] }) }), particleRingEnabled && (_jsx("points", { geometry: dustGeo, material: dustMat }))] }));
 };
 export default PortalEffect;

package/dist/components/effects/ShockwaveEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { ShockwaveConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface ShockwaveEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface ShockwaveEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: ShockwaveConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/ShockwaveEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShockwaveEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ShockwaveEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,UAAU,oBAAoB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAkFD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA0EnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ShockwaveEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ShockwaveEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAkFD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4EnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/ShockwaveEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo, useEffect } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // Ring vertex — organic warp + vertical ripple
 const vertexShader = /* glsl */ `
   uniform float uProgress;
@@ -82,9 +83,11 @@ const flashVert = /* glsl */ `
     gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
   }
 `;
-const ShockwaveEffect = ({ boundingRadius, config, animations }) => {
+const ShockwaveEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { ringCount, expansionRadius, thickness, intervalSeconds, color, rimColor, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const meshRefs = useRef([]);
     const flashRefs = useRef([]);
     const makeRingStates = (count, interval) => Array.from({ length: count }, (_, i) => ({
@@ -155,6 +158,6 @@ const ShockwaveEffect = ({ boundingRadius, config, animations }) => {
         }
     });
     const flashR = radius * 1.05;
-    return (_jsx("group", { children: Array.from({ length: ringCount }, (_, i) => (_jsxs("group", { children: [_jsx("mesh", { ref: el => { meshRefs.current[i] = el; }, material: materials[i], rotation: [-Math.PI / 2, 0, 0], children: _jsx("torusGeometry", { args: [radius, thickness * intensity, 10, 80] }) }), _jsx("mesh", { ref: el => { flashRefs.current[i] = el; }, material: flashMaterials[i], rotation: [-Math.PI / 2, 0, 0], children: _jsx("circleGeometry", { args: [flashR, 48] }) })] }, i))) }));
+    return (_jsx("group", { ref: rootRef, children: Array.from({ length: ringCount }, (_, i) => (_jsxs("group", { children: [_jsx("mesh", { ref: el => { meshRefs.current[i] = el; }, material: materials[i], rotation: [-Math.PI / 2, 0, 0], children: _jsx("torusGeometry", { args: [radius, thickness * intensity, 10, 80] }) }), _jsx("mesh", { ref: el => { flashRefs.current[i] = el; }, material: flashMaterials[i], rotation: [-Math.PI / 2, 0, 0], children: _jsx("circleGeometry", { args: [flashR, 48] }) })] }, i))) }));
 };
 export default ShockwaveEffect;

package/dist/components/effects/SmokePlumeEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { SmokePlumeConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface SmokePlumeEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface SmokePlumeEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: SmokePlumeConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/SmokePlumeEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmokePlumeEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokePlumeEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,UAAU,qBAAqB;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA4DrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"SmokePlumeEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokePlumeEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA6ED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA8DrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/effects/SmokePlumeEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Fully GPU-animated smoke puff vertex shader ───────────────────────────────
 // Each particle has a lifetime t ∈ [0,1). It rises, expands, and billows.
 // All motion driven by u_time — zero CPU writes per frame.
@@ -77,9 +78,11 @@ const smokeFrag = /* glsl */ `
     gl_FragColor = vec4(col, g * vAlpha * uOpacity);
   }
 `;
-const SmokePlumeEffect = ({ boundingRadius, config, animations }) => {
+const SmokePlumeEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, height, spread, smokeColor, turbulence, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const h = boundingRadius * height;
     const s = boundingRadius * spread;
     const { geo, mat } = useMemo(() => {
@@ -136,6 +139,6 @@ const SmokePlumeEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([mat], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return _jsx("points", { geometry: geo, material: mat });
+    return _jsx("points", { ref: rootRef, geometry: geo, material: mat });
 };
 export default SmokePlumeEffect;

package/dist/components/effects/SmokeRibbon.d.ts

@@ -1,5 +1,6 @@
 import type { SmokeRibbonConfig } from '@3driseai/3drise-core';
-export interface SmokeRibbonProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface SmokeRibbonProps extends ObjectReadyProps {
     config?: SmokeRibbonConfig;
     boundingRadius?: number;
 }
@@ -8,6 +9,6 @@ export interface SmokeRibbonProps {
  *
  *   <SmokeRibbon position={[0, 0, 0]} config={{ planes: 2, twistStart: 0.2 }} />
  */
-declare const SmokeRibbon: ({ config, boundingRadius, ...groupProps }: SmokeRibbonProps) => import("react").JSX.Element;
+declare const SmokeRibbon: ({ config, boundingRadius, onObjectReady, onObjectDispose, ...groupProps }: SmokeRibbonProps) => import("react").JSX.Element;
 export default SmokeRibbon;
 //# sourceMappingURL=SmokeRibbon.d.ts.map

package/dist/components/effects/SmokeRibbon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,2CAAoD,gBAAgB,gCAyDxF,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,2EAAoF,gBAAgB,gCA2DxH,CAAC;AACF,eAAe,WAAW,CAAC"}