@bendyline/squisq-editor-react 1.3.0 → 1.5.0

package/dist/recorder/hooks/useMediaRecorder.d.ts

@@ -0,0 +1,90 @@
+/**
+ * useMediaRecorder
+ *
+ * React wrapper around `MediaRecorder` that handles stream acquisition,
+ * the recorder lifecycle, and produces a single `Blob` on stop. Selects
+ * a browser-supported MIME type via {@link resolveFormat}.
+ *
+ * Mirrors the shape of `useVideoExport` in `@bendyline/squisq-video-react`
+ * (request → start → stop → blob), inverted for capture rather than
+ * export.
+ */
+import { type CaptureKind } from '../formats.js';
+/** Which capture source to use. `screen+mic` mixes the microphone into the screen stream. */
+export type RecorderSource = 'mic' | 'camera' | 'screen' | 'screen+mic';
+/** Discriminated state describing what the recorder is currently doing. */
+export type RecorderState = 'idle' | 'requesting' | 'ready' | 'recording' | 'stopping' | 'stopped' | 'error';
+export interface UseMediaRecorderOptions {
+    /** Which capture pipeline to use. */
+    source: RecorderSource;
+    /**
+     * Preferred MIME type override. When the browser supports it, this
+     * wins over the default candidate list. When unset (or unsupported),
+     * the hook probes a built-in priority list.
+     */
+    mimeType?: string;
+    /** Video track constraints for camera / screen sources. */
+    videoConstraints?: MediaTrackConstraints | boolean;
+    /** Audio track constraints for mic / camera / screen+mic sources. */
+    audioConstraints?: MediaTrackConstraints | boolean;
+    /**
+     * Bits-per-second hint passed to `MediaRecorder`. Most browsers cap to
+     * reasonable defaults internally; leaving this undefined is usually
+     * fine.
+     */
+    bitsPerSecond?: number;
+    /**
+     * Whether to attempt to capture system audio when `source === 'screen'`
+     * or `'screen+mic'`. Browser support is limited (desktop Chromium
+     * only); when unsupported the resulting stream simply omits it.
+     */
+    systemAudio?: boolean;
+}
+export interface UseMediaRecorderResult {
+    /** Current recorder state. */
+    state: RecorderState;
+    /** Live `MediaStream` after `request()` succeeds; useful for preview. */
+    stream: MediaStream | null;
+    /** Final `Blob` after `stop()` resolves, or `null` while recording. */
+    blob: Blob | null;
+    /** MIME type the recorder actually used (after `request()`). */
+    mimeType: string | null;
+    /** File extension matching `mimeType` (e.g. `.webm`). */
+    extension: string | null;
+    /** Suggested container directory (`'audio'` for mic, `'video'` for camera/screen). */
+    directory: 'audio' | 'video' | null;
+    /** Milliseconds elapsed since `start()` was called. Updates ~10× per second while recording. */
+    durationMs: number;
+    /** Most recent error, if any. */
+    error: Error | null;
+    /**
+     * Acquire the stream and prepare a `MediaRecorder`. After this resolves
+     * the hook is in `'ready'` state and a `<video>`/`<audio>` element can
+     * preview `stream`. Call `start()` to begin recording.
+     */
+    request: () => Promise<void>;
+    /** Start recording. Must be called from `'ready'`. */
+    start: () => void;
+    /**
+     * Stop recording and resolve with the resulting `Blob`. Safe to call
+     * from `'recording'`; a no-op from any other state (resolves with the
+     * existing `blob`, or `null`).
+     */
+    stop: () => Promise<Blob | null>;
+    /**
+     * Tear everything down — stops the recorder if running, releases all
+     * tracks, disposes the AudioContext mixer (if any), and returns to
+     * `'idle'`. Always safe to call.
+     */
+    cancel: () => void;
+    /** Reset state without releasing the stream. Useful for re-recording. */
+    reset: () => void;
+}
+/**
+ * Returns the kind of capture that the given source produces. Exposed
+ * separately from {@link useMediaRecorder} so non-React callers
+ * (e.g. headless tests) can resolve a format up front.
+ */
+export declare function getCaptureKind(source: RecorderSource): CaptureKind;
+export declare function useMediaRecorder(options: UseMediaRecorderOptions): UseMediaRecorderResult;
+//# sourceMappingURL=useMediaRecorder.d.ts.map

