remotion 4.0.485 → 4.0.487

package/LICENSE.md

@@ -0,0 +1,49 @@
+# Remotion License
+
+In Remotion 5.0, the license will slightly change. [View the changes here](https://github.com/remotion-dev/remotion/pull/3750).
+
+---
+
+Depending on the type of your legal entity, you are granted permission to use Remotion for your project. Individuals and small companies are allowed to use Remotion to create videos for free (even commercial), while a company license is required for for-profit organizations of a certain size. This two-tier system was designed to ensure funding for this project while still allowing the source code to be available and the program to be free for most. Read below for the exact terms of use.
+
+- [Free License](#free-license)
+- [Company License](#company-license)
+
+## Free License
+
+Copyright © 2026 [Remotion](https://www.remotion.dev)
+
+### Eligibility
+
+You are eligible to use Remotion for free if you are:
+
+- an individual
+- a for-profit organization with up to 3 employees
+- a non-profit or not-for-profit organization
+- evaluating whether Remotion is a good fit, and are not yet using it in a commercial way
+
+### Allowed use cases
+
+Permission is hereby granted, free of charge, to any person eligible for the "Free License", to use the software non-commercially or commercially for the purpose of creating videos and images and to modify the software to their own liking, for the purpose of fulfilling their custom use case or to contribute bug fixes or improvements back to Remotion.
+
+### Disallowed use cases
+
+It is not allowed to copy or modify Remotion code for the purpose of selling, renting, licensing, relicensing, or sublicensing your own derivate of Remotion.
+
+### Warranty notice
+
+The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the author or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.
+
+### Support
+
+Support is provided on a best-we-can-do basis via GitHub Issues and Discord.
+
+## Company License
+
+You are required to obtain a Company License to use Remotion if you are not within the group of entities eligible for a Free License. This license will enable you to use Remotion for the allowed use cases specified in the Free License, and give you access to prioritized support (read the [Support Policy](https://www.remotion.dev/docs/support)).
+
+Visit [remotion.pro](https://www.remotion.pro/license) for pricing and to buy a license.
+
+### FAQs
+
+Are you not sure whether you need a Company License because of an edge case? Here are some [frequently asked questions](https://www.remotion.pro/faq).

package/dist/cjs/Folder.d.ts

@@ -1,4 +1,4 @@
-import type { FC } from 'react';
+import type { FC, ReactNode } from 'react';
 import type { NonceHistory } from './nonce.js';
 export type TFolder = {
     name: string;
@@ -13,6 +13,6 @@ type FolderContextType = {
 export declare const FolderContext: import("react").Context<FolderContextType>;
 export declare const Folder: FC<{
     readonly name: string;
-    readonly children: React.ReactNode;
+    readonly children?: ReactNode;
 }>;
 export {};

package/dist/cjs/HtmlInCanvas.js

@@ -104,8 +104,7 @@ const HtmlInCanvasContent = (0, react_1.forwardRef)(({ width, height, effects, c
             ref(node);
         }
         else if (ref) {
-            ref.current =
-                node;
+            ref.current = node;
         }
     }, [ref]);
     const chainState = (0, use_effect_chain_state_js_1.useEffectChainState)();
@@ -319,8 +318,7 @@ const HtmlInCanvasInner = (0, react_1.forwardRef)(({ width, height, effects = []
             ref(node);
         }
         else if (ref) {
-            ref.current =
-                node;
+            ref.current = node;
         }
     }, [ref]);
     return (jsx_runtime_1.jsx(Sequence_js_1.Sequence, { durationInFrames: resolvedDuration, name: name !== null && name !== void 0 ? name : '<HtmlInCanvas>', _remotionInternalDocumentationLink: "https://www.remotion.dev/docs/remotion/html-in-canvas", controls: controls, _remotionInternalEffects: memoizedEffectDefinitions, outlineRef: actualRef, layout: "none", ...sequenceProps, children: jsx_runtime_1.jsx(HtmlInCanvasContent, { ref: setCanvasRef, width: width, height: height, effects: effects, onPaint: onPaint, onInit: onInit, pixelDensity: pixelDensity, controls: controls, style: style, children: children }) }));

package/dist/cjs/Interactive.d.ts

@@ -94,6 +94,12 @@ export declare const Interactive: {
             readonly default: undefined;
             readonly description: "Color";
         };
+        readonly 'style.fontFamily': {
+            readonly type: "font-family";
+            readonly default: undefined;
+            readonly description: "Font family";
+            readonly keyframable: false;
+        };
         readonly 'style.fontSize': {
             readonly type: "number";
             readonly default: undefined;

package/dist/cjs/ResolveCompositionConfig.d.ts

@@ -5,6 +5,7 @@ export declare const ResolveCompositionContext: import("react").Context<ResolveC
 export declare const resolveCompositionsRef: import("react").RefObject<{
     setCurrentRenderModalComposition: (compositionId: string | null) => void;
     reloadCurrentlySelectedComposition: () => void;
+    resolveComposition: (compositionId: string) => Promise<VideoConfig>;
 } | null>;
 type VideoConfigState = {
     type: 'loading';

package/dist/cjs/Still.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Still = void 0;
 const react_1 = __importDefault(require("react"));
 const Composition_js_1 = require("./Composition.js");
+const enable_sequence_stack_traces_js_1 = require("./enable-sequence-stack-traces.js");
 /*
  * @description A `<Still />` is a `<Composition />` that is only 1 frame long.
  * @see [Documentation](https://www.remotion.dev/docs/still)
@@ -20,3 +21,4 @@ const Still = (props) => {
     return react_1.default.createElement(Composition_js_1.Composition, newProps);
 };
 exports.Still = Still;
+(0, enable_sequence_stack_traces_js_1.addSequenceStackTraces)(exports.Still);

package/dist/cjs/TimelineContext.d.ts

@@ -1,12 +1,12 @@
-import type { MutableRefObject } from 'react';
+import type { RefObject } from 'react';
 import React from 'react';
 import { type PlayableMediaTag } from './timeline-position-state';
 export type TimelineContextValue = {
     frame: Record<string, number>;
     playing: boolean;
     rootId: string;
-    imperativePlaying: MutableRefObject<boolean>;
-    audioAndVideoTags: MutableRefObject<PlayableMediaTag[]>;
+    imperativePlaying: RefObject<boolean>;
+    audioAndVideoTags: RefObject<PlayableMediaTag[]>;
 };
 export type PlaybackRateContextValue = {
     playbackRate: number;

package/dist/cjs/buffering.d.ts

@@ -17,7 +17,7 @@ type BufferManager = {
     addBlock: AddBlock;
     listenForBuffering: ListenForBuffering;
     listenForResume: ListenForResume;
-    buffering: React.MutableRefObject<boolean>;
+    buffering: React.RefObject<boolean>;
 };
 export declare const BufferingContextReact: React.Context<BufferManager | null>;
 export declare const BufferingProvider: React.FC<{

package/dist/cjs/buffering.js

@@ -90,7 +90,11 @@ const useBufferManager = (logLevel, mountTime) => {
         if (rendering) {
             return;
         }
-        if (blocks.length > 0) {
+        // Only fire on the `false -> true` transition: adding a block while
+        // already buffering (e.g. a second media element starts loading) must
+        // not re-dispatch `waiting` to listeners.
+        if (blocks.length > 0 && !buffering.current) {
+            buffering.current = true;
             onBufferingCallbacks.forEach((c) => c());
             (0, playback_logging_1.playbackLogging)({
                 logLevel,
@@ -110,7 +114,11 @@ const useBufferManager = (logLevel, mountTime) => {
             if (rendering) {
                 return;
             }
-            if (blocks.length === 0) {
+            // Only fire on the `true -> false` transition: the initial mount and
+            // a block that was added and removed within the same commit must not
+            // dispatch `resume` to listeners.
+            if (blocks.length === 0 && buffering.current) {
+                buffering.current = false;
                 onResumeCallbacks.forEach((c) => c());
                 (0, playback_logging_1.playbackLogging)({
                     logLevel,
@@ -145,11 +153,11 @@ const useIsPlayerBuffering = (bufferManager) => {
         const onResume = () => {
             setIsBuffering(false);
         };
-        bufferManager.listenForBuffering(onBuffer);
-        bufferManager.listenForResume(onResume);
+        const buffer = bufferManager.listenForBuffering(onBuffer);
+        const resume = bufferManager.listenForResume(onResume);
         return () => {
-            bufferManager.listenForBuffering(() => undefined);
-            bufferManager.listenForResume(() => undefined);
+            buffer.remove();
+            resume.remove();
         };
     }, [bufferManager]);
     return isBuffering;

package/dist/cjs/canvas-image/CanvasImage.js

@@ -86,6 +86,14 @@ const loadImage = ({ src, signal, }) => {
 function exponentialBackoff(errorCount) {
     return 1000 * 2 ** (errorCount - 1);
 }
+const waitForNextFrame = ({ onFrame, }) => {
+    if (typeof requestAnimationFrame === 'undefined') {
+        onFrame();
+        return () => undefined;
+    }
+    const frame = requestAnimationFrame(onFrame);
+    return () => cancelAnimationFrame(frame);
+};
 const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit = 'fill', effects, controls, onError, className, style, id, pauseWhenLoading, maxRetries = 2, delayRenderRetries, delayRenderTimeoutInMilliseconds, refForOutline, ...canvasProps }, ref) => {
     var _a;
     const { delayRender, continueRender, cancelRender } = (0, use_delay_render_js_1.useDelayRender)();
@@ -99,6 +107,17 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
         overrideId: (_a = controls === null || controls === void 0 ? void 0 : controls.overrideId) !== null && _a !== void 0 ? _a : null,
     });
     const sequenceContext = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
+    const pendingLoadDelayRef = (0, react_1.useRef)(null);
+    const continuePendingLoadDelay = (0, react_1.useCallback)(() => {
+        const pending = pendingLoadDelayRef.current;
+        if (!pending || pending.continued) {
+            return;
+        }
+        pending.continued = true;
+        pending.unblock();
+        continueRender(pending.handle);
+        pendingLoadDelayRef.current = null;
+    }, [continueRender]);
     const sourceCanvas = (0, react_1.useMemo)(() => {
         if (typeof document === 'undefined') {
             return null;
@@ -117,7 +136,7 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
             ref.current = canvas;
         }
     }, [ref, refForOutline]);
-    (0, react_1.useEffect)(() => {
+    (0, react_1.useLayoutEffect)(() => {
         const isPremounting = Boolean(sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.premounting);
         const isPostmounting = Boolean(sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.postmounting);
         const handle = delayRender(`Rendering <CanvasImage> with src="${(0, truncate_src_for_label_js_1.truncateSrcForLabel)(actualSrc)}"`, {
@@ -129,17 +148,13 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
             : () => undefined;
         const controller = new AbortController();
         let cancelled = false;
-        let continued = false;
         let errorCount = 0;
         let timeoutId = null;
         setLoadedImage(null);
-        const continueRenderOnce = () => {
-            if (continued) {
-                return;
-            }
-            continued = true;
-            unblock();
-            continueRender(handle);
+        pendingLoadDelayRef.current = {
+            handle,
+            unblock,
+            continued: false,
         };
         const attemptLoad = () => {
             loadImage({ src: actualSrc, signal: controller.signal })
@@ -148,15 +163,10 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
                     return;
                 }
                 setLoadedImage(image);
-            })
-                .then(() => {
-                if (!cancelled) {
-                    continueRenderOnce();
-                }
             })
                 .catch((err) => {
                 if (err.name === 'AbortError') {
-                    continueRenderOnce();
+                    continuePendingLoadDelay();
                     return;
                 }
                 errorCount++;
@@ -172,7 +182,7 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
                 }
                 else if (onError) {
                     onError(err);
-                    continueRenderOnce();
+                    continuePendingLoadDelay();
                 }
                 else {
                     cancelRender(err);
@@ -186,12 +196,12 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
                 clearTimeout(timeoutId);
             }
             controller.abort();
-            continueRenderOnce();
+            continuePendingLoadDelay();
         };
     }, [
         actualSrc,
         cancelRender,
-        continueRender,
+        continuePendingLoadDelay,
         delayPlayback,
         delayRender,
         delayRenderRetries,
@@ -202,13 +212,14 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
         sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.postmounting,
         sequenceContext === null || sequenceContext === void 0 ? void 0 : sequenceContext.premounting,
     ]);
-    (0, react_1.useEffect)(() => {
+    (0, react_1.useLayoutEffect)(() => {
         if (!loadedImage || !outputCanvas || !sourceCanvas) {
             return;
         }
         const handle = delayRender(`Applying effects to <CanvasImage> with src="${(0, truncate_src_for_label_js_1.truncateSrcForLabel)(actualSrc)}"`);
         let cancelled = false;
         let continued = false;
+        let cancelWaitForNextFrame = () => undefined;
         const continueRenderOnce = () => {
             if (continued) {
                 return;
@@ -244,7 +255,15 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
         })
             .then((completed) => {
             if (completed && !cancelled) {
-                continueRenderOnce();
+                cancelWaitForNextFrame = waitForNextFrame({
+                    onFrame: () => {
+                        if (cancelled) {
+                            return;
+                        }
+                        continueRenderOnce();
+                        continuePendingLoadDelay();
+                    },
+                });
             }
         })
             .catch((err) => {
@@ -254,6 +273,7 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
             if (onError) {
                 onError(err);
                 continueRenderOnce();
+                continuePendingLoadDelay();
             }
             else {
                 cancelRender(err);
@@ -261,6 +281,7 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
         });
         return () => {
             cancelled = true;
+            cancelWaitForNextFrame();
             continueRenderOnce();
         };
     }, [
@@ -268,6 +289,7 @@ const CanvasImageContent = (0, react_1.forwardRef)(({ src, width, height, fit =
         cancelRender,
         chainState,
         continueRender,
+        continuePendingLoadDelay,
         delayRender,
         fit,
         height,

package/dist/cjs/get-media-sync-action.d.ts

@@ -0,0 +1,44 @@
+export type MediaSyncAction = {
+    type: 'seek-due-to-shift';
+    shouldBeTime: number;
+    why: string;
+    bufferUntilFirstFrame: boolean;
+    playReason: string | null;
+    warnAboutNonSeekable: boolean;
+} | {
+    type: 'seek-if-not-playing';
+    shouldBeTime: number;
+    why: string | null;
+} | {
+    type: 'play-and-seek';
+    shouldBeTime: number;
+    why: string | null;
+    playReason: string;
+    bufferUntilFirstFrame: boolean;
+} | {
+    type: 'none';
+};
+export type GetMediaSyncActionInput = {
+    duration: number;
+    currentTime: number;
+    paused: boolean;
+    ended: boolean;
+    desiredUnclampedTime: number;
+    mediaTagTime: number;
+    mediaTagLastUpdate: number;
+    rvcTime: number | null;
+    rvcLastUpdate: number | null;
+    isVariableFpsVideo: boolean;
+    acceptableTimeShift: number;
+    lastSeekDueToShift: number | null;
+    playing: boolean;
+    playbackRate: number;
+    mediaTagBufferingOrStalled: boolean;
+    playerBuffering: boolean;
+    absoluteFrame: number;
+    onlyWarnForMediaSeekingError: boolean;
+    isPremounting: boolean;
+    isPostmounting: boolean;
+    pauseWhenBuffering: boolean;
+};
+export declare const getMediaSyncAction: (input: GetMediaSyncActionInput) => MediaSyncAction;

package/dist/cjs/get-media-sync-action.js

@@ -0,0 +1,78 @@
+"use strict";
+// Pure decision logic for `useMediaPlayback`.
+//
+// Every frame, the media element's clock has to be reconciled with the
+// timeline clock. This function takes a snapshot of the relevant state and
+// decides *what* should happen (seek / play / buffer / nothing). The effect in
+// `use-media-playback.ts` is responsible for actually executing the returned
+// action. Keeping the decision separate makes the branch ordering testable
+// without a DOM or a real media element.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMediaSyncAction = void 0;
+const getMediaSyncAction = (input) => {
+    const { duration, currentTime, paused, ended, desiredUnclampedTime, mediaTagTime, mediaTagLastUpdate, rvcTime, rvcLastUpdate, isVariableFpsVideo, acceptableTimeShift, lastSeekDueToShift, playing, playbackRate, mediaTagBufferingOrStalled, playerBuffering, absoluteFrame, onlyWarnForMediaSeekingError, isPremounting, isPostmounting, pauseWhenBuffering, } = input;
+    const shouldBeTime = !Number.isNaN(duration) && Number.isFinite(duration)
+        ? Math.min(duration, desiredUnclampedTime)
+        : desiredUnclampedTime;
+    const timeShiftMediaTag = Math.abs(shouldBeTime - mediaTagTime);
+    const timeShiftRvcTag = rvcTime ? Math.abs(shouldBeTime - rvcTime) : null;
+    const mostRecentTimeshift = rvcLastUpdate && rvcTime > mediaTagLastUpdate
+        ? timeShiftRvcTag
+        : timeShiftMediaTag;
+    const timeShift = timeShiftRvcTag && !isVariableFpsVideo
+        ? mostRecentTimeshift
+        : timeShiftMediaTag;
+    if (timeShift > acceptableTimeShift && lastSeekDueToShift !== shouldBeTime) {
+        // If scrubbing around, adjust timing
+        // or if time shift is bigger than 0.45sec
+        return {
+            type: 'seek-due-to-shift',
+            shouldBeTime,
+            why: `because time shift is too big. shouldBeTime = ${shouldBeTime}, isTime = ${mediaTagTime}, requestVideoCallbackTime = ${rvcTime}, timeShift = ${timeShift}${isVariableFpsVideo ? ', isVariableFpsVideo = true' : ''}, isPremounting = ${isPremounting}, isPostmounting = ${isPostmounting}, pauseWhenBuffering = ${pauseWhenBuffering}`,
+            bufferUntilFirstFrame: playing && playbackRate > 0,
+            playReason: playing && paused
+                ? 'player is playing but media tag is paused, and just seeked'
+                : null,
+            warnAboutNonSeekable: !onlyWarnForMediaSeekingError,
+        };
+    }
+    const seekThreshold = playing ? 0.15 : 0.01;
+    // Only perform a seek if the time is not already the same.
+    // Chrome rounds to 6 digits, so 0.033333333 -> 0.033333,
+    // therefore a threshold is allowed.
+    // Refer to the https://github.com/remotion-dev/video-buffering-example
+    // which is fixed by only seeking conditionally.
+    const makesSenseToSeek = Math.abs(currentTime - shouldBeTime) > seekThreshold;
+    const isSomethingElseBuffering = playerBuffering && !mediaTagBufferingOrStalled;
+    if (!playing || isSomethingElseBuffering) {
+        return {
+            type: 'seek-if-not-playing',
+            shouldBeTime,
+            why: makesSenseToSeek
+                ? `not playing or something else is buffering. time offset is over seek threshold (${seekThreshold})`
+                : null,
+        };
+    }
+    if (!playing || playerBuffering) {
+        return { type: 'none' };
+    }
+    // We now assured we are in playing state and not buffering
+    const pausedCondition = paused && !ended;
+    const firstFrameCondition = absoluteFrame === 0;
+    if (pausedCondition || firstFrameCondition) {
+        const reason = pausedCondition
+            ? 'media tag is paused'
+            : 'absolute frame is 0';
+        return {
+            type: 'play-and-seek',
+            shouldBeTime,
+            why: makesSenseToSeek
+                ? `is over timeshift threshold (threshold = ${seekThreshold}) and ${reason}`
+                : null,
+            playReason: `player is playing and ${reason}`,
+            bufferUntilFirstFrame: !isVariableFpsVideo && playbackRate > 0,
+        };
+    }
+    return { type: 'none' };
+};
+exports.getMediaSyncAction = getMediaSyncAction;

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

@@ -88,6 +88,12 @@ export type TextContentFieldSchema = {
     description?: string;
     keyframable?: false;
 };
+export type FontFamilyFieldSchema = {
+    type: 'font-family';
+    default: string | undefined;
+    description?: string;
+    keyframable?: false;
+};
 export type EnumFieldSchema = {
     type: 'enum';
     default: string;
@@ -117,7 +123,7 @@ export type ArrayFieldSchema = {
     description?: string;
     keyframable?: false;
 };
-export type VisibleFieldSchema = NumberFieldSchema | BooleanFieldSchema | RotationCssFieldSchema | RotationDegreesFieldSchema | TranslateFieldSchema | TransformOriginFieldSchema | ScaleFieldSchema | UvCoordinateFieldSchema | ColorFieldSchema | TextContentFieldSchema | ArrayFieldSchema | EnumFieldSchema;
+export type VisibleFieldSchema = NumberFieldSchema | BooleanFieldSchema | RotationCssFieldSchema | RotationDegreesFieldSchema | TranslateFieldSchema | TransformOriginFieldSchema | ScaleFieldSchema | UvCoordinateFieldSchema | ColorFieldSchema | TextContentFieldSchema | FontFamilyFieldSchema | ArrayFieldSchema | EnumFieldSchema;
 export type InteractivitySchemaField = VisibleFieldSchema | HiddenFieldSchema;
 export type InteractivitySchema = {
     [key: string]: InteractivitySchemaField;
@@ -201,6 +207,12 @@ export declare const textSchema: {
         readonly default: undefined;
         readonly description: "Color";
     };
+    readonly 'style.fontFamily': {
+        readonly type: "font-family";
+        readonly default: undefined;
+        readonly description: "Font family";
+        readonly keyframable: false;
+    };
     readonly 'style.fontSize': {
         readonly type: "number";
         readonly default: undefined;

package/dist/cjs/interactivity-schema.js

@@ -44,6 +44,12 @@ exports.textSchema = {
         default: undefined,
         description: 'Color',
     },
+    'style.fontFamily': {
+        type: 'font-family',
+        default: undefined,
+        description: 'Font family',
+        keyframable: false,
+    },
     'style.fontSize': {
         type: 'number',
         default: undefined,

package/dist/cjs/internals.d.ts

@@ -327,6 +327,12 @@ export declare const Internals: {
             readonly default: undefined;
             readonly description: "Color";
         };
+        readonly 'style.fontFamily': {
+            readonly type: "font-family";
+            readonly default: undefined;
+            readonly description: "Font family";
+            readonly keyframable: false;
+        };
         readonly 'style.fontSize': {
             readonly type: "number";
             readonly default: undefined;
@@ -659,6 +665,7 @@ export declare const Internals: {
     readonly resolveCompositionsRef: import("react").RefObject<{
         setCurrentRenderModalComposition: (compositionId: string | null) => void;
         reloadCurrentlySelectedComposition: () => void;
+        resolveComposition: (compositionId: string) => Promise<import("./video-config.js").VideoConfig>;
     } | null>;
     readonly REMOTION_STUDIO_CONTAINER_ELEMENT: "__remotion-studio-container";
     readonly RenderAssetManager: import("react").Context<import("./RenderAssetManager.js").RenderAssetManagerContext>;
@@ -687,7 +694,7 @@ export declare const Internals: {
         listenForResume: (callback: () => void) => {
             remove: () => void;
         };
-        buffering: import("react").MutableRefObject<boolean>;
+        buffering: import("react").RefObject<boolean>;
     } | null>;
     readonly getComponentsToAddStacksTo: () => unknown[];
     readonly CurrentScaleContext: import("react").Context<import("./use-current-scale.js").CurrentScaleContextType | null>;
@@ -816,7 +823,7 @@ export declare const Internals: {
         listenForResume: (callback: () => void) => {
             remove: () => void;
         };
-        buffering: import("react").MutableRefObject<boolean>;
+        buffering: import("react").RefObject<boolean>;
     }) => boolean;
     readonly TimelinePosition: typeof TimelinePosition;
     readonly DelayRenderContextType: import("react").Context<import("./delay-render.js").DelayRenderScope | null>;

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

@@ -1,4 +1,4 @@
-import type { MutableRefObject } from 'react';
+import type { RefObject } from 'react';
 import { type PlaybackRateContextValue, type TimelineContextValue } from './TimelineContext.js';
 export type PlayableMediaTag = {
     play: (reason: string) => void;
@@ -17,7 +17,7 @@ export declare const useTimelineSetFrame: () => (u: import("react").SetStateActi
 type PlayingReturnType = readonly [
     boolean,
     (u: React.SetStateAction<boolean>) => void,
-    MutableRefObject<boolean>
+    RefObject<boolean>
 ];
 export declare const usePlayingState: () => PlayingReturnType;
 export {};