@3driseai/3drise-viewer 0.1.5 → 0.1.7

package/dist/components/PointCloud.js

@@ -4,7 +4,8 @@ import { useEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import { useParticlesColors } from '../hooks/useParticlesColors.js';
 import { useParticlesTextures } from '../hooks/useParticlesTextures.js';
-import { buildShaderEffectsMaterial, structureKey } from '@3driseai/3drise-core';
+import { buildShaderEffectsMaterial, structureKey, SELF_OWNED_MATERIAL_KEY, applyVertexEffects, partitionShaderEffects, LOCAL_POINTER_SCALE } from '@3driseai/3drise-core';
+import { ownsShaderEffectsMaterial } from '../utils/pointsMaterialOwnership.js';
 import { update3driseShaderUniforms } from '../hooks/use3driseShader.js';
 function normalizeEffects(raw) {
     return Array.isArray(raw) ? raw : [];
@@ -77,27 +78,66 @@ const PointCloud = ({ positions, materialSettings, animations, onObjectReady, on
     const activeEffects = useMemo(() => normalizeEffects(animations?.material?.shaderEffects), [animations?.material?.shaderEffects]);
     const pointerRadius = animations?.material
         ?.shaderEffectsPointerRadius ?? 0.4;
-    const effectsKey = useMemo(() => structureKey(activeEffects), [activeEffects]);
-    const material = useMemo(() => buildShaderEffectsMaterial({
-        effects: activeEffects,
+    // Position effects displace the geometry from the CPU and leave `.material`
+    // alone, so they compose with any material. Only the rest still need the
+    // shader shell — and only the shell takes ownership of `.material`.
+    const { position: positionEffects, shell: shellEffects } = useMemo(() => partitionShaderEffects(activeEffects), [activeEffects]);
+    const hasPositionEffects = positionEffects.some(effect => effect.enabled);
+    const effectsKey = useMemo(() => structureKey(shellEffects), [shellEffects]);
+    const ownsMaterial = ownsShaderEffectsMaterial(materialSettings, shellEffects);
+    // A separate buffer to displace into, so `positions` stays the authored
+    // baseline and effects never accumulate frame over frame.
+    const displayPositions = useMemo(() => (hasPositionEffects && positions ? new Float32Array(positions) : positions), [positions, hasPositionEffects]);
+    const material = useMemo(() => ownsMaterial ? buildShaderEffectsMaterial({
+        effects: shellEffects,
         initialColor: color,
         initialOpacity: opacity,
         initialPointSize: pointSize,
         initialParticleUVScale: particleUVScale,
         initialPointerEffectRadius: pointerRadius,
-    }), 
+    }) : null, 
     // Rebuild when the structural set of effects changes; not on parameter tweaks.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [effectsKey]);
+    [effectsKey, ownsMaterial]);
     useEffect(() => {
         materialRef.current = material;
         return () => {
-            material.dispose();
+            material?.dispose();
         };
     }, [material]);
+    // Tell useMaterialApplication's traversal to leave this object alone while we
+    // own its material. Set imperatively rather than through a `userData` prop:
+    // R3F replaces the whole object on every render, which would wipe the
+    // applyTexture handle stashed above.
+    useEffect(() => {
+        const points = pointsRef.current;
+        if (!points)
+            return;
+        points.userData[SELF_OWNED_MATERIAL_KEY] = ownsMaterial;
+        return () => {
+            if (points.userData)
+                delete points.userData[SELF_OWNED_MATERIAL_KEY];
+        };
+    }, [ownsMaterial]);
     useFrame((state, delta) => {
+        const points = pointsRef.current;
+        if (!points)
+            return;
+        if (hasPositionEffects && displayPositions !== positions) {
+            const moved = applyVertexEffects(positions, displayPositions, positionEffects, {
+                time: state.clock.getElapsedTime(),
+                pointerX: state.pointer.x * LOCAL_POINTER_SCALE,
+                pointerY: state.pointer.y * LOCAL_POINTER_SCALE,
+                pointerRadius: pointerRadius * LOCAL_POINTER_SCALE,
+            });
+            if (moved) {
+                const attribute = points.geometry?.attributes?.position;
+                if (attribute)
+                    attribute.needsUpdate = true;
+            }
+        }
         const mat = materialRef.current;
-        if (!mat || !pointsRef.current)
+        if (!mat)
             return;
         handleColorsAnimation(materialRef, delta, speed);
         if (prevTexture.current)
@@ -106,10 +146,10 @@ const PointCloud = ({ positions, materialSettings, animations, onObjectReady, on
             mat.uniforms.uTargetTexture.value = currentTexture.current;
         mat.uniforms.uHasTexture.value = !!currentTexture.current;
         handleTextureAnimation(materialRef, delta, speed);
-        update3driseShaderUniforms(mat.uniforms, activeEffects, state.clock.getElapsedTime(), { x: state.pointer.x, y: state.pointer.y }, { pointerRadius });
+        update3driseShaderUniforms(mat.uniforms, shellEffects, state.clock.getElapsedTime(), { x: state.pointer.x, y: state.pointer.y }, { pointerRadius });
     });
     if (!positions)
         return null;
-    return (_jsxs("points", { ref: pointsRef, raycast: () => null, position: [0, 0, 0], rotation: [0, 0, 0], scale: [1, 1, 1], children: [_jsxs("bufferGeometry", { children: [_jsx("bufferAttribute", { attach: "attributes-position", count: positions.length / 3, array: positions, itemSize: 3, args: [positions, 3] }), uvs && (_jsx("bufferAttribute", { attach: "attributes-aUV", count: uvs.length / 2, array: uvs, itemSize: 2, args: [uvs, 2] }))] }), _jsx("primitive", { object: material, attach: "material" })] }));
+    return (_jsxs("points", { ref: pointsRef, raycast: () => null, position: [0, 0, 0], rotation: [0, 0, 0], scale: [1, 1, 1], children: [_jsxs("bufferGeometry", { children: [_jsx("bufferAttribute", { attach: "attributes-position", count: displayPositions.length / 3, array: displayPositions, itemSize: 3, args: [displayPositions, 3] }), uvs && (_jsx("bufferAttribute", { attach: "attributes-aUV", count: uvs.length / 2, array: uvs, itemSize: 2, args: [uvs, 2] }))] }), material && _jsx("primitive", { object: material, attach: "material" })] }));
 };
 export default PointCloud;

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,KAAK,YAAY,GAAG,gBAAgB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAIF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA+EzC,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ProjectLoader.d.ts","sourceRoot":"","sources":["../../src/components/ProjectLoader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,KAAK,YAAY,GAAG,gBAAgB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACtG,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC,CAAC;AAGF,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAqDzC,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/ProjectLoader.js

@@ -5,7 +5,6 @@ import SceneBuilder from "./SceneBuilder.js";
 import { loadAssets, } from "@3driseai/3drise-core";
 import LoadingIndicator from "./LoadingIndicator.js";
 import { useMeshController } from "../hooks/useMeshController.js";
-const PROJECT_LOADER_DEBUG_PREFIX = '[ProjectLoaderDebug]';
 const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick, onElementHover, onSceneInitialized, onObjectReady, onObjectDispose, loadingIndicator = _jsx(LoadingIndicator, { text: "Loading project...", fullScreen: true, animate: true }) }) => {
     const [project, setProject] = useState(null);
     const meshController = useMeshController();
@@ -17,22 +16,12 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
     const loadProject = async (projectId) => {
         try {
             const url = `${dataCenterServer}projects/${projectId}/view`;
-            console.log(PROJECT_LOADER_DEBUG_PREFIX, 'Fetching project', {
-                projectId,
-                url,
-            });
             const response = await fetch(url, {
                 method: "GET",
                 headers: {
                     "Content-Type": "application/json",
                 },
             });
-            console.log(PROJECT_LOADER_DEBUG_PREFIX, 'Received project response', {
-                projectId,
-                status: response.status,
-                ok: response.ok,
-                url,
-            });
             if (!response.ok) {
                 if (response.status === 404) {
                     throw new Error("Project not found");
@@ -40,36 +29,22 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
                 throw new Error(`HTTP error! status: ${response.status}`);
             }
             const responseData = await response.json();
-            // console.log(PROJECT_LOADER_DEBUG_PREFIX, 'Parsed project payload', {
-            //     projectId,
-            //     sceneObjectsCount: responseData.sceneObjects?.length || 0,
-            //     projectName: responseData.name,
-            // });
-            console.log("Loaded project:", responseData);
             const sceneObjects = responseData.sceneObjects || [];
             const modelObjects = sceneObjects.filter(obj => obj.type === 'model');
             const meshObjects = sceneObjects.filter(obj => obj.type === 'mesh');
-            console.log('Model objects in loaded project:', modelObjects);
             try {
                 const models = modelObjects.map(obj => ({
                     ...obj.userData,
                     id: obj.id,
                 }));
                 await loadAssets(models);
-                console.log('[useLoadProject] Assets loaded for model objects');
             }
             catch (assetError) {
-                console.error('[useLoadProject] Failed to load model assets, continuing with project load:', assetError);
             }
             // meshController.createObjects(meshObjects);
-            console.log("PROJECT LOAD COMPLETE");
             setProject(responseData);
         }
         catch (error) {
-            console.error(PROJECT_LOADER_DEBUG_PREFIX, 'Error fetching project', {
-                projectId,
-                error,
-            });
         }
     };
     if (!project) {
@@ -80,9 +55,6 @@ const ProjectLoader = ({ projectId, onObjectClick, onObjectHover, onElementClick
                 flexDirection: 'column', gap: '1rem'
             }, children: loadingIndicator });
     }
-    console.log(PROJECT_LOADER_DEBUG_PREFIX, 'Rendering SceneBuilder with project', {
-        project
-    });
     return _jsx(_Fragment, { children: _jsx(SceneBuilder, { project: project, onSceneInitialized: onSceneInitialized, onUiElementClick: onElementClick, onUiElementHover: onElementHover, onObjectClick: onObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }) });
 };
 export default ProjectLoader;

package/dist/components/QuasiGrid.d.ts

@@ -0,0 +1,22 @@
+import type { ThreeElements } from '@react-three/fiber';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { QuasiGridConfig } from '../types/gridConfigs';
+export interface QuasiGridProps extends ObjectReadyProps {
+    config?: QuasiGridConfig;
+    groupProps?: ThreeElements['group'];
+}
+/** QuasiGridConfig — the single source of truth for a quasicrystal grid instance. */
+export declare const defaultQuasiGridConfig: QuasiGridConfig;
+/**
+ * An aperiodic quasicrystal lattice, built as a de Bruijn multigrid: `symmetry`
+ * families of evenly spaced parallel lines spread over a half turn.
+ *
+ * Where the angles do not divide the half turn evenly the intersections never
+ * repeat, so unlike every other grid in this package the pattern is genuinely
+ * non-periodic — pan as far as you like and it never comes back around. 5 is
+ * Penrose. 4 and 6 do divide evenly and so come out periodic, which makes them
+ * a useful sanity check rather than a bug.
+ */
+export declare function QuasiGrid({ config, groupProps, onObjectReady, onObjectDispose }: QuasiGridProps): import("react").JSX.Element;
+export default QuasiGrid;
+//# sourceMappingURL=QuasiGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuasiGrid.d.ts","sourceRoot":"","sources":["../../src/components/QuasiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACvC;AAKD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,eA2BpC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BAgExH;AAED,eAAe,SAAS,CAAC"}

package/dist/components/QuasiGrid.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useObjectReady } from '../hooks/useObjectReady.js';
+import { useGridSurface } from '../hooks/useGridSurface.js';
+import { QuasiGridMaterial } from '@3driseai/3drise-core';
+// Side-effect import registers <quasiGridMaterial> via extend().
+void QuasiGridMaterial;
+/** QuasiGridConfig — the single source of truth for a quasicrystal grid instance. */
+export const defaultQuasiGridConfig = {
+    cellSize: 3,
+    size: 50,
+    segments: undefined,
+    flat: true,
+    lineMode: 1, // ripple out from the focus point
+    cellMode: 2, // twinkle
+    lineWidth: 1.2,
+    sectionSize: 5,
+    sectionWidth: 2,
+    animSpeed: 1,
+    animScale: 0.5,
+    animIntensity: 1,
+    fadeDistance: undefined,
+    fadeStrength: 0.7,
+    displace: 0,
+    symmetry: 5, // Penrose
+    phase: 0.2,
+    lineColor: '#8c4d1f',
+    sectionColor: '#ffc759',
+    cellColor: '#381a08',
+    glowColor: '#ffa640',
+    bgColor: '#0d0503',
+    bgOpacity: 0,
+    followMouse: false,
+    reveal: 1,
+    revealDuration: 0,
+};
+/**
+ * An aperiodic quasicrystal lattice, built as a de Bruijn multigrid: `symmetry`
+ * families of evenly spaced parallel lines spread over a half turn.
+ *
+ * Where the angles do not divide the half turn evenly the intersections never
+ * repeat, so unlike every other grid in this package the pattern is genuinely
+ * non-periodic — pan as far as you like and it never comes back around. 5 is
+ * Penrose. 4 and 6 do divide evenly and so come out periodic, which makes them
+ * a useful sanity check rather than a bug.
+ */
+export function QuasiGrid({ config = defaultQuasiGridConfig, groupProps, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    const meshRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const { cellSize, size, segments, flat, lineMode, cellMode, lineWidth, sectionSize, sectionWidth, animSpeed, animScale, animIntensity, fadeDistance, fadeStrength, displace, symmetry, phase, lineColor, sectionColor, cellColor, glowColor, bgColor, bgOpacity, followMouse, reveal, revealDuration, } = config;
+    const segs = segments ?? (displace > 0
+        ? Math.min(256, Math.max(64, Math.ceil(size / Math.max(cellSize, 1e-4)) * 2))
+        : 1);
+    const fade = fadeDistance ?? size * 0.5;
+    const colors = useMemo(() => ({
+        line: new THREE.Color(lineColor),
+        section: new THREE.Color(sectionColor),
+        cell: new THREE.Color(cellColor),
+        glow: new THREE.Color(glowColor),
+        bg: new THREE.Color(bgColor),
+    }), [lineColor, sectionColor, cellColor, glowColor, bgColor]);
+    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("quasiGridMaterial", { ref: matRef, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide, u_cellSize: cellSize, u_lineWidth: lineWidth, u_sectionSize: sectionSize, u_sectionWidth: sectionWidth, u_lineMode: lineMode, u_cellMode: cellMode, u_animSpeed: animSpeed, u_animScale: animScale, u_animIntensity: animIntensity, u_fadeDistance: fade, u_fadeStrength: fadeStrength, u_displace: displace, u_symmetry: Math.max(3, Math.min(9, symmetry)), u_phase: phase, u_lineColor: colors.line, u_sectionColor: colors.section, u_cellColor: colors.cell, u_glowColor: colors.glow, u_bgColor: colors.bg, u_bgOpacity: bgOpacity }, QuasiGridMaterial.key)] }) }));
+}
+export default QuasiGrid;

