xertica-ui 2.6.0 → 2.8.0

package/CHANGELOG.md

@@ -11,6 +11,40 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [2.8.0] — 2026-07-09
+
+### Added
+
+- **Novo tema `xertica`** — a nova identidade visual da Xertica (papel quente `#FFFEF8`, tintas vivas e o preto da marca como acento geral), somando-se aos temas já existentes em `contexts/theme-data.ts` → `colorThemes`. Botões neste tema ganham radius pill (`buttonRadius: '9999px'`), stroke em todas as variantes preenchidas (`buttonStrokeWidth`/`buttonStrokeColor(Dark)`), botão primário amarelo (`#FAF338`) com contorno e texto pretos, e botão secundário na cor preta da marca (`buttonSecondaryBg(Dark)`/`buttonSecondaryForeground(Dark)`). O amarelo é **intencionalmente restrito** ao botão `default` e ao estado ligado do `Switch` — o acento geral do tema (`--primary`, usado por links, radio buttons, foco, logo, etc.) é Negro Xertica `#1E1E1E` (Crema `#F2EDD8` no dark mode), evitado de virar amarelo sem contraste em elementos que não são botão/switch. O tema `xertica-original` (agora exibido como **"Xertica Classic"**) permanece o padrão — o `id` não foi alterado, então projetos scaffolded e chamadas `setTheme('xertica-original')` continuam funcionando sem mudanças.
+- **`BrandColors` ganha campos opcionais de forma/estrutura de botão** — `backgroundLight`, `buttonRadius`, `buttonStrokeWidth`, `buttonStrokeColor`/`buttonStrokeColorDark`, `buttonSecondaryBg`/`buttonSecondaryBgDark`, `buttonSecondaryForeground`/`buttonSecondaryForegroundDark`, e `buttonPrimaryBg`/`buttonPrimaryBgDark`, `buttonPrimaryForeground`/`buttonPrimaryForegroundDark` (acento do botão `default` e do `Switch`, com fallback para `var(--primary)`/`var(--primary-foreground)`). Todos são opcionais e têm fallback idêntico ao comportamento anterior, então os 9 temas pré-existentes ficam pixel-idênticos. Removido o campo morto `radius?: string` (nunca lido por `applyColors()`).
+- **`components/ui/button/button.tsx`** — as variantes preenchidas (`default`, `destructive`, `secondary`, `success`, `info`, `warning`) agora aceitam um stroke via `--button-stroke-width`/`--button-stroke-color`; a variante `default` passou a usar `--button-primary-bg`/`--button-primary-foreground` (em vez de `bg-primary`/`text-primary-foreground` direto) para permitir um acento de botão distinto do `--primary` semântico geral; a variante `secondary` passou a usar os tokens `--button-secondary-bg`/`--button-secondary-foreground` (com fallback para `--secondary`/`--secondary-foreground`) em vez do modificador de opacidade `/80`, que não funcionava sobre cores vindas de `var()`.
+- **`components/ui/switch/switch.tsx`** — o estado marcado (`checked`) passou a usar `--button-primary-bg` em vez de `bg-primary`, para acompanhar o mesmo acento do botão `default`.
+
+### Changed
+
+- `bin/generate-tokens.ts` e os `tokens.css` estáticos (`styles/xertica/`, `templates/src/styles/xertica/`) passam a emitir `--button-stroke-width`, `--button-stroke-color`, `--button-secondary-bg`, `--button-secondary-foreground`, `--button-primary-bg`, `--button-primary-foreground`, e `--radius-button`/`--background` (light) respeitam os novos campos do tema quando definidos.
+- `.storybook/preview.tsx` — toolbar "Brand Color" renomeia `xertica-original` para "Xertica Classic" e adiciona a entrada "Xertica" (`xertica`).
+
+---
+
+## [2.7.0] — 2026-07-07
+
+### Added
+
+- **`xertica-ui/blocks` ganha um novo namespace `auth`** — `AuthPageShell` (layout de imagem hero + seletor de idioma + painel de formulário centralizado), `SocialLoginButtons` (com prop `providers` configurável, default `['google', 'mtLogin', 'govBr']`, para projetos que não usam todos os provedores de login social), `usePasswordStrength` e `PasswordStrengthMeter`. Extraídos da duplicação entre `components/pages/{login,forgot-password,reset-password,verify-email}-page/*` e `templates/src/features/auth/ui/*`, que agora consomem a mesma fonte via `xertica-ui/blocks`.
+
+### Fixed
+
+- **Assistente de IA — clique numa sugestão inicial rolava a página e deslocava o header** — o efeito de auto-scroll de `use-assistant.ts` media `messagesEndRef.current.parentElement` (uma `<div>` sem overflow próprio) em vez do viewport real do `ScrollArea` do Radix, fazendo a checagem "está perto do fim da rolagem" ser sempre verdadeira — inclusive na primeira mensagem, na transição da tela de boas-vindas para a conversa. Sem `block: 'nearest'`, o `scrollIntoView` podia rolar a janela inteira. Corrigido para medir o `[data-radix-scroll-area-viewport]` correto e conter o scroll dentro dele.
+- **`components/pages/forgot-password-page/ForgotPasswordPage.tsx` tinha texto hardcoded em português**, sem passar por `useTranslation()` como as demais páginas de auth. Convertido para `t('forgotPassword.xxx')`, com as chaves adicionadas em `locales/*/pages/forgotPassword.json` (en/es/pt-BR) na raiz.
+
+### Changed
+
+- **`templates/src/features/home` e `templates/src/features/template` reduzidos a placeholders mínimos** — esse conteúdo é vitrine de exemplo, feito para ser substituído pelo consumidor do `npx xertica-ui init`, não para ficar sincronizado com a lib. Removido código morto (`CrudTemplate`, `DashboardTemplate`, `FormTemplate`, `LoginTemplate`, `dashboardStore`, `mock.ts`, `useFeatureCards`) e os locales órfãos correspondentes nos 3 idiomas.
+- Removidos `templates/vite.config.js`/`vite.config.d.ts` — artefatos de build obsoletos e versionados por engano desde a v2.1.0, que faziam o Vite carregar uma versão desatualizada da config (sem os aliases de desenvolvimento do monorepo) em vez do `vite.config.ts` atual.
+
+---
+
 ## [2.6.0] — 2026-07-06
 
 ### Security

