remotion 4.0.533 → 4.0.535

package/dist/cjs/RemotionRoot.js

@@ -11,11 +11,12 @@ const prefetch_state_js_1 = require("./prefetch-state.js");
 const SequenceManager_js_1 = require("./SequenceManager.js");
 const TimelineContext_js_1 = require("./TimelineContext.js");
 const use_media_enabled_js_1 = require("./use-media-enabled.js");
+const use_video_js_1 = require("./use-video.js");
 const duration_state_js_1 = require("./video/duration-state.js");
 const RemotionRootContexts = ({ children, numberOfAudioTags, logLevel, audioLatencyHint, previewSampleRate, videoEnabled, audioEnabled, frameState, _experimentalKeepAudioContextAlive, }) => {
     const logging = (0, react_1.useMemo)(() => {
         return { logLevel, mountTime: Date.now() };
     }, [logLevel]);
-    return (jsx_runtime_1.jsx(log_level_context_js_1.LogLevelContext.Provider, { value: logging, children: jsx_runtime_1.jsx(TimelineContext_js_1.TimelineContextProvider, { frameState: frameState, children: jsx_runtime_1.jsx(use_media_enabled_js_1.MediaEnabledProvider, { videoEnabled: videoEnabled, audioEnabled: audioEnabled, children: jsx_runtime_1.jsx(EditorProps_js_1.EditorPropsProvider, { children: jsx_runtime_1.jsx(prefetch_state_js_1.PrefetchProvider, { children: jsx_runtime_1.jsx(SequenceManager_js_1.SequenceManagerProvider, { children: jsx_runtime_1.jsx(duration_state_js_1.DurationsContextProvider, { children: jsx_runtime_1.jsx(buffering_js_1.BufferingProvider, { children: jsx_runtime_1.jsx(shared_audio_tags_js_1.SharedAudioContextProvider, { audioLatencyHint: audioLatencyHint, audioEnabled: audioEnabled, previewSampleRate: previewSampleRate, _experimentalKeepAudioContextAlive: _experimentalKeepAudioContextAlive, children: jsx_runtime_1.jsx(shared_audio_tags_js_1.SharedAudioTagsContextProvider, { numberOfAudioTags: numberOfAudioTags, children: children }) }) }) }) }) }) }) }) }) }));
+    return (jsx_runtime_1.jsx(log_level_context_js_1.LogLevelContext.Provider, { value: logging, children: jsx_runtime_1.jsx(TimelineContext_js_1.TimelineContextProvider, { frameState: frameState, children: jsx_runtime_1.jsx(use_media_enabled_js_1.MediaEnabledProvider, { videoEnabled: videoEnabled, audioEnabled: audioEnabled, children: jsx_runtime_1.jsx(EditorProps_js_1.EditorPropsProvider, { children: jsx_runtime_1.jsx(prefetch_state_js_1.PrefetchProvider, { children: jsx_runtime_1.jsx(SequenceManager_js_1.SequenceManagerProvider, { children: jsx_runtime_1.jsx(duration_state_js_1.DurationsContextProvider, { children: jsx_runtime_1.jsx(buffering_js_1.BufferingProvider, { children: jsx_runtime_1.jsx(shared_audio_tags_js_1.SharedAudioContextProvider, { audioLatencyHint: audioLatencyHint, audioEnabled: audioEnabled, previewSampleRate: previewSampleRate, _experimentalKeepAudioContextAlive: _experimentalKeepAudioContextAlive, children: jsx_runtime_1.jsx(shared_audio_tags_js_1.SharedAudioTagsContextProvider, { numberOfAudioTags: numberOfAudioTags, children: jsx_runtime_1.jsx(use_video_js_1.VideoProvider, { children: children }) }) }) }) }) }) }) }) }) }) }));
 };
 exports.RemotionRootContexts = RemotionRootContexts;

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' | 'seriesOffset'>;
     /**
      * @deprecated For internal use only.
      */
@@ -75,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,36 +2,48 @@
 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");
 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 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, _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, _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 parentPlaybackRate = (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.playbackRate) !== null && _a !== void 0 ? _a : 1;
+    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 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
@@ -107,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,
@@ -127,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
@@ -141,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 = ((_b = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.absoluteFrom) !== null && _b !== void 0 ? _b : 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
@@ -151,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) ||
@@ -251,15 +266,22 @@ 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
-        ? ((_d = (_c = (0, enable_sequence_stack_traces_js_1.getStackForControls)(controls)) !== null && _c !== void 0 ? _c : stack) !== null && _d !== void 0 ? _d : 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)(() => 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);
+    (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 = (_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 -
@@ -335,9 +357,19 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
     ]);
     const getSequenceForRegistration = (0, react_1.useCallback)(() => {
         var _a, _b, _c;
+        const trackRegistration = timelineTrack
+            ? {
+                timelineTrack: {
+                    ...timelineTrack,
+                    role: timelineTrackRole,
+                    seriesOffset,
+                },
+            }
+            : {};
         if (isMedia) {
             if (isMedia.type === 'image') {
                 return {
+                    ...trackRegistration,
                     sequencePlaybackRate: playbackRate,
                     type: 'image',
                     controls: registrationControls,
@@ -356,7 +388,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,
@@ -364,6 +397,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 };
             }
             return {
+                ...trackRegistration,
                 type: isMedia.type,
                 sequencePlaybackRate: playbackRate,
                 controls: registrationControls,
@@ -371,7 +405,6 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
                 effectRuntimeValues,
                 displayName: timelineClipName,
                 documentationLink: resolvedDocumentationLink,
-                doesVolumeChange: isMedia.data.doesVolumeChange,
                 duration: actualDurationInFrames,
                 from,
                 trimBefore: registeredTrimBefore,
@@ -384,10 +417,10 @@ 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,
                 muted: isMedia.data.muted,
                 refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
                 isInsideSeries,
@@ -397,6 +430,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
             };
         }
         return {
+            ...trackRegistration,
             from,
             sequencePlaybackRate: playbackRate,
             trimBefore: registeredTrimBefore,
@@ -412,7 +446,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,
@@ -425,6 +460,11 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, trimBefore = 0, playba
         };
     }, [
         id,
+        timelineTrack,
+        timelineTrackRole,
+        seriesOffset,
+        getCurrentFrame,
+        getStack,
         timelineClipName,
         playbackRate,
         parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.id,
@@ -452,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,
@@ -467,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;
@@ -507,15 +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 sequenceContent = 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 sequence = (jsx_runtime_1.jsx(SequenceContext_js_1.SequenceContext.Provider, { value: contextValue, children: retainSeriesRegistration ? (jsx_runtime_1.jsx(SeriesContentVisibilityContext.Provider, { value: content !== null, children: sequenceContent })) : (sequenceContent) }));
-    return shouldDiscoverOutline ? (jsx_runtime_1.jsx(sequence_order_marker_js_1.SequenceOrderMarker, { sequenceId: id, outlineChildrenRef: automaticOutlineRef, children: sequence })) : (sequence);
+    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 sequence;
 };
 const RegularSequence = (0, react_1.forwardRef)(RegularSequenceRefForwardingFunction);
 const PremountedPostmountedSequenceRefForwardingFunction = (props, ref) => {
@@ -537,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 {};