melies-video-editor 0.1.4 → 0.1.5

package/package.json

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

package/dist/types/App.d.ts

@@ -1,33 +0,0 @@
-import './index.less';
-export type MeliesVideoEditorProps = {
-    /**
-     * URLs (often blob: URLs) to show in the footage bin.
-     * When omitted or empty, the footage bin will be empty.
-     */
-    footageUrls?: string[];
-    /**
-     * Local Files to show in the footage bin.
-     *
-     * This is ideal for OPFS (Base44 can load from OPFS and pass `File`s here).
-     */
-    footageFiles?: File[];
-    /**
-     * Handle-like objects (e.g. `FileSystemFileHandle`) that can yield `File`s.
-     *
-     * We intentionally avoid depending on `FileSystemFileHandle` directly so
-     * consumers without that DOM lib type can still compile.
-     */
-    footageFileHandles?: Array<{
-        getFile: () => Promise<File>;
-        name?: 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, footageFiles, footageFileHandles, autoPlaceFootage, }: MeliesVideoEditorProps) => import("react/jsx-runtime").JSX.Element;
-export default MeliesVideoEditor;

package/dist/types/audioControl.d.ts

@@ -1,29 +0,0 @@
-import type { TimelineEngine } from '@xzdarcy/react-timeline-editor';
-declare class AudioControl {
-    private howlBySrc;
-    private activeByActionId;
-    private getHowl;
-    /**
-     * Ensure the underlying WebAudio context is resumed.
-     *
-     * Some browsers (notably iOS Safari) block audio playback until a user gesture
-     * resumes the AudioContext. Timeline engine callbacks may occur outside the
-     * original gesture call stack, so we explicitly unlock in the toolbar handler.
-     */
-    unlock(): void;
-    warm(src: string): void;
-    private seekForEngineTime;
-    start(data: {
-        actionId: string;
-        engine: TimelineEngine;
-        src: string;
-        startTime: number;
-        time: number;
-        offset?: number;
-    }): void;
-    stop(data: {
-        actionId: string;
-    }): void;
-}
-declare const _default: AudioControl;
-export default _default;

package/dist/types/custom.d.ts

@@ -1,14 +0,0 @@
-import type { FC } from 'react';
-import type { CustomTimelineAction, CusTomTimelineRow } from './mock';
-export declare const CustomRender0: FC<{
-    action: CustomTimelineAction;
-    row: CusTomTimelineRow;
-}>;
-export declare const CustomRender1: FC<{
-    action: CustomTimelineAction;
-    row: CusTomTimelineRow;
-}>;
-export declare const CustomRender2: FC<{
-    action: CustomTimelineAction;
-    row: CusTomTimelineRow;
-}>;

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

