remotion 4.0.477 → 4.0.478

package/dist/cjs/CompositionManager.d.ts

@@ -34,6 +34,7 @@ type EnhancedTSequenceData = {
     doesVolumeChange: boolean;
     startMediaFrom: number;
     playbackRate: number;
+    frozenMediaFrame: number | null;
 } | {
     type: 'video';
     src: string;
@@ -41,6 +42,7 @@ type EnhancedTSequenceData = {
     doesVolumeChange: boolean;
     startMediaFrom: number;
     playbackRate: number;
+    frozenMediaFrame: number | null;
 } | {
     type: 'image';
     src: string;
@@ -76,6 +78,7 @@ export type TSequence = {
     refForOutline: React.RefObject<Element | null> | null;
     effects: readonly EffectDefinition<unknown>[];
     isInsideSeries: boolean;
+    frozenFrame: number | null;
 } & EnhancedTSequenceData;
 export type AudioOrVideoAsset = {
     type: 'audio' | 'video';

package/dist/cjs/Sequence.js

@@ -20,7 +20,7 @@ const v5_flag_js_1 = require("./v5-flag.js");
 const wrap_in_schema_js_1 = require("./wrap-in-schema.js");
 const EMPTY_EFFECTS = [];
 const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFrames = Infinity, children, name, height, width, showInTimeline = true, hidden = false, _experimentalControls: controls, _remotionInternalEffects, _remotionInternalLoopDisplay: loopDisplay, _remotionInternalStack: stack, _remotionInternalDocumentationLink: documentationLink, _remotionInternalPremountDisplay: premountDisplay, _remotionInternalPostmountDisplay: postmountDisplay, _remotionInternalIsMedia: isMedia, _remotionInternalRefForOutline: passedRefForOutline, ...other }, ref) => {
-    var _a, _b;
+    var _a, _b, _c;
     const { layout = 'absolute-fill' } = other;
     const [id] = (0, react_1.useState)(() => String(Math.random()));
     const parentSequence = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
@@ -148,6 +148,25 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFram
     // and if it changes, it would lead to-remounting of the sequence.
     const stackRef = (0, react_1.useRef)(null);
     stackRef.current = stack !== null && stack !== void 0 ? stack : inheritedStack;
+    const registeredFrozenFrame = typeof freeze === 'number' ? freeze : null;
+    const parentCumulatedNegativeFrom = (_c = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _c !== void 0 ? _c : 0;
+    const startMediaFrom = isMedia && isMedia.type !== 'image'
+        ? isMedia.data.startMediaFrom +
+            parentCumulatedNegativeFrom -
+            cumulatedNegativeFrom
+        : null;
+    const mediaFrameAtSequenceZero = isMedia && isMedia.type !== 'image'
+        ? isMedia.data.startMediaFrom + parentCumulatedNegativeFrom
+        : null;
+    const frozenMediaFrame = isMedia && isMedia.type !== 'image' && mediaFrameAtSequenceZero !== null
+        ? registeredFrozenFrame === null
+            ? null
+            : mediaFrameAtSequenceZero +
+                (loopDisplay
+                    ? registeredFrozenFrame % loopDisplay.durationInFrames
+                    : registeredFrozenFrame) *
+                    isMedia.data.playbackRate
+        : null;
     (0, react_1.useEffect)(() => {
         var _a, _b, _c;
         if (!env.isStudio) {
@@ -175,6 +194,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFram
                     getStack: () => stackRef.current,
                     refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
                     isInsideSeries,
+                    frozenFrame: registeredFrozenFrame,
                 });
             }
             else {
@@ -198,10 +218,12 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFram
                     showInTimeline,
                     src: isMedia.data.src,
                     getStack: () => stackRef.current,
-                    startMediaFrom: isMedia.data.startMediaFrom,
+                    startMediaFrom: startMediaFrom !== null && startMediaFrom !== void 0 ? startMediaFrom : isMedia.data.startMediaFrom,
                     volume: isMedia.data.volumes,
                     refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
                     isInsideSeries,
+                    frozenFrame: registeredFrozenFrame,
+                    frozenMediaFrame,
                 });
             }
             return () => {
@@ -227,6 +249,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFram
             effects: _remotionInternalEffects !== null && _remotionInternalEffects !== void 0 ? _remotionInternalEffects : EMPTY_EFFECTS,
             refForOutline: refForOutline !== null && refForOutline !== void 0 ? refForOutline : null,
             isInsideSeries,
+            frozenFrame: registeredFrozenFrame,
         });
         return () => {
             unregisterSequence(id);
@@ -254,6 +277,9 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, freeze, durationInFram
         resolvedDocumentationLink,
         refForOutline,
         isInsideSeries,
+        registeredFrozenFrame,
+        startMediaFrom,
+        frozenMediaFrame,
     ]);
     // Ceil to support floats
     // https://github.com/remotion-dev/remotion/issues/2958

