@trinityui/design-system 1.0.3 → 1.0.5

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

@@ -0,0 +1,312 @@
+/**
+ * AI Response Schema
+ * Canonical types for AI response architecture.
+ *
+ * Design Principles:
+ * 1. HETEROGENEOUS: A single response can contain mixed content types
+ * 2. ORDERED: Block order is preserved and meaningful
+ * 3. EXTENSIBLE: New block types can be added without breaking changes
+ * 4. TYPED: Discriminated union ensures type safety per block type
+ *
+ * Architecture:
+ * ```
+ * AIResponse
+ *   └── blocks: AIResponseBlock[]
+ *         ├── TextBlock      (type: 'text')
+ *         ├── TableBlock     (type: 'table')     [future]
+ *         ├── ChartBlock     (type: 'chart')     [future]
+ *         ├── ImageBlock     (type: 'image')     [future]
+ *         ├── FormBlock      (type: 'form')      [future]
+ *         └── ActionsBlock   (type: 'actions')   [future]
+ * ```
+ *
+ * Why This Structure:
+ * - Discriminated unions (`type` field) enable exhaustive switch/case handling
+ * - Array preserves order without complex ordering logic
+ * - Each block is self-contained with its own props
+ * - Metadata at response level (id, timestamp) separate from content
+ * - Sources/citations link to specific blocks via optional `blockId`
+ *
+ * @example
+ * ```tsx
+ * const response: AIResponse = {
+ *   id: 'resp-123',
+ *   blocks: [
+ *     { type: 'text', content: 'Here is the analysis:' },
+ *     { type: 'table', columns: [...], rows: [...] },
+ *     { type: 'text', content: 'Key takeaway: growth is 14% YoY.' },
+ *   ],
+ *   metadata: {
+ *     model: 'gpt-4',
+ *     timestamp: '2026-01-10T10:30:00Z',
+ *     processingTime: 1250,
+ *   },
+ * };
+ * ```
+ */
+/**
+ * Base interface for all blocks.
+ * Every block has a `type` discriminator and optional `id` for targeting.
+ */
+export interface BaseBlock {
+    /** Discriminator for block type */
+    type: string;
+    /** Optional unique identifier for this block (for citations, anchoring) */
+    id?: string;
+}
+/**
+ * Text Block
+ * Renders as paragraph text, optionally with markdown formatting.
+ *
+ * This is the foundational block type - all AI responses will have at least one.
+ */
+export interface TextBlock extends BaseBlock {
+    type: 'text';
+    /** The text content */
+    content: string;
+    /** Whether to render as markdown (default: false) */
+    markdown?: boolean;
+    /** Optional semantic role for styling */
+    variant?: 'body' | 'caption' | 'heading' | 'quote';
+}
+/**
+ * Table Block [FUTURE]
+ * @reserved - Schema defined but rendering not yet implemented
+ */
+export interface TableBlock extends BaseBlock {
+    type: 'table';
+    columns: Array<{
+        key: string;
+        label: string;
+        align?: 'left' | 'center' | 'right';
+        width?: number | string;
+    }>;
+    rows: Array<Record<string, unknown>>;
+    title?: string;
+    compact?: boolean;
+    sortable?: boolean;
+}
+/**
+ * Chart Block [FUTURE]
+ * @reserved - Schema defined but rendering not yet implemented
+ */
+export interface ChartBlock extends BaseBlock {
+    type: 'chart';
+    chartType: 'bar' | 'line' | 'pie' | 'area' | 'donut';
+    data: Array<Record<string, unknown>>;
+    series: Array<{
+        dataKey: string;
+        name?: string;
+        color?: string;
+    }>;
+    xAxis?: {
+        dataKey: string;
+        label?: string;
+    };
+    yAxis?: {
+        label?: string;
+    };
+    title?: string;
+    height?: number;
+}
+/**
+ * Image Block [FUTURE]
+ * @reserved - Schema defined but rendering not yet implemented
+ */
+export interface ImageBlock extends BaseBlock {
+    type: 'image';
+    src: string;
+    alt: string;
+    caption?: string;
+    maxWidth?: number | string;
+}
+/**
+ * Form Block [FUTURE]
+ * @reserved - Schema defined but rendering not yet implemented
+ */
+export interface FormBlock extends BaseBlock {
+    type: 'form';
+    fields: Array<{
+        name: string;
+        label: string;
+        type: 'text' | 'number' | 'select' | 'checkbox' | 'textarea';
+        value?: unknown;
+        options?: Array<{
+            value: string;
+            label: string;
+        }>;
+        placeholder?: string;
+        required?: boolean;
+    }>;
+    submitLabel?: string;
+}
+/**
+ * Actions Block [FUTURE]
+ * @reserved - Schema defined but rendering not yet implemented
+ */
+export interface ActionsBlock extends BaseBlock {
+    type: 'actions';
+    items: Array<{
+        id?: string;
+        label: string;
+        icon?: string;
+        variant?: 'text' | 'outlined' | 'contained';
+        color?: 'primary' | 'secondary' | 'inherit';
+        href?: string;
+        disabled?: boolean;
+    }>;
+    direction?: 'row' | 'column';
+}
+/**
+ * AIResponseBlock - Discriminated union of all supported block types.
+ *
+ * Use `block.type` to narrow the type in switch/case or conditionals.
+ *
+ * @example
+ * ```tsx
+ * function renderBlock(block: AIResponseBlock) {
+ *   switch (block.type) {
+ *     case 'text':
+ *       return <TextRenderer content={block.content} />;
+ *     case 'table':
+ *       return <TableRenderer columns={block.columns} rows={block.rows} />;
+ *     // ... exhaustive handling
+ *   }
+ * }
+ * ```
+ */
+export type AIResponseBlock = TextBlock | TableBlock | ChartBlock | ImageBlock | FormBlock | ActionsBlock;
+/**
+ * Extract block type string literals for type guards
+ */
+export type AIResponseBlockType = AIResponseBlock['type'];
+/**
+ * Metadata about the AI response generation.
+ */
+export interface AIResponseMetadata {
+    /** Model used to generate response */
+    model?: string;
+    /** ISO timestamp of response generation */
+    timestamp?: string;
+    /** Processing time in milliseconds */
+    processingTime?: number;
+    /** Token usage */
+    tokens?: {
+        prompt?: number;
+        completion?: number;
+        total?: number;
+    };
+    /** Confidence score (0-1) */
+    confidence?: number;
+}
+/**
+ * Source citation for response content.
+ */
+export interface AIResponseSource {
+    /** Unique identifier */
+    id: string;
+    /** Source title/name */
+    title: string;
+    /** Source URL */
+    url?: string;
+    /** Source type */
+    type?: 'document' | 'webpage' | 'database' | 'api' | 'other';
+    /** Relevance score (0-1) */
+    relevance?: number;
+    /** Which block(s) this source supports */
+    blockIds?: string[];
+    /** Snippet/excerpt from source */
+    excerpt?: string;
+}
+/**
+ * AIResponse - Canonical schema for a complete AI response.
+ *
+ * This is the top-level type that wraps all response content.
+ * Use this as the contract between AI service and UI components.
+ *
+ * Key Design Decisions:
+ * 1. `blocks` is an ordered array - sequence matters for narrative
+ * 2. `metadata` is optional - not all responses need it
+ * 3. `sources` are at response level but can reference specific blocks
+ * 4. `relatedQuestions` are response-level suggestions
+ *
+ * @example
+ * ```tsx
+ * // Simple text response
+ * const simple: AIResponse = {
+ *   id: 'r1',
+ *   blocks: [{ type: 'text', content: 'Hello!' }],
+ * };
+ *
+ * // Complex multi-block response
+ * const complex: AIResponse = {
+ *   id: 'r2',
+ *   blocks: [
+ *     { type: 'text', id: 'intro', content: 'Analysis summary:' },
+ *     { type: 'chart', id: 'chart1', chartType: 'bar', data: [...] },
+ *     { type: 'text', content: 'The data shows growth.' },
+ *   ],
+ *   sources: [
+ *     { id: 's1', title: 'Q4 Report', blockIds: ['chart1'] },
+ *   ],
+ *   relatedQuestions: ['What about Q3?', 'Show monthly breakdown'],
+ *   metadata: { model: 'gpt-4', timestamp: '2026-01-10T10:30:00Z' },
+ * };
+ * ```
+ */
+export interface AIResponse {
+    /** Unique identifier for this response */
+    id: string;
+    /** Ordered array of content blocks */
+    blocks: AIResponseBlock[];
+    /** Sources/citations for the response content */
+    sources?: AIResponseSource[];
+    /** Suggested follow-up questions */
+    relatedQuestions?: string[];
+    /** Response generation metadata */
+    metadata?: AIResponseMetadata;
+    /** Error state (if response failed) */
+    error?: {
+        code: string;
+        message: string;
+        recoverable?: boolean;
+    };
+}
+/**
+ * Type guard to check if a block is a TextBlock
+ */
+export declare function isTextBlock(block: AIResponseBlock): block is TextBlock;
+/**
+ * Type guard to check if a block is a TableBlock
+ */
+export declare function isTableBlock(block: AIResponseBlock): block is TableBlock;
+/**
+ * Type guard to check if a block is a ChartBlock
+ */
+export declare function isChartBlock(block: AIResponseBlock): block is ChartBlock;
+/**
+ * Type guard to check if a block is an ImageBlock
+ */
+export declare function isImageBlock(block: AIResponseBlock): block is ImageBlock;
+/**
+ * Type guard to check if a block is a FormBlock
+ */
+export declare function isFormBlock(block: AIResponseBlock): block is FormBlock;
+/**
+ * Type guard to check if a block is an ActionsBlock
+ */
+export declare function isActionsBlock(block: AIResponseBlock): block is ActionsBlock;
+/**
+ * Helper type to create a response with only text blocks
+ */
+export type TextOnlyResponse = Omit<AIResponse, 'blocks'> & {
+    blocks: TextBlock[];
+};
+/**
+ * Helper type for response building
+ */
+export type PartialAIResponse = Partial<AIResponse> & {
+    id: string;
+    blocks: AIResponseBlock[];
+};
+//# sourceMappingURL=response.d.ts.map

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

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

