melies-video-editor 0.1.0

package/dist/types/App.d.ts

@@ -0,0 +1,10 @@
+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[];
+};
+declare const MeliesVideoEditor: ({ footageUrls }: MeliesVideoEditorProps) => import("react/jsx-runtime").JSX.Element;
+export default MeliesVideoEditor;

package/dist/types/audioControl.d.ts

@@ -0,0 +1,29 @@
+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

@@ -0,0 +1,14 @@
+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/footageBin.d.ts

@@ -0,0 +1,12 @@
+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

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

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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1,20 @@
+type MediaKind = 'video' | 'audio' | 'other';
+declare const guessKind: (src: string) => MediaKind;
+declare class MediaCache {
+    private blobUrlBySrc;
+    private pendingBySrc;
+    /**
+     * 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;
+    /** 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

@@ -0,0 +1,23 @@
+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;
+        /** 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

@@ -0,0 +1,15 @@
+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, }: {
+    timelineState: React.MutableRefObject<TimelineState | null>;
+    autoScrollWhenPlay: React.MutableRefObject<boolean>;
+    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/useCoarsePointer.d.ts

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

package/dist/types/videoControl.d.ts

@@ -0,0 +1,30 @@
+import type { TimelineEngine } from '@xzdarcy/react-timeline-editor';
+declare class VideoControl {
+    private videoEl;
+    private currentSrc;
+    private lastSeekAtMs;
+    private lastRate;
+    private boundEngine;
+    private boundActionStart;
+    private vfcHandle;
+    private rafHandle;
+    attach(el: HTMLVideoElement | null): void;
+    setActive(active: boolean): void;
+    bindEngine(engine: TimelineEngine, actionStart: number): void;
+    unbindEngine(): void;
+    private tickFromVideo;
+    setSource(src: string): void;
+    warm(src: string): void;
+    setRate(rate: number): void;
+    /**
+     * Sync the video to a desired timeline time.
+     * To avoid buffering/stutters, we only seek when drift is large or when paused/scrubbing.
+     */
+    seek(time: number, opts?: {
+        force?: boolean;
+    }): void;
+    play(): Promise<void>;
+    pause(): void;
+}
+declare const _default: VideoControl;
+export default _default;

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "melies-video-editor",
+  "version": "0.1.0",
+  "description": "A React video timeline editor GUI built on @xzdarcy/react-timeline-editor.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "timeline",
+    "video",
+    "editor",
+    "react",
+    "base44"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/types/lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/lib/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "vite --host",
+    "dev:server": "node server/index.mjs",
+    "build": "tsc -b && vite build && tsc -p tsconfig.types.json",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@ant-design/icons": "4.7.0",
+    "@dnd-kit/core": "^6.3.1",
+    "@xzdarcy/react-timeline-editor": "0.1.8",
+    "antd": "4.21.6",
+    "howler": "2.2.3",
+    "lodash": "4.17.21",
+    "lottie-web": "5.10.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/howler": "^2.2.12",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^5.1.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "express": "^4.21.2",
+    "globals": "^16.5.0",
+    "less": "^4.5.1",
+    "multer": "^2.0.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  },
+  "packageManager": "pnpm@8.7.1+sha1.cb9fb56ca170a718619cd9bc669d99ddadc1afb5"
+}