npm - @c15t/nextjs - Versions diffs - 2.1.0 → 2.2.1 - Mend

@c15t/nextjs 2.1.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

package/AGENTS.md +155 -0
package/README.md +31 -15
package/client/components/integrations.js +3 -0
package/dist/components/integrations/index.cjs +1 -0
package/dist/components/integrations/index.js +1 -0
package/dist/headless.cjs +1 -1
package/dist/index.cjs +1 -1
package/dist/libs/browser-initial-data.cjs +1 -1
package/dist/libs/initial-data.cjs +1 -1
package/dist/styles.tw3.css +1 -1
package/dist/version.cjs +1 -1
package/dist/version.js +1 -1
package/dist-types/components/integrations/index.d.ts +1 -0
package/dist-types/libs/browser-initial-data.d.ts +1 -1
package/dist-types/version.d.ts +1 -1
package/docs/README.md +155 -73
package/docs/{building-headless-components.md → frameworks/next/building-headless-components.md} +3 -1
package/docs/{callbacks.md → frameworks/next/callbacks.md} +3 -1
package/docs/{components → frameworks/next/components}/consent-banner.md +10 -21
package/docs/{components → frameworks/next/components}/consent-dialog-link.md +8 -5
package/docs/frameworks/next/components/consent-dialog-trigger.md +202 -0
package/docs/{components → frameworks/next/components}/consent-dialog.md +7 -15
package/docs/frameworks/next/components/consent-manager-provider.md +327 -0
package/docs/{components → frameworks/next/components}/consent-widget.md +8 -6
package/docs/{components → frameworks/next/components}/dev-tools.md +9 -6
package/docs/{components → frameworks/next/components}/frame.md +8 -9
package/docs/{concepts → frameworks/next/concepts}/client-modes.md +4 -2
package/docs/{concepts → frameworks/next/concepts}/consent-categories.md +1 -0
package/docs/{concepts → frameworks/next/concepts}/consent-models.md +1 -0
package/docs/{concepts → frameworks/next/concepts}/cookie-management.md +3 -3
package/docs/{concepts → frameworks/next/concepts}/glossary.md +1 -0
package/docs/{concepts → frameworks/next/concepts}/initialization-flow.md +1 -0
package/docs/{concepts → frameworks/next/concepts}/policy-packs.md +1 -0
package/docs/{headless.md → frameworks/next/headless.md} +3 -1
package/docs/{hooks → frameworks/next/hooks}/use-color-scheme.md +1 -0
package/docs/{hooks → frameworks/next/hooks}/use-consent-manager/checking-consent.md +3 -1
package/docs/{hooks → frameworks/next/hooks}/use-consent-manager/location-info.md +3 -1
package/docs/frameworks/next/hooks/use-consent-manager/overview.md +185 -0
package/docs/{hooks → frameworks/next/hooks}/use-consent-manager/setting-consent.md +3 -1
package/docs/{hooks → frameworks/next/hooks}/use-draggable.md +3 -1
package/docs/{hooks → frameworks/next/hooks}/use-focus-trap.md +1 -0
package/docs/{hooks → frameworks/next/hooks}/use-reduced-motion.md +3 -1
package/docs/{hooks → frameworks/next/hooks}/use-ssr-status.md +6 -5
package/docs/{hooks → frameworks/next/hooks}/use-text-direction.md +1 -0
package/docs/frameworks/next/hooks/use-translations.md +55 -0
package/docs/{iab → frameworks/next/iab}/consent-banner.md +9 -12
package/docs/{iab → frameworks/next/iab}/consent-dialog.md +9 -14
package/docs/{iab → frameworks/next/iab}/overview.md +4 -2
package/docs/{iab → frameworks/next/iab}/use-gvl-data.md +3 -2
package/docs/{iframe-blocking.md → frameworks/next/iframe-blocking.md} +8 -9
package/docs/{internationalization.md → frameworks/next/internationalization.md} +13 -3
package/docs/{network-blocker.md → frameworks/next/network-blocker.md} +13 -51
package/docs/{optimization.md → frameworks/next/optimization.md} +5 -4
package/docs/{policy-packs.md → frameworks/next/policy-packs.md} +3 -1
package/docs/{quickstart.md → frameworks/next/quickstart.md} +26 -42
package/docs/{script-loader.md → frameworks/next/script-loader.md} +72 -90
package/docs/{server-side.md → frameworks/next/server-side.md} +12 -15
package/docs/{styling → frameworks/next/styling}/classnames.md +3 -1
package/docs/{styling → frameworks/next/styling}/color-scheme.md +3 -1
package/docs/frameworks/next/styling/css-variables.md +53 -0
package/docs/frameworks/next/styling/overview.md +299 -0
package/docs/frameworks/next/styling/slots.md +94 -0
package/docs/{styling → frameworks/next/styling}/tailwind.md +3 -1
package/docs/frameworks/next/styling/tokens.md +156 -0
package/docs/{troubleshooting.md → frameworks/next/troubleshooting.md} +3 -1
package/docs/integrations/adobe-analytics.md +160 -0
package/docs/integrations/ahrefs-analytics.md +15 -82
package/docs/integrations/amplitude.md +230 -0
package/docs/integrations/building-integrations.md +15 -181
package/docs/integrations/clearbit.md +130 -0
package/docs/integrations/cloudflare-web-analytics.md +15 -83
package/docs/integrations/crisp.md +13 -87
package/docs/integrations/databuddy.md +16 -85
package/docs/integrations/fathom-analytics.md +15 -86
package/docs/integrations/google-maps.md +263 -0
package/docs/integrations/google-tag-manager.md +18 -86
package/docs/integrations/google-tag.md +15 -84
package/docs/integrations/heap.md +219 -0
package/docs/integrations/hightouch.md +199 -0
package/docs/integrations/hotjar.md +15 -83
package/docs/integrations/intercom.md +13 -83
package/docs/integrations/linkedin-insights.md +15 -82
package/docs/integrations/logrocket.md +175 -0
package/docs/integrations/matomo-analytics.md +13 -88
package/docs/integrations/meta-pixel.md +33 -316
package/docs/integrations/microsoft-clarity.md +15 -83
package/docs/integrations/microsoft-uet.md +16 -83
package/docs/integrations/mixpanel-analytics.md +15 -83
package/docs/integrations/overview.md +55 -6
package/docs/integrations/pirsch.md +142 -0
package/docs/integrations/plausible-analytics.md +14 -97
package/docs/integrations/posthog.md +26 -98
package/docs/integrations/promptwatch.md +16 -82
package/docs/integrations/reddit-pixel.md +27 -122
package/docs/integrations/rudderstack.md +271 -0
package/docs/integrations/rybbit-analytics.md +15 -94
package/docs/integrations/segment.md +15 -82
package/docs/integrations/snapchat-pixel.md +21 -102
package/docs/integrations/tiktok-pixel.md +13 -81
package/docs/integrations/umami-analytics.md +16 -88
package/docs/integrations/vercel-analytics.md +13 -85
package/docs/integrations/x-pixel.md +27 -102
package/docs/integrations/youtube.md +193 -0
package/docs/shared/concepts/client-modes.md +103 -0
package/docs/shared/concepts/consent-categories.md +41 -0
package/docs/shared/concepts/consent-models.md +72 -0
package/docs/shared/concepts/cookie-management.md +88 -0
package/docs/shared/concepts/glossary.md +24 -0
package/docs/shared/concepts/initialization-flow.md +105 -0
package/docs/shared/concepts/policy-packs.md +225 -0
package/docs/shared/react/components/consent-banner.md +242 -0
package/docs/shared/react/components/consent-dialog-link.md +45 -0
package/docs/shared/react/components/consent-dialog-trigger.md +185 -0
package/docs/shared/react/components/consent-dialog.md +119 -0
package/docs/shared/react/components/consent-manager-provider.md +225 -0
package/docs/shared/react/components/consent-widget.md +121 -0
package/docs/shared/react/components/dev-tools.md +81 -0
package/docs/shared/react/components/frame.md +52 -0
package/docs/shared/react/guides/building-headless-components.md +110 -0
package/docs/shared/react/guides/callbacks.md +89 -0
package/docs/shared/react/guides/headless.md +31 -0
package/docs/shared/react/guides/iframe-blocking.md +65 -0
package/docs/shared/react/guides/internationalization.md +123 -0
package/docs/shared/react/guides/network-blocker.md +72 -0
package/docs/shared/react/guides/optimization.md +44 -0
package/docs/shared/react/guides/policy-packs.md +173 -0
package/docs/shared/react/guides/script-loader.md +311 -0
package/docs/shared/react/hooks/use-color-scheme.md +31 -0
package/docs/shared/react/hooks/use-consent-manager/checking-consent.md +95 -0
package/docs/shared/react/hooks/use-consent-manager/location-info.md +96 -0
package/docs/shared/react/hooks/use-consent-manager/overview.md +74 -0
package/docs/shared/react/hooks/use-consent-manager/setting-consent.md +93 -0
package/docs/shared/react/hooks/use-draggable.md +30 -0
package/docs/shared/react/hooks/use-focus-trap.md +20 -0
package/docs/shared/react/hooks/use-reduced-motion.md +33 -0
package/docs/shared/react/hooks/use-ssr-status.md +16 -0
package/docs/shared/react/hooks/use-text-direction.md +38 -0
package/docs/shared/react/hooks/use-translations.md +15 -0
package/docs/shared/react/iab/consent-banner.md +60 -0
package/docs/shared/react/iab/consent-dialog.md +76 -0
package/docs/shared/react/iab/overview.md +80 -0
package/docs/shared/react/iab/use-gvl-data.md +21 -0
package/docs/shared/react/styling/classnames.md +93 -0
package/docs/shared/react/styling/color-scheme.md +35 -0
package/docs/shared/react/styling/css-variables.md +53 -0
package/docs/shared/react/styling/overview.md +261 -0
package/docs/shared/react/styling/slots.md +93 -0
package/docs/shared/react/styling/stylesheet-entrypoint.md +8 -0
package/docs/shared/react/styling/tailwind.md +88 -0
package/docs/shared/react/styling/tokens.md +155 -0
package/docs/shared/troubleshooting.md +82 -0
package/package.json +19 -10
package/readme.json +14 -8
package/docs/ai-agents.md +0 -111
package/docs/components/consent-dialog-trigger.md +0 -103
package/docs/components/consent-manager-provider.md +0 -425
package/docs/hooks/use-consent-manager/overview.md +0 -420
package/docs/hooks/use-translations.md +0 -118
package/docs/styling/css-variables.md +0 -92
package/docs/styling/overview.md +0 -457
package/docs/styling/slots.md +0 -128
package/docs/styling/tokens.md +0 -216