package/dist/components/AppLayout/AIFab.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview AIFab component.
+ * @module components/AppLayout/AIFab
+ * AIFab Component
+ * Floating Action Button for launching the AI chat panel
+ * @example
+ * ```tsx
+ *  import { AIFab } from '@trinityui/design-system';
+ *
+ *  <AIFab />
+ *  ```
+ */
+import React from 'react';
+/**
+ * Props for AIFab component.
+ */
+export interface AIFabProps {
+    /** Whether the AI panel is currently open */
+    open?: boolean;
+    /** Callback when the FAB is clicked */
+    onClick?: () => void;
+    /** Position of the FAB */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Custom offset from the edge (in pixels) */
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    /** Whether to show a badge (e.g., for notifications) */
+    showBadge?: boolean;
+    /** Badge content (number or dot) */
+    badgeContent?: number | string;
+    /** Size of the FAB */
+    size?: 'small' | 'medium' | 'large';
+    /** Tooltip text */
+    tooltip?: string;
+    /** Whether the FAB is disabled */
+    disabled?: boolean;
+    /** Custom z-index */
+    zIndex?: number;
+}
+/**
+ * AIFab - Floating Action Button for launching AI chat
+ *
+ * A beautifully styled FAB with Trinity AI branding that can be used
+ * to open the InsightEnginePanel from anywhere in the application.
+ */
+export declare const AIFab: React.FC<AIFabProps>;
+export default AIFab;
+//# sourceMappingURL=AIFab.d.ts.map

