@mieweb/ui 0.10.0-dev.9 → 0.11.0-dev.0

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

@@ -1,13 +1,94 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { S as SuperChatConversation, a as SuperChatRenderPlugin, A as AttachmentKind, b as SuperChatLinkBuilder, c as SuperChatCopyFormat, C as ComposerAttachment, d as SuperChatRef } from '../../types-B97JNRNQ.cjs';
-export { G as GenUIBlockPayload, e as GenUIPrefetchPolicy, f as GenUIRegistry, g as GenUIWidgetEntry, h as GenUIWidgetProps, P as Participant, i as ParticipantKind, j as ParticipantStatus, k as StandardSchemaV1, l as SuperChatChannel, m as SuperChatItemType, n as SuperChatMessage, o as SuperChatPluggable, p as SuperChatPluggableList } from '../../types-B97JNRNQ.cjs';
-import { b as AIRenderTextContent } from '../../types-CnPEwzlp.cjs';
-export { A as AIMessageContent, a as AIMessageStatus, c as AITextRenderContext, M as MCPResourceLink } from '../../types-CnPEwzlp.cjs';
 import * as React from 'react';
+import { S as SuperChatConversation, a as SuperChatView, b as SuperChatMediaFeedProps, c as SuperChatMediaLabels, d as SuperChatRenderPlugin, A as AIRenderTextContent, e as AttachmentKind, f as SuperChatLinkBuilder, g as SuperChatCopyFormat, C as ComposerAttachment, h as SuperChatRef, i as SuperChatMediaItem } from '../../types-Cx1FHLq2.cjs';
+export { j as AIMessageContent, k as AIMessageStatus, l as AITextRenderContext, G as GenUIBlockPayload, m as GenUIPrefetchPolicy, n as GenUIRegistry, o as GenUIWidgetEntry, p as GenUIWidgetProps, M as MCPResourceLink, P as Participant, q as ParticipantKind, r as ParticipantStatus, s as StandardSchemaV1, t as SuperChatChannel, u as SuperChatItemType, v as SuperChatMediaAttachment, w as SuperChatMessage, x as SuperChatPluggable, y as SuperChatPluggableList } from '../../types-Cx1FHLq2.cjs';
+
+type ProviderModelValue = {
+    provider: string;
+    model: string;
+};
+type ProviderModelOption = ProviderModelValue & {
+    label?: string;
+    providerLabel?: string;
+    id?: string;
+};
+/** A reasoning-effort level offered alongside the model. */
+type ComposerEffortOption = {
+    value: string;
+    label: string;
+    /** Optional secondary line, e.g. a caveat about cost or latency. */
+    description?: string;
+};
+type ComposerModelSelectorBaseProps = {
+    models: ProviderModelOption[];
+    value: ProviderModelValue | null;
+    onChange: (value: ProviderModelValue) => void;
+    disabled?: boolean;
+    /**
+     * Trigger appearance: 'default' is the bordered pill; 'ghost' is a quiet
+     * text trigger that matches ChatComposer's selector-row controls.
+     */
+    variant?: 'default' | 'ghost';
+    className?: string;
+    boundaryRef?: React.RefObject<HTMLElement | null>;
+    placeholder?: string;
+    anyLabel?: string;
+    emptyLabel?: string;
+    ariaLabel?: string;
+    /**
+     * Reasoning-effort levels for the selected model. Omit or pass an empty
+     * array to hide the effort row entirely, which is what a model that cannot
+     * reason should resolve to — the levels are provider-specific, so the caller
+     * owns deciding which apply.
+     */
+    effortOptions?: ComposerEffortOption[];
+    /** Currently selected effort. */
+    effort?: string | null;
+    /** Effort marked with a "default" badge in the list. */
+    defaultEffort?: string;
+    onEffortChange?: (value: string) => void;
+    effortLabel?: string;
+    effortHint?: string;
+    defaultBadgeLabel?: string;
+    backLabel?: string;
+};
+type ControlledProviderFilterProps = {
+    providerFilter: string | null;
+    onProviderFilterChange: (provider: string | null) => void;
+};
+type UncontrolledProviderFilterProps = {
+    providerFilter?: undefined;
+    onProviderFilterChange?: (provider: string | null) => void;
+};
+type ComposerModelSelectorProps = ComposerModelSelectorBaseProps & (ControlledProviderFilterProps | UncontrolledProviderFilterProps);
+
+/** An agent shown in the composer's agent selector. */
+interface ChatComposerAgentOption {
+    /** Stable id (returned via `onAgentChange`). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Optional leading icon (defaults to a bot glyph in the trigger). */
+    icon?: React.ReactNode;
+    /** Optional secondary text shown in the menu. */
+    description?: string;
+}
 
 interface SuperChatProps {
     /** The conversation to display (host-owned state). */
     conversation: SuperChatConversation;
+    /** Controlled conversation view. The host still owns the same messages. */
+    view?: SuperChatView;
+    /** Initial uncontrolled view; defaults to the existing message thread. */
+    defaultView?: SuperChatView;
+    /** Fired when the user requests a thread/media view change. */
+    onViewChange?: (view: SuperChatView, meta: {
+        conversation: SuperChatConversation;
+    }) => void;
+    /** MediaFeed behavior, labels and action/render slots for explicit attachments. */
+    mediaFeedProps?: SuperChatMediaFeedProps;
+    /** Labels for media launches and returning to the conversation. */
+    mediaLabels?: Partial<SuperChatMediaLabels>;
     /** The participant id representing the local user (alignment + compose). */
     currentParticipantId?: string;
     /** Opt-in rich render plugins (code/math/genui/…). */
@@ -48,6 +129,26 @@ interface SuperChatProps {
     defaultCopyFormat?: SuperChatCopyFormat;
     /** Additional class name. */
     className?: string;
+    /** Show the conversation header (title + participants). Defaults to `true`. */
+    showHeader?: boolean;
+    /** Composer placeholder override. */
+    placeholder?: string;
+    /** Allow file attachments in the composer. Defaults to `true` unless read-only. */
+    allowAttachments?: boolean;
+    /** Agents offered by the composer's agent selector (shown when non-empty). */
+    agents?: ChatComposerAgentOption[];
+    /** Selected agent id for the composer's agent selector. */
+    selectedAgent?: string | null;
+    onAgentChange?: (agentId: string) => void;
+    /** Localized accessible label / empty-state text for the agent selector. */
+    agentSelectorLabel?: string;
+    /** Props for the composer's model selector (shown when provided). */
+    modelSelectorProps?: ComposerModelSelectorProps;
+    /** While true, the send button becomes a stop button (requires `onStop`). */
+    isStreaming?: boolean;
+    onStop?: () => void;
+    /** Localized accessible label for the icon-only stop button. */
+    stopLabel?: string;
     /**
      * Fired when the local user sends a message. If the callback returns a
      * promise it is awaited, and a rejected send restores the typed text into
@@ -80,7 +181,7 @@ interface SuperChatProps {
  * 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, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationClosed, onReferenceClick, onBack, }: SuperChatProps): react_jsx_runtime.JSX.Element;
+declare function SuperChat({ conversation, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, linkBuilder, defaultCopyFormat, className, showHeader, placeholder, allowAttachments, agents, selectedAgent, onAgentChange, agentSelectorLabel, modelSelectorProps, isStreaming, onStop, stopLabel, onMessageSent, onMessageEdited, onConversationClosed, onReferenceClick, onBack, }: SuperChatProps): react_jsx_runtime.JSX.Element;
 
 interface SuperChatConversationsProps {
     /** All conversations (host-owned state). */
@@ -102,6 +203,16 @@ declare function SuperChatConversations({ conversations, activeConversationId, d
 interface SuperChatInboxProps {
     /** All conversations (host-owned state). */
     conversations: SuperChatConversation[];
+    /** Controlled thread/media view, forwarded to the active conversation panel. */
+    view?: SuperChatProps['view'];
+    /** Initial uncontrolled panel view; defaults to 'thread'. */
+    defaultView?: SuperChatProps['defaultView'];
+    /** Fired with the active conversation when its view is changed. */
+    onViewChange?: SuperChatProps['onViewChange'];
+    /** MediaFeed behavior and slots; items remain scoped to the active conversation. */
+    mediaFeedProps?: SuperChatProps['mediaFeedProps'];
+    /** Labels for the view switch and attachment previews. */
+    mediaLabels?: SuperChatProps['mediaLabels'];
     /** Controlled active conversation id. */
     activeConversationId?: string;
     /** Uncontrolled initial active conversation id. */
@@ -143,7 +254,7 @@ interface SuperChatInboxProps {
         conversation: SuperChatConversation;
         mentions: string[];
         attachments: ComposerAttachment[];
-    }) => void;
+    }) => void | Promise<void>;
     /** Fired when the local user saves an edit to one of their own messages. */
     onMessageEdited?: (messageId: string, text: string, meta: {
         conversation: SuperChatConversation;
@@ -158,7 +269,14 @@ interface SuperChatInboxProps {
  * 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, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationOpened, onConversationClosed, onNewConversation, onReferenceClick, }: SuperChatInboxProps): react_jsx_runtime.JSX.Element;
+declare function SuperChatInbox({ conversations, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, activeConversationId, defaultActiveConversationId, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, showSidebar, linkBuilder, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationOpened, onConversationClosed, onNewConversation, onReferenceClick, }: SuperChatInboxProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Flatten explicit attachments in chronological message order. No Markdown or
+ * custom metadata is interpreted as media. The source objects are preserved,
+ * so actions can address the same message in either conversation view.
+ */
+declare function getConversationMediaItems(conversation: SuperChatConversation): SuperChatMediaItem[];
 
 /**
  * SuperChat Markdown render composer.
@@ -207,4 +325,4 @@ interface SuperChatTextContext {
 declare const TextRenderContext: React.Context<SuperChatTextContext>;
 declare const useTextRenderContext: () => SuperChatTextContext;
 
-export { AIRenderTextContent, AttachmentKind, ComposerAttachment, type CreateMarkdownRendererOptions, SuperChat, SuperChatConversation, SuperChatConversations, type SuperChatConversationsProps, SuperChatCopyFormat, SuperChatInbox, type SuperChatInboxProps, SuperChatLinkBuilder, type SuperChatProps, SuperChatRef, SuperChatRenderPlugin, type SuperChatTextContext, TextRenderContext, createMarkdownRenderer, useTextRenderContext };
+export { AIRenderTextContent, AttachmentKind, ComposerAttachment, type CreateMarkdownRendererOptions, SuperChat, SuperChatConversation, SuperChatConversations, type SuperChatConversationsProps, SuperChatCopyFormat, SuperChatInbox, type SuperChatInboxProps, SuperChatLinkBuilder, SuperChatMediaFeedProps, SuperChatMediaItem, SuperChatMediaLabels, type SuperChatProps, SuperChatRef, SuperChatRenderPlugin, type SuperChatTextContext, SuperChatView, TextRenderContext, createMarkdownRenderer, getConversationMediaItems, useTextRenderContext };

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

@@ -1,13 +1,94 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { S as SuperChatConversation, a as SuperChatRenderPlugin, A as AttachmentKind, b as SuperChatLinkBuilder, c as SuperChatCopyFormat, C as ComposerAttachment, d as SuperChatRef } from '../../types-gZXrfLj6.js';
-export { G as GenUIBlockPayload, e as GenUIPrefetchPolicy, f as GenUIRegistry, g as GenUIWidgetEntry, h as GenUIWidgetProps, P as Participant, i as ParticipantKind, j as ParticipantStatus, k as StandardSchemaV1, l as SuperChatChannel, m as SuperChatItemType, n as SuperChatMessage, o as SuperChatPluggable, p as SuperChatPluggableList } from '../../types-gZXrfLj6.js';
-import { b as AIRenderTextContent } from '../../types-CnPEwzlp.js';
-export { A as AIMessageContent, a as AIMessageStatus, c as AITextRenderContext, M as MCPResourceLink } from '../../types-CnPEwzlp.js';
 import * as React from 'react';
+import { S as SuperChatConversation, a as SuperChatView, b as SuperChatMediaFeedProps, c as SuperChatMediaLabels, d as SuperChatRenderPlugin, A as AIRenderTextContent, e as AttachmentKind, f as SuperChatLinkBuilder, g as SuperChatCopyFormat, C as ComposerAttachment, h as SuperChatRef, i as SuperChatMediaItem } from '../../types-Cx1FHLq2.js';
+export { j as AIMessageContent, k as AIMessageStatus, l as AITextRenderContext, G as GenUIBlockPayload, m as GenUIPrefetchPolicy, n as GenUIRegistry, o as GenUIWidgetEntry, p as GenUIWidgetProps, M as MCPResourceLink, P as Participant, q as ParticipantKind, r as ParticipantStatus, s as StandardSchemaV1, t as SuperChatChannel, u as SuperChatItemType, v as SuperChatMediaAttachment, w as SuperChatMessage, x as SuperChatPluggable, y as SuperChatPluggableList } from '../../types-Cx1FHLq2.js';
+
+type ProviderModelValue = {
+    provider: string;
+    model: string;
+};
+type ProviderModelOption = ProviderModelValue & {
+    label?: string;
+    providerLabel?: string;
+    id?: string;
+};
+/** A reasoning-effort level offered alongside the model. */
+type ComposerEffortOption = {
+    value: string;
+    label: string;
+    /** Optional secondary line, e.g. a caveat about cost or latency. */
+    description?: string;
+};
+type ComposerModelSelectorBaseProps = {
+    models: ProviderModelOption[];
+    value: ProviderModelValue | null;
+    onChange: (value: ProviderModelValue) => void;
+    disabled?: boolean;
+    /**
+     * Trigger appearance: 'default' is the bordered pill; 'ghost' is a quiet
+     * text trigger that matches ChatComposer's selector-row controls.
+     */
+    variant?: 'default' | 'ghost';
+    className?: string;
+    boundaryRef?: React.RefObject<HTMLElement | null>;
+    placeholder?: string;
+    anyLabel?: string;
+    emptyLabel?: string;
+    ariaLabel?: string;
+    /**
+     * Reasoning-effort levels for the selected model. Omit or pass an empty
+     * array to hide the effort row entirely, which is what a model that cannot
+     * reason should resolve to — the levels are provider-specific, so the caller
+     * owns deciding which apply.
+     */
+    effortOptions?: ComposerEffortOption[];
+    /** Currently selected effort. */
+    effort?: string | null;
+    /** Effort marked with a "default" badge in the list. */
+    defaultEffort?: string;
+    onEffortChange?: (value: string) => void;
+    effortLabel?: string;
+    effortHint?: string;
+    defaultBadgeLabel?: string;
+    backLabel?: string;
+};
+type ControlledProviderFilterProps = {
+    providerFilter: string | null;
+    onProviderFilterChange: (provider: string | null) => void;
+};
+type UncontrolledProviderFilterProps = {
+    providerFilter?: undefined;
+    onProviderFilterChange?: (provider: string | null) => void;
+};
+type ComposerModelSelectorProps = ComposerModelSelectorBaseProps & (ControlledProviderFilterProps | UncontrolledProviderFilterProps);
+
+/** An agent shown in the composer's agent selector. */
+interface ChatComposerAgentOption {
+    /** Stable id (returned via `onAgentChange`). */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Optional leading icon (defaults to a bot glyph in the trigger). */
+    icon?: React.ReactNode;
+    /** Optional secondary text shown in the menu. */
+    description?: string;
+}
 
 interface SuperChatProps {
     /** The conversation to display (host-owned state). */
     conversation: SuperChatConversation;
+    /** Controlled conversation view. The host still owns the same messages. */
+    view?: SuperChatView;
+    /** Initial uncontrolled view; defaults to the existing message thread. */
+    defaultView?: SuperChatView;
+    /** Fired when the user requests a thread/media view change. */
+    onViewChange?: (view: SuperChatView, meta: {
+        conversation: SuperChatConversation;
+    }) => void;
+    /** MediaFeed behavior, labels and action/render slots for explicit attachments. */
+    mediaFeedProps?: SuperChatMediaFeedProps;
+    /** Labels for media launches and returning to the conversation. */
+    mediaLabels?: Partial<SuperChatMediaLabels>;
     /** The participant id representing the local user (alignment + compose). */
     currentParticipantId?: string;
     /** Opt-in rich render plugins (code/math/genui/…). */
@@ -48,6 +129,26 @@ interface SuperChatProps {
     defaultCopyFormat?: SuperChatCopyFormat;
     /** Additional class name. */
     className?: string;
+    /** Show the conversation header (title + participants). Defaults to `true`. */
+    showHeader?: boolean;
+    /** Composer placeholder override. */
+    placeholder?: string;
+    /** Allow file attachments in the composer. Defaults to `true` unless read-only. */
+    allowAttachments?: boolean;
+    /** Agents offered by the composer's agent selector (shown when non-empty). */
+    agents?: ChatComposerAgentOption[];
+    /** Selected agent id for the composer's agent selector. */
+    selectedAgent?: string | null;
+    onAgentChange?: (agentId: string) => void;
+    /** Localized accessible label / empty-state text for the agent selector. */
+    agentSelectorLabel?: string;
+    /** Props for the composer's model selector (shown when provided). */
+    modelSelectorProps?: ComposerModelSelectorProps;
+    /** While true, the send button becomes a stop button (requires `onStop`). */
+    isStreaming?: boolean;
+    onStop?: () => void;
+    /** Localized accessible label for the icon-only stop button. */
+    stopLabel?: string;
     /**
      * Fired when the local user sends a message. If the callback returns a
      * promise it is awaited, and a rejected send restores the typed text into
@@ -80,7 +181,7 @@ interface SuperChatProps {
  * 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, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationClosed, onReferenceClick, onBack, }: SuperChatProps): react_jsx_runtime.JSX.Element;
+declare function SuperChat({ conversation, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, linkBuilder, defaultCopyFormat, className, showHeader, placeholder, allowAttachments, agents, selectedAgent, onAgentChange, agentSelectorLabel, modelSelectorProps, isStreaming, onStop, stopLabel, onMessageSent, onMessageEdited, onConversationClosed, onReferenceClick, onBack, }: SuperChatProps): react_jsx_runtime.JSX.Element;
 
 interface SuperChatConversationsProps {
     /** All conversations (host-owned state). */
@@ -102,6 +203,16 @@ declare function SuperChatConversations({ conversations, activeConversationId, d
 interface SuperChatInboxProps {
     /** All conversations (host-owned state). */
     conversations: SuperChatConversation[];
+    /** Controlled thread/media view, forwarded to the active conversation panel. */
+    view?: SuperChatProps['view'];
+    /** Initial uncontrolled panel view; defaults to 'thread'. */
+    defaultView?: SuperChatProps['defaultView'];
+    /** Fired with the active conversation when its view is changed. */
+    onViewChange?: SuperChatProps['onViewChange'];
+    /** MediaFeed behavior and slots; items remain scoped to the active conversation. */
+    mediaFeedProps?: SuperChatProps['mediaFeedProps'];
+    /** Labels for the view switch and attachment previews. */
+    mediaLabels?: SuperChatProps['mediaLabels'];
     /** Controlled active conversation id. */
     activeConversationId?: string;
     /** Uncontrolled initial active conversation id. */
@@ -143,7 +254,7 @@ interface SuperChatInboxProps {
         conversation: SuperChatConversation;
         mentions: string[];
         attachments: ComposerAttachment[];
-    }) => void;
+    }) => void | Promise<void>;
     /** Fired when the local user saves an edit to one of their own messages. */
     onMessageEdited?: (messageId: string, text: string, meta: {
         conversation: SuperChatConversation;
@@ -158,7 +269,14 @@ interface SuperChatInboxProps {
  * 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, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationOpened, onConversationClosed, onNewConversation, onReferenceClick, }: SuperChatInboxProps): react_jsx_runtime.JSX.Element;
+declare function SuperChatInbox({ conversations, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, activeConversationId, defaultActiveConversationId, currentParticipantId, renderPlugins, renderTextContent, trustedContent, readOnly, acceptedFileTypes, order, virtualized, showSidebar, linkBuilder, defaultCopyFormat, className, onMessageSent, onMessageEdited, onConversationOpened, onConversationClosed, onNewConversation, onReferenceClick, }: SuperChatInboxProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Flatten explicit attachments in chronological message order. No Markdown or
+ * custom metadata is interpreted as media. The source objects are preserved,
+ * so actions can address the same message in either conversation view.
+ */
+declare function getConversationMediaItems(conversation: SuperChatConversation): SuperChatMediaItem[];
 
 /**
  * SuperChat Markdown render composer.
@@ -207,4 +325,4 @@ interface SuperChatTextContext {
 declare const TextRenderContext: React.Context<SuperChatTextContext>;
 declare const useTextRenderContext: () => SuperChatTextContext;
 
-export { AIRenderTextContent, AttachmentKind, ComposerAttachment, type CreateMarkdownRendererOptions, SuperChat, SuperChatConversation, SuperChatConversations, type SuperChatConversationsProps, SuperChatCopyFormat, SuperChatInbox, type SuperChatInboxProps, SuperChatLinkBuilder, type SuperChatProps, SuperChatRef, SuperChatRenderPlugin, type SuperChatTextContext, TextRenderContext, createMarkdownRenderer, useTextRenderContext };
+export { AIRenderTextContent, AttachmentKind, ComposerAttachment, type CreateMarkdownRendererOptions, SuperChat, SuperChatConversation, SuperChatConversations, type SuperChatConversationsProps, SuperChatCopyFormat, SuperChatInbox, type SuperChatInboxProps, SuperChatLinkBuilder, SuperChatMediaFeedProps, SuperChatMediaItem, SuperChatMediaLabels, type SuperChatProps, SuperChatRef, SuperChatRenderPlugin, type SuperChatTextContext, SuperChatView, TextRenderContext, createMarkdownRenderer, getConversationMediaItems, useTextRenderContext };