@c15t/react 3.0.0-alpha.0 → 3.0.0-alpha.10

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 (405) hide show
  1. package/AGENTS.md +96 -69
  2. package/README.md +21 -17
  3. package/SKILL.md +34 -0
  4. package/dist/aggregate-components.js +1 -1
  5. package/dist/chunk-warming.js +1 -1
  6. package/dist/component-hooks/use-headless-consent-ui.js +1 -1
  7. package/dist/component-hooks/use-headless-iab-consent-ui.js +1 -1
  8. package/dist/component-hooks/use-panel-trigger.js +1 -1
  9. package/dist/components/consent-gate/atoms.js +1 -0
  10. package/dist/components/consent-gate/consent-gate.js +2 -0
  11. package/dist/components/consent-gate/frame.js +2 -0
  12. package/dist/components/consent-gate/index.js +2 -0
  13. package/dist/components/consent-preferences-link/consent-preferences-link.js +1 -1
  14. package/dist/components/iab-panel/atoms/card.js +1 -1
  15. package/dist/components/iab-panel/atoms/feature-item.js +2 -0
  16. package/dist/components/iab-panel/atoms/header.js +1 -1
  17. package/dist/components/iab-panel/atoms/purpose-item.js +1 -1
  18. package/dist/components/iab-panel/atoms/root.js +1 -1
  19. package/dist/components/iab-panel/atoms/stack-item.js +1 -1
  20. package/dist/components/iab-panel/atoms/vendor-list.js +1 -1
  21. package/dist/components/iab-panel/hooks/use-gvl-data.js +1 -1
  22. package/dist/components/iab-panel/iab-panel.js +1 -1
  23. package/dist/components/iab-panel/index.js +1 -1
  24. package/dist/components/iab-prompt/atoms/overlay.js +1 -1
  25. package/dist/components/iab-prompt/atoms/root.js +1 -1
  26. package/dist/components/panel/atoms/card.js +1 -1
  27. package/dist/components/panel/atoms/overlay.js +1 -1
  28. package/dist/components/panel/atoms/root.js +1 -1
  29. package/dist/components/panel/panel.js +1 -1
  30. package/dist/components/panel-trigger/atoms/button.js +1 -1
  31. package/dist/components/panel-trigger/atoms/icon.js +1 -1
  32. package/dist/components/panel-trigger/atoms/root.js +1 -1
  33. package/dist/components/panel-trigger/atoms/toolbar.js +1 -1
  34. package/dist/components/panel-trigger/atoms/trigger-icons.js +1 -0
  35. package/dist/components/panel-trigger/panel-trigger-toolbar.js +1 -1
  36. package/dist/components/panel-trigger/panel-trigger.js +1 -1
  37. package/dist/components/preferences/atoms/accordion.js +1 -1
  38. package/dist/components/preferences/atoms/root.js +1 -1
  39. package/dist/components/preferences/atoms/vendor-list.js +1 -0
  40. package/dist/components/preferences/index.js +1 -1
  41. package/dist/components/prompt/atoms/early-tap-script.js +2 -0
  42. package/dist/components/prompt/atoms/overlay.js +1 -1
  43. package/dist/components/prompt/atoms/root.js +1 -1
  44. package/dist/components/prompt/components.js +1 -1
  45. package/dist/components/prompt/policy-actions.js +1 -1
  46. package/dist/components/prompt/prompt.js +1 -1
  47. package/dist/components/shared/dialog-sheets.js +1 -0
  48. package/dist/components/shared/first-paint-sheets.js +1 -0
  49. package/dist/components/shared/iab-dialog-sheets.js +1 -0
  50. package/dist/components/shared/iab-first-paint-sheets.js +1 -0
  51. package/dist/components/shared/libs/compose-refs.js +1 -0
  52. package/dist/components/shared/libs/slot.js +1 -1
  53. package/dist/components/shared/primitives/button.js +1 -1
  54. package/dist/components/shared/primitives/legal-links/index.js +1 -1
  55. package/dist/components/shared/streamed-surface.js +2 -0
  56. package/dist/components/shared/surface-styles.js +2 -0
  57. package/dist/components/shared/ui/dialog/dialog.js +1 -1
  58. package/dist/components/shared/ui/icon.js +1 -1
  59. package/dist/components/shared/ui/logo.js +1 -1
  60. package/dist/components/shared/ui/preference-item/preference-item.js +1 -1
  61. package/dist/consent-gate.js +2 -0
  62. package/dist/consent-theme.js +1 -0
  63. package/dist/context/consent-tracking-context.js +1 -1
  64. package/dist/context/index.js +1 -1
  65. package/dist/context.js +1 -1
  66. package/dist/devtools-launcher.js +2 -0
  67. package/dist/devtools.js +1 -1
  68. package/dist/draft-context.js +2 -0
  69. package/dist/draft.js +1 -1
  70. package/dist/external-iab-context.js +1 -1
  71. package/dist/gpp.js +2 -0
  72. package/dist/headless.js +1 -1
  73. package/dist/hooks/use-color-scheme.js +1 -1
  74. package/dist/hooks/use-committed-ref.js +2 -0
  75. package/dist/hooks/use-focus-trap.js +1 -1
  76. package/dist/hooks/use-headless-iab-consent-ui.js +1 -1
  77. package/dist/hooks/use-iab-policy-guard.js +1 -0
  78. package/dist/hooks/use-late-entry.js +2 -0
  79. package/dist/hooks.js +1 -1
  80. package/dist/iab/styles.tw3.css +5 -151
  81. package/dist/iab-context.js +1 -1
  82. package/dist/index-parts/consent-banner.js +1 -0
  83. package/dist/index-parts/consent-dialog-link.js +1 -0
  84. package/dist/index-parts/consent-dialog-trigger.js +1 -0
  85. package/dist/index-parts/consent-dialog.js +1 -0
  86. package/dist/index-parts/consent-gate.js +1 -0
  87. package/dist/index-parts/core.js +1 -0
  88. package/dist/index-parts/draft.js +1 -0
  89. package/dist/index-parts/frame.js +1 -0
  90. package/dist/index-parts/hooks.js +1 -0
  91. package/dist/index-parts/hosted.js +1 -0
  92. package/dist/index-parts/module-hooks.js +1 -0
  93. package/dist/index-parts/offline.js +1 -0
  94. package/dist/index-parts/presets.js +1 -0
  95. package/dist/index-parts/provider.js +1 -0
  96. package/dist/index-parts/theme.js +1 -0
  97. package/dist/index-parts/translations.js +1 -0
  98. package/dist/index.js +1 -1
  99. package/dist/kernel-selector.js +1 -0
  100. package/dist/modes.js +1 -0
  101. package/dist/module-hooks/iframe-blocker.js +1 -1
  102. package/dist/module-hooks/network-blocker.js +1 -1
  103. package/dist/module-hooks/network-hold.js +2 -0
  104. package/dist/module-hooks/persistence.js +1 -1
  105. package/dist/panel-link.js +1 -1
  106. package/dist/panel-trigger.js +1 -1
  107. package/dist/panel.js +1 -1
  108. package/dist/postcss-tailwind3.js +1 -0
  109. package/dist/preferences.js +1 -2
  110. package/dist/provider.js +1 -1
  111. package/dist/server/fetch-ssr-data.js +1 -1
  112. package/dist/server/headers.js +1 -1
  113. package/dist/server/normalize-url.js +1 -1
  114. package/dist/styles.tw3.css +35 -159
  115. package/dist/transports/hosted.js +1 -0
  116. package/dist/transports/manifest.js +1 -0
  117. package/dist/transports/offline.js +1 -1
  118. package/dist/utils/deferred-module.js +2 -0
  119. package/dist/utils/merge-slot-props.js +1 -1
  120. package/dist/utils/theme-utils.js +1 -1
  121. package/dist/version.js +1 -1
  122. package/dist-types/aggregate-components.d.ts +2 -2
  123. package/dist-types/chunk-warming.d.ts +45 -8
  124. package/dist-types/component-hooks/use-headless-consent-ui.d.ts +5 -5
  125. package/dist-types/component-hooks/use-headless-iab-consent-ui.d.ts +2 -2
  126. package/dist-types/components/consent-gate/atoms.d.ts +11 -0
  127. package/dist-types/components/consent-gate/consent-gate.d.ts +2 -0
  128. package/dist-types/components/consent-gate/frame.d.ts +19 -0
  129. package/dist-types/components/consent-gate/index.d.ts +25 -0
  130. package/dist-types/components/{frame → consent-gate}/types.d.ts +7 -7
  131. package/dist-types/components/consent-preferences-link/consent-preferences-link.d.ts +1 -1
  132. package/dist-types/components/consent-preferences-link/index.d.ts +1 -1
  133. package/dist-types/components/iab-panel/atoms/feature-item.d.ts +28 -0
  134. package/dist-types/components/iab-panel/atoms/purpose-item.d.ts +5 -2
  135. package/dist-types/components/iab-panel/atoms/stack-item.d.ts +7 -2
  136. package/dist-types/components/iab-panel/atoms/vendor-list.d.ts +1 -1
  137. package/dist-types/components/iab-panel/iab-panel.d.ts +3 -3
  138. package/dist-types/components/iab-panel/index.d.ts +29 -26
  139. package/dist-types/components/iab-panel/use-iab-translations.d.ts +4 -0
  140. package/dist-types/components/iab-prompt/iab-prompt.d.ts +3 -3
  141. package/dist-types/components/iab-prompt/index.d.ts +19 -19
  142. package/dist-types/components/panel/atoms/card.d.ts +5 -4
  143. package/dist-types/components/panel/atoms/overlay.d.ts +1 -1
  144. package/dist-types/components/panel/index.d.ts +8 -8
  145. package/dist-types/components/panel/panel.d.ts +3 -3
  146. package/dist-types/components/panel-link/index.d.ts +1 -1
  147. package/dist-types/components/panel-trigger/atoms/button.d.ts +1 -1
  148. package/dist-types/components/panel-trigger/atoms/icon.d.ts +1 -1
  149. package/dist-types/components/panel-trigger/atoms/root.d.ts +2 -2
  150. package/dist-types/components/panel-trigger/atoms/toolbar.d.ts +2 -2
  151. package/dist-types/components/panel-trigger/atoms/trigger-icons.d.ts +25 -0
  152. package/dist-types/components/panel-trigger/index.d.ts +4 -4
  153. package/dist-types/components/panel-trigger/panel-trigger-toolbar.d.ts +1 -1
  154. package/dist-types/components/panel-trigger/panel-trigger.d.ts +9 -17
  155. package/dist-types/components/panel-trigger/types.d.ts +1 -1
  156. package/dist-types/components/preferences/atoms/accordion.d.ts +6 -4
  157. package/dist-types/components/preferences/atoms/button.d.ts +1 -1
  158. package/dist-types/components/preferences/atoms/footer.d.ts +1 -1
  159. package/dist-types/components/preferences/atoms/root.d.ts +1 -1
  160. package/dist-types/components/preferences/atoms/vendor-list.d.ts +23 -0
  161. package/dist-types/components/preferences/index.d.ts +14 -12
  162. package/dist-types/components/preferences/policy-actions.d.ts +2 -2
  163. package/dist-types/components/preferences/preferences.d.ts +1 -1
  164. package/dist-types/components/preferences/types.d.ts +1 -1
  165. package/dist-types/components/prompt/atoms/early-tap-script.d.ts +17 -0
  166. package/dist-types/components/prompt/atoms/root.d.ts +4 -0
  167. package/dist-types/components/prompt/components.d.ts +9 -3
  168. package/dist-types/components/prompt/index.d.ts +12 -12
  169. package/dist-types/components/prompt/policy-actions.d.ts +2 -2
  170. package/dist-types/components/prompt/prompt.d.ts +5 -1
  171. package/dist-types/components/shared/dialog-sheets.d.ts +9 -0
  172. package/dist-types/components/shared/first-paint-sheets.d.ts +8 -0
  173. package/dist-types/components/shared/iab-dialog-sheets.d.ts +3 -0
  174. package/dist-types/components/shared/iab-first-paint-sheets.d.ts +3 -0
  175. package/dist-types/components/shared/libs/compose-refs.d.ts +20 -0
  176. package/dist-types/components/shared/policy-actions.d.ts +2 -2
  177. package/dist-types/components/shared/primitives/box.d.ts +1 -1
  178. package/dist-types/components/shared/primitives/button.d.ts +2 -2
  179. package/dist-types/components/shared/primitives/button.types.d.ts +1 -1
  180. package/dist-types/components/shared/streamed-surface.d.ts +23 -0
  181. package/dist-types/components/shared/surface-styles.d.ts +36 -0
  182. package/dist-types/components/shared/ui/accordion/accordion.d.ts +2 -2
  183. package/dist-types/components/shared/ui/accordion/index.d.ts +2 -2
  184. package/dist-types/components/shared/ui/animated-collapse/index.d.ts +2 -2
  185. package/dist-types/components/shared/ui/branding.d.ts +1 -1
  186. package/dist-types/components/shared/ui/button/button.d.ts +1 -1
  187. package/dist-types/components/shared/ui/button/index.d.ts +2 -2
  188. package/dist-types/components/shared/ui/collapsible/index.d.ts +1 -1
  189. package/dist-types/components/shared/ui/dialog/index.d.ts +1 -1
  190. package/dist-types/components/shared/ui/icon.d.ts +2 -1
  191. package/dist-types/components/shared/ui/logo.d.ts +0 -10
  192. package/dist-types/components/shared/ui/preference-item/index.d.ts +1 -1
  193. package/dist-types/components/shared/ui/preference-item/preference-item.d.ts +13 -0
  194. package/dist-types/components/shared/ui/switch/index.d.ts +2 -2
  195. package/dist-types/components/shared/ui/switch/switch.d.ts +1 -1
  196. package/dist-types/components/shared/ui/tabs/index.d.ts +1 -1
  197. package/dist-types/consent-gate.d.ts +1 -0
  198. package/dist-types/consent-theme.d.ts +38 -0
  199. package/dist-types/context/consent-tracking-context.d.ts +10 -0
  200. package/dist-types/context/index.d.ts +3 -3
  201. package/dist-types/context/theme-context.d.ts +3 -3
  202. package/dist-types/context.d.ts +25 -1
  203. package/dist-types/devtools-launcher.d.ts +29 -0
  204. package/dist-types/devtools.d.ts +13 -2
  205. package/dist-types/draft-context.d.ts +31 -0
  206. package/dist-types/draft.d.ts +81 -9
  207. package/dist-types/gpp.d.ts +27 -0
  208. package/dist-types/headless.d.ts +6 -7
  209. package/dist-types/hooks/use-committed-ref.d.ts +24 -0
  210. package/dist-types/hooks/use-focus-trap.d.ts +3 -1
  211. package/dist-types/hooks/use-headless-iab-consent-ui.d.ts +1 -1
  212. package/dist-types/hooks/use-iab-manager.d.ts +5 -5
  213. package/dist-types/hooks/use-iab-policy-guard.d.ts +35 -0
  214. package/dist-types/hooks/use-late-entry.d.ts +14 -0
  215. package/dist-types/hooks/use-theme.d.ts +1 -1
  216. package/dist-types/hooks.d.ts +106 -11
  217. package/dist-types/iab.d.ts +7 -7
  218. package/dist-types/index-parts/consent-banner.d.ts +7 -0
  219. package/dist-types/index-parts/consent-dialog-link.d.ts +7 -0
  220. package/dist-types/index-parts/consent-dialog-trigger.d.ts +7 -0
  221. package/dist-types/index-parts/consent-dialog.d.ts +7 -0
  222. package/dist-types/index-parts/consent-gate.d.ts +7 -0
  223. package/dist-types/index-parts/core.d.ts +7 -0
  224. package/dist-types/index-parts/draft.d.ts +7 -0
  225. package/dist-types/index-parts/frame.d.ts +7 -0
  226. package/dist-types/index-parts/hooks.d.ts +7 -0
  227. package/dist-types/index-parts/hosted.d.ts +7 -0
  228. package/dist-types/index-parts/module-hooks.d.ts +7 -0
  229. package/dist-types/index-parts/offline.d.ts +7 -0
  230. package/dist-types/index-parts/presets.d.ts +7 -0
  231. package/dist-types/index-parts/provider.d.ts +7 -0
  232. package/dist-types/index-parts/theme.d.ts +8 -0
  233. package/dist-types/index-parts/translations.d.ts +7 -0
  234. package/dist-types/index.d.ts +32 -28
  235. package/dist-types/kernel-selector.d.ts +68 -0
  236. package/dist-types/modes.d.ts +26 -0
  237. package/dist-types/module-hooks/iframe-blocker.d.ts +33 -1
  238. package/dist-types/module-hooks/network-blocker.d.ts +23 -0
  239. package/dist-types/module-hooks/network-hold.d.ts +47 -0
  240. package/dist-types/module-hooks.d.ts +4 -4
  241. package/dist-types/panel-link.d.ts +1 -1
  242. package/dist-types/panel-trigger.d.ts +1 -1
  243. package/dist-types/panel.d.ts +13 -1
  244. package/dist-types/postcss-tailwind3.d.ts +21 -0
  245. package/dist-types/preferences.d.ts +12 -1
  246. package/dist-types/primitives/accordion.d.ts +1 -1
  247. package/dist-types/primitives/button.d.ts +1 -1
  248. package/dist-types/primitives/collapsible.d.ts +1 -1
  249. package/dist-types/primitives/dialog.d.ts +1 -1
  250. package/dist-types/primitives/preference-item.d.ts +1 -1
  251. package/dist-types/primitives/switch.d.ts +1 -1
  252. package/dist-types/primitives/tabs.d.ts +1 -1
  253. package/dist-types/primitives.d.ts +7 -7
  254. package/dist-types/prompt.d.ts +1 -1
  255. package/dist-types/provider.d.ts +174 -28
  256. package/dist-types/server/fetch-ssr-data.d.ts +1 -1
  257. package/dist-types/server/headers.d.ts +14 -4
  258. package/dist-types/server/index.d.ts +5 -5
  259. package/dist-types/server/normalize-url.d.ts +14 -7
  260. package/dist-types/server/types.d.ts +12 -1
  261. package/dist-types/theme-provider.d.ts +2 -2
  262. package/dist-types/transports/hosted.d.ts +36 -0
  263. package/dist-types/transports/manifest.d.ts +48 -0
  264. package/dist-types/transports/offline.d.ts +7 -16
  265. package/dist-types/types/index.d.ts +3 -3
  266. package/dist-types/types/manager.d.ts +1 -1
  267. package/dist-types/types/theme/index.d.ts +1 -1
  268. package/dist-types/ui-config-context.d.ts +14 -2
  269. package/dist-types/utils/deferred-module.d.ts +13 -0
  270. package/dist-types/utils/index.d.ts +4 -4
  271. package/dist-types/utils/merge-slot-props.d.ts +17 -3
  272. package/dist-types/utils/merge-styles.d.ts +1 -1
  273. package/dist-types/utils/theme-utils.d.ts +18 -3
  274. package/dist-types/version.d.ts +1 -1
  275. package/docs/README.md +96 -69
  276. package/docs/assets/v3/bottom-bar.png +0 -0
  277. package/docs/assets/v3/brand-card.png +0 -0
  278. package/docs/assets/v3/brand-preferences.png +0 -0
  279. package/docs/assets/v3/choice-wall.png +0 -0
  280. package/docs/assets/v3/headless-bar-html.png +0 -0
  281. package/docs/assets/v3/headless-bar-mobile.png +0 -0
  282. package/docs/assets/v3/headless-bar.png +0 -0
  283. package/docs/assets/v3/slim-bar.png +0 -0
  284. package/docs/concepts/choose-your-setup.md +138 -0
  285. package/docs/concepts/consent-categories.md +84 -0
  286. package/docs/concepts/consent-state.md +421 -0
  287. package/docs/concepts/data-fetching.md +270 -0
  288. package/docs/concepts/how-consent-works.md +123 -0
  289. package/docs/concepts/modes.md +278 -0
  290. package/docs/{frameworks/react/concepts/policy-presets.md → concepts/policies.md} +8 -60
  291. package/docs/customization/class-names.md +202 -0
  292. package/docs/customization/dark-mode.md +157 -0
  293. package/docs/customization/motion.md +128 -0
  294. package/docs/customization/overview.md +68 -33
  295. package/docs/customization/recipes.md +838 -47
  296. package/docs/customization/slots.md +217 -35
  297. package/docs/customization/stylesheets.md +248 -0
  298. package/docs/customization/tailwind.md +863 -0
  299. package/docs/customization/tokens.md +167 -36
  300. package/docs/customization/translations.md +87 -3
  301. package/docs/frameworks/react/callbacks.md +118 -0
  302. package/docs/frameworks/react/clear-on-revocation.md +106 -0
  303. package/docs/frameworks/react/components/consent-banner.md +48 -27
  304. package/docs/frameworks/react/components/consent-dialog-link.md +13 -11
  305. package/docs/frameworks/react/components/consent-dialog-trigger.md +86 -76
  306. package/docs/frameworks/react/components/consent-dialog.md +111 -58
  307. package/docs/frameworks/react/components/{frame.md → consent-gate.md} +70 -49
  308. package/docs/frameworks/react/components/consent-provider.md +140 -0
  309. package/docs/frameworks/react/components/consent-widget.md +69 -24
  310. package/docs/frameworks/react/components/dev-tools.md +76 -85
  311. package/docs/frameworks/react/components.md +113 -0
  312. package/docs/frameworks/react/compose.md +354 -0
  313. package/docs/frameworks/react/content-security-policy.md +143 -0
  314. package/docs/frameworks/react/customize.md +258 -0
  315. package/docs/frameworks/react/embeds.md +89 -0
  316. package/docs/frameworks/react/gpp.md +163 -0
  317. package/docs/frameworks/react/headless.md +4 -4
  318. package/docs/frameworks/react/hooks.md +70 -0
  319. package/docs/frameworks/react/iab.md +259 -0
  320. package/docs/frameworks/react/network-blocker.md +140 -0
  321. package/docs/frameworks/react/quickstart.md +220 -102
  322. package/docs/frameworks/react/rendering.md +263 -0
  323. package/docs/frameworks/react/scripts.md +114 -0
  324. package/docs/frameworks/react/translations.md +155 -0
  325. package/docs/frameworks/react/troubleshooting.md +188 -61
  326. package/docs/frameworks/react/upgrade-v3.md +651 -0
  327. package/docs/frameworks/react/vendor-consent.md +188 -0
  328. package/docs/guides/banner-experiments.md +672 -0
  329. package/docs/guides/troubleshooting.md +192 -54
  330. package/docs/guides/verify-consent.md +96 -49
  331. package/docs/integrations/adobe-analytics.md +177 -183
  332. package/docs/integrations/ahrefs-analytics.md +162 -178
  333. package/docs/integrations/amplitude.md +172 -180
  334. package/docs/integrations/building-integrations.md +137 -33
  335. package/docs/integrations/clearbit.md +164 -178
  336. package/docs/integrations/cloudflare-web-analytics.md +166 -180
  337. package/docs/integrations/cloudflare-zaraz.md +333 -0
  338. package/docs/integrations/crisp.md +174 -182
  339. package/docs/integrations/databuddy.md +167 -197
  340. package/docs/integrations/fathom-analytics.md +168 -180
  341. package/docs/integrations/front-chat.md +308 -0
  342. package/docs/integrations/google-maps.md +142 -108
  343. package/docs/integrations/google-tag-manager.md +258 -185
  344. package/docs/integrations/google-tag.md +226 -182
  345. package/docs/integrations/heap.md +173 -179
  346. package/docs/integrations/hightouch.md +171 -181
  347. package/docs/integrations/hotjar.md +169 -179
  348. package/docs/integrations/intercom.md +193 -177
  349. package/docs/integrations/klaviyo.md +473 -0
  350. package/docs/integrations/linkedin-insights.md +184 -174
  351. package/docs/integrations/logrocket.md +170 -180
  352. package/docs/integrations/matomo-analytics.md +198 -202
  353. package/docs/integrations/meta-pixel.md +198 -174
  354. package/docs/integrations/microsoft-clarity.md +173 -179
  355. package/docs/integrations/microsoft-uet.md +158 -178
  356. package/docs/integrations/mixpanel-analytics.md +165 -184
  357. package/docs/integrations/one-dollar-stats.md +292 -0
  358. package/docs/integrations/openai-pixel.md +214 -325
  359. package/docs/integrations/overview.md +152 -83
  360. package/docs/integrations/pinterest-tag.md +315 -0
  361. package/docs/integrations/pirsch.md +179 -183
  362. package/docs/integrations/plausible-analytics.md +182 -182
  363. package/docs/integrations/posthog.md +323 -264
  364. package/docs/integrations/promptwatch.md +164 -178
  365. package/docs/integrations/reddit-pixel.md +195 -181
  366. package/docs/integrations/rudderstack.md +211 -210
  367. package/docs/integrations/rybbit-analytics.md +181 -184
  368. package/docs/integrations/segment.md +192 -178
  369. package/docs/integrations/sentry.md +402 -0
  370. package/docs/integrations/snapchat-pixel.md +196 -180
  371. package/docs/integrations/tiktok-pixel.md +181 -174
  372. package/docs/integrations/umami-analytics.md +173 -182
  373. package/docs/integrations/vercel-analytics.md +176 -181
  374. package/docs/integrations/x-pixel.md +186 -174
  375. package/docs/integrations/youtube.md +150 -111
  376. package/package.json +48 -17
  377. package/dist/component-hooks/use-manager.js +0 -2
  378. package/dist/components/frame/atoms.js +0 -1
  379. package/dist/components/frame/frame.js +0 -2
  380. package/dist/components/frame/index.js +0 -2
  381. package/dist/frame.js +0 -2
  382. package/dist/ui-save.js +0 -1
  383. package/dist-types/component-hooks/use-manager.d.ts +0 -40
  384. package/dist-types/components/frame/atoms.d.ts +0 -11
  385. package/dist-types/components/frame/frame.d.ts +0 -2
  386. package/dist-types/components/frame/index.d.ts +0 -24
  387. package/dist-types/frame.d.ts +0 -1
  388. package/dist-types/ui-save.d.ts +0 -5
  389. package/docs/assets/v3/brand-bar.png +0 -0
  390. package/docs/assets/v3/mobile-card.png +0 -0
  391. package/docs/assets/v3/preferences.png +0 -0
  392. package/docs/frameworks/react/components/consent-manager-provider.md +0 -62
  393. package/docs/frameworks/react/concepts/consent-categories.md +0 -33
  394. package/docs/frameworks/react/hooks/use-consent-manager/overview.md +0 -58
  395. package/docs/frameworks/react/iab/overview.md +0 -53
  396. package/docs/frameworks/react/script-loader.md +0 -55
  397. package/docs/frameworks/react/styling/overview.md +0 -207
  398. package/docs/guides/consent-state.md +0 -60
  399. package/docs/guides/data-fetching.md +0 -163
  400. package/docs/guides/deployment-modes.md +0 -63
  401. package/docs/upgrade-v3.md +0 -334
  402. package/readme.json +0 -48
  403. package/src/iab/styles.css +0 -11
  404. package/src/styles.css +0 -10
  405. /package/dist/components/{frame → consent-gate}/types.js +0 -0
