xertica-ui 2.6.0 → 2.7.0

package/CHANGELOG.md

@@ -11,6 +11,24 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [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)
 
 ---

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/{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>
   );
 }