react-lgpd-consent 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -232,24 +232,220 @@ var init_CategoriesContext = __esm({
   }
 });
 
+// src/utils/SafeThemeProvider.tsx
+function SafeThemeProvider({
+  theme,
+  children
+}) {
+  const safeTheme = React3.useMemo(() => createSafeTheme(theme), [theme]);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_styles.ThemeProvider, { theme: safeTheme, children });
+}
+var React3, import_styles, import_jsx_runtime2, createSafeTheme;
+var init_SafeThemeProvider = __esm({
+  "src/utils/SafeThemeProvider.tsx"() {
+    "use strict";
+    React3 = __toESM(require("react"), 1);
+    import_styles = require("@mui/material/styles");
+    import_jsx_runtime2 = require("react/jsx-runtime");
+    createSafeTheme = (userTheme) => {
+      const baseTheme = (0, import_styles.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 (0, import_styles.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
+          }
+        }
+      });
+    };
+  }
+});
+
+// src/utils/logger.ts
+function setDebugLogging(enabled, level = 2 /* INFO */) {
+  logger.setEnabled(enabled);
+  logger.setLevel(level);
+  logger.info(
+    `Debug logging ${enabled ? "enabled" : "disabled"} with level ${LogLevel[level]}`
+  );
+}
+var IS_DEVELOPMENT, LOG_PREFIX, LogLevel, ConsentLogger, logger;
+var init_logger = __esm({
+  "src/utils/logger.ts"() {
+    "use strict";
+    IS_DEVELOPMENT = typeof window !== "undefined" && window.__REACT_DEVTOOLS_GLOBAL_HOOK__ || typeof globalThis !== "undefined" && globalThis.process?.env?.NODE_ENV === "development";
+    LOG_PREFIX = "[react-lgpd-consent]";
+    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 || {});
+    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);
+      }
+    };
+    logger = new ConsentLogger();
+  }
+});
+
 // src/utils/cookieUtils.ts
 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 = import_js_cookie.default.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;
   }
 }
@@ -273,7 +469,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 = {
@@ -287,23 +486,35 @@ function writeConsentCookie(state, config, opts, source = "banner") {
     projectConfig: config
     // isModalOpen NÃO é persistido (campo de UI apenas)
   };
+  logger.cookieOperation("write", o.name, cookieData);
   import_js_cookie.default.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);
   import_js_cookie.default.remove(o.name, { path: o.path });
