@c15t/react 3.0.0-alpha.4 → 3.0.0-alpha.6

package/dist-types/draft.d.ts

@@ -1,4 +1,5 @@
-import type { AllConsentNames, ConsentKernel, ConsentState, SaveResult, SaveInput, SaveUISource } from '@c15t/core';
+import type { AllConsentNames, ConsentState, SaveResult } from '@c15t/core';
+import type { PreferenceDraft, PreferenceDraftState } from '@c15t/core/preference-draft';
 import type { ReactNode } from 'react';
 /** A local, unmasked selection, committed only by an explicit save. */
 export interface ConsentDraftHandle {
@@ -27,61 +28,37 @@ export interface ConsentDraftHandle {
     save: () => Promise<SaveResult>;
     reset: () => void;
 }
-interface DraftSnapshot {
-    values: ConsentState;
-    displayedCategories: readonly AllConsentNames[];
-    vendors: Record<string, boolean>;
-    isDirty: boolean;
-    isStale: boolean;
-}
-declare const createDraftStore: (kernel: ConsentKernel, initialDefaults?: Partial<ConsentState>) => {
-    acceptAll(): void;
-    connect(): import("@c15t/core").Unsubscribe;
-    getSnapshot: () => DraftSnapshot;
-    /** The kernel this draft reads from and saves into. */
-    kernel: ConsentKernel;
-    rejectAll(): void;
-    reset: () => void;
-    save(input?: SaveInput, categories?: readonly AllConsentNames[], onSuccess?: () => void, uiSource?: SaveUISource): Promise<SaveResult>;
-    set(category: AllConsentNames, value: boolean): void;
-    /**
-     * Replace the defaults a category without a receipt seeds from. A
-     * clean draft reseeds at once, so an experiment arm assigned after
-     * mount shows its own defaults; edits the visitor already made stay.
-     */
-    setDefaults(next: Partial<ConsentState> | undefined): void;
-    setVendor(vendorId: string, granted: boolean): void;
-    subscribe(listener: () => void): () => void;
-    update: (patch: Partial<ConsentState>) => void;
-};
-type DraftStore = ReturnType<typeof createDraftStore>;
+type DraftStore = PreferenceDraft;
 export interface ConsentDraftProviderProps {
     children: ReactNode;
     /** Defaults apply only to categories without an explicit receipt. */
     initial?: Partial<ConsentState>;
 }
+/**
+ * Share one draft with every draft hook and stock control below it. The
+ * preference dialog renders one, so its switches, vendor rows and save
+ * button stage into and confirm the same draft.
+ */
 export declare const ConsentDraftProvider: ({ children, initial, }: ConsentDraftProviderProps) => import("react").JSX.Element;
-/** Internal UI save path shared by stock controls and headless actions. */
-export declare const useConsentSaveAction: () => (input?: SaveInput, uiSource?: SaveUISource) => Promise<SaveResult>;
 /**
- * The nearest consent draft store, for the stock preference rows. Pair with
+ * The nearest consent draft, for the stock preference rows. Pair with
  * {@link useConsentDraftSlice} so a row re-renders only when its own slice
  * changes, not on every staged edit elsewhere in the draft.
  *
- * @returns The shared draft store, or a local one outside a provider.
+ * @returns The shared draft, or a local one outside a provider.
  * @internal
  */
 export declare const useConsentDraftStore: () => DraftStore;
 /**
- * Subscribes to one slice of a consent draft store.
+ * Subscribes to one slice of a consent draft.
  *
- * @param store - Store from {@link useConsentDraftStore}.
+ * @param draft - Draft from {@link useConsentDraftStore}.
  * @param selector - Picks the slice. Return a primitive or a reference the
  * draft already holds.
  * @returns The selected slice.
  * @internal
  */
-export declare const useConsentDraftSlice: <SliceType>(store: DraftStore, selector: (draft: DraftSnapshot) => SliceType) => SliceType;
+export declare const useConsentDraftSlice: <SliceType>(draft: DraftStore, selector: (state: PreferenceDraftState) => SliceType) => SliceType;
 /** Read and edit displayed choices without replacing masked effective permissions. */
 export declare const useConsentDraft: () => ConsentDraftHandle;
 /** The vendor slice of the consent draft, for a custom vendor control. */

package/dist-types/gpp.d.ts

@@ -0,0 +1,27 @@
+import type { RuntimeGPPOptions } from '@c15t/core/runtime';
+/** Props for {@link ConsentGPP}: the GPP options, all optional. */
+export type ConsentGPPProps = RuntimeGPPOptions;
+/**
+ * Installs `window.__gpp`, the IAB GPP CMP API, on the surrounding
+ * provider's kernel and keeps its GPP string in step with the visitor's
+ * choices. Renders nothing. Unmounting removes `__gpp`.
+ *
+ * Render it inside `ConsentProvider` (or `ConsentRoot` in Next.js and
+ * TanStack Start). Every prop is plain data, so a Server Component can
+ * render it.
+ *
+ * @param props - GPP options. See `RuntimeGPPOptions`.
+ * @returns `null`.
+ * @throws {Error} When rendered outside a consent provider.
+ *
+ * @example
+ * ```tsx
+ * import { ConsentGPP } from '@c15t/react/gpp';
+ *
+ * <ConsentProvider options={{ mode: hosted({ url }) }}>
+ *   <ConsentGPP usFallback="none" />
+ *   <App />
+ * </ConsentProvider>
+ * ```
+ */
+export declare const ConsentGPP: ({ cmpId, mspaMode, optOutCategories, tcf, usApproach, usFallback, }: ConsentGPPProps) => null;

package/dist-types/hooks/use-iab-manager.d.ts

@@ -11,8 +11,8 @@ export declare const useIABConsentManager: (overrides?: ConsentPresentation) =>
         actionGroups: import("@c15t/core").PresentationAction[][];
         primaryActions: import("@c15t/core").PresentationAction[];
         diagnostics: import("@c15t/core").PresentationDiagnostic[];
-        rights: readonly import("@c15t/schema/types").PolicyRight[];
-        preferenceControls: Exclude<import("@c15t/schema/types").PolicyRight, 'disclosure'>[];
+        rights: readonly import("@c15t/schema").PolicyRight[];
+        preferenceControls: Exclude<import("@c15t/schema").PolicyRight, 'disclosure'>[];
         direction: 'row' | 'column';
         uiProfile: 'balanced' | 'compact' | 'strict';
         scrollLock: boolean;
@@ -32,8 +32,8 @@ export declare const useIABConsentManager: (overrides?: ConsentPresentation) =>
         actionGroups: import("@c15t/core").PresentationAction[][];
         primaryActions: import("@c15t/core").PresentationAction[];
         diagnostics: import("@c15t/core").PresentationDiagnostic[];
-        rights: readonly import("@c15t/schema/types").PolicyRight[];
-        preferenceControls: Exclude<import("@c15t/schema/types").PolicyRight, 'disclosure'>[];
+        rights: readonly import("@c15t/schema").PolicyRight[];
+        preferenceControls: Exclude<import("@c15t/schema").PolicyRight, 'disclosure'>[];
         direction: 'row' | 'column';
         uiProfile: 'balanced' | 'compact' | 'strict';
         scrollLock: boolean;

package/dist-types/hooks.d.ts

@@ -84,13 +84,35 @@ export declare const usePolicyScopeMode: () => PolicyScopeMode;
 export declare const useIABSnapshot: () => Readonly<KernelIABState> | null;
 /** Is IAB active? */
 export declare const useIABEnabled: () => boolean;
-/** Consent for a specific IAB vendor. Accepts numeric or string IDs; IAB
- * vendors are numeric but the kernel stores them as strings for
- * uniformity with custom vendors. */
+/**
+ * The preference centre's consent selection for one IAB vendor, including
+ * changes the visitor has not saved yet. Use it to render a control, not to
+ * gate a vendor: the saved choice is the TC string that `__tcfapi` serves,
+ * and `useIABSnapshot()?.authority` holds its decoded signals.
+ *
+ * @param vendorId - Numeric or string ID. IAB vendors are numeric; the
+ * kernel stores IDs as strings so custom vendors fit the same map.
+ * @returns Whether the vendor is selected.
+ */
 export declare const useVendorConsent: (vendorId: string | number) => boolean;
-/** Consent for a specific IAB purpose (1–11). */
+/**
+ * The preference centre's consent selection for one IAB purpose (1-11),
+ * including changes the visitor has not saved yet. Use it to render a
+ * control, not to gate a vendor: see {@link useVendorConsent}.
+ *
+ * @param purposeId - IAB purpose ID.
+ * @returns Whether the purpose is selected.
+ */
 export declare const usePurposeConsent: (purposeId: number) => boolean;
-/** Opt-in for a special feature (1 = geolocation, 2 = device ID). */
+/**
+ * The preference centre's opt-in selection for one special feature
+ * (1 = geolocation, 2 = device ID), including changes the visitor has not
+ * saved yet. Use it to render a control, not to gate a vendor: see
+ * {@link useVendorConsent}.
+ *
+ * @param featureId - IAB special feature ID.
+ * @returns Whether the special feature is selected.
+ */
 export declare const useSpecialFeatureOptIn: (featureId: number) => boolean;
 /** Latest TCF string. `null` until the IAB module encodes one. */
 export declare const useTCString: () => string | null;
@@ -144,6 +166,9 @@ export declare const useSetOverrides: () => (input: KernelOverrides) => void;
 export declare const useSetLanguage: () => (code: string) => void;
 /**
  * Sync mutation: set the active UI surface (banner/dialog/none).
+ *
+ * Explicit navigation: a pending save on this kernel can no longer close or
+ * restore a surface once the visitor navigated.
  */
 export declare const useSetActiveUI: () => (ui: KernelActiveUI) => void;
 /**

package/dist-types/index-parts/consent-banner.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 { ConsentBanner, useConsentBannerSurface } from '../components/prompt/index.js';

package/dist-types/index-parts/consent-dialog-link.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 { ConsentDialogLink } from '../components/panel-link/index.js';

package/dist-types/index-parts/consent-dialog-trigger.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 { ConsentDialogTrigger, ConsentDialogTriggerToolbar, } from '../components/panel-trigger/index.js';

package/dist-types/index-parts/consent-dialog.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 { ConsentDialog, ConsentWidget } from '../aggregate-components.js';

package/dist-types/index-parts/consent-gate.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 { ConsentGate, Frame } from '../components/consent-gate/index.js';

package/dist-types/index-parts/core.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 { createConsentKernel, custom, hosted, policyRulePresets, } from '@c15t/core';
+export { offline } from '../transports/offline.js';

package/dist-types/index-parts/draft.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 { ConsentDraftProvider, useConsentDraft, useVendorDraft, } from '../draft.js';

package/dist-types/index-parts/hooks.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 { useActiveUI, useBranding, useConsent, useConsents, useDeclaredVendors, useDismissNotice, useEffectivePermissions, useExperiment, useExplicitChoice, useHasConsentPolicy, useHasConsentPreferences, useHasConsentUI, useIABEnabled, useIABSnapshot, useIdentify, useInit, useLocation, useModel, useNoticeDismissal, useOverrides, usePolicyCategories, usePolicyResolution, usePolicyRule, usePolicyScopeMode, usePreferencesPresentation, usePrivacySignals, usePromptPresentation, usePromptRequirement, usePurposeConsent, useRegisterConsentCategories, useResolvedPresentation, useResolvedTheme, useRestrictions, useSaveConsents, useSetActiveUI, useSetLanguage, useSetOverrides, useSnapshot, useSpecialFeatureOptIn, useSubscribeToConsentChanges, useTCString, useUser, useVendorAllowed, useVendorChoice, useVendorConsent, } from '../hooks.js';

package/dist-types/index-parts/module-hooks.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 { useIframeBlocker, useNetworkBlocker, usePersistence, useScriptLoader, } from '../module-hooks.js';

package/dist-types/index-parts/provider.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 { ConsentProvider } from '../provider.js';

package/dist-types/index-parts/theme.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 { ConsentTheme } from '../consent-theme.js';
+export { defineTheme } from '../types/theme/index.js';

package/dist-types/index-parts/translations.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 { useTranslations } from '../component-hooks/use-translations.js';

package/dist-types/index.d.ts

@@ -31,32 +31,31 @@
  *   cache patching. No method rewriting. Provider boot work is explicit
  *   module wiring around a single per-mount kernel.
  */
-export type { ConsentKernel, ConsentSnapshot, ConsentState, HostedTransportOptions, InitContext, InitResponse, InitResult, KernelConfig, KernelEvent, KernelOverrides, KernelTransport, KernelUser, Listener, HostedModeOptions, ProviderTransportContext, ProviderTransportFactory, ProviderTransportKind, SavePayload, SaveResult, Unsubscribe, } from '@c15t/core';
-export { createConsentKernel, custom, hosted } from '@c15t/core';
+export type { AllConsentNames, ClearOnRevocationConfig, ConsentKernel, ConsentSnapshot, ConsentState, HostedTransportOptions, InitContext, InitResponse, InitResult, KernelConfig, KernelEvent, KernelOverrides, KernelTransport, KernelUser, Listener, HostedModeOptions, PolicyRule, ProviderTransportContext, ProviderTransportFactory, ProviderTransportKind, SavePayload, SaveResult, Unsubscribe, } from '@c15t/core';
 export type { OfflineModeOptions } from './transports/offline.js';
-export { offline } from './transports/offline.js';
-export { ConsentDialog, ConsentWidget } from './aggregate-components.js';
 export type { ConsentBannerButton, ConsentBannerLayout, ConsentBannerProps, ConsentBannerRight, ConsentBannerRightLinkProps, ConsentBannerRightsProps, ConsentBannerSurface, } from './components/prompt/index.js';
-export { ConsentBanner, type ConsentBannerCompoundComponent, useConsentBannerSurface, } from './components/prompt/index.js';
 export type { ConsentDialogCompoundComponent, ConsentDialogProps, } from './components/panel/index.js';
 export type { ConsentDialogLinkProps } from './components/panel-link/index.js';
-export { ConsentDialogLink } from './components/panel-link/index.js';
 export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, ConsentDialogTriggerToolbarProps, TriggerOrientation, } from './components/panel-trigger/index.js';
