@react-lgpd-consent/core 0.7.0 → 0.7.2

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,471 @@ declare const GUIDANCE_PRESETS: {
 
 /**
  * @fileoverview
- * Definições de tipos TypeScript para o sistema de consentimento LGPD/ANPD.
- *
- * 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 t    es: {
+      bannerMessage: 'Utilizamos cookies para mejorar su experiencia y mostrar contenido personalizado.', (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[];
     /**
@@ -376,7 +718,7 @@ interface ConsentPreferences {
     [key: string]: boolean;
 }
 /**
- * Estrutura do cookie de consentimento em conformidade com LGPD/ANPD.
+ * Estrutura do cookie de consentimento em conformidade com LGPD.
  * @category Types
  * @since 0.2.1
  *
@@ -686,14 +1028,22 @@ interface ConsentTexts {
 interface ConsentCookieOptions {
     /** Nome do cookie. Padrão: 'cookieConsent' */
     name: string;
-    /** Tempo de expiração em dias. Padrão: 365 */
-    maxAgeDays: number;
+    /**
+     * Tempo de expiração em segundos.
+     * @defaultValue 31536000 (365 dias)
+     */
+    maxAge?: number;
+    /**
+     * Tempo de expiração em dias (legado).
+     * @deprecated Prefira `maxAge` em segundos.
+     */
+    maxAgeDays?: number;
     /** Política SameSite do cookie. */
-    sameSite: 'Lax' | 'Strict';
-    /** Se o cookie deve ser seguro (HTTPS). Padrão: true */
-    secure: boolean;
+    sameSite?: 'Lax' | 'Strict' | 'None';
+    /** Se o cookie deve ser seguro (HTTPS). Padrão: true em HTTPS. */
+    secure?: boolean;
     /** Caminho do cookie. Padrão: '/' */
-    path: string;
+    path?: string;
     /**
      * Domínio do cookie (ex.: `.example.com` para compartilhar entre subdomínios).
      * Se não definido, o navegador usa o domínio atual.
@@ -1270,7 +1620,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.
@@ -1391,8 +1753,9 @@ interface ConsentProviderProps {
      * ```tsx
      * cookie={{
      *   name: 'meuAppConsent',
-     *   maxAgeDays: 180,
-     *   sameSite: 'Strict'
+     *   maxAge: 60 * 60 * 24 * 180, // 180 dias
+     *   sameSite: 'Strict',
+     *   secure: true,
      * }}
      * ```
      */
@@ -1469,7 +1832,7 @@ interface CustomCookieBannerProps {
     acceptAll: () => void;
     rejectAll: () => void;
     openPreferences: () => void;
-    texts: ConsentTexts;
+    texts: AdvancedConsentTexts;
     /** Indica se o branding padrão deve ser ocultado. */
     hideBranding?: boolean;
     /**
@@ -1499,7 +1862,7 @@ interface CustomPreferencesModalProps {
     setPreferences: (preferences: ConsentPreferences) => void;
     closePreferences: () => void;
     isModalOpen?: boolean;
-    texts: ConsentTexts;
+    texts: AdvancedConsentTexts;
 }
 /**
  * Props esperadas por um componente customizado de FloatingPreferencesButton.
@@ -1593,7 +1956,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',
@@ -1616,6 +1979,8 @@ interface ConsentInitializedEvent {
     timestamp: string;
     /** Estado inicial das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
 }
 /**
  * Payload do evento `consent_updated` disparado no dataLayer.
@@ -1629,7 +1994,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',
@@ -1657,6 +2022,8 @@ interface ConsentUpdatedEvent {
     origin: ConsentEventOrigin;
     /** Estado atualizado das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
     /** Lista de categorias que foram modificadas nesta atualização */
     changed_categories: string[];
 }
@@ -1681,7 +2048,7 @@ 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 {(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.
@@ -1716,8 +2083,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, 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
@@ -1860,7 +2227,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>
@@ -1995,13 +2362,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.
  *
@@ -2093,7 +2460,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>
@@ -2204,7 +2571,7 @@ declare function useOpenPreferencesModal(): () => void;
  * @example
  * ```javascript
  * // Em código JavaScript puro
- * window.openPreferencesModal?.();
+ * globalThis.window?.openPreferencesModal?.();
  *
  * // Ou importando diretamente
  * import { openPreferencesModal } from 'react-lgpd-consent';
@@ -2429,6 +2796,18 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * 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
@@ -2448,6 +2827,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * @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
@@ -2457,7 +2837,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string): Promise<void>;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string, options?: LoadScriptOptions): Promise<void>;
 
 /**
  * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
@@ -2483,10 +2863,23 @@ declare function loadScript(id: string, src: string, category?: string | null, a
  */
 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`.
+ * 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
+ * ```ts
+ * const consentCookie = detectConsentCookieName()
+ * if (consentCookie) {
+ *   console.log('Cookie de consentimento encontrado:', consentCookie)
+ * }
+ * ```
+ * @remarks SSR-safe: retorna `null` se executado fora do browser.
  */
 declare function detectConsentCookieName(): string | null;
 /**
@@ -2515,6 +2908,7 @@ declare function categorizeDiscoveredCookies(discovered?: CookieDescriptor[], re
  * - URLs possuem valores default atualizados e podem ser sobrescritos via `scriptUrl`
  * - SSR-safe: toda execução que toca `window` é protegida
  */
+
 /**
  * Integração de script de terceiros condicionada a consentimento.
  *
@@ -2561,6 +2955,15 @@ interface ScriptIntegration {
     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) */
@@ -2572,1100 +2975,904 @@ interface ScriptIntegration {
     }>;
 }
 /**
- * Configuração para integração do Google Analytics (GA4).
- *
- * @category Utils
- * @since 0.2.0
- *
- * @example
- * ```typescript
- * const config: GoogleAnalyticsConfig = {
- *   measurementId: 'G-XXXXXXXXXX',
- *   config: { anonymize_ip: true }
- * }
- * ```
- */
-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;
-}
-/**
- * Configuração para integração do Google Tag Manager (GTM).
- *
- * @category Utils
- * @since 0.2.0
- *
- * @example
- * ```typescript
- * const config: GoogleTagManagerConfig = {
- *   containerId: 'GTM-XXXXXXX',
- *   dataLayerName: 'customDataLayer'
- * }
- * ```
- */
-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
- * ```typescript
- * const config: UserWayConfig = {
- *   accountId: 'XXXXXXXXXX'
- * }
- * ```
- */
-interface UserWayConfig {
-    /** ID da conta UserWay */
-    accountId: string;
-    /** URL do script UserWay. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
-/**
- * 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 Google Analytics
- * @returns Integração configurada para o GA4
- * @since 0.2.0
- *
- * @example
- * ```typescript
- * const ga = createGoogleAnalyticsIntegration({
- *   measurementId: 'G-XXXXXXXXXX',
- *   config: { anonymize_ip: true }
- * })
- * ```
- *
- * @remarks
- * - Define cookies: _ga, _ga_*, _gid
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
- */
-declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
-/**
- * Cria integração do Google Tag Manager (GTM).
- * Configura o dataLayer e inicializa o container GTM.
- *
- * @category Utils
- * @param config - Configuração do Google Tag Manager
- * @returns Integração configurada para o GTM
- * @since 0.2.0
- *
- * @example
- * ```typescript
- * const gtm = createGoogleTagManagerIntegration({
- *   containerId: 'GTM-XXXXXXX',
- *   dataLayerName: 'myDataLayer'
- * })
- * ```
- *
- * @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.
- *
- * @category Utils
- * @param config - Configuração do UserWay
- * @returns Integração configurada para o UserWay
- * @since 0.2.0
- *
- * @example
- * ```typescript
- * const userway = createUserWayIntegration({
- *   accountId: 'XXXXXXXXXX'
- * })
- * ```
- *
- * @remarks
- * - Define cookies: _userway_*
- * - Categoria padrão: 'functional'
- * - SSR-safe: verifica disponibilidade do window
- */
-declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
-/**
- * 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.2.0
- *
- * @example
- * ```typescript
- * const ga = COMMON_INTEGRATIONS.googleAnalytics({ measurementId: 'G-XXXXXXXXXX' })
- * ```
- */
-declare const COMMON_INTEGRATIONS: {
-    googleAnalytics: typeof createGoogleAnalyticsIntegration;
-    googleTagManager: typeof createGoogleTagManagerIntegration;
-    userway: typeof createUserWayIntegration;
-};
-/**
- * Configuração para integração do Facebook Pixel.
- *
- * @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;
-}
-/**
- * Configuração para integração do Hotjar.
- *
- * @category Utils
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: HotjarConfig = {
- *   siteId: '1234567',
- *   version: 6,
- *   debug: false
- * }
- * ```
- */
-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;
-}
-/**
- * Configuração para integração do Mixpanel.
- *
- * @category Utils
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: MixpanelConfig = {
- *   token: 'your-project-token',
- *   config: { debug: true },
- *   api_host: 'https://api.mixpanel.com'
- * }
- * ```
- */
-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.
+ * Configuração para integrações customizadas com categoria sugerida automaticamente.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.7.2
+ */
+interface SuggestedIntegrationConfig extends Omit<ScriptIntegration, 'category'> {
+    /** Categoria LGPD customizada (opcional). Se omitida, usa sugestão automática. */
+    category?: string;
+}
+/**
+ * Cria integração customizada aplicando categoria sugerida automaticamente.
+ * Permite sobrescrever a categoria quando necessário.
+ *
+ * @category Utils
+ * @since 0.7.2
  *
  * @example
  * ```typescript
- * const config: ClarityConfig = {
- *   projectId: 'abcdefghij',
- *   upload: true
- * }
+ * const custom = createSuggestedIntegration({
+ *   id: 'custom-chat',
+ *   src: 'https://example.com/chat.js'
+ * })
+ * // -> category sugerida: 'functional'
  * ```
  */
-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;
-}
+declare function createSuggestedIntegration(config: SuggestedIntegrationConfig): ScriptIntegration;
 /**
- * Configuração para integração do Intercom.
+ * Configuração para integração do Google Analytics (GA4).
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const config: IntercomConfig = {
- *   app_id: 'your-app-id'
+ * const config: GoogleAnalyticsConfig = {
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
  * }
  * ```
  */
