@c15t/react 2.0.4 → 2.2.0-canary-20260727202135

package/dist-types/components/shared/ui/dialog/dialog.d.ts

@@ -5,7 +5,7 @@ export interface DialogRootProps {
     onOpenChange?: (open: boolean) => void;
     open?: boolean;
 }
-declare function DialogRoot({ children, defaultOpen, onOpenChange, open, }: DialogRootProps): import("react/jsx-runtime").JSX.Element;
+declare function DialogRoot({ children, defaultOpen, onOpenChange, open, }: DialogRootProps): import("react").JSX.Element;
 export interface DialogTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> {
     asChild?: boolean;
 }

package/dist-types/components/shared/ui/logo.d.ts

@@ -7,20 +7,20 @@ interface IconProps {
  * c15t icon only (without text).
  * Use this for compact displays like the floating trigger.
  */
-export declare const C15TIconOnly: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const C15TIconOnly: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * c15t full logo with text.
  * Use this for branding displays.
  */
-export declare const C15TIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const C15TIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * INTH logo for partner branding displays.
  */
-export declare const InthLogo: (props: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const InthLogo: (props: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * INTH icon-only mark for compact placements like floating triggers.
  */
-export declare const InthIconOnly: (props: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const InthIconOnly: (props: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * Wordmark logo for the hosted consent product (inth.com).
  *
@@ -31,20 +31,20 @@ export declare const InthIconOnly: (props: SVGProps<SVGSVGElement> & IconProps)
  * @param title - Accessible title announced to screen readers. Defaults to "Consent".
  * @param titleId - DOM id for the SVG `<title>` element. Must be unique on the page when rendered more than once.
  */
-export declare const ConsentLogo: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ConsentLogo: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * Consent icon only (without text).
  * Use this for compact displays like the preference center footer.
  */
-export declare const ConsentIconOnly: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ConsentIconOnly: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * Fingerprint icon for privacy/consent contexts.
  * A generic icon representing user identity and privacy.
  */
-export declare const FingerprintIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FingerprintIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 /**
  * Settings/gear icon for preference contexts.
  * A generic icon representing configuration and settings.
  */
-export declare const SettingsIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SettingsIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
 export {};

package/dist-types/headless.d.ts

@@ -2,6 +2,7 @@ export { type ConsentManagerInterface, configureConsentManager, defaultTranslati
 export { useColorScheme } from './hooks/use-color-scheme';
 export { type ConsentDialogTriggerVisibility, type UseConsentDialogTriggerOptions, type UseConsentDialogTriggerResult, useConsentDialogTrigger, } from './hooks/use-consent-dialog-trigger';
 export { useConsentManager } from './hooks/use-consent-manager';
+export { ConsentScriptConflictError, type ConsentScriptReadyControls, type ConsentScriptStatus, type ConsentScriptUnmountBehavior, type UseConsentScriptOptions, type UseConsentScriptResult, useConsentScript, } from './hooks/use-consent-script';
 export { useFocusTrap } from './hooks/use-focus-trap';
 export { type HeadlessConsentBannerAction, type HeadlessConsentBannerState, type HeadlessConsentDialogAction, type HeadlessConsentDialogState, type HeadlessConsentSurface, type HeadlessConsentSurfaceAction, type HeadlessConsentSurfaceState, type HeadlessConsentWriteAction, type UseHeadlessConsentUIResult, useHeadlessConsentUI, } from './hooks/use-headless-consent-ui';
 export { useTranslations } from './hooks/use-translations';

package/dist-types/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export * from './use-component-config';
 export * from './use-consent-dialog-trigger';
 export * from './use-consent-manager';
+export * from './use-consent-script';
 export * from './use-focus-trap';
 export * from './use-headless-consent-ui';
 export * from './use-headless-iab-consent-ui';

package/dist-types/hooks/use-consent-script.d.ts

@@ -0,0 +1,80 @@
+import type { Script } from 'c15t';
+export type ConsentScriptStatus = 'idle' | 'blocked' | 'loading' | 'ready' | 'error';
+export type ConsentScriptUnmountBehavior = 'keep' | 'remove';
+export declare class ConsentScriptConflictError extends Error {
+    readonly scriptId: string;
+    constructor(scriptId: string);
+}
+export interface ConsentScriptReadyControls<TReady> {
+    resolve: (value: TReady) => void;
+    reject: (error: Error) => void;
+}
+export interface UseConsentScriptOptions<TReady = unknown> {
+    /**
+     * Script configuration registered with c15t's script manager.
+     */
+    script: Script;
+    /**
+     * Whether this hook should register the script.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Returns the SDK object when it is already available.
+     */
+    resolveReady?: () => TReady | false | null | undefined;
+    /**
+     * Registers callback-based SDK readiness, such as `callback=` query params.
+     * The returned cleanup function runs after readiness settles or the registry
+     * entry is released.
+     */
+    registerReadyCallback?: (controls: ConsentScriptReadyControls<TReady>) => undefined | (() => void);
+    /**
+     * Semantic key for the SDK readiness contract shared by this script id.
+     *
+     * Consumers of the same script id must use the same key. Set this when the
+     * readiness callbacks are configured differently from the script itself.
+     *
+     * @default script.id
+     */
+    readinessKey?: string;
+    /**
+     * Optional timeout for SDK readiness after the script is registered.
+     */
+    timeoutMs?: number;
+    /**
+     * Changing this value retries a failed registration with the same script id.
+     * Successful singleton registrations remain shared.
+     *
+     * @default 0
+     */
+    retryKey?: string | number;
+    /**
+     * Whether c15t should retain an owned script registration after the final
+     * hook consumer unmounts. Use `keep` for page-level singleton SDKs that
+     * cannot safely be loaded more than once.
+     *
+     * @default 'remove'
+     */
+    unmountBehavior?: ConsentScriptUnmountBehavior;
+}
+export interface UseConsentScriptResult<TReady = unknown> {
+    status: ConsentScriptStatus;
+    scriptId: string;
+    hasConsent: boolean;
+    scriptAppended: boolean;
+    readyValue: TReady | null;
+    error: Error | null;
+    ready: Promise<TReady> | null;
+}
+/**
+ * Registers a consent-gated script through c15t and exposes SDK readiness as a promise.
+ *
+ * @remarks
+ * Registrations are shared within one ConsentManagerProvider. The hook adopts
+ * compatible scripts already registered with that manager and never removes
+ * registrations it does not own. Inline script objects and callbacks are safe:
+ * lifecycle callbacks are read from the latest render without re-registering.
+ */
+export declare function useConsentScript<TReady = unknown>(options: UseConsentScriptOptions<TReady>): UseConsentScriptResult<TReady>;

package/dist-types/index.d.ts

@@ -4,13 +4,15 @@ export { ConsentBanner, type ConsentBannerProps, } from './components/consent-ba
 export * from './components/consent-banner/components';
 export { ConsentDialog, type ConsentDialogProps, } from './components/consent-dialog';
 export { ConsentDialogLink, type ConsentDialogLinkProps, } from './components/consent-dialog-link';
-export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, type ConsentDialogTriggerProps, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, type TriggerIconType, TriggerRoot, type TriggerRootProps, type TriggerSize, TriggerText, type TriggerTextProps, type TriggerVisibility, type UseDraggableOptions, type UseDraggableReturn, useDraggable, useTriggerContext, } from './components/consent-dialog-trigger';
+export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, type ConsentDialogTriggerProps, ConsentDialogTriggerToolbar, type ConsentDialogTriggerToolbarAction, type ConsentDialogTriggerToolbarPreferences, type ConsentDialogTriggerToolbarProps, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, type TriggerIconType, type TriggerOrientation, TriggerRoot, type TriggerRootProps, type TriggerSize, TriggerText, type TriggerTextProps, type TriggerVisibility, type UseDraggableOptions, type UseDraggableReturn, useDraggable, useTriggerContext, } from './components/consent-dialog-trigger';
 export { ConsentWidget, type ConsentWidgetProps, } from './components/consent-widget';
 export { Frame, type FrameProps } from './components/frame';
+export { GoogleMap, type GoogleMapCoordinates, type GoogleMapInstance, type GoogleMapOptions, type GoogleMapProps, type GoogleMapsApi, type GoogleMapsLibrary, YouTubeEmbed, type YouTubeEmbedParams, type YouTubeEmbedProps, type YouTubeSrcSource, type YouTubeVideoIdSource, } from './components/integrations';
 export { ConsentButton } from './components/shared/primitives/button';
 export { useColorScheme } from './hooks/use-color-scheme';
 export { type ConsentDialogTriggerVisibility, type UseConsentDialogTriggerOptions, type UseConsentDialogTriggerResult, useConsentDialogTrigger, } from './hooks/use-consent-dialog-trigger';
 export { useConsentManager } from './hooks/use-consent-manager';
+export { ConsentScriptConflictError, type ConsentScriptReadyControls, type ConsentScriptStatus, type ConsentScriptUnmountBehavior, type UseConsentScriptOptions, type UseConsentScriptResult, useConsentScript, } from './hooks/use-consent-script';
 export { useFocusTrap } from './hooks/use-focus-trap';
 export { type HeadlessConsentBannerAction, type HeadlessConsentBannerState, type HeadlessConsentDialogAction, type HeadlessConsentDialogState, type HeadlessConsentSurface, type HeadlessConsentSurfaceAction, type HeadlessConsentSurfaceState, type HeadlessConsentWriteAction, type UseHeadlessConsentUIResult, useHeadlessConsentUI, } from './hooks/use-headless-consent-ui';
 export { useSSRStatus } from './hooks/use-ssr-status';

package/dist-types/providers/consent-manager-provider.d.ts

@@ -37,4 +37,4 @@ export declare function clearConsentRuntimeCache(): void;
  *
  * @public
  */
-export declare function ConsentManagerProvider({ children, options, }: ConsentManagerProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConsentManagerProvider({ children, options, }: ConsentManagerProviderProps): import("react").JSX.Element;

package/dist-types/server/headers.d.ts

@@ -1,4 +1,4 @@
-declare const FORWARDED_HEADERS: readonly ["cf-ipcountry", "x-vercel-ip-country", "x-amz-cf-ipcountry", "x-country-code", "x-vercel-ip-country-region", "x-region-code", "accept-language", "user-agent", "x-forwarded-host", "x-forwarded-for", "sec-gpc", "purpose", "sec-purpose", "next-router-prefetch", "x-middleware-prefetch"];
+declare const FORWARDED_HEADERS: readonly ["cf-ipcountry", "x-vercel-ip-country", "x-amz-cf-ipcountry", "x-country-code", "x-vercel-ip-country-region", "x-region-code", "x-c15t-version", "accept-language", "user-agent", "x-forwarded-host", "x-forwarded-for", "sec-gpc", "purpose", "sec-purpose", "next-router-prefetch", "x-middleware-prefetch"];
 type ForwardedHeader = (typeof FORWARDED_HEADERS)[number] | 'x-c15t-country' | 'x-c15t-region';
 type RelevantHeaders = Partial<Record<ForwardedHeader, string>>;
 /**

package/dist-types/utils/theme-utils.d.ts

@@ -7,7 +7,7 @@ import type { Theme } from '../types/theme/style-types';
 /**
  * Default design tokens for the v2 theme system.
  */
-export declare const defaultTheme: Required<Omit<Theme, "slots">>;
+export declare const defaultTheme: Required<Omit<Theme, 'slots'>>;
 /**
  * Maps theme tokens to CSS variables.
  */

package/dist-types/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.0.4";
+export declare const version = "2.2.0-canary-20260727202135";

package/docs/README.md

@@ -1,76 +1,155 @@
-# c15t React Docs
-
-React-focused c15t docs for consent UI, hooks, headless flows, and script integrations.
-
-If you are changing consent flows, consent UI, script loading, server-side setup, or backend configuration in an app that uses this package, start here before editing code.
-
-## Start Here
-
-- [Quickstart](./quickstart.md)
-- [Headless](./headless.md)
-- [Building Headless Components](./building-headless-components.md)
-- [Callbacks](./callbacks.md)
-- [Google Tag Manager](./integrations/google-tag-manager.md)
-
-## Workflow Rules
-
-### Styling
-
-Use this when:
-- customizing component appearance
-- adapting c15t components to a design system
-- deciding how far to override the default UI
-
-Prefer:
-- Prefer design tokens first.
-- If tokens are not enough, use component slots.
-- Then use CSS variables or `className` for targeted overrides.
-
-If that is not enough:
-- Use `noStyle` or a full headless rebuild only when the design system cannot be expressed through the supported styling layers.
-
-Avoid:
-- Do not rebuild the consent UI from scratch if tokens, slots, or scoped overrides are sufficient.
-
-Read next:
-- [Overview](./styling/overview.md)
-- [Tokens](./styling/tokens.md)
-- [Slots](./styling/slots.md)
-- [Css Variables](./styling/css-variables.md)
-
-### Consent UI Customization
-
-Use this when:
-- changing banners, dialogs, or preference centers
-- deciding between built-in components and headless APIs
-
-Prefer:
-- Prefer the built-in components and their documented customization surfaces first.
-- If the UI requirements diverge significantly, use the headless APIs.
-
-Avoid:
-- Do not rebuild the full consent flow if a token, slot, or component override is enough.
-
-Read next:
-- [Quickstart](./quickstart.md)
-- [Consent Banner](./components/consent-banner.md)
-- [Headless](./headless.md)
-- [Building Headless Components](./building-headless-components.md)
-
-### Scripts & Integrations
-
-Use this when:
-- adding third-party scripts in React components or providers
-- wiring analytics or advertising behind consent
-
-Prefer:
-- Prefer premade scripts from `@c15t/scripts/*`.
-- Start from the integration docs before implementing custom script wiring in React components.
-
-Avoid:
-- Do not duplicate consent-sync logic in React effects when the integration already handles it.
-
-Read next:
-- [Script Loader](./script-loader.md)
-- [Google Tag Manager](./integrations/google-tag-manager.md)
-- [Meta Pixel](./integrations/meta-pixel.md)
+# @c15t/react
+
+> React consent management docs for c15t, including consent UI, hooks, styling, script loading, and integrations.
+
+These docs ship inside the package so coding agents can read them offline. Open the topic file you need from the list below — paths are relative to this file.
+
+## Frameworks
+
+Install and configure c15t in JavaScript, React, and Next.js applications.
+
+- [Building Headless Components](./frameworks/react/building-headless-components.md): Build policy-aware custom consent components in React using the headless hooks and policy-pack tooling.
+- [Callbacks](./frameworks/react/callbacks.md): React to consent lifecycle events - initialization, consent changes, errors, and revocation reloads.
+- [ConsentBanner](./frameworks/react/components/consent-banner.md): A pre-built consent banner that appears when user consent is needed. Supports policy-aware layout, theming, and advanced composition when markup must change.
+- [ConsentDialog](./frameworks/react/components/consent-dialog.md): A modal dialog where users can toggle individual consent categories.
+- [ConsentDialogLink](./frameworks/react/components/consent-dialog-link.md): An inline trigger for opening the consent dialog from footers, legal pages, and account settings.
+- [ConsentDialogTrigger](./frameworks/react/components/consent-dialog-trigger.md): A floating, draggable button that lets users re-open the consent dialog at any time.
+- [ConsentManagerProvider](./frameworks/react/components/consent-manager-provider.md): The root provider component that initializes the consent system and makes consent state available to all child components.
+- [ConsentWidget](./frameworks/react/components/consent-widget.md): An inline consent management widget for embedding in settings or privacy pages. Shows category toggles with accordion layout.
+- [DevTools](./frameworks/react/components/dev-tools.md): A development tool for inspecting consent state, geolocation, loaded scripts, and consent events in real time.
+- [Frame](./frameworks/react/components/frame.md): A consent-gated content wrapper - children only mount when the required consent category is granted.
+- [Client Modes](./frameworks/react/concepts/client-modes.md): Choose how c15t connects to its backend - full hosted integration, offline-only, or bring your own backend.
+- [Consent Categories](./frameworks/react/concepts/consent-categories.md): How c15t organizes tracking technologies into five consent categories.
+- [Consent Models](./frameworks/react/concepts/consent-models.md): How c15t determines consent behavior based on legal jurisdiction.
+- [Cookie Management](./frameworks/react/concepts/cookie-management.md): How c15t manages cookies through script, iframe, and network gating
+- [Glossary](./frameworks/react/concepts/glossary.md): Key terms used throughout the c15t documentation.
+- [Initialization Flow](./frameworks/react/concepts/initialization-flow.md): What happens from provider mount to first render — the full consent lifecycle.
+- [Policy Packs](./frameworks/react/concepts/policy-packs.md): How c15t resolves regional consent policies and what a policy pack controls.
+- [Headless Mode](./frameworks/react/headless.md): Build fully custom consent UI using only hooks - no pre-built components required.
+- [useColorScheme](./frameworks/react/hooks/use-color-scheme.md): Manage light/dark mode preferences for consent components.
+- [Checking Consent](./frameworks/react/hooks/use-consent-manager/checking-consent.md): Use has() for flexible consent checks with AND, OR, and NOT logic. Check if any consent exists with hasConsented().
+- [Location Info](./frameworks/react/hooks/use-consent-manager/location-info.md): Access detected jurisdiction, country, and region. Override geolocation for testing.
+- [useConsentManager](./frameworks/react/hooks/use-consent-manager/overview.md): The primary hook for accessing consent state and actions. Returns the full consent store including all state properties and action methods.
+- [Setting Consent](./frameworks/react/hooks/use-consent-manager/setting-consent.md): Save, update, and reset consent preferences with setConsent(), setSelectedConsent(), and saveConsents().
+- [useDraggable](./frameworks/react/hooks/use-draggable.md): Make an element draggable between viewport corners with snapping, persistence, and animation support.
+- [useFocusTrap](./frameworks/react/hooks/use-focus-trap.md): Trap keyboard focus within a container for accessible modal dialogs.
+- [useReducedMotion](./frameworks/react/hooks/use-reduced-motion.md): Detect the user's prefers-reduced-motion OS setting and reactively disable animations.
+- [useSSRStatus](./frameworks/react/hooks/use-ssr-status.md): Check whether server-side rendered consent data was used during initialization.
+- [useTextDirection](./frameworks/react/hooks/use-text-direction.md): Manage RTL/LTR text direction based on the active language for consent UI.
+- [useTranslations](./frameworks/react/hooks/use-translations.md): Access the current language's translations for building custom consent UI.
+- [IABConsentBanner](./frameworks/react/iab/consent-banner.md): An IAB TCF 2.3 compliant consent banner that displays partner count, purpose summaries, and legitimate interest notices.
+- [IABConsentDialog](./frameworks/react/iab/consent-dialog.md): An IAB TCF 2.3 compliant preference center with tabbed purpose and vendor management.
+- [IAB TCF 2.3](./frameworks/react/iab/overview.md): Implement IAB Transparency & Consent Framework 2.3 compliance for programmatic advertising in EU/EEA jurisdictions.
+- [useGVLData (Internal)](./frameworks/react/iab/use-gvl-data.md): Status note for the internal GVL hook used by the built-in IAB dialog.
+- [Iframe Blocking](./frameworks/react/iframe-blocking.md): Block embedded content (YouTube, social widgets, maps) until users grant consent for the appropriate category.
+- [Internationalization](./frameworks/react/internationalization.md): Translate consent UI into 30+ languages with built-in translations, custom overrides, and automatic browser language detection.
+- [Network Blocker](./frameworks/react/network-blocker.md): Block outgoing network requests to third-party domains until the user grants consent for the appropriate category.
+- [Optimization](./frameworks/react/optimization.md): Improve c15t startup performance in React with prefetching, proxy rewrites, and rendering tradeoffs.
+- [Policy Packs](./frameworks/react/policy-packs.md): Configure regional consent policies in React — hosted mode, presets, and offline fallback.
+- [Quickstart](./frameworks/react/quickstart.md): Add consent management to your React app in under 5 minutes.
+- [Script Loader](./frameworks/react/script-loader.md): Gate third-party scripts behind consent in React — load Google Analytics, Meta Pixel, and other tracking scripts only when users grant permission.
+- [Server-Side Utilities](./frameworks/react/server-side.md): Fetch consent data on the server for SSR hydration — eliminate the loading flash and improve performance.
+- [Class Names](./frameworks/react/styling/classnames.md): Style consent components using className props and per-slot className targeting via the theme.
+- [Color Scheme](./frameworks/react/styling/color-scheme.md): Support light mode, dark mode, and system preference detection in consent components.
+- [CSS Variables](./frameworks/react/styling/css-variables.md): Reference for all --c15t-* CSS custom properties generated by the theme system.
+- [Styling Overview](./frameworks/react/styling/overview.md): Customize every aspect of c15t's consent components using design tokens, component slots, and CSS variables.
+- [Component Slots](./frameworks/react/styling/slots.md): Target individual component parts with styles using the slot system - className strings or inline style objects.
+- [Tailwind CSS](./frameworks/react/styling/tailwind.md): Use Tailwind CSS utility classes to style consent components via the slot system.
+- [Design Tokens](./frameworks/react/styling/tokens.md): The six base token categories that control colors, typography, spacing, radius, shadows, and motion, plus optional dark-mode overrides.
+- [Troubleshooting](./frameworks/react/troubleshooting.md): Solutions for common issues with @c15t/react — provider errors, missing banners, consent persistence, and more.
+
+## Integrations
+
+Connect analytics, advertising, maps, media, and other third-party tools behind consent.
+
+- [Adobe Analytics](./integrations/adobe-analytics.md): Adobe Analytics loaded through an Adobe Experience Platform Data Collection Tags embed URL.
+- [Ahrefs Analytics](./integrations/ahrefs-analytics.md): Cookieless web analytics from Ahrefs with a prebuilt helper that wires the project key into a c15t-managed script.
+- [Amplitude](./integrations/amplitude.md): Load Amplitude Browser SDK 2 with c15t and gate product analytics behind measurement consent.
+- [Build a Custom Script Integration](./integrations/building-integrations.md): Learn when to use a raw Script, when to build a reusable manifest-backed integration, and how to debug and test custom consent-aware scripts in c15t.
+- [Clearbit](./integrations/clearbit.md): Visitor and company enrichment loaded with Clearbit's account-keyed tags.js snippet.
+- [Cloudflare Web Analytics](./integrations/cloudflare-web-analytics.md): Cookieless analytics from Cloudflare with a prebuilt helper that serializes the beacon config into the `data-cf-beacon` attribute.
+- [Crisp](./integrations/crisp.md): Load Crisp live chat with website ID, runtime, cookie, and session options.
+- [Databuddy](./integrations/databuddy.md): Databuddy is a privacy-focused analytics platform that helps you understand user behavior and track events. It supports cookieless tracking and manages consent automatically through c15t's consent state synchronization.
+- [Fathom Analytics](./integrations/fathom-analytics.md): Privacy-friendly cookieless analytics with a prebuilt helper that maps Fathom's data attributes into a c15t-managed script.
+- [Google Maps](./integrations/google-maps.md): Render Google Maps only after consent with one shared Maps JavaScript API loader and independently managed map instances.
+- [GA4 + Google Ads (gtag.js)](./integrations/google-tag.md): Send data to Google Analytics 4 and Google Ads with automatic Consent Mode v2 support.
+- [Google Tag Manager](./integrations/google-tag-manager.md): Deploy and manage marketing tags centrally with automatic consent state synchronization.
+- [Heap](./integrations/heap.md): Load Heap with c15t and gate autocapture product analytics behind measurement consent.
+- [Hightouch](./integrations/hightouch.md): Load Hightouch Events with c15t and gate the browser SDK behind measurement consent.
+- [Hotjar](./integrations/hotjar.md): Product analytics and behavior insights with a prebuilt helper that seeds Hotjar globals before loading the vendor bundle.
+- [Intercom](./integrations/intercom.md): Bootstrap Intercom settings and load the messenger widget bundle.
+- [LinkedIn Insights](./integrations/linkedin-insights.md): Track conversions and build matched audiences for LinkedIn advertising campaigns.
+- [LogRocket](./integrations/logrocket.md): Session replay and monitoring loaded after measurement consent with LogRocket's browser SDK.
+- [Matomo Analytics](./integrations/matomo-analytics.md): Load Matomo with c15t and keep Matomo's queue aligned with measurement consent.
+- [Meta Pixel](./integrations/meta-pixel.md): Track conversions and build audiences for Facebook and Instagram advertising campaigns.
+- [Microsoft Clarity](./integrations/microsoft-clarity.md): Session replay and behavior analytics with a prebuilt helper that keeps Clarity consent synchronized with c15t measurement state.
+- [Microsoft UET](./integrations/microsoft-uet.md): Track conversions and measure performance for Microsoft Advertising and Bing Ads.
+- [Mixpanel Analytics](./integrations/mixpanel-analytics.md): Load Mixpanel with c15t and let Mixpanel's own opt-in and opt-out APIs follow measurement consent.
+- [Integrations](./integrations/overview.md): Load analytics, pixels, tag managers, and widgets through c15t so consent state controls when they run, update, and appear in your consent UI.
+- [Pirsch](./integrations/pirsch.md): Privacy-friendly, cookieless analytics loaded with Pirsch's fixed script id and identification-code attributes.
+- [Plausible Analytics](./integrations/plausible-analytics.md): Privacy-friendly cookieless analytics with a prebuilt helper that preserves Plausible's queue bootstrap and loader attributes.
+- [PostHog](./integrations/posthog.md): PostHog is an open-source product analytics platform for tracking user behavior, session replays, feature flags, and A/B testing. It supports cookieless tracking, allowing analytics to continue even without cookie consent.
+- [Promptwatch](./integrations/promptwatch.md): Promptwatch analyzes traffic on your site for Artificial Intelligence (AI) traffic and usage insights. Data is stored in the EU without user-identifiable information.
+- [Reddit Pixel](./integrations/reddit-pixel.md): Track conversions and build retargeting audiences for Reddit advertising campaigns.
+- [RudderStack](./integrations/rudderstack.md): Load RudderStack's JavaScript SDK with c15t and gate the browser SDK behind measurement consent.
+- [Rybbit Analytics](./integrations/rybbit-analytics.md): Privacy-friendly analytics with script-tag configuration via Rybbit's data attributes.
+- [Segment](./integrations/segment.md): Load Segment Analytics.js with c15t and gate it behind measurement consent.
+- [Snapchat Pixel](./integrations/snapchat-pixel.md): Measure Snapchat ad performance and build remarketing audiences with a prebuilt pixel helper.
+- [TikTok Pixel](./integrations/tiktok-pixel.md): Measure ad performance and build audiences for TikTok advertising campaigns.
+- [Umami Analytics](./integrations/umami-analytics.md): Open-source, cookieless analytics with a prebuilt helper that maps Umami's data attributes into a c15t-managed script.
+- [Vercel Analytics](./integrations/vercel-analytics.md): Bootstrap Vercel Analytics with a declarative queue and script attributes.
+- [X Pixel (Twitter Pixel)](./integrations/x-pixel.md): Track conversions and build audiences for advertising campaigns on X (formerly Twitter).
+- [YouTube](./integrations/youtube.md): Keep YouTube iframes unmounted until consent with a privacy-enhanced, lazy-loaded React or Next.js embed.
+
+## Reference
+
+Concepts, legal templates, open-source policies, and contributor documentation.
+
+- [Client Modes](./shared/concepts/client-modes.md): Reference page for client modes.
+- [Consent Categories](./shared/concepts/consent-categories.md): Reference page for consent categories.
+- [Consent Models](./shared/concepts/consent-models.md): Reference page for consent models.
+- [Cookie Management](./shared/concepts/cookie-management.md): Reference page for cookie management.
+- [Glossary](./shared/concepts/glossary.md): Reference page for glossary.
+- [Initialization Flow](./shared/concepts/initialization-flow.md): Reference page for initialization flow.
+- [Policy Packs](./shared/concepts/policy-packs.md): Reference page for policy packs.
+- [Consent Banner](./shared/react/components/consent-banner.md): Reference page for consent banner.
+- [Consent Dialog](./shared/react/components/consent-dialog.md): Reference page for consent dialog.
+- [Consent Dialog Link](./shared/react/components/consent-dialog-link.md): Reference page for consent dialog link.
+- [Consent Dialog Trigger](./shared/react/components/consent-dialog-trigger.md): Reference page for consent dialog trigger.
+- [Consent Manager Provider](./shared/react/components/consent-manager-provider.md): Reference page for consent manager provider.
+- [Consent Widget](./shared/react/components/consent-widget.md): Reference page for consent widget.
+- [Dev Tools](./shared/react/components/dev-tools.md): Reference page for dev tools.
+- [Frame](./shared/react/components/frame.md): Reference page for frame.
+- [Building Headless Components](./shared/react/guides/building-headless-components.md): Reference page for building headless components.
+- [Callbacks](./shared/react/guides/callbacks.md): Reference page for callbacks.
+- [Headless](./shared/react/guides/headless.md): Reference page for headless.
+- [Iframe Blocking](./shared/react/guides/iframe-blocking.md): Reference page for iframe blocking.
+- [Internationalization](./shared/react/guides/internationalization.md): Reference page for internationalization.
+- [Network Blocker](./shared/react/guides/network-blocker.md): Reference page for network blocker.
+- [Optimization](./shared/react/guides/optimization.md): Reference page for optimization.
+- [Policy Packs](./shared/react/guides/policy-packs.md): Reference page for policy packs.
+- [Script Loader](./shared/react/guides/script-loader.md): Reference page for script loader.
+- [Use Color Scheme](./shared/react/hooks/use-color-scheme.md): Reference page for use color scheme.
+- [Checking Consent](./shared/react/hooks/use-consent-manager/checking-consent.md): Reference page for checking consent.
+- [Location Info](./shared/react/hooks/use-consent-manager/location-info.md): Reference page for location info.
+- [Overview](./shared/react/hooks/use-consent-manager/overview.md): Reference page for overview.
+- [Setting Consent](./shared/react/hooks/use-consent-manager/setting-consent.md): Reference page for setting consent.
+- [Use Draggable](./shared/react/hooks/use-draggable.md): Reference page for use draggable.
+- [Use Focus Trap](./shared/react/hooks/use-focus-trap.md): Reference page for use focus trap.
+- [Use Reduced Motion](./shared/react/hooks/use-reduced-motion.md): Reference page for use reduced motion.
+- [Use SSR Status](./shared/react/hooks/use-ssr-status.md): Reference page for use ssr status.
+- [Use Text Direction](./shared/react/hooks/use-text-direction.md): Reference page for use text direction.
+- [Use Translations](./shared/react/hooks/use-translations.md): Reference page for use translations.
+- [Consent Banner](./shared/react/iab/consent-banner.md): Reference page for consent banner.
+- [Consent Dialog](./shared/react/iab/consent-dialog.md): Reference page for consent dialog.
+- [Overview](./shared/react/iab/overview.md): Reference page for overview.
+- [Use GVL Data](./shared/react/iab/use-gvl-data.md): Reference page for use gvl data.
+- [Classnames](./shared/react/styling/classnames.md): Reference page for classnames.
+- [Color Scheme](./shared/react/styling/color-scheme.md): Reference page for color scheme.
+- [CSS Variables](./shared/react/styling/css-variables.md): Reference page for css variables.
+- [Overview](./shared/react/styling/overview.md): Reference page for overview.
+- [Slots](./shared/react/styling/slots.md): Reference page for slots.
+- [Stylesheet Entrypoint](./shared/react/styling/stylesheet-entrypoint.md): Reference page for stylesheet entrypoint.
+- [Tailwind](./shared/react/styling/tailwind.md): Reference page for tailwind.
+- [Tokens](./shared/react/styling/tokens.md): Reference page for tokens.
+- [Troubleshooting](./shared/troubleshooting.md): Reference page for troubleshooting.

package/docs/{building-headless-components.md → frameworks/react/building-headless-components.md}

@@ -1,6 +1,8 @@
 ---
 title: Building Headless Components
-description: Build policy-aware custom consent components in React using the headless hooks and policy-pack tooling.
+description: Build policy-aware custom consent components in React using the
+  headless hooks and policy-pack tooling.
+group: frameworks
 ---
 Building custom consent UI is easier now because c15t exposes multiple layers of policy-aware primitives instead of forcing you to reconstruct banner rules by hand.
 

package/docs/{callbacks.md → frameworks/react/callbacks.md}

@@ -1,6 +1,8 @@
 ---
 title: Callbacks
-description: React to consent lifecycle events - initialization, consent changes, errors, and revocation reloads.
+description: React to consent lifecycle events - initialization, consent
+  changes, errors, and revocation reloads.
+group: frameworks
 ---
 Callbacks let you run custom code at key points in the consent lifecycle. Define them in the provider or runtime `callbacks` option, or register them dynamically after initialization.
 

package/docs/{components → frameworks/react/components}/consent-banner.md

@@ -1,6 +1,9 @@
 ---
 title: ConsentBanner
-description: A pre-built consent banner that appears when user consent is needed. Supports policy-aware layout, theming, and advanced composition when markup must change.
+description: A pre-built consent banner that appears when user consent is
+  needed. Supports policy-aware layout, theming, and advanced composition when
+  markup must change.
+group: frameworks
 ---
 `ConsentBanner` is a ready-to-use consent banner that appears automatically in **opt-in jurisdictions** (like GDPR) where explicit consent is required before tracking. In opt-out jurisdictions (like CCPA), the banner won't appear — users get an opt-out mechanism instead. It includes reject, accept, and customize buttons with configurable layout.
 
@@ -247,23 +250,9 @@ If you only need styling changes, stay with tokens and slots instead of rebuildi
 
 ## Props
 
-### ConsentBannerProps
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|noStyle|boolean \|undefined|When true, removes all default styling from the component|false|Optional|
-|title|ReactNode|Content to display as the banner's title|undefined|Optional|
-|description|ReactNode|Content to display as the banner's description|undefined|Optional|
-|rejectButtonText|ReactNode|Content to display on the reject button|undefined|Optional|
-|customizeButtonText|ReactNode|Content to display on the customize button|undefined|Optional|
-|acceptButtonText|ReactNode|Content to display on the accept button|undefined|Optional|
-|scrollLock|boolean \|undefined|When true, the consent banner will lock the scroll of the page|false|Optional|
-|trapFocus|boolean \|undefined|When true, the consent banner will trap focus|true|Optional|
-|disableAnimation|boolean \|undefined|When true, disables the entrance/exit animations|false|Optional|
-|legalLinks|(keyof LegalLinksTranslations)\[] \|null \|undefined|Controls which legal links to display. Options: \`undefined\` (default): Shows all available legal links; \`null\`: Explicitly hides all legal links; Array of keys: Shows only the specified legal links|-|Optional|
-|hideBranding|boolean \|undefined|When true, hides the branding tag on the banner.|false|Optional|
-|layout|ConsentBannerLayout \|undefined|Defines the layout of buttons in the footer. Allows reordering and grouping of buttons.|-|Optional|
-|direction|PolicyUiActionDirection \|undefined|Defines how footer button groups flow.|-|Optional|
-|primaryButton|ConsentBannerButton \|undefined|Specifies which button(s) should be highlighted as the primary action.|-|Optional|
-|models|Model \|undefined|Which consent models this banner responds to.|\['opt-in']|Optional|
-|uiSource|string \|undefined|Override the UI source identifier sent with consent API calls.|'banner'|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentBannerProps\`|
+|Source Path|\`./packages/react/src/components/consent-banner/consent-banner.tsx\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentBannerProps" from "./packages/react/src/components/consent-banner/consent-banner.tsx" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*

package/docs/{components → frameworks/react/components}/consent-dialog-link.md

@@ -1,6 +1,8 @@
 ---
 title: ConsentDialogLink
-description: An inline trigger for opening the consent dialog from footers, legal pages, and account settings.
+description: An inline trigger for opening the consent dialog from footers,
+  legal pages, and account settings.
+group: frameworks
 ---
 `ConsentDialogLink` is an inline trigger for opening the consent dialog from places like site footers, legal pages, or account settings. It is unstyled by default, so it inherits your app's typography and link/button styles.
 
@@ -52,8 +54,9 @@ The component defaults to `noStyle={true}`. Set it to `false` if you want c15t b
 
 ## Props
 
-### ConsentDialogLinkProps
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogLinkProps\`|
+|Source Path|\`./packages/react/src/components/consent-preferences-link/consent-preferences-link.tsx\`|
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|children|ReactNode|Custom trigger content, for example "Your privacy settings" or "Manage preferences".|-|✅ Required|
+\*ExtractedTypeTable: Could not extract "ConsentDialogLinkProps" from "./packages/react/src/components/consent-preferences-link/consent-preferences-link.tsx" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*