-export { ConsentDialogTrigger, ConsentDialogTriggerToolbar, } from './components/panel-trigger/index.js';
 export type { ConsentWidgetCompoundComponent, ConsentWidgetProps, } from './components/preferences/index.js';
 export type { ConsentGateProps, FrameProps } from './components/consent-gate/index.js';
-export { ConsentGate, Frame } from './components/consent-gate/index.js';
 export type { ConsentDraftHandle, ConsentDraftProviderProps, VendorDraftHandle, } from './draft.js';
-export { ConsentDraftProvider, useConsentDraft, useVendorDraft } from './draft.js';
-export { useTranslations } from './component-hooks/use-translations.js';
-export { useActiveUI, useBranding, useConsent, useConsents, useExperiment, useHasConsentPolicy, useHasConsentPreferences, useHasConsentUI, useIABEnabled, useIABSnapshot, useIdentify, useInit, useLocation, useModel, useOverrides, usePromptPresentation, usePolicyCategories, usePreferencesPresentation, useResolvedPresentation, useResolvedTheme, usePolicyScopeMode, usePurposeConsent, useRegisterConsentCategories, useSaveConsents, useSetActiveUI, useSetLanguage, useSetOverrides, useSnapshot, useSpecialFeatureOptIn, useSubscribeToConsentChanges, useTCString, useUser, useDeclaredVendors, useVendorAllowed, useVendorChoice, useVendorConsent, } from './hooks.js';
 export type { UseIframeBlockerOptions, UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions, } from './module-hooks.js';
