react-lgpd-consent 0.3.5 → 0.3.7

package/CHANGELOG.md

@@ -4,7 +4,25 @@ Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
 
 O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/), e este projeto segue [Semantic Versioning](https://semver.org/lang/pt-BR/).
 
-## [Unreleased]
+## [0.3.7] - 2025-09-08 - Testes de UI e carregamento de scripts
+
+### 🧪 Novos testes e cobertura
+
+- CookieBanner
+  - Testes para renderização condicional em modos bloqueante (overlay) e não-bloqueante (Snackbar)
+  - Verificação de abertura do modal ao clicar em “Preferências” e persistência ao clicar em “Recusar”
+- ConsentScriptLoader / Hook
+  - Gating por consentimento e categoria; não carrega scripts quando não consentido ou categoria desabilitada
+  - Tratamento de erros (log `logger.error` quando `loadScript` rejeita)
+  - `reloadOnChange` reexecuta o carregamento ao reabilitar a categoria; default não recarrega
+- Integrações de script
+  - Verificação de `attrs` em integrações (GA define `async: 'true'`)
+
+### 🔧 Interno
+
+- Aumento da estabilidade para refatorações futuras na camada de UI e utilitários de carregamento.
+
+## [0.3.6] - 2025-08-28 - Correção crítica: Herança de ThemeProvider
 
 ### ✨ Novas funcionalidades e melhorias
 
@@ -46,20 +64,16 @@ O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.
   - Novo Quickstart em PT/EN e simplificações no `README` com foco em `QUICKSTART`.
   - Documentação de uso do Storybook e troubleshooting adicionada em `docs`.
 
-### 🛠️ Correção crítica: Herança de ThemeProvider (v0.3.5)
+### 🛠️ Correção crítica
 
-- **Corrigido:** A biblioteca não deve criar ou impor um `ThemeProvider` global por si só. Agora o `ConsentProvider` herda o theme do app consumidor quando um `ThemeProvider` do MUI estiver presente. O Provider só envolverá com `ThemeProvider` se a prop `theme` for explicitamente fornecida.
+- **Corrigido:** A biblioteca não deve criar ou impor um `ThemeProvider` global por si só. O `ConsentProvider` agora herda o theme do app consumidor quando um `ThemeProvider` do MUI estiver presente. O Provider só envolverá com `ThemeProvider` se a prop `theme` for explicitamente fornecida.
 - **Motivação:** Evitar conflitos de contexto MUI/Emotion, regressões visuais e problemas em SSR causados por criação de tema no escopo de módulo.
-- **Export:** `createDefaultConsentTheme()` foi adicionada como fábrica para quem precisar de um fallback explícito. Há também um getter compat (deprecated) `defaultConsentTheme()` que retorna uma nova instância quando chamada.
-- **Compatibilidade:** Uso padrão continua igual — se seu app fornece um `ThemeProvider` e você passa o mesmo theme para `ConsentProvider` (ou não passa `theme`), tudo continuará funcionando normalmente.
-
-Referência: issues/PR relacionadas e notas de release serão adicionadas no branch de release.
+- **Export:** `createDefaultConsentTheme()` foi adicionada como fábrica para quem precisar de um fallback explícito. Mantemos também um getter de compatibilidade (deprecated) `defaultConsentTheme()` que retorna uma nova instância quando chamada, evitando side-effects no import.
+- **Compatibilidade:** Uso padrão continua igual — se seu app já fornece um `ThemeProvider` o `ConsentProvider` usará o theme existente. Para quem precisa de um fallback explícito, passe `theme={createDefaultConsentTheme()}` ao `ConsentProvider`.
 
-### ♻️ Dependências e manutenção
+> Nota: originalmente essa correção foi marcada como v0.3.5; devido a conflito de publicação a versão foi bumpada localmente para v0.3.6 e a entrada foi gravada nesta release.
 
-- Dev-deps e chores
-  - Atualizações de dependências de desenvolvimento (ex.: `jest`, `@types/jest`, `typedoc`, `jest-environment-jsdom`) e ajustes na `package.json` (engine `npm` atualizado, scripts e chores relacionados ao Storybook).
-  - Limpeza de arquivos redundantes e ajustes de ESLint/preview para Storybook.
+- Limpeza de arquivos redundantes e ajustes de ESLint/preview para Storybook.
 
 ### Commits representativos
 

package/dist/{PreferencesModal-KAZMVPBD.js → PreferencesModal-3KKTKVII.js}

@@ -1,6 +1,6 @@
 import {
   PreferencesModal
-} from "./chunk-MHCQFGRJ.js";
+} from "./chunk-TKN3PNIW.js";
 export {
   PreferencesModal
 };

package/dist/{chunk-MHCQFGRJ.js → chunk-TKN3PNIW.js}

