@react-lgpd-consent/core 0.7.0 → 0.7.1

package/dist/index.d.cts

@@ -93,7 +93,7 @@ declare const GUIDANCE_PRESETS: {
 
 /**
  * @fileoverview
- * Definições de tipos TypeScript para o sistema de consentimento LGPD/ANPD.
+ * 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,
@@ -376,7 +376,7 @@ interface ConsentPreferences {
     [key: string]: boolean;
 }
 /**
- * Estrutura do cookie de consentimento em conformidade com LGPD/ANPD.
+ * Estrutura do cookie de consentimento em conformidade com LGPD.
  * @category Types
  * @since 0.2.1
  *
@@ -686,14 +686,22 @@ interface ConsentTexts {
 interface ConsentCookieOptions {
     /** Nome do cookie. Padrão: 'cookieConsent' */
     name: string;
-    /** Tempo de expiração em dias. Padrão: 365 */
-    maxAgeDays: number;
+    /**
+     * Tempo de expiração em segundos.
+     * @defaultValue 31536000 (365 dias)
+     */
+    maxAge?: number;
+    /**
+     * Tempo de expiração em dias (legado).
+     * @deprecated Prefira `maxAge` em segundos.
+     */
+    maxAgeDays?: number;
     /** Política SameSite do cookie. */
-    sameSite: 'Lax' | 'Strict';
-    /** Se o cookie deve ser seguro (HTTPS). Padrão: true */
-    secure: boolean;
+    sameSite?: 'Lax' | 'Strict' | 'None';
+    /** Se o cookie deve ser seguro (HTTPS). Padrão: true em HTTPS. */
+    secure?: boolean;
     /** Caminho do cookie. Padrão: '/' */
-    path: string;
+    path?: string;
     /**
      * Domínio do cookie (ex.: `.example.com` para compartilhar entre subdomínios).
      * Se não definido, o navegador usa o domínio atual.
@@ -1391,8 +1399,9 @@ interface ConsentProviderProps {
      * ```tsx
      * cookie={{
      *   name: 'meuAppConsent',
-     *   maxAgeDays: 180,
-     *   sameSite: 'Strict'
+     *   maxAge: 60 * 60 * 24 * 180, // 180 dias
+     *   sameSite: 'Strict',
+     *   secure: true,
      * }}
      * ```
      */
@@ -1616,6 +1625,8 @@ interface ConsentInitializedEvent {
     timestamp: string;
     /** Estado inicial das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
 }
 /**
  * Payload do evento `consent_updated` disparado no dataLayer.
@@ -1657,6 +1668,8 @@ interface ConsentUpdatedEvent {
     origin: ConsentEventOrigin;
     /** Estado atualizado das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
     /** Lista de categorias que foram modificadas nesta atualização */
     changed_categories: string[];
 }
@@ -2429,6 +2442,18 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * Fornece funções para carregar scripts de terceiros de forma condicional ao consentimento LGPD,
  * garantindo compatibilidade SSR e verificações de permissões por categoria.
  */
+
+type ConsentSnapshot = {
+    consented: boolean;
+    preferences: ConsentPreferences;
+    isModalOpen?: boolean;
+};
+interface LoadScriptOptions {
+    consentSnapshot?: ConsentSnapshot;
+    cookieName?: string;
+    pollIntervalMs?: number;
+    skipConsentCheck?: boolean;
+}
 /**
  * @function
  * @category Utils
@@ -2448,6 +2473,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
  * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
+ * @param {LoadScriptOptions} [options] Configurações avançadas (consentSnapshot, cookieName, pollIntervalMs, skipConsentCheck).
  * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
  * ```ts
@@ -2457,7 +2483,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string): Promise<void>;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string, options?: LoadScriptOptions): Promise<void>;
 
 /**
  * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
@@ -2515,6 +2541,7 @@ declare function categorizeDiscoveredCookies(discovered?: CookieDescriptor[], re
  * - URLs possuem valores default atualizados e podem ser sobrescritos via `scriptUrl`
  * - SSR-safe: toda execução que toca `window` é protegida
  */
+
 /**
  * Integração de script de terceiros condicionada a consentimento.
  *
@@ -2561,6 +2588,15 @@ interface ScriptIntegration {
     attrs?: Record<string, string>;
     /** Nonce CSP opcional aplicado à tag script */
     nonce?: string;
+    /** Prioridade para ordenação na fila do loader (maior = executa primeiro dentro da categoria) */
+    priority?: number;
+    /** Rotina opcional executada antes do carregamento principal (ex.: bootstrap de Consent Mode) */
+    bootstrap?: () => void | Promise<void>;
+    /** Callback disparado quando o consentimento é atualizado */
+    onConsentUpdate?: (consent: {
+        consented: boolean;
+        preferences: ConsentPreferences;
+    }) => void;
     /** Lista de cookies que o script pode definir */
     cookies?: string[];
     /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
@@ -3204,6 +3240,32 @@ declare function suggestCategoryForScript(name: string): string[];
  * 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;
+}
+/**
+ * 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[];
@@ -3435,7 +3497,7 @@ type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'
  *
  * Interface expandida que permite personalização granular de todas as mensagens da biblioteca.
  * Suporta múltiplos idiomas, contextos específicos (e-commerce, SaaS, governo), variações
- * de tom, e compliance completo com LGPD/ANPD.
+ * de tom, e compliance completo com LGPD.
  *
  * @category Types
  * @since 0.4.1
@@ -3843,6 +3905,98 @@ interface PeerDepsCheckResult {
     /** Lista de erros críticos detectados */
     errors: string[];
 }
