@3driseai/3drise-viewer 0.1.2 → 0.1.3

package/dist/components/SparklesBurst.js

@@ -1,9 +1,10 @@
 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 { SparklesBurstMaterial } from '@3driseai/3drise-core';
-const SparklesBurst = ({ config, boundingRadius }) => {
+const SparklesBurst = ({ config, boundingRadius, onObjectReady, onObjectDispose }) => {
     // console.log("Rendering SparklesBurst with config:", config, "and boundingRadius:", boundingRadius);
     const planeSize = useMemo(() => Math.max(0.05, config.scale ?? 2.5), [config.scale]);
     const geometry = useMemo(() => new THREE.PlaneGeometry(planeSize, planeSize, 1, 1), [planeSize]);
@@ -40,6 +41,8 @@ const SparklesBurst = ({ config, boundingRadius }) => {
     // Track elapsed time JS-side so loop on/off toggles cleanly without
     // depending on the global clock for the progress phase.
     const startRef = useRef(null);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // Reset start when loop toggles so behaviour is predictable.
     useEffect(() => { startRef.current = null; }, [config.loop, config.durationMs]);
     useFrame((state) => {
@@ -57,6 +60,6 @@ const SparklesBurst = ({ config, boundingRadius }) => {
     });
     if (!config.enabled)
         return null;
-    return _jsx("mesh", { geometry: geometry, material: material, frustumCulled: false });
+    return _jsx("mesh", { ref: rootRef, geometry: geometry, material: material, frustumCulled: false });
 };
 export default SparklesBurst;

package/dist/components/Stars.d.ts

@@ -1,13 +1,12 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import { BufferGeometry } from 'three';
-import type { Object3D } from 'three';
 import React from "react";
 import type { CreatedObjectSettings } from "@3driseai/3drise-core";
 import type { TimeSettings } from "@3driseai/3drise-core";
-export interface StarsProps {
+export interface StarsProps extends ObjectReadyProps {
     settings: CreatedObjectSettings;
     timeSettings?: TimeSettings;
     sunSystemEnabled?: boolean;
-    onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void;
 }
 export declare function generateStarsGeometry(count: number): BufferGeometry;
 declare const Stars: React.FC<StarsProps>;

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

@@ -1 +1 @@
-{"version":3,"file":"Stars.d.ts","sourceRoot":"","sources":["../../src/components/Stars.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA4C,MAAM,OAAO,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC1E;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuDnE;AAYD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAwK/B,CAAC;AACF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Stars.d.ts","sourceRoot":"","sources":["../../src/components/Stars.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAA4C,MAAM,OAAO,CAAC;AAQjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IAChD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAuDnE;AAYD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAwK/B,CAAC;AACF,eAAe,KAAK,CAAC"}

package/dist/components/Stars.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useMemo, useCallback, useState, useEffect } from 'react';
 import { BufferGeometry, BufferAttribute, AdditiveBlending, Color } from 'three';
 import { useFrame } from '@react-three/fiber';
@@ -78,8 +79,9 @@ const DEFAULT_TIME_SETTINGS = {
     autoAnimate: false,
     syncWithRealTime: false,
 };
-const Stars = ({ settings, timeSettings, sunSystemEnabled = false, onObjectReady }) => {
+const Stars = ({ settings, timeSettings, sunSystemEnabled = false, onObjectReady, onObjectDispose }) => {
     const pointsRef = useRef(null);
+    useObjectReady(pointsRef, settings, onObjectReady, onObjectDispose);
     const materialRef = useRef(null);
     const { meshSettings, config, animations, mouseMove } = settings;
     const { position, rotation, scale, visible } = meshSettings;
@@ -102,7 +104,6 @@ const Stars = ({ settings, timeSettings, sunSystemEnabled = false, onObjectReady
     });
     const geometry = useMemo(() => generateStarsGeometry(count), [count]);
     useEffect(() => {
-        onObjectReady && onObjectReady(settings, pointsRef.current);
         return () => { geometry.dispose(); };
     }, [geometry]);
     useEffect(() => {

package/dist/components/Sun.d.ts

@@ -1,4 +1,5 @@
-type SunProps = {
+import type { ObjectReadyProps } from '../types/objectReady';
+type SunProps = ObjectReadyProps & {
     /** Radius of the sun core. Default 1. */
     radius?: number;
     /** Corona shell size relative to the core. Default 1.25. */
@@ -10,6 +11,6 @@ type SunProps = {
     /** Uniform overrides for SunFlareMaterial. */
     flareUniforms?: Record<string, any>;
 };
-export default function Sun({ radius, coronaScale, coreUniforms, coronaUniforms, flareUniforms, }: SunProps): import("react").JSX.Element;
+export default function Sun({ radius, coronaScale, coreUniforms, coronaUniforms, flareUniforms, onObjectReady, onObjectDispose, }: SunProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=Sun.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Sun.d.ts","sourceRoot":"","sources":["../../src/components/Sun.tsx"],"names":[],"mappings":"AAGA,KAAK,QAAQ,GAAG;IACZ,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,MAAU,EAAE,WAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,GAAG,EAAE,QAAQ,+BAErH"}
+{"version":3,"file":"Sun.d.ts","sourceRoot":"","sources":["../../src/components/Sun.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,KAAK,QAAQ,GAAG,gBAAgB,GAAG;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,MAAU,EAAE,WAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,QAAQ,+BAIrJ"}

package/dist/components/Sun.js

@@ -1,7 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 // import { ReactNode } from "react";
 import SunCore from "./SunCore.js";
-import Corona from "./Corona.js";
-export default function Sun({ radius = 1, coronaScale = 1.25, coreUniforms, coronaUniforms, flareUniforms, }) {
-    return (_jsxs("group", { children: [_jsx(SunCore, { radius: radius, uniforms: coreUniforms }), _jsx(Corona, { radius: radius, shellScale: coronaScale, uniforms: coronaUniforms }), _jsx("pointLight", { color: "#ffa544", intensity: 6, distance: 60, decay: 1.6 })] }));
+import Corona from "./effects/Corona.js";
+export default function Sun({ radius = 1, coronaScale = 1.25, coreUniforms, coronaUniforms, flareUniforms, onObjectReady, onObjectDispose, }) {
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, { radius, coronaScale }, onObjectReady, onObjectDispose);
+    return (_jsxs("group", { ref: rootRef, children: [_jsx(SunCore, { radius: radius, uniforms: coreUniforms }), _jsx(Corona, { radius: radius, shellScale: coronaScale, uniforms: coronaUniforms }), _jsx("pointLight", { color: "#ffa544", intensity: 6, distance: 60, decay: 1.6 })] }));
 }

package/dist/components/SunCore.d.ts

@@ -1,3 +1,4 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type * as THREE from "three";
 declare global {
     namespace JSX {
@@ -6,7 +7,7 @@ declare global {
         }
     }
 }
-export type SunCoreProps = {
+export type SunCoreProps = ObjectReadyProps & {
     /** Radius of the core. Default 1. */
     radius?: number;
     /** Self-rotation speed in rad/s. Default 0.02. */
@@ -14,5 +15,5 @@ export type SunCoreProps = {
     /** Uniform overrides for SunCoreMaterial (u_speed, u_cellScale, u_color1..5, ...). */
     uniforms?: Record<string, number | THREE.Vector3 | number[]>;
 };
-export default function SunCore({ radius, rotationSpeed, uniforms }: SunCoreProps): import("react").JSX.Element;
+export default function SunCore({ radius, rotationSpeed, uniforms, onObjectReady, onObjectDispose }: SunCoreProps): import("react").JSX.Element;
 //# sourceMappingURL=SunCore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SunCore.d.ts","sourceRoot":"","sources":["../../src/components/SunCore.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,eAAe,EAAE,GAAG,CAAC;SACxB;KACJ;CACJ;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,MAAU,EAAE,aAAoB,EAAE,QAAQ,EAAE,EAAE,YAAY,+BAU3F"}
+{"version":3,"file":"SunCore.d.ts","sourceRoot":"","sources":["../../src/components/SunCore.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,GAAG,CAAC;QACV,UAAU,iBAAiB;YACvB,eAAe,EAAE,GAAG,CAAC;SACxB;KACJ;CACJ;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC1C,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,MAAU,EAAE,aAAoB,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,YAAY,+BAW3H"}

package/dist/components/SunCore.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef } from "react";
 import { useFrame } from "@react-three/fiber";
-export default function SunCore({ radius = 1, rotationSpeed = 0.02, uniforms }) {
+export default function SunCore({ radius = 1, rotationSpeed = 0.02, uniforms, onObjectReady, onObjectDispose }) {
     const meshRef = useRef(null);
+    useObjectReady(meshRef, { radius, rotationSpeed, uniforms }, onObjectReady, onObjectDispose);
     // drei's shaderMaterial exposes each uniform as a property on the instance.
     const matRef = useRef(null);
     useFrame((_, delta) => {

package/dist/components/SunLight.d.ts

@@ -1,7 +1,8 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import * as THREE from 'three';
 import React from "react";
 import type { TimeSettings } from "@3driseai/3drise-core";
-export interface SunLightProps {
+export interface SunLightProps extends ObjectReadyProps {
     visible?: boolean;
     timeSettings: TimeSettings;
     targetPosition?: THREE.Vector3;

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

@@ -1 +1 @@
-{"version":3,"file":"SunLight.d.ts","sourceRoot":"","sources":["../../src/components/SunLight.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAaD,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAyCrC,CAAC;AACF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"SunLight.d.ts","sourceRoot":"","sources":["../../src/components/SunLight.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAaD,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0CrC,CAAC;AACF,eAAe,QAAQ,CAAC"}

package/dist/components/SunLight.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 { useSkySystem } from '../hooks/useSkySystem.js';
@@ -12,8 +13,9 @@ const SUNRISE = 6;
 const SUNSET = 21;
 const DARKNESS_START = 20.42;
 const DARKNESS_END = 6.58;
-const SunLight = ({ visible = true, timeSettings, targetPosition = new THREE.Vector3(0, 0, 0), shadowDistance = 300, intensity: intensityMultiplier = 1, castShadow = true, shadowMapSize = 2048, }) => {
+const SunLight = ({ visible = true, timeSettings, targetPosition = new THREE.Vector3(0, 0, 0), shadowDistance = 300, intensity: intensityMultiplier = 1, castShadow = true, shadowMapSize = 2048, onObjectReady, onObjectDispose, }) => {
     const lightRef = useRef(null);
+    useObjectReady(lightRef, { visible, timeSettings, intensity: intensityMultiplier, castShadow, shadowMapSize }, onObjectReady, onObjectDispose);
     const colorRef = useRef(new THREE.Color(0xffe5b0));
     const targetColorRef = useRef(new THREE.Color(0xffe5b0));
     const intensityRef = useRef(1);

package/dist/components/Text2D.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { TextSettings } from '@3driseai/3drise-core';
 import React from "react";
-export interface Text2DProps {
+export interface Text2DProps extends ObjectReadyProps {
     textSettings: TextSettings;
     onTextClick?: (textSettings: TextSettings) => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Text2D.d.ts","sourceRoot":"","sources":["../../src/components/Text2D.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAW;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;CACtD;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA+CjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Text2D.d.ts","sourceRoot":"","sources":["../../src/components/Text2D.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;CACtD;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAgDjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Text2D.js

@@ -1,12 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useState, useCallback, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import { Text, useCursor } from '@react-three/drei';
 import { createDefaultEffectState, applyTransformEffects } from '@3driseai/3drise-core';
 import { fontManager } from '@3driseai/3drise-core';
 import { getTextEffectProps } from '../utils/textEffects.js';
-const Text2D = ({ textSettings, onTextClick }) => {
+const Text2D = ({ textSettings, onTextClick, onObjectReady, onObjectDispose }) => {
     const groupRef = useRef(null);
+    useObjectReady(groupRef, textSettings, onObjectReady, onObjectDispose);
     const textRef = useRef(null);
     const [hovered, setHovered] = useState(false);
     const [clicked, setClicked] = useState(false);

package/dist/components/Text3D.d.ts

@@ -1,7 +1,8 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import type { TextSettings } from "@3driseai/3drise-core";
 import type { LetterData } from "./Letter";
-export interface Text3DProps {
+export interface Text3DProps extends ObjectReadyProps {
     textSettings: TextSettings;
     onLetterClick?: (letterData: LetterData) => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Text3D.d.ts","sourceRoot":"","sources":["../../src/components/Text3D.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,MAAM,WAAW,WAAW;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACpD;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAIjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Text3D.d.ts","sourceRoot":"","sources":["../../src/components/Text3D.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACpD;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAIjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Text3D.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import Letters from './Letters.js';
-const Text3D = ({ textSettings, onLetterClick }) => {
+const Text3D = ({ textSettings, onLetterClick, onObjectReady, onObjectDispose }) => {
     const { config, materialSettings } = textSettings;
     const { text } = config;
-    return (_jsx(Letters, { text: text, config: config, materialSettings: materialSettings, hoverSettings: { sensitivity: 0.5, applyToChildren: false }, transformEffects: textSettings.animations?.transform?.effects || [], onLetterClick: onLetterClick }));
+    return (_jsx(Letters, { text: text, config: config, materialSettings: materialSettings, hoverSettings: { sensitivity: 0.5, applyToChildren: false }, transformEffects: textSettings.animations?.transform?.effects || [], onLetterClick: onLetterClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
 };
 export default Text3D;

package/dist/components/VolumePoints.d.ts

@@ -1,7 +1,8 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { ReactNode } from "react";
 import type { BufferGeometry } from "three";
 import type { ThreeElements } from "@react-three/fiber";
-export interface VolumePointsProps extends Omit<ThreeElements['points'], 'geometry'> {
+export interface VolumePointsProps extends Omit<ThreeElements['points'], 'geometry'>, ObjectReadyProps {
     /** Any closed host geometry to fill with interior points. */
     geometry: BufferGeometry;
     /** Target number of interior points. */
@@ -15,5 +16,5 @@ export interface VolumePointsProps extends Omit<ThreeElements['points'], 'geomet
      */
     children?: ReactNode;
 }
-export declare function VolumePoints({ geometry, count, oversample, children, ...props }: VolumePointsProps): import("react").JSX.Element;
+export declare function VolumePoints({ geometry, count, oversample, children, onObjectReady, onObjectDispose, ...props }: VolumePointsProps): import("react").JSX.Element;
 //# sourceMappingURL=VolumePoints.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"VolumePoints.d.ts","sourceRoot":"","sources":["../../src/components/VolumePoints.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAChF,6DAA6D;IAC7D,QAAQ,EAAE,cAAc,CAAC;IACzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAGD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,+BAKzG"}
+{"version":3,"file":"VolumePoints.d.ts","sourceRoot":"","sources":["../../src/components/VolumePoints.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,EAAE,gBAAgB;IAClG,6DAA6D;IAC7D,QAAQ,EAAE,cAAc,CAAC;IACzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAGD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,+BAOzI"}

package/dist/components/VolumePoints.js

@@ -1,8 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useVolumePoints } from '../hooks/useVolumePoints.js';
-export function VolumePoints({ geometry, count = 8000, oversample, children, ...props }) {
+export function VolumePoints({ geometry, count = 8000, oversample, children, onObjectReady, onObjectDispose, ...props }) {
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, { count, oversample }, onObjectReady, onObjectDispose);
     const pointsGeometry = useVolumePoints(geometry, count, { oversample });
     if (!pointsGeometry)
         return null;
-    return (_jsx("points", { geometry: pointsGeometry, ...props, children: children ?? _jsx("pointsMaterial", { size: 0.02, sizeAttenuation: true }) }));
+    return (_jsx("points", { ref: rootRef, geometry: pointsGeometry, ...props, children: children ?? _jsx("pointsMaterial", { size: 0.02, sizeAttenuation: true }) }));
 }

package/dist/components/cursor/AuraCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuraCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/AuraCursor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAwB3D,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"AuraCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/AuraCursor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAyB3D,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/cursor/AuraCursor.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import AuraEffect from '../effects/AuraEffect.js';
-const AuraCursor = ({ config, worldPosRef, idleMsRef, }) => {
+const AuraCursor = ({ config, worldPosRef, idleMsRef, onObjectReady, onObjectDispose, }) => {
     const groupRef = useRef(null);
+    useObjectReady(groupRef, config, onObjectReady, onObjectDispose);
     const auraConfig = useMemo(() => ({
         enabled: true,
         intensity: config.intensity,

package/dist/components/cursor/AuroraCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuroraCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/AuroraCursor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAsE1D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAqI/D,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"AuroraCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/AuroraCursor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAsE1D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAuI/D,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/cursor/AuroraCursor.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { useEffect, useMemo, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import * as THREE from 'three';
@@ -70,7 +71,7 @@ const fragmentShader = /* glsl */ `
     gl_FragColor = vec4(aurora, alpha);
   }
 `;
-const AuroraCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
+const AuroraCursor = ({ config, worldPosRef, hoverRef, idleMsRef, onObjectReady, onObjectDispose, }) => {
     const N = Math.min(MAX_TRAIL, Math.max(4, config.trailLength));
     const { camera } = useThree();
     // History positions (newest at index 0, oldest at N-1)
@@ -132,6 +133,8 @@ const AuroraCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
     }, [config.color, config.opacity, config.flowSpeed, material]);
     useEffect(() => () => { geometry.dispose(); material.dispose(); }, [geometry, material]);
     const firstFrame = useRef(true);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const tmpTangent = useMemo(() => new THREE.Vector3(), []);
     const tmpToCam = useMemo(() => new THREE.Vector3(), []);
     const tmpSide = useMemo(() => new THREE.Vector3(), []);
@@ -202,6 +205,6 @@ const AuroraCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
         geometry.attributes.aT.needsUpdate = true;
         geometry.setDrawRange(0, (N - 1) * 6);
     });
-    return _jsx("mesh", { geometry: geometry, material: material, frustumCulled: false });
+    return _jsx("mesh", { ref: rootRef, geometry: geometry, material: material, frustumCulled: false });
 };
 export default AuroraCursor;

package/dist/components/cursor/BubblesCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BubblesCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/BubblesCursor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA6E1D,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAuGjE,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"BubblesCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/BubblesCursor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA6E1D,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAyGjE,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/cursor/BubblesCursor.js

@@ -1,4 +1,5 @@
 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';
@@ -77,7 +78,7 @@ const pointsFragmentShader = /* glsl */ `
     gl_FragColor = vec4(col * (1.0 + spec + popFlash), alpha);
   }
 `;
-const BubblesCursor = ({ config, worldPosRef, velocityRef, hoverRef, idleMsRef, }) => {
+const BubblesCursor = ({ config, worldPosRef, velocityRef, hoverRef, idleMsRef, 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), []);
@@ -119,6 +120,8 @@ const BubblesCursor = ({ config, worldPosRef, velocityRef, hoverRef, idleMsRef,
     }, [config.color, config.scale, config.opacity, config.iridescence, material]);
     useEffect(() => () => { geometry.dispose(); material.dispose(); }, [geometry, material]);
     const spawnAccum = useRef(0);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const startTime = useRef(0);
     useFrame((state, delta) => {
         material.uniforms.uTime.value = state.clock.getElapsedTime();
@@ -179,6 +182,6 @@ const BubblesCursor = ({ config, worldPosRef, velocityRef, hoverRef, idleMsRef,
         geometry.attributes.aBaseSize.needsUpdate = true;
         geometry.attributes.aPhase.needsUpdate = true;
     });
-    return _jsx("points", { geometry: geometry, material: material, frustumCulled: false });
+    return _jsx("points", { ref: rootRef, geometry: geometry, material: material, frustumCulled: false });
 };
 export default BubblesCursor;

package/dist/components/cursor/CometCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CometCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CometCursor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA2D1D,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAgI7D,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"CometCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CometCursor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA2D1D,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAqI7D,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/cursor/CometCursor.js

@@ -1,4 +1,5 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } 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';
@@ -59,8 +60,10 @@ const impactVert = /* glsl */ `
     gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
   }
 `;
-const CometCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
+const CometCursor = ({ config, worldPosRef, hoverRef, idleMsRef, onObjectReady, onObjectDispose, }) => {
     // Packed newest-first layout: slot 0 = newest, slot count-1 = oldest.
+    const ref = useRef(null);
+    useObjectReady(ref, config, onObjectReady, onObjectDispose);
     const positions = useMemo(() => new Float32Array(MAX_TRAIL * 3), []);
     const indices = useMemo(() => {
         const arr = new Float32Array(MAX_TRAIL);
@@ -186,6 +189,6 @@ const CometCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
             impact.visible = impactOpacity.current > 0.005;
         }
     });
-    return (_jsxs(_Fragment, { children: [_jsx("points", { geometry: geometry, material: material, frustumCulled: false }), _jsx("mesh", { ref: impactRef, geometry: impactGeom, material: impactMat, visible: false })] }));
+    return (_jsxs("group", { ref: ref, children: [_jsx("points", { geometry: geometry, material: material, frustumCulled: false }), _jsx("mesh", { ref: impactRef, geometry: impactGeom, material: impactMat, visible: false })] }));
 };
 export default CometCursor;

package/dist/components/cursor/CrosshairCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrosshairCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CrosshairCursor.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAe1D,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,qBAAqB,CAAC,CA2HrE,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"CrosshairCursor.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CrosshairCursor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAe1D,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAqIrE,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/cursor/CrosshairCursor.js

@@ -1,4 +1,5 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } 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';
@@ -15,8 +16,10 @@ function hasValidPositions(geo) {
     }
     return true;
 }
-const CrosshairCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
+const CrosshairCursor = ({ config, worldPosRef, hoverRef, idleMsRef, onObjectReady, onObjectDispose, }) => {
     // Billboarded reticle group (ring + ticks)
+    const ref = useRef(null);
+    useObjectReady(ref, config, onObjectReady, onObjectDispose);
     const reticleRef = useRef(null);
     const ringRef = useRef(null);
     // World-space outline group (NOT billboarded) for the hovered object outline
@@ -137,6 +140,6 @@ const CrosshairCursor = ({ config, worldPosRef, hoverRef, idleMsRef, }) => {
         ringMat.opacity = config.opacity * (0.4 + 0.6 * idleFactor);
         tickMat.opacity = config.opacity * (0.4 + 0.6 * idleFactor);
     });
-    return (_jsxs(_Fragment, { children: [_jsxs("group", { ref: reticleRef, children: [_jsx("mesh", { ref: ringRef, geometry: ringGeom, material: ringMat }), _jsx("lineSegments", { geometry: tickGeom, material: tickMat })] }), _jsx("group", { ref: outlineGroupRef, children: _jsx("lineSegments", { ref: outlineRef, material: outlineMat, visible: false }) })] }));
+    return (_jsxs("group", { ref: ref, children: [_jsxs("group", { ref: reticleRef, children: [_jsx("mesh", { ref: ringRef, geometry: ringGeom, material: ringMat }), _jsx("lineSegments", { geometry: tickGeom, material: tickMat })] }), _jsx("group", { ref: outlineGroupRef, children: _jsx("lineSegments", { ref: outlineRef, material: outlineMat, visible: false }) })] }));
 };
 export default CrosshairCursor;

package/dist/components/cursor/CursorActions.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../../types/objectReady';
 import React from 'react';
 import type { ClickActionConfig } from "@3driseai/3drise-core";
-export interface CursorActionsProps {
+export interface CursorActionsProps extends ObjectReadyProps {
     clickActions?: ClickActionConfig[];
 }
 declare const CursorActions: React.FC<CursorActionsProps>;

package/dist/components/cursor/CursorActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CursorActions.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorActions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAYjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,MAAM,WAAW,kBAAkB;IAC/B,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAWD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAqG/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"CursorActions.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAA4B,MAAM,OAAO,CAAC;AAYjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAWD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAsG/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/cursor/CursorActions.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 import React, { useEffect, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import * as THREE from 'three';
@@ -19,12 +20,13 @@ const CLICK_PLANE_DISTANCE = 8;
 // orthographic (no fov) as a sensible fallback.
 const ORTHO_FALLBACK_HALF_HEIGHT = CLICK_PLANE_DISTANCE * 0.5;
 let clickIdCounter = 0;
-const CursorActions = ({ clickActions = [] }) => {
+const CursorActions = ({ clickActions = [], onObjectReady, onObjectDispose }) => {
     const { camera, gl } = useThree();
     // Group that mirrors the camera each frame so any child rendered inside it
     // appears at a fixed offset from the camera in world space — i.e., as if it
     // were a 2D HUD overlay anchored to the screen.
     const followGroupRef = useRef(null);
+    useObjectReady(followGroupRef, clickActions, onObjectReady, onObjectDispose);
     // Pending one-shot click action instances. Each entry maps to one rendered
     // child that self-disposes via onDone.
     const [pendingClicks, setPendingClicks] = React.useState([]);
@@ -99,23 +101,23 @@ const CursorActions = ({ clickActions = [] }) => {
             // position in screen-anchored space.
             switch (ca.type) {
                 case 'shockwave':
-                    return _jsx(ShockwaveAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(ShockwaveAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'sparklesBurst':
-                    return _jsx(SparklesBurstAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(SparklesBurstAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'boltFlash':
-                    return _jsx(BoltFlashAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(BoltFlashAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'plasmaBomb':
-                    return _jsx(PlasmaBombAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(PlasmaBombAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'realityTear':
-                    return _jsx(RealityTearAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(RealityTearAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'implosion':
-                    return _jsx(ImplosionAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(ImplosionAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'voronoiFracture':
-                    return _jsx(VoronoiFractureAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(VoronoiFractureAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'phaseShift':
-                    return _jsx(PhaseShiftAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(PhaseShiftAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 case 'glyphInscription':
-                    return _jsx(GlyphInscriptionAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id) }, pc.id);
+                    return _jsx(GlyphInscriptionAction, { worldPos: pc.localPos, config: ca, onDone: () => removeClick(pc.id), onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, pc.id);
                 default:
                     return null;
             }

package/dist/components/cursor/CursorController.d.ts

@@ -1,7 +1,8 @@
+import type { ObjectReadyProps } from '../../types/objectReady';
 import React from "react";
 import type { CursorConfig, ClickActionConfig } from "@3driseai/3drise-core";
 export type { CursorTypeProps } from './CursorEffects';
-export interface CursorControllerProps {
+export interface CursorControllerProps extends ObjectReadyProps {
     effects?: CursorConfig[];
     clickActions?: ClickActionConfig[];
 }

package/dist/components/cursor/CursorController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CursorController.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorController.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAqI,CAAC;AAC5L,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"CursorController.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorController.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC3D,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAAqS,CAAC;AAC5V,eAAe,gBAAgB,CAAC"}

package/dist/components/cursor/CursorController.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import CursorEffects from './CursorEffects.js';
 import CursorActions from './CursorActions.js';
-const CursorController = ({ effects = [], clickActions = [], }) => (_jsxs(_Fragment, { children: [_jsx(CursorEffects, { effects: effects }), _jsx(CursorActions, { clickActions: clickActions })] }));
+const CursorController = ({ effects = [], clickActions = [], onObjectReady, onObjectDispose, }) => (_jsxs(_Fragment, { children: [_jsx(CursorEffects, { effects: effects, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }), _jsx(CursorActions, { clickActions: clickActions, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }));
 export default CursorController;

package/dist/components/cursor/CursorEffects.d.ts

@@ -1,14 +1,15 @@
+import type { ObjectReadyProps } from '../../types/objectReady';
 import * as THREE from 'three';
 import React from "react";
 import type { CursorConfig } from "@3driseai/3drise-core";
-export interface CursorTypeProps<C extends CursorConfig = CursorConfig> {
+export interface CursorTypeProps<C extends CursorConfig = CursorConfig> extends ObjectReadyProps {
     config: C;
     worldPosRef: React.RefObject<THREE.Vector3>;
     velocityRef: React.RefObject<THREE.Vector3>;
     hoverRef: React.RefObject<THREE.Intersection | null>;
     idleMsRef: React.RefObject<number>;
 }
-export interface CursorEffectsProps {
+export interface CursorEffectsProps extends ObjectReadyProps {
     effects?: CursorConfig[];
 }
 declare const CursorEffects: React.FC<CursorEffectsProps>;

package/dist/components/cursor/CursorEffects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CursorEffects.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorEffects.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAClE,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAWD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAkF/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"CursorEffects.d.ts","sourceRoot":"","sources":["../../../src/components/cursor/CursorEffects.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,gBAAgB;IAC5F,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAWD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAoF/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/cursor/CursorEffects.js

@@ -24,7 +24,7 @@ const createTickState = () => ({
     idleMsRef: { current: 0 },
     firstFrameRef: { current: true },
 });
-const CursorEffects = ({ effects = [] }) => {
+const CursorEffects = ({ effects = [], onObjectReady, onObjectDispose }) => {
     const { camera, gl, scene, raycaster, pointer } = useThree();
     // Per-effect ref bundles. Indexed by effect position. Grows/shrinks as the
     // effects array length changes, but individual entries are stable so the
@@ -83,6 +83,8 @@ const CursorEffects = ({ effects = [] }) => {
         if (!s)
             return null;
         const shared = {
+            onObjectReady,
+            onObjectDispose,
             worldPosRef: s.worldPosRef,
             velocityRef: s.velocityRef,
             hoverRef: s.hoverRef,