@bendyline/squisq-video-react 1.0.0 → 1.0.2

package/dist/hooks/useFrameCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrameCapture.js","sourceRoot":"","sources":["../../src/hooks/useFrameCapture.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useVideoExport.d.ts

@@ -0,0 +1,75 @@
+/**
+ * useVideoExport — Main orchestration hook for browser video export.
+ *
+ * Coordinates frame capture (hidden iframe + html2canvas) with
+ * main-thread WebCodecs encoding via mp4-muxer. Manages the full
+ * lifecycle: prepare → capture + encode → download.
+ *
+ * Encoding runs on the main thread because frame capture via html2canvas
+ * (~100-200ms per frame) is the bottleneck, not encoding (~1ms per frame
+ * with hardware-accelerated WebCodecs). Worker offloading would add
+ * complexity with minimal benefit.
+ *
+ * Usage:
+ *   const { state, progress, phase, startExport, cancel, downloadUrl } = useVideoExport();
+ *   <button onClick={() => startExport(doc, options)}>Export</button>
+ */
+import type { Doc } from '@bendyline/squisq/schemas';
+import type { MediaProvider } from '@bendyline/squisq/schemas';
+import type { VideoQuality, VideoOrientation } from '@bendyline/squisq-video';
+import type { CaptionMode } from '@bendyline/squisq-react';
+export type VideoExportState = 'idle' | 'preparing' | 'capturing' | 'encoding' | 'complete' | 'error';
+export interface VideoExportConfig {
+    /** Encoding quality preset (default: 'normal') */
+    quality?: VideoQuality;
+    /** Frames per second (default: 30) */
+    fps?: number;
+    /** Viewport orientation (default: 'landscape') */
+    orientation?: VideoOrientation;
+    /**
+     * Map of relative image paths to binary data.
+     * Used to embed images into the render HTML.
+     */
+    images?: Map<string, ArrayBuffer>;
+    /**
+     * Map of audio segment names to binary data.
+     * Used to embed audio into the render HTML.
+     */
+    audio?: Map<string, ArrayBuffer>;
+    /** MediaProvider to resolve media URLs (alternative to passing images directly) */
+    mediaProvider?: MediaProvider;
+    /** Caption mode for the exported video (default: 'off') */
+    captionMode?: CaptionMode;
+    /** Player IIFE bundle (unused in browser export, kept for CLI/Playwright path) */
+    playerScript?: string;
+}
+export interface VideoExportResult {
+    /** Current export state */
+    state: VideoExportState;
+    /** 0–100 progress percentage */
+    progress: number;
+    /** Human-readable description of the current phase */
+    phase: string;
+    /** Video duration detected from the doc (seconds) */
+    duration: number;
+    /** Encoder backend ('webcodecs' when active, null when idle) */
+    backend: 'webcodecs' | null;
+    /** Blob download URL (populated when state === 'complete') */
+    downloadUrl: string | null;
+    /** File size in bytes (populated when state === 'complete') */
+    fileSize: number;
+    /** Error message (populated when state === 'error') */
+    error: string | null;
+    /** Seconds elapsed since export started */
+    elapsed: number;
+    /** Estimated seconds remaining (0 when idle or complete) */
+    estimatedRemaining: number;
+    /** Start a new export */
+    startExport: (doc: Doc, config: VideoExportConfig) => Promise<void>;
+    /** Cancel an in-progress export */
+    cancel: () => void;
+    /** Reset state back to idle (e.g., after complete or error) */
+    reset: () => void;
+}
+export declare function useVideoExport(): VideoExportResult;
+//# sourceMappingURL=useVideoExport.d.ts.map

package/dist/hooks/useVideoExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVideoExport.d.ts","sourceRoot":"","sources":["../../src/hooks/useVideoExport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,mFAAmF;IACnF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,KAAK,EAAE,gBAAgB,CAAC;IACxB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,mCAAmC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID,wBAAgB,cAAc,IAAI,iBAAiB,CA0PlD"}

package/dist/hooks/useVideoExport.js

