melies-video-editor 0.1.7 → 0.2.0

package/dist/types/App.d.ts

@@ -51,6 +51,15 @@ export type MeliesVideoEditorProps = {
      * stable asset identifiers if they need cross-session restore.
      */
     onFootageImported?: (event: MeliesFootageImportEvent) => void;
+    /**
+     * Host-facing export hook.
+     *
+     * When provided, the in-editor Export button will call this callback instead of using
+     * the built-in local `/export` POST.
+     *
+     * The host app should orchestrate export (e.g. S3 presign upload → job start → poll → download).
+     */
+    onExport?: (event: MeliesExportEvent) => void | Promise<void>;
 };
 export type MeliesFootageImportEntry = {
     /** The bin item added to the footage bin. */
@@ -66,6 +75,34 @@ export type MeliesFootageImportEvent = {
     /** Convenience list of files. */
     files: File[];
 };
+export type MeliesExportAsset = {
+    /** The timeline join key for this asset (action.data.src). */
+    src: string;
+    /** Best-effort classification based on how the asset is used in the timeline. */
+    kind: 'video' | 'audio' | 'unknown';
+    /** Optional metadata (only available when the editor has seen it this session). */
+    name?: string;
+    /** Optional metadata (only available when the editor has seen it this session). */
+    mimeType?: string;
+};
+export type MeliesExportEvent = {
+    /** A deep-cloned snapshot of the current timeline state (safe to persist/mutate). */
+    snapshot: MeliesTimelineSnapshot;
+    /** Convenience list of unique src keys referenced by the timeline. */
+    assetSrcs: string[];
+    /** Richer asset list with best-effort metadata. */
+    assets: MeliesExportAsset[];
+    /**
+     * Returns a File for a given src when the editor has access to bytes this session.
+     * For stable src keys (e.g. Base44 asset IDs), hosts should resolve bytes themselves.
+     */
+    getFileBySrc: (src: string) => File | null;
+    /** Lists all in-session Files the editor can provide, keyed by src. */
+    listSessionFiles: () => Array<{
+        src: string;
+        file: File;
+    }>;
+};
 export type MeliesTimelineSnapshot = {
     /** Bump this when snapshot schema changes. */
     version: 1;

package/dist/types/audioControl.d.ts

@@ -2,6 +2,12 @@ import type { TimelineEngine } from '@xzdarcy/react-timeline-editor';
 declare class AudioControl {
     private howlBySrc;
     private activeByActionId;
+    /**
+     * Stop and detach an active sound instance for a given action id.
+     *
+     * This is a best-effort cleanup helper used by both `stop()` and `reset()`.
+     */
+    private stopActiveAction;
     private getHowl;
     /**
      * Ensure the underlying WebAudio context is resumed.
@@ -24,6 +30,14 @@ declare class AudioControl {
     stop(data: {
         actionId: string;
     }): void;
+    /**
+     * Fully reset audio playback state.
+     *
+     * This is important because `audioControl` is a singleton and action IDs are
+     * stable across snapshot restores. Without a reset, we can keep references to
+     * revoked blob URLs or previous engine instances, causing silent playback.
+     */
+    reset(): void;
 }
 declare const _default: AudioControl;
 export default _default;

package/dist/types/player.d.ts

@@ -1,6 +1,7 @@
 import type { TimelineState } from '@xzdarcy/react-timeline-editor';
+import type { MeliesExportEvent } from './App';
 export declare const Rates: number[];
-declare const TimelinePlayer: ({ timelineState, autoScrollWhenPlay, scale, scaleWidth, startLeft, editorData, selectedActionId, onDeleteSelectedClip, onSplitSelectedClip, canUndo, canRedo, onUndo, onRedo, }: {
+declare const TimelinePlayer: ({ timelineState, autoScrollWhenPlay, scale, scaleWidth, startLeft, editorData, selectedActionId, onDeleteSelectedClip, onSplitSelectedClip, canUndo, canRedo, onUndo, onRedo, onExport, buildExportEvent, }: {
     timelineState: React.MutableRefObject<TimelineState | null>;
     autoScrollWhenPlay: React.MutableRefObject<boolean>;
     scale: number;
@@ -14,5 +15,7 @@ declare const TimelinePlayer: ({ timelineState, autoScrollWhenPlay, scale, scale
     canRedo: boolean;
     onUndo: () => void;
     onRedo: () => void;
+    onExport?: (event: MeliesExportEvent) => void | Promise<void>;
+    buildExportEvent?: () => MeliesExportEvent;
 }) => import("react/jsx-runtime").JSX.Element;
 export default TimelinePlayer;

package/package.json

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