@3driseai/3drise-viewer 0.1.25 → 0.1.27

package/dist/animationsV2/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/animationsV2/types.ts"],"names":[],"mappings":"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"}

package/dist/animationsV2/types.js

@@ -0,0 +1,8 @@
+// =============================================================================
+// Animations V2 — timeline clips and sequences (project docs
+// claude/animations-v2-design.md, claude/animations-v2-sequences-plan.md).
+// Shared by the studio (client) and the published viewer (ProjectLoader).
+// =============================================================================
+export const DEFAULT_DRIVER_SETTINGS = { sensitivity: 1, smoothing: 0.25, invert: false };
+export const DEFAULT_EASE = 'easeInOutCubic';
+export const FPS_PRESETS = [24, 25, 30, 60];

package/dist/api/sceneHandle.d.ts

@@ -1,4 +1,5 @@
-import type { ActionSequence, AnimationSequence } from '@3driseai/3drise-core';
+import type { ActionSequence } from '@3driseai/3drise-core';
+import type { AnimationClip, AnimationSequence } from '../animationsV2/types';
 export interface SceneActionInfo {
     id: string;
     key?: string;
@@ -6,23 +7,59 @@ export interface SceneActionInfo {
     description?: string;
     applied: boolean;
 }
-export interface SceneAnimationInfo {
+export interface SceneClipInfo {
     id: string;
+    key: string;
     name: string;
     description?: string;
-    /** Seconds, one forward pass: Σ(delay + duration) over steps */
+    /** Seconds, one pass. */
     duration: number;
     loop: boolean;
     yoyo: boolean;
+    endMode: 'hold' | 'restore';
+    playing: boolean;
+}
+export interface SceneSequenceInfo {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    /** Seconds, one pass through every step. */
+    duration: number;
+    steps: number;
+    loop: boolean;
+    yoyo: boolean;
+    reverse: boolean;
+    endMode: 'hold' | 'restore';
+    /** 'time' plays; 'mouseWheel' | 'mouseX' | 'mouseY' — the input scrubs it once played. */
+    driver: 'time' | 'mouseWheel' | 'mouseX' | 'mouseY';
+    autoplay: boolean;
     playing: boolean;
 }
 export interface ScenePlayOptions {
+    /** Playback rate, 1 = authored. */
     speed?: number;
+    /** Play backwards. For a sequence this overrides its own `reverse` for this run. */
     reverse?: boolean;
+    /** Where to start, 0–1 of the duration. */
+    from?: number;
+}
+/** The same controls for clips and for sequences. */
+export interface ScenePlayback<Info> {
+    list(): Info[];
+    play(ref: string, options?: ScenePlayOptions): boolean;
+    pause(ref: string): boolean;
+    resume(ref: string): boolean;
+    /** Stop and put everything it animated back to the authored scene. */
+    stop(ref: string): boolean;
+    /** Jump to a point, 0–1 of the duration. */
+    seek(ref: string, progress: number): boolean;
+    isPlaying(ref: string): boolean;
 }
-export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd';
+export type SceneHandleEventType = 'actionApplied' | 'actionReverted' | 'animationStart' | 'animationEnd' | 'animationLoop';
 export interface SceneHandleEvent {
     type: SceneHandleEventType;
+    kind: 'action' | 'clip' | 'sequence';
     id: string;
     key?: string;
     name: string;
@@ -38,26 +75,28 @@ export interface SceneHandle {
         /** Revert every applied action of this project — back to the authored scene. */
         reset(): void;
     };
-    animations: {
-        list(): SceneAnimationInfo[];
-        play(ref: string, options?: ScenePlayOptions): boolean;
-        pause(ref: string): boolean;
-        resume(ref: string): boolean;
-        stop(ref: string): boolean;
-        /** Jump to a point in the animation, 0–1. */
-        seek(ref: string, progress: number): boolean;
-        isPlaying(ref: string): boolean;
+    clips: ScenePlayback<SceneClipInfo>;
+    sequences: ScenePlayback<SceneSequenceInfo> & {
+        /**
+         * Drive a sequence from your own input (page scroll, a slider…): its position,
+         * 0–1 along its own direction. A running input-driven sequence eases there with
+         * its smoothing; otherwise it is posed there at once.
+         */
+        setProgress(ref: string, progress: number): boolean;
+        /** Current position, 0–1 along its own direction. */
+        getProgress(ref: string): number;
     };
-    /** Subscribe to this project's action / animation events. Returns the unsubscribe. */
+    /** Subscribe to this project's action / clip / sequence events. Returns the unsubscribe. */
     on(type: SceneHandleEventType, listener: (event: SceneHandleEvent) => void): () => void;
 }
 export interface SceneHandleSource {
     actions: ActionSequence[];
-    animations: AnimationSequence[];
+    clips: AnimationClip[];
+    sequences: AnimationSequence[];
 }
 /**
- * Build a handle over one project's actions and animations. `getSource` is read on
- * every call, so the handle stays valid if the project data is replaced.
+ * Build a handle over one project's actions, clips and sequences. `getSource` is
+ * read on every call, so the handle stays valid if the project data is replaced.
  */
 export declare function createSceneHandle(getSource: () => SceneHandleSource): SceneHandle;
 //# sourceMappingURL=sceneHandle.d.ts.map

package/dist/api/sceneHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sceneHandle.d.ts","sourceRoot":"","sources":["../../src/api/sceneHandle.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAkB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE1G,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE;QACL,IAAI,IAAI,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,0FAA0F;QAC1F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAChC,gFAAgF;QAChF,KAAK,IAAI,IAAI,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACR,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC;QACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3B,6CAA6C;QAC7C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;IACF,sFAAsF;IACtF,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3F;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACnC;AA0BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,iBAAiB,GAAG,WAAW,CAuGjF"}
+{"version":3,"file":"sceneHandle.d.ts","sourceRoot":"","sources":["../../src/api/sceneHandle.ts"],"names":[],"mappings":"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"}

package/dist/api/sceneHandle.js

@@ -3,21 +3,24 @@
 // =============================================================================
 //
 // What a developer extending a project gets from <ProjectLoader ref={…} /> or
-// onSceneReady(handle): trigger the project's actions and animations from their
-// own UI, and hear when they run.
+// onSceneReady(handle): trigger the project's actions, clips and sequences from
+// their own UI, and hear when they run.
 //
 //   scene.current?.actions.toggle('open-door');
-//   scene.current?.animations.play('intro', { speed: 1.5 });
-//   const off = scene.current?.on('actionApplied', (e) => console.log(e.key));
+//   scene.current?.clips.play('spin');                    // one clip, its own loop / yoyo / end
+//   scene.current?.sequences.play('intro', { speed: 1.5 });
+//   const off = scene.current?.on('animationEnd', (e) => console.log(e.kind, e.key));
 //
-// Addressing (`ref`): an action's `key` first (stable across renames and project
-// copies — prefer it), then its id, then its exact name. Animations have no key
-// yet, so id, then name. An ambiguous name warns and uses the first match.
+// Addressing (`ref`): the item's `key` first (stable across renames and project
+// copies — prefer it), then its id, then its exact name. An ambiguous name warns
+// and uses the first match. Clip and sequence keys are separate namespaces.
 //
 // This is a thin layer: object clicks go through the same SceneActions /
-// AnimationsManager calls, so a button and a click behave identically.
+// ClipsRuntime calls, so a button and a click behave identically.
 //
-import { AnimationsManager, SceneActions } from '@3driseai/3drise-core';
+import { SceneActions } from '@3driseai/3drise-core';
+import ClipsRuntime from '../animationsV2/ClipsRuntime.js';
+import { clipMap, resolveSequence } from '../animationsV2/sequenceUtils.js';
 function resolve(items, ref, kind) {
     if (!ref)
         return undefined;
@@ -29,25 +32,146 @@ function resolve(items, ref, kind) {
         return byId;
     const byName = items.filter(i => i.name === ref);
     if (byName.length > 1) {
-        console.warn(`[3drise] ${byName.length} ${kind}s are named "${ref}"; using the first.${kind === 'action' ? ' Address it by its key instead.' : ''}`);
+        console.warn(`[3drise] ${byName.length} ${kind}s are named "${ref}"; using the first. Address it by its key instead.`);
     }
     if (byName.length === 0) {
-        console.warn(`[3drise] No ${kind} "${ref}" in this project. Known: ${items.map(i => i.key ?? i.name).join(', ') || 'none'}`);
+        console.warn(`[3drise] No ${kind} "${ref}" in this project. Known: ${items.map(i => i.key || i.name).join(', ') || 'none'}`);
     }
     return byName[0];
 }
-function animationDuration(seq) {
-    return (seq.steps ?? []).reduce((sum, s) => sum + (s.delay || 0) + (s.duration || 0), 0);
-}
+const clamp01 = (n) => Math.min(1, Math.max(0, Number.isFinite(n) ? n : 0));
 /**
- * Build a handle over one project's actions and animations. `getSource` is read on
- * every call, so the handle stays valid if the project data is replaced.
+ * Build a handle over one project's actions, clips and sequences. `getSource` is
+ * read on every call, so the handle stays valid if the project data is replaced.
  */
 export function createSceneHandle(getSource) {
     const actions = () => getSource().actions ?? [];
-    const animations = () => getSource().animations ?? [];
+    const clips = () => getSource().clips ?? [];
+    const sequences = () => getSource().sequences ?? [];
+    const clipsById = () => clipMap(clips());
     const findAction = (ref) => resolve(actions(), ref, 'action');
-    const findAnimation = (ref) => resolve(animations(), ref, 'animation');
+    const findClip = (ref) => resolve(clips(), ref, 'clip');
+    const findSequence = (ref) => resolve(sequences(), ref, 'sequence');
+    const sequenceDuration = (s) => resolveSequence(s, clipsById()).duration;
+    const clipControls = {
+        list: () => clips().map(c => ({
+            id: c.id, key: c.key, name: c.name, description: c.description,
+            duration: c.duration, loop: c.loop, yoyo: c.yoyo, endMode: c.endMode,
+            playing: ClipsRuntime.isPlaying(c.id),
+        })),
+        play(ref, options = {}) {
+            const c = findClip(ref);
+            if (!c)
+                return false;
+            ClipsRuntime.play(c, {
+                speed: options.speed,
+                reverse: options.reverse,
+                from: options.from !== undefined ? clamp01(options.from) * c.duration : undefined,
+            });
+            return true;
+        },
+        pause(ref) {
+            const c = findClip(ref);
+            if (!c)
+                return false;
+            ClipsRuntime.pause(c.id);
+            return true;
+        },
+        resume(ref) {
+            const c = findClip(ref);
+            if (!c)
+                return false;
+            ClipsRuntime.resume(c.id);
+            return true;
+        },
+        stop(ref) {
+            const c = findClip(ref);
+            if (!c)
+                return false;
+            ClipsRuntime.stop(c.id);
+            return true;
+        },
+        seek(ref, progress) {
+            const c = findClip(ref);
+            if (!c)
+                return false;
+            ClipsRuntime.pose(c, clamp01(progress) * c.duration);
+            return true;
+        },
+        isPlaying(ref) {
+            const c = findClip(ref);
+            return c ? ClipsRuntime.isPlaying(c.id) : false;
+        },
+    };
+    const sequenceControls = {
+        list: () => sequences().map(s => ({
+            id: s.id, key: s.key, name: s.name, description: s.description,
+            duration: sequenceDuration(s), steps: s.steps.length,
+            loop: s.loop, yoyo: s.yoyo, reverse: s.reverse, endMode: s.endMode,
+            driver: s.driver, autoplay: s.autoplay,
+            playing: ClipsRuntime.isSequencePlaying(s.id),
+        })),
+        play(ref, options = {}) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            ClipsRuntime.playSequence(s, clipsById(), {
+                speed: options.speed,
+                reverse: options.reverse,
+                from: options.from !== undefined ? clamp01(options.from) * sequenceDuration(s) : undefined,
+            });
+            return true;
+        },
+        pause(ref) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            ClipsRuntime.pauseSequence(s.id);
+            return true;
+        },
+        resume(ref) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            ClipsRuntime.resumeSequence(s.id);
+            return true;
+        },
+        stop(ref) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            ClipsRuntime.stopSequence(s.id);
+            return true;
+        },
+        seek(ref, progress) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            const lookup = clipsById();
+            ClipsRuntime.poseSequence(s, lookup, clamp01(progress) * resolveSequence(s, lookup).duration);
+            return true;
+        },
+        isPlaying(ref) {
+            const s = findSequence(ref);
+            return s ? ClipsRuntime.isSequencePlaying(s.id) : false;
+        },
+        setProgress(ref, progress) {
+            const s = findSequence(ref);
+            if (!s)
+                return false;
+            if (ClipsRuntime.isSequenceActive(s.id))
+                return ClipsRuntime.setSequenceProgress(s.id, progress);
+            const lookup = clipsById();
+            const total = resolveSequence(s, lookup).duration;
+            const p = clamp01(progress);
+            ClipsRuntime.poseSequence(s, lookup, (s.reverse ? 1 - p : p) * total);
+            return true;
+        },
+        getProgress(ref) {
+            const s = findSequence(ref);
+            return s ? ClipsRuntime.getSequenceProgress(s.id) : 0;
+        },
+    };
     return {
         actions: {
             list: () => actions().map(a => ({
@@ -85,56 +209,8 @@ export function createSceneHandle(getSource) {
                     SceneActions.revertAction(a.id);
             },
         },
-        animations: {
-            list: () => animations().map(s => ({
-                id: s.id,
-                name: s.name,
-                description: s.description,
-                duration: animationDuration(s),
-                loop: !!s.loop,
-                yoyo: !!s.yoyo,
-                playing: AnimationsManager.isSequencePlaying(s.id),
-            })),
-            play(ref, options = {}) {
-                const s = findAnimation(ref);
-                if (!s)
-                    return false;
-                AnimationsManager.playSequence(s, { speed: options.speed, reverse: options.reverse });
-                return true;
-            },
-            pause(ref) {
-                const s = findAnimation(ref);
-                if (!s)
-                    return false;
-                AnimationsManager.pauseSequence(s.id);
-                return true;
-            },
-            resume(ref) {
-                const s = findAnimation(ref);
-                if (!s)
-                    return false;
-                AnimationsManager.resumeSequence(s.id);
-                return true;
-            },
-            stop(ref) {
-                const s = findAnimation(ref);
-                if (!s)
-                    return false;
-                AnimationsManager.stopSequence(s.id);
-                return true;
-            },
-            seek(ref, progress) {
-                const s = findAnimation(ref);
-                if (!s)
-                    return false;
-                AnimationsManager.seekToProgress(s.id, progress);
-                return true;
-            },
-            isPlaying(ref) {
-                const s = findAnimation(ref);
-                return s ? AnimationsManager.isSequencePlaying(s.id) : false;
-            },
-        },
+        clips: clipControls,
+        sequences: sequenceControls,
         on(type, listener) {
             if (type === 'actionApplied' || type === 'actionReverted') {
                 return SceneActions.onEvent((e) => {
@@ -144,17 +220,18 @@ export function createSceneHandle(getSource) {
                         return;
                     const a = actions().find(x => x.id === e.actionId);
                     if (a)
-                        listener({ type, id: a.id, key: a.key, name: a.name });
+                        listener({ type, kind: 'action', id: a.id, key: a.key, name: a.name });
                 });
             }
-            const managerEvent = type === 'animationStart' ? 'sequenceStart' : 'sequenceEnd';
-            const handler = (e) => {
-                const s = animations().find(x => x.id === e.sequenceId);
-                if (s)
-                    listener({ type, id: s.id, name: s.name });
-            };
-            AnimationsManager.on(managerEvent, handler);
-            return () => AnimationsManager.off(managerEvent, handler);
+            const wanted = type === 'animationStart' ? 'start' : type === 'animationEnd' ? 'end' : 'loop';
+            return ClipsRuntime.on((e) => {
+                if (e.type !== wanted)
+                    return;
+                // Only this project's items — another scene on the page shares the runtime.
+                const item = e.kind === 'clip' ? clips().find(c => c.id === e.id) : sequences().find(s => s.id === e.id);
+                if (item)
+                    listener({ type, kind: e.kind, id: item.id, key: item.key, name: item.name });
+            });
         },
     };
 }

package/dist/components/AdvancedGrid.d.ts

@@ -1,9 +1,15 @@
 import type { ObjectReadyProps } from '../types/objectReady';
 import type { ThreeElements } from '@react-three/fiber';
-import type { MyGridConfig } from '@3driseai/3drise-core';
+import type { AnimationOptions, MouseMoveDomain, MyGridConfig } from '@3driseai/3drise-core';
 export interface AdvancedGridProps extends ObjectReadyProps {
     config?: MyGridConfig;
     groupProps?: ThreeElements['group'];
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on this grid's config knobs (animations.grid.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on this grid's config knobs (mouseMove.grid). */
+    mouseMove?: MouseMoveDomain;
 }
 /**
  * MyGridConfig — the single source of truth for a grid instance.
@@ -11,6 +17,6 @@ export interface AdvancedGridProps extends ObjectReadyProps {
  * and any preset/serialization layer.
  */
 export declare const defaultMyGridConfig: MyGridConfig;
-export declare function AdvancedGrid({ config, groupProps, onObjectReady, onObjectDispose }: AdvancedGridProps): import("react").JSX.Element;
+export declare function AdvancedGrid({ config, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }: AdvancedGridProps): import("react").JSX.Element;
 export default AdvancedGrid;
 //# sourceMappingURL=AdvancedGrid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AdvancedGrid.d.ts","sourceRoot":"","sources":["../../src/components/AdvancedGrid.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACvC;AAKD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAyBjC,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,MAA4B,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,iBAAiB,+BAiE3H;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"AdvancedGrid.d.ts","sourceRoot":"","sources":["../../src/components/AdvancedGrid.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7F,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAKD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAyBjC,CAAC;AAWF,wBAAgB,YAAY,CAAC,EAAE,MAA4B,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,EAAE,iBAAiB,+BA+CrJ;AAED,eAAe,YAAY,CAAC"}

package/dist/components/AdvancedGrid.js

@@ -1,9 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useGridSurface } from '../hooks/useGridSurface.js';
-import { useMemo, useRef } from 'react';
+import { useConfigDriver } from '../hooks/useConfigDriver.js';
+import { withConfigDefaults } from '../utils/configAnimations.js';
+import { applyGridConfig, GRID_STRUCTURAL } from '../utils/gridConfig.js';
+import { useCallback, useLayoutEffect, useMemo, useRef } from 'react';
 import * as THREE from 'three';
-import { MyGridMaterial } from '@3driseai/3drise-core';
+import { MyGridMaterial, GRIDS_ANIMATABLE } from '@3driseai/3drise-core';
 // Side-effect import registers <myGridMaterial> via extend() in MyGridMaterial.ts.
 void MyGridMaterial;
 /**
@@ -37,27 +40,41 @@ export const defaultMyGridConfig = {
     reveal: 1,
     revealDuration: 0,
 };
-export function AdvancedGrid({ config = defaultMyGridConfig, groupProps, onObjectReady, onObjectDispose }) {
+/** No knobs of its own: the shared surface knobs are all there is. */
+const VARIANT = [];
+/** No computed uniforms: every knob maps straight to its u_<key>. */
+const DERIVE = {};
+/** Knobs that rebuild the plane or pick a mode: they change on commit, never through the live path. */
+const STRUCTURAL = [...GRID_STRUCTURAL];
+/** Knobs a keyframe or pointer binding may drive per frame — exactly what applyGridConfig pushes. */
+const ANIMATABLE = new Set((GRIDS_ANIMATABLE.advancedGrid ?? []).map((p) => p.value));
+export function AdvancedGrid({ config = defaultMyGridConfig, groupProps, id, keyframes, mouseMove, onObjectReady, onObjectDispose }) {
     const matRef = useRef(null);
     const rootRef = useRef(null);
     const meshRef = useRef(null);
     useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
-    const { cellSize, size, segments, flat, lineMode, cellMode, lineWidth, sectionSize, sectionWidth, animSpeed, animScale, animIntensity, fadeDistance, fadeStrength, displace, lineColor, sectionColor, cellColor, glowColor, bgColor, bgOpacity, followMouse, reveal, revealDuration, } = config;
+    // The committed config over this grid's defaults: every knob has a value to render
+    // and for a keyframe or pointer binding to start from.
+    const base = useMemo(() => withConfigDefaults(defaultMyGridConfig, config), [config]);
+    const { cellSize, size, segments, flat, displace, followMouse, reveal, revealDuration } = base;
     const segs = segments ?? (displace > 0 ? Math.max(64, Math.ceil(size / cellSize) * 2) : 1);
-    const fade = fadeDistance ?? size * 0.5;
-    // memoize Color objects so we only re-allocate when the hex actually changes
-    const colors = useMemo(() => ({
-        line: new THREE.Color(lineColor),
-        section: new THREE.Color(sectionColor),
-        cell: new THREE.Color(cellColor),
-        glow: new THREE.Color(glowColor),
-        bg: new THREE.Color(bgColor),
-    }), [lineColor, sectionColor, cellColor, glowColor, bgColor]);
     // Shared with every other shader-plane grid. This also fixes the pointer
     // projection: it used to assume the XZ plane, so `followMouse` picked
     // against the wrong plane whenever `flat` was false or a parent transform
     // had rotated the grid.
     useGridSurface(matRef, meshRef, { followMouse, reveal, revealDuration });
-    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("myGridMaterial", { ref: matRef, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide, u_cellSize: cellSize, u_lineWidth: lineWidth, u_sectionSize: sectionSize, u_sectionWidth: sectionWidth, u_lineMode: lineMode, u_cellMode: cellMode, u_animSpeed: animSpeed, u_animScale: animScale, u_animIntensity: animIntensity, u_fadeDistance: fade, u_fadeStrength: fadeStrength, u_displace: displace, u_lineColor: colors.line, u_sectionColor: colors.section, u_cellColor: colors.cell, u_glowColor: colors.glow, u_bgColor: colors.bg, u_bgOpacity: bgOpacity }, MyGridMaterial.key)] }) }));
+    // One push point for every uniform the config owns: the committed config when the
+    // material mounts or the config commits, the merged one while anything overrides it.
+    const baseRef = useRef(base);
+    baseRef.current = base;
+    const setMaterial = useCallback((m) => {
+        matRef.current = m;
+        if (m)
+            applyGridConfig(m, baseRef.current, VARIANT, DERIVE);
+    }, []);
+    useLayoutEffect(() => { applyGridConfig(matRef.current, base, VARIANT, DERIVE); }, [base]);
+    const push = useCallback((merged) => applyGridConfig(matRef.current, merged, VARIANT, DERIVE), []);
+    useConfigDriver({ rootRef, id, family: 'grids', base, structural: STRUCTURAL, allowed: ANIMATABLE, keyframes, mouseMove, push });
+    return (_jsx("group", { ref: rootRef, ...groupProps, children: _jsxs("mesh", { ref: meshRef, rotation: flat ? [-Math.PI / 2, 0, 0] : [0, 0, 0], children: [_jsx("planeGeometry", { args: [size, size, segs, segs] }), _jsx("myGridMaterial", { ref: setMaterial, transparent: true, depthWrite: false, blending: THREE.AdditiveBlending, side: THREE.DoubleSide }, MyGridMaterial.key)] }) }));
 }
 export default AdvancedGrid;

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

