@react-lgpd-consent/core 0.6.2 → 0.7.0

package/dist/index.d.cts

@@ -458,6 +458,44 @@ interface ConsentCookieData {
      */
     projectConfig?: ProjectCategoriesConfig;
 }
+/**
+ * Ações possíveis registradas no log de auditoria de consentimento.
+ * @category Types
+ * @since 0.7.0
+ * @public
+ */
+type ConsentAuditAction = 'init' | 'update' | 'reset';
+/**
+ * Entrada de auditoria contendo os dados essenciais para comprovar consentimento.
+ * Inclui timestamps, versão configurada e snapshot das preferências.
+ * @category Types
+ * @since 0.7.0
+ * @public
+ */
+interface ConsentAuditEntry {
+    /** Ação que originou o registro (inicialização, atualização ou reset). */
+    action: ConsentAuditAction;
+    /** Chave de armazenamento (cookie/localStorage) aplicada, incluindo namespace/versão. */
+    storageKey: string;
+    /** Versão lógica de consentimento configurada via `storage.version` (política/termo). */
+    consentVersion: string;
+    /** Timestamp ISO do registro de auditoria. */
+    timestamp: string;
+    /** Timestamp ISO da primeira decisão de consentimento. */
+    consentDate: string;
+    /** Timestamp ISO da última alteração de preferências. */
+    lastUpdate: string;
+    /** Estado atual de consentimento agregado. */
+    consented: boolean;
+    /** Preferências por categoria no momento do registro. */
+    preferences: ConsentPreferences;
+    /** Versão do schema do cookie. */
+    version: string;
+    /** Origem da decisão (banner, modal, reset, programmatic). */
+    source: ConsentEventOrigin;
+    /** Snapshot da configuração de categorias utilizada. */
+    projectConfig?: ProjectCategoriesConfig;
+}
 /**
  * Estado interno completo do sistema de consentimento.
  * @category Types
@@ -1312,6 +1350,26 @@ interface ConsentProviderProps {
      * ```
      */
     onConsentGiven?: (state: ConsentState) => void;
+    /** Callback disparado após hidratação inicial (consentimento existente ou não). */
+    onConsentInit?: (state: ConsentState) => void;
+    /** Callback disparado sempre que o consentimento muda (banner, modal ou programático/reset). */
+    onConsentChange?: (state: ConsentState, context: {
+        origin: ConsentState['source'] | 'reset';
+    }) => void;
+    /**
+     * Callback de auditoria executado sempre que o consentimento é registrado, atualizado ou resetado.
+     * Útil para persistir logs externos (ex.: backend, data lake) com carimbo de tempo e versão do termo.
+     * @since 0.7.0
+     *
+     * @example
+     * ```tsx
+     * <ConsentProvider
+     *   storage={{ namespace: 'portal.gov', version: '2025-Q4' }}
+     *   onAuditLog={(audit) => api.auditConsent(audit)}
+     * />
+     * ```
+     */
+    onAuditLog?: (entry: ConsentAuditEntry) => void;
     /**
      * Callback executado quando usuário modifica preferências.
      * Executado após salvar as mudanças.
@@ -1412,6 +1470,8 @@ interface CustomCookieBannerProps {
     rejectAll: () => void;
     openPreferences: () => void;
     texts: ConsentTexts;
+    /** Indica se o branding padrão deve ser ocultado. */
+    hideBranding?: boolean;
     /**
      * Indica se o modo bloqueante está ativo no contexto.
      * Esta prop é apenas informativa para banners customizados ajustarem sua UI.
@@ -1656,7 +1716,7 @@ 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, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+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;
 
 /**
@@ -2342,6 +2402,23 @@ declare function buildConsentStorageKey(options?: {
     namespace?: string | null;
     version?: string | null;
 }): string;
+/**
+ * Cria um registro de auditoria com carimbo de tempo, versão e snapshot das preferências.
+ * @category Utils
+ * @since 0.7.0
+ *
+ * @param state Estado atual de consentimento.
+ * @param params.storageKey Chave de armazenamento (cookie/localStorage) aplicada.
+ * @param params.action Ação que disparou o registro.
+ * @param params.consentVersion Versão lógica do consentimento (ex.: bump de política/termo).
+ * @param params.origin Origem explícita da decisão (opcional).
+ */
+declare function createConsentAuditEntry(state: ConsentState, params: {
+    storageKey: string;
+    action: ConsentAuditAction;
+    consentVersion?: string | null;
+    origin?: ConsentEventOrigin;
+}): ConsentAuditEntry;
 
 /** @module src/utils/scriptLoader */
 /**
@@ -2370,6 +2447,7 @@ declare function buildConsentStorageKey(options?: {
  * @param {string} src A URL do script externo a ser carregado.
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
+ * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
  * @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
@@ -2379,7 +2457,7 @@ declare function buildConsentStorageKey(options?: {
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>): Promise<void>;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string): Promise<void>;
 
 /**
  * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
@@ -2481,6 +2559,8 @@ interface ScriptIntegration {
     init?: () => void;
     /** Atributos HTML adicionais para a tag script */
     attrs?: Record<string, string>;
