@3driseai/3drise-viewer 0.1.32 → 0.1.34

package/dist/hooks/useContinuousEffects.js

@@ -1,6 +1,7 @@
 import { useRef, useEffect } from "react";
+import { animationLiveReader } from "../animationsV2/animationLive.js";
 import { useFrame } from "@react-three/fiber";
-import { animateUniforms, cacheChildrenWithMaterials, handleEdgesAnimations, handleMaterialAnimations, handleMaterialEffects, handleTransformAnimations } from "@3driseai/3drise-core";
+import { AnimationTargetState, animateUniforms, cacheChildrenWithMaterials, handleEdgesAnimations, handleMaterialAnimations, handleMaterialEffects, handleTransformAnimations, targetRootKind } from "@3driseai/3drise-core";
 import usePathAnimation from "./usePathAnimation.js";
 import { resolveObject3D } from "../utils/resolveObject3D.js";
 export const useContinuousEffects = (
@@ -19,6 +20,9 @@ objectSettings, options = {}, objectSource) => {
     const startValuesRef = useRef({});
     // Cache start values for edges animations
     const edgesStartValuesRef = useRef({});
+    // Groups / models: rows scoped each / targets (core animationTargets.ts) — one state per object.
+    const targetsRef = useRef(null);
+    useEffect(() => () => { targetsRef.current?.dispose(); targetsRef.current = null; }, []);
     // Transform keyframes. Effects that move the object (float, sway, spin…) are object
     // effects now (CreatedObject.effects, the operations catalogue) and ride on top of these.
     const transformAnimations = objectSettings?.animations?.transform?.animations || [];
@@ -74,8 +78,15 @@ objectSettings, options = {}, objectSource) => {
     }, [enabled, objectSettings?.animations?.transform?.animations, objectSource, startPathAnimation, stopPathAnimation]);
     useFrame((state, delta) => {
         const object = resolveObject3D(objectSource);
-        if (!enabled || !object || !objectSettings)
+        if (!enabled || !object || !objectSettings) {
+            // Off: the parts the rows moved go back to their rest.
+            if (targetsRef.current) {
+                targetsRef.current.dispose();
+                targetsRef.current = null;
+                lastObjectRef.current = null;
+            }
             return;
+        }
         // Cache the object's materials the first frame we actually see it, and
         // again if the caller swaps the object underneath us.
         if (object !== lastObjectRef.current) {
@@ -83,7 +94,11 @@ objectSettings, options = {}, objectSource) => {
             childrenWithMaterialsRef.current = cacheChildrenWithMaterials(object);
             startValuesRef.current = {};
             edgesStartValuesRef.current = {};
+            targetsRef.current?.dispose();
+            targetsRef.current = targetRootKind(object) ? new AnimationTargetState(object) : null;
         }
+        const targets = targetsRef.current;
+        targets?.beginFrame();
         const time = state.clock.getElapsedTime();
         const mouse = state.pointer;
         const currentTime = Date.now();
@@ -97,7 +112,10 @@ objectSettings, options = {}, objectSource) => {
                 object,
                 meshSettings: objectSettings.meshSettings || {},
                 pathIsActive,
-            }, activeTransformAnimations, currentTime, hovered);
+                targets: targets ?? undefined,
+                // a timeline clip driving a row's value (live, while it runs)
+                liveTo: animationLiveReader(objectSettings.id),
+            }, activeTransformAnimations, currentTime, hovered, delta);
         }
         if (hasEdgesAnimations) {
             handleEdgesAnimations({ object, startValuesCache: edgesStartValuesRef.current }, edgesAnimations, currentTime, hovered);
@@ -109,6 +127,7 @@ objectSettings, options = {}, objectSource) => {
                     object,
                     materialSettings: objectSettings.materialSettings || {},
                     startValuesCache: startValuesRef.current,
+                    targets: targets ?? undefined,
                 }, activeMaterialAnimations, currentTime, hovered);
             }
             // Handle material effects (color effects)
@@ -116,6 +135,8 @@ objectSettings, options = {}, objectSource) => {
                 handleMaterialEffects(object, enabledMaterialEffects, time, delta, effectStateRef, applyToChildren);
             }
         }
