react-lgpd-consent 0.1.8 → 0.1.12

package/dist/index.d.cts

@@ -2,23 +2,102 @@ 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';
 
+/**
+ * Props para o componente CookieBanner.
+ *
+ * @property policyLinkUrl URL da política de privacidade (opcional).
+ * @property debug Força exibição do banner para QA/debug (opcional).
+ * @property blocking Se true, bloqueia interação até decisão do usuário (default: true).
+ * @property hideBranding Se true, oculta o branding "fornecido por LÉdipO.eti.br" (opcional).
+ * @property SnackbarProps Props adicionais para o componente MUI Snackbar (opcional).
+ * @property PaperProps Props adicionais para o componente MUI Paper (opcional).
+ */
 interface CookieBannerProps {
     policyLinkUrl?: string;
     debug?: boolean;
     blocking?: boolean;
+    hideBranding?: boolean;
     SnackbarProps?: Partial<SnackbarProps>;
     PaperProps?: Partial<PaperProps>;
 }
+/**
+ * Banner de consentimento de cookies conforme LGPD.
+ *
+ * Exibe mensagem informativa, botões de ação e link para política de privacidade.
+ * Compatível com modo bloqueante (overlay) e não bloqueante (Snackbar).
+ *
+ * - Textos em pt-BR, customizáveis via contexto.
+ * - Acessível e responsivo.
+ * - Branding opcional.
+ *
+ * @param props Propriedades do banner de consentimento.
+ */
 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;
 