-interface IntercomConfig {
-    /** ID da aplicação Intercom */
-    app_id: string;
-    /** URL do script Intercom. Se omitido usa o padrão oficial. */
+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;
 }
 /**
- * Configuração para integração do Zendesk Chat.
+ * Configuração para integração do Google Tag Manager (GTM).
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const config: ZendeskConfig = {
- *   key: 'your-zendesk-key'
+ * const config: GoogleTagManagerConfig = {
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'customDataLayer'
  * }
  * ```
  */
-interface ZendeskConfig {
-    /** Chave de identificação do Zendesk */
-    key: string;
-    /** URL do script Zendesk. Se omitido usa o padrão oficial. */
+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 Facebook Pixel.
- * Configura o fbq e inicializa o pixel com tracking automático opcional.
+ * Configuração para integração do UserWay (Acessibilidade).
  *
  * @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: UserWayConfig = {
+ *   accountId: 'XXXXXXXXXX'
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: _fbp, fr
- * - Categoria padrão: 'marketing'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createFacebookPixelIntegration(config: FacebookPixelConfig): 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 Hotjar.
- * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
+ * 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 Hotjar
- * @returns Integração configurada para o Hotjar
- * @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 hotjar = createHotjarIntegration({
- *   siteId: '1234567',
- *   debug: true
+ * const ga = createGoogleAnalyticsIntegration({
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
  * })
  * ```
  *
  * @remarks
- * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
+ * - Define cookies: _ga, _ga_*, _gid
  * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
  */
-declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
+declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
 /**
- * Cria integração do Mixpanel.
- * Configura e inicializa o Mixpanel para analytics de eventos.
+ * Cria integração do Google Tag Manager (GTM).
+ * Configura o dataLayer e inicializa o container GTM.
  *
  * @category Utils
- * @param config - Configuração do Mixpanel
- * @returns Integração configurada para o Mixpanel
- * @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 mixpanel = createMixpanelIntegration({
- *   token: 'your-project-token',
- *   config: { debug: true }
+ * const gtm = createGoogleTagManagerIntegration({
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'myDataLayer'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: mp_*
+ * - Define cookies: _gcl_au
  * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na inicialização
  */
-declare function createMixpanelIntegration(config: MixpanelConfig): ScriptIntegration;
+declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
 /**
- * Cria integração do Microsoft Clarity.
- * Configura o Microsoft Clarity para heatmaps e analytics de comportamento.
+ * Cria integração do UserWay (Acessibilidade).
+ * Configura o widget de acessibilidade UserWay.
  *
  * @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 UserWay
+ * @returns Integração configurada para o UserWay
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const clarity = createClarityIntegration({
- *   projectId: 'abcdefghij',
- *   upload: false
+ * const userway = createUserWayIntegration({
+ *   accountId: 'XXXXXXXXXX'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: _clck, _clsk, CLID, ANONCHK, MR, MUID, SM
- * - Categoria padrão: 'analytics'
+ * - Define cookies: _userway_*
+ * - Categoria padrão: 'functional'
  * - SSR-safe: verifica disponibilidade do window
- * - Configuração de upload opcional
  */
-declare function createClarityIntegration(config: ClarityConfig): ScriptIntegration;
+declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
 /**
- * Cria integração do Intercom.
- * Configura o widget de chat e suporte do Intercom.
+ * Funções fábricas para integrações comuns.
+ * Fornece acesso direto às funções de criação de integrações pré-configuradas.
  *
  * @category Utils
- * @param config - Configuração do Intercom
- * @returns Integração configurada para o Intercom
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const intercom = createIntercomIntegration({
- *   app_id: 'your-app-id'
- * })
+ * const ga = COMMON_INTEGRATIONS.googleAnalytics({ measurementId: 'G-XXXXXXXXXX' })
  * ```
- *
- * @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 createIntercomIntegration(config: IntercomConfig): ScriptIntegration;
+declare const COMMON_INTEGRATIONS: {
+    googleAnalytics: typeof createGoogleAnalyticsIntegration;
+    googleTagManager: typeof createGoogleTagManagerIntegration;
+    userway: typeof createUserWayIntegration;
+};
 /**
- * Cria integração do Zendesk Chat.
- * Configura o widget de chat e suporte do Zendesk.
+ * Configuração para integração do Facebook Pixel.
  *
  * @category Utils
- * @param config - Configuração do Zendesk Chat
- * @returns Integração configurada para o Zendesk Chat
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const zendesk = createZendeskChatIntegration({
- *   key: 'your-zendesk-key'
- * })
+ * const config: FacebookPixelConfig = {
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true,
+ *   advancedMatching: { email: 'user@example.com' }
+ * }
  * ```
- *
- * @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 createZendeskChatIntegration(config: ZendeskConfig): ScriptIntegration;
+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 de e-commerce.
- * Define configurações opcionais para múltiplas integrações otimizadas para e-commerce.
+ * Configuração para integração do Hotjar.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: ECommerceConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   facebookPixel: { pixelId: '1234567890123456' }
+ * const config: HotjarConfig = {
+ *   siteId: '1234567',
+ *   version: 6,
+ *   debug: false
  * }
  * ```
  */
-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;
+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;
 }
 /**
- * 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 Mixpanel.
  *
  * @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: MixpanelConfig = {
+ *   token: 'your-project-token',
+ *   config: { debug: true },
+ *   api_host: 'https://api.mixpanel.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 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;
 }
 /**
- * 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 Microsoft Clarity.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: CorporateConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
+ * const config: ClarityConfig = {
+ *   projectId: 'abcdefghij',
+ *   upload: true
  * }
  * ```
  */
-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;
+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;
 }
 /**
- * Cria conjunto de integrações otimizado para e-commerce.
- * Combina analytics de conversão, remarketing e acessibilidade.
+ * Configuração para integração do Intercom.
  *
  * @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' }
- * })
+ * const config: IntercomConfig = {
+ *   app_id: 'your-app-id'
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, marketing, functional
  */
-declare function createECommerceIntegrations(cfg: ECommerceConfig): ScriptIntegration[];
+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;
+}
 /**
- * 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 Zendesk Chat.
  *
  * @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: ZendeskConfig = {
+ *   key: 'your-zendesk-key'
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, functional
  */
-declare function createSaaSIntegrations(cfg: SaaSConfig): ScriptIntegration[];
+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;
+}
 /**
- * Cria conjunto de integrações otimizado para ambientes corporativos.
- * Combina analytics empresariais, compliance e suporte corporativo.
+ * Cria integração do Facebook Pixel.
+ * Configura o fbq e inicializa o pixel com tracking automático opcional.
  *
  * @category Utils
- * @param cfg - Configuração das integrações corporativas
- * @returns Array de integrações configuradas
+ * @param config - Configuração do Facebook Pixel
+ * @returns Integração configurada para o Facebook Pixel
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const integrations = createCorporateIntegrations({
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
+ * const pixel = createFacebookPixelIntegration({
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true
  * })
  * ```
  *
  * @remarks
- * Combina categorias: analytics, functional
+ * - Define cookies: _fbp, fr
+ * - Categoria padrão: 'marketing'
+ * - SSR-safe: verifica disponibilidade do window
  */
