xertica-ui 2.5.3 → 2.7.0

package/components/assistant/modern-chat-input/modern-chat-input.mdx

@@ -1,71 +1,71 @@
-import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
-import * as ModernChatInputStories from './modern-chat-input.stories';
-
-<Meta of={ModernChatInputStories} />
-
-<Title />
-<Subtitle>An advanced, high-performance chat input for the Xertica Assistant.</Subtitle>
-
-<Description />
-
-<Primary />
-
----
-
-## Usage Patterns
-
-### Standard Floating Input
-Optimized for chat interfaces with multi-line support, voice recording, and action chips.
-
-<Canvas>
-  <ModernChatInputStories.Default />
-</Canvas>
-
-### Full-Page Variant
-Adjusts maximum width and alignment for use in standalone chat pages.
-
-<Canvas>
-  <ModernChatInputStories.FullPage />
-</Canvas>
-
----
-
-## Feature Flags
-
-Each input capability can be individually toggled via boolean props.
-All flags default to `true` for full backward compatibility.
-
-| Prop | Controls | Default |
-|---|---|---|
-| `enableAudioInput` | Voice recording button | `true` |
-| `enableFileAttachment` | File attachment (paperclip) button | `true` |
-| `enableDocumentCreation` | "Create document" menu item | `true` |
-| `enablePodcastGeneration` | "Generate podcast" menu item | `true` |
-| `enableSearch` | "Search" menu item | `true` |
-
-> [!NOTE]
-> When all three action types (`enableDocumentCreation`, `enablePodcastGeneration`, `enableSearch`) are set to `false`, the "+" menu button is completely hidden.
-
-### Text Only
-All action buttons disabled — only the text input and send button remain.
-
-<Canvas>
-  <ModernChatInputStories.TextOnly />
-</Canvas>
-
-### Selective Actions
-Only document creation and search are enabled for a focused workflow.
-
-<Canvas>
-  <ModernChatInputStories.SelectiveActions />
-</Canvas>
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Action Workflow** — Handle the `onSubmit` callback's optional `action` parameter to distinguish between standard text messages and intent-driven generations (Documents, Podcasts, Search).
-> - **State Sync** — Always maintain the `value` in a parent state and update it via `onChange` and `onVoiceRecording` to ensure consistent data binding.
-> - **Dynamic Sizing** — The input automatically expands up to 100px based on content; ensure the parent container can accommodate these height changes without layout shift.
-> - **Feature Flags** — Pass flags like `enableSearch={false}` or `enableAudioInput={false}` to tailor input capabilities per use-case. Flags are independent and can be combined freely.
+import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
+import * as ModernChatInputStories from './modern-chat-input.stories';
+
+<Meta of={ModernChatInputStories} />
+
+<Title />
+<Subtitle>An advanced, high-performance chat input for the Xertica Assistant.</Subtitle>
+
+<Description />
+
+<Primary />
+
+---
+
+## Usage Patterns
+
+### Standard Floating Input
+Optimized for chat interfaces with multi-line support, voice recording, and action chips.
+
+<Canvas>
+  <ModernChatInputStories.Default />
+</Canvas>
+
+### Full-Page Variant
+Adjusts maximum width and alignment for use in standalone chat pages.
+
+<Canvas>
+  <ModernChatInputStories.FullPage />
+</Canvas>
+
+---
+
+## Feature Flags
+
+Each input capability can be individually toggled via boolean props.
+All flags default to `true` for full backward compatibility.
+
+| Prop | Controls | Default |
+|---|---|---|
+| `enableAudioInput` | Voice recording button | `true` |
+| `enableFileAttachment` | File attachment (paperclip) button | `true` |
+| `enableDocumentCreation` | "Create document" menu item | `true` |
+| `enablePodcastGeneration` | "Generate podcast" menu item | `true` |
+| `enableSearch` | "Search" menu item | `true` |
+
+> [!NOTE]
+> When all three action types (`enableDocumentCreation`, `enablePodcastGeneration`, `enableSearch`) are set to `false`, the "+" menu button is completely hidden.
+
+### Text Only
+All action buttons disabled — only the text input and send button remain.
+
+<Canvas>
+  <ModernChatInputStories.TextOnly />
+</Canvas>
+
+### Selective Actions
+Only document creation and search are enabled for a focused workflow.
+
+<Canvas>
+  <ModernChatInputStories.SelectiveActions />
+</Canvas>
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Action Workflow** — Handle the `onSubmit` callback's optional `action` parameter to distinguish between standard text messages and intent-driven generations (Documents, Podcasts, Search).
+> - **State Sync** — Always maintain the `value` in a parent state and update it via `onChange` and `onVoiceRecording` to ensure consistent data binding.
+> - **Dynamic Sizing** — The input automatically expands up to 100px based on content; ensure the parent container can accommodate these height changes without layout shift.
+> - **Feature Flags** — Pass flags like `enableSearch={false}` or `enableAudioInput={false}` to tailor input capabilities per use-case. Flags are independent and can be combined freely.