+  logger.info("Consent cookie removed");
 }
 var import_js_cookie, DEFAULT_COOKIE_OPTS, COOKIE_SCHEMA_VERSION;
 var init_cookieUtils = __esm({
   "src/utils/cookieUtils.ts"() {
     "use strict";
     import_js_cookie = __toESM(require("js-cookie"), 1);
+    init_logger();
     DEFAULT_COOKIE_OPTS = {
       name: "cookieConsent",
       maxAgeDays: 365,
@@ -349,12 +560,12 @@ var init_categoryUtils = __esm({
 });
 
 // src/utils/theme.ts
-var import_styles, defaultConsentTheme;
+var import_styles2, defaultConsentTheme;
 var init_theme = __esm({
   "src/utils/theme.ts"() {
     "use strict";
-    import_styles = require("@mui/material/styles");
-    defaultConsentTheme = (0, import_styles.createTheme)({
+    import_styles2 = require("@mui/material/styles");
+    defaultConsentTheme = (0, import_styles2.createTheme)({
       palette: {
         primary: {
           main: "#1976d2",
@@ -427,25 +638,26 @@ function DesignProvider({
   tokens,
   children
 }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(DesignContext.Provider, { value: tokens, children });
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(DesignContext.Provider, { value: tokens, children });
 }
 function useDesignTokens() {
-  return React3.useContext(DesignContext);
+  return React4.useContext(DesignContext);
 }
-var React3, import_jsx_runtime2, DesignContext;
+var React4, import_jsx_runtime3, DesignContext;
 var init_DesignContext = __esm({
   "src/context/DesignContext.tsx"() {
     "use strict";
-    React3 = __toESM(require("react"), 1);
-    import_jsx_runtime2 = require("react/jsx-runtime");
-    DesignContext = React3.createContext(void 0);
+    React4 = __toESM(require("react"), 1);
+    import_jsx_runtime3 = require("react/jsx-runtime");
+    DesignContext = React4.createContext(void 0);
   }
 });
 
 // src/components/Branding.tsx
 function Branding({ variant, hidden = false }) {
+  const texts = useConsentTexts();
   if (hidden) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
     import_Typography.default,
     {
       variant: "caption",
@@ -454,9 +666,9 @@ function Branding({ variant, hidden = false }) {
         color: theme.palette.text.secondary
       }),
       children: [
-        "fornecido por",
+        texts.brandingPoweredBy || "fornecido por",
         " ",
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
           import_Link.default,
           {
             href: "https://www.ledipo.eti.br",
@@ -473,13 +685,14 @@ function Branding({ variant, hidden = false }) {
     }
   );
 }
-var import_Link, import_Typography, import_jsx_runtime3, brandingStyles, linkStyles;
+var import_Link, import_Typography, import_jsx_runtime4, brandingStyles, linkStyles;
 var init_Branding = __esm({
   "src/components/Branding.tsx"() {
     "use strict";
+    init_useConsent();
     import_Link = __toESM(require("@mui/material/Link"), 1);
     import_Typography = __toESM(require("@mui/material/Typography"), 1);
-    import_jsx_runtime3 = require("react/jsx-runtime");
+    import_jsx_runtime4 = require("react/jsx-runtime");
     brandingStyles = {
       banner: {
         fontSize: "0.65rem",
@@ -523,6 +736,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,
@@ -533,8 +753,8 @@ function CookieBanner({
     borderRadius: designTokens?.spacing?.borderRadius?.banner,
     fontFamily: designTokens?.typography?.fontFamily
   };
-  const bannerContent = /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Paper.default, { elevation: 3, sx: bannerStyle, ...PaperProps, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_Stack.default, { spacing: 1, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+  const bannerContent = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_Paper.default, { elevation: 3, sx: bannerStyle, ...PaperProps, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_Stack.default, { spacing: 1, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
       import_Typography2.default,
       {
         variant: "body2",
@@ -542,7 +762,7 @@ function CookieBanner({
         children: [
           texts.bannerMessage,
           " ",
-          policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
             import_Link2.default,
             {
               href: policyLinkUrl,
@@ -556,36 +776,45 @@ function CookieBanner({
         ]
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
       import_Stack.default,
       {
         direction: { xs: "column", sm: "row" },
         spacing: 1,
         justifyContent: "flex-end",
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
             import_Button.default,
             {
               variant: "outlined",
-              onClick: rejectAll,
+              onClick: () => {
+                logger.apiUsage("rejectAll", { source: "banner" });
+                rejectAll();
+              },
               sx: { color: designTokens?.colors?.secondary },
               children: texts.declineAll
             }
           ),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
             import_Button.default,
             {
               variant: "contained",
-              onClick: acceptAll,
+              onClick: () => {
+                logger.apiUsage("acceptAll", { source: "banner" });
+                acceptAll();
+              },
               sx: { backgroundColor: designTokens?.colors?.primary },
               children: texts.acceptAll
             }
           ),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
             import_Button.default,
             {
               variant: "text",
-              onClick: openPreferences,
+              onClick: () => {
+                logger.apiUsage("openPreferences", { source: "banner" });
+                openPreferences();
+              },
               sx: { color: designTokens?.colors?.text },
               children: texts.preferences
             }
@@ -593,7 +822,7 @@ function CookieBanner({
         ]
       }
     ),
-    !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Branding, { variant: "banner" })
+    !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Branding, { variant: "banner" })
   ] }) });
   const positionStyle = {
     position: "fixed",
@@ -605,8 +834,8 @@ function CookieBanner({
     p: 2
   };
   if (blocking) {
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
         import_Box.default,
         {
           sx: {
@@ -620,10 +849,10 @@ function CookieBanner({
           }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Box.default, { sx: positionStyle, children: bannerContent })
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_Box.default, { sx: positionStyle, children: bannerContent })
     ] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
     import_Snackbar.default,
     {
       open,
@@ -636,7 +865,7 @@ function CookieBanner({
     }
   );
 }
-var import_Button, import_Box, import_Paper, import_Snackbar, import_Stack, import_Typography2, import_Link2, import_jsx_runtime4;
+var import_Button, import_Box, import_Paper, import_Snackbar, import_Stack, import_Typography2, import_Link2, import_jsx_runtime5;
 var init_CookieBanner = __esm({
   "src/components/CookieBanner.tsx"() {
     "use strict";
@@ -650,25 +879,54 @@ var init_CookieBanner = __esm({
     init_useConsent();
     init_DesignContext();
     init_Branding();
-    import_jsx_runtime4 = require("react/jsx-runtime");
+    init_logger();
+    import_jsx_runtime5 = require("react/jsx-runtime");
   }
 });
 
 // src/components/FloatingPreferencesButton.tsx
+function useThemeWithFallbacks() {
+  const theme = (0, import_styles3.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__ */ (0, import_jsx_runtime5.jsx)(import_CookieOutlined.default, {}),
+  icon = /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_CookieOutlined.default, {}),
   tooltip,
   FabProps,
   hideWhenConsented = false
 }) {
   const { openPreferences, consented } = useConsent();
-  const theme = (0, import_styles2.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",
@@ -687,7 +945,7 @@ function FloatingPreferencesButton({
         return { ...styles, bottom: offset, right: offset };
     }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_Tooltip.default, { title: tooltipText, placement: "top", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_Tooltip.default, { title: tooltipText, placement: "top", children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
     import_Fab.default,
     {
       size: "medium",
@@ -695,10 +953,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,
@@ -706,16 +965,17 @@ function FloatingPreferencesButton({
     }
   ) });
 }
-var import_CookieOutlined, import_Fab, import_Tooltip, import_styles2, import_jsx_runtime5;
+var import_CookieOutlined, import_Fab, import_Tooltip, import_styles3, import_jsx_runtime6;
 var init_FloatingPreferencesButton = __esm({
   "src/components/FloatingPreferencesButton.tsx"() {
     "use strict";
     import_CookieOutlined = __toESM(require("@mui/icons-material/CookieOutlined"), 1);
     import_Fab = __toESM(require("@mui/material/Fab"), 1);
     import_Tooltip = __toESM(require("@mui/material/Tooltip"), 1);
-    import_styles2 = require("@mui/material/styles");
+    import_styles3 = require("@mui/material/styles");
     init_useConsent();
-    import_jsx_runtime5 = require("react/jsx-runtime");
+    init_logger();
+    import_jsx_runtime6 = require("react/jsx-runtime");
   }
 });
 
@@ -734,10 +994,14 @@ function createFullConsentState(consented, preferences, source, projectConfig, i
   };
 }
 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",
@@ -745,10 +1009,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",
@@ -756,8 +1024,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: {
@@ -767,6 +1043,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,
@@ -833,24 +1110,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,
@@ -860,9 +1137,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) {
@@ -875,18 +1152,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 });
@@ -919,14 +1196,18 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie, finalCategoriesConfig, onPreferencesSaved]);
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_styles3.ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(DesignProvider, { tokens: designTokens, children: /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+  React5.useEffect(() => {
+    _registerGlobalOpenPreferences(api.openPreferences);
+    return () => _unregisterGlobalOpenPreferences();
+  }, [api.openPreferences]);
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(SafeThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DesignProvider, { tokens: designTokens, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
     CategoriesProvider,
     {
       config: finalCategoriesConfig,
       disableDeveloperGuidance,
       children: [
         children,
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(React4.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(React5.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           PreferencesModalComponent,
           {
             preferences: api.preferences,
@@ -936,8 +1217,8 @@ function ConsentProvider({
             texts,
             ...preferencesModalProps
           }
-        ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(PreferencesModal, { hideBranding }) }),
-        !state.consented && isHydrated && (CookieBannerComponent ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        ) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(PreferencesModal, { hideBranding }) }),
+        !state.consented && isHydrated && (CookieBannerComponent ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           CookieBannerComponent,
           {
             consented: api.consented,
@@ -947,54 +1228,67 @@ function ConsentProvider({
             texts,
             ...cookieBannerProps
           }
-        ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(CookieBanner, {})),
-        state.consented && !disableFloatingPreferencesButton && (FloatingPreferencesButtonComponent ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+        ) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CookieBanner, {})),
+        state.consented && !disableFloatingPreferencesButton && (FloatingPreferencesButtonComponent ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           FloatingPreferencesButtonComponent,
           {
             openPreferences: api.openPreferences,
             consented: api.consented,
             ...floatingPreferencesButtonProps
           }
-        ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FloatingPreferencesButton, {}))
+        ) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(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);
 }
-var React4, import_styles3, import_jsx_runtime6, PreferencesModal, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx;
+var React5, import_jsx_runtime7, log, PreferencesModal, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx;
 var init_ConsentContext = __esm({
   "src/context/ConsentContext.tsx"() {
     "use strict";
-    React4 = __toESM(require("react"), 1);
-    import_styles3 = require("@mui/material/styles");
+    React5 = __toESM(require("react"), 1);
+    init_SafeThemeProvider();
     init_cookieUtils();
     init_categoryUtils();
     init_theme();
     init_CategoriesContext();
     init_DesignContext();
     init_developerGuidance();
+    init_useConsent();
     init_CookieBanner();
     init_FloatingPreferencesButton();
-    import_jsx_runtime6 = require("react/jsx-runtime");
-    PreferencesModal = React4.lazy(
+    import_jsx_runtime7 = require("react/jsx-runtime");
+    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);
+        }
+      }
+    };
+    PreferencesModal = React5.lazy(
       () => Promise.resolve().then(() => (init_PreferencesModal(), PreferencesModal_exports)).then((m) => ({
         default: m.PreferencesModal
       }))
@@ -1010,7 +1304,15 @@ var init_ConsentContext = __esm({
       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,
@@ -1028,10 +1330,10 @@ var init_ConsentContext = __esm({
       transferCountries: void 0
       // Exibido se definido
     };
-    StateCtx = React4.createContext(null);
-    ActionsCtx = React4.createContext(null);
-    TextsCtx = React4.createContext(DEFAULT_TEXTS);
-    HydrationCtx = React4.createContext(false);
+    StateCtx = React5.createContext(null);
+    ActionsCtx = React5.createContext(null);
+    TextsCtx = React5.createContext(DEFAULT_TEXTS);
+    HydrationCtx = React5.createContext(false);
   }
 });
 
@@ -1058,10 +1360,31 @@ function useConsentTexts() {
 function useConsentHydration() {
   return useConsentHydrationInternal();
 }
+function useOpenPreferencesModal() {
+  const { openPreferences } = useConsent();
+  return openPreferences;
+}
+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;
+}
+var globalOpenPreferences;
 var init_useConsent = __esm({
   "src/hooks/useConsent.ts"() {
     "use strict";
     init_ConsentContext();
+    globalOpenPreferences = null;
   }
 });
 
@@ -1103,7 +1426,7 @@ function PreferencesModal2({
     setTempPreferences(preferences);
     closePreferences();
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
     import_Dialog.default,
     {
       "aria-labelledby": "cookie-pref-title",
@@ -1111,14 +1434,14 @@ function PreferencesModal2({
       onClose: handleCancel,
       ...DialogProps2,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_DialogTitle.default, { id: "cookie-pref-title", children: texts.modalTitle }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_DialogContent.default, { dividers: true, children: [
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Typography3.default, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_FormGroup.default, { children: [
-            toggleableCategories.map((category) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_DialogTitle.default, { id: "cookie-pref-title", children: texts.modalTitle }),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_DialogContent.default, { dividers: true, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_Typography3.default, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_FormGroup.default, { children: [
+            toggleableCategories.map((category) => /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
               import_FormControlLabel.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                control: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
                   import_Switch.default,
                   {
                     checked: tempPreferences[category.id] ?? false,
@@ -1132,25 +1455,25 @@ function PreferencesModal2({
               },
               category.id
             )),
-            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
               import_FormControlLabel.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Switch.default, { checked: true, disabled: true }),
+                control: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_Switch.default, { checked: true, disabled: true }),
                 label: texts.necessaryAlwaysOn
               }
             )
           ] })
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_DialogActions.default, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Button2.default, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
-          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Button2.default, { variant: "contained", onClick: handleSave, children: texts.save })
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_DialogActions.default, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_Button2.default, { variant: "outlined", onClick: handleCancel, children: texts.close }),
+          /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_Button2.default, { variant: "contained", onClick: handleSave, children: texts.save })
         ] }),
-        !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Branding, { variant: "modal" })
+        !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Branding, { variant: "modal" })
       ]
     }
   );
 }
-var import_Button2, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography3, import_react, import_jsx_runtime7;
+var import_Button2, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography3, import_react, import_jsx_runtime8;
 var init_PreferencesModal = __esm({
   "src/components/PreferencesModal.tsx"() {
     "use strict";
@@ -1167,7 +1490,7 @@ var init_PreferencesModal = __esm({
     init_CategoriesContext();
     init_useConsent();
     init_Branding();
-    import_jsx_runtime7 = require("react/jsx-runtime");
+    import_jsx_runtime8 = require("react/jsx-runtime");
   }
 });
 
@@ -1179,6 +1502,7 @@ __export(index_exports, {
   ConsentProvider: () => ConsentProvider,
   ConsentScriptLoader: () => ConsentScriptLoader,
   DEFAULT_PROJECT_CATEGORIES: () => DEFAULT_PROJECT_CATEGORIES,
+  LogLevel: () => LogLevel,
   PreferencesModal: () => PreferencesModal2,
   analyzeDeveloperConfiguration: () => analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration: () => createGoogleAnalyticsIntegration,
@@ -1186,12 +1510,15 @@ __export(index_exports, {
   createUserWayIntegration: () => createUserWayIntegration,
   defaultConsentTheme: () => defaultConsentTheme,
   loadScript: () => loadScript,
+  openPreferencesModal: () => openPreferencesModal,
+  setDebugLogging: () => setDebugLogging,
   useCategories: () => useCategories,
   useCategoryStatus: () => useCategoryStatus,
   useConsent: () => useConsent,
   useConsentHydration: () => useConsentHydration,
   useConsentScriptLoader: () => useConsentScriptLoader,
-  useConsentTexts: () => useConsentTexts
+  useConsentTexts: () => useConsentTexts,
+  useOpenPreferencesModal: () => useOpenPreferencesModal
 });
 module.exports = __toCommonJS(index_exports);
 init_PreferencesModal();
@@ -1201,11 +1528,11 @@ init_CategoriesContext();
 
 // src/utils/ConsentGate.tsx
 init_useConsent();
-var import_jsx_runtime8 = require("react/jsx-runtime");
+var import_jsx_runtime9 = require("react/jsx-runtime");
 function ConsentGate(props) {
   const { preferences } = useConsent();
   if (!preferences[props.category]) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_jsx_runtime8.Fragment, { children: props.children });
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_jsx_runtime9.Fragment, { children: props.children });
 }
 
 // src/utils/scriptLoader.ts
@@ -1249,15 +1576,15 @@ function loadScript(id, src, category = null, attrs = {}) {
 init_theme();
 
 // src/utils/ConsentScriptLoader.tsx
-var React5 = __toESM(require("react"), 1);
+var React6 = __toESM(require("react"), 1);
 init_useConsent();
 function ConsentScriptLoader({
   integrations,
   reloadOnChange = false
 }) {
   const { preferences, consented } = useConsent();
-  const loadedScripts = React5.useRef(/* @__PURE__ */ new Set());
-  React5.useEffect(() => {
+  const loadedScripts = React6.useRef(/* @__PURE__ */ new Set());
+  React6.useEffect(() => {
     if (!consented) return;
     integrations.forEach(async (integration) => {
       const shouldLoad = preferences[integration.category];
@@ -1285,7 +1612,7 @@ function ConsentScriptLoader({
 }
 function useConsentScriptLoader() {
   const { preferences, consented } = useConsent();
-  return React5.useCallback(
+  return React6.useCallback(
     async (integration) => {
       if (!consented) {
         console.warn(
@@ -1382,6 +1709,7 @@ var COMMON_INTEGRATIONS = {
 
 // src/index.ts
 init_developerGuidance();
+init_logger();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMON_INTEGRATIONS,
@@ -1389,6 +1717,7 @@ init_developerGuidance();
   ConsentProvider,
   ConsentScriptLoader,
   DEFAULT_PROJECT_CATEGORIES,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
@@ -1396,10 +1725,13 @@ init_developerGuidance();
   createUserWayIntegration,
   defaultConsentTheme,
   loadScript,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,
-  useConsentTexts
+  useConsentTexts,
+  useOpenPreferencesModal
 });