react-lgpd-consent 0.3.7 → 0.4.1

package/dist/index.cjs

@@ -30,185 +30,266 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/utils/developerGuidance.ts
-function analyzeDeveloperConfiguration(config) {
-  const guidance = {
-    warnings: [],
-    suggestions: [],
-    activeCategoriesInfo: [],
-    usingDefaults: !config
-  };
-  const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
-  if (!config) {
-    guidance.warnings.push(
-      'LGPD-CONSENT: Nenhuma configura\xE7\xE3o de categorias especificada. Usando padr\xE3o: necessary + analytics. Para produ\xE7\xE3o, recomenda-se especificar explicitamente as categorias via prop "categories".'
-    );
-  }
-  guidance.activeCategoriesInfo.push({
-    id: "necessary",
-    name: "Cookies Necess\xE1rios",
-    description: "Essenciais para funcionamento b\xE1sico do site",
-    essential: true,
-    uiRequired: false
-  });
-  const enabledCategories = finalConfig.enabledCategories || [];
-  const categoryNames = {
-    analytics: {
-      name: "Cookies Anal\xEDticos",
-      description: "Medem uso e performance do site"
-    },
-    functional: {
-      name: "Cookies Funcionais",
-      description: "Melhoram experi\xEAncia e funcionalidades"
-    },
-    marketing: {
-      name: "Cookies de Marketing",
-      description: "Publicidade direcionada e campanhas"
-    },
-    social: {
-      name: "Cookies de Redes Sociais",
-      description: "Integra\xE7\xE3o com plataformas sociais"
-    },
-    personalization: {
-      name: "Cookies de Personaliza\xE7\xE3o",
-      description: "Adaptam conte\xFAdo \xE0s prefer\xEAncias do usu\xE1rio"
+// src/utils/cookieRegistry.ts
+function setCookieCatalogOverrides(overrides) {
+  COOKIE_CATALOG_OVERRIDES = {
+    byCategory: { ...COOKIE_CATALOG_OVERRIDES.byCategory || {}, ...overrides.byCategory || {} },
+    byIntegration: {
+      ...COOKIE_CATALOG_OVERRIDES.byIntegration || {},
+      ...overrides.byIntegration || {}
     }
   };
-  enabledCategories.forEach((categoryId) => {
-    const categoryInfo = categoryNames[categoryId];
-    if (categoryInfo) {
-      guidance.activeCategoriesInfo.push({
-        id: categoryId,
-        name: categoryInfo.name,
-        description: categoryInfo.description,
-        essential: false,
-        uiRequired: true
-      });
-    }
-  });
-  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.'
-    );
-  }
-  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.`
-    );
-  }
-  return guidance;
 }
-function logDeveloperGuidance(guidance, disableGuidanceProp) {
-  const gt = globalThis;
-  const nodeEnv = typeof gt.process !== "undefined" ? gt.process?.env?.NODE_ENV : void 0;
-  const isProd = nodeEnv === "production" || gt.__LGPD_PRODUCTION__ === true;
-  const isDisabled = !!disableGuidanceProp || gt.__LGPD_DISABLE_GUIDANCE__ === true;
-  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((msg) => console.warn(`${PREFIX} ${msg}`));
-    console.groupEnd();
-  }
-  if (guidance.suggestions.length > 0) {
-    console.group(`${PREFIX} \u{1F4A1} Sugest\xF5es`);
-    guidance.suggestions.forEach((msg) => console.info(`${PREFIX} ${msg}`));
-    console.groupEnd();
-  }
-  if (guidance.usingDefaults) {
-    console.warn(
-      `${PREFIX} \u{1F4CB} Usando configura\xE7\xE3o padr\xE3o. Para personalizar, use a prop "categories" no ConsentProvider.`
-    );
-  }
-  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 setCookieCategoryOverrides(map) {
+  COOKIE_CATEGORY_OVERRIDES = { ...COOKIE_CATEGORY_OVERRIDES, ...map };
 }
-function useDeveloperGuidance(config, disableGuidanceProp) {
-  const guidance = import_react.default.useMemo(() => {
-    return analyzeDeveloperConfiguration(config);
-  }, [config]);
-  import_react.default.useEffect(() => {
-    if (!disableGuidanceProp) {
-      logDeveloperGuidance(guidance, disableGuidanceProp);
+function matchPattern(name, pattern) {
+  if (pattern.endsWith("*")) return name.startsWith(pattern.slice(0, -1));
+  return name === pattern;
+}
+function getCookiesInfoForCategory(categoryId, usedIntegrations) {
+  const result = [];
+  usedIntegrations.forEach((id) => {
+    const defaultCat = INTEGRATION_DEFAULT_CATEGORY[id];
+    const defaults = COOKIE_INFO_BY_INTEGRATION[id] || [];
+    const list = COOKIE_CATALOG_OVERRIDES.byIntegration?.[id] || defaults;
+    list.forEach((desc) => {
+      const overrideCat = Object.entries(COOKIE_CATEGORY_OVERRIDES).find(
+        ([pattern]) => matchPattern(desc.name, pattern)
+      )?.[1];
+      const finalCat = overrideCat ?? defaultCat;
+      if (finalCat === categoryId && !result.find((d) => d.name === desc.name)) result.push(desc);
+    });
+  });
+  const catOverride = COOKIE_CATALOG_OVERRIDES.byCategory?.[categoryId];
+  if (catOverride) {
+    catOverride.forEach((d) => {
+      const idx = result.findIndex((x) => x.name === d.name);
+      if (idx >= 0) result[idx] = d;
+      else result.push(d);
+    });
+  }
+  if (categoryId === "necessary") {
+    if (!result.find((d) => d.name === "cookieConsent")) {
+      result.push({
+        name: "cookieConsent",
+        purpose: "Armazena suas prefer\xEAncias de consentimento",
+        duration: "365 dias",
+        provider: "Este site"
+      });
     }
-  }, [guidance, disableGuidanceProp]);
-  return guidance;
+  }
+  return result;
 }
-var import_react, DEFAULT_PROJECT_CATEGORIES;
-var init_developerGuidance = __esm({
-  "src/utils/developerGuidance.ts"() {
+var COOKIE_PATTERNS_BY_CATEGORY, COOKIE_INFO_BY_INTEGRATION, INTEGRATION_DEFAULT_CATEGORY, COOKIE_CATALOG_OVERRIDES, COOKIE_CATEGORY_OVERRIDES;
+var init_cookieRegistry = __esm({
+  "src/utils/cookieRegistry.ts"() {
     "use strict";
-    import_react = __toESM(require("react"), 1);
-    DEFAULT_PROJECT_CATEGORIES = {
-      enabledCategories: ["analytics"]
+    COOKIE_PATTERNS_BY_CATEGORY = {
+      necessary: ["cookieConsent"],
+      analytics: ["_ga", "_ga_*", "_gid", "_gcl_au", "_hj*", "mp_*", "_clck", "_clsk"],
+      functional: ["intercom-*", "__zlcmid", "_zendesk_shared_session", "_userway_*"],
+      marketing: ["_fbp", "fr"],
+      social: [],
+      personalization: []
+    };
+    COOKIE_INFO_BY_INTEGRATION = {
+      "google-analytics": [
+        {
+          name: "_ga",
+          purpose: "Identifica\xE7\xE3o \xFAnica de visitantes para an\xE1lise de tr\xE1fego",
+          duration: "2 anos",
+          provider: "Google Analytics"
+        },
+        {
+          name: "_ga_*",
+          purpose: "Rastreamento de sess\xF5es e eventos espec\xEDficos do stream GA4",
+          duration: "2 anos",
+          provider: "Google Analytics"
+        },
+        {
+          name: "_gid",
+          purpose: "Distin\xE7\xE3o de visitantes \xFAnicos em per\xEDodo de 24h",
+          duration: "24 horas",
+          provider: "Google Analytics"
+        }
+      ],
+      "google-tag-manager": [
+        {
+          name: "_gcl_au",
+          purpose: "Rastreamento de convers\xF5es de an\xFAncios",
+          duration: "90 dias",
+          provider: "Google"
+        }
+      ],
+      hotjar: [
+        {
+          name: "_hjSession_*",
+          purpose: "Rastreamento de sess\xE3o",
+          duration: "30 minutos",
+          provider: "Hotjar"
+        },
+        {
+          name: "_hjSessionUser_*",
+          purpose: "Persist\xEAncia de usu\xE1rio entre sess\xF5es",
+          duration: "365 dias",
+          provider: "Hotjar"
+        },
+        {
+          name: "_hjFirstSeen",
+          purpose: "Detec\xE7\xE3o da primeira visita do usu\xE1rio",
+          duration: "Sess\xE3o",
+          provider: "Hotjar"
+        }
+      ],
+      mixpanel: [
+        {
+          name: "mp_*",
+          purpose: "Rastreamento de eventos e propriedades do usu\xE1rio para analytics",
+          duration: "1 ano",
+          provider: "Mixpanel"
+        }
+      ],
+      clarity: [
+        {
+          name: "_clck",
+          purpose: "Identificador de usu\xE1rio",
+          duration: "365 dias",
+          provider: "Microsoft"
+        },
+        { name: "_clsk", purpose: "Rastreamento de sess\xE3o", duration: "1 dia", provider: "Microsoft" }
+      ],
+      intercom: [
+        {
+          name: "intercom-id-*",
+          purpose: "Identificador do usu\xE1rio",
+          duration: "9 meses",
+          provider: "Intercom"
+        },
+        {
+          name: "intercom-session-*",
+          purpose: "Gerenciamento de sess\xE3o",
+          duration: "1 semana",
+          provider: "Intercom"
+        }
+      ],
+      "zendesk-chat": [
+        {
+          name: "__zlcmid",
+          purpose: "Identificador de sess\xE3o de chat",
+          duration: "1 ano",
+          provider: "Zendesk"
+        },
+        {
+          name: "_zendesk_shared_session",
+          purpose: "Gerenciamento de sess\xE3o",
+          duration: "Sess\xE3o",
+          provider: "Zendesk"
+        }
+      ],
+      userway: [
+        {
+          name: "_userway_*",
+          purpose: "Prefer\xEAncias de acessibilidade",
+          duration: "1 ano",
+          provider: "UserWay"
+        }
+      ],
+      "facebook-pixel": [
+        { name: "_fbp", purpose: "Rastreamento de an\xFAncios", duration: "90 dias", provider: "Meta" },
+        { name: "fr", purpose: "Direcionamento de an\xFAncios", duration: "90 dias", provider: "Meta" }
+      ]
     };
+    INTEGRATION_DEFAULT_CATEGORY = {
+      "google-analytics": "analytics",
+      "google-tag-manager": "analytics",
+      hotjar: "analytics",
+      mixpanel: "analytics",
+      clarity: "analytics",
+      intercom: "functional",
+      "zendesk-chat": "functional",
+      userway: "functional",
+      "facebook-pixel": "marketing"
+    };
+    COOKIE_CATALOG_OVERRIDES = {};
+    COOKIE_CATEGORY_OVERRIDES = {};
   }
 });
 
-// src/context/CategoriesContext.tsx
-function CategoriesProvider({
-  children,
-  config,
-  disableDeveloperGuidance
-}) {
-  const contextValue = React2.useMemo(() => {
-    const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
-    const guidance = analyzeDeveloperConfiguration(config);
-    const toggleableCategories = guidance.activeCategoriesInfo.filter((cat) => cat.uiRequired);
-    return {
-      config: finalConfig,
-      guidance,
-      toggleableCategories,
-      allCategories: guidance.activeCategoriesInfo
-    };
-  }, [config]);
-  React2.useEffect(() => {
-    logDeveloperGuidance(contextValue.guidance, disableDeveloperGuidance);
-  }, [contextValue.guidance, disableDeveloperGuidance]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CategoriesContext.Provider, { value: contextValue, children });
+// src/utils/cookieDiscovery.ts
+function discoverRuntimeCookies() {
+  if (typeof document === "undefined" || !document.cookie) return [];
+  const names = Array.from(
+    new Set(
+      document.cookie.split(";").map((s) => s.trim()).filter(Boolean).map((s) => s.split("=")[0])
+    )
+  );
+  const list = names.map((name) => ({ name }));
+  try {
+    ;
+    globalThis.__LGPD_DISCOVERED_COOKIES__ = list;
+  } catch {
+  }
+  return list;
 }
-function useCategories() {
-  const context = React2.useContext(CategoriesContext);
-  if (!context) {
-    throw new Error(
-      "useCategories deve ser usado dentro de CategoriesProvider. Certifique-se de que o ConsentProvider est\xE1 envolvendo seu componente."
-    );
+function detectConsentCookieName() {
+  if (typeof document === "undefined" || !document.cookie) return null;
+  try {
+    const pairs = document.cookie.split(";").map((s) => s.trim()).filter(Boolean);
+    for (const p of pairs) {
+      const [name, ...rest] = p.split("=");
+      const raw = rest.join("=");
+      if (!raw) continue;
+      let val = raw;
+      try {
+        val = decodeURIComponent(raw);
+      } catch {
+      }
+      if (val.startsWith("{")) {
+        try {
+          const obj = JSON.parse(val);
+          if (obj && typeof obj === "object" && "preferences" in obj && "version" in obj) {
+            return name;
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
   }
-  return context;
+  return null;
 }
-function useCategoryStatus(categoryId) {
-  const { allCategories } = useCategories();
-  const category = allCategories.find((cat) => cat.id === categoryId);
-  return {
-    isActive: !!category,
-    isEssential: category?.essential || false,
-    needsToggle: category?.uiRequired || false,
-    name: category?.name,
-    description: category?.description
-  };
+function categorizeDiscoveredCookies(discovered, registerOverrides = false) {
+  const list = discovered || globalThis.__LGPD_DISCOVERED_COOKIES__ || [];
+  const out = {};
+  function matchPattern2(name, pattern) {
+    if (pattern.endsWith("*")) return name.startsWith(pattern.slice(0, -1));
+    return name === pattern;
+  }
+  list.filter((d) => d.name && d.name !== "cookieConsent").forEach((d) => {
+    let assigned = null;
+    Object.keys(COOKIE_PATTERNS_BY_CATEGORY).forEach((cat2) => {
+      if (assigned) return;
+      const patterns = COOKIE_PATTERNS_BY_CATEGORY[cat2] || [];
+      if (patterns.some((p) => matchPattern2(d.name, p))) assigned = cat2;
+    });
+    const cat = assigned || "analytics";
+    out[cat] = out[cat] || [];
+    if (!out[cat].find((x) => x.name === d.name)) out[cat].push(d);
+  });
+  if (registerOverrides) {
+    const byCategory = {};
+    Object.entries(out).forEach(([cat, cookies]) => {
+      byCategory[cat] = cookies;
+    });
+    setCookieCatalogOverrides({ byCategory });
+  }
+  return out;
 }
-var React2, import_jsx_runtime, CategoriesContext;
-var init_CategoriesContext = __esm({
-  "src/context/CategoriesContext.tsx"() {
+var init_cookieDiscovery = __esm({
+  "src/utils/cookieDiscovery.ts"() {
     "use strict";
-    React2 = __toESM(require("react"), 1);
-    init_developerGuidance();
-    import_jsx_runtime = require("react/jsx-runtime");
-    CategoriesContext = React2.createContext(null);
+    init_cookieRegistry();
   }
 });
 
@@ -493,6 +574,497 @@ var init_cookieUtils = __esm({
   }
 });
 
+// src/utils/developerGuidance.ts
+function calculateComplianceScore(guidance) {
+  let score = 0;
+  const maxScore = 100;
+  if (!guidance.usingDefaults) score += 30;
+  const totalCategories = guidance.activeCategoriesInfo.length;
+  const toggleableCategories = guidance.activeCategoriesInfo.filter((c) => c.uiRequired).length;
+  if (totalCategories > 1) score += 20;
+  if (toggleableCategories >= 2 && toggleableCategories <= 4) score += 25;
+  const criticalWarnings = guidance.messages.filter((m) => m.severity === "error").length;
+  const warnings = guidance.messages.filter((m) => m.severity === "warning").length;
+  if (criticalWarnings === 0) score += 15;
+  if (warnings === 0) score += 10;
+  return Math.min(score, maxScore);
+}
+function analyzeDeveloperConfiguration(config) {
+  const guidance = {
+    warnings: [],
+    suggestions: [],
+    messages: [],
+    activeCategoriesInfo: [],
+    usingDefaults: !config,
+    complianceScore: 0
+  };
+  const addMessage = (severity, message, category, actionable = true) => {
+    const guidanceMessage = { severity, message, category, actionable };
+    guidance.messages.push(guidanceMessage);
+    if (severity === "warning" || severity === "error") {
+      guidance.warnings.push(message);
+    } else {
+      guidance.suggestions.push(message);
+    }
+  };
+  const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
+  if (!config) {
+    addMessage(
+      "warning",
+      'LGPD-CONSENT: Nenhuma configura\xE7\xE3o de categorias especificada. Usando padr\xE3o: necessary + analytics. Para produ\xE7\xE3o, especifique explicitamente as categorias via prop "categories".',
+      "configuration"
+    );
+  }
+  guidance.activeCategoriesInfo.push({
+    id: "necessary",
+    name: "Cookies Necess\xE1rios",
+    description: "Essenciais para funcionamento b\xE1sico do site",
+    essential: true,
+    uiRequired: false,
+    cookies: COOKIE_PATTERNS_BY_CATEGORY["necessary"]
+  });
+  const enabled = finalConfig.enabledCategories || [];
+  const NAMES = {
+    analytics: { name: "Cookies Anal\xEDticos", description: "Medem uso e performance do site" },
+    functional: {
+      name: "Cookies Funcionais",
+      description: "Melhoram experi\xEAncia e funcionalidades"
+    },
+    marketing: { name: "Cookies de Marketing", description: "Publicidade direcionada e campanhas" },
+    social: { name: "Cookies de Redes Sociais", description: "Integra\xE7\xE3o com plataformas sociais" },
+    personalization: { name: "Cookies de Personaliza\xE7\xE3o", description: "Adapta\xE7\xE3o de conte\xFAdo" }
+  };
+  enabled.forEach((id) => {
+    const info = NAMES[id];
+    if (info) {
+      guidance.activeCategoriesInfo.push({
+        id,
+        name: info.name,
+        description: info.description,
+        essential: false,
+        uiRequired: true,
+        cookies: COOKIE_PATTERNS_BY_CATEGORY[id]
+      });
+    }
+  });
+  const custom = finalConfig.customCategories || [];
+  custom.forEach((cat) => {
+    if (!cat?.id || cat.id === "necessary") return;
+    guidance.activeCategoriesInfo.push({
+      id: cat.id,
+      name: cat.name,
+      description: cat.description,
+      essential: !!cat.essential,
+      uiRequired: !cat.essential,
+      cookies: cat.cookies
+    });
+  });
+  try {
+    const gt = globalThis;
+    const implied = (gt.__LGPD_REQUIRED_CATEGORIES__ || []).filter(Boolean);
+    implied.forEach((id) => {
+      if (!guidance.activeCategoriesInfo.find((c) => c.id === id)) {
+        const info = NAMES[id];
+        if (info) {
+          guidance.activeCategoriesInfo.push({
+            id,
+            name: info.name,
+            description: info.description,
+            essential: false,
+            uiRequired: true,
+            cookies: COOKIE_PATTERNS_BY_CATEGORY[id]
+          });
+          if (!enabled.includes(id)) {
+            addMessage(
+              "info",
+              `Integra\xE7\xF5es detectadas requerem a categoria '${id}'. Adicione-a em categories.enabledCategories.`,
+              "integration"
+            );
+          }
+        }
+      }
+    });
+  } catch {
+  }
+  try {
+    const gt2 = globalThis;
+    const used = gt2.__LGPD_USED_INTEGRATIONS__ || [];
+    guidance.activeCategoriesInfo = guidance.activeCategoriesInfo.map((c) => {
+      const info = getCookiesInfoForCategory(c.id, used);
+      const names = Array.from(/* @__PURE__ */ new Set([...c.cookies || [], ...info.map((d) => d.name)]));
+      return { ...c, cookies: names };
+    });
+  } catch {
+  }
+  const totalToggleable = guidance.activeCategoriesInfo.filter((c) => c.uiRequired).length;
+  if (totalToggleable === 0) {
+    addMessage(
+      "info",
+      'Apenas cookies necess\xE1rios est\xE3o configurados. Para compliance LGPD, considere adicionar categorias como "analytics" ou "functional" conforme uso real.',
+      "compliance"
+    );
+  }
+  if (totalToggleable > 5) {
+    addMessage(
+      "warning",
+      `${totalToggleable} categorias opcionais detectadas. UI com muitas op\xE7\xF5es pode prejudicar a experi\xEAncia. Considere agrupar categorias similares.`,
+      "usability"
+    );
+  }
+  guidance.complianceScore = calculateComplianceScore(guidance);
+  return guidance;
+}
+function getComplianceScoreColor(score) {
+  if (score >= 80) return "#4caf50";
+  if (score >= 60) return "#ff9800";
+  return "#f44336";
+}
+function logComplianceScore(prefix, score) {
+  const color = getComplianceScoreColor(score);
+  console.log(
+    `%c${prefix} Score de Conformidade LGPD: ${score}/100`,
+    `color: ${color}; font-weight: bold; font-size: 14px;`
+  );
+}
+function logMessagesByType(prefix, messages, type, config) {
+  const filteredMessages = messages.filter((m) => m.severity === type);
+  if (filteredMessages.length === 0) return false;
+  const typeConfig = {
+    error: {
+      show: config.showWarnings,
+      title: "Erros Cr\xEDticos",
+      color: "#d32f2f",
+      method: console.error
+    },
+    warning: {
+      show: config.showWarnings,
+      title: "Avisos de Configura\xE7\xE3o",
+      color: "#f57c00",
+      method: console.warn
+    },
+    info: {
+      show: config.showSuggestions,
+      title: "Sugest\xF5es",
+      color: "#2196f3",
+      method: console.info
+    }
+  };
+  const typeSettings = typeConfig[type];
+  if (!typeSettings.show) return false;
+  console.group(
+    `%c${prefix} ${typeSettings.title}`,
+    `color: ${typeSettings.color}; font-weight: bold;`
+  );
+  filteredMessages.forEach(
+    (msg) => typeSettings.method(
+      `%c${prefix}%c ${msg.message}`,
+      `color: ${typeSettings.color};`,
+      "color: #333;"
+    )
+  );
+  console.groupEnd();
+  return true;
+}
+function getGuidanceHash(guidance) {
+  const sortedWarnings = [...guidance.warnings].sort((a, b) => a.localeCompare(b));
+  const sortedSuggestions = [...guidance.suggestions].sort(
+    (a, b) => a.localeCompare(b)
+  );
+  const sortedCategories = guidance.activeCategoriesInfo.map((c) => c.id).sort((a, b) => a.localeCompare(b));
+  return JSON.stringify({
+    warnings: sortedWarnings,
+    suggestions: sortedSuggestions,
+    categories: sortedCategories,
+    usingDefaults: guidance.usingDefaults
+  });
+}
+function logIntroOnce() {
+  if (SESSION_LOGGED.intro) return;
+  SESSION_LOGGED.intro = true;
+  console.log(
+    `%c\u{1F36A} LGPD-CONSENT %c- Sistema de Consentimento Ativo`,
+    "background: #4caf50; color: white; padding: 4px 8px; border-radius: 4px; font-weight: bold;",
+    "color: #2e7d32; font-weight: 500;"
+  );
+}
+function logServerSideIfAvailable(guidance) {
+  try {
+    const gt = globalThis;
+    if (gt.process?.stdout?.write) {
+      const prefix = "\x1B[36m[LGPD-CONSENT]\x1B[0m";
+      const warnings = guidance.warnings.length;
+      const suggestions = guidance.suggestions.length;
+      const stdout = gt.process.stdout;
+      if (warnings > 0 || suggestions > 0) {
+        stdout.write(`${prefix} \u{1F527} Config: ${warnings} avisos, ${suggestions} sugest\xF5es
+`);
+        if (warnings > 0) {
+          guidance.warnings.forEach((w) => {
+            stdout.write(`${prefix} \x1B[33m\u26A0\uFE0F  ${w}\x1B[0m
+`);
+          });
+        }
+        if (suggestions > 0) {
+          guidance.suggestions.forEach((s) => {
+            stdout.write(`${prefix} \x1B[36m\u{1F4A1} ${s}\x1B[0m
+`);
+          });
+        }
+      }
+    }
+  } catch {
+  }
+}
+function logDeveloperGuidance(guidance, disableGuidanceProp, config) {
+  const gt = globalThis;
+  const nodeEnv = typeof gt.process !== "undefined" ? gt.process?.env?.NODE_ENV : void 0;
+  const isProd = nodeEnv === "production" || gt.__LGPD_PRODUCTION__ === true;
+  if (isProd || disableGuidanceProp) return;
+  const guidanceHash = getGuidanceHash(guidance);
+  if (GUIDANCE_CACHE.has(guidanceHash)) return;
+  GUIDANCE_CACHE.add(guidanceHash);
+  logServerSideIfAvailable(guidance);
+  const guidanceConfig = {
+    showWarnings: true,
+    showSuggestions: true,
+    showCategoriesTable: true,
+    showBestPractices: true,
+    showComplianceScore: true,
+    minimumSeverity: "info",
+    ...config
+  };
+  if (guidanceConfig.messageProcessor) {
+    guidanceConfig.messageProcessor(guidance.messages);
+    return;
+  }
+  logIntroOnce();
+  const PREFIX = "\u{1F36A}";
+  let hasImportantInfo = false;
+  const filteredMessages = guidance.messages.filter((msg) => {
+    const severityLevels = { info: 0, warning: 1, error: 2 };
+    const minLevel = severityLevels[guidanceConfig.minimumSeverity || "info"];
+    const msgLevel = severityLevels[msg.severity];
+    return msgLevel >= minLevel;
+  });
+  hasImportantInfo = logMessagesByType(PREFIX, filteredMessages, "error", guidanceConfig) || hasImportantInfo;
+  hasImportantInfo = logMessagesByType(PREFIX, filteredMessages, "warning", guidanceConfig) || hasImportantInfo;
+  if (hasImportantInfo || guidance.usingDefaults) {
+    hasImportantInfo = logMessagesByType(PREFIX, filteredMessages, "info", guidanceConfig) || hasImportantInfo;
+  }
+  if (guidanceConfig.showComplianceScore && guidance.complianceScore !== void 0) {
+    logComplianceScore(PREFIX, guidance.complianceScore);
+  }
+  if (guidanceConfig.showCategoriesTable && (hasImportantInfo || guidance.usingDefaults)) {
+    const rows = guidance.activeCategoriesInfo.map((cat) => ({
+      "\u{1F4CA} Categoria": cat.id,
+      "\u{1F3F7}\uFE0F  Nome": cat.name,
+      "\u{1F39B}\uFE0F  UI": cat.uiRequired ? "\u2705" : "\u{1F512}",
+      "\u{1F36A} Cookies": (cat.cookies || []).slice(0, 3).join(", ") + (cat.cookies && cat.cookies.length > 3 ? ` (+${cat.cookies.length - 3})` : "")
+    }));
+    if (typeof console.table === "function") {
+      console.group(`%c${PREFIX} Configura\xE7\xE3o Ativa`, "color: #4caf50; font-weight: bold;");
+      console.table(rows);
+      console.groupEnd();
+    }
+  }
+  if (!SESSION_LOGGED.bestPractices && hasImportantInfo) {
+    SESSION_LOGGED.bestPractices = true;
+    console.group(`%c${PREFIX} LGPD - Boas Pr\xE1ticas`, "color: #9c27b0; font-weight: bold;");
+    console.info(
+      `%c${PREFIX}%c Necessary: sempre ativo \u2022 Demais: opt-out por padr\xE3o`,
+      "color: #9c27b0;",
+      "color: #7b1fa2;"
+    );
+    console.info(
+      `%c${PREFIX}%c Documente pol\xEDticas claras por categoria`,
+      "color: #9c27b0;",
+      "color: #7b1fa2;"
+    );
+    console.info(
+      `%c${PREFIX}%c Registre consentimento com data/hora/origem`,
+      "color: #9c27b0;",
+      "color: #7b1fa2;"
+    );
+    console.groupEnd();
+  }
+}
+function useDeveloperGuidance(config, disableGuidanceProp, guidanceConfig) {
+  const guidance = import_react.default.useMemo(() => analyzeDeveloperConfiguration(config), [config]);
+  import_react.default.useEffect(() => {
+    if (!disableGuidanceProp) logDeveloperGuidance(guidance, disableGuidanceProp, guidanceConfig);
+  }, [guidance, disableGuidanceProp, guidanceConfig]);
+  return guidance;
+}
+var import_react, DEFAULT_PROJECT_CATEGORIES, GUIDANCE_CACHE, SESSION_LOGGED, GUIDANCE_PRESETS;
+var init_developerGuidance = __esm({
+  "src/utils/developerGuidance.ts"() {
+    "use strict";
+    import_react = __toESM(require("react"), 1);
+    init_cookieRegistry();
+    DEFAULT_PROJECT_CATEGORIES = {
+      enabledCategories: ["analytics"]
+    };
+    GUIDANCE_CACHE = /* @__PURE__ */ new Set();
+    SESSION_LOGGED = {
+      intro: false,
+      bestPractices: false
+    };
+    GUIDANCE_PRESETS = {
+      /** Configuração completa para desenvolvimento */
+      development: {
+        showWarnings: true,
+        showSuggestions: true,
+        showCategoriesTable: true,
+        showBestPractices: true,
+        showComplianceScore: true,
+        minimumSeverity: "info"
+      },
+      /** Configuração silenciosa para produção */
+      production: {
+        showWarnings: false,
+        showSuggestions: false,
+        showCategoriesTable: false,
+        showBestPractices: false,
+        showComplianceScore: false,
+        minimumSeverity: "error"
+      },
+      /** Apenas erros críticos */
+      minimal: {
+        showWarnings: true,
+        showSuggestions: false,
+        showCategoriesTable: false,
+        showBestPractices: false,
+        showComplianceScore: false,
+        minimumSeverity: "error"
+      },
+      /** Focado em conformidade LGPD */
+      compliance: {
+        showWarnings: true,
+        showSuggestions: true,
+        showCategoriesTable: true,
+        showBestPractices: true,
+        showComplianceScore: true,
+        minimumSeverity: "warning"
+      }
+    };
+  }
+});
+
+// src/context/CategoriesContext.tsx
+function CategoriesProvider({
+  children,
+  config,
+  disableDeveloperGuidance,
+  disableDiscoveryLog
+}) {
+  const [impliedVersion, setImpliedVersion] = React2.useState(0);
+  React2.useEffect(() => {
+    const handler = () => setImpliedVersion((v) => v + 1);
+    if (typeof window !== "undefined" && typeof window.addEventListener === "function") {
+      window.addEventListener("lgpd:requiredCategories", handler);
+      return () => window.removeEventListener("lgpd:requiredCategories", handler);
+    }
+    return () => {
+    };
+  }, []);
+  const contextValue = React2.useMemo(() => {
+    const finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
+    const guidance = analyzeDeveloperConfiguration(config);
+    const toggleableCategories = guidance.activeCategoriesInfo.filter((cat) => cat.uiRequired);
+    return {
+      config: finalConfig,
+      guidance,
+      toggleableCategories,
+      allCategories: guidance.activeCategoriesInfo
+    };
+  }, [config, impliedVersion]);
+  React2.useEffect(() => {
+    logDeveloperGuidance(contextValue.guidance, disableDeveloperGuidance);
+  }, [contextValue.guidance, disableDeveloperGuidance]);
+  React2.useEffect(() => {
+    try {
+      const gt = globalThis;
+      const env = typeof gt.process !== "undefined" ? gt.process?.env?.NODE_ENV : void 0;
+      const isDev = env === "development";
+      if (!isDev || gt.__LGPD_DISCOVERY_LOGGED__ === true || disableDiscoveryLog) return;
+      const discovered = discoverRuntimeCookies();
+      const consentName = detectConsentCookieName() || DEFAULT_COOKIE_OPTS.name;
+      const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
+      if (typeof console !== "undefined") {
+        try {
+          console.group(`${PREFIX} \u{1F50E} Descoberta de cookies (experimental)`);
+          const names = Array.from(
+            new Set([consentName, ...discovered.map((d) => d.name)].filter(Boolean))
+          );
+          const rows = names.map((n) => ({ Cookie: n }));
+          if (typeof console.table === "function") console.table(rows);
+          else console.log(rows);
+          console.info(
+            `${PREFIX} \u2139\uFE0F  Estes nomes s\xE3o detectados em tempo de execu\xE7\xE3o. Ajuste ou categorize via APIs de override se necess\xE1rio.`
+          );
+          console.groupEnd();
+        } catch {
+        }
+      }
+      gt.__LGPD_DISCOVERY_LOGGED__ = true;
+    } catch {
+    }
+  }, [disableDiscoveryLog]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CategoriesContext.Provider, { value: contextValue, children });
+}
+function useCategories() {
+  const context = React2.useContext(CategoriesContext);
+  if (!context) {
+    throw new Error(
+      "useCategories deve ser usado dentro de CategoriesProvider. Certifique-se de que o ConsentProvider est\xE1 envolvendo seu componente."
+    );
+  }
+  return context;
+}
+function useCategoryStatus(categoryId) {
+  const { allCategories } = useCategories();
+  const category = allCategories.find((cat) => cat.id === categoryId);
+  return {
+    isActive: !!category,
+    isEssential: category?.essential || false,
+    needsToggle: category?.uiRequired || false,
+    name: category?.name,
+    description: category?.description
+  };
+}
+var React2, import_jsx_runtime, CategoriesContext;
+var init_CategoriesContext = __esm({
+  "src/context/CategoriesContext.tsx"() {
+    "use strict";
+    React2 = __toESM(require("react"), 1);
+    init_cookieDiscovery();
+    init_cookieUtils();
+    init_developerGuidance();
+    import_jsx_runtime = require("react/jsx-runtime");
+    CategoriesContext = React2.createContext(null);
+  }
+});
+
+// src/context/DesignContext.tsx
+function DesignProvider({
+  tokens,
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(DesignContext.Provider, { value: tokens, children });
+}
+function useDesignTokens() {
+  return React3.useContext(DesignContext);
+}
+var React3, import_jsx_runtime2, 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);
+  }
+});
+
 // src/utils/categoryUtils.ts
 function createProjectPreferences(config, defaultValue = false) {
   const preferences = {
@@ -505,6 +1077,12 @@ function createProjectPreferences(config, defaultValue = false) {
       preferences[category] = defaultValue;
     }
   });
+  const customCategories = config?.customCategories || [];
+  customCategories.forEach((cat) => {
+    if (cat.id && cat.id !== "necessary") {
+      preferences[cat.id] = defaultValue;
+    }
+  });
   return preferences;
 }
 function validateProjectPreferences(preferences, config) {
@@ -518,6 +1096,13 @@ function validateProjectPreferences(preferences, config) {
       validPreferences[category] = preferences[category];
     }
   });
+  const customCategories = config?.customCategories || [];
+  customCategories.forEach((cat) => {
+    const id = cat.id;
+    if (id && id !== "necessary" && preferences[id] !== void 0) {
+      validPreferences[id] = preferences[id];
+    }
+  });
   return validPreferences;
 }
 function getAllProjectCategories(config) {
@@ -535,6 +1120,12 @@ function getAllProjectCategories(config) {
       allCategories.push(getDefaultCategoryDefinition(category));
     }
   });
+  const customCategories = config?.customCategories || [];
+  customCategories.forEach((cat) => {
+    if (cat.id && cat.id !== "necessary") {
+      allCategories.push({ ...cat, essential: !!cat.essential });
+    }
+  });
   return allCategories;
 }
 function getDefaultCategoryDefinition(category) {
@@ -567,40 +1158,20 @@ function getDefaultCategoryDefinition(category) {
       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";
-  }
-});
-
-// src/context/DesignContext.tsx
-function DesignProvider({
-  tokens,
-  children
-}) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(DesignContext.Provider, { value: tokens, children });
-}
-function useDesignTokens() {
-  return React3.useContext(DesignContext);
+      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 React3, import_jsx_runtime2, DesignContext;
-var init_DesignContext = __esm({
-  "src/context/DesignContext.tsx"() {
+var init_categoryUtils = __esm({
+  "src/utils/categoryUtils.ts"() {
     "use strict";
-    React3 = __toESM(require("react"), 1);
-    import_jsx_runtime2 = require("react/jsx-runtime");
-    DesignContext = React3.createContext(void 0);
   }
 });
 
@@ -678,6 +1249,7 @@ var init_Branding = __esm({
 // src/components/CookieBanner.tsx
 function CookieBanner({
   policyLinkUrl,
+  termsLinkUrl,
   debug,
   blocking = true,
   hideBranding = false,
@@ -697,15 +1269,15 @@ function CookieBanner({
     hideBranding
   });
   if (!open) return null;
-  const bannerStyle = {
+  const bannerStyle = (theme) => ({
     p: designTokens?.spacing?.padding?.banner ?? 2,
     maxWidth: 720,
     mx: "auto",
-    backgroundColor: designTokens?.colors?.background,
-    color: designTokens?.colors?.text,
+    backgroundColor: designTokens?.colors?.background ?? theme.palette.background?.paper,
+    color: designTokens?.colors?.text ?? theme.palette.text?.primary,
     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,
@@ -771,27 +1343,51 @@ function CookieBanner({
     width: designTokens?.layout?.width?.desktop ?? "100%",
     p: 2
   };
-  let backdropColor = "rgba(0, 0, 0, 0.4)";
   const backdropToken = designTokens?.layout?.backdrop;
-  if (backdropToken === false) {
-    backdropColor = "transparent";
-  } else if (typeof backdropToken === "string") {
-    backdropColor = backdropToken;
-  }
-  if (blocking) {
+  const resolveBackdropColor = (theme) => {
+    if (backdropToken === false) return "transparent";
+    if (typeof backdropToken === "string") {
+      if (backdropToken.toLowerCase() === "auto") {
+        const isDark2 = theme?.palette?.mode === "dark";
+        return isDark2 ? "rgba(255, 255, 255, 0.12)" : "rgba(0, 0, 0, 0.4)";
+      }
+      return backdropToken;
+    }
+    const isDark = theme?.palette?.mode === "dark";
+    return isDark ? "rgba(255, 255, 255, 0.12)" : "rgba(0, 0, 0, 0.4)";
+  };
+  const isSafeRoute = (() => {
+    try {
+      if (typeof window === "undefined") return false;
+      const current = new URL(window.location.href);
+      const safeUrls = [policyLinkUrl, termsLinkUrl].filter(Boolean);
+      return safeUrls.some((u) => {
+        try {
+          const target = new URL(u, current.origin);
+          return target.pathname === current.pathname;
+        } catch {
+          return false;
+        }
+      });
+    } catch {
+      return false;
+    }
+  })();
+  const effectiveBlocking = blocking && !isSafeRoute;
+  if (effectiveBlocking) {
     return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         import_Box.default,
         {
-          sx: {
+          sx: (theme) => ({
             position: "fixed",
             top: 0,
             left: 0,
             right: 0,
             bottom: 0,
-            backgroundColor: backdropColor,
+            backgroundColor: resolveBackdropColor(theme),
             zIndex: 1299
-          }
+          })
         }
       ),
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Box.default, { sx: positionStyle, children: bannerContent })
@@ -1023,7 +1619,9 @@ function ConsentProvider({
   onPreferencesSaved,
   cookie: cookieOpts,
   disableDeveloperGuidance,
-  children
+  guidanceConfig,
+  children,
+  disableDiscoveryLog
 }) {
   const texts = React4.useMemo(() => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }), [textsProp]);
   const cookie = React4.useMemo(
@@ -1035,7 +1633,15 @@ function ConsentProvider({
     if (categories) return categories;
     return DEFAULT_PROJECT_CATEGORIES;
   }, [categories]);
-  useDeveloperGuidance(finalCategoriesConfig, disableDeveloperGuidance);
+  useDeveloperGuidance(finalCategoriesConfig, disableDeveloperGuidance, guidanceConfig);
+  React4.useEffect(() => {
+    const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+    if (!isProd && PreferencesModalComponent) {
+      console.info(
+        "[LGPD-CONSENT] Dica: seu PreferencesModal \xE9 customizado. Garanta exibir os detalhes dos cookies por categoria (nome, finalidade, dura\xE7\xE3o) usando as APIs setCookieCatalogOverrides / setCookieCategoryOverrides e getCookiesInfoForCategory. Consulte QUICKSTART e INTEGRACOES.md."
+      );
+    }
+  }, [PreferencesModalComponent]);
   const boot = React4.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
     return createFullConsentState(
@@ -1119,6 +1725,7 @@ function ConsentProvider({
     {
       config: finalCategoriesConfig,
       disableDeveloperGuidance,
+      disableDiscoveryLog,
       children: [
         children,
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(React4.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
@@ -1208,19 +1815,19 @@ function useConsentTextsInternal() {
 function useConsentHydrationInternal() {
   return React4.useContext(HydrationCtx);
 }
-var React4, import_styles2, import_jsx_runtime6, PreferencesModal, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx, defaultTexts;
+var import_styles2, React4, import_jsx_runtime6, PreferencesModal, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx, defaultTexts;
 var init_ConsentContext = __esm({
   "src/context/ConsentContext.tsx"() {
     "use strict";
-    React4 = __toESM(require("react"), 1);
     import_styles2 = require("@mui/material/styles");
-    init_cookieUtils();
+    React4 = __toESM(require("react"), 1);
     init_categoryUtils();
-    init_CategoriesContext();
-    init_DesignContext();
-    init_developerGuidance();
+    init_cookieUtils();
     init_useConsent();
+    init_developerGuidance();
     init_logger();
+    init_CategoriesContext();
+    init_DesignContext();
     init_CookieBanner();
     init_FloatingPreferencesButton();
     import_jsx_runtime6 = require("react/jsx-runtime");
@@ -1297,25 +1904,30 @@ function useConsentTexts() {
 function useConsentHydration() {
   return useConsentHydrationInternal();
 }
+function _registerGlobalOpenPreferences(openPreferences) {
+  globalOpenPreferences = openPreferences;
+}
+function _unregisterGlobalOpenPreferences() {
+  globalOpenPreferences = null;
+}
 function useOpenPreferencesModal() {
-  const { openPreferences } = useConsent();
-  return openPreferences;
+  const actions = useConsentActionsInternal();
+  if (!actions) {
+    throw new Error(
+      "[LGPD-CONSENT] useOpenPreferencesModal deve ser usado dentro do ConsentProvider. Envolva seu componente com <ConsentProvider>."
+    );
+  }
+  return actions.openPreferences;
 }
 function openPreferencesModal() {
   if (globalOpenPreferences) {
     globalOpenPreferences();
   } else {
     logger.warn(
-      "openPreferencesModal: ConsentProvider n\xE3o foi inicializado ou n\xE3o est\xE1 dispon\xEDvel."
+      "openPreferencesModal called but no ConsentProvider is mounted. Make sure ConsentProvider is rendered before calling this function."
     );
   }
 }
-function _registerGlobalOpenPreferences(openPreferences) {
-  globalOpenPreferences = openPreferences;
-}
-function _unregisterGlobalOpenPreferences() {
-  globalOpenPreferences = null;
-}
 var globalOpenPreferences;
 var init_useConsent = __esm({
   "src/hooks/useConsent.ts"() {
@@ -1338,7 +1950,7 @@ function PreferencesModal2({
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
   const designTokens = useDesignTokens();
-  const { toggleableCategories } = useCategories();
+  const { toggleableCategories, allCategories } = useCategories();
   const [tempPreferences, setTempPreferences] = (0, import_react2.useState)(() => {
     const initialPrefs = { necessary: true };
     toggleableCategories.forEach((category) => {
@@ -1363,43 +1975,126 @@ function PreferencesModal2({
     setTempPreferences(preferences);
     closePreferences();
   };
+  const modalTitleSx = (theme) => ({
+    fontSize: designTokens?.typography?.fontSize?.modal ?? void 0,
+    color: designTokens?.colors?.text ?? theme.palette.text.primary
+  });
+  const modalContentSx = (theme) => ({
+    p: designTokens?.spacing?.padding?.modal ?? void 0,
+    backgroundColor: designTokens?.colors?.background ?? theme.palette.background.paper,
+    color: designTokens?.colors?.text ?? theme.palette.text.primary
+  });
   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",
-        sx: { fontSize: designTokens?.typography?.fontSize?.modal ?? void 0 },
-        children: texts.modalTitle
-      }
-    ),
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_DialogContent.default, { dividers: true, sx: { p: designTokens?.spacing?.padding?.modal ?? void 0 }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_DialogTitle.default, { id: "cookie-pref-title", sx: modalTitleSx, children: texts.modalTitle }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_DialogContent.default, { dividers: true, sx: modalContentSx, children: [
       /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
         import_Typography3.default,
         {
           variant: "body2",
-          sx: { mb: 2, fontSize: designTokens?.typography?.fontSize?.modal ?? void 0 },
+          sx: (theme) => ({
+            mb: 2,
+            fontSize: designTokens?.typography?.fontSize?.modal ?? void 0,
+            color: designTokens?.colors?.text ?? theme.palette.text.primary
+          }),
           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,
+        toggleableCategories.map((category) => {
+          const full = allCategories.find((c) => c.id === category.id);
+          const namesFromGuidance = full?.cookies ?? [];
+          const used = globalThis.__LGPD_USED_INTEGRATIONS__ || [];
+          const descriptors = getCookiesInfoForCategory(category.id, used);
+          const enrichedDescriptors = descriptors.map((desc) => {
+            if (desc.purpose && desc.duration && desc.provider) {
+              return desc;
+            }
+            return {
+              name: desc.name,
+              purpose: desc.purpose || "-",
+              duration: desc.duration || "-",
+              provider: desc.provider || "-"
+            };
+          });
+          const merged = [
+            ...enrichedDescriptors,
+            ...namesFromGuidance.filter((n) => !enrichedDescriptors.find((d) => d.name === n)).map((n) => ({ name: n, purpose: "-", duration: "-", provider: "-" }))
+          ];
+          let mergedFinal = merged;
+          try {
+            if (merged.length === 0) {
+              const gmap = globalThis.__LGPD_INTEGRATIONS_MAP__ || {};
+              const scriptRows = Object.entries(gmap).filter(([, cat]) => cat === category.id).map(([id]) => ({
+                name: `(script) ${id}`,
+                purpose: "Script de integra\xE7\xE3o ativo",
+                duration: "-",
+                provider: "-"
+              }));
+              if (scriptRows.length > 0) mergedFinal = scriptRows;
+            }
+          } catch {
+          }
+          return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_Box2.default, { sx: { mb: 1 }, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+              import_FormControlLabel.default,
               {
-                checked: tempPreferences[category.id] ?? false,
-                onChange: (e) => setTempPreferences((prev) => ({
-                  ...prev,
-                  [category.id]: e.target.checked
-                }))
+                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}`
               }
             ),
-            label: `${category.name} - ${category.description}`
-          },
-          category.id
-        )),
-        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_FormControlLabel.default, { control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Switch.default, { checked: true, disabled: true }), label: texts.necessaryAlwaysOn })
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("details", { style: { marginLeft: 48 }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("summary", { children: "Ver detalhes" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Box2.default, { sx: { mt: 1 }, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("table", { style: { width: "100%", borderCollapse: "collapse" }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Cookie" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Finalidade" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Dura\xE7\xE3o" }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Fornecedor" })
+                ] }) }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("tbody", { children: mergedFinal.map((d, idx) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.name }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.purpose }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.duration }),
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.provider })
+                ] }, d.name + idx)) })
+              ] }) })
+            ] })
+          ] }, category.id);
+        }),
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_FormControlLabel.default, { control: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Switch.default, { checked: true, disabled: true }), label: texts.necessaryAlwaysOn }),
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("details", { style: { marginLeft: 48 }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("summary", { children: "Ver detalhes" }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_Box2.default, { sx: { mt: 1 }, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("table", { style: { width: "100%", borderCollapse: "collapse" }, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("thead", { children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Cookie" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Finalidade" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Dura\xE7\xE3o" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("th", { style: { textAlign: "left" }, children: "Fornecedor" })
+            ] }) }),
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("tbody", { children: (() => {
+              const used = globalThis.__LGPD_USED_INTEGRATIONS__ || [];
+              const necessaryCookies = getCookiesInfoForCategory(
+                "necessary",
+                used
+              );
+              return necessaryCookies.map((d, idx) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.name }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.purpose || "-" }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.duration || "-" }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("td", { children: d.provider || "-" })
+              ] }, d.name + idx));
+            })() })
+          ] }) })
+        ] })
       ] })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_DialogActions.default, { children: [
@@ -1409,10 +2104,11 @@ function PreferencesModal2({
     !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Branding, { variant: "modal" })
   ] });
 }
