remotion 4.1.0-alpha5 → 4.1.0-alpha8

package/dist/esm/index.mjs

@@ -58,7 +58,7 @@ function truthy(value) {
 }
 
 // Automatically generated on publish
-const VERSION = '4.1.0-alpha5';
+const VERSION = '4.1.0-alpha8';
 
 const checkMultipleRemotionVersions = () => {
     if (typeof globalThis === 'undefined') {
@@ -292,6 +292,142 @@ const CompositionManager = createContext({
     currentCompositionMetadata: null,
 });
 
+const problematicCharacters = {
+    '%3A': ':',
+    '%2F': '/',
+    '%3F': '?',
+    '%23': '#',
+    '%5B': '[',
+    '%5D': ']',
+    '%40': '@',
+    '%21': '!',
+    '%24': '$',
+    '%26': '&',
+    '%27': "'",
+    '%28': '(',
+    '%29': ')',
+    '%2A': '*',
+    '%2B': '+',
+    '%2C': ',',
+    '%3B': ';',
+};
+const didWarn$1 = {};
+const warnOnce$1 = (message) => {
+    if (didWarn$1[message]) {
+        return;
+    }
+    console.warn(message);
+    didWarn$1[message] = true;
+};
+const includesHexOfUnsafeChar = (path) => {
+    for (const key of Object.keys(problematicCharacters)) {
+        if (path.includes(key)) {
+            return { containsHex: true, hexCode: key };
+        }
+    }
+    return { containsHex: false };
+};
+const trimLeadingSlash = (path) => {
+    if (path.startsWith('/')) {
+        return trimLeadingSlash(path.substring(1));
+    }
+    return path;
+};
+const inner = (path) => {
+    if (typeof window !== 'undefined' && window.remotion_staticBase) {
+        return `${window.remotion_staticBase}/${trimLeadingSlash(path)}`;
+    }
+    return `/${trimLeadingSlash(path)}`;
+};
+const encodeBySplitting = (path) => {
+    const splitBySlash = path.split('/');
+    const encodedArray = splitBySlash.map((element) => {
+        return encodeURIComponent(element);
+    });
+    const merged = encodedArray.join('/');
+    return merged;
+};
+/**
+ * @description Reference a file from the public/ folder. If the file does not appear in the autocomplete, type the path manually.
+ * @see [Documentation](https://www.remotion.dev/docs/staticfile)
+ */
+const staticFile = (path) => {
+    if (path.startsWith('http://') || path.startsWith('https://')) {
+        throw new TypeError(`staticFile() does not support remote URLs - got "${path}". Instead, pass the URL without wrapping it in staticFile(). See: https://remotion.dev/docs/staticfile-remote-urls`);
+    }
+    if (path.startsWith('..') || path.startsWith('./')) {
+        throw new TypeError(`staticFile() does not support relative paths - got "${path}". Instead, pass the name of a file that is inside the public/ folder. See: https://remotion.dev/docs/staticfile-relative-paths`);
+    }
+    if (path.startsWith('/Users') ||
+        path.startsWith('/home') ||
+        path.startsWith('/tmp') ||
+        path.startsWith('/etc') ||
+        path.startsWith('/opt') ||
+        path.startsWith('/var') ||
+        path.startsWith('C:') ||
+        path.startsWith('D:') ||
+        path.startsWith('E:')) {
+        throw new TypeError(`staticFile() does not support absolute paths - got "${path}". Instead, pass the name of a file that is inside the public/ folder. See: https://remotion.dev/docs/staticfile-relative-paths`);
+    }
+    if (path.startsWith('public/')) {
+        throw new TypeError(`Do not include the public/ prefix when using staticFile() - got "${path}". See: https://remotion.dev/docs/staticfile-relative-paths`);
+    }
+    const includesHex = includesHexOfUnsafeChar(path);
+    if (includesHex.containsHex) {
+        warnOnce$1(`WARNING: You seem to pass an already encoded path (path contains ${includesHex.hexCode}). Since Remotion 4.0, the encoding is done by staticFile() itself. You may want to remove a encodeURIComponent() wrapping.`);
+    }
+    const preprocessed = encodeBySplitting(path);
+    const preparsed = inner(preprocessed);
+    if (!preparsed.startsWith('/')) {
+        return `/${preparsed}`;
+    }
+    return preparsed;
+};
+
+// Must keep this file in sync with the one in packages/lambda/src/shared/serialize-props.ts!
+const DATE_TOKEN = 'remotion-date:';
+const FILE_TOKEN = 'remotion-file:';
+const serializeJSONWithDate = ({ data, indent, staticBase, }) => {
+    let customDateUsed = false;
+    let customFileUsed = false;
+    let mapUsed = false;
+    let setUsed = false;
+    const serializedString = JSON.stringify(data, function (key, value) {
+        const item = this[key];
+        if (item instanceof Date) {
+            customDateUsed = true;
+            return `${DATE_TOKEN}${item.toISOString()}`;
+        }
+        if (item instanceof Map) {
+            mapUsed = true;
+            return value;
+        }
+        if (item instanceof Set) {
+            setUsed = true;
+            return value;
+        }
+        if (typeof item === 'string' &&
+            staticBase !== null &&
+            item.startsWith(staticBase)) {
+            customFileUsed = true;
+            return `${FILE_TOKEN}${item.replace(staticBase + '/', '')}`;
+        }
+        return value;
+    }, indent);
+    return { serializedString, customDateUsed, customFileUsed, mapUsed, setUsed };
+};
+const deserializeJSONWithCustomFields = (data) => {
+    return JSON.parse(data, (_, value) => {
+        if (typeof value === 'string' && value.startsWith(DATE_TOKEN)) {
+            return new Date(value.replace(DATE_TOKEN, ''));
+        }
+        if (typeof value === 'string' && value.startsWith(FILE_TOKEN)) {
+            return staticFile(value.replace(FILE_TOKEN, ''));
+        }
+        return value;
+    });
+};
+
 let didWarnSSRImport = false;
 const warnOnceSSRImport = () => {
     if (didWarnSSRImport) {
@@ -315,7 +451,7 @@ const getInputProps = () => {
     if (!param) {
         return {};
     }
-    const parsed = JSON.parse(param);
+    const parsed = deserializeJSONWithCustomFields(param);
     return parsed;
 };
 
@@ -344,7 +480,7 @@ const EditorPropsProvider = ({ children }) => {
     return (jsx(EditorPropsContext.Provider, { value: ctx, children: children }));
 };
 
-const validateDimension = (amount, nameOfProp, location) => {
+function validateDimension(amount, nameOfProp, location) {
     if (typeof amount !== 'number') {
         throw new Error(`The "${nameOfProp}" prop ${location} must be a number, but you passed a value of type ${typeof amount}`);
     }
@@ -360,9 +496,13 @@ const validateDimension = (amount, nameOfProp, location) => {
     if (amount <= 0) {
         throw new TypeError(`The "${nameOfProp}" prop ${location} must be positive, but got ${amount}.`);
     }
-};
+}
 
-const validateDurationInFrames = ({ allowFloats, component, durationInFrames, }) => {
+function validateDurationInFrames(durationInFrames, options) {
+    const { allowFloats, component } = options;
+    if (typeof durationInFrames === 'undefined') {
+        throw new Error(`The "durationInFrames" prop ${component} is missing.`);
+    }
     if (typeof durationInFrames !== 'number') {
         throw new Error(`The "durationInFrames" prop ${component} must be a number, but you passed a value of type ${typeof durationInFrames}`);
     }
@@ -375,21 +515,35 @@ const validateDurationInFrames = ({ allowFloats, component, durationInFrames, })
     if (!Number.isFinite(durationInFrames)) {
         throw new TypeError(`The "durationInFrames" prop ${component} must be finite, but got ${durationInFrames}.`);
     }
-};
+}
 
-const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined, signal, }) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+function validateFps(fps, location, isGif) {
+    if (typeof fps !== 'number') {
+        throw new Error(`"fps" must be a number, but you passed a value of type ${typeof fps} ${location}`);
+    }
+    if (!Number.isFinite(fps)) {
+        throw new Error(`"fps" must be a finite, but you passed ${fps} ${location}`);
+    }
+    if (isNaN(fps)) {
+        throw new Error(`"fps" must not be NaN, but got ${fps} ${location}`);
+    }
+    if (fps <= 0) {
+        throw new TypeError(`"fps" must be positive, but got ${fps} ${location}`);
+    }
+    if (isGif && fps > 50) {
+        throw new TypeError(`The FPS for a GIF cannot be higher than 50. Use the --every-nth-frame option to lower the FPS: https://remotion.dev/docs/render-as-gif`);
+    }
+}
+
+const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined, signal, inputProps, }) => {
+    var _a, _b, _c, _d, _e, _f, _g;
     const calculatedProm = composition.calculateMetadata
         ? composition.calculateMetadata({
             defaultProps: (_a = composition.defaultProps) !== null && _a !== void 0 ? _a : {},
             props: {
                 ...((_b = composition.defaultProps) !== null && _b !== void 0 ? _b : {}),
                 ...(editorPropsOrUndefined !== null && editorPropsOrUndefined !== void 0 ? editorPropsOrUndefined : {}),
-                ...(typeof window === 'undefined' ||
-                    getRemotionEnvironment() === 'player-development' ||
-                    getRemotionEnvironment() === 'player-production'
-                    ? {}
-                    : (_c = getInputProps()) !== null && _c !== void 0 ? _c : {}),
+                ...inputProps,
             },
             abortSignal: signal,
         })
@@ -422,42 +576,34 @@ const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined,
         return {
             ...data,
             id: composition.id,
-            defaultProps: (_d = composition.defaultProps) !== null && _d !== void 0 ? _d : {},
-            props: (_e = composition.defaultProps) !== null && _e !== void 0 ? _e : {},
+            defaultProps: (_c = composition.defaultProps) !== null && _c !== void 0 ? _c : {},
+            props: {
+                ...((_d = composition.defaultProps) !== null && _d !== void 0 ? _d : {}),
+                ...(inputProps !== null && inputProps !== void 0 ? inputProps : {}),
+            },
         };
     }
     return {
         ...data,
         id: composition.id,
-        defaultProps: (_f = composition.defaultProps) !== null && _f !== void 0 ? _f : {},
-        props: (_h = (_g = calculatedProm.props) !== null && _g !== void 0 ? _g : composition.defaultProps) !== null && _h !== void 0 ? _h : {},
+        defaultProps: (_e = composition.defaultProps) !== null && _e !== void 0 ? _e : {},
+        props: (_g = (_f = calculatedProm.props) !== null && _f !== void 0 ? _f : composition.defaultProps) !== null && _g !== void 0 ? _g : {},
     };
 };
 const validateCalculated = ({ composition, calculated, }) => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