@@ -1,210 +1,153 @@
1
1
  ---
2
2
  title: Google Tag Manager
3
- description: Load GTM with c15t consent signals and verify the tags inside your container.
3
+ description: Load a Google Tag Manager container before or after consent with
4
+ c15t Consent Mode v2 signals, configure consent checks inside the container,
5
+ and verify both in DevTools.
6
+ icon: google-tag-manager
4
7
  group: integrations
5
8
  ---
6
9
 
7
- ## Register the container
10
+ ## Configure Google Tag Manager
8
11
 
9
- | Package manager | Command |
10
- | :-------------- | :-------------------------- |
11
- | npm | `npm install @c15t/scripts` |
12
- | pnpm | `pnpm add @c15t/scripts` |
13
- | yarn | `yarn add @c15t/scripts` |
14
- | bun | `bun add @c15t/scripts` |
12
+ Copy the container ID, which starts with `GTM-`, from your GTM workspace.
13
+ Remove the existing GTM snippet, its `<noscript>` iframe and any framework
14
+ plugin that loads the same container.
15
+
16
+ | Package manager | Command |
17
+ | :-------------- | :------------------------------------- |
18
+ | npm | `npm install @c15t/integrations@alpha` |
19
+ | pnpm | `pnpm add @c15t/integrations@alpha` |
20
+ | yarn | `yarn add @c15t/integrations@alpha` |
21
+ | bun | `bun add @c15t/integrations@alpha` |
15
22
 
