@bendyline/squisq-editor-react 2.4.4 → 2.4.6

package/dist/index.d.ts

@@ -22,9 +22,9 @@ import { PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
 import { RenderResult } from 'mermaid';
 export { JsonEditor, JsonEditorProps } from './json-editor/index.js';
-export { C as CameraStreamOptions, a as CaptureKind, R as RecordedBookmark, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraLane, e as RecorderCameraSaveResult, f as RecorderColorScheme, g as RecorderModal, h as RecorderModalProps, i as RecorderNarrationOptions, j as RecorderPanel, k as RecorderPanelProps, l as RecorderSaveResult, m as RecorderSource, n as RecorderState, o as ResolvedFormat, S as ScreenStreamHandle, p as ScreenStreamOptions, T as TimingJson, U as UseMediaRecorderOptions, q as UseMediaRecorderResult, r as buildFilename, s as buildTimingJson, t as encodeTimingJson, u as getCaptureKind, v as requestCameraStream, w as requestMicStream, x as requestScreenStream, y as resolveFormat, z as supportsDisplayMedia, A as supportsMediaRecorder, B as supportsUserMedia, D as timingPathFor, E as useMediaRecorder, F as useStreamPreview } from './recorder-C0Tkyu5W.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, R as RecordedBookmark, a as RecorderAudioDeviceSettings, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraDeviceSettings, e as RecorderCameraSaveResult, f as RecorderColorScheme, g as RecorderConstraintMode, h as RecorderDeviceSettings, i as RecorderDeviceSettingsPanel, j as RecorderDeviceSettingsPanelProps, k as RecorderEncodingSettings, l as RecorderModal, m as RecorderModalProps, n as RecorderNarrationOptions, o as RecorderPanel, p as RecorderPanelProps, q as RecorderSaveResult, r as RecorderScreenAudioSettings, s as RecorderScreenDeviceSettings, S as ScreenStreamHandle, t as ScreenStreamOptions, T as TimingJson, u as buildRecorderAudioConstraints, v as buildRecorderCameraConstraints, w as buildRecorderScreenAudioConstraints, x as buildRecorderScreenConstraints, y as buildTimingJson, z as encodeTimingJson, A as recorderBitsPerSecond, B as requestCameraStream, E as requestMicStream, F as requestScreenStream, G as timingPathFor, H as useStreamPreview } from './recorder-CnOKlYY3.js';
+export { C as CanvasSink, a as CaptureKind, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, b as FloatTier, c as FloatingWindowHandle, d as FloatingWindowManager, M as MicAnalysisHandle, e as MicAnalysisStatus, N as NarrationRecorderController, f as NarrationRecorderState, g as NarrationStageHandle, h as NarrationTake, P as PrompterTransport, R as RecorderAudioBitrateMode, i as RecorderCameraLane, j as RecorderExtendedMediaOptions, k as RecorderSource, l as RecorderState, m as ResolvedFormat, T as TeleprompterController, n as TeleprompterPrefs, o as TeleprompterRecordingDeps, U as UseMediaRecorderOptions, p as UseMediaRecorderResult, q as UseNarrationStageOptions, r as buildFilename, s as createFloatingWindowManager, t as detectFloatTiers, u as getCaptureKind, v as resolveFormat, w as supportsDisplayMedia, x as supportsMediaRecorder, y as supportsUserMedia, z as useFloatingWindow, A as useMediaRecorder, B as useMicAnalysis, E as useNarrationRecorder, G as useNarrationStage, H as useTeleprompter, I as vadConfigForSensitivity } from './useNarrationStage-Bk3mdW75.js';
 export { EYE_LINE_FRACTION, NarrationSavePlan, NarrationSaveResult, NarrationStage, NarrationStageProps, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, TELEPROMPTER_CSS, TeleprompterControls, TeleprompterControlsProps, TeleprompterSurface, TeleprompterSurfaceProps, TeleprompterView, TeleprompterViewProps, TokenLineMap, buildNarrationSavePlan, cameraVideoLine, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor } from './teleprompter/index.js';
-export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, a as FloatTier, b as FloatingWindowHandle, c as FloatingWindowManager, M as MicAnalysisHandle, d as MicAnalysisStatus, N as NarrationRecorderController, e as NarrationRecorderState, f as NarrationStageHandle, g as NarrationTake, P as PrompterTransport, T as TeleprompterController, h as TeleprompterPrefs, i as TeleprompterRecordingDeps, U as UseNarrationStageOptions, j as createFloatingWindowManager, k as detectFloatTiers, u as useFloatingWindow, l as useMicAnalysis, m as useNarrationRecorder, n as useNarrationStage, o as useTeleprompter, v as vadConfigForSensitivity } from './useNarrationStage-Bqo18PBw.js';
 import '@bendyline/squisq/versions';
 import '@bendyline/squisq/imageEdit';
 import '@bendyline/squisq/jsonForm';
