@c15t/nextjs 2.1.0 → 2.2.1

package/docs/README.md

@@ -1,73 +1,155 @@
-# c15t Next.js Docs
-
-Next.js-focused c15t docs for consent UI, server-side behavior, callbacks, and 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)
-- [Server Side](./server-side.md)
-- [Callbacks](./callbacks.md)
-- [Script Loader](./script-loader.md)
-- [Google Tag Manager](./integrations/google-tag-manager.md)
-
-## Workflow Rules
-
-### Server-Side Setup
-
-Use this when:
-- working on App Router or SSR consent initialization
-- connecting the provider to server-fetched consent data
-- deciding whether client-only setup is sufficient
-
-Prefer:
-- Prefer the documented server helpers and provider setup.
-- Use the server-side integration path before inventing custom cookie or init plumbing.
-
-Avoid:
-- Do not default to client-only initialization when the documented SSR flow already covers the use case.
-
-Read next:
-- [Quickstart](./quickstart.md)
-- [Server Side](./server-side.md)
-
-### Styling
-
-Use this when:
-- customizing component appearance in a Next.js app
-- deciding how to override the default consent 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 headless only as a last resort.
-
-Avoid:
-- Do not rebuild the consent UI if the documented styling layers can express the design.
-
-Read next:
-- [Overview](./styling/overview.md)
-- [Tokens](./styling/tokens.md)
-- [Slots](./styling/slots.md)
-
-### Scripts & Integrations
-
-Use this when:
-- wiring scripts through Next.js routes, layouts, or providers
-- adding analytics or advertising behind consent
-
-Prefer:
-- Prefer premade scripts from `@c15t/scripts/*`.
-- Start from the integration docs before wiring scripts through Next-specific code paths.
-
-Avoid:
-- Do not use custom script injection when a documented integration already exists.
-
-Read next:
-- [Script Loader](./script-loader.md)
-- [Google Tag Manager](./integrations/google-tag-manager.md)
-- [Meta Pixel](./integrations/meta-pixel.md)
+# @c15t/nextjs
+
+> Next.js consent management docs for c15t, including App Router setup, consent UI, SSR behavior, 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/next/building-headless-components.md): Build policy-aware custom consent components in Next.js using the headless hooks and policy-pack tooling.
+- [Callbacks](./frameworks/next/callbacks.md): React to consent lifecycle events - initialization, consent changes, errors, and revocation reloads.
+- [ConsentBanner](./frameworks/next/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/next/components/consent-dialog.md): A modal dialog where users can toggle individual consent categories.
+- [ConsentDialogLink](./frameworks/next/components/consent-dialog-link.md): An inline trigger for opening the consent dialog from footers, legal pages, and account settings.
+- [ConsentDialogTrigger](./frameworks/next/components/consent-dialog-trigger.md): A floating, draggable button that lets users re-open the consent dialog at any time.
+- [ConsentManagerProvider](./frameworks/next/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/next/components/consent-widget.md): An inline consent management widget for embedding in settings or privacy pages. Shows category toggles with accordion layout.
+- [DevTools](./frameworks/next/components/dev-tools.md): A development tool for inspecting consent state, geolocation, loaded scripts, and consent events in real time.
+- [Frame](./frameworks/next/components/frame.md): A consent-gated content wrapper - children only mount when the required consent category is granted.
+- [Client Modes](./frameworks/next/concepts/client-modes.md): Choose how c15t connects to its backend - full hosted integration, offline-only, or bring your own backend.
+- [Consent Categories](./frameworks/next/concepts/consent-categories.md): How c15t organizes tracking technologies into five consent categories.
+- [Consent Models](./frameworks/next/concepts/consent-models.md): How c15t determines consent behavior based on legal jurisdiction.
+- [Cookie Management](./frameworks/next/concepts/cookie-management.md): How c15t manages cookies through script, iframe, and network gating
+- [Glossary](./frameworks/next/concepts/glossary.md): Key terms used throughout the c15t documentation.
+- [Initialization Flow](./frameworks/next/concepts/initialization-flow.md): What happens from provider mount to first render — the full consent lifecycle.
+- [Policy Packs](./frameworks/next/concepts/policy-packs.md): How c15t resolves regional consent policies and what a policy pack controls.
+- [Headless Mode](./frameworks/next/headless.md): Build fully custom consent UI using only hooks - no pre-built components required.
+- [useColorScheme](./frameworks/next/hooks/use-color-scheme.md): Manage light/dark mode preferences for consent components.
+- [Checking Consent](./frameworks/next/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/next/hooks/use-consent-manager/location-info.md): Access detected jurisdiction, country, and region. Override geolocation for testing.
+- [useConsentManager](./frameworks/next/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/next/hooks/use-consent-manager/setting-consent.md): Save, update, and reset consent preferences with setConsent(), setSelectedConsent(), and saveConsents().
+- [useDraggable](./frameworks/next/hooks/use-draggable.md): Make an element draggable between viewport corners with snapping, persistence, and animation support.
+- [useFocusTrap](./frameworks/next/hooks/use-focus-trap.md): Trap keyboard focus within a container for accessible modal dialogs.
+- [useReducedMotion](./frameworks/next/hooks/use-reduced-motion.md): Detect the user's prefers-reduced-motion OS setting and reactively disable animations.
+- [useSSRStatus](./frameworks/next/hooks/use-ssr-status.md): Check whether server-side rendered consent data was used during initialization.
+- [useTextDirection](./frameworks/next/hooks/use-text-direction.md): Manage RTL/LTR text direction based on the active language for consent UI.
+- [useTranslations](./frameworks/next/hooks/use-translations.md): Access the current language's translations for building custom consent UI.
+- [IABConsentBanner](./frameworks/next/iab/consent-banner.md): An IAB TCF 2.3 compliant consent banner that displays partner count, purpose summaries, and legitimate interest notices.
+- [IABConsentDialog](./frameworks/next/iab/consent-dialog.md): An IAB TCF 2.3 compliant preference center with tabbed purpose and vendor management.
+- [IAB TCF 2.3](./frameworks/next/iab/overview.md): Implement IAB Transparency & Consent Framework 2.3 compliance for programmatic advertising in EU/EEA jurisdictions.
+- [useGVLData (Internal)](./frameworks/next/iab/use-gvl-data.md): Status note for the internal GVL hook used by the built-in IAB dialog.
+- [Iframe Blocking](./frameworks/next/iframe-blocking.md): Block embedded content (YouTube, social widgets, maps) until users grant consent for the appropriate category.
+- [Internationalization](./frameworks/next/internationalization.md): Translate consent UI into 30+ languages with built-in translations, custom overrides, and automatic browser language detection.
+- [Network Blocker](./frameworks/next/network-blocker.md): Block outgoing network requests to third-party domains until the user grants consent for the appropriate category.
+- [Optimization](./frameworks/next/optimization.md): Improve c15t startup performance in Next.js with same-origin rewrites, static prefetching, and dynamic-route SSR.
+- [Policy Packs](./frameworks/next/policy-packs.md): Configure regional consent policies in Next.js — hosted mode, presets, and offline fallback.
+- [Quickstart](./frameworks/next/quickstart.md): Add consent management to your Next.js app in under 5 minutes.
+- [Script Loader](./frameworks/next/script-loader.md): Gate third-party scripts behind consent in Next.js — load Google Analytics, Meta Pixel, and other tracking scripts only when users grant permission.
+- [Server-Side Data Fetching](./frameworks/next/server-side.md): Pre-fetch consent data in Server Components with fetchInitialData for dynamic Next.js routes.
+- [Class Names](./frameworks/next/styling/classnames.md): Style consent components using className props and per-slot className targeting via the theme.
+- [Color Scheme](./frameworks/next/styling/color-scheme.md): Support light mode, dark mode, and system preference detection in consent components.
+- [CSS Variables](./frameworks/next/styling/css-variables.md): Reference for all --c15t-* CSS custom properties generated by the theme system.
+- [Styling Overview](./frameworks/next/styling/overview.md): Five approaches for theming consent components — design tokens, component slots, CSS variables, className, and noStyle mode.
+- [Component Slots](./frameworks/next/styling/slots.md): Target individual component parts with styles using the slot system - className strings or inline style objects.
+- [Tailwind CSS](./frameworks/next/styling/tailwind.md): Use Tailwind CSS utility classes to style consent components via the slot system.
+- [Design Tokens](./frameworks/next/styling/tokens.md): The six base token categories that control colors, typography, spacing, radius, shadows, and motion, plus optional dark-mode overrides.
+- [Troubleshooting](./frameworks/next/troubleshooting.md): Solutions for common issues with @c15t/nextjs — 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/next/building-headless-components.md}

