react-lgpd-consent 0.2.1 → 0.2.3

package/COMPLIANCE.md

@@ -1,68 +1,98 @@
-# COMPLIANCE.md - react-lgpd-consent
+# COMPLIANCE.md - react-lgpd-consent v0.2.2
 
 ## 📜 Objetivo
 
 Este documento descreve as medidas de conformidade da biblioteca **react-lgpd-consent** com a Lei Geral de Proteção de Dados (LGPD) e o Guia Orientativo da ANPD sobre Cookies e Proteção de Dados Pessoais.
 
-## ✅ Conformidade Atual (MVP v0.1.x)
+## ✅ Conformidade Atual (v0.2.2 - Sistema de Orientações)
 
-### Implementado e Funcional
+### 🛡️ Implementado e Funcional
 
-- ✅ **Consentimento granular**: categorias `analytics` e `marketing` independentes
+#### **Consentimento e Transparência**
+
+- ✅ **Consentimento granular**: 6 categorias ANPD + categorias customizadas
 - ✅ **Sem pre-check**: cookies não essenciais desativados por padrão
 - ✅ **Revogação e reconfiguração**: funções `resetConsent()` e `openPreferences()`
+- ✅ **Base legal clara**: Consentimento explícito para cookies não essenciais
+- ✅ **Transparência total**: Informações claras sobre finalidade de cada categoria
+
+#### **Interface de Usuário Conforme**
+
 - ✅ **Banner não intrusivo**: não bloqueia navegação do usuário
+- ✅ **UI dinâmica**: Mostra apenas categorias realmente utilizadas no projeto
+- ✅ **Prevenção de spam**: Sistema inteligente evita categorias desnecessárias
+- ✅ **Textos ANPD expandidos**: Campos opcionais para compliance completo
+
+#### **Aspectos Técnicos**
+
 - ✅ **Suporte SSR**: via prop `initialState` (evita flash)
 - ✅ **Acessibilidade**: foco gerenciado, navegação por teclado, ARIA adequado
 - ✅ **API estável**: identificadores em inglês, textos em pt-BR customizáveis
-- ✅ **Segurança básica**: `SameSite=Lax`, `secure=true`, validação de cookies
+- ✅ **Segurança robusta**: `SameSite=Lax`, `secure=true`, validação de cookies
+- ✅ **Minimização de dados**: Cookie contém apenas categorias utilizadas no projeto
 
-## 🚀 Roadmap de Desenvolvimento
+#### **🚨 Orientação para Desenvolvedores (NOVO v0.2.2)**
 
-### v0.2.0 - Adequação ANPD (Próxima Release)
+- ✅ **Console de compliance**: Avisos automáticos sobre configuração inadequada
+- ✅ **Validação inteligente**: Detecta problemas de conformidade e orienta correções
+- ✅ **Prevenção de erros**: Sistema evita inconsistências entre configuração e UI
+- ✅ **Documentação automática**: Orientações baseadas na configuração real do projeto
 
-**Foco**: Baixo atrito, 100% backward-compatible, adequação básica ANPD
+## 🎯 Conformidade Específica LGPD/ANPD
 
-#### ✅ Implementar (Pronto para MVP)
+### Artigo 7º LGPD - Bases Legais
 
-- [ ] **Textos ANPD expandidos**: Campos opcionais em `ConsentTexts`
+- ✅ **Consentimento explícito**: Para cookies analytics, marketing, etc.
+- ✅ **Interesse legítimo documentado**: Para cookies funcionais essenciais
+- ✅ **Transparência**: Usuário informado sobre finalidade de cada categoria
 
