@3driseai/3drise-viewer 0.1.26 → 0.1.28

package/dist/components/effects/SmokePlumeEffect.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
-import * as THREE from 'three';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import * as THREE from 'three';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from "@3driseai/3drise-core";
 import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
 /**
  * A buoyant smoke plume rising from the top of the host.
  *
@@ -153,10 +155,27 @@ const plumeFrag = /* glsl */ `
     gl_FragColor = vec4(col * a, a);
   }
 `;
-const SmokePlumeEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
-    const { intensity = 1, speed = 1, opacity = 0.6, particleCount = 180, height = 2, spread = 0.5, smokeColor = '#b4b4b8', turbulence = 0.5, heat = 0, wind = 0, } = config;
+/** Knobs that rebuild the particle set: commit only, never live. */
+const STRUCTURAL = ['particleCount'];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyConfig pushes. */
+const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.smokePlume.map((p) => p.value));
+/** The single push point: every config knob reaches its uniform here. */
+function applyConfig(u, c, bound) {
+    u.uSpeed.value = c.speed;
+    u.uBound.value = bound;
+    u.uIntensity.value = c.intensity;
+    u.uOpacity.value = c.opacity;
+    u.uHeight.value = c.height;
+    u.uSpread.value = c.spread;
+    u.uTurbulence.value = c.turbulence;
+    u.uWind.value = c.wind;
+    u.uHeat.value = c.heat;
+    u.uSmokeColor.value.set(c.smokeColor);
+}
+const SmokePlumeEffect = ({ boundingRadius, config, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) => {
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.smokePlume, config), [config]);
+    const { particleCount } = cfg;
     const rootRef = useRef(null);
-    const animCache = useRef({});
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // a standalone effect gets boundingRadius 1; guard against an empty host
     const b = boundingRadius > 0 ? boundingRadius : 1;
@@ -186,22 +205,13 @@ const SmokePlumeEffect = ({ boundingRadius, config, animations, onObjectReady, o
         return g;
     }, [particleCount]);
     useEffect(() => () => geometry.dispose(), [geometry]);
-    useLayoutEffect(() => {
-        uniforms.uSpeed.value = speed;
-        uniforms.uBound.value = b;
-        uniforms.uIntensity.value = intensity;
-        uniforms.uOpacity.value = opacity;
-        uniforms.uHeight.value = height;
-        uniforms.uSpread.value = spread;
-        uniforms.uTurbulence.value = turbulence;
-        uniforms.uWind.value = wind;
-        uniforms.uHeat.value = heat;
-        uniforms.uSmokeColor.value.set(smokeColor);
-    }, [uniforms, speed, b, intensity, opacity, height, spread, turbulence, wind, heat, smokeColor]);
+    const push = useCallback((merged) => {
+        applyConfig(uniforms, merged, b);
+    }, [uniforms, b]);
+    useLayoutEffect(() => { push(cfg); }, [push, cfg]);
+    useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
     useFrame((_, delta) => {
         uniforms.uTime.value += delta * uniforms.uSpeed.value;
-        if (animations?.length)
-            applyGenerativeAnimations(materials, animations, animCache.current, Date.now(), false);
     });
     return (_jsx("group", { ref: rootRef, children: _jsx("points", { geometry: geometry, material: materials[0], frustumCulled: false }) }));
 };

package/dist/components/effects/SmokeRibbon.d.ts

@@ -1,14 +1,20 @@
-import type { SmokeRibbonConfig } from '@3driseai/3drise-core';
+import type { AnimationOptions, MouseMoveDomain, SmokeRibbonConfig } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface SmokeRibbonProps extends ObjectReadyProps {
     config?: SmokeRibbonConfig;
     boundingRadius?: number;
+    /** Scene object id of a standalone effect: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this effect's config knobs (animations.effect.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this effect's config knobs (mouseMove.effect). */
+    mouseMove?: MouseMoveDomain;
 }
 /**
  * Place where you want the smoke to rise from — it climbs the parent's local +Y:
  *
  *   <SmokeRibbon position={[0, 0, 0]} config={{ planes: 2, twistStart: 0.2 }} />
  */
