tempest-react-sdk 0.78.0 → 0.80.0

package/dist/capture/use-screen-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-capture.js","names":[],"sources":["../../src/capture/use-screen-capture.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — getDisplayMedia's cancellation is indistinguishable\n * from a policy block, so the hook holds the classification, the track's own `ended`\n * event (the user can stop sharing from the browser's bar) and the stop path in one\n * place — all three end the same session.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** Lifecycle of a screen share. */\nexport type ScreenCaptureStatus = \"idle\" | \"requesting\" | \"sharing\" | \"error\";\n\n/** Which surface to put first in the picker. */\nexport type DisplaySurfaceHint = \"monitor\" | \"window\" | \"browser\";\n\n/**\n * Hints `getDisplayMedia` takes that TypeScript's `DisplayMediaStreamOptions` does not\n * list yet.\n */\ntype DisplayMediaOptionsWithHints = DisplayMediaStreamOptions & {\n    preferCurrentTab?: boolean;\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    surfaceSwitching?: \"include\" | \"exclude\";\n    systemAudio?: \"include\" | \"exclude\";\n};\n\n/** `displaySurface` is a constrainable property of a display track, but not in the DOM lib. */\ntype DisplayVideoConstraints = MediaTrackConstraints & { displaySurface?: DisplaySurfaceHint };\n\n/** Options for {@link useScreenCapture}. */\nexport interface UseScreenCaptureOptions {\n    /**\n     * Capture the tab's audio too. Default `false`.\n     *\n     * Chromium only offers this for a **tab** — sharing a window or a whole screen\n     * yields no audio track no matter what you ask for, and Safari has no display\n     * audio at all. Ask for it and check what you got.\n     */\n    audio?: boolean;\n    /**\n     * Which surface the picker should offer first — `\"browser\"` is a tab.\n     *\n     * A hint, never a guarantee: the user can always pick something else, and Firefox\n     * ignores it. Read `surface` afterwards to learn what actually happened.\n     */\n    displaySurface?: DisplaySurfaceHint;\n    /**\n     * Put *this* tab at the top of the picker. Default `false`.\n     *\n     * The right setting for \"record what you are seeing right now\" in a support flow.\n     * Chromium only.\n     */\n    preferCurrentTab?: boolean;\n    /** Offer this tab in the list at all. `\"exclude\"` prevents the hall-of-mirrors capture. */\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    /** Let the user switch to a different surface mid-share, without a new prompt. */\n    surfaceSwitching?: \"include\" | \"exclude\";\n    /** Include the system audio when a whole screen is shared. Chromium, Windows only. */\n    systemAudio?: \"include\" | \"exclude\";\n    /** Escape hatch: full options, replacing everything above. */\n    options?: DisplayMediaStreamOptions;\n    /**\n     * The user stopped the share from the browser's own bar.\n     *\n     * The single most important callback here — see the note on\n     * {@link useScreenCapture}.\n     */\n    onEnded?: () => void;\n    /**\n     * The user dismissed the picker. **Not an error.**\n     *\n     * Receives the rejection so an app that needs to tell a dismissal from an OS-level\n     * block (macOS screen-recording permission) can look at the message. Most should\n     * simply return the UI to its previous state.\n     */\n    onCancelled?: (reason: unknown) => void;\n}\n\n/** Value returned by {@link useScreenCapture}. */\nexport interface UseScreenCaptureResult {\n    status: ScreenCaptureStatus;\n    /** The live stream, or `null`. Feed it to {@link useVideoRecorder} or a `<video>`. */\n    stream: MediaStream | null;\n    /** Classified error, or `null`. A cancelled picker leaves this `null`. */\n    error: MediaAccessError | null;\n    /** What the user actually picked, when the browser reports it. */\n    surface: string | null;\n    /** Whether the stream carries an audio track — ask, do not assume. */\n    hasAudio: boolean;\n    /** `false` when `getDisplayMedia` is missing (every browser on iOS, insecure pages). */\n    supported: boolean;\n    /** Open the picker. Must be called from a user gesture. */\n    start: () => void;\n    /** Stop sharing from the app side. Fires nothing — you asked for it. */\n    stop: () => void;\n}\n\n/** Whether `getDisplayMedia` is reachable at all. */\nexport function isScreenCaptureSupported(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        navigator.mediaDevices !== undefined &&\n        typeof navigator.mediaDevices.getDisplayMedia === \"function\"\n    );\n}\n\n/**\n * A rejection from `getDisplayMedia` that means \"the user said no thanks\".\n *\n * There is no distinct exception for a dismissed picker: closing it produces the same\n * `NotAllowedError` as a policy block, and some builds report `AbortError` instead. The\n * useful default is therefore to treat both as a cancellation, because a\n * display-capture prompt is **always** user-initiated — nothing can open it behind\n * their back — so the overwhelmingly likely cause is that they changed their mind, and\n * a red error toast for that punishes them for it. The rejection is handed to\n * `onCancelled` so the rarer causes stay diagnosable.\n */\nfunction isCancellation(err: unknown): boolean {\n    return (\n        err instanceof DOMException && (err.name === \"NotAllowedError\" || err.name === \"AbortError\")\n    );\n}\n\n/**\n * Capture a screen, a window or a tab with `getDisplayMedia`.\n *\n * Three states decide whether this feels right, and two of them are easy to miss:\n *\n * - **The user dismissed the picker.** A rejection, but not a failure. It leaves\n *   `error` at `null` and the status back at `\"idle\"`, and calls `onCancelled`.\n * - **The user stopped the share from the browser's own bar.** Nothing in your UI was\n *   clicked and no promise rejects — the *only* signal is the video track's `ended`\n *   event, so the hook listens for it and clears the stream. Without that listener, an\n *   app shows \"gravando\" over a stream that is already dead.\n * - **The share is live.** `surface` says what was picked and `hasAudio` says whether\n *   audio actually came along, which is not what you asked for but what you got.\n *\n * The stream is owned here: `stop()` and unmount both release every track. A recorder\n * built on it (`useVideoRecorder`) deliberately does not, so stopping a recording\n * leaves the share running for the next take.\n *\n * @param options - See {@link UseScreenCaptureOptions}.\n * @returns The stream, its status, a classified error and `start`/`stop`.\n *\n * @example\n * const screen = useScreenCapture({ preferCurrentTab: true, onEnded: () => save() });\n * const rec = useVideoRecorder(screen.stream);\n * <button onClick={screen.start}>Compartilhar tela</button>\n */\nexport function useScreenCapture(options: UseScreenCaptureOptions = {}): UseScreenCaptureResult {\n    const {\n        audio = false,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        options: raw,\n        onEnded,\n        onCancelled,\n    } = options;\n\n    const [status, setStatus] = useState<ScreenCaptureStatus>(\"idle\");\n    const [stream, setStream] = useState<MediaStream | null>(null);\n    const [error, setError] = useState<MediaAccessError | null>(null);\n    const [surface, setSurface] = useState<string | null>(null);\n    const [hasAudio, setHasAudio] = useState(false);\n    const [supported] = useState(isScreenCaptureSupported);\n\n    const streamRef = useRef<MediaStream | null>(null);\n    const detach = useRef<(() => void) | null>(null);\n    const generation = useRef(0);\n\n    const emitEnded = useStableCallback(() => onEnded?.());\n    const emitCancelled = useStableCallback((reason: unknown) => onCancelled?.(reason));\n\n    const release = useCallback((): void => {\n        detach.current?.();\n        detach.current = null;\n        streamRef.current?.getTracks().forEach((track) => track.stop());\n        streamRef.current = null;\n    }, []);\n\n    const reset = useCallback((): void => {\n        setStream(null);\n        setSurface(null);\n        setHasAudio(false);\n    }, []);\n\n    const stop = useCallback((): void => {\n        generation.current += 1;\n        release();\n        reset();\n        setStatus(\"idle\");\n        setError(null);\n    }, [release, reset]);\n\n    const start = useCallback((): void => {\n        if (streamRef.current) return;\n        const run = (generation.current += 1);\n        setStatus(\"requesting\");\n        setError(null);\n\n        if (!isScreenCaptureSupported()) {\n            setError(missingCaptureApiError(\"screen\"));\n            setStatus(\"error\");\n            return;\n        }\n\n        const video: DisplayVideoConstraints = displaySurface ? { displaySurface } : {};\n        const request: DisplayMediaOptionsWithHints = raw ?? {\n            video,\n            audio,\n            ...(preferCurrentTab !== undefined ? { preferCurrentTab } : {}),\n            ...(selfBrowserSurface !== undefined ? { selfBrowserSurface } : {}),\n            ...(surfaceSwitching !== undefined ? { surfaceSwitching } : {}),\n            ...(systemAudio !== undefined ? { systemAudio } : {}),\n        };\n\n        void navigator.mediaDevices\n            .getDisplayMedia(request)\n            .then((next) => {\n                if (run !== generation.current) {\n                    next.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                streamRef.current = next;\n                const track = next.getVideoTracks()[0];\n                const ended = (): void => {\n                    if (run !== generation.current) return;\n                    release();\n                    reset();\n                    setStatus(\"idle\");\n                    emitEnded();\n                };\n                track?.addEventListener(\"ended\", ended);\n                detach.current = () => track?.removeEventListener(\"ended\", ended);\n\n                setStream(next);\n                setSurface(track?.getSettings().displaySurface ?? null);\n                setHasAudio(next.getAudioTracks().length > 0);\n                setStatus(\"sharing\");\n            })\n            .catch((err: unknown) => {\n                if (run !== generation.current) return;\n                if (isCancellation(err)) {\n                    setStatus(\"idle\");\n                    emitCancelled(err);\n                    return;\n                }\n                setError(classifyMediaError(err, \"screen\"));\n                setStatus(\"error\");\n            });\n    }, [\n        audio,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        raw,\n        release,\n        reset,\n        emitEnded,\n        emitCancelled,\n    ]);\n\n    useEffect(() => release, [release]);\n\n    return { status, stream, error, surface, hasAudio, supported, start, stop };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-screen-capture.js","names":["isScreenCaptureSupported","isCancellation","err","useScreenCapture","raw","options","status","setStatus","useState","stream","setStream","error","setError","surface","setSurface","hasAudio","setHasAudio","supported","streamRef","useRef","detach","generation","emitEnded","useStableCallback","onEnded","emitCancelled","onCancelled","reason","release","useCallback","track","reset","stop","start","run","missingCaptureApiError","request","displaySurface","preferCurrentTab","selfBrowserSurface","surfaceSwitching","systemAudio","next","ended","classifyMediaError","audio","useEffect"],"sources":["../../src/capture/use-screen-capture.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — getDisplayMedia's cancellation is indistinguishable\n * from a policy block, so the hook holds the classification, the track's own `ended`\n * event (the user can stop sharing from the browser's bar) and the stop path in one\n * place — all three end the same session.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** Lifecycle of a screen share. */\nexport type ScreenCaptureStatus = \"idle\" | \"requesting\" | \"sharing\" | \"error\";\n\n/** Which surface to put first in the picker. */\nexport type DisplaySurfaceHint = \"monitor\" | \"window\" | \"browser\";\n\n/**\n * Hints `getDisplayMedia` takes that TypeScript's `DisplayMediaStreamOptions` does not\n * list yet.\n */\ntype DisplayMediaOptionsWithHints = DisplayMediaStreamOptions & {\n    preferCurrentTab?: boolean;\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    surfaceSwitching?: \"include\" | \"exclude\";\n    systemAudio?: \"include\" | \"exclude\";\n};\n\n/** `displaySurface` is a constrainable property of a display track, but not in the DOM lib. */\ntype DisplayVideoConstraints = MediaTrackConstraints & { displaySurface?: DisplaySurfaceHint };\n\n/** Options for {@link useScreenCapture}. */\nexport interface UseScreenCaptureOptions {\n    /**\n     * Capture the tab's audio too. Default `false`.\n     *\n     * Chromium only offers this for a **tab** — sharing a window or a whole screen\n     * yields no audio track no matter what you ask for, and Safari has no display\n     * audio at all. Ask for it and check what you got.\n     */\n    audio?: boolean;\n    /**\n     * Which surface the picker should offer first — `\"browser\"` is a tab.\n     *\n     * A hint, never a guarantee: the user can always pick something else, and Firefox\n     * ignores it. Read `surface` afterwards to learn what actually happened.\n     */\n    displaySurface?: DisplaySurfaceHint;\n    /**\n     * Put *this* tab at the top of the picker. Default `false`.\n     *\n     * The right setting for \"record what you are seeing right now\" in a support flow.\n     * Chromium only.\n     */\n    preferCurrentTab?: boolean;\n    /** Offer this tab in the list at all. `\"exclude\"` prevents the hall-of-mirrors capture. */\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    /** Let the user switch to a different surface mid-share, without a new prompt. */\n    surfaceSwitching?: \"include\" | \"exclude\";\n    /** Include the system audio when a whole screen is shared. Chromium, Windows only. */\n    systemAudio?: \"include\" | \"exclude\";\n    /** Escape hatch: full options, replacing everything above. */\n    options?: DisplayMediaStreamOptions;\n    /**\n     * The user stopped the share from the browser's own bar.\n     *\n     * The single most important callback here — see the note on\n     * {@link useScreenCapture}.\n     */\n    onEnded?: () => void;\n    /**\n     * The user dismissed the picker. **Not an error.**\n     *\n     * Receives the rejection so an app that needs to tell a dismissal from an OS-level\n     * block (macOS screen-recording permission) can look at the message. Most should\n     * simply return the UI to its previous state.\n     */\n    onCancelled?: (reason: unknown) => void;\n}\n\n/** Value returned by {@link useScreenCapture}. */\nexport interface UseScreenCaptureResult {\n    status: ScreenCaptureStatus;\n    /** The live stream, or `null`. Feed it to {@link useVideoRecorder} or a `<video>`. */\n    stream: MediaStream | null;\n    /** Classified error, or `null`. A cancelled picker leaves this `null`. */\n    error: MediaAccessError | null;\n    /** What the user actually picked, when the browser reports it. */\n    surface: string | null;\n    /** Whether the stream carries an audio track — ask, do not assume. */\n    hasAudio: boolean;\n    /** `false` when `getDisplayMedia` is missing (every browser on iOS, insecure pages). */\n    supported: boolean;\n    /** Open the picker. Must be called from a user gesture. */\n    start: () => void;\n    /** Stop sharing from the app side. Fires nothing — you asked for it. */\n    stop: () => void;\n}\n\n/** Whether `getDisplayMedia` is reachable at all. */\nexport function isScreenCaptureSupported(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        navigator.mediaDevices !== undefined &&\n        typeof navigator.mediaDevices.getDisplayMedia === \"function\"\n    );\n}\n\n/**\n * A rejection from `getDisplayMedia` that means \"the user said no thanks\".\n *\n * There is no distinct exception for a dismissed picker: closing it produces the same\n * `NotAllowedError` as a policy block, and some builds report `AbortError` instead. The\n * useful default is therefore to treat both as a cancellation, because a\n * display-capture prompt is **always** user-initiated — nothing can open it behind\n * their back — so the overwhelmingly likely cause is that they changed their mind, and\n * a red error toast for that punishes them for it. The rejection is handed to\n * `onCancelled` so the rarer causes stay diagnosable.\n */\nfunction isCancellation(err: unknown): boolean {\n    return (\n        err instanceof DOMException && (err.name === \"NotAllowedError\" || err.name === \"AbortError\")\n    );\n}\n\n/**\n * Capture a screen, a window or a tab with `getDisplayMedia`.\n *\n * Three states decide whether this feels right, and two of them are easy to miss:\n *\n * - **The user dismissed the picker.** A rejection, but not a failure. It leaves\n *   `error` at `null` and the status back at `\"idle\"`, and calls `onCancelled`.\n * - **The user stopped the share from the browser's own bar.** Nothing in your UI was\n *   clicked and no promise rejects — the *only* signal is the video track's `ended`\n *   event, so the hook listens for it and clears the stream. Without that listener, an\n *   app shows \"gravando\" over a stream that is already dead.\n * - **The share is live.** `surface` says what was picked and `hasAudio` says whether\n *   audio actually came along, which is not what you asked for but what you got.\n *\n * The stream is owned here: `stop()` and unmount both release every track. A recorder\n * built on it (`useVideoRecorder`) deliberately does not, so stopping a recording\n * leaves the share running for the next take.\n *\n * @param options - See {@link UseScreenCaptureOptions}.\n * @returns The stream, its status, a classified error and `start`/`stop`.\n *\n * @example\n * const screen = useScreenCapture({ preferCurrentTab: true, onEnded: () => save() });\n * const rec = useVideoRecorder(screen.stream);\n * <button onClick={screen.start}>Compartilhar tela</button>\n */\nexport function useScreenCapture(options: UseScreenCaptureOptions = {}): UseScreenCaptureResult {\n    const {\n        audio = false,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        options: raw,\n        onEnded,\n        onCancelled,\n    } = options;\n\n    const [status, setStatus] = useState<ScreenCaptureStatus>(\"idle\");\n    const [stream, setStream] = useState<MediaStream | null>(null);\n    const [error, setError] = useState<MediaAccessError | null>(null);\n    const [surface, setSurface] = useState<string | null>(null);\n    const [hasAudio, setHasAudio] = useState(false);\n    const [supported] = useState(isScreenCaptureSupported);\n\n    const streamRef = useRef<MediaStream | null>(null);\n    const detach = useRef<(() => void) | null>(null);\n    const generation = useRef(0);\n\n    const emitEnded = useStableCallback(() => onEnded?.());\n    const emitCancelled = useStableCallback((reason: unknown) => onCancelled?.(reason));\n\n    const release = useCallback((): void => {\n        detach.current?.();\n        detach.current = null;\n        streamRef.current?.getTracks().forEach((track) => track.stop());\n        streamRef.current = null;\n    }, []);\n\n    const reset = useCallback((): void => {\n        setStream(null);\n        setSurface(null);\n        setHasAudio(false);\n    }, []);\n\n    const stop = useCallback((): void => {\n        generation.current += 1;\n        release();\n        reset();\n        setStatus(\"idle\");\n        setError(null);\n    }, [release, reset]);\n\n    const start = useCallback((): void => {\n        if (streamRef.current) return;\n        const run = (generation.current += 1);\n        setStatus(\"requesting\");\n        setError(null);\n\n        if (!isScreenCaptureSupported()) {\n            setError(missingCaptureApiError(\"screen\"));\n            setStatus(\"error\");\n            return;\n        }\n\n        const video: DisplayVideoConstraints = displaySurface ? { displaySurface } : {};\n        const request: DisplayMediaOptionsWithHints = raw ?? {\n            video,\n            audio,\n            ...(preferCurrentTab !== undefined ? { preferCurrentTab } : {}),\n            ...(selfBrowserSurface !== undefined ? { selfBrowserSurface } : {}),\n            ...(surfaceSwitching !== undefined ? { surfaceSwitching } : {}),\n            ...(systemAudio !== undefined ? { systemAudio } : {}),\n        };\n\n        void navigator.mediaDevices\n            .getDisplayMedia(request)\n            .then((next) => {\n                if (run !== generation.current) {\n                    next.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                streamRef.current = next;\n                const track = next.getVideoTracks()[0];\n                const ended = (): void => {\n                    if (run !== generation.current) return;\n                    release();\n                    reset();\n                    setStatus(\"idle\");\n                    emitEnded();\n                };\n                track?.addEventListener(\"ended\", ended);\n                detach.current = () => track?.removeEventListener(\"ended\", ended);\n\n                setStream(next);\n                setSurface(track?.getSettings().displaySurface ?? null);\n                setHasAudio(next.getAudioTracks().length > 0);\n                setStatus(\"sharing\");\n            })\n            .catch((err: unknown) => {\n                if (run !== generation.current) return;\n                if (isCancellation(err)) {\n                    setStatus(\"idle\");\n                    emitCancelled(err);\n                    return;\n                }\n                setError(classifyMediaError(err, \"screen\"));\n                setStatus(\"error\");\n            });\n    }, [\n        audio,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        raw,\n        release,\n        reset,\n        emitEnded,\n        emitCancelled,\n    ]);\n\n    useEffect(() => release, [release]);\n\n    return { status, stream, error, surface, hasAudio, supported, start, stop };\n}\n"],"mappings":"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"}

package/dist/capture/use-speech-recognition.cjs

@@ -1,2 +1,2 @@
-const e=require("../hooks/use-stable-callback.cjs");let t=require("react");var n={unsupported:`Speech recognition is not supported in this browser.`,"not-allowed":`Microphone permission denied. Enable access in your browser settings.`,"no-speech":`No speech was detected.`,"audio-capture":`No microphone available on this device.`,network:`The recognition service could not be reached.`,aborted:`Recognition was cancelled.`,"language-not-supported":`The recognition service does not support this language.`,unknown:`Unexpected error during speech recognition.`};function r(e){switch(e){case`not-allowed`:case`service-not-allowed`:return`not-allowed`;case`no-speech`:return`no-speech`;case`audio-capture`:return`audio-capture`;case`network`:return`network`;case`aborted`:return`aborted`;case`language-not-supported`:return`language-not-supported`;default:return`unknown`}}function i(){let e=globalThis,t=e.SpeechRecognition??e.webkitSpeechRecognition;return typeof t==`function`?t:null}function a(){return i()!==null}function o(o={}){let{lang:s=`pt-BR`,continuous:c=!1,interimResults:l=!0,maxAlternatives:u=1,onResult:d,onFinal:f,onError:p,onEnd:m,factory:h}=o,[g]=(0,t.useState)(()=>h!==void 0||a()),[_,v]=(0,t.useState)(!1),[y,b]=(0,t.useState)(``),[x,S]=(0,t.useState)(``),[C,w]=(0,t.useState)(null),T=(0,t.useRef)(null),E=e.useStableCallback(e=>d?.(e)),D=e.useStableCallback(e=>f?.(e)),O=e.useStableCallback(()=>m?.()),k=e.useStableCallback(e=>{w(e),p?.(e)}),A=(0,t.useCallback)(()=>{let e=T.current;e&&(e.onresult=null,e.onerror=null,e.onend=null,e.onstart=null,T.current=null)},[]),j=(0,t.useCallback)(()=>{if(T.current)return;let e=(h??(()=>{let e=i();return e?new e:null}))();if(!e){k({kind:`unsupported`,message:n.unsupported});return}e.lang=s,e.continuous=c,e.interimResults=l,e.maxAlternatives=u,e.onresult=e=>{let t=``,n=``;for(let r=e.resultIndex;r<e.results.length;r+=1){let i=e.results[r];if(!i)continue;let a=i[0]?.transcript??``;i.isFinal?t+=a:n+=a}S(n),t!==``&&(b(e=>e+t),D(t)),E({transcript:t===``?n:t,isFinal:t!==``})},e.onerror=e=>{let t=r(e.error);k({kind:t,message:e.message||n[t]})},e.onend=()=>{v(!1),S(``),A(),O()},e.onstart=()=>v(!0),w(null);try{e.start()}catch(e){k({kind:`unknown`,message:e instanceof Error?e.message:n.unknown});return}T.current=e,v(!0)},[s,c,l,u,h,E,D,O,k,A]),M=(0,t.useCallback)(()=>{T.current?.stop()},[]),N=(0,t.useCallback)(()=>{T.current?.abort()},[]),P=(0,t.useCallback)(()=>{b(``),S(``),w(null)},[]);return(0,t.useEffect)(()=>()=>{T.current?.abort(),A()},[A]),{supported:g,listening:_,transcript:y,interim:x,error:C,start:j,stop:M,abort:N,reset:P}}exports.isSpeechRecognitionSupported=a,exports.useSpeechRecognition=o;
+const e=require("../hooks/use-stable-callback.cjs");let t=require("react");var n={unsupported:`Speech recognition is not supported in this browser.`,"not-allowed":`Microphone permission denied. Enable access in your browser settings.`,"no-speech":`No speech was detected.`,"audio-capture":`No microphone available on this device.`,network:`The recognition service could not be reached.`,aborted:`Recognition was cancelled.`,"language-not-supported":`The recognition service does not support this language.`,unknown:`Unexpected error during speech recognition.`};function r(e){switch(e){case`not-allowed`:case`service-not-allowed`:return`not-allowed`;case`no-speech`:return`no-speech`;case`audio-capture`:return`audio-capture`;case`network`:return`network`;case`aborted`:return`aborted`;case`language-not-supported`:return`language-not-supported`;default:return`unknown`}}function i(){let e=globalThis,t=e.SpeechRecognition??e.webkitSpeechRecognition;return typeof t==`function`?t:null}function a(){return i()!==null}function o(o={}){let{lang:s=`pt-BR`,continuous:c=!1,interimResults:l=!0,maxAlternatives:u=1,onResult:d,onFinal:f,onError:p,onEnd:m,factory:h}=o,[g]=(0,t.useState)(()=>h!==void 0||a()),[_,v]=(0,t.useState)(!1),[y,b]=(0,t.useState)(``),[x,S]=(0,t.useState)(``),[C,w]=(0,t.useState)(null),T=(0,t.useRef)(null),E=e.useStableCallback(e=>d?.(e)),D=e.useStableCallback(e=>f?.(e)),O=e.useStableCallback(()=>m?.()),k=e.useStableCallback(e=>{w(e),p?.(e)}),A=(0,t.useCallback)(()=>{let e=T.current;e&&(e.onresult=null,e.onerror=null,e.onend=null,e.onstart=null,T.current=null)},[]),j=(0,t.useCallback)(()=>{if(T.current)return;let e=(h??(()=>{let e=i();return e?new e:null}))();if(!e)k({kind:`unsupported`,message:n.unsupported});else{e.lang=s,e.continuous=c,e.interimResults=l,e.maxAlternatives=u,e.onresult=e=>{let t=``,n=``;for(let r=e.resultIndex;r<e.results.length;r+=1){let i=e.results[r];if(!i)continue;let a=i[0]?.transcript??``;i.isFinal?t+=a:n+=a}S(n),t!==``&&(b(e=>e+t),D(t)),E({transcript:t===``?n:t,isFinal:t!==``})},e.onerror=e=>{let t=r(e.error);k({kind:t,message:e.message||n[t]})},e.onend=()=>{v(!1),S(``),A(),O()},e.onstart=()=>v(!0),w(null);try{e.start()}catch(e){k({kind:`unknown`,message:e instanceof Error?e.message:n.unknown});return}T.current=e,v(!0)}},[s,c,l,u,h,E,D,O,k,A]),M=(0,t.useCallback)(()=>{T.current?.stop()},[]),N=(0,t.useCallback)(()=>{T.current?.abort()},[]),P=(0,t.useCallback)(()=>{b(``),S(``),w(null)},[]);return(0,t.useEffect)(()=>()=>{T.current?.abort(),A()},[A]),{supported:g,listening:_,transcript:y,interim:x,error:C,start:j,stop:M,abort:N,reset:P}}exports.isSpeechRecognitionSupported=a,exports.useSpeechRecognition=o;
 //# sourceMappingURL=use-speech-recognition.cjs.map

package/dist/capture/use-speech-recognition.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-speech-recognition.cjs","names":[],"sources":["../../src/capture/use-speech-recognition.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — the Web Speech API restarts itself on\n * silence, reports interim and final results on the same event, and reports `no-\n * speech` as an error that is not one. The hook is that reconciliation plus the\n * continuous-mode restart loop, and its length is mostly the vendor quirks the\n * docstring warns about.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** One reading of what was heard. */\nexport interface SpeechAlternativeLike {\n    transcript: string;\n    confidence?: number;\n}\n\n/** One recognised phrase, settled (`isFinal`) or still being revised. */\nexport interface SpeechResultLike {\n    isFinal: boolean;\n    length: number;\n    [index: number]: SpeechAlternativeLike | undefined;\n}\n\n/** The growing list of phrases in a session. */\nexport interface SpeechResultListLike {\n    length: number;\n    [index: number]: SpeechResultLike | undefined;\n}\n\n/** The `result` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionEventLike {\n    /** Index of the first result that changed — everything before it is settled. */\n    resultIndex: number;\n    results: SpeechResultListLike;\n}\n\n/** The `error` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionErrorEventLike {\n    error: string;\n    message?: string;\n}\n\n/**\n * The slice of the Web Speech `SpeechRecognition` object this SDK uses.\n *\n * Declared here rather than imported: TypeScript's DOM lib ships the *event* types but\n * not the constructor, because the API is still prefixed in Chromium and absent in\n * Firefox. Exported so a test — or a consumer wrapping a different engine — can hand in\n * something else.\n */\nexport interface SpeechRecognitionLike {\n    lang: string;\n    continuous: boolean;\n    interimResults: boolean;\n    maxAlternatives: number;\n    start: () => void;\n    stop: () => void;\n    abort: () => void;\n    onresult: ((event: SpeechRecognitionEventLike) => void) | null;\n    onerror: ((event: SpeechRecognitionErrorEventLike) => void) | null;\n    onend: (() => void) | null;\n    onstart: (() => void) | null;\n}\n\n/** Classified reason recognition stopped or never started. */\nexport type SpeechErrorKind =\n    | \"unsupported\"\n    | \"not-allowed\"\n    | \"no-speech\"\n    | \"audio-capture\"\n    | \"network\"\n    | \"aborted\"\n    | \"language-not-supported\"\n    | \"unknown\";\n\n/** A classified speech error with a human-readable, English message. */\nexport interface SpeechError {\n    kind: SpeechErrorKind;\n    message: string;\n}\n\n/** Options for {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionOptions {\n    /** BCP-47 tag. Default `\"pt-BR\"`. */\n    lang?: string;\n    /**\n     * Keep listening after the first phrase settles. Default `false`.\n     *\n     * Even with this on, the engine ends the session by itself after a stretch of\n     * silence — that is a server-side timeout, not a bug — so watch `listening` rather\n     * than assuming the microphone stays open.\n     */\n    continuous?: boolean;\n    /** Publish the running guess as it changes. Default `true`. */\n    interimResults?: boolean;\n    /** How many readings per phrase to ask for. Default 1. */\n    maxAlternatives?: number;\n    /** Every update, settled or not. */\n    onResult?: (result: { transcript: string; isFinal: boolean }) => void;\n    /** Only the settled text of a phrase. The one to wire dictation to. */\n    onFinal?: (transcript: string) => void;\n    /** Classified failure. `no-speech` and `aborted` arrive here too — they are routine. */\n    onError?: (error: SpeechError) => void;\n    /** The session ended, for any reason. */\n    onEnd?: () => void;\n    /** Build the recogniser yourself — another engine, or a stub in a test. */\n    factory?: () => SpeechRecognitionLike;\n}\n\n/** Value returned by {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionResult {\n    /** `false` in Firefox and in every browser that is not Chromium-based. */\n    supported: boolean;\n    /** Whether a session is open right now. */\n    listening: boolean;\n    /** Everything settled so far in this session. Cleared by `reset()`. */\n    transcript: string;\n    /** The running guess. Replaced on every event, empty once the phrase settles. */\n    interim: string;\n    /** Classified error, or `null`. */\n    error: SpeechError | null;\n    /** Open a session. No-op while already listening. */\n    start: () => void;\n    /** Close the session, keeping what was recognised. */\n    stop: () => void;\n    /** Close the session and throw the pending phrase away. */\n    abort: () => void;\n    /** Clear `transcript`, `interim` and `error`. Does not stop a session. */\n    reset: () => void;\n}\n\n/** English messages for the `error` codes the spec defines. */\nconst MESSAGES: Record<SpeechErrorKind, string> = {\n    unsupported: \"Speech recognition is not supported in this browser.\",\n    \"not-allowed\": \"Microphone permission denied. Enable access in your browser settings.\",\n    \"no-speech\": \"No speech was detected.\",\n    \"audio-capture\": \"No microphone available on this device.\",\n    network: \"The recognition service could not be reached.\",\n    aborted: \"Recognition was cancelled.\",\n    \"language-not-supported\": \"The recognition service does not support this language.\",\n    unknown: \"Unexpected error during speech recognition.\",\n};\n\n/**\n * Map a spec `error` code to a kind an app can branch on.\n *\n * `service-not-allowed` collapses into `not-allowed` because the fix is the same from\n * the user's side, and `bad-grammar` into `unknown` because this hook never sets a\n * grammar, so seeing it means something outside our control went wrong.\n *\n * @param code - The `error` property of the event.\n * @returns The classified kind.\n */\nfunction classifySpeechError(code: string): SpeechErrorKind {\n    switch (code) {\n        case \"not-allowed\":\n        case \"service-not-allowed\":\n            return \"not-allowed\";\n        case \"no-speech\":\n            return \"no-speech\";\n        case \"audio-capture\":\n            return \"audio-capture\";\n        case \"network\":\n            return \"network\";\n        case \"aborted\":\n            return \"aborted\";\n        case \"language-not-supported\":\n            return \"language-not-supported\";\n        default:\n            return \"unknown\";\n    }\n}\n\n/** The constructor, prefixed or not, or `null` where the API does not exist. */\nfunction speechRecognitionConstructor(): (new () => SpeechRecognitionLike) | null {\n    const scope = globalThis as {\n        SpeechRecognition?: unknown;\n        webkitSpeechRecognition?: unknown;\n    };\n    const candidate = scope.SpeechRecognition ?? scope.webkitSpeechRecognition;\n    return typeof candidate === \"function\" ? (candidate as new () => SpeechRecognitionLike) : null;\n}\n\n/** Whether this browser exposes the Web Speech recognition API at all. */\nexport function isSpeechRecognitionSupported(): boolean {\n    return speechRecognitionConstructor() !== null;\n}\n\n/**\n * Dictate into your app with the Web Speech API — no dependency, no API key.\n *\n * ## Recognition is not local\n *\n * **Chromium streams the captured audio to a Google server to transcribe it.** Nothing\n * about the API says so, there is no setting that changes it, and it happens on every\n * `start()`. Anything the user says while a session is open leaves the device. Do not\n * put this on a field that takes clinical notes, credentials, or a client's financial\n * detail without telling them first — and if the data cannot leave your infrastructure,\n * this API is the wrong tool and a self-hosted model is the right one.\n *\n * ## What the states mean\n *\n * `transcript` accumulates the phrases the engine has **settled** on; `interim` is the\n * guess it is still revising and is replaced wholesale on every event, so rendering\n * `transcript + interim` gives the live caption effect and rendering `transcript` alone\n * gives the committed text. `no-speech` and `aborted` come through `onError` but are\n * routine — a user who pressed the button and said nothing is not a failure to report.\n *\n * There is deliberately **no auto-restart** when the engine ends a session on silence.\n * A restart loop is how an app ends up holding the microphone indefinitely — and, in\n * Chromium, streaming audio to a third party indefinitely. Show that listening stopped\n * and let the user press again.\n *\n * @param options - See {@link UseSpeechRecognitionOptions}.\n * @returns Session state, the transcript and the controls.\n *\n * @example\n * const speech = useSpeechRecognition({ onFinal: (text) => setPrompt(text) });\n * <button onClick={speech.listening ? speech.stop : speech.start}>\n *     {speech.listening ? \"Parar\" : \"Ditar\"}\n * </button>\n * <p>{speech.transcript}{speech.interim}</p>\n */\nexport function useSpeechRecognition(\n    options: UseSpeechRecognitionOptions = {},\n): UseSpeechRecognitionResult {\n    const {\n        lang = \"pt-BR\",\n        continuous = false,\n        interimResults = true,\n        maxAlternatives = 1,\n        onResult,\n        onFinal,\n        onError,\n        onEnd,\n        factory,\n    } = options;\n\n    const [supported] = useState(() => factory !== undefined || isSpeechRecognitionSupported());\n    const [listening, setListening] = useState(false);\n    const [transcript, setTranscript] = useState(\"\");\n    const [interim, setInterim] = useState(\"\");\n    const [error, setError] = useState<SpeechError | null>(null);\n\n    const sessionRef = useRef<SpeechRecognitionLike | null>(null);\n\n    const emitResult = useStableCallback((result: { transcript: string; isFinal: boolean }) =>\n        onResult?.(result),\n    );\n    const emitFinal = useStableCallback((text: string) => onFinal?.(text));\n    const emitEnd = useStableCallback(() => onEnd?.());\n    const emitError = useStableCallback((failure: SpeechError) => {\n        setError(failure);\n        onError?.(failure);\n    });\n\n    const teardown = useCallback((): void => {\n        const session = sessionRef.current;\n        if (!session) return;\n        session.onresult = null;\n        session.onerror = null;\n        session.onend = null;\n        session.onstart = null;\n        sessionRef.current = null;\n    }, []);\n\n    const start = useCallback((): void => {\n        if (sessionRef.current) return;\n        const build =\n            factory ??\n            (() => {\n                const constructor = speechRecognitionConstructor();\n                return constructor ? new constructor() : null;\n            });\n        const session = build();\n        if (!session) {\n            emitError({ kind: \"unsupported\", message: MESSAGES.unsupported });\n            return;\n        }\n\n        session.lang = lang;\n        session.continuous = continuous;\n        session.interimResults = interimResults;\n        session.maxAlternatives = maxAlternatives;\n\n        /**\n         * Fold one event into the two published strings.\n         *\n         * Only the results from `resultIndex` on are new; re-reading the whole list\n         * would append phrases that are already in `transcript`. Settled text is\n         * accumulated, unsettled text replaces the previous guess entirely — the engine\n         * revises a phrase in place, so appending it would stutter the caption.\n         */\n        session.onresult = (event: SpeechRecognitionEventLike): void => {\n            let settled = \"\";\n            let pending = \"\";\n            for (let index = event.resultIndex; index < event.results.length; index += 1) {\n                const result = event.results[index];\n                if (!result) continue;\n                const text = result[0]?.transcript ?? \"\";\n                if (result.isFinal) settled += text;\n                else pending += text;\n            }\n            setInterim(pending);\n            if (settled !== \"\") {\n                setTranscript((previous) => previous + settled);\n                emitFinal(settled);\n            }\n            emitResult({ transcript: settled !== \"\" ? settled : pending, isFinal: settled !== \"\" });\n        };\n\n        session.onerror = (event: SpeechRecognitionErrorEventLike): void => {\n            const kind = classifySpeechError(event.error);\n            emitError({ kind, message: event.message || MESSAGES[kind] });\n        };\n\n        session.onend = (): void => {\n            setListening(false);\n            setInterim(\"\");\n            teardown();\n            emitEnd();\n        };\n\n        session.onstart = (): void => setListening(true);\n\n        setError(null);\n        try {\n            session.start();\n        } catch (failure) {\n            // Chromium throws `InvalidStateError` when a session is already running in\n            // another component. Reporting it beats leaving a dead handle behind.\n            emitError({\n                kind: \"unknown\",\n                message: failure instanceof Error ? failure.message : MESSAGES.unknown,\n            });\n            return;\n        }\n        sessionRef.current = session;\n        setListening(true);\n    }, [\n        lang,\n        continuous,\n        interimResults,\n        maxAlternatives,\n        factory,\n        emitResult,\n        emitFinal,\n        emitEnd,\n        emitError,\n        teardown,\n    ]);\n\n    const stop = useCallback((): void => {\n        sessionRef.current?.stop();\n    }, []);\n\n    const abort = useCallback((): void => {\n        sessionRef.current?.abort();\n    }, []);\n\n    const reset = useCallback((): void => {\n        setTranscript(\"\");\n        setInterim(\"\");\n        setError(null);\n    }, []);\n\n    /**\n     * Never leave a session open past unmount.\n     *\n     * `abort()` and not `stop()`: a component that is gone has nowhere to put a final\n     * result, and `stop()` would keep the microphone — and the upstream connection —\n     * alive while the engine finishes deciding what the last word was.\n     */\n    useEffect(\n        () => () => {\n            sessionRef.current?.abort();\n            teardown();\n        },\n        [teardown],\n    );\n\n    return {\n        supported,\n        listening,\n        transcript,\n        interim,\n        error,\n        start,\n        stop,\n        abort,\n        reset,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-speech-recognition.cjs","names":["useState","useRef","useStableCallback","useCallback","require_use_stable_callback","react","MESSAGES","classifySpeechError","code","speechRecognitionConstructor","scope","candidate","isSpeechRecognitionSupported","useSpeechRecognition","options","supported","factory","listening","setListening","transcript","setTranscript","interim","setInterim","error","setError","sessionRef","emitResult","onResult","result","emitFinal","onFinal","text","emitEnd","onEnd","emitError","failure","onError","teardown","session","start","constructor","lang","continuous","interimResults","maxAlternatives","settled","pending","index","event","previous","kind","stop","abort","reset"],"sources":["../../src/capture/use-speech-recognition.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — the Web Speech API restarts itself on\n * silence, reports interim and final results on the same event, and reports `no-\n * speech` as an error that is not one. The hook is that reconciliation plus the\n * continuous-mode restart loop, and its length is mostly the vendor quirks the\n * docstring warns about.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** One reading of what was heard. */\nexport interface SpeechAlternativeLike {\n    transcript: string;\n    confidence?: number;\n}\n\n/** One recognised phrase, settled (`isFinal`) or still being revised. */\nexport interface SpeechResultLike {\n    isFinal: boolean;\n    length: number;\n    [index: number]: SpeechAlternativeLike | undefined;\n}\n\n/** The growing list of phrases in a session. */\nexport interface SpeechResultListLike {\n    length: number;\n    [index: number]: SpeechResultLike | undefined;\n}\n\n/** The `result` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionEventLike {\n    /** Index of the first result that changed — everything before it is settled. */\n    resultIndex: number;\n    results: SpeechResultListLike;\n}\n\n/** The `error` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionErrorEventLike {\n    error: string;\n    message?: string;\n}\n\n/**\n * The slice of the Web Speech `SpeechRecognition` object this SDK uses.\n *\n * Declared here rather than imported: TypeScript's DOM lib ships the *event* types but\n * not the constructor, because the API is still prefixed in Chromium and absent in\n * Firefox. Exported so a test — or a consumer wrapping a different engine — can hand in\n * something else.\n */\nexport interface SpeechRecognitionLike {\n    lang: string;\n    continuous: boolean;\n    interimResults: boolean;\n    maxAlternatives: number;\n    start: () => void;\n    stop: () => void;\n    abort: () => void;\n    onresult: ((event: SpeechRecognitionEventLike) => void) | null;\n    onerror: ((event: SpeechRecognitionErrorEventLike) => void) | null;\n    onend: (() => void) | null;\n    onstart: (() => void) | null;\n}\n\n/** Classified reason recognition stopped or never started. */\nexport type SpeechErrorKind =\n    | \"unsupported\"\n    | \"not-allowed\"\n    | \"no-speech\"\n    | \"audio-capture\"\n    | \"network\"\n    | \"aborted\"\n    | \"language-not-supported\"\n    | \"unknown\";\n\n/** A classified speech error with a human-readable, English message. */\nexport interface SpeechError {\n    kind: SpeechErrorKind;\n    message: string;\n}\n\n/** Options for {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionOptions {\n    /** BCP-47 tag. Default `\"pt-BR\"`. */\n    lang?: string;\n    /**\n     * Keep listening after the first phrase settles. Default `false`.\n     *\n     * Even with this on, the engine ends the session by itself after a stretch of\n     * silence — that is a server-side timeout, not a bug — so watch `listening` rather\n     * than assuming the microphone stays open.\n     */\n    continuous?: boolean;\n    /** Publish the running guess as it changes. Default `true`. */\n    interimResults?: boolean;\n    /** How many readings per phrase to ask for. Default 1. */\n    maxAlternatives?: number;\n    /** Every update, settled or not. */\n    onResult?: (result: { transcript: string; isFinal: boolean }) => void;\n    /** Only the settled text of a phrase. The one to wire dictation to. */\n    onFinal?: (transcript: string) => void;\n    /** Classified failure. `no-speech` and `aborted` arrive here too — they are routine. */\n    onError?: (error: SpeechError) => void;\n    /** The session ended, for any reason. */\n    onEnd?: () => void;\n    /** Build the recogniser yourself — another engine, or a stub in a test. */\n    factory?: () => SpeechRecognitionLike;\n}\n\n/** Value returned by {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionResult {\n    /** `false` in Firefox and in every browser that is not Chromium-based. */\n    supported: boolean;\n    /** Whether a session is open right now. */\n    listening: boolean;\n    /** Everything settled so far in this session. Cleared by `reset()`. */\n    transcript: string;\n    /** The running guess. Replaced on every event, empty once the phrase settles. */\n    interim: string;\n    /** Classified error, or `null`. */\n    error: SpeechError | null;\n    /** Open a session. No-op while already listening. */\n    start: () => void;\n    /** Close the session, keeping what was recognised. */\n    stop: () => void;\n    /** Close the session and throw the pending phrase away. */\n    abort: () => void;\n    /** Clear `transcript`, `interim` and `error`. Does not stop a session. */\n    reset: () => void;\n}\n\n/** English messages for the `error` codes the spec defines. */\nconst MESSAGES: Record<SpeechErrorKind, string> = {\n    unsupported: \"Speech recognition is not supported in this browser.\",\n    \"not-allowed\": \"Microphone permission denied. Enable access in your browser settings.\",\n    \"no-speech\": \"No speech was detected.\",\n    \"audio-capture\": \"No microphone available on this device.\",\n    network: \"The recognition service could not be reached.\",\n    aborted: \"Recognition was cancelled.\",\n    \"language-not-supported\": \"The recognition service does not support this language.\",\n    unknown: \"Unexpected error during speech recognition.\",\n};\n\n/**\n * Map a spec `error` code to a kind an app can branch on.\n *\n * `service-not-allowed` collapses into `not-allowed` because the fix is the same from\n * the user's side, and `bad-grammar` into `unknown` because this hook never sets a\n * grammar, so seeing it means something outside our control went wrong.\n *\n * @param code - The `error` property of the event.\n * @returns The classified kind.\n */\nfunction classifySpeechError(code: string): SpeechErrorKind {\n    switch (code) {\n        case \"not-allowed\":\n        case \"service-not-allowed\":\n            return \"not-allowed\";\n        case \"no-speech\":\n            return \"no-speech\";\n        case \"audio-capture\":\n            return \"audio-capture\";\n        case \"network\":\n            return \"network\";\n        case \"aborted\":\n            return \"aborted\";\n        case \"language-not-supported\":\n            return \"language-not-supported\";\n        default:\n            return \"unknown\";\n    }\n}\n\n/** The constructor, prefixed or not, or `null` where the API does not exist. */\nfunction speechRecognitionConstructor(): (new () => SpeechRecognitionLike) | null {\n    const scope = globalThis as {\n        SpeechRecognition?: unknown;\n        webkitSpeechRecognition?: unknown;\n    };\n    const candidate = scope.SpeechRecognition ?? scope.webkitSpeechRecognition;\n    return typeof candidate === \"function\" ? (candidate as new () => SpeechRecognitionLike) : null;\n}\n\n/** Whether this browser exposes the Web Speech recognition API at all. */\nexport function isSpeechRecognitionSupported(): boolean {\n    return speechRecognitionConstructor() !== null;\n}\n\n/**\n * Dictate into your app with the Web Speech API — no dependency, no API key.\n *\n * ## Recognition is not local\n *\n * **Chromium streams the captured audio to a Google server to transcribe it.** Nothing\n * about the API says so, there is no setting that changes it, and it happens on every\n * `start()`. Anything the user says while a session is open leaves the device. Do not\n * put this on a field that takes clinical notes, credentials, or a client's financial\n * detail without telling them first — and if the data cannot leave your infrastructure,\n * this API is the wrong tool and a self-hosted model is the right one.\n *\n * ## What the states mean\n *\n * `transcript` accumulates the phrases the engine has **settled** on; `interim` is the\n * guess it is still revising and is replaced wholesale on every event, so rendering\n * `transcript + interim` gives the live caption effect and rendering `transcript` alone\n * gives the committed text. `no-speech` and `aborted` come through `onError` but are\n * routine — a user who pressed the button and said nothing is not a failure to report.\n *\n * There is deliberately **no auto-restart** when the engine ends a session on silence.\n * A restart loop is how an app ends up holding the microphone indefinitely — and, in\n * Chromium, streaming audio to a third party indefinitely. Show that listening stopped\n * and let the user press again.\n *\n * @param options - See {@link UseSpeechRecognitionOptions}.\n * @returns Session state, the transcript and the controls.\n *\n * @example\n * const speech = useSpeechRecognition({ onFinal: (text) => setPrompt(text) });\n * <button onClick={speech.listening ? speech.stop : speech.start}>\n *     {speech.listening ? \"Parar\" : \"Ditar\"}\n * </button>\n * <p>{speech.transcript}{speech.interim}</p>\n */\nexport function useSpeechRecognition(\n    options: UseSpeechRecognitionOptions = {},\n): UseSpeechRecognitionResult {\n    const {\n        lang = \"pt-BR\",\n        continuous = false,\n        interimResults = true,\n        maxAlternatives = 1,\n        onResult,\n        onFinal,\n        onError,\n        onEnd,\n        factory,\n    } = options;\n\n    const [supported] = useState(() => factory !== undefined || isSpeechRecognitionSupported());\n    const [listening, setListening] = useState(false);\n    const [transcript, setTranscript] = useState(\"\");\n    const [interim, setInterim] = useState(\"\");\n    const [error, setError] = useState<SpeechError | null>(null);\n\n    const sessionRef = useRef<SpeechRecognitionLike | null>(null);\n\n    const emitResult = useStableCallback((result: { transcript: string; isFinal: boolean }) =>\n        onResult?.(result),\n    );\n    const emitFinal = useStableCallback((text: string) => onFinal?.(text));\n    const emitEnd = useStableCallback(() => onEnd?.());\n    const emitError = useStableCallback((failure: SpeechError) => {\n        setError(failure);\n        onError?.(failure);\n    });\n\n    const teardown = useCallback((): void => {\n        const session = sessionRef.current;\n        if (!session) return;\n        session.onresult = null;\n        session.onerror = null;\n        session.onend = null;\n        session.onstart = null;\n        sessionRef.current = null;\n    }, []);\n\n    const start = useCallback((): void => {\n        if (sessionRef.current) return;\n        const build =\n            factory ??\n            (() => {\n                const constructor = speechRecognitionConstructor();\n                return constructor ? new constructor() : null;\n            });\n        const session = build();\n        if (!session) {\n            emitError({ kind: \"unsupported\", message: MESSAGES.unsupported });\n            return;\n        }\n\n        session.lang = lang;\n        session.continuous = continuous;\n        session.interimResults = interimResults;\n        session.maxAlternatives = maxAlternatives;\n\n        /**\n         * Fold one event into the two published strings.\n         *\n         * Only the results from `resultIndex` on are new; re-reading the whole list\n         * would append phrases that are already in `transcript`. Settled text is\n         * accumulated, unsettled text replaces the previous guess entirely — the engine\n         * revises a phrase in place, so appending it would stutter the caption.\n         */\n        session.onresult = (event: SpeechRecognitionEventLike): void => {\n            let settled = \"\";\n            let pending = \"\";\n            for (let index = event.resultIndex; index < event.results.length; index += 1) {\n                const result = event.results[index];\n                if (!result) continue;\n                const text = result[0]?.transcript ?? \"\";\n                if (result.isFinal) settled += text;\n                else pending += text;\n            }\n            setInterim(pending);\n            if (settled !== \"\") {\n                setTranscript((previous) => previous + settled);\n                emitFinal(settled);\n            }\n            emitResult({ transcript: settled !== \"\" ? settled : pending, isFinal: settled !== \"\" });\n        };\n\n        session.onerror = (event: SpeechRecognitionErrorEventLike): void => {\n            const kind = classifySpeechError(event.error);\n            emitError({ kind, message: event.message || MESSAGES[kind] });\n        };\n\n        session.onend = (): void => {\n            setListening(false);\n            setInterim(\"\");\n            teardown();\n            emitEnd();\n        };\n\n        session.onstart = (): void => setListening(true);\n\n        setError(null);\n        try {\n            session.start();\n        } catch (failure) {\n            // Chromium throws `InvalidStateError` when a session is already running in\n            // another component. Reporting it beats leaving a dead handle behind.\n            emitError({\n                kind: \"unknown\",\n                message: failure instanceof Error ? failure.message : MESSAGES.unknown,\n            });\n            return;\n        }\n        sessionRef.current = session;\n        setListening(true);\n    }, [\n        lang,\n        continuous,\n        interimResults,\n        maxAlternatives,\n        factory,\n        emitResult,\n        emitFinal,\n        emitEnd,\n        emitError,\n        teardown,\n    ]);\n\n    const stop = useCallback((): void => {\n        sessionRef.current?.stop();\n    }, []);\n\n    const abort = useCallback((): void => {\n        sessionRef.current?.abort();\n    }, []);\n\n    const reset = useCallback((): void => {\n        setTranscript(\"\");\n        setInterim(\"\");\n        setError(null);\n    }, []);\n\n    /**\n     * Never leave a session open past unmount.\n     *\n     * `abort()` and not `stop()`: a component that is gone has nowhere to put a final\n     * result, and `stop()` would keep the microphone — and the upstream connection —\n     * alive while the engine finishes deciding what the last word was.\n     */\n    useEffect(\n        () => () => {\n            sessionRef.current?.abort();\n            teardown();\n        },\n        [teardown],\n    );\n\n    return {\n        supported,\n        listening,\n        transcript,\n        interim,\n        error,\n        start,\n        stop,\n        abort,\n        reset,\n    };\n}\n"],"mappings":"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"}

