remotion 4.0.467 → 4.0.468

package/dist/cjs/Sequence.js

@@ -4,7 +4,6 @@ exports.Sequence = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 /* eslint-disable @typescript-eslint/no-use-before-define */
 const react_1 = require("react");
-const react_2 = require("react");
 const AbsoluteFill_js_1 = require("./AbsoluteFill.js");
 const freeze_js_1 = require("./freeze.js");
 const nonce_js_1 = require("./nonce.js");
@@ -66,11 +65,34 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, durationInFrames = Inf
         return ((parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.postmounting) ||
             Boolean(other._remotionInternalIsPostmounting));
     }, [other._remotionInternalIsPostmounting, parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.postmounting]);
+    // `cumulatedNegativeFrom` answers: "How many frames of this media have
+    // already elapsed before the first visible frame of this sequence?"
+    //
+    // This is intentionally based on the effective sequence start, not on adding
+    // all negative `from` values. See the asset-calculation tests for:
+    // - "Should calculate startFrom correctly with negative offset (Html5Audio)"
+    // - "same as above, but with <Sequence from={0}> inbetween"
+    // - "same as above, but a positive child offset cancels part of the negative parent offset"
+    //
+    // In particular, <Sequence from={-20}><Sequence from={10}> should have a
+    // 10-frame pre-roll, because the positive child offset cancels part of the
+    // negative parent offset. But <Sequence from={10}><Sequence from={-5}>
+    // should still trim 5 frames from the media once the parent starts.
+    const currentSequenceStart = cumulatedFrom + from;
+    const parentSequenceStart = parentSequence
+        ? parentSequence.cumulatedFrom + parentSequence.relativeFrom
+        : 0;
+    const parentFirstFrame = parentSequence
+        ? parentSequenceStart - parentSequence.cumulatedNegativeFrom
+        : 0;
+    const firstFrame = Math.max(0, parentFirstFrame, currentSequenceStart);
+    const cumulatedNegativeFrom = currentSequenceStart - firstFrame;
     const contextValue = (0, react_1.useMemo)(() => {
         var _a, _b, _c;
         return {
             cumulatedFrom,
             relativeFrom: from,
+            cumulatedNegativeFrom,
             durationInFrames: actualDurationInFrames,
             parentFrom: (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.relativeFrom) !== null && _a !== void 0 ? _a : 0,
             id,
@@ -93,6 +115,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, durationInFrames = Inf
         postmounting,
         premountDisplay,
         postmountDisplay,
+        cumulatedNegativeFrom,
     ]);
     const timelineClipName = (0, react_1.useMemo)(() => {
         return name !== null && name !== void 0 ? name : '';
@@ -102,7 +125,7 @@ const RegularSequenceRefForwardingFunction = ({ from = 0, durationInFrames = Inf
     const inheritedStack = (_a = other === null || other === void 0 ? void 0 : other.stack) !== null && _a !== void 0 ? _a : null;
     // 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_2.useRef)(null);
+    const stackRef = (0, react_1.useRef)(null);
     stackRef.current = stack !== null && stack !== void 0 ? stack : inheritedStack;
     (0, react_1.useEffect)(() => {
         var _a, _b, _c;

package/dist/cjs/SequenceContext.d.ts

@@ -1,6 +1,7 @@
 export declare const SequenceContext: import("react").Context<SequenceContextType | null>;
 export type SequenceContextType = {
     cumulatedFrom: number;
+    cumulatedNegativeFrom: number;
     relativeFrom: number;
     parentFrom: number;
     durationInFrames: number;

package/dist/cjs/audio/AudioForRendering.js

@@ -65,7 +65,7 @@ const AudioForRenderingRefForwardingFunction = (props, ref) => {
             mediaFrame: frame,
             playbackRate: (_a = props.playbackRate) !== null && _a !== void 0 ? _a : 1,
             toneFrequency: toneFrequency !== null && toneFrequency !== void 0 ? toneFrequency : 1,
-            audioStartFrame: Math.max(0, -((_b = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom) !== null && _b !== void 0 ? _b : 0)),
+            audioStartFrame: Math.max(0, -((_b = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom) !== null && _b !== void 0 ? _b : 0)),
             audioStreamIndex: audioStreamIndex !== null && audioStreamIndex !== void 0 ? audioStreamIndex : 0,
         });
         return () => unregisterRenderAsset(id);
@@ -82,7 +82,7 @@ const AudioForRenderingRefForwardingFunction = (props, ref) => {
         playbackRate,
         props.playbackRate,
         toneFrequency,
-        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom,
+        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom,
         audioStreamIndex,
     ]);
     const { src } = props;

package/dist/cjs/audio/use-audio-frame.js

@@ -8,8 +8,7 @@ const use_current_frame_js_1 = require("../use-current-frame.js");
 const useMediaStartsAt = () => {
     var _a;
     const parentSequence = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
-    const startsAt = Math.min(0, (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.relativeFrom) !== null && _a !== void 0 ? _a : 0);
-    return startsAt;
+    return (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.cumulatedNegativeFrom) !== null && _a !== void 0 ? _a : 0;
 };
 exports.useMediaStartsAt = useMediaStartsAt;
 /**

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.467";
+export declare const VERSION = "4.0.468";

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.467';
+exports.VERSION = '4.0.468';

package/dist/cjs/video/OffthreadVideoForRendering.js

@@ -74,7 +74,7 @@ crossOrigin, audioStreamIndex, preservePitch: _preservePitch, ...props }) => {
             mediaFrame: frame,
             playbackRate,
             toneFrequency,
-            audioStartFrame: Math.max(0, -((_a = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom) !== null && _a !== void 0 ? _a : 0)),
+            audioStartFrame: Math.max(0, -((_a = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom) !== null && _a !== void 0 ? _a : 0)),
             audioStreamIndex,
         });
         return () => unregisterRenderAsset(id);
@@ -89,7 +89,7 @@ crossOrigin, audioStreamIndex, preservePitch: _preservePitch, ...props }) => {
         absoluteFrame,
         playbackRate,
         toneFrequency,
-        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom,
+        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom,
         audioStreamIndex,
     ]);
     const currentTime = (0, react_1.useMemo)(() => {

package/dist/cjs/video/VideoForRendering.js

@@ -76,7 +76,7 @@ const VideoForRenderingForwardFunction = ({ onError, volume: volumeProp, allowAm
             mediaFrame: frame,
             playbackRate: playbackRate !== null && playbackRate !== void 0 ? playbackRate : 1,
             toneFrequency: toneFrequency !== null && toneFrequency !== void 0 ? toneFrequency : 1,
-            audioStartFrame: Math.max(0, -((_a = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom) !== null && _a !== void 0 ? _a : 0)),
+            audioStartFrame: Math.max(0, -((_a = sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom) !== null && _a !== void 0 ? _a : 0)),
             audioStreamIndex: audioStreamIndex !== null && audioStreamIndex !== void 0 ? audioStreamIndex : 0,
         });
         return () => unregisterRenderAsset(id);
@@ -91,7 +91,7 @@ const VideoForRenderingForwardFunction = ({ onError, volume: volumeProp, allowAm
         absoluteFrame,
         playbackRate,
         toneFrequency,
-        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.relativeFrom,
+        sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.cumulatedNegativeFrom,
         audioStreamIndex,
     ]);
     (0, react_1.useImperativeHandle)(ref, () => {

package/dist/esm/index.mjs

@@ -1,15 +1,11 @@
 var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter.bind(all, name)
+      set: (newValue) => all[name] = () => newValue
     });
 };
 
@@ -1292,7 +1288,7 @@ var addSequenceStackTraces = (component) => {
 };
 
 // src/version.ts
-var VERSION = "4.0.467";
+var VERSION = "4.0.468";
 
 // src/multiple-versions-warning.ts
 var checkMultipleRemotionVersions = () => {
@@ -1334,9 +1330,9 @@ import {
   useContext as useContext17,
   useEffect as useEffect3,
   useMemo as useMemo14,
+  useRef as useRef6,
   useState as useState5
 } from "react";
-import { useRef as useRef6 } from "react";
 
 // src/freeze.tsx
 import { useContext as useContext14, useMemo as useMemo11 } from "react";
@@ -2474,10 +2470,16 @@ var RegularSequenceRefForwardingFunction = ({
   const postmounting = useMemo14(() => {
     return parentSequence?.postmounting || Boolean(other._remotionInternalIsPostmounting);
   }, [other._remotionInternalIsPostmounting, parentSequence?.postmounting]);
+  const currentSequenceStart = cumulatedFrom + from;
+  const parentSequenceStart = parentSequence ? parentSequence.cumulatedFrom + parentSequence.relativeFrom : 0;
+  const parentFirstFrame = parentSequence ? parentSequenceStart - parentSequence.cumulatedNegativeFrom : 0;
+  const firstFrame = Math.max(0, parentFirstFrame, currentSequenceStart);
+  const cumulatedNegativeFrom = currentSequenceStart - firstFrame;
   const contextValue = useMemo14(() => {
     return {
       cumulatedFrom,
       relativeFrom: from,
+      cumulatedNegativeFrom,
       durationInFrames: actualDurationInFrames,
       parentFrom: parentSequence?.relativeFrom ?? 0,
       id,
@@ -2499,7 +2501,8 @@ var RegularSequenceRefForwardingFunction = ({
     premounting,
     postmounting,
     premountDisplay,
-    postmountDisplay
+    postmountDisplay,
+    cumulatedNegativeFrom
   ]);
   const timelineClipName = useMemo14(() => {
     return name ?? "";
@@ -5376,8 +5379,7 @@ import { useContext as useContext24, useEffect as useEffect8, useMemo as useMemo
 import { useContext as useContext23 } from "react";
 var useMediaStartsAt = () => {
   const parentSequence = useContext23(SequenceContext);
-  const startsAt = Math.min(0, parentSequence?.relativeFrom ?? 0);
-  return startsAt;
+  return parentSequence?.cumulatedNegativeFrom ?? 0;
 };
 var useFrameForVolumeProp = (behavior) => {
   const loop = Loop.useLoop();
@@ -6910,7 +6912,7 @@ var AudioForRenderingRefForwardingFunction = (props, ref) => {
       mediaFrame: frame,
       playbackRate: props.playbackRate ?? 1,
       toneFrequency: toneFrequency ?? 1,
-      audioStartFrame: Math.max(0, -(sequenceContext?.relativeFrom ?? 0)),
+      audioStartFrame: Math.max(0, -(sequenceContext?.cumulatedNegativeFrom ?? 0)),
       audioStreamIndex: audioStreamIndex ?? 0
     });
     return () => unregisterRenderAsset(id);
@@ -6927,7 +6929,7 @@ var AudioForRenderingRefForwardingFunction = (props, ref) => {
     playbackRate,
     props.playbackRate,
     toneFrequency,
-    sequenceContext?.relativeFrom,
+    sequenceContext?.cumulatedNegativeFrom,
     audioStreamIndex
   ]);
   const { src } = props;
@@ -8539,7 +8541,7 @@ var OffthreadVideoForRendering = ({
       mediaFrame: frame,
       playbackRate,
       toneFrequency,
-      audioStartFrame: Math.max(0, -(sequenceContext?.relativeFrom ?? 0)),
+      audioStartFrame: Math.max(0, -(sequenceContext?.cumulatedNegativeFrom ?? 0)),
       audioStreamIndex
     });
     return () => unregisterRenderAsset(id);
@@ -8554,7 +8556,7 @@ var OffthreadVideoForRendering = ({
     absoluteFrame,
     playbackRate,
     toneFrequency,
-    sequenceContext?.relativeFrom,
+    sequenceContext?.cumulatedNegativeFrom,
     audioStreamIndex
   ]);
   const currentTime = useMemo35(() => {
@@ -10557,7 +10559,7 @@ var VideoForRenderingForwardFunction = ({
       mediaFrame: frame,
       playbackRate: playbackRate ?? 1,
       toneFrequency: toneFrequency ?? 1,
-      audioStartFrame: Math.max(0, -(sequenceContext?.relativeFrom ?? 0)),
+      audioStartFrame: Math.max(0, -(sequenceContext?.cumulatedNegativeFrom ?? 0)),
       audioStreamIndex: audioStreamIndex ?? 0
     });
     return () => unregisterRenderAsset(id);
@@ -10572,7 +10574,7 @@ var VideoForRenderingForwardFunction = ({
     absoluteFrame,
     playbackRate,
     toneFrequency,
-    sequenceContext?.relativeFrom,
+    sequenceContext?.cumulatedNegativeFrom,
     audioStreamIndex
   ]);
   useImperativeHandle9(ref, () => {

package/dist/esm/version.mjs

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "4.0.467";
+var VERSION = "4.0.468";
 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.467",
+	"version": "4.0.468",
 	"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.467",
+		"@remotion/eslint-config-internal": "4.0.468",
 		"eslint": "9.19.0",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"
 	},