-var import_Button2, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography3, import_react2, import_jsx_runtime7;
+var import_Box2, import_Button2, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography3, import_react2, import_jsx_runtime7;
 var init_PreferencesModal = __esm({
   "src/components/PreferencesModal.tsx"() {
     "use strict";
+    import_Box2 = __toESM(require("@mui/material/Box"), 1);
     import_Button2 = __toESM(require("@mui/material/Button"), 1);
     import_Dialog = __toESM(require("@mui/material/Dialog"), 1);
     import_DialogActions = __toESM(require("@mui/material/DialogActions"), 1);
@@ -1424,8 +2120,9 @@ var init_PreferencesModal = __esm({
     import_Typography3 = __toESM(require("@mui/material/Typography"), 1);
     import_react2 = require("react");
     init_CategoriesContext();
-    init_useConsent();
     init_DesignContext();
+    init_useConsent();
+    init_cookieRegistry();
     init_Branding();
     import_jsx_runtime7 = require("react/jsx-runtime");
   }
@@ -1440,28 +2137,56 @@ __export(index_exports, {
   ConsentScriptLoader: () => ConsentScriptLoader,
   CookieBanner: () => CookieBanner,
   DEFAULT_PROJECT_CATEGORIES: () => DEFAULT_PROJECT_CATEGORIES,
+  EXPANDED_DEFAULT_TEXTS: () => EXPANDED_DEFAULT_TEXTS,
   FloatingPreferencesButton: () => FloatingPreferencesButton,
+  GUIDANCE_PRESETS: () => GUIDANCE_PRESETS,
+  INTEGRATION_TEMPLATES: () => INTEGRATION_TEMPLATES,
   LogLevel: () => LogLevel,
   PreferencesModal: () => PreferencesModal2,
+  TEXT_TEMPLATES: () => TEXT_TEMPLATES,
   analyzeDeveloperConfiguration: () => analyzeDeveloperConfiguration,
+  analyzeIntegrationCategories: () => analyzeIntegrationCategories,
+  autoConfigureCategories: () => autoConfigureCategories,
+  categorizeDiscoveredCookies: () => categorizeDiscoveredCookies,
+  createClarityIntegration: () => createClarityIntegration,
+  createCorporateIntegrations: () => createCorporateIntegrations,
   createDefaultConsentTheme: () => createDefaultConsentTheme,
+  createECommerceIntegrations: () => createECommerceIntegrations,
+  createFacebookPixelIntegration: () => createFacebookPixelIntegration,
   createGoogleAnalyticsIntegration: () => createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration: () => createGoogleTagManagerIntegration,
+  createHotjarIntegration: () => createHotjarIntegration,
+  createIntercomIntegration: () => createIntercomIntegration,
+  createMixpanelIntegration: () => createMixpanelIntegration,
   createProjectPreferences: () => createProjectPreferences,
+  createSaaSIntegrations: () => createSaaSIntegrations,
   createUserWayIntegration: () => createUserWayIntegration,
+  createZendeskChatIntegration: () => createZendeskChatIntegration,
   defaultConsentTheme: () => defaultConsentTheme,
   defaultTexts: () => defaultTexts,
+  detectConsentCookieName: () => detectConsentCookieName,
+  discoverRuntimeCookies: () => discoverRuntimeCookies,
+  extractCategoriesFromIntegrations: () => extractCategoriesFromIntegrations,
   getAllProjectCategories: () => getAllProjectCategories,
+  getCookiesInfoForCategory: () => getCookiesInfoForCategory,
   loadScript: () => loadScript,
+  logDeveloperGuidance: () => logDeveloperGuidance,
   openPreferencesModal: () => openPreferencesModal,
+  resolveTexts: () => resolveTexts,
+  setCookieCatalogOverrides: () => setCookieCatalogOverrides,
+  setCookieCategoryOverrides: () => setCookieCategoryOverrides,
   setDebugLogging: () => setDebugLogging,
+  suggestCategoryForScript: () => suggestCategoryForScript,
   useCategories: () => useCategories,
   useCategoryStatus: () => useCategoryStatus,
   useConsent: () => useConsent,
   useConsentHydration: () => useConsentHydration,
   useConsentScriptLoader: () => useConsentScriptLoader,
   useConsentTexts: () => useConsentTexts,
+  useDeveloperGuidance: () => useDeveloperGuidance,
   useOpenPreferencesModal: () => useOpenPreferencesModal,
+  validateIntegrationCategories: () => validateIntegrationCategories,
+  validateNecessaryClassification: () => validateNecessaryClassification,
   validateProjectPreferences: () => validateProjectPreferences
 });
 module.exports = __toCommonJS(index_exports);
@@ -1516,6 +2241,9 @@ function loadScript(id, src, category = null, attrs = {}) {
   });
 }
 
+// src/index.ts
+init_cookieDiscovery();
+
 // src/utils/theme.ts
 var import_styles3 = require("@mui/material/styles");
 function createDefaultConsentTheme() {
@@ -1589,14 +2317,233 @@ var defaultConsentTheme = () => createDefaultConsentTheme();
 
 // src/utils/ConsentScriptLoader.tsx
 var React5 = __toESM(require("react"), 1);
+init_CategoriesContext();
 init_useConsent();
+
+// src/utils/autoConfigureCategories.ts
+var FORBIDDEN_NECESSARY_SCRIPTS = /* @__PURE__ */ new Set([
+  // Analytics & Performance
+  "google-analytics",
+  "google-tag-manager",
+  "hotjar",
+  "mixpanel",
+  "clarity",
+  "amplitude",
+  "segment",
+  // Marketing & Advertising
+  "facebook-pixel",
+  "twitter-pixel",
+  "linkedin-insight",
+  "pinterest-tag",
+  "snapchat-pixel",
+  "tiktok-pixel",
+  "reddit-pixel",
+  // Communication & Support
+  "intercom",
+  "zendesk-chat",
+  "drift",
+  "crisp",
+  "freshchat",
+  // A/B Testing & Optimization
+  "optimizely",
+  "vwo",
+  "google-optimize",
+  "unbounce",
+  // Social & Content
+  "youtube-embed",
+  "vimeo-embed",
+  "twitter-widget",
+  "facebook-widget",
+  "instagram-widget",
+  // Accessibility (exceto scripts críticos)
+  "userway"
+]);
+function analyzeIntegrationCategories(integrations) {
+  const categoryMap = {};
+  integrations.forEach((integration) => {
+    const category = integration.category;
+    if (!categoryMap[category]) {
+      categoryMap[category] = [];
+    }
+    categoryMap[category].push(integration.id);
+  });
+  return categoryMap;
+}
+function autoConfigureCategories(originalConfig, integrations, options = {}) {
+  const { warningOnly = false, silent = false } = options;
+  const config = originalConfig || { enabledCategories: ["analytics"] };
+  const categoryIntegrations = analyzeIntegrationCategories(integrations);
+  const requiredCategories = Object.keys(categoryIntegrations);
+  const currentCategories = new Set(config.enabledCategories || []);
+  const missingCategories = requiredCategories.filter((cat) => !currentCategories.has(cat));
+  let adjustedConfig = { ...config };
+  let autoEnabledCategories = [];
+  if (missingCategories.length > 0) {
+    if (warningOnly) {
+      if (!silent) {
+        logMissingCategoriesWarning(missingCategories, categoryIntegrations);
+      }
+    } else {
+      autoEnabledCategories = [...missingCategories];
+      adjustedConfig = {
+        ...config,
+        enabledCategories: [...currentCategories, ...missingCategories]
+      };
+      if (!silent) {
+        logAutoEnabledCategories(autoEnabledCategories, categoryIntegrations);
+      }
+    }
+  }
+  return {
+    originalConfig: config,
+    adjustedConfig,
+    autoEnabledCategories,
+    missingCategories,
+    wasAdjusted: autoEnabledCategories.length > 0,
+    categoryIntegrations
+  };
+}
+function logMissingCategoriesWarning(missingCategories, categoryIntegrations) {
+  const isDev = process.env.NODE_ENV !== "production";
+  if (!isDev) return;
+  const PREFIX = "[\u{1F36A} LGPD-CONSENT AUTO-CONFIG]";
+  console.group(`${PREFIX} \u26A0\uFE0F Categorias Requeridas N\xE3o Habilitadas`);
+  missingCategories.forEach((category) => {
+    const integrations = categoryIntegrations[category] || [];
+    console.warn(
+      `${PREFIX} Categoria '${category}' requerida por integra\xE7\xF5es: ${integrations.join(", ")}`
+    );
+  });
+  const categoriesCode = missingCategories.map((c) => `'${c}'`).join(", ");
+  console.warn(
+    `${PREFIX} Para corrigir, adicione estas categorias ao ConsentProvider:`,
+    `categories={{ enabledCategories: [...existingCategories, ${categoriesCode}] }}`
+  );
+  console.groupEnd();
+}
+function logAutoEnabledCategories(autoEnabledCategories, categoryIntegrations) {
+  const isDev = process.env.NODE_ENV !== "production";
+  if (!isDev) return;
+  const PREFIX = "[\u{1F36A} LGPD-CONSENT AUTO-CONFIG]";
+  console.group(`${PREFIX} \u2705 Categorias Auto-Habilitadas`);
+  autoEnabledCategories.forEach((category) => {
+    const integrations = categoryIntegrations[category] || [];
+    console.info(
+      `${PREFIX} Categoria '${category}' auto-habilitada para integra\xE7\xF5es: ${integrations.join(", ")}`
+    );
+  });
+  console.info(`${PREFIX} \u{1F4A1} Essas categorias foram automaticamente adicionadas \xE0 configura\xE7\xE3o.`);
+  console.info(`${PREFIX} \u{1F527} Para controle manual, especifique explicitamente no ConsentProvider.`);
+  console.groupEnd();
+}
+function validateIntegrationCategories(integrations, enabledCategories) {
+  const requiredCategories = integrations.map((i) => i.category);
+  const enabledSet = new Set(enabledCategories);
+  return requiredCategories.every((category) => enabledSet.has(category));
+}
+function extractCategoriesFromIntegrations(integrations) {
+  const categories = /* @__PURE__ */ new Set();
+  integrations.forEach((integration) => {
+    categories.add(integration.category);
+  });
+  return Array.from(categories);
+}
+function validateNecessaryClassification(integrations, enabledCategories) {
+  const warnings = [];
+  const hasNecessaryCategory = enabledCategories.includes("necessary");
+  if (!hasNecessaryCategory) {
+    return warnings;
+  }
+  const problematicIntegrations = integrations.filter(
+    (integration) => integration.category === "necessary" && FORBIDDEN_NECESSARY_SCRIPTS.has(integration.id)
+  );
+  if (problematicIntegrations.length > 0) {
+    warnings.push(
+      `\u26A0\uFE0F ATEN\xC7\xC3O GDPR/LGPD: As seguintes integra\xE7\xF5es NUNCA devem ser classificadas como 'necessary':`
+    );
+    problematicIntegrations.forEach((integration) => {
+      warnings.push(
+        `   \u2022 '${integration.id}' (categoria: ${integration.category}) - Requer consentimento expl\xEDcito`
+      );
+    });
+    warnings.push(
+      `\u{1F4A1} Scripts 'necessary' executam SEM consentimento e podem resultar em multas.`,
+      `\u{1F4DA} Apenas scripts de seguran\xE7a, autentica\xE7\xE3o ou core do site se qualificam.`,
+      `\u{1F527} Mova estes scripts para categorias apropriadas (analytics, marketing, etc.)`
+    );
+  }
+  return warnings;
+}
+
+// src/utils/ConsentScriptLoader.tsx
 init_logger();
 function ConsentScriptLoader({
   integrations,
   reloadOnChange = false
 }) {
   const { preferences, consented } = useConsent();
+  const categories = useCategories();
   const loadedScripts = React5.useRef(/* @__PURE__ */ new Set());
+  React5.useEffect(() => {
+    try {
+      const ids = (integrations || []).map((i) => i.id);
+      const gt = globalThis;
+      const current = Array.isArray(gt.__LGPD_USED_INTEGRATIONS__) ? gt.__LGPD_USED_INTEGRATIONS__ : [];
+      const merged = Array.from(/* @__PURE__ */ new Set([...current, ...ids]));
+      gt.__LGPD_USED_INTEGRATIONS__ = merged;
+      try {
+        const gmap = globalThis;
+        const map = gmap.__LGPD_INTEGRATIONS_MAP__ || {};
+        (integrations || []).forEach((i) => {
+          map[i.id] = i.category;
+        });
+        gmap.__LGPD_INTEGRATIONS_MAP__ = map;
+      } catch {
+      }
+    } catch {
+    }
+  }, [integrations]);
+  React5.useEffect(() => {
+    try {
+      const required = Array.from(new Set((integrations || []).map((i) => i.category))).filter(
+        Boolean
+      );
+      const gt = globalThis;
+      const current = Array.isArray(gt.__LGPD_REQUIRED_CATEGORIES__) ? gt.__LGPD_REQUIRED_CATEGORIES__ : [];
+      const merged = Array.from(/* @__PURE__ */ new Set([...current, ...required]));
+      gt.__LGPD_REQUIRED_CATEGORIES__ = merged;
+      if (typeof window !== "undefined" && typeof window.dispatchEvent === "function") {
+        window.dispatchEvent(new CustomEvent("lgpd:requiredCategories"));
+      }
+    } catch {
+    }
+  }, [integrations]);
+  React5.useEffect(() => {
+    const isDev = process.env.NODE_ENV !== "production";
+    if (!isDev || integrations.length === 0) return;
+    const enabledCategories = categories.allCategories.map((cat) => cat.id);
+    const isValid = validateIntegrationCategories(integrations, enabledCategories);
+    if (!isValid) {
+      autoConfigureCategories({ enabledCategories }, integrations, {
+        warningOnly: true,
+        silent: false
+      });
+    }
+    const necessaryWarnings = validateNecessaryClassification(integrations, enabledCategories);
+    if (necessaryWarnings.length > 0) {
+      console.group("\u{1F6A8} [LGPD-CONSENT] VALIDA\xC7\xC3O DE COMPLIANCE");
+      necessaryWarnings.forEach((warning) => {
+        if (warning.startsWith("\u26A0\uFE0F")) {
+          console.error(warning);
+        } else if (warning.startsWith("\u{1F4A1}") || warning.startsWith("\u{1F4DA}") || warning.startsWith("\u{1F527}")) {
+          console.warn(warning);
+        } else {
+          console.log(warning);
+        }
+      });
+      console.groupEnd();
+    }
+  }, [integrations, categories]);
   React5.useEffect(() => {
     if (!consented) return;
     integrations.forEach(async (integration) => {
@@ -1649,10 +2596,32 @@ function useConsentScriptLoader() {
 
 // src/utils/scriptIntegrations.ts
 function createGoogleAnalyticsIntegration(config) {
+  const src = config.scriptUrl ?? `https://www.googletagmanager.com/gtag/js?id=${config.measurementId}`;
   return {
     id: "google-analytics",
     category: "analytics",
-    src: `https://www.googletagmanager.com/gtag/js?id=${config.measurementId}`,
+    src,
+    cookies: ["_ga", "_ga_*", "_gid"],
+    cookiesInfo: [
+      {
+        name: "_ga",
+        purpose: "Identifica\xE7\xE3o \xFAnica de visitantes para an\xE1lise de tr\xE1fego",
+        duration: "2 anos",
+        provider: "Google Analytics"
+      },
+      {
+        name: "_ga_*",
+        purpose: "Rastreamento de sess\xF5es e eventos espec\xEDficos do stream GA4",
+        duration: "2 anos",
+        provider: "Google Analytics"
+      },
+      {
+        name: "_gid",
+        purpose: "Distin\xE7\xE3o de visitantes \xFAnicos em per\xEDodo de 24h",
+        duration: "24 horas",
+        provider: "Google Analytics"
+      }
+    ],
     init: () => {
       if (typeof window !== "undefined") {
         const w = window;
@@ -1669,29 +2638,30 @@ function createGoogleAnalyticsIntegration(config) {
   };
 }
 function createGoogleTagManagerIntegration(config) {
+  const src = config.scriptUrl ?? `https://www.googletagmanager.com/gtm.js?id=${config.containerId}`;
   return {
     id: "google-tag-manager",
     category: "analytics",
-    src: `https://www.googletagmanager.com/gtm.js?id=${config.containerId}`,
+    src,
+    cookies: ["_gcl_au"],
     init: () => {
       if (typeof window !== "undefined") {
         const dataLayerName = config.dataLayerName || "dataLayer";
         const w = window;
         const layer = w[dataLayerName] ?? [];
         w[dataLayerName] = layer;
-        layer.push({
-          "gtm.start": (/* @__PURE__ */ new Date()).getTime(),
-          event: "gtm.js"
-        });
+        layer.push({ "gtm.start": (/* @__PURE__ */ new Date()).getTime(), event: "gtm.js" });
       }
     }
   };
 }
 function createUserWayIntegration(config) {
+  const src = config.scriptUrl ?? "https://cdn.userway.org/widget.js";
   return {
     id: "userway",
     category: "functional",
-    src: "https://cdn.userway.org/widget.js",
+    src,
+    cookies: ["_userway_*"],
     init: () => {
       if (typeof window !== "undefined") {
         const w = window;
@@ -1707,10 +2677,463 @@ var COMMON_INTEGRATIONS = {
   googleTagManager: createGoogleTagManagerIntegration,
   userway: createUserWayIntegration
 };
+function createFacebookPixelIntegration(config) {
+  const src = config.scriptUrl ?? "https://connect.facebook.net/en_US/fbevents.js";
+  return {
+    id: "facebook-pixel",
+    category: "marketing",
+    src,
+    cookies: ["_fbp", "fr"],
+    init: () => {
+      if (typeof window !== "undefined") {
+        const w = window;
+        if (!w.fbq) {
+          const fbq = (...args) => {
+            if (w.fbq && typeof w.fbq.callMethod === "function") {
+              w.fbq.callMethod(...args);
+            } else {
+              fbq.queue = fbq.queue || [];
+              fbq.queue.push(args);
+            }
+          };
+          fbq.loaded = true;
+          w.fbq = fbq;
+        }
+        w.fbq("init", config.pixelId, config.advancedMatching ?? {});
+        if (config.autoTrack !== false) w.fbq("track", "PageView");
+      }
+    }
+  };
+}
+function createHotjarIntegration(config) {
+  const v = config.version ?? 6;
+  const src = config.scriptUrl ?? `https://static.hotjar.com/c/hotjar-${config.siteId}.js?sv=${v}`;
+  return {
+    id: "hotjar",
+    category: "analytics",
+    src,
+    cookies: [
+      "_hjSession_*",
+      "_hjSessionUser_*",
+      "_hjFirstSeen",
+      "_hjIncludedInSessionSample",
+      "_hjAbsoluteSessionInProgress"
+    ],
+    cookiesInfo: [
+      {
+        name: "_hjSession_*",
+        purpose: "Identifica\xE7\xE3o \xFAnica da sess\xE3o de grava\xE7\xE3o e heatmaps",
+        duration: "30 minutos",
+        provider: "Hotjar"
+      },
+      {
+        name: "_hjSessionUser_*",
+        purpose: "Identifica\xE7\xE3o persistente do usu\xE1rio entre sess\xF5es",
+        duration: "365 dias",
+        provider: "Hotjar"
+      },
+      {
+        name: "_hjFirstSeen",
+        purpose: "Detec\xE7\xE3o de primeira visita do usu\xE1rio ao site",
+        duration: "Sess\xE3o",
+        provider: "Hotjar"
+      },
+      {
+        name: "_hjIncludedInSessionSample",
+        purpose: "Indica se a sess\xE3o est\xE1 inclu\xEDda na amostra de grava\xE7\xE3o",
+        duration: "30 minutos",
+        provider: "Hotjar"
+      },
+      {
+        name: "_hjAbsoluteSessionInProgress",
+        purpose: "Detecta se uma sess\xE3o absoluta est\xE1 em progresso",
+        duration: "30 minutos",
+        provider: "Hotjar"
+      }
+    ],
+    init: () => {
+      if (typeof window !== "undefined") {
+        const w = window;
+        w._hjSettings = { hjid: config.siteId, hjsv: v };
+        if (!w.hj) {
+          const hj = (...args) => {
+            hj.q = hj.q || [];
+            hj.q.push(args);
+          };
+          w.hj = hj;
+        }
+        if (config.debug && typeof console !== "undefined" && typeof console.info === "function") {
+          console.info("[Hotjar] initialized with siteId", config.siteId);
+        }
+      }
+    }
+  };
+}
+function createMixpanelIntegration(config) {
+  const src = config.scriptUrl ?? "https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js";
+  return {
+    id: "mixpanel",
+    category: "analytics",
+    src,
+    cookies: ["mp_*"],
+    cookiesInfo: [
+      {
+        name: "mp_*",
+        purpose: "Rastreamento de eventos e propriedades do usu\xE1rio para analytics",
+        duration: "1 ano",
+        provider: "Mixpanel"
+      }
+    ],
+    init: () => {
+      if (typeof window !== "undefined") {
+        const w = window;
+        w.mixpanel = w.mixpanel || { init: () => void 0 };
+        if (w.mixpanel && typeof w.mixpanel.init === "function") {
+          try {
+            w.mixpanel.init(config.token, config.config ?? {}, config.api_host);
+          } catch (error) {
+            if (typeof console !== "undefined" && typeof console.warn === "function") {
+              console.warn("[Mixpanel] Failed to initialize:", error);
+            }
+          }
+        }
+      }
+    }
+  };
+}
+function createClarityIntegration(config) {
+  const src = config.scriptUrl ?? `https://www.clarity.ms/tag/${config.projectId}`;
+  return {
+    id: "clarity",
+    category: "analytics",
+    src,
+    cookies: ["_clck", "_clsk", "CLID", "ANONCHK", "MR", "MUID", "SM"],
+    init: () => {
+      if (typeof window !== "undefined" && typeof config.upload !== "undefined") {
+        const w = window;
+        if (typeof w.clarity === "function") {
+          try {
+            w.clarity("set", "upload", config.upload);
+          } catch (error) {
+            if (typeof console !== "undefined" && typeof console.warn === "function") {
+              console.warn("[Clarity] Failed to configure upload setting:", error);
+            }
+          }
+        }
+      }
+    }
+  };
+}
+function createIntercomIntegration(config) {
+  const src = config.scriptUrl ?? `https://widget.intercom.io/widget/${config.app_id}`;
+  return {
+    id: "intercom",
+    category: "functional",
+    src,
+    cookies: ["intercom-id-*", "intercom-session-*"],
+    init: () => {
+      if (typeof window !== "undefined") {
+        const w = window;
+        if (typeof w.Intercom === "function") {
+          try {
+            w.Intercom("boot", { app_id: config.app_id });
+          } catch (error) {
+            if (typeof console !== "undefined" && typeof console.warn === "function") {
+              console.warn("[Intercom] Failed to boot:", error);
+            }
+          }
+        }
+      }
+    }
+  };
+}
+function createZendeskChatIntegration(config) {
+  const src = config.scriptUrl ?? `https://static.zdassets.com/ekr/snippet.js?key=${config.key}`;
+  return {
+    id: "zendesk-chat",
+    category: "functional",
+    src,
+    cookies: ["__zlcmid", "_zendesk_shared_session"],
+    init: () => {
+      if (typeof window !== "undefined") {
+        const w = window;
+        if (typeof w.zE === "function") {
+          try {
+            w.zE("webWidget", "identify", { key: config.key });
+          } catch (error) {
+            if (typeof console !== "undefined" && typeof console.warn === "function") {
+              console.warn("[Zendesk] Failed to identify:", error);
+            }
+          }
+        }
+      }
+    }
+  };
+}
+function createECommerceIntegrations(cfg) {
+  const list = [];
+  if (cfg.googleAnalytics) list.push(createGoogleAnalyticsIntegration(cfg.googleAnalytics));
+  if (cfg.facebookPixel) list.push(createFacebookPixelIntegration(cfg.facebookPixel));
+  if (cfg.hotjar) list.push(createHotjarIntegration(cfg.hotjar));
+  if (cfg.userway) list.push(createUserWayIntegration(cfg.userway));
+  return list;
+}
+function createSaaSIntegrations(cfg) {
+  const list = [];
+  if (cfg.googleAnalytics) list.push(createGoogleAnalyticsIntegration(cfg.googleAnalytics));
+  if (cfg.mixpanel) list.push(createMixpanelIntegration(cfg.mixpanel));
+  if (cfg.intercom) list.push(createIntercomIntegration(cfg.intercom));
+  if (cfg.hotjar) list.push(createHotjarIntegration(cfg.hotjar));
+  return list;
+}
+function createCorporateIntegrations(cfg) {
+  const list = [];
+  if (cfg.googleAnalytics) list.push(createGoogleAnalyticsIntegration(cfg.googleAnalytics));
+  if (cfg.clarity) list.push(createClarityIntegration(cfg.clarity));
+  if (cfg.zendesk) list.push(createZendeskChatIntegration(cfg.zendesk));
+  if (cfg.userway) list.push(createUserWayIntegration(cfg.userway));
+  return list;
+}
+var INTEGRATION_TEMPLATES = {
+  ecommerce: {
+    essential: ["google-analytics", "facebook-pixel"],
+    optional: ["hotjar", "userway"],
+    categories: ["analytics", "marketing", "functional"]
+  },
+  saas: {
+    essential: ["google-analytics", "mixpanel"],
+    optional: ["intercom", "hotjar"],
+    categories: ["analytics", "functional"]
+  },
+  corporate: {
+    essential: ["google-analytics"],
+    optional: ["userway", "zendesk-chat", "clarity"],
+    categories: ["analytics", "functional"]
+  }
+};
+function suggestCategoryForScript(name) {
+  const n = name.toLowerCase();
+  if (n.includes("facebook") || n.includes("pixel") || n.includes("ads")) return ["marketing"];
+  if (n.includes("hotjar") || n.includes("mixpanel") || n.includes("clarity")) return ["analytics"];
+  if (n.includes("intercom") || n.includes("zendesk") || n.includes("chat")) return ["functional"];
+  return ["analytics"];
+}
+
+// src/types/advancedTexts.ts
+var EXPANDED_DEFAULT_TEXTS = {
+  // Textos adicionais
+  confirm: "Confirmar",
+  cancel: "Cancelar",
+  loading: "Carregando...",
+  // Feedback
+  feedback: {
+    saveSuccess: "Prefer\xEAncias salvas com sucesso!",
+    saveError: "Erro ao salvar prefer\xEAncias. Tente novamente.",
+    consentUpdated: "Consentimento atualizado.",
+    cookiesRejected: "Cookies opcionais rejeitados.",
+    settingsReset: "Configura\xE7\xF5es resetadas."
+  },
+  // Acessibilidade
+  accessibility: {
+    bannerLabel: "Banner de consentimento de cookies",
+    modalLabel: "Modal de prefer\xEAncias de cookies",
+    keyboardNavigation: "Use Tab para navegar, Enter para selecionar",
+    toggleState: {
+      enabled: "Habilitado",
+      disabled: "Desabilitado"
+    },
+    liveRegion: "Regi\xE3o de an\xFAncios din\xE2micos"
+  },
+  // Categorias
+  categories: {
+    necessary: {
+      name: "Cookies Necess\xE1rios",
+      description: "Essenciais para o funcionamento b\xE1sico do site",
+      examples: "Sess\xE3o, seguran\xE7a, prefer\xEAncias de idioma"
+    },
+    analytics: {
+      name: "Cookies de Analytics",
+      description: "Ajudam a entender como os visitantes usam o site",
+      examples: "Google Analytics, contadores de p\xE1gina"
+    },
+    marketing: {
+      name: "Cookies de Marketing",
+      description: "Usados para personalizar an\xFAncios e ofertas",
+      examples: "Facebook Pixel, Google Ads, remarketing"
+    },
+    functional: {
+      name: "Cookies Funcionais",
+      description: "Melhoram a funcionalidade e personaliza\xE7\xE3o",
+      examples: "Chat, mapas, v\xEDdeos embarcados"
+    },
+    performance: {
+      name: "Cookies de Performance",
+      description: "Coletam informa\xE7\xF5es sobre velocidade e estabilidade",
+      examples: "Monitoramento de erro, otimiza\xE7\xE3o de velocidade"
+    }
+  },
+  // Contextos específicos
+  contexts: {
+    ecommerce: {
+      cartAbandonment: "Lembramos dos produtos no seu carrinho",
+      personalizedOffers: "Ofertas personalizadas baseadas no seu hist\xF3rico",
+      paymentSecurity: "Seguran\xE7a adicional no processo de pagamento",
+      productRecommendations: "Sugest\xF5es de produtos relevantes"
+    },
+    saas: {
+      userAnalytics: "An\xE1lise de uso para melhorar funcionalidades",
+      performanceMonitoring: "Monitoramento de performance da aplica\xE7\xE3o",
+      featureUsage: "Estat\xEDsticas de uso de recursos",
+      customerSupport: "Suporte ao cliente mais eficiente"
+    },
+    government: {
+      citizenServices: "Melhoria dos servi\xE7os ao cidad\xE3o",
+      dataProtection: "Prote\xE7\xE3o rigorosa dos dados pessoais",
+      transparency: "Transpar\xEAncia no uso de dados",
+      accessibility: "Recursos de acessibilidade digital"
+    },
+    education: {
+      studentProgress: "Acompanhamento do progresso educacional",
+      learningAnalytics: "Analytics para melhorar o aprendizado",
+      accessibility: "Recursos educacionais acess\xEDveis",
+      parentalConsent: "Consentimento parental quando necess\xE1rio"
+    }
+  },
+  // Variações de tom
+  variants: {
+    formal: {
+      bannerMessage: "Este s\xEDtio eletr\xF4nico utiliza cookies para otimizar a experi\xEAncia de navega\xE7\xE3o.",
+      acceptAll: "Concordar com todos os cookies",
+      declineAll: "Recusar cookies opcionais",
+      modalTitle: "Configura\xE7\xE3o de Cookies"
+    },
+    casual: {
+      bannerMessage: "\u{1F36A} Ei! Usamos cookies para tornar sua experi\xEAncia ainda melhor!",
+      acceptAll: "Aceitar tudo",
+      declineAll: "S\xF3 o essencial",
+      modalTitle: "Seus Cookies"
+    },
+    concise: {
+      bannerMessage: "Usamos cookies. Voc\xEA aceita?",
+      acceptAll: "Sim",
+      declineAll: "N\xE3o",
+      modalTitle: "Cookies"
+    },
+    detailed: {
+      bannerMessage: "Utilizamos cookies e tecnologias similares para melhorar sua experi\xEAncia de navega\xE7\xE3o, personalizar conte\xFAdo, analisar tr\xE1fego e oferecer funcionalidades de redes sociais.",
+      acceptAll: "Aceitar todos os cookies e tecnologias",
+      declineAll: "Recusar todos os cookies opcionais",
+      modalTitle: "Centro de Prefer\xEAncias de Privacidade"
+    }
+  },
+  // Internacionalização simplificada (apenas textos básicos)
+  i18n: {
+    en: {
+      bannerMessage: "We use cookies to enhance your experience.",
+      acceptAll: "Accept All",
+      declineAll: "Decline",
+      preferences: "Preferences",
+      modalTitle: "Cookie Preferences",
+      modalIntro: "Customize your cookie preferences below.",
+      save: "Save Preferences",
+      necessaryAlwaysOn: "Necessary cookies (always active)"
+    },
+    es: {
+      bannerMessage: "Utilizamos cookies para mejorar su experiencia.",
+      acceptAll: "Aceptar Todo",
+      declineAll: "Rechazar",
+      preferences: "Preferencias",
+      modalTitle: "Preferencias de Cookies",
+      modalIntro: "Personalice sus preferencias de cookies a continuaci\xF3n.",
+      save: "Guardar Preferencias",
+      necessaryAlwaysOn: "Cookies necess\xE1rias (sempre ativas)"
+    },
+    fr: {
+      bannerMessage: "Nous utilisons des cookies pour am\xE9liorer votre exp\xE9rience.",
+      acceptAll: "Tout Accepter",
+      declineAll: "Refuser",
+      preferences: "Pr\xE9f\xE9rences",
+      modalTitle: "Pr\xE9f\xE9rences des Cookies",
+      modalIntro: "Personnalisez vos pr\xE9f\xE9rences de cookies ci-dessous.",
+      save: "Enregistrer les Pr\xE9f\xE9rences",
+      necessaryAlwaysOn: "Cookies n\xE9cessaires (toujours actifs)"
+    }
+  },
+  // Textos técnicos
+  technical: {
+    sessionCookies: "Cookies de sess\xE3o s\xE3o tempor\xE1rios e expiram quando voc\xEA fecha o navegador.",
+    persistentCookies: "Cookies persistentes permanecem no seu dispositivo at\xE9 expirarem ou serem removidos.",
+    thirdPartyCookies: "Cookies de terceiros s\xE3o definidos por dom\xEDnios diferentes do site que voc\xEA est\xE1 visitando.",
+    browserSettings: "Voc\xEA pode gerenciar cookies nas configura\xE7\xF5es do seu navegador.",
+    disablingImpact: "Desabilitar cookies pode afetar a funcionalidade do site."
+  },
+  // Cookie details
+  cookieDetails: {
+    tableHeaders: {
+      name: "Nome",
+      purpose: "Finalidade",
+      duration: "Dura\xE7\xE3o",
+      provider: "Fornecedor",
+      type: "Tipo"
+    },
+    noCookies: "Nenhum cookie encontrado para esta categoria.",
+    toggleDetails: {
+      expand: "Ver detalhes",
+      collapse: "Ocultar detalhes"
+    }
+  }
+};
+function resolveTexts(texts, options = {}) {
+  const { language = "pt", variant } = options;
+  let resolved = { ...texts };
+  if (variant && texts.variants?.[variant]) {
+    resolved = { ...resolved, ...texts.variants[variant] };
+  }
+  if (language !== "pt" && texts.i18n?.[language]) {
+    resolved = { ...resolved, ...texts.i18n[language] };
+  }
+  return resolved;
+}
+var TEXT_TEMPLATES = {
+  ecommerce: {
+    ...EXPANDED_DEFAULT_TEXTS,
+    bannerMessage: "Utilizamos cookies para personalizar ofertas e melhorar sua experi\xEAncia de compra.",
+    acceptAll: "Aceitar e continuar",
+    variants: {
+      casual: {
+        bannerMessage: "\u{1F6D2} Usamos cookies para encontrar as melhores ofertas para voc\xEA!",
+        acceptAll: "Quero ofertas personalizadas!"
+      }
+    }
+  },
+  saas: {
+    ...EXPANDED_DEFAULT_TEXTS,
+    bannerMessage: "Utilizamos cookies para otimizar o desempenho da aplica\xE7\xE3o e sua experi\xEAncia.",
+    acceptAll: "Aceitar e otimizar",
+    variants: {
+      formal: {
+        bannerMessage: "Esta aplica\xE7\xE3o utiliza cookies para an\xE1lise de performance e melhoria cont\xEDnua da experi\xEAncia do usu\xE1rio.",
+        acceptAll: "Autorizar coleta de dados de uso"
+      }
+    }
+  },
+  government: {
+    ...EXPANDED_DEFAULT_TEXTS,
+    bannerMessage: "Este portal utiliza cookies em conformidade com a LGPD para melhorar os servi\xE7os p\xFAblicos.",
+    acceptAll: "Aceitar em conformidade",
+    variants: {
+      formal: {
+        bannerMessage: "Este s\xEDtio eletr\xF4nico do governo utiliza cookies estritamente necess\xE1rios e opcionais, em conformidade com a Lei Geral de Prote\xE7\xE3o de Dados.",
+        acceptAll: "Concordar com o uso de cookies"
+      }
+    }
+  }
+};
 
 // src/index.ts
 init_developerGuidance();
 init_logger();
+init_cookieRegistry();
 init_CookieBanner();
 init_FloatingPreferencesButton();
 init_ConsentContext();
@@ -1723,27 +3146,55 @@ init_categoryUtils();
   ConsentScriptLoader,
   CookieBanner,
   DEFAULT_PROJECT_CATEGORIES,
+  EXPANDED_DEFAULT_TEXTS,
   FloatingPreferencesButton,
+  GUIDANCE_PRESETS,
+  INTEGRATION_TEMPLATES,
   LogLevel,
   PreferencesModal,
+  TEXT_TEMPLATES,
   analyzeDeveloperConfiguration,
+  analyzeIntegrationCategories,
+  autoConfigureCategories,
+  categorizeDiscoveredCookies,
+  createClarityIntegration,
+  createCorporateIntegrations,
   createDefaultConsentTheme,
+  createECommerceIntegrations,
+  createFacebookPixelIntegration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
+  createHotjarIntegration,
+  createIntercomIntegration,
+  createMixpanelIntegration,
   createProjectPreferences,
+  createSaaSIntegrations,
   createUserWayIntegration,
+  createZendeskChatIntegration,
   defaultConsentTheme,
   defaultTexts,
+  detectConsentCookieName,
+  discoverRuntimeCookies,
+  extractCategoriesFromIntegrations,
   getAllProjectCategories,
+  getCookiesInfoForCategory,
   loadScript,
+  logDeveloperGuidance,
   openPreferencesModal,
+  resolveTexts,
+  setCookieCatalogOverrides,
+  setCookieCategoryOverrides,
   setDebugLogging,
+  suggestCategoryForScript,
   useCategories,
   useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,
   useConsentTexts,
+  useDeveloperGuidance,
   useOpenPreferencesModal,
+  validateIntegrationCategories,
+  validateNecessaryClassification,
   validateProjectPreferences
 });