@pixerate/editor-react 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -1,14 +1,14 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import * as _pixerate_editor from '@pixerate/editor';
-import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, SpreadsheetControllerOptions, CellRange, SpreadsheetDocument, CellCoordinate, SpreadsheetController, SpreadsheetColumn, SpreadsheetRow, SpreadsheetDataSource, CellData, SpreadsheetMenuItem, SpreadsheetRowGroup, SpreadsheetViewColumn, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
+import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
 export { ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryManager, HistoryManagerOptions, HistoryState, OutlineHeading, OutlineSnapshot, OutlineTreeItem, PromptDiagnostic, PromptValues, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, VariableFormField, createDirtyTracker, createHistoryManager, defaultIsEqual } from '@pixerate/editor';
 import { UseEditorOptions, EditorContentProps as EditorContentProps$1 } from '@tiptap/react';
 import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
-import * as React$1 from 'react';
-import React__default, { RefObject } from 'react';
+import React$1 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';
+import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 
 interface UsePromptEditorProps {
@@ -210,18 +210,18 @@ declare function useAgentToolProvider(registry: ToolRegistry | null | undefined,
 interface EditorContentProps extends EditorContentProps$1 {
     className?: string;
 }
-declare const EditorContent: React__default.FC<EditorContentProps>;
+declare const EditorContent: React$1.FC<EditorContentProps>;
 
 interface BubbleMenuProps {
     editor: Editor | null;
     className?: string;
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
     tippyOptions?: BubbleMenuPluginProps["tippyOptions"];
     shouldShow?: BubbleMenuPluginProps["shouldShow"];
     pluginKey?: BubbleMenuPluginProps["pluginKey"];
     updateDelay?: BubbleMenuPluginProps["updateDelay"];
 }
-declare const BubbleMenu: React__default.FC<BubbleMenuProps>;
+declare const BubbleMenu: React$1.FC<BubbleMenuProps>;
 
 interface TemplateRendererProps {
     /** Raw prompt or text string to render */
@@ -246,7 +246,7 @@ interface TemplateRendererProps {
     /** Click callback for variable badges */
     onVariableClick?: (variableName: string) => void;
 }
-declare const TemplateRenderer: React__default.FC<TemplateRendererProps>;
+declare const TemplateRenderer: React$1.FC<TemplateRendererProps>;
 
 interface VariableFormProps {
     /** Prompt whose variables become form fields */
@@ -272,7 +272,7 @@ interface VariableFormProps {
  * using its default as the placeholder. Variables only used by `{?name}`
  * conditions render as checkboxes.
  */
-declare const VariableForm: React__default.FC<VariableFormProps>;
+declare const VariableForm: React$1.FC<VariableFormProps>;
 
 /**
  * Subscribes to an editor's heading outline. Returns the headings (flat and
@@ -287,9 +287,9 @@ declare function useOutline(editor: Editor | null | undefined): OutlineSnapshot;
 interface OutlinePanelProps {
     editor: Editor | null;
     /** Heading shown above the list. Pass `null` to hide it. */
-    title?: React__default.ReactNode;
+    title?: React$1.ReactNode;
     /** Content shown when the document has no headings. */
-    emptyState?: React__default.ReactNode;
+    emptyState?: React$1.ReactNode;
     /** Deepest heading level listed. Defaults to 6. */
     maxLevel?: number;
     /** Whether clicking an entry focuses the editor. Defaults to `true`. */
@@ -308,170 +308,16 @@ interface OutlinePanelProps {
  * Clicking an entry moves the caret to that heading; the entry for the
  * section containing the selection is highlighted.
  */
-declare const OutlinePanel: React__default.FC<OutlinePanelProps>;
-
-declare function useSpreadsheetEditor(options?: SpreadsheetControllerOptions): {
-    viewModel: _pixerate_editor.SpreadsheetViewModel;
-    undo: () => void;
-    redo: () => void;
-    sortRows: (keys: _pixerate_editor.SortKey[], options?: {
-        range?: CellRange | null;
-    }) => boolean;
-    getFilterState: () => _pixerate_editor.SpreadsheetFilterState;
-    setFilterRules: (rules: _pixerate_editor.NewFilterRule[]) => void;
-    addFilterRule: (rule: _pixerate_editor.NewFilterRule) => string;
-    updateFilterRule: (ruleId: string, changes: Partial<Omit<_pixerate_editor.FilterRule, "id">>) => void;
-    removeFilterRule: (ruleId: string) => void;
-    clearFilters: () => void;
-    setFiltersEnabled: (enabled: boolean) => void;
-    toggleFilters: () => void;
-    setHeaderRowCount: (count: number) => void;
-    setFooterRowCount: (count: number) => void;
-    setHeaderColumnCount: (count: number) => void;
-    setFrozenRowCount: (count: number) => void;
-    setFrozenColumnCount: (count: number) => void;
-    hideRows: (indices: number[]) => void;
-    unhideRows: (indices: number[]) => void;
-    hideColumns: (indices: number[]) => void;
-    unhideColumns: (indices: number[]) => void;
-    unhideAll: () => void;
-    getMerges: () => CellRange[];
-    getMergeAt: (row: number, col: number) => CellRange | null;
-    mergeCells: (range?: CellRange | null) => boolean;
-    unmergeCells: (range?: CellRange | null) => boolean;
-    autofill: (source: CellRange, target: CellRange) => boolean;
-    groupRowsBy: (colId: string, summaries?: _pixerate_editor.GroupSummary[]) => void;
-    ungroupRows: () => void;
-    setGroupSummary: (colId: string, aggregate: _pixerate_editor.GroupAggregate | null) => void;
-    setGroupCollapsed: (key: string, collapsed: boolean) => void;
-    toggleGroupCollapsed: (key: string) => void;
-    getGroups: () => _pixerate_editor.SpreadsheetRowGroup[];
-    transposeRange: (range?: CellRange | null) => boolean;
-    exportToCsv: (options?: _pixerate_editor.CsvExportOptions) => string;
-    importFromCsv: (csv: string, options?: _pixerate_editor.CsvImportOptions) => void;
-    copyToClipboardData: (range?: CellRange | null) => _pixerate_editor.SpreadsheetClipboardData;
-    pasteClipboardData: (source: _pixerate_editor.SpreadsheetClipboardSource, target?: _pixerate_editor.CellPosition) => boolean;
-    document: SpreadsheetDocument;
-    activeCell: CellCoordinate | null;
-    selectedRange: CellRange | null;
-    editingCell: CellCoordinate | null;
-    draftValue: string;
-    setDraftValue: React$1.Dispatch<React$1.SetStateAction<string>>;
-    controller: SpreadsheetController;
-    getCell: (rowId: string, colId: string) => _pixerate_editor.CellData;
-    setCellValue: (rowId: string, colId: string, raw: string) => void;
-    selectCell: (row: number, col: number, extendSelection?: boolean) => void;
-    selectRange: (range: CellRange) => void;
-    startEditing: (row?: number, col?: number, initialVal?: string) => void;
-    commitEditing: (val?: string) => void;
-    cancelEditing: () => void;
-    moveCursor: (dir: "up" | "down" | "left" | "right", extend?: boolean) => void;
-    insertColumn: (index: number, config?: Partial<SpreadsheetColumn>) => void;
-    deleteColumn: (colId: string) => void;
-    insertRow: (index: number, config?: Partial<SpreadsheetRow>) => void;
-    deleteRow: (rowId: string) => void;
-    setColumnWidth: (colId: string, width: number) => void;
-    autoFitColumnWidth: (colId: string, customWidth?: number) => void;
-    loadDocument: (document: SpreadsheetDocument) => void;
-    syncWithDataSource: () => void;
-    registerDataSource: (ds: SpreadsheetDataSource) => void;
-    setPrimaryDataSource: (id: string | undefined) => void;
-    recalculateAll: () => void;
-    exportToTsv: (range?: CellRange | null) => string;
-    importFromTsv: (data: string) => void;
-};
-
-interface SpreadsheetEditorProps {
-    state?: ReturnType<typeof useSpreadsheetEditor>;
-    readOnly?: boolean;
-    customCellRenderer?: (props: {
-        row: SpreadsheetRow;
-        col: SpreadsheetColumn;
-        cell: CellData;
-    }) => React__default.ReactNode;
-    onAddColumnClick?: () => void;
-    onColumnHeaderClick?: (col: SpreadsheetColumn) => void;
-    onColumnResize?: (colId: string, width: number) => void;
-}
-declare const SpreadsheetEditor: React__default.FC<SpreadsheetEditorProps>;
-
-interface SpreadsheetContextMenuProps {
-    items: SpreadsheetMenuItem[];
-    x: number;
-    y: number;
-    onClose: () => void;
-}
-/** The table context menu (sort, filter, freeze, hide, merge, categories, transpose). */
-declare const SpreadsheetContextMenu: React__default.FC<SpreadsheetContextMenuProps>;
-
-interface SpreadsheetGroupRowProps {
-    group: SpreadsheetRowGroup;
-    columns: SpreadsheetViewColumn[];
-    /** Column the rows are grouped by: shows the group label and toggle. */
-    groupColId: string;
-    onToggle: (key: string) => void;
-    /** Render a trailing cell for the "add column" column. */
-    trailingCell?: boolean;
-}
-/** A category header row: collapse toggle, label, row count and per-column summaries. */
-declare const SpreadsheetGroupRow: React__default.FC<SpreadsheetGroupRowProps>;
-
-type SpreadsheetState = ReturnType<typeof useSpreadsheetEditor>;
-/**
- * Copy and paste for the grid. Copy writes TSV, an HTML table and the
- * lossless `application/x.pixerate.spreadsheet+json` format; paste prefers
- * that format, then HTML, then TSV.
- *
- * The listeners are on `document`: with no text selection the browser fires
- * `copy`/`paste` at `<body>`, not at the focused grid. Text inputs inside the
- * grid keep native copy/paste.
- */
-declare function useSpreadsheetClipboard(gridRef: RefObject<HTMLElement | null>, state: SpreadsheetState, readOnly: boolean): {
-    copyShortcutFallback: () => void;
-};
-/**
- * Fill handle dragging: press on the handle, move over cells, release to
- * autofill from the selection into the dragged range (one undo step).
- */
-declare function useFillHandle(state: SpreadsheetState): {
-    fillTarget: CellRange | null;
-    isFilling: boolean;
-    startFill: (e: {
-        preventDefault(): void;
-        stopPropagation(): void;
-    }) => void;
-    extendFill: (row: number, col: number) => void;
-};
-
-interface FormulaHintsProps {
-    /** The input being edited (a cell editor or the formula bar). */
-    inputRef: React__default.RefObject<HTMLInputElement | null>;
-    /** The input's current value. */
-    value: string;
-    /** Called with the new value when a suggestion is accepted. */
-    onAccept: (value: string) => void;
-    /** Maximum number of function suggestions (default 8). */
-    limit?: number;
-}
-/**
- * Formula autocomplete for an input: while the value starts with `=`, lists
- * functions matching the name at the caret (name, signature, description) and,
- * inside a call, shows the signature with the current argument highlighted.
- *
- * Keys are handled on the input itself, before the grid sees them: ArrowUp /
- * ArrowDown move the selection, Tab accepts it, Escape closes the list.
- * Enter is left alone so it still commits the cell.
- */
-declare const FormulaHints: React__default.FC<FormulaHintsProps>;
+declare const OutlinePanel: React$1.FC<OutlinePanelProps>;
 
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
 }
 /**
  * Context provider allowing consumers to inject custom design system components into the editor.
  */
-declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderProps): React__default.JSX.Element;
+declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderProps): React$1.JSX.Element;
 /**
  * Hook to access injected design system slots.
  */
@@ -519,27 +365,36 @@ interface CommentsPanelProps {
  * thread selects its text in the editor. Threads with an empty body are
  * drafts (e.g. created by `CommentButton`) and show a compose box.
  */
-declare const CommentsPanel: React__default.FC<CommentsPanelProps>;
+declare const CommentsPanel: React$1.FC<CommentsPanelProps>;
 
 interface ReviewToolbarProps {
     editor: Editor | null;
     className?: string;
+    /**
+     * Show the current change's author and description (e.g. "Alice: Formatted:
+     * Bold"). Defaults to `true`.
+     */
+    showDescription?: boolean;
+    /** Class of the description label. */
+    descriptionClassName?: string;
 }
 /**
- * Toolbar for tracked changes: toggle tracking, step through changes, and
- * accept or reject the current change or all changes.
+ * Toolbar for tracked changes: toggle tracking, step through changes
+ * (insertions, deletions, formatting and block changes, with a description
+ * of the current one), and accept or reject the current change or all
+ * changes.
  */
-declare const ReviewToolbar: React__default.FC<ReviewToolbarProps>;
+declare const ReviewToolbar: React$1.FC<ReviewToolbarProps>;
 
 interface CommentButtonProps {
     editor: Editor | null;
     className?: string;
-    children?: React__default.ReactNode;
+    children?: React$1.ReactNode;
 }
 /**
  * Adds a draft comment on the selection; drop it into a `BubbleMenu`. The
  * draft is completed in `CommentsPanel`.
  */
-declare const CommentButton: React__default.FC<CommentButtonProps>;
+declare const CommentButton: React$1.FC<CommentButtonProps>;
 
-export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, FormulaHints, type FormulaHintsProps, type HistoryShortcutsOptions, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, SpreadsheetContextMenu, type SpreadsheetContextMenuProps, SpreadsheetEditor, type SpreadsheetEditorProps, SpreadsheetGroupRow, type SpreadsheetGroupRowProps, TemplateRenderer, type TemplateRendererProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseFileImportResult, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useFillHandle, useHistory, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useSpreadsheetClipboard, useSpreadsheetEditor, useTrackChanges };
+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 UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useHistory, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import * as _pixerate_editor from '@pixerate/editor';
-import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, SpreadsheetControllerOptions, CellRange, SpreadsheetDocument, CellCoordinate, SpreadsheetController, SpreadsheetColumn, SpreadsheetRow, SpreadsheetDataSource, CellData, SpreadsheetMenuItem, SpreadsheetRowGroup, SpreadsheetViewColumn, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
+import { Template, ColorGradient, FileImportOptions, RichTextPresetOptions, RichClipboardOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, FileImportState, FileImportController, FileImportControllerOptions, PromptValues, OutlineSnapshot, OutlineHeading, EditorSlotsMap, CommentStoreSnapshot, CommentStore, TrackChangesSnapshot, TrackedChange, ReviewAuthor } from '@pixerate/editor';
 export { ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryManager, HistoryManagerOptions, HistoryState, OutlineHeading, OutlineSnapshot, OutlineTreeItem, PromptDiagnostic, PromptValues, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, VariableFormField, createDirtyTracker, createHistoryManager, defaultIsEqual } from '@pixerate/editor';
 import { UseEditorOptions, EditorContentProps as EditorContentProps$1 } from '@tiptap/react';
 import { ToolRegistry, AgentToolProvider } from '@pixerate/editor/agent';
-import * as React$1 from 'react';
-import React__default, { RefObject } from 'react';
+import React$1 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';
+import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 
 interface UsePromptEditorProps {
@@ -210,18 +210,18 @@ declare function useAgentToolProvider(registry: ToolRegistry | null | undefined,
 interface EditorContentProps extends EditorContentProps$1 {
     className?: string;
 }
-declare const EditorContent: React__default.FC<EditorContentProps>;
+declare const EditorContent: React$1.FC<EditorContentProps>;
 
 interface BubbleMenuProps {
     editor: Editor | null;
     className?: string;
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
     tippyOptions?: BubbleMenuPluginProps["tippyOptions"];
     shouldShow?: BubbleMenuPluginProps["shouldShow"];
     pluginKey?: BubbleMenuPluginProps["pluginKey"];
     updateDelay?: BubbleMenuPluginProps["updateDelay"];
 }
-declare const BubbleMenu: React__default.FC<BubbleMenuProps>;
+declare const BubbleMenu: React$1.FC<BubbleMenuProps>;
 
 interface TemplateRendererProps {
     /** Raw prompt or text string to render */
@@ -246,7 +246,7 @@ interface TemplateRendererProps {
     /** Click callback for variable badges */
     onVariableClick?: (variableName: string) => void;
 }
-declare const TemplateRenderer: React__default.FC<TemplateRendererProps>;
+declare const TemplateRenderer: React$1.FC<TemplateRendererProps>;
 
 interface VariableFormProps {
     /** Prompt whose variables become form fields */
@@ -272,7 +272,7 @@ interface VariableFormProps {
  * using its default as the placeholder. Variables only used by `{?name}`
  * conditions render as checkboxes.
  */
-declare const VariableForm: React__default.FC<VariableFormProps>;
+declare const VariableForm: React$1.FC<VariableFormProps>;
 
 /**
  * Subscribes to an editor's heading outline. Returns the headings (flat and
@@ -287,9 +287,9 @@ declare function useOutline(editor: Editor | null | undefined): OutlineSnapshot;
 interface OutlinePanelProps {
     editor: Editor | null;
     /** Heading shown above the list. Pass `null` to hide it. */
-    title?: React__default.ReactNode;
+    title?: React$1.ReactNode;
     /** Content shown when the document has no headings. */
-    emptyState?: React__default.ReactNode;
+    emptyState?: React$1.ReactNode;
     /** Deepest heading level listed. Defaults to 6. */
     maxLevel?: number;
     /** Whether clicking an entry focuses the editor. Defaults to `true`. */
@@ -308,170 +308,16 @@ interface OutlinePanelProps {
  * Clicking an entry moves the caret to that heading; the entry for the
  * section containing the selection is highlighted.
  */
-declare const OutlinePanel: React__default.FC<OutlinePanelProps>;
-
-declare function useSpreadsheetEditor(options?: SpreadsheetControllerOptions): {
-    viewModel: _pixerate_editor.SpreadsheetViewModel;
-    undo: () => void;
-    redo: () => void;
-    sortRows: (keys: _pixerate_editor.SortKey[], options?: {
-        range?: CellRange | null;
-    }) => boolean;
-    getFilterState: () => _pixerate_editor.SpreadsheetFilterState;
-    setFilterRules: (rules: _pixerate_editor.NewFilterRule[]) => void;
-    addFilterRule: (rule: _pixerate_editor.NewFilterRule) => string;
-    updateFilterRule: (ruleId: string, changes: Partial<Omit<_pixerate_editor.FilterRule, "id">>) => void;
-    removeFilterRule: (ruleId: string) => void;
-    clearFilters: () => void;
-    setFiltersEnabled: (enabled: boolean) => void;
-    toggleFilters: () => void;
-    setHeaderRowCount: (count: number) => void;
-    setFooterRowCount: (count: number) => void;
-    setHeaderColumnCount: (count: number) => void;
-    setFrozenRowCount: (count: number) => void;
-    setFrozenColumnCount: (count: number) => void;
-    hideRows: (indices: number[]) => void;
-    unhideRows: (indices: number[]) => void;
-    hideColumns: (indices: number[]) => void;
-    unhideColumns: (indices: number[]) => void;
-    unhideAll: () => void;
-    getMerges: () => CellRange[];
-    getMergeAt: (row: number, col: number) => CellRange | null;
-    mergeCells: (range?: CellRange | null) => boolean;
-    unmergeCells: (range?: CellRange | null) => boolean;
-    autofill: (source: CellRange, target: CellRange) => boolean;
-    groupRowsBy: (colId: string, summaries?: _pixerate_editor.GroupSummary[]) => void;
-    ungroupRows: () => void;
-    setGroupSummary: (colId: string, aggregate: _pixerate_editor.GroupAggregate | null) => void;
-    setGroupCollapsed: (key: string, collapsed: boolean) => void;
-    toggleGroupCollapsed: (key: string) => void;
-    getGroups: () => _pixerate_editor.SpreadsheetRowGroup[];
-    transposeRange: (range?: CellRange | null) => boolean;
-    exportToCsv: (options?: _pixerate_editor.CsvExportOptions) => string;
-    importFromCsv: (csv: string, options?: _pixerate_editor.CsvImportOptions) => void;
-    copyToClipboardData: (range?: CellRange | null) => _pixerate_editor.SpreadsheetClipboardData;
-    pasteClipboardData: (source: _pixerate_editor.SpreadsheetClipboardSource, target?: _pixerate_editor.CellPosition) => boolean;
-    document: SpreadsheetDocument;
-    activeCell: CellCoordinate | null;
-    selectedRange: CellRange | null;
-    editingCell: CellCoordinate | null;
-    draftValue: string;
-    setDraftValue: React$1.Dispatch<React$1.SetStateAction<string>>;
-    controller: SpreadsheetController;
-    getCell: (rowId: string, colId: string) => _pixerate_editor.CellData;
-    setCellValue: (rowId: string, colId: string, raw: string) => void;
-    selectCell: (row: number, col: number, extendSelection?: boolean) => void;
-    selectRange: (range: CellRange) => void;
-    startEditing: (row?: number, col?: number, initialVal?: string) => void;
-    commitEditing: (val?: string) => void;
-    cancelEditing: () => void;
-    moveCursor: (dir: "up" | "down" | "left" | "right", extend?: boolean) => void;
-    insertColumn: (index: number, config?: Partial<SpreadsheetColumn>) => void;
-    deleteColumn: (colId: string) => void;
-    insertRow: (index: number, config?: Partial<SpreadsheetRow>) => void;
-    deleteRow: (rowId: string) => void;
-    setColumnWidth: (colId: string, width: number) => void;
-    autoFitColumnWidth: (colId: string, customWidth?: number) => void;
-    loadDocument: (document: SpreadsheetDocument) => void;
-    syncWithDataSource: () => void;
-    registerDataSource: (ds: SpreadsheetDataSource) => void;
-    setPrimaryDataSource: (id: string | undefined) => void;
-    recalculateAll: () => void;
-    exportToTsv: (range?: CellRange | null) => string;
-    importFromTsv: (data: string) => void;
-};
-
-interface SpreadsheetEditorProps {
-    state?: ReturnType<typeof useSpreadsheetEditor>;
-    readOnly?: boolean;
-    customCellRenderer?: (props: {
-        row: SpreadsheetRow;
-        col: SpreadsheetColumn;
-        cell: CellData;
-    }) => React__default.ReactNode;
-    onAddColumnClick?: () => void;
-    onColumnHeaderClick?: (col: SpreadsheetColumn) => void;
-    onColumnResize?: (colId: string, width: number) => void;
-}
-declare const SpreadsheetEditor: React__default.FC<SpreadsheetEditorProps>;
-
-interface SpreadsheetContextMenuProps {
-    items: SpreadsheetMenuItem[];
-    x: number;
-    y: number;
-    onClose: () => void;
-}
-/** The table context menu (sort, filter, freeze, hide, merge, categories, transpose). */
-declare const SpreadsheetContextMenu: React__default.FC<SpreadsheetContextMenuProps>;
-
-interface SpreadsheetGroupRowProps {
-    group: SpreadsheetRowGroup;
-    columns: SpreadsheetViewColumn[];
-    /** Column the rows are grouped by: shows the group label and toggle. */
-    groupColId: string;
-    onToggle: (key: string) => void;
-    /** Render a trailing cell for the "add column" column. */
-    trailingCell?: boolean;
-}
-/** A category header row: collapse toggle, label, row count and per-column summaries. */
-declare const SpreadsheetGroupRow: React__default.FC<SpreadsheetGroupRowProps>;
-
-type SpreadsheetState = ReturnType<typeof useSpreadsheetEditor>;
-/**
- * Copy and paste for the grid. Copy writes TSV, an HTML table and the
- * lossless `application/x.pixerate.spreadsheet+json` format; paste prefers
- * that format, then HTML, then TSV.
- *
- * The listeners are on `document`: with no text selection the browser fires
- * `copy`/`paste` at `<body>`, not at the focused grid. Text inputs inside the
- * grid keep native copy/paste.
- */
-declare function useSpreadsheetClipboard(gridRef: RefObject<HTMLElement | null>, state: SpreadsheetState, readOnly: boolean): {
-    copyShortcutFallback: () => void;
-};
-/**
- * Fill handle dragging: press on the handle, move over cells, release to
- * autofill from the selection into the dragged range (one undo step).
- */
-declare function useFillHandle(state: SpreadsheetState): {
-    fillTarget: CellRange | null;
-    isFilling: boolean;
-    startFill: (e: {
-        preventDefault(): void;
-        stopPropagation(): void;
-    }) => void;
-    extendFill: (row: number, col: number) => void;
-};
-
-interface FormulaHintsProps {
-    /** The input being edited (a cell editor or the formula bar). */
-    inputRef: React__default.RefObject<HTMLInputElement | null>;
-    /** The input's current value. */
-    value: string;
-    /** Called with the new value when a suggestion is accepted. */
-    onAccept: (value: string) => void;
-    /** Maximum number of function suggestions (default 8). */
-    limit?: number;
-}
-/**
- * Formula autocomplete for an input: while the value starts with `=`, lists
- * functions matching the name at the caret (name, signature, description) and,
- * inside a call, shows the signature with the current argument highlighted.
- *
- * Keys are handled on the input itself, before the grid sees them: ArrowUp /
- * ArrowDown move the selection, Tab accepts it, Escape closes the list.
- * Enter is left alone so it still commits the cell.
- */
-declare const FormulaHints: React__default.FC<FormulaHintsProps>;
+declare const OutlinePanel: React$1.FC<OutlinePanelProps>;
 
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
-    children: React__default.ReactNode;
+    children: React$1.ReactNode;
 }
 /**
  * Context provider allowing consumers to inject custom design system components into the editor.
  */
-declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderProps): React__default.JSX.Element;
+declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderProps): React$1.JSX.Element;
 /**
  * Hook to access injected design system slots.
  */
@@ -519,27 +365,36 @@ interface CommentsPanelProps {
  * thread selects its text in the editor. Threads with an empty body are
  * drafts (e.g. created by `CommentButton`) and show a compose box.
  */
-declare const CommentsPanel: React__default.FC<CommentsPanelProps>;
+declare const CommentsPanel: React$1.FC<CommentsPanelProps>;
 
 interface ReviewToolbarProps {
     editor: Editor | null;
     className?: string;
+    /**
+     * Show the current change's author and description (e.g. "Alice: Formatted:
+     * Bold"). Defaults to `true`.
+     */
+    showDescription?: boolean;
+    /** Class of the description label. */
+    descriptionClassName?: string;
 }
 /**
- * Toolbar for tracked changes: toggle tracking, step through changes, and
- * accept or reject the current change or all changes.
+ * Toolbar for tracked changes: toggle tracking, step through changes
+ * (insertions, deletions, formatting and block changes, with a description
+ * of the current one), and accept or reject the current change or all
+ * changes.
  */
-declare const ReviewToolbar: React__default.FC<ReviewToolbarProps>;
+declare const ReviewToolbar: React$1.FC<ReviewToolbarProps>;
 
 interface CommentButtonProps {
     editor: Editor | null;
     className?: string;
-    children?: React__default.ReactNode;
+    children?: React$1.ReactNode;
 }
 /**
  * Adds a draft comment on the selection; drop it into a `BubbleMenu`. The
  * draft is completed in `CommentsPanel`.
  */
-declare const CommentButton: React__default.FC<CommentButtonProps>;
+declare const CommentButton: React$1.FC<CommentButtonProps>;
 
-export { BubbleMenu, type BubbleMenuProps, CommentButton, type CommentButtonProps, CommentsPanel, type CommentsPanelProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, FormulaHints, type FormulaHintsProps, type HistoryShortcutsOptions, OutlinePanel, type OutlinePanelProps, ReviewToolbar, type ReviewToolbarProps, SpreadsheetContextMenu, type SpreadsheetContextMenuProps, SpreadsheetEditor, type SpreadsheetEditorProps, SpreadsheetGroupRow, type SpreadsheetGroupRowProps, TemplateRenderer, type TemplateRendererProps, type UseCommentsResult, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseFileImportResult, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useFillHandle, useHistory, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useSpreadsheetClipboard, useSpreadsheetEditor, useTrackChanges };
+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 UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, type UseTrackChangesResult, VariableForm, type VariableFormProps, useAgentToolProvider, useComments, useDismissGuard, useEditor, useEditorSlots, useFileImport, useHistory, useHistoryShortcuts, useNavigationGuard, useOutline, usePromptEditor, useTrackChanges };