@react-lgpd-consent/core 0.7.1 → 0.7.2

package/dist/index.d.ts

@@ -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,198 +164,469 @@ declare const GUIDANCE_PRESETS: {
 
 /**
  * @fileoverview
- * Definições de tipos TypeScript para o sistema de consentimento LGPD.
- *
- * Este arquivo contém todas as interfaces, tipos e estruturas de dados utilizadas
- * pela biblioteca react-lgpd-consent, incluindo definições de categorias,
- * estado de consentimento, configurações e textos da interface.
+ * Sistema de textos expandido com suporte avançado a internacionalização,
+ * contextos específicos e variações de tom.
  *
  * @author Luciano Édipo
- * @since 0.1.0
+ * @since 0.4.1
  */
+
 /**
- * Tipos de categorias padrão de consentimento para cookies, conforme definido pela ANPD.
- * @category Types
- * @since 0.2.0
- *
- * @remarks
- * Use este tipo para identificar as categorias principais de cookies suportadas nativamente pela biblioteca.
- * Cada categoria representa um tipo específico de processamento de dados:
- *
- * - `'necessary'`: Cookies essenciais para funcionamento do site (sempre ativos).
- * - `'analytics'`: Cookies para análise e estatísticas de uso.
- * - `'functional'`: Cookies para funcionalidades extras e preferências do usuário.
- * - `'marketing'`: Cookies para publicidade e marketing direcionado.
- * - `'social'`: Cookies para integração com redes sociais.
- * - `'personalization'`: Cookies para personalização de conteúdo e experiência.
+ * Tipo auxiliar para variações de texto.
  *
- * @example
- * ```typescript
- * const categories: Category[] = ['analytics', 'marketing'];
- * ```
+ * Define um subconjunto opcional dos textos principais do banner e modal,
+ * permitindo variações de 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.
+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']
      */
@@ -1278,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.
@@ -1478,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;
     /**
@@ -1508,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.
@@ -1602,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',
@@ -1640,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',
@@ -1694,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.
@@ -1729,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
@@ -1873,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>
@@ -2008,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.
  *
@@ -2106,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>
@@ -2217,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';
@@ -2509,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;
 /**
@@ -2608,1126 +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.
- *
- * @category Utils
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: ClarityConfig = {
- *   projectId: 'abcdefghij',
- *   upload: true
- * }
- * ```
- */
-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;
-}
-/**
- * Configuração para integração do Intercom.
+ * Configuração para integrações customizadas com categoria sugerida automaticamente.
  *
  * @category Utils
- * @since 0.4.1
- *
- * @example
- * ```typescript
- * const config: IntercomConfig = {
- *   app_id: 'your-app-id'
- * }
- * ```
+ * @since 0.7.2
  */
-interface IntercomConfig {
-    /** ID da aplicação Intercom */
-    app_id: string;
-    /** URL do script Intercom. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
+interface SuggestedIntegrationConfig extends Omit<ScriptIntegration, 'category'> {
+    /** Categoria LGPD customizada (opcional). Se omitida, usa sugestão automática. */
+    category?: string;
 }
 /**
- * Configuração para integração do Zendesk Chat.
+ * Cria integração customizada aplicando categoria sugerida automaticamente.
+ * Permite sobrescrever a categoria quando necessário.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.7.2
  *
  * @example
  * ```typescript
- * const config: ZendeskConfig = {
- *   key: 'your-zendesk-key'
- * }
+ * const custom = createSuggestedIntegration({
+ *   id: 'custom-chat',
+ *   src: 'https://example.com/chat.js'
+ * })
+ * // -> category sugerida: 'functional'
  * ```
  */
