@pixerate/editor-react 0.15.0 → 0.17.0

package/dist/index.d.cts

@@ -1,18 +1,22 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, HistoryEntry, Command, MergedExecutionOptions, HistoryMark, HistoryManagerOptions, DirtyTrackerOptions, DirtyTracker, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
-export { BindDirtyToHistoryOptions, ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryDirtyBinding, HistoryEntry, HistoryManager, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, OutlineHeading, OutlineSnapshot, OutlineTreeItem, PromptDiagnostic, PromptValues, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, VariableFormField, bindDirtyToHistory, createDirtyTracker, createHistoryManager, defaultIsEqual, withoutDirty } from '@pixerate/editor';
+import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, HistoryEntry, Command, MergedExecutionOptions, HistoryMark, HistoryManagerOptions, DirtyTrackerOptions, DirtyTracker, FileImportState, ImportStructureSummary, FileImportController, FileImportControllerOptions, PromptValues, ParseDataSourceOptions, MergeRecordsOptions, MergeRecordsResult, MergeDataSource, MergeRecord, OutlineSnapshot, OutlineHeading, ParagraphStylesSnapshot, StyleRegistry, StyleDefinition, CreateStyleFromSelectionOptions, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor, CompareSummary, CompareSource, EditorCompareOptions, FindReplaceSnapshot, FindReplaceMode, FindOptions } from '@pixerate/editor';
+export { BindDirtyToHistoryOptions, ColorGradient, Command, CompareSource, CompareSummary, DirtyTracker, DirtyTrackerOptions, EditorCompareOptions, HistoryDirtyBinding, HistoryEntry, HistoryManager, HistoryManagerOptions, HistoryMark, HistoryState, MergeDataSource, MergeOutput, MergeRecord, MergeRecordsResult, MergedExecutionOptions, OutlineHeading, OutlineSnapshot, OutlineTreeItem, ParagraphStylesSnapshot, PromptDiagnostic, PromptValues, RichTextPresetOptions, StyleDefinition, Template, TemplateVersion, Token, TokenType, VariableFormField, bindDirtyToHistory, createDirtyTracker, createHistoryManager, defaultIsEqual, withoutDirty } from '@pixerate/editor';
 import { UseEditorOptions, EditorContentProps as EditorContentProps$1 } from '@tiptap/react';
 import { HistoryManager as HistoryManager$1 } from '@pixerate/editor/history';
 import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
 import React__default from 'react';
 import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
