@trinityui/design-system 2.1.3 → 2.2.1

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

@@ -49,7 +49,7 @@ export interface AISuggestedActionProps {
  * - primary: Filled primary style
  * - outlined: Bordered style
  */
-export declare const AISuggestedAction: React.FC<AISuggestedActionProps>;
+export declare const AISuggestedAction: React.ForwardRefExoticComponent<AISuggestedActionProps & React.RefAttributes<HTMLButtonElement>>;
 /**
  * Props for AICircularAction component.
  */
@@ -83,7 +83,7 @@ export interface AICircularActionProps {
  * - refresh: Retry actions
  * - copy: Copy to clipboard
  */
-export declare const AICircularAction: React.FC<AICircularActionProps>;
+export declare const AICircularAction: React.ForwardRefExoticComponent<AICircularActionProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AIActionsGroup component.
  */
@@ -100,5 +100,5 @@ export interface AIActionsGroupProps {
 /**
  * AI Actions Group - Group of suggested actions.
  */
-export declare const AIActionsGroup: React.FC<AIActionsGroupProps>;
+export declare const AIActionsGroup: React.ForwardRefExoticComponent<AIActionsGroupProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIActions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AIActions.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIActions.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAQL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AASvB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAsL9D,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,cAAc;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7C,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA2G5D,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,uBAAuB;IACvB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAaxD,CAAC"}
+{"version":3,"file":"AIActions.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIActions.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAQL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AASvB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,kGAoL7B,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW;IACX,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,cAAc;IACd,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7C,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,8FAsG5B,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,uBAAuB;IACvB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,4FAU1B,CAAC"}

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

@@ -28,5 +28,5 @@ export interface AIAvatarProps {
 /**
  * AI Avatar - Visual representation of the AI assistant.
  */
-export declare const AIAvatar: React.FC<AIAvatarProps>;
+export declare const AIAvatar: React.ForwardRefExoticComponent<AIAvatarProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIAvatar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AIAvatar.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIAvatar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAU,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAiBD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAiC5C,CAAC"}
+{"version":3,"file":"AIAvatar.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIAvatar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAU,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQvD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAiBD;;GAEG;AACH,eAAO,MAAM,QAAQ,sFAgCnB,CAAC"}

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

@@ -5,6 +5,66 @@
  * Evolved Chain-of-Thought UI — shows AI reasoning steps in a digestible,
  * personable way. Inspired by Replit, Perplexity, and VS Code Coding Agent.
  *
+ * ## State Machine
+ *
+ * AIChainOfThought displays a sequence of `ChainPhase` objects. Each phase has
+ * a derived `status` (see `derivePhaseStatus()`) based on its type-specific
+ * completion signals:
+ *
+ * ```
+ *                  ┌──────────────────────────────────────────┐
+ *                  │             PHASE LIFECYCLE              │
+ *                  └──────────────────────────────────────────┘
+ *
+ *     ┌─pending────► active ──► completed ──┐       ╳ error
+ *     │                                      │       ▲
+ *     │                                      ▼       │
+ *     │                               (next phase    │
+ *     │                                starts here)  │
+ *     │                                              │
+ *     └──────────── retry / reset ───────────────────┘
+ * ```
+ *
+ * Phase-type-specific "active → completed" triggers:
+ *
+ * | Phase type     | Becomes `active` when           | Becomes `completed` when                          |
+ * |----------------|---------------------------------|---------------------------------------------------|
+ * | `understanding`| Has ≥1 thought bubble           | `phase.complete === true`                         |
+ * | `plan`         | Has ≥1 step                     | `phase.complete === true`                         |
+ * | `execution`    | Any task is not `pending`       | All tasks are `completed` or user set `complete`  |
+ * | `output`       | Has artifacts or `complete`     | `phase.complete === true`                         |
+ * | `insight`      | Has content or `complete`       | `phase.complete === true`                         |
+ *
+ * **Error state:** Any phase flips to `error` if its `error` field is set
+ * (execution) or if `phase.status === 'error'` is explicitly set. Rendering
+ * shows the ErrorBanner and a retry affordance.
+ *
+ * ## UI State (internal)
+ *
+ * The component owns the following UI-only state. Do NOT pass these as props —
+ * they're affordances, not domain data:
+ *
+ * - `collapsed: boolean` — whether the "thinking" phases are collapsed behind
+ *   the toggle bar. Auto-flips to `true` when all thinking phases complete AND
+ *   the final-response phase arrives (controlled by `hasAutoCollapsed` ref).
+ * - `expanded: Record<phaseId, boolean>` — per-phase expansion state, seeded
+ *   from each phase's `defaultExpanded` field.
+ *
+ * ## Parent-owned data
+ *
+ * - `phases: ChainPhase[]` — array of phase objects, each with a discriminated
+ *   `type` field. The parent is responsible for updating this over time as the
+ *   AI streams its reasoning.
+ * - `sources`, `relatedQuestions`, `suggestedActions` — presented after the
+ *   final-response phase appears.
+ *
+ * ## Auto-collapse behavior
+ *
+ * When all "thinking" phases (default: understanding / plan / execution) reach
+ * `completed` AND one or more "final" phases (output / insight) appear, the
+ * thinking group collapses automatically — only fires once, tracked via
+ * `hasAutoCollapsed` ref so subsequent toggles stick.
+ *
  * Features:
  * - Collapsible "Thought Process" toggle bar with phase dots & elapsed time
  * - Understanding phase with thought bubbles (supports bold/code), sources
@@ -27,192 +87,8 @@
  * ```
  */
 import React from 'react';
-import { SxProps, Theme } from '@mui/material';
-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';
-export interface ChainSource {
-    /** Icon name */
-    icon?: string;
-    /** Source label */
-    label: string;
-    /** Source type badge text */
-    type?: string;
-}
-export interface TaskError {
-    /** Error message */
-    message: string;
-    /** Error code (e.g. "ERROR 55P03") */
-    code?: string;
-    /** Resolution description */
-    resolution?: string;
-}
-export interface ExecutionTask {
-    /** Task label */
-    label: string;
-    /** Sub-detail text shown while running */
-    detail?: string;
-    /** Timing string */
-    time?: string;
-    /** Current status */
-    status: StepStatus;
-    /** Error details (when status is 'error') */
-    error?: TaskError;
-    /** Retry detail text */
-    retryDetail?: string;
-    /** Retry timing */
-    retryTime?: string;
-}
-export interface ChainArtifact {
-    /** Unique id */
-    id: string;
-    /** Display label */
-    label: string;
-    /** Icon name */
-    icon?: string;
-    /** Short description */
-    description?: string;
-    /** File format badge (e.g. "CSV", "Interactive", "PDF") */
-    format?: string;
-    /** Meta text (e.g. "12,420 records") */
-    meta?: string;
-    /** Whether to show mini chart bars */
-    showChart?: boolean;
-    /** Click handler */
-    onClick?: () => void;
-}
-export interface OutputStat {
-    /** Icon name */
-    icon?: string;
-    /** Stat label */
-    label: string;
-    /** Stat value */
-    value: string;
-}
-export interface InsightMetric {
-    /** Metric value (e.g. "+34%") */
-    value: string;
-    /** Metric label (e.g. "APAC Growth") */
-    label: string;
-}
-export interface InsightReference {
-    /** Icon name */
-    icon?: string;
-    /** Reference title */
-    title: string;
-    /** Badge text (e.g. "Internal", "Docs") */
-    badge?: string;
-    /** Description */
-    description?: string;
-    /** Meta text (e.g. "Updated 2h ago") */
-    meta?: string;
-}
-interface PhaseBase {
-    /** Unique identifier */
-    id: string;
-    /** Display title */
-    title: string;
-    /** Subtitle / description */
-    subtitle?: string;
-    /** Phase status */
-    status?: PhaseStatus;
-    /** Duration string shown when completed */
-    duration?: string;
-    /** Whether phase body is initially expanded */
-    defaultExpanded?: boolean;
-}
-/** Understanding phase — thought bubbles + sources */
-export interface UnderstandingPhase extends PhaseBase {
-    type: 'understanding';
-    /** Thought bubble contents (supports HTML: strong, code) */
-    thoughts: string[];
-    /** Sources consulted */
-    sources?: ChainSource[];
-}
-/** Plan phase — numbered steps with optional Run button */
-export interface PlanPhase extends PhaseBase {
-    type: 'plan';
-    /** Ordered list of plan steps */
-    steps: string[];
-    /** Optional "Run" button handler */
-    onRun?: () => void;
-    /** Whether the run button is shown */
-    showRun?: boolean;
-}
-/** Execution phase — tasks with detail, error, and retry */
-export interface ExecutionPhase extends PhaseBase {
-    type: 'execution';
-    /** Execution tasks */
-    tasks: ExecutionTask[];
-}
-/** Output phase — summary + artifact cards */
-export interface OutputPhase extends PhaseBase {
-    type: 'output';
-    /** Summary title */
-    summary?: string;
-    /** Summary description */
-    description?: string;
-    /** Stats row */
-    stats?: OutputStat[];
-    /** Artifact cards */
-    artifacts: ChainArtifact[];
-}
-/** Insight phase — highlighted body, metrics, references */
-export interface InsightPhase extends PhaseBase {
-    type: 'insight';
-    /** The insight body (supports HTML: p, strong, code, span.insight-highlight) */
-    content: string;
-    /** Optional confidence 0-1 */
-    confidence?: number;
-    /** Key metrics */
-    metrics?: InsightMetric[];
-    /** 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) */
-    query?: string;
-    /** Ordered list of reasoning phases */
-    phases: ChainPhase[];
-    /** Whether to show the collapsible thought-process toggle bar */
-    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 */
-    animated?: boolean;
-    /** Elapsed time string shown in toggle bar */
-    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 */
-    onQuestionClick?: (question: string) => void;
-    /** Suggested actions shown after the response (reuses AISuggestedAction) */
-    suggestedActions?: Array<{
-        label: string;
-        onClick?: () => void;
-    }>;
-    /** 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 */
-    onFeedback?: (positive: boolean) => void;
-    /** Callback for share action on the AI message */
-    onShare?: () => void;
-    /** Callback for download action on the AI message */
-    onDownload?: () => void;
-    /** Custom sx */
-    sx?: SxProps<Theme>;
-}
+import type { StepStatus, PhaseStatus, ChainSource, TaskError, ExecutionTask, ChainArtifact, OutputStat, InsightMetric, InsightReference, UnderstandingPhase, PlanPhase, ExecutionPhase, OutputPhase, InsightPhase, ChainPhase, AIChainOfThoughtProps } from './AIChainOfThought.types';
+export type { StepStatus, PhaseStatus, ChainSource, TaskError, ExecutionTask, ChainArtifact, OutputStat, InsightMetric, InsightReference, UnderstandingPhase, PlanPhase, ExecutionPhase, OutputPhase, InsightPhase, ChainPhase, AIChainOfThoughtProps, };
 /**
  * AIChainOfThought — Evolved reasoning UI.
  *
@@ -223,6 +99,5 @@ export interface AIChainOfThoughtProps {
  * "Thought Process" toggle bar. Output and Insight phases are always visible
  * as the final response.
  */
-export declare const AIChainOfThought: React.FC<AIChainOfThoughtProps>;
-export {};
+export declare const AIChainOfThought: React.ForwardRefExoticComponent<AIChainOfThoughtProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIChainOfThought.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AIChainOfThought.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIChainOfThought.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AIChainOfThought.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIChainOfThought.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuFG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAsBxE,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,qBAAqB,GACtB,CAAC;AAqvCF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,8FAwO5B,CAAC"}

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

@@ -0,0 +1,195 @@
+/**
+ * @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).
+ */
+import type { SxProps, Theme } from '@mui/material';
+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';
+export interface ChainSource {
+    /** Icon name */
+    icon?: string;
+    /** Source label */
+    label: string;
+    /** Source type badge text */
+    type?: string;
+}
+export interface TaskError {
+    /** Error message */
+    message: string;
+    /** Error code (e.g. "ERROR 55P03") */
+    code?: string;
+    /** Resolution description */
+    resolution?: string;
+}
+export interface ExecutionTask {
+    /** Task label */
+    label: string;
+    /** Sub-detail text shown while running */
+    detail?: string;
+    /** Timing string */
+    time?: string;
+    /** Current status */
+    status: StepStatus;
+    /** Error details (when status is 'error') */
+    error?: TaskError;
+    /** Retry detail text */
+    retryDetail?: string;
+    /** Retry timing */
+    retryTime?: string;
+}
+export interface ChainArtifact {
+    /** Unique id */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Icon name */
+    icon?: string;
+    /** Short description */
+    description?: string;
+    /** File format badge (e.g. "CSV", "Interactive", "PDF") */
+    format?: string;
+    /** Meta text (e.g. "12,420 records") */
+    meta?: string;
+    /** Whether to show mini chart bars */
+    showChart?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+}
+export interface OutputStat {
+    /** Icon name */
+    icon?: string;
+    /** Stat label */
+    label: string;
+    /** Stat value */
+    value: string;
+}
+export interface InsightMetric {
+    /** Metric value (e.g. "+34%") */
+    value: string;
+    /** Metric label (e.g. "APAC Growth") */
+    label: string;
+}
+export interface InsightReference {
+    /** Icon name */
+    icon?: string;
+    /** Reference title */
+    title: string;
+    /** Badge text (e.g. "Internal", "Docs") */
+    badge?: string;
+    /** Description */
+    description?: string;
+    /** Meta text (e.g. "Updated 2h ago") */
+    meta?: string;
+}
+export interface PhaseBase {
+    /** Unique identifier */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Subtitle / description */
+    subtitle?: string;
+    /** Phase status */
+    status?: PhaseStatus;
+    /** Duration string shown when completed */
+    duration?: string;
+    /** Whether phase body is initially expanded */
+    defaultExpanded?: boolean;
+}
+/** Understanding phase — thought bubbles + sources */
+export interface UnderstandingPhase extends PhaseBase {
+    type: 'understanding';
+    /** Thought bubble contents (supports HTML: strong, code) */
+    thoughts: string[];
+    /** Sources consulted */
+    sources?: ChainSource[];
+}
+/** Plan phase — numbered steps with optional Run button */
+export interface PlanPhase extends PhaseBase {
+    type: 'plan';
+    /** Ordered list of plan steps */
+    steps: string[];
+    /** Optional "Run" button handler */
+    onRun?: () => void;
+    /** Whether the run button is shown */
+    showRun?: boolean;
+}
+/** Execution phase — tasks with detail, error, and retry */
+export interface ExecutionPhase extends PhaseBase {
+    type: 'execution';
+    /** Execution tasks */
+    tasks: ExecutionTask[];
+}
+/** Output phase — summary + artifact cards */
+export interface OutputPhase extends PhaseBase {
+    type: 'output';
+    /** Summary title */
+    summary?: string;
+    /** Summary description */
+    description?: string;
+    /** Stats row */
+    stats?: OutputStat[];
+    /** Artifact cards */
+    artifacts: ChainArtifact[];
+}
+/** Insight phase — highlighted body, metrics, references */
+export interface InsightPhase extends PhaseBase {
+    type: 'insight';
+    /** The insight body (supports HTML: p, strong, code, span.insight-highlight) */
+    content: string;
+    /** Optional confidence 0-1 */
+    confidence?: number;
+    /** Key metrics */
+    metrics?: InsightMetric[];
+    /** 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) */
+    query?: string;
+    /** Ordered list of reasoning phases */
+    phases: ChainPhase[];
+    /** Whether to show the collapsible thought-process toggle bar */
+    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 */
+    animated?: boolean;
+    /** Elapsed time string shown in toggle bar */
+    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 */
+    onQuestionClick?: (question: string) => void;
+    /** Suggested actions shown after the response (reuses AISuggestedAction) */
+    suggestedActions?: Array<{
+        label: string;
+        onClick?: () => void;
+    }>;
+    /** 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 */
+    onFeedback?: (positive: boolean) => void;
+    /** Callback for share action on the AI message */
+    onShare?: () => void;
+    /** Callback for download action on the AI message */
+    onDownload?: () => void;
+    /** Custom sx */
+    sx?: SxProps<Theme>;
+}
+//# sourceMappingURL=AIChainOfThought.types.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,20 @@
+/**
+ * @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.
+ */
+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.).
+ *
+ * See the "State Machine" section in `AIChainOfThought.tsx` for the full
+ * decision table.
+ *
+ * This function is pure and side-effect-free — safe to call during render.
+ */
+export declare function derivePhaseStatus(phase: ChainPhase): PhaseStatus;
+//# sourceMappingURL=AIChainOfThought.utils.d.ts.map

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

@@ -0,0 +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"}

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

@@ -25,7 +25,7 @@ import { SxProps, Theme } from '@mui/material';
 export type MessageRole = 'user' | 'assistant';
 /**
  * @deprecated Use `AIMessage` instead for rendering AI responses.
- * AIChatMessage duplicates AIMessage functionality and will be removed in a future release.
+ * AIChatMessage duplicates AIMessage functionality and will be removed in v3.0.0.
  *
  * Migration:
  * ```tsx
@@ -81,7 +81,7 @@ export interface AIChatMessageProps {
  *
  * Vertical rhythm is controlled by parent container spacing.
  */
-export declare const AIChatMessage: React.FC<AIChatMessageProps>;
+export declare const AIChatMessage: React.ForwardRefExoticComponent<AIChatMessageProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AIChatInput component.
  */
@@ -110,7 +110,7 @@ export interface AIChatInputProps {
 /**
  * AI Chat Input - Input field for chat messages with send and voice buttons.
  */
-export declare const AIChatInput: React.FC<AIChatInputProps>;
+export declare const AIChatInput: React.ForwardRefExoticComponent<AIChatInputProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AITypingIndicator component.
  */
@@ -123,7 +123,7 @@ export interface AITypingIndicatorProps {
 /**
  * AI Typing Indicator - Shows when AI is generating a response.
  */
-export declare const AITypingIndicator: React.FC<AITypingIndicatorProps>;
+export declare const AITypingIndicator: React.ForwardRefExoticComponent<AITypingIndicatorProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AIQuickReply component.
  */
@@ -138,5 +138,5 @@ export interface AIQuickReplyProps {
 /**
  * AI Quick Reply - Suggested quick reply options.
  */
-export declare const AIQuickReply: React.FC<AIQuickReplyProps>;
+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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"}

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

@@ -45,7 +45,7 @@ export interface AIContainerProps {
 /**
  * AI Container - Wrapper for AI content with optional header.
  */
-export declare const AIContainer: React.FC<AIContainerProps>;
+export declare const AIContainer: React.ForwardRefExoticComponent<AIContainerProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AIExpandableSection component.
  */
@@ -70,7 +70,7 @@ export interface AIExpandableSectionProps {
 /**
  * AI Expandable Section - Collapsible content section.
  */
-export declare const AIExpandableSection: React.FC<AIExpandableSectionProps>;
+export declare const AIExpandableSection: React.ForwardRefExoticComponent<AIExpandableSectionProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * Props for AIPersonaCard component.
  */
@@ -93,5 +93,5 @@ export interface AIPersonaCardProps {
 /**
  * AI Persona Card - Card for selecting AI personas/agents.
  */
-export declare const AIPersonaCard: React.FC<AIPersonaCardProps>;
+export declare const AIPersonaCard: React.ForwardRefExoticComponent<AIPersonaCardProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIContainer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AIContainer.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EASL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAUvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA0DlD,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CA+ElE,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2GtD,CAAC"}
+{"version":3,"file":"AIContainer.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EASL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAUvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,yFAwDtB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,iGA2E/B,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,2FAyGzB,CAAC"}