-export { useIframeBlocker, useNetworkBlocker, usePersistence, useScriptLoader, } from './module-hooks.js';
 export type { ConsentProviderOptions, ConsentProviderCallbacks, ConsentProviderPrefetch, ConsentProviderProps, ExternalRuntimeProviderOptions, ExternalRuntimeProviderProps, OwnedRuntimeProviderProps, } from './provider.js';
-export { ConsentProvider } from './provider.js';
-export { ConsentTheme } from './consent-theme.js';
 export type { ConsentThemeProps } from './consent-theme.js';
+export type { Theme } from './types/theme/index.js';
+export type { ConsentBannerCompoundComponent } from './components/prompt/index.js';
 export type { ReactUIOptions } from './types/manager.js';
-export { defineTheme, type Theme } from './types/theme/index.js';
-export { useExplicitChoice, useEffectivePermissions, usePromptRequirement, useNoticeDismissal, usePrivacySignals, usePolicyResolution, usePolicyRule, useRestrictions, useDismissNotice, } from './hooks.js';
 export type { ConsentPresentation, PromptPresentation, PreferencesPresentation, PresentationAction, PromptPosition, PromptVariant, ResolvedConsentPresentation, } from '@c15t/core';
+export * from './index-parts/core.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/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';

package/dist-types/kernel-selector.d.ts