package/dist/recorder/hooks/useMediaRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorder/hooks/useMediaRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAKvB,6FAA6F;AAC7F,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;AAExE,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,YAAY,GACZ,OAAO,GACP,WAAW,GACX,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACnD,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACnD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,yEAAyE;IACzE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sFAAsF;IACtF,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;IACpC,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,sDAAsD;IACtD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;OAIG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACjC;;;;OAIG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AA0CD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAElE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAgOzF"}

package/dist/recorder/hooks/useMediaRecorder.js

@@ -0,0 +1,277 @@
+/**
+ * useMediaRecorder
+ *
+ * React wrapper around `MediaRecorder` that handles stream acquisition,
+ * the recorder lifecycle, and produces a single `Blob` on stop. Selects
+ * a browser-supported MIME type via {@link resolveFormat}.
+ *
+ * Mirrors the shape of `useVideoExport` in `@bendyline/squisq-video-react`
+ * (request → start → stop → blob), inverted for capture rather than
+ * export.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { resolveFormat, supportsMediaRecorder, } from '../formats.js';
+import { requestMicStream } from '../sources/micStream.js';
+import { requestCameraStream } from '../sources/cameraStream.js';
+import { requestScreenStream } from '../sources/screenStream.js';
+/**
+ * Acquire the right stream for the chosen source. Returns the stream
+ * plus an optional `dispose` callback for sources that own auxiliary
+ * resources (e.g. the screen+mic AudioContext mixer).
+ */
+async function acquireStream(opts) {
+    switch (opts.source) {
+        case 'mic': {
+            const audio = typeof opts.audioConstraints === 'object' ? opts.audioConstraints : undefined;
+            const stream = await requestMicStream(audio);
+            return { stream, dispose: () => { } };
+        }
+        case 'camera': {
+            const stream = await requestCameraStream({
+                video: opts.videoConstraints ?? true,
+                audio: opts.audioConstraints ?? true,
+            });
+            return { stream, dispose: () => { } };
+        }
+        case 'screen':
+        case 'screen+mic': {
+            const handle = await requestScreenStream({
+                video: opts.videoConstraints ?? true,
+                systemAudio: opts.systemAudio ?? false,
+                includeMicrophone: opts.source === 'screen+mic',
+                microphoneConstraints: typeof opts.audioConstraints === 'object' ? opts.audioConstraints : undefined,
+            });
+            return { stream: handle.stream, dispose: handle.dispose };
+        }
+    }
+}
+/** Whether the chosen source records video (vs. audio-only). */
+function captureKindFor(source) {
+    return source === 'mic' ? 'audio' : 'video';
+}
+/**
+ * Returns the kind of capture that the given source produces. Exposed
+ * separately from {@link useMediaRecorder} so non-React callers
+ * (e.g. headless tests) can resolve a format up front.
+ */
+export function getCaptureKind(source) {
+    return captureKindFor(source);
+}
+export function useMediaRecorder(options) {
+    const [state, setState] = useState('idle');
+    const [stream, setStream] = useState(null);
+    const [blob, setBlob] = useState(null);
+    const [format, setFormat] = useState(null);
+    const [durationMs, setDurationMs] = useState(0);
+    const [error, setError] = useState(null);
+    const recorderRef = useRef(null);
+    const chunksRef = useRef([]);
+    const disposeStreamRef = useRef(null);
+    const startTimestampRef = useRef(null);
+    const tickerRef = useRef(null);
+    const stopResolversRef = useRef([]);
+    // Stable copy of options for callbacks that read them late. Re-evaluated
+    // each render, but each callback closes over the ref so we don't have
+    // to recreate them on every options change.
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const clearTicker = useCallback(() => {
+        if (tickerRef.current !== null) {
+            clearInterval(tickerRef.current);
+            tickerRef.current = null;
+        }
+    }, []);
+    const releaseStream = useCallback(() => {
+        const s = recorderRef.current?.stream;
+        if (s) {
+            s.getTracks().forEach((t) => t.stop());
+        }
+        // Also stop whatever we last handed to setStream — it may differ
+        // from recorderRef.current.stream when stream/recorder lifecycles
+        // diverged (e.g. cancel before start).
+        setStream((current) => {
+            current?.getTracks().forEach((t) => t.stop());
+            return null;
+        });
+        disposeStreamRef.current?.();
+        disposeStreamRef.current = null;
+    }, []);
+    const reset = useCallback(() => {
+        setBlob(null);
+        setDurationMs(0);
+        setError(null);
+        chunksRef.current = [];
+        startTimestampRef.current = null;
+        clearTicker();
+        // If a stream is still live from a prior `request()`, hop back to
+        // `'ready'` so the UI can offer "record again" without the caller
+        // having to re-acquire permissions. Otherwise drop to `'idle'`.
+        const rec = recorderRef.current;
+        if (rec && rec.state === 'inactive' && rec.stream.active) {
+            setState('ready');
+        }
+        else {
+            setState('idle');
+        }
+    }, [clearTicker]);
+    const cancel = useCallback(() => {
+        const rec = recorderRef.current;
+        if (rec && rec.state !== 'inactive') {
+            try {
+                rec.stop();
+            }
+            catch {
+                // Ignore — we're tearing down anyway.
+            }
+        }
+        recorderRef.current = null;
+        releaseStream();
+        clearTicker();
+        chunksRef.current = [];
+        startTimestampRef.current = null;
+        // Any in-flight stop() promises won't get a blob.
+        stopResolversRef.current.splice(0).forEach((resolve) => resolve(null));
+        setBlob(null);
+        setDurationMs(0);
+        setError(null);
+        setState('idle');
+    }, [clearTicker, releaseStream]);
+    const request = useCallback(async () => {
+        if (!supportsMediaRecorder()) {
+            const err = new Error('MediaRecorder is not supported in this environment.');
+            setError(err);
+            setState('error');
+            throw err;
+        }
+        if (state === 'recording' || state === 'stopping') {
+            // Don't start a parallel acquisition while one is in flight.
+            return;
+        }
+        setError(null);
+        setState('requesting');
+        try {
+            const { stream: nextStream, dispose } = await acquireStream(optionsRef.current);
+            const resolved = resolveFormat(captureKindFor(optionsRef.current.source), optionsRef.current.mimeType);
+            const recorderOptions = {};
+            if (resolved.mimeType)
+                recorderOptions.mimeType = resolved.mimeType;
+            if (optionsRef.current.bitsPerSecond) {
+                recorderOptions.bitsPerSecond = optionsRef.current.bitsPerSecond;
+            }
+            const recorder = new MediaRecorder(nextStream, recorderOptions);
+            recorder.ondataavailable = (e) => {
+                if (e.data && e.data.size > 0)
+                    chunksRef.current.push(e.data);
+            };
+            recorder.onstop = () => {
+                // The recorded MIME type is authoritative once data is in hand —
+                // some browsers down-negotiate the format (e.g. drop codec hint).
+                const recordedType = recorder.mimeType || resolved.mimeType || 'application/octet-stream';
+                const finalBlob = new Blob(chunksRef.current, { type: recordedType });
+                chunksRef.current = [];
+                setBlob(finalBlob);
+                setState('stopped');
+                clearTicker();
+                stopResolversRef.current.splice(0).forEach((resolve) => resolve(finalBlob));
+            };
+            recorder.onerror = (event) => {
+                const detail = event.error;
+                const err = detail instanceof Error ? detail : new Error('Recorder error');
+                setError(err);
+                setState('error');
+                clearTicker();
+                stopResolversRef.current.splice(0).forEach((resolve) => resolve(null));
+            };
+            recorderRef.current = recorder;
+            disposeStreamRef.current = dispose;
+            setStream(nextStream);
+            setFormat(resolved);
+            setBlob(null);
+            setDurationMs(0);
+            setState('ready');
+        }
+        catch (err) {
+            const normalized = err instanceof Error ? err : new Error('Stream acquisition failed');
+            setError(normalized);
+            setState('error');
+            throw normalized;
+        }
+    }, [state, clearTicker]);
+    const start = useCallback(() => {
+        const rec = recorderRef.current;
+        if (!rec) {
+            const err = new Error('Recorder is not ready. Call request() first.');
+            setError(err);
+            setState('error');
+            return;
+        }
+        if (rec.state === 'recording')
+            return;
+        chunksRef.current = [];
+        setBlob(null);
+        setDurationMs(0);
+        startTimestampRef.current = Date.now();
+        rec.start(1000);
+        setState('recording');
+        clearTicker();
+        tickerRef.current = setInterval(() => {
+            if (startTimestampRef.current !== null) {
+                setDurationMs(Date.now() - startTimestampRef.current);
+            }
+        }, 100);
+    }, [clearTicker]);
+    const stop = useCallback(() => {
+        const rec = recorderRef.current;
+        if (!rec || rec.state === 'inactive') {
+            return Promise.resolve(blob);
+        }
+        setState('stopping');
+        return new Promise((resolve) => {
+            stopResolversRef.current.push(resolve);
+            try {
+                rec.stop();
+            }
+            catch (err) {
+                const normalized = err instanceof Error ? err : new Error('Failed to stop recorder');
+                setError(normalized);
+                setState('error');
+                clearTicker();
+                stopResolversRef.current.splice(0).forEach((r) => r(null));
+            }
+        });
+    }, [blob, clearTicker]);
+    // Final unmount cleanup — make sure we don't leak the camera light /
+    // screen-capture indicator if the component disappears mid-recording.
+    useEffect(() => {
+        return () => {
+            const rec = recorderRef.current;
+            if (rec && rec.state !== 'inactive') {
+                try {
+                    rec.stop();
+                }
+                catch {
+                    // ignore
+                }
+            }
+            releaseStream();
+            clearTicker();
+            stopResolversRef.current.splice(0).forEach((resolve) => resolve(null));
+        };
+    }, [releaseStream, clearTicker]);
+    return {
+        state,
+        stream,
+        blob,
+        mimeType: format?.mimeType ?? null,
+        extension: format?.extension ?? null,
+        directory: format?.directory ?? null,
+        durationMs,
+        error,
+        request,
+        start,
+        stop,
+        cancel,
+        reset,
+    };
+}
+//# sourceMappingURL=useMediaRecorder.js.map

