@mieweb/ui 0.10.0-dev.30 → 0.10.0-dev.31

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

@@ -1,7 +1,78 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+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';
-import * as React from 'react';
+
+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). */
@@ -58,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
@@ -90,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, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, 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). */

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

@@ -1,7 +1,78 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+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';
-import * as React from 'react';
+
+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). */
@@ -58,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
@@ -90,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, view, defaultView, onViewChange, mediaFeedProps, mediaLabels, 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). */

package/dist/components/SuperChat/index.js

@@ -1254,6 +1254,17 @@ function SuperChat({
   linkBuilder,
   defaultCopyFormat,
   className,
+  showHeader = true,
+  placeholder,
+  allowAttachments,
+  agents,
+  selectedAgent,
+  onAgentChange,
+  agentSelectorLabel,
+  modelSelectorProps,
+  isStreaming,
+  onStop,
+  stopLabel,
   onMessageSent,
   onMessageEdited,
   onConversationClosed,
@@ -1662,7 +1673,7 @@ function SuperChat({
         className
       ),
       children: [
-        /* @__PURE__ */ jsxs(
+        showHeader ? /* @__PURE__ */ jsxs(
           "header",
           {
             "data-slot": "superchat-header",
@@ -1726,6 +1737,9 @@ function SuperChat({
               )
             ]
           }
+        ) : (
+          // Keeps the panel's aria-labelledby reference valid without a visible header.
+          /* @__PURE__ */ jsx("h2", { id: headingId, className: "sr-only", children: conversation.title })
         ),
         activeView === "media" ? /* @__PURE__ */ jsxs(
           "div",
@@ -1860,13 +1874,23 @@ function SuperChat({
             onSend: handleComposerSend,
             disabled: readOnly,
             className: "px-4 pb-4",
-            placeholder: readOnly ? "Read-only conversation" : "Type a message\u2026 use @ to address an agent",
+            placeholder: readOnly ? "Read-only conversation" : placeholder ?? "Type a message\u2026 use @ to address an agent",
             mentionOptions,
-            allowAttachments: !readOnly,
+            allowAttachments: !readOnly && (allowAttachments ?? true),
             acceptedFileTypes: composerAccept,
             maxFileSize: 25 * 1024 * 1024,
             maxLength: 1e5,
-            inputLabel: "Message"
+            inputLabel: "Message",
+            showAgentSelector: !!agents?.length,
+            agents,
+            selectedAgent,
+            onAgentChange,
+            agentSelectorLabel,
+            showModelSelector: !!modelSelectorProps,
+            modelSelectorProps,
+            isStreaming,
+            onStop,
+            stopLabel
           }
         )
       ]