@@ -56,11 +56,3 @@ export declare const useCategoryAllowed: (category: AllConsentNames) => boolean;
  * @internal
  */
 export declare const useTranslationLanguage: () => string;
-/**
- * Categories the preference surface lists: `necessary` plus the recorded
- * choice scope, or the policy scope when no choice scope applies.
- *
- * @returns A list whose identity changes only when the scope does.
- * @internal
- */
-export declare const useDisplayedCategories: () => readonly AllConsentNames[];

package/dist-types/module-hooks/iframe-blocker.d.ts

@@ -1,5 +1,5 @@
 import type { ConsentKernel } from '@c15t/core';
-import type { IframeBlockerHandle } from '@c15t/core/modules/iframe-blocker';
+import type { IframeBlockerHandle, IframeBlockerOptions } from '@c15t/core/modules/iframe-blocker';
 export interface UseIframeBlockerOptions {
     disableAutomaticBlocking?: boolean;
 }
@@ -21,13 +21,18 @@ export declare const useIframeBlocker: (options?: UseIframeBlockerOptions) => If
  */
 export declare const watchGatedIframes: (kernel: ConsentKernel, onFound: () => void) => () => void;
 /**
- * The provider's default iframe blocker. Loads the blocker module when the
- * first gated iframe (`data-category` or `data-vendor`) is on the page
- * instead of on every mount, so pages without one never download it.
+ * The provider's iframe blocker. Loads the blocker module when the first
+ * gated iframe (`data-category` or `data-vendor`) is on the page instead of
+ * on every mount, so pages without one never download it. Until then it
+ * pauses gated frames that arrive with a `src` consent does not allow.
  *
- * @param options - Blocker options. With `disableAutomaticBlocking` the
- * module loads at once, as it did before.
+ * Passed to the provider runtime as its `createIframeBlocker` module.
+ *
+ * @param options - The kernel and blocker options. With
+ * `disableAutomaticBlocking` the module loads at once.
+ * @returns A handle; `processAllIframes()` reaches the blocker once it has
+ * loaded.
  * @internal
  */
