@trinityui/design-system 2.11.1 → 2.13.0

package/dist/components/AI/InsightEngine.d.ts

@@ -7,40 +7,87 @@
  * It composes:
  * - ChatHeader
  * - ChatHistoryList (collapsible)
+ * - AIChatWelcome (the start screen before the first message, with the composer centred in it)
  * - ChatThread (messages area)
  * - AIRelatedQuestions
  * - AISuggestedAction / AIActionsGroup
  * - InsightEngineInput
  *
  * State owned by InsightEngine:
- * - viewMode ('sidepanel' | 'expanded')
- * - isOpen
- * - activeChatId
+ * - viewMode ('sidepanel' | 'expanded'), unless controlled through `viewMode`
  * - historyExpanded (for sidepanel mode)
  *
+ * Presentation (H-15): `presentation="drawer"` (default) is a right-anchored drawer, persistent on
+ * desktop and a full-width modal drawer below `sm`; `presentation="embedded"` fills its parent, for
+ * a host panel such as AppLayout's `renderAiPanel`.
+ *
  * @example
  * ```tsx
- *  import { MOCK_MESSAGES } from '@trinityui/design-system';
+ * import { useState } from 'react';
+ * import { InsightEngine, type ChatThreadMessage } from '@trinityui/design-system';
  *
- *  <MOCK_MESSAGES
- *    isOpen={false}
- *    onClose={() => {}}
- *  />
- *  ```
+ * export function Assistant() {
+ *   const [isOpen, setIsOpen] = useState(true);
+ *   const [messages, setMessages] = useState<ChatThreadMessage[]>([]);
+ *   return (
+ *     <InsightEngine
+ *       isOpen={isOpen}
+ *       onClose={() => setIsOpen(false)}
+ *       messages={messages}
+ *       onSendMessage={(value) => setMessages((prev) => [...prev, { id: String(prev.length + 1), role: 'user', content: value }])}
+ *     />
+ *   );
+ * }
+ * ```
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type TrinityRootProps, type TrinitySlotProps } from '../shared/rootProps';
 import { type ChatViewMode } from './ChatHeader';
 import { type ChatHistoryItem } from './ChatHistoryList';
-import { type ChatMessage } from './ChatThread';
+import { type ChatThreadMessage, type ChatThreadMessageActions, type ChatThreadOwnProps } from './ChatThread';
+import { type HeadingLevel } from '../shared/headingLevel';
 import { type AISourceCategory, type AISourceItem } from './AISourcesPanel';
+import { type AIRelatedQuestion } from './AIRelatedQuestions';
 import { type ModelOption, type SourceOption } from './InsightEngineInput';
+import { type AIChatWelcomeOptions } from './AIChatWelcome';
 /** Re-export source types from AISourcesPanel for convenience */
 export type { AISourceCategory, AISourceItem };
-/** Re-export ChatMessage from ChatThread */
-export type { ChatMessage } from './ChatThread';
+/** Re-export ChatThreadMessage from ChatThread */
+export type { ChatThreadMessage } from './ChatThread';
 /**
- * Props for InsightEngine component.
+ * Trinity-owned slots of InsightEngine (ADR-04 (6)). Each takes `className`, `sx`, `id`,
+ * `data-*` and the slot element's HTML attributes; owned attributes (`role`, `aria-live`, ...)
+ * are ignored.
+ *
+ * @since 2.13.0
+ */
+export interface InsightEngineSlotProps {
+    /**
+     * The root: the Drawer's root in the `drawer` presentation, the embedded `div` in the
+     * `embedded` presentation. Applied after the root's own styles and before the root `sx` and
+     * `className`.
+     * @since 2.13.0
+     */
+    root?: TrinitySlotProps<HTMLDivElement>;
+    /**
+     * The drawer's paper (a `div`; `drawer` presentation only). Its own width and width transition
+     * apply first, then these props. A root `sx` rule on `& .MuiDrawer-paper` still wins over the
+     * paper's own styles.
+     */
+    paper?: TrinitySlotProps<HTMLDivElement>;
+    /**
+     * The body: the `div` below the header that holds the history, the thread and the composer.
+     * @since 2.13.0
+     */
+    body?: TrinitySlotProps<HTMLDivElement>;
+    /** The message thread's root (ChatThread's log `div`). */
+    thread?: TrinitySlotProps<HTMLDivElement>;
+    /** The composer's container (the `div` around the input, at the bottom of the panel). */
+    composer?: TrinitySlotProps<HTMLDivElement>;
+}
+/**
+ * InsightEngine's own props, without the root element's HTML attributes.
  *
  * **State ownership model:**
  *
@@ -50,33 +97,90 @@ export type { ChatMessage } from './ChatThread';
  * must manage that state and pass it in. The component calls back via the
  * various `on*` props whenever the user interacts.
  *
- * Internally-owned state (do NOT pass these as props; they're UI affordances):
- * - `viewMode`: which panel layout is shown (`sidepanel` | `expanded`). Seeded
- *   by `defaultViewMode` on mount.
- * - `historyExpanded`: whether the history sidebar is expanded in sidepanel mode.
+ * UI state:
+ * - `viewMode`: which panel layout is shown (`sidepanel` | `expanded`). Controlled with
+ *   `viewMode` / `onViewModeChange`, or kept internally and seeded by `defaultViewMode`.
+ * - `historyExpanded`: whether the history sidebar is expanded in sidepanel mode (internal).
  *
  * Parent-owned (pass via props and update via callbacks):
  * - `isOpen` / `onClose`
  * - `messages` (thread content)
- * - `inputValue` / `onInputChange` / `onSendMessage`
+ * - `inputValue` / `onInputChange` / `onSendMessage` (the composer's text may also stay
+ *   uncontrolled: omit `inputValue` and read sends from `onSendMessage`)
  * - `chats` / `activeChatId` / `onSelectChat` and friends
  * - `selectedModel` / `onModelChange`
  * - `sources` / `onSourceToggle`
  */
-export interface InsightEngineProps {
-    /** Whether the panel is open */
+export interface InsightEngineOwnProps {
+    /** Whether the panel is open. A closed `embedded` panel stays mounted and hidden. */
     isOpen: boolean;
-    /** Close callback */
-    onClose: () => void;
-    /** Initial view mode */
+    /**
+     * Called when the panel asks to close, with the reason: the header's Close button
+     * (`'closeButton'`), or Escape and the backdrop of the modal drawer on phones
+     * (`'escapeKeyDown'`, `'backdropClick'`). A handler that takes no argument still fits.
+     *
+     * Required for the `drawer` presentation (a development warning says so when it is missing).
+     * Optional for `embedded` (since 2.13.0): without it the header shows no Close button, for a
+     * host that is always open or closes itself.
+     */
+    onClose?: (reason?: 'closeButton' | 'escapeKeyDown' | 'backdropClick') => void;
+    /**
+     * Where the panel renders (H-15).
+     * - `'drawer'`: a right-anchored drawer. At and above the `sm` breakpoint it is persistent
+     *   (non-modal) at `sidepanelWidth` / `expandedWidth`, never wider than the viewport; below `sm`
+     *   it is a full-width modal drawer (see `mobileVariant`).
+     * - `'embedded'`: no drawer. The header, body and composer fill the parent (width and height
+     *   100%), so the panel fits any host: AppLayout's AI panel through `renderAiPanel`, a 320px
+     *   column, a dialog. The width props do not apply; the host sets the width.
+     * @default 'drawer'
+     * @since 2.13.0
+     */
+    presentation?: 'drawer' | 'embedded';
+    /**
+     * The drawer below the `sm` breakpoint (`drawer` presentation): `'temporary'` is a full-width
+     * modal drawer (focus trap, Escape and backdrop close through `onClose`, focus returns to the
+     * opener); `'persistent'` keeps the non-modal drawer at full width. The expand toggle is hidden
+     * on phones either way.
+     * @default 'temporary'
+     * @since 2.13.0
+     */
+    mobileVariant?: 'temporary' | 'persistent';
+    /** Initial view mode, when `viewMode` is not passed (uncontrolled). */
     defaultViewMode?: ChatViewMode;
-    /** Panel title */
+    /**
+     * The view mode, controlled: `'sidepanel'` (collapsible history above the thread) or
+     * `'expanded'` (history column beside the thread, and the `expandedWidth` drawer). Pass it with
+     * `onViewModeChange`; without it the panel keeps its own, seeded by `defaultViewMode`.
+     * @since 2.13.0
+     */
+    viewMode?: ChatViewMode;
+    /**
+     * Called with the next view mode when the header's expand toggle is pressed, controlled or not.
+     * @since 2.13.0
+     */
+    onViewModeChange?: (mode: ChatViewMode) => void;
+    /**
+     * The panel's title (its h2, which names the panel). Default: the `ai.insightEngine.title`
+     * string ('Insight Engine'), from the nearest AIConfigProvider.
+     */
     title?: string;
     /**
-     * Fires when a network or business-logic error happens inside the panel
-     * (e.g. failed chat load, failed message send). The component does NOT own
-     * error UI — the consumer decides how to present the error. A default
-     * inline banner is a sensible UX, but you can toast, modal, or ignore.
+     * Controls of the host in the header, before the expand toggle and Close (ChatHeader
+     * `actions`): for example 'New chat', or AppLayout's fullscreen toggle when the panel is
+     * embedded through `renderAiPanel`. Give each control an accessible name and a matching
+     * tooltip.
+     * @since 2.13.0
+     */
+    headerActions?: React.ReactNode;
+    /**
+     * The panel's async error sink (G-15, H-16): called with an `Error` when an action inside the
+     * panel fails: a send (`onSendMessage` threw or rejected), a message action (Regenerate, Copy's
+     * clipboard write, an app action) or a block event (`onBlockEvent` rejected or threw). A
+     * rejection that is not an `Error` arrives wrapped, with the original value as its `cause`. The
+     * failure still shows inline where it happened (ADR-36): a failed send shows an alert above the
+     * composer with 'Try again', an action or a block shows its own error. Without `onError` a
+     * failed send or message action goes to `globalThis.reportError`, and a block shows its error
+     * inline.
      */
     onError?: (error: Error) => void;
     /** List of past chats */
@@ -92,13 +196,101 @@ export interface InsightEngineProps {
     onPinChat?: (id: string) => void;
     onAddChatToProject?: (id: string) => void;
     /** Messages in current thread */
-    messages?: ChatMessage[];
-    /** Input value */
+    messages?: ChatThreadMessage[];
+    /**
+     * What the thread shows while `messages` is empty, forwarded to ChatThread, with the composer
+     * at the bottom. It wins over the start screen (`welcome`).
+     * @since 2.13.0
+     */
+    emptyState?: React.ReactNode;
+    /**
+     * The start screen while `messages` is empty and no `emptyState` is passed: AIChatWelcome with
+     * the composer centred in it, which moves to the bottom after the first message (no motion
+     * under reduced motion). Pass its options (`variant`, `userName`, `greeting`, `subtitle`,
+     * `suggestions`, `suggestionBehavior`, `onSuggestionSelect`, `updates`, `scope`,
+     * `recentThreads`, `onRecentThreadClick`, `disclaimer`, `guidelinesHref`, …); a suggestion
+     * sends through `onSendMessage` by default. `false` shows ChatThread's 'Start a conversation'
+     * state (`ai.chatThread.empty`) above the bottom composer, as before.
+     * @default {} (the showcase variant with the default greeting)
+     * @since 2.13.0
+     */
+    welcome?: AIChatWelcomeOptions | false;
+    /**
+     * Called with the message and what the user did in an interactive block of its response
+     * (answered a clarification, confirmed a plan), forwarded to ChatThread. Return the promise of
+     * your request: it drives the block's pending state, and a rejection shows the block's error and
+     * reaches `onError`. While the latest response asks a required clarification, the composer is
+     * blocked with a visible reason ('Answer the question above to continue',
+     * `ai.blocks.answerToContinue`) until the answer is submitted, whether or not you write the
+     * answer back into `messages`. Without `onBlockEvent` the blocks are read-only and the composer
+     * is never blocked by them.
+     * @since 2.13.0
+     */
+    onBlockEvent?: ChatThreadOwnProps['onBlockEvent'];
+    /**
+     * Block renderers by block type, forwarded to ChatThread (which renders the interactive blocks
+     * by default; an entry wins, `null` turns a default off). Keep the object stable.
+     * @since 2.13.0
+     */
+    blockRenderers?: ChatThreadOwnProps['blockRenderers'];
+    /**
+     * Renders any block first, forwarded to ChatThread: return a node, `null` to skip the block, or
+     * `undefined` to fall through.
+     * @since 2.13.0
+     */
+    renderBlock?: ChatThreadOwnProps['renderBlock'];
+    /**
+     * Overrides the slots of an assistant message (badges, feedback control, attachments), forwarded
+     * to ChatThread. Also the way to add AIChainOfThought reasoning to a message.
+     * @since 2.13.0
+     */
+    getMessageSlots?: ChatThreadOwnProps['getMessageSlots'];
+    /**
+     * The level of the visually hidden heading before each message, forwarded to ChatThread. The
+     * panel's title is an h2, so `3` fits.
+     * @since 2.13.0
+     */
+    headingLevel?: HeadingLevel;
+    /**
+     * Overrides the composer's blocked state. A string blocks sending and shows it as the reason;
+     * `null` never blocks (not even for a required clarification); `undefined` (the default) blocks
+     * only while a required clarification waits for an answer.
+     * @since 2.13.0
+     */
+    composerBlockedReason?: string | null;
+    /**
+     * The actions of each assistant message, forwarded to ChatThread unchanged (G-05). Each action
+     * shows only when its handler is passed; Copy always shows. `getGoldenDataset` adds the built-in
+     * 'Add to golden dataset' action for the users your app permits (GA-01).
+     * @since 2.13.0
+     */
+    messageActions?: ChatThreadMessageActions;
+    /**
+     * The composer's text, controlled. Without it the composer keeps its own text (uncontrolled)
+     * and clears it after a send.
+     */
     inputValue?: string;
-    /** Input change callback */
+    /** Called with the composer's text on every change, controlled or not. */
     onInputChange?: (value: string) => void;
-    /** Send message callback */
-    onSendMessage?: (value: string) => void;
+    /**
+     * Called with the trimmed text when the user sends a message, controlled or not. Return the
+     * promise of your request (H-16): while it is pending, Send stays in place `aria-disabled` and
+     * `aria-busy` with a spinner (never disabled, so focus stays), and Enter does not send again. If
+     * it rejects (or the handler throws), an alert above the composer says the message wasn't sent,
+     * with 'Try again' that sends the same text again, and the error reaches `onError`. The composer
+     * text is not restored: a controlled `inputValue` stays as you set it.
+     *
+     * Typed as a union of the sync and the async form, so a handler written before H-16 that returns
+     * something else (`(value) => list.push(value)`) still compiles.
+     */
+    onSendMessage?: ((value: string) => void) | ((value: string) => Promise<void>);
+    /**
+     * The composer's placeholder, which is also its accessible name while a reason blocks it.
+     * Default: the `ai.insightEngine.placeholder` string ('Ask anything…'), from the nearest
+     * AIConfigProvider.
+     * @since 2.13.0
+     */
+    placeholder?: string;
     /** Model options */
     models?: ModelOption[];
     /** Selected model ID */
@@ -109,10 +301,19 @@ export interface InsightEngineProps {
     sources?: SourceOption[];
     /** Source toggle callback */
     onSourceToggle?: (id: string, enabled: boolean) => void;
-    /** Related questions to display */
-    relatedQuestions?: string[];
-    /** Related question click callback */
+    /**
+     * Related questions after the last message, shown when no message shows its own. Strings, or
+     * {@link AIRelatedQuestion} objects for an id and the verified flag (since 2.13.0).
+     */
+    relatedQuestions?: Array<string | AIRelatedQuestion>;
+    /** Called with the text of a picked related question (a message's or the thread's). */
     onRelatedQuestionClick?: (question: string) => void;
+    /**
+     * Called with a picked related question (a string is passed as `{ text }`) and its index in its
+     * list, after `onRelatedQuestionClick`; forwarded to ChatThread.
+     * @since 2.13.0
+     */
+    onRelatedQuestionSelect?: (question: AIRelatedQuestion, index: number) => void;
     /** Suggested actions */
     suggestedActions?: Array<{
         label: string;
@@ -122,21 +323,44 @@ export interface InsightEngineProps {
     sidepanelWidth?: number;
     /** Expanded width */
     expandedWidth?: number;
-    /** Custom sx props */
+    /**
+     * Width in px of the history column in the expanded view. In a panel narrower than 600px (the
+     * `regular` container width) the column stacks above the thread at full width instead. The
+     * drawer itself never grows past the viewport (`max-width: 100vw`).
+     * @default 260
+     * @since 2.13.0
+     */
+    historyWidth?: number;
+    /**
+     * Styles for the root (the Drawer in the `drawer` presentation, the embedded `div` otherwise),
+     * applied after its own. Object, array and function forms all apply. Style the paper through
+     * `slotProps.paper`; a `& .MuiDrawer-paper` rule here still wins over the paper's own width.
+     */
     sx?: SxProps<Theme>;
+    /**
+     * Added to the root's class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /**
+     * Props for Trinity-owned slots (ADR-04 (6)): `root`, `paper`, `body`, `thread` and `composer`.
+     * @since 2.13.0
+     */
+    slotProps?: InsightEngineSlotProps;
 }
 /**
- * Example mock messages for development/testing.
- * Demonstrates both simple text and structured AIResponse formats.
- *
- * @example
- * ```tsx
- * import { MOCK_MESSAGES } from './InsightEngine';
+ * Props for InsightEngine. Besides its own props, the root takes the HTML attributes of a `div`
+ * (`id`, `data-*`, `aria-*`, event handlers), spread before its own (ADR-04). Owned attributes
+ * (`role`, `aria-live`, `aria-busy`, `aria-relevant`, `aria-atomic`, `aria-modal`) are ignored on
+ * the root, with a development warning.
  *
