@3driseai/3drise-viewer 0.1.28 → 0.1.29

package/dist/components/AdvancedGrid.js

@@ -6,40 +6,11 @@ import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
 import { useCallback, useLayoutEffect, useMemo, useRef } from 'react';
 import * as THREE from 'three';
-import { MyGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { MyGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <myGridMaterial> via extend() in MyGridMaterial.ts.
 void MyGridMaterial;
-/**
- * MyGridConfig — the single source of truth for a grid instance.
- * Colors are hex strings so they round-trip cleanly through the controller
- * and any preset/serialization layer.
- */
-export const defaultMyGridConfig = {
-    cellSize: 1,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 2, // flow
-    cellMode: 2, // twinkle
-    lineWidth: 1,
-    sectionSize: 5,
-    sectionWidth: 1.6,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.65,
-    displace: 0,
-    lineColor: '#477fb8',
-    sectionColor: '#80c7ff',
-    cellColor: '#1a5999',
-    glowColor: '#339eff',
-    bgColor: '#05080d',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** MyGridConfig defaults: the core registry entry (DEFAULT_GRIDS.advancedGrid), never a copy. */
+export const defaultMyGridConfig = DEFAULT_GRIDS.advancedGrid;
 /** No knobs of its own: the shared surface knobs are all there is. */
 const VARIANT = [];
 /** No computed uniforms: every knob maps straight to its u_<key>. */
@@ -56,13 +27,13 @@ export function AdvancedGrid({ config = defaultMyGridConfig, groupProps, id, key
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultMyGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0 ? Math.max(64, Math.ceil(size / cellSize) * 2) : 1);
     // Shared with every other shader-plane grid. This also fixes the pointer
     // projection: it used to assume the XZ plane, so `followMouse` picked
     // against the wrong plane whenever `flat` was false or a parent transform
     // had rotated the grid.
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -75,6 +46,6 @@ export function AdvancedGrid({ config = defaultMyGridConfig, groupProps, id, key
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    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("myGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, MyGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("myGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, MyGridMaterial.key)] }) }));
 }
 export default AdvancedGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiFvD,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAO7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAuFvD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/components/AnimatedObject.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
-import { useRef, useEffect, useCallback, memo } from 'react';
+import { useRef, useEffect, useCallback, useMemo, memo } from 'react';
+import { objectEffectClipOf, objectEffectStepsOf, objectTakesVisualEffects, DEFAULT_EFFECT_SPREAD } from '@3driseai/3drise-core';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
 import { useObjectEffectLayers } from '../operations/useObjectEffectLayers.js';
 import { useObjectAnimation } from '../hooks/useObjectAnimation.js';
@@ -40,7 +41,11 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
         hovered,
     }, groupRef);
     // Effects layered on the object (frost, metalize…) — switched on / off, held while on.
-    useObjectEffectLayers(groupRef, createdObject.effects);
+    const effectClip = objectEffectClipOf(createdObject);
+    const effectSteps = useMemo(() => objectEffectStepsOf(effectClip), [effectClip.steps, effectClip.loop, effectClip.yoyo]);
+    // a group hands its effects to its children (its spread, or the default stagger)
+    const groupSpread = createdObject.type === 'group' ? (effectClip.spread ?? DEFAULT_EFFECT_SPREAD) : null;
+    useObjectEffectLayers(groupRef, effectClip.effects, visible, effectSteps, effectClip.parts, !!effectClip.visible, groupSpread);
     const { startPathAnimation, updatePathAnimation, isAnimating: isPathAnimating } = usePathAnimation();
     const syncTransform = useCallback(() => {
         const obj = groupRef.current;
@@ -70,9 +75,9 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
                 //  onClick={onClick}
                 // onPointerEnter={onPointerEnter}
                 // onPointerLeave={onPointerLeave}
-                name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: children }) });
+                name: createdObject.meshSettings.name, "userData-id": createdObject.id, "userData-objectType": createdObject.type, "userData-visualFx": objectTakesVisualEffects(createdObject), children: children }) });
     }