package/dist/cjs/use-media-in-timeline.js

@@ -142,6 +142,8 @@ const useMediaInTimeline = ({ volume, mediaVolume, src, mediaType, playbackRate,
             effects: [],
             refForOutline,
             isInsideSeries: false,
+            frozenFrame: null,
+            frozenMediaFrame: null,
         });
         return () => {
             unregisterSequence(id);

package/dist/cjs/version.d.ts

@@ -3,4 +3,4 @@
  * @see [Documentation](https://remotion.dev/docs/version)
  * @returns {string} The current version of the remotion package
  */
-export declare const VERSION = "4.0.477";
+export declare const VERSION = "4.0.478";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.VERSION = void 0;
  * @see [Documentation](https://remotion.dev/docs/version)
  * @returns {string} The current version of the remotion package
  */
-exports.VERSION = '4.0.477';
+exports.VERSION = '4.0.478';

package/dist/esm/index.mjs

@@ -1291,7 +1291,7 @@ var addSequenceStackTraces = (component) => {
 };
 
 // src/version.ts
-var VERSION = "4.0.477";
+var VERSION = "4.0.478";
 
 // src/multiple-versions-warning.ts
 var checkMultipleRemotionVersions = () => {
@@ -4285,6 +4285,11 @@ var RegularSequenceRefForwardingFunction = ({
   const inheritedStack = other?.stack ?? null;
   const stackRef = useRef6(null);
   stackRef.current = stack ?? inheritedStack;
+  const registeredFrozenFrame = typeof freeze === "number" ? freeze : null;
+  const parentCumulatedNegativeFrom = parentSequence?.cumulatedNegativeFrom ?? 0;
+  const startMediaFrom = isMedia && isMedia.type !== "image" ? isMedia.data.startMediaFrom + parentCumulatedNegativeFrom - cumulatedNegativeFrom : null;
+  const mediaFrameAtSequenceZero = isMedia && isMedia.type !== "image" ? isMedia.data.startMediaFrom + parentCumulatedNegativeFrom : null;
+  const frozenMediaFrame = isMedia && isMedia.type !== "image" && mediaFrameAtSequenceZero !== null ? registeredFrozenFrame === null ? null : mediaFrameAtSequenceZero + (loopDisplay ? registeredFrozenFrame % loopDisplay.durationInFrames : registeredFrozenFrame) * isMedia.data.playbackRate : null;
   useEffect3(() => {
     if (!env.isStudio) {
       return;
@@ -4310,7 +4315,8 @@ var RegularSequenceRefForwardingFunction = ({
           src: isMedia.src,
           getStack: () => stackRef.current,
           refForOutline: refForOutline ?? null,
-          isInsideSeries
+          isInsideSeries,
+          frozenFrame: registeredFrozenFrame
         });
       } else {
         registerSequence({
@@ -4333,10 +4339,12 @@ var RegularSequenceRefForwardingFunction = ({
           showInTimeline,
           src: isMedia.data.src,
           getStack: () => stackRef.current,
-          startMediaFrom: isMedia.data.startMediaFrom,
+          startMediaFrom: startMediaFrom ?? isMedia.data.startMediaFrom,
           volume: isMedia.data.volumes,
           refForOutline: refForOutline ?? null,
-          isInsideSeries
+          isInsideSeries,
+          frozenFrame: registeredFrozenFrame,
+          frozenMediaFrame
         });
       }
       return () => {
@@ -4361,7 +4369,8 @@ var RegularSequenceRefForwardingFunction = ({
       controls: controls ?? null,
       effects: _remotionInternalEffects ?? EMPTY_EFFECTS,
       refForOutline: refForOutline ?? null,
-      isInsideSeries
+      isInsideSeries,
+      frozenFrame: registeredFrozenFrame
     });
     return () => {
       unregisterSequence(id);
@@ -4388,7 +4397,10 @@ var RegularSequenceRefForwardingFunction = ({
     isMedia,
     resolvedDocumentationLink,
     refForOutline,
-    isInsideSeries
+    isInsideSeries,
+    registeredFrozenFrame,
+    startMediaFrom,
+    frozenMediaFrame
   ]);
   const endThreshold = Math.ceil(cumulatedFrom + from + durationInFrames - 1);
   const content = absoluteFrame < cumulatedFrom + from ? null : absoluteFrame > endThreshold ? null : children;
@@ -7032,7 +7044,9 @@ var useMediaInTimeline = ({
       controls: null,
       effects: [],
       refForOutline,
-      isInsideSeries: false
+      isInsideSeries: false,
+      frozenFrame: null,
+      frozenMediaFrame: null
     });
     return () => {
       unregisterSequence(id);

package/dist/esm/version.mjs

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "4.0.477";
+var VERSION = "4.0.478";
 export {
   VERSION
 };

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/core"
 	},
 	"name": "remotion",
-	"version": "4.0.477",
+	"version": "4.0.478",
 	"description": "Make videos programmatically",
 	"main": "dist/cjs/index.js",
 	"types": "dist/cjs/index.d.ts",
@@ -35,7 +35,7 @@
 		"react-dom": "19.2.3",
 		"webpack": "5.105.0",
 		"zod": "4.3.6",
-		"@remotion/eslint-config-internal": "4.0.477",
+		"@remotion/eslint-config-internal": "4.0.478",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},

package/dist/cjs/interpolate-translate.d.ts

@@ -1,8 +0,0 @@
-import { type InterpolateOptions } from './interpolate.js';
-export type InterpolateTranslateOptions = InterpolateOptions;
-export declare const interpolateTranslate: (input: number, inputRange: readonly number[], outputRange: readonly string[], options?: Partial<{
-    easing: import("./interpolate.js").EasingFunction | readonly import("./interpolate.js").EasingFunction[];
-    extrapolateLeft: import("./interpolate.js").ExtrapolateType;
-    extrapolateRight: import("./interpolate.js").ExtrapolateType;
-    posterize: number;
-}> | undefined) => string;

package/dist/cjs/interpolate-translate.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.interpolateTranslate = void 0;
-const interpolate_js_1 = require("./interpolate.js");
-const pixelValueRegex = /^([+-]?(?:\d+\.?\d*|\.\d+))px$/;
-const parseTranslate = (value) => {
-    if (typeof value !== 'string') {
-        throw new TypeError(`outputRange must contain only strings, but got ${typeof value}`);
-    }
-    const parts = value.trim().split(/\s+/);
-    if (parts.length < 1 || parts.length > 3 || parts[0] === '') {
-        throw new TypeError(`translate values must contain 1 to 3 pixel values, but got "${value}"`);
-    }
-    return parts.map((part) => {
-        const match = pixelValueRegex.exec(part);
-        if (match === null) {
-            throw new TypeError(`interpolateTranslate() only supports px values, but got "${part}" in "${value}"`);
-        }
-        return Number(match[1]);
-    });
-};
-/*
- * @description Allows you to map a range of values to CSS translate values using pixel units.
- * @see [Documentation](https://remotion.dev/docs/interpolate-translate)
- */
-const interpolateTranslate = (input, inputRange, outputRange, options) => {
-    var _a;
-    if (typeof input === 'undefined') {
-        throw new TypeError('input can not be undefined');
-    }
-    if (typeof inputRange === 'undefined') {
-        throw new TypeError('inputRange can not be undefined');
-    }
-    if (typeof outputRange === 'undefined') {
-        throw new TypeError('outputRange can not be undefined');
-    }
-    if (inputRange.length !== outputRange.length) {
-        throw new TypeError('inputRange (' +
-            inputRange.length +
-            ' values provided) and outputRange (' +
-            outputRange.length +
-            ' values provided) must have the same length');
-    }
-    const parsedOutputRange = outputRange.map((translateValue) => parseTranslate(translateValue));
-    const firstValueLength = (_a = parsedOutputRange[0]) === null || _a === void 0 ? void 0 : _a.length;
-    if (firstValueLength === undefined) {
-        throw new TypeError('outputRange must have at least 1 element');
-    }
-    for (const parsedTranslate of parsedOutputRange) {
-        if (parsedTranslate.length !== firstValueLength) {
-            throw new TypeError(`All translate values must have the same number of pixel values, but got ${firstValueLength} and ${parsedTranslate.length}`);
-        }
-    }
-    return new Array(firstValueLength)
-        .fill(true)
-        .map((_, index) => {
-        const outputValues = [];
-        for (const translateValue of parsedOutputRange) {
-            const value = translateValue[index];
-            if (value === undefined) {
-                throw new TypeError(`All translate values must have the same number of pixel values, but got ${firstValueLength} and ${translateValue.length}`);
-            }
-            outputValues.push(value);
-        }
-        const interpolatedValue = (0, interpolate_js_1.interpolate)(input, inputRange, outputValues, options);
-        return `${interpolatedValue}px`;
-    })
-        .join(' ');
-};
-exports.interpolateTranslate = interpolateTranslate;