react-lgpd-consent 0.1.8 → 0.1.11

package/README.md

@@ -2,7 +2,39 @@
 
 [![NPM Version](https://img.shields.io/npm/v/react-lgpd-consent?style=for-the-badge&color=blue)](https://www.npmjs.com/package/react-lgpd-consent)
 [![License](https://img.shields.io/npm/l/react-lgpd-consent?style=for-the-badge)](https://github.com/lucianoedipo/react-lgpd-consent/blob/main/LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
+[![TypeScrip```
+
+## 🎛️ Botão Flutuante de Preferências
+
+Para facilitar o acesso às configurações após consentimento inicial:
+
+```tsx
+import { FloatingPreferencesButton } from 'react-lgpd-consent'
+
+function App() {
+  return (
+    <ConsentProvider>
+      <MeuApp />
+      <CookieBanner />
+
+      {/* Botão flutuante opcional */}
+      <FloatingPreferencesButton
+        position="bottom-right"
+        hideWhenConsented={false}
+        tooltip="Configurar Cookies"
+      />
+    </ConsentProvider>
+  )
+}
+```
+
+### Posições Disponíveis
+
+- `bottom-left` | `bottom-right` (padrão)
+- `top-left` | `top-right`
+
+## 🔧 API Completahttps://img.shields.io/badge/TypeScript-Ready-blue?style=for-the-badge&logo=typescript)](https://www.typescriptlang.org/)
+
 [![React](https://img.shields.io/badge/React-18%2B-61DAFB?style=for-the-badge&logo=react)](https://reactjs.org/)
 [![Material-UI](https://img.shields.io/badge/MUI-Ready-007FFF?style=for-the-badge&logo=mui)](https://mui.com/)
 
@@ -24,6 +56,7 @@ Solução moderna, acessível e personalizável para gerenciar consentimento de
 - 🎨 **Sistema de Temas**: Temas customizáveis para integração visual perfeita
 - ⚡ **Carregamento Condicional**: Scripts só executam após consentimento explícito
 - 🔌 **Modal Automático**: Modal de preferências incluído automaticamente com lazy loading
+- 🎛️ **Botão Flutuante**: Componente opcional para acesso fácil às preferências
 
 ## 🚀 Instalação
 
@@ -44,7 +77,11 @@ npm install @mui/material js-cookie
 ## � Exemplo Completo
 
 ```tsx
-import { ConsentProvider, CookieBanner } from 'react-lgpd-consent'
+import {
+  ConsentProvider,
+  CookieBanner,
+  FloatingPreferencesButton,
+} from 'react-lgpd-consent'
 
 function App() {
   return (
@@ -53,8 +90,11 @@ function App() {
         <h1>Meu Site</h1>
         <p>Conteúdo do site...</p>
 
-        {/* Banner de cookies */}
+        {/* Banner de cookies - Modal incluído automaticamente! */}
         <CookieBanner policyLinkUrl="/privacy-policy" blocking={true} />
+
+        {/* Botão flutuante opcional para acesso às preferências */}
+        <FloatingPreferencesButton position="bottom-right" />
       </div>
     </ConsentProvider>
   )
@@ -343,12 +383,13 @@ Para controle total, desabilite o modal automático:
 
 ### Components
 
-| Componente         | Descrição                                        | Props Principais                                                                                  |
-| ------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
-| `ConsentProvider`  | Provider principal do contexto                   | `initialState`, `texts`, `theme`, `PreferencesModalComponent`, `disableAutomaticModal`, callbacks |
-| `CookieBanner`     | Banner de consentimento                          | `policyLinkUrl`, `blocking`, `debug`, pass-through MUI props                                      |
-| `PreferencesModal` | Modal de preferências (incluído automaticamente) | `DialogProps` (MUI pass-through) - **Opcional**                                                   |
-| `ConsentGate`      | Renderização condicional por categoria           | `category`, `children`                                                                            |
+| Componente                  | Descrição                                        | Props Principais                                                                         |
+| --------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------- |
+| `ConsentProvider`           | Provider principal do contexto                   | `initialState`, `texts`, `theme`, `hideBranding`, `PreferencesModalComponent`, callbacks |
+| `CookieBanner`              | Banner de consentimento                          | `policyLinkUrl`, `blocking`, `hideBranding`, `debug`, pass-through MUI props             |
+| `PreferencesModal`          | Modal de preferências (incluído automaticamente) | `DialogProps`, `hideBranding` - **Opcional**                                             |
+| `FloatingPreferencesButton` | Botão flutuante para abrir preferências          | `position`, `hideWhenConsented`, `tooltip`, `icon`, `FabProps`                           |
+| `ConsentGate`               | Renderização condicional por categoria           | `category`, `children`                                                                   |
 
 ### Hook `useConsent()`
 

package/dist/{PreferencesModal-4FDYT7VE.js → PreferencesModal-IHXZDNYT.js}

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

package/dist/{chunk-Y4XEAQXV.js → chunk-LRMSFSP2.js}

@@ -7,8 +7,8 @@ import DialogTitle from "@mui/material/DialogTitle";
 import FormControlLabel from "@mui/material/FormControlLabel";
 import FormGroup from "@mui/material/FormGroup";
 import Switch from "@mui/material/Switch";
-import Typography from "@mui/material/Typography";
-import { useState, useEffect as useEffect2 } from "react";
+import Typography2 from "@mui/material/Typography";
+import { useEffect as useEffect2, useState as useState2 } from "react";
 
 // src/context/ConsentContext.tsx
 import * as React from "react";
@@ -20,7 +20,7 @@ var DEFAULT_COOKIE_OPTS = {
   name: "cookieConsent",
   maxAgeDays: 365,
   sameSite: "Lax",
-  secure: true,
+  secure: typeof window !== "undefined" ? window.location.protocol === "https:" : false,
   path: "/"
 };
 function readConsentCookie(name = DEFAULT_COOKIE_OPTS.name) {
@@ -123,7 +123,7 @@ var defaultConsentTheme = createTheme({
 // src/context/ConsentContext.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 var PreferencesModal = React.lazy(
-  () => import("./PreferencesModal-4FDYT7VE.js").then((m) => ({
+  () => import("./PreferencesModal-IHXZDNYT.js").then((m) => ({
     default: m.PreferencesModal
   }))
 );
@@ -191,6 +191,7 @@ function reducer(state, action) {
 var StateCtx = React.createContext(null);
 var ActionsCtx = React.createContext(null);
 var TextsCtx = React.createContext(DEFAULT_TEXTS);
+var HydrationCtx = React.createContext(false);
 function ConsentProvider({
   initialState,
   texts: textsProp,
@@ -198,6 +199,7 @@ function ConsentProvider({
   PreferencesModalComponent,
   preferencesModalProps = {},
   disableAutomaticModal = false,
+  hideBranding = false,
   onConsentGiven,
   onPreferencesSaved,
   cookie: cookieOpts,
@@ -217,14 +219,24 @@ function ConsentProvider({
   );
   const boot = React.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
-    const saved = readConsentCookie(cookie.name);
-    return saved ?? {
+    return {
       consented: false,
       preferences: { ...DEFAULT_PREFERENCES },
       isModalOpen: false
     };
-  }, [initialState, cookie.name]);
+  }, [initialState]);
   const [state, dispatch] = React.useReducer(reducer, boot);
+  const [isHydrated, setIsHydrated] = React.useState(false);
+  React.useEffect(() => {
+    if (typeof window !== "undefined" && !initialState) {
+      const saved = readConsentCookie(cookie.name);
+      if (saved?.consented) {
+        console.log("\u{1F680} Immediate hydration: Cookie found", saved);
+        dispatch({ type: "HYDRATE", state: saved });
+      }
+    }
+    setIsHydrated(true);
+  }, [cookie.name, initialState]);
   React.useEffect(() => {
     if (state.consented) writeConsentCookie(state, cookie);
   }, [state, cookie]);
@@ -266,10 +278,10 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie]);
-  return /* @__PURE__ */ jsx(ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsxs(TextsCtx.Provider, { value: texts, children: [
+  return /* @__PURE__ */ jsx(ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ jsx(StateCtx.Provider, { value: state, children: /* @__PURE__ */ jsx(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ jsx(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ jsxs(HydrationCtx.Provider, { value: isHydrated, children: [
     children,
-    !disableAutomaticModal && /* @__PURE__ */ jsx(React.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ jsx(PreferencesModal, {}) })
-  ] }) }) }) });
+    !disableAutomaticModal && /* @__PURE__ */ jsx(React.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ jsx(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ jsx(PreferencesModal, { hideBranding }) })
+  ] }) }) }) }) });
 }
 function useConsentStateInternal() {
   const ctx = React.useContext(StateCtx);
@@ -287,6 +299,9 @@ function useConsentTextsInternal() {
   const ctx = React.useContext(TextsCtx);
   return ctx;
 }
+function useConsentHydrationInternal() {
+  return React.useContext(HydrationCtx);
+}
 
 // src/hooks/useConsent.ts
 function useConsent() {
@@ -308,15 +323,78 @@ function useConsent() {
 function useConsentTexts() {
   return useConsentTextsInternal();
 }
+function useConsentHydration() {
+  return useConsentHydrationInternal();
+}
 
-// src/components/PreferencesModal.tsx
+// src/components/Branding.tsx
+import Link from "@mui/material/Link";
+import Typography from "@mui/material/Typography";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var brandingStyles = {
+  banner: {
+    fontSize: "0.65rem",
+    textAlign: "center",
+    mt: 1,
+    opacity: 0.7,
+    fontStyle: "italic"
+  },
+  modal: {
+    fontSize: "0.65rem",
+    textAlign: "center",
+    px: 3,
+    pb: 1,
+    opacity: 0.7,
+    fontStyle: "italic"
+  }
+};
+var linkStyles = {
+  textDecoration: "none",
+  fontWeight: 500,
+  "&:hover": {
+    textDecoration: "underline"
+  }
+};
+function Branding({ variant, hidden = false }) {
+  if (hidden) return null;
+  return /* @__PURE__ */ jsxs2(
+    Typography,
+    {
+      variant: "caption",
+      sx: (theme) => ({
+        ...brandingStyles[variant],
+        color: theme.palette.text.secondary
+      }),
+      children: [
+        "fornecido por",
+        " ",
+        /* @__PURE__ */ jsx2(
+          Link,
+          {
+            href: "https://ledipo.eti.br",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            sx: (theme) => ({
+              ...linkStyles,
+              color: theme.palette.primary.main
+            }),
+            children: "L\xC9dipO.eti.br"
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/components/PreferencesModal.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function PreferencesModal2({
-  DialogProps: DialogProps2
+  DialogProps: DialogProps2,
+  hideBranding = false
 }) {
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
-  const [tempPreferences, setTempPreferences] = useState(preferences);
+  const [tempPreferences, setTempPreferences] = useState2(preferences);
   useEffect2(() => {
     if (isModalOpen) {
       setTempPreferences(preferences);
@@ -330,7 +408,7 @@ function PreferencesModal2({
     setTempPreferences(preferences);
     closePreferences();
   };
-  return /* @__PURE__ */ jsxs2(
+  return /* @__PURE__ */ jsxs3(
     Dialog,
     {
       "aria-labelledby": "cookie-pref-title",
@@ -338,14 +416,14 @@ function PreferencesModal2({
       onClose: handleCancel,
       ...DialogProps2,
       children: [
-        /* @__PURE__ */ jsx2(DialogTitle, { id: "cookie-pref-title", children: texts.modalTitle }),
-        /* @__PURE__ */ jsxs2(DialogContent, { dividers: true, children: [
-          /* @__PURE__ */ jsx2(Typography, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
-          /* @__PURE__ */ jsxs2(FormGroup, { children: [
-            /* @__PURE__ */ jsx2(
+        /* @__PURE__ */ jsx3(DialogTitle, { id: "cookie-pref-title", children: texts.modalTitle }),
+        /* @__PURE__ */ jsxs3(DialogContent, { dividers: true, children: [
+          /* @__PURE__ */ jsx3(Typography2, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
+          /* @__PURE__ */ jsxs3(FormGroup, { children: [
+            /* @__PURE__ */ jsx3(
               FormControlLabel,
               {
-                control: /* @__PURE__ */ jsx2(
+                control: /* @__PURE__ */ jsx3(
                   Switch,
                   {
                     checked: tempPreferences.analytics,
@@ -358,10 +436,10 @@ function PreferencesModal2({
                 label: "Cookies Anal\xEDticos (medem uso do site)"
               }
             ),
-            /* @__PURE__ */ jsx2(
+            /* @__PURE__ */ jsx3(
               FormControlLabel,
               {
-                control: /* @__PURE__ */ jsx2(
+                control: /* @__PURE__ */ jsx3(
                   Switch,
                   {
                     checked: tempPreferences.marketing,
@@ -374,18 +452,19 @@ function PreferencesModal2({
                 label: "Cookies de Marketing/Publicidade"
               }
             ),
-            /* @__PURE__ */ jsx2(
+            /* @__PURE__ */ jsx3(
               FormControlLabel,
               {
-                control: /* @__PURE__ */ jsx2(Switch, { checked: true, disabled: true }),
+                control: /* @__PURE__ */ jsx3(Switch, { checked: true, disabled: true }),
                 label: texts.necessaryAlwaysOn
               }
             )
           ] })
         ] }),
-        /* @__PURE__ */ jsxs2(DialogActions, { children: [
-          /* @__PURE__ */ jsx2(Button, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
-          /* @__PURE__ */ jsx2(Button, { variant: "contained", onClick: handleSave, children: texts.save })
+        !hideBranding && /* @__PURE__ */ jsx3(Branding, { variant: "modal" }),
+        /* @__PURE__ */ jsxs3(DialogActions, { children: [
+          /* @__PURE__ */ jsx3(Button, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
+          /* @__PURE__ */ jsx3(Button, { variant: "contained", onClick: handleSave, children: texts.save })
         ] })
       ]
     }
@@ -394,8 +473,10 @@ function PreferencesModal2({
 
 export {
   defaultConsentTheme,
+  Branding,
   PreferencesModal2 as PreferencesModal,
   ConsentProvider,
   useConsent,
-  useConsentTexts
+  useConsentTexts,
+  useConsentHydration
 };

package/dist/index.cjs

@@ -65,7 +65,7 @@ var init_cookieUtils = __esm({
       name: "cookieConsent",
       maxAgeDays: 365,
       sameSite: "Lax",
-      secure: true,
+      secure: typeof window !== "undefined" ? window.location.protocol === "https:" : false,
       path: "/"
     };
   }
@@ -148,13 +148,79 @@ var init_theme = __esm({
   }
 });
 
+// src/components/Branding.tsx
+function Branding({ variant, hidden = false }) {
+  if (hidden) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    import_Typography.default,
+    {
+      variant: "caption",
+      sx: (theme) => ({
+        ...brandingStyles[variant],
+        color: theme.palette.text.secondary
+      }),
+      children: [
+        "fornecido por",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          import_Link.default,
+          {
+            href: "https://ledipo.eti.br",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            sx: (theme) => ({
+              ...linkStyles,
+              color: theme.palette.primary.main
+            }),
+            children: "L\xC9dipO.eti.br"
+          }
+        )
+      ]
+    }
+  );
+}
+var import_Link, import_Typography, import_jsx_runtime, brandingStyles, linkStyles;
+var init_Branding = __esm({
+  "src/components/Branding.tsx"() {
+    "use strict";
+    import_Link = __toESM(require("@mui/material/Link"), 1);
+    import_Typography = __toESM(require("@mui/material/Typography"), 1);
+    import_jsx_runtime = require("react/jsx-runtime");
+    brandingStyles = {
+      banner: {
+        fontSize: "0.65rem",
+        textAlign: "center",
+        mt: 1,
+        opacity: 0.7,
+        fontStyle: "italic"
+      },
+      modal: {
+        fontSize: "0.65rem",
+        textAlign: "center",
+        px: 3,
+        pb: 1,
+        opacity: 0.7,
+        fontStyle: "italic"
+      }
+    };
+    linkStyles = {
+      textDecoration: "none",
+      fontWeight: 500,
+      "&:hover": {
+        textDecoration: "underline"
+      }
+    };
+  }
+});
+
 // src/components/PreferencesModal.tsx
 var PreferencesModal_exports = {};
 __export(PreferencesModal_exports, {
   PreferencesModal: () => PreferencesModal
 });
 function PreferencesModal({
-  DialogProps: DialogProps2
+  DialogProps: DialogProps2,
+  hideBranding = false
 }) {
   const { preferences, setPreferences, closePreferences, isModalOpen } = useConsent();
   const texts = useConsentTexts();
@@ -172,7 +238,7 @@ function PreferencesModal({
     setTempPreferences(preferences);
     closePreferences();
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
     import_Dialog.default,
     {
       "aria-labelledby": "cookie-pref-title",
@@ -180,14 +246,14 @@ function PreferencesModal({
       onClose: handleCancel,
       ...DialogProps2,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_DialogTitle.default, { id: "cookie-pref-title", children: texts.modalTitle }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_DialogContent.default, { dividers: true, children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Typography.default, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_FormGroup.default, { children: [
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_DialogTitle.default, { id: "cookie-pref-title", children: texts.modalTitle }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_DialogContent.default, { dividers: true, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_Typography2.default, { variant: "body2", sx: { mb: 2 }, children: texts.modalIntro }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_FormGroup.default, { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
               import_FormControlLabel.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                control: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
                   import_Switch.default,
                   {
                     checked: tempPreferences.analytics,
@@ -200,10 +266,10 @@ function PreferencesModal({
                 label: "Cookies Anal\xEDticos (medem uso do site)"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
               import_FormControlLabel.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                control: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
                   import_Switch.default,
                   {
                     checked: tempPreferences.marketing,
@@ -216,24 +282,25 @@ function PreferencesModal({
                 label: "Cookies de Marketing/Publicidade"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
               import_FormControlLabel.default,
               {
-                control: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Switch.default, { checked: true, disabled: true }),
+                control: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_Switch.default, { checked: true, disabled: true }),
                 label: texts.necessaryAlwaysOn
               }
             )
           ] })
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_DialogActions.default, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Button.default, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_Button.default, { variant: "contained", onClick: handleSave, children: texts.save })
+        !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Branding, { variant: "modal" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_DialogActions.default, { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_Button.default, { variant: "outlined", onClick: handleCancel, children: "Cancelar" }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_Button.default, { variant: "contained", onClick: handleSave, children: texts.save })
         ] })
       ]
     }
   );
 }
-var import_Button, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography, import_react, import_jsx_runtime;
+var import_Button, import_Dialog, import_DialogActions, import_DialogContent, import_DialogTitle, import_FormControlLabel, import_FormGroup, import_Switch, import_Typography2, import_react, import_jsx_runtime2;
 var init_PreferencesModal = __esm({
   "src/components/PreferencesModal.tsx"() {
     "use strict";
@@ -245,10 +312,11 @@ var init_PreferencesModal = __esm({
     import_FormControlLabel = __toESM(require("@mui/material/FormControlLabel"), 1);
     import_FormGroup = __toESM(require("@mui/material/FormGroup"), 1);
     import_Switch = __toESM(require("@mui/material/Switch"), 1);
-    import_Typography = __toESM(require("@mui/material/Typography"), 1);
+    import_Typography2 = __toESM(require("@mui/material/Typography"), 1);
     import_react = require("react");
     init_useConsent();
-    import_jsx_runtime = require("react/jsx-runtime");
+    init_Branding();
+    import_jsx_runtime2 = require("react/jsx-runtime");
   }
 });
 
@@ -306,6 +374,7 @@ function ConsentProvider({
   PreferencesModalComponent,
   preferencesModalProps = {},
   disableAutomaticModal = false,
+  hideBranding = false,
   onConsentGiven,
   onPreferencesSaved,
   cookie: cookieOpts,
@@ -325,14 +394,24 @@ function ConsentProvider({
   );
   const boot = React.useMemo(() => {
     if (initialState) return { ...initialState, isModalOpen: false };
-    const saved = readConsentCookie(cookie.name);
-    return saved ?? {
+    return {
       consented: false,
       preferences: { ...DEFAULT_PREFERENCES },
       isModalOpen: false
     };
-  }, [initialState, cookie.name]);
+  }, [initialState]);
   const [state, dispatch] = React.useReducer(reducer, boot);
+  const [isHydrated, setIsHydrated] = React.useState(false);
+  React.useEffect(() => {
+    if (typeof window !== "undefined" && !initialState) {
+      const saved = readConsentCookie(cookie.name);
+      if (saved?.consented) {
+        console.log("\u{1F680} Immediate hydration: Cookie found", saved);
+        dispatch({ type: "HYDRATE", state: saved });
+      }
+    }
+    setIsHydrated(true);
+  }, [cookie.name, initialState]);
   React.useEffect(() => {
     if (state.consented) writeConsentCookie(state, cookie);
   }, [state, cookie]);
@@ -374,10 +453,10 @@ function ConsentProvider({
       resetConsent
     };
   }, [state, cookie]);
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_styles2.ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(TextsCtx.Provider, { value: texts, children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_styles2.ThemeProvider, { theme: appliedTheme, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(StateCtx.Provider, { value: state, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ActionsCtx.Provider, { value: api, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(TextsCtx.Provider, { value: texts, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(HydrationCtx.Provider, { value: isHydrated, children: [
     children,
-    !disableAutomaticModal && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(React.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(PreferencesModal2, {}) })
-  ] }) }) }) });
+    !disableAutomaticModal && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(React.Suspense, { fallback: null, children: PreferencesModalComponent ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PreferencesModalComponent, { ...preferencesModalProps }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(PreferencesModal2, { hideBranding }) })
+  ] }) }) }) }) });
 }
 function useConsentStateInternal() {
   const ctx = React.useContext(StateCtx);
@@ -395,7 +474,10 @@ function useConsentTextsInternal() {
   const ctx = React.useContext(TextsCtx);
   return ctx;
 }
-var React, import_styles2, import_jsx_runtime2, PreferencesModal2, DEFAULT_PREFERENCES, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx;
+function useConsentHydrationInternal() {
+  return React.useContext(HydrationCtx);
+}
+var React, import_styles2, import_jsx_runtime3, PreferencesModal2, DEFAULT_PREFERENCES, DEFAULT_TEXTS, StateCtx, ActionsCtx, TextsCtx, HydrationCtx;
 var init_ConsentContext = __esm({
   "src/context/ConsentContext.tsx"() {
     "use strict";
@@ -403,7 +485,7 @@ var init_ConsentContext = __esm({
     import_styles2 = require("@mui/material/styles");
     init_cookieUtils();
     init_theme();
-    import_jsx_runtime2 = require("react/jsx-runtime");
+    import_jsx_runtime3 = require("react/jsx-runtime");
     PreferencesModal2 = React.lazy(
       () => Promise.resolve().then(() => (init_PreferencesModal(), PreferencesModal_exports)).then((m) => ({
         default: m.PreferencesModal
@@ -427,6 +509,7 @@ var init_ConsentContext = __esm({
     StateCtx = React.createContext(null);
     ActionsCtx = React.createContext(null);
     TextsCtx = React.createContext(DEFAULT_TEXTS);
+    HydrationCtx = React.createContext(false);
   }
 });
 
@@ -450,6 +533,9 @@ function useConsent() {
 function useConsentTexts() {
   return useConsentTextsInternal();
 }
+function useConsentHydration() {
+  return useConsentHydrationInternal();
+}
 var init_useConsent = __esm({
   "src/hooks/useConsent.ts"() {
     "use strict";
@@ -463,10 +549,12 @@ __export(index_exports, {
   ConsentGate: () => ConsentGate,
   ConsentProvider: () => ConsentProvider,
   CookieBanner: () => CookieBanner,
+  FloatingPreferencesButton: () => FloatingPreferencesButton,
   PreferencesModal: () => PreferencesModal,
   defaultConsentTheme: () => defaultConsentTheme,
   loadScript: () => loadScript,
   useConsent: () => useConsent,
+  useConsentHydration: () => useConsentHydration,
   useConsentTexts: () => useConsentTexts
 });
 module.exports = __toCommonJS(index_exports);
@@ -474,37 +562,40 @@ module.exports = __toCommonJS(index_exports);
 // src/components/CookieBanner.tsx
 var import_Button2 = __toESM(require("@mui/material/Button"), 1);
 var import_Box = __toESM(require("@mui/material/Box"), 1);
-var import_Link = __toESM(require("@mui/material/Link"), 1);
 var import_Paper = __toESM(require("@mui/material/Paper"), 1);
 var import_Snackbar = __toESM(require("@mui/material/Snackbar"), 1);
 var import_Stack = __toESM(require("@mui/material/Stack"), 1);
-var import_Typography2 = __toESM(require("@mui/material/Typography"), 1);
+var import_Typography3 = __toESM(require("@mui/material/Typography"), 1);
+var import_Link2 = __toESM(require("@mui/material/Link"), 1);
 init_useConsent();
-var import_jsx_runtime3 = require("react/jsx-runtime");
+init_Branding();
+var import_jsx_runtime4 = require("react/jsx-runtime");
 function CookieBanner({
   policyLinkUrl,
   debug,
   blocking = true,
   // Por padrão, bloqueia até decisão
+  hideBranding = false,
   SnackbarProps,
   PaperProps
 }) {
   const { consented, acceptAll, rejectAll, openPreferences } = useConsent();
   const texts = useConsentTexts();
-  const open = debug ? true : !consented;
+  const isHydrated = useConsentHydration();
+  const open = debug ? true : isHydrated && !consented;
   if (!open) return null;
-  const bannerContent = /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+  const bannerContent = /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
     import_Paper.default,
     {
       elevation: 3,
       sx: { p: 2, maxWidth: 720, mx: "auto" },
       ...PaperProps,
-      children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_Stack.default, { spacing: 1, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_Typography2.default, { variant: "body2", children: [
+      children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_Stack.default, { spacing: 1, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_Typography3.default, { variant: "body2", children: [
           texts.bannerMessage,
           " ",
-          policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-            import_Link.default,
+          policyLinkUrl && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+            import_Link2.default,
             {
               href: policyLinkUrl,
               underline: "hover",
@@ -514,25 +605,26 @@ function CookieBanner({
             }
           )
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
           import_Stack.default,
           {
             direction: { xs: "column", sm: "row" },
             spacing: 1,
             justifyContent: "flex-end",
             children: [
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_Button2.default, { variant: "outlined", onClick: rejectAll, children: texts.declineAll }),
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_Button2.default, { variant: "contained", onClick: acceptAll, children: texts.acceptAll }),
-              /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_Button2.default, { variant: "text", onClick: openPreferences, children: texts.preferences })
+              /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Button2.default, { variant: "outlined", onClick: rejectAll, children: texts.declineAll }),
+              /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Button2.default, { variant: "contained", onClick: acceptAll, children: texts.acceptAll }),
+              /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_Button2.default, { variant: "text", onClick: openPreferences, children: texts.preferences })
             ]
           }
-        )
+        ),
+        !hideBranding && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Branding, { variant: "banner" })
       ] })
     }
   );
   if (blocking) {
-    return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_jsx_runtime3.Fragment, { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_jsx_runtime4.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         import_Box.default,
         {
           sx: {
@@ -547,7 +639,7 @@ function CookieBanner({
           }
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         import_Box.default,
         {
           sx: {
@@ -564,7 +656,7 @@ function CookieBanner({
       )
     ] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
     import_Snackbar.default,
     {
       open,
@@ -577,16 +669,78 @@ function CookieBanner({
 
 // src/index.ts
 init_PreferencesModal();
+
+// src/components/FloatingPreferencesButton.tsx
+var import_Fab = __toESM(require("@mui/material/Fab"), 1);
+var import_Tooltip = __toESM(require("@mui/material/Tooltip"), 1);
+var import_Settings = __toESM(require("@mui/icons-material/Settings"), 1);
+var import_styles3 = require("@mui/material/styles");
+init_useConsent();
+var import_jsx_runtime5 = require("react/jsx-runtime");
+function FloatingPreferencesButton({
+  position = "bottom-right",
+  offset = 24,
+  icon = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_Settings.default, {}),
+  tooltip,
+  FabProps,
+  hideWhenConsented = false
+}) {
+  const { openPreferences, consented } = useConsent();
+  const theme = (0, import_styles3.useTheme)();
+  if (hideWhenConsented && consented) {
+    return null;
+  }
+  const tooltipText = tooltip ?? "Gerenciar Prefer\xEAncias de Cookies";
+  const getPosition = () => {
+    const styles = {
+      position: "fixed",
+      zIndex: 1200
+      // Abaixo do modal mas acima do conteúdo
+    };
+    switch (position) {
+      case "bottom-left":
+        return { ...styles, bottom: offset, left: offset };
+      case "bottom-right":
+        return { ...styles, bottom: offset, right: offset };
+      case "top-left":
+        return { ...styles, top: offset, left: offset };
+      case "top-right":
+        return { ...styles, top: offset, right: offset };
+      default:
+        return { ...styles, bottom: offset, right: offset };
+    }
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_Tooltip.default, { title: tooltipText, placement: "top", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+    import_Fab.default,
+    {
+      size: "medium",
+      color: "primary",
+      onClick: openPreferences,
+      sx: {
+        ...getPosition(),
+        backgroundColor: theme.palette.primary.main,
+        "&:hover": {
+          backgroundColor: theme.palette.primary.dark
+        }
+      },
+      "aria-label": tooltipText,
+      ...FabProps,
+      children: icon
+    }
+  ) });
+}
+
+// src/index.ts
 init_ConsentContext();
 init_useConsent();
 
 // src/utils/ConsentGate.tsx
 init_useConsent();
-var import_jsx_runtime4 = require("react/jsx-runtime");
+var import_jsx_runtime6 = require("react/jsx-runtime");
 function ConsentGate(props) {
   const { preferences } = useConsent();
   if (!preferences[props.category]) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_jsx_runtime4.Fragment, { children: props.children });
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: props.children });
 }
 
 // src/utils/scriptLoader.ts
@@ -633,9 +787,11 @@ init_theme();
   ConsentGate,
   ConsentProvider,
   CookieBanner,
+  FloatingPreferencesButton,
   PreferencesModal,
   defaultConsentTheme,
   loadScript,
   useConsent,
+  useConsentHydration,
   useConsentTexts
 });

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { PaperProps } from '@mui/material/Paper';
 import { SnackbarProps } from '@mui/material/Snackbar';
 import { DialogProps } from '@mui/material/Dialog';
+import { FabProps } from '@mui/material/Fab';
 import * as React$1 from 'react';
 import * as _mui_material_styles from '@mui/material/styles';
 
@@ -9,16 +10,34 @@ interface CookieBannerProps {
     policyLinkUrl?: string;
     debug?: boolean;
     blocking?: boolean;
+    hideBranding?: boolean;
     SnackbarProps?: Partial<SnackbarProps>;
     PaperProps?: Partial<PaperProps>;
 }
 declare function CookieBanner({ policyLinkUrl, debug, blocking, // Por padrão, bloqueia até decisão
-SnackbarProps, PaperProps, }: Readonly<CookieBannerProps>): react_jsx_runtime.JSX.Element | null;
+hideBranding, SnackbarProps, PaperProps, }: Readonly<CookieBannerProps>): react_jsx_runtime.JSX.Element | null;
 
 interface PreferencesModalProps {
     DialogProps?: Partial<DialogProps>;
+    hideBranding?: boolean;
 }
-declare function PreferencesModal({ DialogProps, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+declare function PreferencesModal({ DialogProps, hideBranding, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+
+interface FloatingPreferencesButtonProps {
+    /** Posição do botão flutuante. Padrão: 'bottom-right' */
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Offset da borda em pixels. Padrão: 24 */
+    offset?: number;
+    /** Ícone customizado. Padrão: SettingsIcon */
+    icon?: React.ReactNode;
+    /** Tooltip customizado */
+    tooltip?: string;
+    /** Props do Fab do MUI */
+    FabProps?: Partial<FabProps>;
+    /** Se deve esconder quando consentimento já foi dado. Padrão: false */
+    hideWhenConsented?: boolean;
+}
+declare function FloatingPreferencesButton({ position, offset, icon, tooltip, FabProps, hideWhenConsented, }: Readonly<FloatingPreferencesButtonProps>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Categoria de consentimento para cookies.
@@ -86,6 +105,8 @@ interface ConsentProviderProps {
     preferencesModalProps?: Record<string, any>;
     /** Desabilita o modal automático (para usar componente totalmente customizado). */
     disableAutomaticModal?: boolean;
+    /** Esconde branding "fornecido por LÉdipO.eti.br". */
+    hideBranding?: boolean;
     /** Callback chamado quando o consentimento é dado. */
     onConsentGiven?: (state: ConsentState) => void;
     /** Callback chamado ao salvar preferências. */
@@ -121,7 +142,7 @@ interface ConsentContextValue {
     resetConsent: () => void;
 }
 
-declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
 declare function useConsent(): ConsentContextValue;
 /**
@@ -129,6 +150,11 @@ declare function useConsent(): ConsentContextValue;
  * Útil para componentes personalizados que precisam dos textos configurados.
  */
 declare function useConsentTexts(): ConsentTexts;
+/**
+ * Hook para verificar se a hidratação do cookie foi concluída.
+ * Útil para evitar flash do banner antes de verificar cookies existentes.
+ */
+declare function useConsentHydration(): boolean;
 
 declare function ConsentGate(props: Readonly<{
     category: Category;
@@ -147,4 +173,4 @@ declare function loadScript(id: string, src: string, category?: 'analytics' | 'm
  */
 declare const defaultConsentTheme: _mui_material_styles.Theme;
 
-export { type Category, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentState, type ConsentTexts, CookieBanner, PreferencesModal, defaultConsentTheme, loadScript, useConsent, useConsentTexts };
+export { type Category, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentState, type ConsentTexts, CookieBanner, FloatingPreferencesButton, PreferencesModal, defaultConsentTheme, loadScript, useConsent, useConsentHydration, useConsentTexts };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { PaperProps } from '@mui/material/Paper';
 import { SnackbarProps } from '@mui/material/Snackbar';
 import { DialogProps } from '@mui/material/Dialog';
+import { FabProps } from '@mui/material/Fab';
 import * as React$1 from 'react';
 import * as _mui_material_styles from '@mui/material/styles';
 
@@ -9,16 +10,34 @@ interface CookieBannerProps {
     policyLinkUrl?: string;
     debug?: boolean;
     blocking?: boolean;
+    hideBranding?: boolean;
     SnackbarProps?: Partial<SnackbarProps>;
     PaperProps?: Partial<PaperProps>;
 }
 declare function CookieBanner({ policyLinkUrl, debug, blocking, // Por padrão, bloqueia até decisão
-SnackbarProps, PaperProps, }: Readonly<CookieBannerProps>): react_jsx_runtime.JSX.Element | null;
+hideBranding, SnackbarProps, PaperProps, }: Readonly<CookieBannerProps>): react_jsx_runtime.JSX.Element | null;
 
 interface PreferencesModalProps {
     DialogProps?: Partial<DialogProps>;
+    hideBranding?: boolean;
 }
-declare function PreferencesModal({ DialogProps, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+declare function PreferencesModal({ DialogProps, hideBranding, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+
+interface FloatingPreferencesButtonProps {
+    /** Posição do botão flutuante. Padrão: 'bottom-right' */
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Offset da borda em pixels. Padrão: 24 */
+    offset?: number;
+    /** Ícone customizado. Padrão: SettingsIcon */
+    icon?: React.ReactNode;
+    /** Tooltip customizado */
+    tooltip?: string;
+    /** Props do Fab do MUI */
+    FabProps?: Partial<FabProps>;
+    /** Se deve esconder quando consentimento já foi dado. Padrão: false */
+    hideWhenConsented?: boolean;
+}
+declare function FloatingPreferencesButton({ position, offset, icon, tooltip, FabProps, hideWhenConsented, }: Readonly<FloatingPreferencesButtonProps>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Categoria de consentimento para cookies.
@@ -86,6 +105,8 @@ interface ConsentProviderProps {
     preferencesModalProps?: Record<string, any>;
     /** Desabilita o modal automático (para usar componente totalmente customizado). */
     disableAutomaticModal?: boolean;
+    /** Esconde branding "fornecido por LÉdipO.eti.br". */
+    hideBranding?: boolean;
     /** Callback chamado quando o consentimento é dado. */
     onConsentGiven?: (state: ConsentState) => void;
     /** Callback chamado ao salvar preferências. */
@@ -121,7 +142,7 @@ interface ConsentContextValue {
     resetConsent: () => void;
 }
 
-declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
+declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
 declare function useConsent(): ConsentContextValue;
 /**
@@ -129,6 +150,11 @@ declare function useConsent(): ConsentContextValue;
  * Útil para componentes personalizados que precisam dos textos configurados.
  */
 declare function useConsentTexts(): ConsentTexts;
+/**
+ * Hook para verificar se a hidratação do cookie foi concluída.
+ * Útil para evitar flash do banner antes de verificar cookies existentes.
+ */
+declare function useConsentHydration(): boolean;
 
 declare function ConsentGate(props: Readonly<{
     category: Category;
@@ -147,4 +173,4 @@ declare function loadScript(id: string, src: string, category?: 'analytics' | 'm
  */
 declare const defaultConsentTheme: _mui_material_styles.Theme;
 
-export { type Category, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentState, type ConsentTexts, CookieBanner, PreferencesModal, defaultConsentTheme, loadScript, useConsent, useConsentTexts };
+export { type Category, type ConsentCookieOptions, ConsentGate, type ConsentPreferences, ConsentProvider, type ConsentState, type ConsentTexts, CookieBanner, FloatingPreferencesButton, PreferencesModal, defaultConsentTheme, loadScript, useConsent, useConsentHydration, useConsentTexts };

package/dist/index.js

@@ -1,31 +1,35 @@
 import {
+  Branding,
   ConsentProvider,
   PreferencesModal,
   defaultConsentTheme,
   useConsent,
+  useConsentHydration,
   useConsentTexts
-} from "./chunk-Y4XEAQXV.js";
+} from "./chunk-LRMSFSP2.js";
 
 // src/components/CookieBanner.tsx
 import Button from "@mui/material/Button";
 import Box from "@mui/material/Box";
-import Link from "@mui/material/Link";
 import Paper from "@mui/material/Paper";
 import Snackbar from "@mui/material/Snackbar";
 import Stack from "@mui/material/Stack";
 import Typography from "@mui/material/Typography";
+import Link from "@mui/material/Link";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function CookieBanner({
   policyLinkUrl,
   debug,
   blocking = true,
   // Por padrão, bloqueia até decisão
+  hideBranding = false,
   SnackbarProps,
   PaperProps
 }) {
   const { consented, acceptAll, rejectAll, openPreferences } = useConsent();
   const texts = useConsentTexts();
-  const open = debug ? true : !consented;
+  const isHydrated = useConsentHydration();
+  const open = debug ? true : isHydrated && !consented;
   if (!open) return null;
   const bannerContent = /* @__PURE__ */ jsx(
     Paper,
@@ -60,7 +64,8 @@ function CookieBanner({
               /* @__PURE__ */ jsx(Button, { variant: "text", onClick: openPreferences, children: texts.preferences })
             ]
           }
-        )
+        ),
+        !hideBranding && /* @__PURE__ */ jsx(Branding, { variant: "banner" })
       ] })
     }
   );
@@ -109,12 +114,71 @@ function CookieBanner({
   );
 }
 
+// src/components/FloatingPreferencesButton.tsx
+import Fab from "@mui/material/Fab";
+import Tooltip from "@mui/material/Tooltip";
+import SettingsIcon from "@mui/icons-material/Settings";
+import { useTheme } from "@mui/material/styles";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function FloatingPreferencesButton({
+  position = "bottom-right",
+  offset = 24,
+  icon = /* @__PURE__ */ jsx2(SettingsIcon, {}),
+  tooltip,
+  FabProps,
+  hideWhenConsented = false
+}) {
+  const { openPreferences, consented } = useConsent();
+  const theme = useTheme();
+  if (hideWhenConsented && consented) {
+    return null;
+  }
+  const tooltipText = tooltip ?? "Gerenciar Prefer\xEAncias de Cookies";
+  const getPosition = () => {
+    const styles = {
+      position: "fixed",
+      zIndex: 1200
+      // Abaixo do modal mas acima do conteúdo
+    };
+    switch (position) {
+      case "bottom-left":
+        return { ...styles, bottom: offset, left: offset };
+      case "bottom-right":
+        return { ...styles, bottom: offset, right: offset };
+      case "top-left":
+        return { ...styles, top: offset, left: offset };
+      case "top-right":
+        return { ...styles, top: offset, right: offset };
+      default:
+        return { ...styles, bottom: offset, right: offset };
+    }
+  };
+  return /* @__PURE__ */ jsx2(Tooltip, { title: tooltipText, placement: "top", children: /* @__PURE__ */ jsx2(
+    Fab,
+    {
+      size: "medium",
+      color: "primary",
+      onClick: openPreferences,
+      sx: {
+        ...getPosition(),
+        backgroundColor: theme.palette.primary.main,
+        "&:hover": {
+          backgroundColor: theme.palette.primary.dark
+        }
+      },
+      "aria-label": tooltipText,
+      ...FabProps,
+      children: icon
+    }
+  ) });
+}
+
 // src/utils/ConsentGate.tsx
-import { Fragment as Fragment2, jsx as jsx2 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx3 } from "react/jsx-runtime";
 function ConsentGate(props) {
   const { preferences } = useConsent();
   if (!preferences[props.category]) return null;
-  return /* @__PURE__ */ jsx2(Fragment2, { children: props.children });
+  return /* @__PURE__ */ jsx3(Fragment2, { children: props.children });
 }
 
 // src/utils/scriptLoader.ts
@@ -157,9 +221,11 @@ export {
   ConsentGate,
   ConsentProvider,
   CookieBanner,
+  FloatingPreferencesButton,
   PreferencesModal,
   defaultConsentTheme,
   loadScript,
   useConsent,
+  useConsentHydration,
   useConsentTexts
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-lgpd-consent",
-  "version": "0.1.8",
+  "version": "0.1.11",
   "description": "Biblioteca de consentimento de cookies (LGPD) para React e Next.js, com contexto, banner e modal personalizáveis usando MUI.",
   "keywords": [
     "lgpd",