@mieweb/ui 0.6.1-dev.149 → 0.6.1-dev.150

package/dist/components/SuperChat/index.d.ts

@@ -0,0 +1,189 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as SuperChatConversation, a as SuperChatRenderPlugin, A as AttachmentKind, b as SuperChatLinkBuilder, C as ComposerAttachment, c as SuperChatRef } from '../../types-BFFgW6qy.js';
+export { G as GenUIBlockPayload, d as GenUIPrefetchPolicy, e as GenUIRegistry, f as GenUIWidgetEntry, g as GenUIWidgetProps, P as Participant, h as ParticipantKind, i as ParticipantStatus, j as StandardSchemaV1, k as SuperChatChannel, l as SuperChatItemType, m as SuperChatMessage, n as SuperChatPluggable, o as SuperChatPluggableList } from '../../types-BFFgW6qy.js';
+import { b as AIRenderTextContent } from '../../types-BzeY_kYO.js';
+export { A as AIMessageContent, a as AIMessageStatus, c as AITextRenderContext, M as MCPResourceLink } from '../../types-BzeY_kYO.js';
+import * as React from 'react';
+
+interface SuperChatProps {
+    /** The conversation to display (host-owned state). */
+    conversation: SuperChatConversation;
+    /** The participant id representing the local user (alignment + compose). */
+    currentParticipantId?: string;
+    /** Opt-in rich render plugins (code/math/genui/…). */
+    renderPlugins?: SuperChatRenderPlugin[];
+    /** Override the entire text renderer (advanced). */
+    renderTextContent?: AIRenderTextContent;
+    /** Treat content as trusted and skip sanitization (host-authored only). */
+    trustedContent?: boolean;
+    /** Disable the composer. */
+    readOnly?: boolean;
+    /**
+     * File categories the composer accepts for paste and the paperclip picker.
+     * Defaults to `['image', 'video', 'audio', 'pdf']`.
+     */
+    acceptedFileTypes?: AttachmentKind[];
+    /**
+     * Thread ordering.
+     * - `'asc'` (default): oldest → newest, anchored to the bottom like a
+     *   classic messenger (auto-scrolls to the newest message).
+     * - `'desc'`: newest → oldest, anchored to the top like a social feed
+     *   (auto-scrolls to the top when a new message arrives).
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Virtualize the message thread (windowed rendering). Only the rows near the
+     * viewport are mounted, so very long threads (hundreds to thousands of
+     * messages) stay responsive. Off by default — enable for long histories.
+     */
+    virtualized?: boolean;
+    /** Build hrefs for `ref` thread items. */
+    linkBuilder?: SuperChatLinkBuilder;
+    /** Additional class name. */
+    className?: string;
+    onMessageSent?: (text: string, meta: {
+        conversation: SuperChatConversation;
+        mentions: string[];
+        attachments: ComposerAttachment[];
+    }) => void;
+    /**
+     * Fired when the local user saves an edit to one of their own messages.
+     * Providing this enables the inline "Edit" affordance on self-authored
+     * messages (the host owns state, so apply the new `text` to the message and
+     * typically stamp `editedAt`).
+     */
+    onMessageEdited?: (messageId: string, text: string, meta: {
+        conversation: SuperChatConversation;
+    }) => void;
+    onConversationClosed?: (conversation: SuperChatConversation) => void;
+    onReferenceClick?: (ref: SuperChatRef) => void;
+    /**
+     * Show a "back" affordance in the header (used by {@link SuperChatInbox} on
+     * small screens to return from the chat panel to the conversation list).
+     */
+    onBack?: () => void;
+}
+/**
+ * Single-conversation chat panel. See the module `MAINTAINERS.md` for the
+ * participant model and render-plugin architecture.
+ */
+declare function SuperChat({ conversation, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, linkBuilder, className, onMessageSent, onMessageEdited, onConversationClosed, onReferenceClick, onBack, }: SuperChatProps): react_jsx_runtime.JSX.Element;
+
+interface SuperChatConversationsProps {
+    /** All conversations (host-owned state). */
+    conversations: SuperChatConversation[];
+    /** Controlled active conversation id. */
+    activeConversationId?: string;
+    /** Uncontrolled initial active conversation id. */
+    defaultActiveConversationId?: string;
+    /** Additional class name. */
+    className?: string;
+    onConversationOpened?: (conversation: SuperChatConversation) => void;
+    onNewConversation?: () => void;
+}
+/**
+ * Conversation list. See the module `MAINTAINERS.md` for the data model.
+ */
+declare function SuperChatConversations({ conversations, activeConversationId, defaultActiveConversationId, className, onConversationOpened, onNewConversation, }: SuperChatConversationsProps): react_jsx_runtime.JSX.Element;
+
+interface SuperChatInboxProps {
+    /** All conversations (host-owned state). */
+    conversations: SuperChatConversation[];
+    /** Controlled active conversation id. */
+    activeConversationId?: string;
+    /** Uncontrolled initial active conversation id. */
+    defaultActiveConversationId?: string;
+    /** The participant id representing the local user (alignment + compose). */
+    currentParticipantId?: string;
+    /** Opt-in rich render plugins (code/math/genui/…). */
+    renderPlugins?: SuperChatRenderPlugin[];
+    /** Override the entire text renderer (advanced). */
+    renderTextContent?: AIRenderTextContent;
+    /** Treat content as trusted and skip sanitization (host-authored only). */
+    trustedContent?: boolean;
+    /** Disable the composer. */
+    readOnly?: boolean;
+    /**
+     * File categories the composer accepts for paste and the paperclip picker.
+     * Defaults to `['image', 'video', 'audio', 'pdf']`.
+     */
+    acceptedFileTypes?: AttachmentKind[];
+    /** Thread ordering: `'asc'` (oldest→newest, default) or `'desc'` (feed-style). */
+    order?: 'asc' | 'desc';
+    /** Virtualize the message thread (windowed rendering) for long histories. */
+    virtualized?: boolean;
+    /** Show the conversation sidebar. */
+    showSidebar?: boolean;
+    /** Build hrefs for `ref` thread items. */
+    linkBuilder?: SuperChatLinkBuilder;
+    /** Additional class name. */
+    className?: string;
+    onMessageSent?: (text: string, meta: {
+        conversation: SuperChatConversation;
+        mentions: string[];
+        attachments: ComposerAttachment[];
+    }) => void;
+    /** Fired when the local user saves an edit to one of their own messages. */
+    onMessageEdited?: (messageId: string, text: string, meta: {
+        conversation: SuperChatConversation;
+    }) => void;
+    onConversationOpened?: (conversation: SuperChatConversation) => void;
+    onConversationClosed?: (conversation: SuperChatConversation) => void;
+    onNewConversation?: () => void;
+    onReferenceClick?: (ref: SuperChatRef) => void;
+}
+/**
+ * Combined inbox surface (conversation list + active conversation panel). See
+ * the module `MAINTAINERS.md` for the participant model and render-plugin
+ * architecture.
+ */
+declare function SuperChatInbox({ conversations, activeConversationId, defaultActiveConversationId, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, showSidebar, linkBuilder, className, onMessageSent, onMessageEdited, onConversationOpened, onConversationClosed, onNewConversation, onReferenceClick, }: SuperChatInboxProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * SuperChat Markdown render composer.
+ *
+ * Composes a list of {@link SuperChatRenderPlugin}s into a single
+ * {@link AIRenderTextContent} implementation that plugs into the AI module's
+ * `renderTextContent` seam. Ships **Markdown core** (GFM) with `rehype-sanitize`
+ * applied to untrusted model/agent output. Math / code / GenUI / NITRO / mermaid
+ * are added by passing the corresponding opt-in plugins.
+ *
+ * The host owns the trust boundary: untrusted content is always sanitized via an
+ * allow-list schema, extended by each plugin's `sanitizeSchema` so token
+ * classNames (syntax highlighting) and KaTeX markup survive.
+ */
+
+interface CreateMarkdownRendererOptions {
+    /** Opt-in rich plugins (code, math, genui, nitro, mermaid, …). */
+    plugins?: SuperChatRenderPlugin[];
+    /**
+     * Disable sanitization. **Only** set this when the content is fully trusted
+     * (e.g. authored by the host, never model output). Defaults to `false`.
+     */
+    trusted?: boolean;
+}
+/**
+ * Build an {@link AIRenderTextContent} from a set of render plugins.
+ *
+ * @example
+ * const render = createMarkdownRenderer({ plugins: [createCodePlugin(), createMathPlugin()] });
+ * <AIChat renderTextContent={render} … />
+ */
+declare function createMarkdownRenderer(options?: CreateMarkdownRendererOptions): AIRenderTextContent;
+
+/**
+ * Render-time context threaded from the message into custom Markdown nodes
+ * (e.g. GenUI widgets need `messageId` + `streaming` for their `meta` and for
+ * gating mount/data-fetch while a message is still streaming).
+ */
+
+interface SuperChatTextContext {
+    /** id of the parent message (stable cache key). */
+    messageId: string;
+    /** true while the parent message is still streaming. */
+    streaming: boolean;
+}
+declare const TextRenderContext: React.Context<SuperChatTextContext>;
+declare const useTextRenderContext: () => SuperChatTextContext;
+
+export { AIRenderTextContent, AttachmentKind, ComposerAttachment, type CreateMarkdownRendererOptions, SuperChat, SuperChatConversation, SuperChatConversations, type SuperChatConversationsProps, SuperChatInbox, type SuperChatInboxProps, SuperChatLinkBuilder, type SuperChatProps, SuperChatRef, SuperChatRenderPlugin, type SuperChatTextContext, TextRenderContext, createMarkdownRenderer, useTextRenderContext };