remotion 4.1.0-alpha1 → 4.1.0-alpha11

package/dist/cjs/input-props-serialization.js

@@ -0,0 +1,49 @@
+"use strict";
+// Must keep this file in sync with the one in packages/lambda/src/shared/serialize-props.ts!
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializeJSONWithCustomFields = exports.serializeJSONWithDate = exports.FILE_TOKEN = exports.DATE_TOKEN = void 0;
+const static_file_js_1 = require("./static-file.js");
+exports.DATE_TOKEN = 'remotion-date:';
+exports.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 `${exports.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 `${exports.FILE_TOKEN}${item.replace(staticBase + '/', '')}`;
+        }
+        return value;
+    }, indent);
+    return { serializedString, customDateUsed, customFileUsed, mapUsed, setUsed };
+};
+exports.serializeJSONWithDate = serializeJSONWithDate;
+const deserializeJSONWithCustomFields = (data) => {
+    return JSON.parse(data, (_, value) => {
+        if (typeof value === 'string' && value.startsWith(exports.DATE_TOKEN)) {
+            return new Date(value.replace(exports.DATE_TOKEN, ''));
+        }
+        if (typeof value === 'string' && value.startsWith(exports.FILE_TOKEN)) {
+            return (0, static_file_js_1.staticFile)(value.replace(exports.FILE_TOKEN, ''));
+        }
+        return value;
+    });
+};
+exports.deserializeJSONWithCustomFields = deserializeJSONWithCustomFields;

package/dist/cjs/internals.d.ts

@@ -1,52 +1,52 @@
 /// <reference types="react" />
-import type { CompProps } from './Composition.js';
+import { type CompProps } from './Composition.js';
 import type { TAsset, TCompMetadata, TComposition, TSequence } from './CompositionManager.js';
 import type { CompositionManagerContext } from './CompositionManagerContext.js';
 import * as CSSUtils from './default-css.js';
 import type { RemotionEnvironment } from './get-environment.js';
+import type { SerializedJSONWithCustomFields } from './input-props-serialization.js';
 import { processColor } from './interpolate-colors.js';
 import type { SetTimelineContextValue, TimelineContextValue } from './timeline-position-state.js';
 import * as TimelinePosition from './timeline-position-state.js';
 import { truthy } from './truthy.js';
+import { validateDimension } from './validation/validate-dimensions.js';
+import { validateDurationInFrames } from './validation/validate-duration-in-frames.js';
+import { validateFps } from './validation/validate-fps.js';
 import type { MediaVolumeContextValue, SetMediaVolumeContextValue } from './volume-position-state.js';
 import { useRemotionContexts } from './wrap-remotion-context.js';
 declare const Timeline: typeof TimelinePosition;
 export declare const Internals: {
-    useUnsafeVideoConfig: () => import("./video-config.js").VideoConfig | null;
-    Timeline: typeof TimelinePosition;
-    CompositionManager: import("react").Context<CompositionManagerContext>;
-    SequenceManager: import("react").Context<import("./SequenceManager.js").SequenceManagerContext>;
-    RemotionRoot: import("react").FC<{
+    readonly useUnsafeVideoConfig: () => import("./video-config.js").VideoConfig | null;
+    readonly Timeline: typeof TimelinePosition;
+    readonly CompositionManager: import("react").Context<CompositionManagerContext>;
+    readonly SequenceManager: import("react").Context<import("./SequenceManager.js").SequenceManagerContext>;
+    readonly RemotionRoot: import("react").FC<{
         children: import("react").ReactNode;
         numberOfAudioTags: number;
     }>;
-    useVideo: () => (import("./video-config.js").VideoConfig & {
-        component: import("react").LazyExoticComponent<import("react").ComponentType<Record<string, unknown> | undefined>>;
+    readonly useVideo: () => (import("./video-config.js").VideoConfig & {
+        component: import("react").LazyExoticComponent<import("react").ComponentType<Record<string, unknown>>>;
     }) | null;
-    getRoot: () => import("react").FC<{}> | null;
-    useMediaVolumeState: () => readonly [number, (u: number) => void];
-    useMediaMutedState: () => readonly [boolean, (u: import("react").SetStateAction<boolean>) => void];
-    useLazyComponent: <Props>(compProps: CompProps<Props>) => import("react").ExoticComponent<(import("react").PropsWithoutRef<Props> & import("react").RefAttributes<import("react").Component<Props, any, any>>) | import("react").PropsWithRef<Props>> & {
+    readonly getRoot: () => import("react").FC<{}> | null;
+    readonly useMediaVolumeState: () => readonly [number, (u: number) => void];
+    readonly useMediaMutedState: () => readonly [boolean, (u: import("react").SetStateAction<boolean>) => void];
+    readonly useLazyComponent: <Props>(compProps: CompProps<Props>) => import("react").ExoticComponent<(import("react").PropsWithoutRef<Props> & import("react").RefAttributes<import("react").Component<Props, any, any>>) | import("react").PropsWithRef<Props>> & {
         readonly _result: import("react").ComponentType<Props>;
     };
-    truthy: typeof truthy;
-    SequenceContext: import("react").Context<import("./SequenceContext.js").SequenceContextType | null>;
-    useRemotionContexts: typeof useRemotionContexts;
-    RemotionContextProvider: (props: import("./wrap-remotion-context.js").RemotionContextProviderProps) => JSX.Element;
-    CSSUtils: typeof CSSUtils;
-    setupEnvVariables: () => void;
-    MediaVolumeContext: import("react").Context<MediaVolumeContextValue>;
-    SetMediaVolumeContext: import("react").Context<SetMediaVolumeContextValue>;
-    validateDurationInFrames: ({ allowFloats, component, durationInFrames, }: {
-        durationInFrames: number;
-        component: string;
-        allowFloats: boolean;
-    }) => void;
-    validateFps: (fps: number, location: string, isGif: boolean) => void;
-    validateDefaultAndInputProps: (defaultProps: unknown, name: "defaultProps" | "inputProps", compositionId: string | null) => void;
-    validateDimension: (amount: number, nameOfProp: string, location: string) => void;
-    getRemotionEnvironment: () => RemotionEnvironment;
-    SharedAudioContext: import("react").Context<{
+    readonly truthy: typeof truthy;
+    readonly SequenceContext: import("react").Context<import("./SequenceContext.js").SequenceContextType | null>;
+    readonly useRemotionContexts: typeof useRemotionContexts;
+    readonly RemotionContextProvider: (props: import("./wrap-remotion-context.js").RemotionContextProviderProps) => JSX.Element;
+    readonly CSSUtils: typeof CSSUtils;
+    readonly setupEnvVariables: () => void;
+    readonly MediaVolumeContext: import("react").Context<MediaVolumeContextValue>;
+    readonly SetMediaVolumeContext: import("react").Context<SetMediaVolumeContextValue>;
+    readonly validateDurationInFrames: typeof validateDurationInFrames;
+    readonly validateFps: typeof validateFps;
+    readonly validateDefaultAndInputProps: (defaultProps: unknown, name: "defaultProps" | "inputProps", compositionId: string | null) => void;
+    readonly validateDimension: typeof validateDimension;
+    readonly getRemotionEnvironment: () => RemotionEnvironment;
+    readonly SharedAudioContext: import("react").Context<{
         registerAudio: (aud: import("./index.js").RemotionAudioProps, audioId: string) => {
             id: number;
             props: import("./index.js").RemotionAudioProps;
@@ -62,53 +62,54 @@ export declare const Internals: {
         playAllAudios: () => void;
         numberOfAudioTags: number;
     } | null>;
-    SharedAudioContextProvider: import("react").FC<{
+    readonly SharedAudioContextProvider: import("react").FC<{
         numberOfAudioTags: number;
         children: import("react").ReactNode;
-        component: import("react").LazyExoticComponent<import("react").ComponentType<Record<string, unknown> | undefined>> | null;
+        component: import("react").LazyExoticComponent<import("react").ComponentType<Record<string, unknown>>> | null;
     }>;
-    invalidCompositionErrorMessage: string;
-    isCompositionIdValid: (id: string) => RegExpMatchArray | null;
-    getPreviewDomElement: () => HTMLElement | null;
-    compositionsRef: import("react").RefObject<{
-        getCompositions: () => import("./CompositionManager.js").TCompMetadataWithCalcFunction<import("zod").AnyZodObject, Record<string, unknown> | undefined>[];
+    readonly invalidCompositionErrorMessage: string;
+    readonly isCompositionIdValid: (id: string) => RegExpMatchArray | null;
+    readonly getPreviewDomElement: () => HTMLElement | null;
+    readonly compositionsRef: import("react").RefObject<{
+        getCompositions: () => import("./CompositionManager.js").TCompMetadataWithCalcFunction<import("zod").AnyZodObject, Record<string, unknown>>[];
     }>;
-    DELAY_RENDER_CALLSTACK_TOKEN: string;
-    portalNode: () => HTMLElement;
-    waitForRoot: (fn: (comp: import("react").FC<{}>) => void) => () => void;
-    CanUseRemotionHooksProvider: import("react").FC<{
+    readonly DELAY_RENDER_CALLSTACK_TOKEN: "The delayRender was called:";
+    readonly portalNode: () => HTMLElement;
+    readonly waitForRoot: (fn: (comp: import("react").FC<{}>) => void) => () => void;
+    readonly CanUseRemotionHooksProvider: import("react").FC<{
         children: import("react").ReactNode;
     }>;
-    CanUseRemotionHooks: import("react").Context<boolean>;
-    PrefetchProvider: import("react").FC<{
+    readonly CanUseRemotionHooks: import("react").Context<boolean>;
+    readonly PrefetchProvider: import("react").FC<{
         children: import("react").ReactNode;
     }>;
-    DurationsContextProvider: import("react").FC<{
+    readonly DurationsContextProvider: import("react").FC<{
         children: import("react").ReactNode;
     }>;
-    IsPlayerContextProvider: import("react").FC<{
+    readonly IsPlayerContextProvider: import("react").FC<{
         children?: import("react").ReactNode;
     }>;
-    useIsPlayer: () => boolean;
-    useRemotionEnvironment: () => RemotionEnvironment;
-    validateFrame: ({ allowFloats, durationInFrames, frame, }: {
+    readonly useIsPlayer: () => boolean;
+    readonly useRemotionEnvironment: () => RemotionEnvironment;
+    readonly validateFrame: ({ allowFloats, durationInFrames, frame, }: {
         frame: number;
         durationInFrames: number;
         allowFloats: boolean;
     }) => void;
-    EditorPropsProvider: import("react").FC<{
+    readonly EditorPropsProvider: import("react").FC<{
         children: import("react").ReactNode;
     }>;
-    EditorPropsContext: import("react").Context<import("./EditorProps.js").EditorPropsContextType>;
-    usePreload: (src: string) => string;
-    processColor: typeof processColor;
-    NonceContext: import("react").Context<import("./nonce.js").TNonceContext>;
-    resolveVideoConfig: ({ composition, editorProps: editorPropsOrUndefined, signal, }: {
-        composition: import("./CompositionManager.js").TCompMetadataWithCalcFunction<import("zod").AnyZodObject, Record<string, unknown> | undefined>;
+    readonly EditorPropsContext: import("react").Context<import("./EditorProps.js").EditorPropsContextType>;
+    readonly usePreload: (src: string) => string;
+    readonly processColor: typeof processColor;
+    readonly NonceContext: import("react").Context<import("./nonce.js").TNonceContext>;
+    readonly resolveVideoConfig: ({ composition, editorProps: editorPropsOrUndefined, signal, inputProps, }: {
+        composition: import("./CompositionManager.js").TCompMetadataWithCalcFunction<import("zod").AnyZodObject, Record<string, unknown>>;
         editorProps: object;
         signal: AbortSignal;
+        inputProps: Record<string, unknown>;
     }) => import("./video-config.js").VideoConfig | Promise<import("./video-config.js").VideoConfig>;
-    useResolvedVideoConfig: (preferredCompositionId: string | null) => ({
+    readonly useResolvedVideoConfig: (preferredCompositionId: string | null) => ({
         type: "loading";
     } | {
         type: "success";
@@ -117,15 +118,32 @@ export declare const Internals: {
         type: "error";
         error: Error;
     }) | null;
-    resolveCompositionsRef: import("react").RefObject<{
+    readonly resolveCompositionsRef: import("react").RefObject<{
         setCurrentRenderModalComposition: (compositionId: string | null) => void;
         reloadCurrentlySelectedComposition: () => void;
     }>;
-    ResolveCompositionConfig: import("react").FC<import("react").PropsWithChildren<{
+    readonly ResolveCompositionConfig: import("react").FC<import("react").PropsWithChildren<{
         children: import("react").ReactNode;
     }>>;
-    REMOTION_STUDIO_CONTAINER_ELEMENT: string;
-    AssetManager: import("react").Context<import("./AssetManager.js").AssetManagerContext>;
-    bundleName: string;
+    readonly REMOTION_STUDIO_CONTAINER_ELEMENT: "__remotion-studio-container";
+    readonly AssetManager: import("react").Context<import("./AssetManager.js").AssetManagerContext>;
+    readonly bundleName: "bundle.js";
+    readonly bundleMapName: "bundle.js.map";
+    readonly persistCurrentFrame: (frame: number, composition: string) => void;
+    readonly useTimelineSetFrame: () => (u: import("react").SetStateAction<Record<string, number>>) => void;
+    readonly serializeJSONWithDate: ({ data, indent, staticBase, }: {
+        data: Record<string, unknown>;
+        indent: number | undefined;
+        staticBase: string | null;
+    }) => SerializedJSONWithCustomFields;
+    readonly deserializeJSONWithCustomFields: (data: string) => Record<string, unknown>;
+    readonly FILE_TOKEN: "remotion-file:";
+    readonly DATE_TOKEN: "remotion-date:";
+    readonly NativeLayersProvider: import("react").FC<{
+        children?: import("react").ReactNode;
+    }>;
+    readonly ClipComposition: import("react").FC<{
+        children?: import("react").ReactNode;
+    }>;
 };
-export type { TComposition, Timeline, TCompMetadata, TSequence, TAsset, TimelineContextValue, SetTimelineContextValue, CompProps, CompositionManagerContext, MediaVolumeContextValue, SetMediaVolumeContextValue, RemotionEnvironment, };
+export type { TComposition, Timeline, TCompMetadata, TSequence, TAsset, TimelineContextValue, SetTimelineContextValue, CompProps, CompositionManagerContext, MediaVolumeContextValue, SetMediaVolumeContextValue, RemotionEnvironment, SerializedJSONWithCustomFields, };

package/dist/cjs/internals.js

@@ -27,6 +27,7 @@ exports.Internals = void 0;
 const AssetManager_js_1 = require("./AssetManager.js");
 const shared_audio_tags_js_1 = require("./audio/shared-audio-tags.js");
 const CanUseRemotionHooks_js_1 = require("./CanUseRemotionHooks.js");
+const Composition_js_1 = require("./Composition.js");
 const CompositionManager_js_1 = require("./CompositionManager.js");
 const CompositionManagerContext_js_1 = require("./CompositionManagerContext.js");
 const CSSUtils = __importStar(require("./default-css.js"));
@@ -34,8 +35,10 @@ const delay_render_js_1 = require("./delay-render.js");
 const EditorProps_js_1 = require("./EditorProps.js");
 const get_environment_js_1 = require("./get-environment.js");
 const get_preview_dom_element_js_1 = require("./get-preview-dom-element.js");
+const input_props_serialization_js_1 = require("./input-props-serialization.js");
 const interpolate_colors_js_1 = require("./interpolate-colors.js");
 const is_player_js_1 = require("./is-player.js");
+const NativeLayers_js_1 = require("./NativeLayers.js");
 const nonce_js_1 = require("./nonce.js");
 const portal_node_js_1 = require("./portal-node.js");
 const prefetch_state_js_1 = require("./prefetch-state.js");
@@ -48,6 +51,7 @@ const SequenceContext_js_1 = require("./SequenceContext.js");
 const SequenceManager_js_1 = require("./SequenceManager.js");
 const setup_env_variables_js_1 = require("./setup-env-variables.js");
 const TimelinePosition = __importStar(require("./timeline-position-state.js"));
+const timeline_position_state_js_1 = require("./timeline-position-state.js");
 const truthy_js_1 = require("./truthy.js");
 const use_lazy_component_js_1 = require("./use-lazy-component.js");
 const use_unsafe_video_config_js_1 = require("./use-unsafe-video-config.js");
@@ -117,4 +121,13 @@ exports.Internals = {
     REMOTION_STUDIO_CONTAINER_ELEMENT: get_preview_dom_element_js_1.REMOTION_STUDIO_CONTAINER_ELEMENT,
     AssetManager: AssetManager_js_1.AssetManager,
     bundleName: 'bundle.js',
+    bundleMapName: 'bundle.js.map',
+    persistCurrentFrame: timeline_position_state_js_1.persistCurrentFrame,
+    useTimelineSetFrame: timeline_position_state_js_1.useTimelineSetFrame,
+    serializeJSONWithDate: input_props_serialization_js_1.serializeJSONWithDate,
+    deserializeJSONWithCustomFields: input_props_serialization_js_1.deserializeJSONWithCustomFields,
+    FILE_TOKEN: input_props_serialization_js_1.FILE_TOKEN,
+    DATE_TOKEN: input_props_serialization_js_1.DATE_TOKEN,
+    NativeLayersProvider: NativeLayers_js_1.NativeLayersProvider,
+    ClipComposition: Composition_js_1.ClipComposition,
 };

package/dist/cjs/loop/index.js

@@ -14,8 +14,7 @@ const validate_duration_in_frames_js_1 = require("../validation/validate-duratio
 const Loop = ({ durationInFrames, times = Infinity, children, name, ...props }) => {
     const currentFrame = (0, use_current_frame_js_1.useCurrentFrame)();
     const { durationInFrames: compDuration } = (0, use_video_config_js_1.useVideoConfig)();
-    (0, validate_duration_in_frames_js_1.validateDurationInFrames)({
-        durationInFrames,
+    (0, validate_duration_in_frames_js_1.validateDurationInFrames)(durationInFrames, {
         component: 'of the <Loop /> component',
         allowFloats: true,
     });

package/dist/cjs/props-if-has-props.d.ts

@@ -1,10 +1,10 @@
 import type { AnyZodObject, z } from 'zod';
 type And<A extends boolean, B extends boolean> = A extends true ? B extends true ? true : false : false;
-export type PropsIfHasProps<Schema extends AnyZodObject, Props extends Record<string, unknown> | undefined> = And<AnyZodObject extends Schema ? true : false, {} extends Props ? true : false> extends true ? {
+export type PropsIfHasProps<Schema extends AnyZodObject, Props extends Record<string, unknown>> = And<AnyZodObject extends Schema ? true : false, {} extends Props ? true : false> extends true ? {
     defaultProps?: {};
 } : {
     defaultProps: InferProps<Schema, Props>;
 };
-export type InferProps<Schema extends AnyZodObject, Props extends Record<string, unknown> | undefined> = AnyZodObject extends Schema ? {} extends Props ? Record<string, unknown> : Props : {} extends Props ? z.infer<Schema> : // Props and schema specified
+export type InferProps<Schema extends AnyZodObject, Props extends Record<string, unknown>> = AnyZodObject extends Schema ? {} extends Props ? Record<string, unknown> : Props : {} extends Props ? z.infer<Schema> : // Props and schema specified
 z.infer<Schema> & Props;
 export {};

package/dist/cjs/resolve-video-config.d.ts

@@ -1,8 +1,9 @@
 import type { AnyZodObject } from 'zod';
 import type { TCompMetadataWithCalcFunction } from './CompositionManager.js';
 import type { VideoConfig } from './video-config.js';
-export declare const resolveVideoConfig: ({ composition, editorProps: editorPropsOrUndefined, signal, }: {
-    composition: TCompMetadataWithCalcFunction<AnyZodObject, Record<string, unknown> | undefined>;
+export declare const resolveVideoConfig: ({ composition, editorProps: editorPropsOrUndefined, signal, inputProps, }: {
+    composition: TCompMetadataWithCalcFunction<AnyZodObject, Record<string, unknown>>;
     editorProps: object;
     signal: AbortSignal;
+    inputProps: Record<string, unknown>;
 }) => VideoConfig | Promise<VideoConfig>;

package/dist/cjs/resolve-video-config.js

@@ -1,23 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveVideoConfig = void 0;
-const input_props_js_1 = require("./config/input-props.js");
-const get_environment_js_1 = require("./get-environment.js");
 const validate_dimensions_js_1 = require("./validation/validate-dimensions.js");
 const validate_duration_in_frames_js_1 = require("./validation/validate-duration-in-frames.js");
-const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined, signal, }) => {
-    var _a, _b, _c, _d, _e, _f;
+const validate_fps_js_1 = require("./validation/validate-fps.js");
+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' ||
-                    (0, get_environment_js_1.getRemotionEnvironment)() === 'player-development' ||
-                    (0, get_environment_js_1.getRemotionEnvironment)() === 'player-production'
-                    ? {}
-                    : (_c = (0, input_props_js_1.getInputProps)()) !== null && _c !== void 0 ? _c : {}),
+                ...inputProps,
             },
             abortSignal: signal,
         })
@@ -26,7 +21,7 @@ const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined,
         typeof calculatedProm === 'object' &&
         'then' in calculatedProm) {
         return calculatedProm.then((c) => {
-            var _a, _b;
+            var _a, _b, _c;
             const { height, width, durationInFrames, fps } = validateCalculated({
                 calculated: c,
                 composition,
@@ -37,7 +32,8 @@ const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined,
                 fps,
                 durationInFrames,
                 id: composition.id,
-                defaultProps: (_b = (_a = c.props) !== null && _a !== void 0 ? _a : composition.defaultProps) !== null && _b !== void 0 ? _b : {},
+                defaultProps: (_a = composition.defaultProps) !== null && _a !== void 0 ? _a : {},
+                props: (_c = (_b = c.props) !== null && _b !== void 0 ? _b : composition.defaultProps) !== null && _c !== void 0 ? _c : {},
             };
         });
     }
@@ -49,41 +45,35 @@ const resolveVideoConfig = ({ composition, editorProps: editorPropsOrUndefined,
         return {
             ...data,
             id: composition.id,
-            defaultProps: (_d = composition === null || composition === void 0 ? void 0 : composition.defaultProps) !== null && _d !== void 0 ? _d : {},
+            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 = (_e = calculatedProm === null || calculatedProm === void 0 ? void 0 : calculatedProm.props) !== null && _e !== void 0 ? _e : composition.defaultProps) !== null && _f !== void 0 ? _f : {},
+        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 : {},
     };
 };
 exports.resolveVideoConfig = resolveVideoConfig;
 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.');
-    }
-    (0, validate_dimensions_js_1.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.');
-    }
-    (0, validate_dimensions_js_1.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;
+    (0, validate_dimensions_js_1.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;
+    (0, validate_dimensions_js_1.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.');
-    }
+    (0, validate_fps_js_1.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.');
-    }
-    (0, validate_duration_in_frames_js_1.validateDurationInFrames)({
-        durationInFrames,
-        component: potentialErrorLocation,
+    (0, validate_duration_in_frames_js_1.validateDurationInFrames)(durationInFrames, {
         allowFloats: false,
+        component: `of the "<Composition />" component with the id "${composition.id}"`,
     });
     return { width, height, fps, durationInFrames };
 };

package/dist/cjs/series/index.js

@@ -38,11 +38,10 @@ const Series = ({ children }) => {
                 throw new TypeError(`A <Series.Sequence /> component (${debugInfo}) was detected to not have any children. Delete it to fix this error.`);
             }
             const durationInFramesProp = castedChild.props.durationInFrames;
-            const { durationInFrames, children: _children, ...passedProps } = castedChild.props;
+            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) {
-                (0, validate_duration_in_frames_js_1.validateDurationInFrames)({
-                    durationInFrames: durationInFramesProp,
+                (0, validate_duration_in_frames_js_1.validateDurationInFrames)(durationInFramesProp, {
                     component: `of a <Series.Sequence /> component`,
                     allowFloats: true,
                 });

package/dist/cjs/spring/index.js

@@ -52,7 +52,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 = (0, spring_utils_js_1.springCalculation)({
         fps,
         frame: passedDurationInFrames === undefined

package/dist/cjs/static-file.js

@@ -49,6 +49,14 @@ const inner = (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)
@@ -76,9 +84,10 @@ const staticFile = (path) => {
     }
     const includesHex = (0, exports.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()  `);
