@tessera-editor/react 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,9 +1,12 @@
 import * as react from 'react';
+import { ReactNode } from 'react';
 import { Editor } from '@tiptap/react';
+export { Editor } from '@tiptap/react';
 import * as _tiptap_core from '@tiptap/core';
 import { Content } from '@tiptap/core';
+export { Content, JSONContent } from '@tiptap/core';
 import * as _tessera_editor_core from '@tessera-editor/core';
-import { TesseraLocale, UploadService, StorageService, CommentStore, IdentityService, SlashMenuItem, TesseraTranslator } from '@tessera-editor/core';
+import { TesseraLocale, TesseraMessageOverrides, UploadService, CommentStore, IdentityService, TesseraTranslator, SlashMenuItem } from '@tessera-editor/core';
 import { AIRuntime, SuggestionSession, AiController } from '@tessera-editor/ai';
 import { SuggestionProps, SuggestionKeyDownProps } from '@tiptap/suggestion';
 import * as _tiptap_extension_table from '@tiptap/extension-table';
@@ -12,24 +15,40 @@ interface TesseraProps {
     /** Initial document (JSON / HTML / markdown string). Host owns persistence. */
     content?: Content;
     locale?: TesseraLocale;
+    /** Empty-paragraph placeholder text (default: the i18n `placeholderEmpty` string). */
+    placeholder?: string;
+    /** Per-key overrides of the built-in UI dictionary (slash items, tooltips…). */
+    messages?: TesseraMessageOverrides;
+    /** Render the editor read-only (default: editable). */
+    editable?: boolean;
+    /**
+     * Host block policy: top-level block types to exclude entirely (see
+     * `TesseraPresetOptions.excludeBlocks`). Read once at editor creation.
+     */
+    excludeBlocks?: string[];
     /** Injected image upload capability (ADR-0001 family). */
     upload?: UploadService;
-    /** v1.1: version-history snapshot storage. */
-    storage?: StorageService;
     /** v1.1: inline comment persistence. */
     comments?: CommentStore;
     /** v1.1: current user (comment authorship). */
     identity?: IdentityService;
     /** Injected model runtime; presence enables all AI surfaces. */
     ai?: AIRuntime;
-    /** v1.1: idle window for history auto-capture (playground uses short ones) */
-    historyIdleMs?: number;
     /** v1.1: document column max-width in px (Slite-style centered column). */
     docWidth?: number;
+    /**
+     * Host buttons appended to the selection toolbar (e.g. custom AI actions).
+     * A render function receives the live editor + translator, so a host button
+     * like 「让 AI 改写此段」 can read the current selection on click.
+     */
+    extraSelectionItems?: ReactNode | ((ctx: {
+        editor: Editor;
+        t: TesseraTranslator;
+    }) => ReactNode);
     onUpdate?: (editor: Editor) => void;
     onCreate?: (editor: Editor) => void;
 }
-declare function Tessera({ content, locale, upload, storage, comments, identity, ai: runtime, historyIdleMs, docWidth, onUpdate, onCreate, }: TesseraProps): react.JSX.Element | null;
+declare function Tessera({ content, locale, placeholder, messages, editable, excludeBlocks, upload, comments, identity, ai: runtime, docWidth, extraSelectionItems, onUpdate, onCreate, }: TesseraProps): react.JSX.Element | null;
 
 declare function EmptyLineToolbar(): react.ReactPortal | null;
 
@@ -65,12 +84,6 @@ declare function SuggestionBar({ session, onClear, }: {
     onClear: () => void;
 }): react.JSX.Element | null;
 
-/**
- * Version history panel (v1.1): snapshots from the injected StorageService,
- * block+word level diff against the current doc, one-click restore.
- */
-declare function HistoryPanel(): react.JSX.Element | null;
-
 declare function CommentPanel(): react.JSX.Element | null;
 /** Selection-toolbar composer popover: quote + comment → thread + mark. */
 declare function CommentComposer({ onClose }: {
@@ -93,8 +106,17 @@ interface TesseraContextValue {
     locale: TesseraLocale;
     t: TesseraTranslator;
     ai: AiController | null;
+    /**
+     * Host buttons appended to the selection toolbar (e.g. custom AI actions).
+     * A render function receives the live editor + translator, so a host button
+     * like 「让 AI 改写此段」 can read the current selection on click.
+     */
+    extraSelectionItems?: ReactNode | ((ctx: {
+        editor: Editor;
+        t: TesseraTranslator;
+    }) => ReactNode);
 }
 declare const TesseraContext: react.Context<TesseraContextValue | null>;
 declare function useTesseraContext(): TesseraContextValue;
 
-export { AiTableCellViewExtension, AiTableHeaderViewExtension, AskPanel, BlockContextMenuUI, CommentComposer, CommentPanel, EmbedBlockView, EmptyLineToolbar, FindReplacePanel, HistoryPanel, ImageBlockView, SelectionToolbar, SlashMenuView, SuggestionBar, Tessera, TesseraContext, type TesseraContextValue, type TesseraProps, TocBlockView, createSlashRenderer, useTesseraContext };
+export { AiTableCellViewExtension, AiTableHeaderViewExtension, AskPanel, BlockContextMenuUI, CommentComposer, CommentPanel, EmbedBlockView, EmptyLineToolbar, FindReplacePanel, ImageBlockView, SelectionToolbar, SlashMenuView, SuggestionBar, Tessera, TesseraContext, type TesseraContextValue, type TesseraProps, TocBlockView, createSlashRenderer, useTesseraContext };