- * <InsightEngine messages={MOCK_MESSAGES} ... />
- * ```
+ * **The root and the ref target, per presentation** (H-15, recorded under ADR-04 as deliberate):
+ * the persistent drawer's root (`.MuiDrawer-docked`, as before H-15) on desktop; the modal
+ * drawer's root (the MUI Modal root, portalled to `body`) below `sm`; the embedded `div` (a
+ * region named by the title) in the `embedded` presentation.
  */
-export declare const MOCK_MESSAGES: ChatMessage[];
+export interface InsightEngineProps extends InsightEngineOwnProps, TrinityRootProps<HTMLDivElement, InsightEngineOwnProps> {
+}
 /**
  * InsightEngine - Pure composition container for AI chat interface.
  *

package/dist/components/AI/InsightEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InsightEngine.d.ts","sourceRoot":"","sources":["../../../src/components/AI/InsightEngine.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"InsightEngine.d.ts","sourceRoot":"","sources":["../../../src/components/AI/InsightEngine.tsx"],"names":[],"mappings":"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"}

package/dist/components/AI/InsightEngineInput.d.ts

@@ -24,6 +24,7 @@ import React from 'react';
 import { SxProps, Theme } from '@mui/material';
 import { type MentionTrigger, type MentionOption, type MentionMatch } from '../MentionsInput';
 import { type AIVoiceStatus } from './AIVoiceMode';
+import { type TrinityRootProps } from '../shared/rootProps';
 export interface ModelOption {
     /** Unique identifier */
     id: string;
@@ -100,16 +101,16 @@ export interface InsightEngineAction {
     keepOpenOnClick?: boolean;
 }
 /**
- * Props for InsightEngineInput component.
+ * InsightEngineInput's own props.
  */
-export interface InsightEngineInputProps {
+export interface InsightEngineInputOwnProps {
     /** Current input value (controlled) */
     value?: string;
     /** Change handler for input */
     onChange?: (value: string) => void;
     /** Submit handler */
     onSubmit?: (value: string) => void;
-    /** Placeholder text */
+    /** Placeholder text. Default: the `ai.insightEngineInput.placeholder` string. */
     placeholder?: string;
     /** Enable native mentions experience in input area */
     mentionsEnabled?: boolean;
@@ -121,6 +122,37 @@ export interface InsightEngineInputProps {
     onMentionsChange?: (mentions: MentionMatch[]) => void;
     /** Whether input is disabled */
     disabled?: boolean;
+    /**
+     * Blocks sending, with a visible reason (ADR-05 (6)), for example while a required
+     * clarification waits for an answer. Send becomes `aria-disabled` (never natively disabled, so
+     * it keeps focus and stays in the tab order), Enter and Send do not submit, and the field stays
+     * editable so the user can keep drafting (DN-13). The reason renders as helper text below the
+     * composer, and both the field and Send are described by it (`aria-describedby`). Native
+     * `disabled` is unchanged and is never set by this prop.
+     * @since 2.13.0
+     */
+    disabledReason?: string;
+    /**
+     * The sent message is waiting to be accepted (for example while the request starts). Send
+     * stays in place, `aria-disabled` and `aria-busy` (never natively disabled), so focus stays on
+     * it; a spinner replaces its icon; Enter and Send do not submit. The field stays editable.
+     * @since 2.13.0
+     */
+    pending?: boolean;
+    /**
+     * An answer is being generated. Send becomes a Stop button (named and tooltipped
+     * `ai.insightEngineInput.stopGenerating`, 'Stop generating') in the same place, so focus stays on it, and Enter does not submit.
+     * Stop calls `onStop` once per generation and emits the content-free `answer.stopped`
+     * interaction through `AIConfigProvider`'s `onInteraction`.
+     * @since 2.13.0
+     */
+    generating?: boolean;
+    /**
+     * Called when the user stops the answer being generated (the Stop button shown while
+     * `generating`). Replaces the deprecated AIChatInput's `onStopGeneration`.
+     * @since 2.13.0
+     */
+    onStop?: () => void;
     /** Available AI models */
     models?: ModelOption[];
     /** Currently selected model ID */
@@ -186,9 +218,20 @@ export interface InsightEngineInputProps {
      * mode is active.
      */
     glow?: boolean;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the root's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for InsightEngineInput: its own props, plus the HTML attributes of its root `div`
+ * (`id`, `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface InsightEngineInputProps extends InsightEngineInputOwnProps, TrinityRootProps<HTMLDivElement, InsightEngineInputOwnProps> {
+}
 export declare const InsightEngineInput: React.ForwardRefExoticComponent<InsightEngineInputProps & React.RefAttributes<HTMLDivElement>>;
 export default InsightEngineInput;
 //# sourceMappingURL=InsightEngineInput.d.ts.map

