@trinityui/design-system 1.0.3 → 1.0.5

package/dist/accessibility.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Trinity Accessibility Utilities
+ * Helpers for building accessible components
+ *
+ * @module accessibility
+ */
+export interface UseFocusTrapOptions {
+    /** Whether the focus trap is active */
+    enabled?: boolean;
+    /** Initial element to focus (selector or element) */
+    initialFocus?: string | HTMLElement | null;
+    /** Element to return focus to when trap is deactivated */
+    returnFocus?: boolean;
+    /** Whether to include tab navigation wrapping */
+    wrapFocus?: boolean;
+}
+export interface UseFocusTrapReturn {
+    /** Ref to attach to the container element */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** Activate the focus trap */
+    activate: () => void;
+    /** Deactivate the focus trap */
+    deactivate: () => void;
+    /** Whether the trap is currently active */
+    isActive: boolean;
+}
+/**
+ * Hook to trap focus within a container element.
+ * Useful for modals, dialogs, and dropdown menus.
+ */
+export declare const useFocusTrap: ({ enabled, initialFocus, returnFocus, wrapFocus, }?: UseFocusTrapOptions) => UseFocusTrapReturn;
+/**
+ * Hook to detect user's reduced motion preference.
+ * Use this to disable animations for users who have requested reduced motion.
+ */
+export declare const useReducedMotion: () => boolean;
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+export interface SkipLinkProps {
+    /** Target element ID to skip to */
+    targetId: string;
+    /** Link text */
+    label?: string;
+    /** Custom styles */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Skip Link - Provides keyboard users a way to skip navigation.
+ * Should be the first focusable element on the page.
+ */
+export declare const SkipLink: React.FC<SkipLinkProps>;
+export interface UseAriaLiveOptions {
+    /** Politeness level */
+    politeness?: 'polite' | 'assertive' | 'off';
+    /** Whether the region is atomic */
+    atomic?: boolean;
+    /** Relevance filter */
+    relevant?: 'additions' | 'removals' | 'text' | 'all';
+}
+export interface UseAriaLiveReturn {
+    /** Announce a message */
+    announce: (message: string) => void;
+    /** Clear the current announcement */
+    clear: () => void;
+    /** Current message */
+    message: string;
+    /** ARIA attributes to spread */
+    ariaProps: {
+        role: 'status' | 'alert';
+        'aria-live': 'polite' | 'assertive' | 'off';
+        'aria-atomic': boolean;
+        'aria-relevant'?: 'additions' | 'removals' | 'text' | 'all';
+    };
+}
+/**
+ * Hook for managing ARIA live regions.
+ * Useful for announcing dynamic content changes to screen readers.
+ */
+export declare const useAriaLive: ({ politeness, atomic, relevant, }?: UseAriaLiveOptions) => UseAriaLiveReturn;
+export interface VisuallyHiddenProps {
+    /** Content to hide visually but keep accessible */
+    children: React.ReactNode;
+    /** HTML element to render as */
+    as?: React.ElementType;
+}
+/**
+ * Visually Hidden - Hides content visually while keeping it accessible.
+ * Useful for providing additional context to screen readers.
+ */
+export declare const VisuallyHidden: React.FC<VisuallyHiddenProps>;
+export type NavigationDirection = 'horizontal' | 'vertical' | 'both';
+export interface UseRovingTabIndexOptions {
+    /** List of item refs */
+    items: React.RefObject<HTMLElement | null>[];
+    /** Current focused index */
+    currentIndex?: number;
+    /** Navigation direction */
+    direction?: NavigationDirection;
+    /** Whether navigation wraps */
+    wrap?: boolean;
+    /** Callback when index changes */
+    onIndexChange?: (index: number) => void;
+}
+export interface UseRovingTabIndexReturn {
+    /** Current focused index */
+    focusedIndex: number;
+    /** Set focused index */
+    setFocusedIndex: (index: number) => void;
+    /** Key down handler to attach to container */
+    handleKeyDown: (event: React.KeyboardEvent) => void;
+    /** Get tabindex for an item */
+    getTabIndex: (index: number) => 0 | -1;
+}
+/**
+ * Hook for implementing roving tabindex keyboard navigation.
+ * Useful for lists, tabs, and other navigable components.
+ */
+export declare const useRovingTabIndex: ({ items, currentIndex, direction, wrap, onIndexChange, }: UseRovingTabIndexOptions) => UseRovingTabIndexReturn;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/accessibility.d.ts.map

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

package/dist/assets/index.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Trinity Design System - Asset Registry (Internal/Storybook Use Only)
+ *
+ * This module provides programmatic access to Trinity brand assets for
+ * Storybook documentation. As of v1.2.0, these assets are NOT exported
+ * from the npm package due to bundle size concerns (80MB+ of images).
+ *
+ * For production use, download assets from Storybook and add them to
+ * your project's public folder.
+ *
+ * @internal
+ * @example
+ * ```tsx
+ * // In your app, copy assets to public folder and reference directly:
+ * <img src="/assets/icons/gradient-ai.svg" alt="AI Icon" />
+ * <div style={{ backgroundImage: `url(/assets/backgrounds/smooth-abstract-1.jpg)` }} />
+ * <div style={{ backgroundImage: `url(/assets/gradients/light-1.png)` }} />
+ * ```
+ */
+export declare const gradientIcons: {
+    readonly benefits: string;
+    readonly bigQuoteMark: string;
+    readonly careersSmaller: string;
+    readonly combined: string;
+    readonly culture: string;
+    readonly focus: string;
+    readonly growth: string;
+    readonly ai: string;
+    readonly brandDev: string;
+    readonly commsInsights: string;
+    readonly comms: string;
+    readonly custEngagement: string;
+    readonly customer: string;
+    readonly insights: string;
+    readonly intelligence: string;
+    readonly launch1: string;
+    readonly launch: string;
+    readonly loss: string;
+    readonly marketAccess: string;
+    readonly marketResearch: string;
+    readonly medical: string;
+    readonly patientHcp: string;
+    readonly perfTracking: string;
+    readonly perf: string;
+    readonly portfolio: string;
+    readonly pricing: string;
+    readonly realWorld: string;
+    readonly strategy: string;
+    readonly impactSmaller: string;
+    readonly inclusionSmaller: string;
+    readonly leadershipSmaller: string;
+    readonly mindset: string;
+    readonly puzzle: string;
+    readonly rightThing: string;
+    readonly supportive: string;
+    readonly together: string;
+    readonly voices: string;
+};
+export type GradientIconName = keyof typeof gradientIcons;
+/** Gradient icon metadata for documentation */
+export declare const gradientIconMeta: Record<GradientIconName, {
+    label: string;
+    category: string;
+}>;
+export declare const backgroundImages: {
+    readonly smoothAbstract: readonly [string, string, string, string, string, string, string, string, string, string, string, string, string, string];
+    readonly technologyHuman: readonly [string, string, string, string, string, string, string, string, string, string, string, string, string];
+};
+export type BackgroundCategory = keyof typeof backgroundImages;
+/** Background image metadata */
+export declare const backgroundImageMeta: {
+    readonly smoothAbstract: {
+        readonly label: "Smooth Abstract";
+        readonly description: "Soft, flowing abstract backgrounds with gradient effects";
+        readonly count: 14;
+    };
+    readonly technologyHuman: {
+        readonly label: "Technology & Human";
+        readonly description: "Backgrounds featuring technology and human elements";
+        readonly count: 13;
+    };
+};
+export declare const brandGradients: {
+    readonly light: readonly [string, string, string, string, string, string, string, string, string, string];
+    readonly dark: readonly [string, string, string, string, string, string, string, string];
+};
+export type GradientTheme = keyof typeof brandGradients;
+/** Brand gradient metadata */
+export declare const brandGradientMeta: {
+    readonly light: {
+        readonly label: "Light Brand Gradients";
+        readonly description: "Trinity brand gradients optimized for light mode interfaces";
+        readonly count: 10;
+    };
+    readonly dark: {
+        readonly label: "Dark Brand Gradients";
+        readonly description: "Trinity brand gradients optimized for dark mode interfaces";
+        readonly count: 8;
+    };
+};
+/** Get all asset URLs for bulk download */
+export declare const getAllAssetUrls: () => {
+    gradientIcons: {
+        name: string;
+        url: string;
+        filename: string;
+    }[];
+    smoothAbstract: {
+        name: string;
+        url: string;
+        filename: string;
+    }[];
+    technologyHuman: {
+        name: string;
+        url: string;
+        filename: string;
+    }[];
+    lightGradients: {
+        name: string;
+        url: string;
+        filename: string;
+    }[];
+    darkGradients: {
+        name: string;
+        url: string;
+        filename: string;
+    }[];
+};
+declare const _default: {
+    gradientIcons: {
+        readonly benefits: string;
+        readonly bigQuoteMark: string;
+        readonly careersSmaller: string;
+        readonly combined: string;
+        readonly culture: string;
+        readonly focus: string;
+        readonly growth: string;
+        readonly ai: string;
+        readonly brandDev: string;
+        readonly commsInsights: string;
+        readonly comms: string;
+        readonly custEngagement: string;
+        readonly customer: string;
+        readonly insights: string;
+        readonly intelligence: string;
+        readonly launch1: string;
+        readonly launch: string;
+        readonly loss: string;
+        readonly marketAccess: string;
+        readonly marketResearch: string;
+        readonly medical: string;
+        readonly patientHcp: string;
+        readonly perfTracking: string;
+        readonly perf: string;
+        readonly portfolio: string;
+        readonly pricing: string;
+        readonly realWorld: string;
+        readonly strategy: string;
+        readonly impactSmaller: string;
+        readonly inclusionSmaller: string;
+        readonly leadershipSmaller: string;
+        readonly mindset: string;
+        readonly puzzle: string;
+        readonly rightThing: string;
+        readonly supportive: string;
+        readonly together: string;
+        readonly voices: string;
+    };
+    gradientIconMeta: Record<"focus" | "benefits" | "bigQuoteMark" | "careersSmaller" | "combined" | "culture" | "growth" | "ai" | "brandDev" | "commsInsights" | "comms" | "custEngagement" | "customer" | "insights" | "intelligence" | "launch1" | "launch" | "loss" | "marketAccess" | "marketResearch" | "medical" | "patientHcp" | "perfTracking" | "perf" | "portfolio" | "pricing" | "realWorld" | "strategy" | "impactSmaller" | "inclusionSmaller" | "leadershipSmaller" | "mindset" | "puzzle" | "rightThing" | "supportive" | "together" | "voices", {
+        label: string;
+        category: string;
+    }>;
+    backgroundImages: {
+        readonly smoothAbstract: readonly [string, string, string, string, string, string, string, string, string, string, string, string, string, string];
+        readonly technologyHuman: readonly [string, string, string, string, string, string, string, string, string, string, string, string, string];
+    };
+    backgroundImageMeta: {
+        readonly smoothAbstract: {
+            readonly label: "Smooth Abstract";
+            readonly description: "Soft, flowing abstract backgrounds with gradient effects";
+            readonly count: 14;
+        };
+        readonly technologyHuman: {
+            readonly label: "Technology & Human";
+            readonly description: "Backgrounds featuring technology and human elements";
+            readonly count: 13;
+        };
+    };
+    brandGradients: {
+        readonly light: readonly [string, string, string, string, string, string, string, string, string, string];
+        readonly dark: readonly [string, string, string, string, string, string, string, string];
+    };
+    brandGradientMeta: {
+        readonly light: {
+            readonly label: "Light Brand Gradients";
+            readonly description: "Trinity brand gradients optimized for light mode interfaces";
+            readonly count: 10;
+        };
+        readonly dark: {
+            readonly label: "Dark Brand Gradients";
+            readonly description: "Trinity brand gradients optimized for dark mode interfaces";
+            readonly count: 8;
+        };
+    };
+    getAllAssetUrls: () => {
+        gradientIcons: {
+            name: string;
+            url: string;
+            filename: string;
+        }[];
+        smoothAbstract: {
+            name: string;
+            url: string;
+            filename: string;
+        }[];
+        technologyHuman: {
+            name: string;
+            url: string;
+            filename: string;
+        }[];
+        lightGradients: {
+            name: string;
+            url: string;
+            filename: string;
+        }[];
+        darkGradients: {
+            name: string;
+            url: string;
+            filename: string;
+        }[];
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA4CH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsChB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE1D,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAsC1F,CAAC;AAuCF,eAAO,MAAM,gBAAgB;;;CAgCnB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE/D,gCAAgC;AAChC,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAWtB,CAAC;AA8BX,eAAO,MAAM,cAAc;;;CAuBjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AAExD,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAWpB,CAAC;AAMX,2CAA2C;AAC3C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B1B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAnO8D,MAAM;kBAAY,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsOzF,wBAQE"}

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

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview AIActions component.
+ * @module components/AI/AIActions
+ * AI Action Components
+ * Components for AI actions: Suggested Actions, Circular Actions
+ *
+ * Icons used:
+ * - forward: Arrow icon for list-style suggested actions (matches screenshot design)
+ * - chevron-right: Navigation indicator for card-style actions
+ * - sparkles: AI/generate actions
+ * - search: Search actions
+ * - close: Clear/dismiss actions
+ * @example
+ * ```tsx
+ *  import { AIActions } from '@trinityui/design-system';
+ *
+ *  <AIActions
+ *    label="Example"
+ *  />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AISuggestedAction component.
+ */
+export interface AISuggestedActionProps {
+    /** Action label */
+    label: string;
+    /** Action description (for card variant only) */
+    description?: string;
+    /** Icon name - defaults to 'forward' for list, varies for card */
+    icon?: string;
+    /** Click handler */
+    onClick?: () => void;
+    /** Whether action is disabled */
+    disabled?: boolean;
+    /** Variant - 'list' matches screenshot design with arrow icons */
+    variant?: 'default' | 'primary' | 'outlined' | 'list';
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Suggested Action - Actionable suggestion button.
+ *
+ * Variants:
+ * - list: Simple row with arrow icon (matches screenshot design)
+ * - default: Card style with icon container
+ * - primary: Filled primary style
+ * - outlined: Bordered style
+ */
+export declare const AISuggestedAction: React.FC<AISuggestedActionProps>;
+/**
+ * Props for AICircularAction component.
+ */
+export interface AICircularActionProps {
+    /** Tooltip label */
+    label: string;
+    /** Icon name - use approved icons: close, search, sparkles, etc. */
+    icon: string;
+    /** Click handler */
+    onClick?: () => void;
+    /** Whether action is disabled */
+    disabled?: boolean;
+    /** Size */
+    size?: 'small' | 'medium' | 'large';
+    /** Variant */
+    variant?: 'default' | 'primary' | 'gradient';
+    /** Whether to show badge */
+    showBadge?: boolean;
+    /** Badge content */
+    badgeContent?: React.ReactNode;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Circular Action - Circular action button with icon.
+ *
+ * Approved icons:
+ * - close: Clear/dismiss actions
+ * - search: Search actions
+ * - sparkles: AI/generate actions
+ * - refresh: Retry actions
+ * - copy: Copy to clipboard
+ */
+export declare const AICircularAction: React.FC<AICircularActionProps>;
+/**
+ * Props for AIActionsGroup component.
+ */
+export interface AIActionsGroupProps {
+    /** List of actions */
+    actions: AISuggestedActionProps[];
+    /** Layout direction */
+    direction?: 'row' | 'column';
+    /** Spacing between actions */
+    spacing?: number;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Actions Group - Group of suggested actions.
+ */
+export declare const AIActionsGroup: React.FC<AIActionsGroupProps>;
+//# sourceMappingURL=AIActions.d.ts.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview AIAvatar component.
+ * @module components/AI/AIAvatar
+ * AI Avatar Component
+ * Visual representation of the AI assistant
+ * @example
+ * ```tsx
+ *  import { AIAvatar } from '@trinityui/design-system';
+ *
+ *  <AIAvatar />
+ *  ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+/**
+ * Props for AIAvatar component.
+ */
+export interface AIAvatarProps {
+    /** Size of the avatar */
+    size?: 'xs' | 'small' | 'medium' | 'large';
+    /** Whether to show animated pulse */
+    animated?: boolean;
+    /** Custom icon name */
+    icon?: string;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Avatar - Visual representation of the AI assistant.
+ */
+export declare const AIAvatar: React.FC<AIAvatarProps>;
+//# sourceMappingURL=AIAvatar.d.ts.map

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

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

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

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview AIChat component.
+ * @module components/AI/AIChat
+ * AI Chat Components
+ * Components for AI chat interfaces: Message, Input, Typing Indicator, Quick Reply
+ *
+ * These components are used by InsightEnginePanel and can also be used
+ * independently for custom AI chat implementations.
+ *
+ * @note AIChatMessage is deprecated. Use AIMessage for new implementations.
+ * AIChatInput, AITypingIndicator, and AIQuickReply remain canonical.
+ *
+ * @example
+ * ```tsx
+ *  import { AIMessage } from '@trinityui/design-system';
+ *
+ *  <AIMessage
+ *    content={<div />}
+ *    role={undefined as never}
+ *  />
+ *  ```
+ */
+import React from 'react';
+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.
+ *
+ * Migration:
+ * ```tsx
+ * // Before (deprecated)
+ * <AIChatMessage role="assistant" content="Hello" />
+ *
+ * // After (recommended)
+ * <AIMessage response={{ id: '1', blocks: [{ type: 'text', content: 'Hello' }] }} />
+ * ```
+ */
+export interface AIChatMessageProps {
+    /** Message content */
+    content: React.ReactNode;
+    /** Role of the message sender */
+    role: MessageRole;
+    /** Timestamp */
+    timestamp?: string;
+    /** Whether the message is loading */
+    isLoading?: boolean;
+    /** User avatar/initials for user messages */
+    userAvatar?: string | React.ReactNode;
+    /** Custom AI avatar */
+    aiAvatar?: React.ReactNode;
+    /** User initials for default avatar */
+    userInitials?: string;
+    /** Whether to show copy button */
+    showCopy?: boolean;
+    /** Whether to show feedback buttons */
+    showFeedback?: boolean;
+    /** Whether to show share button */
+    showShare?: boolean;
+    /** Whether to show regenerate button */
+    showRegenerate?: boolean;
+    /** Copy callback */
+    onCopy?: () => void;
+    /** Feedback callback */
+    onFeedback?: (positive: boolean) => void;
+    /** Share callback */
+    onShare?: () => void;
+    /** Regenerate callback */
+    onRegenerate?: () => void;
+    /** Additional content after message (sources, related questions, etc.) */
+    children?: React.ReactNode;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Chat Message - Individual message in a chat conversation.
+ *
+ * Structure:
+ * - User messages: Right-aligned with bubble and avatar
+ * - Assistant messages: Left-aligned with avatar, content, actions, and children
+ *
+ * Vertical rhythm is controlled by parent container spacing.
+ */
+export declare const AIChatMessage: React.FC<AIChatMessageProps>;
+/**
+ * Props for AIChatInput component.
+ */
+export interface AIChatInputProps {
+    /** Placeholder text */
+    placeholder?: string;
+    /** Current value */
+    value?: string;
+    /** Change handler */
+    onChange?: (value: string) => void;
+    /** Submit handler */
+    onSubmit?: (value: string) => void;
+    /** Whether input is disabled */
+    disabled?: boolean;
+    /** Whether to show voice input button */
+    showVoiceInput?: boolean;
+    /** Voice input callback */
+    onVoiceInput?: () => void;
+    /** Whether AI is currently generating */
+    isGenerating?: boolean;
+    /** Stop generation callback */
+    onStopGeneration?: () => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Chat Input - Input field for chat messages with send and voice buttons.
+ */
+export declare const AIChatInput: React.FC<AIChatInputProps>;
+/**
+ * Props for AITypingIndicator component.
+ */
+export interface AITypingIndicatorProps {
+    /** Custom text */
+    text?: string;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Typing Indicator - Shows when AI is generating a response.
+ */
+export declare const AITypingIndicator: React.FC<AITypingIndicatorProps>;
+/**
+ * Props for AIQuickReply component.
+ */
+export interface AIQuickReplyProps {
+    /** List of quick reply options */
+    options: string[];
+    /** Selection handler */
+    onSelect: (option: string) => void;
+    /** Custom sx props */
+    sx?: SxProps<Theme>;
+}
+/**
+ * AI Quick Reply - Suggested quick reply options.
+ */
+export declare const AIQuickReply: React.FC<AIQuickReplyProps>;
+//# sourceMappingURL=AIChat.d.ts.map

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

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