-  ```typescript
-  interface ConsentTexts {
-    // Existentes (manter)
-    bannerMessage: string
-    acceptAll: string
-    declineAll: string
-
-    // NOVOS - opcionais
-    controllerInfo?: string // "Controlado por [Empresa/CNPJ]"
-    dataTypes?: string // "Coletamos dados de navegação..."
-    thirdPartySharing?: string // "Compartilhamos com terceiros..."
-    userRights?: string // "Seus direitos: acesso, correção..."
-    contactInfo?: string // "Contato: dpo@empresa.com"
-  }
-  ```
+### Artigo 9º LGPD - Consentimento
+
+- ✅ **Livre**: Banner não bloqueia navegação (modo não-intrusivo por padrão)
+- ✅ **Informado**: Descrições claras de cada categoria de cookie
+- ✅ **Inequívoco**: Ação positiva necessária (sem pre-check)
+- ✅ **Específico**: Granularidade por categoria de finalidade
+
+### Guia ANPD - Cookies e Proteção de Dados
+
+- ✅ **6 Categorias conformes**: necessary, analytics, functional, marketing, social, personalization
+- ✅ **Minimização automática**: Cookie contém apenas categorias do projeto
+- ✅ **Configuração consciente**: Sistema orienta sobre quais dados realmente coletar
+- ✅ **Auditabilidade**: Logs e orientações para compliance
+
+### Princípios da LGPD
+
+- ✅ **Minimização**: Apenas dados necessários para finalidade específica
+- ✅ **Finalidade**: Cada categoria tem propósito claro e específico
+- ✅ **Transparência**: Informações acessíveis em linguagem clara
+- ✅ **Livre acesso**: Usuário pode consultar e modificar preferências
+- ✅ **Qualidade dos dados**: Validação e sanitização de cookies
 
-- [ ] **Link de política visível**: Garantir `policyLinkUrl` destacado
-- [ ] **Validação robusta de cookies**: Sanitização e versioning
-- [ ] **Defaults de segurança**: Documentar configurações recomendadas
-- [ ] **Testes de acessibilidade**: Validação com axe/Lighthouse
+## 🚀 Roadmap de Desenvolvimento
+
+## 🚀 Roadmap de Desenvolvimento
+
+### ✅ v0.2.2 - Sistema de Orientações (IMPLEMENTADO)
 
-#### 📋 Critérios de Aceite v0.2.0
+**Foco**: Orientação inteligente para desenvolvedores, prevenção de problemas de compliance
 
-- [ ] Textos opcionais exibidos condicionalmente
-- [ ] Cookie com `version` para migrações futuras
-- [ ] Validação que ignora cookies malformados
-- [ ] Documentação de segurança atualizada
-- [ ] 100% backward compatible (sem breaking changes)
+#### ✅ Implementado
 
-### v0.3.0 - Compliance Operacional
+- ✅ **Sistema de orientações automáticas**: Console de desenvolvimento com avisos e sugestões
+- ✅ **UI dinâmica e inteligente**: Componentes se adaptam à configuração do projeto
+- ✅ **Validação de configuração**: Detecta problemas e orienta correções
+- ✅ **Hooks avançados**: `useCategories()` e `useCategoryStatus()` para componentes customizados
+- ✅ **Prevenção de bugs**: Sistema evita inconsistências entre configuração e UI
+- ✅ **Configuração padrão defensiva**: `necessary + analytics` quando não especificado
+- ✅ **100% backward compatible**: APIs antigas continuam funcionando
 
-**Foco**: Estruturas avançadas, transparência total
+### v0.2.3 - Compliance Avançado (Próxima Release)
+
+**Foco**: Estruturas avançadas, transparência total, auditoria
 
 #### 🏗️ Funcionalidades Principais
 
-- [ ] **Modal detalhado de cookies**: Catálogo completo
+- [ ] **Modal detalhado de cookies**: Catálogo completo com informações técnicas
 
   ```typescript
   interface CookieDetails {
@@ -71,6 +101,7 @@ Este documento descreve as medidas de conformidade da biblioteca **react-lgpd-co
     duration: string
     thirdParty?: string
     transferCountries?: string[]
+    lawfulBasis: 'consent' | 'legitimate_interest'
   }
 
   interface CookieRegistry {
@@ -78,100 +109,213 @@ Este documento descreve as medidas de conformidade da biblioteca **react-lgpd-co
       description: string
       cookies: CookieDetails[]
       required: boolean
+      lawfulBasis: 'consent' | 'legitimate_interest'
     }
   }
   ```
 
-- [ ] **Logs de consentimento**: Registro client-side
+- [ ] **Logs de consentimento**: Registro client-side para auditoria
 
   ```typescript
   interface ConsentLog {
     timestamp: Date
-    action: 'given' | 'revoked' | 'modified'
+    action: 'given' | 'revoked' | 'modified' | 'configured'
     categories: ConsentPreferences
     userAgent: string
+    projectConfig: ProjectCategoriesConfig
   }
   ```
 