-export declare const useIframeBlockerOnDemand: (options?: UseIframeBlockerOptions) => void;
+export declare const createIframeBlockerOnDemand: ({ disableAutomaticBlocking, kernel, }: IframeBlockerOptions) => IframeBlockerHandle;
 export type { IframeBlockerHandle };

package/dist-types/provider.d.ts

@@ -1,6 +1,7 @@
-import type { AllConsentNames, ClearOnRevocationConfig, ConsentExperiment, ExperimentState, ConsentPresentation, Callbacks, I18nConfig, KernelConfig, KernelOverrides, KernelUser, LegalLinks, ProviderTransportFactory, StorageConfig, User, Vendor } from '@c15t/core';
+import type { AllConsentNames, Callbacks, ClearOnRevocationConfig, ConsentExperiment, ConsentPresentation, ExperimentState, I18nConfig, KernelConfig, KernelOverrides, KernelUser, LegalLinks, ProviderTransportFactory, StorageConfig, User, Vendor } from '@c15t/core';
 import type { Script } from '@c15t/core/modules/script-loader';
-import type { ConsentControlOptions, ConsentRuntime } from '@c15t/core/runtime';
+import type { ConsentControlOptions } from '@c15t/core/runtime';
+import type { ConsentRuntime, ConsentRuntimeModules, ResolveStreamedInit } from '@c15t/core/runtime/provider';
 import type { ReactNode } from 'react';
 import type { DialogPreload } from './chunk-warming.js';
 import type { UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions } from './module-hooks.js';
