xertica-ui 2.5.3 → 2.7.0

package/components/pages/template-content/template-content.mdx

@@ -1,61 +1,61 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-
-<Meta title="Pages/TemplateContent" />
-
-<Title>TemplateContent</Title>
-<Subtitle>Kitchen-sink showcase and CLI starter template demonstrating the full Xertica UI component set.</Subtitle>
-
----
-
-## Overview
-
-`TemplateContent` is a comprehensive living demo that assembles the majority of Xertica UI primitives into a single scrollable page. It serves two purposes:
-
-1. **Development reference** - Shows the correct composition patterns for every major component.
-2. **CLI starter** - Acts as the baseline when scaffolding a new application page.
-
-It includes interactive showcases for cards, tabs, forms, tables, dialogs, alerts, progress, sliders, maps, headers, and sidebars.
-
-```tsx
-import { TemplateContent } from 'xertica-ui';
-
-{ path: '/template', element: <TemplateContent /> }
-```
-
----
-
-## Props
-
-| Prop | Type | Default | Description |
-|---|---|---|---|
-| `user` | `{ name?: string; email?: string; avatar?: string } \| null` | - | Currently authenticated user for the header. |
-| `onLogout` | `() => void` | - | Logout handler forwarded to the header. |
-| `onSettings` | `() => void` | - | Settings handler forwarded to the header. |
-
----
-
-## Layout Dependency
-
-`TemplateContent` uses optional layout state. When wrapped in `XerticaProvider`, it synchronizes sidebar width, expanded state, and layout controls. Without the provider, it renders with local fallback sidebar state.
-
-React Router is still required because the showcase uses `Link` and `useNavigate`.
-
----
-
-## Sidebar Showcase
-
-`TemplateContent` includes an embedded, interactive `Sidebar` preview with controls for:
-
-- Toggling footer sections.
-- Adjusting sidebar width via a `Slider`.
-- Switching between `variant="assistant"` and `variant="default"` modes.
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Reference first** - Before building a new page, check `TemplateContent` for the correct composition pattern.
-> - **Provider fallback** - `TemplateContent` renders without `XerticaProvider`, but the provider is recommended for synchronized layout state.
-> - **Router requirement** - React Router is still required for navigation hooks and links.
-> - **Map section** - The Maps showcase requires a valid `googleMapsApiKey` passed to `XerticaProvider`.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+
+<Meta title="Pages/TemplateContent" />
+
+<Title>TemplateContent</Title>
+<Subtitle>Kitchen-sink showcase and CLI starter template demonstrating the full Xertica UI component set.</Subtitle>
+
+---
+
+## Overview
+
+`TemplateContent` is a comprehensive living demo that assembles the majority of Xertica UI primitives into a single scrollable page. It serves two purposes:
+
+1. **Development reference** - Shows the correct composition patterns for every major component.
+2. **CLI starter** - Acts as the baseline when scaffolding a new application page.
+
+It includes interactive showcases for cards, tabs, forms, tables, dialogs, alerts, progress, sliders, maps, headers, and sidebars.
+
+```tsx
+import { TemplateContent } from 'xertica-ui';
+
+{ path: '/template', element: <TemplateContent /> }
+```
+
+---
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `user` | `{ name?: string; email?: string; avatar?: string } \| null` | - | Currently authenticated user for the header. |
+| `onLogout` | `() => void` | - | Logout handler forwarded to the header. |
+| `onSettings` | `() => void` | - | Settings handler forwarded to the header. |
+
+---
+
+## Layout Dependency
+
+`TemplateContent` uses optional layout state. When wrapped in `XerticaProvider`, it synchronizes sidebar width, expanded state, and layout controls. Without the provider, it renders with local fallback sidebar state.
+
+React Router is still required because the showcase uses `Link` and `useNavigate`.
+
+---
+
+## Sidebar Showcase
+
+`TemplateContent` includes an embedded, interactive `Sidebar` preview with controls for:
+
+- Toggling footer sections.
+- Adjusting sidebar width via a `Slider`.
+- Switching between `variant="assistant"` and `variant="default"` modes.
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Reference first** - Before building a new page, check `TemplateContent` for the correct composition pattern.
+> - **Provider fallback** - `TemplateContent` renders without `XerticaProvider`, but the provider is recommended for synchronized layout state.
+> - **Router requirement** - React Router is still required for navigation hooks and links.
+> - **Map section** - The Maps showcase requires a valid `googleMapsApiKey` passed to `XerticaProvider`.