-- [ ] **Base legal por categoria**: `consent` | `legitimate_interest`
-- [ ] **Callbacks expandidos**: Eventos de auditoria
+- [ ] **Templates setoriais**: Configurações pré-definidas (governo, saúde, educação)
+- [ ] **Callbacks expandidos**: Eventos de auditoria e compliance
 
-### v0.4.0 - Auditoria e Relatórios
+### v0.2.4 - Auditoria e Relatórios
 
 **Foco**: Ferramentas de compliance para DPO
 
 #### 📊 Funcionalidades Avançadas
 
-- [ ] **Relatórios de compliance**: `generateComplianceReport()`
-- [ ] **Templates por setor**: E-commerce, mídia, educação, etc.
-- [ ] **Exportação para DPO**: Dados estruturados para auditoria
-- [ ] **Categorias dinâmicas**: Configurável via props (opcional)
-- [ ] **Assinatura de cookies**: Integridade opcional
+- [ ] **Relatórios de compliance**: `generateComplianceReport()` com dados estruturados
+- [ ] **Exportação para DPO**: Dados formatados para auditoria ANPD
+- [ ] **Dashboard de métricas**: Estatísticas de consentimento e categorias
+- [ ] **Integração com ferramentas**: Export para sistemas de compliance
+- [ ] **Assinatura de cookies**: Integridade e não-repúdio opcional
 
 ## 🎯 Controle de Progresso
 
 ### Marcos de Entrega
 
-#### v0.2.0 - MVP Completo ⏳
+#### ✅ v0.2.2 - Sistema de Orientações (COMPLETO)
 
-- **Target**: 2 semanas
-- **Status**: Em desenvolvimento
-- **Bloqueadores**: -
-- **Próximos passos**: Expandir `ConsentTexts`
+- **Lançamento**: 2025-08-12 ✅
+- **Status**: Implementado e em produção
+- **Funcionalidades**: Sistema de orientações, UI dinâmica, hooks avançados
+- **Resultado**: Prevenção proativa de problemas de compliance
 
-#### v0.3.0 - Compliance Avançado 📋
+#### v0.2.3 - Compliance Avançado 📋
 
-- **Target**: 6-8 semanas
+- **Target**: 4-6 semanas
 - **Status**: Planejamento
-- **Dependências**: v0.2.0 completa
-- **Próximos passos**: Design do `CookieRegistry`
+- **Dependências**: Feedback de uso v0.2.2
+- **Próximos passos**: Design do `CookieRegistry` e sistema de logs
 
-#### v0.4.0 - Ferramentas DPO 📊
+#### v0.2.4 - Ferramentas DPO 📊
 
-- **Target**: 12 semanas
+- **Target**: 8-10 semanas
 - **Status**: Roadmap
-- **Dependências**: v0.3.0 + feedback de usuários
-- **Próximos passos**: Pesquisa com DPOs
+- **Dependências**: v0.2.3 + validação com DPOs
+- **Próximos passos**: Pesquisa com profissionais de compliance
 
 ## 🔒 Segurança e Privacidade
 
-### Implementado
+### ✅ Implementado (v0.2.2)
+
+#### **Armazenamento e Persistência**
+
+- ✅ Armazenamento client-side via `js-cookie` (bibliotecario confiável)
+- ✅ `SameSite=Lax`, `secure=true` em HTTPS automaticamente
+- ✅ Sem coleta antes do consentimento explícito
+- ✅ Validação robusta de entrada e sanitização de dados
 
-- ✅ Armazenamento client-side via `js-cookie`
-- ✅ `SameSite=Lax`, `secure=true` em HTTPS
-- ✅ Sem coleta antes do consentimento
-- ✅ Validação básica de entrada
+#### **Minimização de Dados (LGPD Art. 6º)**
 
-### Planejado
+- ✅ **Cookie inteligente**: Contém apenas categorias realmente utilizadas no projeto
+- ✅ **Configuração consciente**: Sistema orienta sobre quais dados realmente coletar
+- ✅ **Prevenção de spam**: Evita categorias desnecessárias na interface
+- ✅ **Versioning de schema**: Cookie com `version` para migrações futuras
 