-declare const SmokeRibbon: ({ config, boundingRadius, onObjectReady, onObjectDispose, ...groupProps }: SmokeRibbonProps) => import("react").JSX.Element;
+declare const SmokeRibbon: ({ config, boundingRadius, id, keyframes, mouseMove, onObjectReady, onObjectDispose, ...groupProps }: SmokeRibbonProps) => import("react").JSX.Element;
 export default SmokeRibbon;
 //# sourceMappingURL=SmokeRibbon.d.ts.map

package/dist/components/effects/SmokeRibbon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,2EAAoF,gBAAgB,gCA0DxH,CAAC;AACF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"SmokeRibbon.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRibbon.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIlG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AA2BD;;;;GAIG;AACH,QAAA,MAAM,WAAW,GAAI,qGAA8G,gBAAgB,gCA6ClJ,CAAC;AACF,eAAe,WAAW,CAAC"}

package/dist/components/effects/SmokeRibbon.js

@@ -1,16 +1,40 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { PlaneGeometry } from 'three';
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
-import { SmokeRibbonMaterial } from '@3driseai/3drise-core';
+import { SmokeRibbonMaterial, DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from '@3driseai/3drise-core';
 import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+/** Knobs that rebuild the ribbon planes: commit only, never live. */
+const STRUCTURAL = ['width', 'height', 'segmentsPerLength', 'planes'];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyConfig pushes. */
+const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.smokeRibbon.map((p) => p.value));
+/** The single push point: every config knob reaches its uniform here. */
+function applyConfig(material, c) {
+    material.u_color.set(c.color);
+    material.u_colorTop.set(c.colorTop);
+    material.u_speed = c.speed;
+    material.u_detail = c.detail;
+    material.u_remapLow = c.remapLow;
+    material.u_remapHigh = c.remapHigh;
+    material.u_edgeX = c.edgeX;
+    material.u_edgeY = c.edgeY;
+    material.u_density = c.density;
+    material.u_twistStrength = c.twistStrength;
+    material.u_twistSpeed = c.twistSpeed;
+    material.u_twistScale = c.twistScale;
+    material.u_twistStart = c.twistStart;
+    material.u_windDir.set(c.wind[0], c.wind[1]);
+}
 /**
  * Place where you want the smoke to rise from — it climbs the parent's local +Y:
  *
  *   <SmokeRibbon position={[0, 0, 0]} config={{ planes: 2, twistStart: 0.2 }} />
  */
-const SmokeRibbon = ({ config = {}, boundingRadius = 1, onObjectReady, onObjectDispose, ...groupProps }) => {
-    const { width = 1.5, height = 5, segmentsPerLength = 12, planes = 2, color = '#f2f2f7', colorTop = '#b3b8c7', speed = 0.18, detail = 1.4, remapLow = 0.38, remapHigh = 1.0, edgeX = 0.4, edgeY = 0.32, density = 1.0, twistStrength = 9, twistSpeed = 0.4, twistScale = 0.9, twistStart = 0.18, wind = [0.15, 0], animate = true, interactive = false, } = config;
+const SmokeRibbon = ({ config = {}, boundingRadius = 1, id, keyframes, mouseMove, onObjectReady, onObjectDispose, ...groupProps }) => {
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.smokeRibbon, config), [config]);
+    const { width, height, segmentsPerLength, planes, animate, interactive } = cfg;
     // One material instance shared across the crossed planes -> one set of uniforms.
     const material = useMemo(() => new SmokeRibbonMaterial(), []);
     // One subdivided plane, bottom at the origin; reused per crossed copy.
@@ -29,30 +53,16 @@ const SmokeRibbon = ({ config = {}, boundingRadius = 1, onObjectReady, onObjectD
             return [0, Math.PI / 2];
         return [0, Math.PI / 3, (2 * Math.PI) / 3];
     }, [planes]);