@@ -0,0 +1,241 @@
+/**
+ * useVideoExport — Main orchestration hook for browser video export.
+ *
+ * Coordinates frame capture (hidden iframe + html2canvas) with
+ * main-thread WebCodecs encoding via mp4-muxer. Manages the full
+ * lifecycle: prepare → capture + encode → download.
+ *
+ * Encoding runs on the main thread because frame capture via html2canvas
+ * (~100-200ms per frame) is the bottleneck, not encoding (~1ms per frame
+ * with hardware-accelerated WebCodecs). Worker offloading would add
+ * complexity with minimal benefit.
+ *
+ * Usage:
+ *   const { state, progress, phase, startExport, cancel, downloadUrl } = useVideoExport();
+ *   <button onClick={() => startExport(doc, options)}>Export</button>
+ */
+import { useState, useRef, useCallback, useEffect } from 'react';
+import { resolveDimensions } from '@bendyline/squisq-video';
+import { createEncoder, supportsWebCodecs } from '../mainThreadEncoder.js';
+import { useFrameCapture } from './useFrameCapture.js';
+// ── Hook ───────────────────────────────────────────────────────────
+export function useVideoExport() {
+    const [state, setState] = useState('idle');
+    const [progress, setProgress] = useState(0);
+    const [phase, setPhase] = useState('');
+    const [duration, setDuration] = useState(0);
+    const [backend, setBackend] = useState(null);
+    const [downloadUrl, setDownloadUrl] = useState(null);
+    const [fileSize, setFileSize] = useState(0);
+    const [error, setError] = useState(null);
+    const [elapsed, setElapsed] = useState(0);
+    const [estimatedRemaining, setEstimatedRemaining] = useState(0);
+    const encoderRef = useRef(null);
+    const cancelledRef = useRef(false);
+    const downloadUrlRef = useRef(null);
+    const startTimeRef = useRef(0);
+    const elapsedTimerRef = useRef(null);
+    const frameCapture = useFrameCapture();
+    // Clean up on unmount
+    useEffect(() => {
+        return () => {
+            if (elapsedTimerRef.current)
+                clearInterval(elapsedTimerRef.current);
+            if (downloadUrlRef.current) {
+                URL.revokeObjectURL(downloadUrlRef.current);
+            }
+            if (encoderRef.current) {
+                encoderRef.current.close();
+            }
+            frameCapture.destroy();
+        };
+    }, [frameCapture]);
+    const reset = useCallback(() => {
+        if (downloadUrlRef.current) {
+            URL.revokeObjectURL(downloadUrlRef.current);
+            downloadUrlRef.current = null;
+        }
+        if (encoderRef.current) {
+            encoderRef.current.close();
+            encoderRef.current = null;
+        }
+        frameCapture.destroy();
+        setState('idle');
+        setProgress(0);
+        setPhase('');
+        setDuration(0);
+        setBackend(null);
+        setDownloadUrl(null);
+        setFileSize(0);
+        setError(null);
+        setElapsed(0);
+        setEstimatedRemaining(0);
+        if (elapsedTimerRef.current)
+            clearInterval(elapsedTimerRef.current);
+        cancelledRef.current = false;
+    }, [frameCapture]);
+    const cancel = useCallback(() => {
+        cancelledRef.current = true;
+        if (elapsedTimerRef.current)
+            clearInterval(elapsedTimerRef.current);
+        if (encoderRef.current) {
+            encoderRef.current.close();
+            encoderRef.current = null;
+        }
+        frameCapture.destroy();
+        setState('idle');
+        setProgress(0);
+        setPhase('Cancelled');
+    }, [frameCapture]);
+    const startExport = useCallback(async (doc, config) => {
+        // Clear previous state
+        cancelledRef.current = false;
+        if (downloadUrlRef.current) {
+            URL.revokeObjectURL(downloadUrlRef.current);
+            downloadUrlRef.current = null;
+        }
+        setDownloadUrl(null);
+        setFileSize(0);
+        setError(null);
+        const quality = config.quality ?? 'normal';
+        const fps = config.fps ?? 30;
+        const orientation = config.orientation ?? 'landscape';
+        const { width, height } = resolveDimensions({ orientation });
+        try {
+            // ── Check browser support ─────────────────────────────────
+            if (!supportsWebCodecs()) {
+                throw new Error('WebCodecs is not available in this browser. ' +
+                    'Video export requires Chrome 94+, Edge 94+, or another Chromium-based browser.');
+            }
+            // ── Step 1: Prepare ───────────────────────────────────────
+            setState('preparing');
+            setPhase('Loading document…');
+            setProgress(0);
+            setElapsed(0);
+            setEstimatedRemaining(0);
+            // Start elapsed timer
+            startTimeRef.current = performance.now();
+            if (elapsedTimerRef.current)
+                clearInterval(elapsedTimerRef.current);
+            elapsedTimerRef.current = setInterval(() => {
+                setElapsed(Math.floor((performance.now() - startTimeRef.current) / 1000));
+            }, 1000);
+            // Collect images from MediaProvider if provided and images not passed directly
+            let images = config.images;
+            if (!images && config.mediaProvider) {
+                images = new Map();
+                const entries = await config.mediaProvider.listMedia();
+                for (const entry of entries) {
+                    const url = await config.mediaProvider.resolveUrl(entry.name);
+                    const res = await fetch(url);
+                    if (res.ok) {
+                        const data = await res.arrayBuffer();
+                        images.set(entry.name, data);
+                    }
+                }
+            }
+            const docDuration = await frameCapture.init(doc, { images, audio: config.audio, width, height }, config.captionMode);
+            if (cancelledRef.current)
+                return;
+            setDuration(docDuration);
+            if (docDuration <= 0) {
+                throw new Error('Document has zero duration — nothing to export');
+            }
+            // ── Step 2: Create encoder ────────────────────────────────
+            setPhase('Starting encoder…');
+            setProgress(5);
+            const encoder = createEncoder({ width, height, fps, quality });
+            encoderRef.current = encoder;
+            setBackend('webcodecs');
+            if (cancelledRef.current)
+                return;
+            // ── Step 3: Capture frames and encode ─────────────────────
+            setState('capturing');
+            const totalFrames = Math.ceil(docDuration * fps);
+            const captureStartTime = performance.now();
+            // Throttle UI updates to every ~10 frames to avoid excessive re-renders.
+            // Each setState between awaits triggers a separate render cycle.
+            const UI_UPDATE_INTERVAL = 10;
+            for (let i = 0; i < totalFrames; i++) {
+                if (cancelledRef.current)
+                    return;
+                const time = i / fps;
+                // Update UI periodically (not every frame)
+                if (i % UI_UPDATE_INTERVAL === 0 || i === totalFrames - 1) {
+                    const captureProgress = Math.round((i / totalFrames) * 90);
+                    setProgress(5 + captureProgress);
+                    setPhase(`Capturing frame ${i + 1}/${totalFrames} (${time.toFixed(1)}s)`);
+                    if (i > 0) {
+                        const elapsedCapture = (performance.now() - captureStartTime) / 1000;
+                        const avgPerFrame = elapsedCapture / i;
+                        const remaining = Math.round(avgPerFrame * (totalFrames - i));
+                        setEstimatedRemaining(remaining);
+                    }
+                }
+                const bitmap = await frameCapture.captureFrame(time);
+                if (cancelledRef.current) {
+                    bitmap.close();
+                    return;
+                }
+                // Encode immediately — WebCodecs is fast and async internally
+                encoder.encodeFrame(bitmap, i);
+            }
+            if (cancelledRef.current)
+                return;
+            // ── Step 4: Finalize MP4 ──────────────────────────────────
+            setState('encoding');
+            setPhase('Finalizing video…');
+            setProgress(95);
+            const mp4Buffer = await encoder.finalize();
+            encoderRef.current = null;
+            if (cancelledRef.current)
+                return;
+            // ── Step 5: Create download URL ───────────────────────────
+            const blob = new Blob([mp4Buffer], { type: 'video/mp4' });
+            const url = URL.createObjectURL(blob);
+            downloadUrlRef.current = url;
+            setDownloadUrl(url);
+            setFileSize(mp4Buffer.byteLength);
+            setState('complete');
+            setProgress(100);
+            setPhase('Export complete');
+            setEstimatedRemaining(0);
+            if (elapsedTimerRef.current)
+                clearInterval(elapsedTimerRef.current);
+            // Clean up
+            frameCapture.destroy();
+        }
+        catch (err) {
+            if (elapsedTimerRef.current)
+                clearInterval(elapsedTimerRef.current);
+            if (cancelledRef.current)
+                return;
+            const message = err instanceof Error ? err.message : String(err);
+            setState('error');
+            setError(message);
+            setPhase('Export failed');
+            // Clean up on error
+            if (encoderRef.current) {
+                encoderRef.current.close();
+                encoderRef.current = null;
+            }
+            frameCapture.destroy();
+        }
+    }, [frameCapture]);
+    return {
+        state,
+        progress,
+        phase,
+        duration,
+        backend,
+        downloadUrl,
+        fileSize,
+        error,
+        elapsed,
+        estimatedRemaining,
+        startExport,
+        cancel,
+        reset,
+    };
+}
+//# sourceMappingURL=useVideoExport.js.map

