remotion 4.0.534 → 4.0.535

package/dist/cjs/Sequence.d.ts

@@ -36,7 +36,7 @@ export type SequencePropsWithoutDuration = {
     /**
      * @deprecated For internal use only.
      */
-    readonly _remotionInternalTimelineTrack?: Pick<TimelineTrackItem, 'role'>;
+    readonly _remotionInternalTimelineTrack?: Pick<TimelineTrackItem, 'role' | 'seriesOffset'>;
     /**
      * @deprecated For internal use only.
      */
@@ -80,8 +80,7 @@ export type SequencePropsWithoutDuration = {
         src: string;
     };
     /**
-     * @deprecated Remotion Studio discovers rendered elements automatically.
-     * Remove this prop.
+     * @deprecated This prop has no effect. Remotion Studio discovers selection outlines automatically.
      */
     readonly outlineRef?: React.RefObject<Element | null> | null;
 } & LayoutAndStyle;

package/dist/cjs/Sequence.js

@@ -2,18 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SequenceWithoutFrom = exports.Sequence = exports.SequenceWithoutSchema = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
-/* eslint-disable @typescript-eslint/no-use-before-define */
 const react_1 = require("react");
 const AbsoluteFillElement_js_1 = require("./AbsoluteFillElement.js");
+const committed_metadata_js_1 = require("./committed-metadata.js");
+const component_identity_js_1 = require("./component-identity.js");
+const DefaultPremountContext_js_1 = require("./DefaultPremountContext.js");
 const enable_sequence_stack_traces_js_1 = require("./enable-sequence-stack-traces.js");
 const freeze_js_1 = require("./freeze.js");
 const get_sequence_boundary_tolerance_js_1 = require("./get-sequence-boundary-tolerance.js");
 const interactivity_schema_js_1 = require("./interactivity-schema.js");
 const loop_context_js_1 = require("./loop/loop-context.js");
 const resolve_sequence_duration_js_1 = require("./resolve-sequence-duration.js");
+const sequence_activity_context_js_1 = require("./sequence-activity-context.js");
 const sequence_crop_js_1 = require("./sequence-crop.js");
-const sequence_order_marker_js_1 = require("./sequence-order-marker.js");
 const sequence_outline_js_1 = require("./sequence-outline.js");
+const SequenceActivityBoundary_js_1 = require("./SequenceActivityBoundary.js");
+const SequenceActivityBudget_js_1 = require("./SequenceActivityBudget.js");
 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");
@@ -23,18 +27,23 @@ 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 SequenceContextProvider = (0, committed_metadata_js_1.withCommittedMetadata)(SequenceContext_js_1.SequenceContext.Provider);
 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, _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 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, _remotionInternalSingleChildComponent: childComponentOverride, _remotionInternalDocumentationLink: documentationLink, _remotionInternalPremountDisplay: premountDisplay, _remotionInternalPostmountDisplay: postmountDisplay, _remotionInternalIsMedia: isMedia, cropLeft, cropRight, cropTop, cropBottom, ...other }, ref) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     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 activityRequested = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityContext);
+    const parentDormant = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityDormantContext);
+    const env = (0, use_remotion_environment_js_1.useRemotionEnvironment)();
+    const activityEnabled = activityRequested && env.isStudio && !env.isRendering;
     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 seriesOffset = (_b = timelineTrackItem === null || timelineTrackItem === void 0 ? void 0 : timelineTrackItem.seriesOffset) !== null && _b !== void 0 ? _b : null;
+    const parentPlaybackRate = (_c = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.playbackRate) !== null && _c !== void 0 ? _c : 1;
     const cumulativePlaybackRate = parentPlaybackRate * playbackRate;
     const cumulatedFrom = parentSequence
         ? parentSequence.cumulatedFrom + parentSequence.relativeFrom
@@ -110,7 +119,9 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         lastPlaybackRate.current.playbackRate !== playbackRate) {
         throw new Error('The "playbackRate" prop of <Sequence /> must be constant. Animating playbackRate is not supported.');
     }
