@3driseai/3drise-viewer 0.1.2 → 0.1.4

package/dist/components/effects/SmokeRibbon.js

@@ -3,12 +3,13 @@ import { PlaneGeometry } from 'three';
 import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import { SmokeRibbonMaterial } from '@3driseai/3drise-core';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 /**
  * Place where you want the smoke to rise from — it climbs the parent's local +Y:
  *
  *   <SmokeRibbon position={[0, 0, 0]} config={{ planes: 2, twistStart: 0.2 }} />
  */
-const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
+const SmokeRibbon = ({ config = {}, boundingRadius = 1, onObjectReady, onObjectDispose, ...groupProps }) => {
     const { width = 1.5, height = 5, segmentsPerLength = 12, planes = 2, color = '#f2f2f7', colorTop = '#b3b8c7', speed = 0.18, detail = 1.4, remapLow = 0.38, remapHigh = 1.0, edgeX = 0.4, edgeY = 0.32, density = 1.0, twistStrength = 9, twistSpeed = 0.4, twistScale = 0.9, twistStart = 0.18, wind = [0.15, 0], animate = true, interactive = false, } = config;
     // One material instance shared across the crossed planes -> one set of uniforms.
     const material = useMemo(() => new SmokeRibbonMaterial(), []);
@@ -50,6 +51,8 @@ const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
     ]);
     const { pointer } = useThree();
     const hovering = useRef(false);
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     useFrame(({ clock }) => {
         if (animate)
             material.u_time = clock.getElapsedTime();
@@ -64,6 +67,6 @@ const SmokeRibbon = ({ config = {}, boundingRadius = 1, ...groupProps }) => {
         }
     });
     console.log('SmokeRibbon render with config:', config, 'and groupProps:', groupProps);
-    return (_jsx("group", { ...groupProps, onPointerOver: interactive ? () => (hovering.current = true) : undefined, onPointerOut: interactive ? () => (hovering.current = false) : undefined, children: angles.map((a, i) => (_jsx("mesh", { geometry: geometry, material: material, "rotation-y": a }, i))) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, onPointerOver: interactive ? () => (hovering.current = true) : undefined, onPointerOut: interactive ? () => (hovering.current = false) : undefined, children: angles.map((a, i) => (_jsx("mesh", { geometry: geometry, material: material, "rotation-y": a }, i))) }));
 };
 export default SmokeRibbon;

package/dist/components/effects/SmokeRingEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { SmokeRingConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface SmokeRingEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface SmokeRingEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: SmokeRingConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/SmokeRingEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,UAAU,oBAAoB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAiED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAyFnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAiED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2FnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/SmokeRingEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Per-ring puff shader (one Points per ring — GPU computes torus positions) ──
 const ringVert = /* glsl */ `
   attribute float aAngle;    // 0..TAU position around torus
@@ -65,9 +66,11 @@ const ringFrag = /* glsl */ `
   }
 `;
 const PUFFS_PER_RING = 120;
-const SmokeRingEffect = ({ boundingRadius, config, animations }) => {
+const SmokeRingEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { ringCount, expansionRadius, riseSpeed, intervalSeconds, smokeColor, thickness, opacity, speed, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const N = Math.max(1, Math.min(ringCount, 4));
     // Ring states — one per slot
     const ringStates = useRef([]);
@@ -153,6 +156,6 @@ const SmokeRingEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations(mats, animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return (_jsx("group", { children: geos.map((geo, i) => (_jsx("points", { geometry: geo, material: mats[i] }, i))) }));
+    return (_jsx("group", { ref: rootRef, children: geos.map((geo, i) => (_jsx("points", { geometry: geo, material: mats[i] }, i))) }));
 };
 export default SmokeRingEffect;

package/dist/components/effects/VolumetricFogEffect.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import type { VolumetricFogConfig, AnimationOptions } from "@3driseai/3drise-core";
-interface VolumetricFogEffectProps {
+import type { ObjectReadyProps } from '../../types/objectReady';
+interface VolumetricFogEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: VolumetricFogConfig;
     animations?: AnimationOptions[];

package/dist/components/effects/VolumetricFogEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnF,UAAU,wBAAwB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAoDD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAuD3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,UAAU,wBAAyB,SAAQ,gBAAgB;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAoDD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAyD3D,CAAC;AACF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/VolumetricFogEffect.js

@@ -3,6 +3,7 @@ import { useRef, useMemo } from 'react';
 import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
 // ── Billboard fog puff — drifts slowly, never rises far ───────────────────────
 const fogVert = /* glsl */ `
   attribute float aT;       // stagger offset 0..1
@@ -52,9 +53,11 @@ const fogFrag = /* glsl */ `
     gl_FragColor = vec4(uFogColor, g * vAlpha * uDensity);
   }
 `;
-const VolumetricFogEffect = ({ boundingRadius, config, animations }) => {
+const VolumetricFogEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
     const { particleCount, fogRadius, driftSpeed, fogColor, density, opacity, intensity } = config;
     const startValuesCacheRef = useRef({});
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const r = boundingRadius * fogRadius;
     const { geo, mat } = useMemo(() => {
         const N = Math.max(20, Math.min(particleCount, 200));
@@ -106,6 +109,6 @@ const VolumetricFogEffect = ({ boundingRadius, config, animations }) => {
             applyGenerativeAnimations([mat], animations, startValuesCacheRef.current, Date.now(), false);
         }
     });
-    return _jsx("points", { geometry: geo, material: mat });
+    return _jsx("points", { ref: rootRef, geometry: geo, material: mat });
 };
 export default VolumetricFogEffect;

package/dist/components/effects/index.d.ts

@@ -0,0 +1,28 @@
+export type { CoronaProps } from './Corona';
+export type { FireProps } from './Fire';
+export type { FlaresProps } from './Flares';
+export type { SmokeRibbonProps } from './SmokeRibbon';
+export { default as AuraEffect } from './AuraEffect';
+export { default as AuroraEffect } from './AuroraEffect';
+export { default as BlackHoleEffect } from './BlackHoleEffect';
+export { default as ConstellationEffect } from './ConstellationEffect';
+export { default as Corona } from './Corona';
+export { default as DataStreamEffect } from './DataStreamEffect';
+export { default as DnaHelixEffect } from './DnaHelixEffect';
+export { default as Fire } from './Fire';
+export { default as FireEffect } from './FireEffect';
+export { default as Flares } from './Flares';
+export { default as ForcefieldEffect } from './ForcefieldEffect';
+export { default as HologramEffect } from './HologramEffect';
+export { default as IceCrystalsEffect } from './IceCrystalsEffect';
+export { default as LightningEffect } from './LightningEffect';
+export { default as MoleculesEffect } from './MoleculesEffect';
+export { default as NeuralNetworkEffect } from './NeuralNetworkEffect';
+export { default as OrbEffect } from './OrbEffect';
+export { default as PortalEffect } from './PortalEffect';
+export { default as ShockwaveEffect } from './ShockwaveEffect';
+export { default as SmokePlumeEffect } from './SmokePlumeEffect';
+export { default as SmokeRibbon } from './SmokeRibbon';
+export { default as SmokeRingEffect } from './SmokeRingEffect';
+export { default as VolumetricFogEffect } from './VolumetricFogEffect';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/effects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/effects/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/effects/index.js

@@ -0,0 +1,24 @@
+// Generative effect components.
+export { default as AuraEffect } from './AuraEffect.js';
+export { default as AuroraEffect } from './AuroraEffect.js';
+export { default as BlackHoleEffect } from './BlackHoleEffect.js';
+export { default as ConstellationEffect } from './ConstellationEffect.js';
+export { default as Corona } from './Corona.js';
+export { default as DataStreamEffect } from './DataStreamEffect.js';
+export { default as DnaHelixEffect } from './DnaHelixEffect.js';
+export { default as Fire } from './Fire.js';
+export { default as FireEffect } from './FireEffect.js';
+export { default as Flares } from './Flares.js';
+export { default as ForcefieldEffect } from './ForcefieldEffect.js';
+export { default as HologramEffect } from './HologramEffect.js';
+export { default as IceCrystalsEffect } from './IceCrystalsEffect.js';
+export { default as LightningEffect } from './LightningEffect.js';
+export { default as MoleculesEffect } from './MoleculesEffect.js';
+export { default as NeuralNetworkEffect } from './NeuralNetworkEffect.js';
+export { default as OrbEffect } from './OrbEffect.js';
+export { default as PortalEffect } from './PortalEffect.js';
+export { default as ShockwaveEffect } from './ShockwaveEffect.js';
+export { default as SmokePlumeEffect } from './SmokePlumeEffect.js';
+export { default as SmokeRibbon } from './SmokeRibbon.js';
+export { default as SmokeRingEffect } from './SmokeRingEffect.js';
+export { default as VolumetricFogEffect } from './VolumetricFogEffect.js';

package/dist/components/index.d.ts