+        // Targets the rows stopped driving go back to their rest.
+        targets?.endFrame();
         animateUniforms(childrenWithMaterialsRef.current, time * speed, mouse, state.camera.position);
     });
     return {

package/dist/hooks/useMaterialApplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMaterialApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialApplication.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,sBAAsB,GAAI,QAAQ,cAAc,EAAE,kBAAkB,gBAAgB,EAAE,4BAA4B,OAAO,EAAE,YAAY,MAAM,IAAI,KAAG,IAwIhK,CAAC"}
+{"version":3,"file":"useMaterialApplication.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialApplication.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,sBAAsB,GAAI,QAAQ,cAAc,EAAE,kBAAkB,gBAAgB,EAAE,4BAA4B,OAAO,EAAE,YAAY,MAAM,IAAI,KAAG,IAyIhK,CAAC"}

package/dist/hooks/useMaterialApplication.js

@@ -96,11 +96,12 @@ export const useMaterialApplication = (source, materialSettings, shouldApply3dri
                 onApplied?.();
                 return;
             }
+            // Stops at child scene objects: they apply their own material.
             traverseSkippingEdgesAndEffects(obj, true, (child) => {
                 if (child && child.material) {
                     applyMaterialToChild(child, variant, resolvedSettings);
                 }
-            });
+            }, true);
         }
         // traverseSkippingEdges(originObject!, true, (child: any) => {
         //   if (child && child.material) {

package/dist/hooks/useMaterialUniforms.d.ts

@@ -1,14 +1,8 @@
 import type { Material, Object3D } from "three";
 /**
- * Hook for direct material manipulation on a scene object ref.
- *
- * Usage pattern (like SkyControllerUi):
- * - On slider drag → updateProperty(key, value) — instant visual feedback, no Redux
- * - On slider end  → updateProperty(key, value) + dispatch to Redux
- * - On color change → updateColor(key, hex) + dispatch to Redux
- * - On variant change → changeMaterial(variant, settings) + dispatch to Redux
+ * `object` may be several objects (a group's Material tab edits the children it applies to).
  */
