@3driseai/3drise-viewer 0.1.22 → 0.1.23

package/dist/components/ledArray/ledMaterials.js

@@ -0,0 +1,151 @@
+// =============================================================================
+// ledMaterials — the dies, their per-die glow, the diffuser and the halo
+// =============================================================================
+//
+// The viewer has no tone mapping and no bloom, so every bright thing here is
+// drawn by hand. An LED array is a set of very small, very bright sources, so
+// the glow is per die rather than one blob: a billboard quad per instance,
+// coloured from an instanced attribute so RGB mode can run a different hue down
+// the array.
+//
+// The diffuser is the other half of the look. A bare die is a point source with
+// a hard-edged shadow; a diffuser turns the whole array into one large soft
+// source. The slab drawn here is that surface — and the component couples the
+// same knob to the light's shadow radius, because the two are the same physics.
+//
+import { AdditiveBlending, Color, DoubleSide, MeshBasicMaterial, ShaderMaterial } from 'three';
+const OUTPUT = /* glsl */ `
+    #include <tonemapping_fragment>
+    #include <colorspace_fragment>
+`;
+/**
+ * A billboard per instance. The quad is built in view space from the instance's
+ * own origin, so the dies always face the camera however the array is turned.
+ */
+function dieGlowMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uStrength: { value: 0 },
+            uSize: { value: 0.09 },
+        },
+        vertexShader: /* glsl */ `
+            attribute vec3 aColor;
+            uniform float uSize;
+            varying vec2 vUv;
+            varying vec3 vColor;
+            void main() {
+                vColor = aColor;
+                vUv = position.xy;
+                // instance origin → view space, then the quad is laid out there
+                vec4 mv = modelViewMatrix * instanceMatrix * vec4(0.0, 0.0, 0.0, 1.0);
+                float s = length(modelMatrix[0].xyz) * uSize;
+                mv.xy += position.xy * s;
+                gl_Position = projectionMatrix * mv;
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform float uStrength;
+            varying vec2 vUv;
+            varying vec3 vColor;
+            void main() {
+                float d = length(vUv);
+                // a tight core with a wide, faint skirt — how a small very bright
+                // source reads through a lens
+                float a = exp(-d * 11.0) + exp(-d * d * 6.0) * 0.35;
+                a *= 1.0 - smoothstep(0.7, 1.0, d);
+                gl_FragColor = vec4(vColor * uStrength * a, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+    });
+}
+/**
+ * The diffuser sheet. Brightest where the dies are (a soft periodic ripple that
+ * fades out as the sheet thickens), dimmer towards the rim where light escapes.
+ */
+function diffuserMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 1, 1) },
+            uStrength: { value: 0 },
+            /** 0 = the dies still show through, 1 = a single even sheet. */
+            uBlend: { value: 0.5 },
+            /** How many die pitches across the sheet, for the hot-spot ripple. */
+            uPitch: { value: 4 },
+        },
+        vertexShader: /* glsl */ `
+            varying vec2 vUv;
+            void main() {
+                vUv = uv;
+                gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            uniform float uBlend;
+            uniform float uPitch;
+            varying vec2 vUv;
+            void main() {
+                vec2 p = vUv * 2.0 - 1.0;
+                // light leaks away at the rim of any real diffuser
+                float edge = (1.0 - smoothstep(0.72, 1.0, abs(p.x))) * (1.0 - smoothstep(0.72, 1.0, abs(p.y)));
+                // hot spots over each die, washed out as the sheet thickens
+                vec2 c = cos(vUv * uPitch * 6.2831853);
+                float dots = (c.x * c.y) * 0.5 + 0.5;
+                float lit = mix(0.45 + dots * 0.75, 1.0, uBlend);
+                gl_FragColor = vec4(uColor * uStrength * lit * edge, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        side: DoubleSide,
+        blending: AdditiveBlending,
+    });
+}
+function haloMaterial() {
+    return new ShaderMaterial({
+        uniforms: {
+            uColor: { value: new Color(1, 1, 1) },
+            uStrength: { value: 0 },
+            uRadius: { value: 0.55 },
+        },
+        vertexShader: /* glsl */ `
+            uniform float uRadius;
+            varying vec2 vUv;
+            void main() {
+                vec4 mv = modelViewMatrix * vec4(0.0, 0.0, 0.0, 1.0);
+                float s = length(modelMatrix[0].xyz) * uRadius;
+                mv.xy += position.xy * s;
+                vUv = position.xy;
+                gl_Position = projectionMatrix * mv;
+            }`,
+        fragmentShader: /* glsl */ `
+            uniform vec3 uColor;
+            uniform float uStrength;
+            varying vec2 vUv;
+            void main() {
+                float d = length(vUv);
+                float a = (exp(-d * 8.0) + exp(-d * d * 4.0) * 0.3) * (1.0 - smoothstep(0.65, 1.0, d));
+                gl_FragColor = vec4(uColor * uStrength * a, 1.0);
+                ${OUTPUT}
+            }`,
+        transparent: true,
+        depthWrite: false,
+        blending: AdditiveBlending,
+    });
+}
+export function createLedArrayMaterials() {
+    return {
+        die: new MeshBasicMaterial({ color: 0xffffff, toneMapped: false }),
+        dieGlow: dieGlowMaterial(),
+        diffuser: diffuserMaterial(),
+        halo: haloMaterial(),
+    };
+}
+export function disposeLedArrayMaterials(m) {
+    m.die.dispose();
+    m.dieGlow.dispose();
+    m.diffuser.dispose();
+    m.halo.dispose();
+}

