@3driseai/3drise-viewer 0.1.1 → 0.1.3

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

@@ -1 +1 @@
-{"version":3,"file":"SkySystem.d.ts","sourceRoot":"","sources":["../../src/components/SkySystem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMnJ,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAGD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,yBAAyB,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAiCjG,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"SkySystem.d.ts","sourceRoot":"","sources":["../../src/components/SkySystem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMnJ,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAC1C,qBAAqB,CAAC,EAAE,WAAW,CAAC;IACpC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAGD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,yBAAyB,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAoCjG,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/components/SkySystem.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 { useEffect, useLayoutEffect, useRef, forwardRef, useImperativeHandle } from 'react';
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
@@ -8,8 +9,11 @@ import Lensflare from './Lensflare.js';
 import SunLight from './SunLight.js';
 import SkyController from './SkyController.js';
 import SceneFog from './SceneFog.js';
-const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible = false, sunSize = 1, moonSize = 1, skyboxScale = 1000, sunIntensity = 1, castShadow = true, shadowMapSize = 2048, playerPosition = new THREE.Vector3(0, 0, 0), starsSettings, cloudsSettings, cloudsMaterialSettings, skyControllerSettings, rainSettings, fogSettings, onTimeOfDayChange, onTimeUpdate, }, ref) => {
+const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible = false, sunSize = 1, moonSize = 1, skyboxScale = 1000, sunIntensity = 1, castShadow = true, shadowMapSize = 2048, playerPosition = new THREE.Vector3(0, 0, 0), starsSettings, cloudsSettings, cloudsMaterialSettings, skyControllerSettings, rainSettings, fogSettings, onTimeOfDayChange, onTimeUpdate, onObjectReady, onObjectDispose, }, ref) => {
     const previousTimeOfDayRef = useRef(null);
+    const rootRef = useRef(null);
+    const ready = { onObjectReady, onObjectDispose };
+    useObjectReady(rootRef, { timeSettings, sunSystemVisible, skyboxScale, sunIntensity, skyControllerSettings, fogSettings }, onObjectReady, onObjectDispose);
     useImperativeHandle(ref, () => ({
         setTime: (h, m) => skySystemManager.setTime(h, m),
         getTime: () => skySystemManager.getTime(),
@@ -40,7 +44,7 @@ const SkySystem = forwardRef(({ timeSettings, visible = true, sunSystemVisible =
     });
     if (!visible)
         return null;
-    return (_jsxs("group", { children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale })), sunSystemVisible && (_jsxs(_Fragment, { children: [_jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings }), _jsx(Lensflare, { visible: true, intensity: sunIntensity, timeSettings: timeSettings }), _jsx(SunLight, { visible: true, timeSettings: timeSettings, targetPosition: playerPosition, intensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize })] })), fogSettings && (_jsx(SceneFog, { fog: fogSettings }))] }));
+    return (_jsxs("group", { ref: rootRef, children: [skyControllerSettings && !sunSystemVisible && (_jsx(SkyController, { settings: skyControllerSettings, timeSettings: timeSettings, scale: skyboxScale, ...ready })), sunSystemVisible && (_jsxs(_Fragment, { children: [_jsx(Skybox, { visible: true, scale: skyboxScale, sunSize: sunSize, moonSize: moonSize, timeSettings: timeSettings, ...ready }), _jsx(Lensflare, { visible: true, intensity: sunIntensity, timeSettings: timeSettings, ...ready }), _jsx(SunLight, { visible: true, timeSettings: timeSettings, targetPosition: playerPosition, intensity: sunIntensity, castShadow: castShadow, shadowMapSize: shadowMapSize, ...ready })] })), fogSettings && (_jsx(SceneFog, { fog: fogSettings }))] }));
 });
 SkySystem.displayName = 'SkySystem';
 export default SkySystem;

package/dist/components/Skybox.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { TimeSettings } from '@3driseai/3drise-core';
 import React from "react";
