@3driseai/3drise-viewer 0.1.2 → 0.1.3

package/dist/components/AnimatedObject.d.ts

@@ -1,8 +1,9 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import type { Object3D } from "three";
 import type { ThreeEvent } from "@react-three/fiber";
 import type { AnimatedTransform, AnchorSettings, CreatedObjectSettings } from "@3driseai/3drise-core";
-export interface AnimatedObjectProps {
+export interface AnimatedObjectProps extends ObjectReadyProps {
     stateKey: string;
     transitionSettings: AnimatedTransform;
     createdObject: CreatedObjectSettings;

package/dist/components/AnimatedObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAwDvD,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+DvD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/components/AnimatedObject.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useEffect, useCallback, memo } from 'react';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
 import EffectsGroup from './EffectsGroup.js';
@@ -6,11 +7,18 @@ import { useObjectAnimation } from '../hooks/useObjectAnimation.js';
 import { hasHoverAnimation } from '../utils/hasHoverAnimation.js';
 export const AnimatedObject = memo(({ stateKey, transitionSettings, createdObject, 
 // speed = 1,
-visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointerLeave, anchor, hovered = false, animateMaterial = true,
+visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointerLeave, anchor, hovered = false, animateMaterial = true, onObjectReady, onObjectDispose,
 // isActive = false,
  }) => {
     const internalRef = useRef(null);
     const groupRef = parentRef ?? internalRef;
+    // Ownership rule: whoever creates the group reports it. CreatedObject passes
+    // its own meshRef in as parentRef, so groupRef is literally CreatedObject's
+    // object — reporting it here as well would fire twice for one Object3D.
+    // Standalone use (no parentRef) means this component owns the group, so it
+    // reports. `unownedRef` stays null, which the hook treats as nothing to report.
+    const unownedRef = useRef(null);
+    useObjectReady(parentRef ? unownedRef : groupRef, createdObject, onObjectReady, onObjectDispose);
     const { position, scale, rotation, targetPosition, targetScale, targetRotation } = transitionSettings;
     const animationStartTime = useRef(null);
     const stepDuration = useRef(1);
@@ -57,9 +65,9 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
         return _jsx(_Fragment, { children: _jsxs("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, 
                 // onPointerEnter={onPointerEnter}
                 // onPointerLeave={onPointerLeave}
-                name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject })] }) });
+                name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) });
     }
-    return (_jsx(_Fragment, { children: _jsxs("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject })] }) }));
+    return (_jsx(_Fragment, { children: _jsxs("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) }));
 });
 AnimatedObject.displayName = 'AnimatedObject';
 export default AnimatedObject;

package/dist/components/Bubbles.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { BubblesConfig } from '@3driseai/3drise-core';
 import React from "react";
-export interface BubblesProps {
+export interface BubblesProps extends ObjectReadyProps {
     config: BubblesConfig;
     boundingRadius?: number;
 }

package/dist/components/Bubbles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Bubbles.d.ts","sourceRoot":"","sources":["../../src/components/Bubbles.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAiGnC,CAAC;AACF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Bubbles.d.ts","sourceRoot":"","sources":["../../src/components/Bubbles.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAmGnC,CAAC;AACF,eAAe,OAAO,CAAC"}

package/dist/components/Bubbles.js

@@ -1,10 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { BubblesPointsMaterial } from '@3driseai/3drise-core';
 const MAX_BUBBLES = 256;
-const Bubbles = ({ config }) => {
+const Bubbles = ({ config, onObjectReady, onObjectDispose }) => {
     const positions = useMemo(() => new Float32Array(MAX_BUBBLES * 3), []);
     const velocities = useMemo(() => new Float32Array(MAX_BUBBLES * 3), []);
     const ages = useMemo(() => new Float32Array(MAX_BUBBLES), []);
@@ -43,6 +44,8 @@ const Bubbles = ({ config }) => {
     }, [config.colors, config.scale, config.opacity, config.iridescence, config.speed, material]);
     useEffect(() => () => { geometry.dispose(); material.dispose(); }, [geometry, material]);
     const spawnAccum = useRef(0);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     useFrame((state, delta) => {
         material.uniforms.uTime.value = state.clock.getElapsedTime();
         const scale = config.scale ?? 1;
@@ -100,6 +103,6 @@ const Bubbles = ({ config }) => {
     });
     if (!config.enabled)
         return null;
-    return _jsx("points", { geometry: geometry, material: material, frustumCulled: false });
+    return _jsx("points", { ref: rootRef, geometry: geometry, material: material, frustumCulled: false });
 };
 export default Bubbles;

package/dist/components/CameraController.d.ts

@@ -1,9 +1,17 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { CameraState } from "@3driseai/3drise-core";
-interface CameraControllerProps {
+interface CameraControllerProps extends ObjectReadyProps {
     settings: CameraState;
     enableAutoAnimation?: boolean;
     animationDuration?: number;
     animationEase?: string;
+    /**
+     * drei's OrbitControls instance is not an Object3D, so it cannot travel
+     * through onObjectReady — it gets its own pair. onObjectReady reports the
+     * camera, which is an Object3D.
+     */
+    onControlsReady?: (controls: any) => void;
+    onControlsDispose?: (controls: any) => void;
 }
 export declare const CameraController: React.FC<CameraControllerProps>;
 export default CameraController;

package/dist/components/CameraController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../src/components/CameraController.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,UAAU,qBAAqB;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAoJ5D,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../src/components/CameraController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,UAAU,qBAAsB,SAAQ,gBAAgB;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAGD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA8J5D,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/CameraController.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import { useCameraAnimation } from '../hooks/useCameraAnimation.js';
@@ -6,11 +7,21 @@ import { cameraManager } from '../utils/CameraSingleton.js';
 import { useAnimationEvents } from '../hooks/useAnimationEvents.js';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
 import { OrbitControls } from "@react-three/drei";
-export const CameraController = ({ enableAutoAnimation = true, animationDuration = 1, animationEase = "power2.out", settings, }) => {
+export const CameraController = ({ enableAutoAnimation = true, animationDuration = 1, animationEase = "power2.out", settings, onObjectReady, onObjectDispose, onControlsReady, onControlsDispose, }) => {
     const { camera, set } = useThree();
     const cameraRef = useRef(camera);
     const transformAnimationProgress = useRef(0);
     const controlsRef = useRef(null);
+    useObjectReady(cameraRef, settings, onObjectReady, onObjectDispose);
+    useEffect(() => {
+        const controls = controlsRef.current;
+        if (!controls)
+            return;
+        onControlsReady && onControlsReady(controls);
+        return () => {
+            onControlsDispose && onControlsDispose(controls);
+        };
+    }, [controlsRef.current]); // eslint-disable-line react-hooks/exhaustive-deps
     const { position, orientation, fov, near, far, controls } = settings;
     const initialControls = useRef(controls);
     const { startPathAnimation, updatePathAnimation, isAnimating: isPathAnimating, } = usePathAnimation();

package/dist/components/Clouds.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { TimeSettings, CreatedObjectSettings } from '@3driseai/3drise-core';
 import React from "react";
-export interface CloudsProps {
+export interface CloudsProps extends ObjectReadyProps {
     settings: CreatedObjectSettings;
     timeSettings?: TimeSettings;
 }

package/dist/components/Clouds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Clouds.d.ts","sourceRoot":"","sources":["../../src/components/Clouds.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAmFD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA4LjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Clouds.d.ts","sourceRoot":"","sources":["../../src/components/Clouds.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAmFD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA6LjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Clouds.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useCallback } from 'react';
 import * as THREE from 'three';
 import { useThree, useFrame } from '@react-three/fiber';
@@ -86,7 +87,7 @@ const defaultTimeSettings = {
     syncWithRealTime: false,
     autoAnimate: false,
 };
-const Clouds = ({ settings, timeSettings = defaultTimeSettings }) => {
+const Clouds = ({ settings, timeSettings = defaultTimeSettings, onObjectReady, onObjectDispose }) => {
     const visible = settings.meshSettings.visible ?? true;
     const meshSettings = settings.meshSettings;
     const config = settings.config;
@@ -100,6 +101,7 @@ const Clouds = ({ settings, timeSettings = defaultTimeSettings }) => {
     const planeSize = config?.planeSize || [10000, 10000];
     const planeSegments = config?.planeSegments || 64;
     const meshRef = useRef(null);
+    useObjectReady(meshRef, settings, onObjectReady, onObjectDispose);
     const cloudAnimTime = useRef(0);
     const { camera } = useThree();
     const cloudColorRef = useRef(new THREE.Color(1, 1, 1));

package/dist/components/CreatedObject.d.ts

@@ -1,12 +1,12 @@
 import type { CreatedObjectSettings } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from "../types/objectReady";
 import React from "react";
 import { Object3D } from "three";
 import { type ThreeEvent } from "@react-three/fiber";
-interface CreatedObjectProps {
+interface CreatedObjectProps extends ObjectReadyProps {
     createdObject: CreatedObjectSettings;
     children: React.ReactNode;
     shouldApply3driseMaterial?: boolean;
-    onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void;
     handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
 }
 declare const CreatedObject: React.FC<CreatedObjectProps>;

package/dist/components/CreatedObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreatedObject.d.ts","sourceRoot":"","sources":["../../src/components/CreatedObject.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AASnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,kBAAkB;IACxB,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuF9C,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"CreatedObject.d.ts","sourceRoot":"","sources":["../../src/components/CreatedObject.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAUnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,kBAAmB,SAAQ,gBAAgB;IACjD,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAqF9C,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/components/CreatedObject.js

@@ -9,7 +9,8 @@ import { cameraManager } from "../utils/CameraSingleton.js";
 import AnimatedObject from "./AnimatedObject.js";
 import { useFrameEffects } from "../hooks/useFrameEffects.js";
 import { useObjectEdges } from "../hooks/useObjectEdges.js";
-const CreatedObject = memo(({ createdObject, children, shouldApply3driseMaterial = true, onObjectReady, handleObjectClick, }) => {
+import { useObjectReady } from "../hooks/useObjectReady.js";
+const CreatedObject = memo(({ createdObject, children, shouldApply3driseMaterial = true, onObjectReady, onObjectDispose, handleObjectClick, }) => {
     const isSelected = false;
     // const isSelected = useObjectSelection(createdObject.id);
     // const { handleObjectClick: contextHandleObjectClick } = useSceneClick();
@@ -34,11 +35,9 @@ const CreatedObject = memo(({ createdObject, children, shouldApply3driseMaterial
     useEffect(() => {
         if (meshRef.current) {
             meshRef.current.userData.id = createdObject.id;
-            onObjectReady && onObjectReady(createdObject, meshRef.current);
         }
-        return () => {
-        };
-    }, [meshRef.current]);
+    }, [meshRef.current, createdObject.id]);
+    useObjectReady(meshRef, createdObject, onObjectReady, onObjectDispose);
     useEffect(() => {
         if (transformRef.current && isSelected) {
             controllersRef.current.set(createdObject.id.toString(), transformRef.current);
@@ -94,7 +93,7 @@ const CreatedObject = memo(({ createdObject, children, shouldApply3driseMaterial
             position: anchorEnabled ? [anchoredPosition.x, anchoredPosition.y, anchoredPosition.z] : animatedTransform.position
         }, createdObject: createdObject, 
         // animateMaterial={!useDreiMaterials}
-        parentRef: meshRef, visible: createdObject.meshSettings.visible, handleObjectClick: handleObjectClick, onPointerEnter: handleObjectEnter, onPointerLeave: e => handleObjectLeave(e), hovered: hovered, children: createdObject.rigidBodySettings?.enabled ? (_jsx(RigidBody, { type: createdObject.rigidBodySettings?.type || 'dynamic', mass: createdObject.rigidBodySettings?.mass || 1, colliders: createdObject.userData?.type === 'plane'
+        parentRef: meshRef, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, visible: createdObject.meshSettings.visible, handleObjectClick: handleObjectClick, onPointerEnter: handleObjectEnter, onPointerLeave: e => handleObjectLeave(e), hovered: hovered, children: createdObject.rigidBodySettings?.enabled ? (_jsx(RigidBody, { type: createdObject.rigidBodySettings?.type || 'dynamic', mass: createdObject.rigidBodySettings?.mass || 1, colliders: createdObject.userData?.type === 'plane'
                 ? 'cuboid' // Force box collider for planes
                 : undefined // Auto-detect for others
             , friction: createdObject.rigidBodySettings?.friction, restitution: createdObject.rigidBodySettings?.restitution, gravityScale: createdObject.rigidBodySettings?.gravityScale ?? 1, linearDamping: createdObject.rigidBodySettings?.linearDamping ?? 0.01, angularDamping: createdObject.rigidBodySettings?.angularDamping ?? 0.01, children: children })) : (children) }));

package/dist/components/CustomPrimitive.d.ts

@@ -1,10 +1,10 @@
 import type { CreatedObjectSettings } from '@3driseai/3drise-core';
 import type { Object3D } from 'three';
+import type { ObjectReadyProps } from "../types/objectReady";
 import React from "react";
 import { type ThreeEvent } from "@react-three/fiber";
-interface CustomPrimitiveProps {
+interface CustomPrimitiveProps extends ObjectReadyProps {
     createdObject: CreatedObjectSettings;
-    onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void;
     handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
 }
 declare const CustomPrimitive: React.FC<CustomPrimitiveProps>;

package/dist/components/CustomPrimitive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/CustomPrimitive.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAItC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAoB;IAC1B,aAAa,EAAE,qBAAqB,CAAC;IACrC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA6ElD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"CustomPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/CustomPrimitive.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAKtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,aAAa,EAAE,qBAAqB,CAAC;IACrC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAgFlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/CustomPrimitive.js

@@ -5,8 +5,11 @@ import { Vector3 } from "three";
 import MaterialLibrary from "./MaterialLibrary.js";
 import { useWaterReflections } from "../hooks/useWaterReflections.js";
 import { GeometryMesh } from "./GeometryShape.js";
-const CustomPrimitive = memo(({ createdObject, onObjectReady, handleObjectClick, }) => {
+import { useObjectReady } from "../hooks/useObjectReady.js";
+const CustomPrimitive = memo(({ createdObject, onObjectReady, onObjectDispose, handleObjectClick, }) => {
     const meshRef = useRef(null);
+    // CustomPrimitive accepted onObjectReady but never fired it; this is the fix.
+    useObjectReady(meshRef, createdObject, onObjectReady, onObjectDispose);
     const resolvedObject = useMemo(() => {
         // console.log(`Resolving object for ${createdObject.name}`, createdObject);
         if (!createdObject)
@@ -75,8 +78,9 @@ const CustomPrimitive = memo(({ createdObject, onObjectReady, handleObjectClick,
     // else if (materialType === 'line') {
     //   mode = 'outline';
     // }
+    // console.log({createdObject});
     if (createdObject.type === 'mesh')
-        return _jsx("mesh", { ref: meshRef, name: createdObject.name, children: _jsx(GeometryMesh, { config: createdObject.config, materialSettings: createdObject.materialSettings, animations: createdObject.animations, modeConfig: createdObject.modeConfig || { mode: 'solid', count: 1000, symmetry: 3, spacing: 0.1, slices: 8, linkRadius: 0.05, angle: 18, lineWidth: 1 } }) }, createdObject.id);
+        return _jsx("mesh", { ref: meshRef, name: createdObject.name, children: _jsx(GeometryMesh, { config: createdObject.config, materialSettings: createdObject.materialSettings, animations: createdObject.animations, onObjectReady: (_object, ref) => onObjectReady && onObjectReady(createdObject, ref), onObjectDispose: (_object, ref) => onObjectDispose && onObjectDispose(createdObject, ref), modeConfig: createdObject.modeConfig || { mode: 'solid', count: 1000, symmetry: 3, spacing: 0.1, slices: 8, linkRadius: 0.05, angle: 18, lineWidth: 1 } }) }, createdObject.id);
     if (!resolvedObject) {
         console.warn(`no resolved object for ${createdObject.name} (${createdObject.id})`);
         return null;

package/dist/components/Earth.d.ts

@@ -1,8 +1,6 @@
-import * as THREE from 'three';
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import { EarthConfig } from "@3driseai/3drise-core";
-declare const Earth: React.FC<EarthConfig & {
-    onMeshReady?: (mesh: THREE.Mesh) => void;
-}>;
+declare const Earth: React.FC<EarthConfig & ObjectReadyProps>;
 export default Earth;
 //# sourceMappingURL=Earth.d.ts.map

package/dist/components/Earth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Earth.d.ts","sourceRoot":"","sources":["../../src/components/Earth.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;CAC5C,CA2BR,CAAC;AAEF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Earth.d.ts","sourceRoot":"","sources":["../../src/components/Earth.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,GAAG,gBAAgB,CA4BnD,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/components/Earth.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useMemo, useCallback, useEffect } from 'react';
 import * as THREE from 'three';
 import { useTexture } from '@react-three/drei';
@@ -6,8 +7,10 @@ const CDN = 'https://3d-rise.sfo3.cdn.digitaloceanspaces.com/app/images/planets'
 const EARTH_DAY_URL = `${CDN}/earth_day_4096.jpg`;
 const EARTH_NIGHT_URL = `${CDN}/earth_night_4096.jpg`;
 const EARTH_BUMP_ROUGHNESS_CLOUDS_URL = `${CDN}/earth_bump_roughness_clouds_4096.jpg`;
-const Earth = ({ sunPosition = [0, 0, 3], atmosphereDayColor = '#4db2ff', atmosphereTwilightColor = '#bc490b', radius = 1, onMeshReady, }) => {
+const Earth = ({ sunPosition = [0, 0, 3], atmosphereDayColor = '#4db2ff', atmosphereTwilightColor = '#bc490b', radius = 1, onObjectReady, onObjectDispose, }) => {
     const globeRef = useRef(null);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, { sunPosition, atmosphereDayColor, atmosphereTwilightColor, radius }, onObjectReady, onObjectDispose);
     const globeMatRef = useRef(null);
     const atmosphereMatRef = useRef(null);
     const segments = 64;
@@ -29,10 +32,9 @@ const Earth = ({ sunPosition = [0, 0, 3], atmosphereDayColor = '#4db2ff', atmosp
     const handleGlobeRef = useCallback((mesh) => {
         if (mesh) {
             globeRef.current = mesh;
-            onMeshReady?.(mesh);
         }
-    }, [onMeshReady]);
-    return (_jsxs("group", { userData: { id: '3drise-earth' }, children: [_jsxs("mesh", { ref: handleGlobeRef, children: [_jsx("sphereGeometry", { args: [radius, segments, segments] }), _jsx("earthMaterial", { ref: globeMatRef, uDayMap: dayMap, uNightMap: nightMap, uBumpRoughnessClouds: bumpRoughnessClouds, uSunDirection: sunDirection, uAtmosphereDayColor: dayColor, uAtmosphereTwilightColor: twilightColor })] }), _jsxs("mesh", { scale: 1.04, children: [_jsx("sphereGeometry", { args: [radius, segments, segments] }), _jsx("earthAtmosphereMaterial", { ref: atmosphereMatRef, transparent: true, side: THREE.BackSide, depthWrite: false, uSunDirection: sunDirection, uAtmosphereDayColor: dayColor, uAtmosphereTwilightColor: twilightColor })] })] }));
+    }, []);
+    return (_jsxs("group", { ref: rootRef, userData: { id: '3drise-earth' }, children: [_jsxs("mesh", { ref: handleGlobeRef, children: [_jsx("sphereGeometry", { args: [radius, segments, segments] }), _jsx("earthMaterial", { ref: globeMatRef, uDayMap: dayMap, uNightMap: nightMap, uBumpRoughnessClouds: bumpRoughnessClouds, uSunDirection: sunDirection, uAtmosphereDayColor: dayColor, uAtmosphereTwilightColor: twilightColor })] }), _jsxs("mesh", { scale: 1.04, children: [_jsx("sphereGeometry", { args: [radius, segments, segments] }), _jsx("earthAtmosphereMaterial", { ref: atmosphereMatRef, transparent: true, side: THREE.BackSide, depthWrite: false, uSunDirection: sunDirection, uAtmosphereDayColor: dayColor, uAtmosphereTwilightColor: twilightColor })] })] }));
 };
 Earth.displayName = 'Earth';
 export default Earth;

package/dist/components/EffectsGenerator.d.ts

@@ -1,7 +1,8 @@
 import type { Object3D } from 'three';
 import React from "react";
 import type { GenerativeEffectSettings } from "@3driseai/3drise-core";
-export interface EffectsGeneratorProps {
+import type { ObjectReadyProps } from '../types/objectReady';
+export interface EffectsGeneratorProps extends ObjectReadyProps {
     settings: GenerativeEffectSettings;
     object?: Object3D | null;
 }

package/dist/components/EffectsGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EffectsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/EffectsGenerator.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAyBtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B;AAGD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA0CrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"EffectsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/EffectsGenerator.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAyBtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B;AAGD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA4CrD,CAAC;AACF,eAAe,gBAAgB,CAAC"}

package/dist/components/EffectsGenerator.js

@@ -19,17 +19,15 @@ import IceCrystalsEffect from './effects/IceCrystalsEffect.js';
 import SmokePlumeEffect from './effects/SmokePlumeEffect.js';
 import VolumetricFogEffect from './effects/VolumetricFogEffect.js';
 import SmokeRingEffect from './effects/SmokeRingEffect.js';
-import Flares from './Flares.js';
+import Flares from './effects/Flares.js';
 import SparklesBurst from './SparklesBurst.js';
 import Bubbles from './Bubbles.js';
 import Glyphs from './Glyphs.js';
 import Fire from './effects/Fire.js';
 import SmokeRibbon from './effects/SmokeRibbon.js';
-const EffectsGenerator = ({ settings, object }) => {
+const EffectsGenerator = ({ settings, object, onObjectReady, onObjectDispose }) => {
     console.log('EffectsGenerator render with settings:', settings, 'and object:', object);
     const { config } = settings;
-    if (!config.enabled)
-        return null;
     // console.log('Effect config:', config);  
     const boundingRadius = useMemo(() => {
         if (!object)
@@ -39,32 +37,35 @@ const EffectsGenerator = ({ settings, object }) => {
         box.getBoundingSphere(sphere);
         return sphere.radius || 1;
     }, [object]);
+    if (!config.enabled)
+        return null;
     const animations = settings.animations;
+    const ready = { onObjectReady, onObjectDispose };
     switch (config.type) {
-        case 'molecules': return _jsx(MoleculesEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'shockwave': return _jsx(ShockwaveEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'aura': return _jsx(AuraEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'dataStream': return _jsx(DataStreamEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'constellation': return _jsx(ConstellationEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'hologram': return _jsx(HologramEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'portal': return _jsx(PortalEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'dnaHelix': return _jsx(DnaHelixEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'orb': return _jsx(OrbEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'lightning': return _jsx(LightningEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'aurora': return _jsx(AuroraEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'forcefield': return _jsx(ForcefieldEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'neuralNetwork': return _jsx(NeuralNetworkEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'blackHole': return _jsx(BlackHoleEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'iceCrystals': return _jsx(IceCrystalsEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'smokePlume': return _jsx(SmokePlumeEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'volumetricFog': return _jsx(VolumetricFogEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'smokeRing': return _jsx(SmokeRingEffect, { boundingRadius: boundingRadius, config: config, animations: animations });
-        case 'fire': return _jsx(Fire, { hostRef: object, config: config, animations: animations });
-        case 'flares': return _jsx(Flares, { hostRef: object, config: config, animations: animations });
+        case 'molecules': return _jsx(MoleculesEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'shockwave': return _jsx(ShockwaveEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'aura': return _jsx(AuraEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'dataStream': return _jsx(DataStreamEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'constellation': return _jsx(ConstellationEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'hologram': return _jsx(HologramEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'portal': return _jsx(PortalEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'dnaHelix': return _jsx(DnaHelixEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'orb': return _jsx(OrbEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'lightning': return _jsx(LightningEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'aurora': return _jsx(AuroraEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'forcefield': return _jsx(ForcefieldEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'neuralNetwork': return _jsx(NeuralNetworkEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'blackHole': return _jsx(BlackHoleEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'iceCrystals': return _jsx(IceCrystalsEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'smokePlume': return _jsx(SmokePlumeEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'volumetricFog': return _jsx(VolumetricFogEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'smokeRing': return _jsx(SmokeRingEffect, { boundingRadius: boundingRadius, config: config, animations: animations, ...ready });
+        case 'fire': return _jsx(Fire, { hostRef: object, config: config, animations: animations, ...ready });
+        case 'flares': return _jsx(Flares, { hostRef: object, config: config, animations: animations, ...ready });
         case 'sparklesBurst': return _jsx(SparklesBurst, { boundingRadius: boundingRadius, config: config });
         case 'bubbles': return _jsx(Bubbles, { boundingRadius: boundingRadius, config: config });
         case 'glyphs': return _jsx(Glyphs, { boundingRadius: boundingRadius, config: config });
-        case 'smokeRibbon': return _jsx(SmokeRibbon, { config: config, boundingRadius: boundingRadius });
+        case 'smokeRibbon': return _jsx(SmokeRibbon, { config: config, boundingRadius: boundingRadius, ...ready });
         default: return null;
     }
 };

package/dist/components/EffectsGroup.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { CreatedObjectSettings } from '@3driseai/3drise-core';
 import React from "react";
-interface EffectsGroupProps {
+interface EffectsGroupProps extends ObjectReadyProps {
     createdObject: CreatedObjectSettings;
 }
 declare const EffectsGroup: React.FC<EffectsGroupProps>;

package/dist/components/EffectsGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EffectsGroup.d.ts","sourceRoot":"","sources":["../../src/components/EffectsGroup.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,UAAU,iBAAiB;IACvB,aAAa,EAAE,qBAAqB,CAAC;CACxC;AAGD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAK7C,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"EffectsGroup.d.ts","sourceRoot":"","sources":["../../src/components/EffectsGroup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,UAAU,iBAAkB,SAAQ,gBAAgB;IAChD,aAAa,EAAE,qBAAqB,CAAC;CACxC;AAGD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAQ7C,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/EffectsGroup.js

@@ -1,11 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { GEREATIVE_EFFECTS_KEY } from '@3driseai/3drise-core';
 import EffectsGenerator from './EffectsGenerator.js';
 import { findById } from '../utils/sceneQuery.js';
-const EffectsGroup = ({ createdObject }) => {
+const EffectsGroup = ({ createdObject, onObjectReady, onObjectDispose }) => {
+    // Hooks must run before the early return below.
+    const groupRef = useRef(null);
+    useObjectReady(groupRef, createdObject, onObjectReady, onObjectDispose);
     if (!createdObject.effects || createdObject.effects.length === 0)
         return null;
     const object = findById(createdObject.id);
-    return (_jsx("group", { name: `${createdObject.id}-effects`, userData: { [GEREATIVE_EFFECTS_KEY]: true }, children: createdObject.effects.map((effect, index) => (_jsx(EffectsGenerator, { settings: effect, object: object }, index))) }));
+    return (_jsx("group", { ref: groupRef, name: `${createdObject.id}-effects`, userData: { [GEREATIVE_EFFECTS_KEY]: true }, children: createdObject.effects.map((effect, index) => (_jsx(EffectsGenerator, { settings: effect, object: object, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, index))) }));
 };
 export default EffectsGroup;

package/dist/components/EnvironmentManager.js

@@ -7,7 +7,7 @@ import SkySystem from './SkySystem.js';
 import { useCubeCamera } from '../hooks/useCubeCamera.js';
 import HdrPlaylistRenderer from './HdrPlaylistRenderer.js';
 import { getTransitionSettings } from '@3driseai/3drise-core';
-const EnvironmentManager = forwardRef(({ environment, cubeCameraResolution = 512, timeSettings, onTimeOfDayChange, onTimeUpdate, }, ref) => {
+const EnvironmentManager = forwardRef(({ environment, cubeCameraResolution = 512, timeSettings, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
     const { scene } = useThree();
     const defaultHdr = {
         visible: false,
@@ -68,7 +68,7 @@ const EnvironmentManager = forwardRef(({ environment, cubeCameraResolution = 512
                 scale: hdr.settings.groundScale,
             } }));
     }, [playlistActive, singleUrl, backgroundName, hdr.settings, scene]);
-    return (_jsxs(_Fragment, { children: [environmentComponent, playlistActive && urls && (_jsx(HdrPlaylistRenderer, { urls: urls, transition: getTransitionSettings(hdr) })), _jsx(SkySystem, { ref: ref, timeSettings: timeSettings, visible: true, sunSystemVisible: sunSystemVisible, sunSize: sunSize, moonSize: moonSize, skyboxScale: skyboxScale, sunIntensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, playerPosition: playerPosition, starsSettings: starsSettings, cloudsSettings: cloudsSettings, cloudsMaterialSettings: cloudsMaterialSettings, skyControllerSettings: skyControllerSettings, rainSettings: rainSettings, fogSettings: fogSettings, onTimeOfDayChange: onTimeOfDayChange, onTimeUpdate: onTimeUpdate })] }));
+    return (_jsxs(_Fragment, { children: [environmentComponent, playlistActive && urls && (_jsx(HdrPlaylistRenderer, { urls: urls, transition: getTransitionSettings(hdr), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })), _jsx(SkySystem, { ref: ref, timeSettings: timeSettings, visible: true, sunSystemVisible: sunSystemVisible, sunSize: sunSize, moonSize: moonSize, skyboxScale: skyboxScale, sunIntensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, playerPosition: playerPosition, starsSettings: starsSettings, cloudsSettings: cloudsSettings, cloudsMaterialSettings: cloudsMaterialSettings, skyControllerSettings: skyControllerSettings, rainSettings: rainSettings, fogSettings: fogSettings, onTimeOfDayChange: onTimeOfDayChange, onTimeUpdate: onTimeUpdate, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }));
 });
 EnvironmentManager.displayName = 'EnvironmentManager';
 export default EnvironmentManager;

package/dist/components/EnvironmentObject.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import type { CreatedObjectSettings } from "@3driseai/3drise-core";
-type EnvironmentObjectProps = {
+type EnvironmentObjectProps = ObjectReadyProps & {
     createdObject: CreatedObjectSettings;
 };
 declare const EnvironmentObject: React.FC<EnvironmentObjectProps>;

package/dist/components/EnvironmentObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentObject.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,KAAK,sBAAsB,GAAG;IAC1B,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAGF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAUvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"EnvironmentObject.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC7C,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAGF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAUvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}

package/dist/components/EnvironmentObject.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import Rain from './Rain.js';
-const EnvironmentObject = ({ createdObject }) => {
+const EnvironmentObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
     const config = createdObject.config;
     if (!config || config.enabled === false)
         return null;
     switch (config.type) {
         case 'rain':
-            return _jsx(Rain, { settings: createdObject });
+            return _jsx(Rain, { settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         default:
             return null;
     }

package/dist/components/Frame.d.ts

@@ -1,9 +1,10 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { Object3D } from 'three';
 import type { CreatedObjectSettings, HoverSettings, GalleryLayoutSettings, TransformEffect, ColorEffect, MaterialSettings } from '@3driseai/3drise-core';
 import type { FrameShapeType } from './FrameGeometry';
 import { type ThreeEvent } from "@react-three/fiber";
 export type { FrameShapeType };
-export interface FrameProps {
+export interface FrameProps extends ObjectReadyProps {
     url: string;
     isActive: boolean;
     createdObject: CreatedObjectSettings;
@@ -19,5 +20,5 @@ export interface FrameProps {
     children?: React.ReactNode;
     handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;
 }
-export default function Frame({ url, isActive, createdObject, position, rotation, shapeType, hoverSettings, transformEffects, colorEffects, layoutSettings, side, materialSettings, children, handleObjectClick, }: FrameProps): import("react").JSX.Element;
+export default function Frame({ url, isActive, createdObject, position, rotation, shapeType, hoverSettings, transformEffects, colorEffects, layoutSettings, side, materialSettings, children, handleObjectClick, onObjectReady, onObjectDispose, }: FrameProps): import("react").JSX.Element;
 //# sourceMappingURL=Frame.d.ts.map

package/dist/components/Frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Frame.d.ts","sourceRoot":"","sources":["../../src/components/Frame.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzJ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAoB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,GAAG,EAAE,UAAU,+BA2ClP"}
+{"version":3,"file":"Frame.d.ts","sourceRoot":"","sources":["../../src/components/Frame.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzJ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAoB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,UAAU,+BA4ClR"}

package/dist/components/Frame.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useState, useEffect } from "react";
 import { useCursor } from "@react-three/drei";
 import { BackSide, DoubleSide, FrontSide, Mesh } from "three";
@@ -8,8 +9,9 @@ import { FrameImage } from "./FrameImage.js";
 import MaterialLibrary from "./MaterialLibrary.js";
 import { useFrameEffects } from "../hooks/useFrameEffects.js";
 import { useObjectAnimation } from "../hooks/useObjectAnimation.js";
-export default function Frame({ url, isActive, createdObject, position, rotation, shapeType = 'circle', hoverSettings, transformEffects = [], colorEffects = [], layoutSettings, side, materialSettings, children, handleObjectClick, }) {
+export default function Frame({ url, isActive, createdObject, position, rotation, shapeType = 'circle', hoverSettings, transformEffects = [], colorEffects = [], layoutSettings, side, materialSettings, children, handleObjectClick, onObjectReady, onObjectDispose, }) {
     const frameRef = useRef(new Mesh());
+    useObjectReady(frameRef, createdObject, onObjectReady, onObjectDispose);
     const imageRef = useRef(null);
     const [texture, setTexture] = useState(null);
     useEffect(() => {