package/dist/hooks/useVideoExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVideoExport.js","sourceRoot":"","sources":["../../src/hooks/useVideoExport.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,176 +1,24 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Doc, MediaProvider } from '@bendyline/squisq/schemas';
-import { VideoQuality, VideoOrientation, RenderHtmlOptions } from '@bendyline/squisq-video';
-import { CaptionMode } from '@bendyline/squisq-react';
-
-interface VideoExportModalProps {
-    /** The document to export */
-    doc: Doc;
-    /** Player IIFE bundle source */
-    playerScript: string;
-    /** Optional media provider for resolving images/audio */
-    mediaProvider?: MediaProvider;
-    /** Pre-collected images map (alternative to mediaProvider) */
-    images?: Map<string, ArrayBuffer>;
-    /** Pre-collected audio map */
-    audio?: Map<string, ArrayBuffer>;
-    /** Called when the modal should close */
-    onClose: () => void;
-}
-declare function VideoExportModal({ doc, playerScript, mediaProvider, images, audio, onClose, }: VideoExportModalProps): react_jsx_runtime.JSX.Element;
-
-interface VideoExportButtonProps {
-    /** The document to export */
-    doc: Doc;
-    /** Player IIFE bundle source */
-    playerScript: string;
-    /** Optional media provider for resolving images/audio */
-    mediaProvider?: MediaProvider;
-    /** Pre-collected images map */
-    images?: Map<string, ArrayBuffer>;
-    /** Pre-collected audio map */
-    audio?: Map<string, ArrayBuffer>;
-    /** Button label (default: "Export Video") */
-    label?: string;
-    /** Additional inline styles for the button */
-    style?: React.CSSProperties;
-    /** Whether the button is disabled */
-    disabled?: boolean;
-}
-declare function VideoExportButton({ doc, playerScript, mediaProvider, images, audio, label, style, disabled, }: VideoExportButtonProps): react_jsx_runtime.JSX.Element;
-
 /**
- * useVideoExport — Main orchestration hook for browser video export.
+ * @bendyline/squisq-video-react — Browser Video Export for Squisq Documents
  *
- * Coordinates frame capture (hidden iframe + html2canvas) with
- * main-thread WebCodecs encoding via mp4-muxer. Manages the full
- * lifecycle: prepare → capture + encode → download.
+ * Provides React components and hooks for exporting Squisq documents
+ * to MP4 video directly in the browser.
  *
- * Encoding runs on the main thread because frame capture via html2canvas
- * (~100-200ms per frame) is the bottleneck, not encoding (~1ms per frame
- * with hardware-accelerated WebCodecs). Worker offloading would add
- * complexity with minimal benefit.
+ * - VideoExportModal: Full modal UI for configure → export → download
+ * - VideoExportButton: Drop-in button that opens the modal
+ * - useVideoExport: Low-level hook for custom UIs
+ * - useFrameCapture: Frame capture via hidden iframe + html2canvas
  *
- * Usage:
- *   const { state, progress, phase, startExport, cancel, downloadUrl } = useVideoExport();
- *   <button onClick={() => startExport(doc, options)}>Export</button>
+ * Encoding: WebCodecs (H.264 via hardware-accelerated VideoEncoder, Chrome 94+)
  */
