react-lgpd-consent 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -284,41 +284,192 @@ interface ConsentCookieOptions {
     path: string;
 }
 /**
- * Propriedades aceitas pelo componente ConsentProvider.
+ * Propriedades do componente ConsentProvider - configuração principal da biblioteca.
+ *
+ * @example Uso básico (configuração mínima):
+ * ```tsx
+ * <ConsentProvider
+ *   categories={{ enabledCategories: ['analytics'] }}
+ * >
+ *   <App />
+ * </ConsentProvider>
+ * ```
+ *
+ * @example Configuração completa com textos ANPD:
+ * ```tsx
+ * <ConsentProvider
+ *   categories={{
+ *     enabledCategories: ['analytics', 'functional'],
+ *     customCategories: [{
+ *       id: 'governo',
+ *       name: 'Cookies Governamentais',
+ *       description: 'Coleta para estatísticas públicas',
+ *       essential: false
+ *     }]
+ *   }}
+ *   texts={{
+ *     bannerMessage: 'Utilizamos cookies conforme LGPD...',
+ *     controllerInfo: 'Controlado por: Ministério XYZ - CNPJ: 00.000.000/0001-00',
+ *     dataTypes: 'Coletamos: dados de navegação para análise estatística',
+ *     userRights: 'Direitos: acessar, corrigir, excluir dados',
+ *     contactInfo: 'DPO: dpo@ministerio.gov.br'
+ *   }}
+ *   onConsentGiven={(state) => console.log('Consentimento:', state)}
+ * >
+ *   <App />
+ * </ConsentProvider>
+ * ```
  */
 interface ConsentProviderProps {
-    /** Estado inicial do consentimento (para SSR). */
+    /**
+     * Estado inicial do consentimento para hidratação SSR.
+     *
+     * @example
+     * ```tsx
+     * // Em Next.js para evitar flash do banner
+     * <ConsentProvider initialState={{ consented: true, preferences: {...} }}>
+     * ```
+     */
     initialState?: ConsentState;
-    /** Configuração de categorias ativas no projeto. */
+    /**
+     * Configuração das categorias de cookies utilizadas no projeto.
+     * Define quais categorias padrão serão habilitadas e categorias customizadas.
+     *
+     * @example Apenas analytics:
+     * ```tsx
+     * categories={{ enabledCategories: ['analytics'] }}
+     * ```
+     *
+     * @example Com categoria customizada:
+     * ```tsx
+     * categories={{
+     *   enabledCategories: ['analytics', 'marketing'],
+     *   customCategories: [{
+     *     id: 'pesquisa',
+     *     name: 'Cookies de Pesquisa',
+     *     description: 'Coleta feedback e opinião dos usuários',
+     *     essential: false
+     *   }]
+     * }}
+     * ```
+     */
     categories?: ProjectCategoriesConfig;
-    /** Textos customizados para a interface. */
+    /**
+     * Textos customizados da interface (banner e modal).
+     * Todos os campos são opcionais - valores não fornecidos usam o padrão em português.
+     *
+     * @example Textos básicos:
+     * ```tsx
+     * texts={{
+     *   bannerMessage: 'We use cookies...',
+     *   acceptAll: 'Accept All',
+     *   declineAll: 'Reject'
+     * }}
+     * ```
+     *
+     * @example Textos ANPD para compliance:
+     * ```tsx
+     * texts={{
+     *   controllerInfo: 'Controlado por: Empresa XYZ - CNPJ: 12.345.678/0001-90',
+     *   dataTypes: 'Coletamos: endereço IP, preferências de navegação',
+     *   userRights: 'Você pode solicitar acesso, correção ou exclusão dos dados'
+     * }}
+     * ```
+     */
     texts?: Partial<ConsentTexts>;
-    /** Tema customizado para os componentes MUI. Aceita qualquer propriedade. */
+    /**
+     * Tema customizado Material-UI aplicado aos componentes.
+     * Aceita qualquer objeto que será passado para ThemeProvider.
+     *
+     * @example
+     * ```tsx
+     * theme={{
+     *   palette: { primary: { main: '#1976d2' } },
+     *   components: { MuiButton: { styleOverrides: { root: { borderRadius: 8 } } } }
+     * }}
+     * ```
+     */
     theme?: any;
     /**
-     * @deprecated Use `categories.customCategories` em vez disso.
-     * Categorias customizadas de cookies (complementa as padrão).
+     * @deprecated Usar `categories.customCategories` em vez disso.
+     * Mantido para compatibilidade com v0.1.x
      */
     customCategories?: CategoryDefinition[];
-    /** Integrações nativas de scripts (Google Analytics, etc.). */
+    /**
+     * Integrações nativas de scripts terceiros (Google Analytics, etc.).
+     * Scripts são carregados automaticamente baseado no consentimento.
+     *
+     * @example
+     * ```tsx
+     * import { createGoogleAnalyticsIntegration } from 'react-lgpd-consent'
+     *
+     * scriptIntegrations={[
+     *   createGoogleAnalyticsIntegration('GA_MEASUREMENT_ID')
+     * ]}
+     * ```
+     */
     scriptIntegrations?: ScriptIntegration[];
-    /** Componente customizado para modal de preferências. */
+    /**
+     * Componente customizado para substituir o modal padrão de preferências.
+     * Deve implementar a lógica de consentimento usando os hooks da biblioteca.
+     */
     PreferencesModalComponent?: React.ComponentType<any>;
-    /** Props adicionais para o modal customizado. */
+    /** Props adicionais passadas para o modal customizado. */
     preferencesModalProps?: Record<string, any>;
-    /** Desabilita o modal automático (para usar componente totalmente customizado). */
+    /**
+     * Desabilita o modal automático de preferências.
+     * Útil quando se quer controle total sobre quando/como exibir as opções.
+     */
     disableAutomaticModal?: boolean;
-    /** Comportamento do banner: true = bloqueia até decisão, false = não bloqueia */
+    /**
+     * Comportamento do banner de consentimento:
+     * - `false` (padrão): Banner não-intrusivo, usuário pode navegar livremente
+     * - `true`: Banner bloqueia interação até decisão (compliance rigorosa)
+     */
     blocking?: boolean;
-    /** Esconde branding "fornecido por LÉdipO.eti.br". */
+    /** Oculta o branding "fornecido por LÉdipO.eti.br" dos componentes. */
     hideBranding?: boolean;
-    /** Callback chamado quando o consentimento é dado. */
+    /**
+     * Callback executado quando usuário dá consentimento pela primeira vez.
+     * Útil para inicializar analytics, registrar evento, etc.
+     *
+     * @example
+     * ```tsx
+     * onConsentGiven={(state) => {
+     *   console.log('Consentimento registrado:', state)
+     *   // Inicializar Google Analytics, etc.
+     * }}
+     * ```
+     */
     onConsentGiven?: (state: ConsentState) => void;
-    /** Callback chamado ao salvar preferências. */
+    /**
+     * Callback executado quando usuário modifica preferências.
+     * Executado após salvar as mudanças.
+     *
+     * @example
+     * ```tsx
+     * onPreferencesSaved={(prefs) => {
+     *   console.log('Novas preferências:', prefs)
+     *   // Reconfigurar scripts baseado nas preferências
+     * }}
+     * ```
+     */
     onPreferencesSaved?: (prefs: ConsentPreferences) => void;
-    /** Configurações customizadas do cookie. */
+    /**
+     * Configurações do cookie de consentimento.
+     * Valores não fornecidos usam padrões seguros para LGPD.
+     *
+     * @example
+     * ```tsx
+     * cookie={{
+     *   name: 'meuAppConsent',
+     *   maxAgeDays: 180,
+     *   sameSite: 'Strict'
+     * }}
+     * ```
+     */
     cookie?: Partial<ConsentCookieOptions>;
-    /** Elementos filhos do provider. */
+    /** Elementos filhos - toda a aplicação que precisa de contexto de consentimento. */
     children: React.ReactNode;
 }
 /**
@@ -362,7 +513,9 @@ interface ConsentContextValue {
  *   <App />
  * </ConsentProvider>
  */
