@pixerate/editor-react 0.11.0 → 0.13.0

package/dist/index.d.cts

@@ -1,13 +1,14 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import * as _pixerate_editor from '@pixerate/editor';
-import { Template, ColorGradient, RichTextPresetOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, SpreadsheetControllerOptions, SpreadsheetDocument, CellCoordinate, CellRange, SpreadsheetController, SpreadsheetColumn, SpreadsheetRow, SpreadsheetDataSource, CellData, EditorSlotsMap } from '@pixerate/editor';
-export { ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryManager, HistoryManagerOptions, HistoryState, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, createDirtyTracker, createHistoryManager, defaultIsEqual } 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 * as React$1 from 'react';
+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';
+import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 
 interface UsePromptEditorProps {
@@ -58,11 +59,28 @@ interface UsePromptEditorProps {
     jsonVariables?: string[];
     /** Animation speed for gradient decorations */
     speed?: number;
+    /**
+     * Import text from .md, .html, .txt and .rtf files dropped onto the editor
+     * (opt-in). Content is always inserted as plain text. Pasting keeps the
+     * plain-text paste handler, so pasted files are not imported.
+     */
+    fileImport?: Omit<FileImportOptions, "asPlainText"> | boolean;
 }
-declare function usePromptEditor({ content, onContentChange, templates, templateColorMap: userColorMap, isEditing, placeholder, className, onEscape, onKeyDown, onSelectionChange, onSlashCommandMatch, clearSlashCommand, slashCommandActive, onMilestone, containerId, jsonVariables, speed, }: UsePromptEditorProps): _tiptap_core.Editor | null;
+declare function usePromptEditor({ content, onContentChange, templates, templateColorMap: userColorMap, isEditing, placeholder, className, onEscape, onKeyDown, onSelectionChange, onSlashCommandMatch, clearSlashCommand, slashCommandActive, onMilestone, containerId, jsonVariables, speed, fileImport, }: UsePromptEditorProps): _tiptap_core.Editor | null;
 
 interface UseRichEditorProps extends UseEditorOptions {
     richTextOptions?: RichTextPresetOptions;
+    /**
+     * Import .md, .html, .txt and .rtf files dropped or pasted into the editor
+     * at the drop position (opt-in; same as `richTextOptions.fileImport`).
+     */
+    fileImport?: FileImportOptions | boolean;
+    /**
+     * Copy/paste lossless ProseMirror slices between editors via the
+     * `application/x.pixerate.document+json` clipboard type (opt-in; same as
+     * `richTextOptions.richClipboard`).
+     */
+    richClipboard?: RichClipboardOptions | boolean;
 }
 /**
  * Hook to initialize a TipTap rich-text editor instance with pre-configured extensions.
@@ -163,6 +181,32 @@ interface HistoryShortcutsOptions {
  */
 declare function useHistoryShortcuts(manager: HistoryManager, options?: HistoryShortcutsOptions): void;
 
+interface UseFileImportResult extends FileImportState {
+    /** Value for `<input type="file" accept={…}>`. */
+    accept: string;
+    /** Opens the browser file picker and imports the chosen files at the selection. */
+    openFilePicker: FileImportController["openFilePicker"];
+    /** Imports files (e.g. from your own `<input>` or drop zone) at `at` or the selection. */
+    importFiles: FileImportController["importFiles"];
+}
+/**
+ * Imports markdown, HTML, plain-text and RTF files (or anything registered
+ * with `registerImportAdapter` for the `document` target) into an editor.
+ * Pair it with `useEditor({ fileImport: true })` to also accept dropped files.
+ */
+declare function useFileImport(editor: Editor | null | undefined, options?: FileImportControllerOptions): UseFileImportResult;
+
+/**
+ * Registers a tool provider with a `ToolRegistry` while the component is
+ * mounted and unregisters it on unmount (the registry then announces the
+ * change through `onListChanged`).
+ *
+ * Memoize the provider (e.g. `useMemo(() => createRichTextToolProvider(editor,
+ * { id }), [editor])`): a new provider object re-registers it. Pass `null`
+ * while it isn't ready.
+ */
+declare function useAgentToolProvider(registry: ToolRegistry | null | undefined, provider: AgentToolProvider | null | undefined): void;
+
 interface EditorContentProps extends EditorContentProps$1 {
     className?: string;
 }
@@ -188,6 +232,13 @@ interface TemplateRendererProps {
     templateColorMap?: Map<string, ColorGradient>;
     /** Whether to resolve nested templates recursively before displaying */
     resolve?: boolean;
+    /** Template version bindings used when `resolve` is set */
+    bindings?: Record<string, string>;
+    /**
+     * Variable values. When set, variables show their value (or default),
+     * sections whose condition fails are hidden, and section tags are dropped.
+     */
+    values?: PromptValues;
     /** Custom class name for the wrapper */
     className?: string;
     /** Click callback for template badges */
@@ -197,52 +248,67 @@ interface TemplateRendererProps {
 }
 declare const TemplateRenderer: React__default.FC<TemplateRendererProps>;
 
-declare function useSpreadsheetEditor(options?: SpreadsheetControllerOptions): {
-    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;
-    undo: () => void;
-    redo: () => void;
-};
+interface VariableFormProps {
+    /** Prompt whose variables become form fields */
+    content: string;
+    /** Templates searched recursively for further variables */
+    templates?: Template[];
+    /** Template version bindings */
+    bindings?: Record<string, string>;
+    /** Entered text per variable (controlled). Omit to let the form keep its own state. */
+    values?: Record<string, string>;
+    /** Initial entered text when uncontrolled */
+    defaultValues?: Record<string, string>;
+    /**
+     * Called on every edit with the values to resolve with (blank fields
+     * dropped so defaults apply) and the raw entered text.
+     */
+    onChange?: (values: PromptValues, entered: Record<string, string>) => void;
+    /** Custom class name for the wrapper */
+    className?: string;
+}
+/**
+ * Renders one input per prompt variable: labelled with its description,
+ * using its default as the placeholder. Variables only used by `{?name}`
+ * conditions render as checkboxes.
+ */
+declare const VariableForm: React__default.FC<VariableFormProps>;
+
+/**
+ * Subscribes to an editor's heading outline. Returns the headings (flat and
+ * nested) and the id of the heading whose section contains the selection.
+ * Re-renders only when the outline or the active heading changes.
+ *
+ * Install the `Outline` extension (`richTextOptions: { outline: true }`) for
+ * stable heading ids; without it, headings are still listed.
+ */
+declare function useOutline(editor: Editor | null | undefined): OutlineSnapshot;
 
-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;
+interface OutlinePanelProps {
+    editor: Editor | null;
+    /** Heading shown above the list. Pass `null` to hide it. */
+    title?: React__default.ReactNode;
+    /** Content shown when the document has no headings. */
+    emptyState?: React__default.ReactNode;
+    /** Deepest heading level listed. Defaults to 6. */
+    maxLevel?: number;
+    /** Whether clicking an entry focuses the editor. Defaults to `true`. */
+    focusOnNavigate?: boolean;
+    /** Custom class name for the wrapper. */
+    className?: string;
+    /** Class name for each entry button. */
+    itemClassName?: string;
+    /** Class name added to the entry of the section containing the selection. */
+    activeItemClassName?: string;
+    /** Called after navigating to a heading. */
+    onNavigate?: (heading: OutlineHeading) => void;
 }
-declare const SpreadsheetEditor: React__default.FC<SpreadsheetEditorProps>;
+/**
+ * Navigation sidebar listing the document's headings (Word's Navigation pane).
+ * 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>;
 
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
@@ -257,4 +323,69 @@ declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderPro
  */
 declare function useEditorSlots(): EditorSlotsMap;
 
-export { BubbleMenu, type BubbleMenuProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, type HistoryShortcutsOptions, SpreadsheetEditor, type SpreadsheetEditorProps, TemplateRenderer, type TemplateRendererProps, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, useDismissGuard, useEditor, useEditorSlots, useHistory, useHistoryShortcuts, useNavigationGuard, usePromptEditor, useSpreadsheetEditor };
+interface UseCommentsResult extends CommentStoreSnapshot {
+    store: CommentStore | null;
+}
+/**
+ * Subscribes to a comment store: pass the store itself, or an editor using
+ * the `Comments` extension (`null` while the editor is being created).
+ */
+declare function useComments(source: Editor | CommentStore | null | undefined): UseCommentsResult;
+interface UseTrackChangesResult extends TrackChangesSnapshot {
+    currentChange: TrackedChange | null;
+    setEnabled: (enabled: boolean) => void;
+    toggle: () => void;
+    accept: (id: string) => void;
+    reject: (id: string) => void;
+    acceptAll: () => void;
+    rejectAll: () => void;
+    next: () => void;
+    previous: () => void;
+}
+/**
+ * Subscribes to the tracked-change state of an editor using the
+ * `TrackChanges` extension and exposes its commands.
+ */
+declare function useTrackChanges(editor: Editor | null | undefined): UseTrackChangesResult;
+
+interface CommentsPanelProps {
+    editor: Editor | null;
+    /** Defaults to the store of the editor's `Comments` extension. */
+    store?: CommentStore;
+    /** Author of replies. Defaults to the `Comments` extension's author. */
+    author?: ReviewAuthor;
+    /** Initially show resolved threads. */
+    showResolved?: boolean;
+    className?: string;
+    formatTime?: (timestamp: number) => string;
+    emptyMessage?: string;
+}
+/**
+ * Lists comment threads with reply, resolve and delete actions. Clicking a
+ * 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>;
+
+interface ReviewToolbarProps {
+    editor: Editor | null;
+    className?: string;
+}
+/**
+ * Toolbar for tracked changes: toggle tracking, step through changes, and
+ * accept or reject the current change or all changes.
+ */
+declare const ReviewToolbar: React__default.FC<ReviewToolbarProps>;
+
+interface CommentButtonProps {
+    editor: Editor | null;
+    className?: string;
+    children?: React__default.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>;
+
+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,13 +1,14 @@
 import * as _tiptap_core from '@tiptap/core';
 import { Editor } from '@tiptap/core';
-import * as _pixerate_editor from '@pixerate/editor';
-import { Template, ColorGradient, RichTextPresetOptions, HistoryState, HistoryManager, Command, HistoryManagerOptions, SpreadsheetControllerOptions, SpreadsheetDocument, CellCoordinate, CellRange, SpreadsheetController, SpreadsheetColumn, SpreadsheetRow, SpreadsheetDataSource, CellData, EditorSlotsMap } from '@pixerate/editor';
-export { ColorGradient, Command, DirtyTracker, DirtyTrackerOptions, HistoryManager, HistoryManagerOptions, HistoryState, RichTextPresetOptions, Template, TemplateVersion, Token, TokenType, createDirtyTracker, createHistoryManager, defaultIsEqual } 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 * as React$1 from 'react';
+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';
+import '@pixerate/editor/spreadsheet';
 import '@pixerate/editor/image-editor';
 
 interface UsePromptEditorProps {
@@ -58,11 +59,28 @@ interface UsePromptEditorProps {
     jsonVariables?: string[];
     /** Animation speed for gradient decorations */
     speed?: number;
+    /**
+     * Import text from .md, .html, .txt and .rtf files dropped onto the editor
+     * (opt-in). Content is always inserted as plain text. Pasting keeps the
+     * plain-text paste handler, so pasted files are not imported.
+     */
+    fileImport?: Omit<FileImportOptions, "asPlainText"> | boolean;
 }
-declare function usePromptEditor({ content, onContentChange, templates, templateColorMap: userColorMap, isEditing, placeholder, className, onEscape, onKeyDown, onSelectionChange, onSlashCommandMatch, clearSlashCommand, slashCommandActive, onMilestone, containerId, jsonVariables, speed, }: UsePromptEditorProps): _tiptap_core.Editor | null;
+declare function usePromptEditor({ content, onContentChange, templates, templateColorMap: userColorMap, isEditing, placeholder, className, onEscape, onKeyDown, onSelectionChange, onSlashCommandMatch, clearSlashCommand, slashCommandActive, onMilestone, containerId, jsonVariables, speed, fileImport, }: UsePromptEditorProps): _tiptap_core.Editor | null;
 
 interface UseRichEditorProps extends UseEditorOptions {
     richTextOptions?: RichTextPresetOptions;
+    /**
+     * Import .md, .html, .txt and .rtf files dropped or pasted into the editor
+     * at the drop position (opt-in; same as `richTextOptions.fileImport`).
+     */
+    fileImport?: FileImportOptions | boolean;
+    /**
+     * Copy/paste lossless ProseMirror slices between editors via the
+     * `application/x.pixerate.document+json` clipboard type (opt-in; same as
+     * `richTextOptions.richClipboard`).
+     */
+    richClipboard?: RichClipboardOptions | boolean;
 }
 /**
  * Hook to initialize a TipTap rich-text editor instance with pre-configured extensions.
@@ -163,6 +181,32 @@ interface HistoryShortcutsOptions {
  */
 declare function useHistoryShortcuts(manager: HistoryManager, options?: HistoryShortcutsOptions): void;
 
+interface UseFileImportResult extends FileImportState {
+    /** Value for `<input type="file" accept={…}>`. */
+    accept: string;
+    /** Opens the browser file picker and imports the chosen files at the selection. */
+    openFilePicker: FileImportController["openFilePicker"];
+    /** Imports files (e.g. from your own `<input>` or drop zone) at `at` or the selection. */
+    importFiles: FileImportController["importFiles"];
+}
+/**
+ * Imports markdown, HTML, plain-text and RTF files (or anything registered
+ * with `registerImportAdapter` for the `document` target) into an editor.
+ * Pair it with `useEditor({ fileImport: true })` to also accept dropped files.
+ */
+declare function useFileImport(editor: Editor | null | undefined, options?: FileImportControllerOptions): UseFileImportResult;
+
+/**
+ * Registers a tool provider with a `ToolRegistry` while the component is
+ * mounted and unregisters it on unmount (the registry then announces the
+ * change through `onListChanged`).
+ *
+ * Memoize the provider (e.g. `useMemo(() => createRichTextToolProvider(editor,
+ * { id }), [editor])`): a new provider object re-registers it. Pass `null`
+ * while it isn't ready.
+ */
+declare function useAgentToolProvider(registry: ToolRegistry | null | undefined, provider: AgentToolProvider | null | undefined): void;
+
 interface EditorContentProps extends EditorContentProps$1 {
     className?: string;
 }
@@ -188,6 +232,13 @@ interface TemplateRendererProps {
     templateColorMap?: Map<string, ColorGradient>;
     /** Whether to resolve nested templates recursively before displaying */
     resolve?: boolean;
+    /** Template version bindings used when `resolve` is set */
+    bindings?: Record<string, string>;
+    /**
+     * Variable values. When set, variables show their value (or default),
+     * sections whose condition fails are hidden, and section tags are dropped.
+     */
+    values?: PromptValues;
     /** Custom class name for the wrapper */
     className?: string;
     /** Click callback for template badges */
@@ -197,52 +248,67 @@ interface TemplateRendererProps {
 }
 declare const TemplateRenderer: React__default.FC<TemplateRendererProps>;
 
-declare function useSpreadsheetEditor(options?: SpreadsheetControllerOptions): {
-    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;
-    undo: () => void;
-    redo: () => void;
-};
+interface VariableFormProps {
+    /** Prompt whose variables become form fields */
+    content: string;
+    /** Templates searched recursively for further variables */
+    templates?: Template[];
+    /** Template version bindings */
+    bindings?: Record<string, string>;
+    /** Entered text per variable (controlled). Omit to let the form keep its own state. */
+    values?: Record<string, string>;
+    /** Initial entered text when uncontrolled */
+    defaultValues?: Record<string, string>;
+    /**
+     * Called on every edit with the values to resolve with (blank fields
+     * dropped so defaults apply) and the raw entered text.
+     */
+    onChange?: (values: PromptValues, entered: Record<string, string>) => void;
+    /** Custom class name for the wrapper */
+    className?: string;
+}
+/**
+ * Renders one input per prompt variable: labelled with its description,
+ * using its default as the placeholder. Variables only used by `{?name}`
+ * conditions render as checkboxes.
+ */
+declare const VariableForm: React__default.FC<VariableFormProps>;
+
+/**
+ * Subscribes to an editor's heading outline. Returns the headings (flat and
+ * nested) and the id of the heading whose section contains the selection.
+ * Re-renders only when the outline or the active heading changes.
+ *
+ * Install the `Outline` extension (`richTextOptions: { outline: true }`) for
+ * stable heading ids; without it, headings are still listed.
+ */
+declare function useOutline(editor: Editor | null | undefined): OutlineSnapshot;
 
-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;
+interface OutlinePanelProps {
+    editor: Editor | null;
+    /** Heading shown above the list. Pass `null` to hide it. */
+    title?: React__default.ReactNode;
+    /** Content shown when the document has no headings. */
+    emptyState?: React__default.ReactNode;
+    /** Deepest heading level listed. Defaults to 6. */
+    maxLevel?: number;
+    /** Whether clicking an entry focuses the editor. Defaults to `true`. */
+    focusOnNavigate?: boolean;
+    /** Custom class name for the wrapper. */
+    className?: string;
+    /** Class name for each entry button. */
+    itemClassName?: string;
+    /** Class name added to the entry of the section containing the selection. */
+    activeItemClassName?: string;
+    /** Called after navigating to a heading. */
+    onNavigate?: (heading: OutlineHeading) => void;
 }
-declare const SpreadsheetEditor: React__default.FC<SpreadsheetEditorProps>;
+/**
+ * Navigation sidebar listing the document's headings (Word's Navigation pane).
+ * 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>;
 
 interface EditorSlotsProviderProps {
     slots?: Partial<EditorSlotsMap>;
@@ -257,4 +323,69 @@ declare function EditorSlotsProvider({ slots, children }: EditorSlotsProviderPro
  */
 declare function useEditorSlots(): EditorSlotsMap;
 
-export { BubbleMenu, type BubbleMenuProps, EditorContent, type EditorContentProps, EditorSlotsProvider, type EditorSlotsProviderProps, type HistoryShortcutsOptions, SpreadsheetEditor, type SpreadsheetEditorProps, TemplateRenderer, type TemplateRendererProps, type UseDismissGuardOptions, type UseDismissGuardReturn, type UseHistoryResult, type UseNavigationGuardOptions, type UseNavigationGuardReturn, type UsePromptEditorProps, type UseRichEditorProps, useDismissGuard, useEditor, useEditorSlots, useHistory, useHistoryShortcuts, useNavigationGuard, usePromptEditor, useSpreadsheetEditor };
+interface UseCommentsResult extends CommentStoreSnapshot {
+    store: CommentStore | null;
+}
+/**
+ * Subscribes to a comment store: pass the store itself, or an editor using
+ * the `Comments` extension (`null` while the editor is being created).
+ */
+declare function useComments(source: Editor | CommentStore | null | undefined): UseCommentsResult;
+interface UseTrackChangesResult extends TrackChangesSnapshot {
+    currentChange: TrackedChange | null;
+    setEnabled: (enabled: boolean) => void;
+    toggle: () => void;
+    accept: (id: string) => void;
+    reject: (id: string) => void;
+    acceptAll: () => void;
+    rejectAll: () => void;
+    next: () => void;
+    previous: () => void;
+}
+/**
+ * Subscribes to the tracked-change state of an editor using the
+ * `TrackChanges` extension and exposes its commands.
+ */
+declare function useTrackChanges(editor: Editor | null | undefined): UseTrackChangesResult;
+
+interface CommentsPanelProps {
+    editor: Editor | null;
+    /** Defaults to the store of the editor's `Comments` extension. */
+    store?: CommentStore;
+    /** Author of replies. Defaults to the `Comments` extension's author. */
+    author?: ReviewAuthor;
+    /** Initially show resolved threads. */
+    showResolved?: boolean;
+    className?: string;
+    formatTime?: (timestamp: number) => string;
+    emptyMessage?: string;
+}
+/**
+ * Lists comment threads with reply, resolve and delete actions. Clicking a
+ * 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>;
+
+interface ReviewToolbarProps {
+    editor: Editor | null;
+    className?: string;
+}
+/**
+ * Toolbar for tracked changes: toggle tracking, step through changes, and
+ * accept or reject the current change or all changes.
+ */
+declare const ReviewToolbar: React__default.FC<ReviewToolbarProps>;
+
+interface CommentButtonProps {
+    editor: Editor | null;
+    className?: string;
+    children?: React__default.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>;
+
+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 };