package/README.md

@@ -2,7 +2,7 @@
 
 > **Enterprise-grade React design system** built on Tailwind CSS v4, Radix UI, and Lucide Icons — with a robust AI-first documentation layer for precise LLM-driven composition and autonomous agent interaction.
 
-[![npm version](https://img.shields.io/badge/npm-2.6.0-blue)](https://www.npmjs.com/package/xertica-ui)
+[![npm version](https://img.shields.io/badge/npm-2.7.0-blue)](https://www.npmjs.com/package/xertica-ui)
 [![license](https://img.shields.io/badge/license-proprietary-red)](./LICENSE)
 
 ---
@@ -353,11 +353,12 @@ Xertica UI uses semantic CSS tokens. **Never use raw colors or generic Tailwind
 
 ### Color Themes
 
-Nine built-in themes — each sets the primary color, sidebar, chart palette, and dark-mode surface hue. Select at `init` time or change later with `npx xertica-ui update → Theme only`.
+Ten built-in themes — each sets the primary color, sidebar, chart palette, and dark-mode surface hue. Select at `init` time or change later with `npx xertica-ui update → Theme only`.
 
 | Theme | ID | Primary | Sidebar | Dark bg |
 |---|---|---|---|---|
-| ![#2C275B](https://img.shields.io/badge/-%232C275B-2C275B?style=flat-square) Xertica | `xertica-original` | `#2C275B` | `#2C275B` | `#05050d` |
+| ![#2C275B](https://img.shields.io/badge/-%232C275B-2C275B?style=flat-square) Xertica Classic | `xertica-original` | `#2C275B` | `#2C275B` | `#05050d` |
+| ![#1E1E1E](https://img.shields.io/badge/-%231E1E1E-1E1E1E?style=flat-square) Xertica | `xertica` | `#1E1E1E` | `#1E1E1E` | `#141311` |
 | ![#18181B](https://img.shields.io/badge/-%2318181B-18181B?style=flat-square) Zinc | `zinc` | `#18181B` | `#18181B` | `#05050d` |
 | ![#0F172A](https://img.shields.io/badge/-%230F172A-0F172A?style=flat-square) Slate | `slate` | `#0F172A` | `#0F172A` | `#05050d` |
 | ![#2563EB](https://img.shields.io/badge/-%232563EB-2563EB?style=flat-square) Blue | `blue` | `#2563EB` | `#1E3A8A` | `#03050f` |
@@ -369,6 +370,8 @@ Nine built-in themes — each sets the primary color, sidebar, chart palette, an
 
 > Each badge renders the **exact primary color** of that theme as a filled swatch. Generated by the CLI and stored in `src/styles/xertica/tokens.css`.
 
+**"Xertica" theme — serigrafia identity:** pill-shaped buttons (`--radius-button: 9999px`) and a visible stroke on every filled button variant. The general brand accent (`--primary`, used by links, focus rings, radio buttons, the logo, etc.) is Negro Xertica (`#1E1E1E`, `#F2EDD8` in dark mode) for reliable contrast everywhere. Yellow (`#FAF338`) is intentionally scoped to just two controls — the `Button` `default` variant and `Switch`'s checked state — via the `--button-primary-bg`/`--button-primary-foreground` tokens, both with black text/outline. The `secondary` button is black (`#1E1E1E`). The page background uses a warm off-white paper tone (`#FFFEF8`) while cards stay pure white. The full accent palette (and the "serigrafia" color-intersection combinations meant for print/marketing pieces — e.g. Celeste `#1899AF` + Magenta `#C45BAA` → Violeta `#5A4A96`) is documented in `contexts/theme-data.ts`.
+
 **CLI — Select at project creation:**
 
 ```bash
@@ -381,7 +384,7 @@ npx xertica-ui@latest init my-app
 ```bash
 npx xertica-ui update
 # → choose "Theme only"
-# → select any of the 9 themes
+# → select any of the 10 themes
 # → src/styles/xertica/tokens.css is fully regenerated
 # → .xertica.json is updated with the new themeId for future updates
 ```
@@ -396,6 +399,7 @@ npx xertica-ui update
 <XerticaProvider defaultColorTheme="violet">
 <XerticaProvider defaultColorTheme="amber">
 <XerticaProvider defaultColorTheme="orange">
+<XerticaProvider defaultColorTheme="xertica"> {/* new serigrafia identity */}
 <XerticaProvider defaultColorTheme="xertica-original"> {/* default */}
 
 // Custom hex — sets primary only; dark surfaces use the neutral default
@@ -414,7 +418,8 @@ npx xertica-ui update
 | `--card`, `--popover`| ✅ Dark mode only (hue-tinted) |
 | `--muted`, `--accent`| ✅ Dark mode only (hue-tinted) |
 | `--border`, `--input`| ✅ Dark mode only (hue-tinted) |
-| Light mode surfaces  | ❌ Always white/zinc (unchanged) |
+| Light mode surfaces  | ❌ Always white/zinc, unless the theme sets `backgroundLight` (only `xertica` does) |
+| `--radius-button`, button stroke, `secondary` button colors | ✅ Only when the theme defines `buttonRadius`/`buttonStroke*`/`buttonSecondary*` (only `xertica` does) |
 
 ### Mobile Content Padding
 
@@ -467,13 +472,16 @@ See [`docs/i18n.md`](./docs/i18n.md) for setup, runtime configuration, and addin
 
 ## 📜 Scripts
 
-| Command              | Description                            |
-| -------------------- | -------------------------------------- |
-| `npm run dev`        | Start development server               |
-| `npm run build`      | Production bundle                      |
-| `npm run storybook`  | Launch component library documentation |
-| `npm run test`       | Run unit tests via Vitest              |
-| `npm run type-check` | TypeScript validation                  |
+| Command               | Description                                                                                                                                                     |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `npm run dev`         | Runs the `templates/` scaffold with live Design System source (via monorepo alias) — the same app a `npx xertica-ui init` consumer gets. Use this to test Design System changes against real pages. |
+| `npm run dev:pages`   | Runs the root harness (`App.tsx`) for the standalone `xertica-ui/pages` showcase subpath.                                                                       |
+| `npm run build`       | Production bundle                                                                                                                                                |
+| `npm run storybook`   | Launch component library documentation                                                                                                                          |
+| `npm run test`        | Run unit tests via Vitest                                                                                                                                       |
+| `npm run type-check`  | TypeScript validation                                                                                                                                            |
+
+> **Note**: `templates/` has its own dependencies — run `npm install` inside `templates/` once before the first `npm run dev`.
 
 ---
 

package/bin/generate-tokens.ts

@@ -42,13 +42,13 @@ export const generateTokensCss = (theme: ColorTheme): string => {
   --xertica-dark: ${rgba(colors.sidebarDark)};
   
   /* Semantic Colors */
-  --background: rgba(255, 255, 255, 1);
+  --background: ${colors.backgroundLight ? rgba(colors.backgroundLight) : 'rgba(255, 255, 255, 1)'};
   --foreground: rgba(9, 9, 11, 1);
-  
-  --card: rgba(255, 255, 255, 1);
+
+  --card: ${colors.cardLight ? rgba(colors.cardLight) : 'rgba(255, 255, 255, 1)'};
   --card-foreground: rgba(9, 9, 11, 1);
-  
-  --popover: rgba(255, 255, 255, 1);
+
+  --popover: ${colors.cardLight ? rgba(colors.cardLight) : 'rgba(255, 255, 255, 1)'};
   --popover-foreground: rgba(9, 9, 11, 1);
   
   --primary: var(--xertica-primary);
@@ -59,7 +59,7 @@ export const generateTokensCss = (theme: ColorTheme): string => {
   --secondary: rgba(244, 244, 245, 1);
   --secondary-foreground: rgba(24, 24, 27, 1);
   
-  --muted: rgba(244, 244, 245, 1);
+  --muted: ${colors.backgroundLight ? rgba(colors.backgroundLight) : 'rgba(244, 244, 245, 1)'};
   --muted-foreground: rgba(113, 113, 122, 1);
   
   --accent: rgba(244, 244, 245, 1);
@@ -77,6 +77,7 @@ export const generateTokensCss = (theme: ColorTheme): string => {
   --warning-foreground: rgba(28, 25, 23, 1);
   
   --border: rgba(228, 228, 231, 1);
+  --input-border: ${colors.inputBorderColor || 'var(--border)'};
   --input: rgba(244, 244, 245, 0.5);
   --input-background: rgba(244, 244, 245, 0.5);
   --ring: ${rgba(colors.primary, 0.5)};
@@ -106,9 +107,17 @@ export const generateTokensCss = (theme: ColorTheme): string => {
   
   /* Spacing & Radius */
   --radius: 6px;
-  --radius-button: 12px;
+  --radius-button: ${colors.buttonRadius || '12px'};
   --radius-card: 12px;
-  
+
+  /* Button stroke & secondary (theme-overridable; defaults preserve the flat look) */
+  --button-stroke-width: ${colors.buttonStrokeWidth || '0px'};
+  --button-stroke-color: ${colors.buttonStrokeColor || 'transparent'};
+  --button-secondary-bg: ${colors.buttonSecondaryBg || 'var(--secondary)'};
+  --button-secondary-foreground: ${colors.buttonSecondaryForeground || 'var(--secondary-foreground)'};
+  --button-primary-bg: ${colors.buttonPrimaryBg || 'var(--primary)'};
+  --button-primary-foreground: ${colors.buttonPrimaryForeground || 'var(--primary-foreground)'};
+
   --elevation-sm: 0px 0px 48px 0px rgba(0, 0, 0, 0.1);
   
   /* Typography */
@@ -209,7 +218,14 @@ export const generateTokensCss = (theme: ColorTheme): string => {
   --input: ${rgba(colors.darkMuted, 0.5)};
   --input-background: ${rgba(colors.darkMuted, 0.5)};
   --ring: ${rgba(colors.primaryDarkMode, 0.5)};
-  
+
+  /* Button stroke & secondary (theme-overridable; defaults preserve the flat look) */
+  --button-stroke-color: ${colors.buttonStrokeColorDark || colors.buttonStrokeColor || 'transparent'};
+  --button-secondary-bg: ${colors.buttonSecondaryBgDark || colors.buttonSecondaryBg || 'var(--secondary)'};
+  --button-secondary-foreground: ${colors.buttonSecondaryForegroundDark || colors.buttonSecondaryForeground || 'var(--secondary-foreground)'};
+  --button-primary-bg: ${colors.buttonPrimaryBgDark || colors.buttonPrimaryBg || 'var(--primary)'};
+  --button-primary-foreground: ${colors.buttonPrimaryForegroundDark || colors.buttonPrimaryForeground || 'var(--primary-foreground)'};
+
   --elevation-sm: 0px 0px 48px 0px rgba(0, 0, 0, 0.3);
 
   /* Charts — dark mode: slightly lighter/more saturated for contrast on dark bg */

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

@@ -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]);

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

@@ -441,7 +441,7 @@ export function XerticaAssistant({
       {/* Main Assistant Container */}
       <div
         className={cn(
-          `${containerHeight} flex flex-col bg-background relative`,
+          `${containerHeight} flex flex-col bg-card relative`,
           !isFullPage && 'border-l border-border shadow-sm',
           isMobile && isExpanded && 'fixed inset-0 z-[100] h-[100dvh] w-full border-l-0 shadow-2xl',
           className

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

@@ -1,13 +1,18 @@
 import React from 'react';
-import { ImageWithFallback } from 'xertica-ui/ui';
-import { LanguageSelector } from 'xertica-ui/brand';
+import { ImageWithFallback } from '../../figma/ImageWithFallback';
+import { LanguageSelector } from '../../brand/language-selector';
 
-interface AuthPageShellProps {
+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">

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]);
+}

package/components/blocks/index.ts

@@ -1 +1,2 @@
 export * from './card-patterns';
+export * from './auth';

package/components/pages/forgot-password-page/ForgotPasswordPage.tsx

@@ -3,10 +3,10 @@ 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 { ArrowLeft, Lock } from 'lucide-react';
+import { AuthPageShell, SocialLoginButtons } from '../../blocks/auth';
+import { ArrowLeft } from 'lucide-react';
 import { useNavigate } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
 
 /**
  * Forgot Password Page component.
@@ -22,6 +22,7 @@ import { useNavigate } from 'react-router-dom';
  */
 export function ForgotPasswordPage() {
   const navigate = useNavigate();
+  const { t } = useTranslation();
   const [email, setEmail] = useState('');
   const [isLoading, setIsLoading] = useState(false);
 
@@ -43,146 +44,51 @@ export function ForgotPasswordPage() {
   };
 
   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-1557804506-669a67965ba0?w=1200&h=800&fit=crop&auto=format"
-          alt="Segurança e tecnologia"
-          className="absolute inset-0 w-full h-full object-cover"
-        />
-
-        {/* Gradient overlay */}
-        <div className="absolute inset-0 bg-[image:var(--gradient-diagonal)] opacity-80" />
+    <AuthPageShell
+      imageSrc="https://images.unsplash.com/photo-1557804506-669a67965ba0?w=1200&h=800&fit=crop&auto=format"
+      imageAlt={t('forgotPassword.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>
+        <h2 className="text-sm text-muted-foreground">{t('forgotPassword.heading')}</h2>
+        <p className="mt-2 text-muted-foreground">{t('forgotPassword.subheading')}</p>
       </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} />
+      <form className="space-y-6" onSubmit={handleSubmit}>
+        <div className="form-group space-y-2">
+          <Label htmlFor="email">{t('forgotPassword.emailLabel')}</Label>
+          <Input
+            id="email"
+            name="email"
+            type="email"
+            required
+            className="w-full"
+            placeholder={t('forgotPassword.emailPlaceholder')}
+            value={email}
+            onChange={e => setEmail(e.target.value)}
+          />
         </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">Recuperar senha</h2>
-            <p className="mt-2 text-muted-foreground">
-              Digite seu e-mail e enviaremos as instruções para redefinir sua senha
-            </p>
-          </div>
-
-          {/* Form */}
-          <form className="space-y-6" onSubmit={handleSubmit}>
-            <div className="form-group space-y-2">
-              <Label htmlFor="email" className="form-label">
-                E-mail
-              </Label>
-              <Input
-                id="email"
-                name="email"
-                type="email"
-                required
-                className="w-full"
-                placeholder="seu@email.com"
-                value={email}
-                onChange={e => setEmail(e.target.value)}
-              />
-            </div>
-
-            <div className="space-y-3">
-              <Button type="submit" className="w-full" disabled={isLoading}>
-                {isLoading ? 'Enviando...' : 'Enviar instruções'}
-              </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" />
-                Voltar para o login
-              </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">ou continue com</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>Entrar com Google</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>Entrar com MT Login</span>
-            </Button>
-
-            {/* gov.br */}
-            <Button
-              type="button"
-              variant="outline"
-              className="w-full justify-center font-normal"
-              onClick={() => handleSocialLogin('gov.br')}
-            >
-              <span>
-                Entrar com <strong className="font-semibold">gov.br</strong>
-              </span>
-            </Button>
-          </div>
+        <div className="space-y-3">
+          <Button type="submit" className="w-full" disabled={isLoading}>
+            {isLoading ? t('forgotPassword.submitting') : t('forgotPassword.submit')}
+          </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('forgotPassword.backToLogin')}
+          </Button>
         </div>
-      </div>
-    </div>
+      </form>
+
+      <SocialLoginButtons onSocialLogin={handleSocialLogin} />
+    </AuthPageShell>
   );
 }