remotion 4.0.533 → 4.0.535

package/dist/cjs/effects/run-effect-chain.js

@@ -105,9 +105,9 @@ const runEffectChain = async ({ state, source, effects, output, width, height, }
     let flipWebGLSourceY = true;
     for (let runIndex = 0; runIndex < runs.length; runIndex++) {
         const run = runs[runIndex];
-        const [a, b] = state.pool.getPair(run.backend);
-        let dst = a;
+        let canvasIndex = 0;
         for (const eff of run.effects) {
+            const dst = state.pool.getCanvas(run.backend, canvasIndex);
             const def = eff.definition;
             if (run.backend === 'webgl2') {
                 // Checked before `setup()`: a lost context cannot compile shaders,
@@ -132,7 +132,7 @@ const runEffectChain = async ({ state, source, effects, output, width, height, }
                 flipWebGLSourceY = true;
             }
             currentImage = dst;
-            dst = dst === a ? b : a;
+            canvasIndex = canvasIndex === 0 ? 1 : 0;
         }
         lastTarget = (_a = currentImage) !== null && _a !== void 0 ? _a : lastTarget;
         const nextRun = runs[runIndex + 1];

package/dist/cjs/effects/use-memoized-effects.d.ts

@@ -2,6 +2,7 @@ import type { RuntimeValueStore } from '../runtime-value-store.js';
 import type { CannotUpdateEffectReason, CannotUpdateSequenceReason } from '../SequenceManager.js';
 import { type SequencePropsSubscriptionKey } from '../SequenceManager.js';
 import { type CanUpdateSequencePropStatus, type PropStatuses } from '../use-schema.js';
+import type { VideoConfigValues } from '../video-config.js';
 import type { EffectDefinitionAndStack, EffectDescriptor, EffectDefinition } from './effect-types.js';
 export declare const useMemoizedEffectDefinitions: (effects: readonly EffectDescriptor<unknown>[]) => readonly EffectDefinition<unknown>[] & {
     readonly runtimeValues: readonly RuntimeValueStore[];
@@ -23,8 +24,9 @@ export declare const getEffectPropStatusesCtx: ({ propStatuses, nodePath, effect
 }) => EffectStatus;
 export declare const getPropStatusesCtx: (propStatuses: PropStatuses, nodePath: SequencePropsSubscriptionKey) => Record<string, CanUpdateSequencePropStatus> | undefined;
 export type GetPropStatusesType = typeof getPropStatusesCtx;
-export declare const useMemoizedEffects: ({ effects, overrideId, }: {
+export declare const useMemoizedEffects: ({ effects, overrideId, videoConfigValues, }: {
     effects: readonly EffectDescriptor<unknown>[];
     readonly overrideId: string | null;
+    videoConfigValues: VideoConfigValues | null;
 }) => EffectDefinitionAndStack<unknown>[];
 export {};

package/dist/cjs/effects/use-memoized-effects.js

@@ -1,14 +1,51 @@
 "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.useMemoizedEffects = exports.getPropStatusesCtx = exports.getEffectPropStatusesCtx = exports.useMemoizedEffectDefinitions = void 0;
-const react_1 = require("react");
+const react_1 = __importStar(require("react"));
+const evaluate_source_expressions_js_1 = require("../evaluate-source-expressions.js");
 const get_effective_visual_mode_value_js_1 = require("../get-effective-visual-mode-value.js");
 const interpolate_keyframed_status_js_1 = require("../interpolate-keyframed-status.js");
 const runtime_value_store_js_1 = require("../runtime-value-store.js");
+const sequence_activity_context_js_1 = require("../sequence-activity-context.js");
 const sequence_node_path_js_1 = require("../sequence-node-path.js");
 const SequenceManager_js_1 = require("../SequenceManager.js");
 const use_current_frame_js_1 = require("../use-current-frame.js");
 const emptyDragOverrides = {};
+const useCacheCommitEffect = (_a = react_1.default.useInsertionEffect) !== null && _a !== void 0 ? _a : react_1.useLayoutEffect;
 const mergeOverrides = ({ descriptor, propStatusOverrides, dragOverrides, frame, }) => {
     if (!propStatusOverrides && !dragOverrides) {
         return { params: descriptor.params, effectKey: descriptor.effectKey };
@@ -66,6 +103,7 @@ const resolvePropStatusOverrides = (propStatus, frame) => {
     return hasAny ? out : null;
 };
 const useMemoizedEffectDefinitions = (effects) => {
+    const activityDormant = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityDormantContext);
     const previousRef = (0, react_1.useRef)(null);
     const definitions = effects.map((descriptor) => descriptor.definition);
     const previous = previousRef.current;
@@ -75,7 +113,51 @@ const useMemoizedEffectDefinitions = (effects) => {
     const controllers = isSame
         ? previous.controllers
         : effects.map((effect) => (0, runtime_value_store_js_1.createRuntimeValueStore)(effect.params));
-    const stableDefinitions = isSame ? previous.definitions : definitions;
+    const stableDefinitions = isSame
+        ? previous.definitions
+        : Object.assign(definitions, {
+            runtimeValues: controllers.map((controller) => controller.store),
+        });
+    useCacheCommitEffect(() => {
+        // Insertion effects also run for hidden Activity commits. Store listeners
+        // must run after React finishes committing, never inside an insertion effect.
+        previousRef.current = { definitions: stableDefinitions, controllers };
+        if (!activityDormant || controllers.length === 0) {
+            return;
+        }
+        let cancelled = false;
+        queueMicrotask(() => {
+            if (cancelled) {
+                return;
+            }
+            controllers.forEach((controller, index) => {
+                var _a;
+                const snapshot = (_a = effects[index]) === null || _a === void 0 ? void 0 : _a.params;
+                const currentSnapshot = controller.store.getSnapshot();
+                if (Object.is(snapshot, currentSnapshot)) {
+                    return;
+                }
+                // Equivalent inline params should not notify inspector subscribers on
+                // every dormant render. Preserve changes to keys and leaf references.
+                if (snapshot !== null &&
+                    currentSnapshot !== null &&
+                    typeof snapshot === 'object' &&
+                    typeof currentSnapshot === 'object') {
+                    const keys = Object.keys(snapshot);
+                    if (keys.length === Object.keys(currentSnapshot).length &&
+                        keys.every((key) => Object.prototype.hasOwnProperty.call(currentSnapshot, key) &&
+                            Object.is(snapshot[key], currentSnapshot[key]))) {
+                        return;
+                    }
+                }
+                controller.setSnapshot(snapshot);
+            });
+        });
+        return () => {
+            // A newer commit or unmount supersedes this pending publication.
+            cancelled = true;
+        };
+    }, [activityDormant, controllers, effects, stableDefinitions]);
     (0, react_1.useLayoutEffect)(() => {
         // Stores are intentionally updated without changing the registered effect
         // array, so frame-dependent parameters don't re-register the Sequence.
@@ -85,10 +167,7 @@ const useMemoizedEffectDefinitions = (effects) => {
             controllers[index].setSnapshot(snapshot);
         });
     }, [controllers, effects, stableDefinitions]);
-    previousRef.current = { definitions: stableDefinitions, controllers };
-    return Object.assign(stableDefinitions, {
-        runtimeValues: controllers.map((controller) => controller.store),
-    });
+    return stableDefinitions;
 };
 exports.useMemoizedEffectDefinitions = useMemoizedEffectDefinitions;
 const getEffectPropStatusesCtx = ({ propStatuses, nodePath, effectIndex, }) => {
@@ -106,7 +185,10 @@ const getEffectPropStatusesCtx = ({ propStatuses, nodePath, effectIndex, }) => {
     if (!effect.canUpdate) {
         return { type: 'cannot-update-effect', reason: effect.reason };
     }
-    return { type: 'can-update-effect', props: effect.props };
+    return {
+        type: 'can-update-effect',
+        props: (0, evaluate_source_expressions_js_1.evaluateSourcePropStatuses)(effect.props, nodePath.videoConfigValues),
+    };
 };
 exports.getEffectPropStatusesCtx = getEffectPropStatusesCtx;
 const getPropStatusesCtx = (propStatuses, nodePath) => {
@@ -117,10 +199,10 @@ const getPropStatusesCtx = (propStatuses, nodePath) => {
     if (!status.canUpdate) {
         return undefined;
     }
-    return status.props;
+    return (0, evaluate_source_expressions_js_1.evaluateSourcePropStatuses)(status.props, nodePath.videoConfigValues);
 };
 exports.getPropStatusesCtx = getPropStatusesCtx;
-const useMemoizedEffects = ({ effects, overrideId, }) => {
+const useMemoizedEffects = ({ effects, overrideId, videoConfigValues, }) => {
     var _a;
     const previousRef = (0, react_1.useRef)(null);
     const { propStatuses } = (0, react_1.useContext)(SequenceManager_js_1.VisualModePropStatusesContext);
@@ -130,7 +212,7 @@ const useMemoizedEffects = ({ effects, overrideId, }) => {
     const nodePath = overrideId
         ? ((_a = overrideIdToNodePathMappings[overrideId]) !== null && _a !== void 0 ? _a : null)
         : null;
-    const effectDragOverrides = (0, SequenceManager_js_1.useEffectDragOverridesForNodePath)(nodePath, effects.length);
+    const effectDragOverrides = (0, SequenceManager_js_1.useEffectDragOverridesForNodePath)(nodePath);
     const resolved = effects.map((descriptor, index) => {
         var _a;
         if (nodePath === null) {
@@ -142,7 +224,7 @@ const useMemoizedEffects = ({ effects, overrideId, }) => {
         }
         const effectStatus = (0, exports.getEffectPropStatusesCtx)({
             propStatuses,
-            nodePath,
+            nodePath: { ...nodePath, videoConfigValues },
             effectIndex: index,
         });
         const propStatusOverrides = effectStatus.type === 'can-update-effect'
@@ -162,16 +244,17 @@ const useMemoizedEffects = ({ effects, overrideId, }) => {
         previous.length === resolved.length &&
         previous.every((p, i) => p.definition === resolved[i].descriptor.definition &&
             p.effectKey === resolved[i].effectKey);
-    if (isSame) {
-        return previous;
-    }
-    const next = resolved.map(({ descriptor, params, effectKey }) => ({
-        definition: descriptor.definition,
-        effectKey,
-        params,
-        memoized: true,
-    }));
-    previousRef.current = next;
+    const next = isSame
+        ? previous
+        : resolved.map(({ descriptor, params, effectKey }) => ({
+            definition: descriptor.definition,
+            effectKey,
+            params,
+            memoized: true,
+        }));
+    useCacheCommitEffect(() => {
+        previousRef.current = next;
+    }, [next]);
     return next;
 };
 exports.useMemoizedEffects = useMemoizedEffects;

package/dist/cjs/enable-sequence-stack-traces.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import type { SequenceControls } from './CompositionManager.js';
-type ComponentIdentityResolver = (component: unknown) => unknown;
+export declare const setSequenceComponent: (component: unknown) => void;
+export declare const getSequenceComponent: () => unknown;
 export declare const REMOTION_INTERNAL_STACK_PROP = "_remotionInternalStack";
 export type OriginalSourceLocation = {
     fileName: string;
@@ -15,11 +15,5 @@ export declare const makeOriginalSourceStack: ({ fileName, lineNumber, columnNum
 export declare const parseOriginalSourceStack: (stack: string | null) => OriginalSourceLocation | null;
 export declare const getComponentsToAddStacksTo: () => unknown[];
 export declare const addSequenceStackTraces: (component: unknown) => void;
-export declare const setSequenceComponent: (component: unknown) => void;
-export declare const getSequenceComponent: () => unknown;
-export declare const setComponentIdentityResolver: (resolver: ComponentIdentityResolver | null) => void;
-export declare const resolveComponentIdentity: (component: unknown) => unknown;
 export declare const setStackForControls: (controls: SequenceControls, stack: string | undefined) => void;
 export declare const getStackForControls: (controls: SequenceControls) => string | null;
-export declare const getSingleChildComponent: (children: React.ReactNode) => unknown;
-export {};

package/dist/cjs/enable-sequence-stack-traces.js

@@ -1,16 +1,15 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSingleChildComponent = exports.getStackForControls = exports.setStackForControls = exports.resolveComponentIdentity = exports.setComponentIdentityResolver = exports.getSequenceComponent = exports.setSequenceComponent = exports.addSequenceStackTraces = exports.getComponentsToAddStacksTo = exports.parseOriginalSourceStack = exports.makeOriginalSourceStack = exports.REMOTION_INTERNAL_STACK_PROP = void 0;
-const react_1 = __importDefault(require("react"));
+exports.getStackForControls = exports.setStackForControls = exports.addSequenceStackTraces = exports.getComponentsToAddStacksTo = exports.parseOriginalSourceStack = exports.makeOriginalSourceStack = exports.REMOTION_INTERNAL_STACK_PROP = exports.getSequenceComponent = exports.setSequenceComponent = void 0;
 const componentsToAddStacksTo = [];
 let sequenceComponent = null;
+const setSequenceComponent = (component) => {
+    sequenceComponent = component;
+};
+exports.setSequenceComponent = setSequenceComponent;
+const getSequenceComponent = () => sequenceComponent;
+exports.getSequenceComponent = getSequenceComponent;
 const stacksByControls = new WeakMap();
-// Studio installs a resolver that maps refreshed component implementations to
-// the stable family object maintained by React Refresh.
-let componentIdentityResolver = null;
 exports.REMOTION_INTERNAL_STACK_PROP = '_remotionInternalStack';
 // Bundlers that know where a JSX element was written encode its source
 // location as a synthetic stack frame, so consumers can skip symbolication.
@@ -41,21 +40,6 @@ const addSequenceStackTraces = (component) => {
     componentsToAddStacksTo.push(component);
 };
 exports.addSequenceStackTraces = addSequenceStackTraces;
-const setSequenceComponent = (component) => {
-    sequenceComponent = component;
-};
-exports.setSequenceComponent = setSequenceComponent;
-const getSequenceComponent = () => sequenceComponent;
-exports.getSequenceComponent = getSequenceComponent;
-const setComponentIdentityResolver = (resolver) => {
-    componentIdentityResolver = resolver;
-};
-exports.setComponentIdentityResolver = setComponentIdentityResolver;
-const resolveComponentIdentity = (component) => {
-    var _a;
-    return (_a = componentIdentityResolver === null || componentIdentityResolver === void 0 ? void 0 : componentIdentityResolver(component)) !== null && _a !== void 0 ? _a : component;
-};
-exports.resolveComponentIdentity = resolveComponentIdentity;
 const setStackForControls = (controls, stack) => {
     if (stack === undefined) {
         stacksByControls.delete(controls);
@@ -69,18 +53,3 @@ const getStackForControls = (controls) => {
     return (_a = stacksByControls.get(controls)) !== null && _a !== void 0 ? _a : null;
 };
 exports.getStackForControls = getStackForControls;
-const getSingleChildComponent = (children) => {
-    const mountedChildren = react_1.default.Children.toArray(children);
-    if (mountedChildren.length !== 1) {
-        return null;
-    }
-    const child = mountedChildren[0];
-    if (!react_1.default.isValidElement(child)) {
-        return null;
-    }
-    if (typeof child.type !== 'function' && typeof child.type !== 'object') {
-        return null;
-    }
-    return (0, exports.resolveComponentIdentity)(child.type);
-};
-exports.getSingleChildComponent = getSingleChildComponent;

package/dist/cjs/evaluate-source-expressions.d.ts

@@ -0,0 +1,5 @@
+import type { CanUpdateSequencePropSource, CanUpdateSequencePropStatus, SourceNumericValue } from './use-schema.js';
+import type { VideoConfigValues } from './video-config.js';
+export declare const evaluateSourceNumericValue: (expression: SourceNumericValue, config: VideoConfigValues | null) => number;
+/** Resolve at the consumer, never in the shared source subscription cache. */
+export declare const evaluateSourcePropStatuses: (props: Record<string, CanUpdateSequencePropSource>, config: VideoConfigValues | null) => Record<string, CanUpdateSequencePropStatus>;

package/dist/cjs/evaluate-source-expressions.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateSourcePropStatuses = exports.evaluateSourceNumericValue = void 0;
+const evaluateSourceNumericValue = (expression, config) => {
+    var _a;
+    if (typeof expression === 'number') {
+        return expression;
+    }
+    if (expression.type === 'literal') {
+        return expression.value;
+    }
+    if (expression.type === 'binary') {
+        const left = (0, exports.evaluateSourceNumericValue)(expression.left, config);
+        const right = (0, exports.evaluateSourceNumericValue)(expression.right, config);
+        switch (expression.operator) {
+            case '+':
+                return left + right;
+            case '-':
+                return left - right;
+            case '*':
+                return left * right;
+            case '/':
+                return left / right;
+            default:
+                throw new Error('Unknown source expression operator');
+        }
+    }
+    const value = expression.binding.type === 'constant'
+        ? expression.binding.value
+        : ((_a = config === null || config === void 0 ? void 0 : config[expression.binding.field]) !== null && _a !== void 0 ? _a : NaN);
+    if (expression.type === 'video-config-multiplication') {
+        return value * expression.multiplier;
+    }
+    if (expression.type === 'video-config-subtraction') {
+        return value - expression.subtrahend;
+    }
+    return value;
+};
+exports.evaluateSourceNumericValue = evaluateSourceNumericValue;
+const evaluatedProps = new WeakMap();
+/** Resolve at the consumer, never in the shared source subscription cache. */
+const evaluateSourcePropStatuses = (props, config) => {
+    var _a;
+    const configKey = config === null
+        ? ''
+        : `${config.durationInFrames}:${config.fps}:${config.width}:${config.height}`;
+    const cached = (_a = evaluatedProps.get(props)) !== null && _a !== void 0 ? _a : new Map();
+    const existing = cached.get(configKey);
+    if (existing)
+        return existing;
+    const result = Object.fromEntries(Object.entries(props).map(([key, status]) => {
+        var _a;
+        if (status.status === 'computed') {
+            return [key, status];
+        }
+        const adjustment = status.keyframeDisplayOffsetAdjustment === null
+            ? null
+            : (0, exports.evaluateSourceNumericValue)(status.keyframeDisplayOffsetAdjustment, config);
+        const rate = (0, exports.evaluateSourceNumericValue)((_a = status.keyframePlaybackRateAdjustment) !== null && _a !== void 0 ? _a : 1, config);
+        if ((adjustment !== null && !Number.isFinite(adjustment)) ||
+            !Number.isFinite(rate) ||
+            rate <= 0) {
+            return [key, { status: 'computed' }];
+        }
+        const timing = {
+            keyframeDisplayOffsetAdjustment: adjustment,
+            ...(status.keyframePlaybackRateAdjustment === undefined
+                ? {}
+                : { keyframePlaybackRateAdjustment: rate }),
+        };
+        if (status.status === 'static') {
+            const value = status.numericExpression === undefined
+                ? status.codeValue
+                : (0, exports.evaluateSourceNumericValue)(status.numericExpression, config);
+            return [
+                key,
+                status.numericExpression !== undefined && !Number.isFinite(value)
+                    ? { status: 'computed' }
+                    : { ...status, ...timing, codeValue: value },
+            ];
+        }
+        const keyframes = status.keyframes.map((keyframe) => ({
+            ...keyframe,
+            frame: (0, exports.evaluateSourceNumericValue)(keyframe.frame, config),
+        }));
+        if (keyframes.some((keyframe, index) => !Number.isFinite(keyframe.frame) ||
+            (index > 0 && keyframe.frame <= keyframes[index - 1].frame))) {
+            return [key, { status: 'computed' }];
+        }
+        return [key, { ...status, ...timing, keyframes }];
+    }));
+    cached.set(configKey, result);
+    if (cached.size > 8)
+        cached.delete(cached.keys().next().value);
+    evaluatedProps.set(props, cached);
+    return result;
+};
+exports.evaluateSourcePropStatuses = evaluateSourcePropStatuses;

package/dist/cjs/freeze.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Freeze = exports.useIsInsideNonPremountFreeze = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
+const sequence_activity_context_js_1 = require("./sequence-activity-context.js");
 const SequenceContext_js_1 = require("./SequenceContext.js");
 const timeline_position_state_js_1 = require("./timeline-position-state.js");
 const TimelineContext_js_1 = require("./TimelineContext.js");
@@ -40,16 +41,16 @@ const Freeze = ({ frame: frameToFreeze, children, active = true, _remotionIntern
         }
     }, [active, frame]);
     const timelineContext = (0, timeline_position_state_js_1.useTimelineContext)();
+    const activityDormant = (0, react_1.useContext)(sequence_activity_context_js_1.SequenceActivityDormantContext);
     const sequenceContext = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
     const isInsideNonPremountFreeze = (0, exports.useIsInsideNonPremountFreeze)();
     const relativeFrom = (_a = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom) !== null && _a !== void 0 ? _a : 0;
     const playbackRate = (_b = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.playbackRate) !== null && _b !== void 0 ? _b : 1;
-    const timelineValue = (0, react_1.useMemo)(() => {
-        if (!isActive) {
-            return timelineContext;
-        }
+    const { audioAndVideoTags } = timelineContext;
+    // Advancing the outer timeline must not invalidate the frozen clock.
+    const frozenTimelineValue = (0, react_1.useMemo)(() => {
         return {
-            ...timelineContext,
+            audioAndVideoTags,
             isPlaying: () => false,
             isInsideFreeze: true,
             frame: {
@@ -57,8 +58,7 @@ const Freeze = ({ frame: frameToFreeze, children, active = true, _remotionIntern
             },
         };
     }, [
-        isActive,
-        timelineContext,
+        audioAndVideoTags,
         videoConfig.id,
         frameToFreeze,
         relativeFrom,
@@ -76,7 +76,8 @@ const Freeze = ({ frame: frameToFreeze, children, active = true, _remotionIntern
             cumulatedFrom: 0,
         };
     }, [sequenceContext, isActive]);
+    const providedTimeline = isActive ? frozenTimelineValue : timelineContext;
     return (jsx_runtime_1.jsx(NonPremountFreezeContext.Provider, { value: isInsideNonPremountFreeze ||
-            (Boolean(isActive) && !_remotionInternalIsPremounting), children: jsx_runtime_1.jsx(TimelineContext_js_1.TimelineContext.Provider, { value: timelineValue, children: jsx_runtime_1.jsx(SequenceContext_js_1.SequenceContext.Provider, { value: newSequenceContext, children: children }) }) }));
+            (Boolean(isActive) && !_remotionInternalIsPremounting), children: jsx_runtime_1.jsx(TimelineContext_js_1.TimelineContext.Provider, { value: providedTimeline, children: jsx_runtime_1.jsx(sequence_activity_context_js_1.SequenceActivityTimelineContext.Provider, { value: activityDormant ? providedTimeline : null, children: jsx_runtime_1.jsx(SequenceContext_js_1.SequenceContext.Provider, { value: newSequenceContext, children: children }) }) }) }));
 };
 exports.Freeze = Freeze;

package/dist/cjs/index.d.ts

@@ -34,6 +34,7 @@ declare global {
         remotion_calculateComposition: (compId: string) => Promise<VideoConfigWithSerializedProps>;
         remotion_setBundleMode: (bundleMode: BundleState) => void;
         remotion_staticBase: string;
+        remotion_outputsBase: string | null;
         remotion_staticFiles: StaticFile[];
         remotion_publicPath: string;
         remotion_publicFolderExists: string | null;
@@ -145,6 +146,7 @@ export * from './spring/index.js';
 export { staticFile } from './static-file.js';
 export * from './Still.js';
 export type { PlayableMediaTag } from './timeline-position-state.js';
+export { Track, type TrackProps } from './Track.js';
 export { useBufferState } from './use-buffer-state';
 export { useCurrentFrame } from './use-current-frame.js';
 export { CurrentScaleContextType, PreviewSize, PreviewSizeCtx, Translation, useCurrentScale, } from './use-current-scale';
@@ -162,12 +164,10 @@ export { watchStaticFile } from './watch-static-file.js';
 export declare const Experimental: {
     /**
      * @description This is a special component that will cause Remotion to only partially capture the frame of the video.
-     * @see [Documentation](https://www.remotion.dev/docs/clipper)
      */
     Clipper: import("react").FC<{}>;
     /**
      * @description This is a special component, that, when rendered, will skip rendering the frame altogether.
-     * @see [Documentation](https://www.remotion.dev/docs/null)
      */
     Null: import("react").FC<{}>;
     useIsPlayer: () => boolean;

package/dist/cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Config = exports.Experimental = exports.watchStaticFile = exports.MediaPlaybackError = exports.Video = exports.OffthreadVideo = exports.Html5Video = exports.useRemotionEnvironment = exports.usePixelDensity = exports.useDelayRender = exports.useCurrentScale = exports.useCurrentFrame = exports.useBufferState = exports.staticFile = exports.Series = exports.Sequence = exports.registerRoot = exports.prefetch = exports.random = exports.interpolate = exports.assertValidInterpolatePosterizeOption = exports.assertValidInterpolateEasingOption = exports.Loop = exports.interpolateColors = exports.Interactive = exports.Img = exports.getStaticFiles = exports.getRemotionEnvironment = exports.delayRender = exports.continueRender = exports.getInputProps = exports.Composition = exports.CanvasImage = exports.isHtmlInCanvasSupported = exports.HtmlInCanvas = exports.getHtmlInCanvasUnsupportedMessage = exports.HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = exports.Solid = exports.cancelRender = exports.Html5Audio = exports.Audio = exports.Artifact = exports.createEffect = void 0;
+exports.Config = exports.Experimental = exports.watchStaticFile = exports.MediaPlaybackError = exports.Video = exports.OffthreadVideo = exports.Html5Video = exports.useRemotionEnvironment = exports.usePixelDensity = exports.useDelayRender = exports.useCurrentScale = exports.useCurrentFrame = exports.useBufferState = exports.Track = exports.staticFile = exports.Series = exports.Sequence = exports.registerRoot = exports.prefetch = exports.random = exports.interpolate = exports.assertValidInterpolatePosterizeOption = exports.assertValidInterpolateEasingOption = exports.Loop = exports.interpolateColors = exports.Interactive = exports.Img = exports.getStaticFiles = exports.getRemotionEnvironment = exports.delayRender = exports.continueRender = exports.getInputProps = exports.Composition = exports.CanvasImage = exports.isHtmlInCanvasSupported = exports.HtmlInCanvas = exports.getHtmlInCanvasUnsupportedMessage = exports.HTML_IN_CANVAS_UNSUPPORTED_MESSAGE = exports.Solid = exports.cancelRender = exports.Html5Audio = exports.Audio = exports.Artifact = exports.createEffect = void 0;
 require("./_check-rsc.js");
 require("./asset-types.js");
 const Clipper_js_1 = require("./Clipper.js");
@@ -91,6 +91,8 @@ __exportStar(require("./spring/index.js"), exports);
 const static_file_js_1 = require("./static-file.js");
 Object.defineProperty(exports, "staticFile", { enumerable: true, get: function () { return static_file_js_1.staticFile; } });
 __exportStar(require("./Still.js"), exports);
+const Track_js_1 = require("./Track.js");
+Object.defineProperty(exports, "Track", { enumerable: true, get: function () { return Track_js_1.Track; } });
 const use_buffer_state_1 = require("./use-buffer-state");
 Object.defineProperty(exports, "useBufferState", { enumerable: true, get: function () { return use_buffer_state_1.useBufferState; } });
 const use_current_frame_js_1 = require("./use-current-frame.js");
@@ -117,12 +119,10 @@ Object.defineProperty(exports, "watchStaticFile", { enumerable: true, get: funct
 exports.Experimental = {
     /**
      * @description This is a special component that will cause Remotion to only partially capture the frame of the video.
-     * @see [Documentation](https://www.remotion.dev/docs/clipper)
      */
     Clipper: Clipper_js_1.Clipper,
     /**
      * @description This is a special component, that, when rendered, will skip rendering the frame altogether.
-     * @see [Documentation](https://www.remotion.dev/docs/null)
      */
     Null: Null_js_1.Null,
     useIsPlayer: is_player_js_1.useIsPlayer,

package/dist/cjs/interactivity-schema.d.ts

@@ -86,12 +86,17 @@ export type ColorFieldSchema = {
     description?: string;
     keyframable?: boolean;
 };
-export type TextContentFieldSchema = {
-    type: 'text-content';
+export type StringFieldSchema = {
+    type: 'string';
     default: string;
     description?: string;
     keyframable?: false;
 };
+/** @deprecated Use StringFieldSchema with type: 'string' instead. */
+export type TextContentFieldSchema = Omit<StringFieldSchema, 'type'> & {
+    /** @deprecated Use 'string' instead. */
+    type: 'text-content';
+};
 export type SvgPathFieldSchema = {
     type: 'svg-path';
     default: string | undefined;
@@ -152,7 +157,7 @@ export type CaptionsFieldSchema = {
     description?: string;
     keyframable: false;
 };
-export type VisibleFieldSchema = NumberFieldSchema | BooleanFieldSchema | RotationCssFieldSchema | RotationDegreesFieldSchema | TranslateFieldSchema | TransformOriginFieldSchema | ScaleFieldSchema | UvCoordinateFieldSchema | ColorFieldSchema | TextContentFieldSchema | SvgPathFieldSchema | FontFamilyFieldSchema | FontWeightFieldSchema | AssetFieldSchema | ArrayFieldSchema | CaptionsFieldSchema | EnumFieldSchema;
+export type VisibleFieldSchema = NumberFieldSchema | BooleanFieldSchema | RotationCssFieldSchema | RotationDegreesFieldSchema | TranslateFieldSchema | TransformOriginFieldSchema | ScaleFieldSchema | UvCoordinateFieldSchema | ColorFieldSchema | StringFieldSchema | TextContentFieldSchema | SvgPathFieldSchema | FontFamilyFieldSchema | FontWeightFieldSchema | AssetFieldSchema | ArrayFieldSchema | CaptionsFieldSchema | EnumFieldSchema;
 export type InteractivitySchemaField = VisibleFieldSchema | HiddenFieldSchema;
 export type InteractivitySchema = {
     [key: string]: InteractivitySchemaField;
@@ -431,13 +436,16 @@ export declare const svgPaintSchema: {
         readonly description: "Fill";
     };
 };
+/**
+ * Controls for children content. Currently uses a string field, but the field
+ * type may evolve to support richer content.
+ */
+export declare const childrenSchema: {
+    children: InteractivitySchemaField;
+};
+/** @deprecated Use childrenSchema instead. */
 export declare const textContentSchema: {
-    readonly children: {
-        readonly type: "text-content";
-        readonly default: "";
-        readonly description: "Text";
-        readonly keyframable: false;
-    };
+    children: InteractivitySchemaField;
 };
 export declare const premountSchema: {
     readonly premountFor: {
@@ -756,6 +764,34 @@ export declare const trimBeforeField: {
     readonly step: 1;
     readonly hiddenFromList: true;
 };
+export declare const sequenceTimingSchema: {
+    readonly from: {
+        readonly type: "number";
+        readonly default: 0;
+        readonly step: 1;
+        readonly description: "From";
+        readonly hiddenFromList: false;
+        readonly keyframable: false;
+    };
+    readonly durationInFrames: {
+        readonly type: "number";
+        readonly default: undefined;
+        readonly min: 1;
+        readonly step: 1;
+        readonly description: "Duration";
+        readonly hiddenFromList: false;
+        readonly keyframable: false;
+    };
+    readonly trimBefore: {
+        readonly type: "number";
+        readonly default: 0;
+        readonly min: 0;
+        readonly step: 1;
+        readonly description: "Trim before";
+        readonly hiddenFromList: false;
+        readonly keyframable: false;
+    };
+};
 export declare const trimAfterField: {
     readonly type: "number";
     readonly default: undefined;