+        warnOnce(`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 preparsed = inner(encodeURIComponent(path));
+    const preprocessed = encodeBySplitting(path);
+    const preparsed = inner(preprocessed);
     if (!preparsed.startsWith('/')) {
         return `/${preparsed}`;
     }

package/dist/cjs/timeline-position-state.d.ts

@@ -4,7 +4,7 @@ export type PlayableMediaTag = {
     id: string;
 };
 export type TimelineContextValue = {
-    frame: number;
+    frame: Record<string, number>;
     playing: boolean;
     rootId: string;
     playbackRate: number;
@@ -13,13 +13,15 @@ export type TimelineContextValue = {
     audioAndVideoTags: MutableRefObject<PlayableMediaTag[]>;
 };
 export type SetTimelineContextValue = {
-    setFrame: (u: React.SetStateAction<number>) => void;
+    setFrame: (u: React.SetStateAction<Record<string, number>>) => void;
     setPlaying: (u: React.SetStateAction<boolean>) => void;
 };
 export declare const TimelineContext: import("react").Context<TimelineContextValue>;
 export declare const SetTimelineContext: import("react").Context<SetTimelineContextValue>;
+export declare const persistCurrentFrame: (frame: number, composition: string) => void;
+export declare const getFrameForComposition: (composition: string) => number;
 export declare const useTimelinePosition: () => number;
-export declare const useTimelineSetFrame: () => (u: React.SetStateAction<number>) => void;
+export declare const useTimelineSetFrame: () => (u: React.SetStateAction<Record<string, number>>) => void;
 type PlayingReturnType = readonly [
     boolean,
     (u: React.SetStateAction<boolean>) => void,

package/dist/cjs/timeline-position-state.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usePlayingState = exports.useTimelineSetFrame = exports.useTimelinePosition = exports.SetTimelineContext = exports.TimelineContext = void 0;
+exports.usePlayingState = exports.useTimelineSetFrame = exports.useTimelinePosition = exports.getFrameForComposition = exports.persistCurrentFrame = exports.SetTimelineContext = exports.TimelineContext = void 0;
 const react_1 = require("react");
 const use_video_js_1 = require("./use-video.js");
 exports.TimelineContext = (0, react_1.createContext)({
-    frame: 0,
+    frame: {},
     playing: false,
     playbackRate: 1,
     rootId: '',
@@ -24,16 +24,34 @@ exports.SetTimelineContext = (0, react_1.createContext)({
         throw new Error('default');
     },
 });
+const makeKey = (composition) => {
+    return `remotion.time.${composition}`;
+};
+const persistCurrentFrame = (frame, composition) => {
+    localStorage.setItem(makeKey(composition), String(frame));
+};
+exports.persistCurrentFrame = persistCurrentFrame;
+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;
+};
+exports.getFrameForComposition = getFrameForComposition;
 const useTimelinePosition = () => {
+    var _a, _b;
     const videoConfig = (0, use_video_js_1.useVideo)();
     const state = (0, react_1.useContext)(exports.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
+        : (0, exports.getFrameForComposition)(videoConfig.id));
+    return Math.min(videoConfig.durationInFrames - 1, unclamped);
 };
 exports.useTimelinePosition = useTimelinePosition;
 const useTimelineSetFrame = () => {

package/dist/cjs/use-unsafe-video-config.js

@@ -13,7 +13,7 @@ const useUnsafeVideoConfig = () => {
         if (!video) {
             return null;
         }
-        const { id, durationInFrames, fps, height, width, defaultProps } = video;
+        const { id, durationInFrames, fps, height, width, defaultProps, props } = video;
         return {
             id,
             width,
@@ -21,6 +21,7 @@ const useUnsafeVideoConfig = () => {
             fps,
             durationInFrames: ctxDuration !== null && ctxDuration !== void 0 ? ctxDuration : durationInFrames,
             defaultProps,
+            props,
         };
     }, [ctxDuration, video]);
 };

package/dist/cjs/use-video.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentType, LazyExoticComponent } from 'react';
 import type { VideoConfig } from './video-config.js';
 type ReturnType = (VideoConfig & {
-    component: LazyExoticComponent<ComponentType<Record<string, unknown> | undefined>>;
+    component: LazyExoticComponent<ComponentType<Record<string, unknown>>>;
 }) | null;
 export declare const useVideo: () => ReturnType;
 export {};

package/dist/cjs/use-video.js

@@ -11,7 +11,7 @@ const useVideo = () => {
     });
     const resolved = (0, ResolveCompositionConfig_js_1.useResolvedVideoConfig)(context.currentComposition);
     return (0, react_1.useMemo)(() => {
-        var _a;
+        var _a, _b;
         if (!resolved) {
             return null;
         }
@@ -26,11 +26,11 @@ const useVideo = () => {
         }
         return {
             ...resolved.result,
-            defaultProps: selected.defaultProps,
+            defaultProps: (_a = selected.defaultProps) !== null && _a !== void 0 ? _a : {},
             id: selected.id,
             // We override the selected metadata with the metadata that was passed to renderMedia(),
             // and don't allow it to be changed during render anymore
-            ...((_a = context.currentCompositionMetadata) !== null && _a !== void 0 ? _a : {}),
+            ...((_b = context.currentCompositionMetadata) !== null && _b !== void 0 ? _b : {}),
             component: selected.component,
         };
     }, [context.currentCompositionMetadata, resolved, selected]);