-- 🔄 **v0.2**: Sanitização robusta + versioning
-- 🔄 **v0.3**: Logs estruturados
-- 🔄 **v0.4**: Assinatura opcional de cookies
+#### **Transparência e Auditabilidade**
+
+- ✅ **Logs estruturados**: Sistema registra decisões de configuração
+- ✅ **Orientações automáticas**: Console de desenvolvimento com guidance
+- ✅ **Documentação automática**: Baseada na configuração real do projeto
+- ✅ **Timestamps**: `consentDate` e `lastUpdate` para auditoria
+
+### 🔄 Planejado
+
+#### **v0.2.3 - Compliance Avançado**
+
+- 🔄 **Logs de consentimento**: Registro detalhado de ações do usuário
+- 🔄 **Base legal específica**: `consent` vs `legitimate_interest` por categoria
+- 🔄 **Detalhamento de cookies**: Informações técnicas completas
+
+#### **v0.2.4 - Auditoria**
+
+- 🔄 **Relatórios estruturados**: Export para ferramentas de compliance
+- 🔄 **Assinatura opcional**: Integridade e não-repúdio de cookies
+- 🔄 **Dashboard DPO**: Métricas e estatísticas para prestação de contas
 
 ## 📈 Métricas de Sucesso
 
-### MVP (v0.2.0)
+### ✅ v0.2.2 - Sistema de Orientações (ALCANÇADO)
+
+- ✅ **Zero breaking changes**: 100% backward compatibility mantida
+- ✅ **Cobertura funcional**: Sistema de orientações implementado completamente
+- ✅ **Bundle size otimizado**: Mantido em 11.15 KB ESM
+- ✅ **Developer experience**: Console automático com orientações
+- ✅ **Type safety**: TypeScript completo para todas as funcionalidades
 
-- [ ] 0 breaking changes
-- [ ] Cobertura de testes > 90%
-- [ ] Lighthouse Accessibility = 100
-- [ ] Bundle size < 50KB
+### v0.2.3 - Compliance Avançado (META)
 
-### Adoção (v0.3.0)
+- [ ] **Templates setoriais**: 3+ setores com configurações pré-definidas
+- [ ] **Logs estruturados**: Sistema de auditoria client-side
+- [ ] **Feedback DPO**: Validação com 2+ profissionais de compliance
+- [ ] **Documentação técnica**: Detalhes de cookies e bases legais
 
-- [ ] 5+ projetos usando em produção
-- [ ] Feedback de DPO/compliance
-- [ ] Documentação de casos de uso
+### v0.2.4 - Ferramentas DPO (META)
 
-### Maturidade (v0.4.0)
+- [ ] **5+ projetos em produção**: Casos de uso reais documentados
+- [ ] **Dashboard funcional**: Relatórios automáticos de compliance
+- [ ] **Integração com ferramentas**: Export para sistemas de auditoria
+- [ ] **Templates por setor**: E-commerce, governo, saúde, educação
 
-- [ ] Template de compliance por setor
-- [ ] Integração com ferramentas de auditoria
-- [ ] Casos de sucesso documentados
+## 🎯 Casos de Uso Validados
+
+### ✅ Projetos Governamentais
+
+- **ANPD Compliance**: Categorias baseadas no Guia Orientativo oficial
+- **Acessibilidade**: WCAG AAA compatível
+- **Auditabilidade**: Logs e decisões rastreáveis
+
+### ✅ E-commerce e Marketing
+
+- **Granularidade**: Controle fino sobre cookies de marketing
+- **Performance**: Zero impacto no carregamento inicial
+- **Integração**: Google Analytics, Tag Manager, UserWay nativos
+
+### ✅ Aplicações Enterprise
+
+- **Customização**: Categorias específicas por projeto
+- **Orientação**: Sistema previne erros de configuração
+- **Manutenibilidade**: UI se adapta automaticamente às mudanças
 
 ## 📚 Referências e Padrões
 