+/**
+ * Idiomas suportados para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+type PeerDepsLocale = 'pt-BR' | 'en';
+/**
+ * Estrutura de mensagens de erro e aviso para diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+interface PeerDepsMessages {
+    MULTIPLE_REACT_INSTANCES: string;
+    UNSUPPORTED_REACT_VERSION: (version: string) => string;
+    UNSUPPORTED_MUI_VERSION: (version: string) => string;
+    MUI_OUT_OF_RANGE: (version: string) => string;
+}
+/**
+ * Define o idioma para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param locale - Idioma desejado ('pt-BR' ou 'en')
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * // Configurar mensagens em inglês
+ * setPeerDepsLocale('en')
+ * ```
+ */
+declare function setPeerDepsLocale(locale: PeerDepsLocale): void;
+/**
+ * Obtém o idioma atual configurado para mensagens de diagnóstico.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @returns O idioma atual
+ *
+ * @example
+ * ```typescript
+ * import { getPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * const locale = getPeerDepsLocale() // 'pt-BR' ou 'en'
+ * ```
+ */
+declare function getPeerDepsLocale(): PeerDepsLocale;
+/**
+ * Permite sobrescrever mensagens de diagnóstico com versões customizadas.
+ * Útil para traduzir para outros idiomas ou personalizar o texto.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param messages - Objeto parcial com mensagens a sobrescrever
+ *
+ * @remarks
+ * As mensagens customizadas têm prioridade sobre as mensagens padrão.
+ * Pode fornecer apenas as mensagens que deseja sobrescrever.
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Customizar mensagens em espanhol
+ * setPeerDepsMessages({
+ *   MULTIPLE_REACT_INSTANCES: `ERROR: Múltiples instancias de React detectadas...`,
+ *   UNSUPPORTED_REACT_VERSION: (v) => `Versión ${v} no soportada...`,
+ * })
+ * ```
+ */
+declare function setPeerDepsMessages(messages: Partial<PeerDepsMessages>): void;
+/**
+ * Restaura as mensagens padrão, removendo qualquer customização.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @example
+ * ```typescript
+ * import { resetPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Voltar para mensagens padrão
+ * resetPeerDepsMessages()
+ * ```
+ */
+declare function resetPeerDepsMessages(): void;
 /**
  * Verifica compatibilidade de peer dependencies (React e MUI).
  *
@@ -4145,4 +4299,4 @@ declare function useDataLayerEvents(): {
     pushUpdated: typeof pushConsentUpdatedEvent;
 };
 
-export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type ProjectCategoriesConfig, type SaaSConfig, type ScriptIntegration, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };
+export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, 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 };

package/dist/index.d.ts

@@ -93,7 +93,7 @@ declare const GUIDANCE_PRESETS: {
 
 /**
  * @fileoverview
- * Definições de tipos TypeScript para o sistema de consentimento LGPD/ANPD.
+ * 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,
@@ -376,7 +376,7 @@ interface ConsentPreferences {
     [key: string]: boolean;
 }
 /**
- * Estrutura do cookie de consentimento em conformidade com LGPD/ANPD.
+ * Estrutura do cookie de consentimento em conformidade com LGPD.
  * @category Types
  * @since 0.2.1
  *
@@ -686,14 +686,22 @@ interface ConsentTexts {
 interface ConsentCookieOptions {
     /** Nome do cookie. Padrão: 'cookieConsent' */
     name: string;