@@ -1,6 +1,8 @@
 ---
 title: Building Headless Components
-description: Build policy-aware custom consent components in Next.js using the headless hooks and policy-pack tooling.
+description: Build policy-aware custom consent components in Next.js 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/next/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/next/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/next/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.\*

package/docs/frameworks/next/components/consent-dialog-trigger.md

@@ -0,0 +1,202 @@
+---
+title: ConsentDialogTrigger
+description: A floating, draggable button that lets users re-open the consent
+  dialog at any time.
+group: frameworks
+---
+`ConsentDialogTrigger` is a floating button that opens the consent dialog when clicked. Users can drag it to any corner of the screen, and the position persists across sessions. Use it to give users a persistent way to manage their privacy settings.
+
+## Basic Usage
+
+Use standalone or via the `showTrigger` prop on `ConsentDialog`:
+
+```tsx
+import { ConsentDialogTrigger } from '@c15t/nextjs';
+
+// Standalone
+<ConsentDialogTrigger />
+
+// Via ConsentDialog
+<ConsentDialog showTrigger />
+```
+
+For inline footer links (instead of a floating button), use [`ConsentDialogLink`](/docs/frameworks/next/components/consent-dialog-link).
+
+## Icon Options
+
+```tsx
+{/* Built-in icons */}
+<ConsentDialogTrigger icon="branding" />    {/* c15t logo (default) */}
+<ConsentDialogTrigger icon="fingerprint" /> {/* Privacy icon */}
+<ConsentDialogTrigger icon="settings" />    {/* Gear icon */}
+
+{/* Custom icon */}
+<ConsentDialogTrigger icon={<MyCustomIcon />} />
+```
+
+## Configurable Toolbar
+
+Use the separate `ConsentDialogTriggerToolbar` when you want to place app-owned controls beside the privacy trigger. It always renders exactly one built-in action that opens consent preferences, so `actions` only contains controls your app owns.
+
+```tsx
+<ConsentDialogTriggerToolbar
+  ariaLabel="Site controls"
+  actions={[
+    {
+      id: 'theme',
+      label: isDark ? 'Switch to light theme' : 'Switch to dark theme',
+      icon: isDark ? <SunIcon /> : <MoonIcon />,
+      pressed: isDark,
+      onSelect: toggleColorScheme,
+    },
+    {
+      id: 'support',
+      label: 'Open support chat',
+      icon: <ChatIcon />,
+      onSelect: openSupportChat,
+    },
+  ]}
+  preferences={{
+    icon: 'fingerprint',
+    label: 'Manage privacy settings',
+  }}
+/>
+```
+
+Each custom action requires a stable `id`, accessible `label`, `icon`, and `onSelect` callback. Use `pressed` for toggle actions and `disabled` for unavailable actions. Your app remains responsible for state, integrations, and changing the icon or label. The preferences action automatically moves to the edge nearest the toolbar's snapped corner while custom actions keep their configured order.
+
+Toolbars are horizontal by default. Set `orientation="vertical"` to stack the actions and enable Up/Down arrow-key navigation:
+
+```tsx
+<ConsentDialogTriggerToolbar
+  orientation="vertical"
+  actions={toolbarActions}
+/>
+```
+
+### Toolbar Styling
+
+The toolbar follows the standard styling precedence: internal CSS module styles, provider theme slots, then direct component overrides. Use `className` and `style` on the toolbar, or on an individual action, and use `noStyle` for a fully custom implementation.
+
+```tsx
+<ConsentManagerProvider
+  options={{
+    theme: {
+      slots: {
+        consentDialogTriggerToolbar: 'my-toolbar',
+        consentDialogTriggerToolbarItem: 'my-toolbar-item',
+        consentDialogTriggerToolbarIcon: 'my-toolbar-icon',
+      },
+    },
+  }}
+>
+  <ConsentDialogTriggerToolbar
+    className="fixed-toolbar"
+    style={{ '--cdtt-offset': '24px' }}
+    actions={[
+      {
+        id: 'support',
+        label: 'Open support chat',
+        icon: <ChatIcon />,
+        onSelect: openSupportChat,
+        className: 'support-action',
+      },
+    ]}
+  />
+</ConsentManagerProvider>
+```
+
+Available toolbar theme slots are `consentDialogTriggerToolbar`, `consentDialogTriggerToolbarItem`, and `consentDialogTriggerToolbarIcon`.
+
+With `noStyle`, use `data-corner`, `data-dragging`, and `data-snapping` on the toolbar to style its current position and interaction state.
+
+## Visibility
+
+Control when the trigger is visible:
+
+```tsx
+{/* Always visible (default) */}
+<ConsentDialogTrigger showWhen="always" />
+
+{/* Only after user has made a consent choice */}
+<ConsentDialogTrigger showWhen="after-consent" />
+
+{/* Hidden (control visibility programmatically) */}
+<ConsentDialogTrigger showWhen="never" />
+```
+
+## Position
+
+Set the default corner and control persistence:
+
+```tsx
+<ConsentDialogTrigger
+  defaultPosition="bottom-left"
+  persistPosition={true} // Remembers user's drag position
+  onPositionChange={(position) => console.log('Moved to:', position)}
+/>
+```
+
+## Size
+
+```tsx
+<ConsentDialogTrigger size="sm" /> {/* Small */}
+<ConsentDialogTrigger size="md" /> {/* Medium (default) */}
+<ConsentDialogTrigger size="lg" /> {/* Large */}
+```
+
+## Compound Components
+
+Build fully custom trigger layouts using sub-components:
+
+```tsx
+<ConsentDialogTrigger.Root defaultPosition="bottom-right">
+  <ConsentDialogTrigger.Button size="md">
+    <ConsentDialogTrigger.Icon icon="settings" />
+    <ConsentDialogTrigger.Text>Privacy</ConsentDialogTrigger.Text>
+  </ConsentDialogTrigger.Button>
+</ConsentDialogTrigger.Root>
+```
+
+* `ConsentDialogTrigger.Root` — Portal wrapper with drag handling and position persistence
+* `ConsentDialogTrigger.Button` — Draggable button element with size variants
+* `ConsentDialogTrigger.Icon` — Icon display (branding, fingerprint, settings, or custom)
+* `ConsentDialogTrigger.Text` — Optional text label
+
+## Props
+
+### ConsentDialogTrigger
+
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogTriggerProps\`|
+|Source Path|\`./packages/react/src/components/consent-dialog-trigger/types.ts\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentDialogTriggerProps" from "./packages/react/src/components/consent-dialog-trigger/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+
+### ConsentDialogTriggerToolbar
+
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogTriggerToolbarProps\`|
+|Source Path|\`./packages/react/src/components/consent-dialog-trigger/types.ts\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentDialogTriggerToolbarProps" from "./packages/react/src/components/consent-dialog-trigger/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+
+### Toolbar Actions
+
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogTriggerToolbarAction\`|
+|Source Path|\`./packages/react/src/components/consent-dialog-trigger/types.ts\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentDialogTriggerToolbarAction" from "./packages/react/src/components/consent-dialog-trigger/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+
+### Preferences Action
+
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogTriggerToolbarPreferences\`|
+|Source Path|\`./packages/react/src/components/consent-dialog-trigger/types.ts\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentDialogTriggerToolbarPreferences" from "./packages/react/src/components/consent-dialog-trigger/types.ts" 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/next/components}/consent-dialog.md

@@ -1,6 +1,7 @@
 ---
 title: ConsentDialog
 description: A modal dialog where users can toggle individual consent categories.
+group: frameworks
 ---
 `ConsentDialog` is a modal that shows toggles for each consent category. In **opt-in jurisdictions**, it typically opens when users click "Customize" on `ConsentBanner`. It can also be controlled programmatically for use on settings pages regardless of jurisdiction.
 
@@ -160,18 +161,9 @@ If the stock dialog structure still works, prefer tokens, slots, and provider co
 
 ## Props
 
-### ConsentDialogProps
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|theme|undefined|Theme configuration override (deprecated)|-|Optional|
-|disableAnimation|boolean \|undefined|Disables all animations when true|-|Optional|
-|noStyle|boolean \|undefined|Removes default styles when true|-|Optional|
-|scrollLock|boolean \|undefined|Locks the scroll when true|-|Optional|
-|trapFocus|boolean \|undefined|Traps keyboard focus within a dialog when true|-|Optional|
-|open|boolean \|undefined|Control the open state. If omitted the dialog follows \`useConsentManager().activeUI === 'dialog'\`.|-|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|Controls whether to hide the branding in the dialog footer.|-|Optional|
-|showTrigger|ConsentDialogTriggerProps \|undefined|Show a floating trigger button to resurface the consent dialog. Useful for allowing users to re-open the dialog after dismissing. Options: \`true\` - Show trigger with default settings; \`false\` - Hide trigger (default); \`ConsentDialogTriggerProps\` - Show trigger with custom props|false|Optional|
-|models|Model \|undefined|Which consent models this dialog responds to.|\['opt-in', 'opt-out']|Optional|
-|uiSource|string \|undefined|Override the UI source identifier sent with consent API calls.|'dialog'|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`ConsentDialogProps\`|
+|Source Path|\`./packages/react/src/components/consent-dialog/consent-dialog.tsx\`|
+
+\*ExtractedTypeTable: Could not extract "ConsentDialogProps" from "./packages/react/src/components/consent-dialog/consent-dialog.tsx" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*