@@ -1,4 +0,0 @@
-export default function DevRoot({ defaultFootageUrls, useHostShell, }: {
-    defaultFootageUrls?: string[];
-    useHostShell: boolean;
-}): import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +0,0 @@
-export default function HostApp({ footageUrls, footageFiles, footageFileHandles, }: {
-    footageUrls?: string[];
-    footageFiles?: File[];
-    footageFileHandles?: Array<{
-        getFile: () => Promise<File>;
-        name?: string;
-    }>;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/types/footageBin.d.ts

@@ -1,12 +0,0 @@
-export type FootageItem = {
-    id: string;
-    kind: 'video' | 'audio';
-    name: string;
-    src: string;
-    /** Optional lower-res/proxy source for smooth preview playback. */
-    previewSrc?: string;
-    defaultDuration?: number;
-};
-export declare const FOOTAGE_BIN: FootageItem[];
-export declare const VIDEO_ITEMS: FootageItem[];
-export declare const AUDIO_ITEMS: FootageItem[];

package/dist/types/index.d.ts

@@ -1 +0,0 @@
-import 'antd/dist/antd.css';

package/dist/types/lib/index.d.ts

@@ -1,3 +0,0 @@
-export { default as MeliesVideoEditor } from '../App';
-export type { MeliesVideoEditorProps } from '../App';
-export type { TimelineAction, TimelineEffect, TimelineRow, TimelineState, } from '@xzdarcy/react-timeline-editor';

package/dist/types/lottieControl.d.ts

@@ -1,28 +0,0 @@
-import { type AnimationItem } from 'lottie-web';
-declare class LottieControl {
-    cacheMap: Record<string, AnimationItem>;
-    private _goToAndStop;
-    enter(data: {
-        id: string;
-        src: string;
-        startTime: number;
-        endTime: number;
-        time: number;
-    }): void;
-    update(data: {
-        id: string;
-        src: string;
-        startTime: number;
-        endTime: number;
-        time: number;
-    }): void;
-    leave(data: {
-        id: string;
-        startTime: number;
-        endTime: number;
-        time: number;
-    }): void;
-    destroy(): void;
-}
-declare const _default: LottieControl;
-export default _default;

package/dist/types/mediaCache.d.ts

@@ -1,80 +0,0 @@
-type MediaKind = 'video' | 'audio' | 'other';
-export type ProxyEvent = {
-    type: 'proxy-start';
-    originalSrc: string;
-} | {
-    type: 'proxy-progress';
-    originalSrc: string;
-    value?: number;
-    status?: string;
-} | {
-    type: 'proxy-ready';
-    originalSrc: string;
-    proxySrc: string;
-} | {
-    type: 'proxy-failed';
-    originalSrc: string;
-    error: string;
-};
-declare const guessKind: (src: string) => MediaKind;
-declare class MediaCache {
-    private blobUrlBySrc;
-    private pendingBySrc;
-    private metaBySrc;
-    private proxyEventListeners;
-    /** Subscribe to proxy generation events (useful for UI debug on mobile where console logs aren't visible). */
-    onProxyEvent(listener: (event: ProxyEvent) => void): () => void;
-    private emitProxyEvent;
-    registerSrcMeta(src: string, meta: {
-        name?: string;
-        mimeType?: string;
-    }): void;
-    getSrcMeta(src: string): {
-        name?: string;
-        mimeType?: string;
-    } | undefined;
-    /**
-     * Ingests a File object into OPFS.
-     * Returns a virtual 'opfs://' URL that can be used as a src reference.
-     */
-    ingest(file: File): Promise<string>;
-    private initProxy;
-    /**
-     * Returns a URL that is safe to assign to a media element (`<video>`/`<audio>`).
-     *
-     * Notes:
-     * - `opfs://...` is NOT directly playable by browsers.
-     * - For OPFS sources, this will kick off an async preload (creating a `blob:` URL) and return `undefined`.
-     */
-    resolveForMediaElement(src: string): string | undefined;
-    /**
-     * Helper to fetch a file from OPFS given an opfs:// URL
-     */
-    getFileFromOpfs(opfsUrl: string): Promise<File | undefined>;
-    /**
-     * Preloads a URL into memory and returns a blob: URL.
-     * Useful to avoid runtime buffering/stalls when seeking frequently.
-     */
-    preloadToBlobUrl(src: string): Promise<string>;
-    /** Returns a blob URL if available, otherwise the original `src`. */
-    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;
-}
-declare const mediaCache: MediaCache;
-export default mediaCache;
-export { guessKind };

package/dist/types/mock.d.ts

@@ -1,25 +0,0 @@
-import type { TimelineAction, TimelineEffect, TimelineRow } from '@xzdarcy/react-timeline-editor';
-export declare const scaleWidth = 160;
-export declare const scale = 5;
-export declare const startLeft = 20;
-export interface CustomTimelineAction extends TimelineAction {
-    data: {
-        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;
-        /**
-         * In-point offset into the underlying media (seconds).
-         * Used for split clips so the right segment continues from the correct time.
-         */
-        offset?: number;
-    };
-}
-export interface CusTomTimelineRow extends TimelineRow {
-    actions: CustomTimelineAction[];
-}
-export declare const mockEffect: Record<string, TimelineEffect>;
-export declare const mockData: CusTomTimelineRow[];

package/dist/types/player.d.ts

@@ -1,18 +0,0 @@
-import type { TimelineState } from '@xzdarcy/react-timeline-editor';
-export declare const Rates: number[];
-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;
-    onSplitSelectedClip: () => void;
-    canUndo: boolean;
-    canRedo: boolean;
-    onUndo: () => void;
-    onRedo: () => void;
-}) => import("react/jsx-runtime").JSX.Element;
-export default TimelinePlayer;

package/dist/types/services/opfs.d.ts