-    lastPlaybackRate.current = { playbackRate, frame: absoluteFrame };
+    (0, react_1.useLayoutEffect)(() => {
+        lastPlaybackRate.current = { playbackRate, frame: absoluteFrame };
+    }, [absoluteFrame, playbackRate]);
     const videoConfig = (0, use_video_config_js_1.useVideoConfig)();
     const effectiveDurationInFrames = (0, resolve_sequence_duration_js_1.resolveSequenceDuration)({
         durationInFrames,
@@ -130,7 +141,11 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         ? contentDurationInFrames / playbackRate
         : null;
     let loopIteration = 0;
-    if (loopPeriod !== null) {
+    if (loopPeriod !== null &&
+        (!activityEnabled ||
+            (!parentDormant &&
+                frameInParent >= from &&
+                frameInParent < from + actualDurationInFrames))) {
         const loopsElapsed = (frameInParent - from) / loopPeriod;
         const nearestIteration = Math.round(loopsElapsed);
         // Fractional periods and nested playback rates can put an exact loop
@@ -144,7 +159,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     const clockFrom = from + loopOffset;
     const effectiveRelativeFrom = clockFrom - trimBefore / playbackRate;
     const relativeFrom = effectiveRelativeFrom / parentPlaybackRate;
-    const absoluteFrom = ((_c = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.absoluteFrom) !== null && _c !== void 0 ? _c : 0) + relativeFrom;
+    const absoluteFrom = ((_d = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.absoluteFrom) !== null && _d !== void 0 ? _d : 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
@@ -154,15 +169,12 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
             trimBefore;
     const sequenceRegistrationEnabled = (0, react_1.useContext)(SequenceManager_js_1.SequenceRegistrationContext);
     const canvasOutlinesEnabled = (0, react_1.useContext)(sequence_outline_js_1.SequenceOutlineContext);
-    const env = (0, use_remotion_environment_js_1.useRemotionEnvironment)();
     const shouldDiscoverOutline = env.isStudio || canvasOutlinesEnabled;
-    const automaticOutlineRef = (0, react_1.useMemo)(() => shouldDiscoverOutline && layout === 'none' && !passedRefForOutline
+    const automaticOutlineRef = (0, react_1.useMemo)(() => shouldDiscoverOutline && layout === 'none'
         ? sequence_outline_js_1.SequenceOutlineInternals.createRef()
-        : null, [shouldDiscoverOutline, layout, passedRefForOutline]);
+        : null, [shouldDiscoverOutline, layout]);
     const wrapperRefForOutline = (0, react_1.useRef)(null);
-    const refForOutline = other.layout === 'none'
-        ? (passedRefForOutline !== null && passedRefForOutline !== void 0 ? passedRefForOutline : automaticOutlineRef)
-        : (passedRefForOutline !== null && passedRefForOutline !== void 0 ? passedRefForOutline : wrapperRefForOutline);
+    const refForOutline = layout === 'none' ? automaticOutlineRef : wrapperRefForOutline;
     const premounting = (0, react_1.useMemo)(() => {
         // || is intentional, ?? would not trigger on `false`
         return ((parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.premounting) ||
@@ -254,13 +266,13 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     }, [name]);
     const resolvedDocumentationLink = documentationLink !== null && documentationLink !== void 0 ? documentationLink : 'https://www.remotion.dev/docs/sequence';
     const isInsideSeries = (0, react_1.useContext)(is_inside_series_js_1.IsInsideSeriesContext);
-    // Our assumption: Stack doesnt' change. After we symbolicate we assign it a nodePath
-    // and if it changes, it would lead to-remounting of the sequence.
-    const stackRef = (0, react_1.useRef)(null);
-    stackRef.current = controls
-        ? ((_e = (_d = (0, enable_sequence_stack_traces_js_1.getStackForControls)(controls)) !== null && _d !== void 0 ? _d : stack) !== null && _e !== void 0 ? _e : null)
+    const singleChildComponent = (0, react_1.useMemo)(() => childComponentOverride === undefined
+        ? (0, component_identity_js_1.getSingleChildComponent)(children)
+        : childComponentOverride, [children, childComponentOverride]);
+    const registrationStack = controls
+        ? ((_f = (_e = (0, enable_sequence_stack_traces_js_1.getStackForControls)(controls)) !== null && _e !== void 0 ? _e : stack) !== null && _f !== void 0 ? _f : null)
         : (stack !== null && stack !== void 0 ? stack : null);
-    const getStack = (0, react_1.useCallback)(() => stackRef.current, []);
+    const getStack = (0, react_1.useCallback)(() => registrationStack, [registrationStack]);
     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);
@@ -269,7 +281,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     }, [currentFrame]);
     const getCurrentFrame = (0, react_1.useCallback)(() => currentFrameRef.current, []);
     const registeredTrimBefore = trimBefore === 0 ? null : trimBefore;
-    const parentCumulatedNegativeFrom = (_f = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _f !== void 0 ? _f : 0;
+    const parentCumulatedNegativeFrom = (_g = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _g !== void 0 ? _g : 0;
     const startMediaFrom = isMedia && isMedia.type !== 'image'
         ? isMedia.data.startMediaFrom +
             parentCumulatedNegativeFrom -
@@ -350,6 +362,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 timelineTrack: {
                     ...timelineTrack,
                     role: timelineTrackRole,
+                    seriesOffset,
                 },
             }
             : {};
@@ -392,7 +405,6 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 effectRuntimeValues,
                 displayName: timelineClipName,
                 documentationLink: resolvedDocumentationLink,
-                doesVolumeChange: isMedia.data.doesVolumeChange,
                 duration: actualDurationInFrames,
                 from,
                 trimBefore: registeredTrimBefore,
@@ -409,7 +421,6 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 getCurrentFrame,
                 startMediaFrom: startMediaFrom !== null && startMediaFrom !== void 0 ? startMediaFrom : isMedia.data.startMediaFrom,
                 mediaFrameAtSequenceZero,
-                volume: isMedia.data.volumes,
                 muted: isMedia.data.muted,
                 refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
                 isInsideSeries,
@@ -451,6 +462,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         id,
         timelineTrack,
         timelineTrackRole,
+        seriesOffset,
         getCurrentFrame,
         getStack,
         timelineClipName,
@@ -480,7 +492,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         frozenMediaFrame,
         singleChildComponent,
     ]);
-    (0, use_sequence_registration_js_1.useSequenceRegistration)({
+    const registration = (0, use_sequence_registration_js_1.useSequenceRegistration)({
         getSequence: env.isStudio || sequenceRegistrationEnabled
             ? getSequenceForRegistration
             : null,
@@ -495,11 +507,24 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         parentPlaybackRate,
         durationInFrames: effectiveDurationInFrames,
     });
-    const content = !seriesContentVisible || frameInParent - from < -boundaryTolerance
-        ? null
-        : frameInParent - endThreshold >= -boundaryTolerance
-            ? null
-            : children;
+    const contentVisible = seriesContentVisible &&
+        frameInParent - from >= -boundaryTolerance &&
+        frameInParent - endThreshold < -boundaryTolerance;
+    const activityDormant = parentDormant || !contentVisible;
+    const admitted = (0, SequenceActivityBudget_js_1.useSequenceActivityAdmission)(activityEnabled && !hidden
+        ? {
+            id,
+            parent: (_h = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.id) !== null && _h !== void 0 ? _h : null,
+            compositionId: videoConfig.id,
+            from: firstFrame,
+            end: cumulatedFrom +
+                (from + actualDurationInFrames) / parentPlaybackRate,
+        }
+        : null);
+    const renderActivity = activityEnabled && (!activityDormant || admitted);
+    const content = (activityEnabled ? renderActivity : contentVisible)
+        ? children
+        : null;
     const frozenContent = content === null || typeof freeze === 'undefined' || freeze === null ? (content) : (jsx_runtime_1.jsx(freeze_js_1.Freeze, { frame: freeze, children: content }));
     const loopedContent = frozenContent === null || loopContextValue === null ? (frozenContent) : (jsx_runtime_1.jsx(loop_context_js_1.LoopContext.Provider, { value: loopContextValue, children: frozenContent }));
     const styleIfThere = other.layout === 'none' ? undefined : other.style;
@@ -535,20 +560,30 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     if (ref !== null && layout === 'none') {
         throw new TypeError('It is not supported to pass both a `ref` and `layout="none"` to <Sequence />.');
     }
+    const metadata = (0, react_1.useMemo)(() => shouldDiscoverOutline || registration !== null
+        ? {
+            type: 'sequence',
+            id,
+            value: registration,
+            outlineChildrenRef: automaticOutlineRef,
+        }
+        : null, [automaticOutlineRef, id, registration, shouldDiscoverOutline]);
     if (hidden) {
-        return shouldDiscoverOutline ? (jsx_runtime_1.jsx(sequence_order_marker_js_1.SequenceOrderMarker, { sequenceId: id, outlineChildrenRef: automaticOutlineRef, children: null })) : null;
+        return shouldDiscoverOutline || registration !== null ? (jsx_runtime_1.jsx(SequenceContextProvider, { value: contextValue, _remotionCommitMetadata: metadata, children: null })) : null;
     }
     // 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) }));
+    const contentForLayout = renderActivity ? (jsx_runtime_1.jsx(SequenceActivityBoundary_js_1.SequenceActivityContent, { dormant: activityDormant, children: loopedContent })) : (loopedContent);
+    const renderedContent = loopedContent === null ? (retainSeriesRegistration ? (children) : null) : other.layout === 'none' ? (contentForLayout) : (jsx_runtime_1.jsx(AbsoluteFillElement_js_1.AbsoluteFillElement, { ref: sequenceRef, style: defaultStyle, className: other.className, children: contentForLayout }));
+    const activityContent = renderActivity ? (jsx_runtime_1.jsx(SequenceActivityBoundary_js_1.SequenceActivityBoundary, { dormant: activityDormant, frame: firstFrame, children: renderedContent })) : (renderedContent);
+    const sequenceContent = (jsx_runtime_1.jsx(SequenceContextProvider, { value: contextValue, _remotionCommitMetadata: metadata, children: retainSeriesRegistration ? (jsx_runtime_1.jsx(SeriesContentVisibilityContext.Provider, { value: renderActivity || contentVisible, children: activityContent })) : (activityContent) }));
     // 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);
+    return sequence;
 };
 const RegularSequence = (0, react_1.forwardRef)(RegularSequenceRefForwardingFunction);
 const PremountedPostmountedSequenceRefForwardingFunction = (props, ref) => {
@@ -570,17 +605,16 @@ const PremountedPostmountedSequenceRefForwardingFunction = (props, ref) => {
         styleWhilePostmounted: styleWhilePostmounted !== null && styleWhilePostmounted !== void 0 ? styleWhilePostmounted : null,
         hideWhilePremounted: 'opacity',
     });
-    return (jsx_runtime_1.jsx(freeze_js_1.Freeze, { frame: freezeFrame, active: isPremountingOrPostmounting, _remotionInternalIsPremounting: premountingActive, children: jsx_runtime_1.jsx(SequenceInner, { ref: ref, from: from, durationInFrames: durationInFrames, style: premountingStyle !== null && premountingStyle !== void 0 ? premountingStyle : undefined, _remotionInternalPremountDisplay: premountFor, _remotionInternalPostmountDisplay: postmountFor, _remotionInternalIsPremounting: premountingActive, _remotionInternalIsPostmounting: postmountingActive, ...otherProps }) }));
+    return (jsx_runtime_1.jsx(freeze_js_1.Freeze, { frame: freezeFrame, active: isPremountingOrPostmounting, _remotionInternalIsPremounting: premountingActive, children: jsx_runtime_1.jsx(RegularSequence, { ref: ref, from: from, durationInFrames: durationInFrames, style: premountingStyle !== null && premountingStyle !== void 0 ? premountingStyle : undefined, _remotionInternalPremountDisplay: premountFor, _remotionInternalPostmountDisplay: postmountFor, _remotionInternalIsPremounting: premountingActive, _remotionInternalIsPostmounting: postmountingActive, ...otherProps }) }));
 };
 const PremountedPostmountedSequence = (0, react_1.forwardRef)(PremountedPostmountedSequenceRefForwardingFunction);
 const SequenceRefForwardingFunction = (props, ref) => {
     var _a;
     const env = (0, use_remotion_environment_js_1.useRemotionEnvironment)();
     const { fps } = (0, use_video_config_js_1.useVideoConfig)();
+    const defaultPremountInSeconds = (0, react_1.useContext)(DefaultPremountContext_js_1.DefaultPremountContext);
     if (props.layout !== 'none' && !env.isRendering) {
-        const effectivePremountFor = v5_flag_js_1.ENABLE_V5_BREAKING_CHANGES
-            ? ((_a = props.premountFor) !== null && _a !== void 0 ? _a : fps)
-            : props.premountFor;
+        const effectivePremountFor = (_a = props.premountFor) !== null && _a !== void 0 ? _a : Math.round(defaultPremountInSeconds * fps);
         if (effectivePremountFor || props.postmountFor) {
             return (jsx_runtime_1.jsx(PremountedPostmountedSequence, { ref: ref, ...props, premountFor: effectivePremountFor }));
         }

package/dist/cjs/SequenceActivityBoundary.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export declare const SequenceActivityContent: React.NamedExoticComponent<{
+    readonly children: React.ReactNode;
+    readonly dormant: boolean;
+}>;
+export declare const SequenceActivityBoundary: React.FC<{
+    readonly children: React.ReactNode;
+    readonly dormant: boolean;
+    readonly frame: number;
+}>;

package/dist/cjs/SequenceActivityBoundary.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequenceActivityBoundary = exports.SequenceActivityContent = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const sequence_activity_context_js_1 = require("./sequence-activity-context.js");
+const TimelineContext_js_1 = require("./TimelineContext.js");
+const use_video_config_js_1 = require("./use-video-config.js");
+const areActivityChildrenEqual = (previous, next) => {
+    if (Object.is(previous, next)) {
+        return true;
+    }
+    if (Array.isArray(previous) && Array.isArray(next)) {
+        return (previous.length === next.length &&
+            previous.every((child, index) => areActivityChildrenEqual(child, next[index])));
+    }
+    if (!react_1.default.isValidElement(previous) ||
+        !react_1.default.isValidElement(next) ||
+        previous.type !== next.type ||
+        previous.key !== next.key) {
+        return false;
+    }
+    const keys = Object.keys(previous.props);
+    return (keys.length === Object.keys(next.props).length &&
+        keys.every((key) => Object.prototype.hasOwnProperty.call(next.props, key) &&
+            (key === 'children'
+                ? areActivityChildrenEqual(previous.props.children, next.props.children)
+                : Object.is(previous.props[key], next.props[key]))));
+};
+// Parent frame subscriptions often recreate unchanged JSX. Compare element
+// structure and all props instead of ignoring changes to dormant scene props.
+exports.SequenceActivityContent = react_1.default.memo(({ children }) => children, (previous, next) => previous.dormant &&
+    next.dormant &&
+    areActivityChildrenEqual(previous.children, next.children));
+const SequenceActivityBoundary = ({ children, dormant, frame }) => {
+    const parentDormant = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityDormantContext);
+    const timeline = (0, react_1.useContext)(parentDormant ? sequence_activity_context_js_1.SequenceActivityTimelineContext : TimelineContext_js_1.TimelineContext);
+    const absoluteTime = (0, react_1.useContext)(parentDormant ? sequence_activity_context_js_1.SequenceActivityAbsoluteTimeContext : TimelineContext_js_1.AbsoluteTimeContext);
+    const { id } = (0, use_video_config_js_1.useVideoConfig)();
+    if (timeline === null) {
+        throw new Error('TimelineContext is missing');
+    }
+    const { audioAndVideoTags } = timeline;
+    const dormantTimeline = (0, react_1.useMemo)(() => ({
+        frame: { [id]: frame },
+        isPlaying: () => false,
+        isInsideFreeze: true,
+        audioAndVideoTags,
+    }), [audioAndVideoTags, frame, id]);
+    // Keep the providers and Activity at the same position when activating a
+    // scene. Unlike Freeze, discovery does not reset SequenceContext origins or
+    // disable Series duration inference.
+    return (jsx_runtime_1.jsx(sequence_activity_context_js_1.SequenceActivityDormantContext.Provider, { value: dormant, children: jsx_runtime_1.jsx(sequence_activity_context_js_1.SequenceActivityTimelineContext.Provider, { value: dormant ? dormantTimeline : null, children: jsx_runtime_1.jsx(sequence_activity_context_js_1.SequenceActivityAbsoluteTimeContext.Provider, { value: dormant ? dormantTimeline : null, children: jsx_runtime_1.jsx(TimelineContext_js_1.TimelineContext.Provider, { value: dormant ? dormantTimeline : timeline, children: jsx_runtime_1.jsx(TimelineContext_js_1.AbsoluteTimeContext.Provider, { value: dormant ? dormantTimeline : absoluteTime, children: jsx_runtime_1.jsx(react_1.default.Activity, { mode: dormant && !parentDormant ? 'hidden' : 'visible', children: children }) }) }) }) }) }));
+};
+exports.SequenceActivityBoundary = SequenceActivityBoundary;

package/dist/cjs/SequenceActivityBudget.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+type ActivityCandidate = {
+    readonly id: string;
+    readonly parent: string | null;
+    readonly compositionId: string;
+    readonly from: number;
+    readonly end: number;
+};
+export declare const SequenceActivityBudgetProvider: React.FC<{
+    readonly children: React.ReactNode;
+}>;
+export declare const useSequenceActivityAdmission: (candidate: ActivityCandidate | null) => boolean;
+export {};

package/dist/cjs/SequenceActivityBudget.js

@@ -0,0 +1,181 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSequenceActivityAdmission = exports.SequenceActivityBudgetProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const registry_store_js_1 = require("./registry-store.js");
+const sequence_activity_context_js_1 = require("./sequence-activity-context.js");
+const TimelineContext_js_1 = require("./TimelineContext.js");
+const use_sync_external_store_js_1 = require("./use-sync-external-store.js");
+// Count nested dormant content too: one admitted scene must not be able to
+// recursively mount another thousand expensive scenes behind its Activity.
+const useCommitEffect = (_a = react_1.default.useInsertionEffect) !== null && _a !== void 0 ? _a : react_1.default.useLayoutEffect;
+const createActivityBudget = () => {
+    const registry = (0, registry_store_js_1.createRegistryStore)(new Set());
+    const candidates = new Map();
+    let frame = {};
+    let limit = sequence_activity_context_js_1.DEFAULT_SEQUENCE_ACTIVITY_LIMIT;
+    let scheduled = false;
+    const schedule = () => {
+        if (scheduled) {
+            return;
+        }
+        scheduled = true;
+        // Insertion effects run in hidden Activities too. Publish only after the
+        // whole commit, once all candidates and the root playhead are current.
+        queueMicrotask(() => {
+            scheduled = false;
+            const ranked = [...candidates.values()]
+                .filter((candidate) => candidate.end > candidate.from)
+                .map((candidate) => {
+                var _a;
+                const currentFrame = (_a = frame[candidate.compositionId]) !== null && _a !== void 0 ? _a : 0;
+                return {
+                    candidate,
+                    distance: Math.max(0, candidate.from - currentFrame, currentFrame - candidate.end),
+                };
+            })
+                .sort((a, b) => a.distance - b.distance);
+            const selected = new Set();
+            for (const { candidate } of ranked) {
+                const ancestors = [];
+                let ancestor = candidate;
+                while (ancestor && !selected.has(ancestor.id)) {
+                    ancestors.push(ancestor.id);
+                    if (selected.size + ancestors.length > limit) {
+                        break;
+                    }
+                    ancestor =
+                        ancestor.parent === null
+                            ? undefined
+                            : candidates.get(ancestor.parent);
+                }
+                if (selected.size + ancestors.length > limit) {
+                    continue;
+                }
+                for (const id of ancestors) {
+                    selected.add(id);
+                }
+                if (selected.size === limit) {
+                    break;
+                }
+            }
+            // Reserve nearby visible trees too, so becoming dormant retains their
+            // state immediately. All other visible trees bypass admission. Reserved
+            // IDs bound dormant content, including during a large seek.
+            registry.setSnapshot((previous) => previous.size === selected.size &&
+                [...previous].every((id) => selected.has(id))
+                ? previous
+                : selected);
+        });
+    };
+    return {
+        ...registry,
+        setLimit: (next) => {
+            if (limit !== next) {
+                limit = next;
+                schedule();
+            }
+        },
+        setFrame: (next) => {
+            frame = next;
+            schedule();
+        },
+        register: (candidate) => {
+            candidates.set(candidate.id, candidate);
+            schedule();
+            return () => {
+                candidates.delete(candidate.id);
+                schedule();
+            };
+        },
+    };
+};
+const ActivityBudgetContext = (0, react_1.createContext)(null);
+const InactiveTimelineContext = (0, react_1.createContext)(null);
+const emptySelection = new Set();
+const ActivitySelectionContext = (0, react_1.createContext)(emptySelection);
+const SequenceActivityBudgetProvider = ({ children }) => {
+    var _a;
+    const enabled = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityContext);
+    const settings = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivitySettingsContext);
+    const limit = (_a = settings === null || settings === void 0 ? void 0 : settings.limit) !== null && _a !== void 0 ? _a : sequence_activity_context_js_1.DEFAULT_SEQUENCE_ACTIVITY_LIMIT;
+    const admitting = enabled && limit > 0;
+    const [budget] = (0, react_1.useState)(createActivityBudget);
+    const timeline = (0, react_1.useContext)(admitting ? TimelineContext_js_1.TimelineContext : InactiveTimelineContext);
+    const selected = (0, use_sync_external_store_js_1.useSyncExternalStore)(budget.subscribe, budget.getSnapshot, budget.getSnapshot);
+    // Shrinking the setting must not keep the old, larger selection for a commit
+    // while the budget schedules its new snapshot.
+    const admitted = (0, react_1.useMemo)(() => !admitting
+        ? emptySelection
+        : selected.size > limit
+            ? new Set([...selected].slice(0, limit))
+            : selected, [admitting, limit, selected]);
+    useCommitEffect(() => {
+        budget.setLimit(admitting ? limit : 0);
+        if (admitting && timeline !== null) {
+            budget.setFrame(timeline.frame);
+        }
+    }, [admitting, budget, limit, timeline]);
+    return (jsx_runtime_1.jsx(ActivityBudgetContext.Provider, { value: admitting ? budget : null, children: jsx_runtime_1.jsx(ActivitySelectionContext.Provider, { value: admitted, children: children }) }));
+};
+exports.SequenceActivityBudgetProvider = SequenceActivityBudgetProvider;
+const useSequenceActivityAdmission = (candidate) => {
+    var _a, _b, _c, _d, _e;
+    const budget = (0, react_1.useContext)(ActivityBudgetContext);
+    const enabled = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityContext);
+    const settings = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivitySettingsContext);
+    const unlimited = enabled && (settings === null || settings === void 0 ? void 0 : settings.limit) === -1;
+    const selected = (0, react_1.useContext)(ActivitySelectionContext);
+    const id = (_a = candidate === null || candidate === void 0 ? void 0 : candidate.id) !== null && _a !== void 0 ? _a : null;
+    const parent = (_b = candidate === null || candidate === void 0 ? void 0 : candidate.parent) !== null && _b !== void 0 ? _b : null;
+    const compositionId = (_c = candidate === null || candidate === void 0 ? void 0 : candidate.compositionId) !== null && _c !== void 0 ? _c : null;
+    const from = (_d = candidate === null || candidate === void 0 ? void 0 : candidate.from) !== null && _d !== void 0 ? _d : null;
+    const end = (_e = candidate === null || candidate === void 0 ? void 0 : candidate.end) !== null && _e !== void 0 ? _e : null;
+    const committedCandidate = (0, react_1.useMemo)(() => id !== null && compositionId !== null && from !== null && end !== null
+        ? { id, parent, compositionId, from, end }
+        : null, [id, parent, compositionId, from, end]);
+    useCommitEffect(() => {
+        if (budget !== null && committedCandidate !== null) {
+            return budget.register(committedCandidate);
+        }
+    }, [budget, committedCandidate]);
+    // Unlimited discovery admits children on their first render, without waiting
+    // for their registration and a subsequent budget publication.
+    return id !== null && (unlimited || selected.has(id));
+};
+exports.useSequenceActivityAdmission = useSequenceActivityAdmission;

