melies-video-editor 0.1.0 → 0.1.2

package/dist/types/App.d.ts

@@ -5,6 +5,13 @@ export type MeliesVideoEditorProps = {
      * When omitted or empty, the footage bin will be empty.
      */
     footageUrls?: string[];
+    /**
+     * When true, automatically place `footageUrls` onto the timeline on first initialization
+     * (one after another, starting at t=0).
+     *
+     * Defaults to false.
+     */
+    autoPlaceFootage?: boolean;
 };
-declare const MeliesVideoEditor: ({ footageUrls }: MeliesVideoEditorProps) => import("react/jsx-runtime").JSX.Element;
+declare const MeliesVideoEditor: ({ footageUrls, autoPlaceFootage }: MeliesVideoEditorProps) => import("react/jsx-runtime").JSX.Element;
 export default MeliesVideoEditor;

package/dist/types/dev/HostApp.d.ts

@@ -0,0 +1,3 @@
+export default function HostApp({ footageUrls }: {
+    footageUrls?: string[];
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/mediaCache.d.ts

@@ -12,6 +12,18 @@ declare class MediaCache {
     resolve(src: string): string;
     /** Starts preload in background (non-blocking). */
     warm(src: string): void;
+    /**
+     * Preload a list of srcs with bounded concurrency.
+     *
+     * This is useful when you know ahead of time which assets will be scrubbed/seeked,
+     * so we can eliminate network stalls during interaction.
+     */
+    warmAll(srcs: Iterable<string>, opts?: {
+        /** Maximum number of concurrent fetches. Defaults to 3. */
+        concurrency?: number;
+        /** Yield back to the event loop between items. Defaults to true. */
+        yieldBetween?: boolean;
+    }): Promise<void>;
     /** Convenience: preload all unique action.data.src from editor data. */
     warmFromEditorData(editorData: unknown): void;
 }

package/dist/types/mock.d.ts

@@ -7,6 +7,8 @@ export interface CustomTimelineAction extends TimelineAction {
         src: string;
         previewSrc?: string;
         name: string;
+        /** Video lane index (0=V1, 1=V2). Higher value wins when overlapping. */
+        videoLayer?: number;
         /** Shared id for clips that should move/trim together (e.g. video + its embedded audio). */
         linkId?: string;
         /**

package/dist/types/player.d.ts

@@ -1,8 +1,11 @@
 import type { TimelineState } from '@xzdarcy/react-timeline-editor';
 export declare const Rates: number[];
-declare const TimelinePlayer: ({ timelineState, autoScrollWhenPlay, editorData, selectedActionId, onDeleteSelectedClip, onSplitSelectedClip, canUndo, canRedo, onUndo, onRedo, }: {
+declare const TimelinePlayer: ({ timelineState, autoScrollWhenPlay, scale, scaleWidth, startLeft, editorData, selectedActionId, onDeleteSelectedClip, onSplitSelectedClip, canUndo, canRedo, onUndo, onRedo, }: {
     timelineState: React.MutableRefObject<TimelineState | null>;
     autoScrollWhenPlay: React.MutableRefObject<boolean>;
+    scale: number;
+    scaleWidth: number;
+    startLeft: number;
     editorData: any[];
     selectedActionId: string | null;
     onDeleteSelectedClip: () => void;

package/dist/types/videoControl.d.ts

@@ -4,12 +4,26 @@ declare class VideoControl {
     private currentSrc;
     private lastSeekAtMs;
     private lastRate;
+    private videoClaims;
+    private activeVideoActionId;
+    private lastEngineTime;
     private boundEngine;
     private boundActionStart;
     private vfcHandle;
     private rafHandle;
     attach(el: HTMLVideoElement | null): void;
     setActive(active: boolean): void;
+    claimVideo(data: {
+        actionId: string;
+        layer: number;
+        src: string;
+        engine: TimelineEngine;
+        isPlaying: boolean;
+        time: number;
+        actionStart: number;
+        offset?: number;
+    }): void;
+    releaseVideo(actionIdRaw: string): void;
     bindEngine(engine: TimelineEngine, actionStart: number): void;
     unbindEngine(): void;
     private tickFromVideo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melies-video-editor",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A React video timeline editor GUI built on @xzdarcy/react-timeline-editor.",
   "type": "module",
   "license": "MIT",