-declare function createCorporateIntegrations(cfg: CorporateConfig): ScriptIntegration[];
+declare function createFacebookPixelIntegration(config: FacebookPixelConfig): ScriptIntegration;
 /**
- * Templates pré-configurados de integrações por tipo de negócio.
- * Define integrações essenciais e opcionais para cada contexto.
+ * Cria integração do Hotjar.
+ * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
  *
  * @category Utils
+ * @param config - Configuração do Hotjar
+ * @returns Integração configurada para o Hotjar
  * @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 hotjar = createHotjarIntegration({
+ *   siteId: '1234567',
+ *   debug: true
+ * })
  * ```
  *
  * @remarks
- * Cada template define:
- * - essential: integrações obrigatórias/recomendadas
- * - optional: integrações complementares
- * - categories: categorias LGPD utilizadas
+ * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
  */
-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[];
-    };
-};
+declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
 /**
- * Sugere categorias LGPD apropriadas para um script baseado no nome/tipo.
- * Utiliza heurísticas para classificar scripts desconhecidos.
+ * Cria integração do Mixpanel.
+ * Configura e inicializa o Mixpanel para analytics de eventos.
  *
  * @category Utils
- * @param name - Nome ou identificador do script
- * @returns Array de categorias sugeridas
+ * @param config - Configuração do Mixpanel
+ * @returns Integração configurada para o Mixpanel
  * @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 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} />
- * ```
- */
-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]);
+ * const mixpanel = createMixpanelIntegration({
+ *   token: 'your-project-token',
+ *   config: { debug: true }
+ * })
  * ```
- */
-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[]>;
-}
+ *
+ * @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;
 /**
- * @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
- * 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 clarity = createClarityIntegration({
+ *   projectId: 'abcdefghij',
+ *   upload: false
+ * })
+ * ```
+ *
+ * @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 analyzeIntegrationCategories(integrations: ScriptIntegration[]): Record<string, string[]>;
+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
- * 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 intercom = createIntercomIntegration({
+ *   app_id: 'your-app-id'
+ * })
+ * ```
  *
- * @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: intercom-id-*, intercom-session-*
+ * - Categoria padrão: 'functional'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na inicialização
  */
-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 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
- * 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 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 validateIntegrationCategories(integrations: ScriptIntegration[], enabledCategories: string[]): boolean;
+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
- * Extrai categorias únicas de um array de integrações
  *
- * @param integrations Array de integrações
- * @returns Array de categorias únicas
+ * @example
+ * ```typescript
+ * const config: ECommerceConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   facebookPixel: { pixelId: '1234567890123456' }
+ * }
+ * ```
  */
-declare function extractCategoriesFromIntegrations(integrations: ScriptIntegration[]): 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;
+}
 /**
- * @function
+ * 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.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: SaaSConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   mixpanel: { token: 'your-token' },
+ *   intercom: { app_id: 'your-app-id' }
  * }
  * ```
  */