-export { FormulaHints, FormulaHintsProps, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.cjs';
-export { ImageEditor, ImageEditorProps, UseImageEditorReturn, useImageEditor } from './image-editor/index.cjs';
+export { FormulaHints, FormulaHintsProps, NameManager, NameManagerProps, SheetTabs, SheetTabsProps, SpreadsheetConditionalFormatPanel, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetDataValidationPanel, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, SpreadsheetRulePanelProps, SpreadsheetValidationDialog, SpreadsheetValidationDialogProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.cjs';
+export { AdjustmentLayersPanel, AdjustmentLayersPanelProps, ControlSlider, ControlSliderProps, CurvesEditor, CurvesEditorProps, Histogram, HistogramProps, ImageEditor, ImageEditorProps, RefineEdgePanel, RefineEdgePanelProps, SelectionOptionsBar, SelectionOptionsBarProps, UseImageEditorReturn, useImageEditor, useImageHistogram } from './image-editor/index.cjs';
 export { CommandPalette, CommandPaletteProps, UseCommandPaletteOptions, UseCommandPaletteResult, UseCommandShortcutsOptions, useCommandPalette, useCommandShortcuts, useRegisterCommands } from './commands/index.cjs';
+export { RecoveryPrompt, RecoveryPromptProps, UseAutosaveOptions, UseAutosaveResult, useAutosave } from './persistence/index.cjs';
+export { AssetMentionChips, AssetMentionChipsProps, GenerationHistory, GenerationHistoryProps, GenerationSettings, GenerationSettingsProps, JobProgress, JobProgressProps, UseGenerationRecordsResult, UseJobProgressOptions, useGenerationPlan, useGenerationRecords, useJobProgress } from './generation/index.cjs';
 import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 import '@pixerate/editor/commands';
+import '@pixerate/editor/persistence';
+import '@pixerate/editor/generation';
 
 interface UsePromptEditorProps {
     /**
@@ -221,6 +225,13 @@ interface HistoryShortcutsOptions {
 declare function useHistoryShortcuts(manager: HistoryManager$1, options?: HistoryShortcutsOptions): void;
 
 interface UseFileImportResult extends FileImportState {
+    /**
+     * Structures detected in the last import (headings, lists, tables, columns),
+     * or `null` when no adapter reported any (only structure-aware adapters such
+     * as PDF do). Turn PDF detection off with
+     * `useFileImport(editor, { adapterOptions: { pdf: { structure: false } } })`.
+     */
+    structureSummary: ImportStructureSummary | null;
     /** Value for `<input type="file" accept={…}>`. */
     accept: string;
     /** Opens the browser file picker and imports the chosen files at the selection. */
@@ -313,6 +324,82 @@ interface VariableFormProps {
  */
 declare const VariableForm: React__default.FC<VariableFormProps>;
 
+interface MergePreviewProps {
+    /** The prompt merged with each record. */
+    content: string;
+    templates?: Template[];
+    bindings?: Record<string, string>;
+    templateColorMap?: Map<string, ColorGradient>;
+    /** Initial CSV / TSV / JSON data source text. */
+    defaultSource?: string;
+    parseOptions?: ParseDataSourceOptions;
+    /** Drop records matching this condition (e.g. `"status=void"`) when merging. */
+    skipIf?: MergeRecordsOptions["skipIf"];
+    /** Separator between merged outputs (default a blank line; `"none"` for nothing). */
+    separator?: string;
+    maxOutputs?: number;
+    /** Called after "Merge all". */
+    onMerge?: (result: MergeRecordsResult) => void;
+    /** Base file name for downloads (default `merged`). */
+    downloadName?: string;
+    className?: string;
+}
+/**
+ * Mail-merge preview: paste or pick a CSV / JSON data source, check the
+ * automatic field mapping, step through records with the resolved prompt
+ * shown by `TemplateRenderer`, and merge every record into text or JSON.
+ */
+declare const MergePreview: React__default.FC<MergePreviewProps>;
+
+interface UseMergePreviewOptions {
+    /** The prompt merged with each record. */
+    template: string;
+    templates?: Template[];
+    bindings?: Record<string, string>;
+    /** Initial CSV / TSV / JSON text. */
+    initialSource?: string;
+    /** How to read the data source text. */
+    parseOptions?: ParseDataSourceOptions;
+    /** Passed to `mergeRecords` by `merge()`. */
+    skipIf?: MergeRecordsOptions["skipIf"];
+    separator?: string;
+    maxOutputs?: number;
+}
+interface MergePreviewState {
+    sourceText: string;
+    setSourceText: (text: string) => void;
+    /** Reads a picked file (CSV, TSV or JSON) into `sourceText`. */
+    loadFile: (file: Blob) => Promise<void>;
+    source: MergeDataSource;
+    /** Variable names the template uses, in order. */
+    variables: string[];
+    /** Variable → field: automatic matches with the user's overrides applied. */
+    mapping: Record<string, string | null>;
+    setFieldMapping: (variable: string, field: string | null) => void;
+    resetMapping: () => void;
+    /** 0-based index of the previewed record. */
+    index: number;
+    count: number;
+    setIndex: (index: number) => void;
+    next: () => void;
+    prev: () => void;
+    record: MergeRecord | undefined;
+    /** Prompt values for the previewed record. */
+    values: PromptValues;
+    /** Merges every record with the current mapping and stores the result. */
+    merge: () => MergeRecordsResult;
+    result: MergeRecordsResult | null;
+    /** The last merge's outputs as text or JSON. */
+    serialize: (format: "text" | "json") => string;
+}
+/**
+ * Headless state for a mail-merge preview (the counterpart of Svelte's
+ * `createMergePreview`): parses a pasted or loaded data source, matches its
+ * fields to the template's variables (editable), steps through records and
+ * merges them all with `mergeRecords`.
+ */
+declare function useMergePreview(options: UseMergePreviewOptions): MergePreviewState;
+
 /**
  * Subscribes to an editor's heading outline. Returns the headings (flat and
  * nested) and the id of the heading whose section contains the selection.
@@ -349,6 +436,58 @@ interface OutlinePanelProps {
  */
 declare const OutlinePanel: React__default.FC<OutlinePanelProps>;
 
+interface UseParagraphStylesResult extends ParagraphStylesSnapshot {
+    registry: StyleRegistry | null;
+    /** The style of the block at the selection. */
+    currentStyle: StyleDefinition | null;
+    /** Applies a paragraph style to the selected blocks. */
+    apply: (id: string) => boolean;
+    /** Resets the selected blocks to Normal. */
+    clear: () => boolean;
+    /** Updates a style (default: the current one) to the formatting at the selection. */
+    updateFromSelection: (id?: string) => boolean;
+    /** Creates (and applies) a style from the formatting at the selection; returns its id. */
+    createFromSelection: (name: string, options?: CreateStyleFromSelectionOptions) => string | null;
+    /** Applies a character style to the selection. */
+    applyCharacterStyle: (id: string) => boolean;
+}
+/**
+ * Subscribes to an editor's paragraph styles (`ParagraphStyles` extension):
+ * the gallery, all styles and the style at the selection, with commands.
+ * Re-renders only when the styles or the current style change.
+ */
+declare function useParagraphStyles(editor: Editor | null | undefined): UseParagraphStylesResult;
+
+interface StylesGalleryProps {
+    editor: Editor | null;
+    /**
+     * `dropdown` (default): a button showing the current style that opens the
+     * list. `gallery`: the styles are always shown, in a row.
+     */
+    variant?: "dropdown" | "gallery";
+    /** List every available paragraph style instead of the gallery (quick) styles. */
+    showAllStyles?: boolean;
+    /** Show the "Update to match selection" and "New style from selection" actions. Defaults to `true`. */
+    showActions?: boolean;
+    /** Preview each style's font, weight, style and color in its entry. Defaults to `true`. */
+    preview?: boolean;
+    className?: string;
+    itemClassName?: string;
+    activeItemClassName?: string;
+    /** Called after a style is applied, updated or created. */
+    onChange?: (event: {
+        type: "apply" | "update" | "create";
+        id: string;
+    }) => void;
+}
+/**
+ * Paragraph styles picker (Word's Styles gallery): shows the style at the
+ * selection, applies a style on click, updates the current style to match
+ * the selection and creates a new style from the selection. Needs the
+ * `ParagraphStyles` extension (`richTextOptions: { paragraphStyles: true }`).
+ */
+declare const StylesGallery: React__default.FC<StylesGalleryProps>;
+
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
     children: React__default.ReactNode;
@@ -380,6 +519,12 @@ interface UseTrackChangesResult extends TrackChangesSnapshot {
     rejectAll: () => void;
     next: () => void;
     previous: () => void;
+    /** Selects a change in the editor. */
+    select: (id: string) => void;
+    /** Accepts a tracked move (both ends). */
+    acceptMove: (id: string) => void;
+    /** Rejects a tracked move (both ends). */
+    rejectMove: (id: string) => void;
 }
 /**
  * Subscribes to the tracked-change state of an editor using the
@@ -436,4 +581,80 @@ interface CommentButtonProps {
  */
 declare const CommentButton: React__default.FC<CommentButtonProps>;
 
-export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, type HistoryShortcutsOptions, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, TemplateRenderer, type TemplateRendererProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseFileImportResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useHistory, useHistoryDirty, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };
+interface UseDocumentCompareResult {
+    /** Summary of the last comparison, or `null`. */
+    summary: CompareSummary | null;
+    /**
+     * Replaces the editor content with the comparison of two versions (nodes,
+     * JSON or HTML) as tracked changes, ready to review with `ReviewToolbar`.
+     * Returns the summary, or `null` without an editor.
+     */
+    compare: (original: CompareSource, revised: CompareSource, options?: EditorCompareOptions) => CompareSummary | null;
+    /** Forgets the last summary. */
+    clear: () => void;
+}
+/**
+ * Compare two document versions into an editor using `TrackChanges`.
+ * `options` are defaults for every comparison.
+ */
+declare function useDocumentCompare(editor: Editor | null | undefined, options?: EditorCompareOptions): UseDocumentCompareResult;
+
+interface TrackedChangesListProps {
+    editor: Editor | null;
+    className?: string;
+    itemClassName?: string;
+    activeItemClassName?: string;
+    /** Content shown when there are no changes. */
+    emptyState?: React__default.ReactNode;
+}
+/**
+ * Lists the document's tracked changes (insertions, deletions, moves,
+ * formatting and block changes) with their author and description, and
+ * accepts or rejects each one. A move is one entry: accepting or rejecting
+ * it resolves both its source and its destination. Clicking an entry
+ * selects the change in the editor.
+ */
+declare const TrackedChangesList: React__default.FC<TrackedChangesListProps>;
+
+interface UseFindReplaceResult extends FindReplaceSnapshot {
+    /** Whether the editor has the `FindReplace` extension. */
+    available: boolean;
+    matchCount: number;
+    open: boolean;
+    show: (mode?: FindReplaceMode) => void;
+    close: () => void;
+    setQuery: (query: string) => void;
+    setReplacement: (replacement: string) => void;
+    setOptions: (options: Partial<FindOptions>) => void;
+    toggleOption: (option: keyof FindOptions) => void;
+    next: () => void;
+    previous: () => void;
+    replace: () => void;
+    replaceAll: () => void;
+    clear: () => void;
+}
+/**
+ * Subscribes to an editor's Find and Replace state (`FindReplace` extension)
+ * and exposes its commands.
+ */
+declare function useFindReplace(editor: Editor | null | undefined): UseFindReplaceResult;
+
+interface FindReplaceBarProps {
+    editor: Editor | null;
+    className?: string;
+    /** Render even while the find state is closed (default: only after Mod+F / Mod+H / `openFindReplace`). */
+    alwaysOpen?: boolean;
+    /** Show the "More options" toggle (prefix, suffix, ignore punctuation/white space, literal). Default `true`. */
+    showMoreOptions?: boolean;
+    /** Called after the bar closes (Escape or the close button). */
+    onClose?: () => void;
+}
+/**
+ * Word-style find bar for an editor using the `FindReplace` extension: find
+ * and replace fields, option toggles, "3 of 12" counter, previous/next,
+ * Replace and Replace All. Enter / Shift+Enter step through matches, Enter in
+ * the replace field replaces, Mod+Enter replaces all, Escape closes.
+ */
+declare const FindReplaceBar: React__default.FC<FindReplaceBarProps>;
+
+export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, FindReplaceBar, type FindReplaceBarProps, type HistoryShortcutsOptions, MergePreview, type MergePreviewProps, type MergePreviewState, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, StylesGallery, type StylesGalleryProps, TemplateRenderer, type TemplateRendererProps, TrackedChangesList, type TrackedChangesListProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseDocumentCompareResult, type UseFileImportResult, type UseFindReplaceResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseMergePreviewOptions, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UseParagraphStylesResult, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, useParagraphStyles, usePromptEditor, useTrackChanges };

package/dist/index.d.ts

@@ -1,18 +1,22 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, HistoryEntry, Command, MergedExecutionOptions, HistoryMark, HistoryManagerOptions, DirtyTrackerOptions, DirtyTracker, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
-export { BindDirtyToHistoryOptions, ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryDirtyBinding, HistoryEntry, HistoryManager, HistoryManagerOptions, HistoryMark, HistoryState, MergedExecutionOptions, OutlineHeading, OutlineSnapshot, OutlineTreeItem, PromptDiagnostic, PromptValues, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, VariableFormField, bindDirtyToHistory, createDirtyTracker, createHistoryManager, defaultIsEqual, withoutDirty } from '@pixerate/editor';
+import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, HistoryEntry, Command, MergedExecutionOptions, HistoryMark, HistoryManagerOptions, DirtyTrackerOptions, DirtyTracker, FileImportState, ImportStructureSummary, FileImportController, FileImportControllerOptions, PromptValues, ParseDataSourceOptions, MergeRecordsOptions, MergeRecordsResult, MergeDataSource, MergeRecord, OutlineSnapshot, OutlineHeading, ParagraphStylesSnapshot, StyleRegistry, StyleDefinition, CreateStyleFromSelectionOptions, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor, CompareSummary, CompareSource, EditorCompareOptions, FindReplaceSnapshot, FindReplaceMode, FindOptions } from '@pixerate/editor';
+export { BindDirtyToHistoryOptions, ColorGradient, Command, CompareSource, CompareSummary, DirtyTracker, DirtyTrackerOptions, EditorCompareOptions, HistoryDirtyBinding, HistoryEntry, HistoryManager, HistoryManagerOptions, HistoryMark, HistoryState, MergeDataSource, MergeOutput, MergeRecord, MergeRecordsResult, MergedExecutionOptions, OutlineHeading, OutlineSnapshot, OutlineTreeItem, ParagraphStylesSnapshot, PromptDiagnostic, PromptValues, RichTextPresetOptions, StyleDefinition, Template, TemplateVersion, Token, TokenType, VariableFormField, bindDirtyToHistory, createDirtyTracker, createHistoryManager, defaultIsEqual, withoutDirty } from '@pixerate/editor';
 import { UseEditorOptions, EditorContentProps as EditorContentProps$1 } from '@tiptap/react';
 import { HistoryManager as HistoryManager$1 } from '@pixerate/editor/history';
 import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
 import React__default from 'react';
 import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
-export { FormulaHints, FormulaHintsProps, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.js';
-export { ImageEditor, ImageEditorProps, UseImageEditorReturn, useImageEditor } from './image-editor/index.js';
+export { FormulaHints, FormulaHintsProps, NameManager, NameManagerProps, SheetTabs, SheetTabsProps, SpreadsheetConditionalFormatPanel, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetDataValidationPanel, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, SpreadsheetRulePanelProps, SpreadsheetValidationDialog, SpreadsheetValidationDialogProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.js';
+export { AdjustmentLayersPanel, AdjustmentLayersPanelProps, ControlSlider, ControlSliderProps, CurvesEditor, CurvesEditorProps, Histogram, HistogramProps, ImageEditor, ImageEditorProps, RefineEdgePanel, RefineEdgePanelProps, SelectionOptionsBar, SelectionOptionsBarProps, UseImageEditorReturn, useImageEditor, useImageHistogram } from './image-editor/index.js';
 export { CommandPalette, CommandPaletteProps, UseCommandPaletteOptions, UseCommandPaletteResult, UseCommandShortcutsOptions, useCommandPalette, useCommandShortcuts, useRegisterCommands } from './commands/index.js';
+export { RecoveryPrompt, RecoveryPromptProps, UseAutosaveOptions, UseAutosaveResult, useAutosave } from './persistence/index.js';
+export { AssetMentionChips, AssetMentionChipsProps, GenerationHistory, GenerationHistoryProps, GenerationSettings, GenerationSettingsProps, JobProgress, JobProgressProps, UseGenerationRecordsResult, UseJobProgressOptions, useGenerationPlan, useGenerationRecords, useJobProgress } from './generation/index.js';
 import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 import '@pixerate/editor/commands';
+import '@pixerate/editor/persistence';
+import '@pixerate/editor/generation';
 
 interface UsePromptEditorProps {
     /**
@@ -221,6 +225,13 @@ interface HistoryShortcutsOptions {
 declare function useHistoryShortcuts(manager: HistoryManager$1, options?: HistoryShortcutsOptions): void;
 
 interface UseFileImportResult extends FileImportState {
+    /**
+     * Structures detected in the last import (headings, lists, tables, columns),
+     * or `null` when no adapter reported any (only structure-aware adapters such
+     * as PDF do). Turn PDF detection off with
+     * `useFileImport(editor, { adapterOptions: { pdf: { structure: false } } })`.
+     */
+    structureSummary: ImportStructureSummary | null;
     /** Value for `<input type="file" accept={…}>`. */
     accept: string;
     /** Opens the browser file picker and imports the chosen files at the selection. */
@@ -313,6 +324,82 @@ interface VariableFormProps {
  */
 declare const VariableForm: React__default.FC<VariableFormProps>;
 
+interface MergePreviewProps {
+    /** The prompt merged with each record. */
+    content: string;
+    templates?: Template[];
+    bindings?: Record<string, string>;
+    templateColorMap?: Map<string, ColorGradient>;
+    /** Initial CSV / TSV / JSON data source text. */
+    defaultSource?: string;
+    parseOptions?: ParseDataSourceOptions;
+    /** Drop records matching this condition (e.g. `"status=void"`) when merging. */
+    skipIf?: MergeRecordsOptions["skipIf"];
+    /** Separator between merged outputs (default a blank line; `"none"` for nothing). */
+    separator?: string;
+    maxOutputs?: number;
+    /** Called after "Merge all". */
+    onMerge?: (result: MergeRecordsResult) => void;
+    /** Base file name for downloads (default `merged`). */
+    downloadName?: string;
+    className?: string;
+}
+/**
+ * Mail-merge preview: paste or pick a CSV / JSON data source, check the
+ * automatic field mapping, step through records with the resolved prompt
+ * shown by `TemplateRenderer`, and merge every record into text or JSON.
+ */
+declare const MergePreview: React__default.FC<MergePreviewProps>;
+
+interface UseMergePreviewOptions {
+    /** The prompt merged with each record. */
+    template: string;
+    templates?: Template[];
+    bindings?: Record<string, string>;
+    /** Initial CSV / TSV / JSON text. */
+    initialSource?: string;
+    /** How to read the data source text. */
+    parseOptions?: ParseDataSourceOptions;
+    /** Passed to `mergeRecords` by `merge()`. */
+    skipIf?: MergeRecordsOptions["skipIf"];
+    separator?: string;
+    maxOutputs?: number;
+}
+interface MergePreviewState {
+    sourceText: string;
+    setSourceText: (text: string) => void;
+    /** Reads a picked file (CSV, TSV or JSON) into `sourceText`. */
+    loadFile: (file: Blob) => Promise<void>;
+    source: MergeDataSource;
+    /** Variable names the template uses, in order. */
+    variables: string[];
+    /** Variable → field: automatic matches with the user's overrides applied. */
+    mapping: Record<string, string | null>;
+    setFieldMapping: (variable: string, field: string | null) => void;
+    resetMapping: () => void;
+    /** 0-based index of the previewed record. */
+    index: number;
+    count: number;
+    setIndex: (index: number) => void;
+    next: () => void;
+    prev: () => void;
+    record: MergeRecord | undefined;
+    /** Prompt values for the previewed record. */
+    values: PromptValues;
+    /** Merges every record with the current mapping and stores the result. */
+    merge: () => MergeRecordsResult;
+    result: MergeRecordsResult | null;
+    /** The last merge's outputs as text or JSON. */
+    serialize: (format: "text" | "json") => string;
+}
+/**
+ * Headless state for a mail-merge preview (the counterpart of Svelte's
+ * `createMergePreview`): parses a pasted or loaded data source, matches its
+ * fields to the template's variables (editable), steps through records and
+ * merges them all with `mergeRecords`.
+ */
+declare function useMergePreview(options: UseMergePreviewOptions): MergePreviewState;
+
 /**
  * Subscribes to an editor's heading outline. Returns the headings (flat and
  * nested) and the id of the heading whose section contains the selection.
@@ -349,6 +436,58 @@ interface OutlinePanelProps {
  */
 declare const OutlinePanel: React__default.FC<OutlinePanelProps>;
 
+interface UseParagraphStylesResult extends ParagraphStylesSnapshot {
+    registry: StyleRegistry | null;
+    /** The style of the block at the selection. */
+    currentStyle: StyleDefinition | null;
+    /** Applies a paragraph style to the selected blocks. */
+    apply: (id: string) => boolean;
+    /** Resets the selected blocks to Normal. */
+    clear: () => boolean;
+    /** Updates a style (default: the current one) to the formatting at the selection. */
+    updateFromSelection: (id?: string) => boolean;
+    /** Creates (and applies) a style from the formatting at the selection; returns its id. */
+    createFromSelection: (name: string, options?: CreateStyleFromSelectionOptions) => string | null;
+    /** Applies a character style to the selection. */
+    applyCharacterStyle: (id: string) => boolean;
+}
+/**
+ * Subscribes to an editor's paragraph styles (`ParagraphStyles` extension):
+ * the gallery, all styles and the style at the selection, with commands.
+ * Re-renders only when the styles or the current style change.
+ */
+declare function useParagraphStyles(editor: Editor | null | undefined): UseParagraphStylesResult;
+
+interface StylesGalleryProps {
+    editor: Editor | null;
+    /**
+     * `dropdown` (default): a button showing the current style that opens the
+     * list. `gallery`: the styles are always shown, in a row.
+     */
+    variant?: "dropdown" | "gallery";
+    /** List every available paragraph style instead of the gallery (quick) styles. */
+    showAllStyles?: boolean;
+    /** Show the "Update to match selection" and "New style from selection" actions. Defaults to `true`. */
+    showActions?: boolean;
+    /** Preview each style's font, weight, style and color in its entry. Defaults to `true`. */
+    preview?: boolean;
+    className?: string;
+    itemClassName?: string;
+    activeItemClassName?: string;
+    /** Called after a style is applied, updated or created. */
+    onChange?: (event: {
+        type: "apply" | "update" | "create";
+        id: string;
+    }) => void;
+}
+/**
+ * Paragraph styles picker (Word's Styles gallery): shows the style at the
+ * selection, applies a style on click, updates the current style to match
+ * the selection and creates a new style from the selection. Needs the
+ * `ParagraphStyles` extension (`richTextOptions: { paragraphStyles: true }`).
+ */
+declare const StylesGallery: React__default.FC<StylesGalleryProps>;
+
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
     children: React__default.ReactNode;
@@ -380,6 +519,12 @@ interface UseTrackChangesResult extends TrackChangesSnapshot {
     rejectAll: () => void;
     next: () => void;
     previous: () => void;
+    /** Selects a change in the editor. */
+    select: (id: string) => void;
+    /** Accepts a tracked move (both ends). */
+    acceptMove: (id: string) => void;
+    /** Rejects a tracked move (both ends). */
+    rejectMove: (id: string) => void;
 }
 /**
  * Subscribes to the tracked-change state of an editor using the
@@ -436,4 +581,80 @@ interface CommentButtonProps {
  */
 declare const CommentButton: React__default.FC<CommentButtonProps>;
 
-export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, type HistoryShortcutsOptions, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, TemplateRenderer, type TemplateRendererProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseFileImportResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useHistory, useHistoryDirty, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };
+interface UseDocumentCompareResult {
+    /** Summary of the last comparison, or `null`. */
+    summary: CompareSummary | null;
+    /**
+     * Replaces the editor content with the comparison of two versions (nodes,
+     * JSON or HTML) as tracked changes, ready to review with `ReviewToolbar`.
+     * Returns the summary, or `null` without an editor.
+     */
+    compare: (original: CompareSource, revised: CompareSource, options?: EditorCompareOptions) => CompareSummary | null;
+    /** Forgets the last summary. */
+    clear: () => void;
+}
+/**
+ * Compare two document versions into an editor using `TrackChanges`.
+ * `options` are defaults for every comparison.
+ */
+declare function useDocumentCompare(editor: Editor | null | undefined, options?: EditorCompareOptions): UseDocumentCompareResult;
+
+interface TrackedChangesListProps {
+    editor: Editor | null;
+    className?: string;
+    itemClassName?: string;
+    activeItemClassName?: string;
+    /** Content shown when there are no changes. */
+    emptyState?: React__default.ReactNode;
+}
+/**
+ * Lists the document's tracked changes (insertions, deletions, moves,
+ * formatting and block changes) with their author and description, and
+ * accepts or rejects each one. A move is one entry: accepting or rejecting
+ * it resolves both its source and its destination. Clicking an entry
+ * selects the change in the editor.
+ */
+declare const TrackedChangesList: React__default.FC<TrackedChangesListProps>;
+
+interface UseFindReplaceResult extends FindReplaceSnapshot {
+    /** Whether the editor has the `FindReplace` extension. */
+    available: boolean;
+    matchCount: number;
+    open: boolean;
+    show: (mode?: FindReplaceMode) => void;
+    close: () => void;
+    setQuery: (query: string) => void;
+    setReplacement: (replacement: string) => void;
+    setOptions: (options: Partial<FindOptions>) => void;
+    toggleOption: (option: keyof FindOptions) => void;
+    next: () => void;
+    previous: () => void;
+    replace: () => void;
+    replaceAll: () => void;
+    clear: () => void;
+}
+/**
+ * Subscribes to an editor's Find and Replace state (`FindReplace` extension)
+ * and exposes its commands.
+ */
+declare function useFindReplace(editor: Editor | null | undefined): UseFindReplaceResult;
+
+interface FindReplaceBarProps {
+    editor: Editor | null;
+    className?: string;
+    /** Render even while the find state is closed (default: only after Mod+F / Mod+H / `openFindReplace`). */
+    alwaysOpen?: boolean;
+    /** Show the "More options" toggle (prefix, suffix, ignore punctuation/white space, literal). Default `true`. */
+    showMoreOptions?: boolean;
+    /** Called after the bar closes (Escape or the close button). */
+    onClose?: () => void;
+}
+/**
+ * Word-style find bar for an editor using the `FindReplace` extension: find
+ * and replace fields, option toggles, "3 of 12" counter, previous/next,
+ * Replace and Replace All. Enter / Shift+Enter step through matches, Enter in
+ * the replace field replaces, Mod+Enter replaces all, Escape closes.
+ */
+declare const FindReplaceBar: React__default.FC<FindReplaceBarProps>;
+
+export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, FindReplaceBar, type FindReplaceBarProps, type HistoryShortcutsOptions, MergePreview, type MergePreviewProps, type MergePreviewState, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, StylesGallery, type StylesGalleryProps, TemplateRenderer, type TemplateRendererProps, TrackedChangesList, type TrackedChangesListProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseDocumentCompareResult, type UseFileImportResult, type UseFindReplaceResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseMergePreviewOptions, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UseParagraphStylesResult, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, useParagraphStyles, usePromptEditor, useTrackChanges };