@bendyline/squisq-editor-react 2.3.4 → 2.4.1

package/dist/index.d.ts

@@ -1,13 +1,16 @@
-import { C as CodeContext, S as SceneTextChannel } from './shell-C-KkTBz7.js';
-export { B as BlockTagVisibility, a as CodeContextSection, D as DocumentLinkCandidate, b as DocumentLinkProvider, E as EditorActions, c as EditorColorScheme, d as EditorContextValue, e as EditorMode, f as EditorProvider, g as EditorProviderProps, h as EditorShell, i as EditorShellProps, j as EditorState, k as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, l as MentionProvider, P as PreviewPanel, m as PreviewPanelProps, R as RawEditor, n as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, o as WysiwygEditor, p as WysiwygEditorProps, u as useEditorContext } from './shell-C-KkTBz7.js';
+import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-CU4GpGuq.js';
+export { B as BlockTagVisibility, a as CodeContextSection, D as DocumentLinkCandidate, b as DocumentLinkProvider, c as EditorActions, d as EditorColorScheme, e as EditorContextValue, f as EditorMode, g as EditorProvider, h as EditorProviderProps, i as EditorShell, j as EditorShellProps, k as EditorState, l as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, m as MentionProvider, P as PreviewPanel, n as PreviewPanelProps, R as RawEditor, o as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, p as WysiwygEditor, q as WysiwygEditorProps, u as useEditorContext } from './shell-CU4GpGuq.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode, CSSProperties } from 'react';
+import { Doc, ScheduledClip, VideoPlacement, VideoPipSize, VideoPipShape, VideoPipPosition, MediaProvider, Theme, CustomTemplateDefinition, ThemeSeedColors, ViewportPreset, ViewportConfig, Block, MediaEntry, DiagramEdgeAnchor } from '@bendyline/squisq/schemas';
+import { ContentContainer } from '@bendyline/squisq/storage';
 export { CanvasRect, ImageEditor, ImageEditorAction, ImageEditorProps, ImageEditorState, ImageEditorTool, ImageViewer, ImageViewerProps, UseImageEditorOptions, UseImageEditorReturn, imageEditorReducer, initialImageEditorState, useImageEditor } from './image-editor/index.js';
-import { MediaProvider, Theme, CustomTemplateDefinition, ThemeSeedColors, ViewportPreset, ViewportConfig, Doc, Block, MediaEntry, DiagramEdgeAnchor } from '@bendyline/squisq/schemas';
 import { IconFamily } from '@bendyline/squisq/icons';
-import { DisplayMode, CaptionStyle } from '@bendyline/squisq-react';
+import { DisplayMode, CaptionStyle, VideoPresentation, PipSize, PipShape, PipPosition } from '@bendyline/squisq-react';
+import { MarkdownWrapState } from '@bendyline/squisq/markdown';
 import * as monaco_editor from 'monaco-editor';
+import { M as MonacoLanguageRequest, a as MonacoLanguageLoadOptions } from './monacoLanguageDetection-DEyUW-BS.js';
 export { MonacoWorkerConstructor, MonacoWorkerConstructors, configureMonacoWorkers } from './monaco-workers/index.js';
 import { ConnectorRouting, AsciiDiagram, Tree, AsciiTimeline, AsciiTimelineSide, AsciiTimelineMarker } from '@bendyline/squisq/doc';
 import * as _tiptap_core from '@tiptap/core';