+/**
+ * Props para o componente PreferencesModal.
+ *
+ * @property DialogProps Props opcionais para customizar o Dialog do Material-UI.
+ * @property hideBranding Se true, oculta o branding "fornecido por LÉdipO.eti.br".
+ */
 interface PreferencesModalProps {
     DialogProps?: Partial<DialogProps>;
+    hideBranding?: boolean;
+}
+/**
+ * Modal de preferências de cookies.
+ *
+ * Permite ao usuário ajustar suas preferências de consentimento para cookies analíticos e de marketing.
+ * Utiliza Material-UI Dialog, switches para cada categoria e textos customizáveis via contexto.
+ * Acessível, responsivo e compatível com SSR.
+ *
+ * @param props Props do modal, incluindo customização do Dialog e opção de ocultar branding.
+ */
+declare function PreferencesModal({ DialogProps, hideBranding, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Props para o componente FloatingPreferencesButton.
+ *
+ * Permite configurar posição, ícone, tooltip, e comportamento de exibição do botão flutuante
+ * para abrir o modal de preferências de cookies LGPD.
+ *
+ * Todos os campos são opcionais e possuem valores padrão.
+ */
+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: CookieOutlined */
+    icon?: React.ReactNode;
+    /** Tooltip customizado exibido ao passar o mouse */
+    tooltip?: string;
+    /** Props adicionais para o Fab do MUI */
+    FabProps?: Partial<FabProps>;
+    /** Se deve esconder quando consentimento já foi dado. Padrão: false */
+    hideWhenConsented?: boolean;
 }
-declare function PreferencesModal({ DialogProps, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+/**
+ * Botão flutuante para abrir o modal de preferências de cookies.
+ *
+ * Permite ao usuário acessar rapidamente as configurações de consentimento LGPD.
+ * Pode ser posicionado em qualquer canto da tela e customizado via props.
+ *
+ * @param position Posição do botão na tela. Padrão: 'bottom-right'.
+ * @param offset Distância da borda em pixels. Padrão: 24.
+ * @param icon Ícone customizado para o botão. Padrão: CookieOutlined.
+ * @param tooltip Texto do tooltip exibido ao passar o mouse. Padrão: 'Gerenciar Preferências de Cookies'.
+ * @param FabProps Props adicionais para o componente Fab do MUI.
+ * @param hideWhenConsented Se verdadeiro, esconde o botão após consentimento. Padrão: false.
+ *
+ * @returns JSX.Element | null
+ */
+declare function FloatingPreferencesButton({ position, offset, icon, tooltip, FabProps, hideWhenConsented, }: Readonly<FloatingPreferencesButtonProps>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Categoria de consentimento para cookies.
@@ -43,6 +122,25 @@ interface ConsentState {
 }
 /**
  * Textos utilizados na interface de consentimento.
+ *
+ * @remarks
+ * Esta interface define todos os textos exibidos na UI do banner e modal de consentimento.
+ * Os campos opcionais permitem adequação à ANPD e customização conforme necessidade do projeto.
+ *
+ * @property bannerMessage - Mensagem principal exibida no banner de consentimento.
+ * @property acceptAll - Texto do botão para aceitar todos os cookies.
+ * @property declineAll - Texto do botão para recusar todos os cookies.
+ * @property preferences - Texto do botão para abrir preferências.
+ * @property policyLink - (Opcional) Link para política de privacidade.
+ * @property modalTitle - Título do modal de preferências.
+ * @property modalIntro - Texto introdutório do modal.
+ * @property save - Texto do botão para salvar preferências.
+ * @property necessaryAlwaysOn - Texto explicativo para cookies necessários.
+ * @property controllerInfo - (Opcional) Informação sobre o controlador dos dados.
+ * @property dataTypes - (Opcional) Tipos de dados coletados.
+ * @property thirdPartySharing - (Opcional) Compartilhamento com terceiros.
+ * @property userRights - (Opcional) Direitos do titular dos dados.
+ * @property contactInfo - (Opcional) Informações de contato do DPO.
  */
 interface ConsentTexts {
     bannerMessage: string;
@@ -86,6 +184,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,14 +221,55 @@ 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;
+/**
+ * Provider principal do contexto de consentimento LGPD.
+ *
+ * Gerencia o estado global de consentimento de cookies, preferências do usuário,
+ * textos customizáveis e integração com SSR. Permite customização do modal de preferências,
+ * callbacks externos e opções de cookie.
+ *
+ * @param props Propriedades do ConsentProvider (ver ConsentProviderProps)
+ * @returns JSX.Element
+ *
+ * @example
+ * <ConsentProvider>
+ *   <App />
+ * </ConsentProvider>
+ */
+declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Hook principal para acessar e manipular o estado de consentimento de cookies.
+ *
+ * Retorna o estado atual do consentimento, preferências do usuário e métodos para
+ * aceitar, recusar, modificar ou resetar consentimentos. Ideal para integração
+ * com componentes customizados ou lógica de negócio.
+ *
+ * @returns {ConsentContextValue} Estado e ações do consentimento.
+ *
+ * @example
+ * const {
+ *   consented,
+ *   preferences,
+ *   acceptAll,
+ *   rejectAll,
+ *   setPreference,
+ *   openPreferences,
+ *   closePreferences,
+ *   resetConsent,
+ * } = useConsent();
+ */
 declare function useConsent(): ConsentContextValue;
 /**
  * Hook para acessar textos customizados do ConsentProvider.
  * Ú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;
@@ -136,15 +277,28 @@ declare function ConsentGate(props: Readonly<{
 }>): react_jsx_runtime.JSX.Element | null;
 
 /**
- * Carrega um script dinamicamente após consentimento finalizado.
- * Aguarda que o usuário tome uma decisão definitiva (banner fechado ou preferências salvas).
+ * Carrega dinamicamente um script externo após o consentimento do usuário ser finalizado.
+ *
+ * Aguarda até que o usuário tome uma decisão definitiva (banner fechado ou preferências salvas)
+ * antes de inserir o script na página. Permite restringir o carregamento por categoria de consentimento.
+ *
+ * @param id - Identificador único do elemento script a ser criado.
+ * @param src - URL do script externo.
+ * @param category - Categoria de consentimento exigida para o script ('analytics', 'marketing' ou null).
+ * @param attrs - Atributos adicionais a serem aplicados ao elemento script.
+ * @returns Promise que resolve quando o script é carregado ou rejeita se o consentimento não for dado.
  */
 declare function loadScript(id: string, src: string, category?: 'analytics' | 'marketing' | null, attrs?: Record<string, string>): Promise<void>;
 
 /**
- * Tema padrão para os componentes de consentimento.
- * Baseado no design system da ANPD/governo brasileiro.
+ * Tema padrão utilizado pelos componentes de consentimento da biblioteca.
+ *
+ * Inclui configurações de cores, tipografia e estilos para componentes Material-UI,
+ * garantindo aparência consistente e acessível conforme guidelines LGPD.
+ *
+ * @remarks
+ * Pode ser sobrescrito via ThemeProvider externo se necessário.
  */
 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,23 +2,102 @@ 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';
 
+/**
+ * Props para o componente CookieBanner.
+ *
+ * @property policyLinkUrl URL da política de privacidade (opcional).
+ * @property debug Força exibição do banner para QA/debug (opcional).
+ * @property blocking Se true, bloqueia interação até decisão do usuário (default: true).
+ * @property hideBranding Se true, oculta o branding "fornecido por LÉdipO.eti.br" (opcional).
+ * @property SnackbarProps Props adicionais para o componente MUI Snackbar (opcional).
+ * @property PaperProps Props adicionais para o componente MUI Paper (opcional).
+ */
 interface CookieBannerProps {
     policyLinkUrl?: string;
     debug?: boolean;
     blocking?: boolean;
+    hideBranding?: boolean;
     SnackbarProps?: Partial<SnackbarProps>;
     PaperProps?: Partial<PaperProps>;
 }
+/**
+ * Banner de consentimento de cookies conforme LGPD.
+ *
+ * Exibe mensagem informativa, botões de ação e link para política de privacidade.
+ * Compatível com modo bloqueante (overlay) e não bloqueante (Snackbar).
+ *
+ * - Textos em pt-BR, customizáveis via contexto.
+ * - Acessível e responsivo.
+ * - Branding opcional.
+ *
+ * @param props Propriedades do banner de consentimento.
+ */
 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;
 
+/**
+ * Props para o componente PreferencesModal.
+ *
+ * @property DialogProps Props opcionais para customizar o Dialog do Material-UI.
+ * @property hideBranding Se true, oculta o branding "fornecido por LÉdipO.eti.br".
+ */
 interface PreferencesModalProps {
     DialogProps?: Partial<DialogProps>;
+    hideBranding?: boolean;
+}
+/**
+ * Modal de preferências de cookies.
+ *
+ * Permite ao usuário ajustar suas preferências de consentimento para cookies analíticos e de marketing.
+ * Utiliza Material-UI Dialog, switches para cada categoria e textos customizáveis via contexto.
+ * Acessível, responsivo e compatível com SSR.
+ *
+ * @param props Props do modal, incluindo customização do Dialog e opção de ocultar branding.
+ */
+declare function PreferencesModal({ DialogProps, hideBranding, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Props para o componente FloatingPreferencesButton.
+ *
+ * Permite configurar posição, ícone, tooltip, e comportamento de exibição do botão flutuante
+ * para abrir o modal de preferências de cookies LGPD.
+ *
+ * Todos os campos são opcionais e possuem valores padrão.
+ */
+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: CookieOutlined */
+    icon?: React.ReactNode;
+    /** Tooltip customizado exibido ao passar o mouse */
+    tooltip?: string;
+    /** Props adicionais para o Fab do MUI */
+    FabProps?: Partial<FabProps>;
+    /** Se deve esconder quando consentimento já foi dado. Padrão: false */
+    hideWhenConsented?: boolean;
 }
-declare function PreferencesModal({ DialogProps, }: Readonly<PreferencesModalProps>): react_jsx_runtime.JSX.Element;
+/**
+ * Botão flutuante para abrir o modal de preferências de cookies.
+ *
+ * Permite ao usuário acessar rapidamente as configurações de consentimento LGPD.
+ * Pode ser posicionado em qualquer canto da tela e customizado via props.
+ *
+ * @param position Posição do botão na tela. Padrão: 'bottom-right'.
+ * @param offset Distância da borda em pixels. Padrão: 24.
+ * @param icon Ícone customizado para o botão. Padrão: CookieOutlined.
+ * @param tooltip Texto do tooltip exibido ao passar o mouse. Padrão: 'Gerenciar Preferências de Cookies'.
+ * @param FabProps Props adicionais para o componente Fab do MUI.
+ * @param hideWhenConsented Se verdadeiro, esconde o botão após consentimento. Padrão: false.
+ *
+ * @returns JSX.Element | null
+ */
+declare function FloatingPreferencesButton({ position, offset, icon, tooltip, FabProps, hideWhenConsented, }: Readonly<FloatingPreferencesButtonProps>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Categoria de consentimento para cookies.
@@ -43,6 +122,25 @@ interface ConsentState {
 }
 /**
  * Textos utilizados na interface de consentimento.
+ *
+ * @remarks
+ * Esta interface define todos os textos exibidos na UI do banner e modal de consentimento.
+ * Os campos opcionais permitem adequação à ANPD e customização conforme necessidade do projeto.
+ *
+ * @property bannerMessage - Mensagem principal exibida no banner de consentimento.
+ * @property acceptAll - Texto do botão para aceitar todos os cookies.
+ * @property declineAll - Texto do botão para recusar todos os cookies.
+ * @property preferences - Texto do botão para abrir preferências.
+ * @property policyLink - (Opcional) Link para política de privacidade.
+ * @property modalTitle - Título do modal de preferências.
+ * @property modalIntro - Texto introdutório do modal.
+ * @property save - Texto do botão para salvar preferências.
+ * @property necessaryAlwaysOn - Texto explicativo para cookies necessários.
+ * @property controllerInfo - (Opcional) Informação sobre o controlador dos dados.
+ * @property dataTypes - (Opcional) Tipos de dados coletados.
+ * @property thirdPartySharing - (Opcional) Compartilhamento com terceiros.
+ * @property userRights - (Opcional) Direitos do titular dos dados.
+ * @property contactInfo - (Opcional) Informações de contato do DPO.
  */
 interface ConsentTexts {
     bannerMessage: string;
@@ -86,6 +184,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,14 +221,55 @@ 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;
+/**
+ * Provider principal do contexto de consentimento LGPD.
+ *
+ * Gerencia o estado global de consentimento de cookies, preferências do usuário,
+ * textos customizáveis e integração com SSR. Permite customização do modal de preferências,
+ * callbacks externos e opções de cookie.
+ *
+ * @param props Propriedades do ConsentProvider (ver ConsentProviderProps)
+ * @returns JSX.Element
+ *
+ * @example
+ * <ConsentProvider>
+ *   <App />
+ * </ConsentProvider>
+ */
+declare function ConsentProvider({ initialState, texts: textsProp, theme, PreferencesModalComponent, preferencesModalProps, disableAutomaticModal, hideBranding, onConsentGiven, onPreferencesSaved, cookie: cookieOpts, children, }: Readonly<ConsentProviderProps>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Hook principal para acessar e manipular o estado de consentimento de cookies.
+ *
+ * Retorna o estado atual do consentimento, preferências do usuário e métodos para
+ * aceitar, recusar, modificar ou resetar consentimentos. Ideal para integração
+ * com componentes customizados ou lógica de negócio.
+ *
+ * @returns {ConsentContextValue} Estado e ações do consentimento.
+ *
+ * @example
+ * const {
+ *   consented,
+ *   preferences,
+ *   acceptAll,
+ *   rejectAll,
+ *   setPreference,
+ *   openPreferences,
+ *   closePreferences,
+ *   resetConsent,
+ * } = useConsent();
+ */
 declare function useConsent(): ConsentContextValue;
 /**
  * Hook para acessar textos customizados do ConsentProvider.
  * Ú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;
@@ -136,15 +277,28 @@ declare function ConsentGate(props: Readonly<{
 }>): react_jsx_runtime.JSX.Element | null;
 
 /**
- * Carrega um script dinamicamente após consentimento finalizado.
- * Aguarda que o usuário tome uma decisão definitiva (banner fechado ou preferências salvas).
+ * Carrega dinamicamente um script externo após o consentimento do usuário ser finalizado.
+ *
+ * Aguarda até que o usuário tome uma decisão definitiva (banner fechado ou preferências salvas)
+ * antes de inserir o script na página. Permite restringir o carregamento por categoria de consentimento.
+ *
+ * @param id - Identificador único do elemento script a ser criado.
+ * @param src - URL do script externo.
+ * @param category - Categoria de consentimento exigida para o script ('analytics', 'marketing' ou null).
+ * @param attrs - Atributos adicionais a serem aplicados ao elemento script.
+ * @returns Promise que resolve quando o script é carregado ou rejeita se o consentimento não for dado.
  */
 declare function loadScript(id: string, src: string, category?: 'analytics' | 'marketing' | null, attrs?: Record<string, string>): Promise<void>;
 
 /**
- * Tema padrão para os componentes de consentimento.
- * Baseado no design system da ANPD/governo brasileiro.
+ * Tema padrão utilizado pelos componentes de consentimento da biblioteca.
+ *
+ * Inclui configurações de cores, tipografia e estilos para componentes Material-UI,
+ * garantindo aparência consistente e acessível conforme guidelines LGPD.
+ *
+ * @remarks
+ * Pode ser sobrescrito via ThemeProvider externo se necessário.
  */
 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-V54LZT2Q.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,70 @@ function CookieBanner({
   );
 }
 
+// src/components/FloatingPreferencesButton.tsx
+import CookieOutlined from "@mui/icons-material/CookieOutlined";
+import Fab from "@mui/material/Fab";
+import Tooltip from "@mui/material/Tooltip";
+import { useTheme } from "@mui/material/styles";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function FloatingPreferencesButton({
+  position = "bottom-right",
+  offset = 24,
+  icon = /* @__PURE__ */ jsx2(CookieOutlined, {}),
+  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
+    };
+    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 +220,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.12",
   "description": "Biblioteca de consentimento de cookies (LGPD) para React e Next.js, com contexto, banner e modal personalizáveis usando MUI.",
   "keywords": [
     "lgpd",