package/dist/components/lightBulb/LightBulb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LightBulb.d.ts","sourceRoot":"","sources":["../../../src/components/lightBulb/LightBulb.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC5C,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzD,CAAC;AAsBF,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAsHvC,CAAC;AACF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"LightBulb.d.ts","sourceRoot":"","sources":["../../../src/components/lightBulb/LightBulb.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAItG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC5C,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzD,CAAC;AAuBF,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAqHvC,CAAC;AACF,eAAe,SAAS,CAAC"}

package/dist/components/lightBulb/LightBulb.js

@@ -7,8 +7,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // is the filament centre, which is where the point light sits; the bulb stands
 // upright (base down, -Y) — rotate the object 180° for a pendant.
 //
-// Intensity ownership: useLightAnimation / useLightMouseMove (and R3F's
-// `intensity` prop) write `light.intensity` as usual. This component then
+// Intensity ownership: useLightConfig (keyframes + pointer bindings) and R3F's
+// `intensity` prop write `light.intensity` as usual. This component then
 // multiplies in the power level (on/off, warm-up, flicker) each frame. Any
 // intensity it did not write itself is adopted as the new base, so the
 // multiplier never compounds and external writers stay in charge of the base.
@@ -26,9 +26,7 @@ import { Color } from 'three';
 import { SELF_OWNED_MATERIAL_KEY } from '@3driseai/3drise-core';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
 import { useLightShadow } from '../../hooks/useLightShadow.js';
-import { useLightAnimation } from '../../hooks/useLightAnimation.js';
-import { useLightMouseMove } from '../../hooks/useLightMouseMove.js';
-import { useLightLive } from '../../hooks/useLightLive.js';
+import { useLightConfig } from '../../hooks/useLightConfig.js';
 import { buildBulbShape, disposeBulbShape } from './bulbShapes.js';
 import { applyGlass, createBulbMaterials, disposeBulbMaterials, GLASS_RESPONSE } from './bulbMaterials.js';
 import { kelvinToColor } from './kelvin.js';
