xertica-ui 2.5.2 → 2.6.0

package/components/pages/home-page/HomePage.stories.tsx

@@ -2,6 +2,7 @@ import type { Meta, StoryObj } from '@storybook/react';
 import { HomePage } from './HomePage';
 import { MemoryRouter } from 'react-router-dom';
 import { LayoutProvider } from '../../../contexts/LayoutContext';
+import { AuthProvider } from '../../../contexts/AuthContext';
 import React from 'react';
 
 const meta: Meta<typeof HomePage> = {
@@ -10,9 +11,11 @@ const meta: Meta<typeof HomePage> = {
   decorators: [
     Story => (
       <MemoryRouter initialEntries={['/home']}>
-        <LayoutProvider>
-          <Story />
-        </LayoutProvider>
+        <AuthProvider>
+          <LayoutProvider>
+            <Story />
+          </LayoutProvider>
+        </AuthProvider>
       </MemoryRouter>
     ),
   ],
@@ -24,16 +27,6 @@ const meta: Meta<typeof HomePage> = {
 export default meta;
 type Story = StoryObj<typeof HomePage>;
 
-export const Default: Story = {
-  args: {
-    user: { email: 'ariel@xertica.com' },
-    onLogout: () => {},
-  },
-};
+export const Default: Story = {};
 
-export const NoUser: Story = {
-  args: {
-    user: null,
-    onLogout: () => {},
-  },
-};
+export const NoUser: Story = {};

package/components/pages/home-page/home-page.mdx

@@ -1,53 +1,53 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-import * as HomePageStories from './HomePage.stories';
-
-<Meta of={HomePageStories} />
-
-<Title>HomePage</Title>
-<Subtitle>Full application shell composed from Sidebar, HomeContent, and XerticaAssistant.</Subtitle>
-
----
-
-## Overview
-
-`HomePage` is the root authenticated page. It assembles the three major layout pillars:
-
-- **Sidebar** - Primary navigation.
-- **HomeContent** - Dashboard area with breadcrumb header and feature card grid.
-- **XerticaAssistant** - Floating AI assistant panel.
-
-When `XerticaProvider` is present, the page synchronizes sidebar width, sidebar expansion, and assistant visibility through `LayoutContext`. Without the provider, it renders with local fallback layout state.
-
-**Requires:** React Router v6. `XerticaProvider` is recommended for app-level synchronization.
-
----
-
-## Props
-
-| Prop | Type | Required | Description |
-|---|---|---|---|
-| `user` | `{ email: string } \| null` | Yes | Currently authenticated user. Passed to Sidebar and HomeContent for display. |
-| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar or Header. |
-
----
-
-## Composition
-
-```tsx
-import { HomePage } from 'xertica-ui';
-
-<Route
-  path="/home"
-  element={<HomePage user={currentUser} onLogout={handleLogout} />}
-/>
-```
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Top-level only** - `HomePage` is a full-screen layout component. Do not nest it inside other layouts.
-> - **No logic here** - Keep business logic in `HomeContent` or lower-level components.
-> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
-> - **Extend via HomeContent** - To add dashboard sections, edit `HomeContent`, not `HomePage`.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+import * as HomePageStories from './HomePage.stories';
+
+<Meta of={HomePageStories} />
+
+<Title>HomePage</Title>
+<Subtitle>Full application shell composed from Sidebar, HomeContent, and XerticaAssistant.</Subtitle>
+
+---
+
+## Overview
+
+`HomePage` is the root authenticated page. It assembles the three major layout pillars:
+
+- **Sidebar** - Primary navigation.
+- **HomeContent** - Dashboard area with breadcrumb header and feature card grid.
+- **XerticaAssistant** - Floating AI assistant panel.
+
+When `XerticaProvider` is present, the page synchronizes sidebar width, sidebar expansion, and assistant visibility through `LayoutContext`. Without the provider, it renders with local fallback layout state.
+
+**Requires:** React Router v6. `XerticaProvider` is recommended for app-level synchronization.
+
+---
+
+## Props
+
+| Prop | Type | Required | Description |
+|---|---|---|---|
+| `user` | `{ email: string } \| null` | Yes | Currently authenticated user. Passed to Sidebar and HomeContent for display. |
+| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar or Header. |
+
+---
+
+## Composition
+
+```tsx
+import { HomePage } from 'xertica-ui';
+
+<Route
+  path="/home"
+  element={<HomePage user={currentUser} onLogout={handleLogout} />}
+/>
+```
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Top-level only** - `HomePage` is a full-screen layout component. Do not nest it inside other layouts.
+> - **No logic here** - Keep business logic in `HomeContent` or lower-level components.
+> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
+> - **Extend via HomeContent** - To add dashboard sections, edit `HomeContent`, not `HomePage`.

package/components/pages/home-page/home-page.test.tsx

@@ -1,4 +1,5 @@
-import { render, screen } from '@testing-library/react';
+import { screen } from '@testing-library/react';
+import { renderWithProviders as render } from '../../../test/render';
 import { describe, it, expect, vi } from 'vitest';
 import { HomePage } from './HomePage';
 import React from 'react';

package/components/pages/login-page/LoginPage.mdx

@@ -1,31 +1,31 @@
-import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
-import * as LoginPageStories from './LoginPage.stories';
-
-<Meta of={LoginPageStories} />
-
-<Title />
-<Subtitle>A complete, responsive login screen with hero image and SSO support.</Subtitle>
-
-<Description />
-
-<Primary />
-
----
-
-## Features
-- **Responsive Layout**: Side-by-side on desktop, stacked on mobile.
-- **SSO Options**: Built-in support for Google, MT Login, and gov.br.
-- **Form States**: Integrated loading and error handling.
-
-<Canvas>
-  <LoginPageStories.Default />
-</Canvas>
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Logic** — Provide the `onLogin` callback to handle actual authentication.
-> - **Customization** — Customize hero images and SSO buttons as per project requirements.
-> - **Routing** — The page uses `useNavigate()` for the forgot-password flow.
+import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
+import * as LoginPageStories from './LoginPage.stories';
+
+<Meta of={LoginPageStories} />
+
+<Title />
+<Subtitle>A complete, responsive login screen with hero image and SSO support.</Subtitle>
+
+<Description />
+
+<Primary />
+
+---
+
+## Features
+- **Responsive Layout**: Side-by-side on desktop, stacked on mobile.
+- **SSO Options**: Built-in support for Google, MT Login, and gov.br.
+- **Form States**: Integrated loading and error handling.
+
+<Canvas>
+  <LoginPageStories.Default />
+</Canvas>
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Logic** — Provide the `onLogin` callback to handle actual authentication.
+> - **Customization** — Customize hero images and SSO buttons as per project requirements.
+> - **Routing** — The page uses `useNavigate()` for the forgot-password flow.

package/components/pages/login-page/LoginPage.tsx

@@ -1,218 +1,218 @@
-import React, { useState } from 'react';
-import { Button } from '../../ui/button';
-import { Input } from '../../ui/input';
-import { Label } from '../../ui/label';
-import { XerticaLogo } from '../../brand/xertica-logo';
-import { ImageWithFallback } from '../../figma/ImageWithFallback';
-import { LanguageSelector } from '../../brand/language-selector';
-import { Lock } from 'lucide-react';
-import { useNavigate } from 'react-router-dom';
-import { useTranslation } from 'react-i18next';
-
-/**
- * Props for the LoginPage component.
- */
-interface LoginPageProps {
-  /**
-   * Callback for login submission.
-   * Returns true if validation succeeds, false otherwise.
-   */
-  onLogin: (email: string, password: string) => boolean;
-}
-
-/**
- * Standard Login Page component.
- *
- * @description
- * A complete, responsive login screen featuring a hero image side-panel (on desktop)
- * and a focused authentication form. Supports email/password login and placeholders
- * for Social/SSO providers (Google, MT Login, gov.br).
- *
- * @ai-rules
- * 1. State Management: You must provide the `onLogin` callback to handle the actual authentication logic.
- * 2. Visuals: Hero images use `ImageWithFallback`. You can customize the `src` if needed.
- * 3. Routing: Uses `react-router` for navigation to the forgot-password flow.
- */
-export function LoginPage({ onLogin }: LoginPageProps) {
-  const navigate = useNavigate();
-  const { t } = useTranslation();
-  const [email, setEmail] = useState('');
-  const [password, setPassword] = useState('');
-  const [isLoading, setIsLoading] = useState(false);
-  const [error, setError] = useState('');
-
-  const handleSubmit = async (e: React.FormEvent) => {
-    e.preventDefault();
-    setError('');
-    setIsLoading(true);
-
-    // Simulate a small delay to show loading state
-    await new Promise(resolve => setTimeout(resolve, 1000));
-
-    const success = onLogin(email, password);
-
-    if (!success) {
-      setError(t('login.errorFillFields'));
-    }
-
-    setIsLoading(false);
-  };
-
-  const handleSocialLogin = (_provider: string) => {
-    // Wire your SSO/social provider integration here
-    onLogin('social@user.com', 'social-auth');
-  };
-
-  return (
-    <div className="h-screen w-full flex overflow-y-auto">
-      {/* Left side - Full background image */}
-      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
-        {/* Background image filling all space */}
-        <ImageWithFallback
-          src="https://images.unsplash.com/photo-1551434678-e076c223a692?w=1200&h=800&fit=crop&auto=format"
-          alt={t('login.heroImageAlt')}
-          className="absolute inset-0 w-full h-full object-cover"
-        />
-
-        {/* Gradient overlay */}
-        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
-      </div>
-
-      {/* Right side - Form */}
-      <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">
-        {/* Language selector in the top right corner */}
-        <div className="absolute top-4 right-4 z-20">
-          <LanguageSelector variant="minimal" showIcon={false} />
-        </div>
-
-        {/* Mobile background gradient */}
-        <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">
-          {/* Form header */}
-          <div className="text-center">
-            <div className="flex items-center justify-center mb-4">
-              <XerticaLogo
-                className="h-12 w-auto text-primary dark:text-foreground"
-                variant="theme"
-              />
-            </div>
-            <h2 className="text-sm text-muted-foreground">{t('login.heading')}</h2>
-          </div>
-
-          {/* Form */}
-          <form className="space-y-6" onSubmit={handleSubmit}>
-            <div className="space-y-2">
-              <Label htmlFor="email">{t('login.emailLabel')}</Label>
-              <Input
-                id="email"
-                name="email"
-                type="email"
-                required
-                className="w-full"
-                placeholder={t('login.emailPlaceholder')}
-                value={email}
-                onChange={e => setEmail(e.target.value)}
-              />
-            </div>
-
-            <div className="space-y-2">
-              <Label htmlFor="password">{t('login.passwordLabel')}</Label>
-              <Input
-                id="password"
-                name="password"
-                type="password"
-                required
-                className="w-full"
-                placeholder="••••••••"
-                value={password}
-                onChange={e => setPassword(e.target.value)}
-              />
-            </div>
-
-            {error && <div className="text-destructive text-sm text-center">{error}</div>}
-
-            <Button type="submit" className="w-full" disabled={isLoading}>
-              {isLoading ? t('login.submitting') : t('login.submit')}
-            </Button>
-
-            {/* Password recovery link */}
-            <div className="text-center">
-              <button
-                type="button"
-                onClick={() => navigate('/forgot-password')}
-                className="text-sm text-primary hover:opacity-80 transition-colors"
-              >
-                {t('login.forgotPassword')}
-              </button>
-            </div>
-          </form>
-
-          {/* Divider */}
-          <div className="relative">
-            <div className="absolute inset-0 flex items-center">
-              <div className="w-full border-t border-border"></div>
-            </div>
-            <div className="relative flex justify-center text-sm">
-              <span className="bg-muted px-2 text-muted-foreground">
-                {t('login.orContinueWith')}
-              </span>
-            </div>
-          </div>
-
-          {/* Social/SSO login options */}
-          <div className="space-y-3">
-            {/* Google */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center"
-              onClick={() => handleSocialLogin('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>
-                <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>
-                <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>
-                <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>
-                <path fill="none" d="M0 0h48v48H0z"></path>
-              </svg>
-              <span>{t('login.signInWithGoogle')}</span>
-            </Button>
-
-            {/* MT Login */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center"
-              onClick={() => handleSocialLogin('MT Login')}
-            >
-              <Lock className="w-5 h-5 mr-2 text-[var(--chart-4)]" />
-              <span>{t('login.signInWithMTLogin')}</span>
-            </Button>
-
-            {/* gov.br */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center font-normal"
-              onClick={() => handleSocialLogin('gov.br')}
-            >
-              <span>{t('login.signInWithGovBr')}</span>
-            </Button>
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-}
+import React, { useState } from 'react';
+import { Button } from '../../ui/button';
+import { Input } from '../../ui/input';
+import { Label } from '../../ui/label';
+import { XerticaLogo } from '../../brand/xertica-logo';
+import { ImageWithFallback } from '../../figma/ImageWithFallback';
+import { LanguageSelector } from '../../brand/language-selector';
+import { Lock } from 'lucide-react';
+import { useNavigate } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
+
+/**
+ * Props for the LoginPage component.
+ */
+interface LoginPageProps {
+  /**
+   * Callback for login submission.
+   * Returns true if validation succeeds, false otherwise.
+   */
+  onLogin: (email: string, password: string) => boolean;
+}
+
+/**
+ * Standard Login Page component.
+ *
+ * @description
+ * A complete, responsive login screen featuring a hero image side-panel (on desktop)
+ * and a focused authentication form. Supports email/password login and placeholders
+ * for Social/SSO providers (Google, MT Login, gov.br).
+ *
+ * @ai-rules
+ * 1. State Management: You must provide the `onLogin` callback to handle the actual authentication logic.
+ * 2. Visuals: Hero images use `ImageWithFallback`. You can customize the `src` if needed.
+ * 3. Routing: Uses `react-router` for navigation to the forgot-password flow.
+ */
+export function LoginPage({ onLogin }: LoginPageProps) {
+  const navigate = useNavigate();
+  const { t } = useTranslation();
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState('');
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setError('');
+    setIsLoading(true);
+
+    // Simulate a small delay to show loading state
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    const success = onLogin(email, password);
+
+    if (!success) {
+      setError(t('login.errorFillFields'));
+    }
+
+    setIsLoading(false);
+  };
+
+  const handleSocialLogin = (_provider: string) => {
+    // Wire your SSO/social provider integration here
+    onLogin('social@user.com', 'social-auth');
+  };
+
+  return (
+    <div className="h-screen w-full flex overflow-y-auto">
+      {/* Left side - Full background image */}
+      <div className="hidden lg:flex lg:flex-1 relative overflow-hidden">
+        {/* Background image filling all space */}
+        <ImageWithFallback
+          src="https://images.unsplash.com/photo-1551434678-e076c223a692?w=1200&h=800&fit=crop&auto=format"
+          alt={t('login.heroImageAlt')}
+          className="absolute inset-0 w-full h-full object-cover"
+        />
+
+        {/* Gradient overlay */}
+        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
+      </div>
+
+      {/* Right side - Form */}
+      <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">
+        {/* Language selector in the top right corner */}
+        <div className="absolute top-4 right-4 z-20">
+          <LanguageSelector variant="minimal" showIcon={false} />
+        </div>
+
+        {/* Mobile background gradient */}
+        <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">
+          {/* Form header */}
+          <div className="text-center">
+            <div className="flex items-center justify-center mb-4">
+              <XerticaLogo
+                className="h-12 w-auto text-primary dark:text-foreground"
+                variant="theme"
+              />
+            </div>
+            <h2 className="text-sm text-muted-foreground">{t('login.heading')}</h2>
+          </div>
+
+          {/* Form */}
+          <form className="space-y-6" onSubmit={handleSubmit}>
+            <div className="space-y-2">
+              <Label htmlFor="email">{t('login.emailLabel')}</Label>
+              <Input
+                id="email"
+                name="email"
+                type="email"
+                required
+                className="w-full"
+                placeholder={t('login.emailPlaceholder')}
+                value={email}
+                onChange={e => setEmail(e.target.value)}
+              />
+            </div>
+
+            <div className="space-y-2">
+              <Label htmlFor="password">{t('login.passwordLabel')}</Label>
+              <Input
+                id="password"
+                name="password"
+                type="password"
+                required
+                className="w-full"
+                placeholder="••••••••"
+                value={password}
+                onChange={e => setPassword(e.target.value)}
+              />
+            </div>
+
+            {error && <div className="text-destructive text-sm text-center">{error}</div>}
+
+            <Button type="submit" className="w-full" disabled={isLoading}>
+              {isLoading ? t('login.submitting') : t('login.submit')}
+            </Button>
+
+            {/* Password recovery link */}
+            <div className="text-center">
+              <button
+                type="button"
+                onClick={() => navigate('/forgot-password')}
+                className="text-sm text-primary hover:opacity-80 transition-colors"
+              >
+                {t('login.forgotPassword')}
+              </button>
+            </div>
+          </form>
+
+          {/* Divider */}
+          <div className="relative">
+            <div className="absolute inset-0 flex items-center">
+              <div className="w-full border-t border-border"></div>
+            </div>
+            <div className="relative flex justify-center text-sm">
+              <span className="bg-muted px-2 text-muted-foreground">
+                {t('login.orContinueWith')}
+              </span>
+            </div>
+          </div>
+
+          {/* Social/SSO login options */}
+          <div className="space-y-3">
+            {/* Google */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center"
+              onClick={() => handleSocialLogin('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>
+                <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>
+                <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>
+                <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>
+                <path fill="none" d="M0 0h48v48H0z"></path>
+              </svg>
+              <span>{t('login.signInWithGoogle')}</span>
+            </Button>
+
+            {/* MT Login */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center"
+              onClick={() => handleSocialLogin('MT Login')}
+            >
+              <Lock className="w-5 h-5 mr-2 text-[var(--chart-4)]" />
+              <span>{t('login.signInWithMTLogin')}</span>
+            </Button>
+
+            {/* gov.br */}
+            <Button
+              type="button"
+              variant="outline"
+              className="w-full justify-center font-normal"
+              onClick={() => handleSocialLogin('gov.br')}
+            >
+              <span>{t('login.signInWithGovBr')}</span>
+            </Button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}