package/dist/components/AppLayout/AIFab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIFab.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/AIFab.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IACrE,8CAA8C;IAC9C,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,sBAAsB;IACtB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CA6FtC,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/components/AppLayout/AIFabLayout.deprecated.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview AIFabLayout.deprecated component.
+ * @module components/AppLayout/AIFabLayout.deprecated
+ * AIFabLayout - DEPRECATED
+ *
+ * @deprecated Use `AppLayout` with `navStyle="topnav"` and `aiTrigger="fab"` instead.
+ * This component will be removed in v2.0.0.
+ *
+ * Migration:
+ * ```tsx
+ * // Before (deprecated)
+ * import { AIFabLayout } from '@trinityui/design-system';
+ * <AIFabLayout navStyle="topnav" />
+ *
+ * // After
+ * import { AppLayout } from '@trinityui/design-system';
+ * <AppLayout navStyle="topnav" aiTrigger="fab" />
+ * ```
+ * @example
+ * ```tsx
+ *  import { AIFabLayout } from '@trinityui/design-system';
+ *
+ *  <AIFabLayout />
+ *  ```
+ */
+import React from 'react';
+import { AppLayoutProps } from './AppLayout';
+/**
+ * @deprecated Use `AppLayout` instead. AIFabLayout will be removed in v2.0.0.
+ */
+export declare const AIFabLayout: React.FC<AppLayoutProps>;
+//# sourceMappingURL=AIFabLayout.deprecated.d.ts.map

package/dist/components/AppLayout/AIFabLayout.deprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIFabLayout.deprecated.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/AIFabLayout.deprecated.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAO,EAAa,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAchD,CAAC"}