-export interface SkyboxProps {
+export interface SkyboxProps extends ObjectReadyProps {
     visible?: boolean;
     scale?: number;
     sunSize?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"Skybox.d.ts","sourceRoot":"","sources":["../../src/components/Skybox.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAkDD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAoCjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Skybox.d.ts","sourceRoot":"","sources":["../../src/components/Skybox.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAkDD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAsCjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Skybox.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useCallback, useEffect } from 'react';
 import * as THREE from 'three';
 import { useSkySystem } from '../hooks/useSkySystem.js';
@@ -52,8 +53,10 @@ function sampleSkyKeyframes(timeInHours, outHorizon, outHigh, outSun) {
     outHigh.copy(last.high);
     outSun.copy(last.sun);
 }
-const Skybox = ({ visible = true, scale = 100000, sunSize = 1, moonSize = 1, timeSettings, }) => {
+const Skybox = ({ visible = true, scale = 100000, sunSize = 1, moonSize = 1, timeSettings, onObjectReady, onObjectDispose, }) => {
     const materialRef = useRef(null);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, { visible, scale, sunSize, moonSize, timeSettings }, onObjectReady, onObjectDispose);
     const sunColorRef = useRef(new THREE.Color(0xffe5b0));
     const skyColorLowRef = useRef(new THREE.Color(0x6fa2ef));
     const skyColorHighRef = useRef(new THREE.Color(0x2053ff));
@@ -87,6 +90,6 @@ const Skybox = ({ visible = true, scale = 100000, sunSize = 1, moonSize = 1, tim
     if (!visible)
         return null;
     // console.log(sunSize)
-    return (_jsxs("mesh", { scale: scale, children: [_jsx("boxGeometry", { args: [1, 1, 1] }), _jsx("skyboxMaterial", { ref: materialRef, side: THREE.BackSide, depthWrite: false, fog: false })] }));
+    return (_jsxs("mesh", { ref: rootRef, scale: scale, children: [_jsx("boxGeometry", { args: [1, 1, 1] }), _jsx("skyboxMaterial", { ref: materialRef, side: THREE.BackSide, depthWrite: false, fog: false })] }));
 };
 export default Skybox;

package/dist/components/SolarSystem.d.ts

@@ -1,8 +1,6 @@
-import type { Group } from 'three';
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import { SolarSystemConfig } from "@3driseai/3drise-core";
-declare const SolarSystem: React.FC<SolarSystemConfig & {
-    onObjectReady?: (ref: Group) => void;
-}>;
+declare const SolarSystem: React.FC<SolarSystemConfig & ObjectReadyProps>;
 export default SolarSystem;
 //# sourceMappingURL=SolarSystem.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SolarSystem.d.ts","sourceRoot":"","sources":["../../src/components/SolarSystem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAKnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAiD1D,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG;IACpC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC,CAoBR,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"SolarSystem.d.ts","sourceRoot":"","sources":["../../src/components/SolarSystem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAiD1D,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAqB/D,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/components/SolarSystem.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, useState, useCallback } from 'react';
 import { BufferGeometry, BufferAttribute, Vector3 } from 'three';
 import { useFrame } from '@react-three/fiber';
@@ -52,10 +53,11 @@ const OrbitedBody = ({ orbitRadius, orbitSpeed, spinSpeed, axialTilt, enableOrbi
     });
     return (_jsx("group", { ref: orbitRef, "rotation-y": initialPhase, children: _jsx("group", { position: [orbitRadius, 0, 0], "rotation-z": axialTilt, children: _jsx("group", { ref: spinRef, children: children }) }) }));
 };
-const SolarSystem = ({ enableOrbit = true, enableSelfRotation = true, showOrbitRings = true, orbitSpeedMultiplier = 1, sunColor = '#ffd27a', sunRadius = 8, sunIntensity = 3, orbitRingColor = '#444444', orbitRingOpacity = 0.35, }) => {
+const SolarSystem = ({ enableOrbit = true, enableSelfRotation = true, showOrbitRings = true, orbitSpeedMultiplier = 1, sunColor = '#ffd27a', sunRadius = 8, sunIntensity = 3, orbitRingColor = '#444444', orbitRingOpacity = 0.35, onObjectReady, onObjectDispose, }) => {
     const [earthSunPos, setEarthSunPos] = useState([1, 0, 0]);
     const lastEarthSyncRef = useRef(0);
     const ref = useRef(null);
+    useObjectReady(ref, { enableOrbit, enableSelfRotation, showOrbitRings, orbitSpeedMultiplier, sunColor, sunRadius, sunIntensity, orbitRingColor, orbitRingOpacity }, onObjectReady, onObjectDispose);
     const handleEarthWorld = useCallback((p) => {
         const now = performance.now();
         if (now - lastEarthSyncRef.current < 100)

package/dist/components/SparklesBurst.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"SparklesBurst.d.ts","sourceRoot":"","sources":["../../src/components/SparklesBurst.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAuD/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"SparklesBurst.d.ts","sourceRoot":"","sources":["../../src/components/SparklesBurst.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAyD/C,CAAC;AACF,eAAe,aAAa,CAAC"}

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;