package/docs/frameworks/next/hooks/use-consent-manager/overview.md ADDED Viewed

@@ -0,0 +1,185 @@
+---
+title: useConsentManager
+description: The primary hook for accessing consent state and actions. Returns
+  the full consent store including all state properties and action methods.
+group: frameworks
+---
+`useConsentManager()` is the primary hook for interacting with the consent system. It returns the complete consent store state and all action methods.
+```tsx
+import { useConsentManager } from '@c15t/nextjs';
+function MyComponent() {
+  const {
+    consents,
+    model,
+    has,
+    saveConsents,
+    // ... all state and actions
+  } = useConsentManager();
+}
+```
+> ⚠️ **Warning:**
+> Must be used within a ConsentManagerProvider. Throws an error if used outside the provider.
+## State Properties
+|Property|Value|
+|:--|:--|
+|Type Name|\`StoreRuntimeState\`|
+|Source Path|\`./packages/core/src/store/type.ts\`|
+\*ExtractedTypeTable: Could not extract "StoreRuntimeState" from "./packages/core/src/store/type.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+## Action Methods
+|Property|Value|
+|:--|:--|
+|Type Name|\`StoreActions\`|
+|Source Path|\`./packages/core/src/store/type.ts\`|
+\*ExtractedTypeTable: Could not extract "StoreActions" from "./packages/core/src/store/type.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+## User Identification
+You can link a consent subject to your own internal user ID or a non-secret anonymous visitor ID. c15t stores the identifier in the subject row's `externalId` field. Consent records remain associated with that subject through `subjectId`, so your backend can find the subject and its related consent records by external ID for GDPR Article 15 exports.
+### 1. Providing the Current User ID
+When using Clerk, prefer the Clerk `userId` whenever the visitor is signed in. Before sign-in, you can fall back to a non-secret visitor ID stored in a first-party cookie:
+> ⚠️ **Warning:**
+> ConsentManagerProvider runs on the client. Values passed through options.user are therefore available to client-side JavaScript, even when they were read from an HttpOnly cookie on the server. Pass only a non-secret identifier, such as a Clerk userId or an opaque visitor ID. Never pass a Clerk session token or a value returned by getToken().
+>
+> ℹ️ **Info:**
+> Clerk's auth() helper requires clerkMiddleware() to be configured. This example also uses the asynchronous cookies() API from Next.js 15+. For Next.js 14 and earlier, use const cookieStore = cookies(); without await. Keep the layout asynchronous because Clerk's auth() is asynchronous.
+```tsx
+// app/layout.tsx
+import { ClerkProvider } from '@clerk/nextjs';
+import { auth } from '@clerk/nextjs/server';
+import { ConsentManagerProvider } from '@c15t/nextjs';
+import { cookies } from 'next/headers';
+import { ClerkConsentSync } from './clerk-consent-sync';
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const { userId } = await auth();
+  const cookieStore = await cookies();
+  const visitorId = cookieStore.get('consent_visitor_id')?.value;
+  const consentUser = userId
+    ? { id: userId, identityProvider: 'clerk' }
+    : visitorId
+      ? { id: visitorId, identityProvider: 'anonymous-visitor' }
+      : undefined;
+  return (
+    <html lang="en">
+      <body>
+        <ClerkProvider>
+          <ConsentManagerProvider
+            options={{
+              mode: 'hosted',
+              backendURL: '/api/c15t',
+              consentCategories: ['necessary', 'measurement', 'marketing'],
+              user: consentUser,
+            }}
+          >
+            <ClerkConsentSync />
+            {children}
+          </ConsentManagerProvider>
+        </ClerkProvider>
+      </body>
+    </html>
+  );
+}
+```
+### 2. Synchronizing Clerk Sign-ins
+Clerk can complete a sign-in without reloading the page. Add a client component inside `ConsentManagerProvider` to update the current consent subject as soon as Clerk exposes the authenticated `userId`:
+```tsx
+// app/clerk-consent-sync.tsx
+'use client';
+import { useAuth } from '@clerk/nextjs';
+import { useConsentManager } from '@c15t/nextjs';
+import { useEffect } from 'react';
+export function ClerkConsentSync() {
+  const { isLoaded, isSignedIn, userId } = useAuth();
+  const { identifyUser } = useConsentManager();
+  useEffect(() => {
+    if (!isLoaded || !isSignedIn || !userId) {
+      return;
+    }
+    void identifyUser({
+      id: userId,
+      identityProvider: 'clerk',
+    }).then(() => {
+      // Prevent the old anonymous ID from replacing the Clerk ID after sign-out.
+      document.cookie =
+        'consent_visitor_id=; Max-Age=0; Path=/; SameSite=Lax';
+    });
+  }, [identifyUser, isLoaded, isSignedIn, userId]);
+  return null;
+}
+```
+`identifyUser()` replaces the subject's current `externalId`; it does not retain the anonymous ID as an alias. Once a visitor is linked to Clerk, stop supplying the former visitor ID. The example clears its client-readable cookie only after `identifyUser()` succeeds so a later render cannot change the subject back to the anonymous ID.
+> ℹ️ **Info:**
+> Backend subject identification requires hosted mode (mode: 'hosted'). In offline mode, identifyUser() cannot update a backend subject. Identifiers supplied through options.user can still be held in client state and persisted with locally stored consent, so do not place sensitive values there.
+## Key Types
+### ConsentState
+A record mapping consent category names to their boolean values:
+```ts
+type ConsentState = Record<AllConsentNames, boolean>;
+// Example: { necessary: true, measurement: true, marketing: false }
+```
+### ConsentInfo
+Metadata about when and how consent was recorded:
+```ts
+interface ConsentInfo {
+  time: number;                    // Epoch timestamp when consent was recorded
+  subjectId?: string;              // Client-generated subject ID (sub_xxx format)
+  externalId?: string;             // External user ID linked via identifyUser()
+  identityProvider?: string;       // Identity provider (e.g. 'clerk', 'auth0')
+}
+```
+### LocationInfo
+Detected geographic location from the c15t backend:
+```ts
+interface LocationInfo {
+  countryCode: string;     // ISO 3166-1 alpha-2 (e.g. 'DE')
+  regionCode: string;      // Region/state code (e.g. 'BY')
+  jurisdiction: string;    // Applicable jurisdiction (e.g. 'GDPR', 'CCPA')
+}
+```
+### Model
+The active consent model:
+```ts
+type Model = 'opt-in' | 'opt-out' | 'iab' | null;
+```
+* `'opt-in'` — Explicit consent required before tracking (GDPR)
+* `'opt-out'` — Tracking allowed by default, user can opt out (CCPA)
+* `'iab'` — IAB TCF 2.3 compliance mode
+* `null` — No jurisdiction detected yet

package/docs/{hooks → frameworks/next/hooks}/use-consent-manager/setting-consent.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: Setting Consent
-description: Save, update, and reset consent preferences with setConsent(), setSelectedConsent(), and saveConsents().
+description: Save, update, and reset consent preferences with setConsent(),
+  setSelectedConsent(), and saveConsents().
+group: frameworks
 ---
 ## saveConsents(type)

package/docs/{hooks → frameworks/next/hooks}/use-draggable.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: useDraggable
-description: Make an element draggable between viewport corners with snapping, persistence, and animation support.
+description: Make an element draggable between viewport corners with snapping,
+  persistence, and animation support.
+group: frameworks
 ---
 `useDraggable()` provides drag-to-corner functionality. Used internally by `ConsentDialogTrigger`, this hook lets you build custom draggable elements that snap to viewport corners.

package/docs/{hooks → frameworks/next/hooks}/use-focus-trap.md RENAMED Viewed

@@ -1,6 +1,7 @@
 ---
 title: useFocusTrap
 description: Trap keyboard focus within a container for accessible modal dialogs.
+group: frameworks
 ---
 `useFocusTrap()` keeps keyboard focus within a container element while active. This is essential for accessibility - when a modal dialog is open, Tab and Shift+Tab should cycle through focusable elements inside the dialog, not escape to the page behind it.

package/docs/{hooks → frameworks/next/hooks}/use-reduced-motion.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: useReducedMotion
-description: Detect the user's prefers-reduced-motion OS setting and reactively disable animations.
+description: Detect the user's prefers-reduced-motion OS setting and reactively
+  disable animations.
+group: frameworks
 ---
 `useReducedMotion()` reads the `prefers-reduced-motion: reduce` media query and reactively updates when the user's preference changes. Use it to conditionally skip animations for users who have enabled reduced motion in their OS accessibility settings.

package/docs/{hooks → frameworks/next/hooks}/use-ssr-status.md RENAMED Viewed

@@ -1,6 +1,7 @@
 ---
 title: useSSRStatus
 description: Check whether server-side rendered consent data was used during initialization.
+group: frameworks
 ---
 `useSSRStatus()` returns information about whether SSR data was used for consent manager initialization. This is primarily useful for debugging SSR data flow in Next.js or other server-rendering frameworks.
@@ -20,12 +21,12 @@ function DebugSSR() {
 ## Return Value
-### SSRStatus
+|Property|Value|
+|:--|:--|
+|Type Name|\`SSRStatus\`|
+|Source Path|\`./packages/react/src/hooks/use-ssr-status.ts\`|
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|ssrDataUsed|boolean|Whether SSR data was used for initialization. \`true\` if SSR data was provided and successfully consumed, \`false\` otherwise.|-|✅ Required|
-|ssrSkippedReason|"no\_data" \|"fetch\_failed" \|"context\_mismatch" \|null|Reason SSR data was skipped, or \`null\` if used successfully.|-|✅ Required|
+\*ExtractedTypeTable: Could not extract "SSRStatus" from "./packages/react/src/hooks/use-ssr-status.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
 > ℹ️ **Info:**
 > Must be used within a ConsentManagerProvider. Throws if used outside the provider context.

package/docs/{hooks → frameworks/next/hooks}/use-text-direction.md RENAMED Viewed

@@ -1,6 +1,7 @@
 ---
 title: useTextDirection
 description: Manage RTL/LTR text direction based on the active language for consent UI.
+group: frameworks
 ---
 `useTextDirection()` determines the correct text direction (`'ltr'` or `'rtl'`) based on the provided language and sets it on the document. It wraps the `@c15t/ui` text direction utilities as a React hook.

package/docs/frameworks/next/hooks/use-translations.md ADDED Viewed

@@ -0,0 +1,55 @@
+---
+title: useTranslations
+description: Access the current language's translations for building custom consent UI.
+group: frameworks
+---
+`useTranslations()` returns the `Translations` object for the currently active language. Use it when building custom consent UI that needs translated text.
+```tsx
+import { useTranslations } from '@c15t/nextjs';
+function CustomBanner() {
+  const translations = useTranslations();
+  return (
+    <div>
+      <h2>{translations.cookieBanner.title}</h2>
+      <p>{translations.cookieBanner.description}</p>
+      <button>{translations.common.acceptAll}</button>
+      <button>{translations.common.rejectAll}</button>
+    </div>
+  );
+}
+```
+## Translation Sections
+The returned `Translations` object has these sections:
+|Property|Value|
+|:--|:--|
+|Type Name|\`Translations\`|
+|Source Path|\`./packages/translations/src/types.ts\`|
+\*ExtractedTypeTable: Could not extract "Translations" from "./packages/translations/src/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
+## With setLanguage
+Translations update automatically when the language changes:
+```tsx
+import { useConsentManager, useTranslations } from '@c15t/nextjs';
+function LocalizedConsent() {
+  const { setLanguage } = useConsentManager();
+  const translations = useTranslations();
+  return (
+    <div>
+      <p>{translations.cookieBanner.description}</p>
+      <button onClick={() => setLanguage('de')}>Deutsch</button>
+      <button onClick={() => setLanguage('fr')}>Français</button>
+    </div>
+  );
+}
+```

package/docs/{iab → frameworks/next/iab}/consent-banner.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: IABConsentBanner
-description: An IAB TCF 2.3 compliant consent banner that displays partner count, purpose summaries, and legitimate interest notices.
+description: An IAB TCF 2.3 compliant consent banner that displays partner
+  count, purpose summaries, and legitimate interest notices.
+group: frameworks
 ---
 > ℹ️ **Info:**
 > c15t's IAB TCF support can be used in production. Use Inth for a hosted, IAB TCF-certified CMP setup with a managed CMP ID, or register your own CMP with IAB Europe and configure your own CMP ID.
@@ -81,14 +83,9 @@ Options: `'reject'`, `'accept'`, `'customize'` (default: `'customize'`)
 ## Props
-### IABConsentBannerProps
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|noStyle|boolean \|undefined|When true, removes all default styling from the component.|false|Optional|
-|disableAnimation|boolean \|undefined|When true, disables entrance/exit animations.|false|Optional|
-|scrollLock|boolean \|undefined|When true, locks page scroll when the banner is visible.|true|Optional|
-|trapFocus|boolean \|undefined|When true, traps keyboard focus within the banner.|true|Optional|
-|primaryButton|"reject" \|"accept" \|"customize" \|undefined|Specifies which button should be highlighted as primary.|'customize'|Optional|
-|models|Model \|undefined|Which consent models this banner responds to.|\['iab']|Optional|
-|uiSource|string \|undefined|Override the UI source identifier sent with consent API calls.|'iab\_banner'|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`IABConsentBannerProps\`|
+|Source Path|\`./packages/react/src/components/iab-consent-banner/iab-consent-banner.tsx\`|
+\*ExtractedTypeTable: Could not extract "IABConsentBannerProps" from "./packages/react/src/components/iab-consent-banner/iab-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/{iab → frameworks/next/iab}/consent-dialog.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: IABConsentDialog
-description: An IAB TCF 2.3 compliant preference center with tabbed purpose and vendor management.
+description: An IAB TCF 2.3 compliant preference center with tabbed purpose and
+  vendor management.
+group: frameworks
 ---
 > ℹ️ **Info:**
 > c15t's IAB TCF support can be used in production. Use Inth for a hosted, IAB TCF-certified CMP setup with a managed CMP ID, or register your own CMP with IAB Europe and configure your own CMP ID.
@@ -119,16 +121,9 @@ The dialog footer provides three buttons:
 ## Props
-### IABConsentDialogProps
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|open|boolean \|undefined|Control the open state. If omitted, follows activeUI === 'dialog' from context.|-|Optional|
-|noStyle|boolean \|undefined|When true, removes all default styling.|false|Optional|
-|disableAnimation|boolean \|undefined|When true, disables entrance/exit animations.|false|Optional|
-|scrollLock|boolean \|undefined|When true, locks page scroll when the dialog is visible.|true|Optional|
-|trapFocus|boolean \|undefined|When true, traps keyboard focus within the dialog.|true|Optional|
-|hideBranding|boolean \|undefined|When true, hides the branding in the footer.|false|Optional|
-|showTrigger|ConsentDialogTriggerProps \|undefined|Show a floating trigger button to resurface the consent dialog. IAB TCF requires the consent dialog to be easily resurfaceable. 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.|\['iab']|Optional|
-|uiSource|string \|undefined|Override the UI source identifier sent with consent API calls.|'iab\_dialog'|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`IABConsentDialogProps\`|
+|Source Path|\`./packages/react/src/components/iab-consent-dialog/iab-consent-dialog.tsx\`|
+\*ExtractedTypeTable: Could not extract "IABConsentDialogProps" from "./packages/react/src/components/iab-consent-dialog/iab-consent-dialog.tsx" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*

package/docs/{iab → frameworks/next/iab}/overview.md RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: IAB TCF 2.3
-description: Implement IAB Transparency & Consent Framework 2.3 compliance for programmatic advertising in EU/EEA jurisdictions.
+description: Implement IAB Transparency & Consent Framework 2.3 compliance for
+  programmatic advertising in EU/EEA jurisdictions.
+group: frameworks
 ---
 ## What is IAB TCF?
@@ -19,7 +21,7 @@ When your site participates in the IAB ecosystem (ad exchanges, SSPs, DSPs, DMPs
 If you self-host the c15t backend or want to operate as your own CMP, register your own CMP with IAB Europe and configure your CMP ID on the backend via `advanced.iab.cmpId` or on the client via the `iab.cmpId` option. Registering your own CMP may also involve IAB Europe fees, so check IAB Europe's current CMP registration terms and pricing before choosing this route. A valid (non-zero) CMP ID is required for IAB TCF compliance.
-> ℹ️ **Info:**
+> ⚠️ **Warning:**
 > If you heavily customize or build your own IAB banner or dialog instead of using the default IABConsentBanner and IABConsentDialog components, you cannot use Inth's CMP ID. You must register your own CMP with IAB Europe and use your own CMP ID.
 ## How c15t Implements TCF

package/docs/{iab → frameworks/next/iab}/use-gvl-data.md RENAMED Viewed

@@ -1,8 +1,9 @@
 ---
 title: useGVLData (Internal)
 description: Status note for the internal GVL hook used by the built-in IAB dialog.
+group: frameworks
 ---
-> ℹ️ **Info:**
+> ⚠️ **Warning:**
 > c15t's IAB TCF support can be used in production through Inth or with your own registered CMP ID. useGVLData() is different: it remains an internal hook and is not part of the supported public API.
 `useGVLData()` currently powers the built-in `IABConsentDialog`, but it is **not part of the public package surface**.
@@ -14,7 +15,7 @@ If you need supported customization points today:
 * Use `IABConsentBanner` and `IABConsentDialog` from `@c15t/react/iab` for the supported prebuilt UI
 * Use `useHeadlessIABConsentUI()` from `@c15t/react/iab` when you need lower-level control over banner/dialog state and actions
-> ℹ️ **Info:**
+> ⚠️ **Warning:**
 > Until useGVLData() is exported as public API, avoid importing it from deep internal paths. Those paths are not covered by semver guarantees and can change without notice.
 When a public GVL-focused hook becomes part of the supported API, this page should document that public surface instead of the internal dialog hook.

package/docs/{iframe-blocking.md → frameworks/next/iframe-blocking.md} RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: Iframe Blocking
-description: Block embedded content (YouTube, social widgets, maps) until users grant consent for the appropriate category.
+description: Block embedded content (YouTube, social widgets, maps) until users
+  grant consent for the appropriate category.
+group: frameworks
 ---
 Embedded iframes from third parties (YouTube, Google Maps, social media widgets) can set cookies and track users without their consent. c15t provides two approaches to gate iframes behind consent:
@@ -96,12 +98,9 @@ function IframeBlockerInit() {
 ## API Reference
-### FrameProps
+|Property|Value|
+|:--|:--|
+|Type Name|\`FrameProps\`|
+|Source Path|\`./packages/react/src/components/frame/types.ts\`|
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|children|ReactNode|Content rendered when consent is granted. Children are not mounted until consent is given, preventing unnecessary network requests.|-|✅ Required|
-|category|AllConsentNames|Consent category required to render children.|-|✅ Required|
-|placeholder|ReactNode|A custom placeholder component to display when consent is not met. If not provided, a default placeholder will be displayed.|-|Optional|
-|noStyle|boolean \|undefined|When true, removes all default styling from the component|false|Optional|
-|theme|any|Custom theme to override default styles while maintaining structure and accessibility. Merges with defaults. Ignored when \`noStyle=\{true}\`.|undefined|Optional|
+\*ExtractedTypeTable: Could not extract "FrameProps" from "./packages/react/src/components/frame/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/{internationalization.md → frameworks/next/internationalization.md} RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: Internationalization
-description: Translate consent UI into 30+ languages with built-in translations, custom overrides, and automatic browser language detection.
+description: Translate consent UI into 30+ languages with built-in translations,
+  custom overrides, and automatic browser language detection.
+group: frameworks
 ---
 c15t ships with built-in translations for 30+ languages via the `@c15t/translations` package. Language detection happens automatically based on the browser's language preference, and you can override or extend translations for any language.
@@ -83,7 +85,7 @@ The `Translations` object is organized into sections:
 |`cookieBanner`|Banner title and description|
 |`consentManagerDialog`|Dialog title and description|
 |`consentTypes`|Per-category title and description (keyed by AllConsentNames)|
-|`frame`|Frame placeholder title and button text (supports `{category}` placeholder)|
+|`frame`|Frame placeholder title, button, loading, and error text (title and button support `{category}`)|
 |`legalLinks`|Privacy policy, cookie policy, terms of service link text|
 |`iab`|IAB TCF banner, preference center, vendor list translations|
@@ -153,7 +155,9 @@ If you need a policy to always use one specific language regardless of browser p
 ## Custom Consent Type Labels
-Override the title and description for individual consent categories:
+Override the title and description for individual consent categories. Frame
+placeholders use that title anywhere their message contains `{category}`, so
+the title and action stay consistent:
 ```tsx
 i18n: {
@@ -169,6 +173,12 @@ i18n: {
           description: 'Used to deliver relevant ads and measure campaign effectiveness.',
         },
       },