@@ -19,10 +22,9 @@ import { PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
 import { RenderResult } from 'mermaid';
 export { JsonEditor, JsonEditorProps } from './json-editor/index.js';
-export { CameraStreamOptions, CaptureKind, RecordedBookmark, RecorderButton, RecorderButtonProps, RecorderColorScheme, RecorderModal, RecorderModalProps, RecorderPanel, RecorderPanelProps, RecorderSaveResult, RecorderSource, RecorderState, ResolvedFormat, ScreenStreamHandle, ScreenStreamOptions, TimingJson, UseMediaRecorderOptions, UseMediaRecorderResult, buildFilename, buildTimingJson, encodeTimingJson, getCaptureKind, requestCameraStream, requestMicStream, requestScreenStream, resolveFormat, supportsDisplayMedia, supportsMediaRecorder, supportsUserMedia, timingPathFor, useMediaRecorder, useStreamPreview } from './recorder/index.js';
-export { CanvasSink, DEFAULT_TELEPROMPTER_PREFS, EYE_LINE_FRACTION, FloatOpenOptions, FloatTier, FloatingWindowHandle, FloatingWindowManager, MicAnalysisHandle, MicAnalysisStatus, NarrationRecorderController, NarrationRecorderState, NarrationSavePlan, NarrationSaveResult, NarrationTake, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, PrompterTransport, TELEPROMPTER_CSS, TeleprompterController, TeleprompterControls, TeleprompterControlsProps, TeleprompterPrefs, TeleprompterRecordingDeps, TeleprompterSurface, TeleprompterSurfaceProps, TeleprompterView, TeleprompterViewProps, TokenLineMap, buildNarrationSavePlan, cameraVideoLine, createFloatingWindowManager, detectFloatTiers, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor, useFloatingWindow, useMicAnalysis, useNarrationRecorder, useTeleprompter, vadConfigForSensitivity } from './teleprompter/index.js';
-import '@bendyline/squisq/markdown';
-import '@bendyline/squisq/storage';
+export { C as CameraStreamOptions, a as CaptureKind, R as RecordedBookmark, b as RecorderButton, c as RecorderButtonProps, d as RecorderCameraLane, e as RecorderCameraSaveResult, f as RecorderColorScheme, g as RecorderModal, h as RecorderModalProps, i as RecorderNarrationOptions, j as RecorderPanel, k as RecorderPanelProps, l as RecorderSaveResult, m as RecorderSource, n as RecorderState, o as ResolvedFormat, S as ScreenStreamHandle, p as ScreenStreamOptions, T as TimingJson, U as UseMediaRecorderOptions, q as UseMediaRecorderResult, r as buildFilename, s as buildTimingJson, t as encodeTimingJson, u as getCaptureKind, v as requestCameraStream, w as requestMicStream, x as requestScreenStream, y as resolveFormat, z as supportsDisplayMedia, A as supportsMediaRecorder, B as supportsUserMedia, D as timingPathFor, E as useMediaRecorder, F as useStreamPreview } from './recorder-C5tAYUE3.js';
+export { EYE_LINE_FRACTION, NarrationSavePlan, NarrationSaveResult, NarrationStage, NarrationStageProps, PCM_WORKLET_NAME, PCM_WORKLET_SOURCE, TELEPROMPTER_CSS, TeleprompterControls, TeleprompterControlsProps, TeleprompterSurface, TeleprompterSurfaceProps, TeleprompterView, TeleprompterViewProps, TokenLineMap, buildNarrationSavePlan, cameraVideoLine, ensureTeleprompterStyles, executeNarrationSave, insertNarrationPreamble, measureTokenLines, narrationAnnotationLine, prompterVarsFromTheme, registerPcmWorklet, stepScroll, targetOffsetFor } from './teleprompter/index.js';
+export { C as CanvasSink, D as DEFAULT_TELEPROMPTER_PREFS, F as FloatOpenOptions, a as FloatTier, b as FloatingWindowHandle, c as FloatingWindowManager, M as MicAnalysisHandle, d as MicAnalysisStatus, N as NarrationRecorderController, e as NarrationRecorderState, f as NarrationStageHandle, g as NarrationTake, P as PrompterTransport, T as TeleprompterController, h as TeleprompterPrefs, i as TeleprompterRecordingDeps, U as UseNarrationStageOptions, j as createFloatingWindowManager, k as detectFloatTiers, u as useFloatingWindow, l as useMicAnalysis, m as useNarrationRecorder, n as useNarrationStage, o as useTeleprompter, v as vadConfigForSensitivity } from './useNarrationStage-Bqo18PBw.js';
 import '@bendyline/squisq/versions';
 import '@bendyline/squisq/imageEdit';
 import '@bendyline/squisq/jsonForm';
@@ -138,6 +140,12 @@ interface UseBlockNavigatorOptions {
 declare function useBlockNavigator(source: string, setSource: (s: string) => void, opts?: UseBlockNavigatorOptions): BlockNavigator;
 
 interface BlockCardViewProps {
+    /**
+     * Whether to show the block-card chrome. Defaults to true. When false the
+     * stable frame remains mounted around `children`, allowing hosts to switch
+     * between document and card layouts without remounting the editor surface.
+     */
+    active?: boolean;
     /** Total number of navigable blocks. */
     blockCount: number;
     /** Index of the block currently shown (0-based). */
@@ -153,7 +161,7 @@ interface BlockCardViewProps {
     /** Optional extra class for the outer container. */
     className?: string;
 }
-declare function BlockCardView({ blockCount, activeBlockKey, onPrev, onNext, onAdd, children, className, }: BlockCardViewProps): react_jsx_runtime.JSX.Element;
+declare function BlockCardView({ active, blockCount, activeBlockKey, onPrev, onNext, onAdd, children, className, }: BlockCardViewProps): react_jsx_runtime.JSX.Element;
 
 /**
  * blockRange
@@ -206,21 +214,136 @@ declare function offsetToLine(source: string, offset: number): number;
 declare function sliceIndexAtOffset(slices: BlockSlice[], offset: number): number;
 
 /**
- * TimelineTrack
+ * useTimelineClock
  *
- * Horizontal timeline strip for the Timeline view. Shows every block as a bar
- * (width ∝ duration, x ∝ startTime) with its media clips as sub-bars below.
- * Clicking a block selects it (the editor above follows). Dragging a block's
- * right edge changes its duration; dragging its left edge changes the previous
- * block's duration (the boundary, since startTime is derived). Dragging a media
- * clip moves its `startAt`; dragging the clip's right edge changes its length;
- * double-clicking a clip toggles `spillover`. All edits are written back to the
- * markdown source via {@link timelineSource}.
+ * A minimal real-time playback clock for the timeline view — a
+ * `requestAnimationFrame` loop that advances `currentTime` at wall-clock speed
+ * between `play()` and `pause()`, clamped to `[0, total]`. No audio element;
+ * media playback is driven separately (the timeline feeds `currentTime` to
+ * `MediaClipLayer`). Mirrors the fallback timer in `useAudioSync`.
  */
+interface TimelineClock {
+    /** Seconds from the start of the timeline. */
+    currentTime: number;
+    isPlaying: boolean;
+    /** Start playing; restarts from 0 when already at the end. */
+    play: () => void;
+    pause: () => void;
+    toggle: () => void;
+    /** Jump to a time (clamped to `[0, total]`). */
+    seek: (t: number) => void;
+}
+
 interface TimelineTrackProps {
     height?: number;
+    /**
+     * Doc used for bar geometry / timing. Callers pass the narration-timed
+     * projection so the track matches what actually plays; falls back to the
+     * editor's raw parse. Editing still round-trips because the projected doc
+     * keeps each block's `sourceHeading`.
+     */
+    doc?: Doc | null;
+    /** Optional shared clock used by docked timeline companions. */
+    clock?: TimelineClock;
+    /** Reuse an already-resolved schedule instead of deriving it from the doc. */
+    schedule?: ScheduledClip[];
+    /** Whether the docked video monitor is currently visible. */
+    videoVisible?: boolean;
+}
+declare function TimelineTrack({ height, doc: docProp, clock, schedule, videoVisible, }: TimelineTrackProps): react_jsx_runtime.JSX.Element | null;
+
+interface TimelineVideoPanelProps {
+    schedule: ScheduledClip[];
+    currentTime: number;
+    isPlaying: boolean;
+    basePath?: string;
+    onClose?: () => void;
+}
+declare function TimelineVideoPanel({ schedule, currentTime, isPlaying, basePath, onClose, }: TimelineVideoPanelProps): react_jsx_runtime.JSX.Element;
+
+interface TimelineCompositionPanelProps {
+    doc: Doc | null;
+    clock: TimelineClock;
+    basePath?: string;
+    workspaceContainer?: ContentContainer | null;
+    onClose?: () => void;
+}
+declare function TimelineCompositionPanel({ doc, clock, basePath, workspaceContainer, onClose, }: TimelineCompositionPanelProps): react_jsx_runtime.JSX.Element;
+
+/** Horizontal controls for Timeline-only companion panes. */
+interface TimelineToolbarProps {
+    literalVideoVisible: boolean;
+    compositionVisible: boolean;
+    videoAvailable: boolean;
+    compositionAvailable: boolean;
+    onToggleLiteralVideo: () => void;
+    onToggleComposition: () => void;
+}
+declare function TimelineToolbar({ literalVideoVisible, compositionVisible, videoAvailable, compositionAvailable, onToggleLiteralVideo, onToggleComposition, }: TimelineToolbarProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * headingTransition
+ *
+ * Read and write a block's transition (`transition` / `transitionDirection` /
+ * `transitionDuration`) on a heading, in both editing surfaces:
+ *
+ * - Markdown (Monaco): operate on the raw heading line string.
+ * - WYSIWYG (Tiptap): operate on the heading node's `dataBlockAttrs` string
+ *   (Pandoc `{…}` inner) and `dataTemplateParams` string (the params inside
+ *   the squisq-native `{[…]}` annotation).
+ *
+ * The editor writes transitions to the squisq-native `{[…]}` annotation by
+ * default. It still reads legacy Pandoc `{transition=…}` attributes and
+ * removes/migrates those keys when rewriting, so the two channels cannot drift
+ * after a toolbar edit.
+ *
+ * All the brace-matching / tokenizing / serializing is delegated to the
+ * shared core helpers so this stays in lockstep with the parser by import
+ * rather than by copied regexes.
+ */
+/** Raw (un-coerced) transition attribute values for one block. */
+interface TransitionFields {
+    /** `transition` value. Empty string means "none" (`cut`). */
+    type: string;
+    /** `transitionDirection` value, or '' when unset. */
+    direction: string;
+    /** `transitionDuration` value (raw, e.g. `0.7` or `700ms`), or '' when unset. */
+    duration: string;
+}
+declare const EMPTY_TRANSITION: TransitionFields;
+/**
+ * Read the transition fields off a heading line. Looks in both the Pandoc
+ * `{…}` block (legacy) and the `{[…]}` template params (canonical),
+ * with the Pandoc block taking precedence. Returns the empty transition for
+ * non-heading lines.
+ */
+declare function readHeadingLineTransition(line: string): TransitionFields;
+/**
+ * Return `line` with its transition rewritten from `next`, writing into the
+ * squisq-native `{[…]}` annotation. Legacy Pandoc transition keys are removed
+ * while preserving ids, classes, and other Pandoc params. Non-heading lines are
+ * returned unchanged.
+ */
+declare function setHeadingLineTransition(line: string, next: TransitionFields): string;
+/**
+ * Read the transition fields from a heading node's `dataBlockAttrs` (legacy
+ * Pandoc inner) plus `dataTemplateParams` (canonical `{[…]}` params). Pandoc
+ * wins so the picker mirrors the value that `markdownToDoc` will render when
+ * both channels are present.
+ */
+declare function readBlockAttrsTransition(blockAttrsInner: string | null | undefined, templateParams: string | null | undefined): TransitionFields;
+interface HeadingTransitionAttrs {
+    /** Inner of the Pandoc `{…}` block, without braces. */
+    blockAttrsInner: string | null;
+    /** Param string inside the `{[…]}` annotation, without the template token. */
+    templateParams: string | null;
 }
-declare function TimelineTrack({ height }: TimelineTrackProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Rewrite a heading node's transition for Tiptap, writing the transition
+ * family into `dataTemplateParams` and removing any legacy transition keys
+ * from `dataBlockAttrs`.
+ */
+declare function setHeadingAttrsTransition(blockAttrsInner: string | null | undefined, templateParams: string | null | undefined, next: TransitionFields): HeadingTransitionAttrs;
 
 /**
  * timelineSource
@@ -232,6 +355,7 @@ declare function TimelineTrack({ height }: TimelineTrackProps): react_jsx_runtim
  * (template annotations, ids, classes, other params) by reusing the shared
  * tokenizers rather than regex-replacing values.
  */
+
 /** Format a seconds value compactly: integers bare, else up to 2 decimals. */
 declare function formatSeconds(seconds: number): string;
 /**
@@ -243,13 +367,22 @@ declare function formatSeconds(seconds: number): string;
  * two can't disagree). Returns the new full source, or null when the line
  * isn't an ATX heading.
  */
-declare function setBlockDurationInSource(source: string, line: number, seconds: number): string | null;
+declare function setBlockDurationInSource(source: string, line: number, seconds: number | null): string | null;
+/** Set or clear a block's explicit start time on its source heading. */
+declare function setBlockStartTimeInSource(source: string, line: number, seconds: number | null): string | null;
+/** Rewrite a block transition on its source heading. */
+declare function setBlockTransitionInSource(source: string, line: number, transition: TransitionFields): string | null;
 /** A patch to a media clip; numeric values are seconds, `null` removes the key. */
 interface MediaClipPatch {
     startAt?: number | null;
     clipStart?: number | null;
     clipEnd?: number | null;
     spillover?: boolean | null;
+    placement?: VideoPlacement | null;
+    lockToBlock?: boolean | null;
+    pipSize?: VideoPipSize | null;
+    pipShape?: VideoPipShape | null;
+    pipPosition?: VideoPipPosition | null;
 }
 /**
  * Patch the `{[audio …]}` / `{[video …]}` annotation at 1-based `line`.
@@ -670,10 +803,24 @@ interface PreviewSettings {
      *  that style. The single entry point so the toggle buttons persist in one
      *  frontmatter write. */
     setCaptionMode: (mode: CaptionMode) => void;
+    /** Whether the current document schedules any video media. */
+    hasVideoMedia: boolean;
+    activeVideoPresentation: VideoPresentation;
+    setVideoPresentation: (presentation: VideoPresentation) => void;
+    activePipSize: PipSize;
+    setPipSize: (size: PipSize) => void;
+    activePipShape: PipShape;
+    setPipShape: (shape: PipShape) => void;
+    activePipPosition: PipPosition;
+    setPipPosition: (position: PipPosition) => void;
     /** Whether Squisq should synthesize and show its managed cover slide. */
     activeCoverSlide: boolean;
     /** Enable/disable the managed cover slide. */
     setCoverSlideEnabled: (enabled: boolean) => void;
+    /** Whether Video mode restarts automatically when playback ends. */
+    activeVideoLoop: boolean;
+    /** Enable/disable automatic Video-mode playback restart. */
+    setVideoLoopEnabled: (enabled: boolean) => void;
     /** User-authored themes (doc + browser library) for the picker's "Custom" group. */
     customThemes: Theme[];
     /** Open the custom-theme designer for a theme (or null to create a new one). */
@@ -702,6 +849,12 @@ declare function usePreviewSettings(): PreviewSettings;
 interface PreviewSettingsProviderProps {
     doc: Doc | null;
     children: ReactNode;
+    /**
+     * Viewport preset to use when the document does not declare
+     * `document-render-as` and the user has not selected a format. Hosts can
+     * make this responsive to their available surface. Defaults to landscape.
+     */
+    defaultViewportPreset?: ViewportPreset;
     /**
      * Optional Theme to use for the preview, regardless of `Doc.themeId` or
      * the user's theme dropdown selection. Used by the theme customizer to
@@ -710,7 +863,7 @@ interface PreviewSettingsProviderProps {
      */
     themeOverride?: Theme | null;
 }
-declare function PreviewSettingsProvider({ doc, children, themeOverride, }: PreviewSettingsProviderProps): react_jsx_runtime.JSX.Element;
+declare function PreviewSettingsProvider({ doc, children, defaultViewportPreset, themeOverride, }: PreviewSettingsProviderProps): react_jsx_runtime.JSX.Element;
 /**
  * Inline preview controls rendered in the main toolbar row.
  *
@@ -723,7 +876,15 @@ declare function PreviewSettingsProvider({ doc, children, themeOverride, }: Prev
  * inline row and the menu, so the available space is always well used and the
  * row never wraps onto a second line.
  */
-declare function PreviewToolbarControls(): react_jsx_runtime.JSX.Element;
+interface PreviewToolbarControlsProps {
+    /**
+     * Display mode whose applicable control set should be rendered. Defaults to
+     * the active Use mode. This only controls toolbar visibility; changing a
+     * setting still writes through the shared preview-settings context.
+     */
+    displayMode?: DisplayMode;
+}
+declare function PreviewToolbarControls({ displayMode }?: PreviewToolbarControlsProps): react_jsx_runtime.JSX.Element;
 /**
  * Segmented display-mode switch retained as a public, embeddable control.
  * The editor shell uses {@link PreviewModeMenu} beside its Use tab instead.
@@ -786,13 +947,19 @@ interface ToolbarProps {
      * editing free-form prompts — can pass false to suppress it.
      */
     showPlayTab?: boolean;
+    /**
+     * Semantic embedding mode inherited from EditorShell. Chat mode exposes
+     * only the Write surface, which suppresses the view tabs and their
+     * keyboard-switch targets. Defaults to `'document'`.
+     */
+    hostMode?: EditorHostMode;
 }
 /**
  * Formatting toolbar.
  * - WYSIWYG: calls Tiptap chain commands (toggleBold, etc.)
  * - Raw: appends markdown syntax to the source
  */
-declare function Toolbar({ className, showFiles, fileCount, onToggleFiles, slotLeft, slotAfterTabs, slotAfterActions, slotRight, showPlayTab, }: ToolbarProps): react_jsx_runtime.JSX.Element;
+declare function Toolbar({ className, showFiles, fileCount, onToggleFiles, slotLeft, slotAfterTabs, slotAfterActions, slotRight, showPlayTab, hostMode, }: ToolbarProps): react_jsx_runtime.JSX.Element;
 
 /**
  * VersionHistoryPanel
@@ -821,6 +988,63 @@ declare function VersionHistoryPanel(): react_jsx_runtime.JSX.Element | null;
  */
 declare function ViewMenuPanel(): react_jsx_runtime.JSX.Element;
 
+/**
+ * TransformMenu
+ *
+ * Toolbar popover applying one-time, undoable markdown source transforms
+ * (unwrap / wrap-at-width / cleanup) from core's
+ * `MARKDOWN_SOURCE_TRANSFORMS` registry, plus a readout of the document's
+ * detected wrap convention (`detectMarkdownWrapState`).
+ *
+ * Apply paths keep the operation a single undo step:
+ * - Source view: minimal per-paragraph `executeEdits` on the Monaco model
+ *   between undo stops — native byte-exact undo, cursor/scroll stay put.
+ * - Write view: one `setMarkdownSource` write; the WYSIWYG external-sync
+ *   `setContent` lands as one Tiptap history entry.
+ * - Use view has no editing surface (no undo), so rows are disabled there.
+ */
+declare function TransformMenu(): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Write-view wrap policy — "unwrap in Write view, persist with wrapping".
+ *
+ * The Tiptap bridge maps each physical source line to its own paragraph, so
+ * a hard-wrapped document renders as choppy one-line paragraphs in Write
+ * view — and the first edit serializes that chopped structure back into the
+ * source. These helpers make the wrap convention transparent instead:
+ * detect the document's prevailing wrap state, hand Tiptap the UNWRAPPED
+ * body (prose flows naturally), and re-apply the detected convention when
+ * serializing back to markdown. The exact same shape as WysiwygEditor's
+ * frontmatter strip/reattach dance, applied to wrapping.
+ *
+ * Pure string logic (no Tiptap, no DOM) so it stays Node-testable.
+ */
+
+interface WrapPolicyIngest {
+    /** Body to hand to the Write view (unwrapped when the doc is wrapped). */
+    displayBody: string;
+    /**
+     * The detected wrap state to persist with, or null when the document has
+     * no confident wrap convention (unwrapped / mixed / no prose) — persist
+     * is then a pass-through.
+     */
+    state: MarkdownWrapState | null;
+}
+/**
+ * Prepare a markdown body (frontmatter already stripped) for Write-view
+ * editing. Only a confident `wrapped` detection unwraps; `mixed`,
+ * `unwrapped`, and `no-prose` documents pass through untouched, so docs
+ * without a convention behave exactly as before.
+ */
+declare function ingestForWrite(body: string): WrapPolicyIngest;
+/**
+ * Re-apply the detected wrap convention to a body serialized from the
+ * Write view. Pass-through when there is no wrapped state; on a degraded
+ * wrap (safety guard) the unwrapped body is persisted instead — a valid
+ * document that merely loses the convention for that save.
+ */
+declare function persistFromWrite(bodyMd: string, state: MarkdownWrapState | null): string;
+
 interface OutlinePanelProps {
     /**
      * Fixed width of the pane in pixels. When omitted, the pane sizes
@@ -895,70 +1119,6 @@ interface TemplatePickerProps {
 }
 declare function TemplatePicker({ value, onChange, colorScheme, compact, recommended, onOpenDesigner, previewSource, }: TemplatePickerProps): react_jsx_runtime.JSX.Element;
 
-/**
- * headingTransition
- *
- * Read and write a block's transition (`transition` / `transitionDirection` /
- * `transitionDuration`) on a heading, in both editing surfaces:
- *
- * - Markdown (Monaco): operate on the raw heading line string.
- * - WYSIWYG (Tiptap): operate on the heading node's `dataBlockAttrs` string
- *   (Pandoc `{…}` inner) and `dataTemplateParams` string (the params inside
- *   the squisq-native `{[…]}` annotation).
- *
- * The editor writes transitions to the squisq-native `{[…]}` annotation by
- * default. It still reads legacy Pandoc `{transition=…}` attributes and
- * removes/migrates those keys when rewriting, so the two channels cannot drift
- * after a toolbar edit.
- *
- * All the brace-matching / tokenizing / serializing is delegated to the
- * shared core helpers so this stays in lockstep with the parser by import
- * rather than by copied regexes.
- */
-/** Raw (un-coerced) transition attribute values for one block. */
-interface TransitionFields {
-    /** `transition` value. Empty string means "none" (`cut`). */
-    type: string;
-    /** `transitionDirection` value, or '' when unset. */
-    direction: string;
-    /** `transitionDuration` value (raw, e.g. `0.7` or `700ms`), or '' when unset. */
-    duration: string;
-}
-declare const EMPTY_TRANSITION: TransitionFields;
-/**
- * Read the transition fields off a heading line. Looks in both the Pandoc
- * `{…}` block (legacy) and the `{[…]}` template params (canonical),
- * with the Pandoc block taking precedence. Returns the empty transition for
- * non-heading lines.
- */
-declare function readHeadingLineTransition(line: string): TransitionFields;
-/**
- * Return `line` with its transition rewritten from `next`, writing into the
- * squisq-native `{[…]}` annotation. Legacy Pandoc transition keys are removed
- * while preserving ids, classes, and other Pandoc params. Non-heading lines are
- * returned unchanged.
- */
-declare function setHeadingLineTransition(line: string, next: TransitionFields): string;
-/**
- * Read the transition fields from a heading node's `dataBlockAttrs` (legacy
- * Pandoc inner) plus `dataTemplateParams` (canonical `{[…]}` params). Pandoc
- * wins so the picker mirrors the value that `markdownToDoc` will render when
- * both channels are present.
- */
-declare function readBlockAttrsTransition(blockAttrsInner: string | null | undefined, templateParams: string | null | undefined): TransitionFields;
-interface HeadingTransitionAttrs {
-    /** Inner of the Pandoc `{…}` block, without braces. */
-    blockAttrsInner: string | null;
-    /** Param string inside the `{[…]}` annotation, without the template token. */
-    templateParams: string | null;
-}
-/**
- * Rewrite a heading node's transition for Tiptap, writing the transition
- * family into `dataTemplateParams` and removing any legacy transition keys
- * from `dataBlockAttrs`.
- */
-declare function setHeadingAttrsTransition(blockAttrsInner: string | null | undefined, templateParams: string | null | undefined, next: TransitionFields): HeadingTransitionAttrs;
-
 interface TransitionPickerProps {
     value: TransitionFields;
     onChange: (next: TransitionFields) => void;
@@ -1139,8 +1299,21 @@ interface MediaBinProps {
     onMediaRemoved?: (relativePath: string, entry: MediaEntry) => void | Promise<void>;
     /** Fired whenever the panel scans media and knows the current entry count. */
     onCountChange?: (count: number) => void;
+    /**
+     * Opens the host's media recorder. When provided, the Files header shows a
+     * compact Record button beside Upload.
+     */
+    onRecord?: () => void;
+    /** Whether the recorder dialog opened by `onRecord` is currently visible. */
+    isRecorderOpen?: boolean;
+    /**
+     * Whether files expose a browser download action. Defaults to true. This
+     * controls the built-in affordance only; it cannot prevent access to media
+     * URLs that the host otherwise exposes to the browser.
+     */
+    allowBinaryDownloads?: boolean;
 }
-declare function MediaBin({ mediaProvider, isDark, refreshKey, usedMediaPaths, onMediaUploaded, onMediaRemoved, onCountChange, }: MediaBinProps): react_jsx_runtime.JSX.Element;
+declare function MediaBin({ mediaProvider, isDark, refreshKey, usedMediaPaths, onMediaUploaded, onMediaRemoved, onCountChange, onRecord, isRecorderOpen, allowBinaryDownloads, }: MediaBinProps): react_jsx_runtime.JSX.Element;
 
 interface StatusBarProps {
     /** Additional class name */
@@ -1271,38 +1444,18 @@ declare function processTextFile(file: File): Promise<string>;
  */
 declare function processTextFiles(files: File[]): Promise<string>;
 
-/**
- * useMonacoLoader
- *
- * Idempotently dynamic-imports `monaco-editor` and points the
- * `@monaco-editor/react` singleton loader at the bundled copy. Replaces
- * the historical top-of-module `import * as monaco from 'monaco-editor';
- * loader.config({ monaco })` pattern, which forced every consumer of
- * `@bendyline/squisq-editor-react` — including ones that only import
- * `JsonEditor` or a type — to drag in monaco's ~9MB worth of language
- * services and workers at module evaluation time.
- *
- * Hosts that want the smallest possible bundle can keep aliasing
- * `monaco-editor` to a slim entry as before; the behavior is identical
- * once the dynamic import settles.
- *
- * The promise is cached at module scope so the first subscriber
- * anywhere in the app pays the import cost and every later subscriber
- * reuses the same settled value.
- */
 interface UseMonacoLoaderResult {
-    /** The monaco namespace once loaded, or `null` while the import is in flight. */
+    /** The Monaco namespace once loaded, or `null` while the core is in flight. */
     monaco: typeof monaco_editor | null;
-    /** Flips to `true` after the import settles. Gate `<Editor>` / `<DiffEditor>` renders on this. */
+    /** True after the compact core and this caller's language profile are ready. */
     ready: boolean;
 }
-/**
- * Subscribe to the lazy-loaded monaco namespace. The first caller
- * triggers `import('monaco-editor')` and configures the
- * `@monaco-editor/react` loader; subsequent callers receive the same
- * cached value.
- */
-declare function useMonacoLoader(): UseMonacoLoaderResult;
+/** Start Monaco and the requested language profile before a React editor mounts. */
+declare function preloadMonaco(requestedLanguages?: MonacoLanguageRequest, options?: MonacoLanguageLoadOptions): Promise<typeof monaco_editor>;
+/** Load completion and snippet UI after the compact editor is already usable. */
+declare function preloadMonacoSuggestions(): Promise<void>;
+/** Subscribe to the shared Monaco namespace and a demand-loaded language profile. */
+declare function useMonacoLoader(requestedLanguages?: MonacoLanguageRequest, options?: MonacoLanguageLoadOptions): UseMonacoLoaderResult;
 
 interface CustomTemplateContextValue {
     /** Templates inlined into the current doc's frontmatter. */
@@ -1459,7 +1612,25 @@ declare function tiptapToMarkdown(html: string): string;
  * slide, interleaves images, recalculates timing, and adds a synthetic
  * audio segment.
  */
-declare function buildPreviewDoc(doc: Doc): Doc;
+interface BuildPreviewDocOptions {
+    /**
+     * Human-facing title to use as the header of the leading heading-less
+     * "preamble" block when the document has no frontmatter `title:`. Hosts
+     * typically pass the file name (extension stripped) via
+     * {@link documentTitleFromFileName}. When neither this nor a frontmatter
+     * title is present, the preamble simply renders with no header rather than
+     * the placeholder block id.
+     */
+    documentTitle?: string;
+}
+/**
+ * Derive a display title from a file name: strip any directory prefix and the
+ * trailing extension (`docs/Longview Plan.md` → `Longview Plan`). Returns an
+ * empty string for an absent/blank name so callers can pass the result through
+ * without extra guards.
+ */
+declare function documentTitleFromFileName(fileName?: string): string;
+declare function buildPreviewDoc(doc: Doc, options?: BuildPreviewDocOptions): Doc;
 
 /**
  * TemplateAnnotation — Tiptap Heading Extension
@@ -2654,4 +2825,4 @@ declare function applyTimelineCommand(editor: Editor, blockId: string, command:
 /** Paste gate for bare, high-confidence Unicode timeline art. */
 declare function shouldPasteAsTimelineFence(text: string): boolean;
 
-export { ALL_PICKER_ENTRIES, type AddTimelineEventOptions, type AddTimelineEventResult, type ApplyAsciiDiagramCommandOptions, type AsciiDiagramBlockEntry, AsciiDiagramExtension, type AsciiDiagramExtensionOptions, type AsciiDiagramPluginState, type AsciiDiagramView, AsciiDiagramWidget, BlockCardView, type BlockCardViewProps, type BlockNavigator, BlockPropertiesPopover, type BlockPropertiesPopoverProps, type BlockRange, type BlockSlice, CODE_SNIPPET_KEY, CODE_SNIPPET_LANGUAGES, CodeContext, CodeContextZones, type CodeSnippetBlockEntry, type CodeSnippetData, CodeSnippetExtension, type CodeSnippetExtensionOptions, type CodeSnippetLanguage, type CodeSnippetPluginState, CodeSnippetWidget, type CodeSnippetWidgetProps, type CustomTemplateContextValue, CustomTemplateProvider, type CustomTemplateProviderProps, type CustomThemeContextValue, CustomThemeProvider, type CustomThemeProviderProps, DEFAULT_MERMAID_DIAGRAM_TYPE, DiagramCanvas, type DiagramCommand, type DiagramData, type DiagramEdge, type DiagramNode, type DirectionModel, type DocCustomTemplates, type DocCustomThemes, DocumentSettingsDialog, type DocumentSettingsDialogProps, type DragContentType, type DropTarget, DropZoneOverlay, type DropZoneOverlayProps, EMPTY_TRANSITION, EmojiPicker, type EmojiPickerProps, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, type HeadingTransitionAttrs, HeadingWithTemplate, ImportThemeSection, type ImportThemeSectionProps, type ImportedThemeResult, InlinePreviewGutter, type InlinePreviewGutterProps, MERMAID_DIAGRAM_KEY, MERMAID_DIAGRAM_TYPES, MERMAID_FLOWCHART_SHAPES, MediaBin, type MediaBinProps, type MediaClipPatch, type MermaidDiagramBlockEntry, MermaidDiagramCanvas, type MermaidDiagramCanvasProps, type MermaidDiagramCategory, type MermaidDiagramData, MermaidDiagramExtension, type MermaidDiagramExtensionOptions, type MermaidDiagramPluginState, type MermaidDiagramPreview, type MermaidDiagramProperty, type MermaidDiagramType, MermaidDiagramTypeThumbnail, MermaidDiagramWidget, type MermaidDiagramWidgetProps, type MermaidEditCapabilities, type MermaidEditableDiagramKind, type MermaidEditableEdge, type MermaidEditableModel, type MermaidEditableNode, type MermaidEditableText, type MermaidEditableTextTarget, type MermaidFlowchartDirection, type MermaidFlowchartModel, type MermaidFlowchartShape, type MermaidFlowchartShapeId, type MermaidNodeCanvasAction, type MermaidRenderResult, type MermaidSelection, MermaidShapePalette, type MermaidShapePaletteProps, type MermaidSourceEditableModel, OutlinePanel, type OutlinePanelProps, PICKER_CATEGORIES, type PickerCategory, type PickerEntry, PlainHtmlPreview, type PlainHtmlPreviewProps, PreviewFormatSwitch, PreviewModeMenu, PreviewModeSwitch, type PreviewSettings, PreviewSettingsProvider, PreviewToolbarControls, REPAIRABLE_KEY, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, StatusBar, type StatusBarProps, TIMELINE_VIEW_KEY, TRANSITION_ENTRIES, TRANSITION_GROUPS, TemplatePicker, ThemeCustomizerPanel, type ThemeCustomizerPanelProps, ThemePicker, type ThemePickerProps, type ThemeSaveExtras, type TimelineBlockEntry, type TimelineCommand, type TimelineCommandResult, TimelineEditorWidget, type TimelineEditorWidgetProps, type TimelineEventPatch, TimelineTrack, type TimelineTrackProps, type TimelineViewData, TimelineViewExtension, type TimelineViewExtensionOptions, type TimelineViewPluginState, Toolbar, type ToolbarProps, TooltipLayer, type TransitionCatalogEntry, type TransitionFields, type TransitionGroup, TransitionPicker, type TransitionPickerProps, type TreeBlockEntry, type TreeCommand, TreeOutlineWidget, type TreeViewData, TreeViewExtension, type TreeViewExtensionOptions, type TreeViewPluginState, type UseBlockNavigatorOptions, type UseFileDropOptions, type UseFileDropResult, type UseMonacoLoaderResult, VersionHistoryPanel, ViewMenuPanel, ViewSwitcher, type ViewSwitcherProps, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, buildPreviewDoc, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, detectLanguageFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, parseTimelineForNode, partitionFiles, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, sliceIndexAtOffset, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMonacoLoader, usePreviewSettings, useTimelineData, useTreeViewData };
+export { ALL_PICKER_ENTRIES, type AddTimelineEventOptions, type AddTimelineEventResult, type ApplyAsciiDiagramCommandOptions, type AsciiDiagramBlockEntry, AsciiDiagramExtension, type AsciiDiagramExtensionOptions, type AsciiDiagramPluginState, type AsciiDiagramView, AsciiDiagramWidget, BlockCardView, type BlockCardViewProps, type BlockNavigator, BlockPropertiesPopover, type BlockPropertiesPopoverProps, type BlockRange, type BlockSlice, type BuildPreviewDocOptions, CODE_SNIPPET_KEY, CODE_SNIPPET_LANGUAGES, CodeContext, CodeContextZones, type CodeSnippetBlockEntry, type CodeSnippetData, CodeSnippetExtension, type CodeSnippetExtensionOptions, type CodeSnippetLanguage, type CodeSnippetPluginState, CodeSnippetWidget, type CodeSnippetWidgetProps, type CustomTemplateContextValue, CustomTemplateProvider, type CustomTemplateProviderProps, type CustomThemeContextValue, CustomThemeProvider, type CustomThemeProviderProps, DEFAULT_MERMAID_DIAGRAM_TYPE, DiagramCanvas, type DiagramCommand, type DiagramData, type DiagramEdge, type DiagramNode, type DirectionModel, type DocCustomTemplates, type DocCustomThemes, DocumentSettingsDialog, type DocumentSettingsDialogProps, type DragContentType, type DropTarget, DropZoneOverlay, type DropZoneOverlayProps, EMPTY_TRANSITION, EditorHostMode, EmojiPicker, type EmojiPickerProps, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, type HeadingTransitionAttrs, HeadingWithTemplate, ImportThemeSection, type ImportThemeSectionProps, type ImportedThemeResult, InlinePreviewGutter, type InlinePreviewGutterProps, MERMAID_DIAGRAM_KEY, MERMAID_DIAGRAM_TYPES, MERMAID_FLOWCHART_SHAPES, MediaBin, type MediaBinProps, type MediaClipPatch, type MermaidDiagramBlockEntry, MermaidDiagramCanvas, type MermaidDiagramCanvasProps, type MermaidDiagramCategory, type MermaidDiagramData, MermaidDiagramExtension, type MermaidDiagramExtensionOptions, type MermaidDiagramPluginState, type MermaidDiagramPreview, type MermaidDiagramProperty, type MermaidDiagramType, MermaidDiagramTypeThumbnail, MermaidDiagramWidget, type MermaidDiagramWidgetProps, type MermaidEditCapabilities, type MermaidEditableDiagramKind, type MermaidEditableEdge, type MermaidEditableModel, type MermaidEditableNode, type MermaidEditableText, type MermaidEditableTextTarget, type MermaidFlowchartDirection, type MermaidFlowchartModel, type MermaidFlowchartShape, type MermaidFlowchartShapeId, type MermaidNodeCanvasAction, type MermaidRenderResult, type MermaidSelection, MermaidShapePalette, type MermaidShapePaletteProps, type MermaidSourceEditableModel, MonacoLanguageLoadOptions, MonacoLanguageRequest, OutlinePanel, type OutlinePanelProps, PICKER_CATEGORIES, type PickerCategory, type PickerEntry, PlainHtmlPreview, type PlainHtmlPreviewProps, PreviewFormatSwitch, PreviewModeMenu, PreviewModeSwitch, type PreviewSettings, PreviewSettingsProvider, PreviewToolbarControls, type PreviewToolbarControlsProps, REPAIRABLE_KEY, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, StatusBar, type StatusBarProps, TIMELINE_VIEW_KEY, TRANSITION_ENTRIES, TRANSITION_GROUPS, TemplatePicker, ThemeCustomizerPanel, type ThemeCustomizerPanelProps, ThemePicker, type ThemePickerProps, type ThemeSaveExtras, type TimelineBlockEntry, type TimelineCommand, type TimelineCommandResult, TimelineCompositionPanel, type TimelineCompositionPanelProps, TimelineEditorWidget, type TimelineEditorWidgetProps, type TimelineEventPatch, TimelineToolbar, type TimelineToolbarProps, TimelineTrack, type TimelineTrackProps, TimelineVideoPanel, type TimelineVideoPanelProps, type TimelineViewData, TimelineViewExtension, type TimelineViewExtensionOptions, type TimelineViewPluginState, Toolbar, type ToolbarProps, TooltipLayer, TransformMenu, type TransitionCatalogEntry, type TransitionFields, type TransitionGroup, TransitionPicker, type TransitionPickerProps, type TreeBlockEntry, type TreeCommand, TreeOutlineWidget, type TreeViewData, TreeViewExtension, type TreeViewExtensionOptions, type TreeViewPluginState, type UseBlockNavigatorOptions, type UseFileDropOptions, type UseFileDropResult, type UseMonacoLoaderResult, VersionHistoryPanel, ViewMenuPanel, ViewSwitcher, type ViewSwitcherProps, type WrapPolicyIngest, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, buildPreviewDoc, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, detectLanguageFromFileName, documentTitleFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, parseTimelineForNode, partitionFiles, persistFromWrite, preloadMonaco, preloadMonacoSuggestions, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setBlockStartTimeInSource, setBlockTransitionInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, sliceIndexAtOffset, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMonacoLoader, usePreviewSettings, useTimelineData, useTreeViewData };