@@ -56,6 +57,12 @@ export interface ConsentProviderOptions extends ConsentControlOptions, Pick<Reac
      * ```
      */
     mode: ProviderTransportFactory;
+    /**
+     * Where the visitor's choice is stored. Read once, like `persistence`:
+     * the stored records and the data clearing that protects them stay at
+     * the location the provider mounted with. Outside production, a change
+     * logs a warning; remount the provider to move storage.
+     */
     storageConfig?: StorageConfig;
     user?: User | KernelUser;
     overrides?: KernelOverrides;
@@ -123,6 +130,10 @@ export interface ConsentProviderOptions extends ConsentControlOptions, Pick<Reac
      * is paused.
      */
     iframeBlocker?: UseIframeBlockerOptions | false;
+    /**
+     * Store the visitor's choice in a cookie and localStorage. On by default.
+     * Read once, when the provider mounts; see `storageConfig`.
+     */
     persistence?: boolean | UsePersistenceOptions;
     i18n?: Partial<I18nConfig>;
     /** Categories to offer alongside discovered integration categories, within policy scope. */
@@ -150,6 +161,27 @@ export interface ConsentProviderOptions extends ConsentControlOptions, Pick<Reac
      * @internal
      */
     __debugPkg?: string;
+    /**
+     * The code that applies a `prefetch` promise, from
+     * `@c15t/core/runtime/streamed-init`. Without it the provider loads that
+     * code once `prefetch` is a promise, so an app that never streams one
+     * doesn't download it. A framework root whose state is usually streamed
+     * (`ConsentRoot`) passes it, so the state applies as soon as it arrives
+     * instead of after one more request. Read once, at mount.
+     * @internal
+     */
+    __resolveStreamedInit?: ResolveStreamedInit;
+    /**
+     * `preloadScriptLoaderWith` from
+     * `@c15t/core/runtime/script-loader-preload`. With it the runtime starts
+     * the script loader's download during the first render when consent
+     * already lets a script run, instead of from the mount effect. A
+     * framework root whose state usually holds a returning visitor's choice
+     * (`ConsentRoot`) passes it; without it the provider ships none of that
+     * decision. Read once, at mount.
+     * @internal
+     */
+    __preloadScriptLoader?: (load: () => Promise<unknown>) => ConsentRuntimeModules['preloadScriptLoader'];
 }
 /**
  * Options accepted when an external runtime supplies the kernel.
@@ -187,19 +219,21 @@ export type ConsentProviderProps = OwnedRuntimeProviderProps | ExternalRuntimePr
 /**
  * v3 ConsentProvider.
  *
- * Retains the enabled kernel while disabled mode uses a separate permissive
- * kernel, so toggling enabled preserves recorded choices. Provides the active
- * kernel via context and wires the curated v2-like options surface to v3
- * modules. It does not mirror the
- * snapshot into React state; selector hooks still subscribe directly to
- * the kernel through `useSyncExternalStore`.
+ * Builds one consent runtime (`createConsentProviderRuntime`) per mounted
+ * provider and renders its kernel: the kernel goes into context, and
+ * selector hooks subscribe to it through `useSyncExternalStore`. New
+ * options reach the runtime through `update()`, which applies only what
+ * changed; `mode`, `i18n`, `experiment`, `prefetch`, `persistence`,
+ * `storageConfig` and `clearOnRevocation` are read once. While `enabled` is
+ * `false` the runtime renders a separate permissive kernel, so toggling it
+ * keeps the visitor's records.
  *
  * Pass `runtime` to render a runtime someone else created. The provider
- * then borrows its kernel and mounts none of the side-effecting modules —
- * no second `init()`, no second persistence handle, no second `window.c15t`
- * — and does not dispose it on unmount. Handing it a different runtime
- * switches the tree to that runtime's kernel; switching between a borrowed
- * runtime and a provider-built kernel still needs a remount.
+ * then borrows its kernel and starts nothing — no second `init()`, no
+ * second persistence handle, no second `window.c15t` — and does not
+ * dispose it on unmount. Handing it a different runtime switches the tree
+ * to that runtime's kernel; switching between a borrowed runtime and a
+ * provider-built one still needs a remount.
  *
  * @example
  * ```tsx

package/dist-types/version.d.ts

@@ -1 +1 @@
-export declare const version = "3.0.0-alpha.4";
+export declare const version = "3.0.0-alpha.6";

package/docs/README.md

@@ -15,7 +15,7 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [How consent works](./concepts/how-consent-works.md): What c15t decides on each page load, the difference between a permission and a recorded choice, and what happens when a visitor saves.
 - [Customize the interface](./customization/overview.md): Change c15t's consent banner and dialog one step at a time, from a prop to your own markup, and find where each step lives in your framework.
 - [Verify consent](./guides/verify-consent.md): Check in a production build that vendor requests wait for consent, rejection survives a reload, preferences reopen and privacy signals apply.