@@ -0,0 +1,112 @@
+export type { AnimatedObjectProps } from './AnimatedObject';
+export type { BubblesProps } from './Bubbles';
+export type { CloudsProps } from './Clouds';
+export type { EffectsGeneratorProps } from './EffectsGenerator';
+export type { EnvironmentManagerProps } from './EnvironmentManager';
+export type { OutlineMode, Point3 } from './extractOutline';
+export type { FrameProps } from './Frame';
+export type { FrameShapeType } from './FrameGeometry';
+export type { GalaxyProps } from './Galaxy';
+export type { GalleryLayoutProps } from './GalleryLayout';
+export type { GeometryMeshProps } from './GeometryShape';
+export type { GlyphsProps } from './Glyphs';
+export type { GridHelperProps } from './GridHelper';
+export type { HdrPlaylistRendererProps } from './HdrPlaylistRenderer';
+export type { ImageGeometryProps } from './ImageGeometry';
+export type { LensflareProps } from './Lensflare';
+export type { LetterData, LetterProps } from './Letter';
+export type { LettersProps } from './Letters';
+export type { LightsManagerProps } from './LightsManager';
+export type { LoadingIndicatorProps } from './LoadingIndicator';
+export type { MaterialLibraryProps } from './MaterialLibrary';
+export type { MoonProps, MoonSettings } from './Moon';
+export type { MyGridProps } from './MyGrid';
+export type { ObjectsRendererApiProps } from './ObjectsRendererApi';
+export type { OceanProps } from './Ocean';
+export type { OutlineProps } from './Outline';
+export type { PathRendererProps } from './PathRenderer';
+export type { PlanetProps, PlanetType } from './Planet';
+export type { RainProps } from './Rain';
+export type { SceneFogProps } from './SceneFog';
+export type { ShootingStarProps } from './ShootingStar';
+export type { ShootingStarsProps } from './ShootingStars';
+export type { SkyboxProps } from './Skybox';
+export type { SkyControllerProps } from './SkyController';
+export type { SkyMeshProps } from './SkyMesh';
+export type { SkySystemProps, SkySystemRef } from './SkySystem';
+export type { SparklesBurstProps } from './SparklesBurst';
+export type { StarsProps } from './Stars';
+export type { SunCoreProps } from './SunCore';
+export type { SunLightProps } from './SunLight';
+export type { Text2DProps } from './Text2D';
+export type { Text3DProps } from './Text3D';
+export type { VolumePointsProps } from './VolumePoints';
+export { AnimatedObject, default as AnimatedObjectDefault } from './AnimatedObject';
+export { default as Bubbles } from './Bubbles';
+export { CameraController, default as CameraControllerDefault } from './CameraController';
+export { default as Clouds } from './Clouds';
+export { default as CreatedObject } from './CreatedObject';
+export { default as CustomPrimitive } from './CustomPrimitive';
+export { default as Earth } from './Earth';
+export { default as EffectsGenerator } from './EffectsGenerator';
+export { default as EffectsGroup } from './EffectsGroup';
+export { default as EnvironmentManager } from './EnvironmentManager';
+export { default as EnvironmentObject } from './EnvironmentObject';
+export { default as Frame } from './Frame';
+export { FrameGeometry } from './FrameGeometry';
+export { FrameImage } from './FrameImage';
+export { default as Galaxy } from './Galaxy';
+export { default as GalleryLayout } from './GalleryLayout';
+export { default as Glyphs } from './Glyphs';
+export { default as GridHelper } from './GridHelper';
+export { default as GridGenerator } from './GridsGenerator';
+export { default as HdrPlaylistRenderer } from './HdrPlaylistRenderer';
+export { ImageGeometry } from './ImageGeometry';
+export { default as Lensflare, createFlareTexture } from './Lensflare';
+export { default as Letter } from './Letter';
+export { default as Letters } from './Letters';
+export { default as LightObject } from './LightObject';
+export { default as LightsManager } from './LightsManager';
+export { default as Lines } from './Lines';
+export { default as LoadingIndicator } from './LoadingIndicator';
+export { default as MaterialLibrary } from './MaterialLibrary';
+export { default as Moon, defaultMoonSettings } from './Moon';
+export { MyGrid, defaultMyGridConfig } from './MyGrid';
+export { default as ObjectNode } from './ObjectNode';
+export { default as ObjectNodeApi } from './ObjectNodeApi';
+export { default as ObjectsRenderer } from './ObjectsRenderer';
+export { default as ObjectsRendererApi } from './ObjectsRendererApi';
+export { default as Ocean } from './Ocean';
+export { Outline } from './Outline';
+export { default as ParticlesR3f } from './ParticlesR3f';
+export { default as Path } from './Path';
+export { default as PathGeometry } from './PathGeometry';
+export { default as PathRenderer } from './PathRenderer';
+export { default as Planet } from './Planet';
+export { default as PointCloud } from './PointCloud';
+export { default as ProductionScene } from './ProductionScene';
+export { default as ProjectLoader } from './ProjectLoader';
+export { default as Rain } from './Rain';
+export { default as RiseLogo } from './RiseLogo';
+export { default as SceneBuilder } from './SceneBuilder';
+export { default as SceneFog } from './SceneFog';
+export { default as ShootingStar } from './ShootingStar';
+export { default as ShootingStars } from './ShootingStars';
+export { default as Skybox } from './Skybox';
+export { default as SkyController } from './SkyController';
+export { default as SkyMesh } from './SkyMesh';
+export { default as SkySystem } from './SkySystem';
+export { default as SolarSystem } from './SolarSystem';
+export { default as SparklesBurst } from './SparklesBurst';
+export { default as Stars, generateStarsGeometry } from './Stars';
+export { default as Sun } from './Sun';
+export { default as SunCore } from './SunCore';
+export { default as SunLight } from './SunLight';
+export { default as Text2D } from './Text2D';
+export { default as Text3D } from './Text3D';
+export { VolumePoints } from './VolumePoints';
+export { FitGroup, GeometryMesh, computeMode, contourSlices, evenScatter, meshVertices, plexus, surfaceScatter, symmetricScatter, useShapeGeometry as useGeometryShape, volumeFill, wireframe, } from './GeometryShape';
+export { contour2D, edges3D } from './extractOutline';
+export * from './cursor';
+export * from './effects';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/index.js