+    /** Nonce CSP opcional aplicado à tag script */
+    nonce?: string;
     /** Lista de cookies que o script pode definir */
     cookies?: string[];
     /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
@@ -3129,6 +3209,8 @@ interface ConsentScriptLoaderProps {
     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
@@ -3151,7 +3233,7 @@ interface ConsentScriptLoaderProps {
  * <ConsentScriptLoader integrations={integrations} />
  * ```
  */
-declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly<ConsentScriptLoaderProps>): null;
+declare function ConsentScriptLoader({ integrations, reloadOnChange, nonce, }: Readonly<ConsentScriptLoaderProps>): null;
 /**
  * @hook
  * @category Hooks
@@ -3179,7 +3261,7 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  * }, [loadScript]);
  * ```
  */
-declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
+declare function useConsentScriptLoader(): (integration: ScriptIntegration, nonce?: string) => Promise<boolean>;
 
 /**
  * @file autoConfigureCategories.ts
@@ -3287,6 +3369,37 @@ declare function extractCategoriesFromIntegrations(integrations: ScriptIntegrati
  */
 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;
+
 /**
  * @fileoverview
  * Sistema de textos expandido com suporte avançado a internacionalização,
@@ -4032,4 +4145,4 @@ declare function useDataLayerEvents(): {
     pushUpdated: typeof pushConsentUpdatedEvent;
 };
 
-export { type AdvancedConsentTexts, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, 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 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, createClarityIntegration, 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 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 };

package/dist/index.d.ts

@@ -458,6 +458,44 @@ interface ConsentCookieData {
      */
     projectConfig?: ProjectCategoriesConfig;
 }
+/**
+ * Ações possíveis registradas no log de auditoria de consentimento.
+ * @category Types
+ * @since 0.7.0
+ * @public
+ */
+type ConsentAuditAction = 'init' | 'update' | 'reset';
+/**
+ * Entrada de auditoria contendo os dados essenciais para comprovar consentimento.
+ * Inclui timestamps, versão configurada e snapshot das preferências.
+ * @category Types
+ * @since 0.7.0
+ * @public
+ */
+interface ConsentAuditEntry {
+    /** Ação que originou o registro (inicialização, atualização ou reset). */
+    action: ConsentAuditAction;
+    /** Chave de armazenamento (cookie/localStorage) aplicada, incluindo namespace/versão. */
+    storageKey: string;
+    /** Versão lógica de consentimento configurada via `storage.version` (política/termo). */
+    consentVersion: string;
+    /** Timestamp ISO do registro de auditoria. */
+    timestamp: string;
+    /** Timestamp ISO da primeira decisão de consentimento. */
+    consentDate: string;
+    /** Timestamp ISO da última alteração de preferências. */
+    lastUpdate: string;
+    /** Estado atual de consentimento agregado. */
+    consented: boolean;
+    /** Preferências por categoria no momento do registro. */
+    preferences: ConsentPreferences;
+    /** Versão do schema do cookie. */
+    version: string;
+    /** Origem da decisão (banner, modal, reset, programmatic). */
+    source: ConsentEventOrigin;
+    /** Snapshot da configuração de categorias utilizada. */
+    projectConfig?: ProjectCategoriesConfig;
+}
 /**
  * Estado interno completo do sistema de consentimento.
  * @category Types
@@ -1312,6 +1350,26 @@ interface ConsentProviderProps {
      * ```
      */
     onConsentGiven?: (state: ConsentState) => void;
+    /** Callback disparado após hidratação inicial (consentimento existente ou não). */
+    onConsentInit?: (state: ConsentState) => void;
+    /** Callback disparado sempre que o consentimento muda (banner, modal ou programático/reset). */
+    onConsentChange?: (state: ConsentState, context: {
+        origin: ConsentState['source'] | 'reset';
+    }) => void;
+    /**
+     * Callback de auditoria executado sempre que o consentimento é registrado, atualizado ou resetado.
+     * Útil para persistir logs externos (ex.: backend, data lake) com carimbo de tempo e versão do termo.
+     * @since 0.7.0
+     *
+     * @example
+     * ```tsx
+     * <ConsentProvider
+     *   storage={{ namespace: 'portal.gov', version: '2025-Q4' }}
+     *   onAuditLog={(audit) => api.auditConsent(audit)}
+     * />
+     * ```
+     */
+    onAuditLog?: (entry: ConsentAuditEntry) => void;
     /**
      * Callback executado quando usuário modifica preferências.
      * Executado após salvar as mudanças.
@@ -1412,6 +1470,8 @@ interface CustomCookieBannerProps {
     rejectAll: () => void;
     openPreferences: () => void;
     texts: ConsentTexts;
+    /** Indica se o branding padrão deve ser ocultado. */
+    hideBranding?: boolean;
     /**
      * Indica se o modo bloqueante está ativo no contexto.
      * Esta prop é apenas informativa para banners customizados ajustarem sua UI.
@@ -1656,7 +1716,7 @@ 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, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+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;
 
 /**
@@ -2342,6 +2402,23 @@ declare function buildConsentStorageKey(options?: {
     namespace?: string | null;
     version?: string | null;
 }): string;
+/**
+ * Cria um registro de auditoria com carimbo de tempo, versão e snapshot das preferências.
+ * @category Utils
+ * @since 0.7.0
+ *
+ * @param state Estado atual de consentimento.
+ * @param params.storageKey Chave de armazenamento (cookie/localStorage) aplicada.
+ * @param params.action Ação que disparou o registro.
+ * @param params.consentVersion Versão lógica do consentimento (ex.: bump de política/termo).
+ * @param params.origin Origem explícita da decisão (opcional).
+ */
+declare function createConsentAuditEntry(state: ConsentState, params: {
+    storageKey: string;
+    action: ConsentAuditAction;
+    consentVersion?: string | null;
+    origin?: ConsentEventOrigin;
+}): ConsentAuditEntry;
 
 /** @module src/utils/scriptLoader */
 /**
@@ -2370,6 +2447,7 @@ declare function buildConsentStorageKey(options?: {
  * @param {string} src A URL do script externo a ser carregado.
  * @param {string | null} [category=null] A categoria de consentimento exigida para o script. Suporta tanto categorias predefinidas quanto customizadas. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
+ * @param {string | undefined} [nonce] Nonce CSP opcional aplicado ao script.
  * @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
@@ -2379,7 +2457,7 @@ declare function buildConsentStorageKey(options?: {
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>): Promise<void>;
+declare function loadScript(id: string, src: string, category?: string | null, attrs?: Record<string, string>, nonce?: string): Promise<void>;
 
 /**
  * Utilitários para descoberta e categorização de cookies em tempo de execução (experimental).
@@ -2481,6 +2559,8 @@ interface ScriptIntegration {
     init?: () => void;
     /** Atributos HTML adicionais para a tag script */
     attrs?: Record<string, string>;
+    /** Nonce CSP opcional aplicado à tag script */
+    nonce?: string;
     /** Lista de cookies que o script pode definir */
     cookies?: string[];
     /** Informações detalhadas dos cookies (nome, finalidade, duração, fornecedor) */
@@ -3129,6 +3209,8 @@ interface ConsentScriptLoaderProps {
     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
@@ -3151,7 +3233,7 @@ interface ConsentScriptLoaderProps {
  * <ConsentScriptLoader integrations={integrations} />
  * ```
  */
-declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly<ConsentScriptLoaderProps>): null;
+declare function ConsentScriptLoader({ integrations, reloadOnChange, nonce, }: Readonly<ConsentScriptLoaderProps>): null;
 /**
  * @hook
  * @category Hooks
@@ -3179,7 +3261,7 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  * }, [loadScript]);
  * ```
  */
-declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
+declare function useConsentScriptLoader(): (integration: ScriptIntegration, nonce?: string) => Promise<boolean>;
 
 /**
  * @file autoConfigureCategories.ts
@@ -3287,6 +3369,37 @@ declare function extractCategoriesFromIntegrations(integrations: ScriptIntegrati
  */
 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;
+
 /**
  * @fileoverview
  * Sistema de textos expandido com suporte avançado a internacionalização,
@@ -4032,4 +4145,4 @@ declare function useDataLayerEvents(): {
     pushUpdated: typeof pushConsentUpdatedEvent;
 };
 
-export { type AdvancedConsentTexts, COMMON_INTEGRATIONS, type CategoriesContextValue, type Category, type CategoryAutoConfigResult, type CategoryDefinition, type ClarityConfig, 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 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, createClarityIntegration, 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 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 };