-    /** Tempo de expiração em dias. Padrão: 365 */
-    maxAgeDays: number;
+    /**
+     * Tempo de expiração em segundos.
+     * @defaultValue 31536000 (365 dias)
+     */
+    maxAge?: number;
+    /**
+     * Tempo de expiração em dias (legado).
+     * @deprecated Prefira `maxAge` em segundos.
+     */
+    maxAgeDays?: number;
     /** Política SameSite do cookie. */
-    sameSite: 'Lax' | 'Strict';
-    /** Se o cookie deve ser seguro (HTTPS). Padrão: true */
-    secure: boolean;
+    sameSite?: 'Lax' | 'Strict' | 'None';
+    /** Se o cookie deve ser seguro (HTTPS). Padrão: true em HTTPS. */
+    secure?: boolean;
     /** Caminho do cookie. Padrão: '/' */
-    path: string;
+    path?: string;
     /**
      * Domínio do cookie (ex.: `.example.com` para compartilhar entre subdomínios).
      * Se não definido, o navegador usa o domínio atual.
@@ -1391,8 +1399,9 @@ interface ConsentProviderProps {
      * ```tsx
      * cookie={{
      *   name: 'meuAppConsent',
-     *   maxAgeDays: 180,
-     *   sameSite: 'Strict'
+     *   maxAge: 60 * 60 * 24 * 180, // 180 dias
+     *   sameSite: 'Strict',
+     *   secure: true,
      * }}
      * ```
      */
@@ -1616,6 +1625,8 @@ interface ConsentInitializedEvent {
     timestamp: string;
     /** Estado inicial das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
 }
 /**
  * Payload do evento `consent_updated` disparado no dataLayer.
@@ -1657,6 +1668,8 @@ interface ConsentUpdatedEvent {
     origin: ConsentEventOrigin;
     /** Estado atualizado das categorias de consentimento */
     categories: Record<string, boolean>;
+    /** Snapshot das preferências (alias para categories para Consent Mode v2) */
+    preferences?: Record<string, boolean>;
     /** Lista de categorias que foram modificadas nesta atualização */
     changed_categories: string[];
 }
@@ -2429,6 +2442,18 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * Fornece funções para carregar scripts de terceiros de forma condicional ao consentimento LGPD,
  * garantindo compatibilidade SSR e verificações de permissões por categoria.
  */