@@ -0,0 +1,77 @@
+// Public surface of the components folder.
+// Sub-folders own their own barrels; this file only aggregates them.
+// ----------------------------------------------------------- components
+export { AnimatedObject, default as AnimatedObjectDefault } from './AnimatedObject.js';
+export { default as Bubbles } from './Bubbles.js';
+export { CameraController, default as CameraControllerDefault } from './CameraController.js';
+export { default as Clouds } from './Clouds.js';
+export { default as CreatedObject } from './CreatedObject.js';
+export { default as CustomPrimitive } from './CustomPrimitive.js';
+export { default as Earth } from './Earth.js';
+export { default as EffectsGenerator } from './EffectsGenerator.js';
+export { default as EffectsGroup } from './EffectsGroup.js';
+export { default as EnvironmentManager } from './EnvironmentManager.js';
+export { default as EnvironmentObject } from './EnvironmentObject.js';
+export { default as Frame } from './Frame.js';
+export { FrameGeometry } from './FrameGeometry.js';
+export { FrameImage } from './FrameImage.js';
+export { default as Galaxy } from './Galaxy.js';
+export { default as GalleryLayout } from './GalleryLayout.js';
+export { default as Glyphs } from './Glyphs.js';
+export { default as GridHelper } from './GridHelper.js';
+export { default as GridGenerator } from './GridsGenerator.js';
+export { default as HdrPlaylistRenderer } from './HdrPlaylistRenderer.js';
+export { ImageGeometry } from './ImageGeometry.js';
+export { default as Lensflare, createFlareTexture } from './Lensflare.js';
+export { default as Letter } from './Letter.js';
+export { default as Letters } from './Letters.js';
+export { default as LightObject } from './LightObject.js';
+export { default as LightsManager } from './LightsManager.js';
+export { default as Lines } from './Lines.js';
+export { default as LoadingIndicator } from './LoadingIndicator.js';
+export { default as MaterialLibrary } from './MaterialLibrary.js';
+export { default as Moon, defaultMoonSettings } from './Moon.js';
+export { MyGrid, defaultMyGridConfig } from './MyGrid.js';
+export { default as ObjectNode } from './ObjectNode.js';
+export { default as ObjectNodeApi } from './ObjectNodeApi.js';
+export { default as ObjectsRenderer } from './ObjectsRenderer.js';
+export { default as ObjectsRendererApi } from './ObjectsRendererApi.js';
+export { default as Ocean } from './Ocean.js';
+export { Outline } from './Outline.js';
+export { default as ParticlesR3f } from './ParticlesR3f.js';
+export { default as Path } from './Path.js';
+export { default as PathGeometry } from './PathGeometry.js';
+export { default as PathRenderer } from './PathRenderer.js';
+export { default as Planet } from './Planet.js';
+export { default as PointCloud } from './PointCloud.js';
+export { default as ProductionScene } from './ProductionScene.js';
+export { default as ProjectLoader } from './ProjectLoader.js';
+export { default as Rain } from './Rain.js';
+export { default as RiseLogo } from './RiseLogo.js';
+export { default as SceneBuilder } from './SceneBuilder.js';
+export { default as SceneFog } from './SceneFog.js';
+export { default as ShootingStar } from './ShootingStar.js';
+export { default as ShootingStars } from './ShootingStars.js';
+export { default as Skybox } from './Skybox.js';
+export { default as SkyController } from './SkyController.js';
+export { default as SkyMesh } from './SkyMesh.js';
+export { default as SkySystem } from './SkySystem.js';
+export { default as SolarSystem } from './SolarSystem.js';
+export { default as SparklesBurst } from './SparklesBurst.js';
+export { default as Stars, generateStarsGeometry } from './Stars.js';
+export { default as Sun } from './Sun.js';
+export { default as SunCore } from './SunCore.js';
+export { default as SunLight } from './SunLight.js';
+export { default as Text2D } from './Text2D.js';
+export { default as Text3D } from './Text3D.js';
+export { VolumePoints } from './VolumePoints.js';
+// --------------------------------------------------- geometry utilities
+// GeometryShape also declares edges3D/contour2D, byte-identical to the ones in
+// extractOutline; only the extractOutline copies are exported. Its
+// useShapeGeometry takes a GeometryShapeConfig (the hooks/ one takes a
+// ShapeName + options), so it is aliased to useGeometryShape.
+export { FitGroup, GeometryMesh, computeMode, contourSlices, evenScatter, meshVertices, plexus, surfaceScatter, symmetricScatter, useShapeGeometry as useGeometryShape, volumeFill, wireframe, } from './GeometryShape.js';
+export { contour2D, edges3D } from './extractOutline.js';
+// ------------------------------------------------------------ sub-folders
+export * from './cursor/index.js';
+export * from './effects/index.js';