-    // Push the look config onto the shared uniforms whenever it changes.
-    useLayoutEffect(() => {
-        material.u_color.set(color);
-        material.u_colorTop.set(colorTop);
-        material.u_speed = speed;
-        material.u_detail = detail;
-        material.u_remapLow = remapLow;
-        material.u_remapHigh = remapHigh;
-        material.u_edgeX = edgeX;
-        material.u_edgeY = edgeY;
-        material.u_density = density;
-        material.u_twistStrength = twistStrength;
-        material.u_twistSpeed = twistSpeed;
-        material.u_twistScale = twistScale;
-        material.u_twistStart = twistStart;
-        material.u_windDir.set(wind[0], wind[1]);
-    }, [
-        material, color, colorTop, speed, detail, remapLow, remapHigh, edgeX, edgeY,
-        density, twistStrength, twistSpeed, twistScale, twistStart, wind,
-    ]);
     const { pointer } = useThree();
     const hovering = useRef(false);
     const rootRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    // Committed config + live drag + keyframes + pointer, merged into the one push point.
+    const push = useCallback((merged) => {
+        applyConfig(material, merged);
+    }, [material]);
+    useLayoutEffect(() => { push(cfg); }, [push, cfg]);
+    useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
     useFrame(({ clock }) => {
         if (animate)
             material.u_time = clock.getElapsedTime();

package/dist/components/effects/SmokeRingEffect.d.ts

@@ -1,10 +1,15 @@
-import React from 'react';
-import type { AnimationOptions, SmokeRingConfig } from '@3driseai/3drise-core';
+import React from "react";
+import type { SmokeRingConfig, AnimationOptions, MouseMoveDomain } from "@3driseai/3drise-core";
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface SmokeRingEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: SmokeRingConfig;
-    animations?: AnimationOptions[];
+    /** Scene object id of a standalone effect: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this effect's config knobs (animations.effect.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this effect's config knobs (mouseMove.effect). */
+    mouseMove?: MouseMoveDomain;
 }
 declare const SmokeRingEffect: React.FC<SmokeRingEffectProps>;
 export default SmokeRingEffect;

package/dist/components/effects/SmokeRingEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAoND,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA+EnD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"SmokeRingEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/SmokeRingEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGhG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAwOD,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAsEnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/effects/SmokeRingEffect.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
-import * as THREE from 'three';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import * as THREE from 'three';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from "@3driseai/3drise-core";
 import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
 /**
  * Physically simulated vortex rings.
  *
@@ -216,11 +218,29 @@ const ringFrag = /* glsl */ `
     gl_FragColor = vec4(uSmokeColor * (0.55 + 0.6 * vShade) * a, a);
   }
 `;
-const SmokeRingEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
-    const { intensity = 1, speed = 1, opacity = 0.65, ringCount = 2, expansionRadius = 3, riseSpeed = 0.5, intervalSeconds = 2.5, smokeColor = '#c4c4c8', thickness = 0.18, leapfrog = true, wobble = 0.5, } = config;
+/** Nothing rebuilds the rings: the particle pool is fixed, and the ring count only gates slots. */
+const STRUCTURAL = [];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what the push point applies. */
+const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.smokeRing.map((p) => p.value));
+/** The single push point: every config knob reaches its uniform (shader or simulation) here. */
+function applyConfig(u, c) {
+    u.uSpeed.value = c.speed;
+    u.uIntensity.value = c.intensity;
+    u.uOpacity.value = c.opacity;
+    u.uSmokeColor.value.set(c.smokeColor);
+    u.uWobble.value = c.wobble;
+    u.uRingCount.value = c.ringCount;
+    u.uExpansionRadius.value = c.expansionRadius;
+    u.uRiseSpeed.value = c.riseSpeed;
+    u.uIntervalSeconds.value = c.intervalSeconds;
+    u.uThickness.value = c.thickness;
+}
+const SmokeRingEffect = ({ boundingRadius, config, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) => {
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.smokeRing, config), [config]);
     const rootRef = useRef(null);
