@bendyline/squisq-editor-react 2.11.15 → 2.11.17

package/dist/{chunk-34FRFDQ6.js → chunk-XZVMKR5Q.js}

@@ -178,7 +178,9 @@ async function registerPcmWorklet(ctx) {
 
 // src/teleprompter/useMicAnalysis.ts
 import { useCallback, useEffect as useEffect2, useRef, useState } from "react";
-function useMicAnalysis(constraints) {
+function useMicAnalysis(constraints, externalStream) {
+  const externalStreamRef = useRef(externalStream);
+  externalStreamRef.current = externalStream;
   const [status, setStatus] = useState("idle");
   const [error, setError] = useState(null);
   const [devices, setDevices] = useState([]);
@@ -220,7 +222,7 @@ function useMicAnalysis(constraints) {
       graph.sink?.disconnect();
     } catch {
     }
-    for (const track of graph.stream.getTracks()) track.stop();
+    if (graph.ownsStream) for (const track of graph.stream.getTracks()) track.stop();
     void graph.context.close().catch(() => void 0);
   }, []);
   const stop = useCallback(() => {
@@ -238,17 +240,26 @@ function useMicAnalysis(constraints) {
       teardown();
       setStatus("starting");
       setError(null);
+      const ownsStream = externalStreamRef.current === void 0;
+      let acquiredStream = null;
+      let acquiredContext = null;
       try {
+        if (!ownsStream && !externalStreamRef.current?.getAudioTracks().length) {
+          setStatus("idle");
+          return null;
+        }
         const baseConstraints = constraintsRef.current;
-        const micStream = await requestMicStream({
+        const micStream = externalStreamRef.current ?? await requestMicStream({
           ...baseConstraints ?? {},
           ...deviceId ? { deviceId: { exact: deviceId } } : {}
         });
+        acquiredStream = micStream;
         if (generation !== generationRef.current) {
-          for (const track of micStream.getTracks()) track.stop();
+          if (ownsStream) for (const track of micStream.getTracks()) track.stop();
           return null;
         }
         const context = new AudioContext();
+        acquiredContext = context;
         if (context.state === "suspended") {
           await context.resume().catch(() => void 0);
         }
@@ -297,17 +308,19 @@ function useMicAnalysis(constraints) {
           node = processor;
         }
         if (generation !== generationRef.current) {
-          for (const track of micStream.getTracks()) track.stop();
+          if (ownsStream) for (const track of micStream.getTracks()) track.stop();
           void context.close().catch(() => void 0);
           return null;
         }
-        graphRef.current = { stream: micStream, context, source, node, sink };
+        graphRef.current = { stream: micStream, ownsStream, context, source, node, sink };
         setStream(micStream);
         setSampleRate(context.sampleRate);
         setStatus("live");
         void refreshDevices();
         return micStream;
       } catch (err) {
+        if (ownsStream) for (const track of acquiredStream?.getTracks() ?? []) track.stop();
+        if (acquiredContext) void acquiredContext.close().catch(() => void 0);
         if (generation !== generationRef.current) return null;
         setError(err instanceof Error ? err : new Error(String(err)));
         setStatus("error");
@@ -316,6 +329,12 @@ function useMicAnalysis(constraints) {
     },
     [refreshDevices, teardown]
   );
+  useEffect2(() => {
+    if (externalStream === void 0) return;
+    if (externalStream?.getAudioTracks().length) void start(null);
+    else stop();
+    return stop;
+  }, [externalStream, start, stop]);
   const subscribeHop = useCallback((listener) => {
     listenersRef.current.add(listener);
     return () => {
@@ -333,7 +352,17 @@ function useMicAnalysis(constraints) {
       teardown();
     };
   }, [teardown]);
-  return { status, error, stream, sampleRate, devices, start, stop, subscribeHop };
+  return {
+    status,
+    error,
+    stream,
+    sampleRate,
+    devices,
+    sourceManaged: externalStream !== void 0,
+    start,
+    stop,
+    subscribeHop
+  };
 }
 
 // src/teleprompter/types.ts
@@ -465,7 +494,7 @@ function useTeleprompter(opts) {
   const [transport, setTransport] = useState2("stopped");
   const [countdownRemaining, setCountdownRemaining] = useState2(null);
   const [view, setView] = useState2({ wordPos: 0, micLevel: 0, voiceActive: false });
-  const mic = useMicAnalysis(opts.micConstraints);
+  const mic = useMicAnalysis(opts.micConstraints, opts.analysisStream);
   const scriptRef = useRef2(script);
   const prefsRef = useRef2(prefs);
   const transportRef = useRef2(transport);
@@ -1851,7 +1880,11 @@ import { useCallback as useCallback5, useEffect as useEffect6, useMemo as useMem
 import { wordIndexAtTime } from "@bendyline/squisq/narration";
 function useNarrationStage(opts) {
   const { doc, recording = null, getAudioBasename } = opts;
-  const controller = useTeleprompter({ doc, micConstraints: opts.micConstraints });
+  const controller = useTeleprompter({
+    doc,
+    micConstraints: opts.micConstraints,
+    analysisStream: opts.analysisStream
+  });
   const float = useFloatingWindow(TELEPROMPTER_CSS);
   const controllerRef = useRef5(controller);
   controllerRef.current = controller;
@@ -2325,6 +2358,8 @@ function TeleprompterControls({
               {
                 "aria-label": "Microphone",
                 value: prefs.micDeviceId ?? "",
+                disabled: mic.sourceManaged,
+                title: mic.sourceManaged ? "Microphone selected in recording settings" : void 0,
                 onChange: (e) => setPrefs({ micDeviceId: e.target.value || null }),
                 children: [
                   /* @__PURE__ */ jsx2("option", { value: "", children: "Default mic" }),

package/dist/index.d.ts

@@ -26,9 +26,9 @@ import { FenceRendererMap } from '@bendyline/squisq/fence';
 import { TableViewState } from '@bendyline/squisq/table';
 import { EditJournal } from '@bendyline/squisq-grid-react';
 export { JsonEditor, JsonEditorProps } from './json-editor/index.js';
-export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, r as RecorderNarrationOptions, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, x as RecorderSlidesOptions, S as ScreenStreamHandle, y as ScreenStreamOptions, z as SlideTimingSaveResult, T as TimingJson, A as buildRecorderAudioConstraints, B as buildRecorderCameraConstraints, E as buildRecorderScreenAudioConstraints, F as buildRecorderScreenConstraints, G as buildTimingJson, H as encodeTimingJson, I as hasRecorderDeviceChoice, J as recordedMediaKind, K as recorderBitsPerSecond, L as recorderDeviceGroups, N as recorderDeviceOptions, O as requestCameraStream, P as requestMicStream, Q as requestScreenStream, U as timingPathFor, V as useMediaDevices, W as useStreamPreview } from './recorder-CC3VW9Z7.js';
-import { R as RecorderState } from './useNarrationStage-D3Sgcf0L.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, i as RecorderAudioBitrateMode, j as RecorderCameraLane, k as RecorderExtendedMediaOptions, l as RecorderSource, 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-D3Sgcf0L.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, r as RecorderNarrationOptions, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, x as RecorderSlidesOptions, S as ScreenStreamHandle, y as ScreenStreamOptions, z as SlideTimingSaveResult, T as TimingJson, A as buildRecorderAudioConstraints, B as buildRecorderCameraConstraints, E as buildRecorderScreenAudioConstraints, F as buildRecorderScreenConstraints, G as buildTimingJson, H as encodeTimingJson, I as hasRecorderDeviceChoice, J as recordedMediaKind, K as recorderBitsPerSecond, L as recorderDeviceGroups, N as recorderDeviceOptions, O as requestCameraStream, P as requestMicStream, Q as requestScreenStream, U as timingPathFor, V as useMediaDevices, W as useStreamPreview } from './recorder-CRsw0eC7.js';
+import { R as RecorderState } from './useNarrationStage-vKtk6H-V.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, i as RecorderAudioBitrateMode, j as RecorderCameraLane, k as RecorderExtendedMediaOptions, l as RecorderSource, 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-vKtk6H-V.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 { H as HarperProofingConfig, a as ProofingCapability, b as ProofingDocumentRef, c as ProofingIgnoreStore, d as ProofingLanguage, e as ProofingLintOptions, P as ProofingProvider, f as ProofingProviderFactory } from './types-De4z-gGb.js';
 export { createHarperProofingProvider } from './proofing/index.js';
@@ -3303,24 +3303,16 @@ declare function RecorderSlidesPanel({ slides, index, onIndexChange, viewport, b
  * of `narrationModePolicy.ts`, kept DOM/MediaRecorder-free so every branch is
  * unit-testable.
  *
- * Slides mode and narration mode both expand the dialog and both claim its
- * right column, so they are mutually exclusive. That exclusion is STRUCTURAL:
- * the dialog holds one {@link RecorderPanelMode} rather than two booleans, so
- * checking one box cannot leave the other checked. There is deliberately no
- * "are these compatible?" predicate to keep in sync.
+ * Narration and slides are independent optional panels. The combined state
+ * keeps both visible without changing which pipeline owns a take.
  */
 
-/** Which optional panel occupies the dialog's right column. */
-type RecorderPanelMode = 'none' | 'narration' | 'slides';
-/** Whether the dialog should render in its full-viewport two-column form. */
+/** Which optional panels appear beside the capture controls. */
+type RecorderPanelMode = 'none' | 'narration' | 'slides' | 'both';
+/** Whether the dialog should render in its full-viewport form. */
 declare function isExpandedPanel(mode: RecorderPanelMode): boolean;
 /**
- * The mode after toggling one of the two checkboxes. Checking a box selects
- * it (deselecting the other by construction); unchecking returns to 'none'.
- *
- * Unchecking a box that is not the active mode is a no-op rather than a
- * collapse — a stale change event from the box that was just superseded must
- * not close the panel the user actually opened.
+ * Toggle only the requested panel, preserving the other checkbox.
  */
 declare function panelModeAfterToggle(current: RecorderPanelMode, target: 'narration' | 'slides', checked: boolean): RecorderPanelMode;
 /** Clamp a slide index into `[0, count - 1]`, or 0 for an empty deck. */

package/dist/index.js

@@ -219,7 +219,7 @@ import {
   useTreeViewData,
   viewStateFromBinding,
   writeHeadingViewState
-} from "./chunk-7B46MJNW.js";
+} from "./chunk-US5DALTZ.js";
 import {
   EditorProvider,
   detectLanguageFromFileName,
@@ -231,18 +231,18 @@ import {
   spliceBlock,
   useBlockNavigator,
   useEditorContext
-} from "./chunk-DNB32SU2.js";
+} from "./chunk-HTO5MTTJ.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
-} from "./chunk-WDQFWD7Z.js";
+} from "./chunk-UBFNLWCN.js";
 import {
   MarkdownEscape
-} from "./chunk-ZDWZRVAY.js";
+} from "./chunk-2XXBDECJ.js";
 import {
   markdownToTiptap,
   tiptapToMarkdown
-} from "./chunk-EN5BYZOE.js";
+} from "./chunk-DPAMJV6A.js";
 import {
   ImageEditor,
   ImageViewer,
@@ -252,7 +252,7 @@ import {
 } from "./chunk-K4Z2GIX4.js";
 import {
   RecorderButton
-} from "./chunk-DN6XFOY2.js";
+} from "./chunk-EJKGXWNK.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -283,11 +283,11 @@ import {
   unshownSlidesWarning,
   useMediaDevices,
   useMediaRecorder
-} from "./chunk-BJ3TXAIQ.js";
+} from "./chunk-C6QVA6TO.js";
 import "./chunk-GS7QWYFT.js";
 import {
   TeleprompterView
-} from "./chunk-ENDRPV6T.js";
+} from "./chunk-QZWFSSDE.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -327,7 +327,7 @@ import {
   useStreamPreview,
   useTeleprompter,
   vadConfigForSensitivity
-} from "./chunk-34FRFDQ6.js";
+} from "./chunk-XZVMKR5Q.js";
 
 // src/FolderView.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -428,7 +428,7 @@ function ViewSwitcher({ className }) {
           "aria-selected": activeView === view.id,
           className: `squisq-view-tab ${activeView === view.id ? "squisq-view-tab--active" : ""}`,
           onClick: () => setActiveView(view.id),
-          title: `${view.label} (${platformShortcut(view.shortcutKey)})`,
+          title: `${view.label} (${platformShortcut(`Shift+${view.shortcutKey}`)})`,
           children: [
             /* @__PURE__ */ jsx2("span", { className: "squisq-view-tab-label squisq-view-tab-label--long", children: view.label }),
             view.shortLabel && view.shortLabel !== view.label && /* @__PURE__ */ jsx2("span", { className: "squisq-view-tab-label squisq-view-tab-label--short", children: view.shortLabel })

package/dist/json-editor/index.js

@@ -1,8 +1,8 @@
 import {
   JsonEditor
-} from "../chunk-WDQFWD7Z.js";
-import "../chunk-ZDWZRVAY.js";
-import "../chunk-EN5BYZOE.js";
+} from "../chunk-UBFNLWCN.js";
+import "../chunk-2XXBDECJ.js";
+import "../chunk-DPAMJV6A.js";
 export {
   JsonEditor
 };

package/dist/recorder/index.d.ts

@@ -1,5 +1,5 @@
-export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, S as ScreenStreamHandle, y as ScreenStreamOptions, T as TimingJson, A as buildRecorderAudioConstraints, B as buildRecorderCameraConstraints, E as buildRecorderScreenAudioConstraints, F as buildRecorderScreenConstraints, G as buildTimingJson, H as encodeTimingJson, I as hasRecorderDeviceChoice, J as recordedMediaKind, K as recorderBitsPerSecond, L as recorderDeviceGroups, N as recorderDeviceOptions, O as requestCameraStream, P as requestMicStream, Q as requestScreenStream, U as timingPathFor, V as useMediaDevices, W as useStreamPreview } from '../recorder-CC3VW9Z7.js';
-export { a as CaptureKind, i as RecorderAudioBitrateMode, j as RecorderCameraLane, k as RecorderExtendedMediaOptions, l as RecorderSource, R 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-D3Sgcf0L.js';
+export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, S as ScreenStreamHandle, y as ScreenStreamOptions, T as TimingJson, A as buildRecorderAudioConstraints, B as buildRecorderCameraConstraints, E as buildRecorderScreenAudioConstraints, F as buildRecorderScreenConstraints, G as buildTimingJson, H as encodeTimingJson, I as hasRecorderDeviceChoice, J as recordedMediaKind, K as recorderBitsPerSecond, L as recorderDeviceGroups, N as recorderDeviceOptions, O as requestCameraStream, P as requestMicStream, Q as requestScreenStream, U as timingPathFor, V as useMediaDevices, W as useStreamPreview } from '../recorder-CRsw0eC7.js';
+export { a as CaptureKind, i as RecorderAudioBitrateMode, j as RecorderCameraLane, k as RecorderExtendedMediaOptions, l as RecorderSource, R 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-vKtk6H-V.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/storage';

package/dist/recorder/index.js

@@ -1,6 +1,6 @@
 import {
   RecorderButton
-} from "../chunk-DN6XFOY2.js";
+} from "../chunk-EJKGXWNK.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -20,7 +20,7 @@ import {
   requestScreenStream,
   useMediaDevices,
   useMediaRecorder
-} from "../chunk-BJ3TXAIQ.js";
+} from "../chunk-C6QVA6TO.js";
 import "../chunk-GS7QWYFT.js";
 import {
   buildFilename,
@@ -34,7 +34,7 @@ import {
   supportsUserMedia,
   timingPathFor,
   useStreamPreview
-} from "../chunk-34FRFDQ6.js";
+} from "../chunk-XZVMKR5Q.js";
 export {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderButton,

package/dist/{recorder-CC3VW9Z7.d.ts → recorder-CRsw0eC7.d.ts}

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Doc, Theme, ViewportConfig, MediaProvider } from '@bendyline/squisq/schemas';
 import { ContentContainer } from '@bendyline/squisq/storage';
-import { l as RecorderSource, o as TeleprompterRecordingDeps } from './useNarrationStage-D3Sgcf0L.js';
+import { l as RecorderSource, o as TeleprompterRecordingDeps, S as ScreenCaptureRegion } from './useNarrationStage-vKtk6H-V.js';
 import { CSSProperties, RefObject } from 'react';
 
 type RecordedMediaKind = 'audio' | 'video';
@@ -24,17 +24,18 @@ declare function recordedMediaKind(source: RecorderSource, stream: {
 type RecorderColorScheme = 'light' | 'dark';
 /**
  * Everything narration mode needs beyond the base recorder props. Supplying
- * this (with non-null `recording`) surfaces the "Show narration mode"
+ * this (with non-null `doc`) surfaces the "Show narration mode"
  * checkbox; when checked, the dialog expands and mounts the teleprompter
  * beside the capture preview, and mic recording switches to the narration
- * pipeline (voice-aligned v3 timing sidecar + document preamble insertion).
+ * pipeline when `recording` is provided. With null `recording`, the stage
+ * tracks the existing capture audio and the host keeps its save pipeline.
  */
 interface RecorderNarrationOptions {
     /** Parsed document the prompter script is built from. */
     doc: Doc | null;
     /** Theme for the prompter surface (colors/fonts). */
     theme: Theme;
-    /** Editor plumbing for the narration save pipeline; null hides the checkbox. */
+    /** Editor plumbing for aligned narration saves; null keeps the capture recorder and host onSave. */
     recording: TeleprompterRecordingDeps | null;
 }
 /**
@@ -89,7 +90,7 @@ interface RecorderModalProps {
      * markdown reference at the cursor — see {@link RecorderSaveResult}
      * for the fields a host needs to build that reference.
      *
-     * NOT fired for narration-mode saves: the narration pipeline writes its
+     * NOT fired for aligned narration saves (non-null narration.recording): that pipeline writes its
      * own `{[audio …]}` document preamble (via `executeNarrationSave`), so a
      * host insertion here would double up.
      */
@@ -225,6 +226,7 @@ declare function RecorderPanel({ mediaProvider, container, initialMode, colorSch
  * 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;
@@ -249,6 +251,8 @@ interface RecorderCameraDeviceSettings {
     width?: number;
 }
 interface RecorderScreenDeviceSettings {
+    /** Crop in captured pixels, relative to the chosen surface (not the desktop). */
+    crop?: ScreenCaptureRegion;
     aspectRatio?: number;
     cursor?: string;
     displaySurface?: string;
@@ -476,7 +480,9 @@ declare function requestCameraStream(options?: CameraStreamOptions): Promise<Med
  * `AudioContext`, so the resulting `MediaStream` carries a single audio
  * track and a single video track.
  */
+
 interface ScreenStreamOptions {
+    crop?: ScreenCaptureRegion;
     /** Video constraints for the screen surface. Pass `true` for browser default. */
     video?: boolean | MediaTrackConstraints;
     /**

package/dist/review/index.js

@@ -19,8 +19,8 @@ import {
   updateReviewDecorations,
   useReview,
   useReviewState
-} from "../chunk-DNB32SU2.js";
-import "../chunk-EN5BYZOE.js";
+} from "../chunk-HTO5MTTJ.js";
+import "../chunk-DPAMJV6A.js";
 
 // src/review/proofingAdapter.ts
 import {

package/dist/shell/index.js

@@ -5,19 +5,19 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContextMenuItems
-} from "../chunk-7B46MJNW.js";
+} from "../chunk-US5DALTZ.js";
 import {
   EditorProvider,
   useEditorContext
-} from "../chunk-DNB32SU2.js";
+} from "../chunk-HTO5MTTJ.js";
 import "../chunk-V4NBQF5C.js";
-import "../chunk-ZDWZRVAY.js";
-import "../chunk-EN5BYZOE.js";
+import "../chunk-2XXBDECJ.js";
+import "../chunk-DPAMJV6A.js";
 import "../chunk-K4Z2GIX4.js";
-import "../chunk-BJ3TXAIQ.js";
+import "../chunk-C6QVA6TO.js";
 import "../chunk-GS7QWYFT.js";
-import "../chunk-ENDRPV6T.js";
-import "../chunk-34FRFDQ6.js";
+import "../chunk-QZWFSSDE.js";
+import "../chunk-XZVMKR5Q.js";
 export {
   EditorContextMenuProvider,
   EditorProvider,

package/dist/styles/index.css

@@ -8710,35 +8710,6 @@
   height: 100%;
   display: block;
 }
-.squisq-template-gallery-content-preview-fallback {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  width: 100%;
-  height: 100%;
-}
-.squisq-template-gallery-content-preview-fallback > svg {
-  width: 100%;
-  height: 100%;
-  display: block;
-}
-.squisq-template-gallery-content-preview-warning {
-  position: absolute;
-  left: 50%;
-  top: 50%;
-  max-width: calc(100% - 16px);
-  padding: 3px 6px;
-  transform: translate(-50%, -50%);
-  border: 1px solid var(--squisq-template-gallery-preview-warning-border);
-  border-radius: 4px;
-  background: var(--squisq-template-gallery-preview-warning-bg);
-  color: var(--squisq-template-gallery-preview-warning-text);
-  font-size: 10px;
-  font-weight: 600;
-  line-height: 1.2;
-  text-align: center;
-  pointer-events: none;
-}
 .squisq-template-gallery-card-body {
   display: flex;
   flex-direction: column;
@@ -15543,6 +15514,43 @@
 .squisq-image-edit-modal__error {
   color: var(--squisq-danger);
 }
+.squisq-image-placeholder {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  box-sizing: border-box;
+  width: 260px;
+  max-width: 100%;
+  min-height: 80px;
+  padding: 16px;
+  border: 1px dashed var(--squisq-editor-control-border);
+  border-radius: 8px;
+  background: var(--squisq-editor-control-bg);
+  color: var(--squisq-text-muted);
+  font: 500 13px/1.4 var(--squisq-ux-font, system-ui, sans-serif);
+  user-select: none;
+}
+.squisq-image-placeholder svg {
+  flex-shrink: 0;
+}
+.squisq-image-placeholder[data-error=true] {
+  border-style: solid;
+}
+.squisq-image-placeholder__text {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+}
+.squisq-image-placeholder__label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 12px;
+  font-weight: 400;
+}
+.squisq-image-placeholder--thumbnail {
+  width: 100px;
+}
 
 /* src/styles/media-edit.css */
 .squisq-media-edit-modal {

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 { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-D3Sgcf0L.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-D3Sgcf0L.js';
+import { o as TeleprompterRecordingDeps, g as NarrationStageHandle, T as TeleprompterController, c as FloatingWindowHandle } from '../useNarrationStage-vKtk6H-V.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-vKtk6H-V.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-ENDRPV6T.js";
+} from "../chunk-QZWFSSDE.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -31,7 +31,7 @@ import {
   useNarrationStage,
   useTeleprompter,
   vadConfigForSensitivity
-} from "../chunk-34FRFDQ6.js";
+} from "../chunk-XZVMKR5Q.js";
 export {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,

package/dist/{useNarrationStage-D3Sgcf0L.d.ts → useNarrationStage-vKtk6H-V.d.ts}

@@ -57,6 +57,13 @@ declare function supportsDisplayMedia(): boolean;
 type RecordingFilenameSeed = 'audio' | 'camera' | 'camera-audio' | 'screen' | 'screen-audio';
 declare function buildFilename(kind: CaptureKind, extension: string, basename?: string, seed?: RecordingFilenameSeed): string;
 
+interface ScreenCaptureRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
 /**
  * useMediaRecorder
  *
@@ -110,6 +117,8 @@ interface RecorderCameraLane {
     extension: string | null;
 }
 interface UseMediaRecorderOptions {
+    /** Optional crop applied to the screen lane before preview and encoding. */
+    screenRegion?: ScreenCaptureRegion;
     /**
      * Combined byte threshold for automatically stopping every capture lane.
      * Defaults to 90 MiB. Browser chunk delivery can be delayed, so the final
@@ -276,6 +285,8 @@ interface MicAnalysisHandle {
     sampleRate: number | null;
     /** Known audio inputs (labels appear after the first grant). */
     devices: MediaDeviceInfo[];
+    /** The host owns stream/device selection; analysis must never stop its tracks. */
+    sourceManaged?: boolean;
     /**
      * Start (or restart) capture. Resolves with the live stream — callers
      * that need it immediately must use the return value, not the `stream`
@@ -287,7 +298,7 @@ interface MicAnalysisHandle {
     /** Subscribe to PCM hops; returns an unsubscribe. */
     subscribeHop: (listener: PcmHopListener) => () => void;
 }
-declare function useMicAnalysis(constraints?: MediaTrackConstraints): MicAnalysisHandle;
+declare function useMicAnalysis(constraints?: MediaTrackConstraints, externalStream?: MediaStream | null): MicAnalysisHandle;
 
 /**
  * Shared types for the Narrate (teleprompter) display mode.
@@ -384,6 +395,8 @@ declare function vadConfigForSensitivity(sensitivity: number): Partial<VadConfig
 declare function useTeleprompter(opts: {
     doc: Doc | null;
     micConstraints?: MediaTrackConstraints;
+    /** Borrow capture audio instead of opening another microphone; null waits for capture. */
+    analysisStream?: MediaStream | null;
 }): TeleprompterController;
 
 /**
@@ -561,6 +574,8 @@ interface UseNarrationStageOptions {
     getAudioBasename?: () => string | undefined;
     /** Microphone constraints shared by voice analysis and audio recording. */
     micConstraints?: MediaTrackConstraints;
+    /** Optional borrowed capture stream for a prompter-only stage; null means no stream yet. */
+    analysisStream?: MediaStream | null;
     /** Constraints for the optional narration camera lane. */
     cameraConstraints?: MediaTrackConstraints;
     /** Combined narration audio/camera soft stop threshold, in bytes. */
@@ -586,4 +601,4 @@ interface NarrationStageHandle {
 }
 declare function useNarrationStage(opts: UseNarrationStageOptions): NarrationStageHandle;
 
-export { useMediaRecorder as A, useMicAnalysis as B, type CanvasSink as C, DEFAULT_TELEPROMPTER_PREFS as D, useNarrationRecorder as E, type FloatOpenOptions as F, useNarrationStage as G, useTeleprompter as H, vadConfigForSensitivity as I, TELEPROMPTER_PREF_LIMITS as J, normalizeTeleprompterPrefs as K, type MicAnalysisHandle as M, type NarrationRecorderController as N, type PrompterTransport as P, type RecorderState as R, type TeleprompterController as T, type UseMediaRecorderOptions as U, type CaptureKind as a, type FloatTier as b, type FloatingWindowHandle as c, type FloatingWindowManager as d, type MicAnalysisStatus as e, type NarrationRecorderState as f, type NarrationStageHandle as g, type NarrationTake as h, type RecorderAudioBitrateMode as i, type RecorderCameraLane as j, type RecorderExtendedMediaOptions as k, type RecorderSource as l, type ResolvedFormat as m, type TeleprompterPrefs as n, type TeleprompterRecordingDeps as o, type UseMediaRecorderResult as p, type UseNarrationStageOptions as q, buildFilename as r, createFloatingWindowManager as s, detectFloatTiers as t, getCaptureKind as u, resolveFormat as v, supportsDisplayMedia as w, supportsMediaRecorder as x, supportsUserMedia as y, useFloatingWindow as z };
+export { useMediaRecorder as A, useMicAnalysis as B, type CanvasSink as C, DEFAULT_TELEPROMPTER_PREFS as D, useNarrationRecorder as E, type FloatOpenOptions as F, useNarrationStage as G, useTeleprompter as H, vadConfigForSensitivity as I, TELEPROMPTER_PREF_LIMITS as J, normalizeTeleprompterPrefs as K, type MicAnalysisHandle as M, type NarrationRecorderController as N, type PrompterTransport as P, type RecorderState as R, type ScreenCaptureRegion as S, type TeleprompterController as T, type UseMediaRecorderOptions as U, type CaptureKind as a, type FloatTier as b, type FloatingWindowHandle as c, type FloatingWindowManager as d, type MicAnalysisStatus as e, type NarrationRecorderState as f, type NarrationStageHandle as g, type NarrationTake as h, type RecorderAudioBitrateMode as i, type RecorderCameraLane as j, type RecorderExtendedMediaOptions as k, type RecorderSource as l, type ResolvedFormat as m, type TeleprompterPrefs as n, type TeleprompterRecordingDeps as o, type UseMediaRecorderResult as p, type UseNarrationStageOptions as q, buildFilename as r, createFloatingWindowManager as s, detectFloatTiers as t, getCaptureKind as u, resolveFormat as v, supportsDisplayMedia as w, supportsMediaRecorder as x, supportsUserMedia as y, useFloatingWindow as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "2.11.15",
+  "version": "2.11.17",
   "description": "React editor shell with raw/WYSIWYG/preview modes for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -98,12 +98,12 @@
     }
   },
   "dependencies": {
-    "@bendyline/squisq": "2.11.12",
+    "@bendyline/squisq": "2.11.14",
     "@bendyline/squisq-calc": "2.11.1",
-    "@bendyline/squisq-formats": "2.6.12",
-    "@bendyline/squisq-grid-react": "2.11.13",
-    "@bendyline/squisq-react": "2.11.14",
-    "@bendyline/squisq-video-react": "2.4.18",
+    "@bendyline/squisq-formats": "2.6.14",
+    "@bendyline/squisq-grid-react": "2.11.15",
+    "@bendyline/squisq-react": "2.11.16",
+    "@bendyline/squisq-video-react": "2.4.20",
     "@fortawesome/fontawesome-free": "7.2.0",
     "@tiptap/core": "2.27.3",
     "@tiptap/extension-heading": "2.27.3",