package/dist/components/RadarGrid.d.ts

@@ -0,0 +1,24 @@
+import type { ThreeElements } from '@react-three/fiber';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { RadarGridConfig } from '../types/gridConfigs';
+export interface RadarGridProps extends ObjectReadyProps {
+    config?: RadarGridConfig;
+    groupProps?: ThreeElements['group'];
+}
+/** RadarGridConfig — the single source of truth for a radar grid instance. */
+export declare const defaultRadarGridConfig: RadarGridConfig;
+/**
+ * A polar HUD — concentric rings and radial spokes instead of an X/Y lattice,
+ * masked to a disc of `fadeDistance` rather than filling its square plane.
+ *
+ * A sweep arm rotates with a decaying trail, contacts light as it crosses them
+ * and fade until it comes back around, and `lineMode` 1 sends ping rings out
+ * from the focus point. Set `sweepWidth` to 0 for a static instrument face,
+ * `spokes` to 0 for rings only.
+ *
+ * Note that `fadeDistance` is the disc radius here, so keep `size` at least
+ * twice it or the disc gets clipped by its own plane.
+ */
+export declare function RadarGrid({ config, groupProps, onObjectReady, onObjectDispose }: RadarGridProps): import("react").JSX.Element;
+export default RadarGrid;
+//# sourceMappingURL=RadarGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RadarGrid.d.ts","sourceRoot":"","sources":["../../src/components/RadarGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACvC;AAKD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,eA4BpC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BAiExH;AAED,eAAe,SAAS,CAAC"}

