@react-lgpd-consent/core 0.6.3 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,130 @@
 # Changelog - @react-lgpd-consent/core
 
+## 0.7.0
+
+### Minor Changes
+
+- [#124](https://github.com/lucianoedipo/react-lgpd-consent/pull/124) [`7669c4f`](https://github.com/lucianoedipo/react-lgpd-consent/commit/7669c4fba84b5cfea8f7da8ab65468110d3e77f7) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - # v0.7.0 - Código Limpo, Testes Aprimorados e Qualidade de Código
+
+  Esta release é parte do trabalho nas issues: [#60](https://github.com/lucianoedipo/react-lgpd-consent/issues/60), [#63](https://github.com/lucianoedipo/react-lgpd-consent/issues/63), [#64](https://github.com/lucianoedipo/react-lgpd-consent/issues/64), [#65](https://github.com/lucianoedipo/react-lgpd-consent/issues/65), [#68](https://github.com/lucianoedipo/react-lgpd-consent/issues/68), [#70](https://github.com/lucianoedipo/react-lgpd-consent/issues/70), [#71](https://github.com/lucianoedipo/react-lgpd-consent/issues/71), [#72](https://github.com/lucianoedipo/react-lgpd-consent/issues/72)
+
+  ## 🧹 Correções de Lint e Code Quality
+
+  ### Migração para APIs Modernas
+  - **globalThis**: Convertidos ~50+ usos de `window` e `global` para `globalThis.window` e `globalThis` (compatibilidade SSR/universal)
+  - **String.replaceAll()**: Migrado de `replace()` com regex global para `replaceAll()` (ES2021)
+  - **Object.hasOwn()**: Migrado de `Object.prototype.hasOwnProperty.call()` para `Object.hasOwn()` (ES2022)
+  - **Number.parseInt()**: Padronizado uso de `Number.parseInt()` em vez de `parseInt()` global
+
+  ### TypeScript Configuration
+  - Adicionado `ES2021.String` ao lib do tsconfig para suportar `String.replaceAll()`
+  - Adicionado `ES2022.Object` ao lib do tsconfig para suportar `Object.hasOwn()`
+  - Mantida compatibilidade com target `ES2020`
+
+  > **ℹ️ Atenção à Compatibilidade com Browsers**
+  >
+  > Esta versão faz uso de recursos ES2021/ES2022 (`String.replaceAll()`, `Object.hasOwn()`, etc.), que não estão disponíveis em todos os navegadores (especialmente versões antigas do Safari, Edge ou Firefox). Se você utiliza este pacote em aplicações web que precisam suportar navegadores legados, é recomendado configurar um transpiler (como Babel) e/ou polyfills apropriados para garantir compatibilidade.
+
+  ### Melhorias de Código
+  - **cookieDiscovery.ts**: Função `matchPattern` movida para outer scope (evita recriação)
+  - **validation.ts**: Adicionado warning quando prop `categories` não é fornecida
+  - **Condições**: Invertidas condições negadas para melhor legibilidade
+  - **Type Safety**: Correções de type assertions em testes
+
+  ## 🧪 Aumento Significativo de Cobertura de Testes
+
+  ### Cobertura Geral: 94.82% → 95.46% (+0.64%)
+
+  | Arquivo                | Antes  | Depois      | Melhoria |
+  | ---------------------- | ------ | ----------- | -------- |
+  | **theme.ts**           | 83.33% | **100%** ✅ | +16.67%  |
+  | **cookieDiscovery.ts** | 88.13% | **96.61%**  | +8.48%   |
+  | **peerDepsCheck.ts**   | 74.19% | **80.64%**  | +6.45%   |
+  | **validation.ts**      | 96.87% | **98.24%**  | +1.37%   |
+
+  ### Novos Testes Adicionados (+33 testes: 318 → 351)
+
+  #### peerDepsCheck.ts
+  - Testes para detecção de múltiplas instâncias React via DevTools hook
+  - Testes para verificação de versões React no limite inferior/superior do range
+  - Testes para logging de erros e warnings quando `logWarnings=true`
+  - Cobertura de edge cases de versão semver complexa
+
+  #### dataLayerEvents.ts
+  - Testes para `ensureDataLayer` criar dataLayer quando undefined
+  - Testes para preservação de eventos existentes no dataLayer
+  - Testes para origins programmatic/reset
+  - Testes para previousCategories vazias/undefined
+  - Testes de SSR safety (window parcialmente definido)
+  - Testes para falha silenciosa de dataLayer.push
+
+  #### cookieDiscovery.ts
+  - Testes para uso de cookies descobertos globalmente (`__LGPD_DISCOVERED_COOKIES__`)
+  - Testes para `registerOverrides=true` chamando `setCookieCatalogOverrides`
+  - Testes para cookies sem nome ou duplicados
+  - Testes para match de padrões wildcard
+
+  #### cookieUtils.ts
+  - Testes para JSON malformado e objetos vazios
+  - Testes para `buildConsentStorageKey` com caracteres especiais
+  - Testes para `createConsentAuditEntry` com estado mínimo
+  - Testes para uso de nomes customizados em `removeConsentCookie`
+
+  #### theme.ts (100% coverage)
+  - Testes completos para palette, typography e component overrides
+  - Testes para button contained hover shadows
+  - Testes para Paper e Dialog border radius
+  - Testes para função deprecada `defaultConsentTheme()`
+  - Verificação de novas instâncias a cada chamada
+
+  ## 📚 Documentação
+
+  ### DEVELOPMENT.md
+  - Adicionada seção **"Cobertura de Testes"** com tabela de métricas por módulo
+  - Comando para rodar testes com cobertura: `pnpm test:coverage`
+  - Tabela detalhada mostrando Statements/Branches/Functions/Lines por pacote
+
+  ### TypeDoc
+  - Documentação regenerada com todas as APIs atualizadas
+  - 15 warnings aceitáveis sobre links relativos para pacotes do monorepo
+
+  ## ✅ Validação
+  - ✅ **type-check**: Todos os tipos válidos (ES2021/ES2022 APIs suportadas)
+  - ✅ **lint**: Código limpo sem erros
+  - ✅ **test**: 351/351 testes passando (100%)
+  - ✅ **build**: Build limpo de todos os pacotes
+  - ✅ **docs**: TypeDoc gerado com sucesso
+
+  ## 🔧 Arquivos Modificados
+
+  ### Core Package
+  - `src/utils/scriptIntegrations.ts`: globalThis, Date.now()
+  - `src/utils/peerDepsCheck.ts`: globalThis, Number.parseInt()
+  - `src/utils/dataLayerEvents.ts`: globalThis, ??= operator
+  - `src/utils/cookieUtils.ts`: replaceAll(), globalThis, condição invertida
+  - `src/utils/cookieDiscovery.ts`: matchPattern outer scope
+  - `src/utils/validation.ts`: warning categories undefined
+  - `src/context/ConsentContext.tsx`: Object.hasOwn(), state deps
+  - `src/context/__tests__/CategoriesContext.test.tsx`: globalThis
+  - `__tests__/*`: +25 novos testes
+
+  ### MUI Package
+  - `src/utils/theme.ts`: 100% coverage
+  - `src/utils/__tests__/theme.test.ts`: +8 novos testes
+
+  ### Configuration
+  - `tsconfig.base.json`: ES2021.String, ES2022.Object no lib
+
+  ### Documentation
+  - `DEVELOPMENT.md`: seção de cobertura de testes
+
+  ***
+
+  **Breaking Changes:** Nenhuma
+  **Migration Required:** Não
+
+  Esta release foca em qualidade de código, testes robustos e aderência a padrões modernos do JavaScript/TypeScript.
+
 ## 0.6.3
 
 ### Patch Changes
@@ -42,5 +167,19 @@
   - 🚀 Configuração de Turborepo para builds otimizados
   - 📦 Configuração de Changesets para versionamento automatizado
 
-As notas de versão completas são mantidas no arquivo `CHANGELOG.md` da raiz do repositório.  
-Este pacote segue a numeração conjunta da biblioteca `react-lgpd-consent`.
+---
+
+## Versões Anteriores (< 0.6.0)
+
+Para histórico completo de versões 0.5.x e anteriores, consulte:
+
+- [CHANGELOG.md do pacote principal](../react-lgpd-consent/CHANGELOG.md)
+- [Releases no GitHub](https://github.com/lucianoedipo/react-lgpd-consent/releases)
+
+**Resumo de marcos importantes:**
+
+- **v0.5.0** (25/10/2025): Arquitetura modular - criação dos pacotes `@react-lgpd-consent/core` e `@react-lgpd-consent/mui`
+- **v0.4.5** (25/10/2025): DataLayer events para Google Tag Manager
+- **v0.4.1** (21/09/2025): Expansão de integrações nativas (Hotjar, Mixpanel, Clarity, Intercom, Zendesk)
+- **v0.3.0-v0.4.0**: Sistema de design tokens, categorias customizadas, testes de acessibilidade
+- **v0.1.0-v0.2.x**: Implementação inicial com ConsentProvider, CookieBanner, PreferencesModal

package/README.md

@@ -62,6 +62,52 @@ function MyCustomBanner() {
 - **Integrações:** Google Analytics, GTM, UserWay, Facebook Pixel, Hotjar, etc.
 - **Tipos TypeScript:** Tipagem completa para toda a API
 
+## 🆕 Novidades v0.7.0
+
+### Callbacks de Lifecycle
+
+```tsx
+import { ConsentProvider } from '@react-lgpd-consent/core'
+
+<ConsentProvider
+  onConsentInit={(state) => console.log('Init:', state)}
+  onConsentChange={(current, previous) => {
+    console.log('Mudou:', { current, previous })
+  }}
+  onAuditLog={(entry) => {
+    // Enviar para backend
+    fetch('/api/audit', { method: 'POST', body: JSON.stringify(entry) })
+  }}
+>
+```
+
+### Presets ANPD
+
+```tsx
+import { createAnpdCategories, ANPD_CATEGORY_PRESETS } from '@react-lgpd-consent/core'
+
+// Preset BÁSICO
+const basic = createAnpdCategories({ include: ['analytics'] })
+
+// Preset COMPLETO
+const full = createAnpdCategories({
+  include: ['analytics', 'marketing', 'functional', 'social', 'personalization']
+})
+```
+
+### Auditoria de Consentimento
+
+```tsx
+import { createConsentAuditEntry } from '@react-lgpd-consent/core'
+
+const audit = createConsentAuditEntry(
+  { consented: true, preferences: { analytics: true } },
+  { action: 'update', storageKey: 'lgpd-consent__v1' }
+)
+```
+
+📖 **Saiba mais:** [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md)
+
 ## 📚 Documentação
 
 Para documentação completa, exemplos e API reference: