@editframe/elements 0.37.3-beta → 0.38.1

package/dist/elements/EFVideo.d.ts

@@ -1,8 +1,10 @@
-import { FrameRenderable, FrameState, FrameTask } from "../preview/FrameController.js";
+import { FrameRenderable, FrameState } from "../preview/FrameController.js";
 import { EFFramegen } from "../EF_FRAMEGEN.js";
 import { EFMedia } from "./EFMedia.js";
+import { RenderToVideoOptions } from "../preview/renderTimegroupToVideo.types.js";
 import * as lit3 from "lit";
 import { PropertyValueMap } from "lit";
+import { VideoSample } from "mediabunny";
 import * as lit_html3 from "lit-html";
 import * as lit_html_directives_ref0 from "lit-html/directives/ref";
 
@@ -20,26 +22,26 @@ interface LoadingState {
  * Dispatched during prefetchScrubSegments to indicate network activity.
  */
 
+declare class VideoSeekTask {
+  #private;
+  value: VideoSample | undefined;
+  task: ((...args: any[]) => any) | undefined;
+  taskComplete: Promise<VideoSample | undefined>;
+  begin(): void;
+  complete(sample: VideoSample | undefined): void;
+  abort(): void;
+}
 declare const EFVideo_base: typeof EFMedia;
 declare class EFVideo extends EFVideo_base implements FrameRenderable {
   #private;
   static styles: lit3.CSSResult[];
   canvasRef: lit_html_directives_ref0.Ref<HTMLCanvasElement>;
+  unifiedVideoSeekTask: VideoSeekTask;
   /**
-   * Duration in milliseconds for video buffering ahead of current time
-   * @domAttribute "video-buffer-duration"
-   */
-  videoBufferDurationMs: number;
-  /**
-   * Maximum number of concurrent video segment fetches for buffering
-   * @domAttribute "max-video-buffer-fetches"
-   */
-  maxVideoBufferFetches: number;
-  /**
-   * Enable/disable video buffering system
-   * @domAttribute "enable-video-buffering"
+   * Get the current rendition being displayed.
+   * @public
    */
-  enableVideoBuffering: boolean;
+  get currentRenditionId(): "main" | "scrub" | undefined;
   /**
    * Query readiness state for a given time.
    * @implements FrameRenderable
@@ -78,11 +80,6 @@ declare class EFVideo extends EFVideo_base implements FrameRenderable {
   protected updated(changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
   render(): lit_html3.TemplateResult<1>;
   get canvasElement(): HTMLCanvasElement | undefined;
-  /**
-   * @deprecated Use FrameRenderable methods (prepareFrame, renderFrame) via FrameController instead.
-   * This is a compatibility wrapper that delegates to the new system.
-   */
-  frameTask: FrameTask;
   /**
    * Start a delayed loading operation for testing
    */
@@ -99,7 +96,6 @@ declare class EFVideo extends EFVideo_base implements FrameRenderable {
   private setLoadingState;
   /**
    * Paint the current video frame to canvas
-   * Called by frameTask after seek is complete
    */
   paint(seekToMs: number, parentSpan?: any): void;
   /**
@@ -119,21 +115,26 @@ declare class EFVideo extends EFVideo_base implements FrameRenderable {
    */
   private isFrameRenderingActive;
   /**
-   * Legacy getter for fragment index task
-   * Still used by EFCaptions - maps to frameTask
-   */
-  get fragmentIndexTask(): FrameTask;
-  /**
-   * Helper method for tests: wait for the current frame to be ready
-   * This encapsulates the complexity of ensuring the video has updated
-   * and its frameTask has completed.
+   * Get a decoded VideoFrame at a specific source media timestamp.
+   * Returns a standard WebCodecs VideoFrame — caller MUST call .close() when done.
+   *
+   * Uses the same routing logic as the unified video system:
+   * - "auto": main track for production rendering, follows normal routing otherwise
+   * - "scrub": force low-res scrub track (for thumbnails)
+   * - "main": force full-quality main track
    *
-   * @returns Promise that resolves when the frame is ready
+   * @param sourceTimeMs - Timestamp in source media coordinates (not timeline)
+   * @param options - Quality and abort signal
+   * @returns VideoFrame that the caller must close()
+   * @public
    */
-  waitForFrameReady(): Promise<void>;
+  getVideoFrameAtSourceTime(sourceTimeMs: number, options?: {
+    quality?: "auto" | "scrub" | "main";
+    signal?: AbortSignal;
+  }): Promise<VideoFrame>;
   /**
    * Capture a video frame directly at a source media timestamp.
-   * Bypasses the frameTask system - designed for export/rendering.
+   * Designed for export/rendering.
    * Does NOT paint to the element's internal canvas.
    *
    * Uses the same routing logic as unified video system:
@@ -161,20 +162,11 @@ declare class EFVideo extends EFVideo_base implements FrameRenderable {
    *
    * @param timestamps - Array of timestamps (in ms) that will be captured
    * @param onProgress - Optional callback for loading progress
+   * @param signal - Optional AbortSignal for cancellation
    * @returns Promise that resolves when all segments are cached
    * @public
    */
-  prefetchScrubSegments(timestamps: number[], onProgress?: (loaded: number, total: number, segmentTimeRange: [number, number]) => void): Promise<void>;
-  /**
-   * Pre-fetch main video segments for given timestamps.
-   * This ensures segments are cached for fast seeking during video export.
-   *
-   * @param timestamps - Array of timestamps (in ms) that will be captured
-   * @param onProgress - Optional callback for loading progress
-   * @returns Promise that resolves when all segments are cached
-   * @public
-   */
-  prefetchMainVideoSegments(timestamps: number[], onProgress?: (loaded: number, total: number) => void): Promise<void>;
+  prefetchScrubSegments(timestamps: number[], onProgress?: (loaded: number, total: number, segmentTimeRange: [number, number]) => void, signal?: AbortSignal): Promise<void>;
   /**
    * Clean up resources when component is disconnected
    */
@@ -191,6 +183,16 @@ declare class EFVideo extends EFVideo_base implements FrameRenderable {
     width: number;
     height: number;
   } | null;
+  /**
+   * Render this video element to an MP4 using the direct video-to-video fast path.
+   * Bypasses DOM serialization — decodes frames directly and re-encodes to MP4.
+   * Respects trim, CSS filter, and opacity.
+   *
+   * @param options - Rendering options (fps, codec, bitrate, etc.)
+   * @returns Promise resolving to video buffer (if returnBuffer), or undefined
+   * @public
+   */
+  renderToVideo(options?: RenderToVideoOptions): Promise<Uint8Array | undefined>;
 }
 declare global {
   interface HTMLElementTagNameMap {