@@ -1,37 +0,0 @@
-export type OpfsRoot = FileSystemDirectoryHandle;
-export declare const ensureOpfsRoot: () => Promise<OpfsRoot>;
-export declare const ensureDir: (root: OpfsRoot, path: string) => Promise<FileSystemDirectoryHandle>;
-/**
- * Writes a Blob or File to OPFS.
- * Uses createWritable() which is the standard async way to write.
- */
-export declare const writeFileToOpfs: (opts: {
-    root: OpfsRoot;
-    dirPath: string;
-    fileName: string;
-    file: Blob | File;
-}) => Promise<{
-    fileHandle: FileSystemFileHandle;
-    path: string;
-}>;
-export declare const getOpfsFile: (path: string) => Promise<File | undefined>;
-export declare const listFiles: (opts: {
-    root: OpfsRoot;
-    dirPath: string;
-}) => Promise<FileSystemFileHandle[]>;
-export declare const clearDir: (opts: {
-    root: OpfsRoot;
-    dirPath: string;
-}) => Promise<void>;
-type Maybe<T> = T | null | undefined;
-export declare const getFileFromPublicUrl: (url: string, fallbackName?: Maybe<string>) => Promise<File>;
-export declare const writeBlobToOpfs: (opts: {
-    root: OpfsRoot;
-    dirPath: string;
-    fileName: string;
-    blob: Blob;
-}) => Promise<{
-    fileHandle: FileSystemFileHandle;
-    path: string;
-}>;
-export {};

package/dist/types/services/proxyManager.d.ts

@@ -1,19 +0,0 @@
-declare class ProxyManager {
-    private activeJobs;
-    /**
-     * Create (or reuse) a proxy file for an OPFS video.
-     *
-     * `originalOpfsPath` should be an `opfs://...` URL.
-     */
-    createProxy(originalOpfsPath: string, opts?: {
-        onProgress?: (info: {
-            value?: number;
-            status?: string;
-        }) => void;
-    }): Promise<string>;
-    private _runWorker;
-    private getHandle;
-    private ensureDir;
-}
-export declare const proxyManager: ProxyManager;
-export {};

package/dist/types/useCoarsePointer.d.ts

@@ -1 +0,0 @@
-export declare function useCoarsePointer(): boolean;

package/dist/types/videoControl.d.ts

@@ -1,71 +0,0 @@
-import type { TimelineEngine, TimelineRow } from '@xzdarcy/react-timeline-editor';
-declare class VideoControl {
-    private primaryEl;
-    private secondaryEl;
-    private activeEl;
-    private rowData;
-    private boundEngine;
-    private vfcHandle;
-    private rafHandle;
-    private isPlaying;
-    private playbackRate;
-    private lastVideoClip;
-    private lastKnownTime;
-    constructor();
-    /**
-     * Called by App.tsx to provide the two video elements.
-     */
-    attachPrimary(el: HTMLVideoElement | null): void;
-    attachSecondary(el: HTMLVideoElement | null): void;
-    /**
-     * Helper to set initial styling/events for video elements.
-     */
-    private initElement;
-    /**
-     * Deprecated single-element attach, mapped to primary for safety.
-     */
-    attach(el: HTMLVideoElement | null): void;
-    /**
-     * Called by App.tsx whenever timeline data changes.
-     */
-    setEditorData(data: TimelineRow[]): void;
-    /**
-     * We use claimVideo to drive the dual-buffer logic from the engine's time updates.
-     * This ensures we sync to the engine's clock (Slave Mode).
-     */
-    claimVideo(data: {
-        isPlaying?: boolean;
-        time?: number;
-        [key: string]: unknown;
-    }): void;
-    bindEngine(engine: TimelineEngine): void;
-    unbindEngine(): void;
-    private startLoop;
-    private stopLoop;
-    /**
-     * The main heart beat.
-     * - If playing: sync engine time to video time.
-     * - Always: Check schedule (what should be playing vs preloading).
-     */
-    private tickLoop;
-    /**
-     * Evaluate the timeline at `time` (and `time + lookahead`).
-     * Manage Primary/Secondary elements.
-     */
-    private updateState;
-    private makeActive;
-    private loadVideo;
-    private isLoaded;
-    private findClipAtTime;
-    private findNextVideoClipStartAfter;
-    private findNextVideoClipAfter;
-    play(): void;
-    pause(): void;
-    setRate(rate: number): void;
-    seek(time: number): void;
-    warm(src: string): void;
-    releaseVideo(_actionId: string): void;
-    setActive(_active: boolean): void;
-}
-declare const _default: VideoControl;
-export default _default;

package/dist/types/workers/proxyWorker.d.ts

@@ -1 +0,0 @@
-export {};