@bendyline/squisq-editor-react 2.10.3 → 2.11.1

package/dist/{chunk-TCLNRATG.js → chunk-A2W4GYPG.js}

@@ -15,6 +15,8 @@ var RE_LEGACY_ITALIC_STAR = /(?<!\*)\*(?![\s*])(.+?)(?<![\s*])([ \t]+)\*(?=$|[^\
 var ESCAPABLE_MD_CHARS = ["*", "_", "~", "\\"];
 var RE_MD_ESCAPE = /\\([*_~\\])/g;
 var RE_INLINE_CODE = /`(.+?)`/g;
+var BACKTICK = "`";
+var FENCE = "```";
 var RE_IMAGE = /!\[(.*?)\]\((.+?)\)/g;
 var RE_MENTION = /@\[([^\]]+?)\]\(([a-z][a-z0-9+.-]*)\\?:([^)\s]+)\)/gi;
 var RE_MENTION_TAG = /<span\b[^>]*?\bdata-mention\b[^>]*?>(?:<[^>]+>)*([^<]*)<\/span>/gi;
@@ -26,10 +28,50 @@ var RE_VERT_ALIGN_TAG = /<(sup|sub)>((?:(?!<\/?(?:sup|sub)>)[\s\S])*)<\/\1>/gi;
 var RE_A_TAG = /<a\b([^>]*)>(.*?)<\/a>/g;
 var RE_IMG_TAG = /<img\b([^>]*)>/g;
 var RE_STRIP_TAGS = /<[^>]+>/g;
