react-lgpd-consent 0.3.0 → 0.3.1

package/dist/{chunk-R3IKVZBC.js → chunk-VFAOBR3X.js}

@@ -202,11 +202,186 @@ function useCategoryStatus(categoryId) {
 }
 
 // src/context/ConsentContext.tsx
-import * as React4 from "react";
-import { ThemeProvider } from "@mui/material/styles";
+import * as React5 from "react";
+
+// src/utils/SafeThemeProvider.tsx
+import * as React3 from "react";
+import { ThemeProvider, createTheme } from "@mui/material/styles";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var createSafeTheme = (userTheme) => {
+  const baseTheme = createTheme({
+    palette: {
+      primary: {
+        main: "#1976d2",
+        dark: "#1565c0",
+        light: "#42a5f5",
+        contrastText: "#ffffff"
+      },
+      secondary: {
+        main: "#dc004e",
+        dark: "#9a0036",
+        light: "#e33371",
+        contrastText: "#ffffff"
+      },
+      background: {
+        default: "#fafafa",
+        paper: "#ffffff"
+      },
+      text: {
+        primary: "#333333",
+        secondary: "#666666"
+      }
+    },
+    transitions: {
+      duration: {
+        shortest: 150,
+        shorter: 200,
+        short: 250,
+        standard: 300,
+        complex: 375,
+        enteringScreen: 225,
+        leavingScreen: 195
+      }
+    }
+  });
+  if (!userTheme) {
+    return baseTheme;
+  }
+  return createTheme({
+    ...baseTheme,
+    ...userTheme,
+    palette: {
+      ...baseTheme.palette,
+      ...userTheme.palette,
+      primary: {
+        ...baseTheme.palette.primary,
+        ...userTheme.palette?.primary
+      },
+      secondary: {
+        ...baseTheme.palette.secondary,
+        ...userTheme.palette?.secondary
+      },
+      background: {
+        ...baseTheme.palette.background,
+        ...userTheme.palette?.background
+      },
+      text: {
+        ...baseTheme.palette.text,
+        ...userTheme.palette?.text
+      }
+    },
+    transitions: {
+      ...baseTheme.transitions,
+      ...userTheme.transitions,
+      duration: {
+        ...baseTheme.transitions.duration,
+        ...userTheme.transitions?.duration
+      }
+    }
+  });
+};
+function SafeThemeProvider({
+  theme,
+  children
+}) {
+  const safeTheme = React3.useMemo(() => createSafeTheme(theme), [theme]);
+  return /* @__PURE__ */ jsx2(ThemeProvider, { theme: safeTheme, children });
+}
 
 // src/utils/cookieUtils.ts
 import Cookies from "js-cookie";
