@3driseai/3drise-viewer 0.1.27 → 0.1.29

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

@@ -1 +1 @@
-{"version":3,"file":"ClipPlayer.d.ts","sourceRoot":"","sources":["../../src/animationsV2/ClipPlayer.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAIjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IACvD,6FAA6F;IAC7F,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CACzE;AAcD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAoJzC,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ClipPlayer.d.ts","sourceRoot":"","sources":["../../src/animationsV2/ClipPlayer.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAKjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IACvD,6FAA6F;IAC7F,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;QAAC,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CACzE;AAcD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAuJzC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/animationsV2/ClipPlayer.js

@@ -26,6 +26,7 @@ import { useEffect, useRef } from 'react';
 import { useFrame, useThree } from '@react-three/fiber';
 import ClipsRuntime from './ClipsRuntime.js';
 import { clipMap } from './sequenceUtils.js';
+import { sceneReadiness } from '../triggers/readiness.js';
 /** Wheel delta in pixels, whatever the device reports. */
 const wheelPixels = (e) => e.deltaMode === 1 ? e.deltaY * 16 : e.deltaMode === 2 ? e.deltaY * window.innerHeight : e.deltaY;
 /** Diagnostics switch: `?animdebug=1` or localStorage '3drise.animdebug' = '1'. */
@@ -75,16 +76,19 @@ const ClipPlayer = ({ getSettings, getAction, autoplay }) => {
     useEffect(() => {
         if (!autoplay)
             return;
-        const lookup = clipMap(autoplay.clips);
-        ClipsRuntime.dlog('autoplay effect', {
-            clips: autoplay.clips.length,
-            sequences: autoplay.sequences.map(s => ({ name: s.name, autoplay: s.autoplay, driver: s.driver, active: ClipsRuntime.isSequenceActive(s.id) })),
+        // nothing starts before the scene is ready (models loaded, shaders compiled)
+        return sceneReadiness.whenReady(() => {
+            const lookup = clipMap(autoplay.clips);
+            ClipsRuntime.dlog('autoplay effect', {
+                clips: autoplay.clips.length,
+                sequences: autoplay.sequences.map(s => ({ name: s.name, autoplay: s.autoplay, driver: s.driver, active: ClipsRuntime.isSequenceActive(s.id) })),
+            });
+            for (const seq of autoplay.sequences) {
+                if (!seq.autoplay || ClipsRuntime.isSequenceActive(seq.id))
+                    continue;
+                ClipsRuntime.playSequence(seq, lookup, { waitForTargets: true });
+            }
         });
-        for (const seq of autoplay.sequences) {
-            if (!seq.autoplay || ClipsRuntime.isSequenceActive(seq.id))
-                continue;
-            ClipsRuntime.playSequence(seq, lookup, { waitForTargets: true });
-        }
     }, [autoplay?.sequences, autoplay?.clips]);
     const isPublished = !!autoplay;
     useEffect(() => () => { if (isPublished)

package/dist/animationsV2/ClipsRuntime.d.ts

@@ -1,4 +1,5 @@
 import type { AnimationClip, AnimationSequence, KeyValue, Track } from './types';
+import type { ActionSequence, SceneCommand } from '@3driseai/3drise-core';
 import { type ApplyContext } from './appliers';
 import { type ClipLookup, type ScheduledClip } from './sequenceUtils';
 /** A driven sequence as the input layer sees it. */
@@ -17,7 +18,22 @@ export interface RuntimeEvent {
 }
 /** @deprecated name kept for existing imports */
 export type ClipEvent = RuntimeEvent;
+/**
+ * How a cue switches (apply / revert) or fires its subject. The triggers engine installs one,
+ * so cues run through it with the clip or sequence as their source. Returns false when an
+ * 'apply' left the subject alone (another source already had it on — the timeline then never
+ * reverts it). Without a runner only action cues run (SceneActions directly), as before.
+ */
+export type CueRunner = (command: SceneCommand, mode: 'apply' | 'revert' | 'fire', opts: {
+    effects: boolean;
+    host: 'sequence' | 'clip';
+    timelineId: string;
+    getAction?: (id: string) => ActionSequence | undefined;
+}) => boolean;
 declare class ClipsRuntime {
+    private cueRunner;
+    /** The triggers engine runs cues (see CueRunner). */
+    setCueRunner(fn: CueRunner | null): void;
     private clips;
     private sequences;
     private ctx;
@@ -32,6 +48,8 @@ declare class ClipsRuntime {
     private pendingRestore;
     /** last written value per property (targetKey -> JSON) */
     private written;
+    /** values written straight from outside (a UI slider): targetKey -> value. */
+    private live;
     debug: boolean;
     private logAt;
     dlog(...args: unknown[]): void;
@@ -39,6 +57,17 @@ declare class ClipsRuntime {
     private dlogEvery;
     private caller;
     setContext(ctx: ApplyContext | null): void;
+    /**
+     * Write one value to the live scene by settings path — the same appliers a clip track
+     * uses, so nothing goes through React and nothing is saved. A running clip that
+     * animates the same property wins again on its next write. False when there is no
+     * applier for the path or its target is not mounted.
+     */
+    setLiveValue(state: string, path: string, value: KeyValue, node?: string): boolean;
+    /** What was last written by `setLiveValue`, else the authored value (action patches included). */
+    getLiveValue(state: string, path: string, node?: string): KeyValue | undefined;
+    /** Whether `setLiveValue` can write this path (it has an applier). */
+    canSetLiveValue(state: string, path: string): boolean;
     /**
      * Every change, including each frame's time while anything plays. For UI that
      * follows the playhead, write through refs in the listener — never re-render React
@@ -120,11 +149,23 @@ declare class ClipsRuntime {
     isSequencePlaying(seqId: string): boolean;
     isSequenceActive(seqId: string): boolean;
     tick(delta: number): void;
-    /** Objects / nodes the sequence animates — or its cued actions touch — that aren't in the scene yet. */
+    /** Objects / nodes the sequence animates — or its cues act on — that aren't in the scene yet. */
     private missingTargets;
-    /** Apply / revert the actions whose cue state changed since the last tick. */
+    /**
+     * Switch a timeline's lanes to what time T asks for. A lane switched on by someone else
+     * already is left alone (and never switched off by this timeline).
+     */
+    private syncLanes;
+    private switchOff;
+    /** Switch the sequence's lanes to what its time asks for. */
     private syncCues;
-    /** Revert every action the sequence applied (stop / close). */
+    /** Fire the 'fire' cues the playhead crossed moving forward since the last tick. */
+    private fireCues;
+    /** A clip's cues: state lanes to what its time asks for, and fire cues crossed moving forward. */
+    private syncClipCues;
+    /** Switch off every lane a timeline switched on (stop / close). */
+    private releaseCues;
+    /** Revert every lane the sequence switched on (stop / close). */
     private releaseActions;
     /** Every driver's values for this frame, lowest priority first. */
     private proposals;

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

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

package/dist/animationsV2/ClipsRuntime.js

@@ -33,13 +33,16 @@
 //
 import { SceneActions } from '@3driseai/3drise-core';
 import { getAtPath, sampleTrack } from './clipUtils.js';
-import { applyValue, clearApplierCaches, isTargetMounted } from './appliers.js';
-import { restoreNodeTrack } from './nodeTracks.js';
-import { cueStatesAt, entryLocalTime, isEntryActive, resolveSequence, } from './sequenceUtils.js';
+import { applyValue, clearApplierCaches, isApplicable, isTargetMounted } from './appliers.js';
+import { readNodeValue, restoreNodeTrack } from './nodeTracks.js';
+import { cueStatesAt, entryLocalTime, isEntryActive, resolveSequence, cueCommand, clipCueSchedule, firedBetween, } from './sequenceUtils.js';
 /** Longest an autoplaying sequence waits for its targets. */
 const MAX_TARGET_WAIT_MS = 8000;
 const targetKey = (state, node, path) => `${state}|${node ?? ''}|${path}`;
 class ClipsRuntime {
+    cueRunner = null;
+    /** The triggers engine runs cues (see CueRunner). */
+    setCueRunner(fn) { this.cueRunner = fn; }
     clips = new Map();
     sequences = new Map();
     ctx = null;
@@ -54,6 +57,8 @@ class ClipsRuntime {
     pendingRestore = [];
     /** last written value per property (targetKey -> JSON) */
     written = new Map();
+    /** values written straight from outside (a UI slider): targetKey -> value. */
+    live = new Map();
     // --- diagnostics ------------------------------------------------------------------
     // On with `?animdebug=1` in the URL, or localStorage '3drise.animdebug' = '1'
     // (ClipPlayer reads it). Logs every lifecycle call on sequences (with the caller's
@@ -83,8 +88,42 @@ class ClipsRuntime {
         this.dlog('setContext', ctx ? { camera: !!ctx.camera, controls: !!ctx.controls, getAction: !!ctx.getAction } : null);
         this.ctx = ctx;
         this.written.clear();
+        this.live.clear();
         clearApplierCaches();
     }
+    // --- direct writes (UI controls, SceneHandle.values) ----------------------------------
+    /**
+     * Write one value to the live scene by settings path — the same appliers a clip track
+     * uses, so nothing goes through React and nothing is saved. A running clip that
+     * animates the same property wins again on its next write. False when there is no
+     * applier for the path or its target is not mounted.
+     */
+    setLiveValue(state, path, value, node) {
+        const ctx = this.ctx;
+        if (!ctx)
+            return false;
+        if (!applyValue(ctx, state, path, value, node))
+            return false;
+        const key = targetKey(state, node, path);
+        this.live.set(key, value);
+        this.written.delete(key); // a clip holding the same value must write it again
+        return true;
+    }
+    /** What was last written by `setLiveValue`, else the authored value (action patches included). */
+    getLiveValue(state, path, node) {
+        const key = targetKey(state, node, path);
+        if (this.live.has(key))
+            return this.live.get(key);
+        if (node)
+            return readNodeValue(state, node, path); // the node as it is now
+        if (!this.ctx)
+            return undefined;
+        return getAtPath(this.ctx.getSettings(state), path);
+    }
+    /** Whether `setLiveValue` can write this path (it has an applier). */
+    canSetLiveValue(state, path) {
+        return isApplicable(state, path);
+    }
     /**
      * Every change, including each frame's time while anything plays. For UI that
      * follows the playhead, write through refs in the listener — never re-render React
@@ -129,7 +168,10 @@ class ClipsRuntime {
             time = 0;
         if (direction === -1 && time <= 0)
             time = clip.duration;
-        this.clips.set(clip.id, { clip, time, speed: opts.speed ?? 1, direction, playing: true, order: ++this.order });
+        this.clips.set(clip.id, {
+            clip, time, speed: opts.speed ?? 1, direction, playing: true, order: ++this.order,
+            cueState: existing?.cueState ?? new Map(), owned: existing?.owned ?? new Map(), cueTime: undefined,
+        });
         this.emit({ type: 'start', kind: 'clip', id: clip.id });
         this.bumpState();
     }
@@ -154,6 +196,8 @@ class ClipsRuntime {
             return;
         this.clips.delete(clipId);
         this.pendingRestore.push(...inst.clip.tracks);
+        this.releaseCues(inst.owned, 'clip', clipId);
+        inst.cueState.clear();
         this.bumpState();
     }
     /** Hold the clip at t (seconds) — the editor playhead, or seek() from outside. */
@@ -163,10 +207,11 @@ class ClipsRuntime {
         if (inst) {
             inst.clip = clip;
             inst.time = time;
+            inst.cueTime = undefined;
             this.bump();
         }
         else {
-            this.clips.set(clip.id, { clip, time, speed: 1, direction: 1, playing: false, order: ++this.order });
+            this.clips.set(clip.id, { clip, time, speed: 1, direction: 1, playing: false, order: ++this.order, cueState: new Map(), owned: new Map() });
             this.bumpState();
         }
     }
@@ -219,7 +264,8 @@ class ClipsRuntime {
             order: ++this.order,
             active: existing?.active ?? new Set(),
             cueState: existing?.cueState ?? new Map(),
-            owned: existing?.owned ?? new Set(),
+            owned: existing?.owned ?? new Map(),
+            cueTime: undefined,
             waitUntil: opts.waitForTargets ? Date.now() + MAX_TARGET_WAIT_MS : undefined,
         });
         this.dlog('playSequence', seq.name, {
@@ -324,6 +370,7 @@ class ClipsRuntime {
                 this.updateSequence(seq, clips);
             inst.time = Math.min(inst.schedule.duration, Math.max(0, T));
             inst.target = inst.time;
+            inst.cueTime = undefined;
         }
         else {
             const schedule = resolveSequence(seq, clips);
@@ -331,7 +378,7 @@ class ClipsRuntime {
             this.sequences.set(seq.id, {
                 seq, schedule, time, target: time, driven: false,
                 speed: 1, direction: 1, baseDirection: 1, playing: false, order: ++this.order, active: new Set(),
-                cueState: new Map(), owned: new Set(),
+                cueState: new Map(), owned: new Map(),
             });
             this.bumpState();
             return;
@@ -390,11 +437,15 @@ class ClipsRuntime {
         }
         const dt = Math.min(delta, 0.1);
         let anyPlaying = false;
-        for (const inst of this.clips.values()) {
-            if (!inst.playing)
-                continue;
-            anyPlaying = true;
-            this.advanceClip(inst, dt);
+        for (const inst of [...this.clips.values()]) {
+            const prev = inst.time;
+            const dir = inst.direction;
+            if (inst.playing) {
+                anyPlaying = true;
+                this.advanceClip(inst, dt);
+            }
+            if (inst.clip.cues?.length && this.clips.get(inst.clip.id) === inst)
+                this.syncClipCues(inst, prev, dir);
         }
         for (const inst of [...this.sequences.values()]) {
             if (!inst.playing)
@@ -435,8 +486,10 @@ class ClipsRuntime {
         // A sequence still waiting for its targets doesn't fire its cues yet — their
         // effects would run on objects that aren't there (and never run again).
         for (const inst of this.sequences.values()) {
-            if (inst.waitUntil === undefined)
+            if (inst.waitUntil === undefined) {
                 this.syncCues(ctx, inst);
+                this.fireCues(ctx, inst);
+            }
         }
         if (this.pendingRestore.length)
             this.runRestores(ctx);
@@ -461,7 +514,7 @@ class ClipsRuntime {
         if (anyPlaying)
             this.bump();
     }
-    /** Objects / nodes the sequence animates — or its cued actions touch — that aren't in the scene yet. */
+    /** Objects / nodes the sequence animates — or its cues act on — that aren't in the scene yet. */
     missingTargets(ctx, inst) {
         const missing = new Set();
         for (const e of inst.schedule.entries) {
@@ -472,60 +525,125 @@ class ClipsRuntime {
                     missing.add(t.node ? `${t.state} › ${t.node}` : t.state);
             }
         }
-        if (ctx.getAction) {
-            for (const sc of inst.schedule.cues) {
-                const action = ctx.getAction(sc.cue.actionId);
-                if (!action)
-                    continue;
-                for (const t of action.targets ?? [])
-                    if (!isTargetMounted(ctx, t.state))
-                        missing.add(t.state);
-                for (const eff of action.effects ?? []) {
-                    for (const id of eff.targets ?? [])
-                        if (id !== 'self' && !isTargetMounted(ctx, id))
-                            missing.add(id);
-                }
-            }
+        const idsOf = (c) => (c?.kind === 'effect' ? c.effect?.targets ?? [] : c?.kind === 'effectClip' ? c.use?.targets ?? [] : []);
+        for (const sc of inst.schedule.cues) {
+            const cmd = cueCommand(sc.cue);
+            for (const id of idsOf(cmd))
+                if (id !== 'self' && !isTargetMounted(ctx, id))
+                    missing.add(id);
+            if (cmd?.kind !== 'action' || !ctx.getAction)
+                continue;
+            const action = ctx.getAction(cmd.ref);
+            if (!action)
+                continue;
+            for (const t of action.targets ?? [])
+                if (!isTargetMounted(ctx, t.state))
+                    missing.add(t.state);
+            // its effects / effect clips
+            for (const c of action.commands ?? [])
+                for (const id of idsOf(c))
+                    if (id !== 'self' && !isTargetMounted(ctx, id))
+                        missing.add(id);
         }
         return [...missing];
     }
-    /** Apply / revert the actions whose cue state changed since the last tick. */
-    syncCues(ctx, inst) {
-        if (!ctx.getAction)
-            return;
-        const wanted = cueStatesAt(inst.schedule, inst.time);
-        const ids = new Set([...wanted.keys(), ...inst.cueState.keys()]);
-        for (const id of ids) {
-            const on = wanted.get(id) ?? false; // a removed cue counts as off
-            if ((inst.cueState.get(id) ?? false) === on) {
-                if (!wanted.has(id))
-                    inst.cueState.delete(id);
+    /**
+     * Switch a timeline's lanes to what time T asks for. A lane switched on by someone else
+     * already is left alone (and never switched off by this timeline).
+     */
+    syncLanes(lanes, wanted, state, owned, opts) {
+        const commandOf = new Map();
+        for (const l of lanes)
+            if (l.command && !commandOf.has(l.subject))
+                commandOf.set(l.subject, l.command);
+        const keys = new Set([...wanted.keys(), ...state.keys()]);
+        for (const key of keys) {
+            const on = wanted.get(key) ?? false; // a removed lane counts as off
+            if ((state.get(key) ?? false) === on) {
+                if (!wanted.has(key))
+                    state.delete(key);
                 continue;
             }
-            if (wanted.has(id))
-                inst.cueState.set(id, on);
+            if (wanted.has(key))
+                state.set(key, on);
             else
-                inst.cueState.delete(id);
+                state.delete(key);
             if (on) {
-                if (SceneActions.isActionApplied(id))
-                    continue; // someone else's — leave it
-                const action = ctx.getAction(id);
-                if (!action)
+                const cmd = commandOf.get(key);
+                if (!cmd)
                     continue;
-                SceneActions.applyAction(action, { effects: inst.playing });
-                inst.owned.add(id);
+                if (this.cueRunner) {
+                    if (this.cueRunner(cmd, 'apply', { ...opts, getAction: this.ctx?.getAction }))
+                        owned.set(key, cmd);
+                }
+                else if (cmd.kind === 'action') {
+                    if (SceneActions.isActionApplied(cmd.ref))
+                        continue; // someone else's — leave it
+                    const action = this.ctx?.getAction?.(cmd.ref);
+                    if (!action)
+                        continue;
+                    SceneActions.applyAction(action, { effects: opts.effects });
+                    owned.set(key, cmd);
+                }
             }
-            else if (inst.owned.has(id)) {
-                inst.owned.delete(id);
-                SceneActions.revertAction(id);
+            else if (owned.has(key)) {
+                const cmd = owned.get(key);
+                owned.delete(key);
+                this.switchOff(cmd, opts.host, opts.timelineId);
             }
         }
     }
-    /** Revert every action the sequence applied (stop / close). */
+    switchOff(cmd, host, timelineId) {
+        if (this.cueRunner)
+            this.cueRunner(cmd, 'revert', { effects: true, host, timelineId, getAction: this.ctx?.getAction });
+        else if (cmd.kind === 'action')
+            SceneActions.revertAction(cmd.ref);
+    }
+    /** Switch the sequence's lanes to what its time asks for. */
+    syncCues(ctx, inst) {
+        if (!ctx.getAction && !this.cueRunner)
+            return;
+        const lanes = inst.schedule.cues.map(sc => ({ ...sc, command: cueCommand(sc.cue) }));
+        this.syncLanes(lanes, cueStatesAt(inst.schedule, inst.time), inst.cueState, inst.owned, { effects: inst.playing, host: 'sequence', timelineId: inst.seq.id });
+    }
+    /** Fire the 'fire' cues the playhead crossed moving forward since the last tick. */
+    fireCues(_ctx, inst) {
+        const prev = inst.cueTime;
+        inst.cueTime = inst.time;
+        if (prev === undefined || !inst.playing || !this.cueRunner)
+            return;
+        const wrapped = !inst.driven && inst.direction === 1 && inst.time < prev - 1e-9;
+        for (const sc of firedBetween(inst.schedule.cues, prev, inst.time, wrapped ? inst.schedule.duration : undefined)) {
+            const cmd = cueCommand(sc.cue);
+            if (cmd)
+                this.cueRunner(cmd, 'fire', { effects: true, host: 'sequence', timelineId: inst.seq.id, getAction: this.ctx?.getAction });
+        }
+    }
+    /** A clip's cues: state lanes to what its time asks for, and fire cues crossed moving forward. */
+    syncClipCues(inst, prev, dir) {
+        const schedule = clipCueSchedule(inst.clip);
+        const lanes = schedule.map(sc => ({ ...sc, command: cueCommand(sc.cue) }));
+        this.syncLanes(lanes, cueStatesAt({ cues: schedule }, inst.time), inst.cueState, inst.owned, { effects: inst.playing, host: 'clip', timelineId: inst.clip.id });
+        const last = inst.cueTime;
+        inst.cueTime = inst.time;
+        if (last === undefined || !inst.playing || !this.cueRunner)
+            return;
+        const wrapped = dir === 1 && inst.direction === 1 && inst.time < prev - 1e-9;
+        for (const sc of firedBetween(schedule, last, inst.time, wrapped ? inst.clip.duration : undefined)) {
+            const cmd = cueCommand(sc.cue);
+            if (cmd)
+                this.cueRunner(cmd, 'fire', { effects: true, host: 'clip', timelineId: inst.clip.id, getAction: this.ctx?.getAction });
+        }
+    }
+    /** Switch off every lane a timeline switched on (stop / close). */
+    releaseCues(owned, host, timelineId) {
+        for (const cmd of [...owned.values()].reverse())
+            this.switchOff(cmd, host, timelineId);
+        owned.clear();
+    }
+    /** Revert every lane the sequence switched on (stop / close). */
     releaseActions(inst) {
-        for (const id of inst.owned)
-            SceneActions.revertAction(id);
-        inst.owned.clear();
+        this.releaseCues(inst.owned, 'sequence', inst.seq.id);
         inst.cueState.clear();
     }
     /** Every driver's values for this frame, lowest priority first. */

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

@@ -1 +1 @@
-{"version":3,"file":"appliers.d.ts","sourceRoot":"","sources":["../../src/animationsV2/appliers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAc/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC;IACd,yFAAyF;IACzF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;CACxD;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AA2KD,uFAAuF;AACvF,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlH;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}
+{"version":3,"file":"appliers.d.ts","sourceRoot":"","sources":["../../src/animationsV2/appliers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAgB/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,qDAAqD;IACrD,QAAQ,EAAE,GAAG,CAAC;IACd,yFAAyF;IACzF,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAC;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;CACxD;AAWD,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAsLD,uFAAuF;AACvF,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlH;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAKxF;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/animationsV2/appliers.js

@@ -4,6 +4,8 @@ import { CLOUD_LIVE_KEY } from '../hooks/useCloudLive.js';
 import { OCEAN_LIVE_KEY } from '../hooks/useOceanLive.js';
 import { TERRAIN_LIVE_KEY } from '../hooks/useTerrainLive.js';
 import { createSunPosition } from '../utils/utils3d.js';
+import { sunAnglesFromDirection } from '@3driseai/3drise-core';
+import { publishRenderedSky, sceneOf } from '../utils/renderedSky.js';
 import { applyNodeValue, clearNodeCaches, nodesFor } from './nodeTracks.js';
 // --- live-target caches (cleared when the scene changes under us) -------------
 const objectCache = new Map();
@@ -141,17 +143,31 @@ const applySky = (_ctx, _state, path, value) => {
     if (SKY_UNIFORM_KEYS.has(path)) {
         if (uniforms[path])
             uniforms[path].value = value;
-        return;
     }
-    if ((path === 'elevation' || path === 'azimuth') && uniforms.sunPosition) {
+    else if ((path === 'elevation' || path === 'azimuth') && uniforms.sunPosition) {
         // The other angle comes from the current sun, so the two can be keyed separately.
-        const { x, y, z } = uniforms.sunPosition.value;
-        const r = Math.sqrt(x * x + y * y + z * z) || 1;
-        const current = { elevation: 90 - Math.acos(y / r) * (180 / Math.PI), azimuth: Math.atan2(z, x) * (180 / Math.PI) };
+        const current = sunAnglesFromDirection(uniforms.sunPosition.value);
         const elevation = path === 'elevation' ? value : current.elevation;
         const azimuth = path === 'azimuth' ? value : current.azimuth;
         uniforms.sunPosition.value.copy(createSunPosition(elevation, azimuth));
     }
+    else {
+        return;
+    }
+    // Publish what the clip drew, so the key light, clouds, water and terrain
+    // follow the animated sky instead of only the background changing. A hidden
+    // sky publishes nothing — SkyController cleared it and nothing should read it.
+    if (!sky.visible)
+        return;
+    const sun = sunAnglesFromDirection(uniforms.sunPosition.value);
+    publishRenderedSky(sceneOf(sky), {
+        turbidity: uniforms.turbidity.value,
+        rayleigh: uniforms.rayleigh.value,
+        mieCoefficient: uniforms.mieCoefficient.value,
+        mieDirectionalG: uniforms.mieDirectionalG.value,
+        elevation: sun.elevation,
+        azimuth: sun.azimuth,
+    });
 };
 /** Clouds: the layer's live handle — `config.*` is the deck, `cirrus.*` the high layer. */
 const applyClouds = (ctx, _state, path, value) => {

package/dist/animationsV2/index.d.ts

@@ -10,7 +10,7 @@ export type { ApplyContext } from './appliers';
 export { readNodeValue, NODE_TRANSFORM_PATHS, NODE_MATERIAL_KEYS } from './nodeTracks';
 export { resolveElementSettings, isEnvironmentState, ENVIRONMENT_STATES as CLIP_ENVIRONMENT_STATES } from './elementSettings';
 export type { ElementSources } from './elementSettings';
-export type { AnimationClip, Track as ClipTrack, Keyframe as ClipKeyframe, KeyValue as ClipKeyValue, EaseName as ClipEaseName, SequenceStep, StepClip, SequenceCue, AnimationSequence as ClipSequence, SequenceDriver, SequenceDriverSettings, } from './types';
+export type { AnimationClip, Track as ClipTrack, Keyframe as ClipKeyframe, KeyValue as ClipKeyValue, EaseName as ClipEaseName, SequenceStep, StepClip, SequenceCue, TimelineCue, AnimationSequence as ClipSequence, SequenceDriver, SequenceDriverSettings, } from './types';
 export { DEFAULT_DRIVER_SETTINGS } from './types';
 export { DEFAULT_EASE as CLIP_DEFAULT_EASE, FPS_PRESETS as CLIP_FPS_PRESETS } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/animationsV2/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC9H,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACR,aAAa,EAAE,KAAK,IAAI,SAAS,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,EAC/G,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,IAAI,YAAY,EAAE,cAAc,EAAE,sBAAsB,GACjH,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/animationsV2/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC9H,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACR,aAAa,EAAE,KAAK,IAAI,SAAS,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,EAC/G,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,IAAI,YAAY,EAAE,cAAc,EAAE,sBAAsB,GAC9H,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/animationsV2/normalize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAkB,MAAM,SAAS,CAAC;AAQhF,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAarD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,iBAAiB,CAyC7D"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/animationsV2/normalize.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAkB,MAAM,SAAS,CAAC;AAQhF,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAgBrD;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,iBAAiB,CAyC7D"}

package/dist/animationsV2/normalize.js

@@ -14,8 +14,12 @@ export function normalizeClip(row) {
         yoyo: flag(row.yoyo),
         endMode: row.endMode === 'restore' ? 'restore' : 'hold',
         tracks: Array.isArray(row.tracks) ? row.tracks : [],
+        cues: (Array.isArray(row.cues) ? row.cues : [])
+            .filter((c) => c && c.command && typeof c.command === 'object')
+            .map((c, i) => ({ id: c.id ?? `cue-${i}`, command: c.command, at: Math.max(0, Number(c.at) || 0), mode: CUE_MODES.includes(c.mode) ? c.mode : 'apply' })),
     };
 }
+const CUE_MODES = ['apply', 'revert', 'fire'];
 export function normalizeSequence(row) {
     const steps = Array.isArray(row.steps) ? row.steps : [];
     return {
@@ -37,13 +41,13 @@ export function normalizeSequence(row) {
                 : [],
         })),
         cues: (Array.isArray(row.cues) ? row.cues : [])
-            .filter((c) => c && typeof c.actionId === 'string' && typeof c.stepId === 'string')
+            .filter((c) => c && typeof c.stepId === 'string' && c.command && typeof c.command === 'object')
             .map((c, i) => ({
             id: c.id ?? `cue-${i}`,
-            actionId: c.actionId,
+            command: c.command,
             stepId: c.stepId,
             at: Math.max(0, Number(c.at) || 0),
-            mode: c.mode === 'revert' ? 'revert' : 'apply',
+            mode: CUE_MODES.includes(c.mode) ? c.mode : 'apply',
         })),
         loop: flag(row.loop),
         yoyo: flag(row.yoyo),