-interface ZendeskConfig {
-    /** Chave de identificação do Zendesk */
-    key: string;
-    /** URL do script Zendesk. Se omitido usa o padrão oficial. */
-    scriptUrl?: string;
-}
+declare function createSuggestedIntegration(config: SuggestedIntegrationConfig): ScriptIntegration;
 /**
- * Cria integração do Facebook Pixel.
- * Configura o fbq e inicializa o pixel com tracking automático opcional.
+ * Configuração para integração do Google Analytics (GA4).
  *
  * @category Utils
- * @param config - Configuração do Facebook Pixel
- * @returns Integração configurada para o Facebook Pixel
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const pixel = createFacebookPixelIntegration({
- *   pixelId: '1234567890123456',
- *   autoTrack: true
- * })
+ * const config: GoogleAnalyticsConfig = {
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: _fbp, fr
- * - Categoria padrão: 'marketing'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createFacebookPixelIntegration(config: FacebookPixelConfig): ScriptIntegration;
+interface GoogleAnalyticsConfig {
+    /** ID de medição do GA4 (formato: G-XXXXXXXXXX) */
+    measurementId: string;
+    /** Configurações adicionais para o gtag */
+    config?: Record<string, unknown>;
+    /** URL do script GA4. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Hotjar.
- * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
+ * Configuração para integração do Google Tag Manager (GTM).
  *
  * @category Utils
- * @param config - Configuração do Hotjar
- * @returns Integração configurada para o Hotjar
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const hotjar = createHotjarIntegration({
- *   siteId: '1234567',
- *   debug: true
- * })
+ * const config: GoogleTagManagerConfig = {
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'customDataLayer'
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
  */
-declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
+interface GoogleTagManagerConfig {
+    /** ID do container GTM (formato: GTM-XXXXXXX) */
+    containerId: string;
+    /** Nome customizado para o dataLayer. Padrão: 'dataLayer' */
+    dataLayerName?: string;
+    /** URL do script GTM. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Mixpanel.
- * Configura e inicializa o Mixpanel para analytics de eventos.
+ * Configuração para integração do UserWay (Acessibilidade).
  *
  * @category Utils
- * @param config - Configuração do Mixpanel
- * @returns Integração configurada para o Mixpanel
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const mixpanel = createMixpanelIntegration({
- *   token: 'your-project-token',
- *   config: { debug: true }
- * })
+ * const config: UserWayConfig = {
+ *   accountId: 'XXXXXXXXXX'
+ * }
  * ```
- *
- * @remarks
- * - Define cookies: mp_*
- * - Categoria padrão: 'analytics'
- * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na inicialização
  */
-declare function createMixpanelIntegration(config: MixpanelConfig): ScriptIntegration;
+interface UserWayConfig {
+    /** ID da conta UserWay */
+    accountId: string;
+    /** URL do script UserWay. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria integração do Microsoft Clarity.
- * Configura o Microsoft Clarity para heatmaps e analytics de comportamento.
+ * Cria integração do Google Analytics (GA4).
+ * Configura o gtag e inicializa o tracking com o measurement ID fornecido.
  *
  * @category Utils
- * @param config - Configuração do Microsoft Clarity
- * @returns Integração configurada para o Clarity
- * @since 0.4.1
+ * @param config - Configuração do Google Analytics
+ * @returns Integração configurada para o GA4
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const clarity = createClarityIntegration({
- *   projectId: 'abcdefghij',
- *   upload: false
+ * const ga = createGoogleAnalyticsIntegration({
+ *   measurementId: 'G-XXXXXXXXXX',
+ *   config: { anonymize_ip: true }
  * })
  * ```
  *
  * @remarks
- * - Define cookies: _clck, _clsk, CLID, ANONCHK, MR, MUID, SM
+ * - Define cookies: _ga, _ga_*, _gid
  * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
- * - Configuração de upload opcional
  */
-declare function createClarityIntegration(config: ClarityConfig): ScriptIntegration;
+declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
 /**
- * Cria integração do Intercom.
- * Configura o widget de chat e suporte do Intercom.
+ * Cria integração do Google Tag Manager (GTM).
+ * Configura o dataLayer e inicializa o container GTM.
  *
  * @category Utils
- * @param config - Configuração do Intercom
- * @returns Integração configurada para o Intercom
- * @since 0.4.1
+ * @param config - Configuração do Google Tag Manager
+ * @returns Integração configurada para o GTM
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const intercom = createIntercomIntegration({
- *   app_id: 'your-app-id'
+ * const gtm = createGoogleTagManagerIntegration({
+ *   containerId: 'GTM-XXXXXXX',
+ *   dataLayerName: 'myDataLayer'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: intercom-id-*, intercom-session-*
- * - Categoria padrão: 'functional'
+ * - Define cookies: _gcl_au
+ * - Categoria padrão: 'analytics'
  * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na inicialização
  */
-declare function createIntercomIntegration(config: IntercomConfig): ScriptIntegration;
+declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
 /**
- * Cria integração do Zendesk Chat.
- * Configura o widget de chat e suporte do Zendesk.
+ * Cria integração do UserWay (Acessibilidade).
+ * Configura o widget de acessibilidade UserWay.
  *
  * @category Utils
- * @param config - Configuração do Zendesk Chat
- * @returns Integração configurada para o Zendesk Chat
- * @since 0.4.1
+ * @param config - Configuração do UserWay
+ * @returns Integração configurada para o UserWay
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const zendesk = createZendeskChatIntegration({
- *   key: 'your-zendesk-key'
+ * const userway = createUserWayIntegration({
+ *   accountId: 'XXXXXXXXXX'
  * })
  * ```
  *
  * @remarks
- * - Define cookies: __zlcmid, _zendesk_shared_session
+ * - Define cookies: _userway_*
  * - Categoria padrão: 'functional'
  * - SSR-safe: verifica disponibilidade do window
- * - Inclui tratamento de erro na identificação
  */
-declare function createZendeskChatIntegration(config: ZendeskConfig): ScriptIntegration;
+declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
 /**
- * Configuração para conjunto de integrações de e-commerce.
- * Define configurações opcionais para múltiplas integrações otimizadas para e-commerce.
+ * Funções fábricas para integrações comuns.
+ * Fornece acesso direto às funções de criação de integrações pré-configuradas.
  *
  * @category Utils
- * @since 0.4.1
+ * @since 0.2.0
  *
  * @example
  * ```typescript
- * const config: ECommerceConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   facebookPixel: { pixelId: '1234567890123456' }
- * }
+ * const ga = COMMON_INTEGRATIONS.googleAnalytics({ measurementId: 'G-XXXXXXXXXX' })
  * ```
  */
-interface ECommerceConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Facebook Pixel */
-    facebookPixel?: FacebookPixelConfig;
-    /** Configuração do Hotjar */
-    hotjar?: HotjarConfig;
-    /** Configuração do UserWay */
-    userway?: UserWayConfig;
-}
+declare const COMMON_INTEGRATIONS: {
+    googleAnalytics: typeof createGoogleAnalyticsIntegration;
+    googleTagManager: typeof createGoogleTagManagerIntegration;
+    userway: typeof createUserWayIntegration;
+};
 /**
- * Configuração para conjunto de integrações de SaaS.
- * Define configurações opcionais para múltiplas integrações otimizadas para SaaS.
+ * Configuração para integração do Facebook Pixel.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: SaaSConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   mixpanel: { token: 'your-token' },
- *   intercom: { app_id: 'your-app-id' }
+ * const config: FacebookPixelConfig = {
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true,
+ *   advancedMatching: { email: 'user@example.com' }
  * }
  * ```
  */
-interface SaaSConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Mixpanel */
-    mixpanel?: MixpanelConfig;
-    /** Configuração do Intercom */
-    intercom?: IntercomConfig;
-    /** Configuração do Hotjar */
-    hotjar?: HotjarConfig;
+interface FacebookPixelConfig {
+    /** ID do pixel do Facebook */
+    pixelId: string;
+    /** Se deve rastrear PageView automaticamente. Padrão: true */
+    autoTrack?: boolean;
+    /** Configuração de correspondência avançada */
+    advancedMatching?: Record<string, unknown>;
+    /** URL do script do Pixel. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
 }
 /**
- * Configuração para conjunto de integrações corporativas.
- * Define configurações opcionais para múltiplas integrações otimizadas para ambientes corporativos.
+ * Configuração para integração do Hotjar.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const config: CorporateConfig = {
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
+ * const config: HotjarConfig = {
+ *   siteId: '1234567',
+ *   version: 6,
+ *   debug: false
  * }
  * ```
  */
-interface CorporateConfig {
-    /** Configuração do Google Analytics */
-    googleAnalytics?: GoogleAnalyticsConfig;
-    /** Configuração do Microsoft Clarity */
-    clarity?: ClarityConfig;
-    /** Configuração do Zendesk Chat */
-    zendesk?: ZendeskConfig;
-    /** Configuração do UserWay */
-    userway?: UserWayConfig;
+interface HotjarConfig {
+    /** ID do site no Hotjar */
+    siteId: string;
+    /** Versão do script Hotjar. Padrão: 6 */
+    version?: number;
+    /** Ativar modo debug. Padrão: false */
+    debug?: boolean;
+    /** URL do script Hotjar. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
 }
 /**
- * Cria conjunto de integrações otimizado para e-commerce.
- * Combina analytics de conversão, remarketing e acessibilidade.
+ * Configuração para integração do Mixpanel.
  *
  * @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: MixpanelConfig = {
+ *   token: 'your-project-token',
+ *   config: { debug: true },
+ *   api_host: 'https://api.mixpanel.com'
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, marketing, functional
  */
-declare function createECommerceIntegrations(cfg: ECommerceConfig): ScriptIntegration[];
+interface MixpanelConfig {
+    /** Token do projeto Mixpanel */
+    token: string;
+    /** Configurações adicionais do Mixpanel */
+    config?: Record<string, unknown>;
+    /** Host customizado da API Mixpanel */
+    api_host?: string;
+    /** URL do script Mixpanel. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria conjunto de integrações otimizado para SaaS.
- * Combina analytics de produto, suporte ao cliente e comportamento do usuário.
+ * Configuração para integração do Microsoft Clarity.
  *
  * @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: ClarityConfig = {
+ *   projectId: 'abcdefghij',
+ *   upload: true
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, functional
  */
-declare function createSaaSIntegrations(cfg: SaaSConfig): ScriptIntegration[];
+interface ClarityConfig {
+    /** ID do projeto no Microsoft Clarity */
+    projectId: string;
+    /** Configuração de upload de dados. Padrão: indefinido */
+    upload?: boolean;
+    /** URL do script Clarity. Se omitido usa o padrão oficial. */
+    scriptUrl?: string;
+    /** Categoria LGPD customizada (opcional). */
+    category?: string;
+}
 /**
- * Cria conjunto de integrações otimizado para ambientes corporativos.
- * Combina analytics empresariais, compliance e suporte corporativo.
+ * Configuração para integração do Intercom.
  *
  * @category Utils
- * @param cfg - Configuração das integrações corporativas
- * @returns Array de integrações configuradas
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const integrations = createCorporateIntegrations({
- *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
- *   clarity: { projectId: 'abcdefghij' },
- *   userway: { accountId: 'XXXXXXXXXX' }
- * })
+ * const config: IntercomConfig = {
+ *   app_id: 'your-app-id'
+ * }
  * ```
- *
- * @remarks
- * Combina categorias: analytics, functional
  */
-declare function createCorporateIntegrations(cfg: CorporateConfig): 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;
+}
 /**
- * Templates pré-configurados de integrações por tipo de negócio.
- * Define integrações essenciais e opcionais para cada contexto.
+ * Configuração para integração do Zendesk Chat.
  *
  * @category Utils
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * const template = INTEGRATION_TEMPLATES.ecommerce
- * console.log(template.essential) // ['google-analytics', 'facebook-pixel']
- * console.log(template.categories) // ['analytics', 'marketing', 'functional']
+ * const config: ZendeskConfig = {
+ *   key: 'your-zendesk-key'
+ * }
  * ```
- *
- * @remarks
- * Cada template define:
- * - essential: integrações obrigatórias/recomendadas
- * - optional: integrações complementares
- * - categories: categorias LGPD utilizadas
  */
-declare const INTEGRATION_TEMPLATES: {
-    ecommerce: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-    saas: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-    corporate: {
-        essential: string[];
-        optional: string[];
-        categories: string[];
-    };
-};
+interface 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;
+}
 /**
- * Sugere categorias LGPD apropriadas para um script baseado no nome/tipo.
- * Utiliza heurísticas para classificar scripts desconhecidos.
+ * Cria integração do Facebook Pixel.
+ * Configura o fbq e inicializa o pixel com tracking automático opcional.
  *
  * @category Utils
- * @param name - Nome ou identificador do script
- * @returns Array de categorias sugeridas
+ * @param config - Configuração do Facebook Pixel
+ * @returns Integração configurada para o Facebook Pixel
  * @since 0.4.1
  *
  * @example
  * ```typescript
- * suggestCategoryForScript('facebook-pixel') // ['marketing']
- * suggestCategoryForScript('hotjar') // ['analytics']
- * suggestCategoryForScript('intercom-chat') // ['functional']
- * suggestCategoryForScript('unknown-script') // ['analytics']
+ * const pixel = createFacebookPixelIntegration({
+ *   pixelId: '1234567890123456',
+ *   autoTrack: true
+ * })
  * ```
  *
  * @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.
+ * - Define cookies: _fbp, fr
+ * - Categoria padrão: 'marketing'
+ * - SSR-safe: verifica disponibilidade do window
  */
-
-interface RegisteredScript {
-    id: string;
-    category: string;
-    execute: () => void | Promise<void>;
-    priority?: number;
-    allowReload?: boolean;
-    onConsentUpdate?: (consent: {
-        consented: boolean;
-        preferences: ConsentPreferences;
-    }) => void;
-}
+declare function createFacebookPixelIntegration(config: FacebookPixelConfig): ScriptIntegration;
 /**
- * Registra um script (inline ou externo) na fila controlada por consentimento.
- *
- * @remarks
- * - Scripts `necessary` rodam imediatamente; demais aguardam consentimento da categoria.
- * - Fluxo de estados: `pending` → `running` → `executed` (respeitando `allowReload` e `onConsentUpdate`).
- * - A fila é ordenada por categoria, `priority` (maior primeiro) e ordem de registro.
- * - `allowReload` permite reexecutar scripts quando o usuário muda preferências.
- * - Use `onConsentUpdate` para reenviar sinais (ex.: Consent Mode) após novas decisões.
- * - Sempre chame o cleanup retornado em efeitos React para evitar múltiplos registros do mesmo `id`.
+ * Cria integração do Hotjar.
+ * Configura as configurações do Hotjar e inicializa o tracking de heatmaps e gravações.
  *
- * @param def Definição do script a ser registrado.
- * @returns Função de cleanup para remover o script da fila.
- */
-declare function registerScript(def: RegisteredScript): () => void;
-interface ConsentScriptLoaderProps {
-    /** Lista de integrações de scripts para carregar baseado no consentimento */
-    integrations: ScriptIntegration[];
-    /** Se true, força recarregamento se consentimento mudar */
-    reloadOnChange?: boolean;
-    /** Nonce CSP aplicado às tags <script> geradas automaticamente (sobrescrevível por integração). */
-    nonce?: string;
-}
-/**
- * @component
  * @category Utils
- * @since 0.2.0
- * Componente que não renderiza UI, mas gerencia o carregamento de scripts de terceiros
- * (como Google Analytics) com base nas preferências de consentimento do usuário.
- *
- * @param props As propriedades do componente.
- * @param {ScriptIntegration[]} props.integrations Um array de objetos de integração de script. Use as factory functions (`createGoogleAnalyticsIntegration`, etc.) para criar.
- * @param {boolean} [props.reloadOnChange=false] Se `true`, recarrega os scripts se as preferências de consentimento mudarem.
+ * @param config - Configuração do Hotjar
+ * @returns Integração configurada para o Hotjar
+ * @since 0.4.1
  *
  * @example
- * ```tsx
- * const integrations = [
- *   createGoogleAnalyticsIntegration({ measurementId: 'GA_ID' }),
- *   createFacebookPixelIntegration({ pixelId: 'PIXEL_ID' })
- * ];
- *
- * <ConsentScriptLoader integrations={integrations} />
+ * ```typescript
+ * const hotjar = createHotjarIntegration({
+ *   siteId: '1234567',
+ *   debug: true
+ * })
  * ```
- */
-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
- */
-
-/**
- * @interface CategoryAutoConfigResult
- * Resultado da análise e auto-configuração de categorias
+ * @remarks
+ * - Define cookies: _hjSession_*, _hjSessionUser_*, _hjFirstSeen, _hjIncludedInSessionSample, _hjAbsoluteSessionInProgress
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
  */
-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[]>;
-}
+declare function createHotjarIntegration(config: HotjarConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Mixpanel.
+ * Configura e inicializa o Mixpanel para analytics de eventos.
+ *
  * @category Utils
+ * @param config - Configuração do Mixpanel
+ * @returns Integração configurada para o Mixpanel
  * @since 0.4.1
- * Analisa as integrações fornecidas e determina quais categorias são necessárias.
  *
- * @param integrations Array de integrações de script
- * @returns Record mapeando categoria para nomes das integrações que a utilizam
+ * @example
+ * ```typescript
+ * const mixpanel = createMixpanelIntegration({
+ *   token: 'your-project-token',
+ *   config: { debug: true }
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: mp_*
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na inicialização
  */
-declare function analyzeIntegrationCategories(integrations: ScriptIntegration[]): Record<string, string[]>;
+declare function createMixpanelIntegration(config: MixpanelConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Microsoft Clarity.
+ * Configura o Microsoft Clarity para heatmaps e analytics de comportamento.
+ *
  * @category Utils
+ * @param config - Configuração do Microsoft Clarity
+ * @returns Integração configurada para o Clarity
  * @since 0.4.1
- * Configura automaticamente as categorias necessárias baseado nas integrações utilizadas.
  *
- * Esta função implementa o comportamento inteligente da biblioteca:
- * 1. Detecta categorias requeridas pelas integrações
- * 2. Auto-habilita categorias em falta (modo padrão)
- * 3. Ou apenas avisa sobre categorias em falta (modo warning-only)
- * 4. Loga no console em modo DEV
+ * @example
+ * ```typescript
+ * const clarity = createClarityIntegration({
+ *   projectId: 'abcdefghij',
+ *   upload: false
+ * })
+ * ```
  *
- * @param originalConfig Configuração original do ConsentProvider
- * @param integrations Array de integrações que serão utilizadas
- * @param options Opções de comportamento
- * @returns Resultado da análise e configuração automática
+ * @remarks
+ * - Define cookies: _clck, _clsk, CLID, ANONCHK, MR, MUID, SM
+ * - Categoria padrão: 'analytics'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Configuração de upload opcional
  */
-declare function autoConfigureCategories(originalConfig: ProjectCategoriesConfig | undefined, integrations: ScriptIntegration[], options?: {
-    /** Se true, apenas avisa mas não modifica a config (padrão: false - auto-habilita) */
-    warningOnly?: boolean;
-    /** Se true, desabilita logs no console (padrão: false) */
-    silent?: boolean;
-}): CategoryAutoConfigResult;
+declare function createClarityIntegration(config: ClarityConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Intercom.
+ * Configura o widget de chat e suporte do Intercom.
+ *
  * @category Utils
+ * @param config - Configuração do Intercom
+ * @returns Integração configurada para o Intercom
  * @since 0.4.1
- * Valida se todas as integrações têm suas categorias habilitadas.
- * Útil para validação em tempo de execução.
  *
- * @param integrations Array de integrações
- * @param enabledCategories Array de categorias habilitadas
- * @returns true se todas as categorias necessárias estão habilitadas
+ * @example
+ * ```typescript
+ * const intercom = createIntercomIntegration({
+ *   app_id: 'your-app-id'
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: intercom-id-*, intercom-session-*
+ * - Categoria padrão: 'functional'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na inicialização
  */
-declare function validateIntegrationCategories(integrations: ScriptIntegration[], enabledCategories: string[]): boolean;
+declare function createIntercomIntegration(config: IntercomConfig): ScriptIntegration;
 /**
- * @function
+ * Cria integração do Zendesk Chat.
+ * Configura o widget de chat e suporte do Zendesk.
+ *
  * @category Utils
+ * @param config - Configuração do Zendesk Chat
+ * @returns Integração configurada para o Zendesk Chat
  * @since 0.4.1
- * Extrai categorias únicas de um array de integrações
  *
- * @param integrations Array de integrações
- * @returns Array de categorias únicas
+ * @example
+ * ```typescript
+ * const zendesk = createZendeskChatIntegration({
+ *   key: 'your-zendesk-key'
+ * })
+ * ```
+ *
+ * @remarks
+ * - Define cookies: __zlcmid, _zendesk_shared_session
+ * - Categoria padrão: 'functional'
+ * - SSR-safe: verifica disponibilidade do window
+ * - Inclui tratamento de erro na identificação
  */
-declare function extractCategoriesFromIntegrations(integrations: ScriptIntegration[]): string[];
+declare function createZendeskChatIntegration(config: ZendeskConfig): ScriptIntegration;
 /**
- * @function
+ * Configuração para conjunto de integrações de e-commerce.
+ * Define configurações opcionais para múltiplas integrações otimizadas para e-commerce.
+ *
  * @category Utils
  * @since 0.4.1
- * Valida se integrações estão sendo incorretamente classificadas como "necessary".
  *
- * Esta função protege contra violações de GDPR/LGPD identificando scripts que
- * NUNCA devem ser considerados estritamente necessários.
+ * @example
+ * ```typescript
+ * const config: ECommerceConfig = {
+ *   googleAnalytics: { measurementId: 'G-XXXXXXXXXX' },
+ *   facebookPixel: { pixelId: '1234567890123456' }
+ * }
+ * ```
+ */
+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;
+}
+/**
+ * Configuração para conjunto de integrações de SaaS.
+ * Define configurações opcionais para múltiplas integrações otimizadas para SaaS.
  *
- * @param integrations Array de integrações para validar
- * @param enabledCategories Categorias habilitadas na configuração
- * @returns Lista de avisos sobre classificações incorretas
+ * @category Utils
+ * @since 0.4.1
  *
  * @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.
+ *
+ * @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' }
+ * })
+ * ```
  *
- * @author Luciano Édipo
- * @since 0.4.1
+ * @remarks
+ * Combina categorias: analytics, functional
  */
-
+declare function createSaaSIntegrations(cfg: SaaSConfig): ScriptIntegration[];
 /**
- * Tipo auxiliar para variações de texto.
- *
- * Define um subconjunto opcional dos textos principais do banner e modal,
- * permitindo variações de t    es: {
-      bannerMessage: 'Utilizamos cookies para mejorar su experiencia y mostrar contenido personalizado.', (formal, casual, etc.) sem sobrescrever todos os textos.
+ * Cria conjunto de integrações otimizado para ambientes corporativos.
+ * Combina analytics empresariais, compliance e suporte corporativo.
  *
- * @category Types
+ * @category Utils
+ * @param cfg - Configuração das integrações corporativas
+ * @returns Array de integrações configuradas
  * @since 0.4.1
- */
-type TextVariant = Partial<Pick<ConsentTexts, 'bannerMessage' | 'acceptAll' | 'declineAll' | 'modalTitle'>>;
-/**
- * Tipo auxiliar para textos de idioma.
  *
- * Define um subconjunto dos textos principais, excluindo propriedades específicas de internacionalização
- * e contextos, para uso em configurações multilíngues.
+ * @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.
+ * 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 function extractCategoriesFromIntegrations(integrations: ScriptIntegration[]): string[];
+/**
+ * @function
  * @category Utils
  * @since 0.4.1
+ * Valida se integrações estão sendo incorretamente classificadas como "necessary".
+ *
+ * Esta função protege contra violações de GDPR/LGPD identificando scripts que
+ * NUNCA devem ser considerados estritamente necessários.
+ *
+ * @param integrations Array de integrações para validar
+ * @param enabledCategories Categorias habilitadas na configuração
+ * @returns Lista de avisos sobre classificações incorretas
+ *
+ * @example
+ * ```typescript
+ * const warnings = validateNecessaryClassification([
+ *   createGoogleAnalyticsIntegration({...}), // ❌ NUNCA é necessary
+ *   createCustomIntegration({...})           // ✅ Pode ser necessary se apropriado
+ * ], ['necessary', 'analytics'])
+ *
+ * if (warnings.length > 0) {
+ *   console.warn('Scripts incorretamente classificados como necessary:', warnings)
+ * }
+ * ```
  */
-declare const TEXT_TEMPLATES: {
-    readonly ecommerce: AdvancedConsentTexts;
-    readonly saas: AdvancedConsentTexts;
-    readonly government: AdvancedConsentTexts;
-};
+declare function validateNecessaryClassification(integrations: ScriptIntegration[], enabledCategories: Category[]): string[];
+
+/**
+ * Presets de categorias conforme usos típicos da LGPD/ANPD.
+ *
+ * @category Utils
+ * @since 0.6.4
+ */
+declare const ANPD_CATEGORY_PRESETS: Record<Category, CategoryDefinition>;
+type AnpdPresetCategory = keyof typeof ANPD_CATEGORY_PRESETS;
+interface CreateAnpdCategoriesOptions {
+    /**
+     * Lista de categorias que devem ser habilitadas (além de necessary que é sempre inclusa).
+     * @default ['analytics', 'functional', 'marketing']
+     */
+    include?: AnpdPresetCategory[];
+    /**
+     * Overrides de descrições por categoria.
+     */
+    descriptions?: Partial<Record<AnpdPresetCategory, string>>;
+    /**
+     * Overrides de nomes por categoria.
+     */
+    names?: Partial<Record<AnpdPresetCategory, string>>;
+}
+/**
+ * Gera um `ProjectCategoriesConfig` com presets LGPD/ANPD tipados.
+ *
+ * @category Utils
+ * @since 0.6.4
+ */
+declare function createAnpdCategoriesConfig(options?: CreateAnpdCategoriesOptions): ProjectCategoriesConfig;
 
 /**
  * @enum LogLevel
@@ -4189,7 +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;
+        };
     }
 }
 /**
@@ -4299,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 PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, getPeerDepsLocale, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, registerScript, resetPeerDepsMessages, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, setPeerDepsLocale, setPeerDepsMessages, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };
+export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, type SuggestedIntegrationConfig, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createSuggestedIntegration, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, getPeerDepsLocale, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, registerScript, resetPeerDepsMessages, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, setPeerDepsLocale, setPeerDepsMessages, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };