react-lgpd-consent 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -186,74 +186,242 @@ 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) {
+  try {
+    const isProduction = (
+      // 1. NODE_ENV de bundlers (Vite, webpack, etc.)
+      typeof globalThis.process !== "undefined" && globalThis.process.env?.NODE_ENV === "production" || // 2. Vite/bundler env vars (apenas em ESM)
+      typeof globalThis !== "undefined" && typeof globalThis.import !== "undefined" && globalThis.import.meta?.env?.PROD === true || // 3. Flag customizada para desabilitar logs
+      typeof globalThis !== "undefined" && globalThis.__LGPD_PRODUCTION__ || // 4. Flag de desenvolvimento desabilitada
+      typeof window !== "undefined" && window.__LGPD_DISABLE_GUIDANCE__
+    );
+    if (isProduction) return;
+    const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
+    if (guidance.warnings.length > 0) {
+      console.group(`${PREFIX} \u26A0\uFE0F  Avisos de Configura\xE7\xE3o`);
+      guidance.warnings.forEach(
+        (warning) => console.warn(`${PREFIX} ${warning}`)
+      );
+      console.groupEnd();
+    }
+    if (guidance.suggestions.length > 0) {
+      console.group(`${PREFIX} \u{1F4A1} Sugest\xF5es`);
+      guidance.suggestions.forEach(
+        (suggestion) => console.info(`${PREFIX} ${suggestion}`)
+      );
+      console.groupEnd();
+    }
+    if (guidance.usingDefaults) {
+      console.info(
+        `${PREFIX} \u{1F4CB} Usando configura\xE7\xE3o padr\xE3o. Para personalizar, use a prop "categories" no ConsentProvider.`
+      );
+    }
+    console.group(`${PREFIX} \u{1F527} Categorias Ativas (para UI customizada)`);
+    console.table(
+      guidance.activeCategoriesInfo.map((cat) => ({
+        ID: cat.id,
+        Nome: cat.name,
+        "Toggle UI?": cat.uiRequired ? "\u2705 SIM" : "\u274C N\xC3O (sempre ativo)",
+        "Essencial?": cat.essential ? "\u{1F512} SIM" : "\u2699\uFE0F N\xC3O"
+      }))
+    );
+    console.info(
+      `${PREFIX} \u2139\uFE0F  Use estes dados para criar componentes customizados adequados.`
+    );
+    console.groupEnd();
+  } catch (error) {
+    if (typeof console !== "undefined" && console.warn) {
+      console.warn(
+        "[\u{1F36A} LGPD-CONSENT] Sistema de orienta\xE7\xF5es encontrou erro:",
+        error
+      );
+    }
+  }
+}
+function useDeveloperGuidance(config) {
+  const guidance = analyzeDeveloperConfiguration(config);
+  React.useEffect(() => {
+    logDeveloperGuidance(guidance);
+  }, [JSON.stringify(config)]);
+  return guidance;
+}
+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
+  };
+}
+function useCustomCategories() {
+  return React2.useContext(CategoriesCtx);
 }
-var React, import_jsx_runtime, 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([]);
   }
 });
 
@@ -333,12 +501,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);
@@ -359,38 +540,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)(
+            toggleableCategories.map((category) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
               import_FormControlLabel.default,
               {
                 control: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
                   import_Switch.default,
                   {
-                    checked: tempPreferences.analytics,
+                    checked: tempPreferences[category.id] ?? false,
                     onChange: (e) => setTempPreferences((prev) => ({
                       ...prev,
-                      analytics: e.target.checked
+                      [category.id]: e.target.checked
                     }))
                   }
                 ),
-                label: "Cookies Anal\xEDticos (medem uso do site)"
-              }
-            ),
-            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-              import_FormControlLabel.default,
-              {
-                control: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-                  import_Switch.default,
-                  {
-                    checked: tempPreferences.marketing,
-                    onChange: (e) => setTempPreferences((prev) => ({
-                      ...prev,
-                      marketing: e.target.checked
-                    }))
-                  }
-                ),
-                label: "Cookies de Marketing/Publicidade"
-              }
-            ),
+                label: `${category.name} - ${category.description}`
+              },
+              category.id
+            )),
             /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
               import_FormControlLabel.default,
               {
@@ -423,6 +589,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");
@@ -515,9 +682,12 @@ function reducer(state, action) {
 }
 function ConsentProvider({
   initialState,
+  categories,
+  // NOVO: configuração completa de categorias
   texts: textsProp,
   theme,
   customCategories,
+  // LEGACY: compatibilidade
   scriptIntegrations,
   PreferencesModalComponent,
   preferencesModalProps = {},
@@ -528,19 +698,31 @@ 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]);
+  useDeveloperGuidance(finalCategoriesConfig);
+  const boot = React3.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
     return createFullConsentState(
       false,
@@ -549,9 +731,9 @@ function ConsentProvider({
       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) {
@@ -561,24 +743,24 @@ function ConsentProvider({
     }
     setIsHydrated(true);
   }, [cookie.name, initialState]);
-  React2.useEffect(() => {
+  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 });
@@ -602,41 +784,49 @@ 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();
+    init_developerGuidance();
     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
       }))
@@ -674,10 +864,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);
   }
 });
 
@@ -719,14 +909,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,
@@ -960,15 +1153,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];
@@ -999,7 +1192,7 @@ function ConsentScriptLoader({
 }
 function useConsentScriptLoader() {
   const { preferences, consented } = useConsent();
-  return React3.useCallback(
+  return React4.useCallback(
     async (integration) => {
       if (!consented) {
         console.warn(
@@ -1096,6 +1289,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,
@@ -1103,14 +1299,17 @@ var COMMON_INTEGRATIONS = {
   ConsentProvider,
   ConsentScriptLoader,
   CookieBanner,
+  DEFAULT_PROJECT_CATEGORIES,
   FloatingPreferencesButton,
   PreferencesModal,
+  analyzeDeveloperConfiguration,
   createGoogleAnalyticsIntegration,
   createGoogleTagManagerIntegration,
   createUserWayIntegration,
   defaultConsentTheme,
   loadScript,
-  useAllCategories,
+  useCategories,
+  useCategoryStatus,
   useConsent,
   useConsentHydration,
   useConsentScriptLoader,