react-lgpd-consent 0.3.0 → 0.3.2

package/dist/index.cjs

@@ -50,7 +50,6 @@ function analyzeDeveloperConfiguration(config) {
     description: "Essenciais para funcionamento b\xE1sico do site",
     essential: true,
     uiRequired: false
-    // Não precisa de toggle (sempre ativo)
   });
   const enabledCategories = finalConfig.enabledCategories || [];
   const categoryNames = {
@@ -84,13 +83,10 @@ function analyzeDeveloperConfiguration(config) {
         description: categoryInfo.description,
         essential: false,
         uiRequired: true
-        // Precisa de toggle na UI
       });
     }
   });
-  const totalToggleable = guidance.activeCategoriesInfo.filter(
-    (c) => c.uiRequired
-  ).length;
+  const totalToggleable = guidance.activeCategoriesInfo.filter((c) => c.uiRequired).length;
   if (totalToggleable === 0) {
     guidance.suggestions.push(
       'Apenas cookies necess\xE1rios est\xE3o configurados. Para compliance completo LGPD, considere adicionar categorias como "analytics" ou "functional" conforme uso real.'
@@ -98,78 +94,66 @@ function analyzeDeveloperConfiguration(config) {
   }
   if (totalToggleable > 5) {
     guidance.warnings.push(
-      `${totalToggleable} categorias opcionais detectadas. UI com muitas op\xE7\xF5es pode ' +
-      'prejudicar experi\xEAncia do usu\xE1rio. Considere agrupar categorias similares.`
+      `${totalToggleable} categorias opcionais detectadas. UI com muitas op\xE7\xF5es pode prejudicar experi\xEAncia do usu\xE1rio. Considere agrupar categorias similares.`
     );
   }
   return guidance;
 }
 function logDeveloperGuidance(guidance, disableGuidanceProp) {
-  if (disableGuidanceProp) {
-    return;
-  }
-  const isProduction = (
-    // 1. NODE_ENV de bundlers (Vite, webpack, etc.)
-    typeof globalThis.process !== "undefined" && globalThis.process.env?.NODE_ENV === "production" || // 2. Flag customizada para desabilitar logs
-    typeof globalThis !== "undefined" && globalThis.__LGPD_PRODUCTION__ === true || // 3. Flag de desenvolvimento desabilitada via window global (legado)
-    typeof window !== "undefined" && window.__LGPD_DISABLE_GUIDANCE__ === true
-  );
-  if (isProduction) return;
+  const nodeEnv = typeof globalThis.process !== "undefined" ? globalThis.process.env?.NODE_ENV : void 0;
+  const isProd = nodeEnv === "production" || globalThis.__LGPD_PRODUCTION__ === true && typeof globalThis !== "undefined";
+  const isDisabled = !!disableGuidanceProp || globalThis.__LGPD_DISABLE_GUIDANCE__ === true && typeof globalThis !== "undefined";
+  if (isProd || isDisabled) return;
   const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
   if (guidance.warnings.length > 0) {
     console.group(`${PREFIX} \u26A0\uFE0F  Avisos de Configura\xE7\xE3o`);
-    guidance.warnings.forEach((warning) => console.warn(`${PREFIX} ${warning}`));
+    guidance.warnings.forEach((msg) => console.warn(`${PREFIX} ${msg}`));
     console.groupEnd();
   }
   if (guidance.suggestions.length > 0) {
     console.group(`${PREFIX} \u{1F4A1} Sugest\xF5es`);
-    guidance.suggestions.forEach(
-      (suggestion) => console.info(`${PREFIX} ${suggestion}`)
-    );
+    guidance.suggestions.forEach((msg) => console.info(`${PREFIX} ${msg}`));
     console.groupEnd();
   }
   if (guidance.usingDefaults) {
     console.warn(
-      // Changed from console.info to console.warn
       `${PREFIX} \u{1F4CB} Usando configura\xE7\xE3o padr\xE3o. Para personalizar, use a prop "categories" no ConsentProvider.`
     );
   }
-  console.group(`${PREFIX} \u{1F527} Categorias Ativas (para UI customizada)`);
-  console.table(
-    guidance.activeCategoriesInfo.map((cat) => ({
-      ID: cat.id,
-      Nome: cat.name,
-      "Toggle UI?": cat.uiRequired ? "\u2705 SIM" : "\u274C N\xC3O (sempre ativo)",
-      "Essencial?": cat.essential ? "\u{1F512} SIM" : "\u2699\uFE0F N\xC3O"
-    }))
-  );
-  console.info(
-    `${PREFIX} \u2139\uFE0F  Use estes dados para criar componentes customizados adequados.`
-  );
-  console.groupEnd();
+  const rows = guidance.activeCategoriesInfo.map((cat) => ({
+    ID: cat.id,
+    Nome: cat.name,
+    "Toggle UI?": cat.uiRequired ? "\u2705 SIM" : "\u274C N\xC3O (sempre ativo)",
+    "Essencial?": cat.essential ? "\u{1F512} SIM" : "\u2699\uFE0F N\xC3O"
+  }));
+  if (typeof console.table === "function") {
+    console.group(`${PREFIX} \u{1F527} Categorias Ativas (para UI customizada)`);
+    console.table(rows);
+    console.info(`${PREFIX} \u2139\uFE0F  Use estes dados para criar componentes customizados adequados.`);
+    console.groupEnd();
+  } else {
+    console.log(`${PREFIX} \u{1F527} Categorias Ativas (para UI customizada)`, rows);
+    console.info(`${PREFIX} \u2139\uFE0F  Use estes dados para criar componentes customizados adequados.`);
+  }
 }
 function useDeveloperGuidance(config, disableGuidanceProp) {
-  const guidance = analyzeDeveloperConfiguration(config);
-  const stringifiedConfig = React.useMemo(
-    () => JSON.stringify(config),
-    [config]
-  );
-  React.useEffect(() => {
-    if (disableGuidanceProp === true) {
-      return;
+  const guidance = import_react.default.useMemo(() => {
+    return analyzeDeveloperConfiguration(config);
+  }, [config]);
+  import_react.default.useEffect(() => {
+    if (!disableGuidanceProp) {
+      logDeveloperGuidance(guidance, disableGuidanceProp);
     }
-    logDeveloperGuidance(guidance, disableGuidanceProp);
-  }, [guidance, stringifiedConfig, disableGuidanceProp]);
+  }, [guidance, disableGuidanceProp]);
   return guidance;
 }
-var React, DEFAULT_PROJECT_CATEGORIES;
+var import_react, DEFAULT_PROJECT_CATEGORIES;
 var init_developerGuidance = __esm({
   "src/utils/developerGuidance.ts"() {
     "use strict";
-    React = __toESM(require("react"), 1);
+    import_react = __toESM(require("react"), 1);
     DEFAULT_PROJECT_CATEGORIES = {
       enabledCategories: ["analytics"]
-      // Só analytics além de necessary
     };
   }
 });
@@ -178,15 +162,12 @@ var init_developerGuidance = __esm({
 function CategoriesProvider({
   children,
   config,
-  // NOVO: configuração completa
   disableDeveloperGuidance
 }) {
   const contextValue = React2.useMemo(() => {
     const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
     const guidance = analyzeDeveloperConfiguration(config);
-    const toggleableCategories = guidance.activeCategoriesInfo.filter(
-      (cat) => cat.uiRequired
-    );
+    const toggleableCategories = guidance.activeCategoriesInfo.filter((cat) => cat.uiRequired);
     return {
       config: finalConfig,
       guidance,
@@ -226,30 +207,297 @@ var init_CategoriesContext = __esm({
     React2 = __toESM(require("react"), 1);
     init_developerGuidance();
     import_jsx_runtime = require("react/jsx-runtime");
-    CategoriesContext = React2.createContext(
-      null
-    );
+    CategoriesContext = React2.createContext(null);
+  }
+});
+
+// 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 LogLevel, _ConsentLogger, ConsentLogger, logger;
+var init_logger = __esm({
+  "src/utils/logger.ts"() {
+    "use strict";
+    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 _ConsentLogger {
+      constructor() {
+        this.enabled = _ConsentLogger.IS_DEVELOPMENT;
+        this.level = 2 /* INFO */;
+      }
+      /**
+       * Habilita ou desabilita o sistema de logging.
+       * @param {boolean} enabled Se `true`, os logs serão exibidos; caso contrário, serão suprimidos.
+       */
+      setEnabled(enabled) {
+        this.enabled = enabled;
+      }
+      /**
+       * Define o nível mínimo de severidade para os logs.
+       * Mensagens com severidade menor que o nível definido não serão exibidas.
+       * @param {LogLevel} level O nível mínimo de severidade (ex: `LogLevel.DEBUG` para ver todos os logs).
+       */
+      setLevel(level) {
+        this.level = level;
+      }
+      /**
+       * Registra uma mensagem de erro.
+       * @param {...any[]} args Os argumentos a serem logados.
+       */
+      error(...args) {
+        if (this.enabled && this.level >= 0 /* ERROR */) {
+          console.error(_ConsentLogger.LOG_PREFIX, "[ERROR]", ...args);
+        }
+      }
+      /**
+       * Registra uma mensagem de aviso.
+       * @param {...any[]} args Os argumentos a serem logados.
+       */
+      warn(...args) {
+        if (this.enabled && this.level >= 1 /* WARN */) {
+          console.warn(_ConsentLogger.LOG_PREFIX, "[WARN]", ...args);
+        }
+      }
+      /**
+       * Registra uma mensagem informativa.
+       * @param {...any[]} args Os argumentos a serem logados.
+       */
+      info(...args) {
+        if (this.enabled && this.level >= 2 /* INFO */) {
+          console.info(_ConsentLogger.LOG_PREFIX, "[INFO]", ...args);
+        }
+      }
+      /**
+       * Registra uma mensagem de depuração.
+       * @param {...any[]} args Os argumentos a serem logados.
+       */
+      debug(...args) {
+        if (this.enabled && this.level >= 3 /* DEBUG */) {
+          console.debug(_ConsentLogger.LOG_PREFIX, "[DEBUG]", ...args);
+        }
+      }
+      /**
+       * Inicia um grupo de logs no console.
+       * @param {...any[]} args Os argumentos para o título do grupo.
+       */
+      group(...args) {
+        if (this.enabled && this.level >= 3 /* DEBUG */) {
+          console.group(_ConsentLogger.LOG_PREFIX, ...args);
+        }
+      }
+      /**
+       * Finaliza o grupo de logs mais recente no console.
+       */
+      groupEnd() {
+        if (this.enabled && this.level >= 3 /* DEBUG */) {
+          console.groupEnd();
+        }
+      }
+      /**
+       * Exibe dados tabulares no console.
+       * @param {any} tabularData Os dados a serem exibidos na tabela.
+       * @param {string[]} [properties] Um array opcional de propriedades para exibir.
+       */
+      table(tabularData, properties) {
+        if (this.enabled && this.level >= 3 /* DEBUG */) {
+          console.table(tabularData, properties);
+        }
+      }
+      /**
+       * Registra informações sobre a compatibilidade do tema Material-UI.
+       * @param {any} themeInfo Objeto com informações do tema.
+       */
+      themeCompatibility(themeInfo) {
+        this.debug("Theme compatibility check:", {
+          hasTheme: !!themeInfo,
+          hasPalette: !!themeInfo?.palette,
+          hasPrimary: !!themeInfo?.palette?.primary,
+          hasTransitions: !!themeInfo?.transitions,
+          hasDuration: !!themeInfo?.transitions?.duration
+        });
+      }
+      /**
+       * Registra mudanças no estado de consentimento.
+       * @param {string} action A ação que causou a mudança de estado.
+       * @param {any} state O estado atual do consentimento.
+       */
+      consentState(action, state) {
+        this.debug(`Consent state change [${action}]:`, {
+          consented: state.consented,
+          isModalOpen: state.isModalOpen,
+          preferencesCount: Object.keys(state.preferences || {}).length
+        });
+      }
+      /**
+       * Registra operações de cookie (leitura, escrita, remoção).
+       * @param {'read' | 'write' | 'delete'} operation O tipo de operação de cookie.
+       * @param {string} cookieName O nome do cookie.
+       * @param {any} [data] Os dados do cookie, se aplicável.
+       */
+      cookieOperation(operation, cookieName, data) {
+        this.debug(`Cookie ${operation}:`, {
+          name: cookieName,
+          hasData: !!data,
+          dataSize: data ? JSON.stringify(data).length : 0
+        });
+      }
+      /**
+       * Registra a renderização de um componente.
+       * @param {string} componentName O nome do componente.
+       * @param {any} [props] As propriedades do componente.
+       */
+      componentRender(componentName, props) {
+        this.debug(`Component render [${componentName}]:`, {
+          hasProps: !!props,
+          propsKeys: props ? Object.keys(props) : []
+        });
+      }
+      /**
+       * Registra o status de carregamento de scripts de integração.
+       * @param {string} scriptName O nome do script.
+       * @param {'load' | 'remove'} action A ação realizada (carregar ou remover).
+       * @param {boolean} success Se a operação foi bem-sucedida.
+       */
+      scriptIntegration(scriptName, action, success) {
+        this.info(`Script ${action} [${scriptName}]:`, success ? "SUCCESS" : "FAILED");
+      }
+      /**
+       * Registra chamadas à API interna da biblioteca.
+       * @param {string} method O nome do método da API chamado.
+       * @param {any} [params] Os parâmetros passados para o método.
+       */
+      apiUsage(method, params) {
+        this.debug(`API call [${method}]:`, params);
+      }
+    };
+    _ConsentLogger.IS_DEVELOPMENT = typeof globalThis !== "undefined" && globalThis.process?.env?.NODE_ENV === "development";
+    _ConsentLogger.LOG_PREFIX = "[react-lgpd-consent]";
+    ConsentLogger = _ConsentLogger;
+    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;
   }
 }
@@ -261,19 +509,19 @@ function migrateLegacyCookie(legacyData) {
       consented: legacyData.consented || false,
       preferences: legacyData.preferences || { necessary: true },
       consentDate: now,
-      // Não temos o original, usar data atual
       lastUpdate: now,
       source: "banner",
-      // Assumir origem banner
       isModalOpen: false
-      // Nunca persistir estado de UI
     };
   } catch {
     return null;
   }
 }
 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 = {
@@ -281,29 +529,39 @@ function writeConsentCookie(state, config, opts, source = "banner") {
     consented: state.consented,
     preferences: state.preferences,
     consentDate: state.consentDate || now,
-    // Preservar data original ou usar atual
     lastUpdate: now,
     source,
     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,
@@ -342,6 +600,64 @@ function validateProjectPreferences(preferences, config) {
   });
   return validPreferences;
 }
+function getAllProjectCategories(config) {
+  const allCategories = [
+    {
+      id: "necessary",
+      name: "Necess\xE1rios",
+      description: "Cookies essenciais para funcionamento b\xE1sico do site",
+      essential: true
+    }
+  ];
+  const enabledCategories = config?.enabledCategories || [];
+  enabledCategories.forEach((category) => {
+    if (category !== "necessary") {
+      allCategories.push(getDefaultCategoryDefinition(category));
+    }
+  });
+  return allCategories;
+}
+function getDefaultCategoryDefinition(category) {
+  const definitions = {
+    necessary: {
+      id: "necessary",
+      name: "Necess\xE1rios",
+      description: "Cookies essenciais para funcionamento b\xE1sico do site",
+      essential: true
+    },
+    analytics: {
+      id: "analytics",
+      name: "An\xE1lise e Estat\xEDsticas",
+      description: "Cookies para an\xE1lise de uso e estat\xEDsticas do site",
+      essential: false
+    },
+    functional: {
+      id: "functional",
+      name: "Funcionalidades",
+      description: "Cookies para funcionalidades extras como prefer\xEAncias e idioma",
+      essential: false
+    },
+    marketing: {
+      id: "marketing",
+      name: "Marketing e Publicidade",
+      description: "Cookies para publicidade direcionada e marketing",
+      essential: false
+    },
+    social: {
+      id: "social",
+      name: "Redes Sociais",
+      description: "Cookies para integra\xE7\xE3o com redes sociais e compartilhamento",
+      essential: false
+    },
+    personalization: {
+      id: "personalization",
+      name: "Personaliza\xE7\xE3o",
+      description: "Cookies para personaliza\xE7\xE3o de conte\xFAdo e experi\xEAncia",
+      essential: false
+    }
+  };
+  return definitions[category];
+}
 var init_categoryUtils = __esm({
   "src/utils/categoryUtils.ts"() {
     "use strict";
@@ -349,12 +665,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 +743,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 +771,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 +790,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 +841,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,67 +858,61 @@ 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)(
-      import_Typography2.default,
-      {
-        variant: "body2",
-        sx: { fontSize: designTokens?.typography?.fontSize?.banner },
-        children: [
-          texts.bannerMessage,
-          " ",
-          policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            import_Link2.default,
-            {
-              href: policyLinkUrl,
-              underline: "hover",
-              target: "_blank",
-              rel: "noopener noreferrer",
-              sx: { color: designTokens?.colors?.primary },
-              children: texts.policyLink ?? "Saiba mais"
-            }
-          )
-        ]
-      }
-    ),
-    /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
-      import_Stack.default,
-      {
-        direction: { xs: "column", sm: "row" },
-        spacing: 1,
-        justifyContent: "flex-end",
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            import_Button.default,
-            {
-              variant: "outlined",
-              onClick: rejectAll,
-              sx: { color: designTokens?.colors?.secondary },
-              children: texts.declineAll
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            import_Button.default,
-            {
-              variant: "contained",
-              onClick: acceptAll,
-              sx: { backgroundColor: designTokens?.colors?.primary },
-              children: texts.acceptAll
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
-            import_Button.default,
-            {
-              variant: "text",
-              onClick: openPreferences,
-              sx: { color: designTokens?.colors?.text },
-              children: texts.preferences
-            }
-          )
-        ]
-      }
-    ),
-    !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Branding, { variant: "banner" })
+  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", sx: { fontSize: designTokens?.typography?.fontSize?.banner }, children: [
+      texts.bannerMessage,
+      " ",
+      policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        import_Link2.default,
+        {
+          href: policyLinkUrl,
+          underline: "hover",
+          target: "_blank",
+          rel: "noopener noreferrer",
+          sx: { color: designTokens?.colors?.primary },
+          children: texts.policyLink ?? "Saiba mais"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_Stack.default, { direction: { xs: "column", sm: "row" }, spacing: 1, justifyContent: "flex-end", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        import_Button.default,
+        {
+          variant: "outlined",
+          onClick: () => {
+            logger.apiUsage("rejectAll", { source: "banner" });
+            rejectAll();
+          },
+          sx: { color: designTokens?.colors?.secondary },
+          children: texts.declineAll
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        import_Button.default,
+        {
+          variant: "contained",
+          onClick: () => {
+            logger.apiUsage("acceptAll", { source: "banner" });
+            acceptAll();
+          },
+          sx: { backgroundColor: designTokens?.colors?.primary },
+          children: texts.acceptAll
+        }
+      ),
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        import_Button.default,
+        {
+          variant: "text",
+          onClick: () => {
+            logger.apiUsage("openPreferences", { source: "banner" });
+            openPreferences();
+          },
+          sx: { color: designTokens?.colors?.text },
+          children: texts.preferences
+        }
+      )
+    ] }),
+    !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Branding, { variant: "banner" })
   ] }) });
   const positionStyle = {
     position: "fixed",
@@ -605,8 +924,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 +939,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 +955,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 +969,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 +1035,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 +1043,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 +1055,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,30 +1084,29 @@ function createFullConsentState(consented, preferences, source, projectConfig, i
   };
 }
 function reducer(state, action) {
+  logger.consentState(action.type, state);
   switch (action.type) {
     case "ACCEPT_ALL": {
       const prefs = createProjectPreferences(action.config, true);
-      return createFullConsentState(
-        true,
-        prefs,
-        "banner",
-        action.config,
-        false,
-        state
-      );
+      const newState = createFullConsentState(true, prefs, "banner", action.config, false, state);
+      logger.info("User accepted all cookies", {
+        preferences: newState.preferences
+      });
+      return newState;
     }
     case "REJECT_ALL": {
       const prefs = createProjectPreferences(action.config, false);
-      return createFullConsentState(
-        true,
-        prefs,
-        "banner",
-        action.config,
-        false,
-        state
-      );
+      const newState = createFullConsentState(true, prefs, "banner", action.config, false, state);
+      logger.info("User rejected all cookies", {
+        preferences: newState.preferences
+      });
+      return newState;
     }
     case "SET_CATEGORY":
+      logger.debug("Category preference changed", {
+        category: action.category,
+        value: action.value
+      });
       return {
         ...state,
         preferences: {
@@ -767,25 +1116,12 @@ function reducer(state, action) {
         lastUpdate: (/* @__PURE__ */ new Date()).toISOString()
       };
     case "SET_PREFERENCES":
-      return createFullConsentState(
-        true,
-        action.preferences,
-        "modal",
-        action.config,
-        false,
-        state
-      );
+      logger.info("Preferences saved", { preferences: action.preferences });
+      return createFullConsentState(true, action.preferences, "modal", action.config, false, state);
     case "OPEN_MODAL":
       return { ...state, isModalOpen: true };
     case "CLOSE_MODAL":
-      return createFullConsentState(
-        true,
-        state.preferences,
-        "modal",
-        action.config,
-        false,
-        state
-      );
+      return createFullConsentState(true, state.preferences, "modal", action.config, false, state);
     case "RESET": {
       return createFullConsentState(
         false,
@@ -813,12 +1149,9 @@ function reducer(state, action) {
 function ConsentProvider({
   initialState,
   categories,
-  // Nova prop para configuração de categorias
   texts: textsProp,
   theme,
   designTokens,
-  scriptIntegrations,
-  // eslint-disable-line no-unused-vars
   PreferencesModalComponent,
   preferencesModalProps = {},
   CookieBannerComponent,
@@ -833,24 +1166,18 @@ function ConsentProvider({
   disableDeveloperGuidance,
   children
 }) {
-  const texts = React4.useMemo(
-    () => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }),
-    [textsProp]
-  );
-  const cookie = React4.useMemo(
+  const texts = React5.useMemo(() => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }), [textsProp]);
+  const cookie = React5.useMemo(
     () => ({ ...DEFAULT_COOKIE_OPTS, ...cookieOpts ?? {} }),
     [cookieOpts]
   );
-  const appliedTheme = React4.useMemo(
-    () => theme || defaultConsentTheme,
-    [theme]
-  );
-  const finalCategoriesConfig = React4.useMemo(() => {
+  const appliedTheme = React5.useMemo(() => theme || defaultConsentTheme, [theme]);
+  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 +1187,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 +1202,17 @@ function ConsentProvider({
     }
     setIsHydrated(true);
   }, [cookie.name, initialState, finalCategoriesConfig]);
-  React4.useEffect(() => {
-    if (state.consented)
-      writeConsentCookie(state, finalCategoriesConfig, cookie);
+  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 +1245,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 +1266,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 +1277,54 @@ 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);
-  if (!ctx)
-    throw new Error("useConsentState must be used within ConsentProvider");
+  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);
-  if (!ctx)
-    throw new Error("useConsentActions must be used within ConsentProvider");
+  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, PreferencesModal, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx, defaultTexts;
 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_logger();
     init_CookieBanner();
     init_FloatingPreferencesButton();
-    import_jsx_runtime6 = require("react/jsx-runtime");
-    PreferencesModal = React4.lazy(
+    import_jsx_runtime7 = require("react/jsx-runtime");
+    PreferencesModal = React5.lazy(
       () => Promise.resolve().then(() => (init_PreferencesModal(), PreferencesModal_exports)).then((m) => ({
         default: m.PreferencesModal
       }))
@@ -1010,7 +1340,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 +1366,11 @@ 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);
+    defaultTexts = DEFAULT_TEXTS;
   }
 });
 
@@ -1058,10 +1397,32 @@ function useConsentTexts() {
 function useConsentHydration() {
   return useConsentHydrationInternal();
 }
+function useOpenPreferencesModal() {
+  const { openPreferences } = useConsent();
+  return openPreferences;
+}
+function openPreferencesModal() {
+  if (globalOpenPreferences) {
+    globalOpenPreferences();
+  } else {
+    logger.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();
+    init_logger();
+    globalOpenPreferences = null;
   }
 });
 
@@ -1077,16 +1438,14 @@ function PreferencesModal2({
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
   const { toggleableCategories } = useCategories();
-  const [tempPreferences, setTempPreferences] = (0, import_react.useState)(
-    () => {
-      const initialPrefs = { necessary: true };
-      toggleableCategories.forEach((category) => {
-        initialPrefs[category.id] = preferences[category.id] ?? false;
-      });
-      return initialPrefs;
-    }
-  );
-  (0, import_react.useEffect)(() => {
+  const [tempPreferences, setTempPreferences] = (0, import_react2.useState)(() => {
+    const initialPrefs = { necessary: true };
+    toggleableCategories.forEach((category) => {
+      initialPrefs[category.id] = preferences[category.id] ?? false;
+    });
+    return initialPrefs;
+  });
+  (0, import_react2.useEffect)(() => {
     if (isModalOpen) {
       const syncedPrefs = { necessary: true };
       toggleableCategories.forEach((category) => {
@@ -1103,54 +1462,39 @@ function PreferencesModal2({
     setTempPreferences(preferences);
     closePreferences();
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
-    import_Dialog.default,
-    {
-      "aria-labelledby": "cookie-pref-title",
-      open,
-      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)(
-              import_FormControlLabel.default,
-              {
-                control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-                  import_Switch.default,
-                  {
-                    checked: tempPreferences[category.id] ?? false,
-                    onChange: (e) => setTempPreferences((prev) => ({
-                      ...prev,
-                      [category.id]: e.target.checked
-                    }))
-                  }
-                ),
-                label: `${category.name} - ${category.description}`
-              },
-              category.id
-            )),
-            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-              import_FormControlLabel.default,
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_Dialog.default, { "aria-labelledby": "cookie-pref-title", open, onClose: handleCancel, ...DialogProps2, children: [
+    /* @__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_runtime8.jsx)(
+              import_Switch.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Switch.default, { checked: true, disabled: true }),
-                label: texts.necessaryAlwaysOn
+                checked: tempPreferences[category.id] ?? false,
+                onChange: (e) => setTempPreferences((prev) => ({
+                  ...prev,
+                  [category.id]: e.target.checked
+                }))
               }
-            )
-          ] })
-        ] }),
-        /* @__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 })
-        ] }),
-        !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Branding, { variant: "modal" })
-      ]
-    }
-  );
+            ),
+            label: `${category.name} - ${category.description}`
+          },
+          category.id
+        )),
+        /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_FormControlLabel.default, { control: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_Switch.default, { checked: true, disabled: true }), label: texts.necessaryAlwaysOn })
+      ] })
+    ] }),
+    /* @__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_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_react2, import_jsx_runtime8;
 var init_PreferencesModal = __esm({
   "src/components/PreferencesModal.tsx"() {
     "use strict";
@@ -1163,11 +1507,11 @@ var init_PreferencesModal = __esm({
     import_FormGroup = __toESM(require("@mui/material/FormGroup"), 1);
     import_Switch = __toESM(require("@mui/material/Switch"), 1);
     import_Typography3 = __toESM(require("@mui/material/Typography"), 1);
-    import_react = require("react");
+    import_react2 = require("react");
     init_CategoriesContext();
     init_useConsent();
     init_Branding();
-    import_jsx_runtime7 = require("react/jsx-runtime");
+    import_jsx_runtime8 = require("react/jsx-runtime");
   }
 });
 
@@ -1178,20 +1522,30 @@ __export(index_exports, {
   ConsentGate: () => ConsentGate,
   ConsentProvider: () => ConsentProvider,
   ConsentScriptLoader: () => ConsentScriptLoader,
+  CookieBanner: () => CookieBanner,
   DEFAULT_PROJECT_CATEGORIES: () => DEFAULT_PROJECT_CATEGORIES,
+  FloatingPreferencesButton: () => FloatingPreferencesButton,
+  LogLevel: () => LogLevel,
   PreferencesModal: () => PreferencesModal2,
   analyzeDeveloperConfiguration: () => analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration: () => createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration: () => createGoogleTagManagerIntegration,
+  createProjectPreferences: () => createProjectPreferences,
   createUserWayIntegration: () => createUserWayIntegration,
   defaultConsentTheme: () => defaultConsentTheme,
+  defaultTexts: () => defaultTexts,
+  getAllProjectCategories: () => getAllProjectCategories,
   loadScript: () => loadScript,
+  openPreferencesModal: () => openPreferencesModal,
+  setDebugLogging: () => setDebugLogging,
   useCategories: () => useCategories,
   useCategoryStatus: () => useCategoryStatus,
   useConsent: () => useConsent,
   useConsentHydration: () => useConsentHydration,
   useConsentScriptLoader: () => useConsentScriptLoader,
-  useConsentTexts: () => useConsentTexts
+  useConsentTexts: () => useConsentTexts,
+  useOpenPreferencesModal: () => useOpenPreferencesModal,
+  validateProjectPreferences: () => validateProjectPreferences
 });
 module.exports = __toCommonJS(index_exports);
 init_PreferencesModal();
@@ -1201,11 +1555,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 +1603,16 @@ 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();
+init_logger();
 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];
@@ -1276,7 +1631,7 @@ function ConsentScriptLoader({
           }
           loadedScripts.current.add(integration.id);
         } catch (error) {
-          console.error(`\u274C Failed to load script: ${integration.id}`, error);
+          logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         }
       }
     });
@@ -1285,17 +1640,15 @@ function ConsentScriptLoader({
 }
 function useConsentScriptLoader() {
   const { preferences, consented } = useConsent();
-  return React5.useCallback(
+  return React6.useCallback(
     async (integration) => {
       if (!consented) {
-        console.warn(
-          `\u26A0\uFE0F Cannot load script ${integration.id}: No consent given`
-        );
+        logger.warn(`\u26A0\uFE0F Cannot load script ${integration.id}: No consent given`);
         return false;
       }
       const shouldLoad = preferences[integration.category];
       if (!shouldLoad) {
-        console.warn(
+        logger.warn(
           `\u26A0\uFE0F Cannot load script ${integration.id}: Category '${integration.category}' not consented`
         );
         return false;
@@ -1313,7 +1666,7 @@ function useConsentScriptLoader() {
         }
         return true;
       } catch (error) {
-        console.error(`\u274C Failed to load script: ${integration.id}`, error);
+        logger.error(`\u274C Failed to load script: ${integration.id}`, error);
         return false;
       }
     },
@@ -1363,8 +1716,7 @@ function createUserWayIntegration(config) {
   return {
     id: "userway",
     category: "functional",
-    // Categoria mais apropriada para acessibilidade
-    src: `https://cdn.userway.org/widget.js`,
+    src: "https://cdn.userway.org/widget.js",
     init: () => {
       if (typeof window !== "undefined") {
         window.UserWayWidgetApp = window.UserWayWidgetApp || {};
@@ -1382,24 +1734,39 @@ var COMMON_INTEGRATIONS = {
 
 // src/index.ts
 init_developerGuidance();
+init_logger();
+init_CookieBanner();
+init_FloatingPreferencesButton();
+init_ConsentContext();
+init_categoryUtils();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMON_INTEGRATIONS,
   ConsentGate,
   ConsentProvider,
   ConsentScriptLoader,
+  CookieBanner,
   DEFAULT_PROJECT_CATEGORIES,
+  FloatingPreferencesButton,
+  LogLevel,
   PreferencesModal,
   analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
+  createProjectPreferences,
   createUserWayIntegration,
   defaultConsentTheme,
+  defaultTexts,
+  getAllProjectCategories,
   loadScript,
+  openPreferencesModal,
+  setDebugLogging,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,
-  useConsentTexts
+  useConsentTexts,
+  useOpenPreferencesModal,
+  validateProjectPreferences
 });