@react-lgpd-consent/core 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog - @react-lgpd-consent/core
 
+## 0.9.0
+
+### Minor Changes
+
+- [#145](https://github.com/lucianoedipo/react-lgpd-consent/pull/145) [`2d772bc`](https://github.com/lucianoedipo/react-lgpd-consent/commit/2d772bcf72d16ead7faace93f2e71d11c7bfec12) Thanks [@lucianoedipo](https://github.com/lucianoedipo)! - feat: adiciona posicionamento configurável do banner e aprimora textos de consentimento
+
+  ### Melhorias de UX e Posicionamento
+  - **Posicionamento do banner**: novas props `position`, `anchor` e `offset` em `cookieBannerProps` permitem ajustar a posição do banner para evitar colisões com footers fixos, chat widgets e outros elementos flutuantes
+  - **Posicionamento do FAB**: prop `offset` em `floatingPreferencesButtonProps` possibilita afastar o botão flutuante de outros elementos da UI
+  - **Textos de consentimento**: aprimorados os textos padrão para comunicar claramente o uso de cookies necessários e categorias opcionais, melhorando a transparência LGPD/ANPD
+
+  ### Melhorias Técnicas
+  - **Storybook**: removidas stories MDX e adicionada configuração Vite para avisos de tamanho de chunks
+  - **TypeDoc**: removida execução shell em `run-typedoc.mjs` para compatibilidade multiplataforma
+  - **Bundle**: ajustados limites de tamanho no `react-lgpd-consent/package.json`
+  - **MUI Patch**: aplicado patch em `@mui/icons-material@7.3.6` para resolver problemas de compatibilidade com exports
+
+  ### Documentação
+  - Adicionada seção de posicionamento em `QUICKSTART.md` e `API.md`
+  - Atualizada `CONFORMIDADE.md` com ênfase na comunicação clara de categorias
+  - Aprimorada documentação de props em `DesignContext.tsx`
+  - Consolidados links entre pacotes em READMEs
+
+  ### Limpeza e Refinamentos
+  - Ajustados testes de parsing de cookies legados em `cookieUtils.test.ts`
+  - Removidos comentários desnecessários em `cookieDiscovery.ts`
+  - Refinado guidance para desenvolvedores em `developerGuidance.ts`
+
 ## 0.8.0
 
 ### Minor Changes

package/README.md

@@ -133,8 +133,8 @@ Para documentação completa, exemplos e API reference:
 
 ## 🔗 Pacotes Relacionados
 
-- [`@react-lgpd-consent/mui`](../mui) - Componentes prontos usando Material-UI
-- [`react-lgpd-consent`](../react-lgpd-consent) - Pacote agregador (core + mui)
+- [`@react-lgpd-consent/mui`](../mui/README.md) - Componentes prontos usando Material-UI
+- [`react-lgpd-consent`](../react-lgpd-consent/README.md) - Pacote agregador (core + mui)
 
 ## 📄 Licença
 

package/dist/index.cjs

@@ -118,7 +118,7 @@ var EXPANDED_DEFAULT_TEXTS = {
   // Variações de tom
   variants: {
     formal: {
-      bannerMessage: "Este s\xEDtio eletr\xF4nico utiliza cookies para otimizar a experi\xEAncia de navega\xE7\xE3o.",
+      bannerMessage: "Este s\xEDtio eletr\xF4nico utiliza cookies necess\xE1rios e, mediante sua autoriza\xE7\xE3o, cookies opcionais para otimizar a experi\xEAncia de navega\xE7\xE3o.",
       acceptAll: "Concordar com todos os cookies",
       declineAll: "Recusar cookies opcionais",
       modalTitle: "Configura\xE7\xE3o de Cookies"
@@ -136,7 +136,7 @@ var EXPANDED_DEFAULT_TEXTS = {
       modalTitle: "Cookies"
     },
     detailed: {
-      bannerMessage: "Utilizamos cookies e tecnologias similares para melhorar sua experi\xEAncia de navega\xE7\xE3o, personalizar conte\xFAdo, analisar tr\xE1fego e oferecer funcionalidades de redes sociais.",
+      bannerMessage: "Utilizamos cookies e tecnologias similares para melhorar sua experi\xEAncia de navega\xE7\xE3o, personalizar conte\xFAdo, analisar tr\xE1fego e oferecer funcionalidades de redes sociais. Os cookies necess\xE1rios permanecem ativos e os opcionais dependem da sua autoriza\xE7\xE3o.",
       acceptAll: "Aceitar todos os cookies e tecnologias",
       declineAll: "Recusar todos os cookies opcionais",
       modalTitle: "Centro de Prefer\xEAncias de Privacidade"
@@ -700,7 +700,7 @@ function removeConsentCookie(opts) {
 }
 
 // src/utils/dataLayerEvents.ts
-var LIBRARY_VERSION = "0.8.0";
+var LIBRARY_VERSION = "0.9.0";
 function ensureDataLayer() {
   const currentWindow = globalThis.window;
   if (!currentWindow) return;
@@ -2013,10 +2013,7 @@ function useCategoryStatus(categoryId) {
   };
 }
 var DesignContext = React4__namespace.createContext(void 0);
-function DesignProvider({
-  tokens,
-  children
-}) {
+function DesignProvider({ tokens, children }) {
   return /* @__PURE__ */ jsxRuntime.jsx(DesignContext.Provider, { value: tokens, children });
 }
 function useDesignTokens() {
@@ -2038,19 +2035,19 @@ function createFullConsentState(consented, preferences, source, projectConfig, i
 }
 var BASE_TEXTS = {
   // Textos básicos
-  bannerMessage: "Usamos cookies necess\xE1rios para o funcionamento do site. Os demais cookies s\xE3o opcionais e voc\xEA pode aceitar, rejeitar ou ajustar suas prefer\xEAncias.",
+  bannerMessage: "Usamos cookies necess\xE1rios para o funcionamento do site e, com sua autoriza\xE7\xE3o, cookies opcionais para melhorar sua experi\xEAncia. Voc\xEA pode aceitar todos, rejeitar os opcionais ou ajustar suas prefer\xEAncias.",
   acceptAll: "Aceitar todos",
   declineAll: "Rejeitar opcionais",
   preferences: "Prefer\xEAncias",
   policyLink: "Pol\xEDtica de privacidade",
   modalTitle: "Prefer\xEAncias de cookies",
-  modalIntro: "Cookies necess\xE1rios s\xE3o sempre ativos. As demais categorias s\xE3o opcionais e voc\xEA pode ativ\xE1-las ou desativ\xE1-las a qualquer momento.",
+  modalIntro: "Cookies necess\xE1rios s\xE3o sempre ativos. As categorias opcionais s\xF3 ser\xE3o usadas com sua autoriza\xE7\xE3o e podem ser ativadas ou desativadas a qualquer momento.",
   save: "Salvar prefer\xEAncias",
   necessaryAlwaysOn: "Cookies necess\xE1rios (sempre ativos)",
   // Textos adicionais para UI customizada
   preferencesButton: "Gerenciar cookies",
   preferencesTitle: "Gerenciar prefer\xEAncias de cookies",
-  preferencesDescription: "Escolha quais categorias opcionais voc\xEA permite. Cookies necess\xE1rios permanecem sempre ativos.",
+  preferencesDescription: "Escolha quais categorias opcionais voc\xEA permite. Cookies necess\xE1rios permanecem sempre ativos e voc\xEA pode mudar sua escolha quando quiser.",
   close: "Fechar",
   accept: "Aceitar",
   reject: "Rejeitar",

package/dist/index.d.cts

@@ -2713,8 +2713,9 @@ declare function useCategoryStatus(categoryId: string): {
  * precisam acessar tokens de design. Permite overrides globais de design sem alterar
  * os componentes individuais, mantendo tree-shaking e performance.
  *
- * @param tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
- * @param children - Componentes filhos que terão acesso aos tokens via contexto
+ * @param props - Propriedades do DesignProvider.
+ * @param props.tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
+ * @param props.children - Componentes filhos que terão acesso aos tokens via contexto
  *
  * @example Uso básico com tokens padrão
  * ```tsx
@@ -2752,10 +2753,11 @@ declare function useCategoryStatus(categoryId: string): {
  * @category Context
  * @since 0.1.0
  */
-declare function DesignProvider({ tokens, children, }: Readonly<{
+interface DesignProviderProps {
     tokens?: DesignTokens;
     children: React$1.ReactNode;
-}>): react_jsx_runtime.JSX.Element;
+}
+declare function DesignProvider({ tokens, children }: Readonly<DesignProviderProps>): react_jsx_runtime.JSX.Element;
 /**
  * Hook para acessar os tokens de design do contexto atual.
  *

package/dist/index.d.ts

@@ -2713,8 +2713,9 @@ declare function useCategoryStatus(categoryId: string): {
  * precisam acessar tokens de design. Permite overrides globais de design sem alterar
  * os componentes individuais, mantendo tree-shaking e performance.
  *
- * @param tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
- * @param children - Componentes filhos que terão acesso aos tokens via contexto
+ * @param props - Propriedades do DesignProvider.
+ * @param props.tokens - Tokens de design opcionais para customização (cores, layouts, etc.)
+ * @param props.children - Componentes filhos que terão acesso aos tokens via contexto
  *
  * @example Uso básico com tokens padrão
  * ```tsx
@@ -2752,10 +2753,11 @@ declare function useCategoryStatus(categoryId: string): {
  * @category Context
  * @since 0.1.0
  */
-declare function DesignProvider({ tokens, children, }: Readonly<{
+interface DesignProviderProps {
     tokens?: DesignTokens;
     children: React$1.ReactNode;
-}>): react_jsx_runtime.JSX.Element;
+}
+declare function DesignProvider({ tokens, children }: Readonly<DesignProviderProps>): react_jsx_runtime.JSX.Element;
 /**
  * Hook para acessar os tokens de design do contexto atual.
  *

package/dist/index.js

@@ -94,7 +94,7 @@ var EXPANDED_DEFAULT_TEXTS = {
   // Variações de tom
   variants: {
     formal: {
-      bannerMessage: "Este s\xEDtio eletr\xF4nico utiliza cookies para otimizar a experi\xEAncia de navega\xE7\xE3o.",
+      bannerMessage: "Este s\xEDtio eletr\xF4nico utiliza cookies necess\xE1rios e, mediante sua autoriza\xE7\xE3o, cookies opcionais para otimizar a experi\xEAncia de navega\xE7\xE3o.",
       acceptAll: "Concordar com todos os cookies",
       declineAll: "Recusar cookies opcionais",
       modalTitle: "Configura\xE7\xE3o de Cookies"
@@ -112,7 +112,7 @@ var EXPANDED_DEFAULT_TEXTS = {
       modalTitle: "Cookies"
     },
     detailed: {
-      bannerMessage: "Utilizamos cookies e tecnologias similares para melhorar sua experi\xEAncia de navega\xE7\xE3o, personalizar conte\xFAdo, analisar tr\xE1fego e oferecer funcionalidades de redes sociais.",
+      bannerMessage: "Utilizamos cookies e tecnologias similares para melhorar sua experi\xEAncia de navega\xE7\xE3o, personalizar conte\xFAdo, analisar tr\xE1fego e oferecer funcionalidades de redes sociais. Os cookies necess\xE1rios permanecem ativos e os opcionais dependem da sua autoriza\xE7\xE3o.",
       acceptAll: "Aceitar todos os cookies e tecnologias",
       declineAll: "Recusar todos os cookies opcionais",
       modalTitle: "Centro de Prefer\xEAncias de Privacidade"
@@ -676,7 +676,7 @@ function removeConsentCookie(opts) {
 }
 
 // src/utils/dataLayerEvents.ts
-var LIBRARY_VERSION = "0.8.0";
+var LIBRARY_VERSION = "0.9.0";
 function ensureDataLayer() {
   const currentWindow = globalThis.window;
   if (!currentWindow) return;
@@ -1989,10 +1989,7 @@ function useCategoryStatus(categoryId) {
   };
 }
 var DesignContext = React4.createContext(void 0);
-function DesignProvider({
-  tokens,
-  children
-}) {
+function DesignProvider({ tokens, children }) {
   return /* @__PURE__ */ jsx(DesignContext.Provider, { value: tokens, children });
 }
 function useDesignTokens() {
@@ -2014,19 +2011,19 @@ function createFullConsentState(consented, preferences, source, projectConfig, i
 }
 var BASE_TEXTS = {
   // Textos básicos
-  bannerMessage: "Usamos cookies necess\xE1rios para o funcionamento do site. Os demais cookies s\xE3o opcionais e voc\xEA pode aceitar, rejeitar ou ajustar suas prefer\xEAncias.",
+  bannerMessage: "Usamos cookies necess\xE1rios para o funcionamento do site e, com sua autoriza\xE7\xE3o, cookies opcionais para melhorar sua experi\xEAncia. Voc\xEA pode aceitar todos, rejeitar os opcionais ou ajustar suas prefer\xEAncias.",
   acceptAll: "Aceitar todos",
   declineAll: "Rejeitar opcionais",
   preferences: "Prefer\xEAncias",
   policyLink: "Pol\xEDtica de privacidade",
   modalTitle: "Prefer\xEAncias de cookies",
-  modalIntro: "Cookies necess\xE1rios s\xE3o sempre ativos. As demais categorias s\xE3o opcionais e voc\xEA pode ativ\xE1-las ou desativ\xE1-las a qualquer momento.",
+  modalIntro: "Cookies necess\xE1rios s\xE3o sempre ativos. As categorias opcionais s\xF3 ser\xE3o usadas com sua autoriza\xE7\xE3o e podem ser ativadas ou desativadas a qualquer momento.",
   save: "Salvar prefer\xEAncias",
   necessaryAlwaysOn: "Cookies necess\xE1rios (sempre ativos)",
   // Textos adicionais para UI customizada
   preferencesButton: "Gerenciar cookies",
   preferencesTitle: "Gerenciar prefer\xEAncias de cookies",
-  preferencesDescription: "Escolha quais categorias opcionais voc\xEA permite. Cookies necess\xE1rios permanecem sempre ativos.",
+  preferencesDescription: "Escolha quais categorias opcionais voc\xEA permite. Cookies necess\xE1rios permanecem sempre ativos e voc\xEA pode mudar sua escolha quando quiser.",
   close: "Fechar",
   accept: "Aceitar",
   reject: "Rejeitar",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-lgpd-consent/core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Núcleo da biblioteca de consentimento LGPD para React - Estado, hooks e utilitários sem dependências de UI",
   "keywords": [
     "lgpd",
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "js-cookie": "^3.0.5",
-    "zod": "^4.2.1"
+    "zod": "^4.3.4"
   },
   "repository": {
     "type": "git",