-
-type VideoExportState = 'idle' | 'preparing' | 'capturing' | 'encoding' | 'complete' | 'error';
-interface VideoExportConfig {
-    /** Encoding quality preset (default: 'normal') */
-    quality?: VideoQuality;
-    /** Frames per second (default: 30) */
-    fps?: number;
-    /** Viewport orientation (default: 'landscape') */
-    orientation?: VideoOrientation;
-    /**
-     * Map of relative image paths to binary data.
-     * Used to embed images into the render HTML.
-     */
-    images?: Map<string, ArrayBuffer>;
-    /**
-     * Map of audio segment names to binary data.
-     * Used to embed audio into the render HTML.
-     */
-    audio?: Map<string, ArrayBuffer>;
-    /** MediaProvider to resolve media URLs (alternative to passing images directly) */
-    mediaProvider?: MediaProvider;
-    /** Caption mode for the exported video (default: 'off') */
-    captionMode?: CaptionMode;
-    /** Player IIFE bundle (unused in browser export, kept for CLI/Playwright path) */
-    playerScript?: string;
-}
-interface VideoExportResult {
-    /** Current export state */
-    state: VideoExportState;
-    /** 0–100 progress percentage */
-    progress: number;
-    /** Human-readable description of the current phase */
-    phase: string;
-    /** Video duration detected from the doc (seconds) */
-    duration: number;
-    /** Encoder backend ('webcodecs' when active, null when idle) */
-    backend: 'webcodecs' | null;
-    /** Blob download URL (populated when state === 'complete') */
-    downloadUrl: string | null;
-    /** File size in bytes (populated when state === 'complete') */
-    fileSize: number;
-    /** Error message (populated when state === 'error') */
-    error: string | null;
-    /** Seconds elapsed since export started */
-    elapsed: number;
-    /** Estimated seconds remaining (0 when idle or complete) */
-    estimatedRemaining: number;
-    /** Start a new export */
-    startExport: (doc: Doc, config: VideoExportConfig) => Promise<void>;
-    /** Cancel an in-progress export */
-    cancel: () => void;
-    /** Reset state back to idle (e.g., after complete or error) */
-    reset: () => void;
-}
-declare function useVideoExport(): VideoExportResult;
-
-/**
- * useFrameCapture — Hidden div + html2canvas frame capture.
- *
- * Mounts a DocPlayer in renderMode inside a hidden div (same document),
- * then captures individual frames by seeking the player and rendering
- * the DOM to a canvas via html2canvas.
- *
- * Uses React directly — no script injection, no iframes, no eval.
- *
- * Returns an ImageBitmap for each frame (transferable to a Worker).
- */
-
-interface FrameCaptureHandle {
-    /** Initialize the hidden player. Returns the video duration in seconds. */
-    init: (doc: Doc, renderOptions: Omit<RenderHtmlOptions, 'playerScript'>, captionMode?: CaptionMode) => Promise<number>;
-    /** Capture a single frame at the given time (seconds). Returns an ImageBitmap. */
-    captureFrame: (time: number) => Promise<ImageBitmap>;
-    /** Clean up resources. */
-    destroy: () => void;
-}
-/**
- * Hook that manages a hidden div for frame capture.
- */
-declare function useFrameCapture(): FrameCaptureHandle;
-
-/**
- * Main-thread WebCodecs encoder.
- *
- * Encodes video frames to MP4 using the WebCodecs API and mp4-muxer,
- * running directly on the main thread. This is simpler and avoids
- * worker module-resolution issues with bundlers. Since frame capture
- * via html2canvas (~100-200ms per frame) is the bottleneck — not
- * encoding (~1ms per frame with hardware-accelerated WebCodecs) —
- * worker offloading provides minimal benefit.
- *
- * Requirements: Chrome 94+ / Edge 94+ (WebCodecs support).
- */
-interface EncoderConfig {
-    width: number;
-    height: number;
-    fps: number;
-    quality: 'draft' | 'normal' | 'high';
-}
-interface MainThreadEncoder {
-    /** Encode a single frame. The bitmap is closed after encoding. */
-    encodeFrame(bitmap: ImageBitmap, frameIndex: number): void;
-    /** Flush pending frames and finalize the MP4. Returns the MP4 ArrayBuffer. */
-    finalize(): Promise<ArrayBuffer>;
-    /** Close the encoder without producing output (e.g., on cancel). */
-    close(): void;
-}
-/**
- * Check whether the browser supports WebCodecs video encoding.
- */
-declare function supportsWebCodecs(): boolean;
-/**
- * Create a main-thread WebCodecs encoder.
- *
- * Throws if WebCodecs is not available.
- */
-declare function createEncoder(config: EncoderConfig): MainThreadEncoder;
-
-export { type FrameCaptureHandle, type MainThreadEncoder, VideoExportButton, type VideoExportButtonProps, type VideoExportConfig, VideoExportModal, type VideoExportModalProps, type VideoExportResult, type VideoExportState, createEncoder, supportsWebCodecs, useFrameCapture, useVideoExport };
+export { VideoExportModal } from './VideoExportModal.js';
+export type { VideoExportModalProps } from './VideoExportModal.js';
+export { VideoExportButton } from './VideoExportButton.js';
+export type { VideoExportButtonProps } from './VideoExportButton.js';
+export { useVideoExport } from './hooks/useVideoExport.js';
+export type { VideoExportState, VideoExportConfig, VideoExportResult, } from './hooks/useVideoExport.js';
+export { useFrameCapture } from './hooks/useFrameCapture.js';
+export type { FrameCaptureHandle } from './hooks/useFrameCapture.js';
+export { supportsWebCodecs, createEncoder } from './mainThreadEncoder.js';
+export type { MainThreadEncoder } from './mainThreadEncoder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}