-    return (_jsx("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: children }));
+    return (_jsx("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, "userData-id": createdObject.id, "userData-objectType": createdObject.type, "userData-visualFx": objectTakesVisualEffects(createdObject), children: children }));
 });
 AnimatedObject.displayName = 'AnimatedObject';
 export default AnimatedObject;

package/dist/components/ApollonianGrid.d.ts

@@ -12,7 +12,7 @@ export interface ApollonianGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ApollonianGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ApollonianGridConfig defaults: the core registry entry (DEFAULT_GRIDS.apollonianGrid), never a copy. */
 export declare const defaultApollonianGridConfig: ApollonianGridConfig;
 /**
  * An Apollonian gasket by circle inversion: a point is walked out of nested gaps through the four dual circles, so every tangent circle gets a pixel-true rim. A slow Möbius disk flow re-balances the packing while every tangency holds.

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

@@ -1 +1 @@
-{"version":3,"file":"ApollonianGrid.d.ts","sourceRoot":"","sources":["../../src/components/ApollonianGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,iGAAiG;AACjG,eAAO,MAAM,2BAA2B,EAAE,oBAyBzC,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAoC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,mBAAmB,+BA4CjK;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ApollonianGrid.d.ts","sourceRoot":"","sources":["../../src/components/ApollonianGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,2GAA2G;AAC3G,eAAO,MAAM,2BAA2B,EAA8C,oBAAoB,CAAC;AAW3G;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAoC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,mBAAmB,+BA4CjK;AAED,eAAe,cAAc,CAAC"}

package/dist/components/ApollonianGrid.js

@@ -6,36 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ApollonianGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ApollonianGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <apollonianGridMaterial> via extend().
 void ApollonianGridMaterial;
-/** ApollonianGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultApollonianGridConfig = {
-    cellSize: 2,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 1,
-    lineWidth: 1.1,
-    sectionSize: 2,
-    sectionWidth: 2,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.15,
-    displace: 0,
-    depth: 12,
-    morph: 0.25,
-    lineColor: '#6a90c8',
-    sectionColor: '#c9e4ff',
-    cellColor: '#1a2f5c',
-    glowColor: '#8fb8ff',
-    bgColor: '#03050c',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ApollonianGridConfig defaults: the core registry entry (DEFAULT_GRIDS.apollonianGrid), never a copy. */
+export const defaultApollonianGridConfig = DEFAULT_GRIDS.apollonianGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['depth', 'morph'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/ChladniGrid.d.ts

@@ -12,7 +12,7 @@ export interface ChladniGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ChladniGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ChladniGridConfig defaults: the core registry entry (DEFAULT_GRIDS.chladniGrid), never a copy. */
 export declare const defaultChladniGridConfig: ChladniGridConfig;
 export declare function ChladniGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: ChladniGridProps): import("react").JSX.Element;
 export default ChladniGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"ChladniGrid.d.ts","sourceRoot":"","sources":["../../src/components/ChladniGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,EAAE,iBA6BtC,CAAC;AAcF,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ChladniGrid.d.ts","sourceRoot":"","sources":["../../src/components/ChladniGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAclG,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/ChladniGrid.js

@@ -6,40 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ChladniGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ChladniGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <chladniGridMaterial> via extend().
 void ChladniGridMaterial;
-/** ChladniGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultChladniGridConfig = {
-    cellSize: 8,
-    size: 50,
-    flat: true,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 2,
-    lineWidth: 1.2,
-    sectionSize: 1,
-    sectionWidth: 0.8,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.6,
-    displace: 0,
-    modeN: 3,
-    modeM: 5,
-    morph: 0.4,
-    grain: 0.8,
-    lineColor: '#d9c7a3',
-    sectionColor: '#4d5d6e',
-    cellColor: '#16222e',
-    glowColor: '#ffe2a8',
-    bgColor: '#06080b',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ChladniGridConfig defaults: the core registry entry (DEFAULT_GRIDS.chladniGrid), never a copy. */
+export const defaultChladniGridConfig = DEFAULT_GRIDS.chladniGrid;
 /**
  * Chladni plates: the nodal lines of a standing wave on a square plate, with sand settling on them, drifting slowly between two neighbouring resonances.
  */
@@ -59,10 +30,10 @@ export function ChladniGrid({ config = defaultChladniGridConfig, groupProps, id,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultChladniGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // the displacement is the standing wave itself, so the mesh has to resolve every mode
     const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 48)) : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -75,6 +46,6 @@ export function ChladniGrid({ config = defaultChladniGridConfig, groupProps, id,
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    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("chladniGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ChladniGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("chladniGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ChladniGridMaterial.key)] }) }));
 }
 export default ChladniGrid;

package/dist/components/CircuitGrid.d.ts