-declare function validateNecessaryClassification(integrations: ScriptIntegration[], enabledCategories: Category[]): 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;
+}
 /**
- * Presets de categorias conforme usos típicos da LGPD/ANPD.
+ * 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 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 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;
 }
 /**
- * Gera um `ProjectCategoriesConfig` com presets LGPD/ANPD tipados.
+ * Cria conjunto de integrações otimizado para e-commerce.
+ * Combina analytics de conversão, remarketing e acessibilidade.
  *
  * @category Utils
- * @since 0.6.4
+ * @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 createAnpdCategoriesConfig(options?: CreateAnpdCategoriesOptions): ProjectCategoriesConfig;
-
+declare function createECommerceIntegrations(cfg: ECommerceConfig): ScriptIntegration[];
 /**
- * @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 SaaS.
+ * Combina analytics de produto, suporte ao cliente e comportamento do usuário.
  *
- * @author Luciano Édipo
+ * @category Utils
+ * @param cfg - Configuração das integrações de SaaS
+ * @returns Array de integrações configuradas
  * @since 0.4.1
- */
-
-/**
- * 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.
+ * @example
+ * ```typescript
+ * const integrations = createSaaSIntegrations({
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   mixpanel: { token: 'your-project-token' },
+ *   intercom: { app_id: 'your-app-id' }
+ * })
+ * ```
  *
- * @category Types
- * @since 0.4.1
+ * @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.
+ * Cria conjunto de integrações otimizado para ambientes corporativos.
+ * Combina analytics empresariais, compliance e suporte corporativo.
  *
- * Define um subconjunto dos textos principais, excluindo propriedades específicas de internacionalização
- * e contextos, para uso em configurações multilíngues.
+ * @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' }
+ * })
+ * ```
  *
- * @category Types
- * @since 0.4.1
+ * @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/ANPD.
+ * 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;
+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} />
+ * ```
+ */
+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 const TEXT_TEMPLATES: {
-    readonly ecommerce: AdvancedConsentTexts;
-    readonly saas: AdvancedConsentTexts;
-    readonly government: AdvancedConsentTexts;
-};
+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 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
@@ -3843,6 +4050,98 @@ interface PeerDepsCheckResult {
     /** Lista de erros críticos detectados */
     errors: string[];
 }