@@ -87,9 +87,10 @@ function analyzeDeveloperConfiguration(config) {
   return guidance;
 }
 function logDeveloperGuidance(guidance, disableGuidanceProp) {
-  const nodeEnv = typeof globalThis.process !== "undefined" ? globalThis.process.env?.NODE_ENV : void 0;
-  const isProd = nodeEnv === "production" || globalThis.__LGPD_PRODUCTION__ === true && typeof globalThis !== "undefined";
-  const isDisabled = !!disableGuidanceProp || globalThis.__LGPD_DISABLE_GUIDANCE__ === true && typeof globalThis !== "undefined";
+  const gt = globalThis;
+  const nodeEnv = typeof gt.process !== "undefined" ? gt.process?.env?.NODE_ENV : void 0;
+  const isProd = nodeEnv === "production" || gt.__LGPD_PRODUCTION__ === true;
+  const isDisabled = !!disableGuidanceProp || gt.__LGPD_DISABLE_GUIDANCE__ === true;
   if (isProd || isDisabled) return;
   const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
   if (guidance.warnings.length > 0) {
@@ -217,7 +218,7 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra uma mensagem de erro.
-   * @param {...any[]} args Os argumentos a serem logados.
+   * @param {...unknown[]} args Argumentos a serem logados.
    */
   error(...args) {
     if (this.enabled && this.level >= 0 /* ERROR */) {
@@ -226,7 +227,7 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra uma mensagem de aviso.
-   * @param {...any[]} args Os argumentos a serem logados.
+   * @param {...unknown[]} args Argumentos a serem logados.
    */
   warn(...args) {
     if (this.enabled && this.level >= 1 /* WARN */) {
@@ -235,7 +236,7 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra uma mensagem informativa.
-   * @param {...any[]} args Os argumentos a serem logados.
+   * @param {...unknown[]} args Argumentos a serem logados.
    */
   info(...args) {
     if (this.enabled && this.level >= 2 /* INFO */) {
@@ -244,7 +245,7 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra uma mensagem de depuração.
-   * @param {...any[]} args Os argumentos a serem logados.
+   * @param {...unknown[]} args Argumentos a serem logados.
    */
   debug(...args) {
     if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -253,7 +254,7 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Inicia um grupo de logs no console.
-   * @param {...any[]} args Os argumentos para o título do grupo.
+   * @param {...unknown[]} args Argumentos para o título do grupo.
    */
   group(...args) {
     if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -270,8 +271,8 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Exibe dados tabulares no console.
-   * @param {any} tabularData Os dados a serem exibidos na tabela.
-   * @param {string[]} [properties] Um array opcional de propriedades para exibir.
+   * @param {unknown} tabularData Dados a serem exibidos na tabela.
+   * @param {string[]} [properties] Propriedades opcionais para exibir.
    */
   table(tabularData, properties) {
     if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -280,21 +281,27 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra informações sobre a compatibilidade do tema Material-UI.
-   * @param {any} themeInfo Objeto com informações do tema.
+   * @param {unknown} themeInfo Objeto potencialmente parcial do tema (inspeção segura).
    */
   themeCompatibility(themeInfo) {
+    const isRecord = (v) => typeof v === "object" && v !== null;
+    const theme = isRecord(themeInfo) ? themeInfo : void 0;
+    const palette = theme && isRecord(theme["palette"]) ? theme["palette"] : void 0;
+    const primary = palette && isRecord(palette["primary"]);
+    const transitions = theme && isRecord(theme["transitions"]) ? theme["transitions"] : void 0;
+    const duration = transitions && isRecord(transitions["duration"]);
     this.debug("Theme compatibility check:", {
-      hasTheme: !!themeInfo,
-      hasPalette: !!themeInfo?.palette,
-      hasPrimary: !!themeInfo?.palette?.primary,
-      hasTransitions: !!themeInfo?.transitions,
-      hasDuration: !!themeInfo?.transitions?.duration
+      hasTheme: !!theme,
+      hasPalette: !!palette,
+      hasPrimary: !!primary,
+      hasTransitions: !!transitions,
+      hasDuration: !!duration
     });
   }
   /**
    * Registra mudanças no estado de consentimento.
-   * @param {string} action A ação que causou a mudança de estado.
-   * @param {any} state O estado atual do consentimento.
+   * @param {string} action Ação que causou a mudança de estado.
+   * @param {{ consented?: boolean; isModalOpen?: boolean; preferences?: Record<string, unknown> }} state Estado atual.
    */
   consentState(action, state) {
     this.debug(`Consent state change [${action}]:`, {
@@ -305,9 +312,9 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra operações de cookie (leitura, escrita, remoção).
-   * @param {'read' | 'write' | 'delete'} operation O tipo de operação de cookie.
-   * @param {string} cookieName O nome do cookie.
-   * @param {any} [data] Os dados do cookie, se aplicável.
+   * @param {'read' | 'write' | 'delete'} operation Tipo de operação.
+   * @param {string} cookieName Nome do cookie.
+   * @param {unknown} [data] Dados associados, se aplicável.
    */
   cookieOperation(operation, cookieName, data) {
     this.debug(`Cookie ${operation}:`, {
@@ -318,8 +325,8 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra a renderização de um componente.
-   * @param {string} componentName O nome do componente.
-   * @param {any} [props] As propriedades do componente.
+   * @param {string} componentName Nome do componente.
+   * @param {Record<string, unknown>} [props] Propriedades do componente.
    */
   componentRender(componentName, props) {
     this.debug(`Component render [${componentName}]:`, {
@@ -338,8 +345,8 @@ var _ConsentLogger = class _ConsentLogger {
   }
   /**
    * Registra chamadas à API interna da biblioteca.
-   * @param {string} method O nome do método da API chamado.
-   * @param {any} [params] Os parâmetros passados para o método.
+   * @param {string} method Nome do método da API chamado.
+   * @param {unknown} [params] Parâmetros passados para o método.
    */
   apiUsage(method, params) {
     this.debug(`API call [${method}]:`, params);
@@ -397,8 +404,8 @@ function migrateLegacyCookie(legacyData) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     return {
       version: COOKIE_SCHEMA_VERSION,
-      consented: legacyData.consented || false,
-      preferences: legacyData.preferences || { necessary: true },
+      consented: Boolean(legacyData.consented) || false,
+      preferences: legacyData.preferences && typeof legacyData.preferences === "object" ? legacyData.preferences : { necessary: true },
       consentDate: now,
       lastUpdate: now,
       source: "banner",
@@ -848,7 +855,7 @@ function FloatingPreferencesButton({
 // src/context/ConsentContext.tsx
 import { jsx as jsx6, jsxs as jsxs3 } from "react/jsx-runtime";
 var PreferencesModal = React4.lazy(
-  () => import("./PreferencesModal-KAZMVPBD.js").then((m) => ({
+  () => import("./PreferencesModal-3KKTKVII.js").then((m) => ({
     default: m.PreferencesModal
   }))
 );
@@ -1142,12 +1149,17 @@ function ConsentProvider({
           }
         ) : (
           // Encaminha `floatingPreferencesButtonProps` para o componente padrão
-          /* @__PURE__ */ jsx6(FloatingPreferencesButton, { ...floatingPreferencesButtonProps })
+          /* @__PURE__ */ jsx6(
+            FloatingPreferencesButton,
+            {
+              ...floatingPreferencesButtonProps ?? {}
+            }
+          )
         ))
       ]
     }
   ) }) }) }) }) });
-  if (theme) {
+  if (mergedTheme) {
     return /* @__PURE__ */ jsx6(ThemeProvider, { theme: mergedTheme, children: content });
   }
   return content;

package/dist/index.cjs

@@ -100,9 +100,10 @@ function analyzeDeveloperConfiguration(config) {
   return guidance;
 }
 function logDeveloperGuidance(guidance, disableGuidanceProp) {
-  const nodeEnv = typeof globalThis.process !== "undefined" ? globalThis.process.env?.NODE_ENV : void 0;
-  const isProd = nodeEnv === "production" || globalThis.__LGPD_PRODUCTION__ === true && typeof globalThis !== "undefined";
-  const isDisabled = !!disableGuidanceProp || globalThis.__LGPD_DISABLE_GUIDANCE__ === true && typeof globalThis !== "undefined";
+  const gt = globalThis;
+  const nodeEnv = typeof gt.process !== "undefined" ? gt.process?.env?.NODE_ENV : void 0;
+  const isProd = nodeEnv === "production" || gt.__LGPD_PRODUCTION__ === true;
+  const isDisabled = !!disableGuidanceProp || gt.__LGPD_DISABLE_GUIDANCE__ === true;
   if (isProd || isDisabled) return;
   const PREFIX = "[\u{1F36A} LGPD-CONSENT]";
   if (guidance.warnings.length > 0) {
@@ -250,7 +251,7 @@ var init_logger = __esm({
       }
       /**
        * Registra uma mensagem de erro.
-       * @param {...any[]} args Os argumentos a serem logados.
+       * @param {...unknown[]} args Argumentos a serem logados.
        */
       error(...args) {
         if (this.enabled && this.level >= 0 /* ERROR */) {
@@ -259,7 +260,7 @@ var init_logger = __esm({
       }
       /**
        * Registra uma mensagem de aviso.
-       * @param {...any[]} args Os argumentos a serem logados.
+       * @param {...unknown[]} args Argumentos a serem logados.
        */
       warn(...args) {
         if (this.enabled && this.level >= 1 /* WARN */) {
@@ -268,7 +269,7 @@ var init_logger = __esm({
       }
       /**
        * Registra uma mensagem informativa.
-       * @param {...any[]} args Os argumentos a serem logados.
+       * @param {...unknown[]} args Argumentos a serem logados.
        */
       info(...args) {
         if (this.enabled && this.level >= 2 /* INFO */) {
@@ -277,7 +278,7 @@ var init_logger = __esm({
       }
       /**
        * Registra uma mensagem de depuração.
-       * @param {...any[]} args Os argumentos a serem logados.
+       * @param {...unknown[]} args Argumentos a serem logados.
        */
       debug(...args) {
         if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -286,7 +287,7 @@ var init_logger = __esm({
       }
       /**
        * Inicia um grupo de logs no console.
-       * @param {...any[]} args Os argumentos para o título do grupo.
+       * @param {...unknown[]} args Argumentos para o título do grupo.
        */
       group(...args) {
         if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -303,8 +304,8 @@ var init_logger = __esm({
       }
       /**
        * Exibe dados tabulares no console.
-       * @param {any} tabularData Os dados a serem exibidos na tabela.
-       * @param {string[]} [properties] Um array opcional de propriedades para exibir.
+       * @param {unknown} tabularData Dados a serem exibidos na tabela.
+       * @param {string[]} [properties] Propriedades opcionais para exibir.
        */
       table(tabularData, properties) {
         if (this.enabled && this.level >= 3 /* DEBUG */) {
@@ -313,21 +314,27 @@ var init_logger = __esm({
       }
       /**
        * Registra informações sobre a compatibilidade do tema Material-UI.
-       * @param {any} themeInfo Objeto com informações do tema.
+       * @param {unknown} themeInfo Objeto potencialmente parcial do tema (inspeção segura).
        */
       themeCompatibility(themeInfo) {
+        const isRecord = (v) => typeof v === "object" && v !== null;
+        const theme = isRecord(themeInfo) ? themeInfo : void 0;
+        const palette = theme && isRecord(theme["palette"]) ? theme["palette"] : void 0;
+        const primary = palette && isRecord(palette["primary"]);
+        const transitions = theme && isRecord(theme["transitions"]) ? theme["transitions"] : void 0;
+        const duration = transitions && isRecord(transitions["duration"]);
         this.debug("Theme compatibility check:", {
-          hasTheme: !!themeInfo,
-          hasPalette: !!themeInfo?.palette,
-          hasPrimary: !!themeInfo?.palette?.primary,
-          hasTransitions: !!themeInfo?.transitions,
-          hasDuration: !!themeInfo?.transitions?.duration
+          hasTheme: !!theme,
+          hasPalette: !!palette,
+          hasPrimary: !!primary,
+          hasTransitions: !!transitions,
+          hasDuration: !!duration
         });
       }
       /**
        * Registra mudanças no estado de consentimento.
-       * @param {string} action A ação que causou a mudança de estado.
-       * @param {any} state O estado atual do consentimento.
+       * @param {string} action Ação que causou a mudança de estado.
+       * @param {{ consented?: boolean; isModalOpen?: boolean; preferences?: Record<string, unknown> }} state Estado atual.
        */
       consentState(action, state) {
         this.debug(`Consent state change [${action}]:`, {
@@ -338,9 +345,9 @@ var init_logger = __esm({
       }
       /**
        * Registra operações de cookie (leitura, escrita, remoção).
-       * @param {'read' | 'write' | 'delete'} operation O tipo de operação de cookie.
-       * @param {string} cookieName O nome do cookie.
-       * @param {any} [data] Os dados do cookie, se aplicável.
+       * @param {'read' | 'write' | 'delete'} operation Tipo de operação.
+       * @param {string} cookieName Nome do cookie.
+       * @param {unknown} [data] Dados associados, se aplicável.
        */
       cookieOperation(operation, cookieName, data) {
         this.debug(`Cookie ${operation}:`, {
@@ -351,8 +358,8 @@ var init_logger = __esm({
       }
       /**
        * Registra a renderização de um componente.
-       * @param {string} componentName O nome do componente.
-       * @param {any} [props] As propriedades do componente.
+       * @param {string} componentName Nome do componente.
+       * @param {Record<string, unknown>} [props] Propriedades do componente.
        */
       componentRender(componentName, props) {
         this.debug(`Component render [${componentName}]:`, {
@@ -371,8 +378,8 @@ var init_logger = __esm({
       }
       /**
        * Registra chamadas à API interna da biblioteca.
-       * @param {string} method O nome do método da API chamado.
-       * @param {any} [params] Os parâmetros passados para o método.
+       * @param {string} method Nome do método da API chamado.
+       * @param {unknown} [params] Parâmetros passados para o método.
        */
       apiUsage(method, params) {
         this.debug(`API call [${method}]:`, params);
@@ -419,8 +426,8 @@ function migrateLegacyCookie(legacyData) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
     return {
       version: COOKIE_SCHEMA_VERSION,
-      consented: legacyData.consented || false,
-      preferences: legacyData.preferences || { necessary: true },
+      consented: Boolean(legacyData.consented) || false,
+      preferences: legacyData.preferences && typeof legacyData.preferences === "object" ? legacyData.preferences : { necessary: true },
       consentDate: now,
       lastUpdate: now,
       source: "banner",
@@ -1169,12 +1176,17 @@ function ConsentProvider({
           }
         ) : (
           // Encaminha `floatingPreferencesButtonProps` para o componente padrão
-          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(FloatingPreferencesButton, { ...floatingPreferencesButtonProps })
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+            FloatingPreferencesButton,
+            {
+              ...floatingPreferencesButtonProps ?? {}
+            }
+          )
         ))
       ]
     }
   ) }) }) }) }) });
-  if (theme) {
+  if (mergedTheme) {
     return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_styles2.ThemeProvider, { theme: mergedTheme, children: content });
   }
   return content;
@@ -1592,13 +1604,7 @@ function ConsentScriptLoader({
       const alreadyLoaded = loadedScripts.current.has(integration.id);
       if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
         try {
-          await loadScript(
-            integration.id,
-            integration.src,
-            integration.category,
-            // Categoria dinâmica
-            integration.attrs
-          );
+          await loadScript(integration.id, integration.src, integration.category, integration.attrs);
           if (integration.init) {
             integration.init();
           }
@@ -1627,13 +1633,7 @@ function useConsentScriptLoader() {
         return false;
       }
       try {
-        await loadScript(
-          integration.id,
-          integration.src,
-          integration.category,
-          // Categoria dinâmica
-          integration.attrs
-        );
+        await loadScript(integration.id, integration.src, integration.category, integration.attrs);
         if (integration.init) {
           integration.init();
         }
@@ -1655,14 +1655,14 @@ function createGoogleAnalyticsIntegration(config) {
     src: `https://www.googletagmanager.com/gtag/js?id=${config.measurementId}`,
     init: () => {
       if (typeof window !== "undefined") {
-        let gtag2 = function(...args) {
-          window.dataLayer.push(...args);
+        const w = window;
+        w.dataLayer = w.dataLayer ?? [];
+        const gtag = (...args) => {
+          w.dataLayer.push(...args);
         };
-        var gtag = gtag2;
-        window.dataLayer = window.dataLayer || [];
-        window.gtag = gtag2;
-        gtag2("js", /* @__PURE__ */ new Date());
-        gtag2("config", config.measurementId, config.config || {});
+        w.gtag = gtag;
+        gtag("js", /* @__PURE__ */ new Date());
+        gtag("config", config.measurementId, config.config ?? {});
       }
     },
     attrs: { async: "true" }
@@ -1676,8 +1676,10 @@ function createGoogleTagManagerIntegration(config) {
     init: () => {
       if (typeof window !== "undefined") {
         const dataLayerName = config.dataLayerName || "dataLayer";
-        window[dataLayerName] = window[dataLayerName] || [];
-        window[dataLayerName].push({
+        const w = window;
+        const layer = w[dataLayerName] ?? [];
+        w[dataLayerName] = layer;
+        layer.push({
           "gtm.start": (/* @__PURE__ */ new Date()).getTime(),
           event: "gtm.js"
         });
@@ -1692,8 +1694,9 @@ function createUserWayIntegration(config) {
     src: "https://cdn.userway.org/widget.js",
     init: () => {
       if (typeof window !== "undefined") {
-        window.UserWayWidgetApp = window.UserWayWidgetApp || {};
-        window.UserWayWidgetApp.accountId = config.accountId;
+        const w = window;
+        w.UserWayWidgetApp = w.UserWayWidgetApp || {};
+        w.UserWayWidgetApp.accountId = config.accountId;
       }
     },
     attrs: { "data-account": config.accountId }

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { DialogProps } from '@mui/material/Dialog';
-import * as React$1 from 'react';
 import { Theme } from '@mui/material/styles';
+import * as React$1 from 'react';
 import { PaperProps } from '@mui/material/Paper';
 import { SnackbarProps } from '@mui/material/Snackbar';
 import { FabProps } from '@mui/material/Fab';
@@ -653,18 +653,23 @@ interface ConsentProviderProps {
      */
     texts?: Partial<ConsentTexts>;
     /**
-     * Tema customizado Material-UI aplicado aos componentes.
-     * Aceita qualquer objeto que será passado para ThemeProvider.
+     * Tema Material-UI a ser aplicado aos componentes via ThemeProvider.
+     *
+     * Observação importante: a biblioteca NÃO cria/mescla tema automaticamente.
+     * Se você fornecer um `theme` aqui, ele será repassado diretamente ao `ThemeProvider`.
+     * Se não fornecer, a lib não envolverá com `ThemeProvider` e herdará o tema do app.
      *
      * @example
      * ```tsx
-     * theme={{
-     *   palette: { primary: { main: '#1976d2' } },
-     *   components: { MuiButton: { styleOverrides: { root: { borderRadius: 8 } } } }
-     * }}
+     * import { createTheme } from '@mui/material/styles'
+     * const appTheme = createTheme({ palette: { primary: { main: '#1976d2' } } })
+     *
+     * <ConsentProvider theme={appTheme}>
+     *   <App />
+     * </ConsentProvider>
      * ```
      */
-    theme?: any;
+    theme?: Theme;
     /**
      * Tokens de design para customização visual avançada.
      * Oferece controle direto sobre cores, fontes, espaçamento e layout.
@@ -684,24 +689,24 @@ interface ConsentProviderProps {
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomPreferencesModalProps`.
      */
     PreferencesModalComponent?: React.ComponentType<CustomPreferencesModalProps>;
-    /** Props adicionais passadas para o modal customizado. */
-    preferencesModalProps?: Record<string, any>;
+    /** Props adicionais passadas para o modal customizado (repassadas sem transformação). */
+    preferencesModalProps?: Record<string, unknown>;
     /**
      * Componente customizado para substituir o banner padrão de cookies.
      * Se não fornecido, o `CookieBanner` padrão será renderizado.
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomCookieBannerProps`.
      */
     CookieBannerComponent?: React.ComponentType<CustomCookieBannerProps>;
-    /** Props adicionais passadas para o banner customizado. */
-    cookieBannerProps?: Record<string, any>;
+    /** Props adicionais passadas para o banner customizado (repassadas sem transformação). */
+    cookieBannerProps?: Record<string, unknown>;
     /**
      * Componente customizado para substituir o botão flutuante de preferências.
      * Se não fornecido, o `FloatingPreferencesButton` padrão será renderizado.
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomFloatingPreferencesButtonProps`.
      */
     FloatingPreferencesButtonComponent?: React.ComponentType<CustomFloatingPreferencesButtonProps>;
-    /** Props adicionais passadas para o botão flutuante customizado. */
-    floatingPreferencesButtonProps?: Record<string, any>;
+    /** Props adicionais passadas para o botão flutuante customizado (repassadas sem transformação). */
+    floatingPreferencesButtonProps?: Record<string, unknown>;
     /**
      * Desabilita o botão flutuante de preferências.
      * Útil quando o usuário da lib quer ter controle total sobre o acesso às preferências.
@@ -1600,7 +1605,7 @@ declare function ConsentGate(props: Readonly<{
  *
  * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
  * @param {string} src A URL do script externo a ser carregado.
- * @param {'analytics' | 'marketing' | null} [category=null] A categoria de consentimento exigida para o script. Se o consentimento para esta categoria não for dado, o script não será carregado.
+ * @param {import('../types/types').Category | null} [category=null] A categoria de consentimento exigida para o script. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
  * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
@@ -1611,7 +1616,8 @@ declare function ConsentGate(props: Readonly<{
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: 'analytics' | 'marketing' | null, attrs?: Record<string, string>): Promise<void>;
+
+declare function loadScript(id: string, src: string, category?: Category | null, attrs?: Record<string, string>): Promise<void>;
 
 /**
  * @constant
@@ -1637,13 +1643,19 @@ declare const defaultConsentTheme: () => Theme;
 
 /**
  * @interface ScriptIntegration
- * Define a estrutura de um objeto de integração de script, usado para carregar scripts de terceiros condicionalmente.
+ * Estrutura de uma integração de script de terceiros a ser carregada condicionalmente conforme o consentimento.
+ *
+ * @remarks
+ * - `category` é um `Category` tipado (ex.: 'analytics', 'marketing').
+ * - `init` roda após o script ser inserido no DOM e carregado.
+ * - `attrs` é repassado como atributos HTML da tag `<script>`.
  */
+
 interface ScriptIntegration {
     /** Um ID único para esta integração de script. */
     id: string;
-    /** A categoria de consentimento necessária para que este script seja carregado (ex: 'analytics', 'marketing'). */
-    category: string;
+    /** Categoria de consentimento necessária para carregar o script. */
+    category: Category;
     /** A URL do script a ser carregado. */
     src: string;
     /** Uma função opcional a ser executada após o script ser carregado e inicializado no DOM. */
@@ -1658,8 +1670,8 @@ interface ScriptIntegration {
 interface GoogleAnalyticsConfig {
     /** O ID de medição do GA4 (ex: 'G-XXXXXXXXXX'). */
     measurementId: string;
-    /** Um objeto opcional de configuração adicional a ser passado para o comando `gtag('config')`. */
-    config?: any;
+    /** Objeto opcional repassado para `gtag('config')`. */
+    config?: Record<string, unknown>;
 }
 /**
  * @interface GoogleTagManagerConfig
@@ -1683,30 +1695,30 @@ interface UserWayConfig {
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o Google Analytics 4 (GA4).
+ * Cria uma integração para Google Analytics 4 (GA4).
  *
- * @param {GoogleAnalyticsConfig} config A configuração do GA4, incluindo o `measurementId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o GA4.
+ * @param {GoogleAnalyticsConfig} config Configuração com `measurementId` e `config` opcional.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'analytics'`.
  */
 declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
 /**
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o Google Tag Manager (GTM).
+ * Cria uma integração para Google Tag Manager (GTM).
  *
- * @param {GoogleTagManagerConfig} config A configuração do GTM, incluindo o `containerId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o GTM.
+ * @param {GoogleTagManagerConfig} config Configuração com `containerId` e `dataLayerName` opcional.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'analytics'`.
  */
 declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
 /**
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o widget de acessibilidade UserWay.
+ * Cria uma integração para o widget de acessibilidade UserWay.
  *
- * @param {UserWayConfig} config A configuração do UserWay, incluindo o `accountId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o UserWay.
+ * @param {UserWayConfig} config Configuração com `accountId`.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'functional'`.
  */
 declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
 /**

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { DialogProps } from '@mui/material/Dialog';
-import * as React$1 from 'react';
 import { Theme } from '@mui/material/styles';
+import * as React$1 from 'react';
 import { PaperProps } from '@mui/material/Paper';
 import { SnackbarProps } from '@mui/material/Snackbar';
 import { FabProps } from '@mui/material/Fab';
@@ -653,18 +653,23 @@ interface ConsentProviderProps {
      */
     texts?: Partial<ConsentTexts>;
     /**
-     * Tema customizado Material-UI aplicado aos componentes.
-     * Aceita qualquer objeto que será passado para ThemeProvider.
+     * Tema Material-UI a ser aplicado aos componentes via ThemeProvider.
+     *
+     * Observação importante: a biblioteca NÃO cria/mescla tema automaticamente.
+     * Se você fornecer um `theme` aqui, ele será repassado diretamente ao `ThemeProvider`.
+     * Se não fornecer, a lib não envolverá com `ThemeProvider` e herdará o tema do app.
      *
      * @example
      * ```tsx
-     * theme={{
-     *   palette: { primary: { main: '#1976d2' } },
-     *   components: { MuiButton: { styleOverrides: { root: { borderRadius: 8 } } } }
-     * }}
+     * import { createTheme } from '@mui/material/styles'
+     * const appTheme = createTheme({ palette: { primary: { main: '#1976d2' } } })
+     *
+     * <ConsentProvider theme={appTheme}>
+     *   <App />
+     * </ConsentProvider>
      * ```
      */
-    theme?: any;
+    theme?: Theme;
     /**
      * Tokens de design para customização visual avançada.
      * Oferece controle direto sobre cores, fontes, espaçamento e layout.
@@ -684,24 +689,24 @@ interface ConsentProviderProps {
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomPreferencesModalProps`.
      */
     PreferencesModalComponent?: React.ComponentType<CustomPreferencesModalProps>;
-    /** Props adicionais passadas para o modal customizado. */
-    preferencesModalProps?: Record<string, any>;
+    /** Props adicionais passadas para o modal customizado (repassadas sem transformação). */
+    preferencesModalProps?: Record<string, unknown>;
     /**
      * Componente customizado para substituir o banner padrão de cookies.
      * Se não fornecido, o `CookieBanner` padrão será renderizado.
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomCookieBannerProps`.
      */
     CookieBannerComponent?: React.ComponentType<CustomCookieBannerProps>;
-    /** Props adicionais passadas para o banner customizado. */
-    cookieBannerProps?: Record<string, any>;
+    /** Props adicionais passadas para o banner customizado (repassadas sem transformação). */
+    cookieBannerProps?: Record<string, unknown>;
     /**
      * Componente customizado para substituir o botão flutuante de preferências.
      * Se não fornecido, o `FloatingPreferencesButton` padrão será renderizado.
      * Deve implementar a lógica de consentimento usando as props definidas em `CustomFloatingPreferencesButtonProps`.
      */
     FloatingPreferencesButtonComponent?: React.ComponentType<CustomFloatingPreferencesButtonProps>;
-    /** Props adicionais passadas para o botão flutuante customizado. */
-    floatingPreferencesButtonProps?: Record<string, any>;
+    /** Props adicionais passadas para o botão flutuante customizado (repassadas sem transformação). */
+    floatingPreferencesButtonProps?: Record<string, unknown>;
     /**
      * Desabilita o botão flutuante de preferências.
      * Útil quando o usuário da lib quer ter controle total sobre o acesso às preferências.
@@ -1600,7 +1605,7 @@ declare function ConsentGate(props: Readonly<{
  *
  * @param {string} id Um identificador único para o elemento `<script>` a ser criado.
  * @param {string} src A URL do script externo a ser carregado.
- * @param {'analytics' | 'marketing' | null} [category=null] A categoria de consentimento exigida para o script. Se o consentimento para esta categoria não for dado, o script não será carregado.
+ * @param {import('../types/types').Category | null} [category=null] A categoria de consentimento exigida para o script. Se o consentimento para esta categoria não for dado, o script não será carregado.
  * @param {Record<string, string>} [attrs={}] Atributos adicionais a serem aplicados ao elemento `<script>` (ex: `{ async: 'true' }`).
  * @returns {Promise<void>} Uma Promise que resolve quando o script é carregado com sucesso, ou rejeita se o consentimento não for dado ou ocorrer um erro de carregamento.
  * @example
@@ -1611,7 +1616,8 @@ declare function ConsentGate(props: Readonly<{
  *   .catch(error => console.error('Erro ao carregar script:', error))
  * ```
  */
-declare function loadScript(id: string, src: string, category?: 'analytics' | 'marketing' | null, attrs?: Record<string, string>): Promise<void>;
+
+declare function loadScript(id: string, src: string, category?: Category | null, attrs?: Record<string, string>): Promise<void>;
 
 /**
  * @constant
@@ -1637,13 +1643,19 @@ declare const defaultConsentTheme: () => Theme;
 
 /**
  * @interface ScriptIntegration
- * Define a estrutura de um objeto de integração de script, usado para carregar scripts de terceiros condicionalmente.
+ * Estrutura de uma integração de script de terceiros a ser carregada condicionalmente conforme o consentimento.
+ *
+ * @remarks
+ * - `category` é um `Category` tipado (ex.: 'analytics', 'marketing').
+ * - `init` roda após o script ser inserido no DOM e carregado.
+ * - `attrs` é repassado como atributos HTML da tag `<script>`.
  */
+
 interface ScriptIntegration {
     /** Um ID único para esta integração de script. */
     id: string;
-    /** A categoria de consentimento necessária para que este script seja carregado (ex: 'analytics', 'marketing'). */
-    category: string;
+    /** Categoria de consentimento necessária para carregar o script. */
+    category: Category;
     /** A URL do script a ser carregado. */
     src: string;
     /** Uma função opcional a ser executada após o script ser carregado e inicializado no DOM. */
@@ -1658,8 +1670,8 @@ interface ScriptIntegration {
 interface GoogleAnalyticsConfig {
     /** O ID de medição do GA4 (ex: 'G-XXXXXXXXXX'). */
     measurementId: string;
-    /** Um objeto opcional de configuração adicional a ser passado para o comando `gtag('config')`. */
-    config?: any;
+    /** Objeto opcional repassado para `gtag('config')`. */
+    config?: Record<string, unknown>;
 }
 /**
  * @interface GoogleTagManagerConfig
@@ -1683,30 +1695,30 @@ interface UserWayConfig {
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o Google Analytics 4 (GA4).
+ * Cria uma integração para Google Analytics 4 (GA4).
  *
- * @param {GoogleAnalyticsConfig} config A configuração do GA4, incluindo o `measurementId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o GA4.
+ * @param {GoogleAnalyticsConfig} config Configuração com `measurementId` e `config` opcional.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'analytics'`.
  */
 declare function createGoogleAnalyticsIntegration(config: GoogleAnalyticsConfig): ScriptIntegration;
 /**
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o Google Tag Manager (GTM).
+ * Cria uma integração para Google Tag Manager (GTM).
  *
- * @param {GoogleTagManagerConfig} config A configuração do GTM, incluindo o `containerId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o GTM.
+ * @param {GoogleTagManagerConfig} config Configuração com `containerId` e `dataLayerName` opcional.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'analytics'`.
  */
 declare function createGoogleTagManagerIntegration(config: GoogleTagManagerConfig): ScriptIntegration;
 /**
  * @function
  * @category Utils
  * @since 0.2.0
- * Cria um objeto de integração para o widget de acessibilidade UserWay.
+ * Cria uma integração para o widget de acessibilidade UserWay.
  *
- * @param {UserWayConfig} config A configuração do UserWay, incluindo o `accountId`.
- * @returns {ScriptIntegration} Um objeto `ScriptIntegration` configurado para o UserWay.
+ * @param {UserWayConfig} config Configuração com `accountId`.
+ * @returns {ScriptIntegration} Integração tipada com `category: 'functional'`.
  */
 declare function createUserWayIntegration(config: UserWayConfig): ScriptIntegration;
 /**

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   useConsentTexts,
   useOpenPreferencesModal,
   validateProjectPreferences
-} from "./chunk-MHCQFGRJ.js";
+} from "./chunk-TKN3PNIW.js";
 
 // src/utils/ConsentGate.tsx
 import { Fragment, jsx } from "react/jsx-runtime";
@@ -152,13 +152,7 @@ function ConsentScriptLoader({
       const alreadyLoaded = loadedScripts.current.has(integration.id);
       if (shouldLoad && (!alreadyLoaded || reloadOnChange)) {
         try {
-          await loadScript(
-            integration.id,
-            integration.src,
-            integration.category,
-            // Categoria dinâmica
-            integration.attrs
-          );
+          await loadScript(integration.id, integration.src, integration.category, integration.attrs);
           if (integration.init) {
             integration.init();
           }
@@ -187,13 +181,7 @@ function useConsentScriptLoader() {
         return false;
       }
       try {
-        await loadScript(
-          integration.id,
-          integration.src,
-          integration.category,
-          // Categoria dinâmica
-          integration.attrs
-        );
+        await loadScript(integration.id, integration.src, integration.category, integration.attrs);
         if (integration.init) {
           integration.init();
         }
@@ -215,14 +203,14 @@ function createGoogleAnalyticsIntegration(config) {
     src: `https://www.googletagmanager.com/gtag/js?id=${config.measurementId}`,
     init: () => {
       if (typeof window !== "undefined") {
-        let gtag2 = function(...args) {
-          window.dataLayer.push(...args);
+        const w = window;
+        w.dataLayer = w.dataLayer ?? [];
+        const gtag = (...args) => {
+          w.dataLayer.push(...args);
         };
-        var gtag = gtag2;
-        window.dataLayer = window.dataLayer || [];
-        window.gtag = gtag2;
-        gtag2("js", /* @__PURE__ */ new Date());
-        gtag2("config", config.measurementId, config.config || {});
+        w.gtag = gtag;
+        gtag("js", /* @__PURE__ */ new Date());
+        gtag("config", config.measurementId, config.config ?? {});
       }
     },
     attrs: { async: "true" }
@@ -236,8 +224,10 @@ function createGoogleTagManagerIntegration(config) {
     init: () => {
       if (typeof window !== "undefined") {
         const dataLayerName = config.dataLayerName || "dataLayer";
-        window[dataLayerName] = window[dataLayerName] || [];
-        window[dataLayerName].push({
+        const w = window;
+        const layer = w[dataLayerName] ?? [];
+        w[dataLayerName] = layer;
+        layer.push({
           "gtm.start": (/* @__PURE__ */ new Date()).getTime(),
           event: "gtm.js"
         });
@@ -252,8 +242,9 @@ function createUserWayIntegration(config) {
     src: "https://cdn.userway.org/widget.js",
     init: () => {
       if (typeof window !== "undefined") {
-        window.UserWayWidgetApp = window.UserWayWidgetApp || {};
-        window.UserWayWidgetApp.accountId = config.accountId;
+        const w = window;
+        w.UserWayWidgetApp = w.UserWayWidgetApp || {};
+        w.UserWayWidgetApp.accountId = config.accountId;
       }
     },
     attrs: { "data-account": config.accountId }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Biblioteca de consentimento LGPD, integrações nativas e sistema extensível para React.",
   "keywords": [
     "lgpd",
@@ -54,14 +54,15 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18.18"
+    "node": ">=20.0.0"
   },
-  "packageManager": "npm@10.9.3",
+  "packageManager": "npm@11.6.0",
   "scripts": {
     "clean": "rimraf node_modules package-lock.json dist docs storybook-static .cache .stryker-tmp",
     "build": "cross-env NODE_ENV=production tsup src/index.ts --format esm,cjs --dts --clean",
     "dev": "cross-env NODE_ENV=development tsup src/index.ts --format esm,cjs --dts --watch",
-    "lint": "eslint . --ext .ts,.tsx",
+    "lint": "eslint \"**/*.{ts,tsx}\" --cache",
+    "lint:ci": "eslint \"**/*.{ts,tsx}\" --cache --max-warnings=0",
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\" \"eslint.config.js\"",
     "type-check": "tsc --noEmit",
     "test": "jest --config jest.config.ts",
@@ -95,47 +96,48 @@
     "js-cookie": "^3.0.5"
   },
   "devDependencies": {
-    "@chromatic-com/storybook": "^4.1.1",
-    "@emotion/react": "^11.14.0",
-    "@emotion/styled": "^11.14.1",
-    "@eslint/compat": "^1.3.2",
-    "@mui/icons-material": "^7.3.1",
-    "@mui/material": "^7.3.1",
-    "@storybook/addon-a11y": "^9.1.3",
-    "@storybook/addon-docs": "^9.1.3",
-    "@storybook/addon-vitest": "^9.1.3",
-    "@storybook/react-vite": "^9.1.3",
-    "@stryker-mutator/core": "^9.0.1",
-    "@stryker-mutator/jest-runner": "^9.0.1",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^6.8.0",
-    "@testing-library/react": "^16.3.0",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/jest": "^30.0.0",
-    "@types/js-cookie": "^3.0.6",
-    "@types/node": "^24.3.0",
-    "@types/react": "^19.1.12",
-    "@types/react-dom": "^19.1.9",
-    "@typescript-eslint/eslint-plugin": "^8.41.0",
-    "@typescript-eslint/parser": "^8.41.0",
-    "cross-env": "^10.0.0",
-    "eslint": "^9.34.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jest": "^29.0.1",
-    "eslint-plugin-react-hooks": "^5.2.0",
-    "eslint-plugin-storybook": "^9.1.3",
-    "jest": "^30.1.1",
-    "jest-environment-jsdom": "^30.1.1",
-    "prettier": "^3.6.2",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "rimraf": "^6.0.1",
-    "storybook": "^9.1.3",
-    "ts-jest": "^29.4.1",
-    "ts-node": "^10.9.2",
-    "tsup": "^8.5.0",
-    "typedoc": "^0.28.11",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.41.0"
+    "@chromatic-com/storybook": "4.1.1",
+    "@emotion/react": "11.14.0",
+    "@emotion/styled": "11.14.1",
+    "@eslint/compat": "1.3.2",
+    "@mui/icons-material": "7.3.2",
+    "@mui/material": "7.3.2",
+    "@storybook/addon-a11y": "9.1.5",
+    "@storybook/addon-docs": "9.1.5",
+    "@storybook/addon-vitest": "9.1.5",
+    "@storybook/react-vite": "9.1.5",
+    "@stryker-mutator/core": "9.1.1",
+    "@stryker-mutator/jest-runner": "9.1.1",
+    "@testing-library/dom": "10.4.1",
+    "@testing-library/jest-dom": "6.8.0",
+    "@testing-library/react": "16.3.0",
+    "@testing-library/user-event": "14.6.1",
+    "@types/jest": "29.5.12",
+    "@types/js-cookie": "3.0.6",
+    "@types/node": "24.3.1",
+    "@types/react": "19.1.12",
+    "@types/react-dom": "19.1.9",
+    "@typescript-eslint/eslint-plugin": "8.43.0",
+    "@typescript-eslint/parser": "8.43.0",
+    "cross-env": "10.0.0",
+    "eslint": "8.57.0",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-jest": "29.0.1",
+    "eslint-plugin-react-hooks": "5.2.0",
+    "eslint-plugin-storybook": "9.1.5",
+    "globals": "^15.15.0",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "29.7.0",
+    "prettier": "3.6.2",
+    "react": "19.1.1",
+    "react-dom": "19.1.1",
+    "rimraf": "6.0.1",
+    "storybook": "9.1.5",
+    "ts-jest": "29.4.1",
+    "ts-node": "10.9.2",
+    "tsup": "8.5.0",
+    "typedoc": "0.28.12",
+    "typescript": "5.9.2",
+    "typescript-eslint": "8.43.0"
   }
 }