package/dist/recorder/hooks/useMediaRecorder.js.map

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

package/dist/recorder/hooks/useStreamPreview.d.ts

@@ -0,0 +1,22 @@
+/**
+ * useStreamPreview — binds a `MediaStream` to a `<video>` element's
+ * `srcObject`. Decouples the preview surface from `useMediaRecorder`,
+ * letting hosts compose the preview element however they like.
+ */
+import { type RefObject } from 'react';
+/**
+ * Assign `stream` to `<video>.srcObject` whenever either changes; clears
+ * it on unmount or when `stream` is `null`. The element is set to
+ * `playsInline` + `muted` automatically because previewing your own
+ * microphone with audio playthrough creates a feedback loop.
+ *
+ * @example
+ * ```tsx
+ * const videoRef = useRef<HTMLVideoElement>(null);
+ * const { stream } = useMediaRecorder({ source: 'camera' });
+ * useStreamPreview(videoRef, stream);
+ * return <video ref={videoRef} autoPlay />;
+ * ```
+ */
+export declare function useStreamPreview(ref: RefObject<HTMLVideoElement | null>, stream: MediaStream | null): void;
+//# sourceMappingURL=useStreamPreview.d.ts.map

package/dist/recorder/hooks/useStreamPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamPreview.d.ts","sourceRoot":"","sources":["../../../src/recorder/hooks/useStreamPreview.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EACvC,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,IAAI,CAqBN"}

