@3driseai/3drise-viewer 0.1.1 → 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;
@@ -24,14 +25,11 @@ export interface GeometryMeshProps {
     /** Material for the solid path (defaults to a standard material). */
     children?: ReactNode;
 }
-export declare function useShapeGeometry(options: GeometryShapeConfig): BufferGeometry;
-/** interior fill via point-in-mesh ray-parity (closed meshes only) */
+export declare function useShapeGeometry(options: GeometryShapeConfig | null | undefined): BufferGeometry;
 export declare function volumeFill(geo: BufferGeometry, count: number, oversample?: number): Float32Array;
 /** area-weighted points on the skin — the keystone for the modes below */
 export declare function surfaceScatter(geo: BufferGeometry, count: number): Float32Array;
-/** fold into one wedge, mirror, rotate-copy around Z → kaleidoscope */
 export declare function symmetricScatter(geo: BufferGeometry, count: number, sym: number): Float32Array;
-/** blue-noise: oversample then reject anything closer than minDist (grid-hashed) */
 export declare function evenScatter(geo: BufferGeometry, count: number, spacing: number): Float32Array;
 export declare function meshVertices(geo: BufferGeometry): Float32Array;
 export declare function edges3D(geo: BufferGeometry, angleDeg: number): Pt[];
@@ -44,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,17 +1,39 @@
 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';
-// ── Wire these to your project ───────────────────────────────────────────────
 import { shapeGenerators } from '../utils/shapes.js';
 import PointCloud from './PointCloud.js';
-// import type { ShapeConfig, DisplayMode } from './GeometryShapeController';
-/* ════════════════════════════════════════════════════════════════════════════
- * Geometry — one source the modes all read from.
- * ══════════════════════════════════════════════════════════════════════════ */
+const defaultModeConfig = {
+    mode: 'solid',
+    count: 1000,
+    symmetry: 3,
+    spacing: 0.1,
+    slices: 8,
+    linkRadius: 0.05,
+    angle: 18,
+    lineWidth: 1,
+};
+function normalizeShapeConfig(config) {
+    if (config && typeof config === 'object' && typeof config.type === 'string' && config.type in shapeGenerators) {
+        return config;
+    }
+    return { type: 'box' };
+}
+function normalizeModeConfig(config) {
+    return {
+        ...defaultModeConfig,
+        ...(config || {}),
+    };
+}
 export function useShapeGeometry(options) {
-    const key = JSON.stringify(options);
-    const geometry = useMemo(() => shapeGenerators[options.type](options), [options.type, key]); // eslint-disable-line react-hooks/exhaustive-deps
+    const safeOptions = useMemo(() => normalizeShapeConfig(options), [options]);
+    const key = JSON.stringify(safeOptions);
+    const geometry = useMemo(() => {
+        const generator = shapeGenerators[safeOptions.type] ?? shapeGenerators.box;
+        return generator(safeOptions);
+    }, [safeOptions.type, key]); // eslint-disable-line react-hooks/exhaustive-deps
     useEffect(() => () => geometry.dispose(), [geometry]);
     return geometry;
 }
@@ -41,10 +63,6 @@ function toPairs(arr) {
         out.push([arr[i], arr[i + 1], arr[i + 2]]);
     return out;
 }
-/* ════════════════════════════════════════════════════════════════════════════
- * POINT transforms → Float32Array of xyz.
- * ══════════════════════════════════════════════════════════════════════════ */
-/** interior fill via point-in-mesh ray-parity (closed meshes only) */
 export function volumeFill(geo, count, oversample = 80) {
     const probe = new Mesh(geo, new MeshBasicMaterial({ side: DoubleSide }));
     probe.updateMatrixWorld(true);
@@ -106,7 +124,6 @@ export function surfaceScatter(geo, count) {
     }
     return out;
 }
-/** fold into one wedge, mirror, rotate-copy around Z → kaleidoscope */
 export function symmetricScatter(geo, count, sym) {
     const base = surfaceScatter(geo, Math.max(1, Math.floor(count / (2 * sym))));
     const w = (Math.PI * 2) / sym;
@@ -125,7 +142,6 @@ export function symmetricScatter(geo, count, sym) {
     }
     return new Float32Array(out);
 }
-/** blue-noise: oversample then reject anything closer than minDist (grid-hashed) */
 export function evenScatter(geo, count, spacing) {
     const cand = surfaceScatter(geo, count * 6);
     const minD = (spacing * bboxDiag(geo)) / Math.sqrt(count);
@@ -169,9 +185,6 @@ export function meshVertices(geo) {
     }
     return out;
 }
-/* ════════════════════════════════════════════════════════════════════════════
- * LINE transforms → segment endpoint pairs (Pt[]).
- * ══════════════════════════════════════════════════════════════════════════ */
 export function edges3D(geo, angleDeg) {
     const e = new EdgesGeometry(geo, angleDeg);
     const pts = toPairs(e.attributes.position.array);
@@ -228,9 +241,6 @@ export function contourSlices(geo, slices, axis = 1) {
     }
     return out;
 }
-/* ════════════════════════════════════════════════════════════════════════════
- * PLEXUS → points + links to near neighbours.
- * ══════════════════════════════════════════════════════════════════════════ */
 export function plexus(geo, count, radiusMul, maxLinks = 6) {
     const pts = surfaceScatter(geo, count);
     const n = pts.length / 3;
@@ -288,24 +298,33 @@ export function computeMode(geo, c) {
     }
 }
 function useModeData(geometry, config) {
-    console.log('useModeData', config);
-    const key = [config.mode, config.count, config.symmetry, config.spacing, config.slices, config.linkRadius, config.angle].join('|');
-    return useMemo(() => computeMode(geometry, config), [geometry, key]); // eslint-disable-line react-hooks/exhaustive-deps
+    const safeConfig = normalizeModeConfig(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
 }
-const defaultModeConfig = { mode: 'solid', count: 1000, symmetry: 3, spacing: 0.1, slices: 8, linkRadius: 0.05, angle: 18, lineWidth: 1 };
-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 data = useModeData(geometry, modeConfig);
+    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: modeConfig.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: modeConfig.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 }) }));
 }
-/* ── Optional host-owned auto-fit (generators return raw geometry). ── */
 export function FitGroup({ geometry, radius = 1.7, children }) {
     const { scale, position } = useMemo(() => {
         geometry.computeBoundingSphere();

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