package/components/assistant/modern-chat-input/modern-chat-input.test.tsx

@@ -1,4 +1,5 @@
-import { render, screen, fireEvent, act, waitFor } from '@testing-library/react';
+import { screen, fireEvent, act, waitFor } from '@testing-library/react';
+import { renderWithProviders as render } from '../../../test/render';
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { ModernChatInput } from './ModernChatInput';
 import React from 'react';
@@ -19,7 +20,7 @@ describe('ModernChatInput', () => {
     const onChange = vi.fn();
     render(<ModernChatInput value="" onChange={onChange} onSubmit={vi.fn()} />);
 
-    const textarea = screen.getByPlaceholderText('Mande uma mensagem para o Xertica');
+    const textarea = screen.getByPlaceholderText('Envie uma mensagem');
     fireEvent.change(textarea, { target: { value: 'hello' } });
 
     expect(onChange).toHaveBeenCalledWith('hello');

package/components/assistant/xertica-assistant/parts/AssistantMessageBubble.tsx

@@ -238,7 +238,7 @@ export function AssistantMessageBubble({
 
           {/* Table Rendering */}
           {msg.tableData && (
-            <div className="mt-4 w-full max-w-full border rounded-[var(--radius)] overflow-x-auto custom-scrollbar relative">
+            <div className="mt-4 w-full max-w-full border rounded-[var(--radius)] overflow-x-auto scrollbar-thin scrollbar-thumb-border scrollbar-track-transparent relative">
               <Table>
                 {msg.tableData.caption && <TableCaption>{msg.tableData.caption}</TableCaption>}
                 <TableHeader>

package/components/assistant/xertica-assistant/types.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { ChartConfig, DashboardChartDatum } from '../../ui/chart';
 
 /**
  * @file types.ts
@@ -88,8 +89,8 @@ export interface Message {
   searchResults?: SearchResult[];
   searchSources?: SearchSource[];
   searchCommands?: SearchCommand[];
-  chartData?: any[];
-  chartConfig?: any;
+  chartData?: DashboardChartDatum[];
+  chartConfig?: ChartConfig;
   tableData?: {
     caption?: string;
     headers: string[];

package/components/assistant/xertica-assistant/use-assistant.ts

@@ -183,7 +183,7 @@ export function useAssistant({
   onSendMessage,
   isProcessing = false,
   responseGenerator,
-  richSuggestions = [],
+  richSuggestions: _richSuggestions = [],
   onRichAction,
   onEvaluation,
 }: UseAssistantProps = {}): UseAssistantReturn {
@@ -257,15 +257,14 @@ export function useAssistant({
   // Auto-scroll on new messages (condicional ≤ 120px)
   useEffect(() => {
     if (messagesEndRef.current && abaSelecionada === 'chat') {
-      const container = messagesEndRef.current.parentElement;
-      if (!container) {
-        messagesEndRef.current.scrollIntoView({ behavior: 'smooth' });
-        return;
-      }
+      const container = messagesEndRef.current.closest<HTMLElement>(
+        '[data-radix-scroll-area-viewport]'
+      );
+      if (!container) return;
       const distanceFromBottom =
         container.scrollHeight - container.scrollTop - container.clientHeight;
       if (distanceFromBottom < 120) {
-        messagesEndRef.current.scrollIntoView({ behavior: 'smooth' });
+        messagesEndRef.current.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
       }
     }
   }, [mensagens, abaSelecionada]);
@@ -381,10 +380,11 @@ export function useAssistant({
           await navigator.clipboard.writeText(content);
           setCopiedId(messageId);
           setTimeout(() => setCopiedId(null), 2000);
-        } catch (clipboardError: any) {
+        } catch (clipboardError) {
           if (
-            clipboardError.name === 'NotAllowedError' ||
-            clipboardError.message.includes('permissions policy')
+            clipboardError instanceof Error &&
+            (clipboardError.name === 'NotAllowedError' ||
+              clipboardError.message.includes('permissions policy'))
           ) {
             throw new Error('Clipboard permission denied, falling back');
           }

package/components/assistant/xertica-assistant/xertica-assistant.mdx

@@ -1,66 +1,66 @@
-import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
-import * as AssistantStories from './xertica-assistant.stories';
-
-<Meta of={AssistantStories} />
-
-<Title />
-<Subtitle>An embedded AI-powered assistant panel for chat, document creation, and data analysis.</Subtitle>
-
-<Description />
-
-<Primary />
-
----
-
-## Feature Flags
-
-Each assistant capability can be individually toggled on or off via boolean props.
-All flags default to `true` for full backward compatibility.
-
-| Prop | Controls | Default |
-|---|---|---|
-| `showHistory` | Conversation history tab and collapsed icon | `true` |
-| `showFavorites` | Favorites tab and collapsed icon | `true` |
-| `enableAudioInput` | Voice recording and audio upload | `true` |
-| `enableFileAttachment` | File attachment button | `true` |
-| `enableDocumentCreation` | "Create document" action in the input menu | `true` |
-| `enablePodcastGeneration` | "Generate podcast" action and per-message button | `true` |
-| `enableSearch` | "Search" action in the input menu | `true` |
-
-### Chat Only
-
-All extra features disabled — the assistant provides only a basic text chat.
-
-<Canvas of={AssistantStories.ChatOnly} />
-
-### Minimal Input
-
-Only document creation and file attachment are enabled — ideal for document-focused workflows.
-
-<Canvas of={AssistantStories.MinimalInput} />
-
----
-
-## Workspace Integration
-
-The assistant features specialized workspaces for different content types.
-
-### Document Editing
-When the assistant generates a document, it opens a dedicated editing workspace using the `RichTextEditor` component.
-
-<Canvas of={AssistantStories.DocumentEditing} />
-
-### Full Page View
-For focused work, the assistant can be expanded into a centered full-page layout.
-
-<Canvas of={AssistantStories.FullPage} />
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Layout Context** — Use `useLayout()` to toggle the assistant's visibility and track its state across the application.
-> - **Demo Mode** — Use `demoMode={true}` for prototyping; it provides rich mock responses for documents, charts, and media.
-> - **Custom Responses** — Leverage `responseGenerator` to bridge the assistant with your backend or custom LLM logic.
-> - **Feature Flags** — Pass individual flags like `showHistory={false}` or `enableSearch={false}` to tailor the assistant's capabilities per use-case. Flags can be combined freely.
+import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
+import * as AssistantStories from './xertica-assistant.stories';
+
+<Meta of={AssistantStories} />
+
+<Title />
+<Subtitle>An embedded AI-powered assistant panel for chat, document creation, and data analysis.</Subtitle>
+
+<Description />
+
+<Primary />
+
+---
+
+## Feature Flags
+
+Each assistant capability can be individually toggled on or off via boolean props.
+All flags default to `true` for full backward compatibility.
+
+| Prop | Controls | Default |
+|---|---|---|
+| `showHistory` | Conversation history tab and collapsed icon | `true` |
+| `showFavorites` | Favorites tab and collapsed icon | `true` |
+| `enableAudioInput` | Voice recording and audio upload | `true` |
+| `enableFileAttachment` | File attachment button | `true` |
+| `enableDocumentCreation` | "Create document" action in the input menu | `true` |
+| `enablePodcastGeneration` | "Generate podcast" action and per-message button | `true` |
+| `enableSearch` | "Search" action in the input menu | `true` |
+
+### Chat Only
+
+All extra features disabled — the assistant provides only a basic text chat.
+
+<Canvas of={AssistantStories.ChatOnly} />
+
+### Minimal Input
+
+Only document creation and file attachment are enabled — ideal for document-focused workflows.
+
+<Canvas of={AssistantStories.MinimalInput} />
+
+---
+
+## Workspace Integration
+
+The assistant features specialized workspaces for different content types.
+
+### Document Editing
+When the assistant generates a document, it opens a dedicated editing workspace using the `RichTextEditor` component.
+
+<Canvas of={AssistantStories.DocumentEditing} />
+
+### Full Page View
+For focused work, the assistant can be expanded into a centered full-page layout.
+
+<Canvas of={AssistantStories.FullPage} />
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Layout Context** — Use `useLayout()` to toggle the assistant's visibility and track its state across the application.
+> - **Demo Mode** — Use `demoMode={true}` for prototyping; it provides rich mock responses for documents, charts, and media.
+> - **Custom Responses** — Leverage `responseGenerator` to bridge the assistant with your backend or custom LLM logic.
+> - **Feature Flags** — Pass individual flags like `showHistory={false}` or `enableSearch={false}` to tailor the assistant's capabilities per use-case. Flags can be combined freely.

package/components/assistant/xertica-assistant/xertica-assistant.test.tsx

@@ -1,4 +1,5 @@
-import { render, screen, fireEvent, act, waitFor } from '@testing-library/react';
+import { screen, fireEvent, act, waitFor } from '@testing-library/react';
+import { renderWithProviders as render } from '../../../test/render';
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { XerticaAssistant } from './xertica-assistant';
 import React from 'react';

package/{templates/src/features/auth/ui → components/blocks/auth}/AuthPageShell.tsx

@@ -1,32 +1,37 @@
-import React from 'react';
-import { ImageWithFallback } from 'xertica-ui/ui';
-import { LanguageSelector } from 'xertica-ui/brand';
-
-interface AuthPageShellProps {
-  imageSrc: string;
-  imageAlt: string;
-  children: React.ReactNode;
-}
-
-export function AuthPageShell({ imageSrc, imageAlt, children }: AuthPageShellProps) {
-  return (
-    <div className="h-screen w-full flex overflow-y-auto">
-      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
-        <ImageWithFallback
-          src={imageSrc}
-          alt={imageAlt}
-          className="absolute inset-0 w-full h-full object-cover"
-        />
-        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
-      </div>
-
-      <div className="flex-1 flex items-center justify-center px-4 sm:px-6 lg:px-8 lg:flex-none lg:w-1/2 relative bg-muted">
-        <div className="absolute top-4 right-4 z-20">
-          <LanguageSelector variant="minimal" showIcon={false} />
-        </div>
-        <div className="absolute inset-0 lg:hidden bg-[image:var(--gradient-diagonal)] opacity-10 dark:opacity-5" />
-        <div className="w-full max-w-sm space-y-6 relative z-10">{children}</div>
-      </div>
-    </div>
-  );
-}
+import React from 'react';
+import { ImageWithFallback } from '../../figma/ImageWithFallback';
+import { LanguageSelector } from '../../brand/language-selector';
+
+export interface AuthPageShellProps {
+  imageSrc: string;
+  imageAlt: string;
+  children: React.ReactNode;
+}
+
+/**
+ * Shared two-column shell used by every auth page (Login, ForgotPassword,
+ * ResetPassword, VerifyEmail): hero image on the left, centered form panel
+ * with a language selector on the right.
+ */
+export function AuthPageShell({ imageSrc, imageAlt, children }: AuthPageShellProps) {
+  return (
+    <div className="h-screen w-full flex overflow-y-auto">
+      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
+        <ImageWithFallback
+          src={imageSrc}
+          alt={imageAlt}
+          className="absolute inset-0 w-full h-full object-cover"
+        />
+        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
+      </div>
+
+      <div className="flex-1 flex items-center justify-center px-4 sm:px-6 lg:px-8 lg:flex-none lg:w-1/2 relative bg-muted">
+        <div className="absolute top-4 right-4 z-20">
+          <LanguageSelector variant="minimal" showIcon={false} />
+        </div>
+        <div className="absolute inset-0 lg:hidden bg-[image:var(--gradient-diagonal)] opacity-10 dark:opacity-5" />
+        <div className="w-full max-w-sm space-y-6 relative z-10">{children}</div>
+      </div>
+    </div>
+  );
+}

package/components/blocks/auth/PasswordStrengthMeter.tsx

@@ -0,0 +1,41 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import type { PasswordStrength } from './usePasswordStrength';
+
+export interface PasswordStrengthMeterProps {
+  strength: PasswordStrength;
+}
+
+const BAR_WIDTH: Record<Exclude<PasswordStrength, null>, string> = {
+  weak: 'w-1/3 bg-destructive',
+  medium: 'w-2/3 bg-[var(--chart-3)]',
+  strong: 'w-full bg-[var(--chart-2)]',
+};
+
+const TEXT_COLOR: Record<Exclude<PasswordStrength, null>, string> = {
+  weak: 'text-destructive',
+  medium: 'text-[var(--chart-3)]',
+  strong: 'text-[var(--chart-2)]',
+};
+
+const LABEL_KEY: Record<Exclude<PasswordStrength, null>, string> = {
+  weak: 'resetPassword.strengthWeak',
+  medium: 'resetPassword.strengthMedium',
+  strong: 'resetPassword.strengthStrong',
+};
+
+/** Progress bar + label shown under the new-password field on reset/create-password screens. */
+export function PasswordStrengthMeter({ strength }: PasswordStrengthMeterProps) {
+  const { t } = useTranslation();
+
+  if (!strength) return null;
+
+  return (
+    <div className="flex items-center gap-2">
+      <div className="flex-1 h-1 bg-muted rounded-full overflow-hidden">
+        <div className={`h-full transition-all duration-300 ${BAR_WIDTH[strength]}`} />
+      </div>
+      <span className={`text-small ${TEXT_COLOR[strength]}`}>{t(LABEL_KEY[strength])}</span>
+    </div>
+  );
+}

package/components/blocks/auth/SocialLoginButtons.tsx

@@ -0,0 +1,95 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { Lock } from 'lucide-react';
+import { Button } from '../../ui/button';
+
+export type SocialProvider = 'google' | 'mtLogin' | 'govBr';
+
+export interface SocialLoginButtonsProps {
+  onSocialLogin: (provider: string) => void;
+  /** Which SSO providers to render — projects without gov.br/MT Login can pass a smaller list. */
+  providers?: SocialProvider[];
+}
+
+const DEFAULT_PROVIDERS: SocialProvider[] = ['google', 'mtLogin', 'govBr'];
+
+export function SocialLoginButtons({
+  onSocialLogin,
+  providers = DEFAULT_PROVIDERS,
+}: SocialLoginButtonsProps) {
+  const { t } = useTranslation();
+
+  if (providers.length === 0) return null;
+
+  return (
+    <>
+      <div className="relative">
+        <div className="absolute inset-0 flex items-center">
+          <div className="w-full border-t border-border" />
+        </div>
+        <div className="relative flex justify-center text-sm">
+          <span className="bg-muted px-2 text-muted-foreground">{t('login.orContinueWith')}</span>
+        </div>
+      </div>
+
+      <div className="space-y-3">
+        {providers.includes('google') && (
+          <Button
+            type="button"
+            variant="outline"
+            className="w-full justify-center"
+            onClick={() => onSocialLogin('Google')}
+          >
+            <svg className="w-5 h-5 mr-2" viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg">
+              <path
+                fill="#EA4335"
+                d="M24 9.5c3.54 0 6.71 1.22 9.21 3.6l6.85-6.85C35.9 2.38 30.47 0 24 0 14.62 0 6.51 5.38 2.56 13.22l7.98 6.19C12.43 13.72 17.74 9.5 24 9.5z"
+              />
+              <path
+                fill="#4285F4"
+                d="M46.98 24.55c0-1.57-.15-3.09-.38-4.55H24v9.02h12.94c-.58 2.96-2.26 5.48-4.78 7.18l7.73 6c4.51-4.18 7.09-10.36 7.09-17.65z"
+              />
+              <path
+                fill="#FBBC05"
+                d="M10.53 28.59c-.48-1.45-.76-2.99-.76-4.59s.27-3.14.76-4.59l-7.98-6.19C.92 16.46 0 20.12 0 24c0 3.88.92 7.54 2.56 10.78l7.97-6.19z"
+              />
+              <path
+                fill="#34A853"
+                d="M24 48c6.48 0 11.93-2.13 15.89-5.81l-7.73-6c-2.15 1.45-4.92 2.3-8.16 2.3-6.26 0-11.57-4.22-13.47-9.91l-7.98 6.19C6.51 42.62 14.62 48 24 48z"
+              />
+              <path fill="none" d="M0 0h48v48H0z" />
+            </svg>
+            <span>{t('login.signInWithGoogle')}</span>
+          </Button>
+        )}
+
+        {providers.includes('mtLogin') && (
+          <Button
+            type="button"
+            variant="outline"
+            className="w-full justify-center"
+            onClick={() => onSocialLogin('MT Login')}
+          >
+            <Lock className="w-5 h-5 mr-2 text-[var(--chart-4)]" />
+            <span>{t('login.signInWithMTLogin')}</span>
+          </Button>
+        )}
+
+        {providers.includes('govBr') && (
+          <Button
+            type="button"
+            variant="outline"
+            className="w-full justify-center font-normal"
+            onClick={() => onSocialLogin('gov.br')}
+          >
+            <span>
+              {t('login.signInWithGovBr').split('gov.br')[0]}
+              <strong className="font-semibold">gov.br</strong>
+              {t('login.signInWithGovBr').split('gov.br')[1] || ''}
+            </span>
+          </Button>
+        )}
+      </div>
+    </>
+  );
+}

package/components/blocks/auth/index.ts

@@ -0,0 +1,11 @@
+export { AuthPageShell } from './AuthPageShell';
+export type { AuthPageShellProps } from './AuthPageShell';
+
+export { SocialLoginButtons } from './SocialLoginButtons';
+export type { SocialLoginButtonsProps, SocialProvider } from './SocialLoginButtons';
+
+export { usePasswordStrength } from './usePasswordStrength';
+export type { PasswordStrength } from './usePasswordStrength';
+
+export { PasswordStrengthMeter } from './PasswordStrengthMeter';
+export type { PasswordStrengthMeterProps } from './PasswordStrengthMeter';

package/components/blocks/auth/usePasswordStrength.ts

@@ -0,0 +1,13 @@
+import { useMemo } from 'react';
+
+export type PasswordStrength = 'weak' | 'medium' | 'strong' | null;
+
+/** Length-based password strength heuristic shared by every reset/create-password screen. */
+export function usePasswordStrength(password: string): PasswordStrength {
+  return useMemo(() => {
+    if (password.length === 0) return null;
+    if (password.length < 6) return 'weak';
+    if (password.length < 10) return 'medium';
+    return 'strong';
+  }, [password]);
+}