package/dist/recorder/hooks/useStreamPreview.js

@@ -0,0 +1,44 @@
+/**
+ * useStreamPreview — binds a `MediaStream` to a `<video>` element's
+ * `srcObject`. Decouples the preview surface from `useMediaRecorder`,
+ * letting hosts compose the preview element however they like.
+ */
+import { useEffect } from 'react';
+/**
+ * Assign `stream` to `<video>.srcObject` whenever either changes; clears
+ * it on unmount or when `stream` is `null`. The element is set to
+ * `playsInline` + `muted` automatically because previewing your own
+ * microphone with audio playthrough creates a feedback loop.
+ *
+ * @example
+ * ```tsx
+ * const videoRef = useRef<HTMLVideoElement>(null);
+ * const { stream } = useMediaRecorder({ source: 'camera' });
+ * useStreamPreview(videoRef, stream);
+ * return <video ref={videoRef} autoPlay />;
+ * ```
+ */
+export function useStreamPreview(ref, stream) {
+    useEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        el.muted = true;
+        el.playsInline = true;
+        el.srcObject = stream;
+        if (stream) {
+            // Some browsers don't auto-play on srcObject assignment; trigger
+            // it explicitly and ignore the inevitable "user gesture required"
+            // rejections — the preview will play on the next interaction.
+            void el.play().catch(() => { });
+        }
+        return () => {
+            // Only detach when this effect is tearing down. Don't stop tracks
+            // — that's the recorder's responsibility.
+            if (el.srcObject === stream) {
+                el.srcObject = null;
+            }
+        };
+    }, [ref, stream]);
+}
+//# sourceMappingURL=useStreamPreview.js.map

