react-lgpd-consent 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -36,15 +36,55 @@ function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
   const raw = import_js_cookie.default.get(name);
   if (!raw) return null;
   try {
-    return JSON.parse(raw);
+    const data = JSON.parse(raw);
+    if (!data.version) {
+      return migrateLegacyCookie(data);
+    }
+    if (data.version !== COOKIE_SCHEMA_VERSION) {
+      console.warn(
+        `[react-lgpd-consent] Cookie version mismatch: ${data.version} != ${COOKIE_SCHEMA_VERSION}`
+      );
+      return null;
+    }
+    return data;
   } catch {
     return null;
   }
 }
-function writeConsentCookie(state, opts) {
+function migrateLegacyCookie(legacyData) {
+  try {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    return {
+      version: COOKIE_SCHEMA_VERSION,
+      consented: legacyData.consented || false,
+      preferences: legacyData.preferences || { necessary: true },
+      consentDate: now,
+      // Não temos o original, usar data atual
+      lastUpdate: now,
+      source: "banner",
+      // Assumir origem banner
+      isModalOpen: false
+      // Nunca persistir estado de UI
+    };
+  } catch {
+    return null;
+  }
+}
+function writeConsentCookie(state, source = "banner", opts) {
   if (typeof document === "undefined") return;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
   const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
-  import_js_cookie.default.set(o.name, JSON.stringify(state), {
+  const cookieData = {
+    version: COOKIE_SCHEMA_VERSION,
+    consented: state.consented,
+    preferences: state.preferences,
+    consentDate: state.consentDate || now,
+    // Preservar data original ou usar atual
+    lastUpdate: now,
+    source
+    // isModalOpen NÃO é persistido (campo de UI apenas)
+  };
+  import_js_cookie.default.set(o.name, JSON.stringify(cookieData), {
     expires: o.maxAgeDays,
     sameSite: o.sameSite,
     secure: o.secure,
@@ -56,7 +96,7 @@ function removeConsentCookie(opts) {
   const o = { ...DEFAULT_COOKIE_OPTS, ...opts };
   import_js_cookie.default.remove(o.name, { path: o.path });
 }
-var import_js_cookie, DEFAULT_COOKIE_OPTS;
+var import_js_cookie, DEFAULT_COOKIE_OPTS, COOKIE_SCHEMA_VERSION;
 var init_cookieUtils = __esm({
   "src/utils/cookieUtils.ts"() {
     "use strict";
@@ -68,6 +108,7 @@ var init_cookieUtils = __esm({
       secure: typeof window !== "undefined" ? window.location.protocol === "https:" : false,
       path: "/"
     };
+    COOKIE_SCHEMA_VERSION = "1.0";
   }
 });
 
@@ -145,74 +186,212 @@ var init_theme = __esm({
   }
 });
 
+// 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
+    // Não precisa de toggle (sempre ativo)
+  });
+  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"
+    }
+  };
+  enabledCategories.forEach((categoryId) => {
+    const categoryInfo = categoryNames[categoryId];
+    if (categoryInfo) {
+      guidance.activeCategoriesInfo.push({
+        id: categoryId,
+        name: categoryInfo.name,
+        description: categoryInfo.description,
+        essential: false,
+        uiRequired: true
+        // Precisa de toggle na UI
+      });
+    }
+  });
+  const customCategories = finalConfig.customCategories || [];
+  customCategories.forEach((category) => {
+    guidance.activeCategoriesInfo.push({
+      id: category.id,
+      name: category.name,
+      description: category.description,
+      essential: category.essential === true,
+      uiRequired: category.essential !== true
+      // Apenas não-essenciais precisam toggle
+    });
+  });
+  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.`
+    );
+  }
+  const poorDescriptions = customCategories.filter(
+    (c) => !c.description || c.description.length < 10
+  );
+  if (poorDescriptions.length > 0) {
+    guidance.warnings.push(
+      `Categorias customizadas com descri\xE7\xF5es inadequadas: ${poorDescriptions.map((c) => c.id).join(", ")}. Descri\xE7\xF5es claras s\xE3o obrigat\xF3rias para compliance LGPD.`
+    );
+  }
+  return guidance;
+}
+function logDeveloperGuidance(guidance) {
+  const isProduction = typeof globalThis !== "undefined" && globalThis.__LGPD_PRODUCTION__ || typeof window !== "undefined" && !window.__LGPD_DEV__;
+  if (isProduction) return;
+  if (guidance.warnings.length > 0) {
+    console.group("\u{1F7E8} LGPD-CONSENT: Avisos de Configura\xE7\xE3o");
+    guidance.warnings.forEach((warning) => console.warn(warning));
+    console.groupEnd();
+  }
+  if (guidance.suggestions.length > 0) {
+    console.group("\u{1F4A1} LGPD-CONSENT: Sugest\xF5es");
+    guidance.suggestions.forEach((suggestion) => console.info(suggestion));
+    console.groupEnd();
+  }
+  if (guidance.usingDefaults) {
+    console.info(
+      '\u{1F4CB} LGPD-CONSENT: Usando configura\xE7\xE3o padr\xE3o. Para personalizar, use a prop "categories" no ConsentProvider.'
+    );
+  }
+  console.group("\u{1F527} LGPD-CONSENT: Categorias Ativas (para UI customizada)");
+  console.table(
+    guidance.activeCategoriesInfo.map((cat) => ({
+      ID: cat.id,
+      Nome: cat.name,
+      "Toggle UI?": cat.uiRequired ? "\u2705 SIM" : "\u274C N\xC3O (sempre ativo)",
+      "Essencial?": cat.essential ? "\u{1F512} SIM" : "\u2699\uFE0F N\xC3O"
+    }))
+  );
+  console.groupEnd();
+}
+var React, DEFAULT_PROJECT_CATEGORIES;
+var init_developerGuidance = __esm({
+  "src/utils/developerGuidance.ts"() {
+    "use strict";
+    React = __toESM(require("react"), 1);
+    DEFAULT_PROJECT_CATEGORIES = {
+      enabledCategories: ["analytics"],
+      // Só analytics além de necessary
+      customCategories: []
+    };
+  }
+});
+
 // src/context/CategoriesContext.tsx
 function CategoriesProvider({
+  children,
   categories,
-  children
+  // LEGACY: prop antiga (apenas customCategories)
+  config
+  // NOVO: configuração completa
 }) {
-  const value = React.useMemo(() => categories || [], [categories]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CategoriesCtx.Provider, { value, children });
+  const contextValue = React2.useMemo(() => {
+    let finalConfig;
+    if (categories && !config) {
+      finalConfig = {
+        enabledCategories: DEFAULT_PROJECT_CATEGORIES.enabledCategories,
+        customCategories: categories
+      };
+    } else {
+      finalConfig = config || DEFAULT_PROJECT_CATEGORIES;
+    }
+    const guidance = analyzeDeveloperConfiguration(
+      config || (categories ? { customCategories: categories } : void 0)
+    );
+    const toggleableCategories = guidance.activeCategoriesInfo.filter(
+      (cat) => cat.uiRequired
+    );
+    return {
+      config: finalConfig,
+      guidance,
+      toggleableCategories,
+      allCategories: guidance.activeCategoriesInfo,
+      legacyCategories: categories || []
+    };
+  }, [config, categories]);
+  React2.useEffect(() => {
+    logDeveloperGuidance(contextValue.guidance);
+  }, [contextValue.guidance]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CategoriesContext.Provider, { value: contextValue, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(CategoriesCtx.Provider, { value: contextValue.legacyCategories, children }) });
 }
-function useCustomCategories() {
-  return React.useContext(CategoriesCtx);
+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 useAllCategories() {
-  const customCategories = useCustomCategories();
-  return React.useMemo(() => {
-    const defaultCategories = [
-      {
-        id: "necessary",
-        name: "Cookies Necess\xE1rios",
-        description: "Essenciais para o funcionamento b\xE1sico do site. Incluem cookies de sess\xE3o, autentica\xE7\xE3o e seguran\xE7a.",
-        essential: true,
-        cookies: ["PHPSESSID", "JSESSIONID", "cookieConsent", "csrf_token"]
-      },
-      {
-        id: "analytics",
-        name: "Analytics e Estat\xEDsticas",
-        description: "Permitem medir audi\xEAncia e desempenho, gerando estat\xEDsticas an\xF4nimas de uso.",
-        essential: false,
-        cookies: ["_ga", "_ga_*", "_gid", "_gat", "gtag"]
-      },
-      {
-        id: "functional",
-        name: "Cookies Funcionais",
-        description: "Melhoram a experi\xEAncia do usu\xE1rio, lembrando prefer\xEAncias e configura\xE7\xF5es.",
-        essential: false,
-        cookies: ["language", "theme", "timezone", "preferences"]
-      },
-      {
-        id: "marketing",
-        name: "Marketing e Publicidade",
-        description: "Utilizados para publicidade direcionada e medi\xE7\xE3o de campanhas publicit\xE1rias.",
-        essential: false,
-        cookies: ["_fbp", "fr", "tr", "ads_*", "doubleclick"]
-      },
-      {
-        id: "social",
-        name: "Redes Sociais",
-        description: "Permitem compartilhamento e integra\xE7\xE3o com redes sociais como Facebook, YouTube, etc.",
-        essential: false,
-        cookies: ["__Secure-*", "sb", "datr", "c_user", "social_*"]
-      },
-      {
-        id: "personalization",
-        name: "Personaliza\xE7\xE3o",
-        description: "Adaptam o conte\xFAdo e interface \xE0s prefer\xEAncias individuais do usu\xE1rio.",
-        essential: false,
-        cookies: ["personalization_*", "content_*", "layout_*"]
-      }
-    ];
-    return [...defaultCategories, ...customCategories];
-  }, [customCategories]);
+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 React, import_jsx_runtime, CategoriesCtx;
+function useCustomCategories() {
+  return React2.useContext(CategoriesCtx);
+}
+var React2, import_jsx_runtime, CategoriesContext, CategoriesCtx;
 var init_CategoriesContext = __esm({
   "src/context/CategoriesContext.tsx"() {
     "use strict";
-    React = __toESM(require("react"), 1);
+    React2 = __toESM(require("react"), 1);
+    init_developerGuidance();
     import_jsx_runtime = require("react/jsx-runtime");
-    CategoriesCtx = React.createContext([]);
+    CategoriesContext = React2.createContext(
+      null
+    );
+    CategoriesCtx = React2.createContext([]);
   }
 });
 
@@ -292,12 +471,25 @@ function PreferencesModal({
 }) {
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
-  const [tempPreferences, setTempPreferences] = (0, import_react.useState)(preferences);
+  const { toggleableCategories } = useCategories();
+  const [tempPreferences, setTempPreferences] = (0, import_react.useState)(
+    () => {
+      const initialPrefs = { necessary: true };
+      toggleableCategories.forEach((category) => {
+        initialPrefs[category.id] = preferences[category.id] ?? false;
+      });
+      return initialPrefs;
+    }
+  );
   (0, import_react.useEffect)(() => {
     if (isModalOpen) {
-      setTempPreferences(preferences);
+      const syncedPrefs = { necessary: true };
+      toggleableCategories.forEach((category) => {
+        syncedPrefs[category.id] = preferences[category.id] ?? false;
+      });
+      setTempPreferences(syncedPrefs);
     }
-  }, [isModalOpen, preferences]);
+  }, [isModalOpen, preferences, toggleableCategories]);
   const open = DialogProps2?.open ?? isModalOpen ?? false;
   const handleSave = () => {
     setPreferences(tempPreferences);
@@ -318,38 +510,23 @@ function PreferencesModal({
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_DialogContent.default, { dividers: true, children: [
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_Typography2.default, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
           /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_FormGroup.default, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              import_FormControlLabel.default,
-              {
-                control: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                  import_Switch.default,
-                  {
-                    checked: tempPreferences.analytics,
-                    onChange: (e) => setTempPreferences((prev) => ({
-                      ...prev,
-                      analytics: e.target.checked
-                    }))
-                  }
-                ),
-                label: "Cookies Anal\xEDticos (medem uso do site)"
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+            toggleableCategories.map((category) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
               import_FormControlLabel.default,
               {
                 control: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
                   import_Switch.default,
                   {
-                    checked: tempPreferences.marketing,
+                    checked: tempPreferences[category.id] ?? false,
                     onChange: (e) => setTempPreferences((prev) => ({
                       ...prev,
-                      marketing: e.target.checked
+                      [category.id]: e.target.checked
                     }))
                   }
                 ),
-                label: "Cookies de Marketing/Publicidade"
-              }
-            ),
+                label: `${category.name} - ${category.description}`
+              },
+              category.id
+            )),
             /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
               import_FormControlLabel.default,
               {
@@ -382,6 +559,7 @@ var init_PreferencesModal = __esm({
     import_Switch = __toESM(require("@mui/material/Switch"), 1);
     import_Typography2 = __toESM(require("@mui/material/Typography"), 1);
     import_react = require("react");
+    init_CategoriesContext();
     init_useConsent();
     init_Branding();
     import_jsx_runtime3 = require("react/jsx-runtime");
@@ -398,6 +576,18 @@ function createInitialPreferences(customCategories) {
   }
   return prefs;
 }
+function createFullConsentState(consented, preferences, source, isModalOpen = false, existingState) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    version: "1.0",
+    consented,
+    preferences,
+    consentDate: existingState?.consentDate || now,
+    lastUpdate: now,
+    source,
+    isModalOpen
+  };
+}
 function reducer(state, action) {
   switch (action.type) {
     case "ACCEPT_ALL": {
@@ -405,11 +595,7 @@ function reducer(state, action) {
       Object.keys(prefs).forEach((key) => {
         prefs[key] = true;
       });
-      return {
-        consented: true,
-        preferences: prefs,
-        isModalOpen: false
-      };
+      return createFullConsentState(true, prefs, "banner", false, state);
     }
     case "REJECT_ALL": {
       const prefs = createInitialPreferences(action.customCategories);
@@ -420,11 +606,7 @@ function reducer(state, action) {
           }
         });
       }
-      return {
-        consented: true,
-        preferences: prefs,
-        isModalOpen: false
-      };
+      return createFullConsentState(true, prefs, "banner", false, state);
     }
     case "SET_CATEGORY":
       return {
@@ -432,38 +614,50 @@ function reducer(state, action) {
         preferences: {
           ...state.preferences,
           [action.category]: action.value
-        }
+        },
+        lastUpdate: (/* @__PURE__ */ new Date()).toISOString()
       };
     case "SET_PREFERENCES":
-      return {
-        ...state,
-        consented: true,
-        preferences: action.preferences,
-        isModalOpen: false
-      };
+      return createFullConsentState(
+        true,
+        action.preferences,
+        "modal",
+        false,
+        state
+      );
     case "OPEN_MODAL":
       return { ...state, isModalOpen: true };
     case "CLOSE_MODAL":
-      return { ...state, isModalOpen: false, consented: true };
-    // houve interação
+      return createFullConsentState(
+        true,
+        state.preferences,
+        "modal",
+        false,
+        state
+      );
     case "RESET": {
-      return {
-        consented: false,
-        preferences: createInitialPreferences(action.customCategories),
-        isModalOpen: false
-      };
+      return createFullConsentState(
+        false,
+        createInitialPreferences(action.customCategories),
+        "programmatic",
+        false
+      );
     }
     case "HYDRATE":
-      return { ...action.state };
+      return { ...action.state, isModalOpen: false };
+    // Nunca hidratar com modal aberto
     default:
       return state;
   }
 }
 function ConsentProvider({
   initialState,
+  categories,
+  // NOVO: configuração completa de categorias
   texts: textsProp,
   theme,
   customCategories,
+  // LEGACY: compatibilidade
   scriptIntegrations,
   PreferencesModalComponent,
   preferencesModalProps = {},
@@ -474,29 +668,41 @@ function ConsentProvider({
   cookie: cookieOpts,
   children
 }) {
-  const texts = React2.useMemo(
+  const texts = React3.useMemo(
     () => ({ ...DEFAULT_TEXTS, ...textsProp ?? {} }),
     [textsProp]
   );
-  const cookie = React2.useMemo(
+  const cookie = React3.useMemo(
     () => ({ ...DEFAULT_COOKIE_OPTS, ...cookieOpts ?? {} }),
     [cookieOpts]
   );
-  const appliedTheme = React2.useMemo(
+  const appliedTheme = React3.useMemo(
     () => theme || defaultConsentTheme,
     [theme]
   );
-  const boot = React2.useMemo(() => {
+  const finalCategoriesConfig = React3.useMemo(() => {
+    if (categories) return categories;
+    if (customCategories) {
+      return {
+        enabledCategories: ["analytics"],
+        // padrão quando usando API antiga
+        customCategories
+      };
+    }
+    return void 0;
+  }, [categories, customCategories]);
+  const boot = React3.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
-    return {
-      consented: false,
-      preferences: createInitialPreferences(customCategories),
-      isModalOpen: false
-    };
+    return createFullConsentState(
+      false,
+      createInitialPreferences(customCategories),
+      "banner",
+      false
+    );
   }, [initialState, customCategories]);
-  const [state, dispatch] = React2.useReducer(reducer, boot);
-  const [isHydrated, setIsHydrated] = React2.useState(false);
-  React2.useEffect(() => {
+  const [state, dispatch] = React3.useReducer(reducer, boot);
+  const [isHydrated, setIsHydrated] = React3.useState(false);
+  React3.useEffect(() => {
     if (!initialState) {
       const saved = readConsentCookie(cookie.name);
       if (saved?.consented) {
@@ -506,24 +712,24 @@ function ConsentProvider({
     }
     setIsHydrated(true);
   }, [cookie.name, initialState]);
-  React2.useEffect(() => {
-    if (state.consented) writeConsentCookie(state, cookie);
+  React3.useEffect(() => {
+    if (state.consented) writeConsentCookie(state, state.source, cookie);
   }, [state, cookie]);
-  const prevConsented = React2.useRef(state.consented);
-  React2.useEffect(() => {
+  const prevConsented = React3.useRef(state.consented);
+  React3.useEffect(() => {
     if (!prevConsented.current && state.consented && onConsentGiven) {
       setTimeout(() => onConsentGiven(state), 150);
     }
     prevConsented.current = state.consented;
   }, [state, onConsentGiven]);
-  const prevPrefs = React2.useRef(state.preferences);
-  React2.useEffect(() => {
+  const prevPrefs = React3.useRef(state.preferences);
+  React3.useEffect(() => {
     if (state.consented && onPreferencesSaved && prevPrefs.current !== state.preferences) {
       setTimeout(() => onPreferencesSaved(state.preferences), 150);
       prevPrefs.current = state.preferences;
     }
   }, [state, onPreferencesSaved]);
-  const api = React2.useMemo(() => {
+  const api = React3.useMemo(() => {
     const acceptAll = () => dispatch({ type: "ACCEPT_ALL", customCategories });
     const rejectAll = () => dispatch({ type: "REJECT_ALL", customCategories });
     const setPreference = (category, value) => dispatch({ type: "SET_CATEGORY", category, value });
@@ -547,53 +753,55 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie, customCategories]);
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_styles2.ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(CategoriesProvider, { categories: customCategories, children: [
-    children,
-    !disableAutomaticModal && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(React2.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PreferencesModal2, { hideBranding }) })
-  ] }) }) }) }) }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_styles2.ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(HydrationCtx.Provider, { value: isHydrated, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+    CategoriesProvider,
+    {
+      config: finalCategoriesConfig,
+      categories: customCategories,
+      children: [
+        children,
+        !disableAutomaticModal && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(React3.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PreferencesModal2, { hideBranding }) })
+      ]
+    }
+  ) }) }) }) }) });
 }
 function useConsentStateInternal() {
-  const ctx = React2.useContext(StateCtx);
+  const ctx = React3.useContext(StateCtx);
   if (!ctx)
     throw new Error("useConsentState must be used within ConsentProvider");
   return ctx;
 }
 function useConsentActionsInternal() {
-  const ctx = React2.useContext(ActionsCtx);
+  const ctx = React3.useContext(ActionsCtx);
   if (!ctx)
     throw new Error("useConsentActions must be used within ConsentProvider");
   return ctx;
 }
 function useConsentTextsInternal() {
-  const ctx = React2.useContext(TextsCtx);
+  const ctx = React3.useContext(TextsCtx);
   return ctx;
 }
 function useConsentHydrationInternal() {
-  return React2.useContext(HydrationCtx);
+  return React3.useContext(HydrationCtx);
 }
-var React2, import_styles2, import_jsx_runtime4, PreferencesModal2, DEFAULT_PREFERENCES, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx;
+var React3, import_styles2, import_jsx_runtime4, PreferencesModal2, DEFAULT_PREFERENCES, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx;
 var init_ConsentContext = __esm({
   "src/context/ConsentContext.tsx"() {
     "use strict";
-    React2 = __toESM(require("react"), 1);
+    React3 = __toESM(require("react"), 1);
     import_styles2 = require("@mui/material/styles");
     init_cookieUtils();
     init_theme();
     init_CategoriesContext();
     import_jsx_runtime4 = require("react/jsx-runtime");
-    PreferencesModal2 = React2.lazy(
+    PreferencesModal2 = React3.lazy(
       () => Promise.resolve().then(() => (init_PreferencesModal(), PreferencesModal_exports)).then((m) => ({
         default: m.PreferencesModal
       }))
     );
     DEFAULT_PREFERENCES = {
-      necessary: true,
+      necessary: true
       // Sempre ativo (essencial)
-      analytics: false,
-      functional: false,
-      marketing: false,
-      social: false,
-      personalization: false
     };
     DEFAULT_TEXTS = {
       // Textos básicos
@@ -624,10 +832,10 @@ var init_ConsentContext = __esm({
       transferCountries: void 0
       // Exibido se definido
     };
-    StateCtx = React2.createContext(null);
-    ActionsCtx = React2.createContext(null);
-    TextsCtx = React2.createContext(DEFAULT_TEXTS);
-    HydrationCtx = React2.createContext(false);
+    StateCtx = React3.createContext(null);
+    ActionsCtx = React3.createContext(null);
+    TextsCtx = React3.createContext(DEFAULT_TEXTS);
+    HydrationCtx = React3.createContext(false);
   }
 });
 
@@ -669,14 +877,17 @@ __export(index_exports, {
   ConsentProvider: () => ConsentProvider,
   ConsentScriptLoader: () => ConsentScriptLoader,
   CookieBanner: () => CookieBanner,
+  DEFAULT_PROJECT_CATEGORIES: () => DEFAULT_PROJECT_CATEGORIES,
   FloatingPreferencesButton: () => FloatingPreferencesButton,
   PreferencesModal: () => PreferencesModal,
+  analyzeDeveloperConfiguration: () => analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration: () => createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration: () => createGoogleTagManagerIntegration,
   createUserWayIntegration: () => createUserWayIntegration,
   defaultConsentTheme: () => defaultConsentTheme,
   loadScript: () => loadScript,
-  useAllCategories: () => useAllCategories,
+  useCategories: () => useCategories,
+  useCategoryStatus: () => useCategoryStatus,
   useConsent: () => useConsent,
   useConsentHydration: () => useConsentHydration,
   useConsentScriptLoader: () => useConsentScriptLoader,
@@ -910,15 +1121,15 @@ function loadScript(id, src, category = null, attrs = {}) {
 init_theme();
 
 // src/utils/ConsentScriptLoader.tsx
-var React3 = __toESM(require("react"), 1);
+var React4 = __toESM(require("react"), 1);
 init_useConsent();
 function ConsentScriptLoader({
   integrations,
   reloadOnChange = false
 }) {
   const { preferences, consented } = useConsent();
-  const loadedScripts = React3.useRef(/* @__PURE__ */ new Set());
-  React3.useEffect(() => {
+  const loadedScripts = React4.useRef(/* @__PURE__ */ new Set());
+  React4.useEffect(() => {
     if (!consented) return;
     integrations.forEach(async (integration) => {
       const shouldLoad = preferences[integration.category];
@@ -949,7 +1160,7 @@ function ConsentScriptLoader({
 }
 function useConsentScriptLoader() {
   const { preferences, consented } = useConsent();
-  return React3.useCallback(
+  return React4.useCallback(
     async (integration) => {
       if (!consented) {
         console.warn(
@@ -1046,6 +1257,9 @@ var COMMON_INTEGRATIONS = {
   googleTagManager: createGoogleTagManagerIntegration,
   userway: createUserWayIntegration
 };
+
+// src/index.ts
+init_developerGuidance();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMON_INTEGRATIONS,
@@ -1053,14 +1267,17 @@ var COMMON_INTEGRATIONS = {
   ConsentProvider,
   ConsentScriptLoader,
   CookieBanner,
+  DEFAULT_PROJECT_CATEGORIES,
   FloatingPreferencesButton,
   PreferencesModal,
+  analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
   createUserWayIntegration,
   defaultConsentTheme,
   loadScript,
-  useAllCategories,
+  useCategories,
+  useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,