@datametria/vue-components 1.1.3 → 1.2.0

package/README.md

@@ -3,25 +3,29 @@
 [![npm version](https://img.shields.io/npm/v/@datametria/vue-components.svg)](https://www.npmjs.com/package/@datametria/vue-components)
 [![npm downloads](https://img.shields.io/npm/dm/@datametria/vue-components.svg)](https://www.npmjs.com/package/@datametria/vue-components)
 [![License](https://img.shields.io/npm/l/@datametria/vue-components)](https://github.com/datametria/DATAMETRIA-common-libraries/blob/main/LICENSE)
-[![Coverage](https://img.shields.io/badge/coverage-95%2B%25-brightgreen)](/docs/packages/vue-components/PROGRESS.md)
-[![Tests](https://img.shields.io/badge/tests-499%20passing-brightgreen)](/docs/packages/vue-components/TEST-RESULTS.md)
+[![Coverage](https://img.shields.io/badge/coverage-82%2B%25-brightgreen)](/docs/packages/vue-components/PROGRESS.md)
+[![Tests](https://img.shields.io/badge/tests-514%20passing-brightgreen)](/docs/packages/vue-components/TEST-RESULTS.md)
+[![Variants](https://img.shields.io/badge/variants-standardized-blue)](/docs/operations/variant-migration-guide.md)
 
 > **Biblioteca enterprise de componentes Vue.js 3 com 100% conformidade UX/UI DATAMETRIA**
 >
-> 40 módulos • Design System completo • WCAG 2.1 AA • Dark Mode nativo • Sistema responsivo avançado • Micro-interações modernas • 200+ testes
+> 40 módulos • **Variants padronizados** • Design System completo • WCAG 2.1 AA • Dark Mode nativo • Sistema responsivo avançado • Micro-interações modernas • 514 testes
 
 ## 🏆 Features Enterprise (100% Conformidade UX/UI)
 
-### ✅ **4 Sprints Implementados**
+### ✅ **4 Sprints Implementados + Variants Padronizados**
 - 🎨 **Sprint 1:** Design System Enhancement (gradientes, bordas, dark mode, escalabilidade)
 - 🧩 **Sprint 2:** Componentes Críticos (TimePicker, Slider, Tooltip, Menu)
 - ⚡ **Sprint 3:** Micro-interações (shimmer, ripple, haptic feedback)
 - 📱 **Sprint 4:** Responsividade Avançada (6 breakpoints, typography fluida, container queries)
+- 🎯 **Variants v1.2.0:** Padronização completa de variants com primary em todos os componentes
 
 ### 🎯 **Qualidade Enterprise**
 - **40 módulos** (30 componentes + 10 composables)
-- **200+ testes** com 100% success rate
-- **95%+ coverage** em todos os módulos
+- **514 testes** com 100% success rate
+- **82%+ coverage** geral (100% nos componentes principais)
+- **Variants padronizados** - Primary variant em todos os componentes
+- **Validação runtime** - Warnings em desenvolvimento para variants inválidos
 - **WCAG 2.1 AA** com escalabilidade controlada (0.8x-2.0x)
 - **Performance otimizada** para produção
 - **TypeScript completo** com inferência automática
@@ -93,6 +97,56 @@ const handleLogin = () => {
 </template>
 ```
 
+## 🎯 Guia Rápido de Variants
+
+### ✅ **Todos os Componentes Suportam `primary`**
+
+```vue
+<!-- ✅ CORRETO - Primary variant disponível em todos -->
+<DatametriaButton variant="primary">Botão Principal</DatametriaButton>
+<DatametriaAlert variant="primary" message="Alerta importante" />
+<DatametriaNavbar variant="primary" brand="DATAMETRIA" />
+<DatametriaToast variant="primary" message="Notificação" />
+<DatametriaBadge variant="primary" label="Novo" />
+<DatametriaChip variant="primary" label="Tag" />
+```
+
+### ⚠️ **Breaking Changes v1.2.0**
+
+```vue
+<!-- ❌ ANTES (v1.1.x) -->
+<DatametriaChip variant="default">Chip</DatametriaChip>
+<DatametriaToast variant="info" message="Azul" />
+
+<!-- ✅ DEPOIS (v1.2.0) -->
+<DatametriaChip variant="primary">Chip</DatametriaChip>
+<DatametriaToast variant="primary" message="Azul" />
+<DatametriaToast variant="info" message="Cinza" />
+```
+
+### 🛡️ **Validação Automática**
+
+```vue
+<!-- ❌ Variant inválido -->
+<DatametriaButton variant="invalid">Botão</DatametriaButton>
+<!-- Console: [DatametriaButton] Invalid variant "invalid". Valid options: primary, secondary, outline, ghost -->
+
+<!-- ✅ Variants válidos por componente -->
+<DatametriaButton variant="primary | secondary | outline | ghost" />
+<DatametriaAlert variant="primary | success | error | warning | info" />
+<DatametriaNavbar variant="primary | light | dark | transparent" />
+```
+
+### 📚 **Migração Rápida**
+
+```bash
+# Script automático de migração
+curl -o migrate.sh https://raw.githubusercontent.com/datametria/vue-components/main/scripts/migrate-variants.sh
+chmod +x migrate.sh && ./migrate.sh
+```
+
+**📖 [Guia Completo de Migração](../operations/variant-migration-guide.md)**
+
 ## 🎨 Componentes (30 implementados)
 
 ### 🌟 **Novos Componentes dos Sprints**
@@ -105,10 +159,13 @@ const handleLogin = () => {
 ### 🔘 Form Components (10)
 
 ```vue
-<!-- Button com 4 variants e 3 sizes -->
+<!-- Button com 4 variants padronizados -->
 <DatametriaButton variant="primary" size="md" :loading="false">
-  Clique aqui
+  Primary Button
 </DatametriaButton>
+<DatametriaButton variant="secondary">Secondary</DatametriaButton>
+<DatametriaButton variant="outline">Outline</DatametriaButton>
+<DatametriaButton variant="ghost">Ghost</DatametriaButton>
 
 <!-- Input com validação -->
 <DatametriaInput 
@@ -185,19 +242,23 @@ const handleLogin = () => {
 ### 🔔 Feedback Components (4)
 
 ```vue
-<!-- Alert -->
+<!-- Alert com variant primary -->
+<DatametriaAlert variant="primary" :closable="true">
+  Informação importante!
+</DatametriaAlert>
 <DatametriaAlert variant="success" :closable="true">
   Operação realizada com sucesso!
 </DatametriaAlert>
 
-<!-- Toast -->
+<!-- Toast com variant primary -->
 <DatametriaToast 
   v-model="showToast" 
-  variant="info" 
+  variant="primary" 
   :duration="3000"
 >
-  Notificação
+  Notificação importante
 </DatametriaToast>
+<DatametriaToast variant="info">Informação</DatametriaToast>
 
 <!-- Progress -->
 <DatametriaProgress :value="75" variant="primary" />
@@ -516,7 +577,9 @@ setScale(1.5) // 150% zoom
 ### 🎯 **Conquistas**
 
 - ✅ **40 módulos** implementados e funcionais
-- ✅ **200+ testes** com 100% success rate
+- ✅ **514 testes** com 100% success rate
+- ✅ **Variants padronizados** - Primary variant em todos os componentes
+- ✅ **Validação runtime** - Warnings automáticos para variants inválidos
 - ✅ **Design System completo** com brand colors oficiais
 - ✅ **Sistema responsivo avançado** com 6 breakpoints
 - ✅ **Micro-interações modernas** (shimmer, ripple, haptic)
@@ -566,7 +629,11 @@ npm run build
 
 ## 📄 Licença
 
-MIT © 2025 DATAMETRIA
+MIT © 2025 DATAMETRIA - Vander Loto (CTO)
+
+**Versão:** 1.2.0
+**Última Atualização:** 05/11/2025
+**Autor:** Vander Loto - CTO DATAMETRIA
 
 ## 👥 Equipe