@3driseai/3drise-viewer 0.1.27 → 0.1.29

package/dist/components/TruchetGrid.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useLayoutEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useObjectReady } from '../hooks/useObjectReady.js';
+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 { TruchetGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+// Side-effect import registers <truchetGridMaterial> via extend().
+void TruchetGridMaterial;
+/** TruchetGridConfig defaults: the core registry entry (DEFAULT_GRIDS.truchetGrid), never a copy. */
+export const defaultTruchetGridConfig = DEFAULT_GRIDS.truchetGrid;
+/** This grid's own uniforms (u_<key>), pushed by applyGridConfig beside the shared surface knobs. */
+const VARIANT = ['flip', 'bias', 'pulse', 'regionFill'];
+/** No computed uniforms: every knob maps straight to its u_<key>. */
+const DERIVE = {};
+/** Knobs that reshape the plane or pick a mode: they change on commit, never through the live path. */
+const STRUCTURAL = [...GRID_STRUCTURAL];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyGridConfig pushes. */
+const ANIMATABLE = new Set((GRIDS_ANIMATABLE.truchetGrid ?? []).map((p) => p.value));
+/**
+ * Smith quarter-circle Truchet tiles: arcs always meet arcs, so the plane fills with endless two-coloured loops. Tiles re-deal by turning a quarter turn, and comets travel the loops in one direction.
+ *
+ * The grid always lies flat: any other orientation, and any movement of the
+ * whole, is the parent object's transform. Only what happens inside it animates.
+ */
+export function TruchetGrid({ config = defaultTruchetGridConfig, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) {
+    const matRef = useRef(null);
+    const rootRef = useRef(null);
+    const meshRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    // 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(defaultTruchetGridConfig, config), [config]);
+    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, { 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);
+    baseRef.current = base;
+    const setMaterial = useCallback((m) => {
+        matRef.current = m;
+        if (m)
+            applyGridConfig(m, baseRef.current, VARIANT, DERIVE);
+    }, []);
+    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: [-Math.PI / 2, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("truchetGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, TruchetGridMaterial.key)] }) }));
+}
+export default TruchetGrid;

package/dist/components/VoronoiGrid.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"VoronoiGrid.d.ts","sourceRoot":"","sources":["../../src/components/VoronoiGrid.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,iBA2BtC,CAAC;AAoBF,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":"VoronoiGrid.d.ts","sourceRoot":"","sources":["../../src/components/VoronoiGrid.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;AAoBlG,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/VoronoiGrid.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 { VoronoiGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { VoronoiGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } 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,
-};
+/** VoronoiGridConfig defaults: the core registry entry (DEFAULT_GRIDS.voronoiGrid), never a copy. */
+export const defaultVoronoiGridConfig = DEFAULT_GRIDS.voronoiGrid;
 /**
  * An irregular cellular lattice on a shader plane.
  *
@@ -63,11 +36,11 @@ export function VoronoiGrid({ config = defaultVoronoiGridConfig, 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(defaultVoronoiGridConfig, 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(384, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 6))
         : 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);
@@ -80,6 +53,6 @@ export function VoronoiGrid({ config = defaultVoronoiGridConfig, 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("voronoiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, VoronoiGridMaterial.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("voronoiGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, VoronoiGridMaterial.key)] }) }));
 }
 export default VoronoiGrid;

package/dist/components/WallpaperGrid.d.ts

@@ -12,7 +12,7 @@ export interface WallpaperGridProps extends ObjectReadyProps {
     /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
     mouseMove?: MouseMoveDomain;
 }
-/** WallpaperGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
+/** WallpaperGridConfig defaults: the core registry entry (DEFAULT_GRIDS.wallpaperGrid), never a copy. */
 export declare const defaultWallpaperGridConfig: WallpaperGridConfig;
 /**
  * Wallpaper-group kaleidoscope: a drifting lattice-periodic Fourier motif summed over the coset representatives of one of the 17 plane crystallographic groups. The runtime builds the group tables and crossfades from group to group.

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

@@ -1 +1 @@
-{"version":3,"file":"WallpaperGrid.d.ts","sourceRoot":"","sources":["../../src/components/WallpaperGrid.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,mBA6BxC,CAAC;AAkQF;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BA0D9J;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"WallpaperGrid.d.ts","sourceRoot":"","sources":["../../src/components/WallpaperGrid.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;AAkQxG;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAmC,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,kBAAkB,+BA0D9J;AAED,eAAe,aAAa,CAAC"}

package/dist/components/WallpaperGrid.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 { WallpaperGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
+import { WallpaperGridMaterial, DEFAULT_GRIDS, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <wallpaperGridMaterial> via extend().
 void WallpaperGridMaterial;
-/** WallpaperGridConfig defaults. Must match the catalog entry in grid-defaults.json exactly. */
-export const defaultWallpaperGridConfig = {
-    cellSize: 10,
-    size: 50,
-    flat: true,
-    segments: undefined,
-    lineMode: 2,
-    cellMode: 2,
-    lineWidth: 2,
-    sectionSize: 0,
-    sectionWidth: 1.4,
-    animSpeed: 1,
-    animScale: 0.6,
-    animIntensity: 0.55,
-    fadeDistance: undefined,
-    fadeStrength: 0.7,
-    displace: 0,
-    group: -1,
-    cycleTime: 12,
-    motif: 0.5,
-    levels: 11,
-    lineColor: '#f3d79b',
-    sectionColor: '#7fd6ff',
-    cellColor: '#101c50',
-    glowColor: '#ff9ec7',
-    bgColor: '#05070a',
-    bgOpacity: 0,
-    followMouse: false,
-    reveal: 1,
-    revealDuration: 0,
-};
+/** WallpaperGridConfig defaults: the core registry entry (DEFAULT_GRIDS.wallpaperGrid), never a copy. */
+export const defaultWallpaperGridConfig = DEFAULT_GRIDS.wallpaperGrid;
 // ---------------------------------------------------------------------------
 // The 17 wallpaper groups (Farris, "Creating Symmetry").
 // Each group is listed by its ITA general positions in lattice coordinates:
@@ -341,10 +312,10 @@ export function WallpaperGrid({ config = defaultWallpaperGridConfig, groupProps,
     // 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(defaultWallpaperGridConfig, config), [config]);
-    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
+    const { cellSize, size, segments, displace, reveal, revealDuration } = base;
     // the motif has up to ~3 waves per unit cell, so 16 vertices per cell keep the displaced relief smooth
     const segs = segments ?? (displace > 0 ? Math.min(512, Math.max(96, Math.ceil(size / Math.max(cellSize, 1e-4)) * 16)) : 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);
@@ -373,6 +344,6 @@ export function WallpaperGrid({ config = defaultWallpaperGridConfig, groupProps,
             runtimeRef.current = null;
         }
     }, []);
-    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("wallpaperGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, WallpaperGridMaterial.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("wallpaperGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, WallpaperGridMaterial.key)] }) }));
 }
 export default WallpaperGrid;