@@ -53,10 +51,9 @@ const LightBulb = ({ id, config, animations, mouseMove, settings, onObjectReady,
     const lightRef = useRef(null);
     useObjectReady(groupRef, settings, onObjectReady, onObjectDispose);
     useLightShadow(lightRef, config.shadow);
-    useLightAnimation(lightRef, animations);
-    useLightMouseMove(lightRef, mouseMove, { lightConfig: config });
-    // Slider drags: light props land on the light; flicker / halo / warmup are read per frame below.
-    const live = useLightLive(groupRef, lightRef, id, config);
+    // Keyframes, pointer bindings and slider drags: the light's own knobs land on
+    // the light, and the merged config is what the filament, glow and halo read.
+    const { merged } = useLightConfig(groupRef, lightRef, id, config, animations, mouseMove);
     const glass = config.glass ?? 'clear';
     const glassTint = config.glassTint ?? '#ffb070';
     const on = config.on ?? true;
@@ -99,10 +96,10 @@ const LightBulb = ({ id, config, animations, mouseMove, settings, onObjectReady,
         if (!light)
             return;
         const p = power.current;
-        const lv = live.current;
-        const warmup = Math.max(num(lv.warmup, config.warmup ?? 0.25), 0);
-        const flicker = Math.min(Math.max(num(lv.flicker, config.flicker ?? 0), 0), 1);
-        const haloAmount = Math.min(Math.max(num(lv.halo, config.halo ?? 1), 0), 2);
+        const cfg = merged.current;
+        const warmup = Math.max(num(cfg.warmup, 0.25), 0);
+        const flicker = Math.min(Math.max(num(cfg.flicker, 0), 0), 1);
+        const haloAmount = Math.min(Math.max(num(cfg.halo, 1), 0), 2);
         if (light.intensity !== p.written)
             p.base = light.intensity;
         const target = on ? 1 : 0;

package/dist/components/particles/BioluminescentWakeParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, BioluminescentWakeParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, BioluminescentWakeParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface BioluminescentWakeParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/BioluminescentWakeParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BioluminescentWakeParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/BioluminescentWakeParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAMjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,gCAAiC,SAAQ,gBAAgB;IACtE,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iCAAiC,CAAC;IAC1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA09BD,QAAA,MAAM,2BAA2B,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAiD3E,CAAC;AAEF,eAAe,2BAA2B,CAAC"}
+{"version":3,"file":"BioluminescentWakeParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/BioluminescentWakeParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMlH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,gCAAiC,SAAQ,gBAAgB;IACtE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iCAAiC,CAAC;IAC1C,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA09BD,QAAA,MAAM,2BAA2B,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAqD3E,CAAC;AAEF,eAAe,2BAA2B,CAAC"}

package/dist/components/particles/BioluminescentWakeParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -1103,7 +1103,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.bioluminescentWake.map((p) => p.value));
-const BioluminescentWakeParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const BioluminescentWakeParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -1135,8 +1135,12 @@ const BioluminescentWakeParticles = ({ id, size, config, animations, onObjectRea
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/BrownianDustParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, BrownianDustParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, BrownianDustParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface BrownianDustParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/BrownianDustParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrownianDustParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/BrownianDustParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAM3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAChE,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,2BAA2B,CAAC;IACpC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA4qBD,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAiD/D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"BrownianDustParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/BrownianDustParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,0BAA2B,SAAQ,gBAAgB;IAChE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,2BAA2B,CAAC;IACpC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA4qBD,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAqD/D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/components/particles/BrownianDustParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -737,7 +737,7 @@ const DEFAULTS = {
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.brownianDust.map((p) => p.value));
 /** Knobs that rebuild the simulation: they change on commit, never through the live path. */
 const STRUCTURAL = ['particleCount'];
-const BrownianDustParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const BrownianDustParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -769,8 +769,12 @@ const BrownianDustParticles = ({ id, size, config, animations, onObjectReady, on
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/ChladniSandParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, ChladniSandParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, ChladniSandParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface ChladniSandParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/ChladniSandParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChladniSandParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ChladniSandParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAM1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAsvBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAiD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ChladniSandParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ChladniSandParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAsvBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAqD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/particles/ChladniSandParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -870,7 +870,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.chladniSand.map((p) => p.value));
-const ChladniSandParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const ChladniSandParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -902,8 +902,12 @@ const ChladniSandParticles = ({ id, size, config, animations, onObjectReady, onO
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/ElectronOrbitalsParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, ElectronOrbitalsParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, ElectronOrbitalsParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface ElectronOrbitalsParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/ElectronOrbitalsParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElectronOrbitalsParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ElectronOrbitalsParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAM/F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,8BAA+B,SAAQ,gBAAgB;IACpE,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,+BAA+B,CAAC;IACxC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA0xBD,QAAA,MAAM,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CAiDvE,CAAC;AAEF,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"ElectronOrbitalsParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/ElectronOrbitalsParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMhH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,8BAA+B,SAAQ,gBAAgB;IACpE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,+BAA+B,CAAC;IACxC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA0xBD,QAAA,MAAM,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CAqDvE,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/components/particles/ElectronOrbitalsParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -924,7 +924,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'stateA', 'stateB', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.electronOrbitals.map((p) => p.value));
-const ElectronOrbitalsParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const ElectronOrbitalsParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -956,8 +956,12 @@ const ElectronOrbitalsParticles = ({ id, size, config, animations, onObjectReady
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/FaradayPowderParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, FaradayPowderParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, FaradayPowderParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface FaradayPowderParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/FaradayPowderParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FaradayPowderParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/FaradayPowderParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAM5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAypBD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAiDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"FaradayPowderParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/FaradayPowderParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAypBD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/components/particles/FaradayPowderParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -741,7 +741,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.faradayPowder.map((p) => p.value));
-const FaradayPowderParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const FaradayPowderParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -773,8 +773,12 @@ const FaradayPowderParticles = ({ id, size, config, animations, onObjectReady, o
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/GrinderSparksParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, GrinderSparksParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, GrinderSparksParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface GrinderSparksParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/GrinderSparksParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GrinderSparksParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/GrinderSparksParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAM5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA8pBD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAiDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"GrinderSparksParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/GrinderSparksParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,4BAA4B,CAAC;IACrC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AA8pBD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAqDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/components/particles/GrinderSparksParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -726,7 +726,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.grinderSparks.map((p) => p.value));
-const GrinderSparksParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const GrinderSparksParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -758,8 +758,12 @@ const GrinderSparksParticles = ({ id, size, config, animations, onObjectReady, o
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/NeonRainParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, NeonRainParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, NeonRainParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface NeonRainParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/NeonRainParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NeonRainParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/NeonRainParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC5D,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;IAChC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAinBD,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAiDvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"NeonRainParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/NeonRainParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC5D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,uBAAuB,CAAC;IAChC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAinBD,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAqDvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/particles/NeonRainParticles.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three';
 import { useFrame } from '@react-three/fiber';
 import { GENERATIVE_PARTICLES_ANIMATABLE } from '@3driseai/3drise-core';
-import { applyConfigKeyframeAnimations } from '../../utils/configAnimations.js';
+import { applyConfigKeyframeAnimations, applyConfigMouseMove } from '../../utils/configAnimations.js';
 import { createPointerUniforms, stepPointerField, usePointerField } from '../../utils/pointerField.js';
 import { createTrailUniforms, applyTrailConfig, createCpuTrail } from '../../utils/particleTrails.js';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
@@ -674,7 +674,7 @@ const DEFAULTS = {
 const STRUCTURAL = ['particleCount', 'seed', 'quality'];
 /** Knobs an animation (or mouse move) may drive per frame — generated from applyConfig. */
 const ANIMATABLE = new Set(GENERATIVE_PARTICLES_ANIMATABLE.neonRain.map((p) => p.value));
-const NeonRainParticles = ({ id, size, config, animations, onObjectReady, onObjectDispose }) => {
+const NeonRainParticles = ({ id, size, config, animations, mouseMove, onObjectReady, onObjectDispose }) => {
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     const s = size > 0 ? size : 1;
@@ -706,8 +706,12 @@ const NeonRainParticles = ({ id, size, config, animations, onObjectReady, onObje
     const pointer = usePointerField();
     useFrame((state, delta) => {
         instance.update(Math.min(delta, 0.1), state.camera, pointer);
-        if (keyframes?.length) {
+        // Keyframes first, pointer on top: a knob bound to both follows the cursor.
+        const pointerBound = !!mouseMove?.enabled && !!mouseMove.properties?.length;
+        if (keyframes?.length || pointerBound) {
             applyConfigKeyframeAnimations(keyframes, animFrom.current, cfg, animOverride.current, performance.now() - animStart.current, ANIMATABLE);
+            if (pointerBound)
+                applyConfigMouseMove(mouseMove.properties, cfg, animOverride.current, state.pointer, ANIMATABLE);
             push(live.current);
         }
     });

package/dist/components/particles/TidalStreamParticles.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import type { ObjectAnimations, TidalStreamParticlesConfig } from '@3driseai/3drise-core';
+import type { ObjectAnimations, TidalStreamParticlesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface TidalStreamParticlesProps extends ObjectReadyProps {
+    /** Pointer bindings for this object's config knobs (mouseMove.particles). */
+    mouseMove?: MouseMoveDomain;
     /** Scene object id: the controller finds the live-edit handle by it. */
     id?: string;
     /** World size of the object (units); the object's transform scales it further. */

package/dist/components/particles/TidalStreamParticles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TidalStreamParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/TidalStreamParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAM1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAmtBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAiD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"TidalStreamParticles.d.ts","sourceRoot":"","sources":["../../../src/components/particles/TidalStreamParticles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IAC/D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAmtBD,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAqD7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}