@consenti/ui 0.1.0 → 0.2.0

package/dist/react.d.ts

@@ -1,13 +1,54 @@
+type NonEmptyArray<T> = [T, ...T[]];
+type DeepPartial<T> = T extends Function ? T : T extends Array<infer InferredArrayType> ? Array<DeepPartial<InferredArrayType>> : T extends ReadonlyArray<infer InferredReadonlyArrayType> ? ReadonlyArray<DeepPartial<InferredReadonlyArrayType>> : T extends object ? {
+    [Key in keyof T]?: DeepPartial<T[Key]>;
+} : T;
+
+declare const COMPLIANCE_GROUP_IDS: readonly ["opt-in", "opt-out", "opt-out-strict", "opt-in-dpdpa", "opt-in-china", "opt-in-brazil", "general-privacy-consent", "notice-only"];
+
+/**
+ * Compliance-related literal types, derived from the regulation/group ID data
+ * that lives in @consenti/utils (packages/utils/src/compliance.ts).
+ *
+ * This import is type-only and fully erased at compile time — @consenti/types
+ * has no runtime dependency on @consenti/utils. The actual data (COMPLIANCE_GROUPS,
+ * EMBEDDED_COMPLIANCE_MAP, COMPLIANCE_VALIDATION_RULES, GPC_OPTIONS, etc.) lives in
+ * @consenti/utils; import it from there.
+ *
+ * HOW TO ADD A NEW REGULATION OR COMPLIANCE GROUP: see the header comment in
+ * packages/utils/src/compliance.ts — these types auto-update from that data.
+ */
+
+type ComplianceGroupId = typeof COMPLIANCE_GROUP_IDS[number];
+
+interface ComplianceMapData {
+    version: string;
+    countries: Record<string, CountryComplianceEntry>;
+}
+interface CountryComplianceEntry {
+    complianceGroup: ComplianceGroupId;
+    default: ComplianceGroupId;
+    description: string;
+    overriddenRegions?: Record<string, {
+        complianceGroup: ComplianceGroupId;
+        description: string;
+    }>;
+}
+
 type ConsentStatus = 'granted' | 'denied' | 'objected';
+type ConsentAction = 'accept_all' | 'reject_all' | 'custom' | 'update';
 type ConsentValue = Record<string, ConsentStatus>;
 interface Cookie {
     id: string;
-    type?: 'consent' | 'legitimate_interest';
+    legalBasis?: 'mandatory' | 'consent' | 'legitimate_interest';
+    /** @deprecated use legalBasis: 'mandatory' */
     mandatory?: boolean;
+    /** @deprecated use legalBasis */
+    type?: 'consent' | 'legitimate_interest';
     listenGpc?: boolean;
     expiry?: number;
     tcfVendorId?: number;
     tcfPurposes?: number[];
+    tcfSpecialFeatures?: number[];
     cpraCategory?: 'sale' | 'sharing' | 'sensitive';
 }
 type ButtonStyle = 'primary' | 'secondary' | 'text' | 'accent';
@@ -18,6 +59,7 @@ interface Button {
     action: ButtonAction;
     cookies?: string[] | '*' | '!';
     url?: string;
+    type?: string;
 }
 interface MainBanner {
     position: 'top' | 'bottom' | 'middle' | 'left-bottom' | 'right-bottom';
@@ -43,18 +85,13 @@ interface Category {
     };
     cookies: string[];
 }