package/dist/capture/use-speech-recognition.js

@@ -42,44 +42,43 @@ function l(l = {}) {
 			let e = s();
 			return e ? new e() : null;
 		}))();
-		if (!e) {
-			M({
-				kind: "unsupported",
-				message: a.unsupported
-			});
-			return;
-		}
-		e.lang = u, e.continuous = d, e.interimResults = f, e.maxAlternatives = p, e.onresult = (e) => {
-			let t = "", n = "";
-			for (let r = e.resultIndex; r < e.results.length; r += 1) {
-				let i = e.results[r];
-				if (!i) continue;
-				let a = i[0]?.transcript ?? "";
-				i.isFinal ? t += a : n += a;
+		if (!e) M({
+			kind: "unsupported",
+			message: a.unsupported
+		});
+		else {
+			e.lang = u, e.continuous = d, e.interimResults = f, e.maxAlternatives = p, e.onresult = (e) => {
+				let t = "", n = "";
+				for (let r = e.resultIndex; r < e.results.length; r += 1) {
+					let i = e.results[r];
+					if (!i) continue;
+					let a = i[0]?.transcript ?? "";
+					i.isFinal ? t += a : n += a;
+				}
+				T(n), t !== "" && (C((e) => e + t), A(t)), k({
+					transcript: t === "" ? n : t,
+					isFinal: t !== ""
+				});
+			}, e.onerror = (e) => {
+				let t = o(e.error);
+				M({
+					kind: t,
+					message: e.message || a[t]
+				});
+			}, e.onend = () => {
+				x(!1), T(""), N(), j();
+			}, e.onstart = () => x(!0), D(null);
+			try {
+				e.start();
+			} catch (e) {
+				M({
+					kind: "unknown",
+					message: e instanceof Error ? e.message : a.unknown
+				});
+				return;
 			}
-			T(n), t !== "" && (C((e) => e + t), A(t)), k({
-				transcript: t === "" ? n : t,
-				isFinal: t !== ""
-			});
-		}, e.onerror = (e) => {
-			let t = o(e.error);
-			M({
-				kind: t,
-				message: e.message || a[t]
-			});
-		}, e.onend = () => {
-			x(!1), T(""), N(), j();
-		}, e.onstart = () => x(!0), D(null);
-		try {
-			e.start();
-		} catch (e) {
-			M({
-				kind: "unknown",
-				message: e instanceof Error ? e.message : a.unknown
-			});
-			return;
+			O.current = e, x(!0);
 		}
-		O.current = e, x(!0);
 	}, [
 		u,
 		d,

package/dist/capture/use-speech-recognition.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-speech-recognition.js","names":[],"sources":["../../src/capture/use-speech-recognition.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — the Web Speech API restarts itself on\n * silence, reports interim and final results on the same event, and reports `no-\n * speech` as an error that is not one. The hook is that reconciliation plus the\n * continuous-mode restart loop, and its length is mostly the vendor quirks the\n * docstring warns about.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** One reading of what was heard. */\nexport interface SpeechAlternativeLike {\n    transcript: string;\n    confidence?: number;\n}\n\n/** One recognised phrase, settled (`isFinal`) or still being revised. */\nexport interface SpeechResultLike {\n    isFinal: boolean;\n    length: number;\n    [index: number]: SpeechAlternativeLike | undefined;\n}\n\n/** The growing list of phrases in a session. */\nexport interface SpeechResultListLike {\n    length: number;\n    [index: number]: SpeechResultLike | undefined;\n}\n\n/** The `result` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionEventLike {\n    /** Index of the first result that changed — everything before it is settled. */\n    resultIndex: number;\n    results: SpeechResultListLike;\n}\n\n/** The `error` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionErrorEventLike {\n    error: string;\n    message?: string;\n}\n\n/**\n * The slice of the Web Speech `SpeechRecognition` object this SDK uses.\n *\n * Declared here rather than imported: TypeScript's DOM lib ships the *event* types but\n * not the constructor, because the API is still prefixed in Chromium and absent in\n * Firefox. Exported so a test — or a consumer wrapping a different engine — can hand in\n * something else.\n */\nexport interface SpeechRecognitionLike {\n    lang: string;\n    continuous: boolean;\n    interimResults: boolean;\n    maxAlternatives: number;\n    start: () => void;\n    stop: () => void;\n    abort: () => void;\n    onresult: ((event: SpeechRecognitionEventLike) => void) | null;\n    onerror: ((event: SpeechRecognitionErrorEventLike) => void) | null;\n    onend: (() => void) | null;\n    onstart: (() => void) | null;\n}\n\n/** Classified reason recognition stopped or never started. */\nexport type SpeechErrorKind =\n    | \"unsupported\"\n    | \"not-allowed\"\n    | \"no-speech\"\n    | \"audio-capture\"\n    | \"network\"\n    | \"aborted\"\n    | \"language-not-supported\"\n    | \"unknown\";\n\n/** A classified speech error with a human-readable, English message. */\nexport interface SpeechError {\n    kind: SpeechErrorKind;\n    message: string;\n}\n\n/** Options for {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionOptions {\n    /** BCP-47 tag. Default `\"pt-BR\"`. */\n    lang?: string;\n    /**\n     * Keep listening after the first phrase settles. Default `false`.\n     *\n     * Even with this on, the engine ends the session by itself after a stretch of\n     * silence — that is a server-side timeout, not a bug — so watch `listening` rather\n     * than assuming the microphone stays open.\n     */\n    continuous?: boolean;\n    /** Publish the running guess as it changes. Default `true`. */\n    interimResults?: boolean;\n    /** How many readings per phrase to ask for. Default 1. */\n    maxAlternatives?: number;\n    /** Every update, settled or not. */\n    onResult?: (result: { transcript: string; isFinal: boolean }) => void;\n    /** Only the settled text of a phrase. The one to wire dictation to. */\n    onFinal?: (transcript: string) => void;\n    /** Classified failure. `no-speech` and `aborted` arrive here too — they are routine. */\n    onError?: (error: SpeechError) => void;\n    /** The session ended, for any reason. */\n    onEnd?: () => void;\n    /** Build the recogniser yourself — another engine, or a stub in a test. */\n    factory?: () => SpeechRecognitionLike;\n}\n\n/** Value returned by {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionResult {\n    /** `false` in Firefox and in every browser that is not Chromium-based. */\n    supported: boolean;\n    /** Whether a session is open right now. */\n    listening: boolean;\n    /** Everything settled so far in this session. Cleared by `reset()`. */\n    transcript: string;\n    /** The running guess. Replaced on every event, empty once the phrase settles. */\n    interim: string;\n    /** Classified error, or `null`. */\n    error: SpeechError | null;\n    /** Open a session. No-op while already listening. */\n    start: () => void;\n    /** Close the session, keeping what was recognised. */\n    stop: () => void;\n    /** Close the session and throw the pending phrase away. */\n    abort: () => void;\n    /** Clear `transcript`, `interim` and `error`. Does not stop a session. */\n    reset: () => void;\n}\n\n/** English messages for the `error` codes the spec defines. */\nconst MESSAGES: Record<SpeechErrorKind, string> = {\n    unsupported: \"Speech recognition is not supported in this browser.\",\n    \"not-allowed\": \"Microphone permission denied. Enable access in your browser settings.\",\n    \"no-speech\": \"No speech was detected.\",\n    \"audio-capture\": \"No microphone available on this device.\",\n    network: \"The recognition service could not be reached.\",\n    aborted: \"Recognition was cancelled.\",\n    \"language-not-supported\": \"The recognition service does not support this language.\",\n    unknown: \"Unexpected error during speech recognition.\",\n};\n\n/**\n * Map a spec `error` code to a kind an app can branch on.\n *\n * `service-not-allowed` collapses into `not-allowed` because the fix is the same from\n * the user's side, and `bad-grammar` into `unknown` because this hook never sets a\n * grammar, so seeing it means something outside our control went wrong.\n *\n * @param code - The `error` property of the event.\n * @returns The classified kind.\n */\nfunction classifySpeechError(code: string): SpeechErrorKind {\n    switch (code) {\n        case \"not-allowed\":\n        case \"service-not-allowed\":\n            return \"not-allowed\";\n        case \"no-speech\":\n            return \"no-speech\";\n        case \"audio-capture\":\n            return \"audio-capture\";\n        case \"network\":\n            return \"network\";\n        case \"aborted\":\n            return \"aborted\";\n        case \"language-not-supported\":\n            return \"language-not-supported\";\n        default:\n            return \"unknown\";\n    }\n}\n\n/** The constructor, prefixed or not, or `null` where the API does not exist. */\nfunction speechRecognitionConstructor(): (new () => SpeechRecognitionLike) | null {\n    const scope = globalThis as {\n        SpeechRecognition?: unknown;\n        webkitSpeechRecognition?: unknown;\n    };\n    const candidate = scope.SpeechRecognition ?? scope.webkitSpeechRecognition;\n    return typeof candidate === \"function\" ? (candidate as new () => SpeechRecognitionLike) : null;\n}\n\n/** Whether this browser exposes the Web Speech recognition API at all. */\nexport function isSpeechRecognitionSupported(): boolean {\n    return speechRecognitionConstructor() !== null;\n}\n\n/**\n * Dictate into your app with the Web Speech API — no dependency, no API key.\n *\n * ## Recognition is not local\n *\n * **Chromium streams the captured audio to a Google server to transcribe it.** Nothing\n * about the API says so, there is no setting that changes it, and it happens on every\n * `start()`. Anything the user says while a session is open leaves the device. Do not\n * put this on a field that takes clinical notes, credentials, or a client's financial\n * detail without telling them first — and if the data cannot leave your infrastructure,\n * this API is the wrong tool and a self-hosted model is the right one.\n *\n * ## What the states mean\n *\n * `transcript` accumulates the phrases the engine has **settled** on; `interim` is the\n * guess it is still revising and is replaced wholesale on every event, so rendering\n * `transcript + interim` gives the live caption effect and rendering `transcript` alone\n * gives the committed text. `no-speech` and `aborted` come through `onError` but are\n * routine — a user who pressed the button and said nothing is not a failure to report.\n *\n * There is deliberately **no auto-restart** when the engine ends a session on silence.\n * A restart loop is how an app ends up holding the microphone indefinitely — and, in\n * Chromium, streaming audio to a third party indefinitely. Show that listening stopped\n * and let the user press again.\n *\n * @param options - See {@link UseSpeechRecognitionOptions}.\n * @returns Session state, the transcript and the controls.\n *\n * @example\n * const speech = useSpeechRecognition({ onFinal: (text) => setPrompt(text) });\n * <button onClick={speech.listening ? speech.stop : speech.start}>\n *     {speech.listening ? \"Parar\" : \"Ditar\"}\n * </button>\n * <p>{speech.transcript}{speech.interim}</p>\n */\nexport function useSpeechRecognition(\n    options: UseSpeechRecognitionOptions = {},\n): UseSpeechRecognitionResult {\n    const {\n        lang = \"pt-BR\",\n        continuous = false,\n        interimResults = true,\n        maxAlternatives = 1,\n        onResult,\n        onFinal,\n        onError,\n        onEnd,\n        factory,\n    } = options;\n\n    const [supported] = useState(() => factory !== undefined || isSpeechRecognitionSupported());\n    const [listening, setListening] = useState(false);\n    const [transcript, setTranscript] = useState(\"\");\n    const [interim, setInterim] = useState(\"\");\n    const [error, setError] = useState<SpeechError | null>(null);\n\n    const sessionRef = useRef<SpeechRecognitionLike | null>(null);\n\n    const emitResult = useStableCallback((result: { transcript: string; isFinal: boolean }) =>\n        onResult?.(result),\n    );\n    const emitFinal = useStableCallback((text: string) => onFinal?.(text));\n    const emitEnd = useStableCallback(() => onEnd?.());\n    const emitError = useStableCallback((failure: SpeechError) => {\n        setError(failure);\n        onError?.(failure);\n    });\n\n    const teardown = useCallback((): void => {\n        const session = sessionRef.current;\n        if (!session) return;\n        session.onresult = null;\n        session.onerror = null;\n        session.onend = null;\n        session.onstart = null;\n        sessionRef.current = null;\n    }, []);\n\n    const start = useCallback((): void => {\n        if (sessionRef.current) return;\n        const build =\n            factory ??\n            (() => {\n                const constructor = speechRecognitionConstructor();\n                return constructor ? new constructor() : null;\n            });\n        const session = build();\n        if (!session) {\n            emitError({ kind: \"unsupported\", message: MESSAGES.unsupported });\n            return;\n        }\n\n        session.lang = lang;\n        session.continuous = continuous;\n        session.interimResults = interimResults;\n        session.maxAlternatives = maxAlternatives;\n\n        /**\n         * Fold one event into the two published strings.\n         *\n         * Only the results from `resultIndex` on are new; re-reading the whole list\n         * would append phrases that are already in `transcript`. Settled text is\n         * accumulated, unsettled text replaces the previous guess entirely — the engine\n         * revises a phrase in place, so appending it would stutter the caption.\n         */\n        session.onresult = (event: SpeechRecognitionEventLike): void => {\n            let settled = \"\";\n            let pending = \"\";\n            for (let index = event.resultIndex; index < event.results.length; index += 1) {\n                const result = event.results[index];\n                if (!result) continue;\n                const text = result[0]?.transcript ?? \"\";\n                if (result.isFinal) settled += text;\n                else pending += text;\n            }\n            setInterim(pending);\n            if (settled !== \"\") {\n                setTranscript((previous) => previous + settled);\n                emitFinal(settled);\n            }\n            emitResult({ transcript: settled !== \"\" ? settled : pending, isFinal: settled !== \"\" });\n        };\n\n        session.onerror = (event: SpeechRecognitionErrorEventLike): void => {\n            const kind = classifySpeechError(event.error);\n            emitError({ kind, message: event.message || MESSAGES[kind] });\n        };\n\n        session.onend = (): void => {\n            setListening(false);\n            setInterim(\"\");\n            teardown();\n            emitEnd();\n        };\n\n        session.onstart = (): void => setListening(true);\n\n        setError(null);\n        try {\n            session.start();\n        } catch (failure) {\n            // Chromium throws `InvalidStateError` when a session is already running in\n            // another component. Reporting it beats leaving a dead handle behind.\n            emitError({\n                kind: \"unknown\",\n                message: failure instanceof Error ? failure.message : MESSAGES.unknown,\n            });\n            return;\n        }\n        sessionRef.current = session;\n        setListening(true);\n    }, [\n        lang,\n        continuous,\n        interimResults,\n        maxAlternatives,\n        factory,\n        emitResult,\n        emitFinal,\n        emitEnd,\n        emitError,\n        teardown,\n    ]);\n\n    const stop = useCallback((): void => {\n        sessionRef.current?.stop();\n    }, []);\n\n    const abort = useCallback((): void => {\n        sessionRef.current?.abort();\n    }, []);\n\n    const reset = useCallback((): void => {\n        setTranscript(\"\");\n        setInterim(\"\");\n        setError(null);\n    }, []);\n\n    /**\n     * Never leave a session open past unmount.\n     *\n     * `abort()` and not `stop()`: a component that is gone has nowhere to put a final\n     * result, and `stop()` would keep the microphone — and the upstream connection —\n     * alive while the engine finishes deciding what the last word was.\n     */\n    useEffect(\n        () => () => {\n            sessionRef.current?.abort();\n            teardown();\n        },\n        [teardown],\n    );\n\n    return {\n        supported,\n        listening,\n        transcript,\n        interim,\n        error,\n        start,\n        stop,\n        abort,\n        reset,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-speech-recognition.js","names":["MESSAGES","classifySpeechError","code","speechRecognitionConstructor","scope","candidate","isSpeechRecognitionSupported","useSpeechRecognition","options","supported","useState","factory","listening","setListening","transcript","setTranscript","interim","setInterim","error","setError","sessionRef","useRef","emitResult","useStableCallback","onResult","result","emitFinal","onFinal","text","emitEnd","onEnd","emitError","failure","onError","teardown","useCallback","session","start","constructor","lang","continuous","interimResults","maxAlternatives","settled","pending","index","event","previous","kind","stop","abort","reset","useEffect"],"sources":["../../src/capture/use-speech-recognition.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, hook-lines — the Web Speech API restarts itself on\n * silence, reports interim and final results on the same event, and reports `no-\n * speech` as an error that is not one. The hook is that reconciliation plus the\n * continuous-mode restart loop, and its length is mostly the vendor quirks the\n * docstring warns about.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** One reading of what was heard. */\nexport interface SpeechAlternativeLike {\n    transcript: string;\n    confidence?: number;\n}\n\n/** One recognised phrase, settled (`isFinal`) or still being revised. */\nexport interface SpeechResultLike {\n    isFinal: boolean;\n    length: number;\n    [index: number]: SpeechAlternativeLike | undefined;\n}\n\n/** The growing list of phrases in a session. */\nexport interface SpeechResultListLike {\n    length: number;\n    [index: number]: SpeechResultLike | undefined;\n}\n\n/** The `result` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionEventLike {\n    /** Index of the first result that changed — everything before it is settled. */\n    resultIndex: number;\n    results: SpeechResultListLike;\n}\n\n/** The `error` event, reduced to what this hook reads. */\nexport interface SpeechRecognitionErrorEventLike {\n    error: string;\n    message?: string;\n}\n\n/**\n * The slice of the Web Speech `SpeechRecognition` object this SDK uses.\n *\n * Declared here rather than imported: TypeScript's DOM lib ships the *event* types but\n * not the constructor, because the API is still prefixed in Chromium and absent in\n * Firefox. Exported so a test — or a consumer wrapping a different engine — can hand in\n * something else.\n */\nexport interface SpeechRecognitionLike {\n    lang: string;\n    continuous: boolean;\n    interimResults: boolean;\n    maxAlternatives: number;\n    start: () => void;\n    stop: () => void;\n    abort: () => void;\n    onresult: ((event: SpeechRecognitionEventLike) => void) | null;\n    onerror: ((event: SpeechRecognitionErrorEventLike) => void) | null;\n    onend: (() => void) | null;\n    onstart: (() => void) | null;\n}\n\n/** Classified reason recognition stopped or never started. */\nexport type SpeechErrorKind =\n    | \"unsupported\"\n    | \"not-allowed\"\n    | \"no-speech\"\n    | \"audio-capture\"\n    | \"network\"\n    | \"aborted\"\n    | \"language-not-supported\"\n    | \"unknown\";\n\n/** A classified speech error with a human-readable, English message. */\nexport interface SpeechError {\n    kind: SpeechErrorKind;\n    message: string;\n}\n\n/** Options for {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionOptions {\n    /** BCP-47 tag. Default `\"pt-BR\"`. */\n    lang?: string;\n    /**\n     * Keep listening after the first phrase settles. Default `false`.\n     *\n     * Even with this on, the engine ends the session by itself after a stretch of\n     * silence — that is a server-side timeout, not a bug — so watch `listening` rather\n     * than assuming the microphone stays open.\n     */\n    continuous?: boolean;\n    /** Publish the running guess as it changes. Default `true`. */\n    interimResults?: boolean;\n    /** How many readings per phrase to ask for. Default 1. */\n    maxAlternatives?: number;\n    /** Every update, settled or not. */\n    onResult?: (result: { transcript: string; isFinal: boolean }) => void;\n    /** Only the settled text of a phrase. The one to wire dictation to. */\n    onFinal?: (transcript: string) => void;\n    /** Classified failure. `no-speech` and `aborted` arrive here too — they are routine. */\n    onError?: (error: SpeechError) => void;\n    /** The session ended, for any reason. */\n    onEnd?: () => void;\n    /** Build the recogniser yourself — another engine, or a stub in a test. */\n    factory?: () => SpeechRecognitionLike;\n}\n\n/** Value returned by {@link useSpeechRecognition}. */\nexport interface UseSpeechRecognitionResult {\n    /** `false` in Firefox and in every browser that is not Chromium-based. */\n    supported: boolean;\n    /** Whether a session is open right now. */\n    listening: boolean;\n    /** Everything settled so far in this session. Cleared by `reset()`. */\n    transcript: string;\n    /** The running guess. Replaced on every event, empty once the phrase settles. */\n    interim: string;\n    /** Classified error, or `null`. */\n    error: SpeechError | null;\n    /** Open a session. No-op while already listening. */\n    start: () => void;\n    /** Close the session, keeping what was recognised. */\n    stop: () => void;\n    /** Close the session and throw the pending phrase away. */\n    abort: () => void;\n    /** Clear `transcript`, `interim` and `error`. Does not stop a session. */\n    reset: () => void;\n}\n\n/** English messages for the `error` codes the spec defines. */\nconst MESSAGES: Record<SpeechErrorKind, string> = {\n    unsupported: \"Speech recognition is not supported in this browser.\",\n    \"not-allowed\": \"Microphone permission denied. Enable access in your browser settings.\",\n    \"no-speech\": \"No speech was detected.\",\n    \"audio-capture\": \"No microphone available on this device.\",\n    network: \"The recognition service could not be reached.\",\n    aborted: \"Recognition was cancelled.\",\n    \"language-not-supported\": \"The recognition service does not support this language.\",\n    unknown: \"Unexpected error during speech recognition.\",\n};\n\n/**\n * Map a spec `error` code to a kind an app can branch on.\n *\n * `service-not-allowed` collapses into `not-allowed` because the fix is the same from\n * the user's side, and `bad-grammar` into `unknown` because this hook never sets a\n * grammar, so seeing it means something outside our control went wrong.\n *\n * @param code - The `error` property of the event.\n * @returns The classified kind.\n */\nfunction classifySpeechError(code: string): SpeechErrorKind {\n    switch (code) {\n        case \"not-allowed\":\n        case \"service-not-allowed\":\n            return \"not-allowed\";\n        case \"no-speech\":\n            return \"no-speech\";\n        case \"audio-capture\":\n            return \"audio-capture\";\n        case \"network\":\n            return \"network\";\n        case \"aborted\":\n            return \"aborted\";\n        case \"language-not-supported\":\n            return \"language-not-supported\";\n        default:\n            return \"unknown\";\n    }\n}\n\n/** The constructor, prefixed or not, or `null` where the API does not exist. */\nfunction speechRecognitionConstructor(): (new () => SpeechRecognitionLike) | null {\n    const scope = globalThis as {\n        SpeechRecognition?: unknown;\n        webkitSpeechRecognition?: unknown;\n    };\n    const candidate = scope.SpeechRecognition ?? scope.webkitSpeechRecognition;\n    return typeof candidate === \"function\" ? (candidate as new () => SpeechRecognitionLike) : null;\n}\n\n/** Whether this browser exposes the Web Speech recognition API at all. */\nexport function isSpeechRecognitionSupported(): boolean {\n    return speechRecognitionConstructor() !== null;\n}\n\n/**\n * Dictate into your app with the Web Speech API — no dependency, no API key.\n *\n * ## Recognition is not local\n *\n * **Chromium streams the captured audio to a Google server to transcribe it.** Nothing\n * about the API says so, there is no setting that changes it, and it happens on every\n * `start()`. Anything the user says while a session is open leaves the device. Do not\n * put this on a field that takes clinical notes, credentials, or a client's financial\n * detail without telling them first — and if the data cannot leave your infrastructure,\n * this API is the wrong tool and a self-hosted model is the right one.\n *\n * ## What the states mean\n *\n * `transcript` accumulates the phrases the engine has **settled** on; `interim` is the\n * guess it is still revising and is replaced wholesale on every event, so rendering\n * `transcript + interim` gives the live caption effect and rendering `transcript` alone\n * gives the committed text. `no-speech` and `aborted` come through `onError` but are\n * routine — a user who pressed the button and said nothing is not a failure to report.\n *\n * There is deliberately **no auto-restart** when the engine ends a session on silence.\n * A restart loop is how an app ends up holding the microphone indefinitely — and, in\n * Chromium, streaming audio to a third party indefinitely. Show that listening stopped\n * and let the user press again.\n *\n * @param options - See {@link UseSpeechRecognitionOptions}.\n * @returns Session state, the transcript and the controls.\n *\n * @example\n * const speech = useSpeechRecognition({ onFinal: (text) => setPrompt(text) });\n * <button onClick={speech.listening ? speech.stop : speech.start}>\n *     {speech.listening ? \"Parar\" : \"Ditar\"}\n * </button>\n * <p>{speech.transcript}{speech.interim}</p>\n */\nexport function useSpeechRecognition(\n    options: UseSpeechRecognitionOptions = {},\n): UseSpeechRecognitionResult {\n    const {\n        lang = \"pt-BR\",\n        continuous = false,\n        interimResults = true,\n        maxAlternatives = 1,\n        onResult,\n        onFinal,\n        onError,\n        onEnd,\n        factory,\n    } = options;\n\n    const [supported] = useState(() => factory !== undefined || isSpeechRecognitionSupported());\n    const [listening, setListening] = useState(false);\n    const [transcript, setTranscript] = useState(\"\");\n    const [interim, setInterim] = useState(\"\");\n    const [error, setError] = useState<SpeechError | null>(null);\n\n    const sessionRef = useRef<SpeechRecognitionLike | null>(null);\n\n    const emitResult = useStableCallback((result: { transcript: string; isFinal: boolean }) =>\n        onResult?.(result),\n    );\n    const emitFinal = useStableCallback((text: string) => onFinal?.(text));\n    const emitEnd = useStableCallback(() => onEnd?.());\n    const emitError = useStableCallback((failure: SpeechError) => {\n        setError(failure);\n        onError?.(failure);\n    });\n\n    const teardown = useCallback((): void => {\n        const session = sessionRef.current;\n        if (!session) return;\n        session.onresult = null;\n        session.onerror = null;\n        session.onend = null;\n        session.onstart = null;\n        sessionRef.current = null;\n    }, []);\n\n    const start = useCallback((): void => {\n        if (sessionRef.current) return;\n        const build =\n            factory ??\n            (() => {\n                const constructor = speechRecognitionConstructor();\n                return constructor ? new constructor() : null;\n            });\n        const session = build();\n        if (!session) {\n            emitError({ kind: \"unsupported\", message: MESSAGES.unsupported });\n            return;\n        }\n\n        session.lang = lang;\n        session.continuous = continuous;\n        session.interimResults = interimResults;\n        session.maxAlternatives = maxAlternatives;\n\n        /**\n         * Fold one event into the two published strings.\n         *\n         * Only the results from `resultIndex` on are new; re-reading the whole list\n         * would append phrases that are already in `transcript`. Settled text is\n         * accumulated, unsettled text replaces the previous guess entirely — the engine\n         * revises a phrase in place, so appending it would stutter the caption.\n         */\n        session.onresult = (event: SpeechRecognitionEventLike): void => {\n            let settled = \"\";\n            let pending = \"\";\n            for (let index = event.resultIndex; index < event.results.length; index += 1) {\n                const result = event.results[index];\n                if (!result) continue;\n                const text = result[0]?.transcript ?? \"\";\n                if (result.isFinal) settled += text;\n                else pending += text;\n            }\n            setInterim(pending);\n            if (settled !== \"\") {\n                setTranscript((previous) => previous + settled);\n                emitFinal(settled);\n            }\n            emitResult({ transcript: settled !== \"\" ? settled : pending, isFinal: settled !== \"\" });\n        };\n\n        session.onerror = (event: SpeechRecognitionErrorEventLike): void => {\n            const kind = classifySpeechError(event.error);\n            emitError({ kind, message: event.message || MESSAGES[kind] });\n        };\n\n        session.onend = (): void => {\n            setListening(false);\n            setInterim(\"\");\n            teardown();\n            emitEnd();\n        };\n\n        session.onstart = (): void => setListening(true);\n\n        setError(null);\n        try {\n            session.start();\n        } catch (failure) {\n            // Chromium throws `InvalidStateError` when a session is already running in\n            // another component. Reporting it beats leaving a dead handle behind.\n            emitError({\n                kind: \"unknown\",\n                message: failure instanceof Error ? failure.message : MESSAGES.unknown,\n            });\n            return;\n        }\n        sessionRef.current = session;\n        setListening(true);\n    }, [\n        lang,\n        continuous,\n        interimResults,\n        maxAlternatives,\n        factory,\n        emitResult,\n        emitFinal,\n        emitEnd,\n        emitError,\n        teardown,\n    ]);\n\n    const stop = useCallback((): void => {\n        sessionRef.current?.stop();\n    }, []);\n\n    const abort = useCallback((): void => {\n        sessionRef.current?.abort();\n    }, []);\n\n    const reset = useCallback((): void => {\n        setTranscript(\"\");\n        setInterim(\"\");\n        setError(null);\n    }, []);\n\n    /**\n     * Never leave a session open past unmount.\n     *\n     * `abort()` and not `stop()`: a component that is gone has nowhere to put a final\n     * result, and `stop()` would keep the microphone — and the upstream connection —\n     * alive while the engine finishes deciding what the last word was.\n     */\n    useEffect(\n        () => () => {\n            sessionRef.current?.abort();\n            teardown();\n        },\n        [teardown],\n    );\n\n    return {\n        supported,\n        listening,\n        transcript,\n        interim,\n        error,\n        start,\n        stop,\n        abort,\n        reset,\n    };\n}\n"],"mappings":"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"}