+
+type ConsentSnapshot = {
+    consented: boolean;
+    preferences: ConsentPreferences;
+    isModalOpen?: boolean;
+};
+interface LoadScriptOptions {
+    consentSnapshot?: ConsentSnapshot;
+    cookieName?: string;
+    pollIntervalMs?: number;
+    skipConsentCheck?: boolean;
+}
 /**
  * @function
  * @category Utils
@@ -2448,6 +2473,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
  * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
+ * @param {LoadScriptOptions} [options] Configurações avançadas (consentSnapshot, cookieName, pollIntervalMs, skipConsentCheck).
  * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
  * ```ts
@@ -2457,7 +2483,7 @@ declare function createConsentAuditEntry(state: ConsentState, params: {
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string): Promise<void>;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string, options?: LoadScriptOptions): Promise<void>;
 
 /**
  * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
@@ -2515,6 +2541,7 @@ declare function categorizeDiscoveredCookies(discovered?: CookieDescriptor[], re
  * - URLs possuem valores default atualizados e podem ser sobrescritos via `scriptUrl`
  * - SSR-safe: toda execução que toca `window` é protegida
  */
+
 /**
  * Integração de script de terceiros condicionada a consentimento.
  *
@@ -2561,6 +2588,15 @@ interface ScriptIntegration {
     attrs?: Record<string, string>;
     /** Nonce CSP opcional aplicado à tag script */
     nonce?: string;
+    /** Prioridade para ordenação na fila do loader (maior = executa primeiro dentro da categoria) */
+    priority?: number;
+    /** Rotina opcional executada antes do carregamento principal (ex.: bootstrap de Consent Mode) */
+    bootstrap?: () => void | Promise<void>;
+    /** Callback disparado quando o consentimento é atualizado */
+    onConsentUpdate?: (consent: {
+        consented: boolean;
+        preferences: ConsentPreferences;
+    }) => void;
     /** Lista de cookies que o script pode definir */
     cookies?: string[];
     /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
@@ -3204,6 +3240,32 @@ declare function suggestCategoryForScript(name: string): string[];
  * 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;
+}
+/**
+ * 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[];
@@ -3435,7 +3497,7 @@ type LanguageTexts = Partial<Omit<ConsentTexts, 'i18n' | 'variants' | 'contexts'
  *
  * Interface expandida que permite personalização granular de todas as mensagens da biblioteca.
  * Suporta múltiplos idiomas, contextos específicos (e-commerce, SaaS, governo), variações
- * de tom, e compliance completo com LGPD/ANPD.
+ * de tom, e compliance completo com LGPD.
  *
  * @category Types
  * @since 0.4.1
@@ -3843,6 +3905,98 @@ interface PeerDepsCheckResult {
     /** Lista de erros críticos detectados */
     errors: string[];
 }
