react-lgpd-consent 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -196,6 +196,13 @@ interface ConsentTexts {
     modalIntro: string;
     save: string;
     necessaryAlwaysOn: string;
+    preferencesButton?: string;
+    preferencesTitle?: string;
+    preferencesDescription?: string;
+    close?: string;
+    accept?: string;
+    reject?: string;
+    brandingPoweredBy?: string;
     controllerInfo?: string;
     dataTypes?: string;
     thirdPartySharing?: string;
@@ -582,6 +589,27 @@ declare function useConsentTexts(): ConsentTexts;
  * Útil para evitar flash do banner antes de verificar cookies existentes.
  */
 declare function useConsentHydration(): boolean;
+/**
+ * Hook para abrir o modal de preferências programaticamente.
+ * Útil quando você tem controle customizado sobre como o modal é aberto.
+ *
+ * @returns Função para abrir o modal de preferências.
+ *
+ * @example
+ * ```tsx
+ * function CustomAccessibilityDock() {
+ *   const openPreferencesModal = useOpenPreferencesModal()
+ *
+ *   return (
+ *     <button onClick={openPreferencesModal}>
+ *       ⚙️ Configurar Cookies
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useOpenPreferencesModal(): () => void;
+declare function openPreferencesModal(): void;
 
 /**
  * Sistema de orientações para developers sobre configuração de categorias.
@@ -718,4 +746,28 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  */
 declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
 
-export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts };
+/**
+ * Sistema de logging interno da biblioteca para facilitar debug e troubleshooting.
+ * Os logs são desabilitados automaticamente em production builds.
+ */
+declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+/**
+ * Função para habilitar/desabilitar logs de debug externamente.
+ * Útil para troubleshooting em produção quando necessário.
+ *
+ * @example
+ * ```typescript
+ * import { setDebugLogging } from 'react-lgpd-consent'
+ *
+ * // Habilitar logs detalhados
+ * setDebugLogging(true, LogLevel.DEBUG)
+ * ```
+ */
+declare function setDebugLogging(enabled: boolean, level?: LogLevel): void;
+
+export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentState, type ConsentTexts, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, LogLevel, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, openPreferencesModal, setDebugLogging, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useOpenPreferencesModal };

package/dist/index.d.ts

@@ -196,6 +196,13 @@ interface ConsentTexts {
     modalIntro: string;
     save: string;
     necessaryAlwaysOn: string;
+    preferencesButton?: string;
+    preferencesTitle?: string;
+    preferencesDescription?: string;
+    close?: string;
+    accept?: string;
+    reject?: string;
+    brandingPoweredBy?: string;
     controllerInfo?: string;
     dataTypes?: string;
     thirdPartySharing?: string;
@@ -582,6 +589,27 @@ declare function useConsentTexts(): ConsentTexts;
  * Útil para evitar flash do banner antes de verificar cookies existentes.
  */
 declare function useConsentHydration(): boolean;
+/**
+ * Hook para abrir o modal de preferências programaticamente.
+ * Útil quando você tem controle customizado sobre como o modal é aberto.
+ *
+ * @returns Função para abrir o modal de preferências.
+ *
+ * @example
+ * ```tsx
+ * function CustomAccessibilityDock() {
+ *   const openPreferencesModal = useOpenPreferencesModal()
+ *
+ *   return (
+ *     <button onClick={openPreferencesModal}>
+ *       ⚙️ Configurar Cookies
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useOpenPreferencesModal(): () => void;
+declare function openPreferencesModal(): void;
 
 /**
  * Sistema de orientações para developers sobre configuração de categorias.
@@ -718,4 +746,28 @@ declare function ConsentScriptLoader({ integrations, reloadOnChange, }: Readonly
  */
 declare function useConsentScriptLoader(): (integration: ScriptIntegration) => Promise<boolean>;
 
-export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, ConsentScriptLoader, type ConsentState, type ConsentTexts, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts };
+/**
+ * Sistema de logging interno da biblioteca para facilitar debug e troubleshooting.
+ * Os logs são desabilitados automaticamente em production builds.
+ */
+declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+/**
+ * Função para habilitar/desabilitar logs de debug externamente.
+ * Útil para troubleshooting em produção quando necessário.
+ *
+ * @example
+ * ```typescript
+ * import { setDebugLogging } from 'react-lgpd-consent'
+ *
+ * // Habilitar logs detalhados
+ * setDebugLogging(true, LogLevel.DEBUG)
+ * ```
+ */
+declare function setDebugLogging(enabled: boolean, level?: LogLevel): void;
+
+export { COMMON_INTEGRATIONS, type Category, type CategoryDefinition, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentProviderProps, ConsentScriptLoader, type ConsentState, type ConsentTexts, type CustomCookieBannerProps, type CustomFloatingPreferencesButtonProps, type CustomPreferencesModalProps, DEFAULT_PROJECT_CATEGORIES, type DeveloperGuidance, type GoogleAnalyticsConfig, type GoogleTagManagerConfig, LogLevel, PreferencesModal, type ProjectCategoriesConfig, type ScriptIntegration, type UserWayConfig, analyzeDeveloperConfiguration, createGoogleAnalyticsIntegration, createGoogleTagManagerIntegration, createUserWayIntegration, defaultConsentTheme, loadScript, openPreferencesModal, setDebugLogging, useCategories, useCategoryStatus, useConsent, useConsentHydration, useConsentScriptLoader, useConsentTexts, useOpenPreferencesModal };

package/dist/index.js

@@ -1,15 +1,19 @@
 import {
   ConsentProvider,
   DEFAULT_PROJECT_CATEGORIES,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
   defaultConsentTheme,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
-  useConsentTexts
-} from "./chunk-R3IKVZBC.js";
+  useConsentTexts,
+  useOpenPreferencesModal
+} from "./chunk-VFAOBR3X.js";
 
 // src/utils/ConsentGate.tsx
 import { Fragment, jsx } from "react/jsx-runtime";
@@ -192,6 +196,7 @@ export {
   ConsentProvider,
   ConsentScriptLoader,
   DEFAULT_PROJECT_CATEGORIES,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
@@ -199,10 +204,13 @@ export {
   createUserWayIntegration,
   defaultConsentTheme,
   loadScript,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,
-  useConsentTexts
+  useConsentTexts,
+  useOpenPreferencesModal
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Biblioteca completa de consentimento LGPD com 6 categorias ANPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",
@@ -48,12 +48,13 @@
     "dist",
     "README.md",
     "LICENSE",
-    "COMPLIANCE.md"
+    "COMPLIANCE.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18.18"
   },
-  "packageManager": "pnpm@9.0.0",
+  "packageManager": "pnpm@9.15.9",
   "scripts": {
     "clean": "rimraf dist",
     "build": "cross-env NODE_ENV=production tsup src/index.ts --format esm,cjs --dts --clean",
@@ -97,7 +98,7 @@
     "@testing-library/user-event": "^14.6.1",
     "@types/jest": "^30.0.0",
     "@types/js-cookie": "^3.0.6",
-    "@types/react": "^19.1.9",
+    "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "@typescript-eslint/eslint-plugin": "^8.39.1",
     "@typescript-eslint/parser": "^8.39.1",