package/dist/recorder/hooks/useStreamPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamPreview.js","sourceRoot":"","sources":["../../../src/recorder/hooks/useStreamPreview.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAuC,EACvC,MAA0B;IAE1B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC;QAChB,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC;QACtB,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,iEAAiE;YACjE,kEAAkE;YAClE,8DAA8D;YAC9D,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,EAAE;YACV,kEAAkE;YAClE,0CAA0C;YAC1C,IAAI,EAAE,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/recorder/sources/cameraStream.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Camera + microphone capture via `getUserMedia({ video, audio })`.
+ */
+export interface CameraStreamOptions {
+    /** Video track constraints (resolution, facing mode, frame rate). Pass `true` for browser default, or `false` to omit video. */
+    video?: boolean | MediaTrackConstraints;
+    /** Audio track constraints. Pass `true` for browser default, or `false` to omit audio. */
+    audio?: boolean | MediaTrackConstraints;
+}
+/**
+ * Request a camera + mic `MediaStream`. Caller owns the stream and must
+ * stop its tracks when done.
+ *
+ * Both tracks are requested by default. To capture video only, pass
+ * `audio: false`; to capture audio only use {@link requestMicStream}
+ * instead.
+ *
+ * @throws When `mediaDevices` is unavailable, or when the user denies
+ *   permission.
+ */
+export declare function requestCameraStream(options?: CameraStreamOptions): Promise<MediaStream>;
+//# sourceMappingURL=cameraStream.d.ts.map

package/dist/recorder/sources/cameraStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraStream.d.ts","sourceRoot":"","sources":["../../../src/recorder/sources/cameraStream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,mBAAmB;IAClC,gIAAgI;IAChI,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAO7F"}

package/dist/recorder/sources/cameraStream.js

@@ -0,0 +1,24 @@
+/**
+ * Camera + microphone capture via `getUserMedia({ video, audio })`.
+ */
+import { supportsUserMedia } from '../formats.js';
+/**
+ * Request a camera + mic `MediaStream`. Caller owns the stream and must
+ * stop its tracks when done.
+ *
+ * Both tracks are requested by default. To capture video only, pass
+ * `audio: false`; to capture audio only use {@link requestMicStream}
+ * instead.
+ *
+ * @throws When `mediaDevices` is unavailable, or when the user denies
+ *   permission.
+ */
+export async function requestCameraStream(options) {
+    if (!supportsUserMedia()) {
+        throw new Error('navigator.mediaDevices.getUserMedia is not available in this environment.');
+    }
+    const video = options?.video ?? true;
+    const audio = options?.audio ?? true;
+    return navigator.mediaDevices.getUserMedia({ video, audio });
+}
+//# sourceMappingURL=cameraStream.js.map

package/dist/recorder/sources/cameraStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraStream.js","sourceRoot":"","sources":["../../../src/recorder/sources/cameraStream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA6B;IACrE,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;IACrC,OAAO,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/recorder/sources/micStream.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Microphone-only capture via `getUserMedia({ audio: true })`.
+ */
+/**
+ * Request a microphone-only `MediaStream`. Caller owns the stream and
+ * must stop its tracks when done.
+ *
+ * @param constraints - Optional audio constraints (sample rate, device
+ *   id, echo cancellation, etc.). Defaults to `true` — let the browser
+ *   pick.
+ * @throws When `mediaDevices` is unavailable, or when the user denies
+ *   permission (the underlying `getUserMedia` rejection propagates).
+ */
+export declare function requestMicStream(constraints?: MediaTrackConstraints): Promise<MediaStream>;
+//# sourceMappingURL=micStream.d.ts.map

