@openim/im-composer 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { DecoratorNode, NodeKey, EditorConfig, DOMExportOutput, DOMConversionMap, Spread, SerializedLexicalNode, LexicalNode, LexicalEditor } from 'lexical';
+import * as React$1 from 'react';
+import React__default, { MouseEventHandler, ReactNode } from 'react';
+import { Editor, useEditor } from '@tiptap/react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Editor as Editor$1 } from '@tiptap/core';
 
 /**
- * Attachment type for files added in plain mode
+ * Represents a file attachment in plain mode
  */
-type Attachment = {
+interface Attachment {
     /** Unique identifier generated by the component */
     id: string;
-    /** Original File object for upload/send */
+    /** Original File object */
     file: File;
     /** File name */
     name: string;
@@ -16,391 +18,600 @@ type Attachment = {
     size: number;
     /** MIME type */
     mime: string;
-    /** Last modified timestamp */
+    /** File last modified timestamp */
     lastModified?: number;
-    /** Preview URL (objectURL) for display */
+    /** Preview URL for images (objectURL) */
     previewUrl?: string;
-};
+}
 /**
- * Mention info in the message
+ * Information about a mention in the message
  */
-type MentionInfo = {
-    /** User ID of the mentioned member */
+interface MentionInfo {
+    /** User ID */
     userId: string;
-    /** Display name shown in the text */
+    /** Display name */
     display: string;
-    /** Start index (UTF-16, inclusive) */
+    /** Start index in plainText (UTF-16, inclusive) */
     start: number;
-    /** End index (UTF-16, exclusive) */
+    /** End index in plainText (UTF-16, exclusive) */
     end: number;
-};
+}
+/**
+ * Member data for mention suggestions
+ */
+interface Member {
+    /** Unique user identifier */
+    userId: string;
+    /** Display name shown in the editor */
+    display: string;
+    /** Optional avatar URL */
+    avatarUrl?: string;
+}
 /**
- * Quote information
+ * Quoted message information
  */
-type QuoteInfo = {
-    /** Title (e.g., "Reply Name:") */
+interface QuoteInfo {
+    /** Quote title, e.g., "Reply to Alice:" */
     title: string;
-    /** Content of the quote */
+    /** Quoted content */
     content: string;
-};
+}
 /**
- * Locale/i18n configuration for the composer
+ * Result from image upload handler
  */
-type IMComposerLocale = {
-    /** Link dialog labels */
-    linkDialog?: {
-        textLabel?: string;
-        urlLabel?: string;
-        cancelButton?: string;
-        insertButton?: string;
-        saveButton?: string;
-    };
-    /** Toolbar button titles */
-    toolbar?: {
-        bold?: string;
-        italic?: string;
-        strikethrough?: string;
-        code?: string;
-        heading1?: string;
-        heading2?: string;
-        heading3?: string;
-        bulletList?: string;
-        orderedList?: string;
-        quote?: string;
-        codeBlock?: string;
-        link?: string;
-        image?: string;
-    };
-};
+interface UploadImageResult {
+    /** URL of the uploaded image */
+    url: string;
+    /** Optional alt text */
+    alt?: string;
+}
+/**
+ * Progress callback for image upload
+ */
+interface UploadProgressEvent {
+    /** Upload progress percentage (0-100) */
+    progress: number;
+}
+/**
+ * Image upload function type with optional progress callback
+ */
+type UploadImageFn = (file: File, onProgress?: (event: UploadProgressEvent) => void) => Promise<UploadImageResult>;
 /**
  * Payload for plain text mode messages
  */
-type PlainMessagePayload = {
+interface PlainMessagePayload {
     type: 'text';
-    /** Plain text with @mentions as @{display} */
+    /** Plain text with mentions as @userId */
     plainText: string;
-    /** List of mentions with positions */
+    /** List of mentions with their positions */
     mentions: MentionInfo[];
-    /** Attached files */
+    /** List of attached files */
     attachments: Attachment[];
-    /** Optional quote message */
+    /** Quoted message (if any) */
     quote?: QuoteInfo;
-};
+}
 /**
- * Payload for rich text (markdown) mode messages
+ * Payload for rich text mode messages (Markdown)
  */
-type MarkdownMessagePayload = {
+interface MarkdownMessagePayload {
     type: 'markdown';
     /** Markdown content */
     markdown: string;
-};
+}
 /**
  * Union type for all message payloads
  */
 type MessagePayload = PlainMessagePayload | MarkdownMessagePayload;
 /**
- * Member info for mentions
+ * Draft state for saving/restoring editor content
  */
-type Member = {
-    /** Unique user ID */
-    userId: string;
-    /** Display name */
-    display: string;
-    /** Optional avatar URL */
-    avatarUrl?: string;
-};
+interface ComposerDraft {
+    /** Editor mode */
+    mode?: EditorMode;
+    /** Serialized editor state (JSON string from getJSON) - deprecated, use json */
+    editorState?: string;
+    /** Editor JSON content */
+    json?: Record<string, unknown>;
+    /** Attachments (plain mode only) */
+    attachments?: Attachment[];
+    /** Quick restore text for plain mode */
+    text?: string;
+    /** Quote information (plain mode only) */
+    quote?: QuoteInfo;
+}
 /**
- * Composer mode
+ * Locale strings for internationalization
  */
-type ComposerMode = 'plain' | 'rich';
+interface IMComposerLocale {
+    /** Placeholder text for plain mode */
+    placeholderPlain?: string;
+    /** Placeholder text for rich mode */
+    placeholderRich?: string;
+    /** No results found in mention list */
+    mentionNoResults?: string;
+    /** Loading text for mention list */
+    mentionLoading?: string;
+    /** Error text for mention list */
+    mentionError?: string;
+    /** Remove attachment button label */
+    removeAttachment?: string;
+    /** Remove quote button label */
+    removeQuote?: string;
+    /** Upload failed message */
+    uploadFailed?: string;
+    /** Uploading text */
+    uploading?: string;
+    /** Undo button */
+    undo?: string;
+    /** Redo button */
+    redo?: string;
+    /** Heading dropdown */
+    heading?: string;
+    /** Heading 1 */
+    heading1?: string;
+    /** Heading 2 */
+    heading2?: string;
+    /** Heading 3 */
+    heading3?: string;
+    /** Heading 4 */
+    heading4?: string;
+    /** Paragraph */
+    paragraph?: string;
+    /** List dropdown */
+    list?: string;
+    /** Bullet list */
+    bulletList?: string;
+    /** Ordered list */
+    orderedList?: string;
+    /** Task list */
+    taskList?: string;
+    /** Blockquote button */
+    blockquote?: string;
+    /** Code block button */
+    codeBlock?: string;
+    /** Bold button */
+    bold?: string;
+    /** Italic button */
+    italic?: string;
+    /** Strikethrough button */
+    strike?: string;
+    /** Inline code button */
+    code?: string;
+    /** Underline button */
+    underline?: string;
+    /** Highlight button */
+    highlight?: string;
+    /** Remove highlight */
+    removeHighlight?: string;
+    /** Link button */
+    link?: string;
+    /** Link input placeholder */
+    linkPlaceholder?: string;
+    /** Apply link */
+    applyLink?: string;
+    /** Open link */
+    openLink?: string;
+    /** Remove link */
+    removeLink?: string;
+    /** Superscript button */
+    superscript?: string;
+    /** Subscript button */
+    subscript?: string;
+    /** Align left button */
+    alignLeft?: string;
+    /** Align center button */
+    alignCenter?: string;
+    /** Align right button */
+    alignRight?: string;
+    /** Align justify button */
+    alignJustify?: string;
+    /** Insert image button */
+    insertImage?: string;
+    /** Upload image */
+    uploadImage?: string;
+    /** Click to upload */
+    clickToUpload?: string;
+    /** Or drag and drop */
+    orDragAndDrop?: string;
+    /** Maximum files */
+    maxFiles?: string;
+    /** Clear all */
+    clearAll?: string;
+}
 /**
- * Result from image upload
+ * Default English locale
  */
-type UploadImageResult = {
-    /** URL of the uploaded image (must be https) */
-    url: string;
-    /** Optional alt text */
-    alt?: string;
-};
+declare const defaultLocale: IMComposerLocale;
 /**
- * Image upload function type
+ * Send keymap configuration
  */
-type UploadImageFn = (file: File) => Promise<UploadImageResult>;
+type SendKeymap = 'enter' | 'ctrlEnter' | 'cmdEnter';
 /**
- * Markdown syntax options
+ * Editor mode
  */
-type MarkdownSyntaxOptions = {
-    heading?: boolean;
-    bold?: boolean;
-    italic?: boolean;
-    strike?: boolean;
-    codeInline?: boolean;
-    codeBlock?: boolean;
-    quote?: boolean;
-    list?: boolean;
-    link?: boolean;
-    image?: boolean;
-};
+type EditorMode = 'plain' | 'rich';
 /**
- * Keymap send key options
+ * Attachment limit exceeded reason
  */
-type SendKey = 'enter' | 'ctrlEnter' | 'cmdEnter';
+type AttachmentLimitReason = 'count' | 'size' | 'mime';
 /**
- * Props for IMComposer component
+ * Main component props
  */
-type IMComposerProps = {
+interface IMComposerProps {
     /** Controlled mode */
-    mode?: ComposerMode;
+    mode?: EditorMode;
     /** Default mode for uncontrolled usage */
-    defaultMode?: ComposerMode;
-    /** Callback when user sends a message */
+    defaultMode?: EditorMode;
+    /** Called when user triggers send action */
     onSend?: (payload: PlainMessagePayload | MarkdownMessagePayload) => void;
-    /** Enable @mention feature (default: true, plain mode only) */
+    /** Called when editor content changes */
+    onChange?: () => void;
+    /** Context menu handler */
+    onContextMenu?: MouseEventHandler<HTMLDivElement>;
+    /** Called when quote is removed */
+    onQuoteRemoved?: () => void;
+    /** Enable @mention feature */
     enableMention?: boolean;
-    /** Async function to search members for mention */
+    /** Async provider for mention suggestions */
     mentionProvider?: (query: string) => Promise<Member[]>;
-    /** Maximum number of mentions allowed (plain mode only) */
+    /** Maximum number of mentions allowed */
     maxMentions?: number;
-    /** Custom render function for mention list items in dropdown */
+    /** Custom render function for mention list items */
     renderMentionItem?: (props: {
         member: Member;
         isSelected: boolean;
-    }) => React.ReactNode;
-    /** Enable file attachments (default: true, plain mode only) */
+    }) => ReactNode;
+    /** Mention list placement relative to cursor: 'top' or 'bottom' */
+    mentionPlacement?: 'top' | 'bottom';
+    /** Enable file attachments */
     enableAttachments?: boolean;
-    /** Position of attachment preview bar (default: 'bottom') */
+    /** Attachment preview bar placement */
     attachmentPreviewPlacement?: 'top' | 'bottom';
-    /** Maximum number of attachments (default: 10) */
+    /** Maximum number of attachments */
     maxAttachments?: number;
-    /** Allowed MIME types (default: all) */
+    /** Allowed MIME types (supports wildcards like "image/*") */
     allowedMimeTypes?: string[];
     /** Maximum file size in bytes */
     maxFileSize?: number;
-    /** Callback when attachment limit is exceeded */
-    onAttachmentLimitExceeded?: (reason: 'count' | 'size' | 'mime', file: File) => void;
-    /** Callback when attachments change (for external file list rendering) */
+    /** Called when attachment limit is exceeded */
+    onAttachmentLimitExceeded?: (reason: AttachmentLimitReason, file: File) => void;
+    /** Called when attachments change */
     onFilesChange?: (attachments: Attachment[]) => void;
-    /** Show built-in attachment preview bar (default: true, set to false for custom UI) */
+    /** Show attachment preview bar */
     showAttachmentPreview?: boolean;
-    /** Markdown syntax options */
+    /** Markdown options */
     markdownOptions?: {
-        enabledSyntax?: MarkdownSyntaxOptions;
+        enabledSyntax?: string[];
     };
-    /** Image upload function (required for image button in rich mode) */
+    /** Image upload handler with optional progress callback */
     uploadImage?: UploadImageFn;
     /** Keymap configuration */
     keymap?: {
-        send?: SendKey;
+        send?: SendKeymap;
     };
-    /** Placeholder text */
+    /** Placeholder text (string or per-mode object) */
     placeholder?: string | {
         plain?: string;
         rich?: string;
     };
     /** Disable the editor */
     disabled?: boolean;
-    /** Custom class name */
+    /** Additional CSS class */
     className?: string;
-    /** Mouse event handler for context menu (right click) */
-    onContextMenu?: React.MouseEventHandler<HTMLDivElement>;
-    /** Callback when quote is removed (plain mode) */
-    onQuoteRemoved?: () => void;
-    /** Callback when editor content changes */
-    onChange?: () => void;
-    /** Locale/i18n configuration */
+    /** Locale strings */
     locale?: IMComposerLocale;
-};
+}
 /**
  * Methods exposed via ref
  */
