@pixerate/editor 0.24.0 → 0.26.0

package/dist/{index-fJrlkJCd.d.ts → index-B273Zllk.d.ts}

@@ -3,13 +3,27 @@ import { C as ColorGradient, T as Template } from './tokens-D7yXvUU6.js';
 import { EditorState, PluginKey, Transaction } from '@tiptap/pm/state';
 import { DecorationSet, EditorView } from '@tiptap/pm/view';
 import { Node as Node$1 } from '@tiptap/pm/model';
-import { b as MentionOptions, d as TrackChangesOptions } from './track-changes-CDjCrwKe.js';
-import { MarkdownOptions } from 'tiptap-markdown';
+import * as _tiptap_extension_table_cell from '@tiptap/extension-table-cell';
+import * as _tiptap_extension_table_header from '@tiptap/extension-table-header';
+import * as _tiptap_extension_table_row from '@tiptap/extension-table-row';
+import * as _tiptap_extension_table from '@tiptap/extension-table';
+import * as _tiptap_extension_underline from '@tiptap/extension-underline';
+import * as _tiptap_extension_text_style from '@tiptap/extension-text-style';
+import * as _tiptap_extension_text_align from '@tiptap/extension-text-align';
+import * as _tiptap_extension_task_list from '@tiptap/extension-task-list';
+import * as _tiptap_extension_link from '@tiptap/extension-link';
+import * as _tiptap_extension_image from '@tiptap/extension-image';
 import { ImageOptions as ImageOptions$1 } from '@tiptap/extension-image';
-import { R as ReviewAuthor, b as CommentStore, C as CommentAnchor } from './comment-store-BEMgVlAA.js';
-import { c as ImportAdapter, I as ImportAdapterRegistry, b as FindImportAdapterQuery, i as ImportTarget, h as ImportInput, g as ImportFileOptions, a as ImportOutcome, R as RegisterImportAdapterOptions, F as FileLike } from './registry-GJI4gToU.js';
-import { b as CompareSource, C as CompareDocumentsOptions, a as CompareDocumentsResult } from './documents-BQjzJNe2.js';
-import { c as CommandSpec } from './registry-evKTP4ls.js';
+import * as _tiptap_extension_highlight from '@tiptap/extension-highlight';
+import * as _tiptap_extension_color from '@tiptap/extension-color';
+import * as _tiptap_starter_kit from '@tiptap/starter-kit';
+import { f as MentionOptions, h as TrackChangesOptions } from './track-changes-Db_fGEvx.js';
+import { MarkdownOptions } from 'tiptap-markdown';
+import { R as ReviewAuthor, b as CommentStore, C as CommentAnchor, S as SerializedComments } from './comment-store-BEMgVlAA.js';
+import { e as StyleRegistry, c as StyleDefinition, P as ParagraphFormat, C as CharacterFormat } from './registry-CED5C0lA.js';
+import { b as ImportAdapter, I as ImportAdapterRegistry, c as FindImportAdapterQuery, i as ImportTarget, h as ImportInput, g as ImportFileOptions, a as ImportOutcome, R as RegisterImportAdapterOptions, F as FileLike } from './registry-CEgwXED1.js';
+import { b as CompareSource, C as CompareDocumentsOptions, a as CompareDocumentsResult } from './documents-CHT1U5Vs.js';
+import { C as CommandSpec } from './registry-DhVUZioj.js';
 
 interface GradientTextOptions {
     templateColorMap: Map<string, ColorGradient>;
@@ -352,12 +366,162 @@ declare const Comments: Mark<CommentsOptions, CommentsStorage>;
 /** The current author configured on an editor's `Comments` extension. */
 declare function getCommentAuthor(editor: Editor | null | undefined): ReviewAuthor | null;
 
+/** A positioned piece of text, e.g. a pdf.js text item. */
+interface PdfTextRun {
+    text: string;
+    /** Left edge (points). */
+    x: number;
+    /** Baseline, y up (points). */
+    y: number;
+    /** Advance width (points). Estimated from the text length when missing. */
+    width?: number;
+    /** Font size (points). Falls back to `height`, then 10. */
+    fontSize?: number;
+    height?: number;
+    /** Font name; `Bold` / `Italic` / `Oblique` in it set the style when `bold` / `italic` are absent. */
+    fontName?: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+/** A stroked line or thin filled rectangle on a page (table rules). */
+interface PdfRuleLine {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+interface PdfLayoutPage {
+    runs: readonly PdfTextRun[];
+    /** Ruling lines, when the extractor can read the page's vector graphics. */
+    rules?: readonly PdfRuleLine[];
+}
+interface PdfLayoutOptions {
+    /**
+     * A baseline gap larger than this multiple of the typical line pitch starts
+     * a new paragraph (default `1.4`).
+     */
+    paragraphGap?: number;
+    /** Remove running headers, footers and page numbers repeated across pages (default `true`). */
+    removeHeadersAndFooters?: boolean;
+    /** Read multi-column pages column by column (default `true`). */
+    detectColumns?: boolean;
+    /** Detect headings from font size and weight (default `true`). */
+    detectHeadings?: boolean;
+    /** Detect bulleted and numbered lists (default `true`). */
+    detectLists?: boolean;
+    /** Detect tables from ruling lines and aligned columns (default `true`). */
+    detectTables?: boolean;
+    /** Re-join words hyphenated across line ends (default `true`). */
+    dehyphenate?: boolean;
+}
+interface PdfTableCell {
+    text: string;
+    colSpan: number;
+    rowSpan: number;
+    header: boolean;
+}
+type PdfLayoutBlock = {
+    type: "heading";
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    text: string;
+    page: number;
+    confidence: number;
+} | {
+    type: "paragraph";
+    text: string;
+    page: number;
+} | {
+    type: "list";
+    page: number;
+    confidence: number;
+    /** Items in order; `depth` 0 is the outermost level and grows by at most one per item. */
+    items: {
+        text: string;
+        depth: number;
+        ordered: boolean;
+        start?: number;
+    }[];
+} | {
+    type: "table";
+    page: number;
+    confidence: number;
+    /** `true` when the grid came from ruling lines. */
+    ruled: boolean;
+    /** Rows of cells; cells covered by a span are left out. */
+    rows: PdfTableCell[][];
+    columns: number;
+    headerRows: number;
+};
+/** One detected structure, for import reports. */
+interface ImportStructureItem {
+    type: "heading" | "list" | "table" | "columns";
+    /** 1-based page. */
+    page: number;
+    /** 0–1. */
+    confidence: number;
+    /** Short human-readable description, e.g. `H2 "Results"` or `3×4 table`. */
+    detail: string;
+}
+/**
+ * What a structure-aware importer recognised. Adapters attach it to
+ * `DocumentImport.structure`; `summarizeImportStructure` aggregates it.
+ */
+interface ImportStructureReport {
+    /** `"plain"` when structure detection was off (paragraphs only). */
+    mode: "structured" | "plain";
+    counts: {
+        headings: number;
+        lists: number;
+        tables: number;
+        paragraphs: number;
+    };
+    /** Pages read as several columns. */
+    multiColumnPages: number;
+    /** Mean confidence of the detected structures (1 when nothing was detected). */
+    confidence: number;
+    items: ImportStructureItem[];
+}
+interface PdfStructureReport extends ImportStructureReport {
+    pages: number;
+    removed: {
+        headers: number;
+        footers: number;
+        pageNumbers: number;
+    };
+    /** Words re-joined across a line-end hyphen. */
+    dehyphenated: number;
+}
+interface PdfLayoutResult {
+    blocks: PdfLayoutBlock[];
+    report: PdfStructureReport;
+}
+/**
+ * Analyses positioned text runs (one entry per page) and returns blocks in
+ * reading order plus a report of what was detected.
+ */
+declare function analyzePdfLayout(pages: readonly PdfLayoutPage[], options?: PdfLayoutOptions): PdfLayoutResult;
+/** Renders layout blocks as editor HTML (`h1`–`h6`, `p`, `ul`/`ol`, `table`). Text is escaped. */
+declare function pdfLayoutBlocksToHtml(blocks: readonly PdfLayoutBlock[]): string;
+
 /** Result of every `document` adapter: sanitized TipTap HTML plus plain text. */
 interface DocumentImport {
     /** Sanitized HTML ready for `setContent` / `insertContent`. */
     html: string;
     /** Plain-text version, used by plain-text (prompt) editors. */
     text: string;
+    /**
+     * What a structure-aware importer recognised (headings, lists, tables,
+     * columns) with confidences; set by the PDF adapter.
+     */
+    structure?: ImportStructureReport;
+    /**
+     * Comment threads (with replies and resolved state) whose ranges the HTML
+     * marks with `data-comment-id`; set by the DOCX adapter. Load them into the
+     * editor's comment store, e.g. with `applyImportedReviewData`.
+     */
+    comments?: SerializedComments;
+    /** Paragraph and character styles the file defines; set by the DOCX adapter. */
+    styles?: StyleRegistry;
 }
 type DocumentImportAdapter = ImportAdapter<DocumentImport>;
 /**
@@ -396,6 +560,8 @@ declare function getImportAccept(target?: ImportTarget): string;
 interface FileImportOptions {
     /** Registry used to match files (default: the shared default registry). */
     registry?: ImportAdapterRegistry;
+    /** Per-adapter options keyed by adapter id, e.g. `{ pdf: { structure: false } }`. */
+    adapterOptions?: Record<string, unknown>;
     /** Insert extracted plain text instead of HTML (plain-text / prompt editors). */
     asPlainText?: boolean;
     /** Import files dropped onto the editor (default `true`). */
@@ -1161,6 +1327,187 @@ declare function formatFindStatus(s: Pick<FindReplaceSnapshot, "query" | "matche
  */
 declare const FindReplace: Extension<FindReplaceOptions, FindReplaceStorage>;
 
+/** Node attribute naming a block's paragraph style (`data-style` in HTML). */
+declare const STYLE_ID_ATTRIBUTE = "styleId";
+/** Mark applying a character style (`<span data-char-style>`). */
+declare const CHARACTER_STYLE_MARK_NAME = "characterStyle";
+interface ParagraphStylesOptions {
+    /** The style registry. Defaults to a new registry with the built-in styles per editor. */
+    registry: StyleRegistry | null;
+    /** Block types that carry the `styleId` attribute. */
+    types: string[];
+    /**
+     * Inject a `<style>` element with `registry.toCSS({ scope })` while the
+     * editor exists (kept up to date). Default `true`.
+     */
+    injectCSS: boolean;
+    /** Selector the injected CSS is scoped to. Default `.ProseMirror`. */
+    cssScope: string;
+    /** Nonce of the injected `<style>` element (Content Security Policy). */
+    cssNonce?: string;
+    /**
+     * Applying a paragraph style to a partial selection inside one paragraph
+     * applies its linked character style instead (as in Word). Default `true`.
+     */
+    linkedCharacterStyles: boolean;
+}
+interface ParagraphStylesStorage {
+    registry: StyleRegistry;
+}
+interface CreateStyleFromSelectionOptions {
+    /** Id of the new style. Default: derived from the name. */
+    id?: string;
+    /** Base style. Default: the style at the selection. */
+    basedOn?: string | null;
+    /** Apply the new style to the selected paragraphs. Default `true`. */
+    apply?: boolean;
+}
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        paragraphStyles: {
+            /** Applies a paragraph style to the selected blocks (changing headings/code blocks as the style needs). */
+            setParagraphStyle: (id: string) => ReturnType;
+            /** Resets the selected blocks to the Normal style. */
+            clearParagraphStyle: () => ReturnType;
+            /** Applies a character style to the selection. */
+            setCharacterStyle: (id: string) => ReturnType;
+            unsetCharacterStyle: () => ReturnType;
+            /**
+             * Updates a style (default: the style at the selection) to the direct
+             * formatting at the selection ("Update to match selection").
+             */
+            updateParagraphStyleFromSelection: (id?: string) => ReturnType;
+            /** Creates a paragraph style from the formatting at the selection ("New style from selection"). */
+            createParagraphStyleFromSelection: (name: string, options?: CreateStyleFromSelectionOptions) => ReturnType;
+        };
+    }
+}
+declare const paragraphStylesPluginKey: PluginKey<any>;
+/** The style registry of an editor using `ParagraphStyles`. */
+declare function getStyleRegistry(editor: Editor | null | undefined): StyleRegistry | null;
+/**
+ * Whether a paragraph style can be applied in this editor: its block type is
+ * in the schema (and, for headings, its level is configured).
+ */
+declare function isParagraphStyleAvailable(editor: Editor, registry: StyleRegistry, id: string): boolean;
+/** The paragraph style of the textblock at `pos` (defaults to the selection start). */
+declare function getParagraphStyleAt(state: EditorState, registry: StyleRegistry, pos?: number): string | null;
+/**
+ * The direct formatting at the selection, as style formats: bold, italic,
+ * underline, strike, font family/size, color and highlight from marks, and
+ * the alignment of the block.
+ */
+declare function captureSelectionFormat(state: EditorState): {
+    paragraph: ParagraphFormat;
+    character: CharacterFormat;
+};
+/** Character style applied to a run of text. */
+declare const CharacterStyle: Mark<any, any>;
+/**
+ * Paragraph styles (Normal, Title, Heading 1, …) from a `StyleRegistry`:
+ * a `styleId` attribute on paragraphs and headings (`data-style` in HTML),
+ * a `characterStyle` mark, apply/clear/update/create commands, next-style
+ * on Enter and an injected stylesheet. Headings without a `styleId` use
+ * Heading N, plain paragraphs Normal, so existing documents are unchanged.
+ */
+declare const ParagraphStyles: Extension<ParagraphStylesOptions, ParagraphStylesStorage>;
+interface ParagraphStylesSnapshot {
+    /** Paragraph styles for the gallery (quick, not hidden, available in this editor). */
+    gallery: readonly StyleDefinition[];
+    /** All paragraph styles available in this editor. */
+    styles: readonly StyleDefinition[];
+    /** Character styles. */
+    characterStyles: readonly StyleDefinition[];
+    /** The style of the block at the selection. */
+    currentStyleId: string | null;
+    /** Registry version (changes when styles change). */
+    version: number;
+}
+interface ParagraphStylesStore {
+    getSnapshot(): ParagraphStylesSnapshot;
+    subscribe(listener: () => void): () => void;
+    destroy(): void;
+}
+/**
+ * External store over an editor's paragraph styles and the style at the
+ * selection, for `useSyncExternalStore` and Svelte runes. Snapshots change
+ * only when the styles or the current style change. Listeners are attached
+ * to the editor only while subscribed.
+ */
+declare function createParagraphStylesStore(editor: Editor | null | undefined): ParagraphStylesStore;
+
+/** Horizontal alignment of a table cell (`align` attribute). */
+type TableCellAlignment = "left" | "center" | "right" | "justify";
+/** Returns a valid cell alignment, or `null`. */
+declare function normalizeTableCellAlignment(value: unknown): TableCellAlignment | null;
+/** Returns a safe CSS color for a cell background, or `null`. */
+declare function normalizeTableCellColor(value: unknown): string | null;
+/**
+ * Whether a table can be written as a GFM pipe table: the first row is all
+ * header cells, the other rows have none, no cell spans rows or columns, and
+ * every cell holds a single paragraph.
+ */
+declare function isGfmTable(node: Node$1): boolean;
+interface RichTextTableOptions {
+    /** Drag column borders to resize columns (stored as `colwidth`). Default `true`. */
+    resizable: boolean;
+    /** Width of the resize handle in pixels. Default 5. */
+    handleWidth: number;
+    /** Minimum cell width in pixels. Default 25. */
+    cellMinWidth: number;
+    /** Whether the last column can be resized. Default `true`. */
+    lastColumnResizable: boolean;
+    /** Allow selecting the whole table as a node (click its border, Esc from a cell selection). Default `true`. */
+    allowTableNodeSelection: boolean;
+    /** HTML attributes of the `<table>` element. */
+    HTMLAttributes: Record<string, any>;
+    /** HTML attributes of `<td>` elements. */
+    cellHTMLAttributes: Record<string, any>;
+    /** HTML attributes of `<th>` elements. */
+    headerHTMLAttributes: Record<string, any>;
+    /** HTML attributes of `<tr>` elements. */
+    rowHTMLAttributes: Record<string, any>;
+}
+declare const DEFAULT_TABLE_OPTIONS: RichTextTableOptions;
+/** TipTap's `Table` with the GFM-aware markdown serializer. */
+declare const Table: any;
+declare const TableRow: any;
+/** TipTap's `TableCell` plus `align` and `backgroundColor` attributes. */
+declare const TableCell: any;
+/** TipTap's `TableHeader` plus `align` and `backgroundColor` attributes. */
+declare const TableHeader: any;
+/**
+ * The table extensions (`table`, `tableRow`, `tableHeader`, `tableCell`)
+ * configured for rich documents: resizable columns, header rows, columns and
+ * cells, `colspan` / `rowspan` from imported HTML, cell alignment and
+ * background, table node selection and GFM markdown. `createRichTextPreset`
+ * adds them unless `table: false`.
+ */
+declare function createTableExtensions(options?: Partial<RichTextTableOptions>): Extensions;
+
+/**
+ * The TipTap packages whose commands the preset installs. Exported only so the
+ * published declarations import them: each package augments `@tiptap/core`'s
+ * `Commands` interface, which is what types `editor.chain().toggleBold()`,
+ * `toggleHeading()`, `setTextAlign()` and so on for apps that use the preset
+ * without depending on those packages themselves. (Triple-slash references are
+ * dropped by the declaration bundler, and runtime imports leave no trace in .d.ts.)
+ */
+type RichTextPresetCommandPackages = [
+    typeof _tiptap_starter_kit,
+    typeof _tiptap_extension_color,
+    typeof _tiptap_extension_highlight,
+    typeof _tiptap_extension_image,
+    typeof _tiptap_extension_link,
+    typeof _tiptap_extension_task_list,
+    typeof _tiptap_extension_text_align,
+    typeof _tiptap_extension_text_style,
+    typeof _tiptap_extension_underline,
+    typeof _tiptap_extension_table,
+    typeof _tiptap_extension_table_row,
+    typeof _tiptap_extension_table_header,
+    typeof _tiptap_extension_table_cell
+];
 interface RichTextPresetOptions {
     placeholder?: string | ((props: {
         node: any;
@@ -1199,6 +1546,19 @@ interface RichTextPresetOptions {
     crossReferences?: Partial<CrossReferenceOptions> | boolean;
     /** Word-style Find and Replace (Mod+F / Mod+H, match highlights). Off by default. */
     findReplace?: Partial<FindReplaceOptions> | boolean;
+    /**
+     * Paragraph styles (Normal, Title, Heading 1–6, Quote, …) with a style
+     * registry, `data-style` attributes and next-style on Enter. Off by default.
+     */
+    paragraphStyles?: Partial<ParagraphStylesOptions> | boolean;
+    /**
+     * Tables (`table`, `tableRow`, `tableHeader`, `tableCell`): resizable
+     * columns, header rows/columns/cells, `colspan`/`rowspan` (e.g. from PDF
+     * and DOCX import), cell alignment and background, GFM markdown. **On by
+     * default**; `table: false` leaves tables out of the schema, so pasted or
+     * imported tables are flattened into paragraphs as before.
+     */
+    table?: Partial<RichTextTableOptions> | boolean;
 }
 /**
  * Creates a standard rich-text extensions bundle with full formatting support.
@@ -1262,4 +1622,137 @@ declare function createFindReplaceCommands(editor: Editor, options?: FindReplace
 /** Validates Find text without an editor (e.g. to show an error while typing). */
 declare function validateFindPattern(query: string, options?: FindOptions): FindPatternError | null;
 
-export { FindReplaceStore as $, type AddCommentOptions as A, BUILT_IN_IMPORT_ADAPTERS as B, COMMENT_MARK_NAME as C, type DocumentImport as D, type DocumentSearchOptions as E, type DocumentSearchResult as F, type DocumentStructureCommandArgs as G, type DocumentStructureCommandItem as H, EMPTY_FIND_REPLACE_SNAPSHOT as I, type EditorCompareOptions as J, FIND_OPTION_TOGGLES as K, FIND_PARAGRAPH_MARK as L, FileImport as M, type FileImportOptions as N, type FindAllOptions as O, type FindAllResult as P, type FindMatch as Q, type FindOptionToggle as R, type FindOptions as S, type FindPatternError as T, type FindPatternErrorCode as U, FindReplace as V, type FindReplaceCommandOptions as W, type FindReplaceMode as X, type FindReplaceOptions as Y, type FindReplaceSnapshot as Z, type FindReplaceStorage as _, type DocumentImportAdapter as a, fileImportPluginKey as a$, type FocusHeadingOptions as a0, FontSize as a1, Footnote as a2, type FootnoteInfo as a3, FootnoteReference as a4, Footnotes as a5, type FootnotesOptions as a6, GradientText as a7, type GradientTextOptions as a8, Image as a9, SlashCommands as aA, type SlashCommandsOptions as aB, SmilieReplacer as aC, TableOfContents as aD, type TableOfContentsEntry as aE, type TableOfContentsOptions as aF, TemplateSuggestions as aG, type TemplateSuggestionsOptions as aH, applyDocumentComparison as aI, applyReplacements as aJ, autocorrectPluginKey as aK, buildOutlineTree as aL, capitalizeSentenceRules as aM, commentsPluginKey as aN, compareInEditor as aO, compileFindPattern as aP, computeOutline as aQ, createFindReplaceCommands as aR, createImportAdapterRegistry as aS, createOutlineStore as aT, createRichTextPreset as aU, createSearchBudget as aV, crossReferencePluginKey as aW, defaultAutocorrectRules as aX, defaultImportRegistry as aY, documentStructureCommandItems as aZ, expandReplacement as a_, type ImageOptions as aa, type InsertFootnoteOptions as ab, type InsertTableOfContentsOptions as ac, LoadingNode as ad, MAX_FIND_PATTERN_LENGTH as ae, Markdown as af, type OpenFindReplaceParams as ag, Outline as ah, type OutlineHeading as ai, type OutlineOptions as aj, type OutlineSnapshot as ak, type OutlineStorage as al, type OutlineStore as am, type OutlineTreeItem as an, type PatternMatch as ao, type ReplacePiece as ap, RichClipboard as aq, type RichClipboardOptions as ar, type RichClipboardStorage as as, type RichTextPresetOptions as at, SMILIE_REPLACEMENTS as au, type SearchBudget as av, type SearchBudgetOptions as aw, type SetBookmarkOptions as ax, type SetSearchParams as ay, type SlashCommandMatchData as az, Autocorrect as b, findAllMatches as b0, findAutocorrection as b1, findCommentRanges as b2, findHexColors as b3, findImportAdapter as b4, findReplacePluginKey as b5, foldCodePoint as b6, footnotesMarkdownIt as b7, footnotesPluginKey as b8, formatFindStatus as b9, registerImportAdapter as bA, removeImageNode as bB, richClipboardPluginKey as bC, rtfImportAdapter as bD, searchDocument as bE, smartQuoteRules as bF, smilieAutocorrectRules as bG, symbolRules as bH, syncFootnotes as bI, tableOfContentsMarkdownIt as bJ, tableOfContentsPluginKey as bK, twoInitialCapitalsRules as bL, unregisterImportAdapter as bM, updateImageSrc as bN, validateFindPattern as bO, writeRichClipboard as bP, fractionRules as ba, getActiveHeading as bb, getBookmarks as bc, getCommentAnchors as bd, getCommentAuthor as be, getCommentIdsAt as bf, getCommentStore as bg, getCrossReferenceTargets as bh, getDocumentStructureCommandItems as bi, getFindReplaceState as bj, getFindReplaceStore as bk, getFootnotes as bl, getImportAccept as bm, getOutline as bn, getTableOfContentsEntries as bo, handleImageInsertion as bp, htmlImportAdapter as bq, imagePastePluginKey as br, importFile as bs, insertImageNode as bt, isInsidePromptToken as bu, markdownImportAdapter as bv, navigateToHeading as bw, outlinePluginKey as bx, parseReplacement as by, plainTextImportAdapter as bz, type AutocorrectContext as c, type AutocorrectCorrection as d, type AutocorrectOptions as e, type AutocorrectRule as f, type AutocorrectStorage as g, Bookmark as h, type BookmarkInfo as i, type BookmarkOptions as j, ColorHighlighter as k, type CommentRange as l, Comments as m, type CommentsOptions as n, type CommentsStorage as o, type CompileFindPatternResult as p, type CompiledFindPattern as q, type CreateImportAdapterRegistryOptions as r, CrossReference as s, type CrossReferenceOptions as t, type CrossReferenceTarget as u, type CrossReferenceTargetType as v, DEFAULT_AUTOCORRECT_EXCEPTIONS as w, DocumentCompare as x, type DocumentCompareOptions as y, type DocumentCompareStorage as z };
+/** Table operations shared by the command registry, the toolbars and agent tools. */
+type TableAction = "insertTable" | "addRowBefore" | "addRowAfter" | "deleteRow" | "addColumnBefore" | "addColumnAfter" | "deleteColumn" | "deleteTable" | "mergeCells" | "splitCell" | "toggleHeaderRow" | "toggleHeaderColumn" | "toggleHeaderCell" | "goToNextCell" | "goToPreviousCell" | "setCellAlignment" | "setCellBackground";
+/** Parameters of `insertTable`, `setCellAlignment` and `setCellBackground`. */
+interface TableActionParams {
+    /** `insertTable`: number of rows (1–100, default 3). */
+    rows?: number;
+    /** `insertTable`: number of columns (1–50, default 3). */
+    cols?: number;
+    /** `insertTable`: make the first row a header row (default `true`). */
+    withHeaderRow?: boolean;
+    /** `setCellAlignment`: `left`, `center`, `right`, `justify`, or `null` to clear. */
+    align?: TableCellAlignment | null;
+    /** `setCellBackground`: a CSS color, or `null` to clear. */
+    color?: string | null;
+}
+interface TableActionInfo {
+    action: TableAction;
+    label: string;
+    description: string;
+    keywords: readonly string[];
+}
+/** Every table action with its label, in toolbar order. */
+declare const TABLE_ACTIONS: readonly TableActionInfo[];
+/** A button of the table toolbars (`TableToolbar` in React and Svelte). */
+interface TableToolbarItem {
+    /** Unique id (also the button's `data-action`). */
+    id: string;
+    action: TableAction;
+    params?: TableActionParams;
+    /** Short button text. */
+    label: string;
+    /** Accessible name and tooltip. */
+    title: string;
+    /** Items of one group are separated from the next group. */
+    group: string;
+    /** Toggle buttons: whether the button shows as pressed. */
+    active?: (state: TableState) => boolean;
+}
+/** The default table toolbar: rows, columns, cells, headers, alignment, delete. */
+declare const DEFAULT_TABLE_TOOLBAR: readonly TableToolbarItem[];
+declare const MAX_TABLE_ROWS = 100;
+declare const MAX_TABLE_COLUMNS = 50;
+/** Whether the editor's schema has the table nodes (`createRichTextPreset({ table })`). */
+declare function isTableEnabled(editor: Editor | null | undefined): boolean;
+/** Whether the selection (cursor, text or cell selection) is inside a table. */
+declare function isSelectionInTable(state: EditorState): boolean;
+/**
+ * `shouldShow` for a table bubble menu (TipTap's `BubbleMenuPlugin`): shown
+ * while an editable editor's selection is in a table, even a collapsed cursor.
+ */
+declare function shouldShowTableBubbleMenu({ editor, state }: {
+    editor: Editor;
+    state: EditorState;
+}): boolean;
+/**
+ * Whether a table action can run: `true`, or the reason it cannot (e.g.
+ * "Place the cursor in a table first.").
+ */
+declare function getTableActionState(editor: Editor | null | undefined, action: TableAction, params?: TableActionParams): true | string;
+interface RunTableActionOptions {
+    /** Focus the editor (toolbars). Default `false`. */
+    focus?: boolean;
+}
+/**
+ * Runs a table action. Returns `false` (and changes nothing) when it cannot
+ * run; check `getTableActionState` for the reason.
+ */
+declare function runTableAction(editor: Editor | null | undefined, action: TableAction, params?: TableActionParams, options?: RunTableActionOptions): boolean;
+interface TableActionStatus {
+    enabled: boolean;
+    /** Why the action cannot run (only when `enabled` is false). */
+    reason?: string;
+}
+/** The table at the selection and what can be done there. */
+interface TableState {
+    /** The schema has tables. */
+    enabled: boolean;
+    /** The selection is inside a table. */
+    inTable: boolean;
+    /** Cells are selected (a `CellSelection`). */
+    cellSelection: boolean;
+    /** Size of the table (0 outside a table). */
+    rows: number;
+    columns: number;
+    /** Row and column (0-based) of the selection's first cell, or -1. */
+    row: number;
+    column: number;
+    /** The first row / first column are all header cells. */
+    headerRow: boolean;
+    headerColumn: boolean;
+    /** The cell at the selection is a header cell. */
+    headerCell: boolean;
+    /** Alignment / background of the cell at the selection. */
+    cellAlignment: TableCellAlignment | null;
+    cellBackground: string | null;
+    /** Enablement of every action (with the default params). */
+    actions: Record<TableAction, TableActionStatus>;
+}
+declare const EMPTY_TABLE_STATE: TableState;
+/** Computes the table state at the editor's selection. */
+declare function getTableState(editor: Editor | null | undefined): TableState;
+interface TableStore {
+    getSnapshot(): TableState;
+    subscribe(listener: () => void): () => void;
+    destroy(): void;
+}
+/**
+ * An external store of `getTableState(editor)` for UI bindings (React's
+ * `useSyncExternalStore`, Svelte runes). The snapshot object only changes
+ * when the state does, and the store listens to the editor only while it
+ * has subscribers.
+ */
+declare function createTableStore(editor: Editor | null | undefined): TableStore;
+
+interface TableCommandOptions {
+    /** Id prefix (default `table.`). */
+    prefix?: string;
+    group?: string;
+    scope?: string;
+    /** Focus the editor when a command runs (default `true`, for menus and the palette). */
+    focus?: boolean;
+}
+/**
+ * Table commands for the command registry (`@pixerate/editor/commands`):
+ * `table.insertTable` (`{ rows, cols, withHeaderRow }`), row and column
+ * insertion/deletion, `table.deleteTable`, `table.mergeCells` /
+ * `table.splitCell`, header toggles, cell navigation and
+ * `table.setCellAlignment` / `table.setCellBackground`. Disabled commands
+ * explain why ("Place the cursor in a table first."). Requires the table
+ * extensions (`createRichTextPreset`'s default `table` option).
+ */
+declare function createTableCommands(editor: Editor, options?: TableCommandOptions): CommandSpec[];
+
+export { type FindOptionToggle as $, type AddCommentOptions as A, BUILT_IN_IMPORT_ADAPTERS as B, CHARACTER_STYLE_MARK_NAME as C, type DocumentImport as D, type CrossReferenceTarget as E, type CrossReferenceTargetType as F, DEFAULT_AUTOCORRECT_EXCEPTIONS as G, DEFAULT_TABLE_OPTIONS as H, DEFAULT_TABLE_TOOLBAR as I, DocumentCompare as J, type DocumentCompareOptions as K, type DocumentCompareStorage as L, type DocumentSearchOptions as M, type DocumentSearchResult as N, type DocumentStructureCommandArgs as O, type PdfStructureReport as P, type DocumentStructureCommandItem as Q, EMPTY_FIND_REPLACE_SNAPSHOT as R, EMPTY_TABLE_STATE as S, type EditorCompareOptions as T, FIND_OPTION_TOGGLES as U, FIND_PARAGRAPH_MARK as V, FileImport as W, type FileImportOptions as X, type FindAllOptions as Y, type FindAllResult as Z, type FindMatch as _, type DocumentImportAdapter as a, SlashCommands as a$, type FindOptions as a0, type FindPatternError as a1, type FindPatternErrorCode as a2, FindReplace as a3, type FindReplaceCommandOptions as a4, type FindReplaceMode as a5, type FindReplaceOptions as a6, type FindReplaceSnapshot as a7, type FindReplaceStorage as a8, FindReplaceStore as a9, type OutlineStore as aA, type OutlineTreeItem as aB, ParagraphStyles as aC, type ParagraphStylesOptions as aD, type ParagraphStylesSnapshot as aE, type ParagraphStylesStorage as aF, type ParagraphStylesStore as aG, type PatternMatch as aH, type PdfLayoutBlock as aI, type PdfLayoutPage as aJ, type PdfLayoutResult as aK, type PdfTableCell as aL, type ReplacePiece as aM, RichClipboard as aN, type RichClipboardOptions as aO, type RichClipboardStorage as aP, type RichTextPresetCommandPackages as aQ, type RichTextPresetOptions as aR, type RichTextTableOptions as aS, type RunTableActionOptions as aT, SMILIE_REPLACEMENTS as aU, STYLE_ID_ATTRIBUTE as aV, type SearchBudget as aW, type SearchBudgetOptions as aX, type SetBookmarkOptions as aY, type SetSearchParams as aZ, type SlashCommandMatchData as a_, type FocusHeadingOptions as aa, FontSize as ab, Footnote as ac, type FootnoteInfo as ad, FootnoteReference as ae, Footnotes as af, type FootnotesOptions as ag, GradientText as ah, type GradientTextOptions as ai, Image as aj, type ImageOptions as ak, type ImportStructureItem as al, type ImportStructureReport as am, type InsertFootnoteOptions as an, type InsertTableOfContentsOptions as ao, LoadingNode as ap, MAX_FIND_PATTERN_LENGTH as aq, MAX_TABLE_COLUMNS as ar, MAX_TABLE_ROWS as as, Markdown as at, type OpenFindReplaceParams as au, Outline as av, type OutlineHeading as aw, type OutlineOptions as ax, type OutlineSnapshot as ay, type OutlineStorage as az, type PdfLayoutOptions as b, getCommentStore as b$, type SlashCommandsOptions as b0, SmilieReplacer as b1, TABLE_ACTIONS as b2, Table as b3, type TableAction as b4, type TableActionInfo as b5, type TableActionParams as b6, type TableActionStatus as b7, TableCell as b8, type TableCellAlignment as b9, createRichTextPreset as bA, createSearchBudget as bB, createTableCommands as bC, createTableExtensions as bD, createTableStore as bE, crossReferencePluginKey as bF, defaultAutocorrectRules as bG, defaultImportRegistry as bH, documentStructureCommandItems as bI, expandReplacement as bJ, fileImportPluginKey as bK, findAllMatches as bL, findAutocorrection as bM, findCommentRanges as bN, findHexColors as bO, findImportAdapter as bP, findReplacePluginKey as bQ, foldCodePoint as bR, footnotesMarkdownIt as bS, footnotesPluginKey as bT, formatFindStatus as bU, fractionRules as bV, getActiveHeading as bW, getBookmarks as bX, getCommentAnchors as bY, getCommentAuthor as bZ, getCommentIdsAt as b_, type TableCommandOptions as ba, TableHeader as bb, TableOfContents as bc, type TableOfContentsEntry as bd, type TableOfContentsOptions as be, TableRow as bf, type TableState as bg, type TableStore as bh, type TableToolbarItem as bi, TemplateSuggestions as bj, type TemplateSuggestionsOptions as bk, analyzePdfLayout as bl, applyDocumentComparison as bm, applyReplacements as bn, autocorrectPluginKey as bo, buildOutlineTree as bp, capitalizeSentenceRules as bq, captureSelectionFormat as br, commentsPluginKey as bs, compareInEditor as bt, compileFindPattern as bu, computeOutline as bv, createFindReplaceCommands as bw, createImportAdapterRegistry as bx, createOutlineStore as by, createParagraphStylesStore as bz, type PdfRuleLine as c, getCrossReferenceTargets as c0, getDocumentStructureCommandItems as c1, getFindReplaceState as c2, getFindReplaceStore as c3, getFootnotes as c4, getImportAccept as c5, getOutline as c6, getParagraphStyleAt as c7, getStyleRegistry as c8, getTableActionState as c9, searchDocument as cA, shouldShowTableBubbleMenu as cB, smartQuoteRules as cC, smilieAutocorrectRules as cD, symbolRules as cE, syncFootnotes as cF, tableOfContentsMarkdownIt as cG, tableOfContentsPluginKey as cH, twoInitialCapitalsRules as cI, unregisterImportAdapter as cJ, updateImageSrc as cK, validateFindPattern as cL, writeRichClipboard as cM, getTableOfContentsEntries as ca, getTableState as cb, handleImageInsertion as cc, htmlImportAdapter as cd, imagePastePluginKey as ce, importFile as cf, insertImageNode as cg, isGfmTable as ch, isInsidePromptToken as ci, isParagraphStyleAvailable as cj, isSelectionInTable as ck, isTableEnabled as cl, markdownImportAdapter as cm, navigateToHeading as cn, normalizeTableCellAlignment as co, normalizeTableCellColor as cp, outlinePluginKey as cq, paragraphStylesPluginKey as cr, parseReplacement as cs, pdfLayoutBlocksToHtml as ct, plainTextImportAdapter as cu, registerImportAdapter as cv, removeImageNode as cw, richClipboardPluginKey as cx, rtfImportAdapter as cy, runTableAction as cz, type PdfTextRun as d, Autocorrect as e, type AutocorrectContext as f, type AutocorrectCorrection as g, type AutocorrectOptions as h, type AutocorrectRule as i, type AutocorrectStorage as j, Bookmark as k, type BookmarkInfo as l, type BookmarkOptions as m, COMMENT_MARK_NAME as n, CharacterStyle as o, ColorHighlighter as p, type CommentRange as q, Comments as r, type CommentsOptions as s, type CommentsStorage as t, type CompileFindPatternResult as u, type CompiledFindPattern as v, type CreateImportAdapterRegistryOptions as w, type CreateStyleFromSelectionOptions as x, CrossReference as y, type CrossReferenceOptions as z };