package/dist/capture/use-torch.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-torch.cjs","names":[],"sources":["../../src/capture/use-torch.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * `torch` is a real constrainable property in the Media Capture spec, but\n * TypeScript's `MediaTrackConstraintSet` does not list it, so the literal has to be\n * widened before `applyConstraints` will take it.\n */\ntype TorchConstraints = MediaTrackConstraints & {\n    advanced?: Array<MediaTrackConstraintSet & { torch?: boolean }>;\n};\n\n/** `getCapabilities()` reports `torch` as a list of the values the lamp accepts. */\ntype TorchCapabilities = MediaTrackCapabilities & { torch?: readonly boolean[] };\n\n/** Value returned by {@link useTorch}. */\nexport interface UseTorchResult {\n    /** Whether this track has a controllable lamp. `false` on every desktop webcam. */\n    supported: boolean;\n    /** Whether the lamp is on, as far as this hook knows. */\n    on: boolean;\n    /**\n     * Turn the lamp on or off.\n     *\n     * @param next - `true` to light it up.\n     * @returns `false` when the track refused — treat that as \"no torch\".\n     */\n    set: (next: boolean) => Promise<boolean>;\n    /** Flip it. Same return contract as {@link UseTorchResult.set}. */\n    toggle: () => Promise<boolean>;\n}\n\n/**\n * Drive the camera's LED torch on the video track of a stream.\n *\n * The lamp is not a device you can open — it is a **constraint on a live video\n * track**, so there is nothing to control until a camera stream exists, and it\n * disappears when that stream is released. That is also why `supported` can only be\n * answered after the track is live: the same code is `true` on an Android rear camera\n * and `false` on the front one of the same phone.\n *\n * Capability detection prefers `getCapabilities()` and falls back to\n * `getSettings()`, because Firefox implements neither the torch nor\n * `getCapabilities()` and Safari reports the setting without the capability. When\n * neither mentions `torch`, the hook reports `supported: false` instead of offering a\n * button that silently does nothing.\n *\n * @param stream - A live camera stream, or `null` before permission lands.\n * @returns Whether a lamp exists, its state, and setters.\n *\n * @example\n * const camera = useBarcodeScanner();\n * {camera.torch.supported && (\n *     <button onClick={() => void camera.torch.toggle()}>Lanterna</button>\n * )}\n */\nexport function useTorch(stream: MediaStream | null): UseTorchResult {\n    const [supported, setSupported] = useState(false);\n    const [on, setOn] = useState(false);\n\n    useEffect(() => {\n        const track = stream?.getVideoTracks()[0] ?? null;\n        if (!track) {\n            setSupported(false);\n            setOn(false);\n            return;\n        }\n        const capabilities = (track.getCapabilities?.() ?? {}) as TorchCapabilities;\n        const settings = track.getSettings();\n        setSupported(capabilities.torch !== undefined || settings.torch !== undefined);\n        setOn(settings.torch === true);\n    }, [stream]);\n\n    const set = useCallback(\n        async (next: boolean): Promise<boolean> => {\n            const track = stream?.getVideoTracks()[0] ?? null;\n            if (!track) return false;\n            try {\n                await track.applyConstraints({\n                    advanced: [{ torch: next }],\n                } as TorchConstraints);\n                setOn(next);\n                return true;\n            } catch {\n                // A track without a lamp rejects with `OverconstrainedError`. There is\n                // nothing for the user to fix, and the honest report is \"no torch\".\n                setSupported(false);\n                setOn(false);\n                return false;\n            }\n        },\n        [stream],\n    );\n\n    const toggle = useCallback((): Promise<boolean> => set(!on), [set, on]);\n\n    return { supported, on, set, toggle };\n}\n"],"mappings":"uBAuDA,SAAgB,EAAS,EAA4C,CACjE,GAAM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAS,EAAK,EAC1C,CAAC,EAAI,IAAA,EAAS,EAAA,SAAA,CAAS,EAAK,GAElC,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAQ,GAAQ,eAAe,CAAC,CAAC,IAAM,KAC7C,GAAI,CAAC,EAAO,CACR,EAAa,EAAK,EAClB,EAAM,EAAK,EACX,MACJ,CACA,IAAM,EAAgB,EAAM,kBAAkB,GAAK,CAAC,EAC9C,EAAW,EAAM,YAAY,EACnC,EAAa,EAAa,QAAU,IAAA,IAAa,EAAS,QAAU,IAAA,EAAS,EAC7E,EAAM,EAAS,QAAU,EAAI,CACjC,EAAG,CAAC,CAAM,CAAC,EAEX,IAAM,GAAA,EAAM,EAAA,YAAA,CACR,KAAO,IAAoC,CACvC,IAAM,EAAQ,GAAQ,eAAe,CAAC,CAAC,IAAM,KAC7C,GAAI,CAAC,EAAO,MAAO,GACnB,GAAI,CAKA,OAJA,MAAM,EAAM,iBAAiB,CACzB,SAAU,CAAC,CAAE,MAAO,CAAK,CAAC,CAC9B,CAAqB,EACrB,EAAM,CAAI,EACH,EACX,MAAQ,CAKJ,OAFA,EAAa,EAAK,EAClB,EAAM,EAAK,EACJ,EACX,CACJ,EACA,CAAC,CAAM,CACX,EAIA,MAAO,CAAE,YAAW,KAAI,MAAK,QAAA,EAFd,EAAA,YAAA,KAAoC,EAAI,CAAC,CAAE,EAAG,CAAC,EAAK,CAAE,CAExC,CAAO,CACxC"}
+{"version":3,"file":"use-torch.cjs","names":["useState","useCallback","react","useTorch","supported","setSupported","on","setOn","track","stream","capabilities","settings","set","next"],"sources":["../../src/capture/use-torch.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * `torch` is a real constrainable property in the Media Capture spec, but\n * TypeScript's `MediaTrackConstraintSet` does not list it, so the literal has to be\n * widened before `applyConstraints` will take it.\n */\ntype TorchConstraints = MediaTrackConstraints & {\n    advanced?: Array<MediaTrackConstraintSet & { torch?: boolean }>;\n};\n\n/** `getCapabilities()` reports `torch` as a list of the values the lamp accepts. */\ntype TorchCapabilities = MediaTrackCapabilities & { torch?: readonly boolean[] };\n\n/** Value returned by {@link useTorch}. */\nexport interface UseTorchResult {\n    /** Whether this track has a controllable lamp. `false` on every desktop webcam. */\n    supported: boolean;\n    /** Whether the lamp is on, as far as this hook knows. */\n    on: boolean;\n    /**\n     * Turn the lamp on or off.\n     *\n     * @param next - `true` to light it up.\n     * @returns `false` when the track refused — treat that as \"no torch\".\n     */\n    set: (next: boolean) => Promise<boolean>;\n    /** Flip it. Same return contract as {@link UseTorchResult.set}. */\n    toggle: () => Promise<boolean>;\n}\n\n/**\n * Drive the camera's LED torch on the video track of a stream.\n *\n * The lamp is not a device you can open — it is a **constraint on a live video\n * track**, so there is nothing to control until a camera stream exists, and it\n * disappears when that stream is released. That is also why `supported` can only be\n * answered after the track is live: the same code is `true` on an Android rear camera\n * and `false` on the front one of the same phone.\n *\n * Capability detection prefers `getCapabilities()` and falls back to\n * `getSettings()`, because Firefox implements neither the torch nor\n * `getCapabilities()` and Safari reports the setting without the capability. When\n * neither mentions `torch`, the hook reports `supported: false` instead of offering a\n * button that silently does nothing.\n *\n * @param stream - A live camera stream, or `null` before permission lands.\n * @returns Whether a lamp exists, its state, and setters.\n *\n * @example\n * const camera = useBarcodeScanner();\n * {camera.torch.supported && (\n *     <button onClick={() => void camera.torch.toggle()}>Lanterna</button>\n * )}\n */\nexport function useTorch(stream: MediaStream | null): UseTorchResult {\n    const [supported, setSupported] = useState(false);\n    const [on, setOn] = useState(false);\n\n    useEffect(() => {\n        const track = stream?.getVideoTracks()[0] ?? null;\n        if (!track) {\n            setSupported(false);\n            setOn(false);\n            return;\n        }\n        const capabilities = (track.getCapabilities?.() ?? {}) as TorchCapabilities;\n        const settings = track.getSettings();\n        setSupported(capabilities.torch !== undefined || settings.torch !== undefined);\n        setOn(settings.torch === true);\n    }, [stream]);\n\n    const set = useCallback(\n        async (next: boolean): Promise<boolean> => {\n            const track = stream?.getVideoTracks()[0] ?? null;\n            if (!track) return false;\n            try {\n                await track.applyConstraints({\n                    advanced: [{ torch: next }],\n                } as TorchConstraints);\n                setOn(next);\n                return true;\n            } catch {\n                // A track without a lamp rejects with `OverconstrainedError`. There is\n                // nothing for the user to fix, and the honest report is \"no torch\".\n                setSupported(false);\n                setOn(false);\n                return false;\n            }\n        },\n        [stream],\n    );\n\n    const toggle = useCallback((): Promise<boolean> => set(!on), [set, on]);\n\n    return { supported, on, set, toggle };\n}\n"],"mappings":"A,uBAuDA,SAAgBG,EAAS,EAA4C,CACjE,GAAM,CAACC,EAAWC,IAAA,EAAgBL,EAAAA,SAAAA,CAAS,EAAK,EAC1C,CAACM,EAAIC,IAAA,EAASP,EAAAA,SAAAA,CAAS,EAAK,GAElC,EAAAE,EAAA,UAAA,KAAgB,CACZ,IAAMM,EAAQC,GAAQ,eAAe,CAAC,CAAC,IAAM,KAC7C,GAAI,CAACD,EAAO,CACRH,EAAa,EAAK,EAClBE,EAAM,EAAK,EACX,MACJ,CACA,IAAMG,EAAgBF,EAAM,kBAAkB,GAAK,CAAC,EAC9CG,EAAWH,EAAM,YAAY,EACnCH,EAAaK,EAAa,QAAU,IAAA,IAAaC,EAAS,QAAU,IAAA,EAAS,EAC7EJ,EAAMI,EAAS,QAAU,EAAI,CACjC,EAAG,CAACF,CAAM,CAAC,EAEX,IAAMG,GAAA,EAAMX,EAAAA,YAAAA,CACR,KAAO,IAAoC,CACvC,IAAMO,EAAQC,GAAQ,eAAe,CAAC,CAAC,IAAM,KAC7C,GAAI,CAACD,EAAO,MAAO,GACnB,GAAI,CAKA,OAJA,MAAMA,EAAM,iBAAiB,CACzB,SAAU,CAAC,CAAE,MAAOK,CAAK,CAAC,CAC9B,CAAqB,EACrBN,EAAMM,CAAI,EACH,EACX,MAAQ,CAKJ,OAFAR,EAAa,EAAK,EAClBE,EAAM,EAAK,EACJ,EACX,CACJ,EACA,CAACE,CAAM,CACX,EAIA,MAAO,CAAE,YAAW,KAAI,MAAK,QAAA,EAFdR,EAAAA,YAAAA,KAAoCW,EAAI,CAACN,CAAE,EAAG,CAACM,EAAKN,CAAE,CAExC,CAAO,CACxC,C"}

package/dist/capture/use-torch.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-torch.js","names":[],"sources":["../../src/capture/use-torch.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * `torch` is a real constrainable property in the Media Capture spec, but\n * TypeScript's `MediaTrackConstraintSet` does not list it, so the literal has to be\n * widened before `applyConstraints` will take it.\n */\ntype TorchConstraints = MediaTrackConstraints & {\n    advanced?: Array<MediaTrackConstraintSet & { torch?: boolean }>;\n};\n\n/** `getCapabilities()` reports `torch` as a list of the values the lamp accepts. */\ntype TorchCapabilities = MediaTrackCapabilities & { torch?: readonly boolean[] };\n\n/** Value returned by {@link useTorch}. */\nexport interface UseTorchResult {\n    /** Whether this track has a controllable lamp. `false` on every desktop webcam. */\n    supported: boolean;\n    /** Whether the lamp is on, as far as this hook knows. */\n    on: boolean;\n    /**\n     * Turn the lamp on or off.\n     *\n     * @param next - `true` to light it up.\n     * @returns `false` when the track refused — treat that as \"no torch\".\n     */\n    set: (next: boolean) => Promise<boolean>;\n    /** Flip it. Same return contract as {@link UseTorchResult.set}. */\n    toggle: () => Promise<boolean>;\n}\n\n/**\n * Drive the camera's LED torch on the video track of a stream.\n *\n * The lamp is not a device you can open — it is a **constraint on a live video\n * track**, so there is nothing to control until a camera stream exists, and it\n * disappears when that stream is released. That is also why `supported` can only be\n * answered after the track is live: the same code is `true` on an Android rear camera\n * and `false` on the front one of the same phone.\n *\n * Capability detection prefers `getCapabilities()` and falls back to\n * `getSettings()`, because Firefox implements neither the torch nor\n * `getCapabilities()` and Safari reports the setting without the capability. When\n * neither mentions `torch`, the hook reports `supported: false` instead of offering a\n * button that silently does nothing.\n *\n * @param stream - A live camera stream, or `null` before permission lands.\n * @returns Whether a lamp exists, its state, and setters.\n *\n * @example\n * const camera = useBarcodeScanner();\n * {camera.torch.supported && (\n *     <button onClick={() => void camera.torch.toggle()}>Lanterna</button>\n * )}\n */\nexport function useTorch(stream: MediaStream | null): UseTorchResult {\n    const [supported, setSupported] = useState(false);\n    const [on, setOn] = useState(false);\n\n    useEffect(() => {\n        const track = stream?.getVideoTracks()[0] ?? null;\n        if (!track) {\n            setSupported(false);\n            setOn(false);\n            return;\n        }\n        const capabilities = (track.getCapabilities?.() ?? {}) as TorchCapabilities;\n        const settings = track.getSettings();\n        setSupported(capabilities.torch !== undefined || settings.torch !== undefined);\n        setOn(settings.torch === true);\n    }, [stream]);\n\n    const set = useCallback(\n        async (next: boolean): Promise<boolean> => {\n            const track = stream?.getVideoTracks()[0] ?? null;\n            if (!track) return false;\n            try {\n                await track.applyConstraints({\n                    advanced: [{ torch: next }],\n                } as TorchConstraints);\n                setOn(next);\n                return true;\n            } catch {\n                // A track without a lamp rejects with `OverconstrainedError`. There is\n                // nothing for the user to fix, and the honest report is \"no torch\".\n                setSupported(false);\n                setOn(false);\n                return false;\n            }\n        },\n        [stream],\n    );\n\n    const toggle = useCallback((): Promise<boolean> => set(!on), [set, on]);\n\n    return { supported, on, set, toggle };\n}\n"],"mappings":";;AAuDA,SAAgB,EAAS,GAA4C;CACjE,IAAM,CAAC,GAAW,KAAgB,EAAS,EAAK,GAC1C,CAAC,GAAI,KAAS,EAAS,EAAK;CAElC,QAAgB;EACZ,IAAM,IAAQ,GAAQ,eAAe,CAAC,CAAC,MAAM;EAC7C,IAAI,CAAC,GAAO;GAER,AADA,EAAa,EAAK,GAClB,EAAM,EAAK;GACX;EACJ;EACA,IAAM,IAAgB,EAAM,kBAAkB,KAAK,CAAC,GAC9C,IAAW,EAAM,YAAY;EAEnC,AADA,EAAa,EAAa,UAAU,KAAA,KAAa,EAAS,UAAU,KAAA,CAAS,GAC7E,EAAM,EAAS,UAAU,EAAI;CACjC,GAAG,CAAC,CAAM,CAAC;CAEX,IAAM,IAAM,EACR,OAAO,MAAoC;EACvC,IAAM,IAAQ,GAAQ,eAAe,CAAC,CAAC,MAAM;EAC7C,IAAI,CAAC,GAAO,OAAO;EACnB,IAAI;GAKA,OAJA,MAAM,EAAM,iBAAiB,EACzB,UAAU,CAAC,EAAE,OAAO,EAAK,CAAC,EAC9B,CAAqB,GACrB,EAAM,CAAI,GACH;EACX,QAAQ;GAKJ,OAFA,EAAa,EAAK,GAClB,EAAM,EAAK,GACJ;EACX;CACJ,GACA,CAAC,CAAM,CACX;CAIA,OAAO;EAAE;EAAW;EAAI;EAAK,QAFd,QAAoC,EAAI,CAAC,CAAE,GAAG,CAAC,GAAK,CAAE,CAExC;CAAO;AACxC"}
+{"version":3,"file":"use-torch.js","names":["useTorch","supported","setSupported","useState","on","setOn","track","stream","capabilities","settings","set","useCallback","next"],"sources":["../../src/capture/use-torch.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/**\n * `torch` is a real constrainable property in the Media Capture spec, but\n * TypeScript's `MediaTrackConstraintSet` does not list it, so the literal has to be\n * widened before `applyConstraints` will take it.\n */\ntype TorchConstraints = MediaTrackConstraints & {\n    advanced?: Array<MediaTrackConstraintSet & { torch?: boolean }>;\n};\n\n/** `getCapabilities()` reports `torch` as a list of the values the lamp accepts. */\ntype TorchCapabilities = MediaTrackCapabilities & { torch?: readonly boolean[] };\n\n/** Value returned by {@link useTorch}. */\nexport interface UseTorchResult {\n    /** Whether this track has a controllable lamp. `false` on every desktop webcam. */\n    supported: boolean;\n    /** Whether the lamp is on, as far as this hook knows. */\n    on: boolean;\n    /**\n     * Turn the lamp on or off.\n     *\n     * @param next - `true` to light it up.\n     * @returns `false` when the track refused — treat that as \"no torch\".\n     */\n    set: (next: boolean) => Promise<boolean>;\n    /** Flip it. Same return contract as {@link UseTorchResult.set}. */\n    toggle: () => Promise<boolean>;\n}\n\n/**\n * Drive the camera's LED torch on the video track of a stream.\n *\n * The lamp is not a device you can open — it is a **constraint on a live video\n * track**, so there is nothing to control until a camera stream exists, and it\n * disappears when that stream is released. That is also why `supported` can only be\n * answered after the track is live: the same code is `true` on an Android rear camera\n * and `false` on the front one of the same phone.\n *\n * Capability detection prefers `getCapabilities()` and falls back to\n * `getSettings()`, because Firefox implements neither the torch nor\n * `getCapabilities()` and Safari reports the setting without the capability. When\n * neither mentions `torch`, the hook reports `supported: false` instead of offering a\n * button that silently does nothing.\n *\n * @param stream - A live camera stream, or `null` before permission lands.\n * @returns Whether a lamp exists, its state, and setters.\n *\n * @example\n * const camera = useBarcodeScanner();\n * {camera.torch.supported && (\n *     <button onClick={() => void camera.torch.toggle()}>Lanterna</button>\n * )}\n */\nexport function useTorch(stream: MediaStream | null): UseTorchResult {\n    const [supported, setSupported] = useState(false);\n    const [on, setOn] = useState(false);\n\n    useEffect(() => {\n        const track = stream?.getVideoTracks()[0] ?? null;\n        if (!track) {\n            setSupported(false);\n            setOn(false);\n            return;\n        }\n        const capabilities = (track.getCapabilities?.() ?? {}) as TorchCapabilities;\n        const settings = track.getSettings();\n        setSupported(capabilities.torch !== undefined || settings.torch !== undefined);\n        setOn(settings.torch === true);\n    }, [stream]);\n\n    const set = useCallback(\n        async (next: boolean): Promise<boolean> => {\n            const track = stream?.getVideoTracks()[0] ?? null;\n            if (!track) return false;\n            try {\n                await track.applyConstraints({\n                    advanced: [{ torch: next }],\n                } as TorchConstraints);\n                setOn(next);\n                return true;\n            } catch {\n                // A track without a lamp rejects with `OverconstrainedError`. There is\n                // nothing for the user to fix, and the honest report is \"no torch\".\n                setSupported(false);\n                setOn(false);\n                return false;\n            }\n        },\n        [stream],\n    );\n\n    const toggle = useCallback((): Promise<boolean> => set(!on), [set, on]);\n\n    return { supported, on, set, toggle };\n}\n"],"mappings":";;AAuDA,SAAgBA,EAAS,GAA4C;CACjE,IAAM,CAACC,GAAWC,KAAgBC,EAAS,EAAK,GAC1C,CAACC,GAAIC,KAASF,EAAS,EAAK;CAElC,QAAgB;EACZ,IAAMG,IAAQC,GAAQ,eAAe,CAAC,CAAC,MAAM;EAC7C,IAAI,CAACD,GAAO;GAER,AADAJ,EAAa,EAAK,GAClBG,EAAM,EAAK;GACX;EACJ;EACA,IAAMG,IAAgBF,EAAM,kBAAkB,KAAK,CAAC,GAC9CG,IAAWH,EAAM,YAAY;EAEnC,AADAJ,EAAaM,EAAa,UAAU,KAAA,KAAaC,EAAS,UAAU,KAAA,CAAS,GAC7EJ,EAAMI,EAAS,UAAU,EAAI;CACjC,GAAG,CAACF,CAAM,CAAC;CAEX,IAAMG,IAAMC,EACR,OAAO,MAAoC;EACvC,IAAML,IAAQC,GAAQ,eAAe,CAAC,CAAC,MAAM;EAC7C,IAAI,CAACD,GAAO,OAAO;EACnB,IAAI;GAKA,OAJA,MAAMA,EAAM,iBAAiB,EACzB,UAAU,CAAC,EAAE,OAAOM,EAAK,CAAC,EAC9B,CAAqB,GACrBP,EAAMO,CAAI,GACH;EACX,QAAQ;GAKJ,OAFAV,EAAa,EAAK,GAClBG,EAAM,EAAK,GACJ;EACX;CACJ,GACA,CAACE,CAAM,CACX;CAIA,OAAO;EAAE;EAAW;EAAI;EAAK,QAFdI,QAAoCD,EAAI,CAACN,CAAE,GAAG,CAACM,GAAKN,CAAE,CAExC;CAAO;AACxC"}

package/dist/capture/use-video-recorder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-video-recorder.cjs","names":[],"sources":["../../src/capture/use-video-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the same lifecycle as the audio recorder —\n * permission, recorder, clock, auto-stop — over a stream that also carries video,\n * with the preview element to attach and release.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\nimport type { MediaRecorderHandle, MediaRecorderStatus } from \"./media-recorder\";\nimport {\n    createVideoRecorder,\n    type VideoRecorderOptions,\n    type VideoRecording,\n} from \"./video-recorder\";\n\n/** Options for {@link useVideoRecorder}. */\nexport interface UseVideoRecorderOptions extends VideoRecorderOptions {\n    /**\n     * Stop automatically after this many milliseconds.\n     *\n     * Worth setting on anything user-facing, and more so than for audio: a minute of\n     * 1080p at 2.5 Mbps is roughly 19 MB, so a recording left running by accident\n     * fills memory an order of magnitude faster than a voice note does.\n     */\n    maxDurationMs?: number;\n    /** Called once the recording is assembled, whether by `stop()` or `maxDurationMs`. */\n    onRecorded?: (recording: VideoRecording) => void;\n    /** How often the clock is published, in ms. Default 250. */\n    tickMs?: number;\n}\n\n/** Value returned by {@link useVideoRecorder}. */\nexport interface UseVideoRecorderResult {\n    status: MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: number;\n    /** The finished recording, or `null` before the first `stop()`. */\n    recording: VideoRecording | null;\n    /** Recorder-level error (encoder failure, share revoked mid-recording). */\n    error: unknown;\n    /** `false` when there is no stream yet, or the browser cannot record video. */\n    ready: boolean;\n    start: () => void;\n    pause: () => void;\n    resume: () => void;\n    /** Stop and resolve with the recording. Also published on `recording`. */\n    stop: () => Promise<VideoRecording | null>;\n    /** Stop and throw the video away. */\n    cancel: () => void;\n}\n\n/**\n * Record a video stream — from {@link useScreenCapture}, from a camera, or from a\n * canvas.\n *\n * Pass the stream in; the hook stays `ready: false` until there is one, so a page can\n * render the whole recorder UI before the user has picked a screen and simply have it\n * disabled.\n *\n * There is no level meter here, which is the one real difference from\n * `useAudioRecorder`: metering a screen share means opening an `AudioContext` on a\n * stream that usually has no audio track at all, and browsers cap the number of live\n * contexts. If you are recording a camera **and** want a level, run\n * `createLevelMeter` on the same stream yourself.\n *\n * The clock is published every `tickMs` (default 250 ms) rather than per frame: a\n * video recording UI shows `0:07`, and a hook that re-rendered its parent 60 times a\n * second to move a one-second counter would be the most expensive thing on the page.\n *\n * @param stream - The stream to record, or `null` while the picker is open.\n * @param options - See {@link UseVideoRecorderOptions}.\n *\n * @example\n * const screen = useScreenCapture();\n * const rec = useVideoRecorder(screen.stream, { maxDurationMs: 120_000 });\n * <button disabled={!rec.ready} onClick={rec.start}>Gravar tela</button>\n */\nexport function useVideoRecorder(\n    stream: MediaStream | null,\n    options: UseVideoRecorderOptions = {},\n): UseVideoRecorderResult {\n    const {\n        maxDurationMs,\n        onRecorded,\n        onChunk,\n        onError,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        tickMs = 250,\n    } = options;\n\n    const [status, setStatus] = useState<MediaRecorderStatus>(\"idle\");\n    const [durationMs, setDurationMs] = useState(0);\n    const [recording, setRecording] = useState<VideoRecording | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [ready, setReady] = useState(false);\n\n    const recorderRef = useRef<MediaRecorderHandle | null>(null);\n\n    const emitRecorded = useStableCallback((result: VideoRecording) => onRecorded?.(result));\n    const emitChunk = useStableCallback((chunk: Blob) => onChunk?.(chunk));\n    const emitError = useStableCallback((err: unknown) => {\n        setError(err);\n        onError?.(err);\n    });\n\n    /**\n     * Build the recorder for a stream, and tear it down when the stream changes.\n     *\n     * Rebuilt per stream because `MediaRecorder` is bound to the stream it was\n     * constructed with: a user who stops sharing and picks a different window hands us\n     * a new `MediaStream`, and reusing the old recorder would keep recording a surface\n     * that no longer exists. Same reason for a container or bitrate change — both are\n     * constructor arguments.\n     */\n    useEffect(() => {\n        if (!stream) {\n            setReady(false);\n            return;\n        }\n        let recorder: MediaRecorderHandle;\n        try {\n            recorder = createVideoRecorder(stream, {\n                mimeType,\n                videoBitsPerSecond,\n                audioBitsPerSecond,\n                timesliceMs,\n                onChunk: emitChunk,\n                onError: emitError,\n            });\n        } catch (err) {\n            setError(err);\n            setReady(false);\n            return;\n        }\n        recorderRef.current = recorder;\n        setReady(true);\n        setStatus(\"idle\");\n\n        return () => {\n            if (recorder.status() === \"recording\" || recorder.status() === \"paused\") {\n                recorder.cancel();\n            }\n            recorderRef.current = null;\n            setReady(false);\n        };\n    }, [\n        stream,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        emitChunk,\n        emitError,\n    ]);\n\n    const stop = useCallback(async (): Promise<VideoRecording | null> => {\n        const recorder = recorderRef.current;\n        if (!recorder) return null;\n        const current = recorder.status();\n        if (current !== \"recording\" && current !== \"paused\") return null;\n        const result = await recorder.stop();\n        setStatus(\"stopped\");\n        setDurationMs(result.durationMs);\n        setRecording(result);\n        emitRecorded(result);\n        return result;\n    }, [emitRecorded]);\n\n    /**\n     * Publish the clock while something is running, and enforce `maxDurationMs`.\n     *\n     * The cap is checked on the same tick rather than with a `setTimeout` armed at\n     * `start()`, because a paused recording must not keep counting toward it — a\n     * timeout would fire while the user is paused on a slide.\n     */\n    useEffect(() => {\n        if (status !== \"recording\" && status !== \"paused\") return;\n        const id = setInterval(() => {\n            const recorder = recorderRef.current;\n            if (!recorder) return;\n            const elapsed = recorder.durationMs();\n            setDurationMs(elapsed);\n            if (maxDurationMs !== undefined && elapsed >= maxDurationMs) void stop();\n        }, tickMs);\n        return () => clearInterval(id);\n    }, [status, tickMs, maxDurationMs, stop]);\n\n    const start = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        setRecording(null);\n        setError(null);\n        setDurationMs(0);\n        recorder.start();\n        setStatus(recorder.status());\n    }, []);\n\n    const pause = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.pause();\n        setDurationMs(recorder.durationMs());\n        setStatus(recorder.status());\n    }, []);\n\n    const resume = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.resume();\n        setStatus(recorder.status());\n    }, []);\n\n    const cancel = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.cancel();\n        setStatus(\"idle\");\n        setDurationMs(0);\n        setRecording(null);\n    }, []);\n\n    return { status, durationMs, recording, error, ready, start, pause, resume, stop, cancel };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-video-recorder.cjs","names":["useState","useRef","useStableCallback","createVideoRecorder","useCallback","require_use_stable_callback","require_video_recorder","react","useVideoRecorder","options","status","setStatus","durationMs","setDurationMs","recording","setRecording","error","setError","ready","setReady","recorderRef","emitRecorded","onRecorded","result","emitChunk","onChunk","chunk","emitError","err","onError","stream","recorder","mimeType","videoBitsPerSecond","audioBitsPerSecond","timesliceMs","stop","current","id","elapsed","maxDurationMs","tickMs"],"sources":["../../src/capture/use-video-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the same lifecycle as the audio recorder —\n * permission, recorder, clock, auto-stop — over a stream that also carries video,\n * with the preview element to attach and release.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\nimport type { MediaRecorderHandle, MediaRecorderStatus } from \"./media-recorder\";\nimport {\n    createVideoRecorder,\n    type VideoRecorderOptions,\n    type VideoRecording,\n} from \"./video-recorder\";\n\n/** Options for {@link useVideoRecorder}. */\nexport interface UseVideoRecorderOptions extends VideoRecorderOptions {\n    /**\n     * Stop automatically after this many milliseconds.\n     *\n     * Worth setting on anything user-facing, and more so than for audio: a minute of\n     * 1080p at 2.5 Mbps is roughly 19 MB, so a recording left running by accident\n     * fills memory an order of magnitude faster than a voice note does.\n     */\n    maxDurationMs?: number;\n    /** Called once the recording is assembled, whether by `stop()` or `maxDurationMs`. */\n    onRecorded?: (recording: VideoRecording) => void;\n    /** How often the clock is published, in ms. Default 250. */\n    tickMs?: number;\n}\n\n/** Value returned by {@link useVideoRecorder}. */\nexport interface UseVideoRecorderResult {\n    status: MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: number;\n    /** The finished recording, or `null` before the first `stop()`. */\n    recording: VideoRecording | null;\n    /** Recorder-level error (encoder failure, share revoked mid-recording). */\n    error: unknown;\n    /** `false` when there is no stream yet, or the browser cannot record video. */\n    ready: boolean;\n    start: () => void;\n    pause: () => void;\n    resume: () => void;\n    /** Stop and resolve with the recording. Also published on `recording`. */\n    stop: () => Promise<VideoRecording | null>;\n    /** Stop and throw the video away. */\n    cancel: () => void;\n}\n\n/**\n * Record a video stream — from {@link useScreenCapture}, from a camera, or from a\n * canvas.\n *\n * Pass the stream in; the hook stays `ready: false` until there is one, so a page can\n * render the whole recorder UI before the user has picked a screen and simply have it\n * disabled.\n *\n * There is no level meter here, which is the one real difference from\n * `useAudioRecorder`: metering a screen share means opening an `AudioContext` on a\n * stream that usually has no audio track at all, and browsers cap the number of live\n * contexts. If you are recording a camera **and** want a level, run\n * `createLevelMeter` on the same stream yourself.\n *\n * The clock is published every `tickMs` (default 250 ms) rather than per frame: a\n * video recording UI shows `0:07`, and a hook that re-rendered its parent 60 times a\n * second to move a one-second counter would be the most expensive thing on the page.\n *\n * @param stream - The stream to record, or `null` while the picker is open.\n * @param options - See {@link UseVideoRecorderOptions}.\n *\n * @example\n * const screen = useScreenCapture();\n * const rec = useVideoRecorder(screen.stream, { maxDurationMs: 120_000 });\n * <button disabled={!rec.ready} onClick={rec.start}>Gravar tela</button>\n */\nexport function useVideoRecorder(\n    stream: MediaStream | null,\n    options: UseVideoRecorderOptions = {},\n): UseVideoRecorderResult {\n    const {\n        maxDurationMs,\n        onRecorded,\n        onChunk,\n        onError,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        tickMs = 250,\n    } = options;\n\n    const [status, setStatus] = useState<MediaRecorderStatus>(\"idle\");\n    const [durationMs, setDurationMs] = useState(0);\n    const [recording, setRecording] = useState<VideoRecording | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [ready, setReady] = useState(false);\n\n    const recorderRef = useRef<MediaRecorderHandle | null>(null);\n\n    const emitRecorded = useStableCallback((result: VideoRecording) => onRecorded?.(result));\n    const emitChunk = useStableCallback((chunk: Blob) => onChunk?.(chunk));\n    const emitError = useStableCallback((err: unknown) => {\n        setError(err);\n        onError?.(err);\n    });\n\n    /**\n     * Build the recorder for a stream, and tear it down when the stream changes.\n     *\n     * Rebuilt per stream because `MediaRecorder` is bound to the stream it was\n     * constructed with: a user who stops sharing and picks a different window hands us\n     * a new `MediaStream`, and reusing the old recorder would keep recording a surface\n     * that no longer exists. Same reason for a container or bitrate change — both are\n     * constructor arguments.\n     */\n    useEffect(() => {\n        if (!stream) {\n            setReady(false);\n            return;\n        }\n        let recorder: MediaRecorderHandle;\n        try {\n            recorder = createVideoRecorder(stream, {\n                mimeType,\n                videoBitsPerSecond,\n                audioBitsPerSecond,\n                timesliceMs,\n                onChunk: emitChunk,\n                onError: emitError,\n            });\n        } catch (err) {\n            setError(err);\n            setReady(false);\n            return;\n        }\n        recorderRef.current = recorder;\n        setReady(true);\n        setStatus(\"idle\");\n\n        return () => {\n            if (recorder.status() === \"recording\" || recorder.status() === \"paused\") {\n                recorder.cancel();\n            }\n            recorderRef.current = null;\n            setReady(false);\n        };\n    }, [\n        stream,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        emitChunk,\n        emitError,\n    ]);\n\n    const stop = useCallback(async (): Promise<VideoRecording | null> => {\n        const recorder = recorderRef.current;\n        if (!recorder) return null;\n        const current = recorder.status();\n        if (current !== \"recording\" && current !== \"paused\") return null;\n        const result = await recorder.stop();\n        setStatus(\"stopped\");\n        setDurationMs(result.durationMs);\n        setRecording(result);\n        emitRecorded(result);\n        return result;\n    }, [emitRecorded]);\n\n    /**\n     * Publish the clock while something is running, and enforce `maxDurationMs`.\n     *\n     * The cap is checked on the same tick rather than with a `setTimeout` armed at\n     * `start()`, because a paused recording must not keep counting toward it — a\n     * timeout would fire while the user is paused on a slide.\n     */\n    useEffect(() => {\n        if (status !== \"recording\" && status !== \"paused\") return;\n        const id = setInterval(() => {\n            const recorder = recorderRef.current;\n            if (!recorder) return;\n            const elapsed = recorder.durationMs();\n            setDurationMs(elapsed);\n            if (maxDurationMs !== undefined && elapsed >= maxDurationMs) void stop();\n        }, tickMs);\n        return () => clearInterval(id);\n    }, [status, tickMs, maxDurationMs, stop]);\n\n    const start = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        setRecording(null);\n        setError(null);\n        setDurationMs(0);\n        recorder.start();\n        setStatus(recorder.status());\n    }, []);\n\n    const pause = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.pause();\n        setDurationMs(recorder.durationMs());\n        setStatus(recorder.status());\n    }, []);\n\n    const resume = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.resume();\n        setStatus(recorder.status());\n    }, []);\n\n    const cancel = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.cancel();\n        setStatus(\"idle\");\n        setDurationMs(0);\n        setRecording(null);\n    }, []);\n\n    return { status, durationMs, recording, error, ready, start, pause, resume, stop, cancel };\n}\n"],"mappings":"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"}

package/dist/capture/use-video-recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-video-recorder.js","names":[],"sources":["../../src/capture/use-video-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the same lifecycle as the audio recorder —\n * permission, recorder, clock, auto-stop — over a stream that also carries video,\n * with the preview element to attach and release.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\nimport type { MediaRecorderHandle, MediaRecorderStatus } from \"./media-recorder\";\nimport {\n    createVideoRecorder,\n    type VideoRecorderOptions,\n    type VideoRecording,\n} from \"./video-recorder\";\n\n/** Options for {@link useVideoRecorder}. */\nexport interface UseVideoRecorderOptions extends VideoRecorderOptions {\n    /**\n     * Stop automatically after this many milliseconds.\n     *\n     * Worth setting on anything user-facing, and more so than for audio: a minute of\n     * 1080p at 2.5 Mbps is roughly 19 MB, so a recording left running by accident\n     * fills memory an order of magnitude faster than a voice note does.\n     */\n    maxDurationMs?: number;\n    /** Called once the recording is assembled, whether by `stop()` or `maxDurationMs`. */\n    onRecorded?: (recording: VideoRecording) => void;\n    /** How often the clock is published, in ms. Default 250. */\n    tickMs?: number;\n}\n\n/** Value returned by {@link useVideoRecorder}. */\nexport interface UseVideoRecorderResult {\n    status: MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: number;\n    /** The finished recording, or `null` before the first `stop()`. */\n    recording: VideoRecording | null;\n    /** Recorder-level error (encoder failure, share revoked mid-recording). */\n    error: unknown;\n    /** `false` when there is no stream yet, or the browser cannot record video. */\n    ready: boolean;\n    start: () => void;\n    pause: () => void;\n    resume: () => void;\n    /** Stop and resolve with the recording. Also published on `recording`. */\n    stop: () => Promise<VideoRecording | null>;\n    /** Stop and throw the video away. */\n    cancel: () => void;\n}\n\n/**\n * Record a video stream — from {@link useScreenCapture}, from a camera, or from a\n * canvas.\n *\n * Pass the stream in; the hook stays `ready: false` until there is one, so a page can\n * render the whole recorder UI before the user has picked a screen and simply have it\n * disabled.\n *\n * There is no level meter here, which is the one real difference from\n * `useAudioRecorder`: metering a screen share means opening an `AudioContext` on a\n * stream that usually has no audio track at all, and browsers cap the number of live\n * contexts. If you are recording a camera **and** want a level, run\n * `createLevelMeter` on the same stream yourself.\n *\n * The clock is published every `tickMs` (default 250 ms) rather than per frame: a\n * video recording UI shows `0:07`, and a hook that re-rendered its parent 60 times a\n * second to move a one-second counter would be the most expensive thing on the page.\n *\n * @param stream - The stream to record, or `null` while the picker is open.\n * @param options - See {@link UseVideoRecorderOptions}.\n *\n * @example\n * const screen = useScreenCapture();\n * const rec = useVideoRecorder(screen.stream, { maxDurationMs: 120_000 });\n * <button disabled={!rec.ready} onClick={rec.start}>Gravar tela</button>\n */\nexport function useVideoRecorder(\n    stream: MediaStream | null,\n    options: UseVideoRecorderOptions = {},\n): UseVideoRecorderResult {\n    const {\n        maxDurationMs,\n        onRecorded,\n        onChunk,\n        onError,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        tickMs = 250,\n    } = options;\n\n    const [status, setStatus] = useState<MediaRecorderStatus>(\"idle\");\n    const [durationMs, setDurationMs] = useState(0);\n    const [recording, setRecording] = useState<VideoRecording | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [ready, setReady] = useState(false);\n\n    const recorderRef = useRef<MediaRecorderHandle | null>(null);\n\n    const emitRecorded = useStableCallback((result: VideoRecording) => onRecorded?.(result));\n    const emitChunk = useStableCallback((chunk: Blob) => onChunk?.(chunk));\n    const emitError = useStableCallback((err: unknown) => {\n        setError(err);\n        onError?.(err);\n    });\n\n    /**\n     * Build the recorder for a stream, and tear it down when the stream changes.\n     *\n     * Rebuilt per stream because `MediaRecorder` is bound to the stream it was\n     * constructed with: a user who stops sharing and picks a different window hands us\n     * a new `MediaStream`, and reusing the old recorder would keep recording a surface\n     * that no longer exists. Same reason for a container or bitrate change — both are\n     * constructor arguments.\n     */\n    useEffect(() => {\n        if (!stream) {\n            setReady(false);\n            return;\n        }\n        let recorder: MediaRecorderHandle;\n        try {\n            recorder = createVideoRecorder(stream, {\n                mimeType,\n                videoBitsPerSecond,\n                audioBitsPerSecond,\n                timesliceMs,\n                onChunk: emitChunk,\n                onError: emitError,\n            });\n        } catch (err) {\n            setError(err);\n            setReady(false);\n            return;\n        }\n        recorderRef.current = recorder;\n        setReady(true);\n        setStatus(\"idle\");\n\n        return () => {\n            if (recorder.status() === \"recording\" || recorder.status() === \"paused\") {\n                recorder.cancel();\n            }\n            recorderRef.current = null;\n            setReady(false);\n        };\n    }, [\n        stream,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        emitChunk,\n        emitError,\n    ]);\n\n    const stop = useCallback(async (): Promise<VideoRecording | null> => {\n        const recorder = recorderRef.current;\n        if (!recorder) return null;\n        const current = recorder.status();\n        if (current !== \"recording\" && current !== \"paused\") return null;\n        const result = await recorder.stop();\n        setStatus(\"stopped\");\n        setDurationMs(result.durationMs);\n        setRecording(result);\n        emitRecorded(result);\n        return result;\n    }, [emitRecorded]);\n\n    /**\n     * Publish the clock while something is running, and enforce `maxDurationMs`.\n     *\n     * The cap is checked on the same tick rather than with a `setTimeout` armed at\n     * `start()`, because a paused recording must not keep counting toward it — a\n     * timeout would fire while the user is paused on a slide.\n     */\n    useEffect(() => {\n        if (status !== \"recording\" && status !== \"paused\") return;\n        const id = setInterval(() => {\n            const recorder = recorderRef.current;\n            if (!recorder) return;\n            const elapsed = recorder.durationMs();\n            setDurationMs(elapsed);\n            if (maxDurationMs !== undefined && elapsed >= maxDurationMs) void stop();\n        }, tickMs);\n        return () => clearInterval(id);\n    }, [status, tickMs, maxDurationMs, stop]);\n\n    const start = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        setRecording(null);\n        setError(null);\n        setDurationMs(0);\n        recorder.start();\n        setStatus(recorder.status());\n    }, []);\n\n    const pause = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.pause();\n        setDurationMs(recorder.durationMs());\n        setStatus(recorder.status());\n    }, []);\n\n    const resume = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.resume();\n        setStatus(recorder.status());\n    }, []);\n\n    const cancel = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.cancel();\n        setStatus(\"idle\");\n        setDurationMs(0);\n        setRecording(null);\n    }, []);\n\n    return { status, durationMs, recording, error, ready, start, pause, resume, stop, cancel };\n}\n"],"mappings":";;;;AA8EA,SAAgB,EACZ,GACA,IAAmC,CAAC,GACd;CACtB,IAAM,EACF,kBACA,eACA,YACA,YACA,aACA,uBACA,uBACA,gBACA,YAAS,QACT,GAEE,CAAC,GAAQ,KAAa,EAA8B,MAAM,GAC1D,CAAC,GAAY,KAAiB,EAAS,CAAC,GACxC,CAAC,GAAW,KAAgB,EAAgC,IAAI,GAChE,CAAC,GAAO,KAAY,EAAkB,IAAI,GAC1C,CAAC,GAAO,KAAY,EAAS,EAAK,GAElC,IAAc,EAAmC,IAAI,GAErD,IAAe,GAAmB,MAA2B,IAAa,CAAM,CAAC,GACjF,IAAY,GAAmB,MAAgB,IAAU,CAAK,CAAC,GAC/D,IAAY,GAAmB,MAAiB;EAElD,AADA,EAAS,CAAG,GACZ,IAAU,CAAG;CACjB,CAAC;CAWD,QAAgB;EACZ,IAAI,CAAC,GAAQ;GACT,EAAS,EAAK;GACd;EACJ;EACA,IAAI;EACJ,IAAI;GACA,IAAW,EAAoB,GAAQ;IACnC;IACA;IACA;IACA;IACA,SAAS;IACT,SAAS;GACb,CAAC;EACL,SAAS,GAAK;GAEV,AADA,EAAS,CAAG,GACZ,EAAS,EAAK;GACd;EACJ;EAKA,OAJA,EAAY,UAAU,GACtB,EAAS,EAAI,GACb,EAAU,MAAM,SAEH;GAKT,CAJI,EAAS,OAAO,MAAM,eAAe,EAAS,OAAO,MAAM,aAC3D,EAAS,OAAO,GAEpB,EAAY,UAAU,MACtB,EAAS,EAAK;EAClB;CACJ,GAAG;EACC;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC;CAED,IAAM,IAAO,EAAY,YAA4C;EACjE,IAAM,IAAW,EAAY;EAC7B,IAAI,CAAC,GAAU,OAAO;EACtB,IAAM,IAAU,EAAS,OAAO;EAChC,IAAI,MAAY,eAAe,MAAY,UAAU,OAAO;EAC5D,IAAM,IAAS,MAAM,EAAS,KAAK;EAKnC,OAJA,EAAU,SAAS,GACnB,EAAc,EAAO,UAAU,GAC/B,EAAa,CAAM,GACnB,EAAa,CAAM,GACZ;CACX,GAAG,CAAC,CAAY,CAAC;CAuDjB,OA9CA,QAAgB;EACZ,IAAI,MAAW,eAAe,MAAW,UAAU;EACnD,IAAM,IAAK,kBAAkB;GACzB,IAAM,IAAW,EAAY;GAC7B,IAAI,CAAC,GAAU;GACf,IAAM,IAAU,EAAS,WAAW;GAEpC,AADA,EAAc,CAAO,GACjB,MAAkB,KAAA,KAAa,KAAW,KAAe,EAAU;EAC3E,GAAG,CAAM;EACT,aAAa,cAAc,CAAE;CACjC,GAAG;EAAC;EAAQ;EAAQ;EAAe;CAAI,CAAC,GAoCjC;EAAE;EAAQ;EAAY;EAAW;EAAO;EAAO,OAlCxC,QAAwB;GAClC,IAAM,IAAW,EAAY;GACxB,MACL,EAAa,IAAI,GACjB,EAAS,IAAI,GACb,EAAc,CAAC,GACf,EAAS,MAAM,GACf,EAAU,EAAS,OAAO,CAAC;EAC/B,GAAG,CAAC,CA0BkD;EAAO,OAxB/C,QAAwB;GAClC,IAAM,IAAW,EAAY;GACxB,MACL,EAAS,MAAM,GACf,EAAc,EAAS,WAAW,CAAC,GACnC,EAAU,EAAS,OAAO,CAAC;EAC/B,GAAG,CAAC,CAkByD;EAAO,QAhBrD,QAAwB;GACnC,IAAM,IAAW,EAAY;GACxB,MACL,EAAS,OAAO,GAChB,EAAU,EAAS,OAAO,CAAC;EAC/B,GAAG,CAAC,CAWgE;EAAQ;EAAM,QATnE,QAAwB;GACnC,IAAM,IAAW,EAAY;GACxB,MACL,EAAS,OAAO,GAChB,EAAU,MAAM,GAChB,EAAc,CAAC,GACf,EAAa,IAAI;EACrB,GAAG,CAAC,CAE8E;CAAO;AAC7F"}
+{"version":3,"file":"use-video-recorder.js","names":["useVideoRecorder","options","status","setStatus","useState","durationMs","setDurationMs","recording","setRecording","error","setError","ready","setReady","recorderRef","useRef","emitRecorded","useStableCallback","onRecorded","result","emitChunk","onChunk","chunk","emitError","err","onError","stream","recorder","createVideoRecorder","mimeType","videoBitsPerSecond","audioBitsPerSecond","timesliceMs","stop","useCallback","current","useEffect","id","elapsed","maxDurationMs","tickMs"],"sources":["../../src/capture/use-video-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the same lifecycle as the audio recorder —\n * permission, recorder, clock, auto-stop — over a stream that also carries video,\n * with the preview element to attach and release.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\nimport type { MediaRecorderHandle, MediaRecorderStatus } from \"./media-recorder\";\nimport {\n    createVideoRecorder,\n    type VideoRecorderOptions,\n    type VideoRecording,\n} from \"./video-recorder\";\n\n/** Options for {@link useVideoRecorder}. */\nexport interface UseVideoRecorderOptions extends VideoRecorderOptions {\n    /**\n     * Stop automatically after this many milliseconds.\n     *\n     * Worth setting on anything user-facing, and more so than for audio: a minute of\n     * 1080p at 2.5 Mbps is roughly 19 MB, so a recording left running by accident\n     * fills memory an order of magnitude faster than a voice note does.\n     */\n    maxDurationMs?: number;\n    /** Called once the recording is assembled, whether by `stop()` or `maxDurationMs`. */\n    onRecorded?: (recording: VideoRecording) => void;\n    /** How often the clock is published, in ms. Default 250. */\n    tickMs?: number;\n}\n\n/** Value returned by {@link useVideoRecorder}. */\nexport interface UseVideoRecorderResult {\n    status: MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: number;\n    /** The finished recording, or `null` before the first `stop()`. */\n    recording: VideoRecording | null;\n    /** Recorder-level error (encoder failure, share revoked mid-recording). */\n    error: unknown;\n    /** `false` when there is no stream yet, or the browser cannot record video. */\n    ready: boolean;\n    start: () => void;\n    pause: () => void;\n    resume: () => void;\n    /** Stop and resolve with the recording. Also published on `recording`. */\n    stop: () => Promise<VideoRecording | null>;\n    /** Stop and throw the video away. */\n    cancel: () => void;\n}\n\n/**\n * Record a video stream — from {@link useScreenCapture}, from a camera, or from a\n * canvas.\n *\n * Pass the stream in; the hook stays `ready: false` until there is one, so a page can\n * render the whole recorder UI before the user has picked a screen and simply have it\n * disabled.\n *\n * There is no level meter here, which is the one real difference from\n * `useAudioRecorder`: metering a screen share means opening an `AudioContext` on a\n * stream that usually has no audio track at all, and browsers cap the number of live\n * contexts. If you are recording a camera **and** want a level, run\n * `createLevelMeter` on the same stream yourself.\n *\n * The clock is published every `tickMs` (default 250 ms) rather than per frame: a\n * video recording UI shows `0:07`, and a hook that re-rendered its parent 60 times a\n * second to move a one-second counter would be the most expensive thing on the page.\n *\n * @param stream - The stream to record, or `null` while the picker is open.\n * @param options - See {@link UseVideoRecorderOptions}.\n *\n * @example\n * const screen = useScreenCapture();\n * const rec = useVideoRecorder(screen.stream, { maxDurationMs: 120_000 });\n * <button disabled={!rec.ready} onClick={rec.start}>Gravar tela</button>\n */\nexport function useVideoRecorder(\n    stream: MediaStream | null,\n    options: UseVideoRecorderOptions = {},\n): UseVideoRecorderResult {\n    const {\n        maxDurationMs,\n        onRecorded,\n        onChunk,\n        onError,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        tickMs = 250,\n    } = options;\n\n    const [status, setStatus] = useState<MediaRecorderStatus>(\"idle\");\n    const [durationMs, setDurationMs] = useState(0);\n    const [recording, setRecording] = useState<VideoRecording | null>(null);\n    const [error, setError] = useState<unknown>(null);\n    const [ready, setReady] = useState(false);\n\n    const recorderRef = useRef<MediaRecorderHandle | null>(null);\n\n    const emitRecorded = useStableCallback((result: VideoRecording) => onRecorded?.(result));\n    const emitChunk = useStableCallback((chunk: Blob) => onChunk?.(chunk));\n    const emitError = useStableCallback((err: unknown) => {\n        setError(err);\n        onError?.(err);\n    });\n\n    /**\n     * Build the recorder for a stream, and tear it down when the stream changes.\n     *\n     * Rebuilt per stream because `MediaRecorder` is bound to the stream it was\n     * constructed with: a user who stops sharing and picks a different window hands us\n     * a new `MediaStream`, and reusing the old recorder would keep recording a surface\n     * that no longer exists. Same reason for a container or bitrate change — both are\n     * constructor arguments.\n     */\n    useEffect(() => {\n        if (!stream) {\n            setReady(false);\n            return;\n        }\n        let recorder: MediaRecorderHandle;\n        try {\n            recorder = createVideoRecorder(stream, {\n                mimeType,\n                videoBitsPerSecond,\n                audioBitsPerSecond,\n                timesliceMs,\n                onChunk: emitChunk,\n                onError: emitError,\n            });\n        } catch (err) {\n            setError(err);\n            setReady(false);\n            return;\n        }\n        recorderRef.current = recorder;\n        setReady(true);\n        setStatus(\"idle\");\n\n        return () => {\n            if (recorder.status() === \"recording\" || recorder.status() === \"paused\") {\n                recorder.cancel();\n            }\n            recorderRef.current = null;\n            setReady(false);\n        };\n    }, [\n        stream,\n        mimeType,\n        videoBitsPerSecond,\n        audioBitsPerSecond,\n        timesliceMs,\n        emitChunk,\n        emitError,\n    ]);\n\n    const stop = useCallback(async (): Promise<VideoRecording | null> => {\n        const recorder = recorderRef.current;\n        if (!recorder) return null;\n        const current = recorder.status();\n        if (current !== \"recording\" && current !== \"paused\") return null;\n        const result = await recorder.stop();\n        setStatus(\"stopped\");\n        setDurationMs(result.durationMs);\n        setRecording(result);\n        emitRecorded(result);\n        return result;\n    }, [emitRecorded]);\n\n    /**\n     * Publish the clock while something is running, and enforce `maxDurationMs`.\n     *\n     * The cap is checked on the same tick rather than with a `setTimeout` armed at\n     * `start()`, because a paused recording must not keep counting toward it — a\n     * timeout would fire while the user is paused on a slide.\n     */\n    useEffect(() => {\n        if (status !== \"recording\" && status !== \"paused\") return;\n        const id = setInterval(() => {\n            const recorder = recorderRef.current;\n            if (!recorder) return;\n            const elapsed = recorder.durationMs();\n            setDurationMs(elapsed);\n            if (maxDurationMs !== undefined && elapsed >= maxDurationMs) void stop();\n        }, tickMs);\n        return () => clearInterval(id);\n    }, [status, tickMs, maxDurationMs, stop]);\n\n    const start = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        setRecording(null);\n        setError(null);\n        setDurationMs(0);\n        recorder.start();\n        setStatus(recorder.status());\n    }, []);\n\n    const pause = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.pause();\n        setDurationMs(recorder.durationMs());\n        setStatus(recorder.status());\n    }, []);\n\n    const resume = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.resume();\n        setStatus(recorder.status());\n    }, []);\n\n    const cancel = useCallback((): void => {\n        const recorder = recorderRef.current;\n        if (!recorder) return;\n        recorder.cancel();\n        setStatus(\"idle\");\n        setDurationMs(0);\n        setRecording(null);\n    }, []);\n\n    return { status, durationMs, recording, error, ready, start, pause, resume, stop, cancel };\n}\n"],"mappings":"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"}

package/dist/capture/video-recorder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"video-recorder.cjs","names":[],"sources":["../../src/capture/video-recorder.ts"],"sourcesContent":["import {\n    createMediaRecorder,\n    pickRecordingMimeType,\n    type MediaRecorderHandle,\n    type MediaRecording,\n} from \"./media-recorder\";\n\n/**\n * Container/codec candidates for video, best first.\n *\n * VP9 in WebM leads because it is the best quality per byte that Chromium and Firefox\n * both encode natively; VP8 is the fallback for older Chromium and for hardware that\n * refuses VP9. `video/mp4` is last and exists for Safari, which produces H.264 in MP4\n * and nothing else — and only since Safari 14.1.\n *\n * Every candidate carries **Opus or AAC audio in the same container**, because a\n * screen recording with the tab's audio dropped is a support ticket, not a\n * simplification. On a stream with no audio track the browser simply omits it.\n *\n * Ported from the intersection of what `MediaRecorder.isTypeSupported` accepts in\n * Chrome 120+, Firefox 115+ and Safari 17. Re-check against\n * <https://developer.mozilla.org/docs/Web/API/MediaRecorder/isTypeSupported> before\n * adding to the list.\n */\nexport const VIDEO_MIME_CANDIDATES: readonly string[] = [\n    \"video/webm;codecs=vp9,opus\",\n    \"video/webm;codecs=vp8,opus\",\n    \"video/webm\",\n    \"video/mp4;codecs=avc1.42E01E,mp4a.40.2\",\n    \"video/mp4\",\n];\n\n/**\n * A finished video recording.\n *\n * Structurally the same three fields as an audio one — there is nothing\n * video-specific to add, and inventing a `width`/`height` here would be a lie: the\n * browser negotiates the frame size with the device and can change it mid-recording.\n * Read it from the track's `getSettings()` if you need it.\n */\nexport type VideoRecording = MediaRecording;\n\n/** Imperative video recorder. Same shape as the audio one. */\nexport type VideoRecorderHandle = MediaRecorderHandle;\n\n/** Options for {@link createVideoRecorder}. */\nexport interface VideoRecorderOptions {\n    /**\n     * Force a container. Throws when the browser cannot produce it.\n     *\n     * Leave it out. The default negotiates from {@link VIDEO_MIME_CANDIDATES}, which\n     * is the only way one call site works on both Chromium and Safari.\n     */\n    mimeType?: string;\n    /**\n     * Target video bitrate.\n     *\n     * The browser's default is conservative and a screen recording of text at\n     * 1080p looks smeared under it. 2_500_000 is a good floor for a UI capture,\n     * 8_000_000 for full-motion camera video.\n     */\n    videoBitsPerSecond?: number;\n    /** Target audio bitrate, when the stream carries audio. 64000–128000 is plenty. */\n    audioBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Worth setting for video far sooner than for audio: a minute of 1080p at\n     * 2.5 Mbps is roughly 19 MB sitting in memory.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (screen share revoked mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Whether `MediaRecorder` exists and can produce at least one video container. */\nexport function isVideoRecordingSupported(): boolean {\n    return typeof MediaRecorder !== \"undefined\" && pickVideoMimeType() !== null;\n}\n\n/**\n * First video container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first. Defaults to {@link VIDEO_MIME_CANDIDATES}.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickVideoMimeType(\n    preferred: readonly string[] = VIDEO_MIME_CANDIDATES,\n): string | null {\n    return pickRecordingMimeType(preferred);\n}\n\n/**\n * Record a video stream — a camera, a screen share, or a `canvas.captureStream()`.\n *\n * The state machine, the clock that subtracts paused time and the `stop()` that\n * resolves in `onstop` with every chunk in hand are shared with the audio recorder\n * (see `createMediaRecorder`); what this adds is the container list and\n * `videoBitsPerSecond`.\n *\n * The stream is **not** owned here. For a screen share in particular, stopping the\n * recorder must not stop the sharing: a support flow usually records, stops, lets the\n * user look at the result and then records again.\n *\n * @param stream - A live stream carrying at least one video track.\n * @param options - See {@link VideoRecorderOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n *\n * @example\n * const recorder = createVideoRecorder(stream, { videoBitsPerSecond: 2_500_000 });\n * recorder.start();\n * const { blob, durationMs } = await recorder.stop();\n */\nexport function createVideoRecorder(\n    stream: MediaStream,\n    options: VideoRecorderOptions = {},\n): VideoRecorderHandle {\n    return createMediaRecorder(stream, {\n        candidates: VIDEO_MIME_CANDIDATES,\n        kind: \"video\",\n        mimeType: options.mimeType,\n        videoBitsPerSecond: options.videoBitsPerSecond,\n        audioBitsPerSecond: options.audioBitsPerSecond,\n        timesliceMs: options.timesliceMs,\n        onChunk: options.onChunk,\n        onError: options.onError,\n    });\n}\n"],"mappings":"wCAwBA,IAAa,EAA2C,CACpD,6BACA,6BACA,aACA,yCACA,WACJ,EAgDA,SAAgB,GAAqC,CACjD,OAAO,OAAO,cAAkB,KAAe,EAAkB,IAAM,IAC3E,CAQA,SAAgB,EACZ,EAA+B,EAClB,CACb,OAAO,EAAA,sBAAsB,CAAS,CAC1C,CAwBA,SAAgB,EACZ,EACA,EAAgC,CAAC,EACd,CACnB,OAAO,EAAA,oBAAoB,EAAQ,CAC/B,WAAY,EACZ,KAAM,QACN,SAAU,EAAQ,SAClB,mBAAoB,EAAQ,mBAC5B,mBAAoB,EAAQ,mBAC5B,YAAa,EAAQ,YACrB,QAAS,EAAQ,QACjB,QAAS,EAAQ,OACrB,CAAC,CACL"}
+{"version":3,"file":"video-recorder.cjs","names":["pickRecordingMimeType","createMediaRecorder","require_media_recorder","VIDEO_MIME_CANDIDATES","isVideoRecordingSupported","pickVideoMimeType","preferred","createVideoRecorder","stream","options"],"sources":["../../src/capture/video-recorder.ts"],"sourcesContent":["import {\n    createMediaRecorder,\n    pickRecordingMimeType,\n    type MediaRecorderHandle,\n    type MediaRecording,\n} from \"./media-recorder\";\n\n/**\n * Container/codec candidates for video, best first.\n *\n * VP9 in WebM leads because it is the best quality per byte that Chromium and Firefox\n * both encode natively; VP8 is the fallback for older Chromium and for hardware that\n * refuses VP9. `video/mp4` is last and exists for Safari, which produces H.264 in MP4\n * and nothing else — and only since Safari 14.1.\n *\n * Every candidate carries **Opus or AAC audio in the same container**, because a\n * screen recording with the tab's audio dropped is a support ticket, not a\n * simplification. On a stream with no audio track the browser simply omits it.\n *\n * Ported from the intersection of what `MediaRecorder.isTypeSupported` accepts in\n * Chrome 120+, Firefox 115+ and Safari 17. Re-check against\n * <https://developer.mozilla.org/docs/Web/API/MediaRecorder/isTypeSupported> before\n * adding to the list.\n */\nexport const VIDEO_MIME_CANDIDATES: readonly string[] = [\n    \"video/webm;codecs=vp9,opus\",\n    \"video/webm;codecs=vp8,opus\",\n    \"video/webm\",\n    \"video/mp4;codecs=avc1.42E01E,mp4a.40.2\",\n    \"video/mp4\",\n];\n\n/**\n * A finished video recording.\n *\n * Structurally the same three fields as an audio one — there is nothing\n * video-specific to add, and inventing a `width`/`height` here would be a lie: the\n * browser negotiates the frame size with the device and can change it mid-recording.\n * Read it from the track's `getSettings()` if you need it.\n */\nexport type VideoRecording = MediaRecording;\n\n/** Imperative video recorder. Same shape as the audio one. */\nexport type VideoRecorderHandle = MediaRecorderHandle;\n\n/** Options for {@link createVideoRecorder}. */\nexport interface VideoRecorderOptions {\n    /**\n     * Force a container. Throws when the browser cannot produce it.\n     *\n     * Leave it out. The default negotiates from {@link VIDEO_MIME_CANDIDATES}, which\n     * is the only way one call site works on both Chromium and Safari.\n     */\n    mimeType?: string;\n    /**\n     * Target video bitrate.\n     *\n     * The browser's default is conservative and a screen recording of text at\n     * 1080p looks smeared under it. 2_500_000 is a good floor for a UI capture,\n     * 8_000_000 for full-motion camera video.\n     */\n    videoBitsPerSecond?: number;\n    /** Target audio bitrate, when the stream carries audio. 64000–128000 is plenty. */\n    audioBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Worth setting for video far sooner than for audio: a minute of 1080p at\n     * 2.5 Mbps is roughly 19 MB sitting in memory.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (screen share revoked mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Whether `MediaRecorder` exists and can produce at least one video container. */\nexport function isVideoRecordingSupported(): boolean {\n    return typeof MediaRecorder !== \"undefined\" && pickVideoMimeType() !== null;\n}\n\n/**\n * First video container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first. Defaults to {@link VIDEO_MIME_CANDIDATES}.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickVideoMimeType(\n    preferred: readonly string[] = VIDEO_MIME_CANDIDATES,\n): string | null {\n    return pickRecordingMimeType(preferred);\n}\n\n/**\n * Record a video stream — a camera, a screen share, or a `canvas.captureStream()`.\n *\n * The state machine, the clock that subtracts paused time and the `stop()` that\n * resolves in `onstop` with every chunk in hand are shared with the audio recorder\n * (see `createMediaRecorder`); what this adds is the container list and\n * `videoBitsPerSecond`.\n *\n * The stream is **not** owned here. For a screen share in particular, stopping the\n * recorder must not stop the sharing: a support flow usually records, stops, lets the\n * user look at the result and then records again.\n *\n * @param stream - A live stream carrying at least one video track.\n * @param options - See {@link VideoRecorderOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n *\n * @example\n * const recorder = createVideoRecorder(stream, { videoBitsPerSecond: 2_500_000 });\n * recorder.start();\n * const { blob, durationMs } = await recorder.stop();\n */\nexport function createVideoRecorder(\n    stream: MediaStream,\n    options: VideoRecorderOptions = {},\n): VideoRecorderHandle {\n    return createMediaRecorder(stream, {\n        candidates: VIDEO_MIME_CANDIDATES,\n        kind: \"video\",\n        mimeType: options.mimeType,\n        videoBitsPerSecond: options.videoBitsPerSecond,\n        audioBitsPerSecond: options.audioBitsPerSecond,\n        timesliceMs: options.timesliceMs,\n        onChunk: options.onChunk,\n        onError: options.onError,\n    });\n}\n"],"mappings":"A,wCAwBA,IAAaG,EAA2C,CACpD,6BACA,6BACA,aACA,yCACA,WACJ,EAgDA,SAAgBC,GAAqC,CACjD,OAAO,OAAO,cAAkB,KAAeC,EAAkB,IAAM,IAC3E,CAQA,SAAgBA,EACZ,EAA+BF,EAClB,CACb,OAAOH,EAAAA,sBAAsBM,CAAS,CAC1C,CAwBA,SAAgBC,EACZ,EACA,EAAgC,CAAC,EACd,CACnB,OAAON,EAAAA,oBAAoBO,EAAQ,CAC/B,WAAYL,EACZ,KAAM,QACN,SAAUM,EAAQ,SAClB,mBAAoBA,EAAQ,mBAC5B,mBAAoBA,EAAQ,mBAC5B,YAAaA,EAAQ,YACrB,QAASA,EAAQ,QACjB,QAASA,EAAQ,OACrB,CAAC,CACL,C"}

package/dist/capture/video-recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"video-recorder.js","names":[],"sources":["../../src/capture/video-recorder.ts"],"sourcesContent":["import {\n    createMediaRecorder,\n    pickRecordingMimeType,\n    type MediaRecorderHandle,\n    type MediaRecording,\n} from \"./media-recorder\";\n\n/**\n * Container/codec candidates for video, best first.\n *\n * VP9 in WebM leads because it is the best quality per byte that Chromium and Firefox\n * both encode natively; VP8 is the fallback for older Chromium and for hardware that\n * refuses VP9. `video/mp4` is last and exists for Safari, which produces H.264 in MP4\n * and nothing else — and only since Safari 14.1.\n *\n * Every candidate carries **Opus or AAC audio in the same container**, because a\n * screen recording with the tab's audio dropped is a support ticket, not a\n * simplification. On a stream with no audio track the browser simply omits it.\n *\n * Ported from the intersection of what `MediaRecorder.isTypeSupported` accepts in\n * Chrome 120+, Firefox 115+ and Safari 17. Re-check against\n * <https://developer.mozilla.org/docs/Web/API/MediaRecorder/isTypeSupported> before\n * adding to the list.\n */\nexport const VIDEO_MIME_CANDIDATES: readonly string[] = [\n    \"video/webm;codecs=vp9,opus\",\n    \"video/webm;codecs=vp8,opus\",\n    \"video/webm\",\n    \"video/mp4;codecs=avc1.42E01E,mp4a.40.2\",\n    \"video/mp4\",\n];\n\n/**\n * A finished video recording.\n *\n * Structurally the same three fields as an audio one — there is nothing\n * video-specific to add, and inventing a `width`/`height` here would be a lie: the\n * browser negotiates the frame size with the device and can change it mid-recording.\n * Read it from the track's `getSettings()` if you need it.\n */\nexport type VideoRecording = MediaRecording;\n\n/** Imperative video recorder. Same shape as the audio one. */\nexport type VideoRecorderHandle = MediaRecorderHandle;\n\n/** Options for {@link createVideoRecorder}. */\nexport interface VideoRecorderOptions {\n    /**\n     * Force a container. Throws when the browser cannot produce it.\n     *\n     * Leave it out. The default negotiates from {@link VIDEO_MIME_CANDIDATES}, which\n     * is the only way one call site works on both Chromium and Safari.\n     */\n    mimeType?: string;\n    /**\n     * Target video bitrate.\n     *\n     * The browser's default is conservative and a screen recording of text at\n     * 1080p looks smeared under it. 2_500_000 is a good floor for a UI capture,\n     * 8_000_000 for full-motion camera video.\n     */\n    videoBitsPerSecond?: number;\n    /** Target audio bitrate, when the stream carries audio. 64000–128000 is plenty. */\n    audioBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Worth setting for video far sooner than for audio: a minute of 1080p at\n     * 2.5 Mbps is roughly 19 MB sitting in memory.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (screen share revoked mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Whether `MediaRecorder` exists and can produce at least one video container. */\nexport function isVideoRecordingSupported(): boolean {\n    return typeof MediaRecorder !== \"undefined\" && pickVideoMimeType() !== null;\n}\n\n/**\n * First video container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first. Defaults to {@link VIDEO_MIME_CANDIDATES}.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickVideoMimeType(\n    preferred: readonly string[] = VIDEO_MIME_CANDIDATES,\n): string | null {\n    return pickRecordingMimeType(preferred);\n}\n\n/**\n * Record a video stream — a camera, a screen share, or a `canvas.captureStream()`.\n *\n * The state machine, the clock that subtracts paused time and the `stop()` that\n * resolves in `onstop` with every chunk in hand are shared with the audio recorder\n * (see `createMediaRecorder`); what this adds is the container list and\n * `videoBitsPerSecond`.\n *\n * The stream is **not** owned here. For a screen share in particular, stopping the\n * recorder must not stop the sharing: a support flow usually records, stops, lets the\n * user look at the result and then records again.\n *\n * @param stream - A live stream carrying at least one video track.\n * @param options - See {@link VideoRecorderOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n *\n * @example\n * const recorder = createVideoRecorder(stream, { videoBitsPerSecond: 2_500_000 });\n * recorder.start();\n * const { blob, durationMs } = await recorder.stop();\n */\nexport function createVideoRecorder(\n    stream: MediaStream,\n    options: VideoRecorderOptions = {},\n): VideoRecorderHandle {\n    return createMediaRecorder(stream, {\n        candidates: VIDEO_MIME_CANDIDATES,\n        kind: \"video\",\n        mimeType: options.mimeType,\n        videoBitsPerSecond: options.videoBitsPerSecond,\n        audioBitsPerSecond: options.audioBitsPerSecond,\n        timesliceMs: options.timesliceMs,\n        onChunk: options.onChunk,\n        onError: options.onError,\n    });\n}\n"],"mappings":";;AAwBA,IAAa,IAA2C;CACpD;CACA;CACA;CACA;CACA;AACJ;AAgDA,SAAgB,IAAqC;CACjD,OAAO,OAAO,gBAAkB,OAAe,EAAkB,MAAM;AAC3E;AAQA,SAAgB,EACZ,IAA+B,GAClB;CACb,OAAO,EAAsB,CAAS;AAC1C;AAwBA,SAAgB,EACZ,GACA,IAAgC,CAAC,GACd;CACnB,OAAO,EAAoB,GAAQ;EAC/B,YAAY;EACZ,MAAM;EACN,UAAU,EAAQ;EAClB,oBAAoB,EAAQ;EAC5B,oBAAoB,EAAQ;EAC5B,aAAa,EAAQ;EACrB,SAAS,EAAQ;EACjB,SAAS,EAAQ;CACrB,CAAC;AACL"}
+{"version":3,"file":"video-recorder.js","names":["VIDEO_MIME_CANDIDATES","isVideoRecordingSupported","pickVideoMimeType","pickRecordingMimeType","preferred","createVideoRecorder","createMediaRecorder","stream","options"],"sources":["../../src/capture/video-recorder.ts"],"sourcesContent":["import {\n    createMediaRecorder,\n    pickRecordingMimeType,\n    type MediaRecorderHandle,\n    type MediaRecording,\n} from \"./media-recorder\";\n\n/**\n * Container/codec candidates for video, best first.\n *\n * VP9 in WebM leads because it is the best quality per byte that Chromium and Firefox\n * both encode natively; VP8 is the fallback for older Chromium and for hardware that\n * refuses VP9. `video/mp4` is last and exists for Safari, which produces H.264 in MP4\n * and nothing else — and only since Safari 14.1.\n *\n * Every candidate carries **Opus or AAC audio in the same container**, because a\n * screen recording with the tab's audio dropped is a support ticket, not a\n * simplification. On a stream with no audio track the browser simply omits it.\n *\n * Ported from the intersection of what `MediaRecorder.isTypeSupported` accepts in\n * Chrome 120+, Firefox 115+ and Safari 17. Re-check against\n * <https://developer.mozilla.org/docs/Web/API/MediaRecorder/isTypeSupported> before\n * adding to the list.\n */\nexport const VIDEO_MIME_CANDIDATES: readonly string[] = [\n    \"video/webm;codecs=vp9,opus\",\n    \"video/webm;codecs=vp8,opus\",\n    \"video/webm\",\n    \"video/mp4;codecs=avc1.42E01E,mp4a.40.2\",\n    \"video/mp4\",\n];\n\n/**\n * A finished video recording.\n *\n * Structurally the same three fields as an audio one — there is nothing\n * video-specific to add, and inventing a `width`/`height` here would be a lie: the\n * browser negotiates the frame size with the device and can change it mid-recording.\n * Read it from the track's `getSettings()` if you need it.\n */\nexport type VideoRecording = MediaRecording;\n\n/** Imperative video recorder. Same shape as the audio one. */\nexport type VideoRecorderHandle = MediaRecorderHandle;\n\n/** Options for {@link createVideoRecorder}. */\nexport interface VideoRecorderOptions {\n    /**\n     * Force a container. Throws when the browser cannot produce it.\n     *\n     * Leave it out. The default negotiates from {@link VIDEO_MIME_CANDIDATES}, which\n     * is the only way one call site works on both Chromium and Safari.\n     */\n    mimeType?: string;\n    /**\n     * Target video bitrate.\n     *\n     * The browser's default is conservative and a screen recording of text at\n     * 1080p looks smeared under it. 2_500_000 is a good floor for a UI capture,\n     * 8_000_000 for full-motion camera video.\n     */\n    videoBitsPerSecond?: number;\n    /** Target audio bitrate, when the stream carries audio. 64000–128000 is plenty. */\n    audioBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Worth setting for video far sooner than for audio: a minute of 1080p at\n     * 2.5 Mbps is roughly 19 MB sitting in memory.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (screen share revoked mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Whether `MediaRecorder` exists and can produce at least one video container. */\nexport function isVideoRecordingSupported(): boolean {\n    return typeof MediaRecorder !== \"undefined\" && pickVideoMimeType() !== null;\n}\n\n/**\n * First video container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first. Defaults to {@link VIDEO_MIME_CANDIDATES}.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickVideoMimeType(\n    preferred: readonly string[] = VIDEO_MIME_CANDIDATES,\n): string | null {\n    return pickRecordingMimeType(preferred);\n}\n\n/**\n * Record a video stream — a camera, a screen share, or a `canvas.captureStream()`.\n *\n * The state machine, the clock that subtracts paused time and the `stop()` that\n * resolves in `onstop` with every chunk in hand are shared with the audio recorder\n * (see `createMediaRecorder`); what this adds is the container list and\n * `videoBitsPerSecond`.\n *\n * The stream is **not** owned here. For a screen share in particular, stopping the\n * recorder must not stop the sharing: a support flow usually records, stops, lets the\n * user look at the result and then records again.\n *\n * @param stream - A live stream carrying at least one video track.\n * @param options - See {@link VideoRecorderOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n *\n * @example\n * const recorder = createVideoRecorder(stream, { videoBitsPerSecond: 2_500_000 });\n * recorder.start();\n * const { blob, durationMs } = await recorder.stop();\n */\nexport function createVideoRecorder(\n    stream: MediaStream,\n    options: VideoRecorderOptions = {},\n): VideoRecorderHandle {\n    return createMediaRecorder(stream, {\n        candidates: VIDEO_MIME_CANDIDATES,\n        kind: \"video\",\n        mimeType: options.mimeType,\n        videoBitsPerSecond: options.videoBitsPerSecond,\n        audioBitsPerSecond: options.audioBitsPerSecond,\n        timesliceMs: options.timesliceMs,\n        onChunk: options.onChunk,\n        onError: options.onError,\n    });\n}\n"],"mappings":";;AAwBA,IAAaA,IAA2C;CACpD;CACA;CACA;CACA;CACA;AACJ;AAgDA,SAAgBC,IAAqC;CACjD,OAAO,OAAO,gBAAkB,OAAeC,EAAkB,MAAM;AAC3E;AAQA,SAAgBA,EACZ,IAA+BF,GAClB;CACb,OAAOG,EAAsBC,CAAS;AAC1C;AAwBA,SAAgBC,EACZ,GACA,IAAgC,CAAC,GACd;CACnB,OAAOC,EAAoBC,GAAQ;EAC/B,YAAYP;EACZ,MAAM;EACN,UAAUQ,EAAQ;EAClB,oBAAoBA,EAAQ;EAC5B,oBAAoBA,EAAQ;EAC5B,aAAaA,EAAQ;EACrB,SAASA,EAAQ;EACjB,SAASA,EAAQ;CACrB,CAAC;AACL"}