-type IMComposerRef = {
+interface IMComposerRef {
     /** Focus the editor */
     focus: () => void;
-    /** Clear editor content and attachments */
+    /** Clear the editor content */
     clear: () => void;
-    /** Export current payload without sending */
+    /** Export current content as payload. Returns null if empty or uploading */
     exportPayload: () => PlainMessagePayload | MarkdownMessagePayload | null;
     /** Import markdown content (rich mode only) */
     importMarkdown: (markdown: string) => void;
-    /** Get current attachments (plain mode) */
+    /** Get current attachments */
     getAttachments: () => Attachment[];
-    /** Set attachments (plain mode) */
+    /** Set attachments */
     setAttachments: (attachments: Attachment[]) => void;
-    /** Insert a quote message (plain mode) */
-    insertQuote: (title: string, content: string) => void;
-    /** Add files to attachments (plain mode) */
+    /** Add files to attachments */
     addFiles: (files: FileList | File[]) => void;
-    /** Remove an attachment by ID (plain mode) */
+    /** Remove a specific attachment by ID */
     removeAttachment: (id: string) => void;
-    /** Clear all attachments (plain mode) */
+    /** Clear all attachments */
     clearAttachments: () => void;
-    /** Insert a mention element (plain mode) */
+    /** Insert or replace a quote */
+    insertQuote: (title: string, content: string) => void;
+    /** Programmatically insert a mention */
     insertMention: (userId: string, display: string) => void;
-    /** Get complete draft state (editor content + attachments + text, for saving) */
-    getDraft: () => {
-        editorState: string;
-        attachments: Attachment[];
-        text: string;
-    };
-    /** Set complete draft state (restore from saved draft) */
-    setDraft: (draft: {
-        editorState: string;
-        attachments?: Attachment[];
-    }) => void;
-    /** Set editor content from plain text and optional mentions (plain mode) */
+    /** Get current draft state */
+    getDraft: () => ComposerDraft;
+    /** Restore from draft state */
+    setDraft: (draft: ComposerDraft) => void;
+    /** Set text content (with optional mentions for plain mode) */
     setText: (text: string, mentions?: Member[]) => void;
-    /** Insert text at cursor position (useful for emoji insertion) */
+    /** Insert text at cursor */
     insertText: (text: string) => void;
-};
+}
+/**
+ * @internal Mention suggestion state
+ */
+interface MentionSuggestionState {
+    active: boolean;
+    query: string;
+    items: Member[];
+    selectedIndex: number;
+    loading: boolean;
+    error: boolean;
+    /** Command to insert a mention (replaces @ trigger) */
+    command: ((member: {
+        userId: string;
+        display: string;
+    }) => void) | null;
+}
 