package/dist/components/AI/InsightEngineInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InsightEngineInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/InsightEngineInput.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"InsightEngineInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/InsightEngineInput.tsx"],"names":[],"mappings":"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"}

package/dist/components/AI/MessageActionButton.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @internal — not part of the public API; see ADR-02
+ *
+ * MessageActionButton: the one renderer of AIMessage's footer actions (master plan G-04a,
+ * ADR-13 (3)). AIMessage describes each built-in action (copy, share, download, and later
+ * regenerate) as a {@link BuiltInActionSpec} and renders it here, so the actions share one
+ * markup instead of copy-pasted blocks.
+ *
+ * - An icon-only MUI IconButton inside a Tooltip. The spec's one `label` is both the button's
+ *   explicit `aria-label` and the tooltip text (ADR-13 (3), G-28), so what a sighted user reads
+ *   is what a screen reader announces. The Tooltip stays in MUI's default naming mode (no
+ *   `describeChild`), so the tooltip never adds a description that repeats the name.
+ * - The glyph is `text.secondary` at rest, 3:1 or more on the paper and default surfaces in
+ *   every mode and preset (WCAG 1.4.11, G-04d); the spec's `hoverColor` is its colour on hover
+ *   (a palette key such as `'success.main'`).
+ * - Keyboard focus is an outline (the theme's focus ring, `interactive.focus`), in `Highlight`
+ *   under forced colours (ADR-33 (2)). The pointer target is at least 24 by 24 px
+ *   (`targetSizeHitAreaSx`, WCAG 2.5.8).
+ * - Unavailable (`disabledReason`): the button is `aria-disabled` (never `disabled`, which drops
+ *   focus), a VisuallyHidden reason describes it through `aria-describedby`, and the tooltip
+ *   shows the label, then the reason. This is the one place the Tooltip describes its child
+ *   (`describeChild`, OD-F13 A); the button's own `aria-describedby` wins over the tooltip's, so
+ *   the reason is read once. Clicks do nothing.
+ * - Pending (`busy`, ADR-07): `aria-disabled` and `aria-busy`, focus stays, clicks do nothing.
+ * - Toggle (`pressed`, G-11): `aria-pressed`, and pressed draws the selected fill with an inset
+ *   ring (not colour alone), an inset Highlight outline under forced colours. Without `pressed`
+ *   the button is not a toggle and its styles are unchanged.
+ *
+ * Registered in src/components/internal/index.ts under AI ORGANISMS INTERNALS (G-30); no
+ * package entry exports it.
+ *
+ * @module components/AI/MessageActionButton
+ */
+import * as React from 'react';
+import { type IconName } from '../Icon';
+/**
+ * One built-in footer action of AIMessage.
+ *
+ * @internal
+ */
+export interface BuiltInActionSpec {
+    /** Stable id of the action, for example 'copy'. Also its React key. */
+    id: string;
+    /** The button's accessible name (`aria-label`) and its tooltip text: one string (ADR-13 (3)). */
+    label: string;
+    /** The glyph. An app action (G-11) may name any icon of the Icon set. */
+    icon: IconName | (string & {});
+    /** Runs the action. */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** The glyph's colour on hover: a palette key, for example 'text.secondary'. */
+    hoverColor: string;
+    /** Why the action is unavailable now. Set, the button is aria-disabled and described by it. */
+    disabledReason?: string;
+    /** The action is running: aria-disabled and aria-busy, clicks do nothing (ADR-07). */
+    busy?: boolean;
+    /** Unavailable without a reason to show: aria-disabled, clicks do nothing (G-11). */
+    disabled?: boolean;
+    /** A toggle's state (G-11): sets `aria-pressed`. Leave it out for an action that is not a toggle. */
+    pressed?: boolean;
+}
+/** Props of {@link MessageActionButton}. @internal */
+export interface MessageActionButtonProps {
+    /** The action to render. */
+    action: BuiltInActionSpec;
+}
+/**
+ * Renders one AIMessage footer action. See the module notes.
+ *
+ * @internal
+ */
+export declare const MessageActionButton: React.ForwardRefExoticComponent<MessageActionButtonProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=MessageActionButton.d.ts.map

package/dist/components/AI/MessageActionButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageActionButton.d.ts","sourceRoot":"","sources":["../../../src/components/AI/MessageActionButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM9C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC/B,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC/D,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qGAAqG;IACrG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oGAgF9B,CAAC"}

package/dist/components/AI/QueryInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/QueryInput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,OAAO,EAML,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,2BAA2B,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,2BAA2B;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAC7C,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;CAC1C;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B,CAAC;IAClD,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B,CAAC;CAC/C;AAED,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAkB,SAAQ,WAAW;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,EAAE,UAAU,iBAAiB,CAAC;QAC/C,uBAAuB,EAAE,UAAU,iBAAiB,CAAC;KACtD;CACF;AAMD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,wFAiRrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"QueryInput.d.ts","sourceRoot":"","sources":["../../../src/components/AI/QueryInput.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,OAAO,EAML,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,2BAA2B,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,2BAA2B;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAC7C,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAAC;CAC1C;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B,CAAC;IAClD,CAAC,KAAK,EAAE,MAAM,GAAG,4BAA4B,CAAC;CAC/C;AAED,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,iBAAkB,SAAQ,WAAW;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,iBAAiB,EAAE,UAAU,iBAAiB,CAAC;QAC/C,uBAAuB,EAAE,UAAU,iBAAiB,CAAC;KACtD;CACF;AAYD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,wFAqRrB,CAAC;AAEH,eAAe,UAAU,CAAC"}