@react-lgpd-consent/core 0.7.1 → 0.8.0

package/dist/index.d.cts

@@ -1,13 +1,34 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 
+/**
+ * Nível de severidade para mensagens de orientação ao desenvolvedor.
+ * @category Types
+ * @since 0.4.0
+ */
 type GuidanceSeverity = 'info' | 'warning' | 'error';
+/**
+ * Representa uma mensagem de orientação para o desenvolvedor.
+ * @category Types
+ * @since 0.4.0
+ * @example
+ * { severity: 'warning', message: 'Configuração ausente', category: 'configuration', actionable: true }
+ */
 interface GuidanceMessage {
+    /** Nível de severidade da mensagem */
     severity: GuidanceSeverity;
+    /** Texto da mensagem */
     message: string;
+    /** Categoria relacionada à mensagem */
     category?: string;
+    /** Indica se há ação recomendada */
     actionable?: boolean;
 }
+/**
+ * Configuração para controle de exibição de mensagens de orientação.
+ * @category Types
+ * @since 0.4.0
+ */
 interface GuidanceConfig {
     /** Controla se avisos devem ser exibidos */
     showWarnings?: boolean;
@@ -24,10 +45,19 @@ interface GuidanceConfig {
     /** Callback personalizado para processar mensagens */
     messageProcessor?: (messages: GuidanceMessage[]) => void;
 }
+/**
+ * Resultado da análise de configuração LGPD para orientação do desenvolvedor.
+ * @category Types
+ * @since 0.4.0
+ */
 interface DeveloperGuidance {
+    /** Lista de avisos críticos */
     warnings: string[];
+    /** Lista de sugestões */
     suggestions: string[];
+    /** Mensagens detalhadas de orientação */
     messages: GuidanceMessage[];
+    /** Informações das categorias ativas */
     activeCategoriesInfo: {
         id: string;
         name: string;
@@ -36,21 +66,62 @@ interface DeveloperGuidance {
         uiRequired: boolean;
         cookies?: string[];
     }[];
+    /** Indica se está usando configuração padrão */
     usingDefaults: boolean;
+    /** Score de conformidade LGPD (0-100) com carater orientativo */
     complianceScore?: number;
 }
+/**
+ * Configuração padrão de categorias do projeto.
+ * @category Consts
+ * @since 0.4.0
+ */
 declare const DEFAULT_PROJECT_CATEGORIES: ProjectCategoriesConfig;
 /**
- * Analisa configuração e integrações implícitas para orientar o dev.
- *
+ * Analisa configuração e integrações implícitas para orientar o desenvolvedor.
+ * @category Utils
+ * @param config Configuração de categorias do projeto
+ * @returns Objeto de orientação ao desenvolvedor
+ * @remarks
  * Since v0.4.0: inclui customCategories.
  * Since v0.4.1: considera categorias/integrações implícitas e enriquece cookies por categoria.
+ * @example
+ * const guidance = analyzeDeveloperConfiguration({ enabledCategories: ['analytics', 'marketing'] })
  */
 declare function analyzeDeveloperConfiguration(config?: ProjectCategoriesConfig): DeveloperGuidance;
+/**
+ * Loga orientação ao desenvolvedor no console/browser/servidor.
+ * @category Utils
+ * @param guidance Objeto de orientação
+ * @param disableGuidanceProp Desabilita logs se true
+ * @param config Configuração customizada de exibição
+ * @remarks
+ * Não loga em produção ou se desabilitado.
+ * @since 0.4.0
+ */
 declare function logDeveloperGuidance(guidance: DeveloperGuidance, disableGuidanceProp?: boolean, config?: GuidanceConfig): void;
+/**
+ * Hook React para análise e logging de orientação LGPD ao desenvolvedor.
+ * @category Hooks
+ * @param config Configuração de categorias do projeto
+ * @param disableGuidanceProp Desabilita logs se true
+ * @param guidanceConfig Configuração customizada de exibição
+ * @returns Objeto de orientação LGPD
+ * @remarks
+ * SSR-safe: só loga no client.
+ * @since 0.4.0
+ * @see analyzeDeveloperConfiguration
+ * @see logDeveloperGuidance
+ * @example
+ * const guidance = useDeveloperGuidance({ enabledCategories: ['analytics'] })
+ */
 declare function useDeveloperGuidance(config?: ProjectCategoriesConfig, disableGuidanceProp?: boolean, guidanceConfig?: GuidanceConfig): DeveloperGuidance;
 /**
- * Presets de configuração para diferentes ambientes
+ * Presets de configuração para diferentes ambientes de desenvolvimento/produção.
+ * @category Consts
+ * @since 0.4.0
+ * @example
+ * GUIDANCE_PRESETS.development
  */
 declare const GUIDANCE_PRESETS: {
     /** Configuração completa para desenvolvimento */
@@ -93,200 +164,470 @@ declare const GUIDANCE_PRESETS: {
 
 /**
  * @fileoverview
- * Definições de tipos TypeScript para o sistema de consentimento LGPD.
- *
- * Este arquivo contém todas as interfaces, tipos e estruturas de dados utilizadas
- * pela biblioteca react-lgpd-consent, incluindo definições de categorias,
- * estado de consentimento, configurações e textos da interface.
+ * Sistema de textos expandido com suporte avançado a internacionalização,
+ * contextos específicos e variações de tom.
  *
  * @author Luciano Édipo
- * @since 0.1.0
+ * @since 0.4.1
  */
+
 /**
- * Tipos de categorias padrão de consentimento para cookies, conforme definido pela ANPD.
- * @category Types
- * @since 0.2.0
- *
- * @remarks
- * Use este tipo para identificar as categorias principais de cookies suportadas nativamente pela biblioteca.
- * Cada categoria representa um tipo específico de processamento de dados:
- *
- * - `'necessary'`: Cookies essenciais para funcionamento do site (sempre ativos).
- * - `'analytics'`: Cookies para análise e estatísticas de uso.
- * - `'functional'`: Cookies para funcionalidades extras e preferências do usuário.
- * - `'marketing'`: Cookies para publicidade e marketing direcionado.
- * - `'social'`: Cookies para integração com redes sociais.
- * - `'personalization'`: Cookies para personalização de conteúdo e experiência.
+ * Tipo auxiliar para variações de texto.
  *
- * @example
- * ```typescript
- * const categories: Category[] = ['analytics', 'marketing'];
- * ```
+ * Define um subconjunto opcional dos textos principais do banner e modal,
+ * permitindo variações de tom (formal, casual, etc.) sem sobrescrever todos os textos.
  *
- * @public
+ * @category Types
+ * @since 0.4.1
  */
-type Category = 'necessary' | 'analytics' | 'functional' | 'marketing' | 'social' | 'personalization';
+type TextVariant = Partial<Pick<ConsentTexts, 'bannerMessage' | 'acceptAll' | 'declineAll' | 'modalTitle'>>;
 /**
- * Definição detalhada de uma categoria de cookie para uso interno.
- * @category Types
- * @since 0.2.0
- *
- * @remarks
- * Esta interface define a estrutura completa de uma categoria de cookies,
- * incluindo metadados e configurações específicas para processamento
- * e exibição na interface do usuário.
- *
- * @example
- * ```typescript
- * // Categoria padrão da biblioteca
- * const analyticsCategory: CategoryDefinition = {
- *   id: 'analytics',
- *   name: 'Cookies Analíticos',
- *   description: 'Utilizados para análise de uso do site',
- *   essential: false,
- *   cookies: ['_ga', '_ga_*', '_gid']
- * };
+ * Tipo auxiliar para textos de idioma.
  *
- * // Categoria customizada específica do projeto
- * const chatCategory: CategoryDefinition = {
- *   id: 'chat',
- *   name: 'Chat de Suporte',
- *   description: 'Widget de chat para suporte ao cliente',
- *   essential: false
- * };
- * ```
+ * Define um subconjunto dos textos principais, excluindo propriedades específicas de internacionalização
+ * e contextos, para uso em configurações multilíngues.
  *
- * @public
+ * @category Types
+ * @since 0.4.1
  */
-interface CategoryDefinition {
-    /**
-     * Identificador único da categoria.
-     * @example 'analytics'
-     */
-    id: string;
-    /**
-     * Nome amigável exibido na interface do usuário.
-     * @example 'Cookies Analíticos'
-     */
-    name: string;
-    /**
-     * Descrição detalhada da finalidade da categoria.
-     * @example 'Utilizados para análise de uso e comportamento no site'
-     */
-    description: string;
-    /**
-     * Indica se é uma categoria essencial que não pode ser desabilitada pelo usuário.
-     * @defaultValue false
-     */
-    essential?: boolean;
-    /**
-     * Lista de nomes de cookies ou padrões específicos desta categoria.
-     * @example ['_ga', '_ga_*', '_gid']
-     */
-    cookies?: string[];
-    /**
-     * Metadados detalhados sobre cookies típicos desta categoria.
-     * Não exaustivo; serve para orientar UI e documentação.
-     */
-    cookiesInfo?: CookieDescriptor[];
-}
+type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'>>;
 /**
- * Descritor de cookie com metadados úteis para UI/documentação.
- * @category Types
- * @since 0.2.0
- *
- * @remarks
- * Mantém compatibilidade com abordagens comuns no mercado.
- * Fornece informações detalhadas sobre cookies para exibição em interfaces
- * e documentação de compliance.
+ * Sistema de textos avançado com suporte a internacionalização e contextos específicos.
  *
- * @example
- * ```typescript
- * const cookieInfo: CookieDescriptor = {
- *   name: '_ga',
- *   purpose: 'analytics',
- *   duration: '2 years',
- *   domain: '.example.com',
- *   provider: 'Google Analytics'
- * };
- * ```
+ * Interface expandida que permite personalização granular de todas as mensagens da biblioteca.
+ * Suporta múltiplos idiomas, contextos específicos (e-commerce, SaaS, governo), variações
+ * de tom, e compliance completo com LGPD.
  *
- * @public
- */
-interface CookieDescriptor {
-    /**
-     * Identificador ou padrão do cookie.
-     * @example '_ga'
-     */
-    name: string;
-    /**
-     * Finalidade do cookie (opcional).
-     * @example 'analytics'
-     */
-    purpose?: string;
-    /**
-     * Tempo de retenção do cookie (opcional).
-     * @example '2 years'
-     */
-    duration?: string;
-    /**
-     * Domínio associado ao cookie (opcional).
-     * @example '.example.com'
-     */
-    domain?: string;
-    /**
-     * Provedor ou serviço associado ao cookie (opcional).
-     * @example 'Google Analytics'
-     */
-    provider?: string;
-}
-/**
- * Configuração de categorias ativas no projeto.
  * @category Types
- * @since 0.2.0
- *
+ * @since 0.4.1
  * @remarks
- * Define quais categorias fixas serão usadas (além de 'necessary' que é sempre incluída)
- * e permite extensão com categorias customizadas específicas do projeto.
- *
- * A categoria 'necessary' é sempre incluída automaticamente e não precisa ser
- * especificada em `enabledCategories`.
+ * **Histórico**: v0.4.1 - Nova interface com suporte avançado a i18n e contextos
  *
- * @example
+ * @example Configuração multilíngue
  * ```typescript
- * // Configuração básica
- * const config: ProjectCategoriesConfig = {
- *   enabledCategories: ['analytics', 'marketing']
- * };
- * ```
+ * const multiLangTexts: AdvancedConsentTexts = {
+ *   // Herda de ConsentTexts básico
+ *   bannerMessage: 'Utilizamos cookies para melhorar sua experiência.',
+ *   acceptAll: 'Aceitar todos',
+ *   declineAll: 'Recusar',
+ *   preferences: 'Preferências',
+ *   modalTitle: 'Preferências de Cookies',
+ *   modalIntro: 'Personalize suas preferências de cookies.',
+ *   save: 'Salvar',
+ *   necessaryAlwaysOn: 'Cookies necessários (sempre ativos)',
  *
- * @example
- * ```typescript
- * // Configuração com categorias customizadas
- * const config: ProjectCategoriesConfig = {
- *   enabledCategories: ['analytics'],
- *   customCategories: [
- *     {
- *       id: 'chat',
- *       name: 'Chat de Suporte',
- *       description: 'Widget de chat para suporte ao cliente'
+ *   // Textos expandidos
+ *   variants: {
+ *     formal: {
+ *       bannerMessage: 'Este sítio utiliza cookies para otimizar a experiência de navegação.',
+ *       acceptAll: 'Concordar com todos os cookies'
  *     },
- *     {
- *       id: 'abTesting',
- *       name: 'A/B Testing',
- *       description: 'Experimentos de interface e funcionalidades'
+ *     casual: {
+ *       bannerMessage: '🍪 Olá! Usamos cookies para tornar tudo mais gostoso aqui.',
+ *       acceptAll: 'Aceitar tudo'
  *     }
- *   ]
- * };
- * ```
+ *   },
  *
- * @public
+ *   // Internacionalização
+ *   i18n: {
+ *     en: {
+ *       bannerMessage: 'We use cookies to enhance your experience.',
+ *       acceptAll: 'Accept All',
+ *       declineAll: 'Decline'
+ *     },
+ *     es: {
+ *       bannerMessage: 'Utilizamos cookies para mejorar su experiencia.',
+ *       acceptAll: 'Aceptar Todo',
+ *       declineAll: 'Rechazar'
+ *     }
+ *   }
+ * }
+ * ```
  */
-interface ProjectCategoriesConfig {
-    /**
-     * Categorias padrão que serão ativadas.
-     * A categoria 'necessary' é sempre incluída automaticamente.
-     * @example ['analytics', 'marketing']
+interface AdvancedConsentTexts extends ConsentTexts {
+    /** Texto para confirmar ação */
+    confirm?: string;
+    /** Texto para cancelar ação */
+    cancel?: string;
+    /** Texto de carregamento */
+    loading?: string;
+    /** Textos específicos para cada categoria de cookie */
+    categories?: {
+        necessary?: {
+            name?: string;
+            description?: string;
+            examples?: string;
+        };
+        analytics?: {
+            name?: string;
+            description?: string;
+            examples?: string;
+        };
+        marketing?: {
+            name?: string;
+            description?: string;
+            examples?: string;
+        };
+        functional?: {
+            name?: string;
+            description?: string;
+            examples?: string;
+        };
+        performance?: {
+            name?: string;
+            description?: string;
+            examples?: string;
+        };
+    };
+    /** Mensagens de feedback ao usuário */
+    feedback?: {
+        /** Preferências salvas com sucesso */
+        saveSuccess?: string;
+        /** Erro ao salvar preferências */
+        saveError?: string;
+        /** Consentimento atualizado */
+        consentUpdated?: string;
+        /** Cookies rejeitados */
+        cookiesRejected?: string;
+        /** Configurações resetadas */
+        settingsReset?: string;
+    };
+    /** Labels ARIA e textos para leitores de tela */
+    accessibility?: {
+        /** Label do banner para leitores de tela */
+        bannerLabel?: string;
+        /** Label do modal para leitores de tela */
+        modalLabel?: string;
+        /** Instrução de navegação por teclado */
+        keyboardNavigation?: string;
+        /** Estado do toggle de categoria */
+        toggleState?: {
+            enabled?: string;
+            disabled?: string;
+        };
+        /** Região live para anúncios dinâmicos */
+        liveRegion?: string;
+    };
+    /** Textos otimizados para diferentes contextos */
+    contexts?: {
+        /** Contexto e-commerce */
+        ecommerce?: {
+            cartAbandonment?: string;
+            personalizedOffers?: string;
+            paymentSecurity?: string;
+            productRecommendations?: string;
+        };
+        /** Contexto SaaS */
+        saas?: {
+            userAnalytics?: string;
+            performanceMonitoring?: string;
+            featureUsage?: string;
+            customerSupport?: string;
+        };
+        /** Contexto governamental */
+        government?: {
+            citizenServices?: string;
+            dataProtection?: string;
+            transparency?: string;
+            accessibility?: string;
+        };
+        /** Contexto educacional */
+        education?: {
+            studentProgress?: string;
+            learningAnalytics?: string;
+            accessibility?: string;
+            parentalConsent?: string;
+        };
+    };
+    /** Diferentes variações de tom para a mesma mensagem */
+    variants?: {
+        /** Tom formal/profissional */
+        formal?: TextVariant;
+        /** Tom casual/amigável */
+        casual?: TextVariant;
+        /** Tom conciso/direto */
+        concise?: TextVariant;
+        /** Tom detalhado/explicativo */
+        detailed?: TextVariant;
+    };
+    /** Suporte a múltiplos idiomas */
+    i18n?: {
+        /** Textos em inglês */
+        en?: LanguageTexts;
+        /** Textos em espanhol */
+        es?: LanguageTexts;
+        /** Textos em francês */
+        fr?: LanguageTexts;
+        /** Textos em alemão */
+        de?: LanguageTexts;
+        /** Textos em italiano */
+        it?: LanguageTexts;
+    };
+    /** Informações técnicas sobre cookies */
+    technical?: {
+        /** Explicação sobre cookies de sessão */
+        sessionCookies?: string;
+        /** Explicação sobre cookies persistentes */
+        persistentCookies?: string;
+        /** Explicação sobre cookies de terceiros */
+        thirdPartyCookies?: string;
+        /** Como desabilitar cookies no navegador */
+        browserSettings?: string;
+        /** Impacto de desabilitar cookies */
+        disablingImpact?: string;
+    };
+    /** Cabeçalhos para tabela de detalhes de cookies */
+    cookieDetails?: {
+        tableHeaders?: {
+            name?: string;
+            purpose?: string;
+            duration?: string;
+            provider?: string;
+            type?: string;
+        };
+        /** Texto quando não há cookies para mostrar */
+        noCookies?: string;
+        /** Botão para expandir/colapsar detalhes */
+        toggleDetails?: {
+            expand?: string;
+            collapse?: string;
+        };
+        /** Prefixo exibido antes do ID do script */
+        scriptLabelPrefix?: string;
+        /** Texto de finalidade para scripts ativos detectados */
+        scriptPurpose?: string;
+    };
+}
+/**
+ * Textos padrão expandidos para diferentes contextos e idiomas.
+ *
+ * @category Utils
+ * @since 0.4.1
+ */
+declare const EXPANDED_DEFAULT_TEXTS: Partial<AdvancedConsentTexts>;
+/**
+ * Utilitário para resolver textos baseado em idioma, contexto e variação.
+ *
+ * @category Utils
+ * @since 0.4.1
+ *
+ * @param texts - Textos avançados configurados
+ * @param options - Opções de resolução
+ * @returns Textos resolvidos para o contexto
+ */
+declare function resolveTexts(texts: AdvancedConsentTexts, options?: {
+    language?: 'pt' | 'en' | 'es' | 'fr' | 'de' | 'it';
+    context?: 'ecommerce' | 'saas' | 'government' | 'education';
+    variant?: 'formal' | 'casual' | 'concise' | 'detailed';
+}): AdvancedConsentTexts;
+/**
+ * Templates pré-configurados para diferentes contextos.
+ *
+ * @category Utils
+ * @since 0.4.1
+ */
+declare const TEXT_TEMPLATES: {
+    readonly ecommerce: AdvancedConsentTexts;
+    readonly saas: AdvancedConsentTexts;
+    readonly government: AdvancedConsentTexts;
+};
+
+/**
+ * @fileoverview
+ * Definições de tipos TypeScript para o sistema de consentimento LGPD.
+ *
+ * Este arquivo contém todas as interfaces, tipos e estruturas de dados utilizadas
+ * pela biblioteca react-lgpd-consent, incluindo definições de categorias,
+ * estado de consentimento, configurações e textos da interface.
+ *
+ * @author Luciano Édipo
+ * @since 0.1.0
+ */
+/**
+ * Tipos de categorias padrão de consentimento para cookies, conforme definido pela ANPD.
+ * @category Types
+ * @since 0.2.0
+ *
+ * @remarks
+ * Use este tipo para identificar as categorias principais de cookies suportadas nativamente pela biblioteca.
+ * Cada categoria representa um tipo específico de processamento de dados:
+ *
+ * - `'necessary'`: Cookies essenciais para funcionamento do site (sempre ativos).
+ * - `'analytics'`: Cookies para análise e estatísticas de uso.
+ * - `'functional'`: Cookies para funcionalidades extras e preferências do usuário.
+ * - `'marketing'`: Cookies para publicidade e marketing direcionado.
+ * - `'social'`: Cookies para integração com redes sociais.
+ * - `'personalization'`: Cookies para personalização de conteúdo e experiência.
+ *
+ * @example
+ * ```typescript
+ * const categories: Category[] = ['analytics', 'marketing'];
+ * ```
+ *
+ * @public
+ */
+type Category = 'necessary' | 'analytics' | 'functional' | 'marketing' | 'social' | 'personalization';
+/**
+ * Definição detalhada de uma categoria de cookie para uso interno.
+ * @category Types
+ * @since 0.2.0
+ *
+ * @remarks
+ * Esta interface define a estrutura completa de uma categoria de cookies,
+ * incluindo metadados e configurações específicas para processamento
+ * e exibição na interface do usuário.
+ *
+ * @example
+ * ```typescript
+ * // Categoria padrão da biblioteca
+ * const analyticsCategory: CategoryDefinition = {
+ *   id: 'analytics',
+ *   name: 'Cookies Analíticos',
+ *   description: 'Utilizados para análise de uso do site',
+ *   essential: false,
+ *   cookies: ['_ga', '_ga_*', '_gid']
+ * };
+ *
+ * // Categoria customizada específica do projeto
+ * const chatCategory: CategoryDefinition = {
+ *   id: 'chat',
+ *   name: 'Chat de Suporte',
+ *   description: 'Widget de chat para suporte ao cliente',
+ *   essential: false
+ * };
+ * ```
+ *
+ * @public
+ */
+interface CategoryDefinition {
+    /**
+     * Identificador único da categoria.
+     * @example 'analytics'
+     */
+    id: string;
+    /**
+     * Nome amigável exibido na interface do usuário.
+     * @example 'Cookies Analíticos'
+     */
+    name: string;
+    /**
+     * Descrição detalhada da finalidade da categoria.
+     * @example 'Utilizados para análise de uso e comportamento no site'
+     */
+    description: string;
+    /**
+     * Indica se é uma categoria essencial que não pode ser desabilitada pelo usuário.
+     * @defaultValue false
+     */
+    essential?: boolean;
+    /**
+     * Lista de nomes de cookies ou padrões específicos desta categoria.
+     * @example ['_ga', '_ga_*', '_gid']
+     */
+    cookies?: string[];
+    /**
+     * Metadados detalhados sobre cookies típicos desta categoria.
+     * Não exaustivo; serve para orientar UI e documentação.
+     */
+    cookiesInfo?: CookieDescriptor[];
+}
+/**
+ * Descritor de cookie com metadados úteis para UI/documentação.
+ * @category Types
+ * @since 0.2.0
+ *
+ * @remarks
+ * Mantém compatibilidade com abordagens comuns no mercado.
+ * Fornece informações detalhadas sobre cookies para exibição em interfaces
+ * e documentação de compliance.
+ *
+ * @example
+ * ```typescript
+ * const cookieInfo: CookieDescriptor = {
+ *   name: '_ga',
+ *   purpose: 'analytics',
+ *   duration: '2 years',
+ *   domain: '.example.com',
+ *   provider: 'Google Analytics'
+ * };
+ * ```
+ *
+ * @public
+ */
+interface CookieDescriptor {
+    /**
+     * Identificador ou padrão do cookie.
+     * @example '_ga'
+     */
+    name: string;
+    /**
+     * Finalidade do cookie (opcional).
+     * @example 'analytics'
+     */
+    purpose?: string;
+    /**
+     * Tempo de retenção do cookie (opcional).
+     * @example '2 years'
+     */
+    duration?: string;
+    /**
+     * Domínio associado ao cookie (opcional).
+     * @example '.example.com'
+     */
+    domain?: string;
+    /**
+     * Provedor ou serviço associado ao cookie (opcional).
+     * @example 'Google Analytics'
+     */
+    provider?: string;
+}
+/**
+ * Configuração de categorias ativas no projeto.
+ * @category Types
+ * @since 0.2.0
+ *
+ * @remarks
+ * Define quais categorias fixas serão usadas (além de 'necessary' que é sempre incluída)
+ * e permite extensão com categorias customizadas específicas do projeto.
+ *
+ * A categoria 'necessary' é sempre incluída automaticamente e não precisa ser
+ * especificada em `enabledCategories`.
+ *
+ * @example
+ * ```typescript
+ * // Configuração básica
+ * const config: ProjectCategoriesConfig = {
+ *   enabledCategories: ['analytics', 'marketing']
+ * };
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Configuração com categorias customizadas
+ * const config: ProjectCategoriesConfig = {
+ *   enabledCategories: ['analytics'],
+ *   customCategories: [
+ *     {
+ *       id: 'chat',
+ *       name: 'Chat de Suporte',
+ *       description: 'Widget de chat para suporte ao cliente'
+ *     },
+ *     {
+ *       id: 'abTesting',
+ *       name: 'A/B Testing',
+ *       description: 'Experimentos de interface e funcionalidades'
+ *     }
+ *   ]
+ * };
+ * ```
+ *
+ * @public
+ */
+interface ProjectCategoriesConfig {
+    /**
+     * Categorias padrão que serão ativadas.
+     * A categoria 'necessary' é sempre incluída automaticamente.
+     * @example ['analytics', 'marketing']
      */
     enabledCategories?: Category[];
     /**
@@ -832,6 +1173,19 @@ type BackdropConfig = boolean | string | {
  * @since 0.1.3
  * @remarks
  * **Histórico**: v0.4.1 - Expandido substancialmente com novos tokens
+ *
+ * ### Mapa de tokens (top-level)
+ * - `colors`: cores base, semânticas e por componente
+ * - `typography`: fonte, tamanhos, pesos e hierarquia
+ * - `spacing`: espaçamentos, padding/margin e radius
+ * - `layout`: posição, largura, backdrop e z-index
+ * - `effects`: sombras, transições e filtros
+ * - `accessibility`: contraste, motion e foco
+ * - `themes`: overrides para light/dark
+ *
+ * ### Overrides complementares (MUI)
+ * Mesmo com tokens, você pode ajustar detalhes via `sx` e `ThemeProvider`.
+ * Ex.: `cookieBannerProps.PaperProps.sx` e `preferencesModalProps.DialogProps.sx`.
  * @public
  *
  * @example Configuração básica
@@ -1278,7 +1632,19 @@ interface ConsentProviderProps {
      * }}
      * ```
      */
-    texts?: Partial<ConsentTexts>;
+    texts?: Partial<AdvancedConsentTexts>;
+    /**
+     * Idioma ativo para resolver textos via i18n (opcional).
+     * Quando definido, aplica `texts.i18n[language]` nos campos principais.
+     *
+     * @defaultValue 'pt'
+     */
+    language?: 'pt' | 'en' | 'es' | 'fr' | 'de' | 'it';
+    /**
+     * Variação de tom aplicada aos textos (opcional).
+     * Utiliza `texts.variants[variant]` como override dos textos principais.
+     */
+    textVariant?: 'formal' | 'casual' | 'concise' | 'detailed';
     /**
      * Tokens de design para customização visual avançada.
      * Oferece controle direto sobre cores, fontes, espaçamento e layout.
@@ -1327,6 +1693,16 @@ interface ConsentProviderProps {
      * - `true`: Banner bloqueia interação até decisão (compliance rigorosa)
      */
     blocking?: boolean;
+    /**
+     * Intensidade do bloqueio quando `blocking` estiver habilitado.
+     * - 'soft' (padrão): aplica apenas overlay visual (cliques bloqueados).
+     * - 'hard': aplica overlay + torna o conteúdo da aplicação inerte (sem foco/teclado).
+     *
+     * @remarks
+     * O modo `hard` utiliza o atributo `inert` para restringir navegação por teclado
+     * ao banner/modal, atendendo contextos regulatórios mais estritos.
+     */
+    blockingMode?: 'soft' | 'hard';
     /**
      * Estratégia de bloqueio quando `blocking` estiver habilitado.
      * - 'auto' (padrão):
@@ -1472,13 +1848,27 @@ interface ConsentProviderProps {
  * @since 0.3.1
  * @public
  * Fornece acesso ao estado de consentimento e ações necessárias para o banner.
+ *
+ * @example
+ * ```tsx
+ * function MyBanner({ acceptAll, rejectAll, openPreferences, texts }: CustomCookieBannerProps) {
+ *   return (
+ *     <div>
+ *       <p>{texts.bannerMessage}</p>
+ *       <button onClick={acceptAll}>{texts.acceptAll}</button>
+ *       <button onClick={rejectAll}>{texts.declineAll}</button>
+ *       <button onClick={openPreferences}>{texts.preferences}</button>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 interface CustomCookieBannerProps {
     consented: boolean;
     acceptAll: () => void;
     rejectAll: () => void;
     openPreferences: () => void;
-    texts: ConsentTexts;
+    texts: AdvancedConsentTexts;
     /** Indica se o branding padrão deve ser ocultado. */
     hideBranding?: boolean;
     /**
@@ -1497,6 +1887,28 @@ interface CustomCookieBannerProps {
  * Fornece acesso às preferências atuais do usuário, funções para atualizar e salvar preferências,
  * fechar o modal e textos customizados da interface.
  *
+ * @example
+ * ```tsx
+ * function MyPreferencesModal({
+ *   preferences,
+ *   setPreferences,
+ *   closePreferences,
+ *   isModalOpen,
+ *   texts,
+ * }: CustomPreferencesModalProps) {
+ *   if (!isModalOpen) return null
+ *   return (
+ *     <div role="dialog" aria-label={texts.accessibility?.modalLabel}>
+ *       <h2>{texts.modalTitle}</h2>
+ *       <button onClick={() => setPreferences({ ...preferences, analytics: true })}>
+ *         {texts.acceptAll}
+ *       </button>
+ *       <button onClick={closePreferences}>{texts.close ?? 'Fechar'}</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
  * @property preferences Preferências atuais de consentimento do usuário.
  * @property setPreferences Função para atualizar e salvar as preferências.
  * @property closePreferences Função para fechar o modal de preferências.
@@ -1508,7 +1920,7 @@ interface CustomPreferencesModalProps {
     setPreferences: (preferences: ConsentPreferences) => void;
     closePreferences: () => void;
     isModalOpen?: boolean;
-    texts: ConsentTexts;
+    texts: AdvancedConsentTexts;
 }
 /**
  * Props esperadas por um componente customizado de FloatingPreferencesButton.
@@ -1516,6 +1928,14 @@ interface CustomPreferencesModalProps {
  * @since 0.3.1
  * @public
  * Fornece acesso às ações de abertura do modal e ao estado de consentimento.
+ *
+ * @example
+ * ```tsx
+ * function MyFloatingButton({ openPreferences, consented }: CustomFloatingPreferencesButtonProps) {
+ *   if (!consented) return null
+ *   return <button onClick={openPreferences}>Gerenciar cookies</button>
+ * }
+ * ```
  */
 interface CustomFloatingPreferencesButtonProps {
     openPreferences: () => void;
@@ -1602,7 +2022,7 @@ type ConsentEventOrigin = 'banner' | 'modal' | 'reset' | 'programmatic';
  * @example
  * ```typescript
  * // Exemplo de evento no dataLayer
- * window.dataLayer.push({
+ * globalThis.window?.dataLayer?.push({
  *   event: 'consent_initialized',
  *   consent_version: '0.4.5',
  *   timestamp: '2025-10-25T13:52:33.729Z',
@@ -1640,7 +2060,7 @@ interface ConsentInitializedEvent {
  * @example
  * ```typescript
  * // Exemplo de evento no dataLayer após aceitar analytics
- * window.dataLayer.push({
+ * globalThis.window?.dataLayer?.push({
  *   event: 'consent_updated',
  *   consent_version: '0.4.5',
  *   timestamp: '2025-10-25T13:52:33.729Z',
@@ -1694,8 +2114,9 @@ type ConsentEvent = ConsentInitializedEvent | ConsentUpdatedEvent;
  *
  * @param {Readonly<ConsentProviderProps>} props - As propriedades para configurar o provider.
  * @param {ProjectCategoriesConfig} props.categories - **Obrigatório**. Define as categorias de cookies que seu projeto utiliza, em conformidade com o princípio de minimização da LGPD.
- * @param {Partial<ConsentTexts>} [props.texts] - Objeto para customizar todos os textos exibidos na UI.
+ * @param {Partial<AdvancedConsentTexts>} [props.texts] - Objeto para customizar todos os textos exibidos na UI.
  * @param {boolean} [props.blocking=false] - Se `true`, exibe um overlay que impede a interação com o site até uma decisão do usuário.
+ * @param {'soft' | 'hard'} [props.blockingMode='soft'] - Intensidade do bloqueio; use `hard` para tornar o conteúdo inerte e restringir navegação por teclado.
  * @param {(state: ConsentState) => void} [props.onConsentGiven] - Callback executado na primeira vez que o usuário dá o consentimento.
  * @param {(prefs: ConsentPreferences) => void} [props.onPreferencesSaved] - Callback executado sempre que o usuário salva novas preferências.
  * @param {boolean} [props.disableDeveloperGuidance=false] - Desativa as mensagens de orientação no console em ambiente de desenvolvimento.
@@ -1729,8 +2150,8 @@ type ConsentEvent = ConsentInitializedEvent | ConsentUpdatedEvent;
  * </ConsentProvider>
  * ```
  */
-declare function ConsentProvider({ initialState, categories, texts: textsProp, designTokens, PreferencesModalComponent, preferencesModalProps, CookieBannerComponent, cookieBannerProps, FloatingPreferencesButtonComponent, floatingPreferencesButtonProps, disableFloatingPreferencesButton, blocking, blockingStrategy, hideBranding: _hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, storage, onConsentVersionChange, disableDeveloperGuidance, guidanceConfig, children, disableDiscoveryLog, onConsentInit, onConsentChange, onAuditLog, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
-declare const defaultTexts: ConsentTexts;
+declare function ConsentProvider({ initialState, categories, texts: textsProp, language, textVariant, designTokens, PreferencesModalComponent, preferencesModalProps, CookieBannerComponent, cookieBannerProps, FloatingPreferencesButtonComponent, floatingPreferencesButtonProps, disableFloatingPreferencesButton, blocking, blockingMode, blockingStrategy, hideBranding: _hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, storage, onConsentVersionChange, disableDeveloperGuidance, guidanceConfig, children, disableDiscoveryLog, onConsentInit, onConsentChange, onAuditLog, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+declare const defaultTexts: AdvancedConsentTexts;
 
 /**
  * @fileoverview
@@ -1873,7 +2294,7 @@ declare const defaultTexts: ConsentTexts;
  *     return (
  *       <div>
  *         ❌ Este recurso requer cookies funcionais.
- *         <button onClick={() => window.openPreferencesModal?.()}>
+ *         <button onClick={() => globalThis.window?.openPreferencesModal?.()}>
  *           Alterar Preferências
  *         </button>
  *       </div>
@@ -2008,13 +2429,13 @@ declare function useConsent(): ConsentContextValue;
  * }
  * ```
  *
- * @see {@link ConsentTexts} - Interface completa dos textos
+ * @see {@link AdvancedConsentTexts} - Interface completa dos textos
  * @see {@link ConsentProvider} - Para configurar textos personalizados
  *
  * @public
  * @since 0.1.0
  */
-declare function useConsentTexts(): ConsentTexts;
+declare function useConsentTexts(): AdvancedConsentTexts;
 /**
  * Hook para verificar se a hidratação do estado de consentimento foi concluída.
  *
@@ -2106,7 +2527,7 @@ declare function useConsentTexts(): ConsentTexts;
  *     return (
  *       <div className="consent-partial">
  *         <p>Este recurso requer cookies funcionais.</p>
- *         <button onClick={() => window.openPreferencesModal?.()}>
+ *         <button onClick={() => globalThis.window?.openPreferencesModal?.()}>
  *           Alterar Preferências
  *         </button>
  *       </div>
@@ -2157,1577 +2578,1390 @@ declare function useConsentTexts(): ConsentTexts;
  * // Uso do hook customizado
  * function MyFeature() {
  *   const { isEnabled, isLoading } = useConsentAwareFeature('analytics');
- *
- *   if (isLoading) return <Skeleton />;
- *   if (!isEnabled) return <ConsentRequired />;
- *
- *   return <AnalyticsChart />;
- * }
- * ```
- *
- * @see {@link ConsentProvider} - Para configuração SSR
- *
- * @public
- * @since 0.1.0
- */
-declare function useConsentHydration(): boolean;
-/**
- * @function
- * @category Hooks
- * @since 0.3.1
- * Hook para abrir o modal de preferências programaticamente.
- *
- * @returns Função para abrir o modal de preferências.
- *
- * @remarks
- * Este hook retorna uma função que pode ser usada para abrir o modal de preferências
- * de qualquer lugar dentro do contexto do ConsentProvider. É útil para criar botões
- * customizados ou trigger o modal baseado em eventos específicos.
- *
- * @throws {Error} Se usado fora do ConsentProvider
- *
- * @example
- * ```tsx
- * function CustomButton() {
- *   const openPreferences = useOpenPreferencesModal();
- *
- *   return (
- *     <button onClick={openPreferences}>
- *       Configurar Cookies
- *     </button>
- *   );
- * }
- * ```
- */
-declare function useOpenPreferencesModal(): () => void;
-/**
- * @function
- * @category Utils
- * @since 0.3.1
- * Função global para abrir o modal de preferências de fora do contexto React.
- *
- * @remarks
- * Esta função permite abrir o modal de preferências de código JavaScript puro,
- * sem precisar estar dentro do contexto React. É útil para integração com
- * código legado ou bibliotecas de terceiros.
- *
- * A função é automaticamente registrada pelo ConsentProvider e limpa quando
- * o provider é desmontado.
- *
- * @example
- * ```javascript
- * // Em código JavaScript puro
- * window.openPreferencesModal?.();
- *
- * // Ou importando diretamente
- * import { openPreferencesModal } from 'react-lgpd-consent';
- * openPreferencesModal();
- * ```
- */
-declare function openPreferencesModal(): void;
-
-/**
- * @interface CategoriesContextValue
- * O valor fornecido pelo `CategoriesContext`, contendo informações sobre as categorias de cookies ativas no projeto.
- */
-interface CategoriesContextValue {
-    /** A configuração final das categorias, incluindo padrões aplicados. */
-    config: ProjectCategoriesConfig;
-    /** Análise e orientações para desenvolvedores, incluindo avisos e sugestões. */
-    guidance: DeveloperGuidance;
-    /** Um array de categorias que requerem um toggle na UI de preferências (não essenciais). */
-    toggleableCategories: DeveloperGuidance['activeCategoriesInfo'];
-    /** Um array contendo todas as categorias ativas no projeto (essenciais e não essenciais). */
-    allCategories: DeveloperGuidance['activeCategoriesInfo'];
-}
-/**
- * @hook
- * @category Hooks
- * @since 0.2.2
- * Hook para acessar informações sobre as categorias de cookies ativas no projeto.
- *
- * @remarks
- * Este hook deve ser usado dentro do `ConsentProvider` (que internamente renderiza o `CategoriesProvider`).
- * Ele é útil para construir componentes de UI customizados que precisam se adaptar dinamicamente às categorias configuradas.
- *
- * @returns {CategoriesContextValue} Um objeto contendo a configuração, orientações e listas de categorias.
- *
- * @throws {Error} Se usado fora do `CategoriesProvider`.
- */
-declare function useCategories(): CategoriesContextValue;
-/**
- * @hook
- * @category Hooks
- * @since 0.2.2
- * Hook de conveniência para verificar o status de uma categoria de cookie específica.
- *
- * @param {string} categoryId O ID da categoria a ser verificada (ex: 'analytics', 'necessary').
- * @returns {object} Um objeto com o status da categoria:
- * - `isActive`: `true` se a categoria está configurada e ativa no projeto.
- * - `isEssential`: `true` se a categoria é essencial (não pode ser desativada pelo usuário).
- * - `needsToggle`: `true` se a categoria requer um controle (switch) na UI de preferências.
- * - `name`: O nome amigável da categoria.
- * - `description`: A descrição da categoria.
- * @example
- * ```tsx
- * const analyticsStatus = useCategoryStatus('analytics')
- * if (analyticsStatus.isActive && analyticsStatus.needsToggle) {
- *   // Renderizar switch para analytics
- * }
- * ```
- */
-declare function useCategoryStatus(categoryId: string): {
-    isActive: boolean;
-    isEssential: boolean;
-    needsToggle: boolean;
-    name: string | undefined;
-    description: string | undefined;
-};
-
-/**
- * Provider que envolve a árvore de componentes para fornecer tokens de design via contexto.
- *
- * @remarks
- * Use este provider no topo da aplicação ou seção onde os componentes de consentimento
- * precisam acessar tokens de design. Permite overrides globais de design sem alterar
- * os componentes individuais, mantendo tree-shaking e performance.
- *
- * @param tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
- * @param children - Componentes filhos que terão acesso aos tokens via contexto
- *
- * @example Uso básico com tokens padrão
- * ```tsx
- * import { DesignProvider } from './context/DesignContext';
- *
- * function App() {
- *   return (
- *     <DesignProvider>
- *       <CookieBanner />
- *     </DesignProvider>
- *   );
- * }
- * ```
- *
- * @example Customização de cores
- * ```tsx
- * const customTokens = {
- *   colors: {
- *     primary: '#ff0000',
- *     secondary: '#00ff00'
- *   }
- * };
- *
- * function App() {
- *   return (
- *     <DesignProvider tokens={customTokens}>
- *       <PreferencesModal />
- *     </DesignProvider>
- *   );
- * }
- * ```
- *
- *
- * @component
- * @category Context
- * @since 0.1.0
- */
-declare function DesignProvider({ tokens, children, }: Readonly<{
-    tokens?: DesignTokens;
-    children: React$1.ReactNode;
-}>): react_jsx_runtime.JSX.Element;
-/**
- * Hook para acessar os tokens de design do contexto atual.
- *
- * @remarks
- * Retorna os tokens de design fornecidos pelo DesignProvider mais próximo na árvore de componentes.
- * Se nenhum provider for encontrado ou tokens não forem definidos, retorna undefined.
- * Os componentes usam este hook para aplicar estilos consistentes via MUI `sx` ou outros mecanismos.
- *
- * @returns Os tokens de design atuais ou undefined se não houver provider ou tokens
- *
- * @throws {Error} Se usado fora de um DesignProvider (embora não lance erro, retorna undefined)
- *
- * @example Acesso a tokens em componente
- * ```tsx
- * import { useDesignTokens } from './context/DesignContext';
- *
- * function CustomButton() {
- *   const tokens = useDesignTokens();
- *   const primaryColor = tokens?.colors?.primary || '#default';
- *
- *   return (
- *     <button style={{ backgroundColor: primaryColor }}>
- *       Botão Customizado
- *     </button>
- *   );
- * }
- * ```
- *
- * @example Uso defensivo com fallbacks
- * ```tsx
- * function ThemedComponent() {
- *   const tokens = useDesignTokens();
- *
- *   return (
- *     <div style={{
- *       color: tokens?.colors?.text || '#333',
- *       fontSize: tokens?.typography?.fontSize || '16px'
- *     }}>
- *       Conteúdo temático
- *     </div>
- *   );
+ *
+ *   if (isLoading) return <Skeleton />;
+ *   if (!isEnabled) return <ConsentRequired />;
+ *
+ *   return <AnalyticsChart />;
  * }
  * ```
  *
- * @hook
- * @category Hooks
- * @since 0.1.0
- */
-declare function useDesignTokens(): DesignTokens | undefined;
-
-/**
- * ConsentGate - renderiza children apenas se houver consentimento para a categoria.
- *
- * @remarks
- * Não usa React.memo pois o estado de preferências muda dinamicamente
- * e o componente precisa re-renderizar quando as preferências mudam.
- * A lógica é leve o suficiente para não justificar memoização.
- */
-declare function ConsentGate(props: Readonly<{
-    category: string;
-    children: React$1.ReactNode;
-}>): react_jsx_runtime.JSX.Element | null;
-
-/**
- * @fileoverview
- * Utilitários para manipulação do cookie de consentimento.
- * A estrutura de dados do cookie é um JSON simples para atender aos requisitos da LGPD,
- * e não implementa o padrão IAB TCF, que é mais complexo.
- * Veja `src/types/types.ts` para a definição da estrutura `ConsentCookieData`.
- */
-
-/**
- * Gera o nome da chave de armazenamento (cookie/localStorage) combinando namespace e versão.
- * @param options.namespace Namespace lógico do consentimento (ex.: domínio raiz).
- * @param options.version Versão atual do consentimento (ex.: lote de políticas).
- */
-declare function buildConsentStorageKey(options?: {
-    namespace?: string | null;
-    version?: string | null;
-}): string;
-/**
- * Cria um registro de auditoria com carimbo de tempo, versão e snapshot das preferências.
- * @category Utils
- * @since 0.7.0
+ * @see {@link ConsentProvider} - Para configuração SSR
  *
- * @param state Estado atual de consentimento.
- * @param params.storageKey Chave de armazenamento (cookie/localStorage) aplicada.
- * @param params.action Ação que disparou o registro.
- * @param params.consentVersion Versão lógica do consentimento (ex.: bump de política/termo).
- * @param params.origin Origem explícita da decisão (opcional).
- */
-declare function createConsentAuditEntry(state: ConsentState, params: {
-    storageKey: string;
-    action: ConsentAuditAction;
-    consentVersion?: string | null;
-    origin?: ConsentEventOrigin;
-}): ConsentAuditEntry;
-
-/** @module src/utils/scriptLoader */
-/**
- * @category Utils
+ * @public
  * @since 0.1.0
- * Utilitários para carregamento dinâmico e seguro de scripts externos no DOM.
- *
- * Fornece funções para carregar scripts de terceiros de forma condicional ao consentimento LGPD,
- * garantindo compatibilidade SSR e verificações de permissões por categoria.
  */
-
-type ConsentSnapshot = {
-    consented: boolean;
-    preferences: ConsentPreferences;
-    isModalOpen?: boolean;
-};
-interface LoadScriptOptions {
-    consentSnapshot?: ConsentSnapshot;
-    cookieName?: string;
-    pollIntervalMs?: number;
-    skipConsentCheck?: boolean;
-}
+declare function useConsentHydration(): boolean;
 /**
  * @function
- * @category Utils
- * @since 0.1.0
- * Carrega dinamicamente um script externo no DOM.
+ * @category Hooks
+ * @since 0.3.1
+ * Hook para abrir o modal de preferências programaticamente.
+ *
+ * @returns Função para abrir o modal de preferências.
  *
  * @remarks
- * Esta função é utilizada internamente pela biblioteca para carregar scripts de integração
- * após o consentimento do usuário. Ela garante que o script só seja inserido na página
- * se o consentimento for dado e o contexto estiver disponível.
+ * Este hook retorna uma função que pode ser usada para abrir o modal de preferências
+ * de qualquer lugar dentro do contexto do ConsentProvider. É útil para criar botões
+ * customizados ou trigger o modal baseado em eventos específicos.
  *
- * **React 19 StrictMode**: A função é idempotente e mantém um registro global de scripts
- * em carregamento para evitar duplicações durante double-invoking de efeitos em desenvolvimento.
+ * @throws {Error} Se usado fora do ConsentProvider
  *
- * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
- * @param {string} src A URL do script externo a ser carregado.
- * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
- * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
- * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
- * @param {LoadScriptOptions} [options] Configurações avançadas (consentSnapshot, cookieName, pollIntervalMs, skipConsentCheck).
- * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
- * ```ts
- * // Carregar um script de analytics após o consentimento
- * loadScript('my-analytics-script', 'https://example.com/analytics.js', 'analytics')
- *   .then(() => console.log('Script de analytics carregado!'))
- *   .catch(error => console.error('Erro ao carregar script:', error))
+ * ```tsx
+ * function CustomButton() {
+ *   const openPreferences = useOpenPreferencesModal();
+ *
+ *   return (
+ *     <button onClick={openPreferences}>
+ *       Configurar Cookies
+ *     </button>
+ *   );
+ * }
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string, options?: LoadScriptOptions): Promise<void>;
-
+declare function useOpenPreferencesModal(): () => void;
 /**
- * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
- *
- * Fornece funções para detectar cookies presentes no navegador, identificar o cookie de consentimento
- * e atribuir cookies descobertos a categorias LGPD usando heurísticas baseadas em padrões conhecidos.
- *
+ * @function
  * @category Utils
- * @since 0.4.1
- * @remarks Funcionalidades experimentais para auxiliar no mapeamento de cookies em conformidade com LGPD.
- *          Recomenda-se uso em desenvolvimento para inspeção manual e merge com catálogo existente.
- */
-
-/**
- * Descobre cookies em tempo de execução no navegador (experimental).
- *
- * - Lê `document.cookie` com segurança (SSR-safe)
- * - Retorna lista de cookies detectados (apenas nomes)
- * - Salva em `globalThis.__LGPD_DISCOVERED_COOKIES__` para inspeção/manual merge
+ * @since 0.3.1
+ * Função global para abrir o modal de preferências de fora do contexto React.
  *
- * @category Utils
- * @since 0.4.1
- */
-declare function discoverRuntimeCookies(): CookieDescriptor[];
-/**
- * Tenta detectar o nome do cookie de consentimento pela estrutura JSON armazenada.
- * Retorna o nome se for encontrado, caso contrário `null`.
- * @category Utils
- * @since 0.4.1
- */
-declare function detectConsentCookieName(): string | null;
-/**
- * Heurística simples para atribuir cookies descobertos a categorias LGPD (experimental).
+ * @remarks
+ * Esta função permite abrir o modal de preferências de código JavaScript puro,
+ * sem precisar estar dentro do contexto React. É útil para integração com
+ * código legado ou bibliotecas de terceiros.
  *
- * - Usa padrões conhecidos por categoria
- * - Ignora `cookieConsent` (já tratado como necessary)
- * - Pode opcionalmente registrar overrides de catálogo por categoria
+ * A função é automaticamente registrada pelo ConsentProvider e limpa quando
+ * o provider é desmontado.
  *
- * @param discovered Lista de cookies descobertos (opcional: usa global se ausente)
- * @param registerOverrides Se `true`, registra em `setCookieCatalogOverrides`
- * @returns Mapa categoria -> descritores atribuídos
- * @category Utils
- * @since 0.4.1
- */
-declare function categorizeDiscoveredCookies(discovered?: CookieDescriptor[], registerOverrides?: boolean): Record<Category, CookieDescriptor[]>;
-
-/**
- * @fileoverview
- * Integrações nativas de scripts (GA, GTM, Facebook Pixel, Hotjar, Mixpanel, Clarity, Intercom, Zendesk, UserWay)
- * com categorias LGPD padrão, cookies típicos e pontos de extensão para URLs.
+ * @example
+ * ```javascript
+ * // Em código JavaScript puro
+ * globalThis.window?.openPreferencesModal?.();
  *
- * Princípios:
- * - Cada integração define uma categoria padrão (mais aderente ao uso no mercado)
- * - Cada cookie típico aparece em uma única categoria por padrão
- * - URLs possuem valores default atualizados e podem ser sobrescritos via `scriptUrl`
- * - SSR-safe: toda execução que toca `window` é protegida
+ * // Ou importando diretamente
+ * import { openPreferencesModal } from 'react-lgpd-consent';
+ * openPreferencesModal();
+ * ```
  */
+declare function openPreferencesModal(): void;
 
 /**
- * Integração de script de terceiros condicionada a consentimento.
- *
- * @category Utils
- * @since 0.2.0
- *
- * @remarks
- * **Breaking Change em v0.4.1**: O campo `category` mudou de `Category` para `string`
- * para suportar categorias customizadas. Código existente usando strings literais
- * continua funcionando sem alterações.
- *
- * @example
- * ```typescript
- * const integration: ScriptIntegration = {
- *   id: 'my-script',
- *   category: 'analytics',
- *   src: 'https://example.com/script.js',
- *   cookies: ['_example'],
- *   init: () => console.log('Script initialized')
- * }
- * ```
+ * @interface CategoriesContextValue
+ * O valor fornecido pelo `CategoriesContext`, contendo informações sobre as categorias de cookies ativas no projeto.
  */
-interface ScriptIntegration {
-    /** Identificador único da integração */
-    id: string;
-    /**
-     * Categoria LGPD à qual o script pertence.
-     * Suporta tanto categorias predefinidas quanto customizadas.
-     */
-    category: string;
-    /** Nome legível da integração (opcional) */
-    name?: string;
-    /** URL do script a ser carregado */
-    src: string;
-    /** Se o script deve ser carregado de forma assíncrona */
-    async?: boolean;
-    /** Se o script deve ser deferido */
-    defer?: boolean;
-    /** Configuração específica da integração */
-    config?: Record<string, unknown>;
-    /** Função de inicialização executada após carregamento do script */
-    init?: () => void;
-    /** Atributos HTML adicionais para a tag script */
-    attrs?: Record<string, string>;
-    /** Nonce CSP opcional aplicado à tag script */
-    nonce?: string;
-    /** Prioridade para ordenação na fila do loader (maior = executa primeiro dentro da categoria) */
-    priority?: number;
-    /** Rotina opcional executada antes do carregamento principal (ex.: bootstrap de Consent Mode) */
-    bootstrap?: () => void | Promise<void>;
-    /** Callback disparado quando o consentimento é atualizado */
-    onConsentUpdate?: (consent: {
-        consented: boolean;
-        preferences: ConsentPreferences;
-    }) => void;
-    /** Lista de cookies que o script pode definir */
-    cookies?: string[];
-    /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
-    cookiesInfo?: Array<{
-        name: string;
-        purpose: string;
-        duration: string;
-        provider: string;
-    }>;
+interface CategoriesContextValue {
+    /** A configuração final das categorias, incluindo padrões aplicados. */
+    config: ProjectCategoriesConfig;
+    /** Análise e orientações para desenvolvedores, incluindo avisos e sugestões. */
+    guidance: DeveloperGuidance;
+    /** Um array de categorias que requerem um toggle na UI de preferências (não essenciais). */
+    toggleableCategories: DeveloperGuidance['activeCategoriesInfo'];
+    /** Um array contendo todas as categorias ativas no projeto (essenciais e não essenciais). */
+    allCategories: DeveloperGuidance['activeCategoriesInfo'];
 }
 /**
- * Configuração para integração do Google Analytics (GA4).
+ * @hook
+ * @category Hooks
+ * @since 0.2.2
+ * Hook para acessar informações sobre as categorias de cookies ativas no projeto.
  *
- * @category Utils
- * @since 0.2.0
+ * @remarks
+ * Este hook deve ser usado dentro do `ConsentProvider` (que internamente renderiza o `CategoriesProvider`).
+ * Ele é útil para construir componentes de UI customizados que precisam se adaptar dinamicamente às categorias configuradas.
+ *
+ * @returns {CategoriesContextValue} Um objeto contendo a configuração, orientações e listas de categorias.
+ *
+ * @throws {Error} Se usado fora do `CategoriesProvider`.
+ */
+declare function useCategories(): CategoriesContextValue;
+/**
+ * @hook
+ * @category Hooks
+ * @since 0.2.2
+ * Hook de conveniência para verificar o status de uma categoria de cookie específica.
  *
+ * @param {string} categoryId O ID da categoria a ser verificada (ex: 'analytics', 'necessary').
+ * @returns {object} Um objeto com o status da categoria:
+ * - `isActive`: `true` se a categoria está configurada e ativa no projeto.
+ * - `isEssential`: `true` se a categoria é essencial (não pode ser desativada pelo usuário).
+ * - `needsToggle`: `true` se a categoria requer um controle (switch) na UI de preferências.
+ * - `name`: O nome amigável da categoria.
+ * - `description`: A descrição da categoria.
  * @example
- * ```typescript
- * const config: GoogleAnalyticsConfig = {
- *   measurementId: 'G-XXXXXXXXXX',
- *   config: { anonymize_ip: true }
+ * ```tsx
+ * const analyticsStatus = useCategoryStatus('analytics')
+ * if (analyticsStatus.isActive && analyticsStatus.needsToggle) {
+ *   // Renderizar switch para analytics
  * }
  * ```
  */
-interface GoogleAnalyticsConfig {
-    /** ID de medição do GA4 (formato: G-XXXXXXXXXX) */
-    measurementId: string;
-    /** Configurações adicionais para o gtag */
-    config?: Record<string, unknown>;
-    /** URL do script GA4. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+declare function useCategoryStatus(categoryId: string): {
+    isActive: boolean;
+    isEssential: boolean;
+    needsToggle: boolean;
+    name: string | undefined;
+    description: string | undefined;
+};
+
 /**
- * Configuração para integração do Google Tag Manager (GTM).
+ * Provider que envolve a árvore de componentes para fornecer tokens de design via contexto.
  *
- * @category Utils
- * @since 0.2.0
+ * @remarks
+ * Use este provider no topo da aplicação ou seção onde os componentes de consentimento
+ * precisam acessar tokens de design. Permite overrides globais de design sem alterar
+ * os componentes individuais, mantendo tree-shaking e performance.
  *
- * @example
- * ```typescript
- * const config: GoogleTagManagerConfig = {
- *   containerId: 'GTM-XXXXXXX',
- *   dataLayerName: 'customDataLayer'
+ * @param tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
+ * @param children - Componentes filhos que terão acesso aos tokens via contexto
+ *
+ * @example Uso básico com tokens padrão
+ * ```tsx
+ * import { DesignProvider } from './context/DesignContext';
+ *
+ * function App() {
+ *   return (
+ *     <DesignProvider>
+ *       <CookieBanner />
+ *     </DesignProvider>
+ *   );
  * }
  * ```
- */
-interface GoogleTagManagerConfig {
-    /** ID do container GTM (formato: GTM-XXXXXXX) */
-    containerId: string;
-    /** Nome customizado para o dataLayer. Padrão: 'dataLayer' */
-    dataLayerName?: string;
-    /** URL do script GTM. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
-/**
- * Configuração para integração do UserWay (Acessibilidade).
  *
- * @category Utils
- * @since 0.2.0
+ * @example Customização de cores
+ * ```tsx
+ * const customTokens = {
+ *   colors: {
+ *     primary: '#ff0000',
+ *     secondary: '#00ff00'
+ *   }
+ * };
  *
- * @example
- * ```typescript
- * const config: UserWayConfig = {
- *   accountId: 'XXXXXXXXXX'
+ * function App() {
+ *   return (
+ *     <DesignProvider tokens={customTokens}>
+ *       <PreferencesModal />
+ *     </DesignProvider>
+ *   );
  * }
  * ```
+ *
+ *
+ * @component
+ * @category Context
+ * @since 0.1.0
  */
-interface UserWayConfig {
-    /** ID da conta UserWay */
-    accountId: string;
-    /** URL do script UserWay. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+declare function DesignProvider({ tokens, children, }: Readonly<{
+    tokens?: DesignTokens;
+    children: React$1.ReactNode;
+}>): react_jsx_runtime.JSX.Element;
 /**
- * Cria integração do Google Analytics (GA4).
- * Configura o gtag e inicializa o tracking com o measurement ID fornecido.
+ * Hook para acessar os tokens de design do contexto atual.
  *
- * @category Utils
- * @param config - Configuração do Google Analytics
- * @returns Integração configurada para o GA4
- * @since 0.2.0
+ * @remarks
+ * Retorna os tokens de design fornecidos pelo DesignProvider mais próximo na árvore de componentes.
+ * Se nenhum provider for encontrado ou tokens não forem definidos, retorna undefined.
+ * Os componentes usam este hook para aplicar estilos consistentes via MUI `sx` ou outros mecanismos.
  *
- * @example
- * ```typescript
- * const ga = createGoogleAnalyticsIntegration({
- *   measurementId: 'G-XXXXXXXXXX',
- *   config: { anonymize_ip: true }
- * })
+ * @returns Os tokens de design atuais ou undefined se não houver provider ou tokens
+ *
+ * @throws {Error} Se usado fora de um DesignProvider (embora não lance erro, retorna undefined)
+ *
+ * @example Acesso a tokens em componente
+ * ```tsx
+ * import { useDesignTokens } from './context/DesignContext';
+ *
+ * function CustomButton() {
+ *   const tokens = useDesignTokens();
+ *   const primaryColor = tokens?.colors?.primary || '#default';
+ *
+ *   return (
+ *     <button style={{ backgroundColor: primaryColor }}>
+ *       Botão Customizado
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @example Uso defensivo com fallbacks
+ * ```tsx
+ * function ThemedComponent() {
+ *   const tokens = useDesignTokens();
+ *
+ *   return (
+ *     <div style={{
+ *       color: tokens?.colors?.text || '#333',
+ *       fontSize: tokens?.typography?.fontSize || '16px'
+ *     }}>
+ *       Conteúdo temático
+ *     </div>
+ *   );
+ * }
  * ```
  *
+ * @hook
+ * @category Hooks
+ * @since 0.1.0
+ */
+declare function useDesignTokens(): DesignTokens | undefined;
+
+/**
+ * ConsentGate - renderiza children apenas se houver consentimento para a categoria.
+ *
  * @remarks
- * - Define cookies: _ga, _ga_*, _gid
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
+ * Não usa React.memo pois o estado de preferências muda dinamicamente
+ * e o componente precisa re-renderizar quando as preferências mudam.
+ * A lógica é leve o suficiente para não justificar memoização.
  */
-declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
+declare function ConsentGate(props: Readonly<{
+    category: string;
+    children: React$1.ReactNode;
+}>): react_jsx_runtime.JSX.Element | null;
+
 /**
- * Cria integração do Google Tag Manager (GTM).
- * Configura o dataLayer e inicializa o container GTM.
+ * @fileoverview
+ * Utilitários para manipulação do cookie de consentimento.
+ * A estrutura de dados do cookie é um JSON simples para atender aos requisitos da LGPD,
+ * e não implementa o padrão IAB TCF, que é mais complexo.
+ * Veja `src/types/types.ts` para a definição da estrutura `ConsentCookieData`.
+ */
+
+/**
+ * Gera o nome da chave de armazenamento (cookie/localStorage) combinando namespace e versão.
+ * @param options.namespace Namespace lógico do consentimento (ex.: domínio raiz).
+ * @param options.version Versão atual do consentimento (ex.: lote de políticas).
+ */
+declare function buildConsentStorageKey(options?: {
+    namespace?: string | null;
+    version?: string | null;
+}): string;
+/**
+ * Cria um registro de auditoria com carimbo de tempo, versão e snapshot das preferências.
+ * @category Utils
+ * @since 0.7.0
  *
+ * @param state Estado atual de consentimento.
+ * @param params.storageKey Chave de armazenamento (cookie/localStorage) aplicada.
+ * @param params.action Ação que disparou o registro.
+ * @param params.consentVersion Versão lógica do consentimento (ex.: bump de política/termo).
+ * @param params.origin Origem explícita da decisão (opcional).
+ */
+declare function createConsentAuditEntry(state: ConsentState, params: {
+    storageKey: string;
+    action: ConsentAuditAction;
+    consentVersion?: string | null;
+    origin?: ConsentEventOrigin;
+}): ConsentAuditEntry;
+
+/** @module src/utils/scriptLoader */
+/**
  * @category Utils
- * @param config - Configuração do Google Tag Manager
- * @returns Integração configurada para o GTM
- * @since 0.2.0
+ * @since 0.1.0
+ * Utilitários para carregamento dinâmico e seguro de scripts externos no DOM.
  *
- * @example
- * ```typescript
- * const gtm = createGoogleTagManagerIntegration({
- *   containerId: 'GTM-XXXXXXX',
- *   dataLayerName: 'myDataLayer'
- * })
- * ```
+ * Fornece funções para carregar scripts de terceiros de forma condicional ao consentimento LGPD,
+ * garantindo compatibilidade SSR e verificações de permissões por categoria.
+ */
+
+type ConsentSnapshot = {
+    consented: boolean;
+    preferences: ConsentPreferences;
+    isModalOpen?: boolean;
+};
+interface LoadScriptOptions {
+    consentSnapshot?: ConsentSnapshot;
+    cookieName?: string;
+    pollIntervalMs?: number;
+    skipConsentCheck?: boolean;
+}
+/**
+ * @function
+ * @category Utils
+ * @since 0.1.0
+ * Carrega dinamicamente um script externo no DOM.
  *
  * @remarks
- * - Define cookies: _gcl_au
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
- */
-declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
-/**
- * Cria integração do UserWay (Acessibilidade).
- * Configura o widget de acessibilidade UserWay.
+ * Esta função é utilizada internamente pela biblioteca para carregar scripts de integração
+ * após o consentimento do usuário. Ela garante que o script só seja inserido na página
+ * se o consentimento for dado e o contexto estiver disponível.
  *
- * @category Utils
- * @param config - Configuração do UserWay
- * @returns Integração configurada para o UserWay
- * @since 0.2.0
+ * **React 19 StrictMode**: A função é idempotente e mantém um registro global de scripts
+ * em carregamento para evitar duplicações durante double-invoking de efeitos em desenvolvimento.
  *
+ * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
+ * @param {string} src A URL do script externo a ser carregado.
+ * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
+ * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
+ * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
+ * @param {LoadScriptOptions} [options] Configurações avançadas (consentSnapshot, cookieName, pollIntervalMs, skipConsentCheck).
+ * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
- * ```typescript
- * const userway = createUserWayIntegration({
- *   accountId: 'XXXXXXXXXX'
- * })
+ * ```ts
+ * // Carregar um script de analytics após o consentimento
+ * loadScript('my-analytics-script', 'https://example.com/analytics.js', 'analytics')
+ *   .then(() => console.log('Script de analytics carregado!'))
+ *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
- *
- * @remarks
- * - Define cookies: _userway_*
- * - Categoria padrão: 'functional'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string, options?: LoadScriptOptions): Promise<void>;
+
 /**
- * Funções fábricas para integrações comuns.
- * Fornece acesso direto às funções de criação de integrações pré-configuradas.
+ * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
  *
- * @category Utils
- * @since 0.2.0
+ * Fornece funções para detectar cookies presentes no navegador, identificar o cookie de consentimento
+ * e atribuir cookies descobertos a categorias LGPD usando heurísticas baseadas em padrões conhecidos.
  *
- * @example
- * ```typescript
- * const ga = COMMON_INTEGRATIONS.googleAnalytics({ measurementId: 'G-XXXXXXXXXX' })
- * ```
+ * @category Utils
+ * @since 0.4.1
+ * @remarks Funcionalidades experimentais para auxiliar no mapeamento de cookies em conformidade com LGPD.
+ *          Recomenda-se uso em desenvolvimento para inspeção manual e merge com catálogo existente.
  */
-declare const COMMON_INTEGRATIONS: {
-    googleAnalytics: typeof createGoogleAnalyticsIntegration;
-    googleTagManager: typeof createGoogleTagManagerIntegration;
-    userway: typeof createUserWayIntegration;
-};
+
 /**
- * Configuração para integração do Facebook Pixel.
+ * Descobre cookies em tempo de execução no navegador (experimental).
+ *
+ * - Lê `document.cookie` com segurança (SSR-safe)
+ * - Retorna lista de cookies detectados (apenas nomes)
+ * - Salva em `globalThis.__LGPD_DISCOVERED_COOKIES__` para inspeção/manual merge
  *
  * @category Utils
  * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: FacebookPixelConfig = {
- *   pixelId: '1234567890123456',
- *   autoTrack: true,
- *   advancedMatching: { email: 'user@example.com' }
- * }
- * ```
  */
-interface FacebookPixelConfig {
-    /** ID do pixel do Facebook */
-    pixelId: string;
-    /** Se deve rastrear PageView automaticamente. Padrão: true */
-    autoTrack?: boolean;
-    /** Configuração de correspondência avançada */
-    advancedMatching?: Record<string, unknown>;
-    /** URL do script do Pixel. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+declare function discoverRuntimeCookies(): CookieDescriptor[];
 /**
- * Configuração para integração do Hotjar.
+ * Tenta detectar o nome do cookie de consentimento LGPD presente no navegador.
+ *
+ * - Percorre todos os cookies disponíveis em `document.cookie`.
+ * - Decodifica o valor e verifica se corresponde à estrutura JSON esperada de consentimento.
+ * - Retorna o nome do cookie se encontrado, ou `null` se não houver nenhum compatível.
  *
+ * @returns Nome do cookie de consentimento ou `null` se não encontrado
  * @category Utils
  * @since 0.4.1
- *
  * @example
- * ```typescript
- * const config: HotjarConfig = {
- *   siteId: '1234567',
- *   version: 6,
- *   debug: false
+ * ```ts
+ * const consentCookie = detectConsentCookieName()
+ * if (consentCookie) {
+ *   console.log('Cookie de consentimento encontrado:', consentCookie)
  * }
  * ```
+ * @remarks SSR-safe: retorna `null` se executado fora do browser.
  */
-interface HotjarConfig {
-    /** ID do site no Hotjar */
-    siteId: string;
-    /** Versão do script Hotjar. Padrão: 6 */
-    version?: number;
-    /** Ativar modo debug. Padrão: false */
-    debug?: boolean;
-    /** URL do script Hotjar. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+declare function detectConsentCookieName(): string | null;
 /**
- * Configuração para integração do Mixpanel.
+ * Heurística simples para atribuir cookies descobertos a categorias LGPD (experimental).
+ *
+ * - Usa padrões conhecidos por categoria
+ * - Ignora `cookieConsent` (já tratado como necessary)
+ * - Pode opcionalmente registrar overrides de catálogo por categoria
  *
+ * @param discovered Lista de cookies descobertos (opcional: usa global se ausente)
+ * @param registerOverrides Se `true`, registra em `setCookieCatalogOverrides`
+ * @returns Mapa categoria -> descritores atribuídos
  * @category Utils
  * @since 0.4.1
+ */
+declare function categorizeDiscoveredCookies(discovered?: CookieDescriptor[], registerOverrides?: boolean): Record<Category, CookieDescriptor[]>;
+
+/**
+ * @fileoverview
+ * Integrações nativas de scripts (GA, GTM, Facebook Pixel, Hotjar, Mixpanel, Clarity, Intercom, Zendesk, UserWay)
+ * com categorias LGPD padrão, cookies típicos e pontos de extensão para URLs.
  *
- * @example
- * ```typescript
- * const config: MixpanelConfig = {
- *   token: 'your-project-token',
- *   config: { debug: true },
- *   api_host: 'https://api.mixpanel.com'
- * }
- * ```
+ * Princípios:
+ * - Cada integração define uma categoria padrão (mais aderente ao uso no mercado)
+ * - Cada cookie típico aparece em uma única categoria por padrão
+ * - URLs possuem valores default atualizados e podem ser sobrescritos via `scriptUrl`
+ * - SSR-safe: toda execução que toca `window` é protegida
  */
-interface MixpanelConfig {
-    /** Token do projeto Mixpanel */
-    token: string;
-    /** Configurações adicionais do Mixpanel */
-    config?: Record<string, unknown>;
-    /** Host customizado da API Mixpanel */
-    api_host?: string;
-    /** URL do script Mixpanel. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+
 /**
- * Configuração para integração do Microsoft Clarity.
+ * Integração de script de terceiros condicionada a consentimento.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.2.0
+ *
+ * @remarks
+ * **Breaking Change em v0.4.1**: O campo `category` mudou de `Category` para `string`
+ * para suportar categorias customizadas. Código existente usando strings literais
+ * continua funcionando sem alterações.
  *
  * @example
  * ```typescript
- * const config: ClarityConfig = {
- *   projectId: 'abcdefghij',
- *   upload: true
+ * const integration: ScriptIntegration = {
+ *   id: 'my-script',
+ *   category: 'analytics',
+ *   src: 'https://example.com/script.js',
+ *   cookies: ['_example'],
+ *   init: () => console.log('Script initialized')
  * }
  * ```
  */
-interface ClarityConfig {
-    /** ID do projeto no Microsoft Clarity */
-    projectId: string;
-    /** Configuração de upload de dados. Padrão: indefinido */
-    upload?: boolean;
-    /** URL do script Clarity. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
+interface ScriptIntegration {
+    /** Identificador único da integração */
+    id: string;
+    /**
+     * Categoria LGPD à qual o script pertence.
+     * Suporta tanto categorias predefinidas quanto customizadas.
+     */
+    category: string;
+    /** Nome legível da integração (opcional) */
+    name?: string;
+    /** URL do script a ser carregado */
+    src: string;
+    /** Se o script deve ser carregado de forma assíncrona */
+    async?: boolean;
+    /** Se o script deve ser deferido */
+    defer?: boolean;
+    /** Configuração específica da integração */
+    config?: Record<string, unknown>;
+    /** Função de inicialização executada após carregamento do script */
+    init?: () => void;
+    /** Atributos HTML adicionais para a tag script */
+    attrs?: Record<string, string>;
+    /** Nonce CSP opcional aplicado à tag script */
+    nonce?: string;
+    /** Prioridade para ordenação na fila do loader (maior = executa primeiro dentro da categoria) */
+    priority?: number;
+    /** Rotina opcional executada antes do carregamento principal (ex.: bootstrap de Consent Mode) */
+    bootstrap?: () => void | Promise<void>;
+    /** Callback disparado quando o consentimento é atualizado */
+    onConsentUpdate?: (consent: {
+        consented: boolean;
+        preferences: ConsentPreferences;
+    }) => void;
+    /** Lista de cookies que o script pode definir */
+    cookies?: string[];
+    /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
+    cookiesInfo?: Array<{
+        name: string;
+        purpose: string;
+        duration: string;
+        provider: string;
+    }>;
 }
 /**
- * Configuração para integração do Intercom.
+ * Configuração para integrações customizadas com categoria sugerida automaticamente.
  *
  * @category Utils
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: IntercomConfig = {
- *   app_id: 'your-app-id'
- * }
- * ```
+ * @since 0.7.2
  */
-interface IntercomConfig {
-    /** ID da aplicação Intercom */
-    app_id: string;
-    /** URL do script Intercom. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
+interface SuggestedIntegrationConfig extends Omit<ScriptIntegration, 'category'> {
+    /** Categoria LGPD customizada (opcional). Se omitida, usa sugestão automática. */
+    category?: string;
 }
 /**
- * Configuração para integração do Zendesk Chat.
+ * Cria integração customizada aplicando categoria sugerida automaticamente.
+ * Permite sobrescrever a categoria quando necessário.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.7.2
  *
  * @example
  * ```typescript
- * const config: ZendeskConfig = {
- *   key: 'your-zendesk-key'
- * }
- * ```
- */
-interface ZendeskConfig {
-    /** Chave de identificação do Zendesk */
-    key: string;
-    /** URL do script Zendesk. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+ * const custom = createSuggestedIntegration({
+ *   id: 'custom-chat',
+ *   src: 'https://example.com/chat.js'
+ * })
+ * // -> category sugerida: 'functional'
+ * ```
+ */
+declare function createSuggestedIntegration(config: SuggestedIntegrationConfig): ScriptIntegration;
 /**
- * Cria integração do Facebook Pixel.
- * Configura o fbq e inicializa o pixel com tracking automático opcional.
+ * Configuração para integração do Google Analytics (GA4).
  *
  * @category Utils
- * @param config - Configuração do Facebook Pixel
- * @returns Integração configurada para o Facebook Pixel
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const pixel = createFacebookPixelIntegration({
- *   pixelId: '1234567890123456',
- *   autoTrack: true
- * })
+ * const config: GoogleAnalyticsConfig = {
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: _fbp, fr
- * - Categoria padrão: 'marketing'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createFacebookPixelIntegration(config: FacebookPixelConfig): ScriptIntegration;
+interface GoogleAnalyticsConfig {
+    /** ID de medição do GA4 (formato: G-XXXXXXXXXX) */
+    measurementId: string;
+    /** Configurações adicionais para o gtag */
+    config?: Record<string, unknown>;
+    /** URL do script GA4. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Hotjar.
- * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
+ * Configuração para integração do Google Tag Manager (GTM).
  *
  * @category Utils
- * @param config - Configuração do Hotjar
- * @returns Integração configurada para o Hotjar
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const hotjar = createHotjarIntegration({
- *   siteId: '1234567',
- *   debug: true
- * })
+ * const config: GoogleTagManagerConfig = {
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'customDataLayer'
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
+interface GoogleTagManagerConfig {
+    /** ID do container GTM (formato: GTM-XXXXXXX) */
+    containerId: string;
+    /** Nome customizado para o dataLayer. Padrão: 'dataLayer' */
+    dataLayerName?: string;
+    /** URL do script GTM. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Mixpanel.
- * Configura e inicializa o Mixpanel para analytics de eventos.
+ * Configuração para integração do UserWay (Acessibilidade).
  *
  * @category Utils
- * @param config - Configuração do Mixpanel
- * @returns Integração configurada para o Mixpanel
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const mixpanel = createMixpanelIntegration({
- *   token: 'your-project-token',
- *   config: { debug: true }
- * })
+ * const config: UserWayConfig = {
+ *   accountId: 'XXXXXXXXXX'
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: mp_*
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na inicialização
  */
-declare function createMixpanelIntegration(config: MixpanelConfig): ScriptIntegration;
+interface UserWayConfig {
+    /** ID da conta UserWay */
+    accountId: string;
+    /** URL do script UserWay. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Microsoft Clarity.
- * Configura o Microsoft Clarity para heatmaps e analytics de comportamento.
+ * Cria integração do Google Analytics (GA4).
+ * Configura o gtag e inicializa o tracking com o measurement ID fornecido.
  *
  * @category Utils
- * @param config - Configuração do Microsoft Clarity
- * @returns Integração configurada para o Clarity
- * @since 0.4.1
+ * @param config - Configuração do Google Analytics
+ * @returns Integração configurada para o GA4
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const clarity = createClarityIntegration({
- *   projectId: 'abcdefghij',
- *   upload: false
+ * const ga = createGoogleAnalyticsIntegration({
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
  * })
  * ```
  *
  * @remarks
- * - Define cookies: _clck, _clsk, CLID, ANONCHK, MR, MUID, SM
+ * - Define cookies: _ga, _ga_*, _gid
  * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
- * - Configuração de upload opcional
  */
-declare function createClarityIntegration(config: ClarityConfig): ScriptIntegration;
+declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
 /**
- * Cria integração do Intercom.
- * Configura o widget de chat e suporte do Intercom.
+ * Cria integração do Google Tag Manager (GTM).
+ * Configura o dataLayer e inicializa o container GTM.
  *
  * @category Utils
- * @param config - Configuração do Intercom
- * @returns Integração configurada para o Intercom
- * @since 0.4.1
+ * @param config - Configuração do Google Tag Manager
+ * @returns Integração configurada para o GTM
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const intercom = createIntercomIntegration({
- *   app_id: 'your-app-id'
+ * const gtm = createGoogleTagManagerIntegration({
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'myDataLayer'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: intercom-id-*, intercom-session-*
- * - Categoria padrão: 'functional'
+ * - Define cookies: _gcl_au
+ * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na inicialização
  */
-declare function createIntercomIntegration(config: IntercomConfig): ScriptIntegration;
+declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
 /**
- * Cria integração do Zendesk Chat.
- * Configura o widget de chat e suporte do Zendesk.
+ * Cria integração do UserWay (Acessibilidade).
+ * Configura o widget de acessibilidade UserWay.
  *
  * @category Utils
- * @param config - Configuração do Zendesk Chat
- * @returns Integração configurada para o Zendesk Chat
- * @since 0.4.1
+ * @param config - Configuração do UserWay
+ * @returns Integração configurada para o UserWay
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const zendesk = createZendeskChatIntegration({
- *   key: 'your-zendesk-key'
+ * const userway = createUserWayIntegration({
+ *   accountId: 'XXXXXXXXXX'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: __zlcmid, _zendesk_shared_session
+ * - Define cookies: _userway_*
  * - Categoria padrão: 'functional'
  * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na identificação
  */
-declare function createZendeskChatIntegration(config: ZendeskConfig): ScriptIntegration;
+declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
 /**
- * Configuração para conjunto de integrações de e-commerce.
- * Define configurações opcionais para múltiplas integrações otimizadas para e-commerce.
+ * Funções fábricas para integrações comuns.
+ * Fornece acesso direto às funções de criação de integrações pré-configuradas.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const config: ECommerceConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   facebookPixel: { pixelId: '1234567890123456' }
- * }
+ * const ga = COMMON_INTEGRATIONS.googleAnalytics({ measurementId: 'G-XXXXXXXXXX' })
  * ```
  */
-interface ECommerceConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Facebook Pixel */
-    facebookPixel?: FacebookPixelConfig;
-    /** Configuração do Hotjar */
-    hotjar?: HotjarConfig;
-    /** Configuração do UserWay */
-    userway?: UserWayConfig;
-}
+declare const COMMON_INTEGRATIONS: {
+    googleAnalytics: typeof createGoogleAnalyticsIntegration;
+    googleTagManager: typeof createGoogleTagManagerIntegration;
+    userway: typeof createUserWayIntegration;
+};
 /**
- * Configuração para conjunto de integrações de SaaS.
- * Define configurações opcionais para múltiplas integrações otimizadas para SaaS.
+ * Configuração para integração do Facebook Pixel.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: SaaSConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   mixpanel: { token: 'your-token' },
- *   intercom: { app_id: 'your-app-id' }
+ * const config: FacebookPixelConfig = {
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true,
+ *   advancedMatching: { email: 'user@example.com' }
  * }
  * ```
  */
-interface SaaSConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Mixpanel */
-    mixpanel?: MixpanelConfig;
-    /** Configuração do Intercom */
-    intercom?: IntercomConfig;
-    /** Configuração do Hotjar */
-    hotjar?: HotjarConfig;
+interface FacebookPixelConfig {
+    /** ID do pixel do Facebook */
+    pixelId: string;
+    /** Se deve rastrear PageView automaticamente. Padrão: true */
+    autoTrack?: boolean;
+    /** Configuração de correspondência avançada */
+    advancedMatching?: Record<string, unknown>;
+    /** URL do script do Pixel. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
 }
 /**
- * Configuração para conjunto de integrações corporativas.
- * Define configurações opcionais para múltiplas integrações otimizadas para ambientes corporativos.
+ * Configuração para integração do Hotjar.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: CorporateConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
+ * const config: HotjarConfig = {
+ *   siteId: '1234567',
+ *   version: 6,
+ *   debug: false
  * }
  * ```
  */
-interface CorporateConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Microsoft Clarity */
-    clarity?: ClarityConfig;
-    /** Configuração do Zendesk Chat */
-    zendesk?: ZendeskConfig;
-    /** Configuração do UserWay */
-    userway?: UserWayConfig;
-}
-/**
- * Cria conjunto de integrações otimizado para e-commerce.
- * Combina analytics de conversão, remarketing e acessibilidade.
- *
- * @category Utils
- * @param cfg - Configuração das integrações de e-commerce
- * @returns Array de integrações configuradas
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const integrations = createECommerceIntegrations({
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   facebookPixel: { pixelId: '1234567890123456' }
- * })
- * ```
- *
- * @remarks
- * Combina categorias: analytics, marketing, functional
- */
-declare function createECommerceIntegrations(cfg: ECommerceConfig): ScriptIntegration[];
+interface HotjarConfig {
+    /** ID do site no Hotjar */
+    siteId: string;
+    /** Versão do script Hotjar. Padrão: 6 */
+    version?: number;
+    /** Ativar modo debug. Padrão: false */
+    debug?: boolean;
+    /** URL do script Hotjar. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria conjunto de integrações otimizado para SaaS.
- * Combina analytics de produto, suporte ao cliente e comportamento do usuário.
+ * Configuração para integração do Mixpanel.
  *
  * @category Utils
- * @param cfg - Configuração das integrações de SaaS
- * @returns Array de integrações configuradas
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const integrations = createSaaSIntegrations({
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   mixpanel: { token: 'your-project-token' },
- *   intercom: { app_id: 'your-app-id' }
- * })
+ * const config: MixpanelConfig = {
+ *   token: 'your-project-token',
+ *   config: { debug: true },
+ *   api_host: 'https://api.mixpanel.com'
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, functional
  */
-declare function createSaaSIntegrations(cfg: SaaSConfig): ScriptIntegration[];
+interface MixpanelConfig {
+    /** Token do projeto Mixpanel */
+    token: string;
+    /** Configurações adicionais do Mixpanel */
+    config?: Record<string, unknown>;
+    /** Host customizado da API Mixpanel */
+    api_host?: string;
+    /** URL do script Mixpanel. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria conjunto de integrações otimizado para ambientes corporativos.
- * Combina analytics empresariais, compliance e suporte corporativo.
+ * Configuração para integração do Microsoft Clarity.
  *
  * @category Utils
- * @param cfg - Configuração das integrações corporativas
- * @returns Array de integrações configuradas
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const integrations = createCorporateIntegrations({
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
- * })
+ * const config: ClarityConfig = {
+ *   projectId: 'abcdefghij',
+ *   upload: true
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, functional
  */
-declare function createCorporateIntegrations(cfg: CorporateConfig): ScriptIntegration[];
+interface ClarityConfig {
+    /** ID do projeto no Microsoft Clarity */
+    projectId: string;
+    /** Configuração de upload de dados. Padrão: indefinido */
+    upload?: boolean;
+    /** URL do script Clarity. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Templates pré-configurados de integrações por tipo de negócio.
- * Define integrações essenciais e opcionais para cada contexto.
+ * Configuração para integração do Intercom.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const template = INTEGRATION_TEMPLATES.ecommerce
- * console.log(template.essential) // ['google-analytics', 'facebook-pixel']
- * console.log(template.categories) // ['analytics', 'marketing', 'functional']
+ * const config: IntercomConfig = {
+ *   app_id: 'your-app-id'
+ * }
  * ```
- *
- * @remarks
- * Cada template define:
- * - essential: integrações obrigatórias/recomendadas
- * - optional: integrações complementares
- * - categories: categorias LGPD utilizadas
  */
-declare const INTEGRATION_TEMPLATES: {
-    ecommerce: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-    saas: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-    corporate: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-};
+interface IntercomConfig {
+    /** ID da aplicação Intercom */
+    app_id: string;
+    /** URL do script Intercom. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Sugere categorias LGPD apropriadas para um script baseado no nome/tipo.
- * Utiliza heurísticas para classificar scripts desconhecidos.
+ * Configuração para integração do Zendesk Chat.
  *
  * @category Utils
- * @param name - Nome ou identificador do script
- * @returns Array de categorias sugeridas
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * suggestCategoryForScript('facebook-pixel') // ['marketing']
- * suggestCategoryForScript('hotjar') // ['analytics']
- * suggestCategoryForScript('intercom-chat') // ['functional']
- * suggestCategoryForScript('unknown-script') // ['analytics']
+ * const config: ZendeskConfig = {
+ *   key: 'your-zendesk-key'
+ * }
  * ```
- *
- * @remarks
- * Heurísticas aplicadas:
- * - Scripts de ads/marketing → 'marketing'
- * - Scripts de analytics/tracking → 'analytics'
- * - Scripts de chat/suporte → 'functional'
- * - Padrão para desconhecidos → 'analytics'
  */
-declare function suggestCategoryForScript(name: string): string[];
-
-/**
- * Componente que carrega scripts automaticamente baseado no consentimento.
- * Facilita integração com ferramentas como Google Analytics, Tag Manager, etc.
- */
-
-interface RegisteredScript {
-    id: string;
-    category: string;
-    execute: () => void | Promise<void>;
-    priority?: number;
-    allowReload?: boolean;
-    onConsentUpdate?: (consent: {
-        consented: boolean;
-        preferences: ConsentPreferences;
-    }) => void;
+interface ZendeskConfig {
+    /** Chave de identificação do Zendesk */
+    key: string;
+    /** URL do script Zendesk. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
 }
 /**
- * Registra um script (inline ou externo) na fila controlada por consentimento.
- *
- * @remarks
- * - Scripts `necessary` rodam imediatamente; demais aguardam consentimento da categoria.
- * - Fluxo de estados: `pending` → `running` → `executed` (respeitando `allowReload` e `onConsentUpdate`).
- * - A fila é ordenada por categoria, `priority` (maior primeiro) e ordem de registro.
- * - `allowReload` permite reexecutar scripts quando o usuário muda preferências.
- * - Use `onConsentUpdate` para reenviar sinais (ex.: Consent Mode) após novas decisões.
- * - Sempre chame o cleanup retornado em efeitos React para evitar múltiplos registros do mesmo `id`.
+ * Cria integração do Facebook Pixel.
+ * Configura o fbq e inicializa o pixel com tracking automático opcional.
  *
- * @param def Definição do script a ser registrado.
- * @returns Função de cleanup para remover o script da fila.
- */
-declare function registerScript(def: RegisteredScript): () => void;
-interface ConsentScriptLoaderProps {
-    /** Lista de integrações de scripts para carregar baseado no consentimento */
-    integrations: ScriptIntegration[];
-    /** Se true, força recarregamento se consentimento mudar */
-    reloadOnChange?: boolean;
-    /** Nonce CSP aplicado às tags <script> geradas automaticamente (sobrescrevível por integração). */
-    nonce?: string;
-}
-/**
- * @component
  * @category Utils
- * @since 0.2.0
- * Componente que não renderiza UI, mas gerencia o carregamento de scripts de terceiros
- * (como Google Analytics) com base nas preferências de consentimento do usuário.
- *
- * @param props As propriedades do componente.
- * @param {ScriptIntegration[]} props.integrations Um array de objetos de integração de script. Use as factory functions (`createGoogleAnalyticsIntegration`, etc.) para criar.
- * @param {boolean} [props.reloadOnChange=false] Se `true`, recarrega os scripts se as preferências de consentimento mudarem.
+ * @param config - Configuração do Facebook Pixel
+ * @returns Integração configurada para o Facebook Pixel
+ * @since 0.4.1
  *
  * @example
- * ```tsx
- * const integrations = [
- *   createGoogleAnalyticsIntegration({ measurementId: 'GA_ID' }),
- *   createFacebookPixelIntegration({ pixelId: 'PIXEL_ID' })
- * ];
- *
- * <ConsentScriptLoader integrations={integrations} />
+ * ```typescript
+ * const pixel = createFacebookPixelIntegration({
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true
+ * })
  * ```
+ *
+ * @remarks
+ * - Define cookies: _fbp, fr
+ * - Categoria padrão: 'marketing'
+ * - SSR-safe: verifica disponibilidade do window
  */
-declare function ConsentScriptLoader({ integrations, reloadOnChange, nonce, }: Readonly<ConsentScriptLoaderProps>): null;
+declare function createFacebookPixelIntegration(config: FacebookPixelConfig): ScriptIntegration;
 /**
- * @hook
- * @category Hooks
- * @since 0.2.0
- * Hook para carregamento programático de um script baseado no consentimento.
+ * Cria integração do Hotjar.
+ * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
  *
- * @returns Uma função assíncrona que recebe um objeto de integração de script e tenta carregá-lo.
- * Retorna `true` em caso de sucesso e `false` em caso de falha (por falta de consentimento ou erro de rede).
+ * @category Utils
+ * @param config - Configuração do Hotjar
+ * @returns Integração configurada para o Hotjar
+ * @since 0.4.1
  *
  * @example
- * ```tsx
- * const loadScript = useConsentScriptLoader();
- *
- * useEffect(() => {
- *   const handleUserAction = async () => {
- *     const hotjarIntegration = { id: 'hotjar', category: 'analytics', src: '...' };
- *     const success = await loadScript(hotjarIntegration);
- *     if (success) {
- *       console.log('Hotjar carregado com sucesso!');
- *     }
- *   };
- *
- *   // Exemplo: carregar script após uma ação específica do usuário
- *   myButton.addEventListener('click', handleUserAction);
- * }, [loadScript]);
- * ```
- */
-declare function useConsentScriptLoader(): (integration: ScriptIntegration, nonce?: string) => Promise<boolean>;
-
-/**
- * @file autoConfigureCategories.ts
- * @description Sistema inteligente de auto-habilitação de categorias baseado nas integrações utilizadas
- * @since 0.4.1
- */
-
-/**
- * @interface CategoryAutoConfigResult
- * Resultado da análise e auto-configuração de categorias
- */
-interface CategoryAutoConfigResult {
-    /** Configuração original fornecida pelo desenvolvedor */
-    originalConfig: ProjectCategoriesConfig;
-    /** Configuração ajustada automaticamente pela biblioteca */
-    adjustedConfig: ProjectCategoriesConfig;
-    /** Categorias que foram automaticamente habilitadas */
-    autoEnabledCategories: string[];
-    /** Categorias requeridas pelas integrações mas não habilitadas */
-    missingCategories: string[];
-    /** Se algum ajuste foi necessário */
-    wasAdjusted: boolean;
-    /** Integrações que requerem cada categoria */
-    categoryIntegrations: Record<string, string[]>;
-}
+ * ```typescript
+ * const hotjar = createHotjarIntegration({
+ *   siteId: '1234567',
+ *   debug: true
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
+ */
+declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Mixpanel.
+ * Configura e inicializa o Mixpanel para analytics de eventos.
+ *
  * @category Utils
+ * @param config - Configuração do Mixpanel
+ * @returns Integração configurada para o Mixpanel
  * @since 0.4.1
- * Analisa as integrações fornecidas e determina quais categorias são necessárias.
  *
- * @param integrations Array de integrações de script
- * @returns Record mapeando categoria para nomes das integrações que a utilizam
+ * @example
+ * ```typescript
+ * const mixpanel = createMixpanelIntegration({
+ *   token: 'your-project-token',
+ *   config: { debug: true }
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: mp_*
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na inicialização
  */
-declare function analyzeIntegrationCategories(integrations: ScriptIntegration[]): Record<string, string[]>;
+declare function createMixpanelIntegration(config: MixpanelConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Microsoft Clarity.
+ * Configura o Microsoft Clarity para heatmaps e analytics de comportamento.
+ *
  * @category Utils
+ * @param config - Configuração do Microsoft Clarity
+ * @returns Integração configurada para o Clarity
  * @since 0.4.1
- * Configura automaticamente as categorias necessárias baseado nas integrações utilizadas.
  *
- * Esta função implementa o comportamento inteligente da biblioteca:
- * 1. Detecta categorias requeridas pelas integrações
- * 2. Auto-habilita categorias em falta (modo padrão)
- * 3. Ou apenas avisa sobre categorias em falta (modo warning-only)
- * 4. Loga no console em modo DEV
+ * @example
+ * ```typescript
+ * const clarity = createClarityIntegration({
+ *   projectId: 'abcdefghij',
+ *   upload: false
+ * })
+ * ```
  *
- * @param originalConfig Configuração original do ConsentProvider
- * @param integrations Array de integrações que serão utilizadas
- * @param options Opções de comportamento
- * @returns Resultado da análise e configuração automática
+ * @remarks
+ * - Define cookies: _clck, _clsk, CLID, ANONCHK, MR, MUID, SM
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Configuração de upload opcional
  */
-declare function autoConfigureCategories(originalConfig: ProjectCategoriesConfig | undefined, integrations: ScriptIntegration[], options?: {
-    /** Se true, apenas avisa mas não modifica a config (padrão: false - auto-habilita) */
-    warningOnly?: boolean;
-    /** Se true, desabilita logs no console (padrão: false) */
-    silent?: boolean;
-}): CategoryAutoConfigResult;
+declare function createClarityIntegration(config: ClarityConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Intercom.
+ * Configura o widget de chat e suporte do Intercom.
+ *
  * @category Utils
+ * @param config - Configuração do Intercom
+ * @returns Integração configurada para o Intercom
  * @since 0.4.1
- * Valida se todas as integrações têm suas categorias habilitadas.
- * Útil para validação em tempo de execução.
  *
- * @param integrations Array de integrações
- * @param enabledCategories Array de categorias habilitadas
- * @returns true se todas as categorias necessárias estão habilitadas
+ * @example
+ * ```typescript
+ * const intercom = createIntercomIntegration({
+ *   app_id: 'your-app-id'
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: intercom-id-*, intercom-session-*
+ * - Categoria padrão: 'functional'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na inicialização
  */
-declare function validateIntegrationCategories(integrations: ScriptIntegration[], enabledCategories: string[]): boolean;
+declare function createIntercomIntegration(config: IntercomConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Zendesk Chat.
+ * Configura o widget de chat e suporte do Zendesk.
+ *
  * @category Utils
+ * @param config - Configuração do Zendesk Chat
+ * @returns Integração configurada para o Zendesk Chat
  * @since 0.4.1
- * Extrai categorias únicas de um array de integrações
  *
- * @param integrations Array de integrações
- * @returns Array de categorias únicas
+ * @example
+ * ```typescript
+ * const zendesk = createZendeskChatIntegration({
+ *   key: 'your-zendesk-key'
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: __zlcmid, _zendesk_shared_session
+ * - Categoria padrão: 'functional'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na identificação
  */
-declare function extractCategoriesFromIntegrations(integrations: ScriptIntegration[]): string[];
+declare function createZendeskChatIntegration(config: ZendeskConfig): ScriptIntegration;
 /**
- * @function
+ * Configuração para conjunto de integrações de e-commerce.
+ * Define configurações opcionais para múltiplas integrações otimizadas para e-commerce.
+ *
  * @category Utils
  * @since 0.4.1
- * Valida se integrações estão sendo incorretamente classificadas como "necessary".
- *
- * Esta função protege contra violações de GDPR/LGPD identificando scripts que
- * NUNCA devem ser considerados estritamente necessários.
- *
- * @param integrations Array de integrações para validar
- * @param enabledCategories Categorias habilitadas na configuração
- * @returns Lista de avisos sobre classificações incorretas
  *
  * @example
  * ```typescript
- * const warnings = validateNecessaryClassification([
- *   createGoogleAnalyticsIntegration({...}), // ❌ NUNCA é necessary
- *   createCustomIntegration({...})           // ✅ Pode ser necessary se apropriado
- * ], ['necessary', 'analytics'])
- *
- * if (warnings.length > 0) {
- *   console.warn('Scripts incorretamente classificados como necessary:', warnings)
+ * const config: ECommerceConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   facebookPixel: { pixelId: '1234567890123456' }
  * }
  * ```
  */
-declare function validateNecessaryClassification(integrations: ScriptIntegration[], enabledCategories: Category[]): string[];
-
+interface ECommerceConfig {
+    /** Configuração do Google Analytics */
+    googleAnalytics?: GoogleAnalyticsConfig;
+    /** Configuração do Facebook Pixel */
+    facebookPixel?: FacebookPixelConfig;
+    /** Configuração do Hotjar */
+    hotjar?: HotjarConfig;
+    /** Configuração do UserWay */
+    userway?: UserWayConfig;
+}
 /**
- * Presets de categorias conforme usos típicos da LGPD/ANPD.
+ * Configuração para conjunto de integrações de SaaS.
+ * Define configurações opcionais para múltiplas integrações otimizadas para SaaS.
  *
  * @category Utils
- * @since 0.6.4
+ * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * const config: SaaSConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   mixpanel: { token: 'your-token' },
+ *   intercom: { app_id: 'your-app-id' }
+ * }
+ * ```
  */
-declare const ANPD_CATEGORY_PRESETS: Record<Category, CategoryDefinition>;
-type AnpdPresetCategory = keyof typeof ANPD_CATEGORY_PRESETS;
-interface CreateAnpdCategoriesOptions {
-    /**
-     * Lista de categorias que devem ser habilitadas (além de necessary que é sempre inclusa).
-     * @default ['analytics', 'functional', 'marketing']
-     */
-    include?: AnpdPresetCategory[];
-    /**
-     * Overrides de descrições por categoria.
-     */
-    descriptions?: Partial<Record<AnpdPresetCategory, string>>;
-    /**
-     * Overrides de nomes por categoria.
-     */
-    names?: Partial<Record<AnpdPresetCategory, string>>;
+interface SaaSConfig {
+    /** Configuração do Google Analytics */
+    googleAnalytics?: GoogleAnalyticsConfig;
+    /** Configuração do Mixpanel */
+    mixpanel?: MixpanelConfig;
+    /** Configuração do Intercom */
+    intercom?: IntercomConfig;
+    /** Configuração do Hotjar */
+    hotjar?: HotjarConfig;
 }
 /**
- * Gera um `ProjectCategoriesConfig` com presets LGPD/ANPD tipados.
+ * Configuração para conjunto de integrações corporativas.
+ * Define configurações opcionais para múltiplas integrações otimizadas para ambientes corporativos.
  *
  * @category Utils
- * @since 0.6.4
+ * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * const config: CorporateConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   clarity: { projectId: 'abcdefghij' },
+ *   userway: { accountId: 'XXXXXXXXXX' }
+ * }
+ * ```
  */
-declare function createAnpdCategoriesConfig(options?: CreateAnpdCategoriesOptions): ProjectCategoriesConfig;
-
+interface CorporateConfig {
+    /** Configuração do Google Analytics */
+    googleAnalytics?: GoogleAnalyticsConfig;
+    /** Configuração do Microsoft Clarity */
+    clarity?: ClarityConfig;
+    /** Configuração do Zendesk Chat */
+    zendesk?: ZendeskConfig;
+    /** Configuração do UserWay */
+    userway?: UserWayConfig;
+}
 /**
- * @fileoverview
- * Sistema de textos expandido com suporte avançado a internacionalização,
- * contextos específicos e variações de tom.
+ * Cria conjunto de integrações otimizado para e-commerce.
+ * Combina analytics de conversão, remarketing e acessibilidade.
  *
- * @author Luciano Édipo
+ * @category Utils
+ * @param cfg - Configuração das integrações de e-commerce
+ * @returns Array de integrações configuradas
  * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * const integrations = createECommerceIntegrations({
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   facebookPixel: { pixelId: '1234567890123456' }
+ * })
+ * ```
+ *
+ * @remarks
+ * Combina categorias: analytics, marketing, functional
  */
-
+declare function createECommerceIntegrations(cfg: ECommerceConfig): ScriptIntegration[];
 /**
- * Tipo auxiliar para variações de texto.
- *
- * Define um subconjunto opcional dos textos principais do banner e modal,
- * permitindo variações de t    es: {
-      bannerMessage: 'Utilizamos cookies para mejorar su experiencia y mostrar contenido personalizado.', (formal, casual, etc.) sem sobrescrever todos os textos.
+ * Cria conjunto de integrações otimizado para SaaS.
+ * Combina analytics de produto, suporte ao cliente e comportamento do usuário.
  *
- * @category Types
+ * @category Utils
+ * @param cfg - Configuração das integrações de SaaS
+ * @returns Array de integrações configuradas
  * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * const integrations = createSaaSIntegrations({
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   mixpanel: { token: 'your-project-token' },
+ *   intercom: { app_id: 'your-app-id' }
+ * })
+ * ```
+ *
+ * @remarks
+ * Combina categorias: analytics, functional
  */
-type TextVariant = Partial<Pick<ConsentTexts, 'bannerMessage' | 'acceptAll' | 'declineAll' | 'modalTitle'>>;
+declare function createSaaSIntegrations(cfg: SaaSConfig): ScriptIntegration[];
 /**
- * Tipo auxiliar para textos de idioma.
- *
- * Define um subconjunto dos textos principais, excluindo propriedades específicas de internacionalização
- * e contextos, para uso em configurações multilíngues.
+ * Cria conjunto de integrações otimizado para ambientes corporativos.
+ * Combina analytics empresariais, compliance e suporte corporativo.
  *
- * @category Types
+ * @category Utils
+ * @param cfg - Configuração das integrações corporativas
+ * @returns Array de integrações configuradas
  * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * const integrations = createCorporateIntegrations({
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   clarity: { projectId: 'abcdefghij' },
+ *   userway: { accountId: 'XXXXXXXXXX' }
+ * })
+ * ```
+ *
+ * @remarks
+ * Combina categorias: analytics, functional
  */
-type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'>>;
+declare function createCorporateIntegrations(cfg: CorporateConfig): ScriptIntegration[];
 /**
- * Sistema de textos avançado com suporte a internacionalização e contextos específicos.
- *
- * Interface expandida que permite personalização granular de todas as mensagens da biblioteca.
- * Suporta múltiplos idiomas, contextos específicos (e-commerce, SaaS, governo), variações
- * de tom, e compliance completo com LGPD.
+ * Templates pré-configurados de integrações por tipo de negócio.
+ * Define integrações essenciais e opcionais para cada contexto.
  *
- * @category Types
+ * @category Utils
  * @since 0.4.1
- * @remarks
- * **Histórico**: v0.4.1 - Nova interface com suporte avançado a i18n e contextos
  *
- * @example Configuração multilíngue
+ * @example
  * ```typescript
- * const multiLangTexts: AdvancedConsentTexts = {
- *   // Herda de ConsentTexts básico
- *   bannerMessage: 'Utilizamos cookies para melhorar sua experiência.',
- *   acceptAll: 'Aceitar todos',
- *   declineAll: 'Recusar',
- *   preferences: 'Preferências',
- *   modalTitle: 'Preferências de Cookies',
- *   modalIntro: 'Personalize suas preferências de cookies.',
- *   save: 'Salvar',
- *   necessaryAlwaysOn: 'Cookies necessários (sempre ativos)',
- *
- *   // Textos expandidos
- *   variants: {
- *     formal: {
- *       bannerMessage: 'Este sítio utiliza cookies para otimizar a experiência de navegação.',
- *       acceptAll: 'Concordar com todos os cookies'
- *     },
- *     casual: {
- *       bannerMessage: '🍪 Olá! Usamos cookies para tornar tudo mais gostoso aqui.',
- *       acceptAll: 'Aceitar tudo'
- *     }
- *   },
- *
- *   // Internacionalização
- *   i18n: {
- *     en: {
- *       bannerMessage: 'We use cookies to enhance your experience.',
- *       acceptAll: 'Accept All',
- *       declineAll: 'Decline'
- *     },
- *     es: {
- *       bannerMessage: 'Utilizamos cookies para mejorar su experiencia.',
- *       acceptAll: 'Aceptar Todo',
- *       declineAll: 'Rechazar'
- *     }
- *   }
- * }
+ * const template = INTEGRATION_TEMPLATES.ecommerce
+ * console.log(template.essential) // ['google-analytics', 'facebook-pixel']
+ * console.log(template.categories) // ['analytics', 'marketing', 'functional']
  * ```
+ *
+ * @remarks
+ * Cada template define:
+ * - essential: integrações obrigatórias/recomendadas
+ * - optional: integrações complementares
+ * - categories: categorias LGPD utilizadas
  */
-interface AdvancedConsentTexts extends ConsentTexts {
-    /** Texto para confirmar ação */
-    confirm?: string;
-    /** Texto para cancelar ação */
-    cancel?: string;
-    /** Texto de carregamento */
-    loading?: string;
-    /** Textos específicos para cada categoria de cookie */
-    categories?: {
-        necessary?: {
-            name?: string;
-            description?: string;
-            examples?: string;
-        };
-        analytics?: {
-            name?: string;
-            description?: string;
-            examples?: string;
-        };
-        marketing?: {
-            name?: string;
-            description?: string;
-            examples?: string;
-        };
-        functional?: {
-            name?: string;
-            description?: string;
-            examples?: string;
-        };
-        performance?: {
-            name?: string;
-            description?: string;
-            examples?: string;
-        };
-    };
-    /** Mensagens de feedback ao usuário */
-    feedback?: {
-        /** Preferências salvas com sucesso */
-        saveSuccess?: string;
-        /** Erro ao salvar preferências */
-        saveError?: string;
-        /** Consentimento atualizado */
-        consentUpdated?: string;
-        /** Cookies rejeitados */
-        cookiesRejected?: string;
-        /** Configurações resetadas */
-        settingsReset?: string;
-    };
-    /** Labels ARIA e textos para leitores de tela */
-    accessibility?: {
-        /** Label do banner para leitores de tela */
-        bannerLabel?: string;
-        /** Label do modal para leitores de tela */
-        modalLabel?: string;
-        /** Instrução de navegação por teclado */
-        keyboardNavigation?: string;
-        /** Estado do toggle de categoria */
-        toggleState?: {
-            enabled?: string;
-            disabled?: string;
-        };
-        /** Região live para anúncios dinâmicos */
-        liveRegion?: string;
-    };
-    /** Textos otimizados para diferentes contextos */
-    contexts?: {
-        /** Contexto e-commerce */
-        ecommerce?: {
-            cartAbandonment?: string;
-            personalizedOffers?: string;
-            paymentSecurity?: string;
-            productRecommendations?: string;
-        };
-        /** Contexto SaaS */
-        saas?: {
-            userAnalytics?: string;
-            performanceMonitoring?: string;
-            featureUsage?: string;
-            customerSupport?: string;
-        };
-        /** Contexto governamental */
-        government?: {
-            citizenServices?: string;
-            dataProtection?: string;
-            transparency?: string;
-            accessibility?: string;
-        };
-        /** Contexto educacional */
-        education?: {
-            studentProgress?: string;
-            learningAnalytics?: string;
-            accessibility?: string;
-            parentalConsent?: string;
-        };
-    };
-    /** Diferentes variações de tom para a mesma mensagem */
-    variants?: {
-        /** Tom formal/profissional */
-        formal?: TextVariant;
-        /** Tom casual/amigável */
-        casual?: TextVariant;
-        /** Tom conciso/direto */
-        concise?: TextVariant;
-        /** Tom detalhado/explicativo */
-        detailed?: TextVariant;
-    };
-    /** Suporte a múltiplos idiomas */
-    i18n?: {
-        /** Textos em inglês */
-        en?: LanguageTexts;
-        /** Textos em espanhol */
-        es?: LanguageTexts;
-        /** Textos em francês */
-        fr?: LanguageTexts;
-        /** Textos em alemão */
-        de?: LanguageTexts;
-        /** Textos em italiano */
-        it?: LanguageTexts;
+declare const INTEGRATION_TEMPLATES: {
+    ecommerce: {
+        essential: string[];
+        optional: string[];
+        categories: string[];
     };
-    /** Informações técnicas sobre cookies */
-    technical?: {
-        /** Explicação sobre cookies de sessão */
-        sessionCookies?: string;
-        /** Explicação sobre cookies persistentes */
-        persistentCookies?: string;
-        /** Explicação sobre cookies de terceiros */
-        thirdPartyCookies?: string;
-        /** Como desabilitar cookies no navegador */
-        browserSettings?: string;
-        /** Impacto de desabilitar cookies */
-        disablingImpact?: string;
+    saas: {
+        essential: string[];
+        optional: string[];
+        categories: string[];
     };
-    /** Cabeçalhos para tabela de detalhes de cookies */
-    cookieDetails?: {
-        tableHeaders?: {
-            name?: string;
-            purpose?: string;
-            duration?: string;
-            provider?: string;
-            type?: string;
-        };
-        /** Texto quando não há cookies para mostrar */
-        noCookies?: string;
-        /** Botão para expandir/colapsar detalhes */
-        toggleDetails?: {
-            expand?: string;
-            collapse?: string;
-        };
+    corporate: {
+        essential: string[];
+        optional: string[];
+        categories: string[];
     };
+};
+/**
+ * Sugere categorias LGPD apropriadas para um script baseado no nome/tipo.
+ * Utiliza heurísticas para classificar scripts desconhecidos.
+ *
+ * @category Utils
+ * @param name - Nome ou identificador do script
+ * @returns Array de categorias sugeridas
+ * @since 0.4.1
+ *
+ * @example
+ * ```typescript
+ * suggestCategoryForScript('facebook-pixel') // ['marketing']
+ * suggestCategoryForScript('hotjar') // ['analytics']
+ * suggestCategoryForScript('intercom-chat') // ['functional']
+ * suggestCategoryForScript('unknown-script') // ['analytics']
+ * ```
+ *
+ * @remarks
+ * Heurísticas aplicadas:
+ * - Scripts de ads/marketing → 'marketing'
+ * - Scripts de analytics/tracking → 'analytics'
+ * - Scripts de chat/suporte → 'functional'
+ * - Padrão para desconhecidos → 'analytics'
+ */
+declare function suggestCategoryForScript(name: string): string[];
+
+/**
+ * Componente que carrega scripts automaticamente baseado no consentimento.
+ * Facilita integração com ferramentas como Google Analytics, Tag Manager, etc.
+ */
+
+interface RegisteredScript {
+    id: string;
+    category: string;
+    execute: () => void | Promise<void>;
+    priority?: number;
+    allowReload?: boolean;
+    onConsentUpdate?: (consent: {
+        consented: boolean;
+        preferences: ConsentPreferences;
+    }) => void;
 }
 /**
- * Textos padrão expandidos para diferentes contextos e idiomas.
+ * Registra um script (inline ou externo) na fila controlada por consentimento.
+ *
+ * @remarks
+ * - Scripts `necessary` rodam imediatamente; demais aguardam consentimento da categoria.
+ * - Fluxo de estados: `pending` → `running` → `executed` (respeitando `allowReload` e `onConsentUpdate`).
+ * - A fila é ordenada por categoria, `priority` (maior primeiro) e ordem de registro.
+ * - `allowReload` permite reexecutar scripts quando o usuário muda preferências.
+ * - Use `onConsentUpdate` para reenviar sinais (ex.: Consent Mode) após novas decisões.
+ * - Sempre chame o cleanup retornado em efeitos React para evitar múltiplos registros do mesmo `id`.
+ *
+ * @param def Definição do script a ser registrado.
+ * @returns Função de cleanup para remover o script da fila.
+ */
+declare function registerScript(def: RegisteredScript): () => void;
+/**
+ * Props do ConsentScriptLoader.
  *
+ * @category Types
+ * @since 0.2.0
+ *
+ * @example
+ * ```tsx
+ * <ConsentScriptLoader
+ *   integrations={[COMMON_INTEGRATIONS.googleTagManager({ containerId: 'GTM-XXXX' })]}
+ *   reloadOnChange
+ * />
+ * ```
+ */
+interface ConsentScriptLoaderProps {
+    /** Lista de integrações de scripts para carregar baseado no consentimento */
+    integrations: ScriptIntegration[];
+    /** Se true, força recarregamento se consentimento mudar */
+    reloadOnChange?: boolean;
+    /** Nonce CSP aplicado às tags <script> geradas automaticamente (sobrescrevível por integração). */
+    nonce?: string;
+}
+/**
+ * @component
  * @category Utils
+ * @since 0.2.0
+ * Componente que não renderiza UI, mas gerencia o carregamento de scripts de terceiros
+ * (como Google Analytics) com base nas preferências de consentimento do usuário.
+ *
+ * @param props As propriedades do componente.
+ * @param {ScriptIntegration[]} props.integrations Um array de objetos de integração de script. Use as factory functions (`createGoogleAnalyticsIntegration`, etc.) para criar.
+ * @param {boolean} [props.reloadOnChange=false] Se `true`, recarrega os scripts se as preferências de consentimento mudarem.
+ *
+ * @example
+ * ```tsx
+ * const integrations = [
+ *   createGoogleAnalyticsIntegration({ measurementId: 'GA_ID' }),
+ *   createFacebookPixelIntegration({ pixelId: 'PIXEL_ID' })
+ * ];
+ *
+ * <ConsentScriptLoader integrations={integrations} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <ConsentScriptLoader
+ *   integrations={[COMMON_INTEGRATIONS.googleTagManager({ containerId: 'GTM-XXXX' })]}
+ *   nonce="csp-nonce"
+ * />
+ * ```
+ */
+declare function ConsentScriptLoader({ integrations, reloadOnChange, nonce, }: Readonly<ConsentScriptLoaderProps>): null;
+/**
+ * @hook
+ * @category Hooks
+ * @since 0.2.0
+ * Hook para carregamento programático de um script baseado no consentimento.
+ *
+ * @returns Uma função assíncrona que recebe um objeto de integração de script e tenta carregá-lo.
+ * Retorna `true` em caso de sucesso e `false` em caso de falha (por falta de consentimento ou erro de rede).
+ *
+ * @example
+ * ```tsx
+ * const loadScript = useConsentScriptLoader();
+ *
+ * useEffect(() => {
+ *   const handleUserAction = async () => {
+ *     const hotjarIntegration = { id: 'hotjar', category: 'analytics', src: '...' };
+ *     const success = await loadScript(hotjarIntegration);
+ *     if (success) {
+ *       console.log('Hotjar carregado com sucesso!');
+ *     }
+ *   };
+ *
+ *   // Exemplo: carregar script após uma ação específica do usuário
+ *   myButton.addEventListener('click', handleUserAction);
+ * }, [loadScript]);
+ * ```
+ */
+declare function useConsentScriptLoader(): (integration: ScriptIntegration, nonce?: string) => Promise<boolean>;
+
+/**
+ * @file autoConfigureCategories.ts
+ * @description Sistema inteligente de auto-habilitação de categorias baseado nas integrações utilizadas
  * @since 0.4.1
  */
-declare const EXPANDED_DEFAULT_TEXTS: Partial<AdvancedConsentTexts>;
+
 /**
- * Utilitário para resolver textos baseado em idioma, contexto e variação.
+ * @interface CategoryAutoConfigResult
+ * Resultado da análise e auto-configuração de categorias
+ */
+interface CategoryAutoConfigResult {
+    /** Configuração original fornecida pelo desenvolvedor */
+    originalConfig: ProjectCategoriesConfig;
+    /** Configuração ajustada automaticamente pela biblioteca */
+    adjustedConfig: ProjectCategoriesConfig;
+    /** Categorias que foram automaticamente habilitadas */
+    autoEnabledCategories: string[];
+    /** Categorias requeridas pelas integrações mas não habilitadas */
+    missingCategories: string[];
+    /** Se algum ajuste foi necessário */
+    wasAdjusted: boolean;
+    /** Integrações que requerem cada categoria */
+    categoryIntegrations: Record<string, string[]>;
+}
+/**
+ * @function
+ * @category Utils
+ * @since 0.4.1
+ * Analisa as integrações fornecidas e determina quais categorias são necessárias.
  *
+ * @param integrations Array de integrações de script
+ * @returns Record mapeando categoria para nomes das integrações que a utilizam
+ */
+declare function analyzeIntegrationCategories(integrations: ScriptIntegration[]): Record<string, string[]>;
+/**
+ * @function
  * @category Utils
  * @since 0.4.1
+ * Configura automaticamente as categorias necessárias baseado nas integrações utilizadas.
  *
- * @param texts - Textos avançados configurados
- * @param options - Opções de resolução
- * @returns Textos resolvidos para o contexto
+ * Esta função implementa o comportamento inteligente da biblioteca:
+ * 1. Detecta categorias requeridas pelas integrações
+ * 2. Auto-habilita categorias em falta (modo padrão)
+ * 3. Ou apenas avisa sobre categorias em falta (modo warning-only)
+ * 4. Loga no console em modo DEV
+ *
+ * @param originalConfig Configuração original do ConsentProvider
+ * @param integrations Array de integrações que serão utilizadas
+ * @param options Opções de comportamento
+ * @returns Resultado da análise e configuração automática
  */
-declare function resolveTexts(texts: AdvancedConsentTexts, options?: {
-    language?: 'pt' | 'en' | 'es' | 'fr' | 'de' | 'it';
-    context?: 'ecommerce' | 'saas' | 'government' | 'education';
-    variant?: 'formal' | 'casual' | 'concise' | 'detailed';
-}): ConsentTexts;
+declare function autoConfigureCategories(originalConfig: ProjectCategoriesConfig | undefined, integrations: ScriptIntegration[], options?: {
+    /** Se true, apenas avisa mas não modifica a config (padrão: false - auto-habilita) */
+    warningOnly?: boolean;
+    /** Se true, desabilita logs no console (padrão: false) */
+    silent?: boolean;
+}): CategoryAutoConfigResult;
 /**
- * Templates pré-configurados para diferentes contextos.
+ * @function
+ * @category Utils
+ * @since 0.4.1
+ * Valida se todas as integrações têm suas categorias habilitadas.
+ * Útil para validação em tempo de execução.
+ *
+ * @param integrations Array de integrações
+ * @param enabledCategories Array de categorias habilitadas
+ * @returns true se todas as categorias necessárias estão habilitadas
+ */
+declare function validateIntegrationCategories(integrations: ScriptIntegration[], enabledCategories: string[]): boolean;
+/**
+ * @function
+ * @category Utils
+ * @since 0.4.1
+ * Extrai categorias únicas de um array de integrações
  *
+ * @param integrations Array de integrações
+ * @returns Array de categorias únicas
+ */
+declare function extractCategoriesFromIntegrations(integrations: ScriptIntegration[]): string[];
+/**
+ * @function
  * @category Utils
  * @since 0.4.1
+ * Valida se integrações estão sendo incorretamente classificadas como "necessary".
+ *
+ * Esta função protege contra violações de GDPR/LGPD identificando scripts que
+ * NUNCA devem ser considerados estritamente necessários.
+ *
+ * @param integrations Array de integrações para validar
+ * @param enabledCategories Categorias habilitadas na configuração
+ * @returns Lista de avisos sobre classificações incorretas
+ *
+ * @example
+ * ```typescript
+ * const warnings = validateNecessaryClassification([
+ *   createGoogleAnalyticsIntegration({...}), // ❌ NUNCA é necessary
+ *   createCustomIntegration({...})           // ✅ Pode ser necessary se apropriado
+ * ], ['necessary', 'analytics'])
+ *
+ * if (warnings.length > 0) {
+ *   console.warn('Scripts incorretamente classificados como necessary:', warnings)
+ * }
+ * ```
  */
-declare const TEXT_TEMPLATES: {
-    readonly ecommerce: AdvancedConsentTexts;
-    readonly saas: AdvancedConsentTexts;
-    readonly government: AdvancedConsentTexts;
-};
+declare function validateNecessaryClassification(integrations: ScriptIntegration[], enabledCategories: Category[]): string[];
+
+/**
+ * Presets de categorias conforme usos típicos da LGPD/ANPD.
+ *
+ * @category Utils
+ * @since 0.6.4
+ */
+declare const ANPD_CATEGORY_PRESETS: Record<Category, CategoryDefinition>;
+type AnpdPresetCategory = keyof typeof ANPD_CATEGORY_PRESETS;
+interface CreateAnpdCategoriesOptions {
+    /**
+     * Lista de categorias que devem ser habilitadas (além de necessary que é sempre inclusa).
+     * @default ['analytics', 'functional', 'marketing']
+     */
+    include?: AnpdPresetCategory[];
+    /**
+     * Overrides de descrições por categoria.
+     */
+    descriptions?: Partial<Record<AnpdPresetCategory, string>>;
+    /**
+     * Overrides de nomes por categoria.
+     */
+    names?: Partial<Record<AnpdPresetCategory, string>>;
+}
+/**
+ * Gera um `ProjectCategoriesConfig` com presets LGPD/ANPD tipados.
+ *
+ * @category Utils
+ * @since 0.6.4
+ */
+declare function createAnpdCategoriesConfig(options?: CreateAnpdCategoriesOptions): ProjectCategoriesConfig;
 
 /**
  * @enum LogLevel
@@ -4189,7 +4423,9 @@ declare function getAllProjectCategories(config?: ProjectCategoriesConfig): Cate
  */
 declare global {
     interface Window {
-        dataLayer?: Array<ConsentEvent | Record<string, unknown>>;
+        dataLayer?: Array<ConsentEvent | Record<string, unknown>> | {
+            push?: (...args: unknown[]) => unknown;
+        };
     }
 }
 /**
@@ -4299,4 +4535,4 @@ declare function useDataLayerEvents(): {
     pushUpdated: typeof pushConsentUpdatedEvent;
 };
 
-export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, getPeerDepsLocale, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, registerScript, resetPeerDepsMessages, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, setPeerDepsLocale, setPeerDepsMessages, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };
+export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, type SuggestedIntegrationConfig, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createSuggestedIntegration, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, getPeerDepsLocale, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, registerScript, resetPeerDepsMessages, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, setPeerDepsLocale, setPeerDepsMessages, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };