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/integrations/databuddy.md CHANGED Viewed

@@ -1,8 +1,10 @@
 ---
 title: Databuddy
-description: 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.
-lastModified: 2025-10-31
+description: 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.
 icon: databuddy
+group: integrations
 ---
 The Databuddy script automatically respects consent preferences by toggling tracking on and off based on the user's consent state.
@@ -186,89 +188,18 @@ This ensures that no tracking occurs without user consent, keeping your analytic
 ### DatabuddyConsentOptions
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|clientId|string|Your Databuddy client ID.|-|✅ Required|
-|apiUrl|string \|undefined|Your Databuddy API URL.|'https\://basket.databuddy.cc'|Optional|
-|scriptUrl|string \|undefined|The Databuddy script URL.|'https\://cdn.databuddy.cc/databuddy.js'|Optional|
-|configWhenGranted|Record\<string, unknown>|Databuddy config object to seed when consent is granted at load time.|-|✅ Required|
-|configWhenDenied|Record\<string, unknown>|Databuddy config object to seed when consent is denied at load time.|-|✅ Required|
+|Property|Value|
+|:--|:--|
+|Type Name|\`DatabuddyConsentOptions\`|
+|Source Path|\`./packages/scripts/src/vendors/analytics/databuddy.ts\`|
+\*ExtractedTypeTable: Could not extract "DatabuddyConsentOptions" from "./packages/scripts/src/vendors/analytics/databuddy.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
 ### Script
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|Unique identifier for the script|-|✅ Required|
-|src|string \|undefined|URL of the script to load|-|Optional|
-|textContent|string \|undefined|Inline JavaScript code to execute|-|Optional|
-|category|HasCondition\<AllConsentNames>|Consent category or condition required to load this script|-|✅ Required|
-|callbackOnly|boolean \|undefined|Whether this is a callback-only script that doesn't need to load an external resource. When true, no script tag will be added to the DOM, only callbacks will be executed.|false|Optional|
-|persistAfterConsentRevoked|boolean \|undefined|Whether the script should persist after consent is revoked.|false|Optional|
-|alwaysLoad|boolean \|undefined|Whether the script should always load regardless of consent state. This is useful for scripts like Google Tag Manager or PostHog that manage their own consent state internally. The script will load immediately and never be unloaded based on consent changes. Note: When using this option, you are responsible for ensuring the script itself respects user consent preferences through its own consent management.|false|Optional|
-|fetchPriority|"high" \|"low" \|"auto" \|undefined|Priority hint for browser resource loading|-|Optional|
-|attributes|Record\<string, string> \|undefined|Additional attributes to add to the script element|-|Optional|
-|async|boolean \|undefined|Whether to use async loading|-|Optional|
-|defer|boolean \|undefined|Whether to defer script loading|-|Optional|
-|nonce|string \|undefined|Content Security Policy nonce|-|Optional|
-|anonymizeId|boolean \|undefined|Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockers|true|Optional|
-|target|"head" \|"body" \|undefined|Where to inject the script element in the DOM. Options: \`'head'\`: Scripts are appended to \`\<head>\` (default); \`'body'\`: Scripts are appended to \`\<body>\`|'head'|Optional|
-|onBeforeLoad|Object \|undefined|Callback executed before the script is loaded|-|Optional|
-|onLoad|Object \|undefined|Callback executed when the script loads successfully|-|Optional|
-|onError|Object \|undefined|Callback executed if the script fails to load|-|Optional|
-|onConsentChange|Object \|undefined|Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.|-|Optional|
-|vendorId|string \|number \|undefined|IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over \`category\` when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.|-|Optional|
-|iabPurposes|number\[] \|undefined|IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.|-|Optional|
-|iabLegIntPurposes|number\[] \|undefined|IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.|-|Optional|
-|iabSpecialFeatures|number\[] \|undefined|IAB TCF special feature IDs this script requires. Options: 1: Use precise geolocation data; 2: Actively scan device characteristics for identification|-|Optional|
-#### `onBeforeLoad`
-Callback executed before the script is loaded
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onLoad`
-Callback executed when the script loads successfully
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onError`
-Callback executed if the script fails to load
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onConsentChange`
-Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`Script\`|
+|Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
+\*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/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/integrations/fathom-analytics.md CHANGED Viewed

@@ -1,7 +1,8 @@
 ---
 title: Fathom Analytics
-description: Privacy-friendly cookieless analytics with a prebuilt helper that maps Fathom's data attributes into a c15t-managed script.
-lastModified: 2026-05-10
+description: Privacy-friendly cookieless analytics with a prebuilt helper that
+  maps Fathom's data attributes into a c15t-managed script.
+group: integrations
 icon: fathom-analytics
 ---
 Fathom Analytics is a lightweight, cookieless analytics product configured entirely through `data-*` attributes on its loader. The `fathomAnalytics()` helper serializes your site ID and tracking options into those attributes and hands the result to c15t's script loader.
@@ -132,90 +133,18 @@ if (consentStore.getState().has('measurement')) {
 ### FathomAnalyticsOptions
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|site|string|Your Fathom Analytics site ID.|-|✅ Required|
-|spa|"auto" \|"history" \|"hash" \|undefined|The SPA tracking mode. When undefined, SPA auto-routing is disabled and the \`data-spa\` attribute is omitted.|-|Optional|
-|auto|boolean \|undefined|Automatically track page views.|-|Optional|
-|canonical|boolean \|undefined|Enable canonical URL tracking.|-|Optional|
-|honorDnt|boolean \|undefined|Honor Do Not Track requests.|-|Optional|
-|scriptUrl|string \|undefined|Custom loader URL.|'https\://cdn.usefathom.com/script.js'|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`FathomAnalyticsOptions\`|
+|Source Path|\`./packages/scripts/src/vendors/analytics/fathom-analytics.ts\`|
+\*ExtractedTypeTable: Could not extract "FathomAnalyticsOptions" from "./packages/scripts/src/vendors/analytics/fathom-analytics.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
 ### Script
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|Unique identifier for the script|-|✅ Required|
-|src|string \|undefined|URL of the script to load|-|Optional|
-|textContent|string \|undefined|Inline JavaScript code to execute|-|Optional|
-|category|HasCondition\<AllConsentNames>|Consent category or condition required to load this script|-|✅ Required|
-|callbackOnly|boolean \|undefined|Whether this is a callback-only script that doesn't need to load an external resource. When true, no script tag will be added to the DOM, only callbacks will be executed.|false|Optional|
-|persistAfterConsentRevoked|boolean \|undefined|Whether the script should persist after consent is revoked.|false|Optional|
-|alwaysLoad|boolean \|undefined|Whether the script should always load regardless of consent state. This is useful for scripts like Google Tag Manager or PostHog that manage their own consent state internally. The script will load immediately and never be unloaded based on consent changes. Note: When using this option, you are responsible for ensuring the script itself respects user consent preferences through its own consent management.|false|Optional|
-|fetchPriority|"high" \|"low" \|"auto" \|undefined|Priority hint for browser resource loading|-|Optional|
-|attributes|Record\<string, string> \|undefined|Additional attributes to add to the script element|-|Optional|
-|async|boolean \|undefined|Whether to use async loading|-|Optional|
-|defer|boolean \|undefined|Whether to defer script loading|-|Optional|
-|nonce|string \|undefined|Content Security Policy nonce|-|Optional|
-|anonymizeId|boolean \|undefined|Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockers|true|Optional|
-|target|"head" \|"body" \|undefined|Where to inject the script element in the DOM. Options: \`'head'\`: Scripts are appended to \`\<head>\` (default); \`'body'\`: Scripts are appended to \`\<body>\`|'head'|Optional|
-|onBeforeLoad|Object \|undefined|Callback executed before the script is loaded|-|Optional|
-|onLoad|Object \|undefined|Callback executed when the script loads successfully|-|Optional|
-|onError|Object \|undefined|Callback executed if the script fails to load|-|Optional|
-|onConsentChange|Object \|undefined|Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.|-|Optional|
-|vendorId|string \|number \|undefined|IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over \`category\` when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.|-|Optional|
-|iabPurposes|number\[] \|undefined|IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.|-|Optional|
-|iabLegIntPurposes|number\[] \|undefined|IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.|-|Optional|
-|iabSpecialFeatures|number\[] \|undefined|IAB TCF special feature IDs this script requires. Options: 1: Use precise geolocation data; 2: Actively scan device characteristics for identification|-|Optional|
-#### `onBeforeLoad`
-Callback executed before the script is loaded
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onLoad`
-Callback executed when the script loads successfully
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onError`
-Callback executed if the script fails to load
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onConsentChange`
-Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`Script\`|
+|Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
+\*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/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/integrations/google-maps.md ADDED Viewed

@@ -0,0 +1,263 @@
+---
+title: Google Maps
+description: Render Google Maps only after consent with one shared Maps
+  JavaScript API loader and independently managed map instances.
+icon: google-maps
+group: integrations
+---
+`GoogleMap` is a renderable integration for React and Next.js. It keeps the
+Google Maps JavaScript API off the page until the configured consent category is
+allowed, then loads the SDK once and creates a map for each mounted component.
+Unlike the helpers from `@c15t/scripts`, `GoogleMap` owns both the consent-aware
+script lifecycle and the visible map container.
+> ℹ️ **Info:**
+> The browser must receive a Google Maps API key, so the key is visible to site visitors. Keep it out of source control, use a key created for browser use, and restrict it by website and API in Google Cloud.
+## Integrate with c15t
+`GoogleMap` must render inside a `ConsentManagerProvider`. Complete the
+[React quickstart](/docs/frameworks/react/quickstart) or
+[Next.js quickstart](/docs/frameworks/next/quickstart) first.
+**React**
+```tsx
+import { GoogleMap } from '@c15t/react';
+const apiKey = import.meta.env.VITE_GOOGLE_MAPS_API_KEY;
+export function StoreMap() {
+  if (!apiKey) {
+    return <p>Google Maps is not configured.</p>;
+  }
+  return (
+    <GoogleMap
+      apiKey={apiKey}
+      authReferrerPolicy="origin"
+      center={{ lat: 40.7128, lng: -74.006 }}
+      consentCategory="measurement"
+      style={{ height: 400 }}
+      zoom={12}
+    />
+  );
+}
+```
+**Next.js**
+```tsx
+'use client';
+import { GoogleMap } from '@c15t/nextjs';
+const apiKey = process.env.NEXT_PUBLIC_GOOGLE_MAPS_API_KEY;
+export function StoreMap() {
+  if (!apiKey) {
+    return <p>Google Maps is not configured.</p>;
+  }
+  return (
+    <GoogleMap
+      apiKey={apiKey}
+      authReferrerPolicy="origin"
+      center={{ lat: 40.7128, lng: -74.006 }}
+      consentCategory="measurement"
+      style={{ height: 400 }}
+      zoom={12}
+    />
+  );
+}
+```
+`measurement` is a common choice for an interactive map, but the correct
+category depends on why your application uses Google Maps and the policy shown
+to your users.
+## How c15t loads it
+* **Before consent:** no Maps JavaScript API script is requested and no map
+  instance is created.
+* **After consent:** c15t registers one shared SDK loader and waits for Google's
+  callback before constructing the map.
+* **Multiple maps:** components with the same `scriptId` reuse the SDK while
+  keeping separate map instances.
+* **On revocation or unmount:** the component clears the map instance and its
+  listeners. The page-level SDK registration is retained after its first load
+  because Google supports one loader per page.
+* **Existing SDK:** if another part of the application already loaded a
+  compatible Google Maps global, the component adopts it instead of adding a
+  duplicate script.
+* **Visible states:** the blocked, loading, and error states are accessible and
+  use the active c15t translations by default.
+Keep one `scriptId` and one loader configuration across the page. Override the
+default `scriptId` only to coordinate with a known c15t script registration, not
+to load a second Maps SDK configuration. If two maps register conflicting
+loader options, c15t reports the conflict and tells you to align the key,
+language, region, libraries, and other loader options. A different `scriptId`
+does not make a second Google loader safe.
+## Configure the map
+Pass `center`, `zoom`, `mapId`, and `options` as you would when constructing a
+Google map:
+```tsx
+<GoogleMap
+  apiKey={apiKey}
+  center={{ lat: 51.5072, lng: -0.1276 }}
+  consentCategory="measurement"
+  mapId="YOUR_MAP_ID"
+  options={{
+    disableDefaultUI: true,
+    gestureHandling: 'cooperative',
+  }}
+  zoom={11}
+/>
+```
+Changes to `center`, `zoom`, and updateable `options` are applied to the existing
+map. Changing `mapId` recreates it because Google treats that value as
+construction-time configuration.
+The component has a default height of `320px`. Override `style.height` or apply
+a class with an explicit height when your layout needs another size.
+### Loader options
+The direct Maps JavaScript API loader options are available as component props:
+* `libraries`
+* `language`
+* `region`
+* `version`
+* `authReferrerPolicy`
+* `mapIds`
+* `channel`
+* `solutionChannel`
+* `nonce`
+`mapIds` preloads map ID configuration; `mapId` selects the map ID for the
+component instance.
+## Handle loading and errors
+The built-in loading and error states use `frame.loading` and `frame.error` from
+your c15t messages. The consent placeholder uses the localized consent-type
+title in both its message and button—for example, an `Analytics` title produces
+“Enable Analytics consent.”
+Use the fallback props when you need integration-specific content and `onError`
+for reporting:
+```tsx
+import { Frame, GoogleMap } from '@c15t/react';
+function reportMapError(error: Error) {
+  // Send the error to your observability provider.
+}
+<GoogleMap
+  apiKey={apiKey}
+  center={{ lat: 40.7128, lng: -74.006 }}
+  consentCategory="measurement"
+  loadingFallback={<p>Loading map…</p>}
+  errorFallback={<p>The map could not be loaded.</p>}
+  onError={reportMapError}
+  placeholder={
+    <Frame.Root>
+      <Frame.Title>Allow measurement consent to view this map.</Frame.Title>
+      <Frame.Button category="measurement" />
+    </Frame.Root>
+  }
+/>
+```
+`onError` covers loader failures, timeouts, map-constructor failures, and
+Google's global authentication failure callback. Authentication failures
+usually indicate an invalid key, missing billing, a disabled API, or a referrer
+that is not allowed.
+If you provide a custom `placeholder`, include `Frame.Button` or another way to
+reopen consent preferences or grant the required category.
+### Retry a failed map
+Increment `retryKey` to retry the same map after a loader, authentication, or
+constructor failure:
+```tsx
+import { GoogleMap } from '@c15t/react';
+import { useState } from 'react';
+function RetryableMap({ apiKey }: { apiKey: string }) {
+  const [retryKey, setRetryKey] = useState(0);
+  return (
+    <>
+      <GoogleMap
+        apiKey={apiKey}
+        center={{ lat: 40.7128, lng: -74.006 }}
+        retryKey={retryKey}
+      />
+      <button type="button" onClick={() => setRetryKey((key) => key + 1)}>
+        Retry map
+      </button>
+    </>
+  );
+}
+```
+Changing `retryKey` clears the failed attempt and retries with the same
+`scriptId`. A successful page-level SDK registration remains shared and is not
+loaded again.
+## Secure the browser key
+For production:
+1. Create a key specifically for the browser application.
+2. Apply a **Websites** application restriction for every allowed development
+   and production origin.
+3. Restrict the key to the **Maps JavaScript API** and any additional APIs used
+   by requested libraries.
+4. Keep the value in an untracked environment file and expose it through the
+   browser environment variable required by your framework.
+5. Monitor key usage and rotate the key if you see unexpected traffic.
+When `authReferrerPolicy="origin"` is set, configure origin-level website
+restrictions without URL paths.
+* [Google Maps Platform security guidance](https://developers.google.com/maps/api-security-best-practices)
+* [Maps JavaScript API loader options](https://developers.google.com/maps/documentation/javascript/load-maps-js-api)
+* [Maps Demo Key for local prototypes](https://developers.google.com/maps/documentation/javascript/demo-key)
+## Verify setup
+1. Clear saved consent and reload the page.
+2. Confirm no request to `maps.googleapis.com/maps/api/js` occurs before the
+   configured category is allowed.
+3. Grant consent and confirm the map reaches its ready state.
+4. Render two maps with the same `scriptId` and confirm only one loader script is
+   added.
+5. Revoke consent and confirm each map instance is removed.
+6. Test a rejected key or referrer and confirm `errorFallback` and `onError`
+   receive the failure.
+7. Fix the rejected configuration, change `retryKey`, and confirm the map can
+   recover without changing `scriptId`.
+## Types
+### GoogleMapProps
+|Property|Value|
+|:--|:--|
+|Type Name|\`GoogleMapProps\`|
+|Source Path|\`./packages/react/src/components/integrations/google-map.tsx\`|
+\*ExtractedTypeTable: Could not extract "GoogleMapProps" from "./packages/react/src/components/integrations/google-map.tsx" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*

package/docs/integrations/google-tag-manager.md CHANGED Viewed

@@ -1,8 +1,9 @@
 ---
 title: Google Tag Manager
-description: Deploy and manage marketing tags centrally with automatic consent state synchronization.
-lastModified: 2026-02-10
+description: Deploy and manage marketing tags centrally with automatic consent
+  state synchronization.
 icon: google-tag-manager
+group: integrations
 ---
 Google Tag Manager (GTM) is Google's tag management system that lets you deploy and manage marketing tags, analytics scripts, and conversion pixels without modifying your codebase. Instead of hardcoding multiple scripts, you configure them through GTM's web interface.
@@ -90,14 +91,14 @@ getOrCreateConsentRuntime({
 1. **Creating a Tag Manager Container**
-   > ℹ️ Info:
-   >
+   > 📝 Note:
    > This step is optional if you already have a Tag Manager container. Ensure your container has consent overview enabled.
    After signing into Google Tag Manager, you can create a new container.
    Continue to Google Tag Manager
-   In Tag Manager, click Admin > Container Settings.Under Additional Settings, select "Enable consent overview".
+   1. In Tag Manager, click Admin > Container Settings.
+   2. Under Additional Settings, select "Enable consent overview".
    Enable consent overview
@@ -136,87 +137,18 @@ You do not need to wrap `dataLayer.push(...)` in a `useConsentManager().has(...)
 ### GoogleTagManagerOptions
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|Your Google Tag Manager container ID. Begins with 'GTM-'.|-|✅ Required|
-|updateEventName|string \|undefined|Custom event name fired after consent updates. Can be used as a trigger in GTM to load scripts once consent is updated.|'consent-update'|Optional|
-|consentMapping|Record\<string, string\[]> \|undefined|Custom mapping from c15t consent categories to Google Consent Mode v2 types. Overrides the default mapping when provided.|\`\`\`ts \{ necessary: \['security\_storage'], functionality: \['functionality\_storage'], measurement: \['analytics\_storage'], marketing: \['ad\_storage', 'ad\_user\_data', 'ad\_personalization'], experience: \['personalization\_storage'], } \`\`\`|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`GoogleTagManagerOptions\`|
+|Source Path|\`./packages/scripts/src/vendors/tag-managers/google-tag-manager.ts\`|
+\*ExtractedTypeTable: Could not extract "GoogleTagManagerOptions" from "./packages/scripts/src/vendors/tag-managers/google-tag-manager.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
 ### Script
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|Unique identifier for the script|-|✅ Required|
-|src|string \|undefined|URL of the script to load|-|Optional|
-|textContent|string \|undefined|Inline JavaScript code to execute|-|Optional|
-|category|HasCondition\<AllConsentNames>|Consent category or condition required to load this script|-|✅ Required|
-|callbackOnly|boolean \|undefined|Whether this is a callback-only script that doesn't need to load an external resource. When true, no script tag will be added to the DOM, only callbacks will be executed.|false|Optional|
-|persistAfterConsentRevoked|boolean \|undefined|Whether the script should persist after consent is revoked.|false|Optional|
-|alwaysLoad|boolean \|undefined|Whether the script should always load regardless of consent state. This is useful for scripts like Google Tag Manager or PostHog that manage their own consent state internally. The script will load immediately and never be unloaded based on consent changes. Note: When using this option, you are responsible for ensuring the script itself respects user consent preferences through its own consent management.|false|Optional|
-|fetchPriority|"high" \|"low" \|"auto" \|undefined|Priority hint for browser resource loading|-|Optional|
-|attributes|Record\<string, string> \|undefined|Additional attributes to add to the script element|-|Optional|
-|async|boolean \|undefined|Whether to use async loading|-|Optional|
-|defer|boolean \|undefined|Whether to defer script loading|-|Optional|
-|nonce|string \|undefined|Content Security Policy nonce|-|Optional|
-|anonymizeId|boolean \|undefined|Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockers|true|Optional|
-|target|"head" \|"body" \|undefined|Where to inject the script element in the DOM. Options: \`'head'\`: Scripts are appended to \`\<head>\` (default); \`'body'\`: Scripts are appended to \`\<body>\`|'head'|Optional|
-|onBeforeLoad|Object \|undefined|Callback executed before the script is loaded|-|Optional|
-|onLoad|Object \|undefined|Callback executed when the script loads successfully|-|Optional|
-|onError|Object \|undefined|Callback executed if the script fails to load|-|Optional|
-|onConsentChange|Object \|undefined|Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.|-|Optional|
-|vendorId|string \|number \|undefined|IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over \`category\` when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.|-|Optional|
-|iabPurposes|number\[] \|undefined|IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.|-|Optional|
-|iabLegIntPurposes|number\[] \|undefined|IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.|-|Optional|
-|iabSpecialFeatures|number\[] \|undefined|IAB TCF special feature IDs this script requires. Options: 1: Use precise geolocation data; 2: Actively scan device characteristics for identification|-|Optional|
-#### `onBeforeLoad`
-Callback executed before the script is loaded
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onLoad`
-Callback executed when the script loads successfully
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onError`
-Callback executed if the script fails to load
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
-#### `onConsentChange`
-Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|string|The original script ID|-|✅ Required|
-|elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
-|hasConsent|boolean|Has consent|-|✅ Required|
-|consents|ConsentState|The current consent state|-|✅ Required|
-|element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
-|error|Error \|undefined|Error information (for error callbacks)|-|Optional|
+|Property|Value|
+|:--|:--|
+|Type Name|\`Script\`|
+|Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
+\*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*