@bendyline/squisq-editor-react 2.11.17 → 2.11.19

package/dist/index.js

@@ -215,34 +215,49 @@ import {
   useMermaidSurfaceTheme,
   useMonacoLoader,
   usePreviewSettings,
+  usePreviewSettingsOptional,
   useTimelineData,
   useTreeViewData,
+  validateMermaidSource,
   viewStateFromBinding,
   writeHeadingViewState
-} from "./chunk-US5DALTZ.js";
+} from "./chunk-5EB3BGPE.js";
 import {
   EditorProvider,
+  applySourceEditsToText,
+  blockInsertionPoint,
   detectLanguageFromFileName,
   getBlockSlices,
+  headingDepthForInsertion,
+  joinBlockAt,
   lineToOffset,
+  minimalReplaceEdit,
+  normalizeSourceEdits,
   offsetToLine,
   resolveFileKind,
+  resolveOutlineInsertion,
   sliceIndexAtOffset,
+  sourceOutline,
   spliceBlock,
   useBlockNavigator,
   useEditorContext
-} from "./chunk-HTO5MTTJ.js";
+} from "./chunk-TZX7RKZV.js";
+import {
+  SPEECH_INPUT_SAMPLE_RATE,
+  isSpeechInputProviderFactory,
+  resolveSpeechInputProvider
+} from "./chunk-DNEVUOBZ.js";
 import "./chunk-V4NBQF5C.js";
 import {
   JsonEditor
-} from "./chunk-UBFNLWCN.js";
+} from "./chunk-V2OLZOYJ.js";
 import {
   MarkdownEscape
-} from "./chunk-2XXBDECJ.js";
+} from "./chunk-OCQEWWHI.js";
 import {
   markdownToTiptap,
   tiptapToMarkdown
-} from "./chunk-DPAMJV6A.js";
+} from "./chunk-HSWWEWT4.js";
 import {
   ImageEditor,
   ImageViewer,
@@ -252,9 +267,8 @@ import {
 } from "./chunk-K4Z2GIX4.js";
 import {
   RecorderButton
-} from "./chunk-EJKGXWNK.js";
+} from "./chunk-LR6Q2MK4.js";
 import {
-  DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
@@ -262,10 +276,6 @@ import {
   RecorderSlidesPanel,
   SLIDE_TIMING_CHECKBOX_LABEL,
   buildPreviewDoc,
-  buildRecorderAudioConstraints,
-  buildRecorderCameraConstraints,
-  buildRecorderScreenAudioConstraints,
-  buildRecorderScreenConstraints,
   buildRecorderSlideDeck,
   clampSlideIndex,
   documentTitleFromFileName,
@@ -274,7 +284,6 @@ import {
   isExpandedPanel,
   panelModeAfterToggle,
   recordedMediaKind,
-  recorderBitsPerSecond,
   recorderDeviceGroups,
   recorderDeviceOptions,
   requestScreenStream,
@@ -283,11 +292,19 @@ import {
   unshownSlidesWarning,
   useMediaDevices,
   useMediaRecorder
-} from "./chunk-C6QVA6TO.js";
+} from "./chunk-UFK47ZAI.js";
+import {
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
+  recorderBitsPerSecond
+} from "./chunk-LRZJD5YD.js";
 import "./chunk-GS7QWYFT.js";
 import {
   TeleprompterView
-} from "./chunk-QZWFSSDE.js";
+} from "./chunk-DJS5I5NO.js";
 import {
   DEFAULT_TELEPROMPTER_PREFS,
   EYE_LINE_FRACTION,
@@ -297,7 +314,6 @@ import {
   TELEPROMPTER_CSS,
   TeleprompterControls,
   TeleprompterSurface,
-  buildFilename,
   buildNarrationSavePlan,
   buildTimingJson,
   cameraVideoLine,
@@ -312,12 +328,7 @@ import {
   prompterVarsFromTheme,
   registerPcmWorklet,
   requestCameraStream,
-  requestMicStream,
-  resolveFormat,
   stepScroll,
-  supportsDisplayMedia,
-  supportsMediaRecorder,
-  supportsUserMedia,
   targetOffsetFor,
   timingPathFor,
   useFloatingWindow,
@@ -327,7 +338,15 @@ import {
   useStreamPreview,
   useTeleprompter,
   vadConfigForSensitivity
-} from "./chunk-XZVMKR5Q.js";
+} from "./chunk-ZS6G2P57.js";
+import {
+  buildFilename,
+  requestMicStream,
+  resolveFormat,
+  supportsDisplayMedia,
+  supportsMediaRecorder,
+  supportsUserMedia
+} from "./chunk-DNJ6HOES.js";
 
 // src/FolderView.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -822,6 +841,7 @@ export {
   RecorderSlidesPanel,
   RepairableDiagramExtension,
   SLIDE_TIMING_CHECKBOX_LABEL,
+  SPEECH_INPUT_SAMPLE_RATE,
   StatusBar,
   Subscript,
   Superscript,
@@ -859,9 +879,11 @@ export {
   addTimelineEventOp,
   applyAsciiDiagramCommand,
   applyRepairCommand,
+  applySourceEditsToText,
   applyTimelineCommand,
   applyTreeCommand,
   asciiDiagramToCanvas,
+  blockInsertionPoint,
   buildFilename,
   buildNarrationSavePlan,
   buildPreviewDoc,
@@ -906,6 +928,7 @@ export {
   getCaptureKind,
   getTimelineForNode,
   hasRecorderDeviceChoice,
+  headingDepthForInsertion,
   imageEditorReducer,
   indentItemOp,
   ingestForWrite,
@@ -921,7 +944,9 @@ export {
   isMermaidFlowchartShapeId,
   isMermaidSourceVisible,
   isRepairableFence,
+  isSpeechInputProviderFactory,
   isTimelineSourceSafeForSemanticEdit,
+  joinBlockAt,
   lineToOffset,
   loadDataPreview,
   mapFenceEntries,
@@ -933,6 +958,7 @@ export {
   mermaidEditableTexts,
   mermaidErrorMessage,
   mermaidSurfaceScheme,
+  minimalReplaceEdit,
   monacoLanguageForFence,
   moveItemDownOp,
   moveItemUpOp,
@@ -940,6 +966,7 @@ export {
   narrationAnnotationLine,
   nextTimelineEventId,
   normalizeMermaidFlowchartShape,
+  normalizeSourceEdits,
   offsetToLine,
   outdentItemOp,
   panelModeAfterToggle,
@@ -981,6 +1008,8 @@ export {
   resolveFileKind,
   resolveFormat,
   resolveMermaidSurfaceTheme,
+  resolveOutlineInsertion,
+  resolveSpeechInputProvider,
   sanitizeAsciiLabel,
   sanitizeTimelineText,
   sanitizeTreeLabel,
@@ -1000,6 +1029,7 @@ export {
   showSlideTimingCheckbox,
   sliceIndexAtOffset,
   slideStepForKey,
+  sourceOutline,
   spliceBlock,
   stepScroll,
   summarizeBlockProps,
@@ -1038,11 +1068,13 @@ export {
   useNarrationRecorder,
   useNarrationStage,
   usePreviewSettings,
+  usePreviewSettingsOptional,
   useStreamPreview,
   useTeleprompter,
   useTimelineData,
   useTreeViewData,
   vadConfigForSensitivity,
+  validateMermaidSource,
   viewStateFromBinding,
   writeHeadingViewState
 };

package/dist/json-editor/index.js

@@ -1,8 +1,8 @@
 import {
   JsonEditor
-} from "../chunk-UBFNLWCN.js";
-import "../chunk-2XXBDECJ.js";
-import "../chunk-DPAMJV6A.js";
+} from "../chunk-V2OLZOYJ.js";
+import "../chunk-OCQEWWHI.js";
+import "../chunk-HSWWEWT4.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-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';
+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';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/schemas';
 import '@bendyline/squisq/storage';

package/dist/recorder/index.js

@@ -1,40 +1,44 @@
 import {
   RecorderButton
-} from "../chunk-EJKGXWNK.js";
+} from "../chunk-LR6Q2MK4.js";
 import {
-  DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderDeviceQuickPicks,
   RecorderDeviceSettingsPanel,
   RecorderModal,
   RecorderPanel,
-  buildRecorderAudioConstraints,
-  buildRecorderCameraConstraints,
-  buildRecorderScreenAudioConstraints,
-  buildRecorderScreenConstraints,
   getCaptureKind,
   hasRecorderDeviceChoice,
   recordedMediaKind,
-  recorderBitsPerSecond,
   recorderDeviceGroups,
   recorderDeviceOptions,
   requestScreenStream,
   useMediaDevices,
   useMediaRecorder
-} from "../chunk-C6QVA6TO.js";
+} from "../chunk-UFK47ZAI.js";
+import {
+  DEFAULT_RECORDER_DEVICE_SETTINGS,
+  buildRecorderAudioConstraints,
+  buildRecorderCameraConstraints,
+  buildRecorderScreenAudioConstraints,
+  buildRecorderScreenConstraints,
+  recorderBitsPerSecond
+} from "../chunk-LRZJD5YD.js";
 import "../chunk-GS7QWYFT.js";
 import {
-  buildFilename,
   buildTimingJson,
   encodeTimingJson,
   requestCameraStream,
+  timingPathFor,
+  useStreamPreview
+} from "../chunk-ZS6G2P57.js";
+import {
+  buildFilename,
   requestMicStream,
   resolveFormat,
   supportsDisplayMedia,
   supportsMediaRecorder,
-  supportsUserMedia,
-  timingPathFor,
-  useStreamPreview
-} from "../chunk-XZVMKR5Q.js";
+  supportsUserMedia
+} from "../chunk-DNJ6HOES.js";
 export {
   DEFAULT_RECORDER_DEVICE_SETTINGS,
   RecorderButton,

package/dist/{recorder-CRsw0eC7.d.ts → recorder-DKN3vZPi.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-vKtk6H-V.js';
+import { l as RecorderSource, o as TeleprompterRecordingDeps, S as ScreenCaptureRegion } from './useNarrationStage-CB8dynUg.js';
 import { CSSProperties, RefObject } from 'react';
 
 type RecordedMediaKind = 'audio' | 'video';

package/dist/review/index.js

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

package/dist/shell/index.d.ts

@@ -1,4 +1,4 @@
-export { d as BlockTagVisibility, g as DocumentLinkCandidate, h as DocumentLinkProvider, i as EditorActions, j as EditorColorScheme, k as EditorContextMenuContext, l as EditorContextMenuItem, m as EditorContextMenuItemVisibility, n as EditorContextMenuProvider, o as EditorContextMenuProviderProps, p as EditorContextValue, E as EditorHostMode, q as EditorMode, r as EditorProvider, s as EditorProviderProps, u as EditorShell, v as EditorShellProps, w as EditorState, x as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, A as MentionProvider, P as PreviewPanel, G as PreviewPanelProps, R as RawEditor, H as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, J as WysiwygEditor, K as WysiwygEditorProps, a1 as useEditorContext, a2 as useEditorContextMenuItems } from '../shell-X0EoQbbN.js';
+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';
 import 'react/jsx-runtime';
 import '@bendyline/squisq/table';
 import '@bendyline/squisq-calc';
@@ -12,6 +12,7 @@ import '@bendyline/squisq/markdown';
 import '@bendyline/squisq/storage';
 import '../types-De4z-gGb.js';
 import '@bendyline/squisq/proof';
+import '../speech/index.js';
 import '@bendyline/squisq/versions';
 import '@tiptap/core';
 import 'monaco-editor';

package/dist/shell/index.js

@@ -5,19 +5,22 @@ import {
   RawEditor,
   WysiwygEditor,
   useEditorContextMenuItems
-} from "../chunk-US5DALTZ.js";
+} from "../chunk-5EB3BGPE.js";
 import {
   EditorProvider,
   useEditorContext
-} from "../chunk-HTO5MTTJ.js";
+} from "../chunk-TZX7RKZV.js";
+import "../chunk-DNEVUOBZ.js";
 import "../chunk-V4NBQF5C.js";
-import "../chunk-2XXBDECJ.js";
-import "../chunk-DPAMJV6A.js";
+import "../chunk-OCQEWWHI.js";
+import "../chunk-HSWWEWT4.js";
 import "../chunk-K4Z2GIX4.js";
-import "../chunk-C6QVA6TO.js";
+import "../chunk-UFK47ZAI.js";
+import "../chunk-LRZJD5YD.js";
 import "../chunk-GS7QWYFT.js";
-import "../chunk-QZWFSSDE.js";
-import "../chunk-XZVMKR5Q.js";
+import "../chunk-DJS5I5NO.js";
+import "../chunk-ZS6G2P57.js";
+import "../chunk-DNJ6HOES.js";
 export {
   EditorContextMenuProvider,
   EditorProvider,

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

@@ -7,9 +7,10 @@ import { ReactNode, RefObject, ReactElement } from 'react';
 import { Doc, MediaProvider, ViewportPreset, Theme } from '@bendyline/squisq/schemas';
 import { FenceRendererMap } from '@bendyline/squisq/fence';
 import { CodeBlockCopyHandler } from '@bendyline/squisq-react';
-import { MarkdownDocument } from '@bendyline/squisq/markdown';
+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 { DocumentVersionManager, SaveVersionOptions, SaveVersionResult, PrunePolicy } from '@bendyline/squisq/versions';
 import { Editor } from '@tiptap/core';
 import { editor } from 'monaco-editor';
@@ -207,6 +208,102 @@ declare function offsetToLine(source: string, offset: number): number;
 /** Index of the slice whose range contains `offset`, or -1. */
 declare function sliceIndexAtOffset(slices: BlockSlice[], offset: number): number;
 
+/**
+ * sourceEdits
+ *
+ * Pure helpers behind the editor's undoable source-edit actions
+ * (`applySourceEdits`, `insertBlockAfterCursor`) and usable by any host that
+ * plans edits against a markdown string:
+ *
+ * - validating and applying `{ start, end, text }` edits to a source string;
+ * - the smallest single edit that turns one source into another;
+ * - where a new block may go relative to a cursor, without splitting a
+ *   container template (drawing, layout, diagram) or letting a new heading
+ *   capture the paragraphs that follow it.
+ *
+ * Placement is decided on an abstract outline of top-level blocks so the Write
+ * view (ProseMirror nodes) and the Source view (markdown AST) share one rule.
+ */
+
+/**
+ * Where `insertBlockAfterCursor` puts a block.
+ *
+ * - `afterBlock`: straight after the top-level block holding the cursor. Right
+ *   for fences, tables and paragraphs.
+ * - `sectionEnd`: at the end of the cursor's section, just before the next
+ *   heading. Right for heading-based blocks, which would otherwise capture
+ *   the paragraphs after them.
+ */
+type BlockPlacement = 'afterBlock' | 'sectionEnd';
+/** The heading structure around an insertion point. */
+interface BlockInsertionContext {
+    /** Depth of the section the insertion point belongs to; 0 before any heading. */
+    sectionDepth: number;
+    /** Depth of the first heading after the insertion point, or null at the end. */
+    nextHeadingDepth: number | null;
+    /**
+     * Deepest heading depth a heading-based block may use here. Normally 6;
+     * lower straight after a container template, whose children any deeper
+     * heading would join.
+     */
+    maxHeadingDepth: number;
+}
+/** One top-level block, as an outline sees it. */
+interface OutlineBlock {
+    /** Heading depth, or null for any non-heading block. */
+    headingDepth: number | null;
+    /** True for a heading whose template consumes the headings under it. */
+    container: boolean;
+}
+/** An insertion point in an outline: insert before `blocks[index]`. */
+interface OutlineInsertion extends BlockInsertionContext {
+    index: number;
+}
+/** Validate edits against `source` and sort them by position; null if any is unusable. */
+declare function normalizeSourceEdits(source: string, edits: readonly MarkdownSourceEdit[]): MarkdownSourceEdit[] | null;
+/** Apply edits to `source`. Throws on edits `normalizeSourceEdits` rejects. */
+declare function applySourceEditsToText(source: string, edits: readonly MarkdownSourceEdit[]): string;
+/** The smallest single edit turning `previous` into `next`, or null when they are equal. */
+declare function minimalReplaceEdit(previous: string, next: string): MarkdownSourceEdit | null;
+/**
+ * Decide where a block goes in an outline, given the block holding the cursor
+ * (`cursorIndex`, -1 when the cursor is before every block).
+ *
+ * A cursor inside a container template never puts a block among its children:
+ * `afterBlock` moves before the container and `sectionEnd` after its subtree.
+ */
+declare function resolveOutlineInsertion(blocks: readonly OutlineBlock[], cursorIndex: number, placement: BlockPlacement): OutlineInsertion;
+/**
+ * Heading depth for a heading-based block inserted at this point, so the
+ * heading that follows closes it instead of being captured, and it does not
+ * join a preceding container's children. `childLevels` reserves depth for the
+ * block's own child headings (1 for drawing and layout). Null when nothing fits.
+ */
+declare function headingDepthForInsertion(context: BlockInsertionContext, options?: {
+    childLevels?: number;
+}): number | null;
+/** Top-level blocks of a markdown source with their character ranges. */
+declare function sourceOutline(source: string): {
+    blocks: OutlineBlock[];
+    ranges: Array<{
+        start: number;
+        end: number;
+    }>;
+};
+/**
+ * Where a block goes in a markdown source for a cursor at `cursorOffset`.
+ * `offset` is the end of the block the new one follows (or the body start);
+ * pass it to {@link joinBlockAt}.
+ */
+declare function blockInsertionPoint(source: string, cursorOffset: number, placement: BlockPlacement): BlockInsertionContext & {
+    offset: number;
+};
+/**
+ * The edit that puts `block` at `offset` with exactly one blank line on each
+ * side, absorbing whatever whitespace already surrounds that point.
+ */
+declare function joinBlockAt(source: string, offset: number, block: string): MarkdownSourceEdit;
+
 /**
  * Configuration a Scene host (diagram / drawing / layout widget) supplies
  * so the shared inline text editor knows how to read and write the text of
@@ -288,6 +385,25 @@ interface DocumentLinkCandidate {
  */
 type DocumentLinkProvider = (query: string) => Promise<DocumentLinkCandidate[]>;
 type EditorView = 'raw' | 'wysiwyg' | 'preview';
+/** Options for {@link EditorActions.applySourceEdits}. */
+interface ApplySourceEditsOptions {
+    /**
+     * The source the edits were planned against. When the document no longer
+     * matches it, nothing is applied and the action returns false.
+     */
+    baseSource?: string;
+}
+/**
+ * Builds the markdown for {@link EditorActions.insertBlockAfterCursor} once the
+ * insertion point is known, so a heading-based block can pick a depth that
+ * fits there. Return null to cancel.
+ */
+type BlockInsertionBuilder = (context: BlockInsertionContext) => string | null;
+/** Options for {@link EditorActions.insertBlockAfterCursor}. */
+interface InsertBlockOptions {
+    /** Defaults to `'afterBlock'`. Use `'sectionEnd'` for heading-based blocks. */
+    placement?: BlockPlacement;
+}
 /** What is selected in the active editing surface. */
 interface EditorSelectionInfo {
     /** Which surface reported it. */
@@ -525,8 +641,34 @@ interface EditorActions {
     getBlockAtCursor: () => BlockSlice | null;
     /** Insert text at the current cursor position in the active editor */
     insertAtCursor: (text: string) => void;
-    /** Replace all editor content with the given text */
+    /**
+     * Replace all editor content with the given text. Undoable as one step in
+     * Write and Source views (Document layout); elsewhere it replaces the
+     * source directly.
+     */
     replaceAll: (text: string) => void;
+    /**
+     * Apply `{ start, end, text }` edits to the full markdown source as ONE
+     * undoable step. Offsets refer to `markdownSource` (frontmatter included).
+     *
+     * Source view edits Monaco's model in place, so the cursor, scroll and undo
+     * history survive. Write view loads the result as a minimal change.
+     * Returns false, applying nothing, in Preview, outside the Document layout,
+     * when the edits overlap or fall outside the source, or when the source no
+     * longer matches `options.baseSource`.
+     */
+    applySourceEdits: (edits: readonly MarkdownSourceEdit[], options?: ApplySourceEditsOptions) => boolean;
+    /**
+     * Insert a markdown block near the cursor as ONE undoable step, leaving the
+     * selection where it is.
+     *
+     * `'afterBlock'` (default) puts it after the top-level block holding the
+     * cursor; `'sectionEnd'` puts it just before the next heading. Neither ever
+     * lands among a drawing's or layout's child headings. Pass a builder to
+     * choose the markdown once the surrounding heading depths are known.
+     * Returns false when the surface cannot be edited or the builder cancels.
+     */
+    insertBlockAfterCursor: (block: string | BlockInsertionBuilder, options?: InsertBlockOptions) => boolean;
     /**
      * Request the modal image editor open on the given relative media path.
      * The path must resolve through the active `mediaProvider`. No-op when
@@ -593,6 +735,12 @@ interface EditorContextValue extends EditorState, EditorActions {
      * reads it from here.
      */
     versioning: DocumentVersionManager | null;
+    /**
+     * Whether versions are also saved automatically after an idle pause
+     * (`versioningAutoSaveIdleMs` above zero), so the version-history panel
+     * only promises automatic saves when the host has them on.
+     */
+    versioningAutoSaves: boolean;
     /**
      * Stamp a new snapshot of the current document. No-op (returns
      * `unchanged`) when content matches the latest version. Always safe
@@ -645,6 +793,13 @@ interface EditorContextValue extends EditorState, EditorActions {
      * for the session.
      */
     proofingIgnoreStore: ProofingIgnoreStore | null;
+    /**
+     * Imperative dictation control for the host-injected `speechInput`
+     * capability — e.g. to drive dictation from a native menu command in a
+     * component rendered inside the shell's slots. `null` when no capability
+     * was injected. See docs/speech-input.md.
+     */
+    dictation: DictationControl | null;
     /** The document's article id — part of the proofing document ref. */
     articleId: string;
     /**
@@ -760,6 +915,11 @@ interface EditorProviderProps {
     proofingGrammarEnabled?: boolean;
     /** Host-owned per-document storage for dismissed proofing findings. */
     proofingIgnoreStore?: ProofingIgnoreStore | null;
+    /**
+     * Speech-input (dictation) capability. Omit for no dictation; see
+     * `EditorShellProps.speechInput`.
+     */
+    speechInput?: SpeechInputCapability | null;
     /**
      * Async provider for sibling-document suggestions in the link dialog.
      * Omit to fall back to URL-only link insertion.
@@ -897,7 +1057,7 @@ interface ViewPreferences {
     /** Document vs. block-at-a-time layout. */
     layoutMode?: LayoutMode;
 }
-declare function EditorProvider({ initialMarkdown, initialView, articleId, colorScheme: initialColorScheme, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, mediaProvider, mediaEditRenders, imageDisplayMode, mentionProvider, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, documentLinkProvider, fenceRenderers, onCopyCode, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, saveCoverImageOutput, saveDashboardImageOutput, language, findMode: controlledFindMode, onFindModeChange, inlinePreview, showStatusBar, outline, blockTags, blockTagVisibility: initialBlockTagVisibility, themeInheritance, layoutMode, viewPreferences, onViewPreferencesChange, children, }: EditorProviderProps): react_jsx_runtime.JSX.Element;
+declare function EditorProvider({ initialMarkdown, initialView, articleId, colorScheme: initialColorScheme, workspaceContainer, allowVersioning, versionBasename, versioningPrunePolicy, versioningAutoSaveIdleMs, onSaveVersion, mediaProvider, mediaEditRenders, imageDisplayMode, mentionProvider, proofing, proofingDefaultEnabled, proofingSpellingEnabled, proofingGrammarEnabled, proofingIgnoreStore, speechInput, documentLinkProvider, fenceRenderers, onCopyCode, linkSchemes, allowRecording, allowNarrate, preserveSourceWrapping, fileName, saveCoverImageOutput, saveDashboardImageOutput, language, findMode: controlledFindMode, onFindModeChange, inlinePreview, showStatusBar, outline, blockTags, blockTagVisibility: initialBlockTagVisibility, themeInheritance, layoutMode, viewPreferences, onViewPreferencesChange, children, }: EditorProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Host-supplied context sections rendered INSIDE the Monaco (raw/code)
@@ -1350,6 +1510,17 @@ interface EditorShellProps {
      * store and Ignore still works, lasting for the session only.
      */
     proofingIgnoreStore?: ProofingIgnoreStore | null;
+    /**
+     * Dictation capability — a `SpeechInputProvider` (or factory) from
+     * `@bendyline/squisq-editor-react/speech`. Omit and the feature is off:
+     * no microphone button, no capture code loaded. With it, the toolbar
+     * gains a microphone in the Write and Source views that inserts
+     * recognized phrases as literal text at the caret; hosts can also drive
+     * it via `useEditorContext().dictation`. Instance = host-owned; factory =
+     * created on mount, disposed on unmount. Ignored when `readOnly`. Host
+     * guide: docs/speech-input.md.
+     */
+    speechInput?: SpeechInputCapability | null;
     /**
      * Optional async provider for sibling-document suggestions in the
      * link insert dialog. When supplied, the dialog gains a "Browse
@@ -1527,7 +1698,7 @@ interface EditorShellProps {
  * 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, 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, }: EditorShellProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Shared editor context menu.
@@ -1677,4 +1848,4 @@ interface PreviewPanelProps {
  */
 declare function PreviewPanel({ basePath, className, workspaceContainer, onLinkClick, showCodeCopyButton, onCopyCode, }: PreviewPanelProps): react_jsx_runtime.JSX.Element;
 
-export { sliceIndexAtOffset as $, type MentionProvider as A, type BlockRange as B, type CodeContext as C, type DashboardImageSaveOutput as D, type EditorHostMode as E, type FormulaEditRecord as F, type PreviewPanelProps as G, type RawEditorProps as H, type ImageDisplayMode as I, WysiwygEditor as J, type WysiwygEditorProps as K, type LayoutMode as L, type MentionCandidate as M, XLSX_LOCKED_REASON as N, type XlsxFormulaSession as O, PreviewPanel as P, createXlsxFormulaSession as Q, RawEditor as R, type SceneTextChannel as S, type ThemeInheritance as T, getBlockSlices as U, type ViewPreferences as V, type WriteCanvasSettings as W, type XlsxSourceMeta as X, ingestSidecarBytes as Y, lineToOffset as Z, offsetToLine as _, type CalcEngineFactory as a, spliceBlock as a0, useEditorContext as a1, useEditorContextMenuItems as a2, type CsvSourceMeta as b, type BlockSlice as c, type BlockTagVisibility as d, type CodeContextSection as e, type CoverImageSaveOutput as f, type DocumentLinkCandidate as g, type DocumentLinkProvider as h, type EditorActions as i, type EditorColorScheme as j, type EditorContextMenuContext as k, type EditorContextMenuItem as l, type EditorContextMenuItemVisibility as m, EditorContextMenuProvider as n, type EditorContextMenuProviderProps as o, type EditorContextValue as p, type EditorMode as q, EditorProvider as r, type EditorProviderProps as s, type EditorSelectionInfo as t, EditorShell as u, type EditorShellProps as v, type EditorState as w, type EditorView as x, type FormulaSessionOptions as y, type IngestedSidecar as z };
+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 };