@3driseai/3drise-viewer 0.1.21 → 0.1.23

package/dist/components/lightBulb/bulbShapes.js

@@ -0,0 +1,180 @@
+// =============================================================================
+// bulbShapes — glass profiles, filaments and supports for each LightBulbShape
+// =============================================================================
+//
+// Units: the glass is ~1 unit tall; object scale comes from the CreatedObject
+// wrapper. "Bulb space" has the neck at y = 0 and the glass growing up +Y; the
+// screw base hangs below it. LightBulb shifts the whole bulb down by
+// `filamentCenterY` so the light (and the object's origin) sits on the filament.
+//
+// Lathe profiles run bottom → top. Reversed, the normals face inward and the
+// point light lights the inside of the far wall instead of the near one.
+//
+import { CatmullRomCurve3, Curve, LatheGeometry, TubeGeometry, Vector2, Vector3 } from 'three';
+const LATHE_SEGMENTS = 64;
+/** A tightly wound coil along an arbitrary path. */
+class CoiledCurve extends Curve {
+    path;
+    turns;
+    radius;
+    tmpT = new Vector3();
+    tmpN = new Vector3();
+    tmpB = new Vector3();
+    constructor(path, turns, radius) {
+        super();
+        this.path = path;
+        this.turns = turns;
+        this.radius = radius;
+    }
+    getPoint(t, target = new Vector3()) {
+        const p = this.path.getPoint(t, target);
+        const tangent = this.path.getTangent(t, this.tmpT);
+        // Any vector not parallel to the tangent gives a stable frame for these gentle paths.
+        const ref = Math.abs(tangent.y) < 0.9 ? this.tmpN.set(0, 1, 0) : this.tmpN.set(1, 0, 0);
+        const b = this.tmpB.crossVectors(tangent, ref).normalize();
+        const n = ref.crossVectors(b, tangent).normalize();
+        const a = t * Math.PI * 2 * this.turns;
+        return p.addScaledVector(n, Math.cos(a) * this.radius).addScaledVector(b, Math.sin(a) * this.radius);
+    }
+}
+const coil = (points, turns, radius = 0.02, wire = 0.0045) => new TubeGeometry(new CoiledCurve(new CatmullRomCurve3(points), turns, radius), turns * 28, wire, 5, false);
+const wire = (from, to, bend = 0) => {
+    const mid = from.clone().lerp(to, 0.5);
+    mid.x += bend;
+    return new TubeGeometry(new CatmullRomCurve3([from, mid, to]), 16, 0.0035, 5, false);
+};
+/** Glass stem rising from the neck: a short flared cone. */
+const stemProfile = (top, r = 0.035) => new LatheGeometry([
+    new Vector2(0.09, -0.02), new Vector2(0.05, 0.03), new Vector2(r * 0.9, top * 0.6), new Vector2(r, top), new Vector2(0.001, top + 0.01),
+], 24);
+/** Screw base below the neck. */
+function baseGeometry(neckRadius) {
+    const pts = [new Vector2(0.001, -0.36), new Vector2(0.05, -0.355), new Vector2(neckRadius * 0.62, -0.33)];
+    const threads = 22;
+    for (let i = 0; i <= threads; i++) {
+        const y = -0.3 + (i / threads) * 0.3;
+        pts.push(new Vector2(neckRadius + Math.abs(Math.sin(i * Math.PI / 4)) * 0.018, y));
+    }
+    pts.push(new Vector2(neckRadius * 0.98, 0.012));
+    return new LatheGeometry(pts, LATHE_SEGMENTS);
+}
+const lathe = (pts) => {
+    const g = new LatheGeometry(pts, LATHE_SEGMENTS);
+    g.computeVertexNormals();
+    return g;
+};
+const smooth = (e0, e1, x) => {
+    const t = Math.min(Math.max((x - e0) / (e1 - e0), 0), 1);
+    return t * t * (3 - 2 * t);
+};
+// ---------------------------------------------------------------------------
+function classic() {
+    // A19: narrow neck swelling into a pear, round crown.
+    const neck = 0.17, pts = [];
+    for (let i = 0; i <= 64; i++) {
+        const t = i / 64, y = t * 0.97;
+        let r;
+        if (t < 0.22)
+            r = neck + Math.pow(t / 0.22, 1.6) * 0.07;
+        else {
+            const u = (t - 0.22) / 0.78;
+            r = 0.24 + Math.sin(u * Math.PI * 0.62) * 0.16;
+            if (u > 0.62)
+                r *= Math.sqrt(Math.max(0, 1 - Math.pow((u - 0.62) / 0.38, 2)));
+        }
+        pts.push(new Vector2(Math.max(r, 0.0005), y));
+    }
+    const cy = 0.55, half = 0.1;
+    const ends = [new Vector3(-half, cy, 0), new Vector3(half, cy, 0)];
+    return {
+        glass: lathe(pts),
+        filament: coil([ends[0], new Vector3(0, cy - 0.03, 0), ends[1]], 14),
+        supports: [stemProfile(0.26), wire(new Vector3(-0.02, 0.26, 0), ends[0], -0.03), wire(new Vector3(0.02, 0.26, 0), ends[1], 0.03)],
+        base: baseGeometry(neck),
+        filamentCenterY: cy,
+        haloRadius: 1.1,
+    };
+}
+function globe() {
+    // G25: short neck, near-perfect sphere.
+    const neck = 0.17, R = 0.42, c = 0.52;
+    const join = c - Math.sqrt(R * R - neck * neck);
+    const pts = [new Vector2(neck, 0)];
+    for (let i = 0; i <= 64; i++) {
+        const y = join + (i / 64) * (c + R - join);
+        pts.push(new Vector2(Math.max(Math.sqrt(Math.max(R * R - (y - c) * (y - c), 0)), 0.0005), y));
+    }
+    const half = 0.1;
+    const ends = [new Vector3(-half, c, 0), new Vector3(half, c, 0)];
+    return {
+        glass: lathe(pts),
+        filament: coil([ends[0], new Vector3(0, c - 0.03, 0), ends[1]], 14),
+        supports: [stemProfile(0.3), wire(new Vector3(-0.02, 0.3, 0), ends[0], -0.03), wire(new Vector3(0.02, 0.3, 0), ends[1], 0.03)],
+        base: baseGeometry(neck),
+        filamentCenterY: c,
+        haloRadius: 1.25,
+    };
+}
+function edison() {
+    // ST64: tall teardrop with a squirrel-cage filament.
+    const neck = 0.17, top = 1.35, pts = [];
+    for (let i = 0; i <= 80; i++) {
+        const y = (i / 80) * top;
+        let r = neck + (0.33 - neck) * smooth(0.02, 0.8, y);
+        if (y > 0.86)
+            r *= Math.sqrt(Math.max(0, 1 - Math.pow((y - 0.86) / (top - 0.86), 2)));
+        pts.push(new Vector2(Math.max(r, 0.0005), y));
+    }
+    // Zig-zag between a lower and an upper ring: the vintage "cage".
+    const strands = 7, lowY = 0.42, highY = 1.02, lowR = 0.035, highR = 0.12;
+    const cage = [];
+    for (let i = 0; i < strands * 2; i++) {
+        const a = (i / (strands * 2)) * Math.PI * 2;
+        const up = i % 2 === 1;
+        const r = up ? highR : lowR;
+        cage.push(new Vector3(Math.cos(a) * r, up ? highY : lowY, Math.sin(a) * r));
+    }
+    const filament = new TubeGeometry(new CatmullRomCurve3(cage, true, 'catmullrom', 0.15), 420, 0.004, 5, true);
+    const supports = [stemProfile(lowY - 0.02, 0.03)];
+    // A centre rod up to the top ring, with spokes out to each upper vertex.
+    supports.push(wire(new Vector3(0, lowY, 0), new Vector3(0, highY + 0.04, 0)));
+    for (let i = 1; i < strands * 2; i += 2)
+        supports.push(wire(new Vector3(0, highY + 0.04, 0), cage[i]));
+    return {
+        glass: lathe(pts),
+        filament,
+        supports,
+        base: baseGeometry(neck),
+        filamentCenterY: (lowY + highY) / 2,
+        haloRadius: 1.3,
+    };
+}
+function tube() {
+    // T10: straight tube, rounded crown, long axial coil.
+    const R = 0.14, top = 1.4, pts = [];
+    for (let i = 0; i <= 64; i++) {
+        const y = (i / 64) * top;
+        const crown = top - R;
+        const r = y < crown ? R : Math.sqrt(Math.max(R * R - (y - crown) * (y - crown), 0));
+        pts.push(new Vector2(Math.max(r, 0.0005), y));
+    }
+    const lo = new Vector3(0, 0.3, 0), hi = new Vector3(0, 1.2, 0);
+    return {
+        glass: lathe(pts),
+        filament: coil([lo, new Vector3(0.005, 0.75, 0), hi], 60, 0.014, 0.0035),
+        supports: [stemProfile(0.24, 0.028), wire(new Vector3(0, 0.24, 0), lo), wire(new Vector3(0.03, 0.2, 0), new Vector3(0.09, 0.75, 0), 0.02), wire(new Vector3(0.09, 0.75, 0), hi, 0.02)],
+        base: baseGeometry(R),
+        filamentCenterY: 0.75,
+        haloRadius: 1.2,
+    };
+}
+const BUILDERS = { classic, globe, edison, tube };
+export function buildBulbShape(shape) {
+    return (BUILDERS[shape ?? 'classic'] ?? classic)();
+}
+export function disposeBulbShape(g) {
+    g.glass.dispose();
+    g.filament.dispose();
+    g.base.dispose();
+    g.supports.forEach((s) => s.dispose());
+}