-    const potentialErrorLocation = `calculated by calculateMetadata() for the composition "${composition.id}"`;
-    const width = (_b = (_a = calculated === null || calculated === void 0 ? void 0 : calculated.width) !== null && _a !== void 0 ? _a : composition.width) !== null && _b !== void 0 ? _b : null;
-    if (!width) {
-        throw new TypeError('Composition width was neither specified via the `width` prop nor the `calculateMetadata()` function.');
-    }
-    validateDimension(width, 'width', potentialErrorLocation);
-    const height = (_d = (_c = calculated === null || calculated === void 0 ? void 0 : calculated.height) !== null && _c !== void 0 ? _c : composition.height) !== null && _d !== void 0 ? _d : null;
-    if (!height) {
-        throw new TypeError('Composition height was neither specified via the `height` prop nor the `calculateMetadata()` function.');
-    }
-    validateDimension(width, 'height', potentialErrorLocation);
+    const calculateMetadataErrorLocation = `calculated by calculateMetadata() for the composition "${composition.id}"`;
+    const defaultErrorLocation = `of the "<Composition />" component with the id "${composition.id}"`;
+    const width = (_b = (_a = calculated === null || calculated === void 0 ? void 0 : calculated.width) !== null && _a !== void 0 ? _a : composition.width) !== null && _b !== void 0 ? _b : undefined;
+    validateDimension(width, 'width', (calculated === null || calculated === void 0 ? void 0 : calculated.width) ? calculateMetadataErrorLocation : defaultErrorLocation);
+    const height = (_d = (_c = calculated === null || calculated === void 0 ? void 0 : calculated.height) !== null && _c !== void 0 ? _c : composition.height) !== null && _d !== void 0 ? _d : undefined;
+    validateDimension(height, 'height', (calculated === null || calculated === void 0 ? void 0 : calculated.height) ? calculateMetadataErrorLocation : defaultErrorLocation);
     const fps = (_f = (_e = calculated === null || calculated === void 0 ? void 0 : calculated.fps) !== null && _e !== void 0 ? _e : composition.fps) !== null && _f !== void 0 ? _f : null;