+      frame: {
+        title: 'Allow {category} consent to view this content.',
+        actionButton: 'Enable {category} consent',
+        loading: 'Loading content…',
+        error: 'This content could not be loaded.',
+      },
     },
   },
 }

package/docs/{network-blocker.md → frameworks/next/network-blocker.md} RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: Network Blocker
-description: Block outgoing network requests to third-party domains until the user grants consent for the appropriate category.
+description: Block outgoing network requests to third-party domains until the
+  user grants consent for the appropriate category.
+group: frameworks
 ---
 The network blocker intercepts outgoing `fetch` and `XMLHttpRequest` calls and blocks them based on consent state and domain rules. This catches tracking requests that happen outside of script loading - for example, beacon calls, API requests to analytics endpoints, or pixel fires from already-loaded scripts.
@@ -123,56 +125,16 @@ function NetworkBlockerManager() {
 ## API Reference
-### NetworkBlockerRule
+|Property|Value|
+|:--|:--|
+|Type Name|\`NetworkBlockerRule\`|
+|Source Path|\`./packages/core/src/libs/network-blocker/types.ts\`|
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string \|undefined|Optional identifier for the rule. Useful for debugging and logging.|-|Optional|
-|domain|string|Domain that this rule applies to.|-|✅ Required|
-|pathIncludes|string \|undefined|Optional path substring that must be present in the request path for the rule to apply.|-|Optional|
-|methods|string\[] \|undefined|Optional list of HTTP methods that this rule applies to. If omitted, the rule applies to all methods.|-|Optional|
-|category|HasCondition\<AllConsentNames>|Consent condition that must be satisfied to allow the request. When this condition is not satisfied, matching requests will be blocked.|-|✅ Required|
+\*ExtractedTypeTable: Could not extract "NetworkBlockerRule" from "./packages/core/src/libs/network-blocker/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
-### NetworkBlockerConfig
+|Property|Value|
+|:--|:--|
+|Type Name|\`NetworkBlockerConfig\`|
+|Source Path|\`./packages/core/src/libs/network-blocker/types.ts\`|
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|enabled|boolean \|undefined|Whether the network blocker is enabled.|-|Optional|
-|initialConsents|ConsentState \|undefined|The consent state snapshot that is currently used for blocking logic.|-|Optional|
-|logBlockedRequests|boolean \|undefined|Whether to automatically log blocked requests to the console.|-|Optional|
-|onRequestBlocked|Object \|undefined|Callback invoked whenever a request is blocked.|-|Optional|
-|rules|NetworkBlockerRule|Domain rules that determine which requests should be blocked.|-|✅ Required|
-#### `initialConsents` ConsentState
-The consent state snapshot that is currently used for blocking logic.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|experience|boolean|-|-|✅ Required|
-|functionality|boolean|-|-|✅ Required|
-|marketing|boolean|-|-|✅ Required|
-|measurement|boolean|-|-|✅ Required|
-|necessary|boolean|-|-|✅ Required|
-#### `onRequestBlocked`
-Callback invoked whenever a request is blocked.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|method|string|The HTTP method of the blocked request (e.g. GET, POST).|-|✅ Required|
-|url|string|The URL of the blocked request.|-|✅ Required|
-|rule|NetworkBlockerRule \|undefined|The rule that caused the request to be blocked, if available. Can be undefined when the blocker configuration changed between evaluation and logging.|-|Optional|
-#### `rules` NetworkBlockerRule
-Domain rules that determine which requests should be blocked.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string \|undefined|Optional identifier for the rule. Useful for debugging and logging.|-|Optional|
-|domain|string|Domain that this rule applies to.|-|✅ Required|
-|pathIncludes|string \|undefined|Optional path substring that must be present in the request path for the rule to apply.|-|Optional|
-|methods|string\[] \|undefined|Optional list of HTTP methods that this rule applies to. If omitted, the rule applies to all methods.|-|Optional|
-|category|HasCondition\<AllConsentNames>|Consent condition that must be satisfied to allow the request. When this condition is not satisfied, matching requests will be blocked.|-|✅ Required|
+\*ExtractedTypeTable: Could not extract "NetworkBlockerConfig" from "./packages/core/src/libs/network-blocker/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/{optimization.md → frameworks/next/optimization.md} RENAMED Viewed

@@ -1,7 +1,8 @@
 ---
 title: Optimization
-description: Improve c15t startup performance in Next.js with same-origin rewrites, static prefetching, and dynamic-route SSR.
-lastModified: 2026-04-14
+description: Improve c15t startup performance in Next.js with same-origin
+  rewrites, static prefetching, and dynamic-route SSR.
+group: frameworks
 ---
 Use this guide when you care about banner visibility speed, route static-ness, and reducing backend round-trip cost.
@@ -66,7 +67,7 @@ Why this helps:
 > ℹ️ **Info:**
 > Set NEXT\_PUBLIC\_C15T\_URL in .env to your backend URL, for example https\://your-project.inth.app.
 >
-> ℹ️ **Info:**
+> ⚠️ **Warning:**
 > Use rewrites for browser-side calls (ConsentManagerProvider, C15tPrefetch). For server-side fetchInitialData(), prefer a direct backend URL (for example https\://your-project.inth.app) to avoid an extra server proxy hop.
 ## 2) Choose A Startup Strategy
@@ -136,7 +137,7 @@ export default function ConsentManager({
 }
 ```
-> ℹ️ **Info:**
+> ⚠️ **Warning:**
 > Do not await fetchInitialData(). Pass the unresolved Promise to the provider so Next.js can stream the route while /init runs in parallel.
 >
 > ℹ️ **Info:**

package/docs/{policy-packs.md → frameworks/next/policy-packs.md} RENAMED Viewed

@@ -1,6 +1,8 @@
 ---
 title: Policy Packs
-description: Configure regional consent policies in Next.js — hosted mode, presets, and offline fallback.
+description: Configure regional consent policies in Next.js — hosted mode,
+  presets, and offline fallback.
+group: frameworks
 ---
 Policy packs configure how c15t handles regional consent — which model (opt-in, opt-out, none), which categories, and what UI to show. The backend resolves the right policy automatically based on the visitor's location.