@3driseai/3drise-viewer 0.1.42 → 0.1.43

package/dist/animationsV2/ClipsRuntime.d.ts

@@ -64,6 +64,8 @@ declare class ClipsRuntime {
     private clock;
     /** Blend seconds of the driver that last wrote each property (for its blend-out). */
     private blendOf;
+    /** The driver that last wrote each property (Proposal.driver). */
+    private writer;
     /** Next tick writes every winner even if unchanged (an edited clip). */
     private forceWrite;
     /** Diagnostics: keys written last tick, and keys written for the FIRST time last tick. */
@@ -98,7 +100,7 @@ declare class ClipsRuntime {
     /** Diagnostics: a write whose speed differs sharply from the previous frame's (a velocity discontinuity), per property. */
     private lastSpeed;
     private probeJump;
-    /** Where a property is right now: the last value the runtime wrote, else the live / authored value. */
+    /** Where a property is right now: the live scene where it can be read, else the last value the runtime wrote, else the live / authored value. */
     private currentValue;
     /** Whether `setLiveValue` can write this path (it has an applier). */
     canSetLiveValue(state: string, path: string): boolean;
@@ -216,6 +218,19 @@ declare class ClipsRuntime {
     private releaseCues;
     /** Revert every lane the sequence switched on (stop / close). */
     private releaseActions;
+    /**
+     * Tracks with their "from current" keys replaced by the run's captured values. A value not
+     * captured yet is read now (the scene as it is, before this frame's writes) and kept for the
+     * run. `pending`: a target isn't mounted yet — the key's own value stands in this frame and
+     * the caller resolves again next tick.
+     */
+    private resolveCurrent;
+    /**
+     * A new run of a timeline that wrote before (a held clip played again): what it wrote may not
+     * be where the properties are any more (the visitor orbited the camera since), so its first
+     * write is a take-over again — it blends from the scene as it is.
+     */
+    private forgetWrites;
     /** Every driver's values for this frame, lowest priority first. */
     private proposals;
     private runRestores;

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

@@ -32,6 +32,15 @@
 // track on an element the layer just changed is re-written for a few frames, because
 // the re-render may have rebuilt what it writes to (a new material).
 //
+// A facing position track (Track.face) also drives its object's rotation: the runtime sees it as
+// one more track (clipUtils expandTracks), after the clip's own, so restore, take-over and the
+// last-wins merge treat that rotation like any other track's.
+//
+// "From current" keys (Keyframe.current) take the property's value as the scene shows it when
+// a run starts (a clip played from its start edge; a sequence entry the first time it becomes
+// active in a run), captured once per run and held for it. Each instance keeps its captures and
+// the tracks resolved with them; reverse / yoyo / loop / scrubbing inside the run reuse them.
+//
 // Sequence cues switch actions (SceneActions) by time: each tick a sequence works
 // out which of its actions should be on at its current time and applies / reverts
 // only what changed. It reverts only what it applied itself — an action already on
@@ -41,15 +50,19 @@
 //
 import { SceneActions, expandMaterialVariant } from '@3driseai/3drise-core';
 import { logTrigger } from '../triggers/log.js';
-import { getAtPath, isSwitchTrack, sampleTrack } from './clipUtils.js';
+import { expandTracks, faceSource, getAtPath, isSwitchTrack, sampleTrack, sampleTrackFacing } from './clipUtils.js';
 import { interpolateValue } from '@3driseai/3drise-core';
-import { applyValue, clearApplierCaches, isApplicable, isTargetMounted, releaseLive } from './appliers.js';
+import { applyValue, clearApplierCaches, isApplicable, isTargetMounted, readSceneValue, releaseLive } 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;
 /** A saved playback rate: positive and finite, else 1. */
 const rate = (s) => (typeof s === 'number' && Number.isFinite(s) && s > 0 ? s : 1);
+/** A continuous track with at least one "from current" key. */
+const hasCurrentKey = (t) => !isSwitchTrack(t) && t.keys.some(k => k.current);
+/** A captured value that can stand in for the key's own (same kind, same length). */
+const sameKind = (a, b) => typeof a === typeof b && Array.isArray(a) === Array.isArray(b) && (!Array.isArray(a) || a.length === b.length);
 /**
  * Blends: a property never jumps when a driver takes it over or lets it go. When a continuous
  * track first wins a property, the runtime remembers where the property IS (the last value it
@@ -115,6 +128,8 @@ class ClipsRuntime {
     clock = 0;
     /** Blend seconds of the driver that last wrote each property (for its blend-out). */
     blendOf = new Map();
+    /** The driver that last wrote each property (Proposal.driver). */
+    writer = new Map();
     /** Next tick writes every winner even if unchanged (an edited clip). */
     forceWrite = false;
     /** Diagnostics: keys written last tick, and keys written for the FIRST time last tick. */
@@ -159,6 +174,7 @@ class ClipsRuntime {
         this.dlog('setContext', ctx ? { camera: !!ctx.camera, controls: !!ctx.controls, getAction: !!ctx.getAction } : null);
         this.ctx = ctx;
         this.written.clear();
+        this.writer.clear();
         this.live.clear();
         clearApplierCaches();
     }
@@ -217,8 +233,15 @@ class ClipsRuntime {
         if (ratio > 2.5 || ratio < 0.4)
             this.dlog('JUMP', key, { from: prev, to: value, speedWas: +last.toFixed(4), speedNow: +speed.toFixed(4), dt: +dt.toFixed(4), at: this.clock.toFixed(3) });
     }
-    /** Where a property is right now: the last value the runtime wrote, else the live / authored value. */
+    /** Where a property is right now: the live scene where it can be read, else the last value the runtime wrote, else the live / authored value. */
     currentValue(state, path, node) {
+        // The live scene first: what the runtime last wrote goes stale as soon as something else
+        // moves the property (the visitor orbiting a held camera, a drag, an effect).
+        if (this.ctx) {
+            const seen = readSceneValue(this.ctx, state, path, node);
+            if (seen !== undefined)
+                return seen;
+        }
         const key = targetKey(state, node, path);
         const out = this.blendOuts.get(key);
         if (out) {
@@ -274,10 +297,10 @@ class ClipsRuntime {
                 }
             };
             for (const inst of this.clips.values())
-                add(inst.clip.tracks);
+                add(expandTracks(inst.clip.tracks));
             for (const inst of this.sequences.values())
                 for (const e of inst.schedule.entries)
-                    add(e.clip.tracks);
+                    add(expandTracks(e.clip.tracks));
         }
         return this.taken.has(`${state}|${node ?? ''}|${property}`);
     }
@@ -307,6 +330,7 @@ class ClipsRuntime {
         this.blendOuts.clear();
         this.blendOf.clear();
         this.written.clear();
+        this.writer.clear();
         this.laid.clear();
         this.rewrite.clear();
         this.clashed.clear();
@@ -324,10 +348,16 @@ class ClipsRuntime {
             time = 0;
         if (direction === -1 && time <= 0)
             time = clip.duration;
+        // A run from the start edge reads its "from current" keys afresh; anything else (resume,
+        // the reverse leg of a toggle, play after a scrub) keeps the run's captures.
+        const fresh = !existing || (direction === 1 && time === 0);
         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,
+            captured: fresh || !existing ? new Map() : existing.captured,
         });
+        if (fresh)
+            this.forgetWrites('clip:' + clip.id);
         this.emit({ type: 'start', kind: 'clip', id: clip.id });
         this.bumpState();
     }
@@ -351,7 +381,7 @@ class ClipsRuntime {
         if (!inst)
             return;
         this.clips.delete(clipId);
-        this.pendingRestore.push(...inst.clip.tracks);
+        this.pendingRestore.push(...expandTracks(inst.clip.tracks));
         this.releaseCues(inst.owned, 'clip', clipId);
         inst.cueState.clear();
         this.bumpState();
@@ -361,13 +391,15 @@ class ClipsRuntime {
         const inst = this.clips.get(clip.id);
         const time = Math.min(clip.duration, Math.max(0, t));
         if (inst) {
+            if (inst.clip !== clip)
+                inst.tracks = undefined;
             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, cueState: new Map(), owned: new Map() });
+            this.clips.set(clip.id, { clip, time, speed: 1, direction: 1, playing: false, order: ++this.order, cueState: new Map(), owned: new Map(), captured: new Map() });
             this.bumpState();
         }
     }