package/dist/components/AppLayout/AppLayout.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @fileoverview AppLayout component.
+ * @module components/AppLayout/AppLayout
+ * AppLayout - Unified Application Shell
+ *
+ * A flexible application layout that supports multiple navigation styles and AI integration modes.
+ * This component consolidates the functionality of the previous AppLayout and AIFabLayout components.
+ *
+ * @example
+ * ```tsx
+ *  import { AppLayout } from '@trinityui/design-system';
+ *
+ *  <AppLayout
+ *    name="Example"
+ *  >
+ *    <div>Example content</div>
+ *  </AppLayout>
+ *  ```
+ *
+ * @example Top navigation with FAB AI trigger
+ * ```tsx
+ * <AppLayout
+ *   navStyle="topnav"
+ *   aiTrigger="fab"
+ *   companyName="Acme Corp"
+ * >
+ *   <YourContent />
+ * </AppLayout>
+ * ```
+ *
+ * @example Sidebar navigation with no AI integration
+ * ```tsx
+ * <AppLayout
+ *   navStyle="sidebar"
+ *   aiTrigger="none"
+ *   companyName="Acme Corp"
+ * >
+ *   <YourContent />
+ * </AppLayout>
+ * ```
+ */
+import React from 'react';
+import { SxProps, Theme } from '@mui/material';
+import { type InsightEnginePanelProps } from './InsightEnginePanel';
+import { type AIFabProps } from './AIFab';
+/**
+ * Navigation style determines the overall layout structure
+ * - 'sidebar': Full sidebar navigation with collapsible drawer (default)
+ * - 'topnav': Simple top navigation bar only
+ */
+export type NavStyle = 'sidebar' | 'topnav';
+/**
+ * AI trigger mode determines how users access the AI assistant
+ * - 'sidebar': AI is accessed via a nav item in the sidebar (default for sidebar nav)
+ * - 'fab': AI is accessed via a floating action button (default for topnav)
+ * - 'none': No AI integration
+ */
+export type AITrigger = 'sidebar' | 'fab' | 'none';
+/**
+ * Navigation item for sidebar
+ */
+export interface NavItem {
+    id: string;
+    label: string;
+    icon: React.ReactNode;
+    badge?: number;
+    isSpecial?: boolean;
+}
+/**
+ * Props for AppLayout component.
+ */
+export interface AppLayoutProps {
+    /** Child content to render in the main area */
+    children: React.ReactNode;
+    /**
+     * Navigation style
+     * @default 'sidebar'
+     */
+    navStyle?: NavStyle;
+    /**
+     * AI trigger mode
+     * @default 'sidebar' when navStyle='sidebar', 'fab' when navStyle='topnav'
+     */
+    aiTrigger?: AITrigger;
+    /**
+     * Company or app name displayed in the header
+     */
+    companyName?: string;
+    /**
+     * Navigation items for sidebar mode.
+     * Required when navStyle='sidebar'. If empty or not provided, sidebar navigation will not render.
+     * Include an item with id='insight-engine' and isSpecial=true to add AI trigger to sidebar.
+     */
+    navItems?: NavItem[];
+    /**
+     * Currently selected navigation item ID (controlled).
+     * If not provided, no item will be highlighted.
+     */
+    selectedNavItem?: string;
+    /**
+     * Callback when selected navigation item changes.
+     * Called when user clicks a non-AI nav item.
+     */
+    onSelectedNavItemChange?: (itemId: string) => void;
+    /**
+     * User information for the avatar/menu.
+     * The `initials` field should be provided; if omitted, no initials will be displayed.
+     */
+    user?: {
+        name: string;
+        email?: string;
+        initials?: string;
+    };
+    /**
+     * Client name for the client selector
+     */
+    clientName?: string;
+    /**
+     * Available clients for the selector
+     */
+    clients?: {
+        id: string;
+        name: string;
+    }[];
+    /**
+     * Callback when client changes
+     */
+    onClientChange?: (clientId: string) => void;
+    /**
+     * @deprecated Use onSelectedNavItemChange instead.
+     * Callback when navigation item is clicked.
+     */
+    onNavigate?: (itemId: string) => void;
+    /**
+     * Props passed to the AIFab component (when aiTrigger='fab')
+     */
+    fabProps?: Partial<AIFabProps>;
+    /**
+     * Props passed to the InsightEnginePanel component
+     */
+    panelProps?: Partial<InsightEnginePanelProps>;
+    /**
+     * Custom panel width
+     * @default 420
+     */
+    aiPanelWidth?: number;
+    /**
+     * SX props for the content wrapper
+     */
+    contentSx?: SxProps<Theme>;
+}
+export declare const AppLayout: React.FC<AppLayoutProps>;
+export default AppLayout;
+//# sourceMappingURL=AppLayout.d.ts.map

package/dist/components/AppLayout/AppLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppLayout.d.ts","sourceRoot":"","sources":["../../../src/components/AppLayout/AppLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AACrD,OAAO,EAAgC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI7E,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAExF,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAOjD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAErB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnD;;;OAGG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAEzC;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAE/B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAE9C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC5B;AA8FD,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA+O9C,CAAC;AAEF,eAAe,SAAS,CAAC"}