-export declare function useMaterialUniforms(object: Object3D | null | undefined): {
+export declare function useMaterialUniforms(object: Object3D | Object3D[] | null | undefined): {
     getMaterial: () => Material | null;
     updateProperty: (key: string, value: any) => void;
     updateColor: (key: string, hexValue: string) => void;

package/dist/hooks/useMaterialUniforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMaterialUniforms.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialUniforms.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG;IAClE,WAAW,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CAC5E,CAoFJ"}
+{"version":3,"file":"useMaterialUniforms.d.ts","sourceRoot":"","sources":["../../src/hooks/useMaterialUniforms.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAmBhD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG;IAC/E,WAAW,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;IAC1D,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CAC5E,CAoFJ"}

package/dist/hooks/useMaterialUniforms.js

@@ -9,6 +9,18 @@ import { applySingleProperty, applyColorProperty, createAndApplyMaterial, MATERI
  * - On color change → updateColor(key, hex) + dispatch to Redux
  * - On variant change → changeMaterial(variant, settings) + dispatch to Redux
  */
+/** Every material-bearing node of the object(s) — never inside child scene objects (they have their own material). */
+function eachNode(object, cb) {
+    if (!object)
+        return;
+    for (const root of Array.isArray(object) ? object : [object]) {
+        if (root)
+            traverseSkippingEdgesAndEffects(root, true, cb, true);
+    }
+}
+/**
+ * `object` may be several objects (a group's Material tab edits the children it applies to).
+ */
 export function useMaterialUniforms(object) {
     /**
      * Get the material from the first non-edges child mesh that has one.
@@ -16,10 +28,10 @@ export function useMaterialUniforms(object) {
     const getMaterial = useCallback(() => {
         if (!object)
             return null;
-        if (object.material)
+        if (!Array.isArray(object) && object.material)
             return object.material;
         let found = null;
-        traverseSkippingEdgesAndEffects(object, true, (child) => {
+        eachNode(object, (child) => {
             if (!found && child.material) {
                 found = child.material;
             }
@@ -33,7 +45,7 @@ export function useMaterialUniforms(object) {
     const updateProperty = useCallback((key, value) => {
         if (!object)
             return;
-        traverseSkippingEdgesAndEffects(object, true, (child) => {
+        eachNode(object, (child) => {
             if (child.material) {
                 applySingleProperty(child.material, key, value);
             }
@@ -45,7 +57,7 @@ export function useMaterialUniforms(object) {
     const updateColor = useCallback((key, hexValue) => {
         if (!object)
             return;
-        traverseSkippingEdgesAndEffects(object, true, (child) => {
+        eachNode(object, (child) => {
             if (child.material) {
                 applyColorProperty(child.material, key, hexValue);
             }
@@ -58,7 +70,7 @@ export function useMaterialUniforms(object) {
     const applyAllSettings = useCallback((settings) => {
         if (!object)
             return;
-        traverseSkippingEdgesAndEffects(object, true, (child) => {
+        eachNode(object, (child) => {
             if (child.material) {
                 MaterialRegistryAPI.applySettings(child.material, settings);
             }
@@ -71,7 +83,7 @@ export function useMaterialUniforms(object) {
     const changeMaterial = useCallback((variant, settings) => {
         if (!object)
             return;
-        traverseSkippingEdgesAndEffects(object, true, (child) => {
+        eachNode(object, (child) => {
             if (child.material) {
                 const oldInstance = child.userData[MATERIAL_INSTANCE_KEY];
                 if (oldInstance) {

package/dist/hooks/useOrbitTargetFollow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOrbitTargetFollow.d.ts","sourceRoot":"","sources":["../../src/hooks/useOrbitTargetFollow.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAsE/E,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EACxC,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAClD,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS;AAClD,+EAA+E;AAC/E,YAAY,EAAE,MAAM,OAAO;AAC3B,4FAA4F;AAC5F,QAAQ,EAAE,OAAO;AACjB,gFAAgF;AAChF,QAAQ,EAAE,cAAc,QAqE3B;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"useOrbitTargetFollow.d.ts","sourceRoot":"","sources":["../../src/hooks/useOrbitTargetFollow.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAsE/E,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,EACxC,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAClD,YAAY,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS;AAClD,+EAA+E;AAC/E,YAAY,EAAE,MAAM,OAAO;AAC3B,4FAA4F;AAC5F,QAAQ,EAAE,OAAO;AACjB,gFAAgF;AAChF,QAAQ,EAAE,cAAc,QAsE3B;AAED,eAAe,oBAAoB,CAAC"}

package/dist/hooks/useOrbitTargetFollow.js

@@ -34,7 +34,8 @@
 // So while looking at an object, the limits are widened each frame just enough to hold
 // where the camera is now: the object can take the view outside the authored range,
 // the user still can't rotate / zoom further out of it, and moving back in tightens
-// them to the authored values again. The authored values come from `controls`.
+// them to the authored values again. The authored values are `controls.authoredLimits` on
+// the live instance (CameraController sets them, controllers drag them), else the config.
 //
 // Height limits (controls.minHeight / maxHeight) are world Y, not relative to the target,
 // and are applied after everything else in the frame.
@@ -173,8 +174,9 @@ authored) {
             }
             // HEIGHT LIMITS (world Y): last, so nothing — user, target, follow, a clip — ends
             // the frame under the floor or over the ceiling. The camera keeps facing the target.
-            const minH = typeof auth.minHeight === 'number' ? auth.minHeight : -Infinity;
-            const maxH = typeof auth.maxHeight === 'number' ? auth.maxHeight : Infinity;
+            const lim = controls?.authoredLimits ?? auth;
+            const minH = typeof lim.minHeight === 'number' ? lim.minHeight : -Infinity;
+            const maxH = typeof lim.maxHeight === 'number' ? lim.maxHeight : Infinity;
             const y = Math.min(maxH, Math.max(minH, camera.position.y));
             if (y !== camera.position.y) {
                 camera.position.y = y;
@@ -186,7 +188,7 @@ authored) {
                 camera.updateMatrixWorld();
             // Limits hold the camera where the moving target left it (see the header).
             if (tObj && controls && a.locked)
-                widenLimits(controls, camera.position, auth);
+                widenLimits(controls, camera.position, controls.authoredLimits ?? auth);
         };
         return () => { scene.onBeforeRender = prev; };
     }, [scene, camera, controlsRef]);

package/dist/operations/bake.d.ts

@@ -0,0 +1,36 @@
+import type { ActionSequence, SceneCommand } from '@3driseai/3drise-core';
+import type { OperationParams } from './types';
+/** What a project holds (the lists SceneBuilder / the studio render with). */
+export interface BakeSource {
+    objects?: ReadonlyArray<any>;
+    actions?: ReadonlyArray<ActionSequence>;
+    clips?: ReadonlyArray<{
+        cues?: ReadonlyArray<{
+            command?: SceneCommand | null;
+        }>;
+    }>;
+    sequences?: ReadonlyArray<{
+        cues?: ReadonlyArray<{
+            command?: SceneCommand | null;
+        }>;
+    }>;
+}
+/** One thing to warm: an operation with its parameters on target ids ('self' already resolved). */
+interface BakeJob {
+    op: string;
+    params: OperationParams;
+    targets: string[];
+    meshNames?: Record<string, string[]>;
+}
+/** Every warm job of a project. */
+export declare function collectBakeJobs(src: BakeSource): BakeJob[];
+/** The project the scene renders (ObjectsRenderer keeps it current). */
+export declare const setBakeSource: (src: BakeSource) => void;
+export interface BakeReport {
+    jobs: number;
+    ms: number;
+}
+/** Bake the current project now (queued behind a bake that is running). Resolves when done. */
+export declare function bakeProject(src?: BakeSource): Promise<BakeReport>;
+export {};
+//# sourceMappingURL=bake.d.ts.map

package/dist/operations/bake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bake.d.ts","sourceRoot":"","sources":["../../src/operations/bake.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAA6C,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAKrH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC;YAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACnF,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,CAAC,EAAE,aAAa,CAAC;YAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED,mGAAmG;AACnG,UAAU,OAAO;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACxC;AASD,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,EAAE,CAyC1D;AAiBD,wEAAwE;AACxE,eAAO,MAAM,aAAa,GAAI,KAAK,UAAU,SAAsB,CAAC;AAIpE,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAExD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,GAAG,GAAE,UAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBzE"}

package/dist/operations/bake.js

@@ -0,0 +1,113 @@
+import { findNodesByName, objectEffectClipOf } from '@3driseai/3drise-core';
+import { findById } from '../utils/sceneQuery.js';
+import { getOperation, resolveParams } from './registry.js';
+import { getEffectClipTemplate, isWarmable, warmEffectOn } from './runtime.js';
+import { objectEffectParams } from './objectEffects.js';
+const commandsOfInteraction = (ix) => (Array.isArray(ix?.commands) ? ix.commands : []);
+const commandsOfAction = (a) => (Array.isArray(a?.commands) ? a.commands : []);
+/** The effects of an effect clip (template or an object's own): Base and every step. */
+const clipEffects = (clip) => [...(clip?.effects ?? []), ...(clip?.steps ?? []).flatMap(s => s?.effects ?? [])].filter(e => e && typeof e.operation === 'string');
+/** Every warm job of a project. */
+export function collectBakeJobs(src) {
+    const jobs = new Map();
+    const add = (op, params, targets, meshNames) => {
+        if (!targets.length)
+            return;
+        const k = JSON.stringify([op, params, targets, meshNames ?? null]);
+        if (!jobs.has(k))
+            jobs.set(k, { op, params, targets, ...(meshNames ? { meshNames } : {}) });
+    };
+    const objectRow = (e, targets, meshNames) => {
+        const def = getOperation(e.operation);
+        if (!isWarmable(def))
+            return;
+        add(def.value, objectEffectParams(def, e), targets, meshNames);
+    };
+    const fromCommand = (c, selfId) => {
+        if (!c)
+            return;
+        const ids = (list) => (list ?? []).map(t => (t === 'self' ? selfId : t)).filter((t) => !!t);
+        if (c.kind === 'effect') {
+            const e = c.effect;
+            if (!e || e.enabled === false)
+                return;
+            const def = getOperation(e.operation);
+            if (!isWarmable(def))
+                return;
+            add(def.value, resolveParams(def, e.params), ids(e.targets), e.meshNames);
+        }
+        else if (c.kind === 'effectClip') {
+            const use = c.use;
+            const clip = use && getEffectClipTemplate(use.clip);
+            if (!clip)
+                return;
+            for (const e of clipEffects(clip))
+                objectRow(e, ids(use.targets), use.meshNames);
+        }
+    };
+    for (const o of src.objects ?? []) {
+        if (!o?.id)
+            continue;
+        for (const ix of (Array.isArray(o.actions) ? o.actions : [])) {
+            if (ix?.enabled === false)
+                continue;
+            for (const c of commandsOfInteraction(ix))
+                fromCommand(c, o.id);
+        }
+        const own = objectEffectClipOf(o);
+        const parts = own.parts?.length ? { [o.id]: own.parts } : undefined;
+        for (const e of clipEffects(own))
+            objectRow(e, [o.id], parts);
+    }
+    for (const a of src.actions ?? [])
+        for (const c of commandsOfAction(a))
+            fromCommand(c, null);
+    for (const t of [...(src.clips ?? []), ...(src.sequences ?? [])])
+        for (const cue of t?.cues ?? [])
+            fromCommand(cue?.command, null);
+    return [...jobs.values()];
+}
+function targetsOf(job) {
+    const out = [];
+    for (const id of job.targets) {
+        const root = findById(id);
+        if (!root)
+            continue;
+        const names = job.meshNames?.[id];
+        if (names?.length)
+            for (const n of names)
+                out.push(...findNodesByName(root, n).filter((x) => x !== root));
+        else
+            out.push(root);
+    }
+    return out;
+}
+// ---------------------------------------------------------------- running it
+let source = {};
+/** The project the scene renders (ObjectsRenderer keeps it current). */
+export const setBakeSource = (src) => { source = src; };
+let running = null;
+/** Bake the current project now (queued behind a bake that is running). Resolves when done. */
+export function bakeProject(src = source) {
+    if (running)
+        return running.then(() => bakeProject(src));
+    const run = (async () => {
+        const t0 = performance.now();
+        const jobs = collectBakeJobs(src);
+        for (const job of jobs) {
+            const def = getOperation(job.op);
+            if (!def)
+                continue;
+            const targets = targetsOf(job);
+            if (targets.length)
+                await warmEffectOn(def, targets, job.params);
+            // let a frame through between jobs (the studio is live while it bakes)
+            await new Promise(r => setTimeout(r, 0));
+        }
+        return { jobs: jobs.length, ms: Math.round(performance.now() - t0) };
+    })();
+    running = run;
+    void run.finally(() => { if (running === run)
+        running = null; });
+    return run;
+}

package/dist/operations/catalogue/physicalHeld.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physicalHeld.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/physicalHeld.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB,6CAA6C;IAC7C,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnB,gEAAgE;IAChE,CAAC,EAAE,eAAe,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,GAAG,EAAE,CAAC,CAAC;IACP,oCAAoC;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,kFAAkF;IAClF,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,KAAK,CAAC,CAAC;IACjD,oHAAoH;IACpH,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACtC;AAED,gCAAgC;AAChC,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAgL,CAAC;AAEtP,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,WAAgD,CAAC;AAE9F,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAmD9E"}
+{"version":3,"file":"physicalHeld.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/physicalHeld.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAqB,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB,6CAA6C;IAC7C,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnB,gEAAgE;IAChE,CAAC,EAAE,eAAe,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,GAAG,EAAE,CAAC,CAAC;IACP,oCAAoC;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,kFAAkF;IAClF,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,eAAe,KAAK,CAAC,CAAC;IACjD,oHAAoH;IACpH,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACtC;AAED,gCAAgC;AAChC,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAgL,CAAC;AAEtP,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,WAAgD,CAAC;AAE9F,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAwD9E"}

package/dist/operations/catalogue/physicalHeld.js

@@ -62,6 +62,12 @@ export function heldPhysical(spec) {
             st.out = false;
             return run(target, st, 1, easeTime(p));
         },
+        // a motion reads its params every frame: a new speed / height just takes over
+        live(target, p) {
+            const st = target.userData[KEY];
+            if (st)
+                st.p = { ...p, __backward: st.p.__backward };
+        },
         revert(target, p) {
             const st = target.userData[KEY];
             if (!st)

package/dist/operations/catalogue/shaderLayers.js

@@ -34,7 +34,7 @@
 // three keeps covers every cached program.
 //
 import { Color, Group, InstancedMesh, Material as ThreeMaterial, Mesh, SkinnedMesh } from 'three';
-import { compileInBackground, warmContext } from './warmup.js';
+import { asInFrame, compileInBackground, warmContext } from './warmup.js';
 /** material → uniform name → the live uniform object of the current layer */
 const liveUniforms = new WeakMap();
 /** material → uniform name → the stable proxy handed to the compiled program */
@@ -170,7 +170,7 @@ export async function commitPendingLayers(root) {
     if (ctx) {
         // let the live materials take the cached programs before the clones let go of them
         try {
-            ctx.gl.compile(root, ctx.cam, ctx.scene);
+            asInFrame(ctx, () => ctx.gl.compile(root, ctx.cam, ctx.scene));
         }
         catch { /* next frame will */ }
         setTimeout(() => clones.forEach(c => c.dispose()), 1500);

package/dist/operations/catalogue/warmup.d.ts

@@ -5,12 +5,34 @@ export interface WarmContext {
     cam: any;
 }
 export declare function warmContext(): WarmContext | null;
+/** Run a compile with the render target the scene is drawn into bound (see the header). */
+export declare function asInFrame<T>(ctx: WarmContext, fn: () => T): T;
 /** compileAsync with a safety timeout (a driver that never reports ready must not hang an effect). */
-export declare function compileInBackground(root: Object3D, timeoutMs?: number): Promise<void>;
+export declare function compileInBackground(root: Object3D, timeoutMs?: number, given?: WarmContext | null): Promise<void>;
+/** The whole scene, as the frame draws it (the published scene's load: see triggers/readiness). */
+export declare function compileScene(three?: {
+    gl: any;
+    scene: any;
+    camera: any;
+} | null, timeoutMs?: number): Promise<void>;
+/**
+ * Upload every texture of `root` to the GPU now. three uploads a texture the first time
+ * something using it is drawn — in that frame: an object hidden at load and shown later
+ * (a cue, an action, visibility) would stall the frame it appears in.
+ */
+export declare function uploadTextures(root?: Object3D): number;
 /** Keep a freshly created helper off screen until its shaders are compiled (see warmHelpers). */
 export declare function hideUntilWarm(obj: Object3D): void;
 /** Compile every helper under `root` that is waiting, in the background, then show it. */
 export declare function warmHelpers(root: Object3D): Promise<void>;
+/**
+ * The shadow pass draws a shadow caster with three's own depth material — a program
+ * compileAsync never builds, so a new kind of caster (an instanced helper) compiled it
+ * in the first frame that drew its shadow. Build it here: a stand-in of the same kind
+ * with an equivalent depth material, compiled into a render target as the shadow map is.
+ * The stand-ins are kept (never drawn) so the programs stay cached.
+ */
+export declare function warmShadowPass(root: Object3D): Promise<void>;
 /**
  * Warm-only runs (pre-warming): while this is on, an effect's runProgress compiles
  * everything it needs and then stops — nothing animates. See runtime.prewarmEffect.

package/dist/operations/catalogue/warmup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"warmup.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/warmup.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGhD,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE;AAE9D,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAGhD;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnF;AAUD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,QAI1C;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;;CAAgB,CAAC;AAStC,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,QAmB5C"}
+{"version":3,"file":"warmup.d.ts","sourceRoot":"","sources":["../../../src/operations/catalogue/warmup.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAY,QAAQ,EAAW,MAAM,OAAO,CAAC;AAGzD,MAAM,WAAW,WAAW;IAAG,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE;AAE9D,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAIhD;AA4BD,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAO7D;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,SAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/G;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,EAAE,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG,IAAI,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAatD;AAWD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,QAI1C;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;AAsBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D;AAyCD;;;GAGG;AACH,eAAO,MAAM,QAAQ;;CAAgB,CAAC;AAStC,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,QAqB5C"}