-interface PreferenceModal {
+interface PreferenceModal extends Omit<MainBanner, "position"> {
     position?: 'left' | 'right' | 'center';
-    overlayOpacity?: number;
-    showClose?: boolean;
-    showLocaleSwitcher?: boolean;
-    heading?: string;
-    headingTag?: string;
     subheading?: string;
-    htmlText?: string;
-    buttons: Button[];
     categories: Category[];
     persistent?: boolean;
+    /** Screen width in px below which the modal expands to full screen. Default: 576. Set to 0 to disable. */
+    mobileFullScreenBreakpoint?: number;
 }
 interface DpdpaConfig {
     dataFiduciary: string;
@@ -63,6 +100,7 @@ interface DpdpaConfig {
 }
 interface ResolvedProfile {
     id: number;
+    profileUuid?: string;
     version: number;
     defaultLocale: string;
     locales?: string[];
@@ -73,6 +111,26 @@ interface ResolvedProfile {
     cookieSigningKey?: string;
     dpdpa?: DpdpaConfig;
     darkMode?: boolean;
+    gpcMode?: 'ignore' | 'honor' | 'strict';
+    complianceGroup?: string;
+    complianceConfig?: Record<string, string>;
+}
+type WidgetCountryResolverFn = () => Promise<{
+    country: string | null;
+    region: string | null;
+    confidence: number;
+}>;
+interface AgeGateWidgetConfig {
+    enabled: boolean;
+    minimumAge: number;
+    requireParentalConsent?: boolean;
+}
+interface ComplianceWidgetConfig {
+    type?: 'auto' | ComplianceGroupId | string;
+    geoDataProvider?: 'default' | WidgetCountryResolverFn;
+    autoComplianceMap?: 'default' | ComplianceMapData | 'auto';
+    complianceMapUrl?: string;
+    ageGate?: AgeGateWidgetConfig;
 }
 interface GtmConfig {
     containerId?: string;
@@ -88,6 +146,9 @@ interface ApiConfig {
     enabled?: boolean;
     baseUrl?: string;
     authToken?: string;
+    tenantId?: string;
+    complianceGroup?: string;
+    trustDomain?: boolean;
 }
 interface ThemeConfig {
     bgColor?: string;
@@ -109,35 +170,52 @@ interface ThemeConfig {
     accentTextColor?: string;
 }
 interface CoreConfig {
-    profileId?: number;
+    tenantId?: string;
     autoHonorGPC?: boolean | 'strict';
     locale?: string;
     disableCssTemplate?: boolean;
-    signCookies?: boolean;
     cookieSigningKey?: string;
     allowReceipt?: boolean;
     cookieDomains?: string;
     storage?: 'cookie' | 'localStorage';
     theme?: ThemeConfig;
-    privacyPolicyUrl?: string;
-    regulation?: 'gdpr' | 'ccpa' | 'cpra' | 'dpdpa' | 'uk-gdpr' | 'lgpd' | 'pipeda' | 'popia' | 'pdpa-th' | 'appi' | 'kvkk';
     userId?: string;
+    usePrebuiltProfiles?: 'all' | NonEmptyArray<ComplianceGroupId>;
+    cacheResolvedProfiles?: boolean;
+    console?: Array<'info' | 'log' | 'warning' | 'error'>;
 }
 interface ConsentiConfig {
     core: CoreConfig;
+    compliance?: ComplianceWidgetConfig;
     rootEl?: string | HTMLElement;
     darkMode?: boolean;
     autoInit?: boolean;
     api?: ApiConfig;
     utils?: UtilsConfig;
     plugins?: ConsentiPlugin[];
-    profileOverride?: Partial<ResolvedProfile>;
+    profileOverride?: DeepPartial<ResolvedProfile>;
+    /** When true, suppresses the "Powered by Consenti" footer link in the banner and modal. */
+    hidePoweredBy?: boolean;
 }
+type ConsentiEventName = 'bannerInitialized' | 'consenti:bannerInitialized' | 'bannerVisibility' | 'consenti:bannerVisibility' | 'modalVisibility' | 'consenti:modalVisibility' | 'consentBeingSubmitted' | 'consenti:consentBeingSubmitted' | 'consentSubmitted' | 'consenti:consentSubmitted';
 interface ConsentiWidgetAPI {
     hasConsent(): boolean;
     getConsent(): ConsentValue | null;
     getConsentDate(): Date | false;
     getGTMConsent(): Record<string, string> | null;
+    isCookieGranted(cookieId: string, requestValue?: boolean): boolean | ConsentStatus;
+    isCategoryGranted(categoryId: string, requestValue?: boolean): boolean | {
+        [cookieId: string]: ConsentStatus;
+    }[];
+    grantAll(onlyMandatory?: boolean): Promise<void>;
+    denyAll(includingMandatory?: boolean): Promise<void>;
+    on(event: ConsentiEventName, handler: (data: ConsentEvent) => void): void;
+    off(event: ConsentiEventName, handler: (data: ConsentEvent) => void): void;
+    version(): {
+        package: string;
+        profileVersion: number | null;
+        consentVersion: number;
+    };
     bannerVisibility(): 'main' | 'gpc' | false;
     modalVisibility(): 'preference' | false;
     getProfile(): ResolvedProfile | null;
@@ -152,6 +230,10 @@ interface ConsentiWidgetAPI {
     getBannerElement(): HTMLElement | null;
     getModalElement(): HTMLElement | null;
     switchLocale(locale: string): void;
+    setDarkMode(enable?: boolean): void;
+    setTheme(theme: Partial<ThemeConfig>): void;
+    setConfig(config: DeepPartial<ConsentiConfig>): void;
+    setProfile(override: DeepPartial<ResolvedProfile>): void;
     init(): Promise<void>;
     onReady(callback: () => void): void;
     destroy(): void;
@@ -165,6 +247,19 @@ declare abstract class ConsentiPlugin {
     onModalShow?(): void | Promise<void>;
     onModalHide?(): void | Promise<void>;
 }
+interface ConsentEvent {
+    profileId?: number;
+    consent?: ConsentValue;
+    hasExistingConsent?: boolean;
+    show?: boolean;
+    action?: boolean;
+    consentAction?: ConsentAction;
+    consentId?: string;
+    pageUrl?: string;
+    apiResponse?: unknown;
+    fromBroadcast?: boolean;
+    gpcDetected?: boolean;
+}
 
 /**
  * Main entry point for the Consenti widget.
@@ -176,7 +271,7 @@ declare abstract class ConsentiPlugin {
  * @example
  * ```ts
  * const widget = new ConsentiSetup({
- *   core: { profileId: 0 },
+ *   compliance: { type: 'opt-in' },
  * })
  * await widget.ready
  * console.log(widget.hasConsent())
@@ -188,6 +283,7 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
     private initialized;
     private initializing;
     private profile;
+    private resolvedBase;
     private consentStore;
     private eventBus;
     private banner;
@@ -201,6 +297,8 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
     private lastSignature;
     /** Tracks which banner variant is currently visible, or null when hidden. */
     private _bannerVariant;
+    /** Maps original handler functions to their DOM-wrapped listeners for on/off bookkeeping. */
+    private _eventHandlers;
     /**
      * Creates and initialises the consent widget.
      *
@@ -233,6 +331,8 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
      * @param invoke - Function that calls the desired hook method on a single plugin.
      */
     private callPluginHook;
+    private _buildGrantAllConsent;
+    private _buildDenyAllConsent;
     private buildHandlers;
     /**
      * Classifies a consent submission as `accept_all`, `reject_all`, `custom`, or `update`.
@@ -381,6 +481,93 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
      * @param locale - BCP 47 locale code to switch to (e.g. `'fr'`, `'de-AT'`).
      */
     switchLocale(locale: string): void;
+    /**
+     * Returns `true` if the named cookie's consent is `'granted'`.
+     * When `requestValue` is `true`, returns the raw `ConsentStatus` string instead of a boolean,
+     * or `false` if the cookie is not in the consent map.
+     */
+    isCookieGranted(cookieId: string, requestValue?: boolean): boolean | 'granted' | 'denied' | 'objected';
+    /**
+     * Checks consent for all cookies belonging to the given category.
+     *
+     * With `requestValue = false` (default): returns `true` only when every cookie in the
+     * category is `'granted'`, `false` otherwise.
+     *
+     * With `requestValue = true`: returns an array of one-key records — one per cookie in the
+     * category — e.g. `[{ analytics: 'granted' }, { pixel: 'denied' }]`.
+     *
+     * Returns `false` / `[]` if the category is not found or the widget is not yet initialized.
+     */
+    isCategoryGranted(categoryId: string, requestValue?: boolean): boolean | {
+        [cookieId: string]: 'granted' | 'denied' | 'objected';
+    }[];
+    /**
+     * Programmatically accepts cookies and hides the banner.
+     *
+     * @param onlyMandatory - When `true`, only mandatory cookies are granted and all others
+     *                        are set to `'denied'`. Defaults to `false` (grant everything).
+     */
+    grantAll(onlyMandatory?: boolean): Promise<void>;
+    /**
+     * Programmatically denies cookies and hides the banner.
+     *
+     * @param includingMandatory - When `true`, mandatory cookies are also denied. Defaults to
+     *                             `false` (mandatory cookies remain `'granted'`). Passing `true`
+     *                             logs a warning — ensure this is intentional.
+     */
+    denyAll(includingMandatory?: boolean): Promise<void>;
+    /**
+     * Subscribes to a Consenti widget event. The `consenti:` prefix is optional —
+     * both `'consentSubmitted'` and `'consenti:consentSubmitted'` are accepted.
+     *
+     * The same handler reference must be passed to `off()` to unsubscribe.
+     *
+     * @example
+     * ```ts
+     * const handler = (data) => console.log(data)
+     * widget.on('consentSubmitted', handler)
+     * // later:
+     * widget.off('consentSubmitted', handler)
+     * ```
+     */
+    on(event: ConsentiEventName, handler: (data: ConsentEvent) => void): void;
+    /**
+     * Removes a previously registered event handler. The same function reference passed to
+     * `on()` must be used here.
+     */
+    off(event: ConsentiEventName, handler: (data: ConsentEvent) => void): void;
+    /**
+     * Returns the current version of the package and the active profile/consent versions.
+     * Useful for debugging and support diagnostics.
+     */
+    version(): {
+        package: string;
+        profileVersion: number | null;
+        consentVersion: number;
+    };
+    /**
+     * Toggles or sets dark mode at runtime without re-initialising the widget.
+     * When `enable` is omitted, the current dark mode state is toggled.
+     */
+    setDarkMode(enable?: boolean): void;
+    /**
+     * Applies partial theme token overrides at runtime, merging them into the current theme.
+     * CSS custom properties on the root element are updated immediately.
+     */
+    setTheme(theme: Partial<ThemeConfig>): void;
+    /**
+     * Deep-merges a partial config into the current widget config.
+     * Theme and dark mode side-effects are re-applied immediately.
+     * Changes to locale or profile require an explicit `switchLocale()` or `init()` call.
+     */
+    setConfig(config: DeepPartial<ConsentiConfig>): void;
+    /**
+     * Merges a partial profile override into the current profile and re-renders any visible UI.
+     * Does not make a network request — the resolved base profile from the last `init()` is reused.
+     *
+     * No-op before `init()` completes (while `resolvedBase` is null).
+     */
+    setProfile(override: DeepPartial<ResolvedProfile>): void;
     /**
      * Destroys the widget — removes all DOM elements, disconnects the BroadcastChannel,
      * and calls `destroy()` on all registered plugins.
@@ -398,7 +585,7 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
  *
  * Intended for **Next.js** (App Router and Pages Router) and any other React 18+
  * project where you manage the `ConsentiSetup` instance yourself and want the
- * `useConsent()` hook to re-render when consent changes.
+ * `useConsent()` hook to re-render when consent or UI state changes.
  *
  * @example
  * ```tsx
@@ -410,7 +597,9 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
  *
  * export function ConsentiProvider({ children }: { children: React.ReactNode }) {
  *   useEffect(() => {
- *     const widget = new ConsentiSetup({ core: { profileId: 0 } })
+ *     const widget = new ConsentiSetup({
+ *       api: { enabled: true, baseUrl: process.env.NEXT_PUBLIC_API_URL },
+ *     })
  *     setConsentiWidget(widget)
  *   }, [])
  *   return <>{children}</>
@@ -419,10 +608,10 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
  * // Any component
  * import { useConsent } from '@consenti/ui/react'
  *
- * function CookieBanner() {
- *   const { hasConsent, submitConsent } = useConsent()
- *   if (hasConsent()) return null
- *   return <button onClick={() => submitConsent({ analytics: 'granted' })}>Accept</button>
+ * function CookieStatus() {
+ *   const { hasConsent, consent, showModal } = useConsent()
+ *   if (!hasConsent) return <button onClick={showModal}>Manage Cookies</button>
+ *   return <span>{consent?.analytics === 'granted' ? 'Analytics on' : 'Analytics off'}</span>
  * }
  * ```
  */
@@ -435,18 +624,33 @@ declare class ConsentiSetup implements ConsentiWidgetAPI {
  */
 declare function setConsentiWidget(widget: ConsentiSetup): void;
 /**
- * React hook that exposes consent state and lets components react to consent changes.
+ * React hook that exposes consent state, banner/modal visibility, and widget actions.
+ *
+ * Subscribes to `consenti:consentSubmitted`, `consenti:bannerVisibility`, and
+ * `consenti:modalVisibility` on `window` and triggers re-renders on each event.
+ * Returns SSR-safe initial values during server render.
  *
- * Subscribes to `consenti:consentSubmitted` on `window` and triggers a re-render
- * each time consent is updated. Returns SSR-safe fallback values during server render.
+ * Destructure only what you need — unused values do not cause extra renders.
  *
- * @returns An object with `hasConsent`, `getConsent`, `submitConsent`, and `getConsentDate`.
+ * @returns Consent state values and widget action functions.
  */
 declare function useConsent(): {
-    hasConsent: () => boolean;
-    getConsent: () => ConsentValue | null;
-    submitConsent: (_consent: Partial<ConsentValue>) => Promise<void>;
-    getConsentDate: () => Date | false;
+    hasConsent: boolean;
+    consent: ConsentValue | null;
+    consentDate: Date | false;
+    bannerVisible: "main" | "gpc" | false;
+    modalVisible: "preference" | false;
+    showBanner: (_gpc?: boolean) => void;
+    hideBanner: () => void;
+    showModal: () => void;
+    hideModal: () => void;
+    grantAll: (_onlyMandatory?: boolean) => Promise<void>;
+    denyAll: (_includingMandatory?: boolean) => Promise<void>;
+    submitConsent: (_c: Partial<ConsentValue>) => Promise<void>;
+    reConsent: () => Promise<void>;
+    isCookieGranted: (_id: string) => boolean;
+    isCategoryGranted: (_id: string) => boolean;
+    switchLocale: (_locale: string) => void;
 };
 
 export { setConsentiWidget, useConsent };

package/dist/react.js

@@ -1,61 +1,2 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/react.ts
-var react_exports = {};
-__export(react_exports, {
-  setConsentiWidget: () => setConsentiWidget,
-  useConsent: () => useConsent
-});
-module.exports = __toCommonJS(react_exports);
-var import_react = require("react");
-var _widget = null;
-function setConsentiWidget(widget) {
-  _widget = widget;
-}
-function useConsent() {
-  const isServer = typeof window === "undefined";
-  const [, forceUpdate] = (0, import_react.useState)(0);
-  (0, import_react.useEffect)(() => {
-    if (!_widget) return;
-    const handler = () => forceUpdate((n) => n + 1);
-    window.addEventListener("consenti:consentSubmitted", handler);
-    return () => window.removeEventListener("consenti:consentSubmitted", handler);
-  }, []);
-  if (isServer) {
-    return {
-      hasConsent: () => false,
-      getConsent: () => null,
-      submitConsent: async (_consent) => {
-      },
-      getConsentDate: () => false
-    };
-  }
-  return {
-    /** Returns `true` if the visitor has saved consent. */
-    hasConsent: () => _widget?.hasConsent() ?? false,
-    /** Returns the stored consent map, or `null`. */
-    getConsent: () => _widget?.getConsent() ?? null,
-    /** Saves the given partial consent map. Missing keys default to `'denied'`. */
-    submitConsent: (consent) => _widget?.submitConsent(consent) ?? Promise.resolve(),
-    /** Returns the `Date` of last consent submission, or `false`. */
-    getConsentDate: () => _widget?.getConsentDate() ?? false
-  };
-}
+"use strict";var r=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var y=(s,o)=>{for(var i in o)r(s,i,{get:o[i],enumerable:!0})},p=(s,o,i,l)=>{if(o&&typeof o=="object"||typeof o=="function")for(let a of h(o))!v.call(s,a)&&a!==i&&r(s,a,{get:()=>o[a],enumerable:!(l=g(o,a))||l.enumerable});return s};var V=s=>p(r({},"__esModule",{value:!0}),s);var L={};y(L,{setConsentiWidget:()=>M,useConsent:()=>P});module.exports=V(L);var t=require("react"),n=null;function M(s){n=s}function P(){let s=typeof window>"u",[o,i]=(0,t.useState)(()=>s?!1:n?.hasConsent()??!1),[l,a]=(0,t.useState)(()=>s?null:n?.getConsent()??null),[f,b]=(0,t.useState)(()=>s?!1:n?.getConsentDate()??!1),[C,u]=(0,t.useState)(!1),[m,w]=(0,t.useState)(!1);return(0,t.useEffect)(()=>{if(!n)return;let e=()=>{i(n?.hasConsent()??!1),a(n?.getConsent()??null),b(n?.getConsentDate()??!1)},d=()=>u(n?.bannerVisibility()??!1),c=()=>w(n?.modalVisibility()??!1);return window.addEventListener("consenti:consentSubmitted",e),window.addEventListener("consenti:bannerVisibility",d),window.addEventListener("consenti:modalVisibility",c),()=>{window.removeEventListener("consenti:consentSubmitted",e),window.removeEventListener("consenti:bannerVisibility",d),window.removeEventListener("consenti:modalVisibility",c)}},[]),s?{hasConsent:!1,consent:null,consentDate:!1,bannerVisible:!1,modalVisible:!1,showBanner:e=>{},hideBanner:()=>{},showModal:()=>{},hideModal:()=>{},grantAll:e=>Promise.resolve(),denyAll:e=>Promise.resolve(),submitConsent:e=>Promise.resolve(),reConsent:()=>Promise.resolve(),isCookieGranted:e=>!1,isCategoryGranted:e=>!1,switchLocale:e=>{}}:{hasConsent:o,consent:l,consentDate:f,bannerVisible:C,modalVisible:m,showBanner:e=>n?.showBanner(e),hideBanner:()=>n?.hideBanner(),showModal:()=>n?.showModal(),hideModal:()=>n?.hideModal(),grantAll:e=>n?.grantAll(e)??Promise.resolve(),denyAll:e=>n?.denyAll(e)??Promise.resolve(),submitConsent:e=>n?.submitConsent(e)??Promise.resolve(),reConsent:()=>n?.reConsent()??Promise.resolve(),isCookieGranted:e=>n?.isCookieGranted(e)??!1,isCategoryGranted:e=>n?.isCategoryGranted(e)??!1,switchLocale:e=>n?.switchLocale(e)}}
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React integration for `@consenti/ui`.\n *\n * Import from the `@consenti/ui/react` subpath to keep this module\n * tree-shaken out of vanilla JS or Vue bundles.\n *\n * Intended for **Next.js** (App Router and Pages Router) and any other React 18+\n * project where you manage the `ConsentiSetup` instance yourself and want the\n * `useConsent()` hook to re-render when consent changes.\n *\n * @example\n * ```tsx\n * // app/providers.tsx (Next.js App Router)\n * 'use client'\n * import { useEffect } from 'react'\n * import { ConsentiSetup } from '@consenti/ui'\n * import { setConsentiWidget } from '@consenti/ui/react'\n *\n * export function ConsentiProvider({ children }: { children: React.ReactNode }) {\n *   useEffect(() => {\n *     const widget = new ConsentiSetup({ core: { profileId: 0 } })\n *     setConsentiWidget(widget)\n *   }, [])\n *   return <>{children}</>\n * }\n *\n * // Any component\n * import { useConsent } from '@consenti/ui/react'\n *\n * function CookieBanner() {\n *   const { hasConsent, submitConsent } = useConsent()\n *   if (hasConsent()) return null\n *   return <button onClick={() => submitConsent({ analytics: 'granted' })}>Accept</button>\n * }\n * ```\n */\n\nimport { useState, useEffect } from 'react'\nimport type { ConsentValue } from './types'\nimport type { ConsentiSetup } from './core/consenti-setup'\n\n/**\n * Module-level singleton — the active `ConsentiSetup` instance.\n * Using a module-level variable (rather than React context) keeps the integration\n * zero-configuration: no `<ConsentiProvider>` wrapper is required.\n */\nlet _widget: ConsentiSetup | null = null\n\n/**\n * Registers the active `ConsentiSetup` instance so `useConsent()` can read from it.\n * Call this once after creating your widget, typically inside a `useEffect`.\n *\n * @param widget - The `ConsentiSetup` instance to register.\n */\nexport function setConsentiWidget(widget: ConsentiSetup): void {\n  _widget = widget\n}\n\n/**\n * React hook that exposes consent state and lets components react to consent changes.\n *\n * Subscribes to `consenti:consentSubmitted` on `window` and triggers a re-render\n * each time consent is updated. Returns SSR-safe fallback values during server render.\n *\n * @returns An object with `hasConsent`, `getConsent`, `submitConsent`, and `getConsentDate`.\n */\nexport function useConsent() {\n  const isServer = typeof window === 'undefined'\n\n  const [, forceUpdate] = useState(0)\n\n  useEffect(() => {\n    if (!_widget) return\n    const handler = () => forceUpdate((n) => n + 1)\n    window.addEventListener('consenti:consentSubmitted', handler)\n    return () => window.removeEventListener('consenti:consentSubmitted', handler)\n  }, [])\n\n  if (isServer) {\n    return {\n      hasConsent: () => false as boolean,\n      getConsent: () => null as ConsentValue | null,\n      submitConsent: async (_consent: Partial<ConsentValue>) => {},\n      getConsentDate: () => false as Date | false,\n    }\n  }\n\n  return {\n    /** Returns `true` if the visitor has saved consent. */\n    hasConsent: () => _widget?.hasConsent() ?? false,\n    /** Returns the stored consent map, or `null`. */\n    getConsent: () => _widget?.getConsent() ?? null,\n    /** Saves the given partial consent map. Missing keys default to `'denied'`. */\n    submitConsent: (consent: Partial<ConsentValue>) =>\n      _widget?.submitConsent(consent) ?? Promise.resolve(),\n    /** Returns the `Date` of last consent submission, or `false`. */\n    getConsentDate: () => _widget?.getConsentDate() ?? false,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCA,mBAAoC;AASpC,IAAI,UAAgC;AAQ7B,SAAS,kBAAkB,QAA6B;AAC7D,YAAU;AACZ;AAUO,SAAS,aAAa;AAC3B,QAAM,WAAW,OAAO,WAAW;AAEnC,QAAM,CAAC,EAAE,WAAW,QAAI,uBAAS,CAAC;AAElC,8BAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,UAAM,UAAU,MAAM,YAAY,CAAC,MAAM,IAAI,CAAC;AAC9C,WAAO,iBAAiB,6BAA6B,OAAO;AAC5D,WAAO,MAAM,OAAO,oBAAoB,6BAA6B,OAAO;AAAA,EAC9E,GAAG,CAAC,CAAC;AAEL,MAAI,UAAU;AACZ,WAAO;AAAA,MACL,YAAY,MAAM;AAAA,MAClB,YAAY,MAAM;AAAA,MAClB,eAAe,OAAO,aAAoC;AAAA,MAAC;AAAA,MAC3D,gBAAgB,MAAM;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AAAA;AAAA,IAEL,YAAY,MAAM,SAAS,WAAW,KAAK;AAAA;AAAA,IAE3C,YAAY,MAAM,SAAS,WAAW,KAAK;AAAA;AAAA,IAE3C,eAAe,CAAC,YACd,SAAS,cAAc,OAAO,KAAK,QAAQ,QAAQ;AAAA;AAAA,IAErD,gBAAgB,MAAM,SAAS,eAAe,KAAK;AAAA,EACrD;AACF;","names":[]}
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React integration for `@consenti/ui`.\n *\n * Import from the `@consenti/ui/react` subpath to keep this module\n * tree-shaken out of vanilla JS or Vue bundles.\n *\n * Intended for **Next.js** (App Router and Pages Router) and any other React 18+\n * project where you manage the `ConsentiSetup` instance yourself and want the\n * `useConsent()` hook to re-render when consent or UI state changes.\n *\n * @example\n * ```tsx\n * // app/providers.tsx (Next.js App Router)\n * 'use client'\n * import { useEffect } from 'react'\n * import { ConsentiSetup } from '@consenti/ui'\n * import { setConsentiWidget } from '@consenti/ui/react'\n *\n * export function ConsentiProvider({ children }: { children: React.ReactNode }) {\n *   useEffect(() => {\n *     const widget = new ConsentiSetup({\n *       api: { enabled: true, baseUrl: process.env.NEXT_PUBLIC_API_URL },\n *     })\n *     setConsentiWidget(widget)\n *   }, [])\n *   return <>{children}</>\n * }\n *\n * // Any component\n * import { useConsent } from '@consenti/ui/react'\n *\n * function CookieStatus() {\n *   const { hasConsent, consent, showModal } = useConsent()\n *   if (!hasConsent) return <button onClick={showModal}>Manage Cookies</button>\n *   return <span>{consent?.analytics === 'granted' ? 'Analytics on' : 'Analytics off'}</span>\n * }\n * ```\n */\n\nimport { useState, useEffect } from 'react'\nimport type { ConsentValue } from './types'\nimport type { ConsentiSetup } from './core/consenti-setup'\n\n/**\n * Module-level singleton — the active `ConsentiSetup` instance.\n * Using a module-level variable (rather than React context) keeps the integration\n * zero-configuration: no `<ConsentiProvider>` wrapper is required.\n */\nlet _widget: ConsentiSetup | null = null\n\n/**\n * Registers the active `ConsentiSetup` instance so `useConsent()` can read from it.\n * Call this once after creating your widget, typically inside a `useEffect`.\n *\n * @param widget - The `ConsentiSetup` instance to register.\n */\nexport function setConsentiWidget(widget: ConsentiSetup): void {\n  _widget = widget\n}\n\n/**\n * React hook that exposes consent state, banner/modal visibility, and widget actions.\n *\n * Subscribes to `consenti:consentSubmitted`, `consenti:bannerVisibility`, and\n * `consenti:modalVisibility` on `window` and triggers re-renders on each event.\n * Returns SSR-safe initial values during server render.\n *\n * Destructure only what you need — unused values do not cause extra renders.\n *\n * @returns Consent state values and widget action functions.\n */\nexport function useConsent() {\n  const isServer = typeof window === 'undefined'\n\n  const [hasConsent, setHasConsent] = useState<boolean>(() =>\n    !isServer ? (_widget?.hasConsent() ?? false) : false,\n  )\n  const [consent, setConsent] = useState<ConsentValue | null>(() =>\n    !isServer ? (_widget?.getConsent() ?? null) : null,\n  )\n  const [consentDate, setConsentDate] = useState<Date | false>(() =>\n    !isServer ? (_widget?.getConsentDate() ?? false) : false,\n  )\n  const [bannerVisible, setBannerVisible] = useState<'main' | 'gpc' | false>(false)\n  const [modalVisible, setModalVisible] = useState<'preference' | false>(false)\n\n  useEffect(() => {\n    if (!_widget) return\n\n    const onConsent = () => {\n      setHasConsent(_widget?.hasConsent() ?? false)\n      setConsent(_widget?.getConsent() ?? null)\n      setConsentDate(_widget?.getConsentDate() ?? false)\n    }\n    const onBanner = () => setBannerVisible(_widget?.bannerVisibility() ?? false)\n    const onModal  = () => setModalVisible(_widget?.modalVisibility() ?? false)\n\n    window.addEventListener('consenti:consentSubmitted', onConsent)\n    window.addEventListener('consenti:bannerVisibility',  onBanner)\n    window.addEventListener('consenti:modalVisibility',   onModal)\n\n    return () => {\n      window.removeEventListener('consenti:consentSubmitted', onConsent)\n      window.removeEventListener('consenti:bannerVisibility',  onBanner)\n      window.removeEventListener('consenti:modalVisibility',   onModal)\n    }\n  }, [])\n\n  // ── SSR-safe fallback ──────────────────────────────────────────────────────\n  if (isServer) {\n    return {\n      hasConsent:   false as boolean,\n      consent:      null  as ConsentValue | null,\n      consentDate:  false as Date | false,\n      bannerVisible: false as 'main' | 'gpc' | false,\n      modalVisible:  false as 'preference' | false,\n      showBanner:   (_gpc?: boolean) => {},\n      hideBanner:   () => {},\n      showModal:    () => {},\n      hideModal:    () => {},\n      grantAll:     (_onlyMandatory?: boolean) => Promise.resolve(),\n      denyAll:      (_includingMandatory?: boolean) => Promise.resolve(),\n      submitConsent: (_c: Partial<ConsentValue>) => Promise.resolve(),\n      reConsent:    () => Promise.resolve(),\n      isCookieGranted:   (_id: string) => false as boolean,\n      isCategoryGranted: (_id: string) => false as boolean,\n      switchLocale: (_locale: string) => {},\n    }\n  }\n\n  // ── Client ────────────────────────────────────────────────────────────────\n  return {\n    /** `true` if the visitor has saved a valid consent record. */\n    hasConsent,\n    /** The stored consent map (`Record<cookieId, status>`), or `null` before first submission. */\n    consent,\n    /** `Date` of the last consent submission, or `false` if no consent exists. */\n    consentDate,\n    /** Current banner state: `'main'`, `'gpc'`, or `false` (hidden). */\n    bannerVisible,\n    /** Current modal state: `'preference'` or `false` (hidden). */\n    modalVisible,\n\n    /** Shows the consent banner. Pass `true` to force the GPC variant. */\n    showBanner: (gpc?: boolean) => _widget?.showBanner(gpc),\n    /** Hides the consent banner. */\n    hideBanner: () => _widget?.hideBanner(),\n    /** Opens the preference modal. */\n    showModal: () => _widget?.showModal(),\n    /** Closes the preference modal. */\n    hideModal: () => _widget?.hideModal(),\n\n    /** Grants all non-mandatory cookies. Pass `true` to grant only mandatory ones and deny the rest. */\n    grantAll: (onlyMandatory?: boolean) => _widget?.grantAll(onlyMandatory) ?? Promise.resolve(),\n    /** Denies all non-mandatory cookies. Pass `true` to deny mandatory ones too (use with care). */\n    denyAll: (includingMandatory?: boolean) => _widget?.denyAll(includingMandatory) ?? Promise.resolve(),\n    /** Saves the given partial consent map. */\n    submitConsent: (c: Partial<ConsentValue>) => _widget?.submitConsent(c) ?? Promise.resolve(),\n    /** Deletes the current consent record and re-shows the banner. */\n    reConsent: () => _widget?.reConsent() ?? Promise.resolve(),\n\n    /** Returns `true` if the given cookie ID is `'granted'`. */\n    isCookieGranted: (id: string) => (_widget?.isCookieGranted(id) ?? false) as boolean,\n    /** Returns `true` if every cookie in the given category is `'granted'`. */\n    isCategoryGranted: (id: string) => (_widget?.isCategoryGranted(id) ?? false) as boolean,\n    /** Switches the active locale and re-renders the banner and modal. */\n    switchLocale: (locale: string) => _widget?.switchLocale(locale),\n  }\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,EAAA,eAAAC,IAAA,eAAAC,EAAAJ,GAuCA,IAAAK,EAAoC,iBAShCC,EAAgC,KAQ7B,SAASJ,EAAkBK,EAA6B,CAC7DD,EAAUC,CACZ,CAaO,SAASJ,GAAa,CAC3B,IAAMK,EAAW,OAAO,OAAW,IAE7B,CAACC,EAAYC,CAAa,KAAI,YAAkB,IACnDF,EAA8C,GAAlCF,GAAS,WAAW,GAAK,EACxC,EACM,CAACK,EAASC,CAAU,KAAI,YAA8B,IACzDJ,EAA6C,KAAjCF,GAAS,WAAW,GAAK,IACxC,EACM,CAACO,EAAaC,CAAc,KAAI,YAAuB,IAC1DN,EAAkD,GAAtCF,GAAS,eAAe,GAAK,EAC5C,EACM,CAACS,EAAeC,CAAgB,KAAI,YAAiC,EAAK,EAC1E,CAACC,EAAcC,CAAe,KAAI,YAA+B,EAAK,EAyB5E,SAvBA,aAAU,IAAM,CACd,GAAI,CAACZ,EAAS,OAEd,IAAMa,EAAY,IAAM,CACtBT,EAAcJ,GAAS,WAAW,GAAK,EAAK,EAC5CM,EAAWN,GAAS,WAAW,GAAK,IAAI,EACxCQ,EAAeR,GAAS,eAAe,GAAK,EAAK,CACnD,EACMc,EAAW,IAAMJ,EAAiBV,GAAS,iBAAiB,GAAK,EAAK,EACtEe,EAAW,IAAMH,EAAgBZ,GAAS,gBAAgB,GAAK,EAAK,EAE1E,cAAO,iBAAiB,4BAA6Ba,CAAS,EAC9D,OAAO,iBAAiB,4BAA8BC,CAAQ,EAC9D,OAAO,iBAAiB,2BAA8BC,CAAO,EAEtD,IAAM,CACX,OAAO,oBAAoB,4BAA6BF,CAAS,EACjE,OAAO,oBAAoB,4BAA8BC,CAAQ,EACjE,OAAO,oBAAoB,2BAA8BC,CAAO,CAClE,CACF,EAAG,CAAC,CAAC,EAGDb,EACK,CACL,WAAc,GACd,QAAc,KACd,YAAc,GACd,cAAe,GACf,aAAe,GACf,WAAec,GAAmB,CAAC,EACnC,WAAc,IAAM,CAAC,EACrB,UAAc,IAAM,CAAC,EACrB,UAAc,IAAM,CAAC,EACrB,SAAeC,GAA6B,QAAQ,QAAQ,EAC5D,QAAeC,GAAkC,QAAQ,QAAQ,EACjE,cAAgBC,GAA8B,QAAQ,QAAQ,EAC9D,UAAc,IAAM,QAAQ,QAAQ,EACpC,gBAAoBC,GAAgB,GACpC,kBAAoBA,GAAgB,GACpC,aAAeC,GAAoB,CAAC,CACtC,EAIK,CAEL,WAAAlB,EAEA,QAAAE,EAEA,YAAAE,EAEA,cAAAE,EAEA,aAAAE,EAGA,WAAaW,GAAkBtB,GAAS,WAAWsB,CAAG,EAEtD,WAAY,IAAMtB,GAAS,WAAW,EAEtC,UAAW,IAAMA,GAAS,UAAU,EAEpC,UAAW,IAAMA,GAAS,UAAU,EAGpC,SAAWuB,GAA4BvB,GAAS,SAASuB,CAAa,GAAK,QAAQ,QAAQ,EAE3F,QAAUC,GAAiCxB,GAAS,QAAQwB,CAAkB,GAAK,QAAQ,QAAQ,EAEnG,cAAgBC,GAA6BzB,GAAS,cAAcyB,CAAC,GAAK,QAAQ,QAAQ,EAE1F,UAAW,IAAMzB,GAAS,UAAU,GAAK,QAAQ,QAAQ,EAGzD,gBAAkB0B,GAAgB1B,GAAS,gBAAgB0B,CAAE,GAAK,GAElE,kBAAoBA,GAAgB1B,GAAS,kBAAkB0B,CAAE,GAAK,GAEtE,aAAeC,GAAmB3B,GAAS,aAAa2B,CAAM,CAChE,CACF","names":["react_exports","__export","setConsentiWidget","useConsent","__toCommonJS","import_react","_widget","widget","isServer","hasConsent","setHasConsent","consent","setConsent","consentDate","setConsentDate","bannerVisible","setBannerVisible","modalVisible","setModalVisible","onConsent","onBanner","onModal","_gpc","_onlyMandatory","_includingMandatory","_c","_id","_locale","gpc","onlyMandatory","includingMandatory","c","id","locale"]}

package/dist/react.mjs

@@ -1,40 +1,2 @@
-// src/react.ts
-import { useState, useEffect } from "react";
-var _widget = null;
-function setConsentiWidget(widget) {
-  _widget = widget;
-}
-function useConsent() {
-  const isServer = typeof window === "undefined";
-  const [, forceUpdate] = useState(0);
-  useEffect(() => {
-    if (!_widget) return;
-    const handler = () => forceUpdate((n) => n + 1);
-    window.addEventListener("consenti:consentSubmitted", handler);
-    return () => window.removeEventListener("consenti:consentSubmitted", handler);
-  }, []);
-  if (isServer) {
-    return {
-      hasConsent: () => false,
-      getConsent: () => null,
-      submitConsent: async (_consent) => {
-      },
-      getConsentDate: () => false
-    };
-  }
-  return {
-    /** Returns `true` if the visitor has saved consent. */
-    hasConsent: () => _widget?.hasConsent() ?? false,
-    /** Returns the stored consent map, or `null`. */
-    getConsent: () => _widget?.getConsent() ?? null,
-    /** Saves the given partial consent map. Missing keys default to `'denied'`. */
-    submitConsent: (consent) => _widget?.submitConsent(consent) ?? Promise.resolve(),
-    /** Returns the `Date` of last consent submission, or `false`. */
-    getConsentDate: () => _widget?.getConsentDate() ?? false
-  };
-}
-export {
-  setConsentiWidget,
-  useConsent
-};
+import{useState as o,useEffect as w}from"react";var n=null;function h(s){n=s}function v(){let s=typeof window>"u",[i,l]=o(()=>s?!1:n?.hasConsent()??!1),[r,d]=o(()=>s?null:n?.getConsent()??null),[c,f]=o(()=>s?!1:n?.getConsentDate()??!1),[b,C]=o(!1),[u,m]=o(!1);return w(()=>{if(!n)return;let e=()=>{l(n?.hasConsent()??!1),d(n?.getConsent()??null),f(n?.getConsentDate()??!1)},t=()=>C(n?.bannerVisibility()??!1),a=()=>m(n?.modalVisibility()??!1);return window.addEventListener("consenti:consentSubmitted",e),window.addEventListener("consenti:bannerVisibility",t),window.addEventListener("consenti:modalVisibility",a),()=>{window.removeEventListener("consenti:consentSubmitted",e),window.removeEventListener("consenti:bannerVisibility",t),window.removeEventListener("consenti:modalVisibility",a)}},[]),s?{hasConsent:!1,consent:null,consentDate:!1,bannerVisible:!1,modalVisible:!1,showBanner:e=>{},hideBanner:()=>{},showModal:()=>{},hideModal:()=>{},grantAll:e=>Promise.resolve(),denyAll:e=>Promise.resolve(),submitConsent:e=>Promise.resolve(),reConsent:()=>Promise.resolve(),isCookieGranted:e=>!1,isCategoryGranted:e=>!1,switchLocale:e=>{}}:{hasConsent:i,consent:r,consentDate:c,bannerVisible:b,modalVisible:u,showBanner:e=>n?.showBanner(e),hideBanner:()=>n?.hideBanner(),showModal:()=>n?.showModal(),hideModal:()=>n?.hideModal(),grantAll:e=>n?.grantAll(e)??Promise.resolve(),denyAll:e=>n?.denyAll(e)??Promise.resolve(),submitConsent:e=>n?.submitConsent(e)??Promise.resolve(),reConsent:()=>n?.reConsent()??Promise.resolve(),isCookieGranted:e=>n?.isCookieGranted(e)??!1,isCategoryGranted:e=>n?.isCategoryGranted(e)??!1,switchLocale:e=>n?.switchLocale(e)}}export{h as setConsentiWidget,v as useConsent};
 //# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React integration for `@consenti/ui`.\n *\n * Import from the `@consenti/ui/react` subpath to keep this module\n * tree-shaken out of vanilla JS or Vue bundles.\n *\n * Intended for **Next.js** (App Router and Pages Router) and any other React 18+\n * project where you manage the `ConsentiSetup` instance yourself and want the\n * `useConsent()` hook to re-render when consent changes.\n *\n * @example\n * ```tsx\n * // app/providers.tsx (Next.js App Router)\n * 'use client'\n * import { useEffect } from 'react'\n * import { ConsentiSetup } from '@consenti/ui'\n * import { setConsentiWidget } from '@consenti/ui/react'\n *\n * export function ConsentiProvider({ children }: { children: React.ReactNode }) {\n *   useEffect(() => {\n *     const widget = new ConsentiSetup({ core: { profileId: 0 } })\n *     setConsentiWidget(widget)\n *   }, [])\n *   return <>{children}</>\n * }\n *\n * // Any component\n * import { useConsent } from '@consenti/ui/react'\n *\n * function CookieBanner() {\n *   const { hasConsent, submitConsent } = useConsent()\n *   if (hasConsent()) return null\n *   return <button onClick={() => submitConsent({ analytics: 'granted' })}>Accept</button>\n * }\n * ```\n */\n\nimport { useState, useEffect } from 'react'\nimport type { ConsentValue } from './types'\nimport type { ConsentiSetup } from './core/consenti-setup'\n\n/**\n * Module-level singleton — the active `ConsentiSetup` instance.\n * Using a module-level variable (rather than React context) keeps the integration\n * zero-configuration: no `<ConsentiProvider>` wrapper is required.\n */\nlet _widget: ConsentiSetup | null = null\n\n/**\n * Registers the active `ConsentiSetup` instance so `useConsent()` can read from it.\n * Call this once after creating your widget, typically inside a `useEffect`.\n *\n * @param widget - The `ConsentiSetup` instance to register.\n */\nexport function setConsentiWidget(widget: ConsentiSetup): void {\n  _widget = widget\n}\n\n/**\n * React hook that exposes consent state and lets components react to consent changes.\n *\n * Subscribes to `consenti:consentSubmitted` on `window` and triggers a re-render\n * each time consent is updated. Returns SSR-safe fallback values during server render.\n *\n * @returns An object with `hasConsent`, `getConsent`, `submitConsent`, and `getConsentDate`.\n */\nexport function useConsent() {\n  const isServer = typeof window === 'undefined'\n\n  const [, forceUpdate] = useState(0)\n\n  useEffect(() => {\n    if (!_widget) return\n    const handler = () => forceUpdate((n) => n + 1)\n    window.addEventListener('consenti:consentSubmitted', handler)\n    return () => window.removeEventListener('consenti:consentSubmitted', handler)\n  }, [])\n\n  if (isServer) {\n    return {\n      hasConsent: () => false as boolean,\n      getConsent: () => null as ConsentValue | null,\n      submitConsent: async (_consent: Partial<ConsentValue>) => {},\n      getConsentDate: () => false as Date | false,\n    }\n  }\n\n  return {\n    /** Returns `true` if the visitor has saved consent. */\n    hasConsent: () => _widget?.hasConsent() ?? false,\n    /** Returns the stored consent map, or `null`. */\n    getConsent: () => _widget?.getConsent() ?? null,\n    /** Saves the given partial consent map. Missing keys default to `'denied'`. */\n    submitConsent: (consent: Partial<ConsentValue>) =>\n      _widget?.submitConsent(consent) ?? Promise.resolve(),\n    /** Returns the `Date` of last consent submission, or `false`. */\n    getConsentDate: () => _widget?.getConsentDate() ?? false,\n  }\n}\n"],"mappings":";AAqCA,SAAS,UAAU,iBAAiB;AASpC,IAAI,UAAgC;AAQ7B,SAAS,kBAAkB,QAA6B;AAC7D,YAAU;AACZ;AAUO,SAAS,aAAa;AAC3B,QAAM,WAAW,OAAO,WAAW;AAEnC,QAAM,CAAC,EAAE,WAAW,IAAI,SAAS,CAAC;AAElC,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,UAAM,UAAU,MAAM,YAAY,CAAC,MAAM,IAAI,CAAC;AAC9C,WAAO,iBAAiB,6BAA6B,OAAO;AAC5D,WAAO,MAAM,OAAO,oBAAoB,6BAA6B,OAAO;AAAA,EAC9E,GAAG,CAAC,CAAC;AAEL,MAAI,UAAU;AACZ,WAAO;AAAA,MACL,YAAY,MAAM;AAAA,MAClB,YAAY,MAAM;AAAA,MAClB,eAAe,OAAO,aAAoC;AAAA,MAAC;AAAA,MAC3D,gBAAgB,MAAM;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AAAA;AAAA,IAEL,YAAY,MAAM,SAAS,WAAW,KAAK;AAAA;AAAA,IAE3C,YAAY,MAAM,SAAS,WAAW,KAAK;AAAA;AAAA,IAE3C,eAAe,CAAC,YACd,SAAS,cAAc,OAAO,KAAK,QAAQ,QAAQ;AAAA;AAAA,IAErD,gBAAgB,MAAM,SAAS,eAAe,KAAK;AAAA,EACrD;AACF;","names":[]}
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React integration for `@consenti/ui`.\n *\n * Import from the `@consenti/ui/react` subpath to keep this module\n * tree-shaken out of vanilla JS or Vue bundles.\n *\n * Intended for **Next.js** (App Router and Pages Router) and any other React 18+\n * project where you manage the `ConsentiSetup` instance yourself and want the\n * `useConsent()` hook to re-render when consent or UI state changes.\n *\n * @example\n * ```tsx\n * // app/providers.tsx (Next.js App Router)\n * 'use client'\n * import { useEffect } from 'react'\n * import { ConsentiSetup } from '@consenti/ui'\n * import { setConsentiWidget } from '@consenti/ui/react'\n *\n * export function ConsentiProvider({ children }: { children: React.ReactNode }) {\n *   useEffect(() => {\n *     const widget = new ConsentiSetup({\n *       api: { enabled: true, baseUrl: process.env.NEXT_PUBLIC_API_URL },\n *     })\n *     setConsentiWidget(widget)\n *   }, [])\n *   return <>{children}</>\n * }\n *\n * // Any component\n * import { useConsent } from '@consenti/ui/react'\n *\n * function CookieStatus() {\n *   const { hasConsent, consent, showModal } = useConsent()\n *   if (!hasConsent) return <button onClick={showModal}>Manage Cookies</button>\n *   return <span>{consent?.analytics === 'granted' ? 'Analytics on' : 'Analytics off'}</span>\n * }\n * ```\n */\n\nimport { useState, useEffect } from 'react'\nimport type { ConsentValue } from './types'\nimport type { ConsentiSetup } from './core/consenti-setup'\n\n/**\n * Module-level singleton — the active `ConsentiSetup` instance.\n * Using a module-level variable (rather than React context) keeps the integration\n * zero-configuration: no `<ConsentiProvider>` wrapper is required.\n */\nlet _widget: ConsentiSetup | null = null\n\n/**\n * Registers the active `ConsentiSetup` instance so `useConsent()` can read from it.\n * Call this once after creating your widget, typically inside a `useEffect`.\n *\n * @param widget - The `ConsentiSetup` instance to register.\n */\nexport function setConsentiWidget(widget: ConsentiSetup): void {\n  _widget = widget\n}\n\n/**\n * React hook that exposes consent state, banner/modal visibility, and widget actions.\n *\n * Subscribes to `consenti:consentSubmitted`, `consenti:bannerVisibility`, and\n * `consenti:modalVisibility` on `window` and triggers re-renders on each event.\n * Returns SSR-safe initial values during server render.\n *\n * Destructure only what you need — unused values do not cause extra renders.\n *\n * @returns Consent state values and widget action functions.\n */\nexport function useConsent() {\n  const isServer = typeof window === 'undefined'\n\n  const [hasConsent, setHasConsent] = useState<boolean>(() =>\n    !isServer ? (_widget?.hasConsent() ?? false) : false,\n  )\n  const [consent, setConsent] = useState<ConsentValue | null>(() =>\n    !isServer ? (_widget?.getConsent() ?? null) : null,\n  )\n  const [consentDate, setConsentDate] = useState<Date | false>(() =>\n    !isServer ? (_widget?.getConsentDate() ?? false) : false,\n  )\n  const [bannerVisible, setBannerVisible] = useState<'main' | 'gpc' | false>(false)\n  const [modalVisible, setModalVisible] = useState<'preference' | false>(false)\n\n  useEffect(() => {\n    if (!_widget) return\n\n    const onConsent = () => {\n      setHasConsent(_widget?.hasConsent() ?? false)\n      setConsent(_widget?.getConsent() ?? null)\n      setConsentDate(_widget?.getConsentDate() ?? false)\n    }\n    const onBanner = () => setBannerVisible(_widget?.bannerVisibility() ?? false)\n    const onModal  = () => setModalVisible(_widget?.modalVisibility() ?? false)\n\n    window.addEventListener('consenti:consentSubmitted', onConsent)\n    window.addEventListener('consenti:bannerVisibility',  onBanner)\n    window.addEventListener('consenti:modalVisibility',   onModal)\n\n    return () => {\n      window.removeEventListener('consenti:consentSubmitted', onConsent)\n      window.removeEventListener('consenti:bannerVisibility',  onBanner)\n      window.removeEventListener('consenti:modalVisibility',   onModal)\n    }\n  }, [])\n\n  // ── SSR-safe fallback ──────────────────────────────────────────────────────\n  if (isServer) {\n    return {\n      hasConsent:   false as boolean,\n      consent:      null  as ConsentValue | null,\n      consentDate:  false as Date | false,\n      bannerVisible: false as 'main' | 'gpc' | false,\n      modalVisible:  false as 'preference' | false,\n      showBanner:   (_gpc?: boolean) => {},\n      hideBanner:   () => {},\n      showModal:    () => {},\n      hideModal:    () => {},\n      grantAll:     (_onlyMandatory?: boolean) => Promise.resolve(),\n      denyAll:      (_includingMandatory?: boolean) => Promise.resolve(),\n      submitConsent: (_c: Partial<ConsentValue>) => Promise.resolve(),\n      reConsent:    () => Promise.resolve(),\n      isCookieGranted:   (_id: string) => false as boolean,\n      isCategoryGranted: (_id: string) => false as boolean,\n      switchLocale: (_locale: string) => {},\n    }\n  }\n\n  // ── Client ────────────────────────────────────────────────────────────────\n  return {\n    /** `true` if the visitor has saved a valid consent record. */\n    hasConsent,\n    /** The stored consent map (`Record<cookieId, status>`), or `null` before first submission. */\n    consent,\n    /** `Date` of the last consent submission, or `false` if no consent exists. */\n    consentDate,\n    /** Current banner state: `'main'`, `'gpc'`, or `false` (hidden). */\n    bannerVisible,\n    /** Current modal state: `'preference'` or `false` (hidden). */\n    modalVisible,\n\n    /** Shows the consent banner. Pass `true` to force the GPC variant. */\n    showBanner: (gpc?: boolean) => _widget?.showBanner(gpc),\n    /** Hides the consent banner. */\n    hideBanner: () => _widget?.hideBanner(),\n    /** Opens the preference modal. */\n    showModal: () => _widget?.showModal(),\n    /** Closes the preference modal. */\n    hideModal: () => _widget?.hideModal(),\n\n    /** Grants all non-mandatory cookies. Pass `true` to grant only mandatory ones and deny the rest. */\n    grantAll: (onlyMandatory?: boolean) => _widget?.grantAll(onlyMandatory) ?? Promise.resolve(),\n    /** Denies all non-mandatory cookies. Pass `true` to deny mandatory ones too (use with care). */\n    denyAll: (includingMandatory?: boolean) => _widget?.denyAll(includingMandatory) ?? Promise.resolve(),\n    /** Saves the given partial consent map. */\n    submitConsent: (c: Partial<ConsentValue>) => _widget?.submitConsent(c) ?? Promise.resolve(),\n    /** Deletes the current consent record and re-shows the banner. */\n    reConsent: () => _widget?.reConsent() ?? Promise.resolve(),\n\n    /** Returns `true` if the given cookie ID is `'granted'`. */\n    isCookieGranted: (id: string) => (_widget?.isCookieGranted(id) ?? false) as boolean,\n    /** Returns `true` if every cookie in the given category is `'granted'`. */\n    isCategoryGranted: (id: string) => (_widget?.isCategoryGranted(id) ?? false) as boolean,\n    /** Switches the active locale and re-renders the banner and modal. */\n    switchLocale: (locale: string) => _widget?.switchLocale(locale),\n  }\n}\n"],"mappings":"AAuCA,OAAS,YAAAA,EAAU,aAAAC,MAAiB,QASpC,IAAIC,EAAgC,KAQ7B,SAASC,EAAkBC,EAA6B,CAC7DF,EAAUE,CACZ,CAaO,SAASC,GAAa,CAC3B,IAAMC,EAAW,OAAO,OAAW,IAE7B,CAACC,EAAYC,CAAa,EAAIR,EAAkB,IACnDM,EAA8C,GAAlCJ,GAAS,WAAW,GAAK,EACxC,EACM,CAACO,EAASC,CAAU,EAAIV,EAA8B,IACzDM,EAA6C,KAAjCJ,GAAS,WAAW,GAAK,IACxC,EACM,CAACS,EAAaC,CAAc,EAAIZ,EAAuB,IAC1DM,EAAkD,GAAtCJ,GAAS,eAAe,GAAK,EAC5C,EACM,CAACW,EAAeC,CAAgB,EAAId,EAAiC,EAAK,EAC1E,CAACe,EAAcC,CAAe,EAAIhB,EAA+B,EAAK,EAyB5E,OAvBAC,EAAU,IAAM,CACd,GAAI,CAACC,EAAS,OAEd,IAAMe,EAAY,IAAM,CACtBT,EAAcN,GAAS,WAAW,GAAK,EAAK,EAC5CQ,EAAWR,GAAS,WAAW,GAAK,IAAI,EACxCU,EAAeV,GAAS,eAAe,GAAK,EAAK,CACnD,EACMgB,EAAW,IAAMJ,EAAiBZ,GAAS,iBAAiB,GAAK,EAAK,EACtEiB,EAAW,IAAMH,EAAgBd,GAAS,gBAAgB,GAAK,EAAK,EAE1E,cAAO,iBAAiB,4BAA6Be,CAAS,EAC9D,OAAO,iBAAiB,4BAA8BC,CAAQ,EAC9D,OAAO,iBAAiB,2BAA8BC,CAAO,EAEtD,IAAM,CACX,OAAO,oBAAoB,4BAA6BF,CAAS,EACjE,OAAO,oBAAoB,4BAA8BC,CAAQ,EACjE,OAAO,oBAAoB,2BAA8BC,CAAO,CAClE,CACF,EAAG,CAAC,CAAC,EAGDb,EACK,CACL,WAAc,GACd,QAAc,KACd,YAAc,GACd,cAAe,GACf,aAAe,GACf,WAAec,GAAmB,CAAC,EACnC,WAAc,IAAM,CAAC,EACrB,UAAc,IAAM,CAAC,EACrB,UAAc,IAAM,CAAC,EACrB,SAAeC,GAA6B,QAAQ,QAAQ,EAC5D,QAAeC,GAAkC,QAAQ,QAAQ,EACjE,cAAgBC,GAA8B,QAAQ,QAAQ,EAC9D,UAAc,IAAM,QAAQ,QAAQ,EACpC,gBAAoBC,GAAgB,GACpC,kBAAoBA,GAAgB,GACpC,aAAeC,GAAoB,CAAC,CACtC,EAIK,CAEL,WAAAlB,EAEA,QAAAE,EAEA,YAAAE,EAEA,cAAAE,EAEA,aAAAE,EAGA,WAAaW,GAAkBxB,GAAS,WAAWwB,CAAG,EAEtD,WAAY,IAAMxB,GAAS,WAAW,EAEtC,UAAW,IAAMA,GAAS,UAAU,EAEpC,UAAW,IAAMA,GAAS,UAAU,EAGpC,SAAWyB,GAA4BzB,GAAS,SAASyB,CAAa,GAAK,QAAQ,QAAQ,EAE3F,QAAUC,GAAiC1B,GAAS,QAAQ0B,CAAkB,GAAK,QAAQ,QAAQ,EAEnG,cAAgBC,GAA6B3B,GAAS,cAAc2B,CAAC,GAAK,QAAQ,QAAQ,EAE1F,UAAW,IAAM3B,GAAS,UAAU,GAAK,QAAQ,QAAQ,EAGzD,gBAAkB4B,GAAgB5B,GAAS,gBAAgB4B,CAAE,GAAK,GAElE,kBAAoBA,GAAgB5B,GAAS,kBAAkB4B,CAAE,GAAK,GAEtE,aAAeC,GAAmB7B,GAAS,aAAa6B,CAAM,CAChE,CACF","names":["useState","useEffect","_widget","setConsentiWidget","widget","useConsent","isServer","hasConsent","setHasConsent","consent","setConsent","consentDate","setConsentDate","bannerVisible","setBannerVisible","modalVisible","setModalVisible","onConsent","onBanner","onModal","_gpc","_onlyMandatory","_includingMandatory","_c","_id","_locale","gpc","onlyMandatory","includingMandatory","c","id","locale"]}