@3driseai/3drise-viewer 0.1.2 → 0.1.3

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"}

package/dist/components/effects/SmokeRibbon.js

@@ -3,12 +3,13 @@ import { PlaneGeometry } from 'three';
 import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import { SmokeRibbonMaterial } from '@3driseai/3drise-core';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 /**
  * Place where you want the smoke to rise from — it climbs the parent's local +Y:
  *
  *   <SmokeRibbon position={[0, 0, 0]} config={{ planes: 2, twistStart: 0.2 }} />
  */
-const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
+const SmokeRibbon = ({ config = {}, boundingRadius = 1, onObjectReady, onObjectDispose, ...groupProps }) => {
     const { width = 1.5, height = 5, segmentsPerLength = 12, planes = 2, color = '#f2f2f7', colorTop = '#b3b8c7', speed = 0.18, detail = 1.4, remapLow = 0.38, remapHigh = 1.0, edgeX = 0.4, edgeY = 0.32, density = 1.0, twistStrength = 9, twistSpeed = 0.4, twistScale = 0.9, twistStart = 0.18, wind = [0.15, 0], animate = true, interactive = false, } = config;
     // One material instance shared across the crossed planes -> one set of uniforms.
     const material = useMemo(() => new SmokeRibbonMaterial(), []);
@@ -50,6 +51,8 @@ const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
     ]);
     const { pointer } = useThree();
     const hovering = useRef(false);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     useFrame(({ clock }) => {
         if (animate)
             material.u_time = clock.getElapsedTime();
@@ -64,6 +67,6 @@ const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
         }
     });
     console.log('SmokeRibbon render with config:', config, 'and groupProps:', groupProps);
-    return (_jsx("group", { ...groupProps, onPointerOver: interactive ? () => (hovering.current = true) : undefined, onPointerOut: interactive ? () => (hovering.current = false) : undefined, children: angles.map((a, i) => (_jsx("mesh", { geometry: geometry, material: material, "rotation-y": a }, i))) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, onPointerOver: interactive ? () => (hovering.current = true) : undefined, onPointerOut: interactive ? () => (hovering.current = false) : undefined, children: angles.map((a, i) => (_jsx("mesh", { geometry: geometry, material: material, "rotation-y": a }, i))) }));
 };
 export default SmokeRibbon;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.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;AAiED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAyFnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.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;AAiED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2FnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/SmokeRingEffect.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';
 // ── Per-ring puff shader (one Points per ring — GPU computes torus positions) ──
 const ringVert = /* glsl */ `
   attribute float aAngle;    // 0..TAU position around torus
@@ -65,9 +66,11 @@ const ringFrag = /* glsl */ `
   }
 `;
 const PUFFS_PER_RING = 120;
-const SmokeRingEffect = ({ boundingRadius, config, animations }) => {
+const SmokeRingEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { ringCount, expansionRadius, riseSpeed, intervalSeconds, smokeColor, thickness, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const N = Math.max(1, Math.min(ringCount, 4));
     // Ring states — one per slot
     const ringStates = useRef([]);
@@ -153,6 +156,6 @@ const SmokeRingEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations(mats, animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsx("group", { children: geos.map((geo, i) => (_jsx("points", { geometry: geo, material: mats[i] }, i))) }));
+    return (_jsx("group", { ref: rootRef, children: geos.map((geo, i) => (_jsx("points", { geometry: geo, material: mats[i] }, i))) }));
 };
 export default SmokeRingEffect;

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.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;AAoDD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAuD3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.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;AAoDD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAyD3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/VolumetricFogEffect.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';
 // ── Billboard fog puff — drifts slowly, never rises far ───────────────────────
 const fogVert = /* glsl */ `
   attribute float aT;       // stagger offset 0..1
@@ -52,9 +53,11 @@ const fogFrag = /* glsl */ `
     gl_FragColor = vec4(uFogColor, g * vAlpha * uDensity);
   }
 `;
-const VolumetricFogEffect = ({ boundingRadius, config, animations }) => {
+const VolumetricFogEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, fogRadius, driftSpeed, fogColor, density, opacity, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius * fogRadius;
     const { geo, mat } = useMemo(() => {
         const N = Math.max(20, Math.min(particleCount, 200));
@@ -106,6 +109,6 @@ const VolumetricFogEffect = ({ 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 VolumetricFogEffect;

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

@@ -0,0 +1,28 @@
+export type { CoronaProps } from './Corona';
+export type { FireProps } from './Fire';
+export type { FlaresProps } from './Flares';
+export type { SmokeRibbonProps } from './SmokeRibbon';
+export { default as AuraEffect } from './AuraEffect';
+export { default as AuroraEffect } from './AuroraEffect';
+export { default as BlackHoleEffect } from './BlackHoleEffect';
+export { default as ConstellationEffect } from './ConstellationEffect';
+export { default as Corona } from './Corona';
+export { default as DataStreamEffect } from './DataStreamEffect';
+export { default as DnaHelixEffect } from './DnaHelixEffect';
+export { default as Fire } from './Fire';
+export { default as FireEffect } from './FireEffect';
+export { default as Flares } from './Flares';
+export { default as ForcefieldEffect } from './ForcefieldEffect';
+export { default as HologramEffect } from './HologramEffect';
+export { default as IceCrystalsEffect } from './IceCrystalsEffect';
+export { default as LightningEffect } from './LightningEffect';
+export { default as MoleculesEffect } from './MoleculesEffect';
+export { default as NeuralNetworkEffect } from './NeuralNetworkEffect';
+export { default as OrbEffect } from './OrbEffect';
+export { default as PortalEffect } from './PortalEffect';
+export { default as ShockwaveEffect } from './ShockwaveEffect';
+export { default as SmokePlumeEffect } from './SmokePlumeEffect';
+export { default as SmokeRibbon } from './SmokeRibbon';
+export { default as SmokeRingEffect } from './SmokeRingEffect';
+export { default as VolumetricFogEffect } from './VolumetricFogEffect';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/effects/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}