@trinityui/design-system 2.11.0 → 2.13.0

package/dist/components/AI/AIChainOfThought.types.d.ts

@@ -2,22 +2,35 @@
  * @fileoverview Types for AIChainOfThought.
  * @module components/AI/AIChainOfThought.types
  *
- * Extracted from `AIChainOfThought.tsx` so the type surface can be imported
- * without pulling in the full 1800-line component (e.g. for test fixtures,
- * mock data generators, or server-side rendering of chain data).
+ * Extracted from `AIChainOfThought.tsx` so the types can be imported without
+ * the component (for test fixtures, mock data generators, or server code that
+ * builds chain data).
  */
+import type * as React from 'react';
 import type { SxProps, Theme } from '@mui/material';
+import type { TrinityRootProps, TrinitySlotProps } from '../shared/rootProps';
+import type { HeadingLevel } from '../shared/headingLevel';
 import type { AISourceCategory } from './AISourcesPanel';
-/** Status of an individual execution step */
-export type StepStatus = 'pending' | 'running' | 'completed' | 'error' | 'retrying';
-/** Status of a phase overall */
-export type PhaseStatus = 'pending' | 'active' | 'completed' | 'error';
+import type { AIActionErrorContext, AIBlockEvent, AIFeedbackRating, AIPlan } from './types/hitl';
+import type { AIMessageAction } from './AIMessage';
+import type { AIRelatedQuestion } from './AIRelatedQuestions';
+import type { AIBlockRendererMap } from './blockRendererContext';
+/**
+ * Status of an individual execution step. `'awaiting-input'` (since 2.13.0): the step waits for
+ * the user (shown as "Needs your input"). Switches over it need a default branch.
+ */
+export type StepStatus = 'pending' | 'running' | 'completed' | 'error' | 'retrying' | 'awaiting-input';
+/**
+ * Status of a phase overall. `'awaiting-input'` (since 2.13.0): the phase waits for the user, for
+ * example a plan to confirm; the chain keeps it open. Switches over it need a default branch.
+ */
+export type PhaseStatus = 'pending' | 'active' | 'completed' | 'error' | 'awaiting-input';
 export interface ChainSource {
     /** Icon name */
     icon?: string;
     /** Source label */
     label: string;
-    /** Source type badge text */
+    /** The source's type (for example "Database"), rendered as the chip label: "Database: metrics-store". */
     type?: string;
 }
 export interface TaskError {
@@ -29,6 +42,12 @@ export interface TaskError {
     resolution?: string;
 }
 export interface ExecutionTask {
+    /**
+     * Stable id of the task, used as its row key and as `taskId` in `onActionError`. Default
+     * `<phase id>-task-<index>`. Unique within its phase (a duplicate warns once in development).
+     * @since 2.13.0
+     */
+    id?: string;
     /** Task label */
     label: string;
     /** Sub-detail text shown while running */
@@ -43,23 +62,44 @@ export interface ExecutionTask {
     retryDetail?: string;
     /** Retry timing */
     retryTime?: string;
+    /**
+     * Whether a failed task offers Retry when the chain has `onTaskRetry`. `false` hides Retry for
+     * this task. @default true
+     * @since 2.13.0
+     */
+    retryable?: boolean;
 }
 export interface ChainArtifact {
     /** Unique id */
     id: string;
     /** Display label */
     label: string;
-    /** Icon name */
+    /** Icon name for the card's white tile. Default: a file glyph. */
     icon?: string;
     /** Short description */
     description?: string;
-    /** File format badge (e.g. "CSV", "Interactive", "PDF") */
+    /** File format (e.g. "CSV", "Interactive", "PDF"), shown with `meta` as the card's second line ("CSV · 5 rows"). */
     format?: string;
-    /** Meta text (e.g. "12,420 records") */
+    /** Meta text (e.g. "5 rows", "12,420 records") */
     meta?: string;
-    /** Whether to show mini chart bars */
+    /**
+     * Whether to show the mini chart. Its bars come from `chartData` only; without
+     * data a neutral chart glyph shows instead. The chart is decorative and hidden
+     * from assistive technology.
+     */
     showChart?: boolean;
-    /** Click handler */
+    /**
+     * Values for the mini chart, one bar per value, scaled so the smallest value
+     * gets the shortest bar and the largest the tallest. Keep it short (about 12
+     * values fit a card). Values that are not finite numbers get the shortest bar.
+     * @since 2.13.0
+     */
+    chartData?: number[];
+    /**
+     * Called when the card is activated. With it, the card's primary action is a
+     * button named by `label` that covers the card (click, Enter or Space);
+     * without it the card is plain content.
+     */
     onClick?: () => void;
 }
 export interface OutputStat {
@@ -93,19 +133,33 @@ export interface PhaseBase {
     id: string;
     /** Display title */
     title: string;
-    /** Subtitle / description */
+    /** The phase's one line of text under its title (for example "Three steps, shown before anything runs."). */
     subtitle?: string;
-    /** Phase status */
+    /**
+     * Explicit status. When set it always wins; otherwise `derivePhaseStatus()`
+     * derives it (an execution phase from its tasks, every other type
+     * `completed`). See the table in AIChainOfThought.tsx.
+     */
     status?: PhaseStatus;
     /** Duration string shown when completed */
     duration?: string;
-    /** Whether phase body is initially expanded */
+    /**
+     * Whether the phase body starts expanded. Read the first time the phase id is
+     * seen, including a phase that streams in after mount; later changes do not
+     * reseed it. @default true
+     */
     defaultExpanded?: boolean;
 }
 /** Understanding phase — thought bubbles + sources */
 export interface UnderstandingPhase extends PhaseBase {
     type: 'understanding';
-    /** Thought bubble contents (supports HTML: strong, code) */
+    /**
+     * Thought bubble contents. Treated as untrusted and read as the chain's
+     * `contentFormat` says: by default safe-content HTML (the allowlist b, strong, i,
+     * em, code, br, p, ul, ol, li, span, a, mark; links keep only
+     * http(s)/mailto/tel/relative hrefs; every other tag, attribute and handler is
+     * removed or shown as text), or markdown, or plain text.
+     */
     thoughts: string[];
     /** Sources consulted */
     sources?: ChainSource[];
@@ -141,7 +195,14 @@ export interface OutputPhase extends PhaseBase {
 /** Insight phase — highlighted body, metrics, references */
 export interface InsightPhase extends PhaseBase {
     type: 'insight';
-    /** The insight body (supports HTML: p, strong, code, span.insight-highlight) */
+    /**
+     * The insight body. Treated as untrusted and read as the chain's
+     * `contentFormat` says: by default safe-content HTML (the allowlist b, strong, i,
+     * em, code, br, p, ul, ol, li, span, a, mark, with
+     * `<span class="insight-highlight">` for highlights; links keep only
+     * http(s)/mailto/tel/relative hrefs; everything else is removed or shown as
+     * text), or markdown, or plain text.
+     */
     content: string;
     /** Optional confidence 0-1 */
     confidence?: number;
@@ -150,30 +211,106 @@ export interface InsightPhase extends PhaseBase {
     /** References / sources */
     references?: InsightReference[];
 }
-/** Discriminated union of all phase types */
-export type ChainPhase = UnderstandingPhase | PlanPhase | ExecutionPhase | OutputPhase | InsightPhase;
-export interface AIChainOfThoughtProps {
-    /** The original user query (shown at top) */
+/**
+ * Plan review phase (G-22): a plan the user confirms, edits or clarifies before it runs. A
+ * thinking phase: it shows in the thought process, never in the response, and keeps the
+ * thought process open while the plan waits for the user (`plan.status` 'review'). The body is
+ * the `plan-review` block renderer (AIPlanReview by default) with a block whose id is the
+ * phase's id; its events reach `onBlockEvent`.
+ *
+ * Status without an explicit `status`: 'review' (or none) is `awaiting-input`, 'replanning' is
+ * `active`, every other plan status is `completed`.
+ *
+ * @since 2.13.0
+ */
+export interface PlanReviewPhase extends PhaseBase {
+    type: 'plan-review';
+    /** The plan under review. */
+    plan: AIPlan;
+    /** Where the review shows: in the phase (`'inline'`) or in a dialog (`'dialog'`). @default 'inline' */
+    presentation?: 'inline' | 'dialog';
+}
+/**
+ * Discriminated union of all phase types. `PlanReviewPhase` joined it in 2.13.0: switches over
+ * `type` need a default branch.
+ */
+export type ChainPhase = UnderstandingPhase | PlanPhase | PlanReviewPhase | ExecutionPhase | OutputPhase | InsightPhase;
+/**
+ * AIChainOfThought's own props. The root `<div>`'s HTML attributes are the rest (ADR-04 (3)).
+ */
+export interface AIChainOfThoughtOwnProps {
+    /**
+     * The original user query, used as the accessible name of the reasoning group
+     * ("Reasoning for {query}"; without it, "AI reasoning chain"). Not shown on
+     * screen.
+     */
     query?: string;
+    /**
+     * Shows the query as visible text above the thought process (G-OD3). Off by default: the query
+     * names the reasoning group either way.
+     * @default false
+     * @since 2.13.0
+     */
+    showQuery?: boolean;
     /** Ordered list of reasoning phases */
     phases: ChainPhase[];
-    /** Whether to show the collapsible thought-process toggle bar */
+    /**
+     * How thought bubbles (`thoughts`) and insight bodies (`content`) are read.
+     * All three treat the strings as untrusted model output.
+     *
+     * - `'html'` (default): safe-content HTML. Only b, strong, i, em, code, br, p,
+     *   ul, ol, li, span, a and mark are kept, plus `<span class="insight-highlight">`.
+     *   Links keep only http(s), mailto, tel and relative hrefs. Scripts, event
+     *   handlers, frames, styles and every other tag or attribute are removed or
+     *   shown as text.
+     * - `'markdown'`: parsed by AITextBlock's markdown renderer (bold, italic,
+     *   inline code, links through the same URL policy, headings, lists, quotes,
+     *   rules and paragraphs). HTML in the string is shown as text.
+     *   Recommended for new integrations.
+     * - `'text'`: plain text; nothing is parsed.
+     *
+     * @default 'html'
+     * @since 2.13.0
+     */
+    contentFormat?: 'html' | 'markdown' | 'text';
+    /**
+     * Wraps each phase trigger in a heading of this level (`<h3><button>…</button></h3>`), so
+     * screen-reader users can move between phases by heading. The trigger keeps its name (the
+     * title, then the status). Unset, no heading element is rendered.
+     * @since 2.13.0
+     */
+    phaseHeadingLevel?: HeadingLevel;
+    /** Whether to show the "Thought process" header (the collapsible disclosure with the status line and progress dots). @default true */
     showToggle?: boolean;
     /** Whether the thought process starts collapsed */
     defaultCollapsed?: boolean;
     /** Which phase IDs are "thinking" phases (shown in toggle, collapsible).
      *  Output and Insight phases are always shown outside the collapsible area. */
     thinkingPhaseIds?: string[];
-    /** Whether to animate phase entrance */
+    /**
+     * Whether phase entrance and expand/collapse transitions animate (the Fade and
+     * Collapse timeouts). CSS animations such as spinners and entrance keyframes
+     * run either way. @default true
+     */
     animated?: boolean;
-    /** Elapsed time string shown in toggle bar */
+    /** Elapsed time string shown in the header's status line ("Done · 4.2s") */
     elapsedTime?: string;
     /** Source citations displayed after the AI response (reuses AISourcesPanel) */
     sources?: AISourceCategory[];
-    /** Related follow-up questions (reuses AIRelatedQuestions) */
-    relatedQuestions?: string[];
-    /** Callback when a related question is clicked */
+    /**
+     * Related follow-up questions (reuses AIRelatedQuestions): strings, or `AIRelatedQuestion`
+     * objects (since 2.13.0) for an id and the verified flag ('Verified' badge). Both can be mixed.
+     */
+    relatedQuestions?: Array<string | AIRelatedQuestion>;
+    /** Callback when a related question is clicked: the question's text. */
     onQuestionClick?: (question: string) => void;
+    /**
+     * Callback when a related question is clicked: the question (a string is passed as `{ text }`)
+     * and its index. Fires alongside `onQuestionClick`; the chain then reports the content-free
+     * `followup.select` interaction (`{ verified, index, questionId? }`) once.
+     * @since 2.13.0
+     */
+    onQuestionSelect?: (question: AIRelatedQuestion, index: number) => void;
     /** Suggested actions shown after the response (reuses AISuggestedAction) */
     suggestedActions?: Array<{
         label: string;
@@ -181,15 +318,140 @@ export interface AIChainOfThoughtProps {
     }>;
     /** Timestamp displayed in the AI message footer */
     timestamp?: string;
-    /** Callback for copy action on the AI message */
-    onCopy?: () => void;
-    /** Callback for feedback (thumbs up/down) on the AI message */
+    /**
+     * Called with the copied text when Copy is pressed. Without it, Copy writes the response to the
+     * clipboard and announces the result (AIMessage's `'auto'` copy). Copy always shows.
+     */
+    onCopy?: (text: string) => void;
+    /**
+     * The text Copy uses. Default: the visible text of the final phases (output and insight), without
+     * hidden parts.
+     * @since 2.13.0
+     */
+    copyText?: string;
+    /**
+     * Called with the new rating when a thumb is pressed (`true` good, `false` poor). The thumbs show
+     * only when this, `onFeedbackChange` or a controlled `feedback` is passed.
+     */
     onFeedback?: (positive: boolean) => void;
-    /** Callback for share action on the AI message */
+    /**
+     * The rating, controlled: `'positive'`, `'negative'` or `null`. Passed to AIMessage.
+     * @since 2.13.0
+     */
+    feedback?: AIFeedbackRating | null;
+    /**
+     * The initial rating when `feedback` is not controlled. Passed to AIMessage.
+     * @default null
+     * @since 2.13.0
+     */
+    defaultFeedback?: AIFeedbackRating | null;
+    /**
+     * Called with every rating change, `null` when the pressed thumb is pressed again. Passed to
+     * AIMessage.
+     * @since 2.13.0
+     */
+    onFeedbackChange?: (value: AIFeedbackRating | null) => void;
+    /**
+     * Replaces the built-in thumbs in the footer, for example with a detailed AIFeedbackControl.
+     * @since 2.13.0
+     */
+    feedbackControl?: React.ReactNode;
+    /** Share callback. The Share action shows only when it is passed. */
     onShare?: () => void;
-    /** Callback for download action on the AI message */
+    /** Download callback. The Download action shows only when it is passed. */
     onDownload?: () => void;
-    /** Custom sx */
+    /**
+     * Regenerates the response. When passed, the footer shows Regenerate (AIMessage's action: pending
+     * state, the failure alert with "Try again", `onActionError` with `{ source: 'action', actionId:
+     * 'regenerate' }`).
+     * @since 2.13.0
+     */
+    onRegenerate?: () => void | Promise<void>;
+    /**
+     * App actions after the built-in ones in the response footer (see `AIMessageAction`).
+     * @since 2.13.0
+     */
+    actions?: AIMessageAction[];
+    /**
+     * Non-interactive content at the start of the response footer: AIConfidenceBadge,
+     * AIVerificationBadge.
+     * @since 2.13.0
+     */
+    badges?: React.ReactNode;
+    /**
+     * Retries a failed execution task. When set, every task whose status is `error` shows a
+     * "Retry" button in its error alert. The button runs this through the shared async contract:
+     * while the returned promise is pending it is `aria-disabled` and `aria-busy` and keeps focus,
+     * and a rejection shows an inline "Couldn't retry the task" alert with "Try again". On success
+     * the parent moves the task on by updating `phases` (for example to `running` or `retrying`).
+     * Named apart from the message-level `onRegenerate`, which regenerates the whole response.
+     * @since 2.13.0
+     */
+    onTaskRetry?: (task: ExecutionTask, phase: ExecutionPhase) => void | PromiseLike<void>;
+    /**
+     * Called when a task retry (`onTaskRetry`) rejects, with
+     * `{ source: 'task', phaseId, taskId }` (`taskId` is `<phase id>-task-<index>`). The inline
+     * failure shows either way. Without it, the error goes to `globalThis.reportError` (ADR-07).
+     * @since 2.13.0
+     */
+    onActionError?: (error: unknown, context: AIActionErrorContext) => void;
+    /**
+     * Called with what the user did in a plan-review phase (`plan.confirm`, `plan.stepEdit`,
+     * `plan.clarify`, `plan.cancel`; the block id is the phase id). A returned promise drives the
+     * plan's pending state, its rejection the plan's error. Without it a plan renders read-only.
+     * @since 2.13.0
+     */
+    onBlockEvent?: (event: AIBlockEvent) => void | Promise<void>;
+    /**
+     * Block renderers by block type, merged over the ones a host provides (ChatThread,
+     * InsightEngine). The `plan-review` entry renders plan-review phases; `null` turns a provided
+     * one off. Keep the object stable (module scope or `useMemo`).
+     * @since 2.13.0
+     */
+    blockRenderers?: AIBlockRendererMap;
+    /**
+     * What the chain announces to screen readers (ADR-19).
+     *
+     * - `'transitions'` (default): one polite message per transition: "Thinking"
+     *   when the first thinking phase becomes active, "Plan's ready — needs your
+     *   confirmation" when a plan-review phase starts waiting for the user,
+     *   "Response ready" when the final phases appear. A chain that mounts already
+     *   thinking, waiting or complete does not announce that state.
+     * - `'stream'`: the 2.12 behavior: the chain is a polite live container, so
+     *   added text is read as it streams.
+     * - `'off'`: nothing is announced.
+     *
+     * Inside a chat thread (which announces new messages itself) the chain
+     * announces nothing and is never a live container, whatever this is.
+     *
+     * @default 'transitions'
+     * @since 2.13.0
+     */
+    announcements?: 'transitions' | 'stream' | 'off';
+    /** Added to the root's own class names. @since 2.13.0 */
+    className?: string;
+    /** Custom sx, applied to the root after its own styles (object, array or function form). */
     sx?: SxProps<Theme>;
+    /**
+     * Props for the parts (ADR-04 (6)): `root` (the root; its role and busy and live attributes stay
+     * the component's), `toggle` (the thought-process disclosure), `phaseCard` (each phase card) and
+     * `response` (the box around the response AIMessage). Each takes `className`, `data-*` and `sx`.
+     * @since 2.13.0
+     */
+    slotProps?: {
+        root?: TrinitySlotProps<HTMLDivElement>;
+        toggle?: TrinitySlotProps<HTMLDivElement>;
+        phaseCard?: TrinitySlotProps<HTMLDivElement>;
+        response?: TrinitySlotProps<HTMLDivElement>;
+    };
+}
+/**
+ * Props for AIChainOfThought: its own props plus the root `<div>`'s HTML attributes (`id`,
+ * `data-*`, `aria-*`, event handlers), spread on the root (ADR-04). `role`, `aria-busy`,
+ * `aria-live`, `aria-relevant` and `aria-atomic` stay the component's. The own `onCopy` (Copy's
+ * callback) shadows the DOM clipboard handler by design; a consumer `aria-label` replaces the
+ * group name.
+ */
+export interface AIChainOfThoughtProps extends AIChainOfThoughtOwnProps, TrinityRootProps<HTMLDivElement, AIChainOfThoughtOwnProps> {
 }
 //# sourceMappingURL=AIChainOfThought.types.d.ts.map

package/dist/components/AI/AIChainOfThought.types.d.ts.map

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

package/dist/components/AI/AIChainOfThought.utils.d.ts

@@ -2,19 +2,37 @@
  * @fileoverview Pure helpers for AIChainOfThought.
  * @module components/AI/AIChainOfThought.utils
  *
- * Extracted from `AIChainOfThought.tsx` so the state-derivation logic can be
- * unit-tested in isolation without mounting the full 1800-line component.
+ * Extracted from `AIChainOfThought.tsx` so the state-derivation logic and the marker colour
+ * derivations can be unit-tested without mounting the component.
  */
+import { type Theme } from '@mui/material/styles';
 import type { ChainPhase, PhaseStatus } from './AIChainOfThought.types';
 /**
- * Derive a `PhaseStatus` from a `ChainPhase`. If the phase has an explicit
- * `status` field, that wins; otherwise the status is inferred from phase-type
- * signals (execution tasks' statuses, output artifacts, etc.).
+ * Derive a `PhaseStatus` from a `ChainPhase`. An explicit `status` wins.
+ * Otherwise a plan-review phase reads its plan's status ('review' or none:
+ * awaiting-input; 'replanning': active; any other: completed), an execution
+ * phase derives it from its tasks (error, then awaiting-input, then all
+ * completed, then running or retrying, else pending), and every other phase
+ * type is `completed`.
  *
- * See the "State Machine" section in `AIChainOfThought.tsx` for the full
- * decision table.
+ * See the "Phase status" table in `AIChainOfThought.tsx`.
  *
  * This function is pure and side-effect-free — safe to call during render.
  */
 export declare function derivePhaseStatus(phase: ChainPhase): PhaseStatus;
+/**
+ * The tint behind a done marker's check: the success text at 16%. The check (the success text)
+ * measures 3:1 or more on it and on the card in light and dark (asserted in the contrast tests).
+ */
+export declare const DONE_TINT_ALPHA = 0.16;
+/**
+ * The neutral graphic of a pending step (the gray progress dot, the pending marker's dot and a
+ * pending task's ring): the primary text at 50%, a mid gray that measures 3:1 or more on the
+ * header, the card and the neutral wash in light and dark (asserted in the contrast tests).
+ */
+export declare const PENDING_GRAPHIC_ALPHA = 0.5;
+/** @internal The pending graphic colour of a theme (see PENDING_GRAPHIC_ALPHA). */
+export declare function pendingGraphic(theme: Theme): string;
+/** @internal The done marker's tint of a theme (see DONE_TINT_ALPHA). */
+export declare function doneTint(theme: Theme): string;
 //# sourceMappingURL=AIChainOfThought.utils.d.ts.map

package/dist/components/AI/AIChainOfThought.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIChainOfThought.utils.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIChainOfThought.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAYhE"}
+{"version":3,"file":"AIChainOfThought.utils.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIChainOfThought.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAoBhE;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE7C"}

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

@@ -75,6 +75,9 @@ export interface AIChatMessageProps {
 /**
  * AI Chat Message - Individual message in a chat conversation.
  *
+ * @deprecated Removed in v3.0 (planned). Use `AIMessage` instead (MIGRATION.md, "Deprecated
+ * exports removed in v3.0").
+ *
  * Structure:
  * - User messages: Right-aligned with bubble and avatar
  * - Assistant messages: Left-aligned with avatar, content, actions, and children
@@ -109,6 +112,9 @@ export interface AIChatInputProps {
 }
 /**
  * AI Chat Input - Input field for chat messages with send and voice buttons.
+ *
+ * @deprecated Removed in v3.0 (planned). Use `InsightEngineInput` for the input, or `ChatThread`
+ * for a whole conversation (MIGRATION.md, "Deprecated exports removed in v3.0").
  */
 export declare const AIChatInput: React.ForwardRefExoticComponent<AIChatInputProps & React.RefAttributes<HTMLDivElement>>;
 /**
@@ -122,6 +128,9 @@ export interface AITypingIndicatorProps {
 }
 /**
  * AI Typing Indicator - Shows when AI is generating a response.
+ *
+ * @deprecated Removed in v3.0 (planned). Use `AIMessage`'s streaming state with `AIShimmer`
+ * (MIGRATION.md, "Deprecated exports removed in v3.0").
  */
 export declare const AITypingIndicator: React.ForwardRefExoticComponent<AITypingIndicatorProps & React.RefAttributes<HTMLDivElement>>;
 /**
@@ -137,6 +146,9 @@ export interface AIQuickReplyProps {
 }
 /**
  * AI Quick Reply - Suggested quick reply options.
+ *
+ * @deprecated Removed in v3.0 (planned). Use `AISuggestedAction` or `AIActionsGroup`
+ * (MIGRATION.md, "Deprecated exports removed in v3.0").
  */
 export declare const AIQuickReply: React.ForwardRefExoticComponent<AIQuickReplyProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIChat.d.ts.map

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

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