@react-lgpd-consent/core 0.6.3 → 0.7.1

package/dist/index.cjs

@@ -333,21 +333,41 @@ function setDebugLogging(enabled, level = 2 /* INFO */) {
 // src/utils/cookieUtils.ts
 var DEFAULT_STORAGE_NAMESPACE = "lgpd-consent";
 var DEFAULT_STORAGE_VERSION = "1";
+var DEFAULT_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
 function buildConsentStorageKey(options) {
   const namespaceRaw = options?.namespace?.trim() || DEFAULT_STORAGE_NAMESPACE;
   const versionRaw = options?.version?.trim() || DEFAULT_STORAGE_VERSION;
-  const sanitizedNamespace = namespaceRaw.replace(/[^a-z0-9._-]+/gi, "-").toLowerCase();
-  const sanitizedVersion = versionRaw.replace(/[^a-z0-9._-]+/gi, "-").toLowerCase();
+  const sanitizedNamespace = namespaceRaw.replaceAll(/[^a-z0-9._-]+/gi, "-").toLowerCase();
+  const sanitizedVersion = versionRaw.replaceAll(/[^a-z0-9._-]+/gi, "-").toLowerCase();
   return `${sanitizedNamespace}__v${sanitizedVersion}`;
 }
 var DEFAULT_COOKIE_OPTS = {
   name: "cookieConsent",
+  maxAge: DEFAULT_MAX_AGE_SECONDS,
   maxAgeDays: 365,
   sameSite: "Lax",
-  secure: typeof window !== "undefined" ? window.location.protocol === "https:" : false,
+  secure: globalThis.window === void 0 ? false : globalThis.window.location.protocol === "https:",
   path: "/",
   domain: void 0
 };
+function resolveCookieOptions(opts) {
+  const protocols = [
+    typeof globalThis.window !== "undefined" ? globalThis.window?.location?.protocol : void 0,
+    typeof globalThis.location !== "undefined" ? globalThis.location?.protocol : void 0
+  ].filter(Boolean);
+  const forceHttps = globalThis.__LGPD_FORCE_HTTPS__ === true;
+  const isHttps = forceHttps || protocols.includes("https:");
+  const maxAgeSecondsFromDays = typeof opts?.maxAgeDays === "number" ? Math.max(0, opts.maxAgeDays * 24 * 60 * 60) : null;
+  const maxAgeSeconds = typeof opts?.maxAge === "number" ? Math.max(0, opts.maxAge) : maxAgeSecondsFromDays ?? DEFAULT_MAX_AGE_SECONDS;
+  return {
+    name: opts?.name ?? DEFAULT_COOKIE_OPTS.name,
+    maxAge: maxAgeSeconds,
+    sameSite: opts?.sameSite ?? DEFAULT_COOKIE_OPTS.sameSite ?? "Lax",
+    secure: typeof opts?.secure === "boolean" ? opts.secure : isHttps ? true : DEFAULT_COOKIE_OPTS.secure ?? false,
+    path: opts?.path ?? DEFAULT_COOKIE_OPTS.path ?? "/",
+    domain: opts?.domain ?? DEFAULT_COOKIE_OPTS.domain ?? void 0
+  };
+}
 var COOKIE_SCHEMA_VERSION = "1.0";
 function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
   logger.debug("Reading consent cookie", { name });
@@ -363,6 +383,10 @@ function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
   try {
     const data = JSON.parse(raw);
     logger.cookieOperation("read", name, data);
+    if (!data || typeof data !== "object") {
+      logger.warn("Consent cookie malformed: payload is not an object");
+      return null;
+    }
     if (!data.version) {
       logger.debug("Migrating legacy cookie format");
       return migrateLegacyCookie(data);
@@ -371,7 +395,11 @@ function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
       logger.warn(`Cookie version mismatch: ${data.version} != ${COOKIE_SCHEMA_VERSION}`);
       return null;
     }
-    return data;
+    const preferences = data && typeof data.preferences === "object" ? data.preferences : { necessary: true };
+    return {
+      ...data,
+      preferences: ensureNecessaryAlwaysOn(preferences)
+    };
   } catch (error) {
     logger.error("Error parsing consent cookie", error);
     return null;
@@ -394,12 +422,12 @@ function migrateLegacyCookie(legacyData) {
   }
 }
 function writeConsentCookie(state, config, opts, source = "banner") {
-  if (typeof document === "undefined") {
+  if (typeof document === "undefined" || typeof window === "undefined" || globalThis.__LGPD_SSR__ === true) {
     logger.debug("Cookie write skipped: server-side environment");
     return;
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
+  const o = resolveCookieOptions(opts);
   const preferences = ensureNecessaryAlwaysOn(state.preferences);
   const cookieData = {
     version: COOKIE_SCHEMA_VERSION,
@@ -411,8 +439,9 @@ function writeConsentCookie(state, config, opts, source = "banner") {
     projectConfig: config
   };
   logger.cookieOperation("write", o.name, cookieData);
+  const expires = new Date(Date.now() + o.maxAge * 1e3);
   Cookies__default.default.set(o.name, JSON.stringify(cookieData), {
-    expires: o.maxAgeDays,
+    expires,
     sameSite: o.sameSite,
     secure: o.secure,
     path: o.path,
@@ -424,38 +453,55 @@ function writeConsentCookie(state, config, opts, source = "banner") {
     preferencesCount: Object.keys(cookieData.preferences).length
   });
 }
+function createConsentAuditEntry(state, params) {
+  const preferences = ensureNecessaryAlwaysOn(state.preferences);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    action: params.action,
+    storageKey: params.storageKey,
+    consentVersion: params.consentVersion?.trim() || "1",
+    timestamp: now,
+    consentDate: state.consentDate,
+    lastUpdate: state.lastUpdate,
+    consented: state.consented,
+    preferences,
+    version: state.version,
+    source: params.origin ?? state.source,
+    projectConfig: state.projectConfig
+  };
+}
 function removeConsentCookie(opts) {
   if (typeof document === "undefined") {
     logger.debug("Cookie removal skipped: server-side environment");
     return;
   }
-  const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
+  const o = resolveCookieOptions(opts);
   logger.cookieOperation("delete", o.name);
   Cookies__default.default.remove(o.name, { path: o.path, domain: o.domain });
   logger.info("Consent cookie removed");
 }
 
 // src/utils/dataLayerEvents.ts
-var LIBRARY_VERSION = "0.6.3";
+var LIBRARY_VERSION = "0.7.1";
 function ensureDataLayer() {
-  if (typeof window === "undefined") return;
-  if (!window.dataLayer) {
-    window.dataLayer = [];
-  }
+  var _a;
+  if (globalThis.window === void 0) return;
+  (_a = globalThis.window).dataLayer ?? (_a.dataLayer = []);
 }
 function pushConsentInitializedEvent(categories) {
-  if (typeof window === "undefined") return;
+  if (globalThis.window === void 0) return;
   ensureDataLayer();
   const event = {
     event: "consent_initialized",
     consent_version: LIBRARY_VERSION,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    categories
+    categories,
+    preferences: categories
   };
-  window.dataLayer?.push(event);
+  globalThis.window.dataLayer?.push(event);
 }
 function pushConsentUpdatedEvent(categories, origin, previousCategories) {
-  if (typeof window === "undefined") return;
+  if (globalThis.window === void 0) return;
   ensureDataLayer();
   const changedCategories = previousCategories ? Object.keys(categories).filter((key) => categories[key] !== previousCategories[key]) : [];
   const event = {
@@ -464,9 +510,10 @@ function pushConsentUpdatedEvent(categories, origin, previousCategories) {
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     origin,
     categories,
+    preferences: categories,
     changed_categories: changedCategories
   };
-  window.dataLayer?.push(event);
+  globalThis.window.dataLayer?.push(event);
 }
 function useDataLayerEvents() {
   return {
@@ -655,10 +702,10 @@ var COOKIE_CATALOG_OVERRIDES = {};
 var COOKIE_CATEGORY_OVERRIDES = {};
 function setCookieCatalogOverrides(overrides) {
   COOKIE_CATALOG_OVERRIDES = {
-    byCategory: { ...COOKIE_CATALOG_OVERRIDES.byCategory || {}, ...overrides.byCategory || {} },
+    byCategory: { ...COOKIE_CATALOG_OVERRIDES.byCategory, ...overrides.byCategory },
     byIntegration: {
-      ...COOKIE_CATALOG_OVERRIDES.byIntegration || {},
-      ...overrides.byIntegration || {}
+      ...COOKIE_CATALOG_OVERRIDES.byIntegration,
+      ...overrides.byIntegration
     }
   };
 }
@@ -680,7 +727,7 @@ function getCookiesInfoForCategory(categoryId, usedIntegrations) {
         ([pattern]) => matchPattern(desc.name, pattern)
       )?.[1];
       const finalCat = overrideCat ?? defaultCat;
-      if (finalCat === categoryId && !result.find((d) => d.name === desc.name)) result.push(desc);
+      if (finalCat === categoryId && !result.some((d) => d.name === desc.name)) result.push(desc);
     });
   });
   const catOverride = COOKIE_CATALOG_OVERRIDES.byCategory?.[categoryId];
@@ -692,7 +739,7 @@ function getCookiesInfoForCategory(categoryId, usedIntegrations) {
     });
   }
   if (categoryId === "necessary") {
-    if (!result.find((d) => d.name === "cookieConsent")) {
+    if (!result.some((d) => d.name === "cookieConsent")) {
       result.push({
         name: "cookieConsent",
         purpose: "Armazena suas prefer\xEAncias de consentimento",
@@ -1073,58 +1120,8 @@ var GUIDANCE_PRESETS = {
 };
 
 // src/utils/peerDepsCheck.ts
-function detectMultipleReactInstances() {
-  if (typeof window === "undefined") return false;
-  try {
-    const reactSymbols = Object.getOwnPropertySymbols(window).map((sym) => String(sym)).filter((name) => name.includes("react"));
-    if (reactSymbols.length > 1) {
-      return true;
-    }
-    const ReactModule = window.React;
-    if (ReactModule && Array.isArray(ReactModule)) {
-      return true;
-    }
-    const hasMultipleVersions = window.__REACT_DEVTOOLS_GLOBAL_HOOK__?.renderers?.size > 1;
-    return hasMultipleVersions || false;
-  } catch {
-    return false;
-  }
-}
-function getPackageVersion(packageName) {
-  if (typeof window === "undefined") return null;
-  try {
-    const pkg = window[packageName];
-    if (pkg?.version) return pkg.version;
-    const React6 = window.React;
-    if (packageName === "react" && React6?.version) {
-      return React6.version;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function isVersionInRange(version, minMajor, maxMajor) {
-  const major = parseInt(version.split(".")[0], 10);
-  return major >= minMajor && major <= maxMajor;
-}
-function checkPeerDeps(options = {}) {
-  const { skipInProduction = true, logWarnings = true } = options;
-  const result = {
-    ok: true,
-    warnings: [],
-    errors: []
-  };
-  const isProduction = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
-  if (skipInProduction && isProduction) {
-    return result;
-  }
-  if (typeof window === "undefined") {
-    return result;
-  }
-  if (detectMultipleReactInstances()) {
-    result.ok = false;
-    const errorMsg = `
+var MESSAGES_PT_BR = {
+  MULTIPLE_REACT_INSTANCES: `
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551 \u26A0\uFE0F  ERRO: M\xFAltiplas inst\xE2ncias de React detectadas                           \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
@@ -1186,22 +1183,13 @@ function checkPeerDeps(options = {}) {
    https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#multiple-react-instances
 
 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-`;
-    result.errors.push(errorMsg);
-    if (logWarnings) {
-      console.error(errorMsg);
-    }
-  }
-  const reactVersion = getPackageVersion("react");
-  if (reactVersion) {
-    if (!isVersionInRange(reactVersion, 18, 19)) {
-      result.ok = false;
-      const errorMsg = `
+`,
+  UNSUPPORTED_REACT_VERSION: (version) => `
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551 \u26A0\uFE0F  AVISO: Vers\xE3o do React n\xE3o suportada                                     \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
 
-\u{1F4E6} Vers\xE3o detectada: React ${reactVersion}
+\u{1F4E6} Vers\xE3o detectada: React ${version}
 \u2705 Vers\xF5es suportadas: React 18.x ou 19.x
 
 \u{1F50D} O react-lgpd-consent requer React 18.2.0+ ou React 19.x
@@ -1219,27 +1207,13 @@ function checkPeerDeps(options = {}) {
    https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#react-version
 
 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-`;
-      result.errors.push(errorMsg);
-      if (logWarnings) {
-        console.error(errorMsg);
-      }
-    }
-  }
-  const muiVersion = window["@mui/material"]?.version;
-  if (muiVersion) {
-    if (!isVersionInRange(muiVersion, 5, 7)) {
-      result.warnings.push(
-        `MUI vers\xE3o ${muiVersion} detectada. Vers\xF5es suportadas: 5.15.0+, 6.x ou 7.x. Alguns componentes podem n\xE3o funcionar corretamente.`
-      );
-      if (logWarnings) {
-        logger.warn(
-          `
+`,
+  UNSUPPORTED_MUI_VERSION: (version) => `
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551 \u26A0\uFE0F  AVISO: Vers\xE3o do Material-UI fora do range recomendado                   \u2551
 \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
 
-\u{1F4E6} Vers\xE3o detectada: @mui/material ${muiVersion}
+\u{1F4E6} Vers\xE3o detectada: @mui/material ${version}
 \u2705 Vers\xF5es suportadas: 5.15.0+, 6.x, 7.x
 
 \u{1F50D} Componentes de UI (@react-lgpd-consent/mui) podem apresentar problemas.
@@ -1257,8 +1231,227 @@ function checkPeerDeps(options = {}) {
    https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#mui-version
 
 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-`
-        );
+`,
+  MUI_OUT_OF_RANGE: (version) => `MUI vers\xE3o ${version} detectada. Vers\xF5es suportadas: 5.15.0+, 6.x ou 7.x. Alguns componentes podem n\xE3o funcionar corretamente.`
+};
+var MESSAGES_EN = {
+  MULTIPLE_REACT_INSTANCES: `
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551 \u26A0\uFE0F  ERROR: Multiple React instances detected                                 \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+
+\u{1F534} Problem:
+   Your project is loading more than one copy of React, causing the error:
+   "Invalid hook call. Hooks can only be called inside of the body of a 
+    function component."
+
+\u{1F50D} Probable cause:
+   \u2022 pnpm/Yarn PnP without proper peer dependency hoisting
+   \u2022 node_modules with duplicate React (classic npm/yarn)
+   \u2022 Webpack/Vite with multiple resolutions of the same package
+
+\u2705 Solutions:
+
+   \u{1F4E6} PNPM (RECOMMENDED):
+      Add to root package.json:
+      {
+        "pnpm": {
+          "overrides": {
+            "react": "$react",
+            "react-dom": "$react-dom"
+          }
+        }
+      }
+      Run: pnpm install
+
+   \u{1F4E6} NPM/Yarn:
+      Add to root package.json:
+      {
+        "overrides": {
+          "react": "^18.2.0 || ^19.0.0",
+          "react-dom": "^18.2.0 || ^19.0.0"
+        }
+      }
+      Run: npm install (or yarn install)
+      
+   \u{1F527} Webpack:
+      Add to webpack.config.js:
+      module.exports = {
+        resolve: {
+          alias: {
+            react: path.resolve('./node_modules/react'),
+            'react-dom': path.resolve('./node_modules/react-dom'),
+          }
+        }
+      }
+
+   \u26A1 Vite:
+      Add to vite.config.js:
+      export default {
+        resolve: {
+          dedupe: ['react', 'react-dom']
+        }
+      }
+
+\u{1F4DA} Documentation:
+   https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#multiple-react-instances
+
+\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`,
+  UNSUPPORTED_REACT_VERSION: (version) => `
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551 \u26A0\uFE0F  WARNING: Unsupported React version                                       \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+
+\u{1F4E6} Detected version: React ${version}
+\u2705 Supported versions: React 18.x or 19.x
+
+\u{1F50D} react-lgpd-consent requires React 18.2.0+ or React 19.x
+
+\u2705 Solution:
+   Update React to a supported version:
+   
+   npm install react@^18.2.0 react-dom@^18.2.0
+   
+   or
+   
+   npm install react@^19.0.0 react-dom@^19.0.0
+
+\u{1F4DA} Documentation:
+   https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#react-version
+
+\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`,
+  UNSUPPORTED_MUI_VERSION: (version) => `
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551 \u26A0\uFE0F  WARNING: Material-UI version out of recommended range                    \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+
+\u{1F4E6} Detected version: @mui/material ${version}
+\u2705 Supported versions: 5.15.0+, 6.x, 7.x
+
+\u{1F50D} UI components (@react-lgpd-consent/mui) may have issues.
+
+\u2705 Solution:
+   Update MUI to a supported version:
+   
+   npm install @mui/material@^7.0.0 @emotion/react @emotion/styled
+   
+   or keep 5.15.0+:
+   
+   npm install @mui/material@^5.15.0 @emotion/react @emotion/styled
+
+\u{1F4DA} Documentation:
+   https://github.com/lucianoedipo/react-lgpd-consent/blob/main/TROUBLESHOOTING.md#mui-version
+
+\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+`,
+  MUI_OUT_OF_RANGE: (version) => `MUI version ${version} detected. Supported versions: 5.15.0+, 6.x or 7.x. Some components may not work properly.`
+};
+var MESSAGES_BY_LOCALE = {
+  "pt-BR": MESSAGES_PT_BR,
+  en: MESSAGES_EN
+};
+var currentLocale = "pt-BR";
+var customMessages = {};
+function setPeerDepsLocale(locale) {
+  currentLocale = locale;
+}
+function getPeerDepsLocale() {
+  return currentLocale;
+}
+function setPeerDepsMessages(messages) {
+  customMessages = { ...customMessages, ...messages };
+}
+function resetPeerDepsMessages() {
+  customMessages = {};
+}
+function getMessages() {
+  const baseMessages = MESSAGES_BY_LOCALE[currentLocale];
+  if (Object.keys(customMessages).length === 0) {
+    return baseMessages;
+  }
+  return {
+    MULTIPLE_REACT_INSTANCES: customMessages.MULTIPLE_REACT_INSTANCES ?? baseMessages.MULTIPLE_REACT_INSTANCES,
+    UNSUPPORTED_REACT_VERSION: customMessages.UNSUPPORTED_REACT_VERSION ?? baseMessages.UNSUPPORTED_REACT_VERSION,
+    UNSUPPORTED_MUI_VERSION: customMessages.UNSUPPORTED_MUI_VERSION ?? baseMessages.UNSUPPORTED_MUI_VERSION,
+    MUI_OUT_OF_RANGE: customMessages.MUI_OUT_OF_RANGE ?? baseMessages.MUI_OUT_OF_RANGE
+  };
+}
+function detectMultipleReactInstances() {
+  if (globalThis.window === void 0) return false;
+  try {
+    const reactSymbols = Object.getOwnPropertySymbols(globalThis.window).map(String).filter((name) => name.includes("react"));
+    if (reactSymbols.length > 1) {
+      return true;
+    }
+    const ReactModule = window.React;
+    if (ReactModule && Array.isArray(ReactModule)) {
+      return true;
+    }
+    const hasMultipleVersions = window.__REACT_DEVTOOLS_GLOBAL_HOOK__?.renderers?.size > 1;
+    return hasMultipleVersions || false;
+  } catch {
+    return false;
+  }
+}
+function getPackageVersion(packageName) {
+  if (globalThis.window === void 0) return null;
+  try {
+    const pkg = window[packageName];
+    if (pkg?.version) return pkg.version;
+    const React6 = window.React;
+    if (packageName === "react" && React6?.version) {
+      return React6.version;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function isVersionInRange(version, minMajor, maxMajor) {
+  const major = Number.parseInt(version.split(".")[0], 10);
+  return major >= minMajor && major <= maxMajor;
+}
+function checkPeerDeps(options = {}) {
+  const { skipInProduction = true, logWarnings = true } = options;
+  const result = {
+    ok: true,
+    warnings: [],
+    errors: []
+  };
+  const isProduction = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  if (skipInProduction && isProduction) {
+    return result;
+  }
+  if (globalThis.window === void 0) {
+    return result;
+  }
+  const messages = getMessages();
+  if (detectMultipleReactInstances()) {
+    result.ok = false;
+    result.errors.push(messages.MULTIPLE_REACT_INSTANCES);
+    if (logWarnings) {
+      console.error(messages.MULTIPLE_REACT_INSTANCES);
+    }
+  }
+  const reactVersion = getPackageVersion("react");
+  if (reactVersion) {
+    if (!isVersionInRange(reactVersion, 18, 19)) {
+      result.ok = false;
+      const errorMsg = messages.UNSUPPORTED_REACT_VERSION(reactVersion);
+      result.errors.push(errorMsg);
+      if (logWarnings) {
+        console.error(errorMsg);
+      }
+    }
+  }
+  const muiVersion = window["@mui/material"]?.version;
+  if (muiVersion) {
+    if (!isVersionInRange(muiVersion, 5, 7)) {
+      result.warnings.push(messages.MUI_OUT_OF_RANGE(muiVersion));
+      if (logWarnings) {
+        logger.warn(messages.UNSUPPORTED_MUI_VERSION(muiVersion));
       }
     }
   }
@@ -1281,7 +1474,7 @@ function validateConsentProviderProps(props) {
   const sanitized = {};
   if (!isDev()) {
     if (props.categories) {
-      const enabled = Array.from(/* @__PURE__ */ new Set([...props.categories.enabledCategories ?? []]));
+      const enabled = [...new Set(props.categories.enabledCategories ?? [])];
       const sanitizedEnabled = enabled.filter((c) => c !== "necessary");
       sanitized.categories = {
         enabledCategories: sanitizedEnabled,
@@ -1318,11 +1511,11 @@ function validateConsentProviderProps(props) {
   }
   if (!props.categories) {
     warnings.push(
-      "Prop 'categories' n\xE3o fornecida. A lib aplicar\xE1 um padr\xE3o seguro, mas recomenda-se definir 'categories.enabledCategories' explicitamente para clareza e auditoria."
+      "Prop 'categories' n\xE3o fornecida \u2014 o ConsentProvider requer configura\xE7\xE3o de categorias."
     );
   } else {
     const cat = props.categories;
-    const enabled = Array.from(/* @__PURE__ */ new Set([...cat.enabledCategories ?? []]));
+    const enabled = [...new Set(cat.enabledCategories ?? [])];
     if (enabled.includes("necessary")) {
       warnings.push("'necessary' \xE9 sempre inclu\xEDda automaticamente \u2014 remova de enabledCategories.");
     }
@@ -1330,7 +1523,7 @@ function validateConsentProviderProps(props) {
     const invalidEnabled = sanitizedEnabled.filter((c) => typeof c !== "string" || c.trim() === "");
     if (invalidEnabled.length > 0) {
       warnings.push(
-        `enabledCategories cont\xE9m valores inv\xE1lidos: ${invalidEnabled.map((v) => String(v)).join(", ")} \u2014 remova ou corrija os IDs de categoria`
+        `enabledCategories cont\xE9m valores inv\xE1lidos: ${invalidEnabled.map(String).join(", ")} \u2014 remova ou corrija os IDs de categoria`
       );
     }
     const custom = cat.customCategories ?? [];
@@ -1424,13 +1617,13 @@ function detectConsentCookieName() {
   }
   return null;
 }
+function matchPattern2(name, pattern) {
+  if (pattern.endsWith("*")) return name.startsWith(pattern.slice(0, -1));
+  return name === pattern;
+}
 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) => {
@@ -1438,9 +1631,9 @@ function categorizeDiscoveredCookies(discovered, registerOverrides = false) {
       const patterns = COOKIE_PATTERNS_BY_CATEGORY[cat2] || [];
       if (patterns.some((p) => matchPattern2(d.name, p))) assigned = cat2;
     });
-    const cat = assigned || "analytics";
+    const cat = assigned ?? "analytics";
     out[cat] = out[cat] || [];
-    if (!out[cat].find((x) => x.name === d.name)) out[cat].push(d);
+    if (!out[cat].some((x) => x.name === d.name)) out[cat].push(d);
   });
   if (registerOverrides) {
     const byCategory = {};
@@ -1517,7 +1710,7 @@ function useCategories() {
   const context = React4__namespace.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."
+      "[react-lgpd-consent] useCategories deve ser usado dentro de <ConsentProvider>. Adicione o provider ao redor da sua \xE1rvore antes de chamar o hook."
     );
   }
   return context;
@@ -1668,6 +1861,11 @@ var StateCtx = React4__namespace.createContext(null);
 var ActionsCtx = React4__namespace.createContext(null);
 var TextsCtx = React4__namespace.createContext(DEFAULT_TEXTS);
 var HydrationCtx = React4__namespace.createContext(false);
+function buildProviderError(hookName) {
+  return new Error(
+    `[react-lgpd-consent] ${hookName} deve ser usado dentro de <ConsentProvider>. Envolva seu componente com o provider ou use o wrapper @react-lgpd-consent/mui.`
+  );
+}
 function ConsentProvider({
   initialState,
   categories,
@@ -1691,7 +1889,10 @@ function ConsentProvider({
   disableDeveloperGuidance,
   guidanceConfig,
   children,
-  disableDiscoveryLog
+  disableDiscoveryLog,
+  onConsentInit,
+  onConsentChange,
+  onAuditLog
 }) {
   const texts = React4__namespace.useMemo(() => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }), [textsProp]);
   const cookie = React4__namespace.useMemo(() => {
@@ -1705,6 +1906,14 @@ function ConsentProvider({
     }
     return base;
   }, [cookieOpts, storage?.domain, storage?.namespace, storage?.version]);
+  const consentVersion = storage?.version?.trim() || "1";
+  React4__namespace.useEffect(() => {
+    try {
+      ;
+      globalThis.__LGPD_CONSENT_COOKIE__ = cookie.name;
+    } catch {
+    }
+  }, [cookie.name]);
   const finalCategoriesConfig = React4__namespace.useMemo(() => {
     const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
     if (!categories) return DEFAULT_PROJECT_CATEGORIES;
@@ -1751,6 +1960,8 @@ function ConsentProvider({
   const skipCookiePersistRef = React4__namespace.useRef(false);
   const [isHydrated, setIsHydrated] = React4__namespace.useState(false);
   const previousPreferencesRef = React4__namespace.useRef(state.preferences);
+  const auditInitEmittedRef = React4__namespace.useRef(false);
+  const previousConsentedAuditRef = React4__namespace.useRef(state.consented);
   React4__namespace.useEffect(() => {
     if (!initialState) {
       const saved = readConsentCookie(cookie.name);
@@ -1799,13 +2010,44 @@ function ConsentProvider({
       logger.info("DataLayer: consent_initialized event dispatched", {
         preferences: state.preferences
       });
+      if (onConsentInit) onConsentInit(state);
     }
   }, [isHydrated]);
+  React4__namespace.useEffect(() => {
+    if (!isHydrated) return;
+    if (!onAuditLog) return;
+    if (auditInitEmittedRef.current) return;
+    onAuditLog(
+      createConsentAuditEntry(state, {
+        action: "init",
+        storageKey: cookie.name,
+        consentVersion
+      })
+    );
+    auditInitEmittedRef.current = true;
+  }, [isHydrated, onAuditLog, state, cookie.name, consentVersion]);
   React4__namespace.useEffect(() => {
     if (!state.consented) return;
     if (skipCookiePersistRef.current) return;
     writeConsentCookie(state, finalCategoriesConfig, cookie);
   }, [state, cookie, finalCategoriesConfig]);
+  React4__namespace.useEffect(() => {
+    if (!onAuditLog) {
+      previousConsentedAuditRef.current = state.consented;
+      return;
+    }
+    if (previousConsentedAuditRef.current && !state.consented) {
+      onAuditLog(
+        createConsentAuditEntry(state, {
+          action: "reset",
+          storageKey: cookie.name,
+          consentVersion,
+          origin: "reset"
+        })
+      );
+    }
+    previousConsentedAuditRef.current = state.consented;
+  }, [state, onAuditLog, cookie.name, consentVersion]);
   const prevConsented = React4__namespace.useRef(state.consented);
   React4__namespace.useEffect(() => {
     if (!prevConsented.current && state.consented && onConsentGiven) {
@@ -1826,9 +2068,32 @@ function ConsentProvider({
         preferences: state.preferences,
         consented: state.consented
       });
+      if (onConsentChange) {
+        onConsentChange(state, { origin });
+      }
+      if (onAuditLog) {
+        onAuditLog(
+          createConsentAuditEntry(state, {
+            action: "update",
+            storageKey: cookie.name,
+            consentVersion,
+            origin
+          })
+        );
+      }
       previousPreferencesRef.current = state.preferences;
     }
-  }, [state.preferences, state.consented, state.source, isHydrated]);
+  }, [
+    state,
+    state.preferences,
+    state.consented,
+    state.source,
+    isHydrated,
+    onConsentChange,
+    onAuditLog,
+    cookie.name,
+    consentVersion
+  ]);
   const api = React4__namespace.useMemo(() => {
     const acceptAll = () => dispatch({ type: "ACCEPT_ALL", config: finalCategoriesConfig });
     const rejectAll = () => dispatch({ type: "REJECT_ALL", config: finalCategoriesConfig });
@@ -1879,6 +2144,14 @@ function ConsentProvider({
     if (typeof backdrop === "string") return backdrop;
     return "rgba(0, 0, 0, 0.4)";
   }, [designTokens]);
+  const cookieBannerPropsWithDefaults = React4__namespace.useMemo(() => {
+    const incoming = cookieBannerProps ?? {};
+    return {
+      ...incoming,
+      blocking: incoming.blocking === void 0 ? blocking : Boolean(incoming.blocking),
+      hideBranding: incoming.hideBranding === void 0 ? _hideBranding : Boolean(incoming.hideBranding)
+    };
+  }, [cookieBannerProps, blocking, _hideBranding]);
   const content = /* @__PURE__ */ jsxRuntime.jsx(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsxRuntime.jsx(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsxRuntime.jsx(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsxRuntime.jsx(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ jsxRuntime.jsx(DesignProvider, { tokens: designTokens, children: /* @__PURE__ */ jsxRuntime.jsxs(
     CategoriesProvider,
     {
@@ -1899,7 +2172,7 @@ function ConsentProvider({
           }
         ) : (
           // Aviso de desenvolvimento: usuário pode estar esquecendo de fornecer componentes UI
-          process.env.NODE_ENV === "development" && typeof window !== "undefined" && !didWarnAboutMissingUI.current && !CookieBannerComponent && !FloatingPreferencesButtonComponent && (() => {
+          process.env.NODE_ENV === "development" && globalThis.window !== void 0 && !didWarnAboutMissingUI.current && !CookieBannerComponent && !FloatingPreferencesButtonComponent && (() => {
             didWarnAboutMissingUI.current = true;
             console.warn(
               "%c[@react-lgpd-consent/core] Aviso: Nenhum componente UI fornecido",
@@ -1961,8 +2234,7 @@ function ConsentProvider({
             rejectAll: api.rejectAll,
             openPreferences: api.openPreferences,
             texts,
-            blocking,
-            ...cookieBannerProps
+            ...cookieBannerPropsWithDefaults
           }
         ),
         state.consented && !disableFloatingPreferencesButton && FloatingPreferencesButtonComponent && /* @__PURE__ */ jsxRuntime.jsx(
@@ -1980,12 +2252,12 @@ function ConsentProvider({
 }
 function useConsentStateInternal() {
   const ctx = React4__namespace.useContext(StateCtx);
-  if (!ctx) throw new Error("useConsentState must be used within ConsentProvider");
+  if (!ctx) throw buildProviderError("useConsentState");
   return ctx;
 }
 function useConsentActionsInternal() {
   const ctx = React4__namespace.useContext(ActionsCtx);
-  if (!ctx) throw new Error("useConsentActions must be used within ConsentProvider");
+  if (!ctx) throw buildProviderError("useConsentActions");
   return ctx;
 }
 function useConsentTextsInternal() {
@@ -2004,45 +2276,99 @@ function ConsentGate(props) {
 
 // src/utils/scriptLoader.ts
 var LOADING_SCRIPTS = /* @__PURE__ */ new Map();
-function loadScript(id, src, category = null, attrs = {}) {
+var DEFAULT_POLL_INTERVAL = 100;
+function resolveCookieNames(preferred) {
+  const inferred = globalThis.__LGPD_CONSENT_COOKIE__ ?? null;
+  const names = [preferred, inferred, "cookieConsent", "lgpd-consent__v1"].filter(
+    Boolean
+  );
+  return Array.from(new Set(names));
+}
+function parseConsentFromCookie(names) {
+  const raw = document.cookie;
+  if (!raw) return null;
+  const cookies = raw.split("; ").reduce((acc, part) => {
+    const [k, ...rest] = part.split("=");
+    acc[k] = rest.join("=");
+    return acc;
+  }, {});
+  for (const name of names) {
+    const value = cookies[name];
+    if (!value) continue;
+    try {
+      const parsed = JSON.parse(decodeURIComponent(value));
+      if (!parsed.consented || parsed.isModalOpen) continue;
+      return parsed;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+function hasCategoryConsent(snapshot, category) {
+  if (!snapshot.consented || snapshot.isModalOpen) return false;
+  if (category === null) return true;
+  return Boolean(snapshot.preferences?.[category]);
+}
+function loadScript(id, src, category = null, attrs = {}, nonce, options) {
   if (typeof document === "undefined") return Promise.resolve();
   if (document.getElementById(id)) return Promise.resolve();
   const existingPromise = LOADING_SCRIPTS.get(id);
   if (existingPromise) return existingPromise;
+  const pollInterval = options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL;
+  const names = resolveCookieNames(options?.cookieName);
+  const mergedAttrs = { ...attrs };
   const promise = new Promise((resolve, reject) => {
+    const inject = () => {
+      const s = document.createElement("script");
+      s.id = id;
+      s.src = src;
+      s.async = mergedAttrs.async !== "false";
+      const scriptNonce = mergedAttrs.nonce || nonce;
+      if (scriptNonce) {
+        s.nonce = scriptNonce;
+        mergedAttrs.nonce = scriptNonce;
+      }
+      for (const [k, v] of Object.entries(mergedAttrs)) s.setAttribute(k, v);
+      s.onload = () => {
+        LOADING_SCRIPTS.delete(id);
+        resolve();
+      };
+      s.onerror = () => {
+        LOADING_SCRIPTS.delete(id);
+        reject(new Error(`Failed to load script: ${src}`));
+      };
+      document.body.appendChild(s);
+    };
+    const snapshot = options?.consentSnapshot;
+    const skipChecks = options?.skipConsentCheck === true;
+    if (skipChecks) {
+      inject();
+      return;
+    }
+    if (snapshot) {
+      if (!hasCategoryConsent(snapshot, category)) {
+        reject(
+          new Error(
+            `Consent not granted for category '${category ?? "none"}' when attempting to load ${id}`
+          )
+        );
+        return;
+      }
+      inject();
+      return;
+    }
     const checkConsent = () => {
-      const consentCookie = document.cookie.split("; ").find((row) => row.startsWith("cookieConsent="))?.split("=")[1];
-      if (!consentCookie) {
-        setTimeout(checkConsent, 100);
+      const consent = parseConsentFromCookie(names);
+      if (!consent) {
+        setTimeout(checkConsent, pollInterval);
         return;
       }
-      try {
-        const consent = JSON.parse(decodeURIComponent(consentCookie));
-        if (!consent.consented || consent.isModalOpen) {
-          setTimeout(checkConsent, 100);
-          return;
-        }
-        if (category && !consent.preferences[category]) {
-          setTimeout(checkConsent, 100);
-          return;
-        }
-        const s = document.createElement("script");
-        s.id = id;
-        s.src = src;
-        s.async = true;
-        for (const [k, v] of Object.entries(attrs)) s.setAttribute(k, v);
-        s.onload = () => {
-          LOADING_SCRIPTS.delete(id);
-          resolve();
-        };
-        s.onerror = () => {
-          LOADING_SCRIPTS.delete(id);
-          reject(new Error(`Failed to load script: ${src}`));
-        };
-        document.body.appendChild(s);
-      } catch {
-        setTimeout(checkConsent, 100);
+      if (!hasCategoryConsent(consent, category)) {
+        setTimeout(checkConsent, pollInterval);
+        return;
       }
+      inject();
     };
     checkConsent();
   });
@@ -2206,13 +2532,107 @@ function validateNecessaryClassification(integrations, enabledCategories) {
 }
 
 // src/utils/ConsentScriptLoader.tsx
+var scriptRegistry = /* @__PURE__ */ new Map();
+var queueListeners = /* @__PURE__ */ new Set();
+function notifyQueue() {
+  queueListeners.forEach((listener) => {
+    try {
+      listener();
+    } catch {
+    }
+  });
+}
+function subscribeQueue(listener) {
+  queueListeners.add(listener);
+  return () => {
+    queueListeners.delete(listener);
+  };
+}
+function createInternalScript(def) {
+  return {
+    ...def,
+    status: "pending",
+    lastAllowed: false,
+    registeredAt: Date.now(),
+    token: Date.now() + Math.random(),
+    priority: def.priority ?? 0,
+    allowReload: def.allowReload ?? false,
+    onConsentUpdate: def.onConsentUpdate
+  };
+}
+function registerScript(def) {
+  const entry = createInternalScript(def);
+  scriptRegistry.set(def.id, entry);
+  notifyQueue();
+  return () => {
+    const current = scriptRegistry.get(def.id);
+    if (current && current.token === entry.token) {
+      scriptRegistry.delete(def.id);
+      notifyQueue();
+    }
+  };
+}
+function getExecutableScripts(consent) {
+  const allowedScripts = [];
+  scriptRegistry.forEach((script) => {
+    const categoryAllowed = script.category === "necessary" || consent.consented && Boolean(consent.preferences?.[script.category]);
+    if (!categoryAllowed) {
+      script.lastAllowed = false;
+      return;
+    }
+    if (script.status === "running") return;
+    if (script.status === "executed" && !script.allowReload) return;
+    if (script.status === "executed" && script.allowReload && script.lastAllowed) return;
+    script.lastAllowed = true;
+    allowedScripts.push(script);
+  });
+  return allowedScripts.sort((a, b) => {
+    if (a.category === "necessary" && b.category !== "necessary") return -1;
+    if (b.category === "necessary" && a.category !== "necessary") return 1;
+    if (a.category !== b.category) return a.category.localeCompare(b.category);
+    if (a.priority !== b.priority) return (b.priority ?? 0) - (a.priority ?? 0);
+    return a.registeredAt - b.registeredAt;
+  });
+}
+async function processQueue(consent, devLogging) {
+  const scripts = getExecutableScripts(consent);
+  let order = 0;
+  for (const script of scripts) {
+    order += 1;
+    script.status = "running";
+    if (devLogging) {
+      logger.info("[ConsentScriptLoader] executando script", {
+        id: script.id,
+        category: script.category,
+        priority: script.priority ?? 0,
+        order
+      });
+    }
+    try {
+      await Promise.resolve(script.execute());
+    } catch (error) {
+      logger.error(`\u274C Failed to execute script ${script.id}`, error);
+    } finally {
+      script.status = "executed";
+      if (script.onConsentUpdate) {
+        script.onConsentUpdate(consent);
+      }
+    }
+  }
+}
 function ConsentScriptLoader({
   integrations,
-  reloadOnChange = false
+  reloadOnChange = false,
+  nonce
 }) {
   const { preferences, consented } = useConsent();
+  const isHydrated = useConsentHydration();
   const categories = useCategories();
-  const loadedScripts = React4__namespace.useRef(/* @__PURE__ */ new Set());
+  const [queueVersion, bumpQueueVersion] = React4__namespace.useState(0);
+  React4__namespace.useEffect(() => {
+    const unsubscribe = subscribeQueue(() => bumpQueueVersion((v) => v + 1));
+    return unsubscribe;
+  }, []);
   React4__namespace.useEffect(() => {
     try {
       const ids = (integrations || []).map((i) => i.id);
@@ -2241,8 +2661,8 @@ function ConsentScriptLoader({
       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"));
+      if (globalThis.window !== void 0 && typeof globalThis.window.dispatchEvent === "function") {
+        globalThis.window.dispatchEvent(new CustomEvent("lgpd:requiredCategories"));
       }
     } catch {
     }
@@ -2250,7 +2670,7 @@ function ConsentScriptLoader({
   React4__namespace.useEffect(() => {
     const isDev2 = process.env.NODE_ENV !== "production";
     if (!isDev2 || integrations.length === 0) return;
-    const enabledCategories = categories.allCategories.map((cat) => cat.id);
+    const enabledCategories = categories.config.enabledCategories ?? [];
     const isValid = validateIntegrationCategories(integrations, enabledCategories);
     if (!isValid) {
       autoConfigureCategories({ enabledCategories }, integrations, {
@@ -2273,38 +2693,99 @@ function ConsentScriptLoader({
       console.groupEnd();
     }
   }, [integrations, categories]);
+  const processedIntegrationsRef = React4__namespace.useRef(/* @__PURE__ */ new Map());
   React4__namespace.useEffect(() => {
-    if (!consented) return;
-    const timeoutId = setTimeout(async () => {
-      for (const integration of integrations) {
-        const shouldLoad = preferences[integration.category];
-        const alreadyLoaded = loadedScripts.current.has(integration.id);
-        if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
-          try {
+    const cleanups = [];
+    const currentIds = /* @__PURE__ */ new Set();
+    integrations.forEach((integration) => {
+      currentIds.add(integration.id);
+      const structuralHash = JSON.stringify({
+        category: integration.category,
+        src: integration.src,
+        priority: integration.priority,
+        hasBootstrap: Boolean(integration.bootstrap),
+        hasInit: Boolean(integration.init),
+        hasOnConsentUpdate: Boolean(integration.onConsentUpdate)
+      });
+      const existingHash = processedIntegrationsRef.current.get(integration.id);
+      if (existingHash === structuralHash && scriptRegistry.has(integration.id)) {
+        return;
+      }
+      processedIntegrationsRef.current.set(integration.id, structuralHash);
+      if (integration.bootstrap) {
+        cleanups.push(
+          registerScript({
+            id: `${integration.id}__bootstrap`,
+            category: "necessary",
+            priority: (integration.priority ?? 0) + 1e3,
+            execute: integration.bootstrap
+          })
+        );
+      }
+      cleanups.push(
+        registerScript({
+          id: integration.id,
+          category: integration.category,
+          priority: integration.priority,
+          allowReload: reloadOnChange,
+          onConsentUpdate: integration.onConsentUpdate,
+          execute: async () => {
+            const mergedAttrs = integration.attrs ? { ...integration.attrs } : {};
+            const scriptNonce = integration.nonce ?? nonce;
+            if (scriptNonce && !mergedAttrs.nonce) mergedAttrs.nonce = scriptNonce;
             await loadScript(
               integration.id,
               integration.src,
               integration.category,
-              integration.attrs
+              mergedAttrs,
+              scriptNonce,
+              { skipConsentCheck: true }
             );
             if (integration.init) {
               integration.init();
             }
-            loadedScripts.current.add(integration.id);
-          } catch (error) {
-            logger.error(`\u274C Failed to load script: ${integration.id}`, error);
           }
+        })
+      );
+    });
+    processedIntegrationsRef.current.forEach((_, id) => {
+      if (!currentIds.has(id)) {
+        processedIntegrationsRef.current.delete(id);
+        const script = scriptRegistry.get(id);
+        if (script) {
+          scriptRegistry.delete(id);
+        }
+        const bootstrapScript = scriptRegistry.get(`${id}__bootstrap`);
+        if (bootstrapScript) {
+          scriptRegistry.delete(`${id}__bootstrap`);
         }
       }
-    }, 0);
-    return () => clearTimeout(timeoutId);
-  }, [preferences, consented, integrations, reloadOnChange]);
+    });
+    return () => cleanups.forEach((fn) => fn());
+  }, [integrations, reloadOnChange, nonce]);
+  React4__namespace.useEffect(() => {
+    if (!isHydrated) return;
+    void processQueue({ consented, preferences }, process.env.NODE_ENV !== "production");
+  }, [consented, preferences, isHydrated, queueVersion]);
+  React4__namespace.useEffect(() => {
+    if (!isHydrated) return;
+    scriptRegistry.forEach((script) => {
+      if (script.status !== "executed") return;
+      if (typeof script.onConsentUpdate !== "function") return;
+      script.onConsentUpdate({ consented, preferences });
+    });
+  }, [consented, preferences, isHydrated]);
   return null;
 }
 function useConsentScriptLoader() {
   const { preferences, consented } = useConsent();
+  const isHydrated = useConsentHydration();
   return React4__namespace.useCallback(
-    async (integration) => {
+    async (integration, nonce) => {
+      if (!isHydrated) {
+        logger.warn(`\u26A0\uFE0F Cannot load script ${integration.id}: Consent not hydrated yet`);
+        return false;
+      }
       if (!consented) {
         logger.warn(`\u26A0\uFE0F Cannot load script ${integration.id}: No consent given`);
         return false;
@@ -2317,7 +2798,20 @@ function useConsentScriptLoader() {
         return false;
       }
       try {
-        await loadScript(integration.id, integration.src, integration.category, integration.attrs);
+        const mergedAttrs = integration.attrs ? { ...integration.attrs } : {};
+        const scriptNonce = integration.nonce ?? nonce;
+        if (scriptNonce && !mergedAttrs.nonce) mergedAttrs.nonce = scriptNonce;
+        await loadScript(
+          integration.id,
+          integration.src,
+          integration.category,
+          mergedAttrs,
+          scriptNonce,
+          {
+            consentSnapshot: { consented, preferences },
+            skipConsentCheck: true
+          }
+        );
         if (integration.init) {
           integration.init();
         }
@@ -2327,11 +2821,62 @@ function useConsentScriptLoader() {
         return false;
       }
     },
-    [preferences, consented]
+    [preferences, consented, isHydrated]
   );
 }
 
 // src/utils/scriptIntegrations.ts
+function buildConsentModeSignals(preferences) {
+  const analytics = preferences.analytics ? "granted" : "denied";
+  const marketing = preferences.marketing ? "granted" : "denied";
+  return {
+    ad_storage: marketing,
+    ad_user_data: marketing,
+    ad_personalization: marketing,
+    analytics_storage: analytics
+  };
+}
+function pushToLayer(entry, dataLayerName) {
+  if (typeof globalThis.window === "undefined") return;
+  const registry = globalThis.window;
+  const name = dataLayerName ?? "dataLayer";
+  const layer = registry[name] ?? [];
+  registry[name] = layer;
+  layer.push(entry);
+}
+function ensureGtag(dataLayerName = "dataLayer") {
+  if (typeof globalThis.window === "undefined") return null;
+  const w = window;
+  const registry = w;
+  const layer = registry[dataLayerName] ?? [];
+  registry[dataLayerName] = layer;
+  if (typeof w.gtag !== "function") {
+    const gtag = (...args) => {
+      layer.push(args);
+    };
+    w.gtag = gtag;
+  }
+  return w.gtag;
+}
+function applyDefaultConsentMode(dataLayerName) {
+  const payload = buildConsentModeSignals({
+    analytics: false,
+    marketing: false
+  });
+  const gtag = ensureGtag(dataLayerName);
+  if (gtag) {
+    gtag("consent", "default", payload);
+  }
+  pushToLayer(["consent", "default", payload], dataLayerName);
+}
+function applyConsentModeUpdate(preferences, dataLayerName) {
+  const payload = buildConsentModeSignals(preferences);
+  const gtag = ensureGtag(dataLayerName);
+  if (gtag) {
+    gtag("consent", "update", payload);
+  }
+  pushToLayer(["consent", "update", payload], dataLayerName);
+}
 function createGoogleAnalyticsIntegration(config) {
   const src = config.scriptUrl ?? `https://www.googletagmanager.com/gtag/js?id=${config.measurementId}`;
   return {
@@ -2359,17 +2904,17 @@ function createGoogleAnalyticsIntegration(config) {
         provider: "Google Analytics"
       }
     ],
+    bootstrap: () => {
+      applyDefaultConsentMode();
+    },
+    onConsentUpdate: ({ preferences }) => {
+      applyConsentModeUpdate(preferences);
+    },
     init: () => {
-      if (typeof window !== "undefined") {
-        const w = window;
-        w.dataLayer = w.dataLayer ?? [];
-        const gtag = (...args) => {
-          w.dataLayer.push(...args);
-        };
-        w.gtag = gtag;
-        gtag("js", /* @__PURE__ */ new Date());
-        gtag("config", config.measurementId, config.config ?? {});
-      }
+      const gtag = ensureGtag();
+      if (!gtag) return;
+      gtag("js", /* @__PURE__ */ new Date());
+      gtag("config", config.measurementId, config.config ?? {});
     },
     attrs: { async: "true" }
   };
@@ -2381,13 +2926,19 @@ function createGoogleTagManagerIntegration(config) {
     category: "analytics",
     src,
     cookies: ["_gcl_au"],
+    bootstrap: () => {
+      applyDefaultConsentMode(config.dataLayerName);
+    },
+    onConsentUpdate: ({ preferences }) => {
+      applyConsentModeUpdate(preferences, config.dataLayerName);
+    },
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         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": Date.now(), event: "gtm.js" });
       }
     }
   };
@@ -2400,7 +2951,7 @@ function createUserWayIntegration(config) {
     src,
     cookies: ["_userway_*"],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         w.UserWayWidgetApp = w.UserWayWidgetApp || {};
         w.UserWayWidgetApp.accountId = config.accountId;
@@ -2422,7 +2973,7 @@ function createFacebookPixelIntegration(config) {
     src,
     cookies: ["_fbp", "fr"],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         if (!w.fbq) {
           const fbq = (...args) => {
@@ -2489,7 +3040,7 @@ function createHotjarIntegration(config) {
       }
     ],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         w._hjSettings = { hjid: config.siteId, hjsv: v };
         if (!w.hj) {
@@ -2522,7 +3073,7 @@ function createMixpanelIntegration(config) {
       }
     ],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         w.mixpanel = w.mixpanel || { init: () => void 0 };
         if (w.mixpanel && typeof w.mixpanel.init === "function") {
@@ -2546,7 +3097,7 @@ function createClarityIntegration(config) {
     src,
     cookies: ["_clck", "_clsk", "CLID", "ANONCHK", "MR", "MUID", "SM"],
     init: () => {
-      if (typeof window !== "undefined" && typeof config.upload !== "undefined") {
+      if (globalThis.window !== void 0 && typeof config.upload !== "undefined") {
         const w = window;
         if (typeof w.clarity === "function") {
           try {
@@ -2569,7 +3120,7 @@ function createIntercomIntegration(config) {
     src,
     cookies: ["intercom-id-*", "intercom-session-*"],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         if (typeof w.Intercom === "function") {
           try {
@@ -2592,7 +3143,7 @@ function createZendeskChatIntegration(config) {
     src,
     cookies: ["__zlcmid", "_zendesk_shared_session"],
     init: () => {
-      if (typeof window !== "undefined") {
+      if (globalThis.window !== void 0) {
         const w = window;
         if (typeof w.zE === "function") {
           try {
@@ -2656,6 +3207,68 @@ function suggestCategoryForScript(name) {
   return ["analytics"];
 }
 
+// src/utils/categoryPresets.ts
+var ANPD_CATEGORY_PRESETS = {
+  necessary: {
+    id: "necessary",
+    name: "Necess\xE1rios",
+    description: "Essenciais para funcionamento do site e seguran\xE7a. Sempre ativos.",
+    essential: true,
+    cookies: []
+  },
+  analytics: {
+    id: "analytics",
+    name: "Analytics",
+    description: "Mede desempenho e uso para melhorar a experi\xEAncia.",
+    essential: false,
+    cookies: ["_ga", "_ga_*", "_gid"]
+  },
+  functional: {
+    id: "functional",
+    name: "Funcionais",
+    description: "Habilitam recursos adicionais e prefer\xEAncias do usu\xE1rio.",
+    essential: false,
+    cookies: []
+  },
+  marketing: {
+    id: "marketing",
+    name: "Marketing",
+    description: "Personaliza an\xFAncios e campanhas baseadas no seu perfil.",
+    essential: false,
+    cookies: ["_fbp", "fr"]
+  },
+  social: {
+    id: "social",
+    name: "Social",
+    description: "Integra\xE7\xF5es sociais, compartilhamento e widgets de redes.",
+    essential: false,
+    cookies: []
+  },
+  personalization: {
+    id: "personalization",
+    name: "Personaliza\xE7\xE3o",
+    description: "Personaliza conte\xFAdo e recomenda\xE7\xF5es.",
+    essential: false,
+    cookies: []
+  }
+};
+function createAnpdCategoriesConfig(options = {}) {
+  const include = options.include && options.include.length > 0 ? options.include : ["analytics", "functional", "marketing"];
+  const enabledCategories = include.filter((cat) => cat !== "necessary");
+  const customCategories = include.filter((cat) => cat === "necessary").map((cat) => {
+    const base = ANPD_CATEGORY_PRESETS[cat];
+    return {
+      ...base,
+      name: options.names?.[cat] ?? base.name,
+      description: options.descriptions?.[cat] ?? base.description
+    };
+  });
+  return {
+    enabledCategories,
+    customCategories: customCategories.length ? customCategories : void 0
+  };
+}
+
 // src/types/advancedTexts.ts
 var EXPANDED_DEFAULT_TEXTS = {
   // Textos adicionais
@@ -2867,6 +3480,7 @@ var TEXT_TEMPLATES = {
   }
 };
 
+exports.ANPD_CATEGORY_PRESETS = ANPD_CATEGORY_PRESETS;
 exports.COMMON_INTEGRATIONS = COMMON_INTEGRATIONS;
 exports.ConsentGate = ConsentGate;
 exports.ConsentProvider = ConsentProvider;
@@ -2884,7 +3498,9 @@ exports.autoConfigureCategories = autoConfigureCategories;
 exports.buildConsentStorageKey = buildConsentStorageKey;
 exports.categorizeDiscoveredCookies = categorizeDiscoveredCookies;
 exports.checkPeerDeps = checkPeerDeps;
+exports.createAnpdCategoriesConfig = createAnpdCategoriesConfig;
 exports.createClarityIntegration = createClarityIntegration;
+exports.createConsentAuditEntry = createConsentAuditEntry;
 exports.createCorporateIntegrations = createCorporateIntegrations;
 exports.createECommerceIntegrations = createECommerceIntegrations;
 exports.createFacebookPixelIntegration = createFacebookPixelIntegration;
@@ -2904,17 +3520,22 @@ exports.ensureNecessaryAlwaysOn = ensureNecessaryAlwaysOn;
 exports.extractCategoriesFromIntegrations = extractCategoriesFromIntegrations;
 exports.getAllProjectCategories = getAllProjectCategories;
 exports.getCookiesInfoForCategory = getCookiesInfoForCategory;
+exports.getPeerDepsLocale = getPeerDepsLocale;
 exports.loadScript = loadScript;
 exports.logDeveloperGuidance = logDeveloperGuidance;
 exports.logger = logger;
 exports.openPreferencesModal = openPreferencesModal;
 exports.pushConsentInitializedEvent = pushConsentInitializedEvent;
 exports.pushConsentUpdatedEvent = pushConsentUpdatedEvent;
+exports.registerScript = registerScript;
+exports.resetPeerDepsMessages = resetPeerDepsMessages;
 exports.resolveTexts = resolveTexts;
 exports.runPeerDepsCheck = runPeerDepsCheck;
 exports.setCookieCatalogOverrides = setCookieCatalogOverrides;
 exports.setCookieCategoryOverrides = setCookieCategoryOverrides;
 exports.setDebugLogging = setDebugLogging;
+exports.setPeerDepsLocale = setPeerDepsLocale;
+exports.setPeerDepsMessages = setPeerDepsMessages;
 exports.suggestCategoryForScript = suggestCategoryForScript;
 exports.useCategories = useCategories;
 exports.useCategoryStatus = useCategoryStatus;