-    if (!fps) {
-        throw new TypeError('Composition fps was neither specified via the `fps` prop nor the `calculateMetadata()` function.');
-    }
+    validateFps(fps, (calculated === null || calculated === void 0 ? void 0 : calculated.fps) ? calculateMetadataErrorLocation : defaultErrorLocation, false);
     const durationInFrames = (_h = (_g = calculated === null || calculated === void 0 ? void 0 : calculated.durationInFrames) !== null && _g !== void 0 ? _g : composition.durationInFrames) !== null && _h !== void 0 ? _h : null;
-    if (!durationInFrames) {
-        throw new TypeError('Composition durationInFrames was neither specified via the `durationInFrames` prop nor the `calculateMetadata()` function.');
-    }
-    validateDurationInFrames({
-        durationInFrames,
-        component: potentialErrorLocation,
+    validateDurationInFrames(durationInFrames, {
         allowFloats: false,
+        component: `of the "<Composition />" component with the id "${composition.id}"`,
     });
     return { width, height, fps, durationInFrames };
 };
@@ -484,12 +630,23 @@ const ResolveCompositionConfig = ({ children }) => {
             : {};
     }, [allEditorProps, renderModalComposition]);
     const doResolution = useCallback((composition, editorProps) => {
+        var _a;
         const controller = new AbortController();
         if (currentCompositionMetadata) {
             return controller;
         }
+        const inputProps = typeof window === 'undefined' ||
+            getRemotionEnvironment() === 'player-development' ||
+            getRemotionEnvironment() === 'player-production'
+            ? {}
+            : (_a = getInputProps()) !== null && _a !== void 0 ? _a : {};
         const { signal } = controller;
-        const promOrNot = resolveVideoConfig({ composition, editorProps, signal });
+        const promOrNot = resolveVideoConfig({
+            composition,
+            editorProps,
+            inputProps,
+            signal,
+        });
         if (typeof promOrNot === 'object' && 'then' in promOrNot) {
             setResolvedConfigs((r) => ({
                 ...r,
@@ -623,7 +780,11 @@ const useResolvedVideoConfig = (preferredCompositionId) => {
             return {
                 type: 'success',
                 result: {
-                    ...composition,
+                    width: composition.width,
+                    height: composition.height,
+                    fps: composition.fps,
+                    id: composition.id,
+                    durationInFrames: composition.durationInFrames,
                     defaultProps: (_b = composition.defaultProps) !== null && _b !== void 0 ? _b : {},
                     props: {
                         ...((_c = composition.defaultProps) !== null && _c !== void 0 ? _c : {}),
@@ -677,7 +838,7 @@ const useVideo = () => {
 };
 
 const TimelineContext = createContext({
-    frame: 0,
+    frame: {},
     playing: false,
     playbackRate: 1,
     rootId: '',
@@ -697,16 +858,32 @@ const SetTimelineContext = createContext({
         throw new Error('default');
     },
 });
+const makeKey = (composition) => {
+    return `remotion.time.${composition}`;
+};
+const persistCurrentFrame = (frame, composition) => {
+    localStorage.setItem(makeKey(composition), String(frame));
+};
+const getFrameForComposition = (composition) => {
+    var _a, _b;
+    const frame = localStorage.getItem(makeKey(composition));
+    return frame
+        ? Number(frame)
+        : (_b = (typeof window === 'undefined' ? 0 : (_a = window.remotion_initialFrame) !== null && _a !== void 0 ? _a : 0)) !== null && _b !== void 0 ? _b : 0;
+};
 const useTimelinePosition = () => {
+    var _a, _b;
     const videoConfig = useVideo();
     const state = useContext(TimelineContext);
-    // A dynamically calculated duration using calculateMetadata()
-    // may lead to the frame being bigger than the duration.
-    // If we have the config, we clamp the frame to the duration.
     if (!videoConfig) {
-        return state.frame;
+        return typeof window === 'undefined'
+            ? 0
+            : (_a = window.remotion_initialFrame) !== null && _a !== void 0 ? _a : 0;
     }
-    return Math.min(videoConfig.durationInFrames - 1, state.frame);
+    const unclamped = (_b = state.frame[videoConfig.id]) !== null && _b !== void 0 ? _b : (typeof window !== 'undefined' && window.remotion_isPlayer
+        ? 0
+        : getFrameForComposition(videoConfig.id));
+    return Math.min(videoConfig.durationInFrames - 1, unclamped);
 };
 const useTimelineSetFrame = () => {
     const { setFrame } = useContext(SetTimelineContext);
@@ -722,6 +899,8 @@ var TimelinePosition = /*#__PURE__*/Object.freeze({
     __proto__: null,
     TimelineContext: TimelineContext,
     SetTimelineContext: SetTimelineContext,
+    persistCurrentFrame: persistCurrentFrame,
+    getFrameForComposition: getFrameForComposition,
     useTimelinePosition: useTimelinePosition,
     useTimelineSetFrame: useTimelineSetFrame,
     usePlayingState: usePlayingState
@@ -923,8 +1102,7 @@ const useCurrentFrame = () => {
 const Loop = ({ durationInFrames, times = Infinity, children, name, ...props }) => {
     const currentFrame = useCurrentFrame();
     const { durationInFrames: compDuration } = useVideoConfig();
-    validateDurationInFrames({
-        durationInFrames,
+    validateDurationInFrames(durationInFrames, {
         component: 'of the <Loop /> component',
         allowFloats: true,
     });
@@ -1283,13 +1461,13 @@ const evaluateVolume = ({ frame, volume, mediaVolume = 1, allowAmplificationDuri
     return Math.max(0, Math.min(maxVolume, evaluated));
 };
 
-const didWarn$1 = {};
-const warnOnce$1 = (message) => {
-    if (didWarn$1[message]) {
+const didWarn = {};
+const warnOnce = (message) => {
+    if (didWarn[message]) {
         return;
     }
     console.warn(message);
-    didWarn$1[message] = true;
+    didWarn[message] = true;
 };
 const useMediaInTimeline = ({ volume, mediaVolume, mediaRef, src, mediaType, playbackRate, }) => {
     const videoConfig = useVideoConfig();
@@ -1327,7 +1505,7 @@ const useMediaInTimeline = ({ volume, mediaVolume, mediaRef, src, mediaType, pla
     }, [duration, startsAt, volume, mediaVolume]);
     useEffect(() => {
         if (typeof volume === 'number' && volume !== initialVolume) {
-            warnOnce$1(`Remotion: The ${mediaType} with src ${src} has changed it's volume. Prefer the callback syntax for setting volume to get better timeline display: https://www.remotion.dev/docs/using-audio/#controlling-volume`);
+            warnOnce(`Remotion: The ${mediaType} with src ${src} has changed it's volume. Prefer the callback syntax for setting volume to get better timeline display: https://www.remotion.dev/docs/using-audio/#controlling-volume`);
         }
     }, [initialVolume, mediaType, src, volume]);
     useEffect(() => {
@@ -2399,24 +2577,6 @@ const validateDefaultAndInputProps = (defaultProps, name, compositionId) => {
     }
 };
 
-const validateFps = (fps, location, isGif) => {
-    if (typeof fps !== 'number') {
-        throw new Error(`"fps" must be a number, but you passed a value of type ${typeof fps} ${location}`);
-    }
-    if (!Number.isFinite(fps)) {
-        throw new Error(`"fps" must be a finite, but you passed ${fps} ${location}`);
-    }
-    if (isNaN(fps)) {
-        throw new Error(`"fps" must not be NaN, but got ${fps} ${location}`);
-    }
-    if (fps <= 0) {
-        throw new TypeError(`"fps" must be positive, but got ${fps} ${location}`);
-    }
-    if (isGif && fps > 50) {
-        throw new TypeError(`The FPS for a GIF cannot be higher than 50. Use the --every-nth-frame option to lower the FPS: https://remotion.dev/docs/render-as-gif`);
-    }
-};
-
 const Fallback = () => {
     useEffect(() => {
         const fallback = delayRender('Waiting for Root component to unsuspend');
@@ -2451,20 +2611,12 @@ const Composition = ({ width, height, fps, durationInFrames, id, defaultProps, s
             throw new Error('No id for composition passed.');
         }
         validateCompositionId(id);
-        validateDimension(width, 'width', 'of the <Composition/> component');
-        validateDimension(height, 'height', 'of the <Composition/> component');
-        validateDurationInFrames({
-            durationInFrames,
-            component: 'of the <Composition/> component',
-            allowFloats: false,
-        });
-        validateFps(fps, 'as a prop of the <Composition/> component', false);
         validateDefaultAndInputProps(defaultProps, 'defaultProps', id);
         registerComposition({
-            durationInFrames,
-            fps,
-            height,
-            width,
+            durationInFrames: durationInFrames !== null && durationInFrames !== void 0 ? durationInFrames : undefined,
+            fps: fps !== null && fps !== void 0 ? fps : undefined,
+            height: height !== null && height !== void 0 ? height : undefined,
+            width: width !== null && width !== void 0 ? width : undefined,
             id,
             folderName,
             component: lazy,
@@ -2718,6 +2870,7 @@ class Easing {
  * @see [Documentation](https://www.remotion.dev/docs/freeze)
  */
 const Freeze = ({ frame, children }) => {
+    const videoConfig = useVideoConfig();
     if (typeof frame === 'undefined') {
         throw new Error(`The <Freeze /> component requires a 'frame' prop, but none was passed.`);
     }
@@ -2738,9 +2891,11 @@ const Freeze = ({ frame, children }) => {
             imperativePlaying: {
                 current: false,
             },
-            frame,
+            frame: {
+                [videoConfig.id]: frame,
+            },
         };
-    }, [context, frame]);
+    }, [context, frame, videoConfig.id]);
     return (jsx(TimelineContext.Provider, { value: value, children: jsx(SequenceContext.Provider, { value: null, children: children }) }));
 };
 
@@ -3461,9 +3616,8 @@ const waitForRoot = (fn) => {
 };
 
 const RemotionRoot = ({ children, numberOfAudioTags }) => {
-    var _a;
     const [remotionRootId] = useState(() => String(random(null)));
-    const [frame, setFrame] = useState((_a = window.remotion_initialFrame) !== null && _a !== void 0 ? _a : 0);
+    const [frame, setFrame] = useState({});
     const [playing, setPlaying] = useState(false);
     const imperativePlaying = useRef(false);
     const [fastRefreshes, setFastRefreshes] = useState(0);
@@ -3472,9 +3626,12 @@ const RemotionRoot = ({ children, numberOfAudioTags }) => {
     if (typeof window !== 'undefined') {
         // eslint-disable-next-line react-hooks/rules-of-hooks
         useLayoutEffect(() => {
-            window.remotion_setFrame = (f) => {
+            window.remotion_setFrame = (f, composition) => {
                 const id = delayRender(`Setting the current frame to ${f}`);
-                setFrame(f);
+                setFrame((s) => ({
+                    ...s,
+                    [composition]: f,
+                }));
                 requestAnimationFrame(() => continueRender(id));
             };
             window.remotion_isPlayer = false;
@@ -3668,6 +3825,11 @@ const Internals = {
     REMOTION_STUDIO_CONTAINER_ELEMENT,
     AssetManager,
     bundleName: 'bundle.js',
+    persistCurrentFrame,
+    useTimelineSetFrame,
+    serializeJSONWithDate,
+    deserializeJSONWithCustomFields,
+    FILE_TOKEN,
 };
 
 const flattenChildren = (children) => {
@@ -3717,8 +3879,7 @@ const Series = ({ children }) => {
             const { durationInFrames, children: _children, from, ...passedProps } = castedChild.props; // `from` is not accepted and must be filtered out if used in JS
             if (i !== flattenedChildren.length - 1 ||
                 durationInFramesProp !== Infinity) {
-                validateDurationInFrames({
-                    durationInFrames: durationInFramesProp,
+                validateDurationInFrames(durationInFramesProp, {
                     component: `of a <Series.Sequence /> component`,
                     allowFloats: true,
                 });
@@ -3970,7 +4131,7 @@ function spring({ frame: passedFrame, fps, config = {}, from = 0, to = 1, durati
         };
     const frame = (reverse
         ? (passedDurationInFrames !== null && passedDurationInFrames !== void 0 ? passedDurationInFrames : naturalDurationGetter.get()) - passedFrame
-        : passedFrame) - delay;
+        : passedFrame) - (reverse ? -delay : delay);
     const spr = springCalculation({
         fps,
         frame: passedDurationInFrames === undefined
@@ -3989,89 +4150,6 @@ function spring({ frame: passedFrame, fps, config = {}, from = 0, to = 1, durati
     return Math.max(spr.current, to);
 }
 
-const problematicCharacters = {
-    '%3A': ':',
-    '%2F': '/',
-    '%3F': '?',
-    '%23': '#',
-    '%5B': '[',
-    '%5D': ']',
-    '%40': '@',
-    '%21': '!',
-    '%24': '$',
-    '%26': '&',
-    '%27': "'",
-    '%28': '(',
-    '%29': ')',
-    '%2A': '*',
-    '%2B': '+',
-    '%2C': ',',
-    '%3B': ';',
-};
-const didWarn = {};
-const warnOnce = (message) => {
-    if (didWarn[message]) {
-        return;
-    }
-    console.warn(message);
-    didWarn[message] = true;
-};
-const includesHexOfUnsafeChar = (path) => {
-    for (const key of Object.keys(problematicCharacters)) {
-        if (path.includes(key)) {
-            return { containsHex: true, hexCode: key };
-        }
-    }
-    return { containsHex: false };
-};
-const trimLeadingSlash = (path) => {
-    if (path.startsWith('/')) {
-        return trimLeadingSlash(path.substring(1));
-    }
-    return path;
-};
-const inner = (path) => {
-    if (typeof window !== 'undefined' && window.remotion_staticBase) {
-        return `${window.remotion_staticBase}/${trimLeadingSlash(path)}`;
-    }
-    return `/${trimLeadingSlash(path)}`;
-};
-/**
- * @description Reference a file from the public/ folder. If the file does not appear in the autocomplete, type the path manually.
- * @see [Documentation](https://www.remotion.dev/docs/staticfile)
- */
-const staticFile = (path) => {
-    if (path.startsWith('http://') || path.startsWith('https://')) {
-        throw new TypeError(`staticFile() does not support remote URLs - got "${path}". Instead, pass the URL without wrapping it in staticFile(). See: https://remotion.dev/docs/staticfile-remote-urls`);
-    }
-    if (path.startsWith('..') || path.startsWith('./')) {
-        throw new TypeError(`staticFile() does not support relative paths - got "${path}". Instead, pass the name of a file that is inside the public/ folder. See: https://remotion.dev/docs/staticfile-relative-paths`);
-    }
-    if (path.startsWith('/Users') ||
-        path.startsWith('/home') ||
-        path.startsWith('/tmp') ||
-        path.startsWith('/etc') ||
-        path.startsWith('/opt') ||
-        path.startsWith('/var') ||
-        path.startsWith('C:') ||
-        path.startsWith('D:') ||
-        path.startsWith('E:')) {
-        throw new TypeError(`staticFile() does not support absolute paths - got "${path}". Instead, pass the name of a file that is inside the public/ folder. See: https://remotion.dev/docs/staticfile-relative-paths`);
-    }
-    if (path.startsWith('public/')) {
-        throw new TypeError(`Do not include the public/ prefix when using staticFile() - got "${path}". See: https://remotion.dev/docs/staticfile-relative-paths`);
-    }
-    const includesHex = includesHexOfUnsafeChar(path);
-    if (includesHex.containsHex) {
-        warnOnce(`WARNING: You seem to pass an already encoded path (path contains ${includesHex.hexCode}). The encoding gets automatically handled by staticFile()  `);
-    }
-    const preparsed = inner(encodeURIComponent(path));
-    if (!preparsed.startsWith('/')) {
-        return `/${preparsed}`;
-    }
-    return preparsed;
-};
-
 /**
  * @description A `<Still />` is a `<Composition />` that is only 1 frame long.
  * @see [Documentation](https://www.remotion.dev/docs/still)
@@ -4622,7 +4700,7 @@ const Config = new Proxy(proxyObj, {
             console.warn('+ Replace:');
             console.warn('import {Config} from "@remotion/cli/config";');
             console.warn();
-            console.warn('For more information, see https://v4.remotion.dev/docs/4-0-migration.');
+            console.warn('For more information, see https://www.remotion.dev/docs/4-0-migration.');
             process.exit(1);
         };
     },

package/dist/esm/version.mjs

@@ -1,4 +1,4 @@
 // Automatically generated on publish
-const VERSION = '4.1.0-alpha5';
+const VERSION = '4.1.0-alpha8';
 
 export { VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remotion",
-  "version": "4.1.0-alpha5",
+  "version": "4.1.0-alpha8",
   "description": "Render videos in React",
   "main": "dist/cjs/index.js",
   "types": "dist/cjs/index.d.ts",