-- [Migrate to v3](./upgrade-v3.md): Upgrade a c15t v2 app to v3. Covers packages, the Next.js and React providers, the JavaScript runtime, custom UI built on useConsentManager, callbacks, policies, stored consent and a self-hosted backend.
+- [Migrate to v3](./upgrade-v3.md): Upgrade from c15t v2 to v3. Pick the guide for the v2 package you use (@c15t/nextjs, @c15t/react or the c15t store), rename @c15t/scripts, keep visitors' choices, and upgrade a self-hosted backend and the Node.js SDK.
 
 ## More documentation
 
@@ -38,6 +38,7 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [Content Security Policy](./frameworks/react/content-security-policy.md): Run c15t in a React app under a Content Security Policy, allow the consent backend and vendor hosts, and pass a nonce to ConsentProvider and ConsentTheme.
 - [Customize](./frameworks/react/customize.md): Change the colors, fonts, layout, button styles and copy of the c15t banner and dialog in a React app with the stylesheet, theme tokens, provider options and slots.
 - [Embeds](./frameworks/react/embeds.md): Keep YouTube videos, maps and other iframes out of a React page until their consent category is allowed, with ConsentGate or the iframe blocker in ConsentProvider.
+- [IAB GPP](./frameworks/react/gpp.md): Add the IAB Global Privacy Platform API (__gpp) to a React app with ConsentGPP from @c15t/react/gpp, so ad tech can read US state opt-outs and the TCF EU consent string.
 - [Headless](./frameworks/react/headless.md): Build a custom consent banner in React with the c15t/react/headless hooks inside your ConsentProvider.
 - [Hooks](./frameworks/react/hooks.md): Gate features and save consent choices in React components with the focused hooks exported from c15t/react.
 - [IAB TCF](./frameworks/react/iab.md): Mount the IAB TCF banner and dialog inside a React ConsentProvider and configure the CMP ID, policy and vendor data.
@@ -47,6 +48,7 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [Scripts](./frameworks/react/scripts.md): Load vendor scripts by consent category in a React app with ConsentProvider, and clear stored data or reload the page when a visitor withdraws consent.
 - [Translations](./frameworks/react/translations.md): Where c15t banner and dialog copy comes from in a React app, how the browser picks the visitor's language, and how to override copy and switch languages with the provider's i18n option and hooks.
 - [Troubleshooting](./frameworks/react/troubleshooting.md): Fix a missing banner, early vendor requests, unstyled components and theme warnings in a React app that uses c15t/react.
+- [Upgrade from v2](./frameworks/react/upgrade-v3.md): Upgrade a React app from c15t v2 (@c15t/react) to v3. Covers packages, ConsentProvider and transports, the useConsentManager codemod, callbacks, policies, styles, IAB and stored consent.
 - [Vendor consent](./frameworks/react/vendor-consent.md): Let visitors allow a category such as marketing in a React app and still turn off one vendor in it, with the vendors option on ConsentProvider and useVendorAllowed.
 
 ## Concepts
@@ -54,7 +56,7 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [Choose your setup](./concepts/choose-your-setup.md): Pick the c15t setup for your framework, rendering mode and hosting, and decide who runs the consent backend.
 - [Consent categories](./concepts/consent-categories.md): Assign scripts, embeds and features to c15t consent categories, and understand which categories the preference dialog shows.
 - [Consent state reference](./concepts/consent-state.md): How c15t saves choices, gates IAB vendors, hydrates server records and keeps browser tabs and storage in step.
-- [Data fetching](./concepts/data-fetching.md): How c15t gets policy data through a cached manifest, backend /init, the browser or offline rules, and where consent choices are saved.
+- [Data fetching](./concepts/data-fetching.md): Choose the recommended build-time policy snapshot or runtime manifest fetching, backend /init, browser resolution or offline rules, and understand where consent choices are saved.
 - [How consent works](./concepts/how-consent-works.md): What c15t decides on each page load, the difference between a permission and a recorded choice, and what happens when a visitor saves.
 - [Policies](./concepts/policies.md): How policy models, prompts and scope decide what c15t asks visitors, where to change the rules, and why a banner may not appear.
 
@@ -72,7 +74,7 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [Customize the interface](./customization/overview.md): Change c15t's consent banner and dialog one step at a time, from a prop to your own markup, and find where each step lives in your framework.
 - [Banner designs](./customization/recipes.md): Five consent banner designs built with c15t, from one prop to your own markup, with tested code for React, Vue, Svelte, Astro and plain HTML.
 - [Component parts](./customization/slots.md): Find every part of c15t's banner, dialog, widget, trigger and ConsentGate placeholder, its key in your framework's part API, and the data attributes to select on.
