@bendyline/squisq-editor-react 2.11.16 → 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-C6ArYQBa.js';
-import { R as RecorderState } from './useNarrationStage-DopDr_P5.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-DopDr_P5.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-5TYCTE33.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-27WOOJXR.js";
+} from "./chunk-EJKGXWNK.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -283,11 +283,11 @@ import {
   unshownSlidesWarning,
   useMediaDevices,
   useMediaRecorder
-} from "./chunk-4D7QMRTZ.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-C6ArYQBa.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-DopDr_P5.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-27WOOJXR.js";
+} from "../chunk-EJKGXWNK.js";
 import {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
@@ -20,7 +20,7 @@ import {
   requestScreenStream,
   useMediaDevices,
   useMediaRecorder
-} from "../chunk-4D7QMRTZ.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-C6ArYQBa.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, S as ScreenCaptureRegion } from './useNarrationStage-DopDr_P5.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.
      */

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-5TYCTE33.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-4D7QMRTZ.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-DopDr_P5.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-DopDr_P5.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-DopDr_P5.d.ts → useNarrationStage-vKtk6H-V.d.ts}

@@ -285,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`
@@ -296,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.
@@ -393,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;
 
 /**
@@ -570,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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-editor-react",
-  "version": "2.11.16",
+  "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.13",
+    "@bendyline/squisq": "2.11.14",
     "@bendyline/squisq-calc": "2.11.1",
-    "@bendyline/squisq-formats": "2.6.13",
-    "@bendyline/squisq-grid-react": "2.11.14",
-    "@bendyline/squisq-react": "2.11.15",
-    "@bendyline/squisq-video-react": "2.4.19",
+    "@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",