package/dist/components/lightBulb/index.d.ts

@@ -0,0 +1,5 @@
+export { default as LightBulb } from './LightBulb';
+export type { LightBulbProps } from './LightBulb';
+export type { LightBulbConfig, LightBulbShape, LightBulbGlass, LightBulbColorMode } from './types';
+export { kelvinToColor } from './kelvin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/lightBulb/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/components/lightBulb/index.js

@@ -0,0 +1,3 @@
+// Visible light bulbs (createdObject type 'light', config.type 'lightBulb'), rendered by LightObject.
+export { default as LightBulb } from './LightBulb.js';
+export { kelvinToColor } from './kelvin.js';

package/dist/components/lightBulb/kelvin.d.ts

@@ -0,0 +1,7 @@
+import { Color } from 'three';
+/**
+ * Colour temperature → colour (Tanner Helland's blackbody fit, sRGB).
+ * Writes into `target` and returns it.
+ */
+export declare function kelvinToColor(kelvin: number, target?: Color): Color;
+//# sourceMappingURL=kelvin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kelvin.d.ts","sourceRoot":"","sources":["../../../src/components/lightBulb/kelvin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,KAAmB,GAAG,KAAK,CAehF"}

package/dist/components/lightBulb/kelvin.js

@@ -0,0 +1,21 @@
+import { Color, SRGBColorSpace } from 'three';
+/**
+ * Colour temperature → colour (Tanner Helland's blackbody fit, sRGB).
+ * Writes into `target` and returns it.
+ */
+export function kelvinToColor(kelvin, target = new Color()) {
+    const t = Math.min(Math.max(kelvin, 1000), 40000) / 100;
+    let r, g, b;
+    if (t <= 66) {
+        r = 255;
+        g = 99.4708025861 * Math.log(t) - 161.1195681661;
+        b = t <= 19 ? 0 : 138.5177312231 * Math.log(t - 10) - 305.0447927307;
+    }
+    else {
+        r = 329.698727446 * Math.pow(t - 60, -0.1332047592);
+        g = 288.1221695283 * Math.pow(t - 60, -0.0755148492);
+        b = 255;
+    }
+    const c = (v) => Math.min(Math.max(v, 0), 255) / 255;
+    return target.setRGB(c(r), c(g), c(b), SRGBColorSpace);
+}

package/dist/components/lightBulb/types.d.ts

@@ -0,0 +1,2 @@
+export type { LightBulbConfig, LightBulbShape, LightBulbGlass, LightBulbColorMode } from '@3driseai/3drise-core';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/lightBulb/types.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/lightBulb/types.js

@@ -0,0 +1 @@
+export {};

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"}