-- [Stylesheets and CSS layers](./customization/stylesheets.md): Load the right c15t stylesheet for your framework, see when the dialog's CSS loads, order c15t's cascade layer against your own, and run c15t without its styles.
+- [Stylesheets and CSS layers](./customization/stylesheets.md): Load the right c15t stylesheet for your framework, see which file holds the dialog's rules, order c15t's cascade layer against your own, and run c15t without its styles.
 - [Tailwind CSS](./customization/tailwind.md): Load c15t's styles next to Tailwind CSS 4 or 3 in every framework, put utilities on c15t component parts, and use Tailwind's dark variant with c15t.
 - [Theme tokens](./customization/tokens.md): Change c15t's colors, type, radius, spacing, shadows and motion with theme tokens, and see every --c15t-* variable with its default.
 - [Copy and translations](./customization/translations.md): Change consent wording through i18n and test the complete prompt and preferences flow.
@@ -111,12 +113,13 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 - [Pinterest Tag](./integrations/pinterest-tag.md): Load the Pinterest Tag only after marketing consent with the c15t pinterestTag helper, guard pintrk event calls, and check it in DevTools.
 - [Pirsch](./integrations/pirsch.md): Load Pirsch Analytics only after measurement consent with the c15t pirsch helper, keep custom event bindings working, and check it in DevTools.
 - [Plausible Analytics](./integrations/plausible-analytics.md): Load the Plausible Analytics tracker only after measurement consent with the c15t plausibleAnalytics helper, and check it in DevTools.
-- [PostHog](./integrations/posthog.md): Load PostHog before or after measurement consent with the c15t posthog helper, choose its cookieless behavior, and sync consent with an SDK you already initialize.
+- [PostHog](./integrations/posthog.md): Load PostHog before or after measurement consent with the c15t posthog helper, choose its cookieless behavior, turn off PostHog modules you do not use, and sync consent with an SDK you already initialize.
 - [Promptwatch](./integrations/promptwatch.md): Load the Promptwatch attribution client only after measurement consent with the c15t promptwatch helper, and check it in DevTools.
 - [Reddit Pixel](./integrations/reddit-pixel.md): Load the Reddit Pixel only after marketing consent with the c15t redditPixel helper, guard rdt conversion calls, and check it in DevTools.
 - [RudderStack](./integrations/rudderstack.md): Load the RudderStack JavaScript SDK after measurement consent with the c15t rudderstack helper, or map c15t categories to destination consent IDs, and check each mode.
 - [Rybbit Analytics](./integrations/rybbit-analytics.md): Load Rybbit Analytics only after measurement consent with the c15t rybbitAnalytics helper, map its tracking options to data attributes, and check it in DevTools.
 - [Segment](./integrations/segment.md): Load Segment Analytics.js only after measurement consent with the c15t segment helper, guard your own track and identify calls, and check it in DevTools.
+- [Sentry](./integrations/sentry.md): Configure Sentry's CDN or your own SDK with consent for error monitoring, Session Replay and user data.
 - [Snapchat Pixel](./integrations/snapchat-pixel.md): Load the Snapchat Pixel only after marketing consent with the c15t snapchatPixel helper, guard snaptr event calls, and check it in DevTools.
 - [TikTok Pixel](./integrations/tiktok-pixel.md): Load the TikTok Pixel only after marketing consent with the c15t tiktokPixel helper, guard ttq event calls, and check it in DevTools.
 - [Umami Analytics](./integrations/umami-analytics.md): Load the Umami Analytics tracker only after measurement consent with the c15t umamiAnalytics helper, point it at a self-hosted instance, and check it in DevTools.
@@ -126,4 +129,4 @@ These docs describe c15t v3. Find your app's row in Choose your setup, then foll
 
 ## Reference
 
-- [Migrate to v3](./upgrade-v3.md): Upgrade a c15t v2 app to v3. Covers packages, the Next.js and React providers, the JavaScript runtime, custom UI built on useConsentManager, callbacks, policies, stored consent and a self-hosted backend.
+- [Migrate to v3](./upgrade-v3.md): Upgrade from c15t v2 to v3. Pick the guide for the v2 package you use (@c15t/nextjs, @c15t/react or the c15t store), rename @c15t/scripts, keep visitors' choices, and upgrade a self-hosted backend and the Node.js SDK.