-    const animCache = useRef({});
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    // the knobs read per frame (leapfrog), from the last merged config
+    const cur = useRef(cfg);
     // a standalone effect gets boundingRadius 1; guard against an empty host
     const b = boundingRadius > 0 ? boundingRadius : 1;
     const uniforms = useMemo(() => ({
@@ -252,21 +272,13 @@ const SmokeRingEffect = ({ boundingRadius, config, animations, onObjectReady, on
     }, []);
     useEffect(() => () => geometry.dispose(), [geometry]);
     const sim = useMemo(() => ({ state: createRingSim(), A: new Float32Array(16), B: new Float32Array(16), params: {} }), []);
-    useLayoutEffect(() => {
-        uniforms.uSpeed.value = speed;
-        uniforms.uIntensity.value = intensity;
-        uniforms.uOpacity.value = opacity;
-        uniforms.uSmokeColor.value.set(smokeColor);
-        uniforms.uWobble.value = wobble;
-        uniforms.uRingCount.value = ringCount;
-        uniforms.uExpansionRadius.value = expansionRadius;
-        uniforms.uRiseSpeed.value = riseSpeed;
-        uniforms.uIntervalSeconds.value = intervalSeconds;
-        uniforms.uThickness.value = thickness;
-    }, [uniforms, speed, intensity, opacity, smokeColor, wobble, ringCount, expansionRadius, riseSpeed, intervalSeconds, thickness]);
+    const push = useCallback((merged) => {
+        cur.current = merged;
+        applyConfig(uniforms, merged);
+    }, [uniforms]);
+    useLayoutEffect(() => { push(cfg); }, [push, cfg]);
+    useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
     useFrame((_, delta) => {
-        if (animations?.length)
-            applyGenerativeAnimations(materials, animations, animCache.current, Date.now(), false);
         const p = sim.params;
         p.bound = b;
         p.ringCount = uniforms.uRingCount.value;
@@ -274,7 +286,7 @@ const SmokeRingEffect = ({ boundingRadius, config, animations, onObjectReady, on
         p.riseSpeed = uniforms.uRiseSpeed.value;
         p.intervalSeconds = uniforms.uIntervalSeconds.value;
         p.thickness = uniforms.uThickness.value;
-        p.leapfrog = leapfrog;
+        p.leapfrog = !!cur.current.leapfrog;
         stepRingSim(sim.state, Math.min(delta, 0.05) * uniforms.uSpeed.value, p, sim.A, sim.B);
         for (let i = 0; i < RING_SLOTS; i++) {
             uniforms.uRingA.value[i].fromArray(sim.A, i * 4);

package/dist/components/effects/StrangeAttractorEffect.d.ts

@@ -1,10 +1,15 @@
-import React from 'react';
-import type { AnimationOptions, StrangeAttractorConfig } from '@3driseai/3drise-core';
+import React from "react";
+import type { StrangeAttractorConfig, AnimationOptions, MouseMoveDomain } from "@3driseai/3drise-core";
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface StrangeAttractorEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: StrangeAttractorConfig;
-    animations?: AnimationOptions[];
+    /** Scene object id of a standalone effect: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this effect's config knobs (animations.effect.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this effect's config knobs (mouseMove.effect). */
+    mouseMove?: MouseMoveDomain;
 }
 declare const StrangeAttractorEffect: React.FC<StrangeAttractorEffectProps>;
 export default StrangeAttractorEffect;

package/dist/components/effects/StrangeAttractorEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StrangeAttractorEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/StrangeAttractorEffect.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACnC;AA0KD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA8DjE,CAAC;AACF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"StrangeAttractorEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/StrangeAttractorEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AA8LD,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAkDjE,CAAC;AACF,eAAe,sBAAsB,CAAC"}

package/dist/components/effects/StrangeAttractorEffect.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
-import * as THREE from 'three';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import * as THREE from 'three';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from "@3driseai/3drise-core";
 import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
 /**
  * Glowing trails of a strange attractor (Lorenz, Aizawa or Thomas), integrated
  * once on the CPU with RK4. The strands start 0.001 apart and visibly part
@@ -177,11 +179,28 @@ const pointFrag = /* glsl */ `
     gl_FragColor = vec4(uHeadColor, core * core * vTrail * uOpacity);
   }
 `;
-const StrangeAttractorEffect = ({ boundingRadius, config, animations, onObjectReady, onObjectDispose }) => {
-    const { intensity, speed, color, opacity, system = 0, strands = 6, chaos = 0.5, trailLength = 0.18, scale = 1.4, ghostOpacity = 0.07, particleSize = 2.5, headColor = '#fff1c9', } = config;
+/** Knobs that re-integrate the trajectory (system, strand count, chaos): commit only, never live. */
+const STRUCTURAL = ['system', 'strands', 'chaos'];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyConfig pushes. */
+const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.strangeAttractor.map((p) => p.value));
+/** The single push point: every config knob reaches its uniform here. */
+function applyConfig(u, c, bound) {
+    u.uSpeed.value = c.speed;
+    u.uIntensity.value = c.intensity;
+    u.uOpacity.value = c.opacity;
+    u.uColor.value.set(c.color);
+    u.uHeadColor.value.set(c.headColor);
+    u.uTrailLength.value = c.trailLength;
+    u.uScale.value = c.scale;
+    u.uBound.value = bound;
+    u.uGhostOpacity.value = c.ghostOpacity;
+    u.uParticleSize.value = c.particleSize;
+}
+const StrangeAttractorEffect = ({ boundingRadius, config, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) => {
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.strangeAttractor, config), [config]);
+    const { system, strands, chaos } = cfg;
     const rootRef = useRef(null);
     const spinRef = useRef(null);
-    const animCache = useRef({});
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // one uniform set, shared by the trails and the head beads
     const uniforms = useMemo(() => ({
@@ -205,24 +224,15 @@ const StrangeAttractorEffect = ({ boundingRadius, config, animations, onObjectRe
     // integration only reruns when the trajectory itself changes
     const geometry = useMemo(() => buildAttractor(system, strands, chaos), [system, strands, chaos]);
     useEffect(() => () => { geometry.points.dispose(); geometry.lines.dispose(); }, [geometry]);
-    useLayoutEffect(() => {
-        uniforms.uSpeed.value = speed;
-        uniforms.uIntensity.value = intensity;
-        uniforms.uOpacity.value = opacity;
-        uniforms.uColor.value.set(color);
-        uniforms.uHeadColor.value.set(headColor);
-        uniforms.uTrailLength.value = trailLength;
-        uniforms.uScale.value = scale;
-        uniforms.uBound.value = boundingRadius;
-        uniforms.uGhostOpacity.value = ghostOpacity;
-        uniforms.uParticleSize.value = particleSize;
-    }, [uniforms, speed, intensity, opacity, color, headColor, trailLength, scale, boundingRadius, ghostOpacity, particleSize]);
+    const push = useCallback((merged) => {
+        applyConfig(uniforms, merged, boundingRadius);
+    }, [uniforms, boundingRadius]);
+    useLayoutEffect(() => { push(cfg); }, [push, cfg]);
+    useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
     useFrame((_, delta) => {
         uniforms.uTime.value += delta * uniforms.uSpeed.value;
         if (spinRef.current)
             spinRef.current.rotation.y += delta * 0.1 * uniforms.uSpeed.value;
-        if (animations?.length)
-            applyGenerativeAnimations(materials, animations, animCache.current, Date.now(), false);
     });
     return (_jsx("group", { ref: rootRef, children: _jsxs("group", { ref: spinRef, children: [_jsx("lineSegments", { geometry: geometry.lines, material: materials[0], frustumCulled: false }), _jsx("points", { geometry: geometry.points, material: materials[1], frustumCulled: false })] }) }));
 };

package/dist/components/effects/VolumetricFogEffect.d.ts

@@ -1,10 +1,15 @@
-import React from 'react';
-import type { AnimationOptions, VolumetricFogConfig } from '@3driseai/3drise-core';
+import React from "react";
+import type { VolumetricFogConfig, AnimationOptions, MouseMoveDomain } from "@3driseai/3drise-core";
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface VolumetricFogEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: VolumetricFogConfig;
-    animations?: AnimationOptions[];
+    /** Scene object id of a standalone effect: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this effect's config knobs (animations.effect.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this effect's config knobs (mouseMove.effect). */
+    mouseMove?: MouseMoveDomain;
     /** True when the fog surrounds a host object; the host's bounding sphere then blocks the fog behind it. */
     hasHost?: boolean;
 }

package/dist/components/effects/VolumetricFogEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,2GAA2G;IAC3G,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAgKD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAmF3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"VolumetricFogEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/VolumetricFogEffect.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,2GAA2G;IAC3G,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAoLD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAiF3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/components/effects/VolumetricFogEffect.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
-import * as THREE from 'three';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
-import { applyGenerativeAnimations } from '../../utils/handleGenerativeEffectsAnimations.js';
+import * as THREE from 'three';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { DEFAULT_GENERATIVE_EFFECTS, EFFECTS_ANIMATABLE } from "@3driseai/3drise-core";
 import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
 /**
  * Ray-marched ground fog around the host.
  *
@@ -34,6 +36,7 @@ const fogFrag = /* glsl */ `
   uniform float uSteps;
   uniform float uDensity;
   uniform float uDriftSpeed;
+  uniform float uDrift;  // integrated on the CPU: drift speed changes never jump
   uniform float uNoiseScale;
   uniform float uAnisotropy;
   uniform vec3  uFogColor;
@@ -87,7 +90,7 @@ const fogFrag = /* glsl */ `
     vec2 qc = (p.xz - 0.5 * (uBoxMin.xz + uBoxMax.xz)) / (0.5 * size.xz);
     float radial = 1.0 - smoothstep(0.5, 1.0, length(qc));
     if (layer * radial < 0.001) return 0.0;
-    float t = uTime * uDriftSpeed;
+    float t = uDrift;
     vec3 q = vec3(qc.x, h * size.y / (0.5 * size.x), qc.y) * uNoiseScale;
     // domain warp gives rolling, folded banks instead of blobs
     vec3 w = vec3(fbm3(q * 0.6 + vec3(t * 0.07, 0.0, 0.0), 2), fbm3(q * 0.6 + vec3(5.2, t * 0.05, 1.3), 2), 0.0);
@@ -157,12 +160,28 @@ const fogFrag = /* glsl */ `
 `;
 const _inv = new THREE.Matrix4();
 const _cam = new THREE.Vector3();
-const VolumetricFogEffect = ({ boundingRadius, config, animations, hasHost = false, onObjectReady, onObjectDispose }) => {
-    const { intensity = 1, speed = 0.4, color = '#fff1dc', opacity = 0.9, particleCount = 60, fogRadius = 1.8, driftSpeed = 0.3, fogColor = '#c9d2dc', density = 1, layerHeight = 1.2, anisotropy = 0.55, noiseScale = 1.5, } = config;
+/** Knobs that resize the fog box or set the march step count: commit only, never live. */
+const STRUCTURAL = ['fogRadius', 'layerHeight', 'particleCount'];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyConfig pushes. */
+const ANIMATABLE = new Set(EFFECTS_ANIMATABLE.volumetricFog.map((p) => p.value));
+/** The single push point: every config knob reaches its uniform here. */
+function applyConfig(u, c) {
+    u.uSpeed.value = c.speed;
+    u.uIntensity.value = c.intensity;
+    u.uOpacity.value = c.opacity;
+    u.uColor.value.set(c.color);
+    u.uFogColor.value.set(c.fogColor);
+    u.uDensity.value = c.density;
+    u.uDriftSpeed.value = c.driftSpeed;
+    u.uNoiseScale.value = c.noiseScale;
+    u.uAnisotropy.value = c.anisotropy;
+}
+const VolumetricFogEffect = ({ boundingRadius, config, id, keyframes, mouseMove, hasHost = false, onObjectReady, onObjectDispose }) => {
+    const cfg = useMemo(() => withConfigDefaults(DEFAULT_GENERATIVE_EFFECTS.volumetricFog, config), [config]);
+    const { particleCount, fogRadius, layerHeight } = cfg;
     const rootRef = useRef(null);
     const meshRef = useRef(null);
     const insideRef = useRef(false);
-    const animCache = useRef({});
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
     // a standalone effect gets boundingRadius 1; guard against an empty host
     const b = boundingRadius > 0 ? boundingRadius : 1;
@@ -171,6 +190,7 @@ const VolumetricFogEffect = ({ boundingRadius, config, animations, hasHost = fal
     const y0 = -b;
     const uniforms = useMemo(() => ({
         uTime: { value: 0 },
+        uDrift: { value: 0 },
         uSpeed: { value: 1 },
         uIntensity: { value: 1 },
         uOpacity: { value: 1 },
@@ -196,23 +216,23 @@ const VolumetricFogEffect = ({ boundingRadius, config, animations, hasHost = fal
     }, [R, H, y0]);
     useEffect(() => () => geometry.dispose(), [geometry]);
     const box = useMemo(() => new THREE.Box3(new THREE.Vector3(-R, y0, -R), new THREE.Vector3(R, y0 + H, R)), [R, H, y0]);
+    // the box and the march budget follow the committed (structural) knobs
     useLayoutEffect(() => {
-        uniforms.uSpeed.value = speed;
-        uniforms.uIntensity.value = intensity;
-        uniforms.uOpacity.value = opacity;
-        uniforms.uColor.value.set(color);
-        uniforms.uFogColor.value.set(fogColor);
-        uniforms.uDensity.value = density;
-        uniforms.uDriftSpeed.value = driftSpeed;
-        uniforms.uNoiseScale.value = noiseScale;
-        uniforms.uAnisotropy.value = anisotropy;
         uniforms.uSteps.value = Math.round(Math.min(Math.max(particleCount, 24), 128) * 0.5);
         uniforms.uBoxMin.value.copy(box.min);
         uniforms.uBoxMax.value.copy(box.max);
         uniforms.uHostRadius.value = hasHost ? b * 0.97 : 0;
-    }, [uniforms, speed, intensity, opacity, color, fogColor, density, driftSpeed, noiseScale, anisotropy, particleCount, box, hasHost, b]);
+    }, [uniforms, particleCount, box, hasHost, b]);
+    const push = useCallback((merged) => {
+        applyConfig(uniforms, merged);
+    }, [uniforms]);
+    useLayoutEffect(() => { push(cfg); }, [push, cfg]);
+    useConfigDriver({ rootRef, id, family: 'effects', base: cfg, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
     useFrame((state, delta) => {
-        uniforms.uTime.value += delta * uniforms.uSpeed.value * 2.5;
+        const dt = delta * uniforms.uSpeed.value * 2.5;
+        uniforms.uTime.value += dt;
+        // integrated, so changing the drift speed never makes the fog jump
+        uniforms.uDrift.value += dt * uniforms.uDriftSpeed.value;
         const mesh = meshRef.current;
         if (mesh) {
             mesh.updateWorldMatrix(true, false);
@@ -224,8 +244,6 @@ const VolumetricFogEffect = ({ boundingRadius, config, animations, hasHost = fal
                 materials[0].needsUpdate = true;
             }
         }
-        if (animations?.length)
-            applyGenerativeAnimations(materials, animations, animCache.current, Date.now(), false);
     });
     return (_jsx("group", { ref: rootRef, children: _jsx("mesh", { ref: meshRef, geometry: geometry, material: materials[0] }) }));
 };

package/dist/components/effects/WaterCausticsEffect.d.ts

@@ -1,10 +1,15 @@
 import React from 'react';
-import type { AnimationOptions, WaterCausticsConfig } from '@3driseai/3drise-core';
+import type { AnimationOptions, WaterCausticsConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import type { ObjectReadyProps } from '../../types/objectReady';
 export interface WaterCausticsEffectProps extends ObjectReadyProps {
     boundingRadius: number;
     config: WaterCausticsConfig;
-    animations?: AnimationOptions[];
+    /** Scene object id of a standalone effect: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this effect's config knobs (animations.effect.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this effect's config knobs (mouseMove.effect). */
+    mouseMove?: MouseMoveDomain;
     /** True when the effect is attached to an object, so it can react to the host. */
     hasHost?: boolean;
 }

package/dist/components/effects/WaterCausticsEffect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaterCausticsEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/WaterCausticsEffect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAkSD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA+B3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"WaterCausticsEffect.d.ts","sourceRoot":"","sources":["../../../src/components/effects/WaterCausticsEffect.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAIxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,yEAAyE;IACzE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAwSD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAqC3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}