package/dist/components/RadarGrid.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useObjectReady } from '../hooks/useObjectReady.js';
+import { useGridSurface } from '../hooks/useGridSurface.js';
+import { RadarGridMaterial } from '@3driseai/3drise-core';
+// Side-effect import registers <radarGridMaterial> via extend().
+void RadarGridMaterial;
+/** RadarGridConfig — the single source of truth for a radar grid instance. */
+export const defaultRadarGridConfig = {
+    cellSize: 2.5,
+    size: 50,
+    segments: undefined,
+    flat: true,
+    lineMode: 1, // ping rings expanding from the focus point
+    cellMode: 0,
+    lineWidth: 1,
+    sectionSize: 4,
+    sectionWidth: 1.8,
+    animSpeed: 1,
+    animScale: 0.5,
+    animIntensity: 1,
+    fadeDistance: 24,
+    fadeStrength: 0.25,
+    displace: 0,
+    spokes: 24,
+    sweepWidth: 0.13,
+    blipDensity: 0.08,
+    lineColor: '#1a805a',
+    sectionColor: '#80ffb8',
+    cellColor: '#0d3324',
+    glowColor: '#59ff99',
+    bgColor: '#020d08',
+    bgOpacity: 0.25,
+    followMouse: false,
+    reveal: 1,
+    revealDuration: 0,
+};
+/**
+ * A polar HUD — concentric rings and radial spokes instead of an X/Y lattice,
+ * masked to a disc of `fadeDistance` rather than filling its square plane.
+ *
+ * A sweep arm rotates with a decaying trail, contacts light as it crosses them
+ * and fade until it comes back around, and `lineMode` 1 sends ping rings out
+ * from the focus point. Set `sweepWidth` to 0 for a static instrument face,
+ * `spokes` to 0 for rings only.
+ *
+ * Note that `fadeDistance` is the disc radius here, so keep `size` at least
+ * twice it or the disc gets clipped by its own plane.
+ */
+export function RadarGrid({ config = defaultRadarGridConfig, groupProps, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    const meshRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const { cellSize, size, segments, flat, lineMode, cellMode, lineWidth, sectionSize, sectionWidth, animSpeed, animScale, animIntensity, fadeDistance, fadeStrength, displace, spokes, sweepWidth, blipDensity, lineColor, sectionColor, cellColor, glowColor, bgColor, bgOpacity, followMouse, reveal, revealDuration, } = config;
+    const segs = segments ?? (displace > 0
+        ? Math.min(256, Math.max(64, Math.ceil(size / Math.max(cellSize, 1e-4)) * 4))
+        : 1);
+    const fade = fadeDistance ?? size * 0.5;
+    const colors = useMemo(() => ({
+        line: new THREE.Color(lineColor),
+        section: new THREE.Color(sectionColor),
+        cell: new THREE.Color(cellColor),
+        glow: new THREE.Color(glowColor),
+        bg: new THREE.Color(bgColor),
+    }), [lineColor, sectionColor, cellColor, glowColor, bgColor]);
+    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("radarGridMaterial", { ref: matRef, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide, u_cellSize: cellSize, u_lineWidth: lineWidth, u_sectionSize: sectionSize, u_sectionWidth: sectionWidth, u_lineMode: lineMode, u_cellMode: cellMode, u_animSpeed: animSpeed, u_animScale: animScale, u_animIntensity: animIntensity, u_fadeDistance: fade, u_fadeStrength: fadeStrength, u_displace: displace, u_spokes: spokes, u_sweepWidth: sweepWidth, u_blipDensity: blipDensity, u_lineColor: colors.line, u_sectionColor: colors.section, u_cellColor: colors.cell, u_glowColor: colors.glow, u_bgColor: colors.bg, u_bgOpacity: bgOpacity }, RadarGridMaterial.key)] }) }));
+}
+export default RadarGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CAgIhE,CAAC;AACF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SceneBuilder.d.ts","sourceRoot":"","sources":["../../src/components/SceneBuilder.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,GAAG,gBAAgB,CA+HhE,CAAC;AACF,eAAe,YAAY,CAAC"}