package/dist/components/environment/Rain.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { AnimationOptions, MouseMoveDomain, RainEnvironmentConfig } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface RainProps extends ObjectReadyProps {
+    config: RainEnvironmentConfig;
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.environment.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.environment). */
+    mouseMove?: MouseMoveDomain;
+}
+declare const Rain: React.FC<RainProps>;
+export default Rain;
+//# sourceMappingURL=Rain.d.ts.map

package/dist/components/environment/Rain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rain.d.ts","sourceRoot":"","sources":["../../../src/components/environment/Rain.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAItG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE,MAAM,WAAW,SAAU,SAAQ,gBAAgB;IAC/C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAUD,QAAA,MAAM,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAmF7B,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/components/environment/Rain.js

@@ -0,0 +1,110 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+import { DEFAULT_ENVIRONMENT_OBJECTS, ENVIRONMENT_OBJECTS_ANIMATABLE, RainMaterial } from '@3driseai/3drise-core';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
+const DEFAULTS = DEFAULT_ENVIRONMENT_OBJECTS.rain;
+/** Knobs that rebuild the drops: never live, they change once, on commit. */
+const STRUCTURAL = ['density'];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what push applies. */
+const ANIMATABLE = new Set(ENVIRONMENT_OBJECTS_ANIMATABLE.rain.map((p) => p.value));
+const MAX_DROPS = 20000;
+const DEG = Math.PI / 180;
+const Rain = ({ config, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) => {
+    const rootRef = useRef(null);
+    const cfg = useMemo(() => withConfigDefaults(DEFAULTS, config), [config]);
+    useObjectReady(rootRef, cfg, onObjectReady, onObjectDispose);
+    const count = Math.min(Math.max(Math.round(cfg.density * 100), 100), MAX_DROPS);
+    const drops = useMemo(() => {
+        const positions = new Float32Array(count * 3);
+        const speeds = new Float32Array(count);
+        for (let i = 0; i < count; i++) {
+            positions[i * 3] = Math.random() - 0.5;
+            positions[i * 3 + 1] = Math.random();
+            positions[i * 3 + 2] = Math.random() - 0.5;
+            speeds[i] = 0.8 + Math.random() * 0.4;
+        }
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+        geometry.setAttribute('speed', new THREE.BufferAttribute(speeds, 1));
+        return { geometry, positions, speeds };
+    }, [count]);
+    const material = useMemo(() => {
+        const m = new RainMaterial();
+        m.transparent = true;
+        m.depthWrite = false;
+        m.blending = THREE.NormalBlending;
+        return m;
+    }, []);
+    useEffect(() => () => drops.geometry.dispose(), [drops]);
+    useEffect(() => () => material.dispose(), [material]);
+    // What the simulation reads each frame; written only by push.
+    const sim = useRef({ speed: cfg.speed, windStrength: cfg.windStrength, windDirection: cfg.windDirection, turbulence: cfg.turbulence });
+    const push = useCallback((m) => {
+        const u = material.uniforms;
+        const c = m.color;
+        if (c !== undefined)
+            c.isColor ? u.uColor.value.copy(c) : u.uColor.value.set(c);
+        if (typeof m.opacity === 'number')
+            u.opacity.value = m.opacity;
+        if (typeof m.size === 'number')
+            u.streakLength.value = Math.max(m.size * 30, 1);
+        if (typeof m.windDirection === 'number') {
+            u.windAngle.value = m.windDirection * DEG;
+            sim.current.windDirection = m.windDirection;
+        }
+        if (typeof m.windStrength === 'number') {
+            u.windTilt.value = m.windStrength;
+            sim.current.windStrength = m.windStrength;
+        }
+        if (typeof m.speed === 'number')
+            sim.current.speed = m.speed;
+        if (typeof m.turbulence === 'number')
+            sim.current.turbulence = m.turbulence;
+    }, [material]);
+    useLayoutEffect(() => { push(cfg); }, [cfg, push]);
+    useConfigDriver({ rootRef, id, family: 'environment', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
+    const scale = useMemo(() => new THREE.Vector3(), []);
+    useFrame((_, delta) => {
+        const root = rootRef.current;
+        if (!root)
+            return;
+        root.getWorldScale(scale);
+        const sx = Math.max(Math.abs(scale.x), 1e-3), sy = Math.max(Math.abs(scale.y), 1e-3), sz = Math.max(Math.abs(scale.z), 1e-3);
+        const { speed, windStrength, windDirection, turbulence } = sim.current;
+        const dt = Math.min(delta, 0.05);
+        const fall = speed * 60 * dt / sy;
+        const wind = windStrength * 30 * dt;
+        const wx = Math.sin(windDirection * DEG) * wind / sx, wz = Math.cos(windDirection * DEG) * wind / sz;
+        const turb = turbulence * 10 * dt;
+        const p = drops.positions, v = drops.speeds;
+        for (let i = 0; i < count; i++) {
+            const i3 = i * 3, s = v[i];
+            p[i3] += wx * s + (turb > 0 ? (Math.random() - 0.5) * turb / sx : 0);
+            p[i3 + 1] -= fall * s;
+            p[i3 + 2] += wz * s + (turb > 0 ? (Math.random() - 0.5) * turb / sz : 0);
+            if (p[i3 + 1] < 0) {
+                p[i3] = Math.random() - 0.5;
+                p[i3 + 1] = 1;
+                p[i3 + 2] = Math.random() - 0.5;
+                v[i] = 0.8 + Math.random() * 0.4;
+            }
+            if (p[i3] > 0.5)
+                p[i3] -= 1;
+            else if (p[i3] < -0.5)
+                p[i3] += 1;
+            if (p[i3 + 2] > 0.5)
+                p[i3 + 2] -= 1;
+            else if (p[i3 + 2] < -0.5)
+                p[i3 + 2] += 1;
+        }
+        drops.geometry.attributes.position.needsUpdate = true;
+    });
+    // Clicks reach the scene: the drops never take a raycast.
+    const noRaycast = useMemo(() => () => { }, []);
+    return (_jsx("group", { ref: rootRef, children: _jsx("points", { geometry: drops.geometry, material: material, frustumCulled: false, raycast: noRaycast }) }));
+};
+export default Rain;

package/dist/components/environment/Rainbow.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { AnimationOptions, MouseMoveDomain, RainbowEnvironmentConfig } from '@3driseai/3drise-core';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface RainbowProps extends ObjectReadyProps {
+    config: RainbowEnvironmentConfig;
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.environment.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.environment). */
+    mouseMove?: MouseMoveDomain;
+}
+/**
+ * A single physical rainbow on its own: water dispersion and an Airy profile with supernumerary fringes, centred opposite the sun and seen through the object’s volume. The cursor sprays, clears or polarises it. Use for after-rain and hopeful scenes.
+ *
+ * The volume is the parent's transform: x / z span its scale, y rises from its origin to scale.y.
+ */
+declare const Rainbow: React.FC<RainbowProps>;
+export default Rainbow;
+//# sourceMappingURL=Rainbow.d.ts.map

package/dist/components/environment/Rainbow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rainbow.d.ts","sourceRoot":"","sources":["../../../src/components/environment/Rainbow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAMzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAq3BhE,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAClD,MAAM,EAAE,wBAAwB,CAAC;IACjC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;GAIG;AACH,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAmCnC,CAAC;AAEF,eAAe,OAAO,CAAC"}