@trinityui/design-system 1.0.2 → 1.0.4

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

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview AIContainer component.
+ * @module components/AI/AIContainer
+ * AI Container & Layout Components
+ * Container, Expandable Section, and Persona Card components
+ *
+ * These are wrapper components for AI content that provide
+ * consistent styling with the AI design tokens.
+ *
+ * @example
+ * ```tsx
+ *  import { AIContainer } from '@trinityui/design-system';
+ *
+ *  <AIContainer
+ *  >
+ *    <div>Example content</div>
+ *  </AIContainer>
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AIContainer component.
+ */
+export interface AIContainerProps {
+    /** Container title */
+    title?: string;
+    /** Container subtitle */
+    subtitle?: string;
+    /** Header actions */
+    headerActions?: React.ReactNode;
+    /** Whether to show AI avatar in header */
+    showAvatar?: boolean;
+    /** Container children */
+    children: React.ReactNode;
+    /** Whether container has border */
+    bordered?: boolean;
+    /** Whether container has background */
+    filled?: boolean;
+    /** Whether container has padding */
+    padded?: boolean;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Container - Wrapper for AI content with optional header.
+ */
+export declare const AIContainer: React.FC<AIContainerProps>;
+/**
+ * Props for AIExpandableSection component.
+ */
+export interface AIExpandableSectionProps {
+    /** Section title */
+    title: string;
+    /** Section subtitle */
+    subtitle?: string;
+    /** Leading icon */
+    icon?: string;
+    /** Section children */
+    children: React.ReactNode;
+    /** Default expanded state */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state */
+    expanded?: boolean;
+    /** Change handler */
+    onChange?: (expanded: boolean) => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Expandable Section - Collapsible content section.
+ */
+export declare const AIExpandableSection: React.FC<AIExpandableSectionProps>;
+/**
+ * Props for AIPersonaCard component.
+ */
+export interface AIPersonaCardProps {
+    /** Persona name */
+    name: string;
+    /** Persona description */
+    description?: string;
+    /** Persona avatar */
+    avatar?: React.ReactNode;
+    /** Persona capabilities */
+    capabilities?: string[];
+    /** Whether persona is selected */
+    selected?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Persona Card - Card for selecting AI personas/agents.
+ */
+export declare const AIPersonaCard: React.FC<AIPersonaCardProps>;
+//# sourceMappingURL=AIContainer.d.ts.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview AIExplainability component.
+ * @module components/AI/AIExplainability
+ * AI Explainability Component
+ * Provides details about AI-generated content
+ * @example
+ * ```tsx
+ *  import { AIExplainability } from '@trinityui/design-system';
+ *
+ *  <AIExplainability />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AIExplainability component.
+ */
+export interface AIExplainabilityProps {
+    /** Title/overview of the AI */
+    title?: string;
+    /** Description of what the AI does */
+    description?: string;
+    /** Model name or version */
+    modelName?: string;
+    /** Confidence score (0-100) */
+    confidence?: number;
+    /** Last updated date */
+    lastUpdated?: string;
+    /** Additional details */
+    details?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Action buttons */
+    actions?: Array<{
+        label: string;
+        onClick: () => void;
+    }>;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Explainability Content - Provides details about AI-generated content.
+ */
+export declare const AIExplainability: React.FC<AIExplainabilityProps>;
+//# sourceMappingURL=AIExplainability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIExplainability.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIExplainability.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA2C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQxF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;IACxD,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAmF5D,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview AILabel component.
+ * @module components/AI/AILabel
+ * AI Label Component
+ * Indicates AI-generated content and provides pathway to explainability
+ * @example
+ * ```tsx
+ *  import { AILabel } from '@trinityui/design-system';
+ *
+ *  <AILabel />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+export type AILabelSize = 'mini' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export type AILabelVariant = 'default' | 'inline';
+/**
+ * Props for AILabel component.
+ */
+export interface AILabelProps {
+    /** Size of the AI label */
+    size?: AILabelSize;
+    /** Variant of the AI label */
+    variant?: AILabelVariant;
+    /** Custom text (default: "AI") */
+    text?: string;
+    /** Whether to show explainability popover on click */
+    showPopover?: boolean;
+    /** Content for the explainability popover */
+    popoverContent?: React.ReactNode;
+    /** Whether the label is clickable */
+    clickable?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Label - Indicates AI-generated content and provides pathway to explainability.
+ * Use to mark any instance of AI in the interface.
+ */
+export declare const AILabel: React.FC<AILabelProps>;
+//# sourceMappingURL=AILabel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AILabel.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AILabel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAAwB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AA8BD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CAwH1C,CAAC"}

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

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview AIMessage component.
+ * @module components/AI/AIMessage
+ * AIMessage Component
+ * Visual wrapper for AI responses. Handles presentation concerns ONLY.
+ *
+ * SEPARATION OF CONCERNS:
+ * ┌─────────────────────────────────────────────────────────────────┐
+ * │ AIMessage (this component)                                      │
+ * │ ─────────────────────────────────────────────────────────────── │
+ * │ Responsibilities:                                               │
+ * │   • Avatar display                                              │
+ * │   • Message bubble/container styling                            │
+ * │   • Metadata (timestamp, sender info)                           │
+ * │   • Action buttons (copy, feedback, share, download)            │
+ * │   • Spacing and visual alignment                                │
+ * │                                                                 │
+ * │ Does NOT handle:                                                │
+ * │   • Block type detection                                        │
+ * │   • Content rendering logic                                     │
+ * │   • Voice/streaming state                                       │
+ * │   • Business logic                                              │
+ * ├─────────────────────────────────────────────────────────────────┤
+ * │ AIResponseRenderer (delegated)                                  │
+ * │ ─────────────────────────────────────────────────────────────── │
+ * │ Responsibilities:                                               │
+ * │   • Iterate over response.blocks                                │
+ * │   • Dispatch each block to type-specific renderer               │
+ * │   • Text, table, chart, image, form, actions                    │
+ * └─────────────────────────────────────────────────────────────────┘
+ *
+ * @example
+ * ```tsx
+ *  import { AIMessage } from '@trinityui/design-system';
+ *
+ *  <AIMessage />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+import { type AIResponse } from './types';
+/**
+ * Props for AIMessage component.
+ */
+export interface AIMessageProps {
+    /**
+     * AIResponse object to render (preferred API)
+     * When provided, AIResponseRenderer is used automatically
+     */
+    response?: AIResponse;
+    /**
+     * Legacy: Direct children content
+     * Use `response` prop instead for new implementations
+     */
+    children?: React.ReactNode;
+    /** Timestamp display */
+    timestamp?: string;
+    /** Custom AI avatar */
+    avatar?: React.ReactNode;
+    /** Show copy button */
+    showCopy?: boolean;
+    /** Show feedback buttons (thumbs up/down) */
+    showFeedback?: boolean;
+    /** Show share button */
+    showShare?: boolean;
+    /** Show download button */
+    showDownload?: boolean;
+    /** Copy callback */
+    onCopy?: () => void;
+    /** Feedback callback */
+    onFeedback?: (positive: boolean) => void;
+    /** Share callback */
+    onShare?: () => void;
+    /** Download callback */
+    onDownload?: () => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AIMessage - Visual wrapper for AI responses.
+ *
+ * This is a pure PRESENTATION component. It provides:
+ * - Avatar display
+ * - Timestamp
+ * - Action buttons (copy, feedback, share, download)
+ * - Consistent spacing and alignment
+ *
+ * Content rendering is delegated to AIResponseRenderer.
+ * AIMessage does NOT inspect or care about block types.
+ */
+export declare const AIMessage: React.FC<AIMessageProps>;
+export default AIMessage;
+//# sourceMappingURL=AIMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIMessage.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIMessage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAML,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAyK9C,CAAC;AAEF,eAAe,SAAS,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview AIRelatedQuestions component.
+ * @module components/AI/AIRelatedQuestions
+ * AI Related Questions Component
+ * Collapsible panel displaying related/follow-up questions with filled background surface
+ *
+ * @example
+ * ```tsx
+ *  import { AIRelatedQuestions } from '@trinityui/design-system';
+ *
+ *  <AIRelatedQuestions
+ *    questions="Example"
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AIRelatedQuestions component.
+ */
+export interface AIRelatedQuestionsProps {
+    /** List of related questions */
+    questions: string[];
+    /** Callback when a question is clicked */
+    onQuestionClick?: (question: string) => void;
+    /** Panel title */
+    title?: string;
+    /** Whether panel is initially expanded */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state */
+    expanded?: boolean;
+    /** Callback when expanded state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Empty state title when no questions */
+    emptyTitle?: string;
+    /** Empty state description */
+    emptyDescription?: string;
+    /** Show empty state instead of hiding */
+    showEmpty?: boolean;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Related Questions - Collapsible panel with clickable follow-up questions
+ * Features:
+ * - Filled background surface using semantic tokens
+ * - Left-aligned questions with arrow icons
+ * - Proper empty state with icon, title, and description
+ * - MUI List/ListItem for accessibility
+ */
+export declare const AIRelatedQuestions: React.FC<AIRelatedQuestionsProps>;
+export default AIRelatedQuestions;
+//# sourceMappingURL=AIRelatedQuestions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIRelatedQuestions.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIRelatedQuestions.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAWL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA2LhE,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview AIResponseRenderer component.
+ * @module components/AI/AIResponseRenderer
+ * AIResponseRenderer
+ * Renders AIResponse objects by iterating over blocks and dispatching to type-specific renderers.
+ *
+ * This is a pure rendering component with NO:
+ * - Layout styling (handled by parent)
+ * - AIMessage wrapper (that's a separate component)
+ * - Voice logic
+ * - Business logic
+ *
+ * Currently Supported Block Types:
+ * - text ✅
+ *
+ * Future Block Types (placeholders):
+ * - table 🔜
+ * - chart 🔜
+ * - image 🔜
+ * - form 🔜
+ * - actions 🔜
+ *
+ * @example
+ * ```tsx
+ *  import { AIResponseRenderer } from '@trinityui/design-system';
+ *
+ *  <AIResponseRenderer
+ *    response={undefined as never}
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { type AIResponse } from './types';
+/**
+ * Props for AIResponseRenderer component.
+ */
+export interface AIResponseRendererProps {
+    /** The AIResponse object to render */
+    response: AIResponse;
+    /** Gap between blocks (default: aiSpacing.sm) */
+    blockGap?: number;
+}
+/**
+ * AIResponseRenderer - Iterates over AIResponse blocks and renders each by type.
+ *
+ * Pure rendering logic only. No layout wrapper, no business logic.
+ */
+export declare const AIResponseRenderer: React.FC<AIResponseRendererProps>;
+export default AIResponseRenderer;
+//# sourceMappingURL=AIResponseRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIResponseRenderer.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIResponseRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,KAAK,UAAU,EAQhB,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,EAAE,UAAU,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA0BhE,CAAC;AAuGF,eAAe,kBAAkB,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview AISources component.
+ * @module components/AI/AISources
+ * AI Source Components
+ * Components for displaying AI source citations and references
+ * @example
+ * ```tsx
+ *  import { AISources } from '@trinityui/design-system';
+ *
+ *  <AISources
+ *    number={0}
+ *    title="Example"
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AISource component.
+ */
+export interface AISourceProps {
+    /** Source number */
+    number: number;
+    /** Source title */
+    title: string;
+    /** Source URL */
+    url?: string;
+    /** Source description/snippet */
+    description?: string;
+    /** Source type (webpage, document, etc.) */
+    type?: 'webpage' | 'document' | 'article' | 'video' | 'other';
+    /** Favicon URL */
+    favicon?: string;
+    /** Click handler */
+    onClick?: () => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Source - Individual source citation card.
+ */
+export declare const AISource: React.FC<AISourceProps>;
+/**
+ * Props for AISourcesSection component.
+ */
+export interface AISourcesSectionProps {
+    /** List of sources */
+    sources: Omit<AISourceProps, 'number'>[];
+    /** Section title */
+    title?: string;
+    /** Whether section is collapsible */
+    collapsible?: boolean;
+    /** Default expanded state */
+    defaultExpanded?: boolean;
+    /** Maximum sources to show initially (rest collapsed) */
+    maxVisible?: number;
+    /** Source click handler */
+    onSourceClick?: (index: number, source: Omit<AISourceProps, 'number'>) => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Sources Section - Collapsible section displaying source citations.
+ */
+export declare const AISourcesSection: React.FC<AISourcesSectionProps>;
+//# sourceMappingURL=AISources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AISources.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AISources.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAUL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAUvB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC9D,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAiI5C,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sBAAsB;IACtB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;IACzC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC/E,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAuF5D,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview AISourcesPanel component.
+ * @module components/AI/AISourcesPanel
+ * AI Sources Panel Components
+ * Collapsible sources accordion for displaying AI response citations
+ *
+ * These components provide a structured way to display sources with
+ * expandable categories and detail views.
+ *
+ * @example
+ * ```tsx
+ *  import { AISourcesPanel } from '@trinityui/design-system';
+ *
+ *  <AISourcesPanel
+ *    sources={[]}
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+export interface AISourceItem {
+    /** Unique identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional detail key-value pairs */
+    details?: Record<string, string>;
+}
+export interface AISourceCategory {
+    /** Unique identifier */
+    id: string;
+    /** Category name */
+    name: string;
+    /** Number of items in category */
+    count: number;
+    /** Optional expandable items */
+    items?: AISourceItem[];
+}
+/**
+ * Props for AISourcesPanel component.
+ */
+export interface AISourcesPanelProps {
+    /** List of source categories */
+    sources: AISourceCategory[];
+    /** Panel title */
+    title?: string;
+    /** Whether panel is initially expanded */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state */
+    expanded?: boolean;
+    /** Callback when expanded state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Props for AISourceCategoryItem component.
+ */
+export interface AISourceCategoryItemProps {
+    /** Source category data */
+    category: AISourceCategory;
+    /** Index number to display */
+    index: number;
+    /** Whether category is expanded */
+    isExpanded: boolean;
+    /** Toggle expansion callback */
+    onToggle: () => void;
+    /** Currently selected item */
+    selectedItem: AISourceItem | null;
+    /** Callback when item is selected */
+    onSelectItem: (item: AISourceItem | null) => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Sources Panel - Collapsible panel displaying source citations
+ */
+export declare const AISourcesPanel: React.FC<AISourcesPanelProps>;
+/**
+ * AI Source Category Item - Individual collapsible source category
+ */
+export declare const AISourceCategoryItem: React.FC<AISourceCategoryItemProps>;
+export default AISourcesPanel;
+//# sourceMappingURL=AISourcesPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AISourcesPanel.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AISourcesPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAQL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAQvB,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,qCAAqC;IACrC,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiFxD,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAgKpE,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview AITextBlock component.
+ * @module components/AI/AITextBlock
+ * AITextBlock
+ * Renders text content within AI responses with markdown support.
+ *
+ * Responsibilities:
+ * - Render markdown or plain text
+ * - Use existing MUI typography components
+ * - Respect spacing and readability
+ * - Accessible by default (semantic HTML)
+ *
+ * Constraints:
+ * - No custom styling
+ * - No inline styles
+ * - Semantic tokens only
+ *
+ * @example
+ * ```tsx
+ *  import { AITextBlock } from '@trinityui/design-system';
+ *
+ *  <AITextBlock
+ *    content="Example"
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+import { type TextBlock } from './types';
+/**
+ * Props for AITextBlock component.
+ */
+export interface AITextBlockProps {
+    /** Text content to render */
+    content: string;
+    /** Whether to parse as markdown */
+    markdown?: boolean;
+    /** Semantic variant for styling */
+    variant?: TextBlock['variant'];
+    /** Optional block ID for anchoring */
+    id?: string;
+    /** Custom sx props (use sparingly) */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AITextBlock - Renders text content with optional markdown parsing.
+ *
+ * Uses semantic HTML elements for accessibility:
+ * - body → <p>
+ * - heading → <h3>
+ * - caption → <p> with caption styling
+ * - quote → <blockquote>
+ */
+export declare const AITextBlock: React.FC<AITextBlockProps>;
+export default AITextBlock;
+//# sourceMappingURL=AITextBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AITextBlock.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AITextBlock.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAyB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAOzC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,sCAAsC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA4BlD,CAAC;AAomBF,eAAe,WAAW,CAAC"}