react-lgpd-consent 0.5.4 → 0.6.4

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.6.3
+
+### Patch Changes
+
+- [#115](https://github.com/lucianoedipo/react-lgpd-consent/pull/115) [`2a54bae`](https://github.com/lucianoedipo/react-lgpd-consent/commit/2a54bae6bbbe068b75e489eae72aa77705353d1e) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - Adiciona RECIPES.md com 8 receitas práticas, WORKFLOWS.md documentando CI/CD completo, novos workflows de versionamento/publicação/docs, correção de versão do TypeDoc e atualização da documentação em inglês.
+
+- Updated dependencies [[`2a54bae`](https://github.com/lucianoedipo/react-lgpd-consent/commit/2a54bae6bbbe068b75e489eae72aa77705353d1e)]:
+  - @react-lgpd-consent/core@0.6.3
+  - @react-lgpd-consent/mui@0.6.3
+
+## 0.6.1
+
+### Patch Changes
+
+- [#105](https://github.com/lucianoedipo/react-lgpd-consent/pull/105) [`1deb3bb`](https://github.com/lucianoedipo/react-lgpd-consent/commit/1deb3bb56853165f7ec231e73d7b1d271e51b8f1) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - chore: sincronizar pnpm-lock.yaml com versões bumpeadas
+
+- Updated dependencies [[`1deb3bb`](https://github.com/lucianoedipo/react-lgpd-consent/commit/1deb3bb56853165f7ec231e73d7b1d271e51b8f1)]:
+  - @react-lgpd-consent/core@0.6.1
+  - @react-lgpd-consent/mui@0.6.1
+
+## 0.6.0
+
+### Minor Changes
+
+- [#103](https://github.com/lucianoedipo/react-lgpd-consent/pull/103) [`4c9ebf2`](https://github.com/lucianoedipo/react-lgpd-consent/commit/4c9ebf231ff58168294f2fde405298b7087016ca) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - feat: adicionar diagnósticos de peer dependencies e sistema de troubleshooting
+  - ✨ Novo sistema de diagnóstico automático para peer deps
+  - 🔍 Detecta múltiplas instâncias de React (causa "Invalid hook call")
+  - 📋 Verifica versões de React (18-19) e MUI (5-7)
+  - 📖 Nova página TROUBLESHOOTING.md com soluções detalhadas
+  - 🔧 Mensagens acionáveis no console em modo desenvolvimento
+  - 🚀 Configuração de Turborepo para builds otimizados
+  - 📦 Configuração de Changesets para versionamento automatizado
+
+### Patch Changes
+
+- Updated dependencies [[`4c9ebf2`](https://github.com/lucianoedipo/react-lgpd-consent/commit/4c9ebf231ff58168294f2fde405298b7087016ca)]:
+  - @react-lgpd-consent/core@0.6.0
+  - @react-lgpd-consent/mui@0.6.0
+
 Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 
 # Changelog
@@ -25,7 +64,6 @@ Esta versão introduz uma **arquitetura modular** que separa a lógica de consen
 - **Tree-shaking eficiente**: Instale apenas o que você precisa
   - Core isolado permite uso com qualquer biblioteca de UI
   - MUI opcional como peer dependency
-  
 - **Workspace PNPM**: Monorepo organizado com builds independentes
 - **Guia de migração completo**: [MIGRATION.md](../../MIGRATION.md) documentando todos os cenários
 - **Scripts de publicação**: Suporte para publicar pacotes independentemente
@@ -70,26 +108,28 @@ packages/
 
 ### 📊 Bundle Sizes
 
-| Pacote | ESM | CJS | DTS | Dependências |
-|--------|-----|-----|-----|--------------|
-| `@react-lgpd-consent/core` | 86.04 KB | 89.12 KB | 125.82 KB | React, js-cookie, zod |
-| `@react-lgpd-consent/mui` | 17.69 KB | 20.95 KB | 11.78 KB | core + @mui/material (peer) |
-| `react-lgpd-consent` | 104 KB* | 110 KB* | 138 KB* | mui (workspace) |
+| Pacote                     | ESM      | CJS      | DTS       | Dependências                |
+| -------------------------- | -------- | -------- | --------- | --------------------------- |
+| `@react-lgpd-consent/core` | 86.04 KB | 89.12 KB | 125.82 KB | React, js-cookie, zod       |
+| `@react-lgpd-consent/mui`  | 17.69 KB | 20.95 KB | 11.78 KB  | core + @mui/material (peer) |
+| `react-lgpd-consent`       | 104 KB\* | 110 KB\* | 138 KB\*  | mui (workspace)             |
 
 \* Bundle final = core + mui (~104 KB total)
 
 ### 🎯 Migration Paths
 
 1. **Uso de componentes UI** (maioria dos usuários):
+
    ```bash
    # Opção A: Pacote agregador (zero mudanças)
    npm install react-lgpd-consent@0.5.0
-   
+
    # Opção B: Pacote MUI direto (recomendado)
    npm install @react-lgpd-consent/mui
    ```
 
 2. **Headless/UI customizada**:
+
    ```bash
    npm uninstall react-lgpd-consent @mui/material
    npm install @react-lgpd-consent/core
@@ -152,7 +192,6 @@ packages/
   - `consent_initialized`: Disparado após hidratação inicial do `ConsentProvider`
   - `consent_updated`: Disparado quando usuário altera preferências via banner, modal ou API
   - Payload inclui: `event`, `consent_version`, `timestamp` (ISO 8601), `categories`, `origin`, `changed_categories`
-  
 - **Rastreamento de Origem**: Campo `origin` identifica fonte da mudança de consentimento
   - `'banner'`: Decisão feita no CookieBanner
   - `'modal'`: Ajuste feito no PreferencesModal
@@ -1015,17 +1054,21 @@ A v0.2.1 introduz um **sistema inteligente de orientações** que guia desenvolv
 ### 🧩 Sem breaking changes
 
 - Alterações são compatíveis; padrões seguros preservados.
+
 ## [0.5.0] - 25/10/2025 — Modularização inicial do workspace
 
 ### 🧱 Estrutura modular
+
 - Repositório convertido em workspace PNPM com três pacotes: `@react-lgpd-consent/core`, `@react-lgpd-consent/mui` e `react-lgpd-consent`.
 - Pacote agregador passa a construir entradas adicionais (`core` e `mui`) expondo subpath exports oficiais.
 
 ### 🎨 Camada MUI dedicada
+
 - Publicação inicial de `@react-lgpd-consent/mui` como _proxy_ dos componentes padrão.
 - Metadados de peer dependencies ajustados para reforçar que Material-UI é opcional (requerido apenas para a camada visual).
 
 ### 🧰 Ferramentas & DX
+
 - Scripts de lint/test/build convertidos para `pnpm --filter react-lgpd-consent <comando>`.
 - Jest e TypeDoc atualizados para apontar para `packages/core` e `packages/react-lgpd-consent`.
 - Documentação (README, QUICKSTART, DEVELOPMENT) revisada para explicar a nova arquitetura e o processo de migração gradual.

package/INTEGRACOES.md

@@ -6,11 +6,9 @@ A biblioteca oferece integrações nativas para as ferramentas mais comuns, elim
 
 O componente `ConsentScriptLoader` gerencia o carregamento desses scripts automaticamente, disparando-os apenas quando o usuário concede consentimento para a categoria correspondente.
 
-## 🎯 Integrações Nativas Disponíveis
-
-A biblioteca oferece integrações nativas para as ferramentas mais comuns, eliminando a necessidade de código manual para o carregamento condicional de scripts de terceiros.
+> 💡 **Procurando exemplos práticos?** Veja [RECIPES.md](../../RECIPES.md) para receitas passo a passo de Google Consent Mode v2, Next.js App Router e CSP/nonce.
 
-O componente `ConsentScriptLoader` gerencia o carregamento desses scripts automaticamente, disparando-os apenas quando o usuário concede consentimento para a categoria correspondente.
+## 🎯 Integrações Nativas Disponíveis
 
 ### 1. Google Analytics 4 (GA4)
 

package/QUICKSTART.md

@@ -1238,7 +1238,31 @@ function App() {
 
 ## 🆘 Solução de Problemas Comuns
 
-### "ConsentProvider must be used within ConsentProvider"
+> 💡 **Diagnósticos automáticos**: A partir da v0.5.4, o react-lgpd-consent detecta automaticamente problemas comuns (múltiplas instâncias de React, versões incompatíveis) e exibe mensagens detalhadas no console em modo desenvolvimento.
+
+Para problemas mais complexos, consulte o **[Guia Completo de Troubleshooting](../../TROUBLESHOOTING.md)**.
+
+### Erros mais comuns
+
+#### "Invalid hook call" / Múltiplas instâncias de React
+
+Se você vê este erro, provavelmente tem múltiplas versões de React carregadas. O diagnóstico automático exibirá instruções específicas para o seu gerenciador de pacotes.
+
+**Solução rápida (pnpm)**:
+```json
+{
+  "pnpm": {
+    "overrides": {
+      "react": "$react",
+      "react-dom": "$react-dom"
+    }
+  }
+}
+```
+
+**Mais detalhes**: [TROUBLESHOOTING.md - Invalid hook call](../../TROUBLESHOOTING.md#erro-invalid-hook-call)
+
+#### "ConsentProvider must be used within ConsentProvider"
 
 ```tsx
 // ❌ Errado - hook usado fora do provider
@@ -1298,9 +1322,10 @@ document.cookie = 'cookieConsent=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/
 ## 📚 Próximos Passos
 
 - 📖 [Documentação Completa da API](./API.md)
-- 🏗️ [Guia de Conformidade LGPD](./CONFORMIDADE.md)
+- 🔧 [Guia de Troubleshooting](../../TROUBLESHOOTING.md)
+- 🏗️ [Guia de Conformidade LGPD](../../CONFORMIDADE.md)
 - 🔌 [Integrações Nativas](./INTEGRACOES.md)
-- 🧪 [Executar o Exemplo](./example/)
+- 🧪 [Executar o Exemplo](../../example/)
 
 ---
 

package/README.en.md

@@ -96,11 +96,13 @@ function Analytics() {
 
 ## Documentation & Examples
 
-- Quickstart: `QUICKSTART.en.md` (recommended)
-- API Reference: `API.md`
-- Integrations: `INTEGRACOES.md`
-- Storybook: https://lucianoedipo.github.io/react-lgpd-consent/storybook/
-- TypeDoc: https://lucianoedipo.github.io/react-lgpd-consent/docs/
+- **[🚀 Quickstart](../../QUICKSTART.en.md)** - Step-by-step tutorial
+- **[📖 Recipes](../../RECIPES.md)** - Practical guide with common use cases (Next.js, CSP, Consent Mode v2)
+- **[⚙️ Workflows](../../WORKFLOWS.md)** - CI/CD workflows documentation
+- **[API Reference](./API.md)** - Complete API reference
+- **[Integrations](./INTEGRACOES.md)** - GA4, GTM, Facebook Pixel
+- **[Storybook](https://lucianoedipo.github.io/react-lgpd-consent/storybook/)** - Interactive components
+- **[TypeDoc](https://lucianoedipo.github.io/react-lgpd-consent/docs/)** - Generated API docs
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.5.4",
+  "version": "0.6.4",
   "description": "Biblioteca de consentimento LGPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",
@@ -94,14 +94,14 @@
     }
   },
   "dependencies": {
-    "@react-lgpd-consent/core": "^0.5.1",
-    "@react-lgpd-consent/mui": "^0.5.1"
+    "@react-lgpd-consent/core": "^0.6.3",
+    "@react-lgpd-consent/mui": "^0.6.3"
   },
   "size-limit": [
     {
       "name": "ESM Bundle",
       "path": "dist/index.js",
-      "limit": "70 KB"
+      "limit": "80 KB"
     },
     {
       "name": "CJS Bundle",
@@ -117,7 +117,7 @@
       "name": "Complete Package Import",
       "path": "dist/index.js",
       "import": "{ ConsentProvider, useConsent, ConsentScriptLoader }",
-      "limit": "65 KB"
+      "limit": "70 KB"
     }
   ],
   "scripts": {