@@ -361,10 +361,8 @@ declare function setHeadingAttrsTransition(blockAttrsInner: string | null | unde
  *
  * Line-level markdown rewrites for the timeline editor: set a block's
  * `duration` on its heading's Pandoc attribute block, and patch a media
- * clip's `startAt` / `clipStart` / `clipEnd` / `spillover` on its `{[audio …]}`
- * / `{[video …]}` annotation line. Both preserve everything else on the line
- * (template annotations, ids, classes, other params) by reusing the shared
- * tokenizers rather than regex-replacing values.
+ * clip's timing on either a `{[audio …]}` / `{[video …]}` annotation or the
+ * equivalent standalone HTML element. Rewrites preserve unrelated source.
  */
 
 /** Format a seconds value compactly: integers bare, else up to 2 decimals. */
@@ -396,9 +394,9 @@ interface MediaClipPatch {
     pipPosition?: VideoPipPosition | null;
 }
 /**
- * Patch the `{[audio …]}` / `{[video …]}` annotation at 1-based `line`.
- * Preserves the template name and any params not in the patch. Returns the
- * new full source, or null when the line isn't a media annotation.
+ * Patch a `{[audio …]}` / `{[video …]}` annotation or standalone HTML media
+ * element at 1-based `line`. Preserves unrelated parameters and attributes.
+ * Returns the new full source, or null when the line is not recognized.
  */
 declare function setMediaClipInSource(source: string, line: number, patch: MediaClipPatch): string | null;
 

package/dist/index.js

@@ -194,15 +194,15 @@ import {
   usePreviewSettings,
   useTimelineData,
   useTreeViewData
-} from "./chunk-7OKWPWEQ.js";
+} from "./chunk-55DQFHK5.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
-} from "./chunk-WDX6UDL5.js";
+} from "./chunk-YPRX32GY.js";
 import {
   markdownToTiptap,
   tiptapToMarkdown
-} from "./chunk-WLJ623UZ.js";
+} from "./chunk-K2WJYVS4.js";
 import {
   ImageEditor,
   ImageViewer,
@@ -212,18 +212,25 @@ import {
 } from "./chunk-V44VP242.js";
 import {
   RecorderButton
-} from "./chunk-PEI5EBEN.js";
+} from "./chunk-4F7SN6WU.js";
 import {
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
+  RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
   getCaptureKind,
+  recorderBitsPerSecond,
   requestScreenStream,
   useMediaRecorder
-} from "./chunk-PKGBWNUQ.js";
+} from "./chunk-ZSQN6IO7.js";
 import "./chunk-GS7QWYFT.js";
 import {
   TeleprompterView
-} from "./chunk-V6Z7GG55.js";
+} from "./chunk-IQFPX2CE.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -263,7 +270,7 @@ import {
   useStreamPreview,
   useTeleprompter,
   vadConfigForSensitivity
-} from "./chunk-PDCKJCOS.js";
+} from "./chunk-OWOKKZAU.js";
 
 // src/FolderView.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -700,6 +707,7 @@ export {
   CustomTemplateProvider,
   CustomThemeProvider,
   DEFAULT_MERMAID_DIAGRAM_TYPE,
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
   DEFAULT_TELEPROMPTER_PREFS,
   DiagramCanvas,
   DocumentSettingsDialog,
@@ -740,6 +748,7 @@ export {
   REPAIRABLE_KEY,
   RawEditor,
   RecorderButton,
+  RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
   RepairableDiagramExtension,
@@ -782,6 +791,10 @@ export {
   buildFilename,
   buildNarrationSavePlan,
   buildPreviewDoc,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
   buildTimingJson,
   cameraVideoLine,
   classifyFile,
@@ -852,6 +865,7 @@ export {
   readBlockAttrsTransition,
   readBlockAttrsValue,
   readHeadingLineTransition,
+  recorderBitsPerSecond,
   registerPcmWorklet,
   removeEdgeOp,
   removeItemOp,

package/dist/json-editor/index.js

@@ -1,7 +1,7 @@
 import {
   JsonEditor
-} from "../chunk-WDX6UDL5.js";
-import "../chunk-WLJ623UZ.js";
+} from "../chunk-YPRX32GY.js";
+import "../chunk-K2WJYVS4.js";
 export {
   JsonEditor
 };

package/dist/recorder/index.d.ts

@@ -1,7 +1,7 @@
-export { C as CameraStreamOptions, a as CaptureKind, R as RecordedBookmark, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraLane, e as RecorderCameraSaveResult, f as RecorderColorScheme, g as RecorderModal, h as RecorderModalProps, j as RecorderPanel, k as RecorderPanelProps, l as RecorderSaveResult, m as RecorderSource, n as RecorderState, o as ResolvedFormat, S as ScreenStreamHandle, p as ScreenStreamOptions, T as TimingJson, U as UseMediaRecorderOptions, q as UseMediaRecorderResult, r as buildFilename, s as buildTimingJson, t as encodeTimingJson, u as getCaptureKind, v as requestCameraStream, w as requestMicStream, x as requestScreenStream, y as resolveFormat, z as supportsDisplayMedia, A as supportsMediaRecorder, B as supportsUserMedia, D as timingPathFor, E as useMediaRecorder, F as useStreamPreview } from '../recorder-C0Tkyu5W.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, R as RecordedBookmark, a as RecorderAudioDeviceSettings, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraDeviceSettings, e as RecorderCameraSaveResult, f as RecorderColorScheme, g as RecorderConstraintMode, h as RecorderDeviceSettings, i as RecorderDeviceSettingsPanel, j as RecorderDeviceSettingsPanelProps, k as RecorderEncodingSettings, l as RecorderModal, m as RecorderModalProps, o as RecorderPanel, p as RecorderPanelProps, q as RecorderSaveResult, r as RecorderScreenAudioSettings, s as RecorderScreenDeviceSettings, S as ScreenStreamHandle, t as ScreenStreamOptions, T as TimingJson, u as buildRecorderAudioConstraints, v as buildRecorderCameraConstraints, w as buildRecorderScreenAudioConstraints, x as buildRecorderScreenConstraints, y as buildTimingJson, z as encodeTimingJson, A as recorderBitsPerSecond, B as requestCameraStream, E as requestMicStream, F as requestScreenStream, G as timingPathFor, H as useStreamPreview } from '../recorder-CnOKlYY3.js';
+export { a as CaptureKind, R as RecorderAudioBitrateMode, i as RecorderCameraLane, j as RecorderExtendedMediaOptions, k as RecorderSource, l as RecorderState, m as ResolvedFormat, U as UseMediaRecorderOptions, p as UseMediaRecorderResult, r as buildFilename, u as getCaptureKind, v as resolveFormat, w as supportsDisplayMedia, x as supportsMediaRecorder, y as supportsUserMedia, A as useMediaRecorder } from '../useNarrationStage-Bk3mdW75.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/storage';
-import '../useNarrationStage-Bqo18PBw.js';
 import 'react';
 import '@bendyline/squisq/narration';

package/dist/recorder/index.js

@@ -1,13 +1,20 @@
 import {
   RecorderButton
-} from "../chunk-PEI5EBEN.js";
+} from "../chunk-4F7SN6WU.js";
 import {
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
+  RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
   getCaptureKind,
+  recorderBitsPerSecond,
   requestScreenStream,
   useMediaRecorder
-} from "../chunk-PKGBWNUQ.js";
+} from "../chunk-ZSQN6IO7.js";
 import "../chunk-GS7QWYFT.js";
 import {
   buildFilename,
@@ -21,15 +28,22 @@ import {
   supportsUserMedia,
   timingPathFor,
   useStreamPreview
-} from "../chunk-PDCKJCOS.js";
+} from "../chunk-OWOKKZAU.js";
 export {
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderButton,
+  RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
   buildFilename,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
   buildTimingJson,
   encodeTimingJson,
   getCaptureKind,
+  recorderBitsPerSecond,
   requestCameraStream,
   requestMicStream,
   requestScreenStream,

package/dist/{recorder-C0Tkyu5W.d.ts → recorder-CnOKlYY3.d.ts}

@@ -1,209 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, Theme, MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { i as TeleprompterRecordingDeps } from './useNarrationStage-Bqo18PBw.js';
+import { k as RecorderSource, o as TeleprompterRecordingDeps } from './useNarrationStage-Bk3mdW75.js';
 import { CSSProperties, RefObject } from 'react';
 
-/**
- * Format probing for MediaRecorder.
- *
- * Different browsers expose different container/codec combinations. Chrome
- * and Firefox produce WebM (VP8/VP9 + Opus); Safari produces MP4 (H.264 +
- * AAC). We probe at runtime via `MediaRecorder.isTypeSupported()` and pick
- * the best supported option, falling back to whatever the browser hands
- * back when no probe succeeds.
- */
-/** What the recorded stream is intended to capture. */
-type CaptureKind = 'audio' | 'video';
-/** A probed format choice — what to pass to `MediaRecorder` and where to write it. */
-interface ResolvedFormat {
-    /** MIME type to pass to `new MediaRecorder(stream, { mimeType })`. Empty string means "let the browser pick". */
-    mimeType: string;
-    /** File extension to use when writing to the container, including the leading dot. */
-    extension: string;
-    /** Container directory inside the `ContentContainer` (no trailing slash). */
-    directory: 'audio' | 'video';
-}
-/**
- * Resolve the format the recorder will use for a given capture kind. If a
- * `preferred` MIME type is supported, it wins; otherwise we fall through
- * the priority list. When nothing matches (extremely old browser), we
- * return an empty `mimeType` — `MediaRecorder` will pick a default and we
- * tag the file with `.webm` as a best guess.
- */
-declare function resolveFormat(kind: CaptureKind, preferred?: string): ResolvedFormat;
-/**
- * `MediaRecorder` support probe. Returns false when running in a
- * non-browser environment (e.g. SSR) or on a browser that doesn't
- * implement the API at all.
- */
-declare function supportsMediaRecorder(): boolean;
-/**
- * `getUserMedia` support probe (for mic / camera capture).
- */
-declare function supportsUserMedia(): boolean;
-/**
- * `getDisplayMedia` support probe (for screen capture). Browsers may
- * implement `mediaDevices` without `getDisplayMedia` (Firefox on Android
- * being the long-standing example), so this is its own probe.
- */
-declare function supportsDisplayMedia(): boolean;
-/**
- * Build a default filename for a recording. `basename` is a hint
- * (e.g. user-typed name); when omitted, a sortable timestamp is used so
- * concurrent recordings don't collide. General recorder callers can supply a
- * source-aware `seed`; dedicated narration callers omit it and retain the
- * historical `narration-*` default.
- */
-type RecordingFilenameSeed = 'audio' | 'camera' | 'camera-audio' | 'screen' | 'screen-audio';
-declare function buildFilename(kind: CaptureKind, extension: string, basename?: string, seed?: RecordingFilenameSeed): string;
-
-/**
- * useMediaRecorder
- *
- * React wrapper around `MediaRecorder` that handles stream acquisition,
- * the recorder lifecycle, and produces a single `Blob` on stop. Selects
- * a browser-supported MIME type via {@link resolveFormat}.
- *
- * Mirrors the shape of `useVideoExport` in `@bendyline/squisq-video-react`
- * (request → start → stop → blob), inverted for capture rather than
- * export.
- *
- * The `'screen+camera'` source is the one exception to "one stream, one
- * blob": it drives TWO `MediaRecorder`s in lockstep (screen + system audio
- * on the primary lane, camera + mic on a secondary lane), because a single
- * recorder can only hold one video track. The secondary lane surfaces as
- * {@link UseMediaRecorderResult.camera}; every other source leaves it null.
- * The two lanes' start skew is measured (`cameraOffsetSec`) so the composed
- * playback can line the presenter bubble up with the screen.
- */
-
-/**
- * Which capture source to use. `screen+mic` mixes the microphone into the
- * screen stream (one file); `screen+camera` records screen and camera as two
- * separate files in lockstep.
- */
-type RecorderSource = 'mic' | 'camera' | 'screen' | 'screen+mic' | 'screen+camera';
-/** Discriminated state describing what the recorder is currently doing. */
-type RecorderState = 'idle' | 'requesting' | 'ready' | 'recording' | 'stopping' | 'stopped' | 'error';
-/**
- * The camera companion lane, present only for `source === 'screen+camera'`
- * (null for every other source). Its `blob` is null until the take stops.
- */
-interface RecorderCameraLane {
-    /** Camera stream (video + mic when requested); inactive after stop, null after teardown. */
-    stream: MediaStream | null;
-    /** Final camera `Blob` after `stop()` resolves, or null while recording. */
-    blob: Blob | null;
-    /** MIME type of the camera lane (shares the video format with the screen lane). */
-    mimeType: string | null;
-    /** File extension matching `mimeType` (e.g. `.webm`). */
-    extension: string | null;
-}
-interface UseMediaRecorderOptions {
-    /** Which capture pipeline to use (default: `'mic'`). */
-    source?: RecorderSource;
-    /**
-     * Preferred MIME type override. When the browser supports it, this
-     * wins over the default candidate list. When unset (or unsupported),
-     * the hook probes a built-in priority list.
-     */
-    mimeType?: string;
-    /** Video track constraints for camera / screen sources. */
-    videoConstraints?: MediaTrackConstraints | boolean;
-    /** Audio track constraints for mic / camera / screen+mic sources. */
-    audioConstraints?: MediaTrackConstraints | boolean;
-    /**
-     * Bits-per-second hint passed to `MediaRecorder`. Most browsers cap to
-     * reasonable defaults internally; leaving this undefined is usually
-     * fine.
-     */
-    bitsPerSecond?: number;
-    /**
-     * Whether to capture system (tab/monitor) audio. Browser support is limited
-     * (desktop Chromium only); when unsupported the resulting stream simply omits
-     * it. How it is obtained depends on the source:
-     * - `'screen'` / `'screen+mic'` / `'screen+camera'` — folded into the screen
-     *   lane's `getDisplayMedia` (rides the SCREEN file for the dual source).
-     * - `'mic'` / `'camera'` — captured via a SEPARATE `getDisplayMedia` whose
-     *   video is discarded, then mixed into the mic/camera file. The browser still
-     *   shows the screen/tab picker (audio-only display capture isn't allowed).
-     */
-    systemAudio?: boolean;
-    /**
-     * For `source === 'camera'`, whether to include the microphone track.
-     * Defaults to `true` (camera + mic). Set `false` to capture silent
-     * video. Ignored for `'mic'`/`'screen'`/`'screen+mic'`, whose mic
-     * handling is encoded in the source itself. For `'screen+camera'` this
-     * gates the microphone on the CAMERA lane (the screen lane never carries
-     * the mic — system audio rides it instead).
-     */
-    includeMicrophone?: boolean;
-}
-interface UseMediaRecorderResult {
-    /** Current recorder state. */
-    state: RecorderState;
-    /** `MediaStream` acquired by `request()`; live during preview/recording and
-     * inactive after stop. For `'screen+camera'` this is the SCREEN stream (see
-     * `camera` for the other). */
-    stream: MediaStream | null;
-    /** Final `Blob` after `stop()` resolves, or `null` while recording. For
-     * `'screen+camera'` this is the SCREEN file. */
-    blob: Blob | null;
-    /** MIME type the recorder actually used (after `request()`). */
-    mimeType: string | null;
-    /** File extension matching `mimeType` (e.g. `.webm`). */
-    extension: string | null;
-    /** Suggested container directory (`'audio'` for mic, `'video'` for camera/screen). */
-    directory: 'audio' | 'video' | null;
-    /** Milliseconds elapsed since `start()` was called. Updates ~10× per second while recording. */
-    durationMs: number;
-    /** Most recent error, if any. */
-    error: Error | null;
-    /**
-     * The camera companion lane for `source === 'screen+camera'`, else null.
-     * Its `blob` lands together with the primary `blob` when `stop()` resolves.
-     */
-    camera: RecorderCameraLane | null;
-    /**
-     * Camera onstart minus screen onstart, in seconds (positive = camera
-     * started later). Null until both lanes have reported `onstart`, and for
-     * every non-dual source.
-     */
-    cameraOffsetSec: number | null;
-    /**
-     * Acquire the stream and prepare a `MediaRecorder`. After this resolves
-     * the hook is in `'ready'` state and a `<video>`/`<audio>` element can
-     * preview `stream`. Call `start()` to begin recording.
-     */
-    request: () => Promise<void>;
-    /** Start recording. Must be called from `'ready'`. */
-    start: () => void;
-    /**
-     * Stop recording and resolve with the resulting `Blob`. Safe to call
-     * from `'recording'`; a no-op from any other state (resolves with the
-     * existing `blob`, or `null`). Once the take has flushed, all capture
-     * tracks are stopped so browser sharing / camera / microphone indicators
-     * do not remain active during review.
-     */
-    stop: () => Promise<Blob | null>;
-    /**
-     * Tear everything down — stops the recorder if running, releases all
-     * tracks, disposes the AudioContext mixer (if any), and returns to
-     * `'idle'`. Always safe to call.
-     */
-    cancel: () => void;
-    /** Clear the current take. A new permission request may be needed before re-recording. */
-    reset: () => void;
-}
-/**
- * Returns the kind of capture that the given source produces. Exposed
- * separately from {@link useMediaRecorder} so non-React callers
- * (e.g. headless tests) can resolve a format up front.
- */
-declare function getCaptureKind(source: RecorderSource): CaptureKind;
-declare function useMediaRecorder(options?: UseMediaRecorderOptions): UseMediaRecorderResult;
-
 type RecorderColorScheme = 'light' | 'dark';
 /**
  * Everything narration mode needs beyond the base recorder props. Supplying
@@ -335,6 +135,98 @@ interface RecorderPanelProps {
 }
 declare function RecorderPanel({ mediaProvider, container, initialMode, colorScheme, onSave, narration, tooltip, className, open: controlledOpen, onOpenChange, showTrigger, }: RecorderPanelProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * User-configurable recorder device/encoding settings.
+ *
+ * Values stay serializable so the modal can include them in its capture key:
+ * changing a setting releases any prepared preview before a new stream is
+ * requested. Numeric and string track values are expressed as either `ideal`
+ * (best effort) or `exact` (fail when unavailable) constraints. Display
+ * capture is the exception: the screen-capture standard rejects exact
+ * constraints during its user picker, so those values always remain ideal.
+ */
+type RecorderConstraintMode = 'ideal' | 'exact';
+interface RecorderAudioDeviceSettings {
+    deviceId: string;
+    groupId?: string;
+    autoGainControl?: boolean;
+    channelCount?: number;
+    echoCancellation?: boolean;
+    latency?: number;
+    noiseSuppression?: boolean;
+    sampleRate?: number;
+    sampleSize?: number;
+}
+interface RecorderCameraDeviceSettings {
+    deviceId: string;
+    groupId?: string;
+    aspectRatio?: number;
+    backgroundBlur?: boolean;
+    facingMode?: string;
+    frameRate?: number;
+    height?: number;
+    resizeMode?: string;
+    width?: number;
+}
+interface RecorderScreenDeviceSettings {
+    aspectRatio?: number;
+    cursor?: string;
+    displaySurface?: string;
+    frameRate?: number;
+    height?: number;
+    logicalSurface?: boolean;
+    resizeMode?: string;
+    width?: number;
+}
+interface RecorderScreenAudioSettings {
+    restrictOwnAudio?: boolean;
+    suppressLocalAudioPlayback?: boolean;
+}
+interface RecorderEncodingSettings {
+    audioMimeType: string;
+    videoMimeType: string;
+    bitsPerSecond?: number;
+    audioBitsPerSecond?: number;
+    videoBitsPerSecond?: number;
+    audioBitrateMode?: 'constant' | 'variable';
+    videoKeyFrameIntervalDuration?: number;
+    videoKeyFrameIntervalCount?: number;
+}
+interface RecorderDeviceSettings {
+    constraintMode: RecorderConstraintMode;
+    audio: RecorderAudioDeviceSettings;
+    camera: RecorderCameraDeviceSettings;
+    screen: RecorderScreenDeviceSettings;
+    screenAudio: RecorderScreenAudioSettings;
+    encoding: RecorderEncodingSettings;
+}
+declare const DEFAULT_RECORDER_DEVICE_SETTINGS: RecorderDeviceSettings;
+/** Build microphone constraints from the advanced settings form. */
+declare function buildRecorderAudioConstraints(settings: RecorderDeviceSettings): MediaTrackConstraints;
+/** Build camera constraints from the advanced settings form. */
+declare function buildRecorderCameraConstraints(settings: RecorderDeviceSettings): MediaTrackConstraints;
+/** Build display-capture constraints independently from camera constraints. */
+declare function buildRecorderScreenConstraints(settings: RecorderDeviceSettings): MediaTrackConstraints;
+/** Build the audio-track constraints specific to getDisplayMedia. */
+declare function buildRecorderScreenAudioConstraints(settings: RecorderDeviceSettings): MediaTrackConstraints;
+/** Convert the form's kbps values to the bps values MediaRecorder expects. */
+declare function recorderBitsPerSecond(value: number | undefined): number | undefined;
+
+interface RecorderDeviceSettingsPanelProps {
+    value: RecorderDeviceSettings;
+    onChange: (next: RecorderDeviceSettings) => void;
+    disabled?: boolean;
+    microphoneEnabled: boolean;
+    cameraEnabled: boolean;
+    screenEnabled: boolean;
+    systemAudioEnabled?: boolean;
+    /** Narration records mic audio separately even when its camera is on. */
+    separateAudioRecorder?: boolean;
+    primaryStream?: MediaStream | null;
+    cameraStream?: MediaStream | null;
+}
+declare function RecorderDeviceSettingsPanel({ value, onChange, disabled, microphoneEnabled, cameraEnabled, screenEnabled, systemAudioEnabled, separateAudioRecorder, primaryStream, cameraStream, }: RecorderDeviceSettingsPanelProps): react_jsx_runtime.JSX.Element;
+
 /**
  * useStreamPreview — binds a `MediaStream` to a `<video>` element's
  * `srcObject`. Decouples the preview surface from `useMediaRecorder`,
@@ -415,6 +307,8 @@ interface ScreenStreamOptions {
      * the system audio track.
      */
     systemAudio?: boolean;
+    /** Constraints for the display stream's system-audio track. */
+    systemAudioConstraints?: MediaTrackConstraints;
     /**
      * Whether to also pull the microphone via `getUserMedia` and mix it
      * into the resulting stream's audio track. When both `systemAudio` and
@@ -505,4 +399,4 @@ declare function encodeTimingJson(timing: TimingJson): Uint8Array;
  */
 declare function timingPathFor(audioRelativePath: string): string;
 
-export { supportsMediaRecorder as A, supportsUserMedia as B, type CameraStreamOptions as C, timingPathFor as D, useMediaRecorder as E, useStreamPreview as F, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, type UseMediaRecorderOptions as U, type CaptureKind as a, RecorderButton as b, type RecorderButtonProps as c, type RecorderCameraLane as d, type RecorderCameraSaveResult as e, type RecorderColorScheme as f, RecorderModal as g, type RecorderModalProps as h, type RecorderNarrationOptions as i, RecorderPanel as j, type RecorderPanelProps as k, type RecorderSaveResult as l, type RecorderSource as m, type RecorderState as n, type ResolvedFormat as o, type ScreenStreamOptions as p, type UseMediaRecorderResult as q, buildFilename as r, buildTimingJson as s, encodeTimingJson as t, getCaptureKind as u, requestCameraStream as v, requestMicStream as w, requestScreenStream as x, resolveFormat as y, supportsDisplayMedia as z };
+export { recorderBitsPerSecond as A, requestCameraStream as B, type CameraStreamOptions as C, DEFAULT_RECORDER_DEVICE_SETTINGS as D, requestMicStream as E, requestScreenStream as F, timingPathFor as G, useStreamPreview as H, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, type RecorderAudioDeviceSettings as a, RecorderButton as b, type RecorderButtonProps as c, type RecorderCameraDeviceSettings as d, type RecorderCameraSaveResult as e, type RecorderColorScheme as f, type RecorderConstraintMode as g, type RecorderDeviceSettings as h, RecorderDeviceSettingsPanel as i, type RecorderDeviceSettingsPanelProps as j, type RecorderEncodingSettings as k, RecorderModal as l, type RecorderModalProps as m, type RecorderNarrationOptions as n, RecorderPanel as o, type RecorderPanelProps as p, type RecorderSaveResult as q, type RecorderScreenAudioSettings as r, type RecorderScreenDeviceSettings as s, type ScreenStreamOptions as t, buildRecorderAudioConstraints as u, buildRecorderCameraConstraints as v, buildRecorderScreenAudioConstraints as w, buildRecorderScreenConstraints as x, buildTimingJson as y, encodeTimingJson as z };

package/dist/shell/index.js

@@ -5,14 +5,14 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContext
-} from "../chunk-7OKWPWEQ.js";
+} from "../chunk-55DQFHK5.js";
 import "../chunk-V4NBQF5C.js";
-import "../chunk-WLJ623UZ.js";
+import "../chunk-K2WJYVS4.js";
 import "../chunk-V44VP242.js";
-import "../chunk-PKGBWNUQ.js";
+import "../chunk-ZSQN6IO7.js";
 import "../chunk-GS7QWYFT.js";
-import "../chunk-V6Z7GG55.js";
-import "../chunk-PDCKJCOS.js";
+import "../chunk-IQFPX2CE.js";
+import "../chunk-OWOKKZAU.js";
 export {
   EditorProvider,
   EditorShell,

package/dist/teleprompter/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, Theme, MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { i as TeleprompterRecordingDeps, f as NarrationStageHandle, T as TeleprompterController, b as FloatingWindowHandle } from '../useNarrationStage-Bqo18PBw.js';
-export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, a as FloatTier, c as FloatingWindowManager, M as MicAnalysisHandle, d as MicAnalysisStatus, N as NarrationRecorderController, e as NarrationRecorderState, g as NarrationTake, P as PrompterTransport, p as TELEPROMPTER_PREF_LIMITS, h as TeleprompterPrefs, U as UseNarrationStageOptions, j as createFloatingWindowManager, k as detectFloatTiers, q as normalizeTeleprompterPrefs, u as useFloatingWindow, l as useMicAnalysis, m as useNarrationRecorder, n as useNarrationStage, o as useTeleprompter, v as vadConfigForSensitivity } from '../useNarrationStage-Bqo18PBw.js';
+import { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-Bk3mdW75.js';
+export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, b as FloatTier, d as FloatingWindowManager, M as MicAnalysisHandle, e as MicAnalysisStatus, N as NarrationRecorderController, f as NarrationRecorderState, h as NarrationTake, P as PrompterTransport, J as TELEPROMPTER_PREF_LIMITS, n as TeleprompterPrefs, q as UseNarrationStageOptions, s as createFloatingWindowManager, t as detectFloatTiers, K as normalizeTeleprompterPrefs, z as useFloatingWindow, B as useMicAnalysis, E as useNarrationRecorder, G as useNarrationStage, H as useTeleprompter, I as vadConfigForSensitivity } from '../useNarrationStage-Bk3mdW75.js';
 import { NarrationTimingJsonV3, NarrationScript, NarrationAlignment } from '@bendyline/squisq/narration';
 import { ReactNode } from 'react';
 

package/dist/teleprompter/index.js

@@ -1,6 +1,6 @@
 import {
   TeleprompterView
-} from "../chunk-V6Z7GG55.js";
+} from "../chunk-IQFPX2CE.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -31,7 +31,7 @@ import {
   useNarrationStage,
   useTeleprompter,
   vadConfigForSensitivity
-} from "../chunk-PDCKJCOS.js";
+} from "../chunk-OWOKKZAU.js";
 export {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,