xertica-ui 2.0.6 → 2.1.0

package/CHANGELOG.md

@@ -19,6 +19,8 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   - **`QuickActionCard`** — tile de ação rápida com ícone em caixa colorida, badge e botão full-width.
   - **`NotificationCard`** — lista de notificações com indicador de não-lido, badge de tipo, "Marcar todas como lidas" e "Ver todas".
 - **Exportação do domínio `blocks/`** — todos os componentes disponíveis via `import { ... } from 'xertica-ui'` e via `components/blocks/index.ts`.
+- **Subpath público `xertica-ui/blocks`** — `FeatureCard`, `ActivityCard`, `ProfileCard`, `ProjectCard`, `QuickActionCard` e `NotificationCard` agora podem ser importados diretamente de `xertica-ui/blocks`.
+- **Subpath público `xertica-ui/pages`** — `LoginPage`, `HomePage`, `TemplatePage`, `ForgotPasswordPage`, `ResetPasswordPage`, `VerifyEmailPage` e seus contents agora são publicados com entrypoint dedicado.
 - **Documentação** — criado `docs/components/card-patterns.md` com props, exemplos e layout de dashboard completo para todos os 6 block components.
 
 ### Changed
@@ -28,6 +30,8 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - **Card stories** — enriquecidas com 3 novas variações: `WithAction` (uso de `CardAction` no header), `TeamMember` (grid de member cards com avatar e status), `SettingsCard` (lista de settings com `Separator` e `Badge`). Background `bg-muted` adicionado via decorator global da stories file para contraste com o fundo dos cards.
 - **Storybook — docs stories** — adicionado `render: (args) => <Component {...args} />` no nível do `meta` em todos os 60 arquivos de stories em `components/ui/`. Resolve o problema onde stories com apenas `args` (sem `render` explícito) mostravam a mesma variação repetida na aba Docs por dependerem do `projectAnnotations.render` implícito do framework React.
 - **Storybook — `preview.tsx`** — `min-h-screen` passou a ser condicional a `layout: 'fullscreen'`, resolvendo a altura excessiva dos exemplos na aba Docs.