+/**
+ * Idiomas suportados para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+type PeerDepsLocale = 'pt-BR' | 'en';
+/**
+ * Estrutura de mensagens de erro e aviso para diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ */
+interface PeerDepsMessages {
+    MULTIPLE_REACT_INSTANCES: string;
+    UNSUPPORTED_REACT_VERSION: (version: string) => string;
+    UNSUPPORTED_MUI_VERSION: (version: string) => string;
+    MUI_OUT_OF_RANGE: (version: string) => string;
+}
+/**
+ * Define o idioma para mensagens de diagnóstico de peer dependencies.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param locale - Idioma desejado ('pt-BR' ou 'en')
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * // Configurar mensagens em inglês
+ * setPeerDepsLocale('en')
+ * ```
+ */
+declare function setPeerDepsLocale(locale: PeerDepsLocale): void;
+/**
+ * Obtém o idioma atual configurado para mensagens de diagnóstico.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @returns O idioma atual
+ *
+ * @example
+ * ```typescript
+ * import { getPeerDepsLocale } from '@react-lgpd-consent/core'
+ *
+ * const locale = getPeerDepsLocale() // 'pt-BR' ou 'en'
+ * ```
+ */
+declare function getPeerDepsLocale(): PeerDepsLocale;
+/**
+ * Permite sobrescrever mensagens de diagnóstico com versões customizadas.
+ * Útil para traduzir para outros idiomas ou personalizar o texto.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @param messages - Objeto parcial com mensagens a sobrescrever
+ *
+ * @remarks
+ * As mensagens customizadas têm prioridade sobre as mensagens padrão.
+ * Pode fornecer apenas as mensagens que deseja sobrescrever.
+ *
+ * @example
+ * ```typescript
+ * import { setPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Customizar mensagens em espanhol
+ * setPeerDepsMessages({
+ *   MULTIPLE_REACT_INSTANCES: `ERROR: Múltiples instancias de React detectadas...`,
+ *   UNSUPPORTED_REACT_VERSION: (v) => `Versión ${v} no soportada...`,
+ * })
+ * ```
+ */
+declare function setPeerDepsMessages(messages: Partial<PeerDepsMessages>): void;
+/**
+ * Restaura as mensagens padrão, removendo qualquer customização.
+ *
+ * @category Utils
+ * @since 0.7.1
+ *
+ * @example
+ * ```typescript
+ * import { resetPeerDepsMessages } from '@react-lgpd-consent/core'
+ *
+ * // Voltar para mensagens padrão
+ * resetPeerDepsMessages()
+ * ```
+ */
+declare function resetPeerDepsMessages(): void;
 /**
  * Verifica compatibilidade de peer dependencies (React e MUI).
  *
@@ -4145,4 +4299,4 @@ declare function useDataLayerEvents(): {
     pushUpdated: typeof pushConsentUpdatedEvent;
 };
 
-export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type ProjectCategoriesConfig, type SaaSConfig, type ScriptIntegration, TEXT_TEMPLATES, type UserWayConfig, type ZendeskConfig, analyzeDeveloperConfiguration, analyzeIntegrationCategories, autoConfigureCategories, buildConsentStorageKey, categorizeDiscoveredCookies, checkPeerDeps, createAnpdCategoriesConfig, createClarityIntegration, createConsentAuditEntry, createCorporateIntegrations, createECommerceIntegrations, createFacebookPixelIntegration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createHotjarIntegration, createIntercomIntegration, createMixpanelIntegration, createProjectPreferences, createSaaSIntegrations, createUserWayIntegration, createZendeskChatIntegration, defaultTexts, detectConsentCookieName, discoverRuntimeCookies, ensureNecessaryAlwaysOn, extractCategoriesFromIntegrations, getAllProjectCategories, getCookiesInfoForCategory, loadScript, logDeveloperGuidance, logger, openPreferencesModal, pushConsentInitializedEvent, pushConsentUpdatedEvent, resolveTexts, runPeerDepsCheck, setCookieCatalogOverrides, setCookieCategoryOverrides, setDebugLogging, suggestCategoryForScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useDataLayerEvents, useDesignTokens, useDeveloperGuidance, useOpenPreferencesModal, validateIntegrationCategories, validateNecessaryClassification, validateProjectPreferences };
+export { ANPD_CATEGORY_PRESETS, type AdvancedConsentTexts, type AnpdPresetCategory, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, type ConsentAuditAction, type ConsentAuditEntry, type ConsentContextValue, type ConsentCookieData, type ConsentCookieOptions, type ConsentEvent, type ConsentEventOrigin, ConsentGate, type ConsentInitializedEvent, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentScriptLoaderProps, type ConsentState, type ConsentStorageConfig, type ConsentTexts, type ConsentUpdatedEvent, type ConsentVersionChangeContext, type CookieDescriptor, type CorporateConfig, type CreateAnpdCategoriesOptions, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, DesignProvider, type DesignTokens, type DeveloperGuidance, type ECommerceConfig, EXPANDED_DEFAULT_TEXTS, type FacebookPixelConfig, GUIDANCE_PRESETS, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, type GuidanceConfig, type GuidanceMessage, type GuidanceSeverity, type HotjarConfig, INTEGRATION_TEMPLATES, type IntercomConfig, LogLevel, type MixpanelConfig, type PeerDepsCheckResult, type PeerDepsLocale, type PeerDepsMessages, type ProjectCategoriesConfig, type RegisteredScript, type SaaSConfig, type ScriptIntegration, 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 };