Input

Composer area: rich-text input (Tiptap), send / stop / file-attach actions, and @mention / /command suggestion popups.

Imports

import {
  ChatInput,
  RichTextInput,
  MentionList,
  type ChatInputRef,
  type RichTextInputRef,
  type SuggestionConfig,
  type SuggestionItem,
  type MentionItem,
  type SlashCommandItem
} from 'reachat';

ChatInput

Main composer used inside <Chat>. Wraps RichTextInput and adds: file attachment (FileInput), send button, stop button (during streaming). Reads isLoading, disabled, sendMessage, stopMessage, fileUpload, activeSessionId from ChatContext.

The send/stop buttons swap based on isLoading. Attach button only renders when allowedFiles?.length > 0.

const inputRef = useRef<ChatInputRef>(null);

<ChatInput
  ref={inputRef}
  placeholder="Ask anything..."
  allowedFiles={['image/*', '.pdf']}
  allowMultipleFiles
  mentions={{
    items: [
      { id: '1', label: 'John Doe', description: 'Engineer', icon: <Avatar /> }
    ]
  }}
  commands={{
    items: [
      { id: 'help', label: 'Help', shortcut: 'Ctrl+H' },
      { id: 'search', label: 'Search', type: 'insert', value: 'search:' }
    ]
  }}
  onMessageChange={handleDraftChange}
/>

ChatInputRef

interface ChatInputRef {
  focus: () => void;
  getValue: () => string;
  setValue: (value: string) => void;
  insertText: (text: string) => void;
}

RichTextInput

Standalone Tiptap-based editor used internally by ChatInput. Useful when building a custom composer.

RichTextInputRef exposes the same methods as ChatInputRef.

Built on Tiptap v3 with Document, Paragraph, Text, HardBreak, Placeholder, and Mention extensions; suggestion popups positioned via Floating UI's flip/shift middleware.

SuggestionConfig

interface SuggestionItem {
  id: string;
  label: string;
  description?: string;
  icon?: ReactElement;
  metadata?: Record<string, unknown>;
}

interface MentionItem extends SuggestionItem {
  /** Custom value to insert; defaults to label. */
  value?: string;
}

interface SlashCommandItem extends SuggestionItem {
  shortcut?: string;
  type?: 'insert' | 'action';
  value?: string;
}

interface SuggestionConfig<T extends SuggestionItem = SuggestionItem> {
  /** Trigger character (default: '@' for mentions, '/' for commands) */
  trigger?: string;
  /** Static items */
  items?: T[];
  /** Async search — return filtered items for the current query */
  onSearch?: (query: string) => Promise<T[]> | T[];
  /** Custom selection handler — receives the chosen item and an insertText callback */
  onSelect?: (item: T, insertText: (text: string) => void) => void;
  /** Cap on visible items (default: 10) */
  maxResults?: number;
  /** Custom row renderer */
  renderItem?: (item: T, isHighlighted: boolean) => ReactNode;
  /** Custom empty-state renderer */
  renderEmpty?: (query: string) => ReactNode;
}

Static items

mentions={{
  items: [
    { id: '1', label: 'Alice', description: 'PM' },
    { id: '2', label: 'Bob', description: 'Eng' }
  ]
}}

Async search

commands={{
  onSearch: async query => {
    const results = await api.searchCommands(query);
    return results.map(r => ({ id: r.id, label: r.name, shortcut: r.hotkey }));
  },
  maxResults: 8
}}

Custom render & insert

mentions={{
  items: people,
  renderItem: (item, isHighlighted) => (
    <div className={isHighlighted ? 'bg-blue-100' : ''}>
      <strong>@{item.label}</strong>
      <small>{item.description}</small>
    </div>
  ),
  onSelect: (item, insertText) => insertText(`@[${item.label}](user:${item.id})`)
}}

MentionList

The popup component the editor renders for suggestions. Exposed for advanced users — most code only needs SuggestionConfig.

interface MentionListRef {
  onKeyDown: (props: { event: KeyboardEvent }) => boolean;
}

interface MentionListProps {
  items: SuggestionItem[];
  command: (item: { id: string; label: string }) => void;
  triggerChar: string;
  config: SuggestionConfig;
  query?: string;
}

Keyboard: ↑/↓ moves selection, Enter/Tab inserts, Escape dismisses.

Theme keys

theme.input.{base, upload, input}
theme.input.actions.{base, send, stop}
theme.input.popup.{base, content, item, itemHighlighted, itemIcon, itemContent, itemLabel, itemDescription, itemShortcut, empty, loading}
theme.input.tag.{base, mention, command}    // Inline pill styling for inserted mentions/commands
theme.input.editor.{base, container, placeholder}

Deprecated aliases

The following type aliases exist for backwards compatibility and will be removed in a future major:

• MentionPluginConfig → use SuggestionConfig<MentionItem>
• SlashCommandPluginConfig → use SuggestionConfig<SlashCommandItem>
• InputPluginItem → use SuggestionItem
• InputTrigger<T> → use SuggestionConfig<T>