xertica-ui 2.3.0 → 2.4.0

package/components/brand/xertica-provider/xertica-provider.mdx

@@ -1,61 +1,61 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-
-<Meta title="System/XerticaProvider" />
-
-<Title>XerticaProvider</Title>
-<Subtitle>The recommended root wrapper for shared Xertica UI services.</Subtitle>
-
----
-
-## Overview
-
-The `XerticaProvider` orchestrates the shared services used by complete applications: theme, brand colors, language, API keys, assistant state, layout, tooltips, Google Maps loading, and toast notifications.
-
-Most components have local fallbacks and can render without it, but app shells should still place it at the root so state is synchronized across layout, assistant, maps, theme, and notifications.
-
-```tsx
-import { XerticaProvider } from 'xertica-ui/brand';
-import 'xertica-ui/style.css';
-
-function App() {
-  return (
-    <XerticaProvider>
-      <YourAppContent />
-    </XerticaProvider>
-  );
-}
-```
-
----
-
-## Props
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `children` | `ReactNode` | **Required** | The application content to be wrapped by all providers. |
-| `googleMapsApiKey` | `string` | - | Initial Google Maps JavaScript API key. |
-| `apiKey` | `string` | - | Initial Gemini / AI service API key forwarded to `ApiKeyProvider`. |
-| `defaultBrandTheme` | `string` | - | Initial brand color theme id forwarded to `BrandColorsProvider`. |
-| `primaryColor` | `string` | - | Hex color override for the primary brand token. |
-| `useCustomTokens` | `boolean` | `false` | Skips runtime brand token injection when the host app owns tokens. |
-| `disableDarkMode` | `boolean` | `false` | Forces light mode and disables dark-mode toggling from the theme provider. |
-
----
-
-## What It Provides
-
-1. **Theme, Language, Brand, and API Key Contexts**: Centralizes app-level preferences and service keys.
-2. **Assistant Context**: Provides shared assistant conversation state.
-3. **Layout Context**: Enables `useLayout()` for synchronized sidebar and assistant state.
-4. **Tooltip Provider**: Standardizes Radix tooltip behavior across the app.
-5. **Google Maps Loader**: Handles asynchronous loading of the Maps API.
-6. **Toast Notifications**: Injects the `Sonner` toaster into the DOM.
-
----
-
-## AI Best Practices
-
-> [!CAUTION]
-> - **Recommended App Wrapper** - Components should render independently when possible, but apps should still use this provider once at the root for synchronized state and shared services.
-> - **Environment Safety** - Never hardcode API keys. Always use environment variables when passing them to the provider.
-> - **Toaster Injection** - The provider automatically injects the `Sonner` toaster. Do not add another `<Toaster />` in your app root unless you specifically need to override it.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+
+<Meta title="System/XerticaProvider" />
+
+<Title>XerticaProvider</Title>
+<Subtitle>The recommended root wrapper for shared Xertica UI services.</Subtitle>
+
+---
+
+## Overview
+
+The `XerticaProvider` orchestrates the shared services used by complete applications: theme, brand colors, language, API keys, assistant state, layout, tooltips, Google Maps loading, and toast notifications.
+
+Most components have local fallbacks and can render without it, but app shells should still place it at the root so state is synchronized across layout, assistant, maps, theme, and notifications.
+
+```tsx
+import { XerticaProvider } from 'xertica-ui/brand';
+import 'xertica-ui/style.css';
+
+function App() {
+  return (
+    <XerticaProvider>
+      <YourAppContent />
+    </XerticaProvider>
+  );
+}
+```
+
+---
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `children` | `ReactNode` | **Required** | The application content to be wrapped by all providers. |
+| `googleMapsApiKey` | `string` | - | Initial Google Maps JavaScript API key. |
+| `apiKey` | `string` | - | Initial Gemini / AI service API key forwarded to `ApiKeyProvider`. |
+| `defaultBrandTheme` | `string` | - | Initial brand color theme id forwarded to `BrandColorsProvider`. |
+| `primaryColor` | `string` | - | Hex color override for the primary brand token. |
+| `useCustomTokens` | `boolean` | `false` | Skips runtime brand token injection when the host app owns tokens. |
+| `disableDarkMode` | `boolean` | `false` | Forces light mode and disables dark-mode toggling from the theme provider. |
+
+---
+
+## What It Provides
+
+1. **Theme, Language, Brand, and API Key Contexts**: Centralizes app-level preferences and service keys.
+2. **Assistant Context**: Provides shared assistant conversation state.
+3. **Layout Context**: Enables `useLayout()` for synchronized sidebar and assistant state.
+4. **Tooltip Provider**: Standardizes Radix tooltip behavior across the app.
+5. **Google Maps Loader**: Handles asynchronous loading of the Maps API.
+6. **Toast Notifications**: Injects the `Sonner` toaster into the DOM.
+
+---
+
+## AI Best Practices
+
+> [!CAUTION]
+> - **Recommended App Wrapper** - Components should render independently when possible, but apps should still use this provider once at the root for synchronized state and shared services.
+> - **Environment Safety** - Never hardcode API keys. Always use environment variables when passing them to the provider.
+> - **Toaster Injection** - The provider automatically injects the `Sonner` toaster. Do not add another `<Toaster />` in your app root unless you specifically need to override it.