package/dist/cjs/SequenceManager.d.ts

@@ -1,28 +1,9 @@
 import React from 'react';
-import type { TSequence } from './CompositionManager.js';
+export * from './sequence-registry-context.js';
+import { type SequenceManagerActions, type SequenceNodePath } from './sequence-registry-context.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;
-    updateSequence: ((seq: TSequence) => void) | null;
-    unregisterSequence: (id: string) => void;
-    sequences: TSequence[];
-};
-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>;
-export declare const DisableSequenceRegistrationProvider: React.FC<{
-    readonly children: React.ReactNode;
-}>;
 export type VisualModePropStatuses = {
     propStatuses: PropStatuses;
 };
@@ -96,9 +77,10 @@ export declare const makeSequencePropsSubscriptionKey: (key: SequencePropsSubscr
 export declare const VisualModePropStatusesContext: React.Context<VisualModePropStatuses>;
 export declare const VisualModePropStatusesRefContext: React.Context<VisualModePropStatusesRef>;
 export declare const VisualModeDragOverridesContext: React.Context<VisualModeDragOverrides>;
+export declare const VisualModeDragOverridesRefContext: React.Context<React.RefObject<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 useEffectDragOverridesForNodePath: (nodePath: SequencePropsSubscriptionKey | null) => Record<string, Record<string, DragOverrideValue>>;
 export declare const VisualModeSettersContext: React.Context<VisualModeSetters>;
 export declare const VisualModeBatchSettersContext: React.Context<VisualModeBatchSetters | null>;
 export type SequencePropsSubscriptionKey = {