package/dist/constants.d.ts

@@ -1,2 +1,2 @@
-export declare const dataCenterServer = "https://3drise.ai/api/data/";
+export declare const dataCenterServer: string;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,gCAAgC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,QAAgF,CAAC"}

package/dist/constants.js

@@ -2,4 +2,4 @@ const LOCAL_DATA_CENTER_SERVER = 'http://localhost:3001/api/data/';
 const PRODUCTION_DATA_CENTER_SERVER = 'https://3drise.ai/api/data/';
 const isLocalHostRuntime = typeof window !== 'undefined' &&
     (window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1');
-export const dataCenterServer = PRODUCTION_DATA_CENTER_SERVER;
+export const dataCenterServer = isLocalHostRuntime ? LOCAL_DATA_CENTER_SERVER : PRODUCTION_DATA_CENTER_SERVER;

package/dist/hooks/index.d.ts

@@ -1 +1,56 @@
+export type { Update3driseShaderOptions } from './use3driseShader';
+export { update3driseShaderUniforms, use3driseShader } from './use3driseShader';
+export { useAnimationEvents } from './useAnimationEvents';
+export { useCameraAnimation } from './useCameraAnimation';
+export type { UseContinuousEffectsOptions, UseContinuousEffectsResult } from './useContinuousEffects';
+export { DEBUG_CONTINUOUS_EFFECTS, useContinuousEffects } from './useContinuousEffects';
+export type { UseCubeCameraOptions } from './useCubeCamera';
+export { useCubeCamera } from './useCubeCamera';
+export type { UseEnvironmentEffectsOptions } from './useEnvironmentEffects';
+export { useEnvironmentEffects } from './useEnvironmentEffects';
+export { useFrameAnimations } from './useFrameAnimations';
+export { useFrameEffects } from './useFrameEffects';
+export { ANIMATION_PRESETS, useGsapAnimation } from './useGsapAnimation';
+export { useInteraction } from './useInteraction';
+export type { UseInteractionEffectsOptions, UseInteractionEffectsResult } from './useInteractionEffects';
+export { useMouseMove } from './useInteractionEffects';
+export { useKey, useKeyUpDown } from './useKey';
+export type { UseLightAnimationOptions } from './useLightAnimation';
+export { useLightAnimation } from './useLightAnimation';
+export { useLightHandlers } from './useLightHandlers';
+export type { UseLightMouseMoveOptions } from './useLightMouseMove';
+export { useLightMouseMove } from './useLightMouseMove';
+export { useLightShadow } from './useLightShadow';
+export { useMaterialApplication } from './useMaterialApplication';
+export type { UseMaterialOptionsReturn } from './useMaterialOptions';
+export { useMaterialOptions } from './useMaterialOptions';
+export { useMaterialUniforms } from './useMaterialUniforms';
+export { useMeshController } from './useMeshController';
+export { useMouseHandlers } from './useMouseHandlers';
+export type { NumericValue } from './useNumericAnimation';
+export { useNumericAnimation } from './useNumericAnimation';
+export { useObjectAnimation } from './useObjectAnimation';
+export { useObjectEdges } from './useObjectEdges';
+export type { ObjectEffectsFunctions, ObjectEffectsState, UseObjectEffectsReturn } from './useObjectEffects';
+export { useObjectEffects } from './useObjectEffects';
+export { useObjectReady, useObjectReadyReporter } from './useObjectReady';
+export { useOrbitControls } from './useOrbitControls';
+export { useOutline } from './useOutline';
+export { useParticlePositions } from './useParticlePositions';
+export { useParticlesColors } from './useParticlesColors';
+export { useParticlesTextures } from './useParticlesTextures';
+export type { PathAnimationOptions } from './usePathAnimation';
+export { usePathAnimation } from './usePathAnimation';
+export { useSequenceAnimation } from './useSequenceAnimation';
+export { useShadowApplication } from './useShadowApplication';
+export { useShapeGeometry } from './useShapeGeometry';
+export type { SkyAnimValues } from './useSkyAnimation';
+export { useSkyAnimation } from './useSkyAnimation';
+export type { SkyTimeState, TimeOfDayLabel, UseSkySystemOptions, UseSkySystemReturn } from './useSkySystem';
+export { useSkySystem } from './useSkySystem';
+export { useSkyUniforms } from './useSkyUniforms';
+export { useTransformControls } from './useTransformControls';
+export { useVolumePoints } from './useVolumePoints';
+export { useWaterEnvironment } from './useWaterEnvironment';
+export { useWaterReflections } from './useWaterReflections';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

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

package/dist/hooks/index.js

@@ -1 +1,46 @@
-"use strict";
+// Public surface of the hooks folder.
+// Explicit named re-exports, matching the convention in components/index.ts.
+// Default exports are omitted throughout: every hook that has one also exports
+// the same function by name.
+export { update3driseShaderUniforms, use3driseShader } from './use3driseShader.js';
+export { useAnimationEvents } from './useAnimationEvents.js';
+export { useCameraAnimation } from './useCameraAnimation.js';
+export { DEBUG_CONTINUOUS_EFFECTS, useContinuousEffects } from './useContinuousEffects.js';
+export { useCubeCamera } from './useCubeCamera.js';
+export { useEnvironmentEffects } from './useEnvironmentEffects.js';
+export { useFrameAnimations } from './useFrameAnimations.js';
+export { useFrameEffects } from './useFrameEffects.js';
+export { ANIMATION_PRESETS, useGsapAnimation } from './useGsapAnimation.js';
+export { useInteraction } from './useInteraction.js';
+export { useMouseMove } from './useInteractionEffects.js';
+export { useKey, useKeyUpDown } from './useKey.js';
+export { useLightAnimation } from './useLightAnimation.js';
+export { useLightHandlers } from './useLightHandlers.js';
+export { useLightMouseMove } from './useLightMouseMove.js';
+export { useLightShadow } from './useLightShadow.js';
+export { useMaterialApplication } from './useMaterialApplication.js';
+export { useMaterialOptions } from './useMaterialOptions.js';
+export { useMaterialUniforms } from './useMaterialUniforms.js';
+export { useMeshController } from './useMeshController.js';
+export { useMouseHandlers } from './useMouseHandlers.js';
+export { useNumericAnimation } from './useNumericAnimation.js';
+export { useObjectAnimation } from './useObjectAnimation.js';
+export { useObjectEdges } from './useObjectEdges.js';
+export { useObjectEffects } from './useObjectEffects.js';
+export { useObjectReady, useObjectReadyReporter } from './useObjectReady.js';
+export { useOrbitControls } from './useOrbitControls.js';
+export { useOutline } from './useOutline.js';
+export { useParticlePositions } from './useParticlePositions.js';
+export { useParticlesColors } from './useParticlesColors.js';
+export { useParticlesTextures } from './useParticlesTextures.js';
+export { usePathAnimation } from './usePathAnimation.js';
+export { useSequenceAnimation } from './useSequenceAnimation.js';
+export { useShadowApplication } from './useShadowApplication.js';
+export { useShapeGeometry } from './useShapeGeometry.js';
+export { useSkyAnimation } from './useSkyAnimation.js';
+export { useSkySystem } from './useSkySystem.js';
+export { useSkyUniforms } from './useSkyUniforms.js';
+export { useTransformControls } from './useTransformControls.js';
+export { useVolumePoints } from './useVolumePoints.js';
+export { useWaterEnvironment } from './useWaterEnvironment.js';
+export { useWaterReflections } from './useWaterReflections.js';

package/dist/hooks/useObjectReady.d.ts

@@ -0,0 +1,29 @@
+import type { RefObject } from 'react';
+import type { Object3D } from 'three';
+import type { ObjectReadySource, OnObjectDispose, OnObjectReady } from '../types/objectReady';
+/**
+ * Report a component's root Object3D to its parent, and report it again on the
+ * way out.
+ *
+ * Fires `onObjectReady(source, ref.current)` once the ref is populated, and
+ * `onObjectDispose(source, ref.current)` when the component unmounts or the ref
+ * points somewhere else. The callbacks are read through a ref, so passing an
+ * inline arrow function from the parent does not cause the pair to re-fire on
+ * every render.
+ */
+export declare function useObjectReady(ref: RefObject<Object3D | null>, source: ObjectReadySource, onObjectReady?: OnObjectReady, onObjectDispose?: OnObjectDispose): void;
+/**
+ * The imperative counterpart to {@link useObjectReady}, for components that
+ * create their Object3D inside an effect rather than through JSX — there is no
+ * ref for the layout effect to watch, and by the time the object exists the
+ * layout effect has already run.
+ *
+ * Returns two stable callables, so they can be used inside an effect without
+ * appearing in its dependency array.
+ */
+export declare function useObjectReadyReporter(source: ObjectReadySource, onObjectReady?: OnObjectReady, onObjectDispose?: OnObjectDispose): {
+    report: (object: Object3D) => void;
+    reportDisposed: (object: Object3D) => void;
+};
+export default useObjectReady;
+//# sourceMappingURL=useObjectReady.d.ts.map

package/dist/hooks/useObjectReady.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectReady.d.ts","sourceRoot":"","sources":["../../src/hooks/useObjectReady.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9F;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAC/B,MAAM,EAAE,iBAAiB,EACzB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,eAAe,GAClC,IAAI,CAoBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,iBAAiB,EACzB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,eAAe,GAClC;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;IAAC,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;CAAE,CAgBpF;AAED,eAAe,cAAc,CAAC"}

package/dist/hooks/useObjectReady.js

@@ -0,0 +1,59 @@
+import { useCallback, useLayoutEffect, useRef } from 'react';
+/**
+ * Report a component's root Object3D to its parent, and report it again on the
+ * way out.
+ *
+ * Fires `onObjectReady(source, ref.current)` once the ref is populated, and
+ * `onObjectDispose(source, ref.current)` when the component unmounts or the ref
+ * points somewhere else. The callbacks are read through a ref, so passing an
+ * inline arrow function from the parent does not cause the pair to re-fire on
+ * every render.
+ */
+export function useObjectReady(ref, source, onObjectReady, onObjectDispose) {
+    const readyRef = useRef(onObjectReady);
+    const disposeRef = useRef(onObjectDispose);
+    const sourceRef = useRef(source);
+    readyRef.current = onObjectReady;
+    disposeRef.current = onObjectDispose;
+    sourceRef.current = source;
+    useLayoutEffect(() => {
+        const object = ref.current;
+        if (!object)
+            return;
+        // Capture the source at fire time so dispose reports the same pair that
+        // ready did, and so an inline object literal from the parent cannot
+        // retrigger the effect on every render.
+        const settings = sourceRef.current;
+        readyRef.current?.(settings, object);
+        return () => {
+            disposeRef.current?.(settings, object);
+        };
+    }, [ref.current]);
+}
+/**
+ * The imperative counterpart to {@link useObjectReady}, for components that
+ * create their Object3D inside an effect rather than through JSX — there is no
+ * ref for the layout effect to watch, and by the time the object exists the
+ * layout effect has already run.
+ *
+ * Returns two stable callables, so they can be used inside an effect without
+ * appearing in its dependency array.
+ */
+export function useObjectReadyReporter(source, onObjectReady, onObjectDispose) {
+    const readyRef = useRef(onObjectReady);
+    const disposeRef = useRef(onObjectDispose);
+    const sourceRef = useRef(source);
+    readyRef.current = onObjectReady;
+    disposeRef.current = onObjectDispose;
+    sourceRef.current = source;
+    const report = useCallback((object) => {
+        if (object)
+            readyRef.current?.(sourceRef.current, object);
+    }, []);
+    const reportDisposed = useCallback((object) => {
+        if (object)
+            disposeRef.current?.(sourceRef.current, object);
+    }, []);
+    return { report, reportDisposed };
+}
+export default useObjectReady;