@c15t/react 3.1.0-canary.0 → 3.1.0

package/README.md

@@ -7,7 +7,7 @@
   </a>
 </p>
 
-# @c15t/react: React Cookie Banner and Consent Components
+# @c15t/react: React cookie banner and cookie consent components
 
 <p>
 <a href="https://www.npmjs.com/package/@c15t/react"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/%40c15t%2Freact.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/npm/%40c15t%2Freact.svg?variant=outline&mode=light" alt="Latest NPM Version"></picture></a>
@@ -18,7 +18,7 @@
 <a href="https://inth.com?utm_source=npm&utm_medium=readme&utm_campaign=oss_readme&utm_content=%40c15t%2Freact"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/Made%20By-Inth-ffc803.svg?color=ffc803&labelTextColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAzOTMgNDAwIj48cGF0aCBmaWxsPSIjMDAwIiBkPSJNMTgyLjY2MiAwdjM2Ljg5NWgtNTkuMDMxdjgyLjczM2g1OS4wMzF2MzYuODkzSDI3LjQ4MnYtMzYuODkzaDU5LjAzVjM2Ljg5NWgtNTkuMDNWMHpNMzIxLjk0MSA4OS44NVYwaDM1LjM1NXYxNTYuNTIxaC0yNS43MTNsLTg2LjEzNy05MC4zNjR2OTAuMzY0aC0zNS4zNTVWMGgyNi4zNTV6Ii8%2BPHBhdGggZmlsbD0iIzAwMCIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzE4LjU3MSAxODUuNzE0aDc0LjI4NlY0MDBIMFYxODUuNzE0aDI3Mi44NTd2LTQ3LjE0M3ptLTI5MS4wOSAyOC45Njl2MzcuMTE4aDU4LjEzN3YxMTkuNjI4aDM2Ljg5NVYyNTEuODAxaDU4LjU4NHYtMzcuMTE4em0xODIuNjEuMjI0djE1Ni41MjJoMzYuODk0VjMxMy41OWg3My4zNDF2NTcuODM5aDM3LjExOFYyMTQuOTA3aC0zNy4xMTh2NjEuNzg4aC03My4zNDF2LTYxLjc4OHoiIGNsaXAtcnVsZT0iZXZlbm9kZCIvPjwvc3ZnPg%3D%3D&valueColor=000000&mode=dark"><img src="https://shieldcn.dev/badge/Made%20By-Inth-ffc803.svg?color=ffc803&labelTextColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAzOTMgNDAwIj48cGF0aCBmaWxsPSIjMDAwIiBkPSJNMTgyLjY2MiAwdjM2Ljg5NWgtNTkuMDMxdjgyLjczM2g1OS4wMzF2MzYuODkzSDI3LjQ4MnYtMzYuODkzaDU5LjAzVjM2Ljg5NWgtNTkuMDNWMHpNMzIxLjk0MSA4OS44NVYwaDM1LjM1NXYxNTYuNTIxaC0yNS43MTNsLTg2LjEzNy05MC4zNjR2OTAuMzY0aC0zNS4zNTVWMGgyNi4zNTV6Ii8%2BPHBhdGggZmlsbD0iIzAwMCIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzE4LjU3MSAxODUuNzE0aDc0LjI4NlY0MDBIMFYxODUuNzE0aDI3Mi44NTd2LTQ3LjE0M3ptLTI5MS4wOSAyOC45Njl2MzcuMTE4aDU4LjEzN3YxMTkuNjI4aDM2Ljg5NVYyNTEuODAxaDU4LjU4NHYtMzcuMTE4em0xODIuNjEuMjI0djE1Ni41MjJoMzYuODk0VjMxMy41OWg3My4zNDF2NTcuODM5aDM3LjExOFYyMTQuOTA3aC0zNy4xMTh2NjEuNzg4aC03My4zNDF2LTYxLjc4OHoiIGNsaXAtcnVsZT0iZXZlbm9kZCIvPjwvc3ZnPg%3D%3D&valueColor=000000&mode=light" alt="Made by Inth"></picture></a>
 </p>
 