package/components/pages/template-page/TemplatePage.stories.tsx

@@ -1,32 +1,32 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { TemplatePage } from './TemplatePage';
-import { MemoryRouter } from 'react-router-dom';
-import { LayoutProvider } from '../../../contexts/LayoutContext';
-import { AuthProvider } from '../../../contexts/AuthContext';
-import React from 'react';
-
-const meta: Meta<typeof TemplatePage> = {
-  title: 'Pages/TemplatePage',
-  component: TemplatePage,
-  decorators: [
-    Story => (
-      <MemoryRouter initialEntries={['/template']}>
-        <AuthProvider>
-          <LayoutProvider>
-            <Story />
-          </LayoutProvider>
-        </AuthProvider>
-      </MemoryRouter>
-    ),
-  ],
-  parameters: {
-    layout: 'fullscreen',
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof TemplatePage>;
-
-export const Default: Story = {};
-
-export const NoUser: Story = {};
+import type { Meta, StoryObj } from '@storybook/react';
+import { TemplatePage } from './TemplatePage';
+import { MemoryRouter } from 'react-router-dom';
+import { LayoutProvider } from '../../../contexts/LayoutContext';
+import { AuthProvider } from '../../../contexts/AuthContext';
+import React from 'react';
+
+const meta: Meta<typeof TemplatePage> = {
+  title: 'Pages/TemplatePage',
+  component: TemplatePage,
+  decorators: [
+    Story => (
+      <MemoryRouter initialEntries={['/template']}>
+        <AuthProvider>
+          <LayoutProvider>
+            <Story />
+          </LayoutProvider>
+        </AuthProvider>
+      </MemoryRouter>
+    ),
+  ],
+  parameters: {
+    layout: 'fullscreen',
+  },
+};
+
+export default meta;
+type Story = StoryObj<typeof TemplatePage>;
+
+export const Default: Story = {};
+
+export const NoUser: Story = {};

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

@@ -1,53 +1,53 @@
-import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
-import * as TemplatePageStories from './TemplatePage.stories';
-
-<Meta of={TemplatePageStories} />
-
-<Title>TemplatePage</Title>
-<Subtitle>Full application shell with the component kitchen-sink reference.</Subtitle>
-
----
-
-## Overview
-
-`TemplatePage` is the reference implementation of the full application layout. It assembles:
-
-- **Sidebar** - Primary navigation.
-- **TemplateContent** - Kitchen-sink showcase of Xertica UI components.
-- **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 for avatar and user menu display. |
-| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar. |
-
----
-
-## Composition
-
-```tsx
-import { TemplatePage } from 'xertica-ui';
-
-<Route
-  path="/template"
-  element={<TemplatePage user={currentUser} onLogout={handleLogout} />}
-/>
-```
-
----
-
-## AI Best Practices
-
-> [!IMPORTANT]
-> - **Reference implementation** - Use `TemplatePage` as the primary reference for assembling complex layouts.
-> - **Top-level only** - This is a full-screen layout component. Do not nest it inside other layouts.
-> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
-> - **Extend via TemplateContent** - To change showcased components, edit `TemplateContent`.
+import { Meta, Title, Subtitle } from '@storybook/addon-docs/blocks';
+import * as TemplatePageStories from './TemplatePage.stories';
+
+<Meta of={TemplatePageStories} />
+
+<Title>TemplatePage</Title>
+<Subtitle>Full application shell with the component kitchen-sink reference.</Subtitle>
+
+---
+
+## Overview
+
+`TemplatePage` is the reference implementation of the full application layout. It assembles:
+
+- **Sidebar** - Primary navigation.
+- **TemplateContent** - Kitchen-sink showcase of Xertica UI components.
+- **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 for avatar and user menu display. |
+| `onLogout` | `() => void` | Yes | Called when the user triggers logout from the Sidebar. |
+
+---
+
+## Composition
+
+```tsx
+import { TemplatePage } from 'xertica-ui';
+
+<Route
+  path="/template"
+  element={<TemplatePage user={currentUser} onLogout={handleLogout} />}
+/>
+```
+
+---
+
+## AI Best Practices
+
+> [!IMPORTANT]
+> - **Reference implementation** - Use `TemplatePage` as the primary reference for assembling complex layouts.
+> - **Top-level only** - This is a full-screen layout component. Do not nest it inside other layouts.
+> - **Provider fallback** - The page renders without `XerticaProvider`, but the provider is recommended for synchronized app layout.
+> - **Extend via TemplateContent** - To change showcased components, edit `TemplateContent`.

package/components/pages/template-page/template-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 { TemplatePage } from './TemplatePage';
 import React from 'react';

package/components/pages/verify-email-page/VerifyEmailPage.tsx

@@ -1,206 +1,104 @@
-import React, { useState } from 'react';
-import { Button } from '../../ui/button';
-import { XerticaLogo } from '../../brand/xertica-logo';
-import { ImageWithFallback } from '../../figma/ImageWithFallback';
-import { LanguageSelector } from '../../brand/language-selector';
-import { ArrowLeft, Mail, CheckCircle2, Lock } from 'lucide-react';
-import { useNavigate, useLocation } from 'react-router-dom';
-import { useTranslation } from 'react-i18next';
-
-/**
- * Email Verification Page component.
- *
- * @description
- * An informative screen shown after a password reset request. It instructs
- * the user to check their email and provides a "Resend email" feature.
- * Includes the same consistent layout with a hero image side-panel.
- *
- * @ai-rules
- * 1. Data Source: It retrieves the email from the router's `location.state`.
- * 2. Visual Feedback: Displays a temporary success message upon successful resale of the verification email.
- * 3. Navigation: Includes a link to return to the `LoginPage`.
- */
-export function VerifyEmailPage() {
-  const navigate = useNavigate();
-  const location = useLocation();
-  const { t } = useTranslation();
-  const email = location.state?.email || 'your@email.com';
-  const [isResending, setIsResending] = useState(false);
-  const [resendSuccess, setResendSuccess] = useState(false);
-
-  const handleResend = async () => {
-    setIsResending(true);
-    setResendSuccess(false);
-
-    // Simulate email resending
-    await new Promise(resolve => setTimeout(resolve, 1500));
-
-    setIsResending(false);
-    setResendSuccess(true);
-
-    // Remove success message after 3 seconds
-    setTimeout(() => setResendSuccess(false), 3000);
-  };
-
-  const handleSocialLogin = (_provider: string) => {
-    // Wire your SSO/social provider integration here
-  };
-
-  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-1563986768609-322da13575f3?w=1200&h=800&fit=crop&auto=format"
-          alt={t('verifyEmail.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 - Content */}
-      <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>
-
-            {/* Email icon */}
-            <div className="flex items-center justify-center mb-4">
-              <div className="p-4 bg-primary/10 rounded-[var(--radius)]">
-                <Mail className="w-12 h-12 text-primary" />
-              </div>
-            </div>
-
-            <h2 className="text-sm text-muted-foreground">{t('verifyEmail.heading')}</h2>
-            <p className="mt-2 text-muted-foreground">{t('verifyEmail.instructionsSent')}</p>
-            <p className="mt-1 text-primary">{email}</p>
-          </div>
-
-          {/* Instructions */}
-          <div className="bg-accent rounded-[var(--radius)] p-4 space-y-3">
-            <p className="text-muted-foreground">{t('verifyEmail.instructions')}</p>
-            <div className="flex items-start gap-2 text-muted-foreground">
-              <CheckCircle2 className="w-4 h-4 mt-0.5 flex-shrink-0 text-[var(--chart-2)]" />
-              <span className="text-sm">{t('verifyEmail.checkSpam')}</span>
-            </div>
-          </div>
-
-          {/* Success message on resend */}
-          {resendSuccess && (
-            <div className="bg-[var(--chart-2)]/10 border border-[var(--chart-2)]/20 rounded-[var(--radius)] p-3 flex items-center gap-2">
-              <CheckCircle2 className="w-5 h-5 text-[var(--chart-2)] flex-shrink-0" />
-              <span className="text-sm text-[var(--chart-2)]">
-                {t('verifyEmail.resentSuccess')}
-              </span>
-            </div>
-          )}
-
-          {/* Action buttons */}
-          <div className="space-y-3">
-            <p className="text-center text-muted-foreground">{t('verifyEmail.notReceived')}</p>
-            <Button
-              variant="outline"
-              className="w-full"
-              onClick={handleResend}
-              disabled={isResending}
-            >
-              {isResending ? t('verifyEmail.resending') : t('verifyEmail.resend')}
-            </Button>
-
-            <Button
-              type="button"
-              onClick={() => navigate('/login')}
-              variant="outline"
-              className="w-full text-muted-foreground hover:text-foreground"
-            >
-              <ArrowLeft className="w-4 h-4 mr-2" />
-              {t('verifyEmail.backToLogin')}
-            </Button>
-          </div>
-
-          {/* 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 { XerticaLogo } from '../../brand/xertica-logo';
+import { AuthPageShell, SocialLoginButtons } from '../../blocks/auth';
+import { ArrowLeft, Mail, CheckCircle2 } from 'lucide-react';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
+
+/**
+ * Email Verification Page component.
+ *
+ * @description
+ * An informative screen shown after a password reset request. It instructs
+ * the user to check their email and provides a "Resend email" feature.
+ * Includes the same consistent layout with a hero image side-panel.
+ *
+ * @ai-rules
+ * 1. Data Source: It retrieves the email from the router's `location.state`.
+ * 2. Visual Feedback: Displays a temporary success message upon successful resale of the verification email.
+ * 3. Navigation: Includes a link to return to the `LoginPage`.
+ */
+export function VerifyEmailPage() {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const { t } = useTranslation();
+  const email = location.state?.email || 'your@email.com';
+  const [isResending, setIsResending] = useState(false);
+  const [resendSuccess, setResendSuccess] = useState(false);
+
+  const handleResend = async () => {
+    setIsResending(true);
+    setResendSuccess(false);
+
+    // Simulate email resending
+    await new Promise(resolve => setTimeout(resolve, 1500));
+
+    setIsResending(false);
+    setResendSuccess(true);
+
+    // Remove success message after 3 seconds
+    setTimeout(() => setResendSuccess(false), 3000);
+  };
+
+  const handleSocialLogin = (_provider: string) => {
+    // Wire your SSO/social provider integration here
+  };
+
+  return (
+    <AuthPageShell
+      imageSrc="https://images.unsplash.com/photo-1563986768609-322da13575f3?w=1200&h=800&fit=crop&auto=format"
+      imageAlt={t('verifyEmail.heroImageAlt')}
+    >
+      <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>
+
+        <div className="flex items-center justify-center mb-4">
+          <div className="p-4 bg-primary/10 rounded-[var(--radius)]">
+            <Mail className="w-12 h-12 text-primary" />
+          </div>
+        </div>
+
+        <h2 className="text-sm text-muted-foreground">{t('verifyEmail.heading')}</h2>
+        <p className="mt-2 text-muted-foreground">{t('verifyEmail.instructionsSent')}</p>
+        <p className="mt-1 text-primary">{email}</p>
+      </div>
+
+      <div className="bg-accent rounded-[var(--radius)] p-4 space-y-3">
+        <p className="text-muted-foreground">{t('verifyEmail.instructions')}</p>
+        <div className="flex items-start gap-2 text-muted-foreground">
+          <CheckCircle2 className="w-4 h-4 mt-0.5 flex-shrink-0 text-[var(--chart-2)]" />
+          <span className="text-sm">{t('verifyEmail.checkSpam')}</span>
+        </div>
+      </div>
+
+      {resendSuccess && (
+        <div className="bg-[var(--chart-2)]/10 border border-[var(--chart-2)]/20 rounded-[var(--radius)] p-3 flex items-center gap-2">
+          <CheckCircle2 className="w-5 h-5 text-[var(--chart-2)] flex-shrink-0" />
+          <span className="text-sm text-[var(--chart-2)]">{t('verifyEmail.resentSuccess')}</span>
+        </div>
+      )}
+
+      <div className="space-y-3">
+        <p className="text-center text-muted-foreground">{t('verifyEmail.notReceived')}</p>
+        <Button variant="outline" className="w-full" onClick={handleResend} disabled={isResending}>
+          {isResending ? t('verifyEmail.resending') : t('verifyEmail.resend')}
+        </Button>
+
+        <Button
+          type="button"
+          onClick={() => navigate('/login')}
+          variant="outline"
+          className="w-full text-muted-foreground hover:text-foreground"
+        >
+          <ArrowLeft className="w-4 h-4 mr-2" />
+          {t('verifyEmail.backToLogin')}
+        </Button>
+      </div>
+
+      <SocialLoginButtons onSocialLogin={handleSocialLogin} />
+    </AuthPageShell>
+  );
+}