16
23
  ```ts title="src/consent-scripts.ts"
17
- import { googleTagManager } from '@c15t/scripts/google-tag-manager';
24
+ import { googleTagManager } from '@c15t/integrations/google-tag-manager';
18
25
 
19
26
  export const scripts = [googleTagManager({ id: 'GTM-XXXXXXX' })];
20
27
  ```
21
28
 
22
- Replace the container ID and pass `scripts` to your existing provider options.
23
- Remove the previous GTM snippet and any duplicate framework integration. The
24
- helper sends a `consent-update` event after consent changes; `updateEventName`
25
- customizes that event name.
26
-
27
29
  ## Register the scripts
28
30
 
29
- Complete your [framework quickstart](https://c15t.com/docs/frameworks) first. Keep its Inth
31
+ Complete your [framework quickstart](https://v3.c15t.com/docs/frameworks) first. Keep its Inth
30
32
  endpoint, policy, styles and consent UI. Remove the vendor's original script,
31
- SDK initializer or tag-manager entry so c15t owns loading once.
33
+ SDK initializer or tag-manager entry, so the vendor loads only through c15t.
32
34
 
33
- The `scripts` export in `src/consent-scripts.ts` is a configuration, not an
34
- initializer. Add it to your existing consent owner using the registration point
35
- below. These are partial edits to that owner, not additional providers.
35
+ The vendor pages put the helper in `src/consent-scripts.ts`. If your framework
36
+ quickstart already has a `scripts` array, such as the one in `c15t.config.ts`
37
+ in the Next.js guide, add the helper to that array instead of creating a
38
+ second file.
39
+ The `scripts` export is a configuration, not an initializer. Add it to the c15t provider you already have, at the registration
40
+ point for your framework below. These are edits to that provider, not a second
41
+ provider.
36
42
 
37
43
  **Next.js**
38
44
 
39
- Import the configuration into the client boundary from your router guide:
40
-
41
- ```ts
42
- import { ConsentRoot } from 'c15t/next';
43
- import { scripts } from './consent-scripts';
44
- ```
45
+ Add the configuration to `scripts` in `c15t.config.ts`, next to
46
+ `next.config.ts`:
45
47
 
46
- Keep the server-resolved `state` and shared `consentConfig` from your
47
- router guide. Its manifest, init and save URLs stay in effect. Add
48
- `scripts` as a top-level prop on the existing root:
48
+ ```ts title="c15t.config.ts"
49
+ import { defineConsentConfig } from 'c15t/next';
50
+ import { scripts } from './src/consent-scripts';
49
51
 
50
- ```tsx
51
- <ConsentRoot state={state} config={consentConfig} scripts={scripts}>
52
- {children}
53
- </ConsentRoot>
52
+ export default defineConsentConfig({ scripts });
54
53
  ```
55
54
 
56
- For a Pages Router or static-export setup using `ConsentProvider`, add
57
- `scripts` to its existing `options` instead. Keep the router-specific setup
58
- from [Next.js script loading](https://c15t.com/docs/frameworks/next/script-loader).
55
+ Keep the rest of your config, such as `mode` and `routePrefix`, in the
56
+ same call. `ConsentRoot` reads the config in the browser, so the layout
57
+ keeps passing only `state`. App Router, Pages Router and static export all
58
+ read the same file. See
59
+ [Next.js scripts and embeds](https://v3.c15t.com/docs/frameworks/next/scripts).
59
60
 
60
61
  **TanStack Start**
61
62
 
62
- In your existing root route component, import the scripts alongside
63
- `ConsentRoot`. Keep the server loader from the [TanStack Start quickstart](https://c15t.com/docs/frameworks/tanstack-start/quickstart).
63
+ Import the configuration into your root route and pass it to the existing
64
+ `ConsentRoot` as a top-level prop. Keep the loader from the
65
+ [TanStack Start quickstart](https://v3.c15t.com/docs/frameworks/tanstack-start/quickstart):
64
66
 
65
- ```tsx
66
- import { Outlet } from '@tanstack/react-router';
67
- import { ConsentRoot } from 'c15t/tanstack-start';
67
+ ```tsx title="src/routes/__root.tsx"
68
68
  import { scripts } from '../consent-scripts';
69
69
 
70
- function Root() {
71
- const state = Route.useLoaderData();
72
- return (
73
- <ConsentRoot state={state} backendURL={backendURL} initRoute={false} scripts={scripts}>
74
- <Outlet />
75
- {/* Keep your consent banner, dialog and preferences link here. */}
76
- </ConsentRoot>
77
- );
78
- }
70
+ <ConsentRoot state={consent} scripts={scripts}>
79
71
  ```
80
72
 
81
- This edits the existing route. `Route` and `backendURL` come from its setup;
82
- keep the document shell and head components if they are part of your root.
83
- `initRoute={false}` keeps the quickstart's direct-backend initialization.
84
- If your app mounts a consent server route, retain its existing `initRoute`
85
- instead. Do not return script callbacks from a server function or route loader.
73
+ Import vendor helpers in the root route module, not in a server function.
74
+ A server function's return value must be serializable, and script
75
+ configurations carry callbacks. See
76
+ [TanStack Start scripts](https://v3.c15t.com/docs/frameworks/tanstack-start/scripts).
86
77
 
87
78
  **React**
88
79
 
89
- Import the scripts into your existing provider component:
80
+ Add the configuration to the existing `ConsentProvider` options, next to
81
+ `mode`:
90
82
 
91
- ```ts
92
- import { ConsentProvider } from 'c15t/react';
83
+ ```tsx title="src/consent.tsx"
93
84
  import { scripts } from './consent-scripts';
94
- ```
95
85
 
96
- Keep the existing options and add `scripts`:
97
-
98
- ```tsx
99
- <ConsentProvider options={{ ...consentOptions, scripts }}>
100
- {children}
101
- </ConsentProvider>
86
+ <ConsentProvider options={{ mode, scripts }}>
102
87
  ```
103
88
 
104
- Here `consentOptions` is your existing configuration, including
105
- `mode: hosted({ url: backendURL })`. Keep the banner, dialog and preferences
106
- link inside the provider. See [React script loading](../frameworks/react/script-loader.md).
89
+ `mode` is the `manifest()` value from the
90
+ [React quickstart](../frameworks/react/quickstart.md). Keep the banner,
91
+ dialog and preferences link inside the provider. See
92
+ [React scripts and embeds](../frameworks/react/scripts.md).
107
93
 
108
94
  **Nuxt**
109
95
 
110
- Attach one loader from the root `app.vue`, after the Nuxt module has
111
- started its browser runtime. This keeps vendor callbacks in application code rather
112
- than serialized `nuxt.config.ts` runtime configuration.
96
+ Register the scripts under the `c15t` key in `app/app.config.ts`. Adjust the
97
+ relative import to where you created `consent-scripts.ts`:
113
98
 
114
- ```vue title="app/app.vue"
115
- <script setup lang="ts">
116
- import { onUnmounted } from 'vue';
117
- import { createScriptLoader } from 'c15t/modules/script-loader';
99
+ ```ts title="app/app.config.ts"
118
100
  import { scripts } from '../src/consent-scripts';
119
101
 
120
- const nuxtApp = useNuxtApp();
121
- const kernel = useConsentKernel();
122
- let loader: ReturnType<typeof createScriptLoader> | undefined;
123
-
124
- const removeMountedHook = nuxtApp.hook('app:mounted', () => {
125
- loader = createScriptLoader({ kernel, scripts });
126
- });
127
- onUnmounted(() => {
128
- removeMountedHook();
129
- loader?.dispose();
102
+ export default defineAppConfig({
103
+ c15t: { scripts },
130
104
  });
131
- </script>
132
-
133
- <template>
134
- <ConsentRoot />
135
- <NuxtPage />
136
- </template>
137
105
  ```
138
106
 
139
- Merge the setup code into your root and retain its footer and preferences
140
- link. `useConsentKernel` is auto-imported by the c15t Nuxt module. Adjust the
141
- relative script import if your `app.vue` is at the project root. This loader
142
- waits until the module has applied browser persistence and privacy signals,
143
- then reads the current snapshot and observes future changes. Do not also register these scripts
144
- in another loader. See the [Nuxt quickstart](https://c15t.com/docs/frameworks/nuxt/quickstart).
107
+ The Nuxt module merges this over its options in `nuxt.config.ts` and starts
108
+ one script loader in the browser after hydration, once it has applied the
109
+ visitor's stored choice and privacy signals. Keep `scripts` out of
110
+ `nuxt.config.ts`, which reaches the browser as JSON and drops the vendor
111
+ callbacks. Write the vendor IDs into `consent-scripts.ts`. See
112
+ [Nuxt scripts and embeds](https://v3.c15t.com/docs/frameworks/nuxt/scripts).
145
113
 
146
114
  **Vue**
147
115
 
148
- Use the kernel already provided by the Vue plugin. Merge this setup into
149
- `App.vue`, whose lifetime covers the application:
116
+ Pass the scripts to the existing `c15tVue` plugin call in `src/main.ts`:
150
117
 
151
- ```vue title="src/App.vue"
152
- <script setup lang="ts">
153
- import { onMounted, onUnmounted } from 'vue';
154
- import { createScriptLoader } from 'c15t/modules/script-loader';
155
- import { useConsentKernel } from 'c15t/vue/vue-plugin';
156
- import ConsentRoot from 'c15t/vue/consent-root';
118
+ ```ts title="src/main.ts"
119
+ import { c15tVue, manifest } from 'c15t/vue/vue-plugin';
157
120
  import { scripts } from './consent-scripts';
158
121
 
159
- const kernel = useConsentKernel();
160
- let loader: ReturnType<typeof createScriptLoader> | undefined;
161
-
162
- onMounted(() => {
163
- loader = createScriptLoader({ kernel, scripts });
122
+ app.use(c15tVue, {
123
+ mode: manifest(),
124
+ scripts,
164
125
  });
165
- onUnmounted(() => loader?.dispose());
166
- </script>
167
-
168
- <template>
169
- <ConsentRoot />
170
- <main>Your application</main>
171
- </template>
172
126
  ```
173
127
 
174
- Keep your existing page content and preferences link. The plugin still owns
175
- the kernel and persistence; this component owns only the vendor loader.
176
- Do not register the same scripts in plugin configuration as well. See the
177
- [Vue quickstart](https://c15t.com/docs/frameworks/vue/quickstart).
128
+ Keep your existing `mode` and other options. The plugin starts one
129
+ script loader when the app mounts, after it has applied the visitor's stored
130
+ choice. Do not also call `createScriptLoader` from a component. See
131
+ [Vue scripts and embeds](https://v3.c15t.com/docs/frameworks/vue/scripts).
178
132
 
179
133
  **Astro**
180
134
 
181
- Point the existing Astro integration at a client module. Keep its `mode`,
182
- `ui` and framework integration from the [Astro quickstart](https://c15t.com/docs/frameworks/astro/quickstart).
183
- Import `fileURLToPath` in your Astro configuration:
184
-
185
- ```js title="astro.config.mjs"
186
- import { fileURLToPath } from 'node:url';
187
- ```
188
-
189
- Add this option to the existing `c15t({ ... })` call. Resolve the path from
190
- the configuration file because Astro injects the import into a virtual module:
191
-
192
- ```js
193
- clientEntrypoint: fileURLToPath(new URL('./src/c15t.client.ts', import.meta.url)),
194
- ```
195
-
196
- Export the scripts from that module:
135
+ Add the scripts to the client entrypoint from the
136
+ [Astro quickstart](https://v3.c15t.com/docs/frameworks/astro/quickstart), `src/c15t.client.ts`,
137
+ which the integration finds on its own. Keep `astro.config.mjs` as it is.
138
+ If the module already exports scripts, combine the two arrays.
197
139
 
198
140
  ```ts title="src/c15t.client.ts"
199
- import type { C15tClientOptionsExtension } from '@c15t/astro';
141
+ import type { C15tClientOptionsExtension } from 'c15t/astro';
200
142
  import { scripts } from './consent-scripts';
201
143
 
202
144
  export default { scripts } satisfies C15tClientOptionsExtension;
203
145
  ```
204
146
 
205
- The integration passes this extension to its shared browser runtime. Vendor
206
- helpers contain callbacks, so do not put them in the serialized `scripts`
207
- option in `astro.config.mjs`. Keep one runtime across consent islands and
147
+ Vendor helpers contain callbacks, and the integration options in
148
+ `astro.config.mjs` are serialized into the page, so do not put helpers in
149
+ the integration's `scripts` option. The integration passes the client
150
+ entrypoint to the one runtime every page shares, including across
208
151
  `ClientRouter` navigation.
209
152
 
210
153
  **Svelte**
@@ -214,73 +157,156 @@ pass them as a top-level prop:
214
157
 
215
158
  ```svelte title="src/App.svelte"
216
159
  <script lang="ts">
217
- import { ConsentManagerProvider, hosted } from '@c15t/svelte';
160
+ import { ConsentProvider, manifest } from '@c15t/svelte';
218
161
  import { scripts } from './consent-scripts';
219
-
220
- const backendURL = import.meta.env.VITE_C15T_BACKEND_URL;
221
- if (!backendURL) throw new Error('Set VITE_C15T_BACKEND_URL');
222
- const mode = hosted({ url: backendURL });
223
162
  </script>
224
163
 
225
- <ConsentManagerProvider {mode} {scripts}>
164
+ <ConsentProvider mode={manifest()} {scripts}>
226
165
  <!-- Keep your application, consent UI and preferences link here. -->
227
- </ConsentManagerProvider>
166
+ </ConsentProvider>
228
167
  ```
229
168
 
230
- Retain the styles and consent UI from the [Svelte quickstart](https://c15t.com/docs/frameworks/svelte/quickstart).
169
+ Retain the styles and consent UI from the [Svelte quickstart](https://v3.c15t.com/docs/frameworks/svelte/quickstart).
231
170
  The provider owns the loader and disposes it on unmount.
232
171
 
233
172
  **SvelteKit**
234
173
 
235
- Add the scripts to the existing root layout provider. Keep the server load
236
- and its serializable prefetch data from the [SvelteKit quickstart](https://c15t.com/docs/frameworks/sveltekit/quickstart).
174
+ Add the scripts to the existing `ConsentRoot` in the root layout. Keep the
175
+ handle and the layout load from the [SvelteKit quickstart](https://v3.c15t.com/docs/frameworks/sveltekit/quickstart).
237
176
 
238
177
  ```svelte title="src/routes/+layout.svelte"
239
178
  <script lang="ts">
240
- import { ConsentManagerProvider, hosted } from '@c15t/svelte';
179
+ import { ConsentRoot } from '@c15t/svelte';
241
180
  import { scripts } from '../consent-scripts';
242
181
 
243
182
  let { children, data } = $props();
244
- const mode = hosted({ url: data.backendURL });
245
183
  </script>
246
184
 
247
- <ConsentManagerProvider {mode} {scripts} prefetch={data.prefetch}>
185
+ <ConsentRoot state={data.consent} {scripts}>
248
186
  {@render children()}
249
187
  <!-- Keep your consent UI and preferences link here. -->
250
- </ConsentManagerProvider>
188
+ </ConsentRoot>
251
189
  ```
252
190
 
253
- Import vendor helpers in the layout component, not in `+layout.server.ts`.
254
- For static hosting, keep your browser-only `mode` setup and omit request
255
- prefetch; the `scripts` prop stays the same. If you pass an externally owned
191
+ Import vendor helpers in the layout component, not in `+layout.server.ts`:
192
+ a server load cannot send functions to the browser. Prerendered, static and
193
+ SPA-mode pages use the same `scripts` prop. If you pass an externally owned
256
194
  `runtime` to the provider, register scripts when creating that runtime instead.
257
195
 
196
+ **HTML**
197
+
198
+ The helpers in `@c15t/integrations` are ES modules that need a bundler. On a
199
+ page that loads the c15t script tag, paste the vendor's own snippet instead
200
+ and keep it inert until its category is allowed:
201
+
202
+ ```html
203
+ <script type="text/plain" data-c15t-category="measurement">
204
+ // The vendor's snippet, unchanged
205
+ </script>
206
+ ```
207
+
208
+ Use the category this guide names for the vendor. c15t runs the snippet
209
+ once that category is allowed, and reloads the page when the visitor
210
+ withdraws it. Helper options on this page, such as `loadMode`, do not apply
211
+ to a pasted snippet. See [HTML scripts](https://v3.c15t.com/docs/frameworks/html/scripts).
212
+
258
213
  **JavaScript**
259
214
 
260
- Attach the loader to your existing kernel before calling
261
- `kernel.commands.init()`:
215
+ Pass the scripts to `init()` from `@c15t/browser`, next to your mode:
262
216
 
263
217
  ```ts
264
- import { createScriptLoader } from 'c15t/modules/script-loader';
218
+ import { init, manifest } from '@c15t/browser';
265
219
  import { scripts } from './consent-scripts';
266
220
 
267
- const loader = createScriptLoader({ kernel, scripts });
221
+ const consent = init({
222
+ mode: manifest(),
223
+ scripts,
224
+ });
268
225
  ```
269
226
 
270
- Call `loader.dispose()` when that application instance is destroyed.
271
- `kernel` is the hosted kernel from your quickstart. A provider-owned kernel
272
- already has a loader; do not attach a second one. See
273
- [JavaScript script loading](https://c15t.com/docs/frameworks/javascript/script-loader).
227
+ Keep the mode from your quickstart. With
228
+ `createConsentRuntime` from `c15t/runtime`, pass `scripts` to it instead.
229
+ A kernel you create yourself needs a loader from
230
+ `c15t/modules/script-loader`. Attach one loader per kernel. See
231
+ [JavaScript scripts](https://v3.c15t.com/docs/frameworks/javascript/scripts).
232
+
233
+ ## Options
234
+
235
+ | Option | Default | Behavior |
236
+ | ----------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
237
+ | `id` | Required | Container ID, for example `GTM-1234XXX`. The helper trims it. Empty or whitespace-only values log an error and the script does not load. |
238
+ | `dataLayer` | `'dataLayer'` | Queue name. A custom name adds `&l=<name>` to the container URL and renames the helper's queue function to `<name>Gtag`. |
239
+ | `updateEventName` | `'consent-update'` | `dataLayer` event pushed after every consent update. Use it as a GTM trigger. |
240
+ | `consentMapping` | The table below | Replaces the category-to-Google mapping. |
241
+ | `loadMode` | `'always'` | When `gtm.js` loads. See [choose when the container loads](#choose-when-the-container-loads). |
242
+ | `category` | `'necessary'`, or `{ or: ['measurement', 'marketing'] }` with `loadMode: 'after-consent'` | Consent condition for the container. With `'after-consent'`, `gtm.js` waits for it. With `'always'`, it sets the script's permission, which callbacks receive, but does not delay loading. |
274
243
 
275
- ## Consent Mode is not a zero-request gate
244
+ ## Choose when the container loads
276
245
 
277
- This helper sets `alwaysLoad: true`. It prepares the Google queue, sends consent
278
- defaults and updates, and loads Google's script even before a visitor makes a
279
- choice. That is different from preventing any request to Google until consent.
280
- Google describes the distinction in its
246
+ | `loadMode` | Until the category is allowed | After the category is allowed |
247
+ | ----------------- | ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
248
+ | `'always'` | Loads `gtm.js` and sends `consent` `default` with the current permissions before the `gtm.js` start event. | Sends `consent` `update`, then the `consent-update` event. |
249
+ | `'after-consent'` | Sends nothing to Google. The helper creates no `dataLayer` or `gtag` function. | Loads `gtm.js` once. `consent` `default` carries the current permissions and comes before the `gtm.js` start event. Later changes send `update` and `consent-update`. |
250
+
251
+ Use `'after-consent'` when your policy forbids any request to Google before
252
+ the visitor opts in:
253
+
254
+ ```ts title="src/consent-scripts.ts (partial)"
255
+ googleTagManager({ id: 'GTM-XXXXXXX', loadMode: 'after-consent' }),
256
+ ```
257
+
258
+ `'after-consent'` waits for the category to be allowed, not for a recorded
259
+ choice. Under an `opt-in` policy, that happens when the visitor allows it.
260
+ Under an `opt-out` or `none` policy, optional categories are allowed before a
261
+ choice, so `gtm.js` loads on the first page unless a saved refusal or a
262
+ privacy signal restricts the category; see
263
+ [policies](../concepts/policies.md).
264
+
265
+ `necessary` is always allowed, so a gated container needs another category.
266
+ This mode defaults to `{ or: ['measurement', 'marketing'] }`. A container
267
+ usually holds Analytics tags and advertising tags, and this default loads it
268
+ once the visitor allows either purpose. Google tags inside still follow the
269
+ Consent Mode types, so an Ads tag stays restricted for a visitor who allowed
270
+ only measurement. If the container holds only Analytics tags, pass
271
+ `category: 'measurement'`.
272
+
273
+ This mode gives up part of Consent Mode. With `'always'`, Google tags send
274
+ cookieless pings while a type is denied, and Google uses them to model
275
+ conversions and behavior for visitors who refused or have not chosen. With
276
+ `'after-consent'`, visitors whose category is denied send nothing, so Google
277
+ has no data to model them from. Reports cover only visitors who allowed the
278
+ category.
279
+
280
+ The container starts with the visitor's current choice in its `default`
281
+ command. On the page where the visitor accepts, it loads after the choice, so
282
+ no `consent-update` event fires for that choice. Triggers that wait only for
283
+ `consent-update` first fire on a later change. Use the tag's consent settings,
284
+ described below, for tags that should fire on the first page.
285
+
286
+ When the visitor withdraws the category, c15t reloads the page and the new
287
+ page does not load `gtm.js`. With `reloadOnConsentRevoked: false`, the running
288
+ container stays on the page and gets an `update` that denies the withdrawn
289
+ types. A later grant reuses it instead of starting a second container.
290
+
291
+ ## Google loads before a choice by default
292
+
293
+ With the default `loadMode: 'always'`, the `googleTagManager` and `gtag`
294
+ helpers set `alwaysLoad: true`. Before the visitor chooses, the helper creates
295
+ the `dataLayer` queue, sends `gtag('consent', 'default', ...)` with the current
296
+ permissions and loads Google's script. After each permission change it sends
297
+ `gtag('consent', 'update', ...)`. Google's tags then adjust what they store and
298
+ send; see Google's
281
299
  [Consent Mode overview](https://developers.google.com/tag-platform/security/concepts/consent-mode).
282
300
 
283
- The default mapping is:
301
+ So the browser contacts Google before consent. If your policy requires no
302
+ Google request until the visitor allows it, set `loadMode: 'after-consent'`.
303
+ The helper then creates nothing and requests nothing until its category is
304
+ allowed. When it loads, it sends the `default` command first, with the
305
+ permissions at that moment, and `update` commands after later changes. Under
306
+ an `opt-out` or `none` policy, optional categories are allowed before a
307
+ choice, so the helper loads on the first page.
308
+
309
+ ## How categories map to Google consent types
284
310
 
285
311
  | c15t category | Google consent types |
286
312
  | --------------- | -------------------------------------------------- |
@@ -290,17 +316,64 @@ The default mapping is:
290
316
  | `marketing` | `ad_storage`, `ad_user_data`, `ad_personalization` |
291
317
  | `experience` | `personalization_storage` |
292
318
 
293
- `consentMapping` replaces the mapping when supplied. Keep the full set of
294
- signals your integration needs. Test both default and update commands and the
295
- actual tag behavior. Do not infer a saved grant from an allowed default under an
296
- opt-out policy.
297
-
298
- ## Configure the container too
299
-
300
- Loading GTM with consent signals does not make every custom tag consent-aware.
301
- Configure the appropriate consent checks and triggers for tags inside the
302
- container. Inspect their requests after rejection and revocation, including
303
- non-Google tags. Use Google Tag Assistant alongside the browser Network panel.
304
-
305
- If the requirement is no Google request before permission, do not deploy this
306
- always-loaded helper unchanged. Choose and verify an explicitly gated setup.
319
+ Each Google type is `granted` when its category is allowed and `denied`
320
+ otherwise. If a visitor turns off the helper's vendor, every optional type is
321
+ sent as `denied`. The `consentMapping` option replaces the whole table, so
322
+ include every category you still want signalled.
323
+
324
+ Under an opt-out policy, the default command can grant types before the
325
+ visitor has chosen anything. That is a permission, not a recorded choice.
326
+
327
+ ## Configure consent inside the container
328
+
329
+ With the default `loadMode: 'always'`, `googleTagManager` uses the `necessary`
330
+ category and `alwaysLoad`, so the container loads on every page. With
331
+ `'after-consent'`, it loads once its category is allowed. In both modes,
332
+ consent signals reach Google tags that support Consent Mode. Other tags in the
333
+ container, such as a third-party pixel added as Custom HTML, ignore those
334
+ signals and fire on their triggers.
335
+
336
+ For each non-Google tag, add a consent requirement in the tag's consent
337
+ settings, or fire it from a Custom Event trigger on `consent-update`. If a
338
+ vendor must make no request before consent, remove it from the container and
339
+ register its own c15t helper instead.
340
+
341
+ ## Measure opt-in rate
342
+
343
+ If you run a banner experiment, the backend already counts visitors and
344
+ choices per arm. To see the arm in GTM as well, forward the `onSurfaceShown` and
345
+ `onChoiceRecorded` callbacks, which carry `experiment: { id, arm }`. See
346
+ [banner experiments](../guides/banner-experiments.md#send-the-events-to-your-own-analytics-too).
347
+
348
+ ## Verify Google Tag Manager
349
+
350
+ With the default `loadMode: 'always'`:
351
+
352
+ 1. In a private window with an opt-in policy, load the page. `gtm.js` loads.
353
+ In Google Tag Assistant, the first consent command is `default` with
354
+ `analytics_storage` and `ad_storage` set to `denied`.
355
+ 2. Click Reject, then reload. The `default` command still denies every
356
+ optional type, and in DevTools Network no non-Google tag in the container
357
+ fires.
358
+ 3. Open Privacy settings and allow measurement. Tag Assistant shows an
359
+ `update` command with `analytics_storage` set to `granted`, followed by a
360
+ `consent-update` event, and measurement tags fire.
361
+ 4. Turn measurement off again and save. c15t reloads the page, and the new
362
+ page starts with `analytics_storage` denied.
363
+
364
+ With `loadMode: 'after-consent'`:
365
+
366
+ 1. In a private window with an opt-in policy, filter DevTools Network by
367
+ `google` and load the page. No request appears, and `window.dataLayer` is
368
+ `undefined` in the Console.
369
+ 2. Allow measurement. `gtm.js` loads once. In Tag Assistant, the first command
370
+ is `consent` `default` with `analytics_storage` set to `granted`, before
371
+ the container starts.
372
+ 3. Allow marketing as well. Tag Assistant shows an `update` command that
373
+ grants the ad types, followed by a `consent-update` event. No second
374
+ `gtm.js` request appears.
375
+ 4. Turn both off again and save. c15t reloads the page, and the new page makes
376
+ no request to Google.
377
+
378
+ See the [consent verification guide](../guides/verify-consent.md) for
379
+ navigation and hosting checks.