@@ -376,10 +408,12 @@ class ClipsRuntime {
         const inst = this.clips.get(clip.id);
         if (!inst)
             return;
-        const removed = inst.clip.tracks.filter(t => !clip.tracks.some(n => n.id === t.id));
+        const next = expandTracks(clip.tracks);
+        const removed = expandTracks(inst.clip.tracks).filter(t => !next.some(n => n.id === t.id));
         if (removed.length)
             this.pendingRestore.push(...removed);
         inst.clip = clip;
+        inst.tracks = undefined; // re-resolved next tick (captures kept; new current keys capture then)
         inst.time = Math.min(inst.time, clip.duration);
         this.forceWrite = true; // values may have changed under the same time (the written marks stay: no spurious blend-ins)
         this.bumpState();
@@ -402,7 +436,8 @@ class ClipsRuntime {
     isActive(clipId) { return this.clips.has(clipId); }
     /** Value of a track at the clip's current time (the panel's value column). */
     sampleAt(clip, track) {
-        return sampleTrack(track, this.getTime(clip.id));
+        const resolved = this.clips.get(clip.id)?.tracks?.find(t => t.id === track.id);
+        return sampleTrack(resolved ?? track, this.getTime(clip.id));
     }
     // --- sequences ------------------------------------------------------------------
     /**
@@ -420,7 +455,12 @@ class ClipsRuntime {
             time = 0;
         if (!driven && direction === -1 && time <= 0)
             time = schedule.duration;
+        // A run from the sequence's own start edge reads its "from current" keys afresh (see play()).
+        const startEdge = seq.reverse ? schedule.duration : 0;
+        const fresh = !existing || (!driven && time === startEdge);
         this.sequences.set(seq.id, {
+            captured: fresh || !existing ? new Map() : (existing.captured),
+            entryTracks: new Map(),
             driven,
             target: time,
             seq,
@@ -441,6 +481,8 @@ class ClipsRuntime {
             id: seq.id, driven, driver: seq.driver, time, duration: schedule.duration, entries: schedule.entries.length,
             steps: seq.steps.length, cues: schedule.cues.length, waitForTargets: !!opts.waitForTargets, replaced: !!existing,
         }, this.caller());
+        if (fresh)
+            this.forgetWrites('sequence:' + seq.id);
         this.emit({ type: 'start', kind: 'sequence', id: seq.id });
         this.bumpState();
     }
@@ -525,7 +567,7 @@ class ClipsRuntime {
             return;
         this.dlog('stopSequence', inst.seq.name, this.caller());
         this.sequences.delete(seqId);
-        inst.schedule.entries.forEach(e => this.pendingRestore.push(...e.clip.tracks));
+        inst.schedule.entries.forEach(e => this.pendingRestore.push(...expandTracks(e.clip.tracks)));
         this.releaseActions(inst);
         this.bumpState();
     }
@@ -547,7 +589,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 Map(),
+                cueState: new Map(), owned: new Map(), captured: new Map(), entryTracks: new Map(),
             });
             this.bumpState();
             return;
@@ -561,9 +603,10 @@ class ClipsRuntime {
             return;
         this.dlog('updateSequence', seq.name, { playing: inst.playing, time: inst.time }, this.caller());
         // Restore everything the old schedule drove; whatever is still driven re-writes this frame.
-        inst.schedule.entries.forEach(e => this.pendingRestore.push(...e.clip.tracks));
+        inst.schedule.entries.forEach(e => this.pendingRestore.push(...expandTracks(e.clip.tracks)));
         inst.seq = seq;
         inst.schedule = resolveSequence(seq, clips);
+        inst.entryTracks.clear();
         inst.time = Math.min(inst.time, inst.schedule.duration);
         inst.target = Math.min(inst.target, inst.schedule.duration);
         // The driver can change while it runs (editing): a running sequence switches mode.
@@ -658,7 +701,7 @@ class ClipsRuntime {
                     continue;
                 const e = inst.schedule.entries.find(x => x.id === id);
                 if (e)
-                    this.pendingRestore.push(...e.clip.tracks);
+                    this.pendingRestore.push(...expandTracks(e.clip.tracks));
             }
             inst.active = now;
         }
@@ -723,7 +766,8 @@ class ClipsRuntime {
                 continue;
             // A driver taking the property over: start it from where the property is, not from the key.
             let blend = this.blends.get(key);
-            if (!this.written.has(key)) {
+            // A take-over: nothing wrote it yet (or it was handed back), or another clip / sequence wrote it last.
+            if (!this.written.has(key) || this.writer.get(key) !== p.driver) {
                 const duration = p.blend ?? DEFAULT_BLEND;
                 const from = this.currentValue(p.state, p.path, p.node);
                 if (duration > 0 && from !== undefined && JSON.stringify(from) !== JSON.stringify(p.value)) {
@@ -747,8 +791,12 @@ class ClipsRuntime {
                     value = mixValues(p.path, blend.from, p.value, smooth(u));
             }
             const json = JSON.stringify(value);
-            if (!this.forceWrite && this.written.get(key) === json && !this.rewrite.has(p.state))
+            // Unchanged: nothing to write — but the property is this driver's now (else every frame
+            // would look like a take-over, restart the blend and pin the property where it was).
+            if (!this.forceWrite && this.written.get(key) === json && !this.rewrite.has(p.state)) {
+                this.writer.set(key, p.driver);
                 continue;
+            }
             // Recorded only when it landed: a target that is not mounted yet (a model still
             // loading) is retried next frame instead of being skipped for good.
             if (this.debug) {
@@ -761,6 +809,7 @@ class ClipsRuntime {
             }
             if (applyValue(ctx, p.state, p.path, value, p.node)) {
                 this.written.set(key, json);
+                this.writer.set(key, p.driver);
                 this.blendOf.set(key, p.blend ?? DEFAULT_BLEND);
             }
             else if (this.debug)
@@ -791,7 +840,7 @@ class ClipsRuntime {
                     missing.add(t.node ? `${t.state} › ${t.node}` : t.state);
             }
         }
-        const ENV = ['camera', 'sky', 'clouds', 'ocean', 'terrain'];
+        const ENV = ['camera', 'sky', 'clouds', 'ocean', 'terrain', 'time', 'render'];
         const idsOf = (c) => (c?.kind === 'effect' ? c.effect?.targets ?? []
             : c?.kind === 'effectClip' ? c.use?.targets ?? []
                 : c?.kind === 'change' ? (c.targets ?? []).map((t) => t?.state).filter((s) => s && !ENV.includes(s)) : []);
@@ -926,20 +975,87 @@ class ClipsRuntime {
         this.releaseCues(inst.owned, 'sequence', inst.seq.id);
         inst.cueState.clear();
     }
+    /**
+     * Tracks with their "from current" keys replaced by the run's captured values. A value not
+     * captured yet is read now (the scene as it is, before this frame's writes) and kept for the
+     * run. `pending`: a target isn't mounted yet — the key's own value stands in this frame and
+     * the caller resolves again next tick.
+     */
+    resolveCurrent(tracks, captured, prefix) {
+        if (!tracks.some(hasCurrentKey))
+            return { tracks, pending: false };
+        let pending = false;
+        const out = tracks.map((track) => {
+            if (!hasCurrentKey(track))
+                return track;
+            const id = prefix + track.id;
+            const fallback = track.keys.find(k => k.current).value;
+            let v = captured.get(id);
+            if (v === undefined) {
+                const read = this.currentValue(track.state, track.path, track.node);
+                if (read !== undefined && sameKind(read, fallback))
+                    v = read;
+                else if (this.ctx && !isTargetMounted(this.ctx, track.state, track.node)) {
+                    pending = true;
+                    return track;
+                }
+                else
+                    v = fallback; // nothing readable: the stored value, for the whole run
+                captured.set(id, v);
+                this.dlog('from current', track.state, track.node ?? '', track.path, v);
+            }
+            const value = v;
+            return { ...track, keys: track.keys.map(k => (k.current ? { ...k, value } : k)) };
+        });
+        return { tracks: out, pending };
+    }
+    /**
+     * A new run of a timeline that wrote before (a held clip played again): what it wrote may not
+     * be where the properties are any more (the visitor orbited the camera since), so its first
+     * write is a take-over again — it blends from the scene as it is.
+     */
+    forgetWrites(driver) {
+        for (const [key, d] of this.writer)
+            if (d === driver)
+                this.writer.delete(key);
+    }
     /** Every driver's values for this frame, lowest priority first. */
     *proposals() {
         const drivers = [];
+        const ctx = this.ctx;
+        const authored = (state) => ctx?.getSettings(state);
         for (const inst of this.clips.values()) {
-            drivers.push({ order: inst.order, run: () => sampleTracks(inst.clip.tracks, inst.time, inst.clip.blend ?? DEFAULT_BLEND) });
+            let tracks = inst.tracks;
+            if (!tracks) {
+                const r = this.resolveCurrent(inst.clip.tracks, inst.captured, '');
+                if (!r.pending)
+                    inst.tracks = r.tracks;
+                tracks = r.tracks;
+            }
+            const clipTracks = tracks;
+            const driver = 'clip:' + inst.clip.id;
+            drivers.push({ order: inst.order, run: () => sampleTracks(clipTracks, inst.time, inst.clip.blend ?? DEFAULT_BLEND, authored, driver) });
         }
         for (const inst of this.sequences.values()) {
+            const driver = 'sequence:' + inst.seq.id;
+            const entries = [];
+            for (const e of inst.schedule.entries) {
+                if (!inst.active.has(e.id))
+                    continue;
+                let tracks = inst.entryTracks.get(e.id);
+                if (!tracks) {
+                    const r = this.resolveCurrent(e.clip.tracks, inst.captured, e.id + '|');
+                    if (!r.pending)
+                        inst.entryTracks.set(e.id, r.tracks);
+                    tracks = r.tracks;
+                }
+                entries.push({ e, tracks });
+            }
             drivers.push({
                 order: inst.order,
                 run: function* () {
-                    for (const e of inst.schedule.entries) {
-                        if (!inst.active.has(e.id))
-                            continue;
-                        yield* sampleTracks(e.clip.tracks, entryLocalTime(e, inst.time), e.clip.blend ?? inst.seq.blend ?? DEFAULT_BLEND);
+                    for (const { e, tracks } of entries) {
+                        yield* sampleTracks(tracks, entryLocalTime(e, inst.time), e.clip.blend ?? inst.seq.blend ?? DEFAULT_BLEND, authored, driver);
                     }
                 },
             });
@@ -961,6 +1077,7 @@ class ClipsRuntime {
             done.add(key);
             const last = this.written.get(key);
             this.written.delete(key);
+            this.writer.delete(key);
             this.blends.delete(key);
             if (track.node) {
                 // Node tracks restore their exact pre-animation snapshot (see nodeTracks).
@@ -1134,14 +1251,16 @@ class ClipsRuntime {
 }
 const round2 = (n) => Math.round(n * 100) / 100;
 const isDriven = (seq) => !!seq.driver && seq.driver !== 'time';
-function* sampleTracks(tracks, t, blend) {
-    for (const track of tracks) {
+function* sampleTracks(tracks, t, blend, authored, driver) {
+    for (const track of expandTracks(tracks)) {
         if (track.muted || track.keys.length === 0)
             continue;
-        const value = sampleTrack(track, t);
+        // a facing track's rotation: from its position track's line, the authored rotation as the facing correction
+        const source = faceSource(track);
+        const value = source ? sampleTrackFacing(source, t, authored(track.state)?.meshSettings?.rotation) : sampleTrack(track, t);
         if (value === undefined)
             continue;
-        yield { state: track.state, node: track.node, path: track.path, value, discrete: isSwitchTrack(track), blend };
+        yield { state: track.state, node: track.node, path: track.path, value, discrete: isSwitchTrack(track), blend, driver };
     }
 }
 const clipsRuntime = new ClipsRuntime();

package/dist/animationsV2/appliers.d.ts

@@ -26,4 +26,13 @@ export declare function applyValue(ctx: ApplyContext, state: string, path: strin
 export declare function isTargetMounted(ctx: ApplyContext, state: string, node?: string): boolean;
 /** Whether a (state, path) has an applier — used by the track picker. */
 export declare function isApplicable(state: string, path: string): boolean;
+/**
+ * A property's value as the scene shows it right now — the camera where the visitor
+ * orbited it, an object where a clip or a drag left it — for the paths that can be read
+ * back from the live objects: camera position / fov / orbit target, an object's
+ * transform and visibility, its (first) material's numbers and colours, a model part's
+ * fields. Undefined for anything else (config handles, environment, effects): the
+ * runtime then falls back to what it last wrote, else the authored value.
+ */
+export declare function readSceneValue(ctx: ApplyContext, state: string, path: string, node?: string): KeyValue | undefined;
 //# sourceMappingURL=appliers.d.ts.map

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;AAgB/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKrE;AAED,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;AAkOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,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;AAMxC,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKrE;AAED,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;AAsOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED,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;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAiClH"}

package/dist/animationsV2/appliers.js

@@ -7,9 +7,10 @@ import { createSunPosition } from '../utils/utils3d.js';
 import { sunAnglesFromDirection, skySystemManager } from '@3driseai/3drise-core';
 import { sunSystemLive, SUN_SYSTEM_LIVE_PATHS, TIME_PATHS } from './sunSystemLive.js';
 import { publishRenderedSky, sceneOf } from '../utils/renderedSky.js';
-import { applyNodeValue, clearNodeCaches, nodesFor } from './nodeTracks.js';
+import { applyNodeValue, clearNodeCaches, nodesFor, readNodeValue } from './nodeTracks.js';
 import { setObjectEffectParam } from '../operations/objectEffects.js';
 import { setAnimationLive, transformAnimationIndex } from './animationLive.js';
+import { applyRenderValue, RENDER_LIVE_PATHS } from '../render/renderLive.js';
 /** `effects.<effectId>.<param>` → [effectId, param] (null for any other path). */
 export function effectParamPath(path) {
     if (!path.startsWith('effects.'))
@@ -256,8 +257,11 @@ const applyTime = (_ctx, _state, path, value) => {
     }
     return false;
 };
+/** Post-processing / exposure / HDR (renderLive). False when the effect is not mounted. */
+const applyRender = (_ctx, _state, path, value) => applyRenderValue(path, value);
 const APPLIERS = [
     { match: (s) => s === 'camera', apply: applyCamera },
+    { match: (s, p) => s === 'render' && RENDER_LIVE_PATHS.includes(p), apply: applyRender },
     { match: (s, p) => s === 'time' && TIME_PATHS.includes(p), apply: applyTime },
     // Environment before the generic path families: the ocean's `config.*` is not an object's.
     { match: (s) => s === 'sky', apply: applySky },
@@ -301,7 +305,7 @@ export function applyValue(ctx, state, path, value, node) {
 export function isTargetMounted(ctx, state, node) {
     if (state === 'camera')
         return !!ctx.camera;
-    if (state === 'sky' || state === 'clouds' || state === 'ocean' || state === 'terrain' || state === 'time')
+    if (state === 'sky' || state === 'clouds' || state === 'ocean' || state === 'terrain' || state === 'time' || state === 'render')
         return true;
     if (node)
         return nodesFor(state, node).length > 0;
@@ -311,3 +315,59 @@ export function isTargetMounted(ctx, state, node) {
 export function isApplicable(state, path) {
     return APPLIERS.some(a => a.match(state, path));
 }
+// --- reading the live scene (the inverse of the appliers, where it can be read) -------
+const vec3 = (v) => [v.x, v.y, v.z];
+/**
+ * A property's value as the scene shows it right now — the camera where the visitor
+ * orbited it, an object where a clip or a drag left it — for the paths that can be read
+ * back from the live objects: camera position / fov / orbit target, an object's
+ * transform and visibility, its (first) material's numbers and colours, a model part's
+ * fields. Undefined for anything else (config handles, environment, effects): the
+ * runtime then falls back to what it last wrote, else the authored value.
+ */
+export function readSceneValue(ctx, state, path, node) {
+    if (node)
+        return readNodeValue(state, node, path);
+    if (state === 'camera') {
+        const cam = ctx.camera;
+        if (!cam)
+            return undefined;
+        if (path === 'position')
+            return vec3(cam.position);
+        if (path === 'fov')
+            return cam.fov;
+        if (path === 'controls.target')
+            return ctx.controls?.target ? vec3(ctx.controls.target) : undefined;
+        return undefined;
+    }
+    if (path.startsWith('meshSettings.')) {
+        const obj = objectFor(state);
+        if (!obj)
+            return undefined;
+        const prop = path.slice('meshSettings.'.length);
+        if (prop === 'visible')
+            return !!obj.visible;
+        if (prop === 'position' || prop === 'rotation' || prop === 'scale')
+            return vec3(obj[prop]);
+        return undefined;
+    }
+    if (path.startsWith('materialSettings.')) {
+        const obj = objectFor(state);
+        if (!obj)
+            return undefined;
+        const key = path.slice('materialSettings.'.length);
+        let out;
+        traverseSkippingEdgesAndEffects(obj, true, (n) => {
+            if (out !== undefined || !n.material)
+                return;
+            const mat = Array.isArray(n.material) ? n.material[0] : n.material;
+            const v = mat?.[key];
+            if (typeof v === 'number')
+                out = v;
+            else if (v && v.isColor && typeof v.getHexString === 'function')
+                out = `#${v.getHexString()}`;
+        });
+        return out;
+    }
+    return undefined;
+}

package/dist/animationsV2/clipUtils.d.ts

@@ -22,6 +22,32 @@ export declare const isSwitchTrack: (track: Pick<Track, "discrete" | "node" | "p
  * after the last: the last key's value. Keys must be sorted by t.
  */
 export declare function sampleTrack(track: Track, t: number): KeyValue | undefined;
+/** A position track: an object's, or a model part's. The only tracks that can be curved. */
+export declare const isPositionTrack: (track: Pick<Track, "node" | "path">) => boolean;
+/** An object's position track that turns the object to face its travel (drives its rotation). */
+export declare const isFacingTrack: (track: Pick<Track, "node" | "path" | "face">) => boolean;
+/** Drawn as one line through its keys instead of straight segments. */
+export declare const isCurvedTrack: (track: Track) => boolean;
+/**
+ * The rotation (Euler XYZ, radians) of an object facing its travel along the track at t: +Z along
+ * the line, pitching with the slope, no roll (core pathLineHeading — the path animation's own), with
+ * `rest` (the object's authored rotation) on top as its facing correction. Each angle is taken
+ * nearest to `rest`, so gliding in from the authored rotation never spins the long way round.
+ * Undefined when the track has no line.
+ */
+export declare function sampleTrackFacing(track: Track, t: number, rest?: readonly number[] | null): [number, number, number] | undefined;
+/** The rotation a facing track drives: a track of its own for the runtime (restore, take-over, conflicts). */
+export interface FaceTrack extends Track {
+    faceOf: Track;
+}
+/** The facing track a position track drives, or undefined. */
+export declare const faceSource: (track: Track) => Track | undefined;
+/**
+ * A clip's tracks as the runtime drives them: each facing position track adds its object's
+ * rotation, AFTER all the clip's own tracks — so inside the clip it wins over a rotation track on
+ * the same object (later proposals win). Cached per tracks array (no allocation per frame).
+ */
+export declare function expandTracks(tracks: readonly Track[]): Track[];
 export declare const sortKeys: (keys: Keyframe[]) => Keyframe[];
 /** Add a key at t, or replace the value of a key already on that frame. */
 export declare function upsertKey(track: Track, t: number, value: KeyValue, fps: number): Track;
@@ -35,6 +61,10 @@ export declare function moveKeys(clip: AnimationClip, selection: Set<string>, dt
 export declare function copyKeys(clip: AnimationClip, selection: Set<string>, dt: number, ids: Map<string, string>): AnimationClip;
 export declare function deleteKeys(clip: AnimationClip, selection: Set<string>): AnimationClip;
 export declare function setKeysEase(clip: AnimationClip, selection: Set<string>, ease: EaseName): AnimationClip;
+/** Whether a track's keys can be "from current" (Keyframe.current): eased tracks only. */
+export declare const canKeyFromCurrent: (track: Pick<Track, "discrete" | "node" | "path">) => boolean;
+/** Mark the selected keys "from current" (on) or back to their own value (off). Switch tracks are left alone. */
+export declare function setKeysCurrent(clip: AnimationClip, selection: Set<string>, on: boolean): AnimationClip;
 export declare function setKeyValue(clip: AnimationClip, keyId: string, value: KeyValue): AnimationClip;
 export declare function findKey(clip: AnimationClip, keyId: string): {
     track: Track;

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

@@ -1 +1 @@
-{"version":3,"file":"clipUtils.d.ts","sourceRoot":"","sources":["../../src/animationsV2/clipUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAOlF,eAAO,MAAM,GAAG,GAAI,QAAQ,MAAM,WAAqF,CAAC;AAExH,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAOrD;AAMD,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,WAAwB,CAAC;AAC9E,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,WAAgB,CAAC;AAC1E,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,KAAK,MAAM,WAAgD,CAAC;AAEnG,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKvD;AAaD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,KAAG,OACL,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAyBzE;AAMD,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,EAAE,eAAwC,CAAC;AAElF,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAOtF;AAED,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa,CAc9G;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAkBzH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,aAAa,CAKrF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,aAAa,CAQtG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,aAAa,CAQ9F;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GAAG,SAAS,CAMvG;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAIzD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAEhE;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAQvF"}
+{"version":3,"file":"clipUtils.d.ts","sourceRoot":"","sources":["../../src/animationsV2/clipUtils.ts"],"names":[],"mappings":"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"}