package/dist/components/SceneBuilder.js

@@ -102,7 +102,6 @@ const SceneBuilder = ({ project, width = "100%", height = "100vh", style = {}, c
     //   initializeSceneAssets();
     // }, [meshController, modelObjects, meshObjects]);
     const handleElementClick = (element) => {
-        console.log("Element clicked in scene:", element);
         if (element && onUiElementClick) {
             onUiElementClick(element);
         }

package/dist/components/ShootingStar.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useMemo, useEffect } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { Vector3, BufferGeometry, BufferAttribute, AdditiveBlending, Color } from 'three';
+import { Vector3, BufferGeometry, BufferAttribute, AdditiveBlending } from 'three';
 import { ShootingStarMaterial } from '@3driseai/3drise-core';
 const ShootingStar = ({ position = [0, 0, 0], direction = [1, -1, 0], speed = 0.05, color = '#ffffff', trailLength = 30, size = 0.1, opacity = 1.0, onComplete, maxDistance = 50, followMouse = true, onObjectReady, onObjectDispose, }) => {
     const starRef = useRef(null);
@@ -90,6 +90,6 @@ const ShootingStar = ({ position = [0, 0, 0], direction = [1, -1, 0], speed = 0.
         if (distanceTraveled.current > maxDistance)
             onComplete?.();
     });
-    return (_jsxs("group", { ref: rootRef, children: [_jsx("lineSegments", { ref: trailRef, geometry: trailGeometry, children: _jsx("shootingStarMaterial", { ref: materialRef, attach: "material", transparent: true, blending: AdditiveBlending, depthWrite: false, color: new Color(color), opacity: opacity }, ShootingStarMaterial.key) }), _jsxs("mesh", { ref: starRef, children: [_jsx("sphereGeometry", { args: [size, 8, 8] }), _jsx("meshBasicMaterial", { ref: starMaterialRef, color: color, transparent: true, opacity: opacity, blending: AdditiveBlending, depthWrite: false }), _jsxs("mesh", { ref: glowRef, children: [_jsx("sphereGeometry", { args: [size * 2, 8, 8] }), _jsx("meshBasicMaterial", { ref: glowMaterialRef, color: color, transparent: true, opacity: opacity * 0.3, blending: AdditiveBlending, depthWrite: false })] })] })] }));
+    return (_jsxs("group", { ref: rootRef, children: [_jsx("lineSegments", { ref: trailRef, geometry: trailGeometry, children: _jsx("primitive", { object: materialRef.current || new ShootingStarMaterial(), attach: "material", transparent: true, blending: AdditiveBlending, depthWrite: false }) }), _jsxs("mesh", { ref: starRef, children: [_jsx("sphereGeometry", { args: [size, 8, 8] }), _jsx("meshBasicMaterial", { ref: starMaterialRef, color: color, transparent: true, opacity: opacity, blending: AdditiveBlending, depthWrite: false }), _jsxs("mesh", { ref: glowRef, children: [_jsx("sphereGeometry", { args: [size * 2, 8, 8] }), _jsx("meshBasicMaterial", { ref: glowMaterialRef, color: color, transparent: true, opacity: opacity * 0.3, blending: AdditiveBlending, depthWrite: false })] })] })] }));
 };
 export default ShootingStar;

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

@@ -1 +1 @@
-{"version":3,"file":"ShootingStars.d.ts","sourceRoot":"","sources":["../../src/components/ShootingStars.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,qBAAqB,CAAC;CACnC;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAmC/C,CAAC;AACF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ShootingStars.d.ts","sourceRoot":"","sources":["../../src/components/ShootingStars.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,qBAAqB,CAAC;CACnC;AAGD,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAkC/C,CAAC;AACF,eAAe,aAAa,CAAC"}

package/dist/components/ShootingStars.js

@@ -35,7 +35,6 @@ const ShootingStars = ({ settings, onObjectReady, onObjectDispose }) => {
     }, []);
     if (!settings?.enabled)
         return null;
-    console.log("Rendering ShootingStars with settings:", settings, "and shootingStars:", shootingStars);
     return (_jsx(_Fragment, { children: shootingStars.map(star => (_jsx(ShootingStar, { position: star.position, direction: star.direction, speed: star.speed, color: star.color, trailLength: star.trailLength, size: 0.08, opacity: 0.9, maxDistance: star.length, onComplete: () => handleComplete(star.id), followMouse: settings.followMouse, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, star.id))) }));
 };
 export default ShootingStars;

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

@@ -1 +1 @@
-{"version":3,"file":"SkyController.d.ts","sourceRoot":"","sources":["../../src/components/SkyController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAS7D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;CACtD;AAED,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,kBAAkB,GA2K8H,GAAG,CACtQ;AA6BD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"SkyController.d.ts","sourceRoot":"","sources":["../../src/components/SkyController.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAS7D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEvE,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;CACtD;AAED,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,GAAG,EAAE,kBAAkB,GAwK8H,GAAG,CACtQ;AA6BD,eAAe,aAAa,CAAC"}

package/dist/components/SkyController.js

@@ -33,7 +33,6 @@ function SkyController({ settings, timeSettings, scale = 1000, onSettingsChange,
                 return;
             event.step.transitions.forEach((transition) => {
                 if (transition.state === 'sky' && skyRef.current) {
-                    console.log('Starting sky transition animation', { transition }, skyRef.current.visible);
                     const toProps = transition.properties.to || {};
                     const fromProps = transition.properties.from || {};
                     // Handle `visible` as an immediate boolean switch — not animated
@@ -68,7 +67,6 @@ function SkyController({ settings, timeSettings, scale = 1000, onSettingsChange,
     });
     const handleTimeUpdate = useCallback((state) => {
         const { sunAzimuth, sunElevation, timeInHours } = state;
-        // console.log('SkyController - Time update:', { sunAzimuth, sunElevation, timeInHours });
         const atmosphericParams = calculateSkyParamsForTime(timeInHours);
         const newSettings = {
             ...settings,
@@ -152,7 +150,6 @@ function SkyController({ settings, timeSettings, scale = 1000, onSettingsChange,
         previousSettings.current = { ...newSettings };
     };
     const handleMouseMove = (mouse) => {
-        // console.log(skyRef.current.visible)
         const handlers = settings.handlers;
         if (!handlers || isAnimatingRef.current || !skyRef.current)
             return;

package/dist/components/Skybox.d.ts

@@ -1,6 +1,11 @@
 import type { ObjectReadyProps } from '../types/objectReady';
 import type { TimeSettings } from '@3driseai/3drise-core';
 import React from "react";
+declare module '@react-three/fiber' {
+    interface ThreeElements {
+        skyboxMaterial: any;
+    }
+}
 export interface SkyboxProps extends ObjectReadyProps {
     visible?: boolean;
     scale?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"Skybox.d.ts","sourceRoot":"","sources":["../../src/components/Skybox.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAkDD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAsCjC,CAAC;AACF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Skybox.d.ts","sourceRoot":"","sources":["../../src/components/Skybox.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,QAAQ,oBAAoB,CAAC;IAChC,UAAU,aAAa;QACnB,cAAc,EAAE,GAAG,CAAC;KACvB;CACJ;AAED,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC9B;AAkDD,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAqCjC,CAAC;AACF,eAAe,MAAM,CAAC"}

package/dist/components/Skybox.js

@@ -89,7 +89,6 @@ const Skybox = ({ visible = true, scale = 100000, sunSize = 1, moonSize = 1, tim
     });
     if (!visible)
         return null;
-    // console.log(sunSize)
     return (_jsxs("mesh", { ref: rootRef, scale: scale, children: [_jsx("boxGeometry", { args: [1, 1, 1] }), _jsx("skyboxMaterial", { ref: materialRef, side: THREE.BackSide, depthWrite: false, fog: false })] }));
 };
 export default Skybox;

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

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

package/dist/components/SparklesBurst.js

@@ -5,7 +5,6 @@ import { useFrame } from '@react-three/fiber';
 import * as THREE from 'three';
 import { SparklesBurstMaterial } from '@3driseai/3drise-core';
 const SparklesBurst = ({ config, boundingRadius, onObjectReady, onObjectDispose }) => {
-    // console.log("Rendering SparklesBurst with config:", config, "and boundingRadius:", boundingRadius);
     const planeSize = useMemo(() => Math.max(0.05, config.scale ?? 2.5), [config.scale]);
     const geometry = useMemo(() => new THREE.PlaneGeometry(planeSize, planeSize, 1, 1), [planeSize]);
     const material = useMemo(() => {

package/dist/components/VoronoiGrid.d.ts

@@ -0,0 +1,21 @@
+import type { ThreeElements } from '@react-three/fiber';
+import type { ObjectReadyProps } from '../types/objectReady';
+import type { VoronoiGridConfig } from '../types/gridConfigs';
+export interface VoronoiGridProps extends ObjectReadyProps {
+    config?: VoronoiGridConfig;
+    groupProps?: ThreeElements['group'];
+}
+/** VoronoiGridConfig — the single source of truth for a Voronoi grid instance. */
+export declare const defaultVoronoiGridConfig: VoronoiGridConfig;
+/**
+ * An irregular cellular lattice on a shader plane.
+ *
+ * Seeds drift over time, so the whole lattice slowly morphs rather than
+ * animating in place. `jitter` runs from a regular square lattice (0) to fully
+ * scattered (1); `drift` sets how far the seeds wander. `sectionWidth` draws
+ * the cell nuclei, `sectionSize` groups cells into clusters that share an
+ * accent colour. With `displace > 0` the surface breaks into irregular plates.
+ */
+export declare function VoronoiGrid({ config, groupProps, onObjectReady, onObjectDispose }: VoronoiGridProps): import("react").JSX.Element;
+export default VoronoiGrid;
+//# sourceMappingURL=VoronoiGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VoronoiGrid.d.ts","sourceRoot":"","sources":["../../src/components/VoronoiGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACvC;AAKD,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAE,iBA2BtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BAgE9H;AAED,eAAe,WAAW,CAAC"}

package/dist/components/VoronoiGrid.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useObjectReady } from '../hooks/useObjectReady.js';
+import { useGridSurface } from '../hooks/useGridSurface.js';
+import { VoronoiGridMaterial } from '@3driseai/3drise-core';
+// Side-effect import registers <voronoiGridMaterial> via extend().
+void VoronoiGridMaterial;
+/** VoronoiGridConfig — the single source of truth for a Voronoi grid instance. */
+export const defaultVoronoiGridConfig = {
+    cellSize: 3,
+    size: 50,
+    segments: undefined,
+    flat: true,
+    lineMode: 1, // ripple out from the focus point
+    cellMode: 2, // twinkle
+    lineWidth: 1.4,
+    sectionSize: 4,
+    sectionWidth: 1,
+    animSpeed: 1,
+    animScale: 0.5,
+    animIntensity: 1,
+    fadeDistance: undefined,
+    fadeStrength: 0.7,
+    displace: 0,
+    jitter: 0.9,
+    drift: 0.5,
+    lineColor: '#5a339e',
+    sectionColor: '#d999ff',
+    cellColor: '#1f0d47',
+    glowColor: '#b366ff',
+    bgColor: '#05030d',
+    bgOpacity: 0,
+    followMouse: false,
+    reveal: 1,
+    revealDuration: 0,
+};
+/**
+ * An irregular cellular lattice on a shader plane.
+ *
+ * Seeds drift over time, so the whole lattice slowly morphs rather than
+ * animating in place. `jitter` runs from a regular square lattice (0) to fully
+ * scattered (1); `drift` sets how far the seeds wander. `sectionWidth` draws
+ * the cell nuclei, `sectionSize` groups cells into clusters that share an
+ * accent colour. With `displace > 0` the surface breaks into irregular plates.
+ */
+export function VoronoiGrid({ config = defaultVoronoiGridConfig, groupProps, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    const meshRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const { cellSize, size, segments, flat, lineMode, cellMode, lineWidth, sectionSize, sectionWidth, animSpeed, animScale, animIntensity, fadeDistance, fadeStrength, displace, jitter, drift, lineColor, sectionColor, cellColor, glowColor, bgColor, bgOpacity, followMouse, reveal, revealDuration, } = config;
+    const segs = segments ?? (displace > 0
+        ? Math.min(384, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 6))
+        : 1);
+    const fade = fadeDistance ?? size * 0.5;
+    const colors = useMemo(() => ({
+        line: new THREE.Color(lineColor),
+        section: new THREE.Color(sectionColor),
+        cell: new THREE.Color(cellColor),
+        glow: new THREE.Color(glowColor),
+        bg: new THREE.Color(bgColor),
+    }), [lineColor, sectionColor, cellColor, glowColor, bgColor]);
+    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("voronoiGridMaterial", { ref: matRef, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide, u_cellSize: cellSize, u_lineWidth: lineWidth, u_sectionSize: sectionSize, u_sectionWidth: sectionWidth, u_lineMode: lineMode, u_cellMode: cellMode, u_animSpeed: animSpeed, u_animScale: animScale, u_animIntensity: animIntensity, u_fadeDistance: fade, u_fadeStrength: fadeStrength, u_displace: displace, u_jitter: jitter, u_drift: drift, u_lineColor: colors.line, u_sectionColor: colors.section, u_cellColor: colors.cell, u_glowColor: colors.glow, u_bgColor: colors.bg, u_bgOpacity: bgOpacity }, VoronoiGridMaterial.key)] }) }));
+}
+export default VoronoiGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"ShockwaveEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ShockwaveEffect.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;AAkFD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA4EnD,CAAC;AACF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ShockwaveEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/ShockwaveEffect.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;AAkFD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA2EnD,CAAC;AACF,eAAe,eAAe,CAAC"}

package/dist/components/effects/ShockwaveEffect.js

@@ -130,7 +130,6 @@ const ShockwaveEffect = ({ boundingRadius, config, animations, onObjectReady, on
         side: THREE.DoubleSide,
     })), [ringCount, colorVec, opacity]);
     const radius = boundingRadius;
-    console.log('ShockwaveEffect render with boundingRadius:', boundingRadius, 'and config:', config);
     useFrame((state, delta) => {
         const t = state.clock.getElapsedTime();
         for (let i = 0; i < ringCount; i++) {

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

@@ -1 +1 @@
-{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,2EAAoF,gBAAgB,gCA2DxH,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,2EAAoF,gBAAgB,gCA0DxH,CAAC;AACF,eAAe,WAAW,CAAC"}