-React cookie banner, consent dialog, and preference center for React 18 and 19, with headless hooks when you want your own design.
+React cookie banner, consent dialog, and preference center for React 18 and 19. Each visitor's consent policy decides whether optional cookies wait for an opt-in, as EU cookie rules require, or load until the visitor opts out. Use headless hooks when you want your own design.
 
 c15t is used by [2,100+ sites](https://www.wappalyzer.com/technologies/cookie-compliance/c15t/), including expo.dev, zed.dev, unkey.dev, mintlify.com, and sazabi.com.
 

package/dist/event-dispatcher.js

@@ -0,0 +1,2 @@
+"use client";
+import{getEventDispatcher as e}from"@c15t/core/events";import{useContext as t,useMemo as r}from"react";import{ProviderServicesContext as o}from"./context.js";import{useCommittedRef as c}from"./hooks/use-committed-ref.js";let s=function(s={}){let i=t(o);if(!i)throw Error("c15t: useEventDispatcher() needs <ConsentProvider> from @c15t/react.");let{runtime:n}=i,a=c(s);return r(()=>({pageview:t=>e(n,a.current).pageview(t),track:(t,r)=>e(n,a.current).track(t,r)}),[a,n])};export{s as useEventDispatcher};

package/dist/index-parts/event-dispatcher.js

@@ -0,0 +1 @@
+export{useEventDispatcher}from"../event-dispatcher.js";

package/dist/index.js

@@ -1 +1 @@
-export*from"./index-parts/core.js";export*from"./index-parts/hosted.js";export*from"./index-parts/offline.js";export*from"./index-parts/presets.js";export*from"./index-parts/consent-dialog.js";export*from"./index-parts/consent-banner.js";export*from"./index-parts/consent-dialog-link.js";export*from"./index-parts/consent-dialog-trigger.js";export*from"./index-parts/consent-gate.js";export*from"./index-parts/frame.js";export*from"./index-parts/draft.js";export*from"./index-parts/translations.js";export*from"./index-parts/module-hooks.js";export*from"./index-parts/provider.js";export*from"./index-parts/theme.js";export*from"./index-parts/hooks.js";
+export*from"./index-parts/core.js";export*from"./index-parts/hosted.js";export*from"./index-parts/offline.js";export*from"./index-parts/presets.js";export*from"./index-parts/consent-dialog.js";export*from"./index-parts/consent-banner.js";export*from"./index-parts/consent-dialog-link.js";export*from"./index-parts/consent-dialog-trigger.js";export*from"./index-parts/consent-gate.js";export*from"./index-parts/frame.js";export*from"./index-parts/draft.js";export*from"./index-parts/event-dispatcher.js";export*from"./index-parts/translations.js";export*from"./index-parts/module-hooks.js";export*from"./index-parts/provider.js";export*from"./index-parts/theme.js";export*from"./index-parts/hooks.js";

package/dist/provider.js

@@ -1,2 +1,2 @@
 "use client";
-let e,t;import{jsx as o,jsxs as r}from"react/jsx-runtime";import{applyExperimentAssignment as n,applyExperimentTheme as i,hostExperiment as s,watchRevocationReload as c}from"@c15t/core";import{createPersistence as l,readStoredRecords as a}from"@c15t/core/modules/persistence";import{createWindowDebug as d}from"@c15t/core/modules/window-debug";import{claimEarlyJourney as u,createConsentProviderRuntime as m,earlyInitModes as p,lazyRuntimeModule as h,lazyStreamPrefetch as f,readHostedMode as g,streamPrefetchWith as v}from"@c15t/core/runtime/provider";import{applyThemeSlots as y}from"@c15t/ui/utils";import{useCallback as k,useEffect as S,useLayoutEffect as b,useMemo as w,useReducer as C,useState as x,useSyncExternalStore as j}from"react";import{KernelContext as L,ProviderServicesContext as N,StreamedPrefetchContext as O}from"./context.js";import{ExternalIABProvider as P}from"./external-iab-context.js";import{useColorScheme as D}from"./hooks/use-color-scheme.js";import{useIsHydrated as R}from"./hooks/use-is-hydrated.js";import{createIframeBlockerOnDemand as _}from"./module-hooks/iframe-blocker.js";import{UNCOMMITTED_HOLD_MS as T}from"./module-hooks/network-hold.js";import{V3ThemeProvider as E}from"./theme-provider.js";let q=(e,t)=>{let o,r=!1;return(async()=>{try{let{connectConsentSource:n}=await import("@c15t/core/runtime/controls");r||(o=n(e,t))}catch{}})(),()=>{r=!0,o?.()}},B=async()=>(await import("@c15t/core/modules/script-loader")).createScriptLoader,A=function(e){let t=e.__resolveStreamedInit;return{connectConsentSource:q,createClearOnRevocation:h(async()=>(await import("@c15t/core/modules/clear-on-revocation")).createClearOnRevocation),createIframeBlocker:_,createNetworkBlocker:h(async()=>(await import("@c15t/core/modules/network-blocker")).createNetworkBlocker),createPersistence:l,createScriptLoader:h(B),createWindowDebug:d,preloadScriptLoader:e.__preloadScriptLoader?.(B),streamPrefetch:t?v(t):f,watchRevocationReload:c}},I=new WeakMap,J=new Set,K=(e,t)=>{if("hosted"in e){let o,r;return"hosted"in t&&(o=e.hosted,r=t.hosted,o.fetch===r.fetch&&o.initialData===r.initialData&&JSON.stringify(o)===JSON.stringify(r))}return"mode"in t&&e.fetch===t.fetch&&(e.mode===t.mode||e.mode.sameAs(t.mode))},F=function(o){if("function"!=typeof o)return o;let r=I.get(o);return r||(r=Object.assign(r=>e=(t=()=>o(Object.create(r,{iabEnabled:{value:void 0}})))(),{kind:o.kind}),I.set(o,r)),r},M=function(e){return{...e,mode:F(e.mode),pkg:e.__debugPkg??"@c15t/react"}},V=function(e){let{persistence:t}=e;if(!1===t||e.consentSource)return!1;let o="object"==typeof t?t:{};if(o.skipHydration)return!1;let r=o.now?o.now():Date.now(),{records:n}=a(o.storageConfig??e.storageConfig,r);return!!(n.choice||n.noticeDismissal)},W=function(e){let{journey:t}=e;return JSON.stringify({journey:t?[t.id,t.scope,t.storedChoice]:null,overrides:e.overrides,user:e.user})},z=function(e,t,o){if(!(o&&t.policyPending)||e.prefetch||e.experiment)return;let r=g(e.mode);if(r)return{source:{hosted:{...r,fetch:r.fetch??globalThis.fetch}},storedChoice:V(e)};let n=p.get(e.mode);if(!(!n||V(e))&&n.requestsInit(t.overrides))return{source:{fetch:globalThis.fetch,mode:n},storedChoice:!1}},H=new Set,G=0,Q=function(o,r){let n,i,s,{networkBlocker:c}=o,l=m(M(o),A(o)),a=o,d=!1,p=!1,h=0,f=e;G+=1;let g={expire(){J.delete(s),H.delete(g),clearTimeout(n),d=!0,l.dispose()},holdKey:!1!==o.enabled&&c&&!1!==c.enabled?JSON.stringify(c.rules):null,sequence:G};if("u"<typeof window)p=!0;else{H.add(g),n=setTimeout(g.expire,T);let e=l.kernel.getSnapshot(),c=z(o,e,r);if(c){let{source:r,storedChoice:n}=c,l=u({option:o.journey,storedChoice:n}),a=l?{journey:l,overrides:e.overrides,user:e.user}:{overrides:e.overrides,user:e.user},d=W(a);for(let e of J)e.key===d&&K(e.source,r)&&(i=e);if(!i){let e=t(),o=e.init,n=o(a);n.catch(()=>void 0);let c=!1;e.init=e=>{let t=!c&&W(e)===d;return c=!0,t?n:o(e)},i=s={key:d,source:r,transport:e},J.add(s)}}}let v=function(){if(d)return!1;if(p)return!0;if(p=!0,J.delete(i)&&Object.assign(f,i?.transport),H.delete(g),clearTimeout(n),null!==g.holdKey)for(let e of H)e.sequence<g.sequence&&e.holdKey===g.holdKey&&e.expire();return!0};return{apply(e){e!==a&&(a=e,l.update(M(e)).catch(()=>void 0))},mount(){if(!v())return null;let e=h+=1;return l.start(),()=>{queueMicrotask(()=>{h===e&&l.dispose()})}},runtime:l}},U=function(){let e=null;return{get:(t,o)=>e??=Q(t,o),reset(){e=null}}},X=e=>e+1,Y=()=>()=>void 0,Z=function(e){let[t]=x(U),[,o]=C(X,0),r=R(),n=k(()=>{t.reset(),o()},[t]);return e?{entry:t.get(e,r),rebuild:n}:void 0},$="u"<typeof document?S:b,ee=({entry:e,options:t,rebuild:o})=>($(()=>e.apply(t),[e,t]),S(()=>{let t=e.mount();return t||void o()},[e,o]),null),et=e=>{let{children:t}=e,c=e.options??{},[l]=x(()=>e.runtime),a=Z(l?void 0:c),d=a?.entry.runtime,u=l?e.runtime??l:void 0,m=d??u,p=j(d?d.subscribe:Y,()=>m.kernel,()=>m.kernel),[h]=x(()=>{var e;return l?l.experiment??s(c.experiment,(e=c.prefetch,"function"==typeof e?.then)?void 0:c.prefetch):void 0}),f=d?d.experiment:h,g=u?c.consentCategories:void 0;S(()=>{u&&void 0!==g&&u.setConsentCategories(g)},[u,g]);let{presentation:v}=c,k=w(()=>({clearRecords:()=>m.clearRecords(),getConsentCategories:()=>m.consentCategories,getPresentation:()=>n(v,f,p.getSnapshot().experiment),isStarted:()=>m.started,setLanguage:e=>m.setLanguage(e)}),[f,p,v,m]),b=!!u&&void 0!==c.callbacks;S(()=>{"production"!==process.env.NODE_ENV&&b&&console.warn("c15t ConsentProvider: `options.callbacks` is ignored when you pass `runtime`. Pass them to createConsentRuntime({ callbacks }) instead.")},[b]);let C=j(e=>p.subscribe(e),()=>p.getSnapshot().experiment,()=>p.getServerSnapshot().experiment),R=w(()=>i(c.theme,f,C),[c.theme,f,C]);S(()=>{"production"===process.env.NODE_ENV||!R||!["colors","dark","motion","radius","shadows","spacing","typography"].some(e=>e in R)||document.getElementById("c15t-theme")||console.warn("c15t: `theme` tokens are no longer turned into CSS in the browser. Render <ConsentTheme theme={theme} /> on the server, or put the CSS from generateThemeCSS() in your stylesheet. See https://c15t.com/docs/frameworks/react/customize")},[R]);let _=w(()=>({colorScheme:c.colorScheme,disableAnimation:c.disableAnimation,noStyle:c.noStyle,scrollLock:c.scrollLock,theme:R,trapFocus:c.trapFocus}),[R,c.noStyle,c.disableAnimation,c.scrollLock,c.trapFocus,c.colorScheme]),T=w(()=>({components:y(R?.slots,c.components,"className"),experiment:f,legalLinks:c.legalLinks,nonce:c.nonce,preloadDialog:c.preloadDialog,presentation:c.presentation,styles:c.styles,theme:c.theme}),[R?.slots,c.components,f,c.legalLinks,c.nonce,c.preloadDialog,c.presentation,c.styles,c.theme]);return D(c.colorScheme),o(L.Provider,{value:p,children:o(N.Provider,{value:k,children:r(E,{themeConfig:_,uiConfig:T,children:[a?o(ee,{entry:a.entry,options:c,rebuild:a.rebuild}):null,u?o(P,{runtime:u,children:t}):o(O.Provider,{value:!1===c.streamBanner?void 0:d?.streamed,children:t})]})})})};export{et as ConsentProvider};
+let e,t;import{jsx as o,jsxs as r}from"react/jsx-runtime";import{applyExperimentAssignment as n,applyExperimentTheme as i,hostExperiment as s,watchRevocationReload as c}from"@c15t/core";import{createPersistence as l,readStoredRecords as a}from"@c15t/core/modules/persistence";import{createWindowDebug as d}from"@c15t/core/modules/window-debug";import{claimEarlyJourney as u,createConsentProviderRuntime as m,earlyInitModes as p,lazyRuntimeModule as h,lazyStreamPrefetch as f,readHostedMode as g,streamPrefetchWith as v}from"@c15t/core/runtime/provider";import{applyThemeSlots as y}from"@c15t/ui/utils";import{useCallback as k,useEffect as S,useLayoutEffect as b,useMemo as w,useReducer as C,useState as x,useSyncExternalStore as j}from"react";import{KernelContext as L,ProviderServicesContext as N,StreamedPrefetchContext as O}from"./context.js";import{ExternalIABProvider as P}from"./external-iab-context.js";import{useColorScheme as D}from"./hooks/use-color-scheme.js";import{useIsHydrated as R}from"./hooks/use-is-hydrated.js";import{createIframeBlockerOnDemand as _}from"./module-hooks/iframe-blocker.js";import{UNCOMMITTED_HOLD_MS as T}from"./module-hooks/network-hold.js";import{V3ThemeProvider as E}from"./theme-provider.js";let q=(e,t)=>{let o,r=!1;return(async()=>{try{let{connectConsentSource:n}=await import("@c15t/core/runtime/controls");r||(o=n(e,t))}catch{}})(),()=>{r=!0,o?.()}},B=async()=>(await import("@c15t/core/modules/script-loader")).createScriptLoader,A=function(e){let t=e.__resolveStreamedInit;return{connectConsentSource:q,createClearOnRevocation:h(async()=>(await import("@c15t/core/modules/clear-on-revocation")).createClearOnRevocation),createIframeBlocker:_,createNetworkBlocker:h(async()=>(await import("@c15t/core/modules/network-blocker")).createNetworkBlocker),createPersistence:l,createScriptLoader:h(B),createWindowDebug:d,preloadScriptLoader:e.__preloadScriptLoader?.(B),streamPrefetch:t?v(t):f,watchRevocationReload:c}},I=new WeakMap,J=new Set,K=(e,t)=>{if("hosted"in e){let o,r;return"hosted"in t&&(o=e.hosted,r=t.hosted,o.fetch===r.fetch&&o.initialData===r.initialData&&JSON.stringify(o)===JSON.stringify(r))}return"mode"in t&&e.fetch===t.fetch&&(e.mode===t.mode||e.mode.sameAs(t.mode))},F=function(o){if("function"!=typeof o)return o;let r=I.get(o);return r||(r=Object.assign(r=>e=(t=()=>o(Object.create(r,{iabEnabled:{value:void 0}})))(),{kind:o.kind}),I.set(o,r)),r},M=function(e){return{...e,mode:F(e.mode),pkg:e.__debugPkg??"@c15t/react"}},V=function(e){let{persistence:t}=e;if(!1===t||e.consentSource)return!1;let o="object"==typeof t?t:{};if(o.skipHydration)return!1;let r=o.now?o.now():Date.now(),{records:n}=a(o.storageConfig??e.storageConfig,r);return!!(n.choice||n.noticeDismissal)},W=function(e){let{journey:t}=e;return JSON.stringify({journey:t?[t.id,t.scope,t.storedChoice]:null,overrides:e.overrides,user:e.user})},z=function(e,t,o){if(!(o&&t.policyPending)||e.prefetch||e.experiment)return;let r=g(e.mode);if(r)return{source:{hosted:{...r,fetch:r.fetch??globalThis.fetch}},storedChoice:V(e)};let n=p.get(e.mode);if(!(!n||V(e))&&n.requestsInit(t.overrides))return{source:{fetch:globalThis.fetch,mode:n},storedChoice:!1}},H=new Set,G=0,Q=function(o,r){let n,i,s,{networkBlocker:c}=o,l=m(M(o),A(o)),a=o,d=!1,p=!1,h=0,f=e;G+=1;let g={expire(){J.delete(s),H.delete(g),clearTimeout(n),d=!0,l.dispose()},holdKey:!1!==o.enabled&&c&&!1!==c.enabled?JSON.stringify(c.rules):null,sequence:G};if("u"<typeof window)p=!0;else{H.add(g),n=setTimeout(g.expire,T);let e=l.kernel.getSnapshot(),c=z(o,e,r);if(c){let{source:r,storedChoice:n}=c,l=u({option:o.journey,storedChoice:n}),a=l?{journey:l,overrides:e.overrides,user:e.user}:{overrides:e.overrides,user:e.user},d=W(a);for(let e of J)e.key===d&&K(e.source,r)&&(i=e);if(!i){let e=t(),o=e.init,n=o(a);n.catch(()=>void 0);let c=!1;e.init=e=>{let t=!c&&W(e)===d;return c=!0,t?n:o(e)},i=s={key:d,source:r,transport:e},J.add(s)}}}let v=function(){if(d)return!1;if(p)return!0;if(p=!0,J.delete(i)&&Object.assign(f,i?.transport),H.delete(g),clearTimeout(n),null!==g.holdKey)for(let e of H)e.sequence<g.sequence&&e.holdKey===g.holdKey&&e.expire();return!0};return{apply(e){e!==a&&(a=e,l.update(M(e)).catch(()=>void 0))},mount(){if(!v())return null;let e=h+=1;return l.start(),()=>{queueMicrotask(()=>{h===e&&l.dispose()})}},runtime:l}},U=function(){let e=null;return{get:(t,o)=>e??=Q(t,o),reset(){e=null}}},X=e=>e+1,Y=()=>()=>void 0,Z=function(e){let[t]=x(U),[,o]=C(X,0),r=R(),n=k(()=>{t.reset(),o()},[t]);return e?{entry:t.get(e,r),rebuild:n}:void 0},$="u"<typeof document?S:b,ee=({entry:e,options:t,rebuild:o})=>($(()=>e.apply(t),[e,t]),S(()=>{let t=e.mount();return t||void o()},[e,o]),null),et=e=>{let{children:t}=e,c=e.options??{},[l]=x(()=>e.runtime),a=Z(l?void 0:c),d=a?.entry.runtime,u=l?e.runtime??l:void 0,m=d??u,p=j(d?d.subscribe:Y,()=>m.kernel,()=>m.kernel),[h]=x(()=>{var e;return l?l.experiment??s(c.experiment,(e=c.prefetch,"function"==typeof e?.then)?void 0:c.prefetch):void 0}),f=d?d.experiment:h,g=u?c.consentCategories:void 0;S(()=>{u&&void 0!==g&&u.setConsentCategories(g)},[u,g]);let{presentation:v}=c,k=w(()=>({clearRecords:()=>m.clearRecords(),getConsentCategories:()=>m.consentCategories,getPresentation:()=>n(v,f,p.getSnapshot().experiment),isStarted:()=>m.started,runtime:m,setLanguage:e=>m.setLanguage(e)}),[f,p,v,m]),b=!!u&&void 0!==c.callbacks;S(()=>{"production"!==process.env.NODE_ENV&&b&&console.warn("c15t ConsentProvider: `options.callbacks` is ignored when you pass `runtime`. Pass them to createConsentRuntime({ callbacks }) instead.")},[b]);let C=j(e=>p.subscribe(e),()=>p.getSnapshot().experiment,()=>p.getServerSnapshot().experiment),R=w(()=>i(c.theme,f,C),[c.theme,f,C]);S(()=>{"production"===process.env.NODE_ENV||!R||!["colors","dark","motion","radius","shadows","spacing","typography"].some(e=>e in R)||document.getElementById("c15t-theme")||console.warn("c15t: `theme` tokens are no longer turned into CSS in the browser. Render <ConsentTheme theme={theme} /> on the server, or put the CSS from generateThemeCSS() in your stylesheet. See https://c15t.com/docs/frameworks/react/customize")},[R]);let _=w(()=>({colorScheme:c.colorScheme,disableAnimation:c.disableAnimation,noStyle:c.noStyle,scrollLock:c.scrollLock,theme:R,trapFocus:c.trapFocus}),[R,c.noStyle,c.disableAnimation,c.scrollLock,c.trapFocus,c.colorScheme]),T=w(()=>({components:y(R?.slots,c.components,"className"),experiment:f,legalLinks:c.legalLinks,nonce:c.nonce,preloadDialog:c.preloadDialog,presentation:c.presentation,styles:c.styles,theme:c.theme}),[R?.slots,c.components,f,c.legalLinks,c.nonce,c.preloadDialog,c.presentation,c.styles,c.theme]);return D(c.colorScheme),o(L.Provider,{value:p,children:o(N.Provider,{value:k,children:r(E,{themeConfig:_,uiConfig:T,children:[a?o(ee,{entry:a.entry,options:c,rebuild:a.rebuild}):null,u?o(P,{runtime:u,children:t}):o(O.Provider,{value:!1===c.streamBanner?void 0:d?.streamed,children:t})]})})})};export{et as ConsentProvider};

package/dist/version.js

@@ -1 +1 @@
-let e="3.1.0-canary.0";export{e as version};
+let e="3.1.0";export{e as version};

package/dist-types/context.d.ts

@@ -1,5 +1,5 @@
 import type { AllConsentNames, ConsentKernel, ConsentPresentation, ConsentSnapshot } from '@c15t/core';
-import type { StreamedPrefetch } from '@c15t/core/runtime';
+import type { ConsentRuntime, StreamedPrefetch } from '@c15t/core/runtime';
 /**
  * React context carrying the kernel instance.
  *
@@ -16,6 +16,8 @@ export interface ProviderServices {
     getConsentCategories: () => readonly AllConsentNames[];
     /** Whether the runtime has started: records hydrated, prefetch adopted. */
     isStarted: () => boolean;
+    /** The runtime the provider renders, owned or borrowed. */
+    runtime: ConsentRuntime;
     /**
      * Store a language override and load its copy: init runs again on the
      * provider's own kernel while it is enabled, and a borrowed runtime

package/dist-types/event-dispatcher.d.ts

@@ -0,0 +1,24 @@
+import type { EventDispatcher, RuntimeEventDispatcherOptions } from '@c15t/core/events';
+/**
+ * Get the provider's event dispatcher.
+ *
+ * It delivers to the scripts the provider registered, plus any you pass, and
+ * checks consent when it sends, so a revoked category stops the next event.
+ * The returned object stays the same for the provider's lifetime, and
+ * pageview de-duplication survives navigation, consent changes and the
+ * `enabled` toggle.
+ *
+ * @param options - Extra `scripts`, SPA `pageviews` integrations and
+ * injectable `globals`. The latest committed options apply on each call.
+ * @returns A dispatcher with `track` and `pageview`.
+ * @throws {Error} When called outside `ConsentProvider`.
+ * @example
+ * ```tsx
+ * const events = useEventDispatcher({ pageviews: ['posthog'] });
+ * const pathname = usePathname();
+ * useEffect(() => events.pageview(pathname), [events, pathname]);
+ * ```
+ */
+export declare const useEventDispatcher: (options?: RuntimeEventDispatcherOptions) => EventDispatcher;
+export type { EventDispatcher, EventProperties } from '@c15t/core/events';
+export type { RuntimeEventDispatcherOptions as UseEventDispatcherOptions };

package/dist-types/index-parts/event-dispatcher.d.ts

@@ -0,0 +1,7 @@
+/**
+ * One group of `@c15t/react`'s public exports. The package index re-exports
+ * each group with `export *`, so a bundler that splits code by reachability
+ * (esbuild) does not treat every module the index names as part of an app
+ * that imports one hook: only the groups it uses are live.
+ */
+export { useEventDispatcher } from '../event-dispatcher.js';

package/dist-types/index.d.ts

@@ -40,6 +40,7 @@ export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, Cons
 export type { ConsentWidgetCompoundComponent, ConsentWidgetProps, } from './components/preferences/index.js';
 export type { ConsentGateProps, FrameProps } from './components/consent-gate/index.js';
 export type { ConsentDraftHandle, ConsentDraftProviderProps, VendorDraftHandle, } from './draft.js';
+export type { EventDispatcher, EventProperties, UseEventDispatcherOptions, } from './event-dispatcher.js';
 export type { UseIframeBlockerOptions, UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions, } from './module-hooks.js';
 export type { ConsentProviderOptions, ConsentProviderCallbacks, ConsentProviderPrefetch, ConsentProviderProps, ExternalRuntimeProviderOptions, ExternalRuntimeProviderProps, OwnedRuntimeProviderProps, } from './provider.js';
 export type { ConsentThemeProps } from './consent-theme.js';
@@ -58,6 +59,7 @@ export * from './index-parts/consent-dialog-trigger.js';
 export * from './index-parts/consent-gate.js';
 export * from './index-parts/frame.js';
 export * from './index-parts/draft.js';
+export * from './index-parts/event-dispatcher.js';
 export * from './index-parts/translations.js';
 export * from './index-parts/module-hooks.js';
 export * from './index-parts/provider.js';

package/dist-types/version.d.ts

@@ -1 +1 @@
-export declare const version = "3.1.0-canary.0";
+export declare const version = "3.1.0";

package/docs/concepts/consent-state.md

@@ -136,6 +136,18 @@ writes the v3 format. The upgrade guides for
 [JavaScript](https://c15t.com/docs/frameworks/javascript/upgrade-v3#keep-visitors-existing-choices)
 cover how v3 treats v2 records.
 
+## Retry interrupted saves
+
+Before sending a recorded choice to the backend, c15t puts it in a localStorage
+queue. If the page closes while the request is in flight, the next initialization
+retries it with the original decision time. A successful response removes the
+queued choice. A permanent rejection, such as a stale policy, removes it too.
+
+Queueing depends on the browser allowing storage. When storage is unavailable,
+c15t still attempts the request, but cannot preserve an interrupted request for
+the next page. A locally remembered choice alone does not prove that the backend
+received it; check the saved consent record in Inth.
+
 ## Keep open tabs in step
 
 Tabs and windows on the same origin (scheme, host and port) share the consent

package/docs/frameworks/react/scripts.md

@@ -102,6 +102,50 @@ their vendor slug. See [vendor consent](./vendor-consent.md).
 To send your own events only to allowed integrations, see
 [send events only to allowed integrations](../../integrations/overview.md#send-events-only-to-allowed-integrations).
 
+## Send your own analytics events
+
+`useEventDispatcher()` returns the provider's event dispatcher. It sends to the
+`scripts` you registered and checks consent when an event goes out. Call
+`pageview` from your router with the current path:
+
+```tsx title="src/analytics-events.tsx"
+import { useEventDispatcher } from 'c15t/react';
+import { useEffect } from 'react';
+
+/**
+ * Sends a PostHog pageview for each new path. Call it once, inside
+ * `ConsentProvider`, with your router's current path, such as
+ * `useLocation().pathname` from React Router.
+ */
+export const usePageviews = (path: string) => {
+	const events = useEventDispatcher({ pageviews: ['posthog'] });
+	useEffect(() => {
+		events.pageview(path);
+	}, [events, path]);
+};
+
+export const SearchButton = ({ resultCount }: { resultCount: number }) => {
+	const events = useEventDispatcher();
+	return (
+		<button
+			type="button"
+			onClick={() => {
+				events.track('search', { resultCount });
+			}}
+		>
+			Search
+		</button>
+	);
+};
+```
+
+`track` sends to every registered script with an event API and drops the
+event while measurement is denied. `pageview` sends only to the integrations
+named in `pageviews`, and the first call records the path without sending.
+Every dispatcher shares one pageview history for the provider's lifetime.
+See [send events only to allowed integrations](../../integrations/overview.md#send-events-only-to-allowed-integrations)
+for the supported vendors.
+
 ## Check the scripts
 
 Open DevTools Network in a private window, filter by each vendor's domain and

package/docs/integrations/overview.md

@@ -156,33 +156,56 @@ and embeds group:
 
 ## Send events only to allowed integrations
 
-`createEventDispatcher` from `@c15t/integrations/events` sends one named event to
-every registered integration that has an event API and is allowed right now.
-It drops events while measurement is denied, and one vendor's error does not
-stop delivery to the others:
-
-```ts
-import { createEventDispatcher } from '@c15t/integrations/events';
-
-const events = createEventDispatcher({
-	scripts,
-	getSnapshot: () => runtime.kernel.getSnapshot(),
-	pageviews: ['segment'],
-});
-
-events.track('docs_search', { resultCount: 4 });
-events.pageview(location.pathname);
+The event dispatcher sends one named event to every registered integration
+that has an event API and is allowed right now. It drops events while
+measurement is denied, and one vendor's error does not stop delivery to the
+others. Each framework gives you the provider's dispatcher, so you don't pass
+the scripts or the consent snapshot yourself:
+
+| Framework                      | Get the dispatcher                                                             |
+| ------------------------------ | ------------------------------------------------------------------------------ |
+| React, Next.js, TanStack Start | `useEventDispatcher()` from `c15t/react`, `c15t/next` or `c15t/tanstack-start` |
+| Vue, Nuxt                      | `useEventDispatcher()` from `c15t/vue/vue-plugin`, auto-imported in Nuxt       |
+| Svelte, SvelteKit              | `getEventDispatcher()` from `@c15t/svelte`, called inside `ConsentProvider`    |
+| Astro                          | `getEventDispatcher()` from `c15t/astro/client`                                |
+| JavaScript                     | `getEventDispatcher(runtime)` from `@c15t/browser`                             |
+
+```tsx
+import { useEventDispatcher } from 'c15t/react';
+import { useEffect } from 'react';
+
+export const DocsSearch = ({ path }: { path: string }) => {
+	const events = useEventDispatcher({ pageviews: ['posthog'] });
+	useEffect(() => {
+		events.pageview(path);
+	}, [events, path]);
+	return (
+		<button onClick={() => events.track('docs_search', { resultCount: 4 })}>
+			Search
+		</button>
+	);
+};
 ```
 
-Pass the same `scripts` you registered and a function that returns the live
-consent snapshot. `track` supports Google Tag Manager, Google Tag, PostHog,
-Mixpanel, Segment, Hightouch, Heap, Amplitude, LogRocket, Adobe Analytics,
-Databuddy, Plausible, Fathom, Pirsch, Microsoft Clarity, Hotjar, Vercel
-Analytics, OneDollarStats, Umami, Rybbit, RudderStack and Matomo.
-`pageview` sends single-page-app page views only to the integrations named in
-`pageviews`: PostHog, Segment or Hightouch. Call it from your router's
-navigation hook. The first call records the path without sending, and repeated
-paths or hash-only changes are skipped.
+The dispatcher sends to the scripts registered on the provider. Pass
+`scripts` to add more. It reads consent when an event goes out, so an event
+sent right after a visitor withdraws consent is dropped. Every dispatcher for
+the same provider shares one pageview history, so a component that remounts
+or a consent change does not resend or lose a pageview.
+
+`track` supports Google Tag Manager, Google Tag, PostHog, Mixpanel, Segment,
+Hightouch, Heap, Amplitude, LogRocket, Adobe Analytics, Databuddy, Plausible,
+Fathom, Pirsch, Microsoft Clarity, Hotjar, Vercel Analytics, OneDollarStats,
+Umami, Rybbit, RudderStack and Matomo. `pageview` sends single-page-app page
+views only to the integrations named in `pageviews`: PostHog, Segment or
+Hightouch. Call it from your router's navigation hook. The first call records
+the path without sending, and repeated paths or hash-only changes are skipped.
+Each framework's scripts page shows where to call it.
+
+Without a provider, `createEventDispatcher` from `@c15t/integrations/events`
+takes `scripts` and a `getSnapshot` function that returns the live consent
+snapshot. Create it once and keep it: a new dispatcher starts a new pageview
+history.
 
 ## Add a vendor without a helper
 

package/docs/integrations/posthog.md

@@ -276,6 +276,14 @@ A kernel you create yourself needs a loader from
 | `'after-consent'` | Only while measurement is allowed | Calls `opt_in_capturing` at load and `opt_out_capturing` on revocation      |
 | `'disabled'`      | Never                             | None. The helper returns an empty callback-only script                      |
 
+With `'after-consent'`, a refusal can arrive while `array.js` is still
+downloading. The download keeps going after c15t removes the script, so c15t
+also clears PostHog's queued init. When `array.js` runs, it starts nothing, sends
+no events and writes no cookies. If the visitor allows measurement again before
+`array.js` runs, PostHog starts on the same page. If `array.js` has already
+run, PostHog starts on the next page load. With the default
+`reloadOnConsentRevoked`, the page reloads after the refusal anyway.
+
 `posthog` uses the `measurement` category. With the default
 `cookieless_mode: 'on_reject'`, PostHog keeps capturing without cookies after a
 refusal. That mode needs cookieless server hashing turned on in your PostHog

package/package.json

@@ -1,22 +1,27 @@
 {
 	"name": "@c15t/react",
-	"version": "3.1.0-canary.0",
-	"description": "React cookie banner, consent manager, preference center, and headless CMP components with IAB TCF and Consent Mode support.",
+	"version": "3.1.0",
+	"description": "React cookie consent banner, consent dialog and preference center, plus headless hooks. A GDPR consent management platform (CMP) with Google Consent Mode v2 and IAB TCF.",
 	"keywords": [
+		"banner",
 		"ccpa",
 		"cmp",
 		"consent",
 		"consent-banner",
 		"consent-management",
 		"consent-management-platform",
+		"consent-manager",
 		"consent-manager-react",
 		"consent-mode-v2",
+		"cookie",
 		"cookie-banner",
 		"cookie-consent",
 		"gdpr",
+		"global-privacy-control",
 		"google-consent-mode",
 		"headless",
 		"iab",
+		"iab-tcf",
 		"lgpd",
 		"preference-center",
 		"privacy",
@@ -264,16 +269,16 @@
 		"test:watch": "bun prebuild && vitest"
 	},
 	"dependencies": {
-		"@c15t/core": "3.1.0-canary.0",
-		"@c15t/dev-tools": "3.1.0-canary.0",
-		"@c15t/iab": "3.1.0-canary.0",
-		"@c15t/schema": "3.1.0-canary.0",
-		"@c15t/translations": "3.1.0-canary.0",
-		"@c15t/ui": "3.0.1-canary.0",
+		"@c15t/core": "3.1.0",
+		"@c15t/dev-tools": "3.1.0",
+		"@c15t/iab": "3.1.0",
+		"@c15t/schema": "3.1.0",
+		"@c15t/translations": "3.1.0",
+		"@c15t/ui": "3.0.1",
 		"@types/google.maps": "3.65.3"
 	},
 	"devDependencies": {
-		"@c15t/backend": "3.1.0-canary.0",
+		"@c15t/backend": "3.1.0",
 		"@c15t/conformance": "0.0.1",
 		"@c15t/typescript-config": "0.0.1",
 		"@c15t/vitest-config": "1.0.0",