+
+// src/utils/logger.ts
+var IS_DEVELOPMENT = typeof window !== "undefined" && window.__REACT_DEVTOOLS_GLOBAL_HOOK__ || typeof globalThis !== "undefined" && globalThis.process?.env?.NODE_ENV === "development";
+var LOG_PREFIX = "[react-lgpd-consent]";
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["ERROR"] = 0] = "ERROR";
+  LogLevel2[LogLevel2["WARN"] = 1] = "WARN";
+  LogLevel2[LogLevel2["INFO"] = 2] = "INFO";
+  LogLevel2[LogLevel2["DEBUG"] = 3] = "DEBUG";
+  return LogLevel2;
+})(LogLevel || {});
+var ConsentLogger = class {
+  constructor() {
+    this.enabled = IS_DEVELOPMENT;
+    this.level = 2 /* INFO */;
+  }
+  setEnabled(enabled) {
+    this.enabled = enabled;
+  }
+  setLevel(level) {
+    this.level = level;
+  }
+  error(...args) {
+    if (this.enabled && this.level >= 0 /* ERROR */) {
+      console.error(LOG_PREFIX, "[ERROR]", ...args);
+    }
+  }
+  warn(...args) {
+    if (this.enabled && this.level >= 1 /* WARN */) {
+      console.warn(LOG_PREFIX, "[WARN]", ...args);
+    }
+  }
+  info(...args) {
+    if (this.enabled && this.level >= 2 /* INFO */) {
+      console.info(LOG_PREFIX, "[INFO]", ...args);
+    }
+  }
+  debug(...args) {
+    if (this.enabled && this.level >= 3 /* DEBUG */) {
+      console.debug(LOG_PREFIX, "[DEBUG]", ...args);
+    }
+  }
+  // Logs específicos para troubleshooting
+  themeCompatibility(themeInfo) {
+    this.debug("Theme compatibility check:", {
+      hasTheme: !!themeInfo,
+      hasPalette: !!themeInfo?.palette,
+      hasPrimary: !!themeInfo?.palette?.primary,
+      hasTransitions: !!themeInfo?.transitions,
+      hasDuration: !!themeInfo?.transitions?.duration
+    });
+  }
+  consentState(action, state) {
+    this.debug(`Consent state change [${action}]:`, {
+      consented: state.consented,
+      isModalOpen: state.isModalOpen,
+      preferencesCount: Object.keys(state.preferences || {}).length
+    });
+  }
+  cookieOperation(operation, cookieName, data) {
+    this.debug(`Cookie ${operation}:`, {
+      name: cookieName,
+      hasData: !!data,
+      dataSize: data ? JSON.stringify(data).length : 0
+    });
+  }
+  componentRender(componentName, props) {
+    this.debug(`Component render [${componentName}]:`, {
+      hasProps: !!props,
+      propsKeys: props ? Object.keys(props) : []
+    });
+  }
+  scriptIntegration(scriptName, action, success) {
+    this.info(
+      `Script ${action} [${scriptName}]:`,
+      success ? "SUCCESS" : "FAILED"
+    );
+  }
+  apiUsage(method, params) {
+    this.debug(`API call [${method}]:`, params);
+  }
+};
+var logger = new ConsentLogger();
+function setDebugLogging(enabled, level = 2 /* INFO */) {
+  logger.setEnabled(enabled);
+  logger.setLevel(level);
+  logger.info(
+    `Debug logging ${enabled ? "enabled" : "disabled"} with level ${LogLevel[level]}`
+  );
+}
+
+// src/utils/cookieUtils.ts
 var DEFAULT_COOKIE_OPTS = {
   name: "cookieConsent",
   maxAgeDays: 365,
@@ -216,22 +391,32 @@ var DEFAULT_COOKIE_OPTS = {
 };
 var COOKIE_SCHEMA_VERSION = "1.0";
 function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
-  if (typeof document === "undefined") return null;
+  logger.debug("Reading consent cookie", { name });
+  if (typeof document === "undefined") {
+    logger.debug("Cookie read skipped: server-side environment");
+    return null;
+  }
   const raw = Cookies.get(name);
-  if (!raw) return null;
+  if (!raw) {
+    logger.debug("No consent cookie found");
+    return null;
+  }
   try {
     const data = JSON.parse(raw);
+    logger.cookieOperation("read", name, data);
     if (!data.version) {
+      logger.debug("Migrating legacy cookie format");
       return migrateLegacyCookie(data);
     }
     if (data.version !== COOKIE_SCHEMA_VERSION) {
-      console.warn(
-        `[react-lgpd-consent] Cookie version mismatch: ${data.version} != ${COOKIE_SCHEMA_VERSION}`
+      logger.warn(
+        `Cookie version mismatch: ${data.version} != ${COOKIE_SCHEMA_VERSION}`
       );
       return null;
     }
     return data;
-  } catch {
+  } catch (error) {
+    logger.error("Error parsing consent cookie", error);
     return null;
   }
 }
@@ -255,7 +440,10 @@ function migrateLegacyCookie(legacyData) {
   }
 }
 function writeConsentCookie(state, config, opts, source = "banner") {
-  if (typeof document === "undefined") return;
+  if (typeof document === "undefined") {
+    logger.debug("Cookie write skipped: server-side environment");
+    return;
+  }
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
   const cookieData = {
@@ -269,17 +457,28 @@ function writeConsentCookie(state, config, opts, source = "banner") {
     projectConfig: config
     // isModalOpen NÃO é persistido (campo de UI apenas)
   };
+  logger.cookieOperation("write", o.name, cookieData);
   Cookies.set(o.name, JSON.stringify(cookieData), {
     expires: o.maxAgeDays,
     sameSite: o.sameSite,
     secure: o.secure,
     path: o.path
   });
+  logger.info("Consent cookie saved", {
+    consented: cookieData.consented,
+    source: cookieData.source,
+    preferencesCount: Object.keys(cookieData.preferences).length
+  });
 }
 function removeConsentCookie(opts) {
-  if (typeof document === "undefined") return;
+  if (typeof document === "undefined") {
+    logger.debug("Cookie removal skipped: server-side environment");
+    return;
+  }
   const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
+  logger.cookieOperation("delete", o.name);
   Cookies.remove(o.name, { path: o.path });
+  logger.info("Consent cookie removed");
 }
 
 // src/utils/categoryUtils.ts
@@ -311,8 +510,8 @@ function validateProjectPreferences(preferences, config) {
 }
 
 // src/utils/theme.ts
-import { createTheme } from "@mui/material/styles";
-var defaultConsentTheme = createTheme({
+import { createTheme as createTheme2 } from "@mui/material/styles";
+var defaultConsentTheme = createTheme2({
   palette: {
     primary: {
       main: "#1976d2",
@@ -379,17 +578,17 @@ var defaultConsentTheme = createTheme({
 });
 
 // src/context/DesignContext.tsx
-import * as React3 from "react";
-import { jsx as jsx2 } from "react/jsx-runtime";
-var DesignContext = React3.createContext(void 0);
+import * as React4 from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var DesignContext = React4.createContext(void 0);
 function DesignProvider({
   tokens,
   children
 }) {
-  return /* @__PURE__ */ jsx2(DesignContext.Provider, { value: tokens, children });
+  return /* @__PURE__ */ jsx3(DesignContext.Provider, { value: tokens, children });
 }
 function useDesignTokens() {
-  return React3.useContext(DesignContext);
+  return React4.useContext(DesignContext);
 }
 
 // src/components/CookieBanner.tsx
@@ -404,7 +603,7 @@ import Link2 from "@mui/material/Link";
 // src/components/Branding.tsx
 import Link from "@mui/material/Link";
 import Typography from "@mui/material/Typography";
-import { jsx as jsx3, jsxs } from "react/jsx-runtime";
+import { jsx as jsx4, jsxs } from "react/jsx-runtime";
 var brandingStyles = {
   banner: {
     fontSize: "0.65rem",
@@ -432,6 +631,7 @@ var linkStyles = {
   }
 };
 function Branding({ variant, hidden = false }) {
+  const texts = useConsentTexts();
   if (hidden) return null;
   return /* @__PURE__ */ jsxs(
     Typography,
@@ -442,9 +642,9 @@ function Branding({ variant, hidden = false }) {
         color: theme.palette.text.secondary
       }),
       children: [
-        "fornecido por",
+        texts.brandingPoweredBy || "fornecido por",
         " ",
-        /* @__PURE__ */ jsx3(
+        /* @__PURE__ */ jsx4(
           Link,
           {
             href: "https://www.ledipo.eti.br",
@@ -463,7 +663,7 @@ function Branding({ variant, hidden = false }) {
 }
 
 // src/components/CookieBanner.tsx
-import { Fragment, jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
 function CookieBanner({
   policyLinkUrl,
   debug,
@@ -477,6 +677,13 @@ function CookieBanner({
   const isHydrated = useConsentHydration();
   const designTokens = useDesignTokens();
   const open = debug ? true : isHydrated && !consented;
+  logger.componentRender("CookieBanner", {
+    open,
+    consented,
+    isHydrated,
+    blocking,
+    hideBranding
+  });
   if (!open) return null;
   const bannerStyle = {
     p: designTokens?.spacing?.padding?.banner ?? 2,
@@ -487,7 +694,7 @@ function CookieBanner({
     borderRadius: designTokens?.spacing?.borderRadius?.banner,
     fontFamily: designTokens?.typography?.fontFamily
   };
-  const bannerContent = /* @__PURE__ */ jsx4(Paper, { elevation: 3, sx: bannerStyle, ...PaperProps, children: /* @__PURE__ */ jsxs2(Stack, { spacing: 1, children: [
+  const bannerContent = /* @__PURE__ */ jsx5(Paper, { elevation: 3, sx: bannerStyle, ...PaperProps, children: /* @__PURE__ */ jsxs2(Stack, { spacing: 1, children: [
     /* @__PURE__ */ jsxs2(
       Typography2,
       {
@@ -496,7 +703,7 @@ function CookieBanner({
         children: [
           texts.bannerMessage,
           " ",
-          policyLinkUrl && /* @__PURE__ */ jsx4(
+          policyLinkUrl && /* @__PURE__ */ jsx5(
             Link2,
             {
               href: policyLinkUrl,
@@ -517,29 +724,38 @@ function CookieBanner({
         spacing: 1,
         justifyContent: "flex-end",
         children: [
-          /* @__PURE__ */ jsx4(
+          /* @__PURE__ */ jsx5(
             Button,
             {
               variant: "outlined",
-              onClick: rejectAll,
+              onClick: () => {
+                logger.apiUsage("rejectAll", { source: "banner" });
+                rejectAll();
+              },
               sx: { color: designTokens?.colors?.secondary },
               children: texts.declineAll
             }
           ),
-          /* @__PURE__ */ jsx4(
+          /* @__PURE__ */ jsx5(
             Button,
             {
               variant: "contained",
-              onClick: acceptAll,
+              onClick: () => {
+                logger.apiUsage("acceptAll", { source: "banner" });
+                acceptAll();
+              },
               sx: { backgroundColor: designTokens?.colors?.primary },
               children: texts.acceptAll
             }
           ),
-          /* @__PURE__ */ jsx4(
+          /* @__PURE__ */ jsx5(
             Button,
             {
               variant: "text",
-              onClick: openPreferences,
+              onClick: () => {
+                logger.apiUsage("openPreferences", { source: "banner" });
+                openPreferences();
+              },
               sx: { color: designTokens?.colors?.text },
               children: texts.preferences
             }
@@ -547,7 +763,7 @@ function CookieBanner({
         ]
       }
     ),
-    !hideBranding && /* @__PURE__ */ jsx4(Branding, { variant: "banner" })
+    !hideBranding && /* @__PURE__ */ jsx5(Branding, { variant: "banner" })
   ] }) });
   const positionStyle = {
     position: "fixed",
@@ -560,7 +776,7 @@ function CookieBanner({
   };
   if (blocking) {
     return /* @__PURE__ */ jsxs2(Fragment, { children: [
-      /* @__PURE__ */ jsx4(
+      /* @__PURE__ */ jsx5(
         Box,
         {
           sx: {
@@ -574,10 +790,10 @@ function CookieBanner({
           }
         }
       ),
-      /* @__PURE__ */ jsx4(Box, { sx: positionStyle, children: bannerContent })
+      /* @__PURE__ */ jsx5(Box, { sx: positionStyle, children: bannerContent })
     ] });
   }
-  return /* @__PURE__ */ jsx4(
+  return /* @__PURE__ */ jsx5(
     Snackbar,
     {
       open,
@@ -596,21 +812,49 @@ import CookieOutlined from "@mui/icons-material/CookieOutlined";
 import Fab from "@mui/material/Fab";
 import Tooltip from "@mui/material/Tooltip";
 import { useTheme } from "@mui/material/styles";
-import { jsx as jsx5 } from "react/jsx-runtime";
+import { jsx as jsx6 } from "react/jsx-runtime";
+function useThemeWithFallbacks() {
+  const theme = useTheme();
+  logger.themeCompatibility(theme);
+  return {
+    palette: {
+      primary: {
+        main: theme?.palette?.primary?.main || "#1976d2",
+        dark: theme?.palette?.primary?.dark || "#1565c0"
+      }
+    },
+    transitions: {
+      duration: {
+        shortest: theme?.transitions?.duration?.shortest || 150,
+        short: theme?.transitions?.duration?.short || 250
+      }
+    }
+  };
+}
 function FloatingPreferencesButton({
   position = "bottom-right",
   offset = 24,
-  icon = /* @__PURE__ */ jsx5(CookieOutlined, {}),
+  icon = /* @__PURE__ */ jsx6(CookieOutlined, {}),
   tooltip,
   FabProps,
   hideWhenConsented = false
 }) {
   const { openPreferences, consented } = useConsent();
-  const theme = useTheme();
+  const texts = useConsentTexts();
+  const safeTheme = useThemeWithFallbacks();
+  logger.componentRender("FloatingPreferencesButton", {
+    position,
+    offset,
+    hideWhenConsented,
+    consented
+  });
   if (hideWhenConsented && consented) {
+    logger.debug(
+      "FloatingPreferencesButton: Hidden due to hideWhenConsented=true and consented=true"
+    );
     return null;
   }
-  const tooltipText = tooltip ?? "Gerenciar Prefer\xEAncias de Cookies";
+  const tooltipText = tooltip ?? texts.preferencesButton ?? "Gerenciar Prefer\xEAncias de Cookies";
   const getPosition = () => {
     const styles = {
       position: "fixed",
@@ -629,7 +873,7 @@ function FloatingPreferencesButton({
         return { ...styles, bottom: offset, right: offset };
     }
   };
-  return /* @__PURE__ */ jsx5(Tooltip, { title: tooltipText, placement: "top", children: /* @__PURE__ */ jsx5(
+  return /* @__PURE__ */ jsx6(Tooltip, { title: tooltipText, placement: "top", children: /* @__PURE__ */ jsx6(
     Fab,
     {
       size: "medium",
@@ -637,10 +881,11 @@ function FloatingPreferencesButton({
       onClick: openPreferences,
       sx: {
         ...getPosition(),
-        backgroundColor: theme.palette.primary.main,
+        backgroundColor: safeTheme.palette.primary.main,
         "&:hover": {
-          backgroundColor: theme.palette.primary.dark
-        }
+          backgroundColor: safeTheme.palette.primary.dark
+        },
+        transition: `all ${safeTheme.transitions.duration.short}ms`
       },
       "aria-label": tooltipText,
       ...FabProps,
@@ -650,9 +895,21 @@ function FloatingPreferencesButton({
 }
 
 // src/context/ConsentContext.tsx
-import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
-var PreferencesModal = React4.lazy(
-  () => import("./PreferencesModal-XCTM6WJN.js").then((m) => ({
+import { jsx as jsx7, jsxs as jsxs3 } from "react/jsx-runtime";
+var log = {
+  debug: (message, data) => {
+    if (typeof window !== "undefined" && window.__REACT_DEVTOOLS_GLOBAL_HOOK__) {
+      console.debug("[react-lgpd-consent] [DEBUG]", message, data);
+    }
+  },
+  info: (message, data) => {
+    if (typeof window !== "undefined" && window.__REACT_DEVTOOLS_GLOBAL_HOOK__) {
+      console.info("[react-lgpd-consent] [INFO]", message, data);
+    }
+  }
+};
+var PreferencesModal = React5.lazy(
+  () => import("./PreferencesModal-J27W5XAJ.js").then((m) => ({
     default: m.PreferencesModal
   }))
 );
@@ -680,7 +937,15 @@ var DEFAULT_TEXTS = {
   modalIntro: "Ajuste as categorias de cookies. Cookies necess\xE1rios s\xE3o sempre utilizados para funcionalidades b\xE1sicas.",
   save: "Salvar prefer\xEAncias",
   necessaryAlwaysOn: "Cookies necess\xE1rios (sempre ativos)",
+  // Textos adicionais para UI customizada
+  preferencesButton: "Configurar Cookies",
+  preferencesTitle: "Gerenciar Prefer\xEAncias de Cookies",
+  preferencesDescription: "Escolha quais tipos de cookies voc\xEA permite que sejam utilizados.",
+  close: "Fechar",
+  accept: "Aceitar",
+  reject: "Rejeitar",
   // Textos ANPD expandidos (opcionais)
+  brandingPoweredBy: "fornecido por",
   controllerInfo: void 0,
   // Exibido se definido
   dataTypes: void 0,
@@ -699,10 +964,14 @@ var DEFAULT_TEXTS = {
   // Exibido se definido
 };
 function reducer(state, action) {
+  log.debug("State transition:", {
+    action: action.type,
+    currentState: state.consented
+  });
   switch (action.type) {
     case "ACCEPT_ALL": {
       const prefs = createProjectPreferences(action.config, true);
-      return createFullConsentState(
+      const newState = createFullConsentState(
         true,
         prefs,
         "banner",
@@ -710,10 +979,14 @@ function reducer(state, action) {
         false,
         state
       );
+      log.info("User accepted all cookies", {
+        preferences: newState.preferences
+      });
+      return newState;
     }
     case "REJECT_ALL": {
       const prefs = createProjectPreferences(action.config, false);
-      return createFullConsentState(
+      const newState = createFullConsentState(
         true,
         prefs,
         "banner",
@@ -721,8 +994,16 @@ function reducer(state, action) {
         false,
         state
       );
+      log.info("User rejected all cookies", {
+        preferences: newState.preferences
+      });
+      return newState;
     }
     case "SET_CATEGORY":
+      log.debug("Category preference changed", {
+        category: action.category,
+        value: action.value
+      });
       return {
         ...state,
         preferences: {
@@ -732,6 +1013,7 @@ function reducer(state, action) {
         lastUpdate: (/* @__PURE__ */ new Date()).toISOString()
       };
     case "SET_PREFERENCES":
+      log.info("Preferences saved", { preferences: action.preferences });
       return createFullConsentState(
         true,
         action.preferences,
@@ -775,10 +1057,10 @@ function reducer(state, action) {
       return state;
   }
 }
-var StateCtx = React4.createContext(null);
-var ActionsCtx = React4.createContext(null);
-var TextsCtx = React4.createContext(DEFAULT_TEXTS);
-var HydrationCtx = React4.createContext(false);
+var StateCtx = React5.createContext(null);
+var ActionsCtx = React5.createContext(null);
+var TextsCtx = React5.createContext(DEFAULT_TEXTS);
+var HydrationCtx = React5.createContext(false);
 function ConsentProvider({
   initialState,
   categories,
@@ -802,24 +1084,24 @@ function ConsentProvider({
   disableDeveloperGuidance,
   children
 }) {
-  const texts = React4.useMemo(
+  const texts = React5.useMemo(
     () => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }),
     [textsProp]
   );
-  const cookie = React4.useMemo(
+  const cookie = React5.useMemo(
     () => ({ ...DEFAULT_COOKIE_OPTS, ...cookieOpts ?? {} }),
     [cookieOpts]
   );
-  const appliedTheme = React4.useMemo(
+  const appliedTheme = React5.useMemo(
     () => theme || defaultConsentTheme,
     [theme]
   );
-  const finalCategoriesConfig = React4.useMemo(() => {
+  const finalCategoriesConfig = React5.useMemo(() => {
     if (categories) return categories;
     return DEFAULT_PROJECT_CATEGORIES;
   }, [categories]);
   useDeveloperGuidance(finalCategoriesConfig, disableDeveloperGuidance);
-  const boot = React4.useMemo(() => {
+  const boot = React5.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
     return createFullConsentState(
       false,
@@ -829,9 +1111,9 @@ function ConsentProvider({
       false
     );
   }, [initialState, finalCategoriesConfig]);
-  const [state, dispatch] = React4.useReducer(reducer, boot);
-  const [isHydrated, setIsHydrated] = React4.useState(false);
-  React4.useEffect(() => {
+  const [state, dispatch] = React5.useReducer(reducer, boot);
+  const [isHydrated, setIsHydrated] = React5.useState(false);
+  React5.useEffect(() => {
     if (!initialState) {
       const saved = readConsentCookie(cookie.name);
       if (saved?.consented) {
@@ -844,18 +1126,18 @@ function ConsentProvider({
     }
     setIsHydrated(true);
   }, [cookie.name, initialState, finalCategoriesConfig]);
-  React4.useEffect(() => {
+  React5.useEffect(() => {
     if (state.consented)
       writeConsentCookie(state, finalCategoriesConfig, cookie);
   }, [state, cookie, finalCategoriesConfig]);
-  const prevConsented = React4.useRef(state.consented);
-  React4.useEffect(() => {
+  const prevConsented = React5.useRef(state.consented);
+  React5.useEffect(() => {
     if (!prevConsented.current && state.consented && onConsentGiven) {
       setTimeout(() => onConsentGiven(state), 150);
     }
     prevConsented.current = state.consented;
   }, [state, onConsentGiven]);
-  const api = React4.useMemo(() => {
+  const api = React5.useMemo(() => {
     const acceptAll = () => dispatch({ type: "ACCEPT_ALL", config: finalCategoriesConfig });
     const rejectAll = () => dispatch({ type: "REJECT_ALL", config: finalCategoriesConfig });
     const setPreference = (category, value) => dispatch({ type: "SET_CATEGORY", category, value });
@@ -888,14 +1170,18 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie, finalCategoriesConfig, onPreferencesSaved]);
-  return /* @__PURE__ */ jsx6(ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx6(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx6(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsx6(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsx6(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ jsx6(DesignProvider, { tokens: designTokens, children: /* @__PURE__ */ jsxs3(
+  React5.useEffect(() => {
+    _registerGlobalOpenPreferences(api.openPreferences);
+    return () => _unregisterGlobalOpenPreferences();
+  }, [api.openPreferences]);
+  return /* @__PURE__ */ jsx7(SafeThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx7(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx7(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsx7(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsx7(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ jsx7(DesignProvider, { tokens: designTokens, children: /* @__PURE__ */ jsxs3(
     CategoriesProvider,
     {
       config: finalCategoriesConfig,
       disableDeveloperGuidance,
       children: [
         children,
-        /* @__PURE__ */ jsx6(React4.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx6(
+        /* @__PURE__ */ jsx7(React5.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx7(
           PreferencesModalComponent,
           {
             preferences: api.preferences,
@@ -905,8 +1191,8 @@ function ConsentProvider({
             texts,
             ...preferencesModalProps
           }
-        ) : /* @__PURE__ */ jsx6(PreferencesModal, { hideBranding }) }),
-        !state.consented && isHydrated && (CookieBannerComponent ? /* @__PURE__ */ jsx6(
+        ) : /* @__PURE__ */ jsx7(PreferencesModal, { hideBranding }) }),
+        !state.consented && isHydrated && (CookieBannerComponent ? /* @__PURE__ */ jsx7(
           CookieBannerComponent,
           {
             consented: api.consented,
@@ -916,37 +1202,37 @@ function ConsentProvider({
             texts,
             ...cookieBannerProps
           }
-        ) : /* @__PURE__ */ jsx6(CookieBanner, {})),
-        state.consented && !disableFloatingPreferencesButton && (FloatingPreferencesButtonComponent ? /* @__PURE__ */ jsx6(
+        ) : /* @__PURE__ */ jsx7(CookieBanner, {})),
+        state.consented && !disableFloatingPreferencesButton && (FloatingPreferencesButtonComponent ? /* @__PURE__ */ jsx7(
           FloatingPreferencesButtonComponent,
           {
             openPreferences: api.openPreferences,
             consented: api.consented,
             ...floatingPreferencesButtonProps
           }
-        ) : /* @__PURE__ */ jsx6(FloatingPreferencesButton, {}))
+        ) : /* @__PURE__ */ jsx7(FloatingPreferencesButton, {}))
       ]
     }
   ) }) }) }) }) }) });
 }
 function useConsentStateInternal() {
-  const ctx = React4.useContext(StateCtx);
+  const ctx = React5.useContext(StateCtx);
   if (!ctx)
     throw new Error("useConsentState must be used within ConsentProvider");
   return ctx;
 }
 function useConsentActionsInternal() {
-  const ctx = React4.useContext(ActionsCtx);
+  const ctx = React5.useContext(ActionsCtx);
   if (!ctx)
     throw new Error("useConsentActions must be used within ConsentProvider");
   return ctx;
 }
 function useConsentTextsInternal() {
-  const ctx = React4.useContext(TextsCtx);
+  const ctx = React5.useContext(TextsCtx);
   return ctx;
 }
 function useConsentHydrationInternal() {
-  return React4.useContext(HydrationCtx);
+  return React5.useContext(HydrationCtx);
 }
 
 // src/hooks/useConsent.ts
@@ -972,9 +1258,29 @@ function useConsentTexts() {
 function useConsentHydration() {
   return useConsentHydrationInternal();
 }
+function useOpenPreferencesModal() {
+  const { openPreferences } = useConsent();
+  return openPreferences;
+}
+var globalOpenPreferences = null;
+function openPreferencesModal() {
+  if (globalOpenPreferences) {
+    globalOpenPreferences();
+  } else {
+    console.warn(
+      "openPreferencesModal: ConsentProvider n\xE3o foi inicializado ou n\xE3o est\xE1 dispon\xEDvel."
+    );
+  }
+}
+function _registerGlobalOpenPreferences(openPreferences) {
+  globalOpenPreferences = openPreferences;
+}
+function _unregisterGlobalOpenPreferences() {
+  globalOpenPreferences = null;
+}
 
 // src/components/PreferencesModal.tsx
-import { jsx as jsx7, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx8, jsxs as jsxs4 } from "react/jsx-runtime";
 function PreferencesModal2({
   DialogProps: DialogProps2,
   hideBranding = false
@@ -1016,14 +1322,14 @@ function PreferencesModal2({
       onClose: handleCancel,
       ...DialogProps2,
       children: [
-        /* @__PURE__ */ jsx7(DialogTitle, { id: "cookie-pref-title", children: texts.modalTitle }),
+        /* @__PURE__ */ jsx8(DialogTitle, { id: "cookie-pref-title", children: texts.modalTitle }),
         /* @__PURE__ */ jsxs4(DialogContent, { dividers: true, children: [
-          /* @__PURE__ */ jsx7(Typography3, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
+          /* @__PURE__ */ jsx8(Typography3, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
           /* @__PURE__ */ jsxs4(FormGroup, { children: [
-            toggleableCategories.map((category) => /* @__PURE__ */ jsx7(
+            toggleableCategories.map((category) => /* @__PURE__ */ jsx8(
               FormControlLabel,
               {
-                control: /* @__PURE__ */ jsx7(
+                control: /* @__PURE__ */ jsx8(
                   Switch,
                   {
                     checked: tempPreferences[category.id] ?? false,
@@ -1037,20 +1343,20 @@ function PreferencesModal2({
               },
               category.id
             )),
-            /* @__PURE__ */ jsx7(
+            /* @__PURE__ */ jsx8(
               FormControlLabel,
               {
-                control: /* @__PURE__ */ jsx7(Switch, { checked: true, disabled: true }),
+                control: /* @__PURE__ */ jsx8(Switch, { checked: true, disabled: true }),
                 label: texts.necessaryAlwaysOn
               }
             )
           ] })
         ] }),
         /* @__PURE__ */ jsxs4(DialogActions, { children: [
-          /* @__PURE__ */ jsx7(Button2, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
-          /* @__PURE__ */ jsx7(Button2, { variant: "contained", onClick: handleSave, children: texts.save })
+          /* @__PURE__ */ jsx8(Button2, { variant: "outlined", onClick: handleCancel, children: texts.close }),
+          /* @__PURE__ */ jsx8(Button2, { variant: "contained", onClick: handleSave, children: texts.save })
         ] }),
-        !hideBranding && /* @__PURE__ */ jsx7(Branding, { variant: "modal" })
+        !hideBranding && /* @__PURE__ */ jsx8(Branding, { variant: "modal" })
       ]
     }
   );
@@ -1061,10 +1367,14 @@ export {
   analyzeDeveloperConfiguration,
   useCategories,
   useCategoryStatus,
+  LogLevel,
+  setDebugLogging,
   defaultConsentTheme,
   ConsentProvider,
   useConsent,
   useConsentTexts,
   useConsentHydration,
+  useOpenPreferencesModal,
+  openPreferencesModal,
   PreferencesModal2 as PreferencesModal
 };