package/components/index.ts

@@ -1,90 +1,86 @@
-/**
- * Xertica UI Library Entry Point
- *
- * @description
- * This file exports all public components, contexts, and utilities of the Xertica UI library.
- * Consumers should import from the root of the package.
- */
-import '../styles/globals.css';
-
-// Xertica UI Styles should be imported by the consumer
-// ============================================================================
-// Xertica Assistant Exports
-// ============================================================================
-
-export { XerticaAssistant } from './assistant/xertica-assistant/xertica-assistant';
-export { XerticaProvider } from './brand/xertica-provider';
-export type {
-  XerticaAssistantProps,
-  Message,
-  Conversation,
-  Suggestion,
-  SearchResult,
-  SearchSource,
-  SearchCommand,
-  MessageType,
-  AttachmentType,
-  SearchResultType,
-  AssistantMode,
-  AssistantTab,
-} from './assistant/xertica-assistant/xertica-assistant';
-
-// ============================================================================
-// Page Components
-// ============================================================================
-
-export * from './pages';
-
-// UI Components - All available via /components/ui/index.ts
-export * from './ui';
-
-// Block Components - High-level composed patterns
-export * from './blocks';
-
-// Utility Components (used by XerticaAssistant)
-export { CodeBlock } from './assistant/code-block';
-export { MarkdownMessage } from './assistant/markdown-message';
-export { ModernChatInput } from './assistant/modern-chat-input';
-export { FormattedDocument } from './assistant/formatted-document';
-
-// Branding
-export { XerticaLogo } from './brand/xertica-logo';
-export { XerticaXLogo } from './brand/xertica-xlogo';
-export { XerticaOrbe } from './brand/xertica-orbe';
-
-// Utility
-export { ImageWithFallback } from './figma/ImageWithFallback';
-
-// Layout
-export { Sidebar } from './layout/sidebar';
-export { ThemeToggle } from './brand/theme-toggle';
-export { LanguageSelector } from './brand/language-selector';
-
-// State Management & Contexts
-export * from '../contexts/LayoutContext';
-
-// Language / i18n
-export {
-  useLanguage,
-  LanguageProvider,
-  DEFAULT_LANGUAGES,
-} from '../contexts/LanguageContext';
-export type {
-  Language,
-  LanguageDefinition,
-  LanguageProviderProps,
-} from '../contexts/LanguageContext';
-export { default as i18n, registerLanguageResource } from '../i18n';
-
-// Layout & Common Components
-export { Header } from './layout/header';
-export type { HeaderProps, BreadcrumbType as HeaderBreadcrumbType } from './layout/header';
-
-// Media Components
-export { VideoPlayer } from './media/video-player/VideoPlayer';
-export { AudioPlayer } from './media/audio-player/AudioPlayer';
-export { FloatingMediaWrapper } from './media/FloatingMediaWrapper';
-// PodcastPlayer was consolidated into AudioPlayer via colorVariant="primary" prop
-
-// Demo utilities (for templates)
-export { gerarResposta, gerarResposta as generateDemoResponse } from './shared/assistant-utils';
+/**
+ * Xertica UI Library Entry Point
+ *
+ * @description
+ * This file exports all public components, contexts, and utilities of the Xertica UI library.
+ * Consumers should import from the root of the package.
+ */
+import '../styles/globals.css';
+
+// Xertica UI Styles should be imported by the consumer
+// ============================================================================
+// Xertica Assistant Exports
+// ============================================================================
+
+export { XerticaAssistant } from './assistant/xertica-assistant/xertica-assistant';
+export { XerticaProvider } from './brand/xertica-provider';
+export type {
+  XerticaAssistantProps,
+  Message,
+  Conversation,
+  Suggestion,
+  SearchResult,
+  SearchSource,
+  SearchCommand,
+  MessageType,
+  AttachmentType,
+  SearchResultType,
+  AssistantMode,
+  AssistantTab,
+} from './assistant/xertica-assistant/xertica-assistant';
+
+// ============================================================================
+// Page Components
+// ============================================================================
+
+export * from './pages';
+
+// UI Components - All available via /components/ui/index.ts
+export * from './ui';
+
+// Block Components - High-level composed patterns
+export * from './blocks';
+
+// Utility Components (used by XerticaAssistant)
+export { CodeBlock } from './assistant/code-block';
+export { MarkdownMessage } from './assistant/markdown-message';
+export { ModernChatInput } from './assistant/modern-chat-input';
+export { FormattedDocument } from './assistant/formatted-document';
+
+// Branding
+export { XerticaLogo } from './brand/xertica-logo';
+export { XerticaXLogo } from './brand/xertica-xlogo';
+export { XerticaOrbe } from './brand/xertica-orbe';
+
+// Utility
+export { ImageWithFallback } from './figma/ImageWithFallback';
+
+// Layout
+export { Sidebar } from './layout/sidebar';
+export { ThemeToggle } from './brand/theme-toggle';
+export { LanguageSelector } from './brand/language-selector';
+
+// State Management & Contexts
+export * from '../contexts/LayoutContext';
+
+// Language / i18n
+export { useLanguage, LanguageProvider, DEFAULT_LANGUAGES } from '../contexts/LanguageContext';
+export type {
+  Language,
+  LanguageDefinition,
+  LanguageProviderProps,
+} from '../contexts/LanguageContext';
+export { default as i18n, registerLanguageResource } from '../i18n';
+
+// Layout & Common Components
+export { Header } from './layout/header';
+export type { HeaderProps, BreadcrumbType as HeaderBreadcrumbType } from './layout/header';
+
+// Media Components
+export { VideoPlayer } from './media/video-player/VideoPlayer';
+export { AudioPlayer } from './media/audio-player/AudioPlayer';
+export { FloatingMediaWrapper } from './media/FloatingMediaWrapper';
+// PodcastPlayer was consolidated into AudioPlayer via colorVariant="primary" prop
+
+// Demo utilities (for templates)
+export { gerarResposta, gerarResposta as generateDemoResponse } from './shared/assistant-utils';

package/components/layout/sidebar/sidebar.mdx

@@ -76,7 +76,7 @@ The expansion state is automatically persisted in a cookie (`sidebar_state`), en
 The Sidebar should ideally be synchronized with the `useLayout()` hook to ensure the main application container adjusts its padding accordingly.
 
 ```tsx
-import { Sidebar } from 'xertica-ui/layout';
+import { Sidebar } from 'xertica-ui/layout';
 import { useLayout } from 'xertica-ui/hooks';
 
 const { sidebarExpanded, toggleSidebar, sidebarWidth } = useLayout();