react-lgpd-consent 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -46,6 +46,15 @@ O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.
   - Novo Quickstart em PT/EN e simplificações no `README` com foco em `QUICKSTART`.
   - Documentação de uso do Storybook e troubleshooting adicionada em `docs`.
 
+### 🛠️ Correção crítica: Herança de ThemeProvider (v0.3.5)
+
+- **Corrigido:** A biblioteca não deve criar ou impor um `ThemeProvider` global por si só. Agora o `ConsentProvider` herda o theme do app consumidor quando um `ThemeProvider` do MUI estiver presente. O Provider só envolverá com `ThemeProvider` se a prop `theme` for explicitamente fornecida.
+- **Motivação:** Evitar conflitos de contexto MUI/Emotion, regressões visuais e problemas em SSR causados por criação de tema no escopo de módulo.
+- **Export:** `createDefaultConsentTheme()` foi adicionada como fábrica para quem precisar de um fallback explícito. Há também um getter compat (deprecated) `defaultConsentTheme()` que retorna uma nova instância quando chamada.
+- **Compatibilidade:** Uso padrão continua igual — se seu app fornece um `ThemeProvider` e você passa o mesmo theme para `ConsentProvider` (ou não passa `theme`), tudo continuará funcionando normalmente.
+
+Referência: issues/PR relacionadas e notas de release serão adicionadas no branch de release.
+
 ### ♻️ Dependências e manutenção
 
 - Dev-deps e chores
@@ -60,7 +69,6 @@ O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.
 - Quickstart / README: `db03ae3`
 - Dependências / chores: `27339e7`, `3b7fdba`, `11c3602`
 
-
 ## [0.3.1] - 2025-08-13 - CORREÇÕES DE PRODUÇÃO E MELHORIAS DE COMPATIBILIDADE
 
 ### 🛡️ **Corrigido - Critical Production Fixes**
@@ -515,8 +523,6 @@ A v0.2.1 introduz um **sistema inteligente de orientações** que guia desenvolv
 
 ---
 
-
-
 ### 🔮 Futuro (v0.4.0+)
 
 - [ ] Modal detalhado com lista de cookies

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 @lucianoedipo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 @lucianoedipo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/QUICKSTART.md

@@ -18,7 +18,7 @@ npm install @mui/material @mui/icons-material @emotion/react @emotion/styled
 
 ## 🎯 Uso Básico (30 segundos)
 
-```tsx
+````tsx
 import React from 'react'
 import { ConsentProvider } from 'react-lgpd-consent'
 
@@ -44,7 +44,7 @@ This repository ships an interactive Storybook playground used for manual testin
 
 ```bash
 npm run storybook
-```
+````
 
 - Build static Storybook (for publishing to GitHub Pages):
 
@@ -53,12 +53,14 @@ npm run build-storybook
 ```
 
 Notes:
+
 - The Storybook preview (`.storybook/preview.tsx`) applies a clean environment between stories (removes consent cookie and performs defensive DOM cleanup). Check that file when creating stories that rely on a clean initial state.
 
 }
 
 export default App
-```
+
+````
 
 ## 📋 Tabela Completa de Props do ConsentProvider
 
@@ -136,10 +138,29 @@ function App() {
     </ConsentProvider>
   )
 }
-```
+````
 
 ### Modal de Preferências Personalizado
 
+---
+
+## Nota sobre ThemeProvider
+
+A biblioteca `react-lgpd-consent` não injeta um `ThemeProvider` global por conta própria. Ela foi projetada para herdar o tema do app quando um `ThemeProvider` do MUI está presente. Se você precisa garantir um tema de fallback apenas para os componentes da biblioteca, use a fábrica exportada `createDefaultConsentTheme()` e passe pelo prop `theme` do `ConsentProvider`:
+
+```tsx
+import { ConsentProvider, createDefaultConsentTheme } from 'react-lgpd-consent'
+
+;<ConsentProvider
+  theme={createDefaultConsentTheme()}
+  categories={{ enabledCategories: ['analytics'] }}
+>
+  <App />
+</ConsentProvider>
+```
+
+Isso evita alterações indesejadas no contexto do MUI do seu app e problemas de SSR.
+
 ```tsx
 import React from 'react'
 import { ConsentProvider, type CustomPreferencesModalProps } from 'react-lgpd-consent'

package/README.md

@@ -62,27 +62,50 @@ export default function App() {
 }
 ```
 
+## Nota sobre ThemeProvider e tema padrão
+
+A biblioteca não cria um `ThemeProvider` global automaticamente. Ela tenta herdar o tema do seu app quando você já possui um `ThemeProvider` do MUI. Se você quiser aplicar explicitamente um tema de fallback para os componentes de consentimento, use a fábrica exportada `createDefaultConsentTheme()` e passe via prop `theme`:
+
+```tsx
+import { ConsentProvider, createDefaultConsentTheme } from 'react-lgpd-consent'
+
+// Aplica um tema de fallback somente para os componentes da lib
+;<ConsentProvider
+  theme={createDefaultConsentTheme()}
+  categories={{ enabledCategories: ['analytics'] }}
+>
+  <App />
+</ConsentProvider>
+```
+
+Evite depender de criação de tema no import (isso evita side-effects e problemas em SSR). Se você precisar de compatibilidade retroativa com quem importava `defaultConsentTheme`, entre em contato para adicionarmos um export compatível com deprecação documentada.
+
 ## 📚 Documentação Completa
 
 Para mais detalhes sobre customização, hooks e funcionalidades, consulte os seguintes guias:
 
 ### 📋 Documentação Principal
+
 - **[📚 Guia de Início Rápido (`QUICKSTART.md`)](./QUICKSTART.md)**: Tutorial passo a passo com exemplos práticos, tabela completa de props, debugging e integrações.
 - **[Guia da API (`API.md`)](./API.md)**: Referência completa de todos os componentes, hooks e tipos.
 - **[Guia de Conformidade (`CONFORMIDADE.md`)](./CONFORMIDADE.md)**: Detalhes sobre as funcionalidades de conformidade com a LGPD.
 - **[Guia de Integrações (`INTEGRACOES.md`)](./INTEGRACOES.md)**: Como usar as integrações nativas e criar as suas.
 
 ### 🎨 Documentação Interativa (GitHub Pages)
+
 - **[📖 Storybook - Playground Interativo](https://lucianoedipo.github.io/react-lgpd-consent/storybook/)**: Explore e teste todos os componentes em tempo real com controles interativos.
 - **[⚙️ TypeDoc - Referência de API](https://lucianoedipo.github.io/react-lgpd-consent/docs/)**: Documentação completa da API gerada automaticamente.
 - **[🏠 Portal de Documentação](https://lucianoedipo.github.io/react-lgpd-consent/)**: Página inicial com navegação entre todas as documentações.
+
 ---
 
 ## 🤝 Como Contribuir
+
 1. Abra uma [Issue](https://github.com/lucianoedipo/react-lgpd-consent/issues) para bugs ou melhorias.
 2. Siga o Guia de Desenvolvimento em `DEVELOPMENT.md` para enviar um PR.
 
 ---
+
 ## 📄 Licença
 
 MIT — veja o arquivo `LICENSE`.

package/dist/{PreferencesModal-XYBFROAB.js → PreferencesModal-KAZMVPBD.js}

@@ -1,6 +1,6 @@
 import {
   PreferencesModal
-} from "./chunk-7D2F6JFW.js";
+} from "./chunk-MHCQFGRJ.js";
 export {
   PreferencesModal
 };