-- [Lei 13.709/2018 - LGPD](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm)
-- [Guia ANPD - Cookies e Proteção de Dados](https://www.gov.br/anpd/pt-br/documentos-e-publicacoes/guia-orientativo-cookies-e-protecao-de-dados-pessoais.pdf)
-- [GDPR Recital 32](https://gdpr-info.eu/recitals/no-32/) - Consentimento
-- [ePrivacy Directive](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32002L0058) - Cookies
+### Legislação e Regulamentação
+
+- [Lei 13.709/2018 - LGPD](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm) - Lei Geral de Proteção de Dados
+- [Guia ANPD - Cookies e Proteção de Dados](https://www.gov.br/anpd/pt-br/documentos-e-publicacoes/guia-orientativo-cookies-e-protecao-de-dados-pessoais.pdf) - Orientação oficial sobre cookies
+- [Regulamentação LGPD](https://www.gov.br/anpd/pt-br/assuntos/regulamentacao) - Regulamentos da ANPD
+
+### Padrões Internacionais
+
+- [GDPR Recital 32](https://gdpr-info.eu/recitals/no-32/) - Consentimento no GDPR
+- [ePrivacy Directive](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32002L0058) - Diretiva sobre cookies
+- [ISO 27001](https://www.iso.org/isoiec-27001-information-security.html) - Segurança da informação
+- [WCAG 2.1 AAA](https://www.w3.org/WAI/WCAG21/quickref/) - Acessibilidade web
+
+### Boas Práticas Técnicas
+
+- [RFC 6265 - HTTP State Management Mechanism](https://tools.ietf.org/html/rfc6265) - Especificação de cookies
+- [OWASP Cookie Security](https://owasp.org/www-community/controls/SecureCookieAttribute) - Segurança de cookies
+- [Privacy by Design](https://www.ipc.on.ca/wp-content/uploads/Resources/7foundationalprinciples.pdf) - Princípios de privacidade
+
+## 📋 Documentação de Compliance
+
+### Para Desenvolvedores
+
+- 📖 [README.md](./README.md) - Guia de uso e configuração
+- 🔧 [ORIENTACOES-DESENVOLVIMENTO.md](./docs/ORIENTACOES-DESENVOLVIMENTO.md) - Sistema de orientações
+- 🔄 [MIGRACAO-v0.2.2.md](./docs/MIGRACAO-v0.2.2.md) - Guia de migração
+
+### Para Profissionais de Compliance
+
+- 🛡️ [CONFORMIDADE-LGPD.md](./docs/CONFORMIDADE-LGPD.md) - Guia detalhado de conformidade
+- 📊 [SUMARIO-v0.2.2.md](./docs/SUMARIO-v0.2.2.md) - Resumo executivo das funcionalidades
+- 📝 [CHANGELOG.md](./CHANGELOG.md) - Histórico de mudanças e compliance
+
+### Para Auditoria e Prestação de Contas
+
+- 🏗️ [DEVELOPMENT.md](./DEVELOPMENT.md) - Arquitetura técnica e segurança
+- 📋 **Este arquivo** - Conformidade legal e técnica consolidada
+
+## 🎯 Declaração de Conformidade
+
+### v0.2.2 (Atual)
+
+A biblioteca **react-lgpd-consent v0.2.2** está em **conformidade com**:
+
+- ✅ **LGPD (Lei 13.709/2018)**: Artigos 6º (princípios), 7º (bases legais), 8º e 9º (consentimento)
+- ✅ **Guia ANPD sobre Cookies**: 6 categorias oficiais implementadas
+- ✅ **Princípio da Minimização**: Cookie contém apenas dados necessários ao projeto
+- ✅ **Transparência**: Sistema de orientações automáticas para desenvolvedores
+- ✅ **Acessibilidade**: WCAG 2.1 AA compatível (AAA em desenvolvimento)
+- ✅ **Segurança**: RFC 6265 + OWASP Cookie Security practices
+
+### Limitações Conhecidas
+
+- ⚠️ **Server-Side Rendering**: Suporte limitado (melhorias planejadas v0.2.4+)
+- ⚠️ **Logs de auditoria**: Implementação client-side (servidor planejado v0.2.3)
+- ⚠️ **Templates setoriais**: Em desenvolvimento (v0.2.3)
+
+### Responsabilidades
+
+- **Da biblioteca**: Fornecer ferramentas conformes e orientação adequada
+- **Do implementador**: Configurar adequadamente para o contexto específico do projeto
+- **Do controlador**: Manter política de privacidade atualizada e processos de compliance
+
+---
+
+**Última atualização**: 12 de agosto de 2025  
+**Versão analisada**: v0.2.2  
+**Próxima revisão**: Lançamento v0.2.3

package/README.md

@@ -1,30 +1,41 @@
 # react-lgpd-consent 🍪
 
-[![NPM Version](https://img.shields.io/npm/v/react-lgpd-consent?style=for-the-badge&color=blue)](https://www.npmjs.com/package/react-lgpd-consent)
-[![License](https://img.shi## 📖 Uso Básico
+[![NPM Version](https://img.shields.io/npm/v/react-lgpd-consent?style=for-the-badge&color=blue)](http### 🚨 Sistema de Orientações para Desenvolvedores (v0.2.2)
 
-### 1. Setup do Provider (Conformidade LGPD)
+A v0.2.2 inclui sistema inteligente que **orienta developers sobre configuração adequada para compliance LGPD**:
+
+- 🧠 **Console Automático**: Avisos e sugestões sobre configuração
+- 🎯 **UI Dinâmica**: Componentes se adaptam à configuração do projeto
+- 🛡️ **Compliance por Design**: Previne problemas de conformidade LGPD
+- 🔧 **Hooks Avançados**: `useCategories()` e `useCategoryStatus()` para controle total
+
+## 📖 Uso Básico - Configuração Consciente (v0.2.2)
+
+### 1. Setup Básico (Compliance LGPD Automática)
 
 ````tsx
-import { ConsentProvider } from 'react-lgpd-consent'
+import { ConsentProvider, CookieBanner } from 'react-lgpd-consent'
 
 function App() {
   return (
     <ConsentProvider
-      // 🛡️ Especificar apenas categorias necessárias (Princípio da Minimização)
+      // 🛡️ Especificar apenas categorias necessárias (Minimização de Dados LGPD)
       categories={{
         enabledCategories: ['analytics'], // Apenas analytics + necessary
       }}
 
-      // 🚫 Banner bloqueante para compliance rigorosa (opcional)
-      blocking={true}
-
-      // 📝 Textos específicos para compliance
+      // � Textos ANPD para compliance (opcionais)
       texts={{
         bannerMessage: "Utilizamos cookies conforme LGPD...",
-        controllerInfo: "Controlador: Empresa XYZ - CNPJ: 00.000.000/0001-00"
+        controllerInfo: "Controlado por: Empresa XYZ - CNPJ: 00.000.000/0001-00",
+        dataTypes: "Coletamos: dados de navegação para análise estatística",
+        userRights: "Direitos: acessar, corrigir, excluir dados (dpo@empresa.com)"
       }}
+
+      // 🔔 Callbacks para auditoria (opcionais)
+      onConsentGiven={(state) => console.log('Consentimento registrado:', state)}
     >
+      <CookieBanner policyLinkUrl="/politica-de-privacidade" />
       <YourApp />
     </ConsentProvider>
   )
@@ -126,9 +137,40 @@ A biblioteca agora inclui **6 categorias** baseadas no Guia Orientativo da ANPD:
 
 > 📋 **[Guia Completo de Conformidade LGPD](./docs/CONFORMIDADE-LGPD.md)**
 
-### 🔧 Categorias Customizadas
+### � Sistema de Orientações para Desenvolvedores
+
+A v0.2.1 inclui sistema inteligente que **orienta developers sobre configuração adequada**:
+
+```tsx
+// ⚠️ Sem configuração - usa padrão e avisa
+<ConsentProvider>
+  <App />
+</ConsentProvider>
+// Console: "Usando padrão: necessary + analytics. Especificar para produção."
+
+// ✅ Configuração explícita - recomendado
+<ConsentProvider
+  categories={{
+    enabledCategories: ['analytics', 'marketing'],
+    customCategories: [...]
+  }}
+>
+  <App />
+</ConsentProvider>
+```
+
+**Console de desenvolvimento** mostra automaticamente:
+
+- 🟨 **Avisos**: Configuração faltante ou inconsistente
+- 💡 **Sugestões**: Melhorias para compliance
+- 🔧 **Tabela de categorias ativas**: Para UI customizada
+
+> 📋 **[Sistema de Orientações Completo](./docs/ORIENTACOES-DESENVOLVIMENTO.md)**
+
+### 🔧 Categorias Customizadas (API Legacy)
 
 ```tsx
+// LEGACY: ainda suportado, mas deprecated
 const customCategories = [
   {
     id: 'governo',
@@ -136,13 +178,6 @@ const customCategories = [
     description: 'Cookies para integração com sistemas governamentais.',
     essential: false,
     cookies: ['gov_session', 'cpf_hash']
-  },
-  {
-    id: 'acessibilidade',
-    name: 'Acessibilidade',
-    description: 'Ferramentas para melhorar acessibilidade.',
-    essential: false,
-    cookies: ['userway_*', 'voice_*']
   }
 ]
 
@@ -151,6 +186,60 @@ const customCategories = [
 </ConsentProvider>
 ```
 
+### 🎨 Componentes UI Dinâmicos (v0.2.2)
+
+Os componentes agora **renderizam automaticamente** baseado na configuração:
+
+```tsx
+import { useCategories, useCategoryStatus } from 'react-lgpd-consent'
+
+// ✅ Modal customizado que se adapta às categorias ativas
+function CustomPreferencesModal() {
+  const { toggleableCategories } = useCategories()
+  const { preferences, setPreferences } = useConsent()
+
+  return (
+    <dialog>
+      {/* Renderiza APENAS categorias configuradas no projeto */}
+      {toggleableCategories.map((category) => (
+        <label key={category.id}>
+          <input
+            type="checkbox"
+            checked={preferences[category.id] ?? false} // ✅ Controlado
+            onChange={(e) =>
+              setPreferences({
+                ...preferences,
+                [category.id]: e.target.checked,
+              })
+            }
+          />
+          <strong>{category.name}</strong>
+          <p>{category.description}</p>
+        </label>
+      ))}
+    </dialog>
+  )
+}
+
+// ✅ Feature condicional baseada em configuração
+function AnalyticsDashboard() {
+  const analytics = useCategoryStatus('analytics')
+
+  if (!analytics.isActive) {
+    return null // Categoria não configurada - não renderiza
+  }
+
+  return <div>Dashboard só aparece se analytics estiver configurado!</div>
+}
+```
+
+**Benefícios:**
+
+- ✅ **Zero bugs**: UI sempre consistente com configuração
+- ✅ **Performance**: Não renderiza categorias não utilizadas
+- ✅ **Manutenibilidade**: Mudou configuração? UI atualiza automaticamente
+- ✅ **Orientação**: Console avisa sobre inconsistências
+
 ### 🚀 Integrações Automáticas
 
 ```tsx
@@ -608,7 +697,16 @@ Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICE
 
 ## 🔮 Roadmap
 
-### v0.2.1 - Compliance Avançado (Próxima Release)
+### ✅ v0.2.2 - Sistema de Orientações (Lançado!)
+
+**Implementado: Sistema inteligente de orientação para desenvolvedores**
+
+- ✅ **Console de Desenvolvimento**: Avisos automáticos e orientações
+- ✅ **UI Dinâmica**: Componentes se adaptam à configuração do projeto
+- ✅ **Hooks Avançados**: `useCategories()` e `useCategoryStatus()`
+- ✅ **Validação Automática**: Prevenção de bugs de configuração vs UI
+
+### v0.2.3 - Compliance Avançado (Próxima Release)
 
 **Baseado em feedback de uso real em projetos governamentais:**
 
@@ -630,7 +728,7 @@ Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICE
 - 🔄 **Sync Multi-Domínio**: Consentimento compartilhado
 - 🛡️ **Segurança Empresarial**: Criptografia, audit logs remotos
 
-[📋 Ver plano detalhado v0.2.1](./docs/v0.2.1-PLAN.md)
+> 📋 **Implementado na v0.2.2**: Sistema de orientações para developers e UI dinâmica
 
 ---
 

package/dist/{PreferencesModal-4WHKT67T.js → PreferencesModal-UMNANMVX.js}

@@ -1,6 +1,6 @@
 import {
   PreferencesModal
-} from "./chunk-QCERRRSC.js";
+} from "./chunk-E763JXNL.js";
 export {
   PreferencesModal
 };