+function joinWrappedCodeSpans(lines) {
+  if (!lines.some((line) => line.includes(BACKTICK))) return lines;
+  const joined = [];
+  let inFence = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.startsWith(FENCE)) {
+      inFence = !inFence;
+      joined.push(line);
+      continue;
+    }
+    if (inFence || !leavesCodeSpanOpen(line)) {
+      joined.push(line);
+      continue;
+    }
+    let merged = line;
+    let next = i + 1;
+    let closed = false;
+    while (next < lines.length) {
+      const candidate = lines[next];
+      if (candidate.trim() === "" || candidate.startsWith(FENCE)) break;
+      merged = `${merged} ${candidate.replace(/^[ \t]+/, "")}`;
+      next++;
+      if (!leavesCodeSpanOpen(merged)) {
+        closed = true;
+        break;
+      }
+    }
+    if (!closed) {
+      joined.push(line);
+      continue;
+    }
+    joined.push(merged);
+    i = next - 1;
+  }
+  return joined;
+}
+function leavesCodeSpanOpen(text) {
+  return text.replace(RE_INLINE_CODE, "").includes(BACKTICK);
+}
 function markdownToTiptap(markdown) {
   if (!markdown.trim()) return "<p></p>";
   const html = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-  const lines = html.split("\n");
+  const lines = joinWrappedCodeSpans(html.split("\n"));
   const frontmatterEnd = findFrontmatterEnd(lines);
   const outputBlocks = [];
   let inCodeBlock = false;
@@ -403,7 +445,7 @@ function tiptapToMarkdown(html) {
         while ((cellExec = cellRegex.exec(rowHtml)) !== null) {
           const tag = cellExec[1];
           const attrs = cellExec[2];
-          const content = htmlToInline(cellExec[3].replace(/<\/?p>/g, ""));
+          const content = htmlToTableCell(cellExec[3].replace(/<\/?p>/g, ""));
           const alignExec = attrs.match(/text-align:\s*(left|center|right)/);
           cells.push({
             content,
@@ -789,6 +831,7 @@ function inlineToHtml(text) {
     const name = tag.toLowerCase();
     return stash(`<${name}>${inlineToHtml(inner)}</${name}>`);
   });
+  staged = staged.replace(/<br\s*\/?>/gi, () => stash("<br>"));
   staged = staged.replace(
     RE_IMAGE,
     (_m, alt, src) => stash(`<img alt="${escapeHtml(alt)}" src="${escapeHtml(src)}">`)
@@ -1031,6 +1074,9 @@ function htmlToInline(html) {
   result = vault.restore(result);
   return restoreLeadingSpaces(unescapeHtml(result));
 }
+function htmlToTableCell(html) {
+  return htmlToInline(html).replace(/ {2}\n/g, "<br>");
+}
 function preserveLeadingSpaces(html) {
   return html.replace(/^ +/, (spaces) => "&nbsp;".repeat(spaces.length));
 }

package/dist/{chunk-JYPLPGYJ.js → chunk-SK3MQSHQ.js}

@@ -1,7 +1,7 @@
 import {
   markdownToTiptap,
   tiptapToMarkdown
-} from "./chunk-TCLNRATG.js";
+} from "./chunk-A2W4GYPG.js";
 
 // src/jsonEditor/JsonEditorContext.tsx
 import { createContext, useContext, useEffect, useMemo } from "react";

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel } from './shell-DSHMZvnK.js';
-export { B as BlockTagVisibility, a as CodeContextSection, b as CoverImageSaveOutput, D as DashboardImageSaveOutput, c as DocumentLinkCandidate, d as DocumentLinkProvider, e as EditorActions, f as EditorColorScheme, g as EditorContextMenuContext, h as EditorContextMenuItem, i as EditorContextMenuItemVisibility, j as EditorContextMenuProvider, k as EditorContextMenuProviderProps, l as EditorContextValue, m as EditorMode, n as EditorProvider, o as EditorProviderProps, p as EditorShell, q as EditorShellProps, r as EditorState, s as EditorView, I as ImageDisplayMode, L as LayoutMode, M as MentionCandidate, t as MentionProvider, P as PreviewPanel, u as PreviewPanelProps, R as RawEditor, v as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, w as WysiwygEditor, x as WysiwygEditorProps, y as useEditorContext, z as useEditorContextMenuItems } from './shell-DSHMZvnK.js';
+import { C as CodeContext, E as EditorHostMode, S as SceneTextChannel, a as CalcEngineFactory, b as CsvSourceMeta, X as XlsxSourceMeta, F as FormulaEditRecord } from './shell-CJkHDwpz.js';
+export { B as BlockTagVisibility, c as CodeContextSection, d as CoverImageSaveOutput, D as DashboardImageSaveOutput, e as DocumentLinkCandidate, f as DocumentLinkProvider, g as EditorActions, h as EditorColorScheme, i as EditorContextMenuContext, j as EditorContextMenuItem, k as EditorContextMenuItemVisibility, l as EditorContextMenuProvider, m as EditorContextMenuProviderProps, n as EditorContextValue, o as EditorMode, p as EditorProvider, q as EditorProviderProps, r as EditorShell, s as EditorShellProps, t as EditorState, u as EditorView, v as FormulaSessionOptions, I as ImageDisplayMode, w as IngestedSidecar, L as LayoutMode, M as MentionCandidate, x as MentionProvider, P as PreviewPanel, y as PreviewPanelProps, R as RawEditor, z as RawEditorProps, T as ThemeInheritance, V as ViewPreferences, W as WriteCanvasSettings, A as WysiwygEditor, G as WysiwygEditorProps, H as XLSX_LOCKED_REASON, J as XlsxFormulaSession, K as createXlsxFormulaSession, N as ingestSidecarBytes, O as useEditorContext, Q as useEditorContextMenuItems } from './shell-CJkHDwpz.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { ReactNode, CSSProperties, ReactElement } 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';
@@ -23,6 +23,8 @@ import { Transaction, PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
 import { RenderResult } from 'mermaid';
 import { FenceRendererMap } from '@bendyline/squisq/fence';
+import { TableViewState } from '@bendyline/squisq/table';
+import { EditJournal } from '@bendyline/squisq-grid-react';
 export { JsonEditor, JsonEditorProps } from './json-editor/index.js';
 export { C as CameraStreamOptions, D as DEFAULT_RECORDER_DEVICE_SETTINGS, M as MediaDeviceInventory, R as RecordedBookmark, a as RecordedMediaKind, b as RecorderAudioDeviceSettings, c as RecorderButton, d as RecorderButtonProps, e as RecorderCameraDeviceSettings, f as RecorderCameraSaveResult, g as RecorderColorScheme, h as RecorderConstraintMode, i as RecorderDeviceOption, j as RecorderDeviceQuickPicks, k as RecorderDeviceQuickPicksProps, l as RecorderDeviceSettings, m as RecorderDeviceSettingsPanel, n as RecorderDeviceSettingsPanelProps, o as RecorderEncodingSettings, p as RecorderModal, q as RecorderModalProps, r as RecorderNarrationOptions, s as RecorderPanel, t as RecorderPanelProps, u as RecorderSaveResult, v as RecorderScreenAudioSettings, w as RecorderScreenDeviceSettings, x as RecorderSlidesOptions, S as ScreenStreamHandle, y as ScreenStreamOptions, z as SlideTimingSaveResult, T as TimingJson, A as buildRecorderAudioConstraints, B as buildRecorderCameraConstraints, E as buildRecorderScreenAudioConstraints, F as buildRecorderScreenConstraints, G as buildTimingJson, H as encodeTimingJson, I as hasRecorderDeviceChoice, J as recordedMediaKind, K as recorderBitsPerSecond, L as recorderDeviceGroups, N as recorderDeviceOptions, O as requestCameraStream, P as requestMicStream, Q as requestScreenStream, U as timingPathFor, V as useMediaDevices, W as useStreamPreview } from './recorder-GrEh4xE8.js';
 import { R as RecorderState } from './useNarrationStage-B6r9Zlq-.js';
@@ -31,6 +33,8 @@ export { EYE_LINE_FRACTION, NarrationSavePlan, NarrationSaveResult, NarrationSta
 export { H as HarperProofingConfig, P as ProofingCapability, a as ProofingDocumentRef, b as ProofingIgnoreStore, c as ProofingLanguage, d as ProofingLintOptions, e as ProofingProvider, f as ProofingProviderFactory } from './types-B_aHRuSc.js';
 export { createHarperProofingProvider } from './proofing/index.js';
 export { PROOF_DIALECTS, PROOF_FRONTMATTER_KEYS, ProofCategory, ProofDialect, ProofFinding, ProofRange, ProofSuggestion, ProofSuggestionKind } from '@bendyline/squisq/proof';
+import '@bendyline/squisq-calc';
+import '@bendyline/squisq-formats/xlsx';
 import '@bendyline/squisq/versions';
 import '@bendyline/squisq/imageEdit';
 import '@bendyline/squisq/jsonForm';
@@ -422,9 +426,12 @@ interface FileKind {
     /**
      * 'markdown' keeps the full editor (WYSIWYG + Preview tabs); 'code' is
      * Monaco-only; 'image' renders a dedicated image viewer with no text
-     * editing surface.
+     * editing surface; 'data' marks a tabular data file (csv/tsv/parquet) the
+     * host should open as a sidecar-referencing document (or fall back to a
+     * plaintext Monaco view) rather than pasting raw bytes into the WYSIWYG
+     * markdown editor.
      */
-    mode: 'markdown' | 'code' | 'image';
+    mode: 'markdown' | 'code' | 'image' | 'data';
     /** Monaco language ID — passed to `<Editor defaultLanguage={...} />`. */
     language: string;
 }
@@ -1350,8 +1357,13 @@ interface MediaBinProps {
      * URLs that the host otherwise exposes to the browser.
      */
     allowBinaryDownloads?: boolean;
+    /**
+     * Relative path of an entry to highlight and scroll into view — how the
+     * data card's "Show in Files" lands on the file it names.
+     */
+    highlightPath?: string | null;
 }
-declare function MediaBin({ mediaProvider, isDark, refreshKey, usedMediaPaths, onMediaUploaded, onMediaRemoved, onCountChange, onRecord, isRecorderOpen, allowBinaryDownloads, }: MediaBinProps): react_jsx_runtime.JSX.Element;
+declare function MediaBin({ mediaProvider, isDark, refreshKey, usedMediaPaths, onMediaUploaded, onMediaRemoved, onCountChange, onRecord, isRecorderOpen, allowBinaryDownloads, highlightPath, }: MediaBinProps): react_jsx_runtime.JSX.Element;
 
 interface StatusBarProps {
     /** Additional class name */
@@ -1383,7 +1395,7 @@ declare function TooltipLayer(): react.ReactPortal | null;
  * classifies dragged file types (media vs text), and dispatches
  * drop events to callers.
  */
-type FileCategory = 'media' | 'text' | 'unknown';
+type FileCategory = 'media' | 'text' | 'data' | 'unknown';
 type DragContentType = 'media' | 'text' | 'mixed' | null;
 type DropTarget = 'media' | 'insert' | 'replace';
 declare function classifyFile(file: {
@@ -1439,12 +1451,13 @@ declare function DropZoneOverlay({ dragContentType, zoneProps, hasMediaProvider,
  */
 
 /**
- * Partition an array of files into media and text categories.
+ * Partition an array of files into media, text, and data categories.
  * Files with unknown type are skipped.
  */
 declare function partitionFiles(files: File[]): {
     media: File[];
     text: File[];
+    data: File[];
 };
 /**
  * Add media files to a MediaProvider. Returns the relative paths
@@ -1470,6 +1483,16 @@ declare function partitionFiles(files: File[]): {
  * problematic file doesn't abort a multi-file drop.
  */
 declare function processMediaFiles(files: File[], mediaProvider: MediaProvider): Promise<(string | null)[]>;
+/**
+ * Store data files (csv/tsv/xlsx/parquet) into the container behind a
+ * MediaProvider, under a caller-supplied directory prefix — conventionally
+ * `dataSidecarPrefix(docBasename)`, i.e. `<docbasename>_files/data/`.
+ *
+ * Same defensive read handling and index-aligned `null` slots as
+ * {@link processMediaFiles}. Name collisions inside the prefix get a
+ * ` -1`, `-2`, … suffix rather than overwriting an existing sidecar.
+ */
+declare function processDataFiles(files: File[], mediaProvider: MediaProvider, dataDirPrefix: string): Promise<(string | null)[]>;
 /**
  * Read a text-content file and return its content as a markdown string.
  *
@@ -1775,7 +1798,12 @@ interface FenceBlockEntry {
  * (and may use a lenient re-parse gate); a position absent from it is a NEW
  * fence that must pass full detection.
  */
-declare function mapFenceEntries(tr: Transaction, previous: readonly FenceBlockEntry[], doc: Node): Map<number, string>;
+declare function mapFenceEntries(tr: Transaction, previous: readonly FenceBlockEntry[], doc: Node, 
+/**
+ * Node type the family claims. Defaults to `'codeBlock'` (every fence
+ * family); the data-card family passes `'paragraph'`.
+ */
+nodeTypeName?: string): Map<number, string>;
 
 /**
  * AsciiDiagramExtension — Tiptap/ProseMirror plugin that turns code blocks
@@ -2559,6 +2587,13 @@ interface CodeSnippetExtensionOptions {
      * change freely behind the host extension's getter.
      */
     reservedLanguages?: readonly string[];
+    /**
+     * Getter for the host clipboard adapter used by each snippet's Copy
+     * button. A getter (not the handler itself) so a host can swap its
+     * clipboard implementation without re-configuring the editor — the
+     * same live-behind-a-getter contract `renderers` uses.
+     */
+    onCopyCode?: () => CodeBlockCopyHandler | undefined;
 }
 declare const CODE_SNIPPET_KEY: PluginKey<CodeSnippetPluginState>;
 declare function isCodeSnippetNode(node: Node, reserved?: ReadonlySet<string>): boolean;
@@ -2571,8 +2606,14 @@ interface CodeSnippetWidgetProps {
     host?: HTMLElement | null;
     /** Focus this newly inserted snippet after Monaco has mounted. */
     focusOnMount?: boolean;
+    /**
+     * Getter for the host clipboard adapter. Read at click time so a host can
+     * swap its implementation without remounting the widget. When it yields
+     * nothing, the button falls back to `navigator.clipboard`.
+     */
+    onCopyCode?: () => CodeBlockCopyHandler | undefined;
 }
-declare function CodeSnippetWidget({ editor, blockId, host, focusOnMount, }: CodeSnippetWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function CodeSnippetWidget({ editor, blockId, host, focusOnMount, onCopyCode, }: CodeSnippetWidgetProps): react_jsx_runtime.JSX.Element | null;
 
 /** Lossless edits for language-tagged code fences. */
 
@@ -2823,8 +2864,16 @@ declare const HostFenceExtension: Extension<HostFenceExtensionOptions, any>;
 /**
  * Every event a mounted fence widget must keep to itself. Ordered
  * pointer → key → text-input → composition → clipboard.
+ *
+ * `copy` belongs with `cut`/`paste`: ProseMirror installs its own `copy`
+ * handler on `view.dom` that serializes the DOCUMENT selection into the
+ * clipboard, and since it sits on an ancestor it runs after a widget's own
+ * copy handler — whichever `setData` runs last wins, so a Ctrl/Cmd-C inside
+ * a widget (a selected grid range, a diagram label field) would ship the
+ * document selection instead of the widget's. Its absence while `cut` and
+ * `paste` were contained was an oversight, not a decision.
  */
-declare const FENCE_WIDGET_CONTAINED_EVENTS: readonly ["pointerdown", "mousedown", "keydown", "keyup", "beforeinput", "input", "change", "compositionstart", "compositionupdate", "compositionend", "paste", "cut"];
+declare const FENCE_WIDGET_CONTAINED_EVENTS: readonly ["pointerdown", "mousedown", "keydown", "keyup", "beforeinput", "input", "change", "compositionstart", "compositionupdate", "compositionend", "copy", "paste", "cut"];
 /**
  * Stop every contained event at `container` so interaction inside a mounted
  * fence widget never reaches the ProseMirror editor that hosts it.
@@ -2834,6 +2883,231 @@ declare const FENCE_WIDGET_CONTAINED_EVENTS: readonly ["pointerdown", "mousedown
  */
 declare function containFenceWidgetEvents(container: HTMLElement): void;
 
+/**
+ * DataCardExtension — the Write-view "rectangle" for data sidecar files.
+ *
+ * A paragraph whose entire content is one link to a relative data file
+ * (`[q3.csv](report_files/data/q3.csv)` — the graceful-degradation body link
+ * under a `{[dataTable src=…]}` heading) is hidden and a summary card mounts
+ * in its place: file name, size, rows × cols, and a small preview.
+ *
+ * Structurally a sibling of `fenceWidgets/HostFenceExtension`, claiming
+ * PARAGRAPHS instead of code fences: same position registry with stable
+ * synthetic ids (via the generalized `mapFenceEntries`), same hide-the-node
+ * decoration + React-root widget with `containFenceWidgetEvents`.
+ *
+ * The claim predicate is synchronous and doc-content-only (relative href +
+ * data extension) — never an async listMedia consultation, so plugin state
+ * stays deterministic per transaction. A claimed card whose file is missing
+ * renders the error state instead of un-claiming.
+ *
+ * READ-ONLY by design in this phase: the card never touches the ProseMirror
+ * document, so markdown round-trips byte-identically with the extension
+ * active (`dataCard.test.tsx` holds that contract).
+ */
+
+type DataCardBlockEntry = FenceBlockEntry;
+interface DataCardPluginState {
+    entries: DataCardBlockEntry[];
+    decorations: DecorationSet;
+    seq: number;
+}
+declare const DATA_CARD_KEY: PluginKey<DataCardPluginState>;
+interface DataCardExtensionOptions {
+    /** When false, the extension is inert. */
+    enabled?: boolean;
+    /** Getter — stays live without an editor remount (the mentionProvider pattern). */
+    mediaProvider?: () => MediaProvider | null | undefined;
+    /** Getter for the media revision; a bump re-resolves mounted cards. */
+    mediaRevision?: () => number;
+    /**
+     * Getter for the workspace container — enables the grid save flow's
+     * `.versions/data/` pre-save backups. Absent = saves proceed without a
+     * backup (and say so).
+     */
+    container?: () => ContentContainer | null | undefined;
+    /** Open the Files panel focused on a sidecar path. */
+    onOpenFiles?: (relativePath: string) => void;
+    /** Notified after a successful sidecar save (hosts bump mediaRevision). */
+    onMediaSaved?: () => void;
+    /** Getter for the calc backend of formula sessions (default in-house). */
+    calcEngineFactory?: () => CalcEngineFactory | null | undefined;
+}
+/**
+ * The single data-file href a paragraph is entirely made of, or null.
+ * Every text child must carry the SAME link href; any unlinked or
+ * non-text content disqualifies the paragraph (an inline link in prose
+ * stays prose).
+ */
+declare function dataLinkHrefOf(node: Node): string | null;
+declare function findDataCardBlockPos(editor: Editor, blockId: string): number | null;
+declare const DataCardExtension: Extension<DataCardExtensionOptions, any>;
+
+/**
+ * DataCardWidget — the Write-view surface for a data sidecar reference.
+ *
+ * ALWAYS-GRID contract: every `{[dataTable src=…]}` block mounts the real
+ * virtualized grid (`@bendyline/squisq-grid-react`, lazily imported), with
+ * the summary card's identity strip (icon, name, size, rows×cols,
+ * Show-in-Files) as the grid's header. The compact preview card remains
+ * ONLY as the runtime fallback when the grid module fails to load — plus
+ * the unchanged missing/metadata error states.
+ *
+ * View state (sort/filter) binds to the OWNING heading's annotation params
+ * when the heading really owns this sidecar (see viewStateBinding.ts);
+ * otherwise it is session-only and the grid footer says so. CSV/TSV edits
+ * save in place through gridSave.ts; XLSX edits (values, and formulas when
+ * the calc-engine session boots within budget) save through in-place
+ * patching; parquet mounts read-only with a reason chip.
+ *
+ * The underlying PM paragraph is still never touched by the widget itself —
+ * only the heading's `dataTemplateParams` attribute changes, through the
+ * ordinary PM-undoable transaction path.
+ */
+
+interface DataCardWidgetProps {
+    editor: Editor;
+    blockId: string;
+    getMediaProvider: () => MediaProvider | null | undefined;
+    getMediaRevision: () => number;
+    getContainer?: (() => ContentContainer | null | undefined) | undefined;
+    onOpenFiles?: ((relativePath: string) => void) | undefined;
+    onMediaSaved?: (() => void) | undefined;
+    /** Calc backend for formula sessions (default: the in-house tier). */
+    getCalcEngineFactory?: (() => CalcEngineFactory | null | undefined) | undefined;
+}
+declare function DataCardWidget({ editor, blockId, getMediaProvider, getMediaRevision, getContainer, onOpenFiles, onMediaSaved, getCalcEngineFactory, }: DataCardWidgetProps): ReactElement | null;
+
+/**
+ * Data preview loading for the Write-view data card: bytes → a small
+ * `DataPreview` window via the formats data readers, loaded lazily so a
+ * document with no data references costs nothing. Results are cached by
+ * `(path, mediaRevision)` — a re-uploaded sidecar bumps the revision and
+ * naturally misses the cache.
+ */
+interface DataPreview {
+    columns: string[];
+    rows: string[][];
+    totalRows: number | null;
+    totalCols: number | null;
+}
+/** Lowercase extension of a path, or empty string. */
+declare function dataExtensionOf(path: string): string;
+/**
+ * Parse a bounded preview from raw bytes. Returns null when no reader is
+ * available for the extension (e.g. parquet without the optional peer) —
+ * the card then renders its metadata-only state. Parse failures also
+ * resolve to null rather than throwing.
+ */
+declare function loadDataPreview(bytes: ArrayBuffer, ext: string, opts?: {
+    maxRows?: number;
+    sheet?: string;
+    anchor?: string;
+}): Promise<DataPreview | null>;
+
+/**
+ * Binds the grid's view state (sort/filter) to the OWNING heading's
+ * `{[dataTable …]}` annotation params — the document-persisted half of the
+ * "author's sort IS part of the document" contract.
+ *
+ * Persistence guard: params are written ONLY when the owning heading's
+ * template resolves into `TABLE_FED_TEMPLATES` AND its `src` equals the
+ * card's href — a data-link paragraph under a template-less heading gets
+ * SESSION-ONLY view state rather than a fabricated annotation.
+ *
+ * Writes go through the established single-transaction pattern
+ * (`tr.setNodeAttribute(pos, 'dataTemplateParams', serialized || null)`,
+ * see scene/commands/drawingCommands.ts) with canonical
+ * `key=quoteAttrValue(value)` serialization; existing params keep their
+ * order, `sort`/`filter` update in place or append — `paramsEqual` in
+ * docToMarkdown is order-insensitive, so repeat writes stay byte-stable.
+ */
+
+interface HeadingViewBinding {
+    /** Heading node position, when an owning heading exists. */
+    headingPos: number | null;
+    /** True when sort/filter writes persist to the document. */
+    persisted: boolean;
+    /** All annotation params on the heading (raw, unquoted values). */
+    params: Record<string, string>;
+    /** Raw sort/filter param values, for `parseTableViewState`. */
+    sortRaw?: string;
+    filterRaw?: string;
+}
+/** Resolve the owning heading + persistence eligibility for a card. */
+declare function readHeadingViewBinding(editor: Editor, cardPos: number, href: string): HeadingViewBinding;
+/**
+ * Write the view state onto the heading annotation (one transaction,
+ * PM-undoable). Returns false when the write couldn't apply (stale pos).
+ */
+declare function writeHeadingViewState(editor: Editor, cardPos: number, href: string, view: TableViewState): boolean;
+/** Parse the binding's raw params into a `TableViewState` for the grid. */
+declare function viewStateFromBinding(binding: HeadingViewBinding, headers: readonly string[]): TableViewState;
+
+/**
+ * Grid save orchestration for CSV/TSV sidecars: journal → serialized bytes
+ * → in-place overwrite, with a `.versions/data/` pre-save backup.
+ *
+ * Order of operations and their whys:
+ *  1. BACKUP the original bytes first (`buildDataBackupPath`, pruned to the
+ *     newest 3 per sidecar) — the only cross-save undo the grid offers.
+ *     No container = no backup; the result says so rather than hiding it.
+ *  2. Serialize from the ORIGINAL parsed rows with journal edits splatted
+ *     in — unedited cells reproduce the parse product byte-for-byte (values,
+ *     not necessarily quoting style), sidestepping float-rendering drift.
+ *     Formula neutralization applies ONLY to journal-edited, non-numeric
+ *     cells (`serializeCsvRows` defaults `preserve`; blanket escaping would
+ *     corrupt every negative number in a re-saved file).
+ *  3. `addMedia(samePath)` with FORK DETECTION: `addMedia` returns the path
+ *     the host actually used, and a collision-renaming provider would
+ *     silently fork the document's reference — surface it instead.
+ *  4. The caller bumps mediaRevision (previews re-resolve, journal cache
+ *     rotates) only on success.
+ */
+
+interface GridSaveResult {
+    ok: boolean;
+    /** Path actually written (differs from requested on a host fork). */
+    savedPath?: string;
+    /** Human-readable caveats: fork detected, backup skipped, … */
+    notices: string[];
+    error?: string;
+}
+interface SaveCsvEditsOptions {
+    path: string;
+    originalBytes: ArrayBuffer;
+    csv: CsvSourceMeta;
+    journal: EditJournal;
+    mediaProvider: MediaProvider;
+    container: ContentContainer | null;
+}
+declare function saveCsvEdits(options: SaveCsvEditsOptions): Promise<GridSaveResult>;
+interface SaveXlsxEditsOptions {
+    path: string;
+    originalBytes: ArrayBuffer;
+    xlsx: XlsxSourceMeta;
+    journal: EditJournal;
+    /** Formula edits from the calc-engine session, keyed `"row:col"`. */
+    formulaEdits?: ReadonlyMap<string, FormulaEditRecord>;
+    mediaProvider: MediaProvider;
+    container: ContentContainer | null;
+}
+/**
+ * Save journal edits into an XLSX sidecar via in-place cell patching.
+ *
+ * Journal rowIds are BODY row indices within the region; the region's
+ * anchor (+ header offset) maps them back to sheet addresses. The patcher
+ * is all-or-nothing — a refused cell (formula/date, which the grid's lock
+ * predicate should have prevented) fails the whole save with its reason.
+ */
+declare function saveXlsxEdits(options: SaveXlsxEditsOptions): Promise<GridSaveResult>;
+
+/**
+ * Returns the heading position for the block owning a document position.
+ * A block begins at a top-level heading and continues until the next heading.
+ */
+declare function findOwningHeadingPosition(doc: Node, position: number): number | null;
+
 /**
  * TimelineViewExtension — mounts a WYSIWYG timeline editor over qualifying
  * authored timeline code fences while keeping the fence text as source of
@@ -3106,4 +3380,4 @@ declare function unshownSlidesWarning(total: number, unshown: number): string |
 /** The exact label of the review-state block-timings checkbox. */
 declare const SLIDE_TIMING_CHECKBOX_LABEL = "Update block timings when I save this narration";
 
-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, EditorHostMode, EmojiPicker, type EmojiPickerProps, FENCE_WIDGET_CONTAINED_EVENTS, type FenceBlockEntry, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, HOST_FENCE_KEY, type HeadingTransitionAttrs, HeadingWithTemplate, type HostFenceBlockEntry, HostFenceExtension, type HostFenceExtensionOptions, type HostFencePluginState, 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, type MermaidSurfaceScheme, 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 RecorderPanelMode, type RecorderSlide, RecorderSlidesPanel, type RecorderSlidesPanelProps, RecorderState, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, SLIDE_TIMING_CHECKBOX_LABEL, StatusBar, type StatusBarProps, Subscript, Superscript, 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, adaptThemeToSurface, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, buildRecorderSlideDeck, clampSlideIndex, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, containFenceWidgetEvents, detectLanguageFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findHostFenceBlockPos, findMermaidDiagramBlockPos, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isExpandedPanel, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, mapFenceEntries, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, mermaidSurfaceScheme, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, panelModeAfterToggle, parseTimelineForNode, partitionFiles, persistFromWrite, preloadMonaco, preloadMonacoSuggestions, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceHostFenceText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, resolveMermaidSurfaceTheme, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setBlockStartTimeInSource, setBlockTransitionInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, showSlideTimingCheckbox, sliceIndexAtOffset, slideStepForKey, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, unshownSlidesWarning, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMermaidSurfaceTheme, 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, CODE_SNIPPET_KEY, CODE_SNIPPET_LANGUAGES, CalcEngineFactory, CodeContext, CodeContextZones, type CodeSnippetBlockEntry, type CodeSnippetData, CodeSnippetExtension, type CodeSnippetExtensionOptions, type CodeSnippetLanguage, type CodeSnippetPluginState, CodeSnippetWidget, type CodeSnippetWidgetProps, CsvSourceMeta, type CustomTemplateContextValue, CustomTemplateProvider, type CustomTemplateProviderProps, type CustomThemeContextValue, CustomThemeProvider, type CustomThemeProviderProps, DATA_CARD_KEY, DEFAULT_MERMAID_DIAGRAM_TYPE, type DataCardBlockEntry, DataCardExtension, type DataCardExtensionOptions, type DataCardPluginState, DataCardWidget, type DataPreview, 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, FENCE_WIDGET_CONTAINED_EVENTS, type FenceBlockEntry, type FileCategory, type FileKind, type FolderEntry, FolderView, type FolderViewProps, FormulaEditRecord, type GridSaveResult, HOST_FENCE_KEY, type HeadingTransitionAttrs, type HeadingViewBinding, HeadingWithTemplate, type HostFenceBlockEntry, HostFenceExtension, type HostFenceExtensionOptions, type HostFencePluginState, 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, type MermaidSurfaceScheme, 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 RecorderPanelMode, type RecorderSlide, RecorderSlidesPanel, type RecorderSlidesPanelProps, RecorderState, type RepairableBlockEntry, RepairableDiagramExtension, type RepairableDiagramExtensionOptions, type RepairablePluginState, SLIDE_TIMING_CHECKBOX_LABEL, type SaveCsvEditsOptions, type SaveXlsxEditsOptions, StatusBar, type StatusBarProps, Subscript, Superscript, 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, XlsxSourceMeta, adaptThemeToSurface, addEdgeOp, addItemOp, addNodeOp, addTimelineEventOp, applyAsciiDiagramCommand, applyRepairCommand, applyTimelineCommand, applyTreeCommand, asciiDiagramToCanvas, buildRecorderSlideDeck, clampSlideIndex, classifyFile, codeSnippetFenceLanguageToken, codeSnippetLanguageLabel, codeSnippetMarkdown, containFenceWidgetEvents, dataExtensionOf, dataLinkHrefOf, detectLanguageFromFileName, draftPatchFromImportedTheme, findAsciiDiagramBlockPos, findCodeSnippetBlockPos, findDataCardBlockPos, findHostFenceBlockPos, findMermaidDiagramBlockPos, findOwningHeadingPosition, findRepairableBlockPos, findTimelineBlockPos, findTransitionEntry, findTreeBlockPos, formatSeconds, getBlockSlices, getTimelineForNode, indentItemOp, ingestForWrite, inspectMermaidSource, isAsciiSourceVisible, isCodeSnippetFenceLanguage, isCodeSnippetNode, isExpandedPanel, isMermaidDiagramNode, isMermaidFlowchartShapeId, isMermaidSourceVisible, isRepairableFence, isTimelineSourceSafeForSemanticEdit, lineToOffset, loadDataPreview, mapFenceEntries, markdownToTiptap, mermaidDiagramMarkdown, mermaidDiagramProperties, mermaidEditCapabilities, mermaidEditableTexts, mermaidErrorMessage, mermaidSurfaceScheme, monacoLanguageForFence, moveItemDownOp, moveItemUpOp, moveNodeOp, nextTimelineEventId, normalizeMermaidFlowchartShape, offsetToLine, outdentItemOp, panelModeAfterToggle, parseTimelineForNode, partitionFiles, persistFromWrite, preloadMonaco, preloadMonacoSuggestions, processDataFiles, processMediaFiles, processTextFile, processTextFiles, readBlockAttrsParams, readBlockAttrsTransition, readBlockAttrsValue, readHeadingLineTransition, readHeadingViewBinding, removeEdgeOp, removeItemOp, removeNodeOp, removeTimelineEventOp, renameItemOp, renameNodeOp, renderMermaidDiagram, replaceAsciiFenceText, replaceCodeSnippetText, replaceHostFenceText, replaceAsciiFenceText as replaceTreeFenceText, resizeNodeOp, resolveFileKind, resolveMermaidSurfaceTheme, sanitizeAsciiLabel, sanitizeTimelineText, sanitizeTreeLabel, saveCsvEdits, saveXlsxEdits, searchPickerEntries, setBlockAttrsValue, setBlockDurationInSource, setBlockStartTimeInSource, setBlockTransitionInSource, setHeadingAttrsTransition, setHeadingLineTransition, setMediaClipInSource, shouldPasteAsAsciiFence, shouldPasteAsTimelineFence, shouldPasteAsTreeFence, showSlideTimingCheckbox, sliceIndexAtOffset, slideStepForKey, spliceBlock, summarizeBlockProps, templateLabel, tiptapToMarkdown, toggleAsciiSource, toggleDirOp, toggleMermaidSource, transitionLabel, translateDiagramOp, unshownSlidesWarning, updateTimelineEventOp, useAsciiDiagramData, useBlockNavigator, useCodeSnippetData, useCustomTemplates, useCustomThemes, useDocCustomTemplates, useDocCustomThemes, useFileDrop, useMermaidDiagramData, useMermaidSurfaceTheme, useMonacoLoader, usePreviewSettings, useTimelineData, useTreeViewData, viewStateFromBinding, writeHeadingViewState };