@@ -12,7 +12,7 @@ export interface CircuitGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** CircuitGridConfig — the single source of truth for a circuit grid instance. */
+/** CircuitGridConfig defaults: the core registry entry (DEFAULT_GRIDS.circuitGrid), never a copy. */
 export declare const defaultCircuitGridConfig: CircuitGridConfig;
 export declare function CircuitGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: CircuitGridProps): import("react").JSX.Element;
 export default CircuitGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"CircuitGrid.d.ts","sourceRoot":"","sources":["../../src/components/CircuitGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAE,iBA4BtC,CAAC;AAqBF,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA6CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"CircuitGrid.d.ts","sourceRoot":"","sources":["../../src/components/CircuitGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAqBlG,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA6CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/CircuitGrid.js

@@ -6,39 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { CircuitGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { CircuitGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <circuitGridMaterial> via extend().
 void CircuitGridMaterial;
-/** CircuitGridConfig — the single source of truth for a circuit grid instance. */
-export const defaultCircuitGridConfig = {
-    cellSize: 1.6,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 2, // signal pulses running along the traces
-    cellMode: 0,
-    lineWidth: 1.6,
-    sectionSize: 6,
-    sectionWidth: 1.2,
-    animSpeed: 1,
-    animScale: 1,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    powered: 0.65,
-    chipChance: 0.06,
-    padSize: 1,
-    lineColor: '#186b5c',
-    sectionColor: '#8cf0b4',
-    cellColor: '#082420',
-    glowColor: '#59ffb8',
-    bgColor: '#020806',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** CircuitGridConfig defaults: the core registry entry (DEFAULT_GRIDS.circuitGrid), never a copy. */
+export const defaultCircuitGridConfig = DEFAULT_GRIDS.circuitGrid;
 /**
  * A Truchet circuit board on a shader plane.
  *
@@ -65,11 +37,11 @@ export function CircuitGrid({ config = defaultCircuitGridConfig, groupProps, id,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultCircuitGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0
         ? Math.min(256, Math.max(64, Math.ceil(size / Math.max(cellSize, 1e-4)) * 2))
         : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -82,6 +54,6 @@ export function CircuitGrid({ config = defaultCircuitGridConfig, groupProps, id,
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    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("circuitGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, CircuitGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("circuitGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, CircuitGridMaterial.key)] }) }));
 }
 export default CircuitGrid;

package/dist/components/ConformalGrid.d.ts

@@ -12,7 +12,7 @@ export interface ConformalGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ConformalGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ConformalGridConfig defaults: the core registry entry (DEFAULT_GRIDS.conformalGrid), never a copy. */
 export declare const defaultConformalGridConfig: ConformalGridConfig;
 /**
  * A square lattice pulled back through an ideal-flow complex potential. Cauchy–Riemann keeps every cell square; colour is the flow speed, alternate stream tubes carry dye and hydrogen-bubble dashes ride the flow.

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

@@ -1 +1 @@
-{"version":3,"file":"ConformalGrid.d.ts","sourceRoot":"","sources":["../../src/components/ConformalGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,gGAAgG;AAChG,eAAO,MAAM,0BAA0B,EAAE,mBA+BxC,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BAsD9J;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ConformalGrid.d.ts","sourceRoot":"","sources":["../../src/components/ConformalGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,EAA6C,mBAAmB,CAAC;AAWxG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BAsD9J;AAED,eAAe,aAAa,CAAC"}

package/dist/components/ConformalGrid.js

@@ -7,42 +7,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ConformalGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ConformalGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <conformalGridMaterial> via extend().
 void ConformalGridMaterial;
-/** ConformalGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultConformalGridConfig = {
-    cellSize: 2,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 1,
-    sectionSize: 4,
-    sectionWidth: 1.4,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.8,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    flowMap: 2,
-    poleSpread: 6,
-    spokes: 24,
-    arms: 3,
-    circulation: 1.2,
-    drift: 0.35,
-    fill: 0.5,
-    dye: 0.8,
-    lineColor: '#2fb6c9',
-    sectionColor: '#c8fff4',
-    cellColor: '#1a2a78',
-    glowColor: '#9ff0ff',
-    bgColor: '#020a0f',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ConformalGridConfig defaults: the core registry entry (DEFAULT_GRIDS.conformalGrid), never a copy. */
+export const defaultConformalGridConfig = DEFAULT_GRIDS.conformalGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['flowMap', 'poleSpread', 'spokes', 'arms', 'circulation', 'drift', 'fill', 'dye'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/ContourGrid.d.ts

@@ -12,7 +12,7 @@ export interface ContourGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ContourGridConfig — the single source of truth for a contour grid instance. */
+/** ContourGridConfig defaults: the core registry entry (DEFAULT_GRIDS.contourGrid), never a copy. */
 export declare const defaultContourGridConfig: ContourGridConfig;
 export declare function ContourGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: ContourGridProps): import("react").JSX.Element;
 export default ContourGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"ContourGrid.d.ts","sourceRoot":"","sources":["../../src/components/ContourGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAE,iBA4BtC,CAAC;AAwBF,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA+CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ContourGrid.d.ts","sourceRoot":"","sources":["../../src/components/ContourGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAwBlG,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA+CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/ContourGrid.js

@@ -6,39 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { ContourGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ContourGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <contourGridMaterial> via extend().
 void ContourGridMaterial;
-/** ContourGridConfig — the single source of truth for a contour grid instance. */
-export const defaultContourGridConfig = {
-    cellSize: 14,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 0,
-    cellMode: 1, // elevation tint
-    lineWidth: 1,
-    sectionSize: 5,
-    sectionWidth: 2.2,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    levels: 16,
-    roughness: 0.5,
-    warp: 0.35,
-    lineColor: '#59d9b3',
-    sectionColor: '#bff299',
-    cellColor: '#1a5c52',
-    glowColor: '#8cffbf',
-    bgColor: '#020a0a',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ContourGridConfig defaults: the core registry entry (DEFAULT_GRIDS.contourGrid), never a copy. */
+export const defaultContourGridConfig = DEFAULT_GRIDS.contourGrid;
 /**
  * Topographic iso-lines over a drifting terrain field — minor contours every
  * step, index contours every `sectionSize`.
@@ -68,13 +40,13 @@ export function ContourGrid({ config = defaultContourGridConfig, groupProps, id,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultContourGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // Terrain needs a far denser mesh than the lattice grids: the silhouette is
     // the whole point, and it is only as good as the tessellation carrying it.
     const segs = segments ?? (displace > 0
         ? Math.min(384, Math.max(128, Math.ceil(size / Math.max(cellSize, 1e-4)) * 48))
         : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -87,6 +59,6 @@ export function ContourGrid({ config = defaultContourGridConfig, groupProps, id,
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    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("contourGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ContourGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("contourGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, ContourGridMaterial.key)] }) }));
 }
 export default ContourGrid;

package/dist/components/CustomPrimitive.js

@@ -74,7 +74,7 @@ const CustomPrimitive = memo(({ createdObject, slot = 0, onObjectReady, onObject
     // ModelPrimitive owns its own ref and reports readiness: the meshRef above stays null
     // for a model, so the useObjectReady call at the top of this component is a no-op here
     // and cannot double-report alongside it.
-    return _jsx(ModelBoundary, { label: `${createdObject.name} (${createdObject.id})${slot ? ` slot ${slot}` : ''}`, children: _jsx(ModelPrimitive, { createdObject: createdObject, slot: slot, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, children: useDreiMaterials && createdObject.meshSettings.visible && (_jsx(MaterialLibrary, { materialSettings: createdObject.materialSettings })) }) });
+    return _jsx(ModelBoundary, { objectId: createdObject.id, label: `${createdObject.name} (${createdObject.id})${slot ? ` slot ${slot}` : ''}`, children: _jsx(ModelPrimitive, { createdObject: createdObject, slot: slot, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, children: useDreiMaterials && createdObject.meshSettings.visible && (_jsx(MaterialLibrary, { materialSettings: createdObject.materialSettings })) }) });
 });
 CustomPrimitive.displayName = 'CustomPrimitive';
 export default CustomPrimitive;

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

@@ -1 +1 @@
-{"version":3,"file":"EnvironmentObject.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC7C,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAGF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAUvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"EnvironmentObject.d.ts","sourceRoot":"","sources":["../../src/components/EnvironmentObject.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAA2C,MAAM,uBAAuB,CAAC;AAC5G,KAAK,sBAAsB,GAAG,gBAAgB,GAAG;IAC7C,aAAa,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAKF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAcvD,CAAC;AACF,eAAe,iBAAiB,CAAC"}

package/dist/components/EnvironmentObject.js

@@ -1,14 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import Rain from './Rain.js';
+import { Snow, Sandstorm, Rainbow, Tornado, Thunderstorm, Rain } from './environment/index.js';
+/** The environment family's components by config.type. */
+const FAMILY = { snow: Snow, sandstorm: Sandstorm, rainbow: Rainbow, tornado: Tornado, thunderstorm: Thunderstorm, rain: Rain };
 const EnvironmentObject = ({ createdObject, onObjectReady, onObjectDispose }) => {
     const config = createdObject.config;
     if (!config || config.enabled === false)
         return null;
-    switch (config.type) {
-        case 'rain':
-            return _jsx(Rain, { settings: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose });
-        default:
-            return null;
-    }
+    const type = config.type;
+    const Component = FAMILY[type];
+    if (!Component)
+        return null;
+    // Every family key renders the same way: FAMILY is the only per-key entry.
+    return _jsx(Component, { config: config, id: createdObject.id, keyframes: createdObject.animations?.environment?.animations, mouseMove: createdObject.mouseMove?.environment, onObjectReady: (_source, ref) => onObjectReady?.(createdObject, ref), onObjectDispose: (_source, ref) => onObjectDispose?.(createdObject, ref) });
 };
 export default EnvironmentObject;

package/dist/components/FlowNetGrid.d.ts

@@ -12,7 +12,7 @@ export interface FlowNetGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** FlowNetGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** FlowNetGridConfig defaults: the core registry entry (DEFAULT_GRIDS.flowNetGrid), never a copy. */
 export declare const defaultFlowNetGridConfig: FlowNetGridConfig;
 export declare function FlowNetGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: FlowNetGridProps): import("react").JSX.Element;
 export default FlowNetGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"FlowNetGrid.d.ts","sourceRoot":"","sources":["../../src/components/FlowNetGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,8FAA8F;AAC9F,eAAO,MAAM,wBAAwB,EAAE,iBA4BtC,CAAC;AAcF,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"FlowNetGrid.d.ts","sourceRoot":"","sources":["../../src/components/FlowNetGrid.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,EAA2C,iBAAiB,CAAC;AAclG,wBAAgB,WAAW,CAAC,EAAE,MAAiC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,gBAAgB,+BA4CxJ;AAED,eAAe,WAAW,CAAC"}

package/dist/components/FlowNetGrid.js

@@ -6,39 +6,11 @@ import { useGridSurface } from '../hooks/useGridSurface.js';
 import { useConfigDriver } from '../hooks/useConfigDriver.js';
 import { withConfigDefaults } from '../utils/configAnimations.js';
 import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
-import { FlowNetGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { FlowNetGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <flowNetGridMaterial> via extend().
 void FlowNetGridMaterial;
-/** FlowNetGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultFlowNetGridConfig = {
-    cellSize: 1.5,
-    size: 50,
-    flat: true,
-    segments: undefined,
-    lineMode: 2,
-    cellMode: 1,
-    lineWidth: 1,
-    sectionSize: 5,
-    sectionWidth: 1.6,
-    animSpeed: 1,
-    animScale: 0.6,
-    animIntensity: 0.8,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    obstacleRadius: 3,
-    circulation: 2,
-    flowAngle: 0,
-    lineColor: '#3f8fbf',
-    sectionColor: '#9fe3ff',
-    cellColor: '#0c3148',
-    glowColor: '#5fd0ff',
-    bgColor: '#02070b',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** FlowNetGridConfig defaults: the core registry entry (DEFAULT_GRIDS.flowNetGrid), never a copy. */
+export const defaultFlowNetGridConfig = DEFAULT_GRIDS.flowNetGrid;
 /**
  * Potential flow past a cylinder with circulation, drawn as a flow net: streamlines and equipotentials that cross at right angles everywhere and bend around the obstacle.
  */
@@ -58,10 +30,10 @@ export function FlowNetGrid({ config = defaultFlowNetGridConfig, groupProps, id,
     // The committed config over this grid's defaults: every knob has a value to render
     // and for a keyframe or pointer binding to start from.
     const base = useMemo(() => withConfigDefaults(defaultFlowNetGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // a gentle wave only needs a moderate mesh
     const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 4)) : 1);
-    useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
+    useGridSurface(matRef, meshRef, { reveal, revealDuration });
     // One push point for every uniform the config owns: the committed config when the
     // material mounts or the config commits, the merged one while anything overrides it.
     const baseRef = useRef(base);
@@ -74,6 +46,6 @@ export function FlowNetGrid({ config = defaultFlowNetGridConfig, groupProps, id,
     useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
     const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
     useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
-    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("flowNetGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, FlowNetGridMaterial.key)] }) }));
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("flowNetGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, FlowNetGridMaterial.key)] }) }));
 }
 export default FlowNetGrid;