@3driseai/3drise-viewer 0.1.28 → 0.1.29

package/dist/components/LensingGrid.js

@@ -6,37 +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 { LensingGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { LensingGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <lensingGridMaterial> via extend().
 void LensingGridMaterial;
-/** LensingGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultLensingGridConfig = {
-    cellSize: 2,
-    size: 50,
-    segments: undefined,
-    lineMode: 1,
-    cellMode: 2,
-    lineWidth: 1.1,
-    sectionSize: 5,
-    sectionWidth: 1.8,
-    animSpeed: 1,
-    animScale: 0.6,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    mass: 4,
-    orbit: 0,
-    ringGlow: 0.8,
-    lineColor: '#2b4f80',
-    sectionColor: '#9fd0ff',
-    cellColor: '#0b1a33',
-    glowColor: '#ffcf8a',
-    bgColor: '#02040a',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** LensingGridConfig defaults: the core registry entry (DEFAULT_GRIDS.lensingGrid), never a copy. */
+export const defaultLensingGridConfig = DEFAULT_GRIDS.lensingGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['mass', 'orbit', 'ringGlow'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

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

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

package/dist/components/LightsManager.js

@@ -5,6 +5,7 @@ import { useFrame, useThree } from '@react-three/fiber';
 import { createSunPosition } from '@3driseai/3drise-core';
 import { Color, } from 'three';
 import { useLightAnimation } from '../hooks/useLightAnimation.js';
+import { skyOwnsSun } from '../utils/renderedSky.js';
 const SUN_DISTANCE = 100;
 const LightsManager = ({ config, onObjectReady, onObjectDispose }) => {
     const { scene } = useThree();
@@ -93,6 +94,13 @@ const LightsManager = ({ config, onObjectReady, onObjectDispose }) => {
         };
     }, [scene]);
     useFrame((state) => {
+        // While a sky is active its key light (SunLight) is the scene's sun; this
+        // general-purpose sun is for scenes without one. Checked per frame, not
+        // via props, because the sky lives in a sibling subtree (EnvironmentManager)
+        // and can come and go without this component re-rendering.
+        if (sunLightRef.current) {
+            sunLightRef.current.visible = !!sunConfig?.enabled && !skyOwnsSun(scene);
+        }
         if (followSun && sunLightRef.current) {
             const time = state.clock.getElapsedTime();
             const slowRotation = time * 0.01;

package/dist/components/ModelBoundary.d.ts

@@ -6,6 +6,8 @@ interface ModelBoundaryProps {
     fallback?: ReactNode;
     /** Identifies the offending object in the console when a load fails. */
     label?: string;
+    /** The model's object id: a failed load tells scene readiness not to wait for it. */
+    objectId?: string;
 }
 interface ModelBoundaryState {
     failed: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"ModelBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ModelBoundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAY,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,UAAU,kBAAkB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,kBAAkB;IACxB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,cAAM,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACzE,KAAK,EAAE,kBAAkB,CAAqB;IAE9C,MAAM,CAAC,wBAAwB,IAAI,kBAAkB;IAIrD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAQtD,MAAM,IAAI,SAAS;CAItB;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ModelBoundary.d.ts","sourceRoot":"","sources":["../../src/components/ModelBoundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAY,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD,UAAU,kBAAkB;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,kBAAkB;IACxB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,cAAM,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACzE,KAAK,EAAE,kBAAkB,CAAqB;IAE9C,MAAM,CAAC,wBAAwB,IAAI,kBAAkB;IAIrD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAStD,MAAM,IAAI,SAAS;CAItB;AAED,eAAe,aAAa,CAAC"}

package/dist/components/ModelBoundary.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Component, Suspense } from 'react';
+import { sceneReadiness } from '../triggers/readiness.js';
 /**
  * Suspense + error boundary around a single model leaf.
  *
@@ -15,6 +16,8 @@ class ModelBoundary extends Component {
     }
     componentDidCatch(error, info) {
         console.error(`[ModelBoundary] Model failed to load${this.props.label ? `: ${this.props.label}` : ''}`, error, info.componentStack);
+        if (this.props.objectId)
+            sceneReadiness.fail(this.props.objectId, error);
     }
     render() {
         if (this.state.failed)

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

@@ -1 +1 @@
-{"version":3,"file":"ModelPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/ModelPrimitive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,aAAa,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA0ChD,CAAC;AAIH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ModelPrimitive.d.ts","sourceRoot":"","sources":["../../src/components/ModelPrimitive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,UAAU,mBAAoB,SAAQ,gBAAgB;IAClD,aAAa,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA8ChD,CAAC;AAIH,eAAe,cAAc,CAAC"}

package/dist/components/ModelPrimitive.js

@@ -5,6 +5,7 @@ import { useNodeOverrides } from '../hooks/useNodeOverrides.js';
 import { getNodeOverrides, peekModelAsset, resolveShadowFlags } from '@3driseai/3drise-core';
 import { useObjectReadyReporter } from '../hooks/useObjectReady.js';
 import { applyShadowFlags } from '../hooks/useShadowApplication.js';
+import { sceneReadiness } from '../triggers/readiness.js';
 /**
  * Mounts the Object3D behind a `type: 'model'` scene object, and hands it to the host
  * application.
@@ -47,11 +48,16 @@ const ModelPrimitive = memo(({ createdObject, slot = 0, onObjectReady, onObjectD
     const shadowFlags = useRef({ cast: false, receive: false });
     const resolved = resolveShadowFlags(createdObject.type, createdObject.meshSettings);
     shadowFlags.current = { cast: resolved.castShadow, receive: resolved.receiveShadow };
+    // Scene readiness counts the object itself (slot 0), not its layout clones.
+    const readyId = useRef('');
+    readyId.current = slot === 0 ? createdObject.id : '';
     const setObjectRef = useCallback((instance) => {
         if (instance) {
             applyShadowFlags(instance, shadowFlags.current.cast, shadowFlags.current.receive);
             attachedRef.current = instance;
             report(instance);
+            if (readyId.current)
+                sceneReadiness.report(readyId.current);
             return;
         }
         if (attachedRef.current) {

package/dist/components/MoireGrid.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"MoireGrid.d.ts","sourceRoot":"","sources":["../../src/components/MoireGrid.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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,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;AAWD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,eA6BpC,CAAC;AAsBF,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"MoireGrid.d.ts","sourceRoot":"","sources":["../../src/components/MoireGrid.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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACpD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,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;AAWD,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,EAAyC,eAAe,CAAC;AAsB5F,wBAAgB,SAAS,CAAC,EAAE,MAA+B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,cAAc,+BA6ClJ;AAED,eAAe,SAAS,CAAC"}

package/dist/components/MoireGrid.js

@@ -6,7 +6,7 @@ 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 { MoireGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { MoireGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <moireGridMaterial> via extend().
 void MoireGridMaterial;
 const SHAPE_INDEX = {
@@ -14,37 +14,8 @@ const SHAPE_INDEX = {
     hex: 1,
     rings: 2,
 };
-/** MoireGridConfig — the single source of truth for a moire grid instance. */
-export const defaultMoireGridConfig = {
-    cellSize: 2.8,
-    size: 50,
-    segments: undefined,
-    flat: true,
-    lineMode: 0,
-    cellMode: 2, // steady nodes; the interference carries the motion
-    lineWidth: 1.4,
-    sectionSize: 12,
-    sectionWidth: 0,
-    animSpeed: 1,
-    animScale: 1,
-    animIntensity: 1,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    shape: 'square',
-    layerAngle: 0.05,
-    layerScale: 1.06,
-    spin: 1,
-    lineColor: '#226bd9',
-    sectionColor: '#f2599e',
-    cellColor: '#0d1a40',
-    glowColor: '#99d9ff',
-    bgColor: '#02040d',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** MoireGridConfig defaults: the core registry entry (DEFAULT_GRIDS.moireGrid), never a copy. */
+export const defaultMoireGridConfig = DEFAULT_GRIDS.moireGrid;
 /**
  * Two overlaid lattices, counter-rotating.
  *
@@ -72,11 +43,11 @@ export function MoireGrid({ config = defaultMoireGridConfig, 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(defaultMoireGridConfig, 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);
@@ -89,6 +60,6 @@ export function MoireGrid({ config = defaultMoireGridConfig, 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("moireGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, MoireGridMaterial.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("moireGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, MoireGridMaterial.key)] }) }));
 }
 export default MoireGrid;

package/dist/components/MoonDisc.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { SkySettings, TimeSettings } from '@3driseai/3drise-core';
+export interface MoonDiscProps {
+    timeSettings: TimeSettings;
+    skySettings?: SkySettings;
+    /** Multiplier on the disc's apparent size. */
+    size?: number;
+}
+declare const MoonDisc: React.FC<MoonDiscProps>;
+export default MoonDisc;
+//# sourceMappingURL=MoonDisc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MoonDisc.d.ts","sourceRoot":"","sources":["../../src/components/MoonDisc.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIvE,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA+ED,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAoDrC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/components/MoonDisc.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+import { useCloudSun } from '../hooks/useCloudSun.js';
+import { resolveMoon } from '../utils/skyMoon.js';
+/**
+ * The moon in the sky, for either sky renderer.
+ *
+ * A camera-facing quad placed toward the moon just inside the far plane, so the
+ * sky (drawn at the far plane) is behind it and terrain and objects occlude it.
+ * The disc is shaded as a sphere lit by the real sun direction, so the phase —
+ * crescent, quarter, gibbous, full, and which side is lit — falls out of where
+ * the sun is rather than being drawn. Additive over the sky: pale by day, bright
+ * with a soft halo at night.
+ *
+ * Position and phase come from resolveMoon, the same source as the moonlight.
+ */
+/** Real angular diameter is 0.52°; a true-size moon reads as a dot on a screen. */
+const MOON_ANGULAR_DIAMETER_DEG = 0.52 * 4;
+/** Quad half-size in disc radii — room for the wide glow. */
+const SPAN = 8.0;
+const vertexShader = /* glsl */ `
+varying vec2 vUv;
+void main() {
+    vUv = uv * 2.0 - 1.0;
+    gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}
+`;
+const fragmentShader = /* glsl */ `
+uniform vec3 uSunLocal;
+uniform float uNight;
+uniform float uIllum;
+varying vec2 vUv;
+
+float hash(vec2 p) { return fract(sin(dot(p, vec2(127.1, 311.7))) * 43758.5453); }
+float noise(vec2 p) {
+    vec2 i = floor(p), f = fract(p);
+    vec2 u = f * f * (3.0 - 2.0 * f);
+    return mix(mix(hash(i), hash(i + vec2(1, 0)), u.x), mix(hash(i + vec2(0, 1)), hash(i + vec2(1, 1)), u.x), u.y);
+}
+float fbm(vec2 p) {
+    float v = 0.0, a = 0.5;
+    for (int i = 0; i < 5; i++) { v += a * noise(p); p = p * 2.03 + 17.1; a *= 0.5; }
+    return v;
+}
+
+void main() {
+    vec2 p = vUv * ${SPAN.toFixed(1)};
+    float r = length(p);
+    float aa = fwidth(r) * 1.5;
+    float disc = 1.0 - smoothstep(1.0 - aa, 1.0 + aa, r);
+
+    // The visible hemisphere as a sphere facing the camera (z toward the viewer).
+    vec3 n = vec3(p, sqrt(max(0.0, 1.0 - r * r)));
+    float lit = smoothstep(-0.04, 0.10, dot(n, uSunLocal));
+
+    // Maria: dark low-frequency patches; fine grain on top.
+    float maria = smoothstep(0.42, 0.62, fbm(n.xy * 2.2 + 3.1));
+    float grain = fbm(n.xy * 14.0) * 0.12;
+    vec3 albedo = mix(vec3(0.58, 0.58, 0.57), vec3(0.96, 0.95, 0.91), maria) * (0.94 + grain);
+    float limb = 0.72 + 0.28 * n.z;
+    vec3 surface = albedo * limb * (lit + 0.03);   // + earthshine on the dark side
+
+    // Glow: a tight corona hugging the limb plus a wide soft bloom — moonlight
+    // scattered by the air around the disc. Scales with how much of the moon is
+    // lit and with the night; gone by day, when the sky out-shines it.
+    float d = max(r - 1.0, 0.0);
+    float glow = (exp(-d * 3.2) * 0.55 + exp(-d * 0.75) * 0.16) * (1.0 - disc);
+    vec3 col = surface * disc * mix(0.45, 1.15, uNight)
+             + vec3(0.72, 0.80, 1.0) * glow * uIllum * uNight;
+    gl_FragColor = vec4(col, 1.0);
+}
+`;
+const smooth01 = (edge0, edge1, x) => {
+    const t = THREE.MathUtils.clamp((x - edge0) / (edge1 - edge0), 0, 1);
+    return t * t * (3 - 2 * t);
+};
+const MoonDisc = ({ timeSettings, skySettings, size = 1 }) => {
+    const meshRef = useRef(null);
+    const { update } = useCloudSun({ skySettings, timeSettings });
+    const moon = useRef({ direction: new THREE.Vector3(), illumination: 1 });
+    const scratch = useMemo(() => ({ q: new THREE.Quaternion(), v: new THREE.Vector3() }), []);
+    const geometry = useMemo(() => new THREE.PlaneGeometry(2, 2), []);
+    const material = useMemo(() => new THREE.ShaderMaterial({
+        uniforms: {
+            uSunLocal: { value: new THREE.Vector3(0, 0, 1) },
+            uNight: { value: 0 },
+            uIllum: { value: 1 },
+        },
+        vertexShader,
+        fragmentShader,
+        transparent: true,
+        depthWrite: false,
+        depthTest: true,
+        blending: THREE.AdditiveBlending,
+        fog: false,
+        toneMapped: false,
+    }), []);
+    useEffect(() => () => { geometry.dispose(); material.dispose(); }, [geometry, material]);
+    useFrame(({ camera }) => {
+        const mesh = meshRef.current;
+        if (!mesh)
+            return;
+        const sunDir = update().direction;
+        const m = resolveMoon(timeSettings, sunDir, moon.current);
+        // Below the horizon there is nothing to draw (and nothing to occlude it).
+        if (m.direction.y < -0.03) {
+            mesh.visible = false;
+            return;
+        }
+        mesh.visible = true;
+        const far = camera.far ?? 1000;
+        const dist = far * 0.9;
+        mesh.position.copy(camera.position).addScaledVector(m.direction, dist);
+        mesh.quaternion.copy(camera.quaternion);
+        const radius = dist * Math.tan(THREE.MathUtils.degToRad(MOON_ANGULAR_DIAMETER_DEG * size) / 2);
+        mesh.scale.setScalar(radius * SPAN);
+        // Sun direction in the quad's frame, so the disc is lit from where the sun is.
+        scratch.q.copy(camera.quaternion).invert();
+        material.uniforms.uSunLocal.value.copy(scratch.v.copy(sunDir).applyQuaternion(scratch.q));
+        const sunElevation = THREE.MathUtils.radToDeg(Math.asin(THREE.MathUtils.clamp(sunDir.y, -1, 1)));
+        material.uniforms.uNight.value = smooth01(2, -8, sunElevation);
+        material.uniforms.uIllum.value = m.illumination;
+    });
+    return _jsx("mesh", { ref: meshRef, geometry: geometry, material: material, frustumCulled: false, renderOrder: -1 });
+};
+export default MoonDisc;

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAkBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA+IzC,CAAC;AACF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ObjectNode.d.ts","sourceRoot":"","sources":["../../src/components/ObjectNode.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAe,qBAAqB,EAA2C,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzI,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,KAAK,eAAe,GAAG,gBAAgB,GAAG;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;CAC7G,CAAC;AAoBF,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAqJzC,CAAC;AACF,eAAe,UAAU,CAAC"}

package/dist/components/ObjectNode.js

@@ -10,14 +10,17 @@ import EffectsGenerator from './EffectsGenerator.js';
 import ParticlesGenerator from './ParticlesGenerator.js';
 import LightObject from "./LightObject.js";
 import EnvironmentObject from "./EnvironmentObject.js";
+import LandObject from "./LandObject.js";
+import TextGenerator from "./TextGenerator.js";
 import Galaxy from "./Galaxy.js";
 import GridGenerator from "./GridsGenerator.js";
 import OceanBuilder from "./OceanBuilder.js";
 import LandscapeObject from "./LandscapeObject.js";
 import LayoutInstances from "./LayoutInstances.js";
 import { useRuntimeSettings } from "../hooks/useRuntimeSettings.js";
+import { usePresentedVisibility } from "../operations/usePresentedVisibility.js";
 import { SELF_MANAGED_MATERIAL } from "../constants.js";
-import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig } from "@3driseai/3drise-core";
+import { LAYOUT_CAPABLE_TYPES, getObjectLayoutSupport, normalizeObjectLayout, isGenerativeParticlesConfig, isTextObjectConfig } from "@3driseai/3drise-core";
 // Slots after the first render with no ready callbacks: one object reports once.
 const NO_READY = {};
 // A point light's shadow is six extra renders; only slot 0 keeps it. Cached per settings
@@ -44,14 +47,18 @@ const GroupWithChildren = ({ createdObject, children, onObjectReady, onObjectDis
     const isGroup = createdObject.type === 'group';
     // Generative particle objects own their shaders, like effects do.
     const selfManagedMaterial = SELF_MANAGED_MATERIAL.has(createdObject.type)
-        || (createdObject.type === 'particles' && isGenerativeParticlesConfig(createdObject.config));
+        || (createdObject.type === 'particles' && isGenerativeParticlesConfig(createdObject.config))
+        // The animated text looks own their shaders; the legacy 2d / 3d text (same object type) keeps its material.
+        || (createdObject.type === 'text' && isTextObjectConfig(createdObject.config));
     return (_jsxs(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !isGroup && !selfManagedMaterial, children: [!isGroup && renderObject(createdObject, handleObjectClick), children.map(childNode => (_jsx(ObjectNode, { node: childNode, handleObjectClick: handleObjectClick, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }, childNode.objectId)))] }, createdObject.id));
 };
 const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick }) => {
     const { children } = node;
     // Authored settings + any applied action patches (runtime only). Every renderer
     // below sees the patched object, so an action can change anything an edit can.
-    const createdObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
+    const runtimeObject = useRuntimeSettings(node.createdObject?.id, node.createdObject);
+    // An object whose effects follow its visibility stays drawn until they have played out.
+    const createdObject = usePresentedVisibility(runtimeObject);
     // Children describe themselves with their own settings; the scene above
     // knows them by the node's createdObject, so relabel on the way up.
     const relabel = useCallback((obj) => ({
@@ -89,6 +96,9 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         //     />
         // ),
         text: (obj, onObjectReady) => {
+            // The animated looks (config.type) render through TextGenerator; the legacy 2d / 3d text keeps its own path.
+            if (isTextObjectConfig(obj.config))
+                return (_jsx(TextGenerator, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose }));
             const renderMode = obj.config?.renderMode ?? 'bitmap';
             return (_jsx(_Fragment, { children: renderMode === 'text3d'
                     ? _jsx(Text3D, { textSettings: obj, ...relabel(obj) })
@@ -127,6 +137,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
         light: (obj, _onObjectReady, slot = 0) => (_jsx(LightObject, { createdObject: slot === 0 ? obj : withoutShadow(obj), ...(slot === 0 ? relabel(obj) : NO_READY) })),
         environment: (obj, onObjectReady) => (_jsx(EnvironmentObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         space: (obj, onObjectReady) => (_jsx(Galaxy, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
+        land: (obj, onObjectReady) => (_jsx(LandObject, { createdObject: obj, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })),
         // rain: (obj: CreatedObjectSettings, cameraSettings: CameraState, onObjectReady?: (object: CreatedObjectSettings, ref: Object3D) => void) => (
         //     <Rain
         //         settings={obj}
@@ -169,7 +180,7 @@ const ObjectNode = ({ node, onObjectReady, onObjectDispose, handleObjectClick })
     const shouldRenderAsGroup = hasChildren || createdObject.type === 'group' || createdObject.type === 'effect';
     const renderedObject = shouldRenderAsGroup
         ? _jsx(GroupWithChildren, { createdObject: createdObject, children: children, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, renderObject: renderObject })
-        : _jsx(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !SELF_MANAGED_MATERIAL.has(createdObject.type), children: renderObject(createdObject) }, createdObject.id);
+        : _jsx(CreatedObject, { createdObject: createdObject, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose, handleObjectClick: handleObjectClick, shouldApply3driseMaterial: !(SELF_MANAGED_MATERIAL.has(createdObject.type) || (createdObject.type === 'text' && isTextObjectConfig(createdObject.config))), children: renderObject(createdObject) }, createdObject.id);
     // createdObject.effects
     //     ? <>
     //         {renderObject(createdObject)}

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

@@ -1 +1 @@
-{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAuFlD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ObjectsRenderer.d.ts","sourceRoot":"","sources":["../../src/components/ObjectsRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACvH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQ9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,UAAU,oBAAqB,SAAQ,gBAAgB;IACnD,cAAc,EAAE,WAAW,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IAC1G,mEAAmE;IACnE,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC;AAGD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAwFlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/components/ObjectsRenderer.js

@@ -6,6 +6,7 @@ import useInteraction from '../hooks/useInteraction.js';
 import { ObjectHoverContext, setEffectPrewarmer, setEffectPreviewer, setInteractionRunner } from '../interactions/runner.js';
 import { prewarmEffect, previewEffect, previewEffects } from '../operations/runtime.js';
 import { findById } from '../utils/sceneQuery.js';
+import { actionEffectsOf, commandsOf, effectsOf } from '../triggers/index.js';
 import { useObjectReady } from '../hooks/useObjectReady.js';
 const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSettings, onObjectsReady, onObjectReady, onObjectDispose, handleObjectClick, sequences = [], clips = [], actionSequences = [], }) => {
     const groupRef = useRef(null);
@@ -53,9 +54,10 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
         if (!ref || !createdObject)
             return false;
         if (opts?.preview) {
-            // effects play and come back; animations and actions run as usual
-            executeInteraction({ interaction: { ...interaction, effects: [] }, ref, createdObject });
-            void previewEffects(interaction.effects ?? [], ref);
+            // effects play and come back; everything else runs as usual
+            const commands = commandsOf(interaction);
+            executeInteraction({ interaction: { mouseEvent: interaction.mouseEvent, enabled: interaction.enabled, commands: commands.filter(c => c.kind !== 'effect') }, ref, createdObject });
+            void previewEffects(commands.flatMap(c => (c.kind === 'effect' ? [c.effect] : [])), ref);
         }
         else {
             executeInteraction({ interaction, ref, createdObject });
@@ -79,11 +81,11 @@ const ObjectsRenderer = memo(({ cameraSettings, createdObjects, generalObjectSet
                 if (!ref)
                     continue;
                 for (const ix of (o.actions ?? []))
-                    for (const e of ix?.effects ?? [])
+                    for (const e of effectsOf(ix))
                         void prewarmEffect(e, ref);
             }
             for (const a of actionSequences ?? [])
-                for (const e of a.effects ?? [])
+                for (const e of actionEffectsOf(a))
                     void prewarmEffect(e, null);
         }, 1500);
         return () => clearTimeout(t);

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

@@ -1 +1 @@
-{"version":3,"file":"OceanBuilder.d.ts","sourceRoot":"","sources":["../../src/components/OceanBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD;;uEAEmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAmC7C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"OceanBuilder.d.ts","sourceRoot":"","sources":["../../src/components/OceanBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD;;uEAEmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAqC7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/OceanBuilder.js

@@ -39,6 +39,8 @@ const OceanBuilder = ({ settings, skySettings, timeSettings, sunIntensity, onObj
         sunIntensity,
         id: settings?.id,
         meshSettings: settings?.meshSettings,
+        animations: settings?.animations,
+        mouseMove: settings?.mouseMove,
         onObjectReady,
         onObjectDispose,
     };

package/dist/components/ParastichyGrid.d.ts

@@ -12,7 +12,7 @@ export interface ParastichyGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** ParastichyGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** ParastichyGridConfig defaults: the core registry entry (DEFAULT_GRIDS.parastichyGrid), never a copy. */
 export declare const defaultParastichyGridConfig: ParastichyGridConfig;
 /**
  * The sunflower's crossed Fibonacci spiral families as a grid of their own: sectionSize spirals one way, sectionSize/φ the other, every crossing a seed, and the difference family cutting each cell into triangles. Light runs inward along the spirals.

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

@@ -1 +1 @@
-{"version":3,"file":"ParastichyGrid.d.ts","sourceRoot":"","sources":["../../src/components/ParastichyGrid.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,oBA2BzC,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":"ParastichyGrid.d.ts","sourceRoot":"","sources":["../../src/components/ParastichyGrid.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/ParastichyGrid.js

@@ -6,38 +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 { ParastichyGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { ParastichyGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <parastichyGridMaterial> via extend().
 void ParastichyGridMaterial;
-/** ParastichyGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultParastichyGridConfig = {
-    cellSize: 1.2,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 1.1,
-    sectionSize: 21,
-    sectionWidth: 0.9,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.5,
-    displace: 0,
-    divergence: 137.508,
-    third: 0.45,
-    sap: 0.9,
-    fill: 0.35,
-    lineColor: '#d4ac4e',
-    sectionColor: '#7fb8a8',
-    cellColor: '#0f3a33',
-    glowColor: '#fff0b8',
-    bgColor: '#03080a',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** ParastichyGridConfig defaults: the core registry entry (DEFAULT_GRIDS.parastichyGrid), never a copy. */
+export const defaultParastichyGridConfig = DEFAULT_GRIDS.parastichyGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['divergence', 'third', 'sap', 'fill'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */

package/dist/components/PhyllotaxisGrid.d.ts

@@ -12,7 +12,7 @@ export interface PhyllotaxisGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** PhyllotaxisGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** PhyllotaxisGridConfig defaults: the core registry entry (DEFAULT_GRIDS.phyllotaxisGrid), never a copy. */
 export declare const defaultPhyllotaxisGridConfig: PhyllotaxisGridConfig;
 /**
  * Vogel's sunflower: florets at the golden angle, each a lit dome coloured by age and carrying a mark aligned to the head's radius. Bloom rings travel from the rim to the centre and open the marks; the head itself never turns.

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

@@ -1 +1 @@
-{"version":3,"file":"PhyllotaxisGrid.d.ts","sourceRoot":"","sources":["../../src/components/PhyllotaxisGrid.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,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,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,kGAAkG;AAClG,eAAO,MAAM,4BAA4B,EAAE,qBA6B1C,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAqC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,oBAAoB,+BAsDpK;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"PhyllotaxisGrid.d.ts","sourceRoot":"","sources":["../../src/components/PhyllotaxisGrid.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,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,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,6GAA6G;AAC7G,eAAO,MAAM,4BAA4B,EAA+C,qBAAqB,CAAC;AAW9G;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAqC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,oBAAoB,+BAsDpK;AAED,eAAe,eAAe,CAAC"}

package/dist/components/PhyllotaxisGrid.js

@@ -7,40 +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 { PhyllotaxisGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { PhyllotaxisGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <phyllotaxisGridMaterial> via extend().
 void PhyllotaxisGridMaterial;
-/** PhyllotaxisGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultPhyllotaxisGridConfig = {
-    cellSize: 1.6,
-    size: 50,
-    segments: undefined,
-    lineMode: 0,
-    cellMode: 0,
-    lineWidth: 0.6,
-    sectionSize: 2,
-    sectionWidth: 1.4,
-    animSpeed: 1,
-    animScale: 0.5,
-    animIntensity: 0.6,
-    fadeDistance: undefined,
-    fadeStrength: 0.6,
-    displace: 0,
-    divergence: 137.508,
-    bloomRate: 0.04,
-    relief: 0.8,
-    shape: 1,
-    shapeSize: 0.85,
-    shapeGlow: 0.9,
-    lineColor: '#a8661c',
-    sectionColor: '#ffcf70',
-    cellColor: '#3a1a08',
-    glowColor: '#e4ee8a',
-    bgColor: '#070402',
-    bgOpacity: 0,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** PhyllotaxisGridConfig defaults: the core registry entry (DEFAULT_GRIDS.phyllotaxisGrid), never a copy. */
+export const defaultPhyllotaxisGridConfig = DEFAULT_GRIDS.phyllotaxisGrid;
 /** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
 const VARIANT = ['divergence', 'bloomRate', 'relief', 'shape', 'shapeSize', 'shapeGlow'];
 /** No computed uniforms: every knob maps straight to its u_<key>. */