-declare const IMComposer: react.ForwardRefExoticComponent<IMComposerProps & react.RefAttributes<IMComposerRef>>;
+/**
+ * IM Composer component supporting plain text and rich text modes.
+ */
+declare const IMComposer: React__default.ForwardRefExoticComponent<IMComposerProps & React__default.RefAttributes<IMComposerRef>>;
 
-type SerializedMentionNode = Spread<{
-    userId: string;
-    display: string;
-}, SerializedLexicalNode>;
-declare class MentionNode extends DecoratorNode<ReactNode> {
-    __userId: string;
-    __display: string;
-    static getType(): string;
-    static clone(node: MentionNode): MentionNode;
-    constructor(userId: string, display: string, key?: NodeKey);
-    createDOM(config: EditorConfig): HTMLElement;
-    updateDOM(): boolean;
-    exportDOM(): DOMExportOutput;
-    static importDOM(): DOMConversionMap | null;
-    static importJSON(serializedNode: SerializedMentionNode): MentionNode;
-    exportJSON(): SerializedMentionNode;
-    getUserId(): string;
-    getDisplay(): string;
-    getTextContent(): string;
-    isIsolated(): boolean;
-    isInline(): boolean;
-    canInsertTextBefore(): boolean;
-    canInsertTextAfter(): boolean;
-    decorate(): ReactNode;
+interface RichEditorProps {
+    placeholder?: string;
+    disabled?: boolean;
+    uploadImage?: UploadImageFn;
+    onUploadingChange?: (count: number) => void;
+    onSend?: () => void;
+    onChange?: () => void;
+    sendKeymap?: 'enter' | 'ctrlEnter' | 'cmdEnter';
+}
+interface RichEditorRef {
+    editor: Editor | null;
+    focus: () => void;
+    clear: () => void;
+    exportPayload: () => MarkdownMessagePayload | null;
+    importMarkdown: (markdown: string) => void;
+    getDraft: () => ComposerDraft;
+    setDraft: (draft: ComposerDraft) => void;
+    setText: (text: string) => void;
+    insertText: (text: string) => void;
+    isUploading: () => boolean;
 }
-declare function $createMentionNode(userId: string, display: string): MentionNode;
-declare function $isMentionNode(node: LexicalNode | null | undefined): node is MentionNode;
+declare const RichEditor: React$1.ForwardRefExoticComponent<RichEditorProps & React$1.RefAttributes<RichEditorRef>>;
 
-type SerializedImageNode = Spread<{
-    src: string;
-    alt: string;
-    width?: number;
-    height?: number;
-}, SerializedLexicalNode>;
-declare class ImageNode extends DecoratorNode<ReactNode> {
-    __src: string;
-    __alt: string;
-    __width?: number;
-    __height?: number;
-    static getType(): string;
-    static clone(node: ImageNode): ImageNode;
-    constructor(src: string, alt: string, width?: number, height?: number, key?: NodeKey);
-    createDOM(config: EditorConfig): HTMLElement;
-    updateDOM(): boolean;
-    exportDOM(editor: LexicalEditor): DOMExportOutput;
-    static importDOM(): DOMConversionMap | null;
-    static importJSON(serializedNode: SerializedImageNode): ImageNode;
-    exportJSON(): SerializedImageNode;
-    getSrc(): string;
-    getAlt(): string;
-    getTextContent(): string;
-    isInline(): boolean;
-    decorate(): ReactNode;
+declare function LocaleProvider({ locale, children, }: {
+    locale?: IMComposerLocale;
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare function useLocale(): IMComposerLocale;
+
+interface MentionListProps {
+    /** List of member suggestions */
+    items: Member[];
+    /** Currently selected index */
+    selectedIndex: number;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: boolean;
+    /** Called when item is clicked */
+    onSelect: (member: Member) => void;
+    /** Called when mouse enters an item */
+    onHover: (index: number) => void;
+    /** Custom render function */
+    renderItem?: (props: {
+        member: Member;
+        isSelected: boolean;
+    }) => React__default.ReactNode;
+    /** Locale strings */
+    locale?: {
+        noResults?: string;
+        loading?: string;
+        error?: string;
+    };
 }
-declare function $createImageNode(src: string, alt?: string, width?: number, height?: number): ImageNode;
-declare function $isImageNode(node: LexicalNode | null | undefined): node is ImageNode;
+/**
+ * Mention suggestion list component.
+ */
+declare function MentionList({ items, selectedIndex, loading, error, onSelect, onHover, renderItem, locale, }: MentionListProps): react_jsx_runtime.JSX.Element | null;
 
-type SerializedEmojiNode = Spread<{
-    emoji: string;
-}, SerializedLexicalNode>;
-declare class EmojiNode extends DecoratorNode<ReactNode> {
-    __emoji: string;
-    static getType(): string;
-    static clone(node: EmojiNode): EmojiNode;
-    constructor(emoji: string, key?: NodeKey);
-    createDOM(config: EditorConfig): HTMLElement;
-    updateDOM(): boolean;
-    exportDOM(): DOMExportOutput;
-    static importDOM(): DOMConversionMap | null;
-    static importJSON(serializedNode: SerializedEmojiNode): EmojiNode;
-    exportJSON(): SerializedEmojiNode;
-    getEmoji(): string;
-    getTextContent(): string;
-    isIsolated(): boolean;
-    isInline(): boolean;
-    canInsertTextBefore(): boolean;
-    canInsertTextAfter(): boolean;
-    decorate(): ReactNode;
+interface AttachmentPreviewProps {
+    /** List of attachments */
+    attachments: Attachment[];
+    /** Called when remove button is clicked */
+    onRemove: (id: string) => void;
+    /** Placement position */
+    placement?: 'top' | 'bottom';
+    /** Remove button label */
+    removeLabel?: string;
 }
-declare function $createEmojiNode(emoji: string): EmojiNode;
-declare function $isEmojiNode(node: LexicalNode | null | undefined): node is EmojiNode;
+/**
+ * Attachment preview bar component.
+ */
+declare function AttachmentPreview({ attachments, onRemove, placement, removeLabel, }: AttachmentPreviewProps): react_jsx_runtime.JSX.Element | null;
 
-type SerializedQuoteNode = Spread<{
-    title: string;
-    content: string;
-}, SerializedLexicalNode>;
-declare class QuoteNode extends DecoratorNode<ReactNode> {
-    __title: string;
-    __content: string;
-    static getType(): string;
-    static clone(node: QuoteNode): QuoteNode;
-    constructor(title: string, content: string, key?: NodeKey);
-    createDOM(config: EditorConfig): HTMLElement;
-    updateDOM(): boolean;
-    exportDOM(): DOMExportOutput;
-    static importDOM(): DOMConversionMap | null;
-    static importJSON(serializedNode: SerializedQuoteNode): QuoteNode;
-    exportJSON(): SerializedQuoteNode;
-    getTitle(): string;
-    getContent(): string;
-    getTextContent(): string;
-    isIsolated(): boolean;
-    isInline(): boolean;
-    decorate(): ReactNode;
+interface QuoteBarProps {
+    /** Quote information */
+    quote: QuoteInfo;
+    /** Called when remove button is clicked */
+    onRemove: () => void;
+    /** Remove button label */
+    removeLabel?: string;
 }
-declare function $createQuoteNode(title: string, content: string): QuoteNode;
-declare function $isQuoteNode(node: LexicalNode | null | undefined): node is QuoteNode;
+/**
+ * Quote message bar component.
+ */
+declare function QuoteBar({ quote, onRemove, removeLabel }: QuoteBarProps): react_jsx_runtime.JSX.Element;
 
 interface UseAttachmentsOptions {
+    /** Maximum number of attachments */
     maxAttachments?: number;
+    /** Maximum file size in bytes */
     maxFileSize?: number;
+    /** Allowed MIME types */
     allowedMimeTypes?: string[];
-    onLimitExceeded?: (reason: 'count' | 'size' | 'mime', file: File) => void;
+    /** Called when limit is exceeded */
+    onLimitExceeded?: (reason: AttachmentLimitReason, file: File) => void;
+    /** Called when attachments change */
+    onChange?: (attachments: Attachment[]) => void;
 }
-interface UseAttachmentsResult {
+interface UseAttachmentsReturn {
+    /** Current attachments */
     attachments: Attachment[];
+    /** Add files to attachments */
     addFiles: (files: FileList | File[]) => void;
+    /** Remove attachment by ID */
     removeAttachment: (id: string) => void;
+    /** Clear all attachments */
     clearAttachments: () => void;
+    /** Set attachments directly */
     setAttachments: (attachments: Attachment[]) => void;
+    /** Get current attachments */
+    getAttachments: () => Attachment[];
 }
-declare function useAttachments(options?: UseAttachmentsOptions): UseAttachmentsResult;
+/**
+ * Hook for managing file attachments with proper objectURL lifecycle.
+ */
+declare function useAttachments(options?: UseAttachmentsOptions): UseAttachmentsReturn;
 
-interface UseImageUploadOptions {
-    /** Image upload function */
-    uploadImage?: UploadImageFn;
-    /** Callback when upload starts */
-    onUploadStart?: () => void;
-    /** Callback when upload ends */
-    onUploadEnd?: () => void;
-    /** Callback when error occurs */
-    onError?: (error: Error) => void;
+interface UsePlainEditorOptions {
+    /** Placeholder text */
+    placeholder?: string;
+    /** Keymap for send */
+    sendKeymap?: SendKeymap;
+    /** Called when send is triggered */
+    onSend?: () => void;
+    /** Enable mention */
+    enableMention?: boolean;
+    /** Mention provider */
+    mentionProvider?: (query: string) => Promise<Member[]>;
+    /** Max mentions */
+    maxMentions?: number;
+    /** Called when mention state changes */
+    onMentionStateChange?: (state: MentionSuggestionState) => void;
+    /** Called when files are pasted */
+    onPasteFiles?: (files: File[]) => void;
+    /** Get current uploading state */
+    isUploading?: () => boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Called on content change */
+    onChange?: () => void;
+    /** Called when quote is removed */
+    onQuoteRemoved?: () => void;
 }
-interface UseImageUploadResult {
-    /** Whether any upload is in progress */
-    isUploading: boolean;
-    /** Number of concurrent uploads */
-    uploadCount: number;
-    /** Upload image and get result */
-    upload: (file: File) => Promise<{
-        url: string;
-        alt?: string;
-    } | null>;
-    /** Upload image and insert into editor */
-    uploadAndInsert: (file: File, editor: LexicalEditor) => Promise<boolean>;
+interface UsePlainEditorReturn {
+    /** Tiptap editor instance */
+    editor: ReturnType<typeof useEditor>;
+    /** Check if composing (IME) */
+    isComposing: () => boolean;
+    /** Check if mention list is open */
+    isMentionListOpen: () => boolean;
+    /** Export payload */
+    exportPayload: (attachments: Attachment[]) => PlainMessagePayload | null;
+    /** Get draft */
+    getDraft: (attachments: Attachment[]) => ComposerDraft;
+    /** Set draft */
+    setDraft: (draft: ComposerDraft) => void;
+    /** Insert mention programmatically */
+    insertMention: (userId: string, display: string) => void;
+    /** Insert quote */
+    insertQuote: (title: string, content: string) => void;
+    /** Remove quote */
+    removeQuote: () => void;
+    /** Get current quote */
+    getQuote: () => QuoteInfo | undefined;
+    /** Set text content */
+    setText: (text: string) => void;
+    /** Insert text at cursor */
+    insertText: (text: string) => void;
+    /** Clear editor */
+    clear: () => void;
+    /** Focus editor */
+    focus: () => void;
 }
-declare function useImageUpload(options?: UseImageUploadOptions): UseImageUploadResult;
+/**
+ * Hook for managing plain text editor.
+ */
+declare function usePlainEditor(options?: UsePlainEditorOptions): UsePlainEditorReturn;
+
+/**
+ * Extract plain text and mention information from the editor.
+ * Mention tokens are output as @{userId} followed by a space.
+ *
+ * @param editor Tiptap editor instance
+ * @returns Object containing plainText and mentions array with UTF-16 indices
+ */
+declare function extractPlainTextWithMentions(editor: Editor$1): {
+    plainText: string;
+    mentions: MentionInfo[];
+};
+/**
+ * Check if mention indices are valid and aligned with the plainText.
+ */
+declare function validateMentionIndices(plainText: string, mentions: MentionInfo[]): boolean;
+/**
+ * Create a mention info object with calculated indices.
+ */
+declare function createMentionInfo(userId: string, display: string, startIndex: number): MentionInfo;
+
+/**
+ * Create an Attachment object from a File.
+ */
+declare function createAttachment(file: File): Attachment;
+/**
+ * Revoke object URL for an attachment.
+ */
+declare function revokeAttachmentUrl(attachment: Attachment): void;
+/**
+ * Revoke all object URLs for a list of attachments.
+ */
+declare function revokeAllAttachmentUrls(attachments: Attachment[]): void;
+/**
+ * Validate a file against attachment constraints.
+ * Returns the reason for rejection, or null if valid.
+ */
+declare function validateFile(file: File, currentCount: number, options: {
+    maxAttachments?: number;
+    maxFileSize?: number;
+    allowedMimeTypes?: string[];
+}): AttachmentLimitReason | null;
+/**
+ * Format file size for display.
+ */
+declare function formatFileSize(bytes: number): string;
+
+/**
+ * Markdown serializer for Tiptap editor content.
+ * Converts the editor document to Markdown string.
+ */
+declare function editorToMarkdown(editor: Editor$1): string;
+/**
+ * Parse Markdown to Tiptap-compatible JSON content.
+ * This is a simplified parser for the Markdown subset we support.
+ */
+declare function markdownToEditorContent(markdown: string): any;
+
+/**
+ * Check if a URL has an allowed protocol for links.
+ */
+declare function isAllowedLinkProtocol(url: string): boolean;
+/**
+ * Check if a URL has an allowed protocol for images.
+ */
+declare function isAllowedImageProtocol(url: string): boolean;
+/**
+ * Sanitize a URL for links.
+ * - Adds https:// if no protocol is present
+ * - Returns null if protocol is not allowed (including javascript:, vbscript:, etc.)
+ */
+declare function sanitizeLinkUrl(url: string): string | null;
+/**
+ * Sanitize a URL for images.
+ * Returns null if protocol is not allowed.
+ */
+declare function sanitizeImageUrl(url: string): string | null;
 
-export { $createEmojiNode, $createImageNode, $createMentionNode, $createQuoteNode, $isEmojiNode, $isImageNode, $isMentionNode, $isQuoteNode, type Attachment, type ComposerMode, EmojiNode, IMComposer, type IMComposerLocale, type IMComposerProps, type IMComposerRef, ImageNode, type MarkdownMessagePayload, type MarkdownSyntaxOptions, type Member, type MentionInfo, MentionNode, type MessagePayload, type PlainMessagePayload, type QuoteInfo, QuoteNode, type SendKey, type UploadImageFn, type UploadImageResult, useAttachments, useImageUpload };
+export { type Attachment, type AttachmentLimitReason, AttachmentPreview, type AttachmentPreviewProps, type ComposerDraft, type EditorMode, IMComposer, type IMComposerLocale, type IMComposerProps, type IMComposerRef, LocaleProvider, type MarkdownMessagePayload, type Member, type MentionInfo, MentionList, type MentionListProps, type MessagePayload, type PlainMessagePayload, QuoteBar, type QuoteBarProps, type QuoteInfo, RichEditor, type RichEditorProps, type RichEditorRef, type SendKeymap, type UploadImageFn, type UploadImageResult, type UploadProgressEvent, type UseAttachmentsOptions, type UseAttachmentsReturn, type UsePlainEditorOptions, type UsePlainEditorReturn, createAttachment, createMentionInfo, defaultLocale, editorToMarkdown, extractPlainTextWithMentions, formatFileSize, isAllowedImageProtocol, isAllowedLinkProtocol, markdownToEditorContent, revokeAllAttachmentUrls, revokeAttachmentUrl, sanitizeImageUrl, sanitizeLinkUrl, useAttachments, useLocale, usePlainEditor, validateFile, validateMentionIndices };