@3driseai/3drise-viewer 0.1.2 → 0.1.3

package/dist/components/Galaxy.d.ts

@@ -1,9 +1,8 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import type { CreatedObjectSettings } from "@3driseai/3drise-core";
-import { Object3D } from "three";
-export interface GalaxyProps {
+export interface GalaxyProps extends ObjectReadyProps {
     createdObject: CreatedObjectSettings;
-    onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void;
 }
 declare const Galaxy: React.FC<GalaxyProps>;
 export default Galaxy;

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

@@ -1 +1 @@
-{"version":3,"file":"Galaxy.d.ts","sourceRoot":"","sources":["../../src/components/Galaxy.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,MAAM,WAAW,WAAW;IACxB,aAAa,EAAE,qBAAqB,CAAC;IACrC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC1E;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAsBjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Galaxy.d.ts","sourceRoot":"","sources":["../../src/components/Galaxy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,aAAa,EAAE,qBAAqB,CAAC;CACxC;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAwBjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Galaxy.js

@@ -3,25 +3,25 @@ import Stars from './Stars.js';
 import Earth from './Earth.js';
 import SolarSystem from './SolarSystem.js';
 import ShootingStars from './ShootingStars.js';
-const Galaxy = ({ createdObject, onObjectReady }) => {
+const Galaxy = ({ createdObject, onObjectReady, onObjectDispose }) => {
     const config = createdObject.config;
-    console.log('Galaxy config:', config);
+    // Whatever Galaxy renders, the scene above it knows this object by its
+    // createdObject — so relabel each child's report rather than letting the
+    // child's own settings surface.
+    const reportReady = (_object, ref) => onObjectReady && onObjectReady(createdObject, ref);
+    const reportDispose = (_object, ref) => onObjectDispose && onObjectDispose(createdObject, ref);
     if (!config)
         return null;
-    const starsSettings = config.stars;
-    const earthSettings = config.earth;
-    const solarSystemSettings = config.solarSystem;
-    const shootingStarsSettings = config.shootingStars;
     // const timeSettings = config.time as TimeSettings | undefined;
     switch (config.type) {
         case 'stars':
-            return _jsx(Stars, { settings: createdObject, onObjectReady: onObjectReady });
+            return _jsx(Stars, { settings: createdObject, onObjectReady: reportReady, onObjectDispose: reportDispose });
         case 'earth':
-            return _jsx(Earth, { ...config, onMeshReady: (mesh) => onObjectReady && onObjectReady(createdObject, mesh) });
+            return _jsx(Earth, { ...config, onObjectReady: reportReady, onObjectDispose: reportDispose });
         case 'solarSystem':
-            return _jsx(SolarSystem, { ...config, onObjectReady: group => onObjectReady && onObjectReady(createdObject, group) });
+            return _jsx(SolarSystem, { ...config, onObjectReady: reportReady, onObjectDispose: reportDispose });
         case 'shootingStars':
-            return _jsx(ShootingStars, { settings: config });
+            return _jsx(ShootingStars, { settings: config, onObjectReady: reportReady, onObjectDispose: reportDispose });
         default:
             return null;
     }

package/dist/components/GalleryLayout.d.ts

@@ -1,8 +1,9 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { CreatedObjectSettings } from '@3driseai/3drise-core';
 import React from "react";
 import { Object3D } from "three";
 import { type ThreeEvent } from "@react-three/fiber";
-export interface GalleryLayoutProps {
+export interface GalleryLayoutProps extends ObjectReadyProps {
     createdObject: CreatedObjectSettings;
     selectedFrameUrl?: string;
     handleObjectClick?: (createdObject: CreatedObjectSettings, ref: Object3D, event: ThreeEvent<MouseEvent>) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"GalleryLayout.d.ts","sourceRoot":"","sources":["../../src/components/GalleryLayout.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,qBAAqB,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAa/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"GalleryLayout.d.ts","sourceRoot":"","sources":["../../src/components/GalleryLayout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,aAAa,EAAE,qBAAqB,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CACpH;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAc/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/GalleryLayout.js

@@ -1,10 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useMemo, useRef } from 'react';
 import { updateCurrentLayoutSettings } from '@3driseai/3drise-core';
 import Frame from './Frame.js';
 import { ImageGeometry } from './ImageGeometry.js';
-const GalleryLayout = ({ createdObject, selectedFrameUrl, handleObjectClick, }) => {
+const GalleryLayout = ({ createdObject, selectedFrameUrl, handleObjectClick, onObjectReady, onObjectDispose, }) => {
     const groupRef = useRef(null);
+    useObjectReady(groupRef, createdObject, onObjectReady, onObjectDispose);
     console.log('GalleryLayout - createdObject:', createdObject);
     const { config, materialSettings, animations } = createdObject;
     const galleryLayout = config || {

package/dist/components/GeometryShape.d.ts

@@ -1,3 +1,4 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { ReactNode } from 'react';
 import type { BufferGeometry } from 'three';
 import type { GeometryShapeConfig, MaterialSettings, ModeConfig, ObjectAnimations } from "@3driseai/3drise-core";
@@ -15,7 +16,7 @@ type ModeData = {
     positions: Float32Array;
     segments: Pt[];
 };
-export interface GeometryMeshProps {
+export interface GeometryMeshProps extends ObjectReadyProps {
     config: GeometryShapeConfig;
     modeConfig?: ModeConfig;
     materialSettings: MaterialSettings;
@@ -41,7 +42,7 @@ export declare function plexus(geo: BufferGeometry, count: number, radiusMul: nu
     segments: Pt[];
 };
 export declare function computeMode(geo: BufferGeometry, c: ModeConfig): ModeData;
-export declare function GeometryMesh({ config, materialSettings, animations, modeConfig, color, children }: GeometryMeshProps): import("react").JSX.Element;
+export declare function GeometryMesh({ config, materialSettings, animations, modeConfig, color, children, onObjectReady, onObjectDispose }: GeometryMeshProps): import("react").JSX.Element;
 export declare function FitGroup({ geometry, radius, children }: {
     geometry: BufferGeometry;
     radius?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"GeometryShape.d.ts","sourceRoot":"","sources":["../../src/components/GeometryShape.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"GeometryShape.d.ts","sourceRoot":"","sources":["../../src/components/GeometryShape.tsx"],"names":[],"mappings":"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"}

package/dist/components/GeometryShape.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useMemo } from 'react';
+import { useEffect, useMemo, useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { EdgesGeometry, WireframeGeometry, Mesh, MeshBasicMaterial, Raycaster, Vector3, DoubleSide, } from 'three';
 import { Line } from '@react-three/drei';
 import { shapeGenerators } from '../utils/shapes.js';
@@ -301,18 +302,28 @@ function useModeData(geometry, config) {
     const key = [safeConfig.mode, safeConfig.count, safeConfig.symmetry, safeConfig.spacing, safeConfig.slices, safeConfig.linkRadius, safeConfig.angle].join('|');
     return useMemo(() => computeMode(geometry, safeConfig), [geometry, key]); // eslint-disable-line react-hooks/exhaustive-deps
 }
-export function GeometryMesh({ config, materialSettings, animations, modeConfig = defaultModeConfig, color = '#ffffff', children }) {
+export function GeometryMesh({ config, materialSettings, animations, modeConfig = defaultModeConfig, color = '#ffffff', children, onObjectReady, onObjectDispose }) {
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    // The points branch delegates to PointCloud, which owns and reports its own
+    // <points>; relabel so it still surfaces as this geometry's config.
+    const reportReady = (_object, ref) => onObjectReady && onObjectReady(config, ref);
+    const reportDispose = (_object, ref) => onObjectDispose && onObjectDispose(config, ref);
+    console.log({
+        config,
+        modeConfig,
+    });
     const geometry = useShapeGeometry(config);
     const safeModeConfig = normalizeModeConfig(modeConfig);
     const data = useModeData(geometry, safeModeConfig);
     // if (data.kind === 'points') return <PointCloud positions={data.positions} color={color} size={modeConfig.mode === 'vertices' ? 0.035 : 0.02} />;
     if (data.kind === 'points')
-        return _jsx(PointCloud, { positions: data.positions, animations: animations, materialSettings: materialSettings });
+        return _jsx(PointCloud, { positions: data.positions, animations: animations, materialSettings: materialSettings, onObjectReady: reportReady, onObjectDispose: reportDispose });
     if (data.kind === 'lines')
-        return data.points.length ? _jsx(Line, { points: data.points, segments: true, color: color, lineWidth: safeModeConfig.lineWidth }) : null;
+        return data.points.length ? _jsx(Line, { ref: rootRef, points: data.points, segments: true, color: color, lineWidth: safeModeConfig.lineWidth }) : null;
     if (data.kind === 'plexus')
-        return (_jsxs("group", { children: [_jsx(PointCloud, { positions: data.positions, animations: animations, materialSettings: materialSettings }), data.segments.length > 0 && _jsx(Line, { points: data.segments, segments: true, color: color, lineWidth: safeModeConfig.lineWidth, transparent: true, opacity: 0.45 })] }));
-    return (_jsx("mesh", { geometry: geometry, children: children ?? _jsx("meshPhongMaterial", { color: color, side: DoubleSide }) }));
+        return (_jsxs("group", { ref: rootRef, children: [_jsx(PointCloud, { positions: data.positions, animations: animations, materialSettings: materialSettings }), data.segments.length > 0 && _jsx(Line, { points: data.segments, segments: true, color: color, lineWidth: safeModeConfig.lineWidth, transparent: true, opacity: 0.45 })] }));
+    return (_jsx("mesh", { ref: rootRef, geometry: geometry, children: children ?? _jsx("meshPhongMaterial", { color: color, side: DoubleSide }) }));
 }
 export function FitGroup({ geometry, radius = 1.7, children }) {
     const { scale, position } = useMemo(() => {

package/dist/components/Glyphs.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"Glyphs.d.ts","sourceRoot":"","sources":["../../src/components/Glyphs.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAmDjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Glyphs.d.ts","sourceRoot":"","sources":["../../src/components/Glyphs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAGD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAqDjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Glyphs.js

@@ -1,9 +1,13 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { GlyphRingMaterial } from '@3driseai/3drise-core';
-const Glyphs = ({ config, boundingRadius }) => {
+const Glyphs = ({ config, boundingRadius, onObjectReady, onObjectDispose }) => {
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // The ring sits at r=0.55 within UV space, so the plane must span 2 * ringRadius / 0.55
     // for the ring's outer edge to land at the configured `ringRadius` in world units.
     const planeSize = useMemo(() => {
@@ -53,6 +57,6 @@ const Glyphs = ({ 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 Glyphs;

package/dist/components/GridHelper.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import * as THREE from 'three';
 import React from "react";
-export interface GridHelperProps {
+export interface GridHelperProps extends ObjectReadyProps {
     cellSize?: number;
     cellThickness?: number;
     cellColor?: THREE.ColorRepresentation;

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

@@ -1 +1 @@
-{"version":3,"file":"GridHelper.d.ts","sourceRoot":"","sources":["../../src/components/GridHelper.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAcD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmBzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"GridHelper.d.ts","sourceRoot":"","sources":["../../src/components/GridHelper.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAcD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAoBzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/GridHelper.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useMemo } from 'react';
 import { Grid } from '@react-three/drei';
 import * as THREE from 'three';
@@ -13,8 +14,9 @@ const cleanColor = (color) => {
     }
     return color;
 };
-const GridHelper = ({ cellSize = 1, cellThickness = 1, cellColor = '#000000', sectionSize = 10, sectionThickness = 1.5, sectionColor = '#000000', followCamera = false, infiniteGrid = true, fadeDistance = 30, fadeStrength = 1, fadeFrom = 0, side = THREE.DoubleSide, position = [0, 0, 0], rotation = [0, 0, 0], visible = true, device = 'desktop', }) => {
+const GridHelper = ({ cellSize = 1, cellThickness = 1, cellColor = '#000000', sectionSize = 10, sectionThickness = 1.5, sectionColor = '#000000', followCamera = false, infiniteGrid = true, fadeDistance = 30, fadeStrength = 1, fadeFrom = 0, side = THREE.DoubleSide, position = [0, 0, 0], rotation = [0, 0, 0], visible = true, device = 'desktop', onObjectReady, onObjectDispose, }) => {
     const gridRef = useRef(null);
+    useObjectReady(gridRef, { cellSize, sectionSize, position, rotation, visible, device }, onObjectReady, onObjectDispose);
     const targetY = useRef(position[1]);
     const responsiveScale = useMemo(() => {
         if (device === 'mobile')

package/dist/components/GridsGenerator.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import React from "react";
 import type { GridConfig, MyGridConfig } from "@3driseai/3drise-core";
-type GridGeneratorProps = {
+type GridGeneratorProps = ObjectReadyProps & {
     config: (GridConfig | MyGridConfig) & {
         type: string;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"GridsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/GridsGenerator.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,KAAK,kBAAkB,GAAG;IACtB,MAAM,EAAE,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG;QAClC,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;CACL,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAS/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"GridsGenerator.d.ts","sourceRoot":"","sources":["../../src/components/GridsGenerator.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACtE,KAAK,kBAAkB,GAAG,gBAAgB,GAAG;IACzC,MAAM,EAAE,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG;QAClC,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;CACL,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAe/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/GridsGenerator.js

@@ -1,14 +1,22 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import GridHelper from "./GridHelper.js";
 import { MyGrid } from "./MyGrid.js";
-const GridGenerator = ({ config }) => {
+const GridGenerator = ({ config, onObjectReady, onObjectDispose }) => {
+    // The other two branches render components that report themselves; the
+    // native <gridHelper> is a plain three object, so this component holds its
+    // ref and reports on its behalf. The ref stays null on the other branches,
+    // which the hook treats as nothing to report.
+    const nativeGridRef = useRef(null);
+    useObjectReady(nativeGridRef, config, onObjectReady, onObjectDispose);
     switch (config.type) {
         case "basic":
-            return _jsx(GridHelper, { ...config, side: 2 });
+            return _jsx(GridHelper, { ...config, side: 2, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         case "superGrid":
-            return _jsx(MyGrid, { config: config });
+            return _jsx(MyGrid, { config: config, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         default:
-            return _jsx("gridHelper", { ...config });
+            return _jsx("gridHelper", { ...config, ref: nativeGridRef });
     }
 };
 export default GridGenerator;

package/dist/components/HdrPlaylistRenderer.d.ts

@@ -1,5 +1,6 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { HdrTransitionSettings } from "@3driseai/3drise-core";
-export interface HdrPlaylistRendererProps {
+export interface HdrPlaylistRendererProps extends ObjectReadyProps {
     /** Two or more equirect HDR URLs to cycle through. Caller ensures length >= 2. */
     urls: string[];
     /** Fully resolved transition settings (defaults already merged). */

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

@@ -1 +1 @@
-{"version":3,"file":"HdrPlaylistRenderer.d.ts","sourceRoot":"","sources":["../../src/components/HdrPlaylistRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,MAAM,WAAW,wBAAwB;IACrC,kFAAkF;IAClF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,qBAAqB,CAAC;CACrC;AAwJD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA+M3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"HdrPlaylistRenderer.d.ts","sourceRoot":"","sources":["../../src/components/HdrPlaylistRenderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,kFAAkF;IAClF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,qBAAqB,CAAC;CACrC;AAwJD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAgN3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/HdrPlaylistRenderer.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import * as THREE from 'three';
@@ -153,7 +154,7 @@ const pickNext = (order, current, length, directionRef) => {
     return next;
 };
 // ── Component ───────────────────────────────────────────────────────────────
-const HdrPlaylistRenderer = ({ urls, transition }) => {
+const HdrPlaylistRenderer = ({ urls, transition, onObjectReady, onObjectDispose }) => {
     const { scene, gl: renderer, camera } = useThree();
     const mixRef = useRef(0);
     const tlRef = useRef(null);
@@ -169,6 +170,7 @@ const HdrPlaylistRenderer = ({ urls, transition }) => {
         transitionRef.current = transition;
     }, [transition]);
     const bgMeshRef = useRef(null);
+    useObjectReady(bgMeshRef, { urls, transition }, onObjectReady, onObjectDispose);
     // Gates the timeline-build effect on the cube-RT pipeline being ready.
     // Replaces a previous rAF poll — flips false → true once HDRs load and
     // stateRef.current is populated, and back to false on URL/teardown changes.

package/dist/components/Lensflare.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 LensflareProps {
+export interface LensflareProps extends ObjectReadyProps {
     visible?: boolean;
     intensity?: number;
     timeSettings?: TimeSettings;

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

@@ -1 +1 @@
-{"version":3,"file":"Lensflare.d.ts","sourceRoot":"","sources":["../../src/components/Lensflare.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,aAAa,CA4BpE;AACD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA8BvC,CAAC;AACF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Lensflare.d.ts","sourceRoot":"","sources":["../../src/components/Lensflare.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,aAAa,CA4BpE;AACD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA+BvC,CAAC;AACF,eAAe,SAAS,CAAC"}

package/dist/components/Lensflare.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useMemo, useCallback } from 'react';
 import * as THREE from 'three';
 import { useThree } from '@react-three/fiber';
@@ -32,8 +33,9 @@ export function createFlareTexture(type) {
     texture.magFilter = THREE.LinearFilter;
     return texture;
 }
-const Lensflare = ({ visible = true, intensity = 1, timeSettings = { enabled: false, timeOfDay: 12, timescale: 1, autoAnimate: true, syncWithRealTime: false }, }) => {
+const Lensflare = ({ visible = true, intensity = 1, timeSettings = { enabled: false, timeOfDay: 12, timescale: 1, autoAnimate: true, syncWithRealTime: false }, onObjectReady, onObjectDispose, }) => {
     const spriteRef = useRef(null);
+    useObjectReady(spriteRef, { visible, intensity, timeSettings }, onObjectReady, onObjectDispose);
     const { camera } = useThree();
     const texture = useMemo(() => createFlareTexture(0), []);
     const material = useMemo(() => new THREE.SpriteMaterial({

package/dist/components/Letter.d.ts

@@ -1,3 +1,4 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { HoverSettings, Vector3Array, TransformEffect, MaterialSettings, ColorEffect, TextConfig } from '@3driseai/3drise-core';
 import { Object3D } from "three";
 export interface LetterData {
@@ -5,7 +6,7 @@ export interface LetterData {
     position: Vector3Array;
     index: number;
 }
-export interface LetterProps {
+export interface LetterProps extends ObjectReadyProps {
     letterData: LetterData;
     config: TextConfig;
     materialSettings: MaterialSettings;
@@ -15,5 +16,5 @@ export interface LetterProps {
     isActive: boolean;
     onClick?: (object: Object3D) => void;
 }
-export default function Letter({ letterData, config, materialSettings, hoverSettings, transformEffects, colorEffects, isActive, onClick, }: LetterProps): import("react").JSX.Element;
+export default function Letter({ letterData, config, materialSettings, hoverSettings, transformEffects, colorEffects, isActive, onClick, onObjectReady, onObjectDispose, }: LetterProps): import("react").JSX.Element;
 //# sourceMappingURL=Letter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Letter.d.ts","sourceRoot":"","sources":["../../src/components/Letter.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrI,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxC;AA6BD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,WAAW,+BAgDhK"}
+{"version":3,"file":"Letter.d.ts","sourceRoot":"","sources":["../../src/components/Letter.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrI,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;CACxC;AA6BD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,WAAW,+BAiDhM"}

package/dist/components/Letter.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useState, useEffect } from 'react';
 import { useFrame } from '@react-three/fiber';
 import { useCursor, Text, Text3D, Center } from '@react-three/drei';
@@ -32,8 +33,9 @@ const getText2DConfig = (config) => {
         anchorY: c.anchorY ?? 'middle',
     };
 };
-export default function Letter({ letterData, config, materialSettings, hoverSettings, transformEffects = [], colorEffects = [], isActive, onClick, }) {
+export default function Letter({ letterData, config, materialSettings, hoverSettings, transformEffects = [], colorEffects = [], isActive, onClick, onObjectReady, onObjectDispose, }) {
     const groupRef = useRef(null);
+    useObjectReady(groupRef, letterData, onObjectReady, onObjectDispose);
     const letterRef = useRef(null);
     const hitboxRef = useRef(null);
     const effectStateRef = useRef(null);

package/dist/components/Letters.d.ts

@@ -1,9 +1,10 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import { LetterData } from './Letter';
 import type { HoverSettings } from "@3driseai/3drise-core";
 import type { TextConfig } from "@3driseai/3drise-core";
 import type { MaterialSettings } from "@3driseai/3drise-core";
 import type { ColorEffect, TransformEffect } from "@3driseai/3drise-core";
-export interface LettersProps {
+export interface LettersProps extends ObjectReadyProps {
     text: string;
     config: TextConfig;
     materialSettings: MaterialSettings;
@@ -12,5 +13,5 @@ export interface LettersProps {
     colorEffects?: ColorEffect[];
     onLetterClick?: (letterData: LetterData) => void;
 }
-export default function Letters({ text, config, materialSettings, hoverSettings, transformEffects, colorEffects, onLetterClick, }: LettersProps): import("react").JSX.Element;
+export default function Letters({ text, config, materialSettings, hoverSettings, transformEffects, colorEffects, onLetterClick, onObjectReady, onObjectDispose, }: LettersProps): import("react").JSX.Element;
 //# sourceMappingURL=Letters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Letters.d.ts","sourceRoot":"","sources":["../../src/components/Letters.tsx"],"names":[],"mappings":"AACA,OAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACpD;AAGD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,aAAa,GAAG,EAAE,YAAY,+BAcxJ"}
+{"version":3,"file":"Letters.d.ts","sourceRoot":"","sources":["../../src/components/Letters.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACpD;AAGD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAqB,EAAE,YAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,YAAY,+BAexL"}

package/dist/components/Letters.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef } from 'react';
 import Letter from './Letter.js';
-export default function Letters({ text, config, materialSettings, hoverSettings, transformEffects = [], colorEffects = [], onLetterClick, }) {
+export default function Letters({ text, config, materialSettings, hoverSettings, transformEffects = [], colorEffects = [], onLetterClick, onObjectReady, onObjectDispose, }) {
     const ref = useRef(null);
+    useObjectReady(ref, config, onObjectReady, onObjectDispose);
     const characters = text.split('');
     const letterSpacing = config.letterSpacing || 0;
     const spacing = 0.6 + letterSpacing;

package/dist/components/LightObject.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,KAAK,gBAAgB,GAAG;IACpB,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AA4CF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAgB3C,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"LightObject.d.ts","sourceRoot":"","sources":["../../src/components/LightObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,KAAK,gBAAgB,GAAG,gBAAgB,GAAG;IACvC,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AA+CF,QAAA,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAgB3C,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/LightObject.js

@@ -1,19 +1,22 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useEffect, useRef } from 'react';
 import { useThree } from '@react-three/fiber';
 import { useLightShadow } from '../hooks/useLightShadow.js';
 import { useLightAnimation } from '../hooks/useLightAnimation.js';
 import { useLightMouseMove } from '../hooks/useLightMouseMove.js';
-const DirectionalLightR3F = ({ config, animations, mouseMove }) => {
+const DirectionalLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const lightRef = useRef(null);
+    useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
     useLightShadow(lightRef, config.shadow);
     useLightAnimation(lightRef, animations);
     useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
     return (_jsx("directionalLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1 }));
 };
-const SpotLightR3F = ({ config, animations, mouseMove }) => {
+const SpotLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const { scene } = useThree();
     const lightRef = useRef(null);
+    useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
     const targetRef = useRef(null);
     const [tx, ty, tz] = config.targetPosition ?? [0, 0, 0];
     useEffect(() => {
@@ -38,14 +41,15 @@ const SpotLightR3F = ({ config, animations, mouseMove }) => {
     useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
     return (_jsx("spotLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1, angle: config.angle ?? Math.PI / 4, penumbra: config.penumbra ?? 0.1, decay: config.decay ?? 1, distance: config.distance ?? 0 }));
 };
-const PointLightR3F = ({ config, animations, mouseMove }) => {
+const PointLightR3F = ({ config, animations, mouseMove, settings, onObjectReady, onObjectDispose }) => {
     const lightRef = useRef(null);
+    useObjectReady(lightRef, settings, onObjectReady, onObjectDispose);
     useLightShadow(lightRef, config.shadow);
     useLightAnimation(lightRef, animations);
     useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
     return (_jsx("pointLight", { ref: lightRef, color: config.color || '#ffffff', intensity: config.intensity ?? 1, decay: config.decay ?? 1, distance: config.distance ?? 0 }));
 };
-const LightObject = ({ createdObject }) => {
+const LightObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
     const config = createdObject.config;
     if (!config || config.enabled === false)
         return null;
@@ -53,11 +57,11 @@ const LightObject = ({ createdObject }) => {
     const mouseMove = createdObject.mouseMove?.light;
     switch (config.type) {
         case 'directional':
-            return _jsx(DirectionalLightR3F, { config: config, animations: animations, mouseMove: mouseMove });
+            return _jsx(DirectionalLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         case 'spot':
-            return _jsx(SpotLightR3F, { config: config, animations: animations, mouseMove: mouseMove });
+            return _jsx(SpotLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         case 'point':
-            return _jsx(PointLightR3F, { config: config, animations: animations, mouseMove: mouseMove });
+            return _jsx(PointLightR3F, { config: config, animations: animations, mouseMove: mouseMove, settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
         default:
             return null;
     }

package/dist/components/LightsManager.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { SceneLightConfig } from '@3driseai/3drise-core';
 import React from "react";
-export interface LightsManagerProps {
+export interface LightsManagerProps extends ObjectReadyProps {
     config: SceneLightConfig;
 }
 declare const LightsManager: React.FC<LightsManagerProps>;

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

@@ -1 +1 @@
-{"version":3,"file":"LightsManager.d.ts","sourceRoot":"","sources":["../../src/components/LightsManager.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAID,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA+F/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"LightsManager.d.ts","sourceRoot":"","sources":["../../src/components/LightsManager.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAID,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAmG/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/LightsManager.js

@@ -1,13 +1,16 @@
-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 { useRef, useEffect } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import { createSunPosition } from '@3driseai/3drise-core';
 import { Color, } from 'three';
 import { useLightAnimation } from '../hooks/useLightAnimation.js';
 const SUN_DISTANCE = 100;
-const LightsManager = ({ config }) => {
+const LightsManager = ({ config, onObjectReady, onObjectDispose }) => {
     const { scene } = useThree();
     const ambientLightRef = useRef(null);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const sunLightRef = useRef(null);
     const ambientConfig = config.ambient;
     const sunConfig = config.sun;
@@ -99,6 +102,6 @@ const LightsManager = ({ config }) => {
             sunLightRef.current.position.set(sunPosition.x * SUN_DISTANCE, sunPosition.y * SUN_DISTANCE, sunPosition.z * SUN_DISTANCE);
         }
     });
-    return (_jsxs(_Fragment, { children: [_jsx("ambientLight", { ref: ambientLightRef, color: ambientConfig?.color, intensity: ambientConfig?.intensity, visible: ambientConfig?.enabled }), _jsx("directionalLight", { visible: sunConfig?.enabled, ref: sunLightRef, color: sunConfig?.color || '#ffffff', intensity: sunConfig?.intensity ?? 1, castShadow: config.enableShadows ?? true })] }));
+    return (_jsxs("group", { ref: rootRef, children: [_jsx("ambientLight", { ref: ambientLightRef, color: ambientConfig?.color, intensity: ambientConfig?.intensity, visible: ambientConfig?.enabled }), _jsx("directionalLight", { visible: sunConfig?.enabled, ref: sunLightRef, color: sunConfig?.color || '#ffffff', intensity: sunConfig?.intensity ?? 1, castShadow: config.enableShadows ?? true })] }));
 };
 export default LightsManager;

package/dist/components/Lines.d.ts

@@ -1,6 +1,7 @@
+import type { ObjectReadyProps } from '../types/objectReady';
 import type { ParticlesSettings } from '@3driseai/3drise-core';
 import React from "react";
-interface LinesProps {
+interface LinesProps extends ObjectReadyProps {
     createdObject: ParticlesSettings;
     transitionSettings?: Record<string, any>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Lines.d.ts","sourceRoot":"","sources":["../../src/components/Lines.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,UAAU,UAAU;IAChB,aAAa,EAAE,iBAAiB,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5C;AAGD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAa/B,CAAC;AACF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Lines.d.ts","sourceRoot":"","sources":["../../src/components/Lines.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,UAAU,UAAW,SAAQ,gBAAgB;IACzC,aAAa,EAAE,iBAAiB,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5C;AAGD,QAAA,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAa/B,CAAC;AACF,eAAe,KAAK,CAAC"}

package/dist/components/Lines.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useMemo } from 'react';
 import { PositionsCreator } from '@3driseai/3drise-core';
 import Path from './Path.js';
-const Lines = ({ createdObject, transitionSettings }) => {
+const Lines = ({ createdObject, transitionSettings, onObjectReady, onObjectDispose }) => {
     if (!createdObject)
         return null;
     const { config } = createdObject;
@@ -14,6 +14,6 @@ const Lines = ({ createdObject, transitionSettings }) => {
         : config.shapeType;
     const curves = useMemo(() => PositionsCreator.generatePaths(config.shapeType), [config.shapeType]);
     const targetCurves = useMemo(() => PositionsCreator.generatePaths(targetShape), [targetShape]);
-    return (_jsx(_Fragment, { children: curves.map((currentCurve, index) => (_jsx(Path, { curve: currentCurve, targetCurve: targetCurves[index % targetCurves.length], duration: 1, color: color }, `path-${index}`))) }));
+    return (_jsx(_Fragment, { children: curves.map((currentCurve, index) => (_jsx(Path, { curve: currentCurve, targetCurve: targetCurves[index % targetCurves.length], duration: 1, color: color, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, `path-${index}`))) }));
 };
 export default Lines;