package/dist/recorder/sources/micStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micStream.d.ts","sourceRoot":"","sources":["../../../src/recorder/sources/micStream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAQhG"}

package/dist/recorder/sources/micStream.js

@@ -0,0 +1,24 @@
+/**
+ * Microphone-only capture via `getUserMedia({ audio: true })`.
+ */
+import { supportsUserMedia } from '../formats.js';
+/**
+ * Request a microphone-only `MediaStream`. Caller owns the stream and
+ * must stop its tracks when done.
+ *
+ * @param constraints - Optional audio constraints (sample rate, device
+ *   id, echo cancellation, etc.). Defaults to `true` — let the browser
+ *   pick.
+ * @throws When `mediaDevices` is unavailable, or when the user denies
+ *   permission (the underlying `getUserMedia` rejection propagates).
+ */
+export async function requestMicStream(constraints) {
+    if (!supportsUserMedia()) {
+        throw new Error('navigator.mediaDevices.getUserMedia is not available in this environment.');
+    }
+    return navigator.mediaDevices.getUserMedia({
+        audio: constraints ?? true,
+        video: false,
+    });
+}
+//# sourceMappingURL=micStream.js.map

package/dist/recorder/sources/micStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"micStream.js","sourceRoot":"","sources":["../../../src/recorder/sources/micStream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmC;IACxE,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC;QACzC,KAAK,EAAE,WAAW,IAAI,IAAI;QAC1B,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/recorder/sources/screenStream.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Screen capture via `getDisplayMedia`, with optional microphone mixing.
+ *
+ * The browser-native `getDisplayMedia({ audio: true })` flag only
+ * captures *system* audio (and only on Chromium on desktop). For
+ * narrated screencasts, hosts usually want the speaker's voice too —
+ * we provide an opt-in "include mic" path that pulls a parallel
+ * `getUserMedia` audio track and mixes it into the screen stream via
+ * `AudioContext`, so the resulting `MediaStream` carries a single audio
+ * track and a single video track.
+ */
+export interface ScreenStreamOptions {
+    /** Video constraints for the screen surface. Pass `true` for browser default. */
+    video?: boolean | MediaTrackConstraints;
+    /**
+     * Whether to attempt to capture the system audio (tab / window / monitor
+     * audio). Browser support is limited (desktop Chromium only); when the
+     * platform doesn't honor this flag, the resulting stream simply omits
+     * the system audio track.
+     */
+    systemAudio?: boolean;
+    /**
+     * Whether to also pull the microphone via `getUserMedia` and mix it
+     * into the resulting stream's audio track. When both `systemAudio` and
+     * `includeMicrophone` produce tracks, they're combined via
+     * `AudioContext` into a single output track.
+     */
+    includeMicrophone?: boolean;
+    /** Microphone track constraints, when `includeMicrophone` is true. */
+    microphoneConstraints?: MediaTrackConstraints;
+}
+/**
+ * Handle returned by {@link requestScreenStream}. The `stream` is what
+ * gets handed to `MediaRecorder`; the `dispose()` callback shuts down
+ * any auxiliary resources (e.g. the mic-mix `AudioContext`). Callers
+ * must also stop the stream's tracks via `stream.getTracks().forEach(t
+ * => t.stop())` when done — `dispose()` cleans up everything that isn't
+ * the stream itself.
+ */
+export interface ScreenStreamHandle {
+    stream: MediaStream;
+    /** Auxiliary cleanup beyond the stream tracks. Safe to call multiple times. */
+    dispose: () => void;
+}
+/**
+ * Request a screen-capture `MediaStream`, optionally with a mixed-in
+ * microphone track. Caller owns the resulting stream.
+ *
+ * @throws When `getDisplayMedia` isn't available, or when the user
+ *   cancels the picker / denies permission.
+ */
+export declare function requestScreenStream(options?: ScreenStreamOptions): Promise<ScreenStreamHandle>;
+//# sourceMappingURL=screenStream.d.ts.map

package/dist/recorder/sources/screenStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenStream.d.ts","sourceRoot":"","sources":["../../../src/recorder/sources/screenStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACxC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AA8BD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA2E7B"}