+/**
+ * Idiomas suportados para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+type PeerDepsLocale = 'pt-BR' | 'en';
+/**
+ * Estrutura de mensagens de erro e aviso para diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+interface PeerDepsMessages {
+    MULTIPLE_REACT_INSTANCES: string;
+    UNSUPPORTED_REACT_VERSION: (version: string) => string;
+    UNSUPPORTED_MUI_VERSION: (version: string) => string;
+    MUI_OUT_OF_RANGE: (version: string) => string;
+}
+/**
+ * Define o idioma para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param locale - Idioma desejado ('pt-BR' ou 'en')
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * // Configurar mensagens em inglês
+ * setPeerDepsLocale('en')
+ * ```
+ */
+declare function setPeerDepsLocale(locale: PeerDepsLocale): void;
+/**
+ * Obtém o idioma atual configurado para mensagens de diagnóstico.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @returns O idioma atual
+ *
+ * @example
+ * ```typescript
+ * import { getPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * const locale = getPeerDepsLocale() // 'pt-BR' ou 'en'
+ * ```
+ */
+declare function getPeerDepsLocale(): PeerDepsLocale;
+/**
+ * Permite sobrescrever mensagens de diagnóstico com versões customizadas.
+ * Útil para traduzir para outros idiomas ou personalizar o texto.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param messages - Objeto parcial com mensagens a sobrescrever
+ *
+ * @remarks
+ * As mensagens customizadas têm prioridade sobre as mensagens padrão.
+ * Pode fornecer apenas as mensagens que deseja sobrescrever.
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Customizar mensagens em espanhol
+ * setPeerDepsMessages({
+ *   MULTIPLE_REACT_INSTANCES: `ERROR: Múltiples instancias de React detectadas...`,
+ *   UNSUPPORTED_REACT_VERSION: (v) => `Versión ${v} no soportada...`,
+ * })
+ * ```
+ */
+declare function setPeerDepsMessages(messages: Partial<PeerDepsMessages>): void;
+/**
+ * Restaura as mensagens padrão, removendo qualquer customização.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @example
+ * ```typescript
+ * import { resetPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Voltar para mensagens padrão
+ * resetPeerDepsMessages()
+ * ```
+ */
+declare function resetPeerDepsMessages(): void;
 /**
  * Verifica compatibilidade de peer dependencies (React e MUI).
  *
@@ -4035,7 +4334,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;
+        };
     }
 }
 /**
@@ -4145,4 +4446,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 ProjectCategoriesConfig, 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, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, 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 };