@bendyline/squisq-editor-react 2.11.19 → 2.11.20

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   PROOF_FRONTMATTER_KEYS,
   createHarperProofingProvider
 } from "./chunk-SAKLIEOX.js";
+import "./chunk-2MP7QE7O.js";
 import {
   configureMonacoWorkers
 } from "./chunk-BWPFPHWY.js";
@@ -87,7 +88,10 @@ import {
   TransitionPicker,
   TreeOutlineWidget,
   TreeViewExtension,
+  VIDEO_EMBED_KEY,
   VersionHistoryPanel,
+  VideoEmbedDialog,
+  VideoEmbedExtension,
   ViewMenuPanel,
   WysiwygEditor,
   XLSX_LOCKED_REASON,
@@ -107,6 +111,7 @@ import {
   codeSnippetMarkdown,
   compileDraft,
   containFenceWidgetEvents,
+  convertVideoEmbedToLink,
   createXlsxFormulaSession,
   dataExtensionOf,
   dataLinkHrefOf,
@@ -121,11 +126,13 @@ import {
   findTimelineBlockPos,
   findTransitionEntry,
   findTreeBlockPos,
+  findVideoEmbedBlockPos,
   formatSeconds,
   getTimelineForNode,
   indentItemOp,
   ingestForWrite,
   ingestSidecarBytes,
+  insertVideoEmbedReference,
   inspectMermaidSource,
   isAsciiSourceVisible,
   isCodeSnippetFenceLanguage,
@@ -152,6 +159,7 @@ import {
   outdentItemOp,
   parseTimelineForNode,
   partitionFiles,
+  pasteVideoEmbedCode,
   persistFromWrite,
   platformShortcut,
   preloadMonaco,
@@ -219,9 +227,12 @@ import {
   useTimelineData,
   useTreeViewData,
   validateMermaidSource,
+  videoEmbedMarkdown,
+  videoEmbedOfParagraph,
+  videoEmbedParagraphJson,
   viewStateFromBinding,
   writeHeadingViewState
-} from "./chunk-5EB3BGPE.js";
+} from "./chunk-NL4JP55H.js";
 import {
   EditorProvider,
   applySourceEditsToText,
@@ -240,8 +251,9 @@ import {
   sourceOutline,
   spliceBlock,
   useBlockNavigator,
-  useEditorContext
-} from "./chunk-TZX7RKZV.js";
+  useEditorContext,
+  useEditorInsertMenuItems
+} from "./chunk-JI74KA6C.js";
 import {
   SPEECH_INPUT_SAMPLE_RATE,
   isSpeechInputProviderFactory,
@@ -867,7 +879,10 @@ export {
   TransitionPicker,
   TreeOutlineWidget,
   TreeViewExtension,
+  VIDEO_EMBED_KEY,
   VersionHistoryPanel,
+  VideoEmbedDialog,
+  VideoEmbedExtension,
   ViewMenuPanel,
   ViewSwitcher,
   WysiwygEditor,
@@ -901,6 +916,7 @@ export {
   codeSnippetMarkdown,
   configureMonacoWorkers,
   containFenceWidgetEvents,
+  convertVideoEmbedToLink,
   createFloatingWindowManager,
   createHarperProofingProvider,
   createXlsxFormulaSession,
@@ -923,6 +939,7 @@ export {
   findTimelineBlockPos,
   findTransitionEntry,
   findTreeBlockPos,
+  findVideoEmbedBlockPos,
   formatSeconds,
   getBlockSlices,
   getCaptureKind,
@@ -935,6 +952,7 @@ export {
   ingestSidecarBytes,
   initialImageEditorState,
   insertNarrationPreamble,
+  insertVideoEmbedReference,
   inspectMermaidSource,
   isAsciiSourceVisible,
   isCodeSnippetFenceLanguage,
@@ -972,6 +990,7 @@ export {
   panelModeAfterToggle,
   parseTimelineForNode,
   partitionFiles,
+  pasteVideoEmbedCode,
   persistFromWrite,
   preloadMonaco,
   preloadMonacoSuggestions,
@@ -1056,6 +1075,7 @@ export {
   useDocCustomThemes,
   useEditorContext,
   useEditorContextMenuItems,
+  useEditorInsertMenuItems,
   useFileDrop,
   useFloatingWindow,
   useImageEditor,
@@ -1075,6 +1095,9 @@ export {
   useTreeViewData,
   vadConfigForSensitivity,
   validateMermaidSource,
+  videoEmbedMarkdown,
+  videoEmbedOfParagraph,
+  videoEmbedParagraphJson,
   viewStateFromBinding,
   writeHeadingViewState
 };

package/dist/recorder/index.d.ts

@@ -1,7 +1,9 @@
-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-DKN3vZPi.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-CB8dynUg.js';
+export { C as CameraStreamOptions, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraSaveResult, e as RecorderColorScheme, f as RecorderDeviceOption, g as RecorderDeviceQuickPicks, h as RecorderDeviceQuickPicksProps, i as RecorderDeviceSettingsPanel, j as RecorderDeviceSettingsPanelProps, k as RecorderModal, l as RecorderModalProps, n as RecorderPanel, o as RecorderPanelProps, p as RecorderSaveResult, S as ScreenStreamHandle, r as ScreenStreamOptions, T as TimingJson, t as buildTimingJson, u as encodeTimingJson, v as hasRecorderDeviceChoice, w as recordedMediaKind, x as recorderDeviceGroups, y as recorderDeviceOptions, z as requestCameraStream, A as requestMicStream, B as requestScreenStream, D as timingPathFor, E as useMediaDevices, F as useStreamPreview } from '../recorder-Civyq5SU.js';
+export { D as DEFAULT_RECORDER_DEVICE_SETTINGS, a as RecorderAudioDeviceSettings, b as RecorderCameraDeviceSettings, c as RecorderConstraintMode, R as RecorderDeviceSettings, d as RecorderEncodingSettings, e as RecorderScreenAudioSettings, f as RecorderScreenDeviceSettings, g as buildRecorderAudioConstraints, h as buildRecorderCameraConstraints, i as buildRecorderScreenAudioConstraints, j as buildRecorderScreenConstraints, r as recorderBitsPerSecond } from '../deviceSettings-BSkIQncC.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-DlighI1z.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/storage';
 import 'react';
+import '../screenRegion-Ci_RsCzG.js';
 import '@bendyline/squisq/narration';

package/dist/{recorder-DKN3vZPi.d.ts → recorder-Civyq5SU.d.ts}

@@ -1,8 +1,10 @@
 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-CB8dynUg.js';
+import { l as RecorderSource, o as TeleprompterRecordingDeps } from './useNarrationStage-DlighI1z.js';
 import { CSSProperties, RefObject } from 'react';
+import { R as RecorderDeviceSettings } from './deviceSettings-BSkIQncC.js';
+import { S as ScreenCaptureRegion } from './screenRegion-Ci_RsCzG.js';
 
 type RecordedMediaKind = 'audio' | 'video';
 /**
@@ -216,86 +218,6 @@ interface RecorderPanelProps {
 }
 declare function RecorderPanel({ mediaProvider, container, initialMode, colorScheme, onSave, narration, slides, tooltip, title, 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 {
-    /** Crop in captured pixels, relative to the chosen surface (not the desktop). */
-    crop?: ScreenCaptureRegion;
-    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;
@@ -585,4 +507,4 @@ declare function encodeTimingJson(timing: TimingJson): Uint8Array;
  */
 declare function timingPathFor(audioRelativePath: string): string;
 
-export { buildRecorderAudioConstraints as A, buildRecorderCameraConstraints as B, type CameraStreamOptions as C, DEFAULT_RECORDER_DEVICE_SETTINGS as D, buildRecorderScreenAudioConstraints as E, buildRecorderScreenConstraints as F, buildTimingJson as G, encodeTimingJson as H, hasRecorderDeviceChoice as I, recordedMediaKind as J, recorderBitsPerSecond as K, recorderDeviceGroups as L, type MediaDeviceInventory as M, recorderDeviceOptions as N, requestCameraStream as O, requestMicStream as P, requestScreenStream as Q, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, timingPathFor as U, useMediaDevices as V, useStreamPreview as W, type RecordedMediaKind as a, type RecorderAudioDeviceSettings as b, RecorderButton as c, type RecorderButtonProps as d, type RecorderCameraDeviceSettings as e, type RecorderCameraSaveResult as f, type RecorderColorScheme as g, type RecorderConstraintMode as h, type RecorderDeviceOption as i, RecorderDeviceQuickPicks as j, type RecorderDeviceQuickPicksProps as k, type RecorderDeviceSettings as l, RecorderDeviceSettingsPanel as m, type RecorderDeviceSettingsPanelProps as n, type RecorderEncodingSettings as o, RecorderModal as p, type RecorderModalProps as q, type RecorderNarrationOptions as r, RecorderPanel as s, type RecorderPanelProps as t, type RecorderSaveResult as u, type RecorderScreenAudioSettings as v, type RecorderScreenDeviceSettings as w, type RecorderSlidesOptions as x, type ScreenStreamOptions as y, type SlideTimingSaveResult as z };
+export { requestMicStream as A, requestScreenStream as B, type CameraStreamOptions as C, timingPathFor as D, useMediaDevices as E, useStreamPreview as F, type MediaDeviceInventory as M, type RecordedBookmark as R, type ScreenStreamHandle as S, type TimingJson as T, type RecordedMediaKind as a, RecorderButton as b, type RecorderButtonProps as c, type RecorderCameraSaveResult as d, type RecorderColorScheme as e, type RecorderDeviceOption as f, RecorderDeviceQuickPicks as g, type RecorderDeviceQuickPicksProps as h, RecorderDeviceSettingsPanel as i, type RecorderDeviceSettingsPanelProps as j, RecorderModal as k, type RecorderModalProps as l, type RecorderNarrationOptions as m, RecorderPanel as n, type RecorderPanelProps as o, type RecorderSaveResult as p, type RecorderSlidesOptions as q, type ScreenStreamOptions as r, type SlideTimingSaveResult as s, buildTimingJson as t, encodeTimingJson as u, hasRecorderDeviceChoice as v, recordedMediaKind as w, recorderDeviceGroups as x, recorderDeviceOptions as y, requestCameraStream as z };

package/dist/review/index.js

@@ -19,7 +19,7 @@ import {
   updateReviewDecorations,
   useReview,
   useReviewState
-} from "../chunk-TZX7RKZV.js";
+} from "../chunk-JI74KA6C.js";
 import "../chunk-DNEVUOBZ.js";
 import "../chunk-HSWWEWT4.js";
 

package/dist/screenRegion-Ci_RsCzG.d.ts

@@ -0,0 +1,8 @@
+interface ScreenCaptureRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+
+export type { ScreenCaptureRegion as S };

package/dist/shell/index.d.ts

@@ -1,4 +1,4 @@
-export { g as BlockTagVisibility, j as DocumentLinkCandidate, k as DocumentLinkProvider, l as EditorActions, m as EditorColorScheme, n as EditorContextMenuContext, o as EditorContextMenuItem, p as EditorContextMenuItemVisibility, q as EditorContextMenuProvider, r as EditorContextMenuProviderProps, s as EditorContextValue, E as EditorHostMode, t as EditorMode, u as EditorProvider, v as EditorProviderProps, x as EditorShell, y as EditorShellProps, z as EditorState, G as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, N as MentionProvider, Q as PreviewPanel, R as PreviewPanelProps, T as RawEditor, U as RawEditorProps, V as ThemeInheritance, W as ViewPreferences, Z as WysiwygEditor, _ as WysiwygEditorProps, ag as useEditorContext, ah as useEditorContextMenuItems } from '../shell-Cje1A3zN.js';
+export { h as BlockTagVisibility, k as DocumentLinkCandidate, l as DocumentLinkProvider, m as EditorActions, n as EditorColorScheme, o as EditorContextMenuContext, p as EditorContextMenuItem, q as EditorContextMenuItemVisibility, r as EditorContextMenuProvider, s as EditorContextMenuProviderProps, t as EditorContextValue, E as EditorHostMode, u as EditorInsertMenuItem, v as EditorMode, w as EditorProvider, x as EditorProviderProps, z as EditorShell, G as EditorShellProps, H as EditorState, b as EditorView, J as ImageDisplayMode, M as LayoutMode, N as MentionCandidate, O as MentionProvider, R as PreviewPanel, T as PreviewPanelProps, U as RawEditor, V as RawEditorProps, W as ThemeInheritance, Y as ViewPreferences, _ as WysiwygEditor, $ as WysiwygEditorProps, ah as useEditorContext, ai as useEditorContextMenuItems, aj as useEditorInsertMenuItems } from '../shell-DTefmCBG.js';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/table';
 import '@bendyline/squisq-calc';
@@ -12,7 +12,7 @@ import '@bendyline/squisq/markdown';
 import '@bendyline/squisq/storage';
 import '../types-De4z-gGb.js';
 import '@bendyline/squisq/proof';
-import '../speech/index.js';
+import '../types-Bi4ZVKvN.js';
 import '@bendyline/squisq/versions';
 import '@tiptap/core';
 import 'monaco-editor';

package/dist/shell/index.js

@@ -5,11 +5,12 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContextMenuItems
-} from "../chunk-5EB3BGPE.js";
+} from "../chunk-NL4JP55H.js";
 import {
   EditorProvider,
-  useEditorContext
-} from "../chunk-TZX7RKZV.js";
+  useEditorContext,
+  useEditorInsertMenuItems
+} from "../chunk-JI74KA6C.js";
 import "../chunk-DNEVUOBZ.js";
 import "../chunk-V4NBQF5C.js";
 import "../chunk-OCQEWWHI.js";
@@ -29,5 +30,6 @@ export {
   RawEditor,
   WysiwygEditor,
   useEditorContext,
-  useEditorContextMenuItems
+  useEditorContextMenuItems,
+  useEditorInsertMenuItems
 };

package/dist/{shell-Cje1A3zN.d.ts → shell-DTefmCBG.d.ts}

@@ -10,7 +10,7 @@ import { CodeBlockCopyHandler } from '@bendyline/squisq-react';
 import { MarkdownSourceEdit, MarkdownDocument } from '@bendyline/squisq/markdown';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { a as ProofingCapability, c as ProofingIgnoreStore } from './types-De4z-gGb.js';
-import { DictationControl, SpeechInputCapability } from './speech/index.js';
+import { D as DictationControl, b as SpeechInputCapability } from './types-Bi4ZVKvN.js';
 import { DocumentVersionManager, SaveVersionOptions, SaveVersionResult, PrunePolicy } from '@bendyline/squisq/versions';
 import { Editor } from '@tiptap/core';
 import { editor } from 'monaco-editor';
@@ -410,6 +410,8 @@ interface EditorSelectionInfo {
     view: EditorView;
     /** The selected text, empty when the selection is a bare cursor. */
     text: string;
+    /** Selected Markdown, preserving formatting and block metadata when available. */
+    markdown?: string;
     /** True when the selection is a bare cursor rather than a range. */
     empty: boolean;
 }
@@ -1693,12 +1695,31 @@ interface EditorShellProps {
      * in-progress theme without mutating the document.
      */
     themeOverride?: Theme | null;
+    /**
+     * Host default document theme — a FALLBACK for documents whose frontmatter
+     * names no theme (`squisq-theme`, legacy `themeId` / `theme`). A document's
+     * own theme always wins; built-in and custom-theme ids are accepted. Every
+     * surface (Use/Play, inline and block previews, the Write view's
+     * `themeInheritance` mirroring) renders the same resolved theme.
+     *
+     * While set, the theme pickers offer a "Default (<theme name>)" entry that
+     * removes the document's theme key, and choosing any concrete theme —
+     * `standard` included — writes it explicitly so the document stays pinned.
+     * Unlike {@link themeOverride}, this never overrides the document.
+     */
+    defaultThemeId?: string;
+    /**
+     * Label for the picker entry that follows {@link defaultThemeId}, rendered
+     * as `"<label> (<theme name>)"` — e.g. `'Workspace default'`. Defaults to
+     * `'Default'`.
+     */
+    defaultThemeLabel?: string;
 }
 /**
  * Complete markdown editor shell with toolbar, view switcher, and three
  * editing modes: Raw (Monaco), WYSIWYG (Tiptap), and Preview.
  */
-declare function EditorShell({ initialMarkdown, initialView, hostMode, defaultViewportPreset, articleId, basePath, onChange, onLinkClick, showCodeCopyButton, onCopyCode, colorScheme, className, height, minHeight, maxHeight, mediaProvider, mediaEditRenders, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, showFilesToggle, showFilesWhenNotEmpty, showFormattingControls, showInsertControls, allowBinaryDownloads, toolbarSlotLeft, toolbarSlotAfterActions, toolbarSlotRight, statusBarSlotRight, sidePanelSlot, reviewProviders, showPlayTab, allowPresentationWindow, allowPresentationFullscreen, allowPrint, submitOnEnter, calcEngineFactory, codeContext, fullWidth, uxFont, thinMargins, writeCanvasSettings, showStatusBar, imageDisplayMode, fileName, saveCoverImageOutput, saveDashboardImageOutput, language, findMode, onFindModeChange, mentionProvider, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, speechInput, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, placeholder, readOnly, imageSrc, imageAlt, imageMode, imageEditorContainer, onImageExport, inlinePreview, inlinePreviewWidth, outline, outlineWidth, blockTags, blockTagVisibility, themeInheritance, viewPreferences, onViewPreferencesChange, themeOverride, }: EditorShellProps): react_jsx_runtime.JSX.Element;
+declare function EditorShell({ initialMarkdown, initialView, hostMode, defaultViewportPreset, articleId, basePath, onChange, onLinkClick, showCodeCopyButton, onCopyCode, colorScheme, className, height, minHeight, maxHeight, mediaProvider, mediaEditRenders, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, showFilesToggle, showFilesWhenNotEmpty, showFormattingControls, showInsertControls, allowBinaryDownloads, toolbarSlotLeft, toolbarSlotAfterActions, toolbarSlotRight, statusBarSlotRight, sidePanelSlot, reviewProviders, showPlayTab, allowPresentationWindow, allowPresentationFullscreen, allowPrint, submitOnEnter, calcEngineFactory, codeContext, fullWidth, uxFont, thinMargins, writeCanvasSettings, showStatusBar, imageDisplayMode, fileName, saveCoverImageOutput, saveDashboardImageOutput, language, findMode, onFindModeChange, mentionProvider, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, speechInput, documentLinkProvider, fenceRenderers, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, placeholder, readOnly, imageSrc, imageAlt, imageMode, imageEditorContainer, onImageExport, inlinePreview, inlinePreviewWidth, outline, outlineWidth, blockTags, blockTagVisibility, themeInheritance, viewPreferences, onViewPreferencesChange, themeOverride, defaultThemeId, defaultThemeLabel, }: EditorShellProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Shared editor context menu.
@@ -1848,4 +1869,14 @@ interface PreviewPanelProps {
  */
 declare function PreviewPanel({ basePath, className, workspaceContainer, onLinkClick, showCodeCopyButton, onCopyCode, }: PreviewPanelProps): react_jsx_runtime.JSX.Element;
 
-export { XLSX_LOCKED_REASON as $, type ApplySourceEditsOptions as A, type BlockInsertionBuilder as B, type CodeContext as C, type DashboardImageSaveOutput as D, type EditorHostMode as E, type FormulaEditRecord as F, type EditorView as G, type FormulaSessionOptions as H, type ImageDisplayMode as I, type IngestedSidecar as J, type InsertBlockOptions as K, type LayoutMode as L, type MentionCandidate as M, type MentionProvider as N, type OutlineBlock as O, type OutlineInsertion as P, PreviewPanel as Q, type PreviewPanelProps as R, type SceneTextChannel as S, RawEditor as T, type RawEditorProps as U, type ThemeInheritance as V, type ViewPreferences as W, type XlsxSourceMeta as X, type WriteCanvasSettings as Y, WysiwygEditor as Z, type WysiwygEditorProps as _, type CalcEngineFactory as a, type XlsxFormulaSession as a0, applySourceEditsToText as a1, blockInsertionPoint as a2, createXlsxFormulaSession as a3, getBlockSlices as a4, headingDepthForInsertion as a5, ingestSidecarBytes as a6, joinBlockAt as a7, lineToOffset as a8, minimalReplaceEdit as a9, normalizeSourceEdits as aa, offsetToLine as ab, resolveOutlineInsertion as ac, sliceIndexAtOffset as ad, sourceOutline as ae, spliceBlock as af, useEditorContext as ag, useEditorContextMenuItems as ah, type CsvSourceMeta as b, type BlockInsertionContext as c, type BlockPlacement as d, type BlockRange as e, type BlockSlice as f, type BlockTagVisibility as g, type CodeContextSection as h, type CoverImageSaveOutput as i, type DocumentLinkCandidate as j, type DocumentLinkProvider as k, type EditorActions as l, type EditorColorScheme as m, type EditorContextMenuContext as n, type EditorContextMenuItem as o, type EditorContextMenuItemVisibility as p, EditorContextMenuProvider as q, type EditorContextMenuProviderProps as r, type EditorContextValue as s, type EditorMode as t, EditorProvider as u, type EditorProviderProps as v, type EditorSelectionInfo as w, EditorShell as x, type EditorShellProps as y, type EditorState as z };
+interface EditorInsertMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    disabled?: boolean;
+    onSelect: () => void;
+}
+/** Call from a toolbar slot; callbacks retain access to the editor context. */
+declare function useEditorInsertMenuItems(items: readonly EditorInsertMenuItem[]): void;
+
+export { type WysiwygEditorProps as $, type ApplySourceEditsOptions as A, type BlockInsertionBuilder as B, type CodeContext as C, type DashboardImageSaveOutput as D, type EditorHostMode as E, type FormulaEditRecord as F, type EditorShellProps as G, type EditorState as H, type FormulaSessionOptions as I, type ImageDisplayMode as J, type IngestedSidecar as K, type InsertBlockOptions as L, type LayoutMode as M, type MentionCandidate as N, type MentionProvider as O, type OutlineBlock as P, type OutlineInsertion as Q, PreviewPanel as R, type SceneTextChannel as S, type PreviewPanelProps as T, RawEditor as U, type RawEditorProps as V, type ThemeInheritance as W, type XlsxSourceMeta as X, type ViewPreferences as Y, type WriteCanvasSettings as Z, WysiwygEditor as _, type CalcEngineFactory as a, XLSX_LOCKED_REASON as a0, type XlsxFormulaSession as a1, applySourceEditsToText as a2, blockInsertionPoint as a3, createXlsxFormulaSession as a4, getBlockSlices as a5, headingDepthForInsertion as a6, ingestSidecarBytes as a7, joinBlockAt as a8, lineToOffset as a9, minimalReplaceEdit as aa, normalizeSourceEdits as ab, offsetToLine as ac, resolveOutlineInsertion as ad, sliceIndexAtOffset as ae, sourceOutline as af, spliceBlock as ag, useEditorContext as ah, useEditorContextMenuItems as ai, useEditorInsertMenuItems as aj, type EditorView as b, type CsvSourceMeta as c, type BlockInsertionContext as d, type BlockPlacement as e, type BlockRange as f, type BlockSlice as g, type BlockTagVisibility as h, type CodeContextSection as i, type CoverImageSaveOutput as j, type DocumentLinkCandidate as k, type DocumentLinkProvider as l, type EditorActions as m, type EditorColorScheme as n, type EditorContextMenuContext as o, type EditorContextMenuItem as p, type EditorContextMenuItemVisibility as q, EditorContextMenuProvider as r, type EditorContextMenuProviderProps as s, type EditorContextValue as t, type EditorInsertMenuItem as u, type EditorMode as v, EditorProvider as w, type EditorProviderProps as x, type EditorSelectionInfo as y, EditorShell as z };

package/dist/speech/index.d.ts

@@ -1,126 +1,43 @@
+import { R as RecorderDeviceSettings } from '../deviceSettings-BSkIQncC.js';
+import { S as SpeechInputProvider } from '../types-Bi4ZVKvN.js';
+export { D as DictationControl, a as SPEECH_INPUT_SAMPLE_RATE, b as SpeechInputCapability, c as SpeechInputProviderFactory, d as SpeechInputReadiness, e as SpeechInputReadinessState, f as SpeechInputTranscribeOptions, g as SpeechInputTranscript, i as isSpeechInputProviderFactory, r as resolveSpeechInputProvider } from '../types-Bi4ZVKvN.js';
+import '../screenRegion-Ci_RsCzG.js';
+
 /**
- * The speech-input (dictation) capability contract between an editor host and
- * the shell.
- *
- * A host that can turn speech into text passes a {@link SpeechInputProvider}
- * (or a factory) to `EditorShell`'s `speechInput` prop — the same
- * capability-injection semantics as `proofing`: absent means the feature is
- * off, no dictation code loads, and no microphone button renders.
+ * One dictation session: microphone → progressive takes → 16 kHz WAV → the
+ * host's provider → transcript callbacks.
  *
- * The editor owns everything up to the recognizer: microphone capture, phrase
- * segmentation, WAV encoding, the toolbar button, the caret indicator and the
- * literal-text insertion. The provider owns only recognition. Audio crosses
- * the boundary as one self-contained mono 16-bit PCM WAV at 16 kHz per take,
- * which every whisper.cpp build accepts and which keeps IPC payloads small.
- * The surface is plain data end to end, so a provider can be a local engine
- * behind IPC, a call to a service, or a test fake.
- */
-/** Sample rate (Hz) of every WAV take handed to {@link SpeechInputProvider.transcribe}. */
-declare const SPEECH_INPUT_SAMPLE_RATE = 16000;
-/** Coarse readiness of a provider, as the editor's button presents it. */
-type SpeechInputReadinessState = 
-/** Dictation can start now. */
-'ready'
-/**
- * The host needs a one-time setup (typically a model download) first.
- * Clicking the microphone calls {@link SpeechInputProvider.requestSetup}
- * instead of starting.
+ * This module (with the engine, the activity gate and the WAV encoder it pulls
+ * in) is only ever reached through a dynamic `import()` from the dictation
+ * controller, so a shell without a `speechInput` capability loads none of it.
  */
- | 'download-required'
-/** Dictation can never work in this host/session. The button is hidden. */
- | 'unavailable'
-/**
- * The host still needs a permission (e.g. the OS microphone grant).
- * Starting proceeds — the microphone request is what prompts for it.
- */
- | 'permission-required';
-interface SpeechInputReadiness {
-    readonly state: SpeechInputReadinessState;
-    /** Optional human-readable detail, shown in the button's tooltip/errors. */
-    readonly reason?: string;
-}
-interface SpeechInputTranscribeOptions {
-    /**
-     * The recent dictated text of this session (a word-aligned tail of at most
-     * 1,000 characters), for engines that accept a priming prompt — Whisper's
-     * `prompt`. Absent on the first take.
-     */
-    readonly prompt?: string;
-    /** BCP-47-ish language hint. The editor does not currently set it. */
-    readonly language?: string;
+
+interface DictationSessionOptions {
+    provider: SpeechInputProvider;
+    /** Aborted when the controller cancels the session (or unmounts). */
+    signal: AbortSignal;
     /**
-     * Aborted when the user cancels dictation or the editor unmounts. A
-     * provider should stop promptly; a rejection after abort is ignored.
+     * Recorder device settings to honour (the chosen microphone and its
+     * constraints). Echo cancellation, noise suppression and auto gain are
+     * always on for dictation regardless.
      */
-    readonly signal: AbortSignal;
+    deviceSettings?: RecorderDeviceSettings;
+    onTranscript: (text: string) => void;
+    onAudioLevel: (level: number) => void;
+    onPendingChange: (pending: number) => void;
+    onLongPause: (hadTranscript: boolean) => void;
+    onError: (error: Error) => void;
 }
-interface SpeechInputTranscript {
-    /** Recognized text. Blank (or Whisper's `[BLANK_AUDIO]`) means silence. */
-    readonly text: string;
-}
-interface SpeechInputProvider {
-    /** Stable identifier, e.g. `whisper-local`. */
-    readonly id: string;
-    /** Human-readable name, e.g. `On-device speech recognition`. */
-    readonly label: string;
-    /**
-     * Current readiness. Called once when the editor mounts with the
-     * capability (to decide whether to render the microphone at all) and again
-     * each time the user starts dictation. Must be cheap.
-     */
-    status(): Promise<SpeechInputReadiness>;
-    /** Optional readiness push (e.g. a model finished downloading). Returns unsubscribe. */
-    onStatus?(listener: (readiness: SpeechInputReadiness) => void): () => void;
-    /** Called when the user starts dictation so the host can warm its engine; may reject. */
-    prepare?(signal: AbortSignal): Promise<void>;
-    /** Called when the user clicks the mic while readiness is 'download-required'; the host shows its own setup UI. */
-    requestSetup?(): void;
-    /** Transcribe one self-contained take: mono 16-bit PCM WAV at 16 kHz. */
-    transcribe(wav: ArrayBuffer, options: SpeechInputTranscribeOptions): Promise<SpeechInputTranscript>;
-    /** Release resources. Called by the editor only for a provider it created from a factory. */
-    dispose?(): void;
-}
-/**
- * Deferred construction. The shell creates the provider when it mounts with
- * the capability (it needs `status()` to decide whether to render the
- * microphone) and disposes it on unmount or when the capability changes. A
- * host that passes an instance owns its lifetime — which is what lets one warm
- * engine survive shell remounts.
- */
-type SpeechInputProviderFactory = () => SpeechInputProvider;
-/** What the `speechInput` shell prop accepts. */
-type SpeechInputCapability = SpeechInputProvider | SpeechInputProviderFactory;
-/**
- * Resolve a capability to a provider instance. A factory is invoked (and the
- * caller then owns — must dispose — what it returns); an instance is returned
- * as-is and stays host-owned.
- */
-declare function resolveSpeechInputProvider(capability: SpeechInputCapability): SpeechInputProvider;
-/**
- * Whether a capability is a factory, i.e. whether the provider resolved from
- * it is owned (and must be disposed) by the resolver's caller.
- */
-declare function isSpeechInputProviderFactory(capability: SpeechInputCapability): capability is SpeechInputProviderFactory;
-/**
- * Imperative dictation control on the editor context
- * (`useEditorContext().dictation`), for a host component rendered inside the
- * shell's slots — e.g. to drive dictation from a native menu command. `null`
- * when the host injected no `speechInput` capability.
- */
-interface DictationControl {
-    /** True from the moment dictation starts until its last take is inserted. */
-    readonly active: boolean;
-    /**
-     * True when `toggle()` would do something: the provider is not
-     * `unavailable` and a text-editing view (Write or Source) is showing.
-     */
-    readonly available: boolean;
-    /**
-     * Start dictation when idle (or ask the host to set up when readiness is
-     * `download-required`); finish and stop when listening; cancel while the
-     * microphone is still starting.
-     */
-    toggle(): void;
+interface DictationSessionHandle {
+    /** Stop listening, transcribe and deliver every captured take, then resolve. */
+    stop(): Promise<void>;
+    /** Drop everything immediately — no further callbacks. */
+    cancel(): void;
 }
 
-export { type DictationControl, SPEECH_INPUT_SAMPLE_RATE, type SpeechInputCapability, type SpeechInputProvider, type SpeechInputProviderFactory, type SpeechInputReadiness, type SpeechInputReadinessState, type SpeechInputTranscribeOptions, type SpeechInputTranscript, isSpeechInputProviderFactory, resolveSpeechInputProvider };
+/** Capture into a host-owned transcript without editing the document. Loaded only on a gesture. */
+declare function startDictationSession(options: DictationSessionOptions): Promise<DictationSessionHandle>;
+/** Encode an uploaded audio take using the same wire format as microphone capture. */
+declare function encodeMonoPcm16Wav(channels: readonly Float32Array[], sampleRate: number): Promise<Uint8Array<ArrayBuffer>>;
+
+export { type DictationSessionHandle, type DictationSessionOptions, SpeechInputProvider, encodeMonoPcm16Wav, startDictationSession };

package/dist/speech/index.js

@@ -1,3 +1,7 @@
+import {
+  encodeMonoPcm16Wav,
+  startDictationSession
+} from "../chunk-2MP7QE7O.js";
 import {
   SPEECH_INPUT_SAMPLE_RATE,
   isSpeechInputProviderFactory,
@@ -5,6 +9,8 @@ import {
 } from "../chunk-DNEVUOBZ.js";
 export {
   SPEECH_INPUT_SAMPLE_RATE,
+  encodeMonoPcm16Wav,
   isSpeechInputProviderFactory,
-  resolveSpeechInputProvider
+  resolveSpeechInputProvider,
+  startDictationSession
 };

package/dist/speechAudioWav-WKIQWGIJ.js

@@ -0,0 +1,13 @@
+import {
+  downmixToMono,
+  encodeMonoPcm16Wav,
+  microphoneTakeAsWav,
+  resampleLinear
+} from "./chunk-K56KR27T.js";
+import "./chunk-DNEVUOBZ.js";
+export {
+  downmixToMono,
+  encodeMonoPcm16Wav,
+  microphoneTakeAsWav,
+  resampleLinear
+};