@@ -1 +1 @@
-{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAqFvD,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AnimatedObject.d.ts","sourceRoot":"","sources":["../../src/components/AnimatedObject.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtG,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,qBAAqB,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACjH,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAGD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiFvD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/components/AnimatedObject.js

@@ -1,8 +1,8 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useObjectReady } from '../hooks/useObjectReady.js';
 import { useRef, useEffect, useCallback, memo } from 'react';
 import { usePathAnimation } from '../hooks/usePathAnimation.js';
-import EffectsGroup from './EffectsGroup.js';
+import { useObjectEffectLayers } from '../operations/useObjectEffectLayers.js';
 import { useObjectAnimation } from '../hooks/useObjectAnimation.js';
 import { hasHoverAnimation } from '../utils/hasHoverAnimation.js';
 export const AnimatedObject = memo(({ stateKey, transitionSettings, createdObject, 
@@ -39,6 +39,8 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
         enabled: createdObject.type !== 'gallery', // 
         hovered,
     }, groupRef);
+    // Effects layered on the object (frost, metalize…) — switched on / off, held while on.
+    useObjectEffectLayers(groupRef, createdObject.effects);
     const { startPathAnimation, updatePathAnimation, isAnimating: isPathAnimating } = usePathAnimation();
     const syncTransform = useCallback(() => {
         const obj = groupRef.current;
@@ -64,13 +66,13 @@ visible = true, children, parentRef, handleObjectClick, onPointerEnter, onPointe
         }
     };
     if (createdObject.type === 'particles' || createdObject.type === 'gallery' || (!hasHoverFunctionalities && !hasMouseInteraction)) {
-        return _jsx(_Fragment, { children: _jsxs("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, 
+        return _jsx(_Fragment, { children: _jsx("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, 
                 //  onClick={onClick}
                 // onPointerEnter={onPointerEnter}
                 // onPointerLeave={onPointerLeave}
-                name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject, objectRef: groupRef, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }) });
+                name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: children }) });
     }
