@pixerate/editor-react 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -1,17 +1,18 @@
 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, ParseDataSourceOptions, MergeRecordsOptions, MergeRecordsResult, MergeDataSource, MergeRecord, OutlineSnapshot, OutlineHeading, 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, 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, TableState, TableAction, TableActionParams, TableToolbarItem } 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, TableAction, TableActionParams, TableState, 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 { DocxExportState, DocxExportReport, DocxExportController, DocxExportControllerOptions } from '@pixerate/editor/export';
 import React__default from 'react';
+import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
 import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
-export { FormulaHints, FormulaHintsProps, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.cjs';
-export { AdjustmentLayersPanel, AdjustmentLayersPanelProps, ControlSlider, ControlSliderProps, CurvesEditor, CurvesEditorProps, Histogram, HistogramProps, ImageEditor, ImageEditorProps, UseImageEditorReturn, useImageEditor, useImageHistogram } from './image-editor/index.cjs';
+export { FormulaHints, FormulaHintsProps, NameManager, NameManagerProps, SheetTabs, SheetTabsProps, SpreadsheetConditionalFormatPanel, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetDataValidationPanel, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, SpreadsheetRulePanelProps, SpreadsheetValidationDialog, SpreadsheetValidationDialogProps, SpreadsheetViewportOptions, SpreadsheetViewportState, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor, useSpreadsheetViewport } 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 { GenerationSettings, GenerationSettingsProps, JobProgress, JobProgressProps, UseJobProgressOptions, useGenerationPlan, useJobProgress } from './generation/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';
@@ -225,6 +226,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. */
@@ -239,6 +247,29 @@ interface UseFileImportResult extends FileImportState {
  */
 declare function useFileImport(editor: Editor | null | undefined, options?: FileImportControllerOptions): UseFileImportResult;
 
+interface UseDocxExportResult extends DocxExportState {
+    /** Exports the editor (with its comments, tracked changes and styles) and downloads the `.docx`. */
+    download: (fileName?: string) => Promise<DocxExportReport | null>;
+    /** Builds the `.docx` without downloading it. */
+    exportBlob: DocxExportController["exportBlob"];
+}
+/**
+ * "Export to Word": downloads the editor's document as a `.docx` with its
+ * comments (from the `Comments` store), tracked changes and paragraph styles.
+ * `lastReport` lists anything the export had to leave out.
+ */
+declare function useDocxExport(editor: Editor | null | undefined, options?: DocxExportControllerOptions): UseDocxExportResult;
+
+interface ExportDocxButtonProps extends DocxExportControllerOptions {
+    editor: Editor | null;
+    className?: string;
+    children?: React__default.ReactNode;
+    /** Called after the download with the export report. */
+    onExported?: (report: DocxExportReport) => void;
+}
+/** A button that downloads the editor's document as a Word file (`.docx`). */
+declare const ExportDocxButton: React__default.FC<ExportDocxButtonProps>;
+
 /**
  * Registers a tool provider with a `ToolRegistry` while the component is
  * mounted and unregisters it on unmount (the registry then announces the
@@ -429,6 +460,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;
@@ -460,6 +543,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
@@ -534,6 +623,23 @@ interface UseDocumentCompareResult {
  */
 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;
@@ -575,4 +681,79 @@ interface FindReplaceBarProps {
  */
 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, TemplateRenderer, type TemplateRendererProps, 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 UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };
+interface UseTableMenuResult extends TableState {
+    /** Runs a table action (focusing the editor); `false` when it cannot run. */
+    run: (action: TableAction, params?: TableActionParams) => boolean;
+    /** `true`, or why the action cannot run with these params. */
+    check: (action: TableAction, params?: TableActionParams) => true | string;
+}
+/**
+ * Subscribes to the table at the editor's selection: whether the selection
+ * is in a table, its size, header state, the cell's alignment and
+ * background, and the enablement (with reasons) of every table action.
+ * Re-renders only when that state changes. The Svelte counterpart is
+ * `createTableMenu`.
+ */
+declare function useTableMenu(editor: Editor | null | undefined): UseTableMenuResult;
+
+interface TableToolbarProps {
+    editor: Editor | null;
+    /** Buttons to show (default `DEFAULT_TABLE_TOOLBAR`). */
+    items?: readonly TableToolbarItem[];
+    /** Render (with disabled buttons) when the selection is not in a table. Default `false`. */
+    showWhenOutside?: boolean;
+    className?: string;
+    buttonClassName?: string;
+    activeButtonClassName?: string;
+    separatorClassName?: string;
+    /** Called after a button ran its action. */
+    onAction?: (item: TableToolbarItem) => void;
+}
+/**
+ * Table toolbar: insert/delete rows and columns, merge/split cells, header
+ * toggles, cell alignment and delete table. Rendered only while the
+ * selection is in a table (unless `showWhenOutside`); disabled buttons say
+ * why in their tooltip. Use it inline, or inside `TableBubbleMenu`.
+ */
+declare const TableToolbar: React__default.FC<TableToolbarProps>;
+
+interface InsertTableGridProps {
+    editor: Editor | null;
+    /** Grid size offered (default 8 × 8). */
+    rows?: number;
+    cols?: number;
+    /** Insert with a header row (default `true`). */
+    withHeaderRow?: boolean;
+    className?: string;
+    cellClassName?: string;
+    activeCellClassName?: string;
+    /** Called after a table was inserted. */
+    onInsert?: (size: {
+        rows: number;
+        cols: number;
+    }) => void;
+}
+/**
+ * Word-style insert-table picker: hover (or focus) a cell of the grid to
+ * choose the size, click to insert a table of that size at the cursor. The
+ * grid is disabled (with the reason as its title) where a table cannot be
+ * inserted, e.g. inside another table.
+ */
+declare const InsertTableGrid: React__default.FC<InsertTableGridProps>;
+
+interface TableBubbleMenuProps extends Omit<BubbleMenuProps, "editor" | "children" | "shouldShow"> {
+    editor: Editor | null;
+    /** Custom content (default: a `TableToolbar`). */
+    children?: React__default.ReactNode;
+    /** Props for the default `TableToolbar`. */
+    toolbarProps?: Omit<TableToolbarProps, "editor">;
+}
+/**
+ * A bubble menu that follows the selection while it is in a table (even a
+ * collapsed cursor), with the table toolbar or your own `children`. It uses
+ * its own plugin key (`tableBubbleMenu`), so it can be combined with the
+ * formatting `BubbleMenu`.
+ */
+declare const TableBubbleMenu: React__default.FC<TableBubbleMenuProps>;
+
+export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, ExportDocxButton, type ExportDocxButtonProps, FindReplaceBar, type FindReplaceBarProps, type HistoryShortcutsOptions, InsertTableGrid, type InsertTableGridProps, MergePreview, type MergePreviewProps, type MergePreviewState, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, StylesGallery, type StylesGalleryProps, TableBubbleMenu, type TableBubbleMenuProps, TableToolbar, type TableToolbarProps, TemplateRenderer, type TemplateRendererProps, TrackedChangesList, type TrackedChangesListProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseDocumentCompareResult, type UseDocxExportResult, type UseFileImportResult, type UseFindReplaceResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseMergePreviewOptions, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UseParagraphStylesResult, type UsePromptEditorProps, type UseRichEditorProps, type UseTableMenuResult, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useDocxExport, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, useParagraphStyles, usePromptEditor, useTableMenu, useTrackChanges };

package/dist/index.d.ts

@@ -1,17 +1,18 @@
 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, ParseDataSourceOptions, MergeRecordsOptions, MergeRecordsResult, MergeDataSource, MergeRecord, OutlineSnapshot, OutlineHeading, 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, 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, TableState, TableAction, TableActionParams, TableToolbarItem } 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, TableAction, TableActionParams, TableState, 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 { DocxExportState, DocxExportReport, DocxExportController, DocxExportControllerOptions } from '@pixerate/editor/export';
 import React__default from 'react';
+import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
 import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
-export { FormulaHints, FormulaHintsProps, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor } from './spreadsheet/index.js';
-export { AdjustmentLayersPanel, AdjustmentLayersPanelProps, ControlSlider, ControlSliderProps, CurvesEditor, CurvesEditorProps, Histogram, HistogramProps, ImageEditor, ImageEditorProps, UseImageEditorReturn, useImageEditor, useImageHistogram } from './image-editor/index.js';
+export { FormulaHints, FormulaHintsProps, NameManager, NameManagerProps, SheetTabs, SheetTabsProps, SpreadsheetConditionalFormatPanel, SpreadsheetContextMenu, SpreadsheetContextMenuProps, SpreadsheetDataValidationPanel, SpreadsheetEditor, SpreadsheetEditorProps, SpreadsheetGroupRow, SpreadsheetGroupRowProps, SpreadsheetRulePanelProps, SpreadsheetValidationDialog, SpreadsheetValidationDialogProps, SpreadsheetViewportOptions, SpreadsheetViewportState, useFillHandle, useSpreadsheetClipboard, useSpreadsheetEditor, useSpreadsheetViewport } 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 { GenerationSettings, GenerationSettingsProps, JobProgress, JobProgressProps, UseJobProgressOptions, useGenerationPlan, useJobProgress } from './generation/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';
@@ -225,6 +226,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. */
@@ -239,6 +247,29 @@ interface UseFileImportResult extends FileImportState {
  */
 declare function useFileImport(editor: Editor | null | undefined, options?: FileImportControllerOptions): UseFileImportResult;
 
+interface UseDocxExportResult extends DocxExportState {
+    /** Exports the editor (with its comments, tracked changes and styles) and downloads the `.docx`. */
+    download: (fileName?: string) => Promise<DocxExportReport | null>;
+    /** Builds the `.docx` without downloading it. */
+    exportBlob: DocxExportController["exportBlob"];
+}
+/**
+ * "Export to Word": downloads the editor's document as a `.docx` with its
+ * comments (from the `Comments` store), tracked changes and paragraph styles.
+ * `lastReport` lists anything the export had to leave out.
+ */
+declare function useDocxExport(editor: Editor | null | undefined, options?: DocxExportControllerOptions): UseDocxExportResult;
+
+interface ExportDocxButtonProps extends DocxExportControllerOptions {
+    editor: Editor | null;
+    className?: string;
+    children?: React__default.ReactNode;
+    /** Called after the download with the export report. */
+    onExported?: (report: DocxExportReport) => void;
+}
+/** A button that downloads the editor's document as a Word file (`.docx`). */
+declare const ExportDocxButton: React__default.FC<ExportDocxButtonProps>;
+
 /**
  * Registers a tool provider with a `ToolRegistry` while the component is
  * mounted and unregisters it on unmount (the registry then announces the
@@ -429,6 +460,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;
@@ -460,6 +543,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
@@ -534,6 +623,23 @@ interface UseDocumentCompareResult {
  */
 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;
@@ -575,4 +681,79 @@ interface FindReplaceBarProps {
  */
 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, TemplateRenderer, type TemplateRendererProps, 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 UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };
+interface UseTableMenuResult extends TableState {
+    /** Runs a table action (focusing the editor); `false` when it cannot run. */
+    run: (action: TableAction, params?: TableActionParams) => boolean;
+    /** `true`, or why the action cannot run with these params. */
+    check: (action: TableAction, params?: TableActionParams) => true | string;
+}
+/**
+ * Subscribes to the table at the editor's selection: whether the selection
+ * is in a table, its size, header state, the cell's alignment and
+ * background, and the enablement (with reasons) of every table action.
+ * Re-renders only when that state changes. The Svelte counterpart is
+ * `createTableMenu`.
+ */
+declare function useTableMenu(editor: Editor | null | undefined): UseTableMenuResult;
+
+interface TableToolbarProps {
+    editor: Editor | null;
+    /** Buttons to show (default `DEFAULT_TABLE_TOOLBAR`). */
+    items?: readonly TableToolbarItem[];
+    /** Render (with disabled buttons) when the selection is not in a table. Default `false`. */
+    showWhenOutside?: boolean;
+    className?: string;
+    buttonClassName?: string;
+    activeButtonClassName?: string;
+    separatorClassName?: string;
+    /** Called after a button ran its action. */
+    onAction?: (item: TableToolbarItem) => void;
+}
+/**
+ * Table toolbar: insert/delete rows and columns, merge/split cells, header
+ * toggles, cell alignment and delete table. Rendered only while the
+ * selection is in a table (unless `showWhenOutside`); disabled buttons say
+ * why in their tooltip. Use it inline, or inside `TableBubbleMenu`.
+ */
+declare const TableToolbar: React__default.FC<TableToolbarProps>;
+
+interface InsertTableGridProps {
+    editor: Editor | null;
+    /** Grid size offered (default 8 × 8). */
+    rows?: number;
+    cols?: number;
+    /** Insert with a header row (default `true`). */
+    withHeaderRow?: boolean;
+    className?: string;
+    cellClassName?: string;
+    activeCellClassName?: string;
+    /** Called after a table was inserted. */
+    onInsert?: (size: {
+        rows: number;
+        cols: number;
+    }) => void;
+}
+/**
+ * Word-style insert-table picker: hover (or focus) a cell of the grid to
+ * choose the size, click to insert a table of that size at the cursor. The
+ * grid is disabled (with the reason as its title) where a table cannot be
+ * inserted, e.g. inside another table.
+ */
+declare const InsertTableGrid: React__default.FC<InsertTableGridProps>;
+
+interface TableBubbleMenuProps extends Omit<BubbleMenuProps, "editor" | "children" | "shouldShow"> {
+    editor: Editor | null;
+    /** Custom content (default: a `TableToolbar`). */
+    children?: React__default.ReactNode;
+    /** Props for the default `TableToolbar`. */
+    toolbarProps?: Omit<TableToolbarProps, "editor">;
+}
+/**
+ * A bubble menu that follows the selection while it is in a table (even a
+ * collapsed cursor), with the table toolbar or your own `children`. It uses
+ * its own plugin key (`tableBubbleMenu`), so it can be combined with the
+ * formatting `BubbleMenu`.
+ */
+declare const TableBubbleMenu: React__default.FC<TableBubbleMenuProps>;
+
+export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, ExportDocxButton, type ExportDocxButtonProps, FindReplaceBar, type FindReplaceBarProps, type HistoryShortcutsOptions, InsertTableGrid, type InsertTableGridProps, MergePreview, type MergePreviewProps, type MergePreviewState, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, StylesGallery, type StylesGalleryProps, TableBubbleMenu, type TableBubbleMenuProps, TableToolbar, type TableToolbarProps, TemplateRenderer, type TemplateRendererProps, TrackedChangesList, type TrackedChangesListProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseDocumentCompareResult, type UseDocxExportResult, type UseFileImportResult, type UseFindReplaceResult, type UseHistoryDirtyOptions, type UseHistoryDirtyResult, type UseHistoryResult, type UseMergePreviewOptions, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UseParagraphStylesResult, type UsePromptEditorProps, type UseRichEditorProps, type UseTableMenuResult, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useDocumentCompare, useDocxExport, useEditor, useEditorSlots, useFileImport, useFindReplace, useHistory, useHistoryDirty, useHistoryShortcuts, useMergePreview, useNavigationGuard, useOutline, useParagraphStyles, usePromptEditor, useTableMenu, useTrackChanges };