remotion 4.0.532 → 4.0.534

package/dist/cjs/CompositionManager.d.ts

@@ -7,6 +7,7 @@ import type { EffectDefinition } from './effects/effect-types.js';
 import type { InteractivitySchema } from './interactivity-schema.js';
 import type { InferProps, PropsIfHasProps } from './props-if-has-props.js';
 import type { RuntimeValueSnapshot, RuntimeValueStore } from './runtime-value-store.js';
+import type { TimelineTrackItem } from './timeline-track-context.js';
 import type { VideoConfigValues } from './video-config.js';
 export type TComposition<Schema extends AnyZodObject, Props extends Record<string, unknown>> = {
     width: number | undefined;
@@ -77,14 +78,23 @@ export type TSequence = {
     from: number;
     trimBefore: number | null;
     duration: number;
+    /** Infer the timeline display duration from children without changing playback. */
+    readonly autoDuration?: boolean | null;
+    /** Whether the wrapper can restore its duration from its scenes. */
+    readonly canInferDuration?: boolean | null;
+    /** Full scene duration in the parent clock, before container clipping. */
+    readonly unclippedDuration?: number | null;
     id: string;
     displayName: string;
     documentationLink: string | null;
     parent: string | null;
     showInTimeline: boolean;
     timelineOrder: number | null;
+    timelineTrack?: TimelineTrackItem;
     loopDisplay: LoopDisplay | undefined;
     getStack: () => string | null;
+    /** Read the committed child clock without updating timeline metadata each frame. */
+    getCurrentFrame?: (() => number) | null;
     premountDisplay: number | null;
     postmountDisplay: number | null;
     controls: SequenceRegistrationControls | null;

package/dist/cjs/CompositionManagerProvider.js

@@ -28,11 +28,10 @@ const CompositionManagerProvider = ({ children, onlyRenderComposition, currentCo
     // CompositionManagerProvider state
     const currentcompositionsRef = (0, react_1.useRef)(compositions);
     const updateCompositions = (0, react_1.useCallback)((updateComps) => {
-        setCompositions((comps) => {
-            const updated = updateComps(comps);
-            currentcompositionsRef.current = updated;
-            return updated;
-        });
+        // The renderer may read registrations before React commits the state.
+        const updated = updateComps(currentcompositionsRef.current);
+        currentcompositionsRef.current = updated;
+        setCompositions(updated);
     }, []);
     const registerComposition = (0, react_1.useCallback)((comp) => {
         const orderKey = (0, sequence_order_marker_js_1.getCompositionAndFolderOrderKey)({
@@ -58,10 +57,8 @@ const CompositionManagerProvider = ({ children, onlyRenderComposition, currentCo
     }, [updateCompositions]);
     const unregisterComposition = (0, react_1.useCallback)((id) => {
         internalOrderRef.current.delete((0, sequence_order_marker_js_1.getCompositionAndFolderOrderKey)({ type: 'composition', id }));
-        setCompositions((comps) => {
-            return comps.filter((c) => c.id !== id);
-        });
-    }, []);
+        updateCompositions((comps) => comps.filter((c) => c.id !== id));
+    }, [updateCompositions]);
     const registerFolder = (0, react_1.useCallback)((name, parent, stack) => {
         const orderKey = (0, sequence_order_marker_js_1.getCompositionAndFolderOrderKey)({
             type: 'folder',

package/dist/cjs/HtmlInCanvas.d.ts

@@ -72,6 +72,7 @@ export type HtmlInCanvasOnPaintParams = {
     readonly pixelDensity: number;
 };
 export declare const isHtmlInCanvasSupported: () => boolean;
+export declare const isHtmlInCanvasNestingSupported: () => boolean;
 /** Generic fallback for consumers that cannot inspect the current browser. */
 export declare const HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = "HTML in Canvas requires Chrome 149 or newer with Canvas Draw Element enabled at chrome://flags/#canvas-draw-element.";
 export declare const getHtmlInCanvasUnsupportedMessage: () => string;
@@ -319,4 +320,5 @@ export declare const HtmlInCanvas: React.ForwardRefExoticComponent<Omit<Interact
     readonly _remotionInternalCanvasSiblings?: React.ReactNode;
 } & React.RefAttributes<HTMLCanvasElement>> & {
     readonly isSupported: () => boolean;
+    readonly isNestingSupported: () => boolean;
 };

package/dist/cjs/HtmlInCanvas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HtmlInCanvas = exports.htmlInCanvasSchema = exports.getHtmlInCanvasUnsupportedMessage = exports.HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = exports.isHtmlInCanvasSupported = void 0;
+exports.HtmlInCanvas = exports.htmlInCanvasSchema = exports.getHtmlInCanvasUnsupportedMessage = exports.HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = exports.isHtmlInCanvasNestingSupported = exports.isHtmlInCanvasSupported = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const run_effect_chain_js_1 = require("./effects/run-effect-chain.js");
@@ -54,6 +54,17 @@ const isHtmlInCanvasSupported = () => {
     return cachedSupport;
 };
 exports.isHtmlInCanvasSupported = isHtmlInCanvasSupported;
+const MINIMUM_CHROME_VERSION_FOR_NESTED_HTML_IN_CANVAS = 157;
+const isHtmlInCanvasNestingSupported = () => {
+    var _a;
+    if (!(0, exports.isHtmlInCanvasSupported)() || typeof navigator === 'undefined') {
+        return false;
+    }
+    const chromeVersion = (_a = navigator.userAgent.match(/(?:Chrome|Chromium)\/(\d+)/)) === null || _a === void 0 ? void 0 : _a[1];
+    return (chromeVersion !== undefined &&
+        Number(chromeVersion) >= MINIMUM_CHROME_VERSION_FOR_NESTED_HTML_IN_CANVAS);
+};
+exports.isHtmlInCanvasNestingSupported = isHtmlInCanvasNestingSupported;
 /** Generic fallback for consumers that cannot inspect the current browser. */
 exports.HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = 'HTML in Canvas requires Chrome 149 or newer with Canvas Draw Element enabled at chrome://flags/#canvas-draw-element.';
 const getHtmlInCanvasUnsupportedMessage = () => {
@@ -136,11 +147,11 @@ const defaultOnPaint = ({ canvas, elementImage, }) => {
 /* eslint-enable react/require-default-props */
 const HtmlInCanvasAncestorContext = (0, react_1.createContext)(false);
 const HtmlInCanvasContent = (0, react_1.forwardRef)(({ width, height, effects, children, canvasSiblings, onPaint, onInit, pixelDensity, controls, style, }, ref) => {
-    var _a;
+    var _a, _b;
     const isInsideAncestorHtmlInCanvas = (0, react_1.useContext)(HtmlInCanvasAncestorContext);
     assertHtmlInCanvasDimensions(width, height);
-    if (isInsideAncestorHtmlInCanvas) {
-        throw new Error('<HtmlInCanvas> components cannot be nested. Chrome does not reliably render nested HTML-in-canvas subtrees. Consider merging the effects into one <HtmlInCanvas> if you can.');
+    if (isInsideAncestorHtmlInCanvas && !(0, exports.isHtmlInCanvasNestingSupported)()) {
+        throw new Error(`Nested <HtmlInCanvas> components require Chrome ${MINIMUM_CHROME_VERSION_FOR_NESTED_HTML_IN_CANVAS} or newer with HTML-in-canvas enabled.`);
     }
     const resolvedPixelDensity = resolveHtmlInCanvasPixelDensity(pixelDensity);
     const canvasWidth = Math.ceil(width * resolvedPixelDensity);
@@ -169,6 +180,7 @@ const HtmlInCanvasContent = (0, react_1.forwardRef)(({ width, height, effects, c
     const memoizedEffects = (0, use_memoized_effects_js_1.useMemoizedEffects)({
         effects,
         overrideId: (_a = controls === null || controls === void 0 ? void 0 : controls.overrideId) !== null && _a !== void 0 ? _a : null,
+        videoConfigValues: (_b = controls === null || controls === void 0 ? void 0 : controls.videoConfigValues) !== null && _b !== void 0 ? _b : null,
     });
     // Refs so the paint handler always reads fresh values.
     const effectsRef = (0, react_1.useRef)(memoizedEffects);
@@ -471,6 +483,7 @@ const HtmlInCanvasWrapped = (0, with_interactivity_schema_js_1.withInteractivity
 });
 exports.HtmlInCanvas = Object.assign(HtmlInCanvasWrapped, {
     isSupported: exports.isHtmlInCanvasSupported,
+    isNestingSupported: exports.isHtmlInCanvasNestingSupported,
 });
 exports.HtmlInCanvas.displayName = 'HtmlInCanvas';
 (0, enable_sequence_stack_traces_js_1.addSequenceStackTraces)(exports.HtmlInCanvas);

package/dist/cjs/Sequence.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { LoopDisplay, SequenceControls } from './CompositionManager.js';
 import type { EffectDefinition } from './effects/effect-types.js';
+import { type TimelineTrackItem } from './timeline-track-context.js';
 import type { BasicMediaInTimelineReturnType } from './use-media-in-timeline.js';
 export type AbsoluteFillLayout = {
     layout?: 'absolute-fill';
@@ -32,6 +33,10 @@ export type SequencePropsWithoutDuration = {
     readonly hidden?: boolean;
     readonly controls?: SequenceControls;
     readonly _remotionInternalEffects?: readonly EffectDefinition<unknown>[];
+    /**
+     * @deprecated For internal use only.
+     */
+    readonly _remotionInternalTimelineTrack?: Pick<TimelineTrackItem, 'role'>;
     /**
      * @deprecated For internal use only.
      */

package/dist/cjs/Sequence.js

@@ -18,19 +18,23 @@ const SequenceContext_js_1 = require("./SequenceContext.js");
 const SequenceManager_js_1 = require("./SequenceManager.js");
 const is_inside_series_js_1 = require("./series/is-inside-series.js");
 const timeline_position_state_js_1 = require("./timeline-position-state.js");
+const timeline_track_context_js_1 = require("./timeline-track-context.js");
 const use_premounting_js_1 = require("./use-premounting.js");
 const use_remotion_environment_js_1 = require("./use-remotion-environment.js");
 const use_sequence_registration_js_1 = require("./use-sequence-registration.js");
 const use_video_config_js_1 = require("./use-video-config.js");
 const v5_flag_js_1 = require("./v5-flag.js");
 const with_interactivity_schema_js_1 = require("./with-interactivity-schema.js");
+const SeriesContentVisibilityContext = (0, react_1.createContext)(true);
 const EMPTY_EFFECTS = [];
-const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playbackRate = 1, loop = false, freeze, durationInFrames, children, name, height, width, showInTimeline = true, hidden = false, controls, _remotionInternalEffects, _remotionInternalLoopDisplay: loopDisplay, _remotionInternalStack: stack, _remotionInternalDocumentationLink: documentationLink, _remotionInternalSingleChildComponent: singleChildComponent, _remotionInternalPremountDisplay: premountDisplay, _remotionInternalPostmountDisplay: postmountDisplay, _remotionInternalIsMedia: isMedia, outlineRef: passedRefForOutline, cropLeft, cropRight, cropTop, cropBottom, ...other }, ref) => {
-    var _a, _b, _c, _d, _e;
+const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playbackRate = 1, loop = false, freeze, durationInFrames, children, name, height, width, showInTimeline = true, hidden = false, controls, _remotionInternalEffects, _remotionInternalTimelineTrack: timelineTrackItem, _remotionInternalLoopDisplay: loopDisplay, _remotionInternalStack: stack, _remotionInternalDocumentationLink: documentationLink, _remotionInternalSingleChildComponent: singleChildComponent, _remotionInternalPremountDisplay: premountDisplay, _remotionInternalPostmountDisplay: postmountDisplay, _remotionInternalIsMedia: isMedia, outlineRef: passedRefForOutline, cropLeft, cropRight, cropTop, cropBottom, ...other }, ref) => {
+    var _a, _b, _c, _d, _e, _f;
     const { layout = 'absolute-fill' } = other;
     const [id] = (0, react_1.useState)(() => String(Math.random()));
     const parentSequence = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
-    const parentPlaybackRate = (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.playbackRate) !== null && _a !== void 0 ? _a : 1;
+    const timelineTrack = (0, react_1.useContext)(timeline_track_context_js_1.TimelineTrackContext);
+    const timelineTrackRole = (_a = timelineTrackItem === null || timelineTrackItem === void 0 ? void 0 : timelineTrackItem.role) !== null && _a !== void 0 ? _a : 'clip';
+    const parentPlaybackRate = (_b = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.playbackRate) !== null && _b !== void 0 ? _b : 1;
     const cumulativePlaybackRate = parentPlaybackRate * playbackRate;
     const cumulatedFrom = parentSequence
         ? parentSequence.cumulatedFrom + parentSequence.relativeFrom
@@ -140,7 +144,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     const clockFrom = from + loopOffset;
     const effectiveRelativeFrom = clockFrom - trimBefore / playbackRate;
     const relativeFrom = effectiveRelativeFrom / parentPlaybackRate;
-    const absoluteFrom = ((_b = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.absoluteFrom) !== null && _b !== void 0 ? _b : 0) + relativeFrom;
+    const absoluteFrom = ((_c = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.absoluteFrom) !== null && _c !== void 0 ? _c : 0) + relativeFrom;
     // Inside a loop, the local clock ends after `durationInFrames`, except in a final
     // iteration that the parent cuts short.
     const localClockEnd = loopPeriod === null
@@ -254,11 +258,18 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     // and if it changes, it would lead to-remounting of the sequence.
     const stackRef = (0, react_1.useRef)(null);
     stackRef.current = controls
-        ? ((_d = (_c = (0, enable_sequence_stack_traces_js_1.getStackForControls)(controls)) !== null && _c !== void 0 ? _c : stack) !== null && _d !== void 0 ? _d : null)
+        ? ((_e = (_d = (0, enable_sequence_stack_traces_js_1.getStackForControls)(controls)) !== null && _d !== void 0 ? _d : stack) !== null && _e !== void 0 ? _e : null)
         : (stack !== null && stack !== void 0 ? stack : null);
+    const getStack = (0, react_1.useCallback)(() => stackRef.current, []);
     const registeredFrozenFrame = typeof freeze === 'number' ? freeze : null;
+    const currentFrame = registeredFrozenFrame !== null && registeredFrozenFrame !== void 0 ? registeredFrozenFrame : (absoluteFrame - currentSequenceStart) * cumulativePlaybackRate;
+    const currentFrameRef = (0, react_1.useRef)(currentFrame);
+    (0, react_1.useLayoutEffect)(() => {
+        currentFrameRef.current = currentFrame;
+    }, [currentFrame]);
+    const getCurrentFrame = (0, react_1.useCallback)(() => currentFrameRef.current, []);
     const registeredTrimBefore = trimBefore === 0 ? null : trimBefore;
-    const parentCumulatedNegativeFrom = (_e = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _e !== void 0 ? _e : 0;
+    const parentCumulatedNegativeFrom = (_f = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _f !== void 0 ? _f : 0;
     const startMediaFrom = isMedia && isMedia.type !== 'image'
         ? isMedia.data.startMediaFrom +
             parentCumulatedNegativeFrom -
@@ -283,6 +294,23 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     const controlsComponentIdentity = controls === null || controls === void 0 ? void 0 : controls.componentIdentity;
     const controlsComponentName = controls === null || controls === void 0 ? void 0 : controls.componentName;
     const controlsVideoConfigValues = controls === null || controls === void 0 ? void 0 : controls.videoConfigValues;
+    const isInsideNonPremountFreeze = (0, freeze_js_1.useIsInsideNonPremountFreeze)();
+    const canInferDuration = (controlsComponentIdentity === 'dev.remotion.remotion.Series' ||
+        controlsComponentIdentity ===
+            'dev.remotion.transitions.TransitionSeries') &&
+        !loop &&
+        registeredFrozenFrame === null &&
+        !isInsideNonPremountFreeze &&
+        !hidden;
+    const autoDuration = canInferDuration && durationInFrames === undefined;
+    const isSeriesChild = controlsComponentIdentity === 'dev.remotion.remotion.Series.Sequence' ||
+        controlsComponentIdentity ===
+            'dev.remotion.transitions.TransitionSeries.Sequence' ||
+        controlsComponentIdentity ===
+            'dev.remotion.transitions.TransitionSeries.Transition' ||
+        controlsComponentIdentity ===
+            'dev.remotion.transitions.TransitionSeries.Overlay';
+    const seriesContentVisible = (0, react_1.useContext)(SeriesContentVisibilityContext);
     const effectRuntimeValues = (0, react_1.useMemo)(() => {
         var _a;
         return (_a = _remotionInternalEffects === null || _remotionInternalEffects === void 0 ? void 0 : _remotionInternalEffects.runtimeValues) !== null && _a !== void 0 ? _a : null;
@@ -317,9 +345,18 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     ]);
     const getSequenceForRegistration = (0, react_1.useCallback)(() => {
         var _a, _b, _c;
+        const trackRegistration = timelineTrack
+            ? {
+                timelineTrack: {
+                    ...timelineTrack,
+                    role: timelineTrackRole,
+                },
+            }
+            : {};
         if (isMedia) {
             if (isMedia.type === 'image') {
                 return {
+                    ...trackRegistration,
                     sequencePlaybackRate: playbackRate,
                     type: 'image',
                     controls: registrationControls,
@@ -338,7 +375,8 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                     showInTimeline,
                     timelineOrder: null,
                     src: isMedia.src,
-                    getStack: () => stackRef.current,
+                    getStack,
+                    getCurrentFrame,
                     refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
                     isInsideSeries,
                     frozenFrame: registeredFrozenFrame,
@@ -346,6 +384,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 };
             }
             return {
+                ...trackRegistration,
                 type: isMedia.type,
                 sequencePlaybackRate: playbackRate,
                 controls: registrationControls,
@@ -366,7 +405,8 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 showInTimeline,
                 timelineOrder: null,
                 src: isMedia.data.src,
-                getStack: () => stackRef.current,
+                getStack,
+                getCurrentFrame,
                 startMediaFrom: startMediaFrom !== null && startMediaFrom !== void 0 ? startMediaFrom : isMedia.data.startMediaFrom,
                 mediaFrameAtSequenceZero,
                 volume: isMedia.data.volumes,
@@ -379,10 +419,14 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
             };
         }
         return {
+            ...trackRegistration,
             from,
             sequencePlaybackRate: playbackRate,
             trimBefore: registeredTrimBefore,
             duration: actualDurationInFrames,
+            ...(autoDuration ? { autoDuration: true } : {}),
+            ...(canInferDuration ? { canInferDuration: true } : {}),
+            ...(isSeriesChild ? { unclippedDuration: effectiveDurationInFrames } : {}),
             id,
             displayName: timelineClipName,
             documentationLink: resolvedDocumentationLink,
@@ -391,7 +435,8 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
             showInTimeline,
             timelineOrder: null,
             loopDisplay: resolvedLoopDisplay,
-            getStack: () => stackRef.current,
+            getStack,
+            getCurrentFrame,
             premountDisplay: premountDisplay !== null && premountDisplay !== void 0 ? premountDisplay : null,
             postmountDisplay: postmountDisplay !== null && postmountDisplay !== void 0 ? postmountDisplay : null,
             controls: registrationControls,
@@ -404,10 +449,18 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         };
     }, [
         id,
+        timelineTrack,
+        timelineTrackRole,
+        getCurrentFrame,
+        getStack,
         timelineClipName,
         playbackRate,
         parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.id,
         actualDurationInFrames,
+        autoDuration,
+        canInferDuration,
+        isSeriesChild,
+        effectiveDurationInFrames,
         from,
         registeredTrimBefore,
         showInTimeline,
@@ -442,7 +495,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         parentPlaybackRate,
         durationInFrames: effectiveDurationInFrames,
     });
-    const content = frameInParent - from < -boundaryTolerance
+    const content = !seriesContentVisible || frameInParent - from < -boundaryTolerance
         ? null
         : frameInParent - endThreshold >= -boundaryTolerance
             ? null
@@ -485,7 +538,16 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     if (hidden) {
         return shouldDiscoverOutline ? (jsx_runtime_1.jsx(sequence_order_marker_js_1.SequenceOrderMarker, { sequenceId: id, outlineChildrenRef: automaticOutlineRef, children: null })) : null;
     }
-    const sequence = (jsx_runtime_1.jsx(SequenceContext_js_1.SequenceContext.Provider, { value: contextValue, children: loopedContent === null ? null : other.layout === 'none' ? (loopedContent) : (jsx_runtime_1.jsx(AbsoluteFillElement_js_1.AbsoluteFillElement, { ref: sequenceRef, style: defaultStyle, className: other.className, children: loopedContent })) }));
+    // Retain resolved scene registrations so Studio can recover the natural end
+    // even when seeking past an explicit wrapper trim. Scene contents stay hidden.
+    const retainSeriesRegistration = env.isStudio && canInferDuration;
+    const renderedContent = loopedContent === null ? (retainSeriesRegistration ? (children) : null) : other.layout === 'none' ? (loopedContent) : (jsx_runtime_1.jsx(AbsoluteFillElement_js_1.AbsoluteFillElement, { ref: sequenceRef, style: defaultStyle, className: other.className, children: loopedContent }));
+    const sequenceContent = (jsx_runtime_1.jsx(SequenceContext_js_1.SequenceContext.Provider, { value: contextValue, children: retainSeriesRegistration ? (jsx_runtime_1.jsx(SeriesContentVisibilityContext.Provider, { value: content !== null, children: renderedContent })) : (renderedContent) }));
+    // Keep the provider mounted when track grouping changes so clip state survives.
+    const sequence = (jsx_runtime_1.jsx(timeline_track_context_js_1.TimelineTrackContext.Provider, { value: timelineTrackRole === 'track' ||
+            (timelineTrackRole === 'clip' && !showInTimeline)
+            ? timelineTrack
+            : null, children: sequenceContent }));
     return shouldDiscoverOutline ? (jsx_runtime_1.jsx(sequence_order_marker_js_1.SequenceOrderMarker, { sequenceId: id, outlineChildrenRef: automaticOutlineRef, children: sequence })) : (sequence);
 };
 const RegularSequence = (0, react_1.forwardRef)(RegularSequenceRefForwardingFunction);

package/dist/cjs/SequenceManager.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { TSequence } from './CompositionManager.js';
 import type { CanUpdateSequencePropStatus, DragOverrideValue, GetDragOverrides, GetEffectDragOverrides, PropStatuses } from './use-schema.js';
+import type { SourceNumericValue } from './use-schema.js';
 import type { VideoConfigValues } from './video-config.js';
 export type SequenceManagerContext = {
     registerSequence: (seq: TSequence) => void;
@@ -12,7 +13,10 @@ export type SequenceManagerRef = {
     current: TSequence[];
 };
 export type SequenceNodePath = Array<string | number>;
+type SequenceManagerActions = Pick<SequenceManagerContext, 'registerSequence' | 'updateSequence' | 'unregisterSequence'>;
+export declare const SequenceManagerActionsContext: React.Context<SequenceManagerActions>;
 export declare const SequenceManager: React.Context<SequenceManagerContext>;
+export declare const useSequenceManagerSequences: () => TSequence[];
 export declare const SequenceManagerRefContext: React.Context<SequenceManagerRef>;
 export declare const SequenceRegistrationContext: React.Context<boolean>;
 export declare const DisableSequenceRegistrationContext: React.Context<boolean>;
@@ -29,6 +33,14 @@ export type VisualModeDragOverrides = {
     getDragOverrides: GetDragOverrides;
     getEffectDragOverrides: GetEffectDragOverrides;
 };
+type DragOverridesSubscription = {
+    manager: SequenceManagerActions;
+    subscribe: (key: string | null, listener: () => void) => () => void;
+    getSnapshot: (key: string | null) => Record<string, DragOverrideValue>;
+    subscribeEffects: (key: string | null, listener: () => void) => () => void;
+    getEffectSnapshot: (key: string | null) => Record<string, Record<string, DragOverrideValue>>;
+};
+export declare const VisualModeDragOverridesSubscriptionContext: React.Context<DragOverridesSubscription | null>;
 export type SequencePropsStatusRemapping = {
     previousNodePath: SequencePropsSubscriptionKey;
     nodePath: SequencePropsSubscriptionKey | null;
@@ -42,12 +54,25 @@ export type VisualModeSetters = {
     setPropStatuses: (nodePath: SequencePropsSubscriptionKey, values: (prev: CanUpdateSequencePropsResponse) => CanUpdateSequencePropsResponse) => void;
     remapPropStatuses: (remappings: readonly SequencePropsStatusRemapping[]) => void;
 };
-export type CanUpdateEffectPropsResponseTrue = {
+export type VisualModeBatchSetters = {
+    setDragOverridesBatch: (overrides: readonly {
+        readonly nodePath: SequencePropsSubscriptionKey;
+        readonly key: string;
+        readonly value: DragOverrideValue;
+    }[]) => void;
+    setEffectDragOverridesBatch: (overrides: readonly {
+        readonly nodePath: SequencePropsSubscriptionKey;
+        readonly effectIndex: number;
+        readonly key: string;
+        readonly value: DragOverrideValue;
+    }[]) => void;
+};
+export type CanUpdateEffectPropsResponseTrue<Numeric = SourceNumericValue> = {
     canUpdate: true;
     callee: string;
     importPath: string | null;
     effectIndex: number;
-    props: Record<string, CanUpdateSequencePropStatus>;
+    props: Record<string, CanUpdateSequencePropStatus<Numeric>>;
 };
 export type CannotUpdateEffectReason = 'not-found' | 'computed' | 'not-call-expression';
 export type CannotUpdateSequenceReason = 'not-found' | 'error';
@@ -56,27 +81,32 @@ export type CanUpdateEffectPropsResponseFalse = {
     effectIndex: number;
     reason: CannotUpdateEffectReason;
 };
-export type CanUpdateEffectPropsResponse = CanUpdateEffectPropsResponseTrue | CanUpdateEffectPropsResponseFalse;
-export type CanUpdateSequencePropsResponseTrue = {
+export type CanUpdateEffectPropsResponse<Numeric = SourceNumericValue> = CanUpdateEffectPropsResponseTrue<Numeric> | CanUpdateEffectPropsResponseFalse;
+export type CanUpdateSequencePropsResponseTrue<Numeric = SourceNumericValue> = {
     canUpdate: true;
-    props: Record<string, CanUpdateSequencePropStatus>;
-    effects: CanUpdateEffectPropsResponse[];
+    props: Record<string, CanUpdateSequencePropStatus<Numeric>>;
+    effects: CanUpdateEffectPropsResponse<Numeric>[];
 };
 export type CanUpdateSequencePropsResponseFalse = {
     canUpdate: false;
     reason: CannotUpdateSequenceReason;
 };
-export type CanUpdateSequencePropsResponse = CanUpdateSequencePropsResponseTrue | CanUpdateSequencePropsResponseFalse;
+export type CanUpdateSequencePropsResponse<Numeric = SourceNumericValue> = CanUpdateSequencePropsResponseTrue<Numeric> | CanUpdateSequencePropsResponseFalse;
 export declare const makeSequencePropsSubscriptionKey: (key: SequencePropsSubscriptionKey) => string;
 export declare const VisualModePropStatusesContext: React.Context<VisualModePropStatuses>;
 export declare const VisualModePropStatusesRefContext: React.Context<VisualModePropStatusesRef>;
 export declare const VisualModeDragOverridesContext: React.Context<VisualModeDragOverrides>;
+export declare const useDragOverridesForNodePath: (nodePath: SequencePropsSubscriptionKey | null) => Record<string, DragOverrideValue>;
+export declare const useActiveFromDragOverrideKeys: () => ReadonlySet<string>;
+export declare const useEffectDragOverridesForNodePath: (nodePath: SequencePropsSubscriptionKey | null, effectCount: number) => Record<string, Record<string, DragOverrideValue>>;
 export declare const VisualModeSettersContext: React.Context<VisualModeSetters>;
+export declare const VisualModeBatchSettersContext: React.Context<VisualModeBatchSetters | null>;
 export type SequencePropsSubscriptionKey = {
     absolutePath: string;
     nodePath: SequenceNodePath;
     sequenceKeys: string[];
     effectKeys: string[][];
+    /** Evaluation context of a rendered instance. Never part of source identity. */
     videoConfigValues: VideoConfigValues | null;
 };
 export type { VideoConfigValues } from './video-config.js';