-declare function ConsentProvider({ initialState, texts: textsProp, theme, customCategories, scriptIntegrations, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+declare function ConsentProvider({ initialState, categories, // NOVO: configuração completa de categorias
+texts: textsProp, theme, customCategories, // LEGACY: compatibilidade
+scriptIntegrations, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook principal para acessar e manipular o estado de consentimento de cookies.
@@ -398,14 +551,73 @@ declare function useConsentTexts(): ConsentTexts;
 declare function useConsentHydration(): boolean;
 
 /**
- * Hook para acessar as categorias customizadas.
- * Retorna apenas as categorias customizadas (não as padrão analytics/marketing).
+ * Sistema de orientações para developers sobre configuração de categorias.
+ * Ajuda a manter coerência entre configuração da lib e componentes customizados.
+ */
+interface DeveloperGuidance {
+    /** Avisos sobre configuração inconsistente */
+    warnings: string[];
+    /** Sugestões de melhoria */
+    suggestions: string[];
+    /** Informações sobre categorias ativas */
+    activeCategoriesInfo: {
+        id: string;
+        name: string;
+        description: string;
+        essential: boolean;
+        uiRequired: boolean;
+    }[];
+    /** Se usa configuração padrão (não explícita) */
+    usingDefaults: boolean;
+}
+/**
+ * Configuração padrão quando developer não especifica categorias.
+ * Baseado nas necessidades mais comuns em conformidade LGPD.
  */
-declare function useCustomCategories(): CategoryDefinition[];
+declare const DEFAULT_PROJECT_CATEGORIES: ProjectCategoriesConfig;
 /**
- * Hook para obter todas as categorias (padrão + customizadas).
+ * Analisa configuração do projeto e retorna orientações para o developer.
  */
-declare function useAllCategories(): CategoryDefinition[];
+declare function analyzeDeveloperConfiguration(config?: ProjectCategoriesConfig): DeveloperGuidance;
+
+/**
+ * Context para informações sobre categorias ativas no projeto.
+ * Fornece orientações e validações para components UI.
+ */
+interface CategoriesContextValue {
+    /** Configuração final das categorias (com padrão aplicado) */
+    config: ProjectCategoriesConfig;
+    /** Análise e orientações para developers */
+    guidance: DeveloperGuidance;
+    /** Categorias que precisam de toggle na UI */
+    toggleableCategories: DeveloperGuidance['activeCategoriesInfo'];
+    /** Todas as categorias ativas */
+    allCategories: DeveloperGuidance['activeCategoriesInfo'];
+    /** LEGACY: Apenas categorias customizadas (backward compatibility) */
+    legacyCategories: CategoryDefinition[];
+}
+/**
+ * Hook para acessar informações sobre categorias ativas.
+ * Usado por componentes UI para renderizar adequadamente.
+ */
+declare function useCategories(): CategoriesContextValue;
+/**
+ * Hook de conveniência para verificar se uma categoria específica está ativa.
+ */
+declare function useCategoryStatus(categoryId: string): {
+    isActive: boolean;
+    isEssential: boolean;
+    needsToggle: boolean;
+    name: string | undefined;
+    description: string | undefined;
+};
+/**
+ * LEGACY: Hook para acessar as categorias customizadas.
+ * Mantido para backward compatibility.
+ *
+ * @deprecated Use useCategories() ao invés disso para acesso completo às categorias.
+ */
+declare function useCustomCategories(): CategoryDefinition[];
 
 declare function ConsentGate(props: Readonly<{
     category: string;
@@ -482,4 +694,4 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  */
 declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
 
-export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, CookieBanner, FloatingPreferencesButton, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ScriptIntegration, type UserWayConfig, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useAllCategories, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useCustomCategories };
+export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, CookieBanner, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, FloatingPreferencesButton, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useCustomCategories };

package/dist/index.d.ts

@@ -284,41 +284,192 @@ interface ConsentCookieOptions {
     path: string;
 }
 /**
- * Propriedades aceitas pelo componente ConsentProvider.
+ * Propriedades do componente ConsentProvider - configuração principal da biblioteca.
+ *
+ * @example Uso básico (configuração mínima):
+ * ```tsx
+ * <ConsentProvider
+ *   categories={{ enabledCategories: ['analytics'] }}
+ * >
+ *   <App />
+ * </ConsentProvider>
+ * ```
+ *
+ * @example Configuração completa com textos ANPD:
+ * ```tsx
+ * <ConsentProvider
+ *   categories={{
+ *     enabledCategories: ['analytics', 'functional'],
+ *     customCategories: [{
+ *       id: 'governo',
+ *       name: 'Cookies Governamentais',
+ *       description: 'Coleta para estatísticas públicas',
+ *       essential: false
+ *     }]
+ *   }}
+ *   texts={{
+ *     bannerMessage: 'Utilizamos cookies conforme LGPD...',
+ *     controllerInfo: 'Controlado por: Ministério XYZ - CNPJ: 00.000.000/0001-00',
+ *     dataTypes: 'Coletamos: dados de navegação para análise estatística',
+ *     userRights: 'Direitos: acessar, corrigir, excluir dados',
+ *     contactInfo: 'DPO: dpo@ministerio.gov.br'
+ *   }}
+ *   onConsentGiven={(state) => console.log('Consentimento:', state)}
+ * >
+ *   <App />
+ * </ConsentProvider>
+ * ```
  */
 interface ConsentProviderProps {
-    /** Estado inicial do consentimento (para SSR). */
+    /**
+     * Estado inicial do consentimento para hidratação SSR.
+     *
+     * @example
+     * ```tsx
+     * // Em Next.js para evitar flash do banner
+     * <ConsentProvider initialState={{ consented: true, preferences: {...} }}>
+     * ```
+     */
     initialState?: ConsentState;
-    /** Configuração de categorias ativas no projeto. */
+    /**
+     * Configuração das categorias de cookies utilizadas no projeto.
+     * Define quais categorias padrão serão habilitadas e categorias customizadas.
+     *
+     * @example Apenas analytics:
+     * ```tsx
+     * categories={{ enabledCategories: ['analytics'] }}
+     * ```
+     *
+     * @example Com categoria customizada:
+     * ```tsx
+     * categories={{
+     *   enabledCategories: ['analytics', 'marketing'],
+     *   customCategories: [{
+     *     id: 'pesquisa',
+     *     name: 'Cookies de Pesquisa',
+     *     description: 'Coleta feedback e opinião dos usuários',
+     *     essential: false
+     *   }]
+     * }}
+     * ```
+     */
     categories?: ProjectCategoriesConfig;
-    /** Textos customizados para a interface. */
+    /**
+     * Textos customizados da interface (banner e modal).
+     * Todos os campos são opcionais - valores não fornecidos usam o padrão em português.
+     *
+     * @example Textos básicos:
+     * ```tsx
+     * texts={{
+     *   bannerMessage: 'We use cookies...',
+     *   acceptAll: 'Accept All',
+     *   declineAll: 'Reject'
+     * }}
+     * ```
+     *
+     * @example Textos ANPD para compliance:
+     * ```tsx
+     * texts={{
+     *   controllerInfo: 'Controlado por: Empresa XYZ - CNPJ: 12.345.678/0001-90',
+     *   dataTypes: 'Coletamos: endereço IP, preferências de navegação',
+     *   userRights: 'Você pode solicitar acesso, correção ou exclusão dos dados'
+     * }}
+     * ```
+     */
     texts?: Partial<ConsentTexts>;
-    /** Tema customizado para os componentes MUI. Aceita qualquer propriedade. */
+    /**
+     * Tema customizado Material-UI aplicado aos componentes.
+     * Aceita qualquer objeto que será passado para ThemeProvider.
+     *
+     * @example
+     * ```tsx
+     * theme={{
+     *   palette: { primary: { main: '#1976d2' } },
+     *   components: { MuiButton: { styleOverrides: { root: { borderRadius: 8 } } } }
+     * }}
+     * ```
+     */
     theme?: any;
     /**
-     * @deprecated Use `categories.customCategories` em vez disso.
-     * Categorias customizadas de cookies (complementa as padrão).
+     * @deprecated Usar `categories.customCategories` em vez disso.
+     * Mantido para compatibilidade com v0.1.x
      */
     customCategories?: CategoryDefinition[];
-    /** Integrações nativas de scripts (Google Analytics, etc.). */
+    /**
+     * Integrações nativas de scripts terceiros (Google Analytics, etc.).
+     * Scripts são carregados automaticamente baseado no consentimento.
+     *
+     * @example
+     * ```tsx
+     * import { createGoogleAnalyticsIntegration } from 'react-lgpd-consent'
+     *
+     * scriptIntegrations={[
+     *   createGoogleAnalyticsIntegration('GA_MEASUREMENT_ID')
+     * ]}
+     * ```
+     */
     scriptIntegrations?: ScriptIntegration[];
-    /** Componente customizado para modal de preferências. */
+    /**
+     * Componente customizado para substituir o modal padrão de preferências.
+     * Deve implementar a lógica de consentimento usando os hooks da biblioteca.
+     */
     PreferencesModalComponent?: React.ComponentType<any>;
-    /** Props adicionais para o modal customizado. */
+    /** Props adicionais passadas para o modal customizado. */
     preferencesModalProps?: Record<string, any>;
-    /** Desabilita o modal automático (para usar componente totalmente customizado). */
+    /**
+     * Desabilita o modal automático de preferências.
+     * Útil quando se quer controle total sobre quando/como exibir as opções.
+     */
     disableAutomaticModal?: boolean;
-    /** Comportamento do banner: true = bloqueia até decisão, false = não bloqueia */
+    /**
+     * Comportamento do banner de consentimento:
+     * - `false` (padrão): Banner não-intrusivo, usuário pode navegar livremente
+     * - `true`: Banner bloqueia interação até decisão (compliance rigorosa)
+     */
     blocking?: boolean;
-    /** Esconde branding "fornecido por LÉdipO.eti.br". */
+    /** Oculta o branding "fornecido por LÉdipO.eti.br" dos componentes. */
     hideBranding?: boolean;
-    /** Callback chamado quando o consentimento é dado. */
+    /**
+     * Callback executado quando usuário dá consentimento pela primeira vez.
+     * Útil para inicializar analytics, registrar evento, etc.
+     *
+     * @example
+     * ```tsx
+     * onConsentGiven={(state) => {
+     *   console.log('Consentimento registrado:', state)
+     *   // Inicializar Google Analytics, etc.
+     * }}
+     * ```
+     */
     onConsentGiven?: (state: ConsentState) => void;
-    /** Callback chamado ao salvar preferências. */
+    /**
+     * Callback executado quando usuário modifica preferências.
+     * Executado após salvar as mudanças.
+     *
+     * @example
+     * ```tsx
+     * onPreferencesSaved={(prefs) => {
+     *   console.log('Novas preferências:', prefs)
+     *   // Reconfigurar scripts baseado nas preferências
+     * }}
+     * ```
+     */
     onPreferencesSaved?: (prefs: ConsentPreferences) => void;
-    /** Configurações customizadas do cookie. */
+    /**
+     * Configurações do cookie de consentimento.
+     * Valores não fornecidos usam padrões seguros para LGPD.
+     *
+     * @example
+     * ```tsx
+     * cookie={{
+     *   name: 'meuAppConsent',
+     *   maxAgeDays: 180,
+     *   sameSite: 'Strict'
+     * }}
+     * ```
+     */
     cookie?: Partial<ConsentCookieOptions>;
-    /** Elementos filhos do provider. */
+    /** Elementos filhos - toda a aplicação que precisa de contexto de consentimento. */
     children: React.ReactNode;
 }
 /**
@@ -362,7 +513,9 @@ interface ConsentContextValue {
  *   <App />
  * </ConsentProvider>
  */
-declare function ConsentProvider({ initialState, texts: textsProp, theme, customCategories, scriptIntegrations, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+declare function ConsentProvider({ initialState, categories, // NOVO: configuração completa de categorias
+texts: textsProp, theme, customCategories, // LEGACY: compatibilidade
+scriptIntegrations, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook principal para acessar e manipular o estado de consentimento de cookies.
@@ -398,14 +551,73 @@ declare function useConsentTexts(): ConsentTexts;
 declare function useConsentHydration(): boolean;
 
 /**
- * Hook para acessar as categorias customizadas.
- * Retorna apenas as categorias customizadas (não as padrão analytics/marketing).
+ * Sistema de orientações para developers sobre configuração de categorias.
+ * Ajuda a manter coerência entre configuração da lib e componentes customizados.
+ */
+interface DeveloperGuidance {
+    /** Avisos sobre configuração inconsistente */
+    warnings: string[];
+    /** Sugestões de melhoria */
+    suggestions: string[];
+    /** Informações sobre categorias ativas */
+    activeCategoriesInfo: {
+        id: string;
+        name: string;
+        description: string;
+        essential: boolean;
+        uiRequired: boolean;
+    }[];
+    /** Se usa configuração padrão (não explícita) */
+    usingDefaults: boolean;
+}
+/**
+ * Configuração padrão quando developer não especifica categorias.
+ * Baseado nas necessidades mais comuns em conformidade LGPD.
  */
-declare function useCustomCategories(): CategoryDefinition[];
+declare const DEFAULT_PROJECT_CATEGORIES: ProjectCategoriesConfig;
 /**
- * Hook para obter todas as categorias (padrão + customizadas).
+ * Analisa configuração do projeto e retorna orientações para o developer.
  */
-declare function useAllCategories(): CategoryDefinition[];
+declare function analyzeDeveloperConfiguration(config?: ProjectCategoriesConfig): DeveloperGuidance;
+
+/**
+ * Context para informações sobre categorias ativas no projeto.
+ * Fornece orientações e validações para components UI.
+ */
+interface CategoriesContextValue {
+    /** Configuração final das categorias (com padrão aplicado) */
+    config: ProjectCategoriesConfig;
+    /** Análise e orientações para developers */
+    guidance: DeveloperGuidance;
+    /** Categorias que precisam de toggle na UI */
+    toggleableCategories: DeveloperGuidance['activeCategoriesInfo'];
+    /** Todas as categorias ativas */
+    allCategories: DeveloperGuidance['activeCategoriesInfo'];
+    /** LEGACY: Apenas categorias customizadas (backward compatibility) */
+    legacyCategories: CategoryDefinition[];
+}
+/**
+ * Hook para acessar informações sobre categorias ativas.
+ * Usado por componentes UI para renderizar adequadamente.
+ */
+declare function useCategories(): CategoriesContextValue;
+/**
+ * Hook de conveniência para verificar se uma categoria específica está ativa.
+ */
+declare function useCategoryStatus(categoryId: string): {
+    isActive: boolean;
+    isEssential: boolean;
+    needsToggle: boolean;
+    name: string | undefined;
+    description: string | undefined;
+};
+/**
+ * LEGACY: Hook para acessar as categorias customizadas.
+ * Mantido para backward compatibility.
+ *
+ * @deprecated Use useCategories() ao invés disso para acesso completo às categorias.
+ */
+declare function useCustomCategories(): CategoryDefinition[];
 
 declare function ConsentGate(props: Readonly<{
     category: string;
@@ -482,4 +694,4 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  */
 declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
 
-export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, CookieBanner, FloatingPreferencesButton, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ScriptIntegration, type UserWayConfig, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useAllCategories, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useCustomCategories };
+export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, CookieBanner, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, FloatingPreferencesButton, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useCustomCategories };

package/dist/index.js

@@ -1,14 +1,17 @@
 import {
   Branding,
   ConsentProvider,
+  DEFAULT_PROJECT_CATEGORIES,
   PreferencesModal,
+  analyzeDeveloperConfiguration,
   defaultConsentTheme,
-  useAllCategories,
+  useCategories,
+  useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentTexts,
   useCustomCategories
-} from "./chunk-QCERRRSC.js";
+} from "./chunk-E763JXNL.js";
 
 // src/components/CookieBanner.tsx
 import Button from "@mui/material/Button";
@@ -361,14 +364,17 @@ export {
   ConsentProvider,
   ConsentScriptLoader,
   CookieBanner,
+  DEFAULT_PROJECT_CATEGORIES,
   FloatingPreferencesButton,
   PreferencesModal,
+  analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
   createUserWayIntegration,
   defaultConsentTheme,
   loadScript,
-  useAllCategories,
+  useCategories,
+  useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Biblioteca completa de consentimento LGPD com 6 categorias ANPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",