+- **Template npm** — `templates/package.json` atualizado para `2.1.0` e dependência `xertica-ui` para `^2.1.0`.
+- **Template version badge** — o template passa a exibir um indicador visual discreto da versão do pacote `xertica-ui` usada pelo projeto.
 - **Documentação** — atualizados `calendar.md` (props `captionLayout`/`buttonVariant`, nota sobre `size` no trigger), `card.md` (`CardAction` na anatomia, exemplos WithAction/Stats/TeamMember/Settings), `chart.md` (nova seção Stacked Bar Chart), `architecture.md` (domínio `blocks/` com árvore de arquivos).
 
 ### Fixed

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.0.6-blue)](https://www.npmjs.com/package/xertica-ui)
+[![npm version](https://img.shields.io/badge/npm-2.1.0-blue)](https://www.npmjs.com/package/xertica-ui)
 [![license](https://img.shields.io/badge/license-proprietary-red)](./LICENSE)
 
 ---
@@ -85,12 +85,14 @@ function App() {
 Xertica UI v2 exposes **granular subpath entries** — import only what your layer needs without loading the entire library:
 
 ```tsx
-import { Button, Card, Input }       from 'xertica-ui/ui';        // shared/ui — primitives
-import { Sidebar, Header }           from 'xertica-ui/layout';    // layout shell
+import { Button, Card, Input }       from 'xertica-ui/ui';        // shared/ui — primitives
+import { QuickActionCard }           from 'xertica-ui/blocks';    // composed blocks
+import { Sidebar, Header }           from 'xertica-ui/layout';    // layout shell
 import { XerticaProvider }           from 'xertica-ui/brand';     // app-level — providers & brand
 import { XerticaAssistant }          from 'xertica-ui/assistant'; // feature — AI assistant
 import { VideoPlayer, AudioPlayer }  from 'xertica-ui/media';     // feature — media players
 import { useLayout, useOptionalLayout, useTheme } from 'xertica-ui/hooks'; // shared/lib — hooks & contexts
+import { TemplatePage }              from 'xertica-ui/pages';     // optional page templates
 import 'xertica-ui/style.css';                                     // styles — import once at root
 ```
 
@@ -175,7 +177,7 @@ Each feature only imports from `shared/` or its own domain. Pages only compose f
 
 ---
 
-## 🧩 Component Catalog (97 Components)
+## 🧩 Component Catalog (100+ Components)
 
 ### Layout & Navigation
 `Header` · `Sidebar` · `PageHeader` · `Breadcrumb` · `NavigationMenu` · `Tabs` · `Pagination` · `Accordion` · `Collapsible`
@@ -189,8 +191,11 @@ Each feature only imports from `shared/` or its own domain. Pages only compose f
 ### Actions & Data
 `Button` · `Toggle` · `ToggleGroup` · `Rating` · `Table` · `Badge` · `Avatar` · `Progress` · `StatsCard` · `Timeline` · `Stepper` · `TreeView` · `NotificationBadge` · `Chart`
 
-### Overlays & Feedback
-`Dialog` · `AlertDialog` · `Sheet` · `Drawer` · `Popover` · `HoverCard` · `Tooltip` · `Alert` · `Sonner (Toast)` · `Command`
+### Overlays & Feedback
+`Dialog` · `AlertDialog` · `Sheet` · `Drawer` · `Popover` · `HoverCard` · `Tooltip` · `Alert` · `Sonner (Toast)` · `Command`
+
+### Composed Blocks
+`FeatureCard` · `ActivityCard` · `ProfileCard` · `ProjectCard` · `QuickActionCard` · `NotificationCard`
 
 ---
 
@@ -207,6 +212,15 @@ First-class Google Maps integration.
 ### 🎙️ Media
 - `AudioPlayer` · `VideoPlayer` · `FloatingMediaWrapper`
 
+### 📄 Pages
+- `LoginPage` · `HomePage` · `TemplatePage` · `ForgotPasswordPage` · `ResetPasswordPage` · `VerifyEmailPage`
+
+### 🧱 Blocks
+High-level dashboard and product patterns exported from `xertica-ui/blocks`.
+- `FeatureCard` · `ActivityCard` · `ProfileCard` · `ProjectCard` · `QuickActionCard` · `NotificationCard`
+
+The CLI template now includes a small fixed version badge so generated projects can visually identify which `xertica-ui` package version they are using.
+
 ---
 
 ## 📚 Storybook Documentation

package/components/hooks/index.ts

@@ -4,3 +4,4 @@ export * from '../../contexts/LanguageContext';
 export * from '../../contexts/BrandColorsContext';
 export * from '../../contexts/AssistenteContext';
 export * from '../../contexts/ApiKeyContext';
+export { useMobile, useIsMobile } from '../shared/use-mobile';

package/components/index.ts

@@ -30,16 +30,10 @@ export type {
 } from './assistant/xertica-assistant/xertica-assistant';
 
 // ============================================================================
-// Page Components
-// ============================================================================
-
-export { TemplatePage } from './pages/template-page';
-export { HomePage } from './pages/home-page';
-export { LoginPage } from './pages/login-page';
-export { HomeContent } from './pages/home-content';
-export { ForgotPasswordPage } from './pages/forgot-password-page';
-export { VerifyEmailPage } from './pages/verify-email-page';
-export { ResetPasswordPage } from './pages/reset-password-page';
+// Page Components
+// ============================================================================
+
+export * from './pages';
 
 // UI Components - All available via /components/ui/index.ts
 export * from './ui';
@@ -80,4 +74,4 @@ export { FloatingMediaWrapper } from './media/FloatingMediaWrapper';
 // PodcastPlayer was consolidated into AudioPlayer via colorVariant="primary" prop
 
 // Demo utilities (for templates)
-export { gerarResposta, gerarResposta as generateDemoResponse } from './shared/assistant-utils';
+export { gerarResposta, gerarResposta as generateDemoResponse } from './shared/assistant-utils';

package/components/pages/index.ts

@@ -0,0 +1,8 @@
+export * from './forgot-password-page';
+export * from './home-content';
+export * from './home-page';
+export * from './login-page';
+export * from './reset-password-page';
+export * from './template-content';
+export * from './template-page';
+export * from './verify-email-page';

package/components/public-api-smoke.test.tsx

@@ -4,10 +4,12 @@ import { renderHook } from '@testing-library/react';
 import { describe, expect, it } from 'vitest';
 import * as Root from './index';
 import * as Assistant from './assistant';
+import * as Blocks from './blocks';
 import * as Brand from './brand';
 import * as Hooks from './hooks';
 import * as Layout from './layout';
 import * as Media from './media';
+import * as Pages from './pages';
 import * as UI from './ui';
 
 describe('public API smoke tests', () => {
@@ -16,8 +18,13 @@ describe('public API smoke tests', () => {
     expect(Brand.XerticaProvider).toBeTypeOf('function');
     expect(Layout.Header).toBeTypeOf('function');
     expect(Assistant.XerticaAssistant).toBeTypeOf('function');
+    expect(Blocks.FeatureCard).toBeTypeOf('function');
     expect(Media.AudioPlayer).toBeTypeOf('function');
+    expect(Pages.TemplateContent).toBeTypeOf('function');
+    expect(UI.CalendarDayButton).toBeTypeOf('function');
     expect(Hooks.useOptionalLayout).toBeTypeOf('function');
+    expect(Hooks.useMobile).toBeTypeOf('function');
+    expect(Root.TemplateContent).toBe(Pages.TemplateContent);
     expect(Root.XerticaProvider).toBe(Brand.XerticaProvider);
   });
 

package/components/ui/index.ts

@@ -243,5 +243,71 @@ export type {
 // Hooks
 export { useMobile, useIsMobile } from "../shared/use-mobile";
 
-// Image Utilities
+// Image Utilities
 export { ImageWithFallback } from "../figma/ImageWithFallback";
+
+// Complete component folder re-exports
+export * from "./accordion";
+export * from "./alert";
+export * from "./alert-dialog";
+export * from "./aspect-ratio";
+export * from "./assistant-chart";
+export * from "./avatar";
+export * from "./badge";
+export * from "./breadcrumb";
+export * from "./button";
+export * from "./calendar";
+export * from "./card";
+export * from "./carousel";
+export * from "./chart";
+export * from "./checkbox";
+export * from "./collapsible";
+export * from "./command";
+export * from "./context-menu";
+export * from "./dialog";
+export * from "./drawer";
+export * from "./dropdown-menu";
+export * from "./empty";
+export * from "./file-upload";
+export * from "./form";
+export * from "./google-maps-loader";
+export * from "./hover-card";
+export * from "./input";
+export * from "./input-otp";
+export * from "./label";
+export * from "./map";
+export * from "./map-config";
+export * from "./map-layers";
+export * from "./map.exports";
+export * from "./menubar";
+export * from "./navigation-menu";
+export * from "./notification-badge";
+export * from "./page-header";
+export * from "./pagination";
+export * from "./popover";
+export * from "./progress";
+export * from "./radio-group";
+export * from "./rating";
+export * from "./resizable";
+export * from "./rich-text-editor";
+export * from "./route-map";
+export * from "./scroll-area";
+export * from "./search";
+export * from "./select";
+export * from "./separator";
+export * from "./sheet";
+export * from "./simple-map";
+export * from "./skeleton";
+export * from "./slider";
+export * from "./sonner";
+export * from "./stats-card";
+export * from "./stepper";
+export * from "./switch";
+export * from "./table";
+export * from "./tabs";
+export * from "./textarea";
+export * from "./timeline";
+export * from "./toggle";
+export * from "./toggle-group";
+export * from "./tooltip";
+export * from "./tree-view";