-    return (_jsxs("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: [children, _jsx(EffectsGroup, { createdObject: createdObject, objectRef: groupRef, onObjectReady: onObjectReady, onObjectDispose: onObjectDispose })] }));
+    return (_jsx("group", { ref: groupRef, position: position, scale: scale, rotation: rotation, visible: visible, onClick: onClick, onPointerEnter: onPointerEnter, onPointerLeave: onPointerLeave, name: createdObject.meshSettings.name, userData: { id: createdObject.id }, children: children }));
 });
 AnimatedObject.displayName = 'AnimatedObject';
 export default AnimatedObject;

package/dist/components/Bubbles.d.ts

@@ -1,9 +1,15 @@
 import type { ObjectReadyProps } from '../types/objectReady';
-import type { BubblesConfig } from '@3driseai/3drise-core';
+import type { AnimationOptions, BubblesConfig, MouseMoveDomain } from '@3driseai/3drise-core';
 import React from "react";
 export interface BubblesProps extends ObjectReadyProps {
     config: BubblesConfig;
     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;
 }
 declare const Bubbles: React.FC<BubblesProps>;
 export default Bubbles;

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

@@ -1 +1 @@
-{"version":3,"file":"Bubbles.d.ts","sourceRoot":"","sources":["../../src/components/Bubbles.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAmGnC,CAAC;AACF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Bubbles.d.ts","sourceRoot":"","sources":["../../src/components/Bubbles.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IAClD,MAAM,EAAE,aAAa,CAAC;IACtB,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;AAyBD,QAAA,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAqGnC,CAAC;AACF,eAAe,OAAO,CAAC"}