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

package/dist-types/hooks/use-theme.d.ts

@@ -1,2 +1,2 @@
-import type { ThemeContextValue } from '../context/theme-context';
+import type { ThemeContextValue } from '../context/theme-context.js';
 export declare const useTheme: () => ThemeContextValue;

package/dist-types/hooks.d.ts

@@ -17,7 +17,7 @@
  * observed through the selector hooks, whose subscription model handles
  * invalidation correctly.
  */
-import type { AllConsentNames, ConsentKernel, PromptPresentation, PreferencesPresentation, ConsentSnapshot, ConsentState, KernelActiveUI, KernelBranding, KernelIABState, KernelModel, KernelOverrides, KernelTranslations, KernelUser, LocationResponse, PolicyScopeMode } from '@c15t/core';
+import type { AllConsentNames, ConsentKernel, PromptPresentation, PreferencesPresentation, ConsentSnapshot, ConsentState, KernelActiveUI, KernelBranding, KernelIABState, KernelModel, KernelOverrides, KernelTranslations, KernelUser, LocationResponse, PolicyScopeMode, ResolvedVendor, VendorChoice } from '@c15t/core';
 /**
  * Full snapshot accessor. Escape hatch for consumers that genuinely need
  * multiple slices. Prefer narrow hooks for re-render isolation.
@@ -91,6 +91,33 @@ export declare const usePurposeConsent: (purposeId: number) => boolean;
 export declare const useSpecialFeatureOptIn: (featureId: number) => boolean;
 /** Latest TCF string. `null` until the IAB module encodes one. */
 export declare const useTCString: () => string | null;
+/**
+ * Vendors declared for vendor-level consent outside IAB, merged from the
+ * provider's `vendors` option, the backend and script slugs. Empty under an
+ * `iab` policy, where the TC string decides and vendor rows are not shown.
+ */
+export declare const useDeclaredVendors: () => readonly ResolvedVendor[];
+/**
+ * The visitor's recorded vendor decision.
+ *
+ * @returns The decision, whose `denied` list may be empty after a bulk
+ * action lifted every denial, or `null` when no vendor decision was ever
+ * recorded.
+ */
+export declare const useVendorChoice: () => Readonly<VendorChoice> | null;
+/**
+ * Whether one vendor is allowed: its category condition passes and the
+ * visitor has not turned it off.
+ *
+ * @param vendorId - Vendor slug as declared in `vendors` or on a script.
+ * @returns `false` while the vendor is denied outside `iab`, otherwise the
+ * result of its declared category condition. An undeclared id is `true`:
+ * nothing is known about its category, and a denial only exists for a vendor
+ * the visitor saw.
+ */
+export declare const useVendorAllowed: (vendorId: string) => boolean;
+/** Register categories used by scripts, frames, or other integrations. */
+export declare const useRegisterConsentCategories: () => (categories: readonly AllConsentNames[]) => void;
 /**
  * Sync mutation: apply overrides (country, region, language, GPC).
  */

package/dist-types/iab.d.ts

@@ -23,8 +23,8 @@
  *
  * @packageDocumentation
  */
-export { IABConsentBanner, type IABConsentBannerProps, } from './components/iab-prompt';
-export { IABConsentDialog, type IABConsentDialogProps, } from './components/iab-panel';
-export { type HeadlessIABBannerAction, type HeadlessIABBannerState, type HeadlessIABDialogAction, type HeadlessIABDialogState, type HeadlessIABPreferenceTab, type UseHeadlessIABConsentUIResult, useHeadlessIABConsentUI, } from './hooks/use-headless-iab-consent-ui';
-export { IABProvider } from './iab-context';
-export type { IABProviderProps } from './iab-context';
+export { IABConsentBanner, type IABConsentBannerProps, } from './components/iab-prompt/index.js';
+export { IABConsentDialog, type IABConsentDialogProps, } from './components/iab-panel/index.js';
+export { type HeadlessIABBannerAction, type HeadlessIABBannerState, type HeadlessIABDialogAction, type HeadlessIABDialogState, type HeadlessIABPreferenceTab, type UseHeadlessIABConsentUIResult, useHeadlessIABConsentUI, } from './hooks/use-headless-iab-consent-ui.js';
+export { IABProvider } from './iab-context.js';
+export type { IABProviderProps } from './iab-context.js';

package/dist-types/index.d.ts

@@ -33,29 +33,29 @@
  */
 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 { OfflineModeOptions } from './transports/offline';
-export { offline } from './transports/offline';
-export { ConsentDialog, ConsentWidget } from './aggregate-components';
-export type { ConsentBannerButton, ConsentBannerLayout, ConsentBannerProps, ConsentBannerRight, ConsentBannerRightLinkProps, ConsentBannerRightsProps, ConsentBannerSurface, } from './components/prompt';
-export { ConsentBanner, type ConsentBannerCompoundComponent, useConsentBannerSurface, } from './components/prompt';
-export type { ConsentDialogCompoundComponent, ConsentDialogProps, } from './components/panel';
-export type { ConsentDialogLinkProps } from './components/panel-link';
-export { ConsentDialogLink } from './components/panel-link';
-export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, ConsentDialogTriggerToolbarProps, TriggerOrientation, } from './components/panel-trigger';
-export { ConsentDialogTrigger, ConsentDialogTriggerToolbar, } from './components/panel-trigger';
-export type { ConsentWidgetCompoundComponent, ConsentWidgetProps, } from './components/preferences';
-export type { FrameProps } from './components/frame';
-export { Frame } from './components/frame';
-export type { ConsentDraftHandle, ConsentDraftProviderProps } from './draft';
-export { ConsentDraftProvider, useConsentDraft } from './draft';
-export { useConsentManager } from './component-hooks/use-manager';
-export { useTranslations } from './component-hooks/use-translations';
-export { useActiveUI, useBranding, useConsent, useConsents, useHasConsentPolicy, useHasConsentUI, useIABEnabled, useIABSnapshot, useIdentify, useInit, useLocation, useModel, useOverrides, usePromptPresentation, usePolicyCategories, usePreferencesPresentation, usePolicyScopeMode, usePurposeConsent, useSaveConsents, useSetActiveUI, useSetLanguage, useSetOverrides, useSnapshot, useSpecialFeatureOptIn, useTCString, useUser, useVendorConsent, } from './hooks';
-export type { UseIframeBlockerOptions, UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions, } from './module-hooks';
-export { useIframeBlocker, useNetworkBlocker, usePersistence, useScriptLoader, } from './module-hooks';
-export type { ConsentProviderOptions, ConsentProviderCallbacks, ConsentProviderPrefetch, ConsentProviderProps, ExternalRuntimeProviderOptions, ExternalRuntimeProviderProps, OwnedRuntimeProviderProps, } from './provider';
-export { ConsentProvider } from './provider';
-export type { ReactUIOptions } from './types/manager';
-export { defineTheme, type Theme } from './types/theme';
-export { useExplicitChoice, useEffectivePermissions, usePromptRequirement, useNoticeDismissal, usePrivacySignals, useOptOutDirectives, usePolicyResolution, usePolicyRule, useRestrictions, useDismissNotice, } from './hooks';
+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 { useConsentManager } from './component-hooks/use-manager.js';
+export { useTranslations } from './component-hooks/use-translations.js';
+export { useActiveUI, useBranding, useConsent, useConsents, useHasConsentPolicy, useHasConsentUI, useIABEnabled, useIABSnapshot, useIdentify, useInit, useLocation, useModel, useOverrides, usePromptPresentation, usePolicyCategories, usePreferencesPresentation, usePolicyScopeMode, usePurposeConsent, useSaveConsents, useSetActiveUI, useSetLanguage, useSetOverrides, useSnapshot, useSpecialFeatureOptIn, 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 type { ReactUIOptions } from './types/manager.js';
+export { defineTheme, type Theme } from './types/theme/index.js';
+export { useExplicitChoice, useEffectivePermissions, usePromptRequirement, useNoticeDismissal, usePrivacySignals, useOptOutDirectives, usePolicyResolution, usePolicyRule, useRestrictions, useDismissNotice, } from './hooks.js';
 export type { ConsentPresentation, PromptPresentation, PreferencesPresentation, PresentationAction, PromptPosition, PromptVariant, ResolvedConsentPresentation, } from '@c15t/core';

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

@@ -1,4 +1,4 @@
-export { type IframeBlockerHandle, type UseIframeBlockerOptions, useIframeBlocker, } from './module-hooks/iframe-blocker';
-export { type BlockedRequestInfo, type NetworkBlockerHandle, type NetworkBlockerRule, type UseNetworkBlockerOptions, useNetworkBlocker, } from './module-hooks/network-blocker';
-export { type PersistenceHandle, type PersistenceOptions, type UsePersistenceOptions, usePersistence, } from './module-hooks/persistence';
-export { type Script, type ScriptLoaderDebugEvent, type ScriptLoaderHandle, type UseScriptLoaderOptions, useScriptLoader, } from './module-hooks/script-loader';
+export { type IframeBlockerHandle, type UseIframeBlockerOptions, useIframeBlocker, } from './module-hooks/iframe-blocker.js';
+export { type BlockedRequestInfo, type NetworkBlockerHandle, type NetworkBlockerRule, type UseNetworkBlockerOptions, useNetworkBlocker, } from './module-hooks/network-blocker.js';
+export { type PersistenceHandle, type PersistenceOptions, type UsePersistenceOptions, usePersistence, } from './module-hooks/persistence.js';
+export { type Script, type ScriptLoaderDebugEvent, type ScriptLoaderHandle, type UseScriptLoaderOptions, useScriptLoader, } from './module-hooks/script-loader.js';

package/dist-types/panel-link.d.ts

@@ -1 +1 @@
-export * from './components/panel-link';
+export * from './components/panel-link/index.js';

package/dist-types/panel-trigger.d.ts

@@ -1 +1 @@
-export * from './components/panel-trigger';
+export * from './components/panel-trigger/index.js';

package/dist-types/panel.d.ts

@@ -1 +1 @@
-export * from './components/panel';
+export * from './components/panel/index.js';

package/dist-types/preferences.d.ts

@@ -1 +1 @@
-export * from './components/preferences';
+export * from './components/preferences/index.js';

package/dist-types/primitives/accordion.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/accordion';
+export * from '../components/shared/ui/accordion/index.js';

package/dist-types/primitives/button.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/button';
+export * from '../components/shared/ui/button/index.js';

package/dist-types/primitives/collapsible.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/collapsible';
+export * from '../components/shared/ui/collapsible/index.js';

package/dist-types/primitives/dialog.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/dialog';
+export * from '../components/shared/ui/dialog/index.js';

package/dist-types/primitives/preference-item.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/preference-item';
+export * from '../components/shared/ui/preference-item/index.js';

package/dist-types/primitives/switch.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/switch';
+export * from '../components/shared/ui/switch/index.js';

package/dist-types/primitives/tabs.d.ts

@@ -1 +1 @@
-export * from '../components/shared/ui/tabs';
+export * from '../components/shared/ui/tabs/index.js';

package/dist-types/primitives.d.ts

@@ -1,7 +1,7 @@
-export * as Accordion from './components/shared/ui/accordion';
-export * as Button from './components/shared/ui/button';
-export * as Collapsible from './components/shared/ui/collapsible';
-export * as Dialog from './components/shared/ui/dialog';
-export * as PreferenceItem from './components/shared/ui/preference-item';
-export * as Switch from './components/shared/ui/switch';
-export * as Tabs from './components/shared/ui/tabs';
+export * as Accordion from './components/shared/ui/accordion/index.js';
+export * as Button from './components/shared/ui/button/index.js';
+export * as Collapsible from './components/shared/ui/collapsible/index.js';
+export * as Dialog from './components/shared/ui/dialog/index.js';
+export * as PreferenceItem from './components/shared/ui/preference-item/index.js';
+export * as Switch from './components/shared/ui/switch/index.js';
+export * as Tabs from './components/shared/ui/tabs/index.js';

package/dist-types/prompt.d.ts

@@ -1 +1 @@
-export * from './components/prompt';
+export * from './components/prompt/index.js';

package/dist-types/provider.d.ts

@@ -1,10 +1,11 @@
-import type { AllConsentNames, ConsentPresentation, Callbacks, I18nConfig, KernelConfig, KernelOverrides, KernelUser, LegalLinks, ProviderTransportFactory, StorageConfig, User } from '@c15t/core';
+import type { AllConsentNames, ClearOnRevocationConfig, ConsentPresentation, Callbacks, I18nConfig, KernelConfig, KernelOverrides, KernelUser, LegalLinks, ProviderTransportFactory, StorageConfig, User, Vendor } from '@c15t/core';
 import type { Script } from '@c15t/core/modules/script-loader';
 import type { ConsentRuntime } from '@c15t/core/runtime';
 import type { ReactNode } from 'react';
-import type { UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions } from './module-hooks';
-import type { ReactUIOptions } from './types/manager';
-import type { ReactComponentSlots } from './types/slots';
+import type { UseNetworkBlockerOptions, UsePersistenceOptions, UseScriptLoaderOptions } from './module-hooks.js';
+import type { UseIframeBlockerOptions } from './module-hooks/iframe-blocker.js';
+import type { ReactUIOptions } from './types/manager.js';
+import type { ReactComponentSlots } from './types/slots.js';
 /** Events emitted by the mounted provider without snapshot-derived consent aliases. */
 export type ConsentProviderCallbacks = Pick<Callbacks, 'onChoiceRecorded' | 'onPermissionsChanged' | 'onError'>;
 /** Prepared policy and records; legacy consent projections are not provider inputs. */
@@ -77,11 +78,27 @@ export interface ConsentProviderOptions extends Pick<ReactUIOptions, 'colorSchem
      */
     prefetch?: ConsentProviderPrefetch | Promise<ConsentProviderPrefetch>;
     callbacks?: ConsentProviderCallbacks;
+    /**
+     * Remove configured browser data when its consent permission is revoked.
+     * Initial-only: remount the provider to replace its cleanup configuration.
+     */
+    clearOnRevocation?: ClearOnRevocationConfig;
     scripts?: Script[];
+    /**
+     * Vendors offered for vendor-level consent outside IAB. Each sits inside a
+     * category; a visitor can grant the category and still turn one vendor
+     * off. Scripts, network rules and iframes name a vendor through `vendor`
+     * or `data-vendor`. Merged with vendors the backend returns and with slugs
+     * found on scripts and rules; presentation declared here wins.
+     */
+    vendors?: Vendor[];
     scriptLoader?: UseScriptLoaderOptions;
     networkBlocker?: UseNetworkBlockerOptions | false;
+    /** Discover and gate DOM iframes with data-category. Enabled by default. */
+    iframeBlocker?: UseIframeBlockerOptions | false;
     persistence?: boolean | UsePersistenceOptions;
     i18n?: Partial<I18nConfig>;
+    /** Categories to offer alongside discovered integration categories, within policy scope. */
     consentCategories?: AllConsentNames[];
     /** Per-component slot attribute overrides (shared contract with @c15t/vue). */
     components?: ReactComponentSlots;
@@ -99,8 +116,13 @@ export interface ConsentProviderOptions extends Pick<ReactUIOptions, 'colorSchem
  * Everything the component tree still owns — theme, slots, legal links —
  * is unchanged.
  */
-export type ExternalRuntimeProviderOptions = Omit<ConsentProviderOptions, 'mode'> & {
+export type ExternalRuntimeProviderOptions = Omit<ConsentProviderOptions, 'mode' | 'vendors'> & {
     mode?: ConsentProviderOptions['mode'];
+    /**
+     * Not accepted here: the runtime owner declares vendors through
+     * `createConsentRuntime({ vendors })`, and the kernel carries them.
+     */
+    vendors?: never;
 };
 /** The provider builds and owns its own kernel. */
 export interface OwnedRuntimeProviderProps {

package/dist-types/server/fetch-ssr-data.d.ts

@@ -1,5 +1,5 @@
 import type { SSRInitialData } from '@c15t/core';
-import type { FetchSSRDataOptions } from './types';
+import type { FetchSSRDataOptions } from './types.js';
 /**
  * Fetches initial consent data on the server for SSR hydration.
  *

package/dist-types/server/index.d.ts

@@ -24,8 +24,8 @@
  *
  * @packageDocumentation
  */
-export { fetchSSRData } from './fetch-ssr-data';
-export { extractRelevantHeaders } from './headers';
-export { createSSRInitCacheKey } from './init-cache-key';
-export { normalizeBackendURL, validateBackendURL } from './normalize-url';
-export type { FetchSSRDataOptions, FetchSSRDataOptionsBase, FetchSSRDataResult, } from './types';
+export { fetchSSRData } from './fetch-ssr-data.js';
+export { extractRelevantHeaders } from './headers.js';
+export { createSSRInitCacheKey } from './init-cache-key.js';
+export { normalizeBackendURL, validateBackendURL } from './normalize-url.js';
+export type { FetchSSRDataOptions, FetchSSRDataOptionsBase, FetchSSRDataResult, } from './types.js';

package/dist-types/theme-provider.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { ThemeContextValue } from './context/theme-context';
-import type { V3UIConfigValue } from './ui-config-context';
+import type { ThemeContextValue } from './context/theme-context.js';
+import type { V3UIConfigValue } from './ui-config-context.js';
 interface V3ThemeProviderProps {
     themeConfig: ThemeContextValue;
     uiConfig: V3UIConfigValue;

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

@@ -1,3 +1,3 @@
-export * from './manager';
-export * from './slots';
-export * from './theme';
+export * from './manager.js';
+export * from './slots.js';
+export * from './theme/index.js';

package/dist-types/types/manager.d.ts

@@ -1,5 +1,5 @@
 import type { UIOptions } from '@c15t/ui/theme';
-import type { ReactComponentSlots } from './slots';
+import type { ReactComponentSlots } from './slots.js';
 /**
  * React-specific UI configuration options.
  *

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

@@ -1 +1 @@
-export * from './style-types';
+export * from './style-types.js';

package/dist-types/ui-config-context.d.ts

@@ -1,5 +1,5 @@
 import type { LegalLinks, ConsentPresentation } from '@c15t/core';
-import type { ReactComponentSlots } from './types/slots';
+import type { ReactComponentSlots } from './types/slots.js';
 export interface V3UIConfigValue {
     components?: ReactComponentSlots;
     presentation?: ConsentPresentation;

package/dist-types/utils/deferred-module.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentType } from 'react';
+/**
+ * Share an on-demand module across exports and intent preloading. Ready client
+ * retries run synchronously; Suspense retains server rendering and hydration.
+ *
+ * @internal
+ */
+export declare const createDeferredModule: <ModuleType>(importModule: () => Promise<ModuleType>) => {
+    component<Props extends object>(select: (module: ModuleType) => ComponentType<Props>): ComponentType<Props>;
+    preload(): Promise<void>;
+};

package/dist-types/utils/index.d.ts

@@ -1,4 +1,4 @@
-export * from './cn';
-export * from './default-translation-config';
-export * from './merge-styles';
-export * from './theme-utils';
+export * from './cn.js';
+export * from './default-translation-config.js';
+export * from './merge-styles.js';
+export * from './theme-utils.js';

package/dist-types/utils/merge-slot-props.d.ts

@@ -1,7 +1,7 @@
 import type { ConsentComponentSlotKey } from '@c15t/schema/config';
 import type { ClassValue } from '@c15t/ui/utils';
-import type { ReactComponentSlots, ReactSlotProps } from '../types/slots';
-import type { CSSPropertiesWithVars } from '../types/theme';
+import type { ReactComponentSlots, ReactSlotProps } from '../types/slots.js';
+import type { CSSPropertiesWithVars } from '../types/theme/index.js';
 type MergeSlotPropsInput = ReactSlotProps & {
     baseClassName?: ClassValue;
     noStyle?: boolean;

package/dist-types/utils/merge-styles.d.ts

@@ -1,4 +1,4 @@
-import type { ClassNameStyle, ThemeValue } from '../types/theme';
+import type { ClassNameStyle, ThemeValue } from '../types/theme/index.js';
 /**
  * Merges two styles objects, handling theme values and style properties.
  * This React version uses React-specific types but uses the core logic from @c15t/ui.

package/dist-types/utils/theme-utils.d.ts

@@ -3,7 +3,7 @@
  * Handles token-to-CSS variable conversion and dark mode overrides.
  */
 import type { ThemeCSSVariables } from '@c15t/ui/theme';
-import type { Theme } from '../types/theme/style-types';
+import type { Theme } from '../types/theme/style-types.js';
 /**
  * Default design tokens for the v2 theme system.
  */

package/dist-types/version.d.ts

@@ -1 +1 @@
-export declare const version = "3.0.0-alpha.0";
+export declare const version = "3.0.0-alpha.2";

package/docs/README.md

@@ -25,10 +25,10 @@ These docs describe v3. Start with Inth hosted setup, identify the framework, ro
 - [ConsentDialog](./frameworks/react/components/consent-dialog.md): Open the c15t preference center as a modal ConsentDialog in a React app, wire its triggers and control blocking, focus and policy gating.
 - [ConsentDialogLink](./frameworks/react/components/consent-dialog-link.md): Add a ConsentDialogLink to a React footer so visitors reopen the c15t preference center from your own text link, with asChild and rights data.
 - [ConsentDialogTrigger](./frameworks/react/components/consent-dialog-trigger.md): Floating button and toolbar that reopen the preference center after the first prompt.
+- [ConsentGate](./frameworks/react/components/consent-gate.md): Gate a YouTube or map iframe behind consent with ConsentGate in React, showing a placeholder that opens the preference center until the category is allowed.
 - [ConsentProvider](./frameworks/react/components/consent-manager-provider.md): Configure the v3 consent runtime and share its state with child components.
 - [ConsentWidget](./frameworks/react/components/consent-widget.md): Embed the c15t preference center inline with ConsentWidget on a React privacy page, with draft toggles that record a choice only on Save.
 - [DevTools](./frameworks/react/components/dev-tools.md): A development tool for inspecting consent state, geolocation, loaded scripts, and consent events in real time.
-- [Frame](./frameworks/react/components/frame.md): Gate a YouTube or map iframe behind consent with Frame in React, showing a placeholder that opens the preference center until the category is allowed.
 - [Consent categories](./frameworks/react/concepts/consent-categories.md): Assign optional features to categories and understand how policy scope affects permission.
 - [Policy presets](./frameworks/react/concepts/policy-presets.md): Understand how policy rules affect React prompts, permissions and persistent privacy controls.
 - [Headless](./frameworks/react/headless.md): Build a custom consent banner in React with the c15t/react/headless hooks inside your ConsentProvider.
@@ -61,14 +61,17 @@ These docs describe v3. Start with Inth hosted setup, identify the framework, ro
 - [Ahrefs Analytics](./integrations/ahrefs-analytics.md): Configure Ahrefs Analytics with c15t v3, understand measurement permission and verify loading and revocation.
 - [Amplitude](./integrations/amplitude.md): Configure Amplitude with c15t v3, understand measurement permission and verify loading and revocation.
 - [Custom integrations](./integrations/building-integrations.md): Define loading, initialization and consent-change behavior for a vendor without a helper.
+- [Clear on revocation](./integrations/clear-on-revocation.md): Remove configured first-party cookies and Web Storage keys when their consent category is denied.
 - [Clearbit](./integrations/clearbit.md): Configure Clearbit with c15t v3, understand marketing permission and verify loading and revocation.
 - [Cloudflare Web Analytics](./integrations/cloudflare-web-analytics.md): Configure Cloudflare Web Analytics with c15t v3, understand measurement permission and verify loading and revocation.
+- [Cloudflare Zaraz](./integrations/cloudflare-zaraz.md): Synchronize c15t permissions with Zaraz purposes while Cloudflare manages your tools.
 - [Crisp](./integrations/crisp.md): Configure Crisp with c15t v3, understand functionality permission and verify loading and revocation.
 - [Databuddy](./integrations/databuddy.md): Configure Databuddy's initial and updated consent state with c15t v3.
 - [Fathom Analytics](./integrations/fathom-analytics.md): Configure Fathom Analytics with c15t v3, understand measurement permission and verify loading and revocation.
 - [Google Maps](./integrations/google-maps.md): Prevent a map iframe from mounting before the required permission.
 - [Google Tag](./integrations/google-tag.md): Configure gtag with c15t Consent Mode signals and understand its loading behavior.
 - [Google Tag Manager](./integrations/google-tag-manager.md): Load GTM with c15t consent signals and verify the tags inside your container.
+- [Granular consent](./integrations/granular-consent.md): Let visitors grant a category and still turn one vendor off, without adopting IAB TCF.
 - [Heap](./integrations/heap.md): Configure Heap with c15t v3, understand measurement permission and verify loading and revocation.
 - [Hightouch](./integrations/hightouch.md): Configure Hightouch with c15t v3, understand measurement permission and verify loading and revocation.
 - [Hotjar](./integrations/hotjar.md): Configure Hotjar with c15t v3, understand measurement permission and verify loading and revocation.

package/docs/frameworks/react/components/consent-dialog.md

@@ -93,7 +93,7 @@ it is `dialog`. These set that surface:
 * The Customize button on a `ConsentBanner`, and the "Manage preferences"
   or "Do not sell or share my data" button a notice renders.
 * `ConsentDialogLink` and `ConsentDialogTrigger`.
-* The button in a `Frame` placeholder.
+* The button in a `ConsentGate` placeholder.
 * `useSetActiveUI()('dialog')` in your own component, or `openDialog()`
   from `useHeadlessConsentUI()` on the headless subpath.
 

package/docs/frameworks/react/components/{frame.md → consent-gate.md}

@@ -1,14 +1,14 @@
 ---
-title: Frame
-description: Gate a YouTube or map iframe behind consent with Frame in React,
-  showing a placeholder that opens the preference center until the category is
-  allowed.
+title: ConsentGate
+description: Gate a YouTube or map iframe behind consent with ConsentGate in
+  React, showing a placeholder that opens the preference center until the
+  category is allowed.
 group: frameworks
 ---
 
 ## Gate an embed behind consent
 
-`Frame` mounts its children only while the effective permission for one
+`ConsentGate` mounts its children only while the effective permission for one
 consent category is granted, and shows a placeholder otherwise. Wrap any
 iframe or third-party widget that would set cookies or contact a vendor on
 load. Render it anywhere inside the `ConsentProvider` from your
@@ -16,11 +16,11 @@ load. Render it anywhere inside the `ConsentProvider` from your
 placeholder button opens.
 
 ```tsx title="src/product-video.tsx"
-import { Frame } from 'c15t/react';
+import { ConsentGate } from 'c15t/react';
 
 export function ProductVideo() {
   return (
-    <Frame category="marketing" className="video-frame">
+    <ConsentGate category="marketing" className="video-frame">
       <iframe
         src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ"
         title="Product tour"
@@ -28,18 +28,18 @@ export function ProductVideo() {
         allowFullScreen
         style={{ width: '100%', aspectRatio: '16 / 9', border: 0 }}
       />
-    </Frame>
+    </ConsentGate>
   );
 }
 ```
 
 `marketing` must be in your policy scope. If you set a non-empty
 `options.consentCategories` list on `ConsentProvider`, include `marketing`
-there too so the preference center can display and save it. `Frame` does
+there too so the preference center can display and save it. `ConsentGate` does
 not add categories to that list.
 
 The placeholder names the category using its title from your translations. Set `className` or `style`
-on `Frame` to reserve the embed's space, so the page does not shift when the
+on `ConsentGate` to reserve the embed's space, so the page does not shift when the
 placeholder is replaced.
 
 ## Props
@@ -51,22 +51,22 @@ placeholder is replaced.
 | `placeholder` | `ReactNode`       | built-in placeholder | Replaces the built-in title and button while the category is not allowed. Falsy values such as `null`, `false`, `0` and an empty string use the built-in placeholder. Pass an empty fragment, `<></>`, to render no placeholder content. |
 
 Other `div` attributes such as `className`, `style` and `ref` apply to the
-wrapper element that stays in the page in both states. `FrameProps` also
+wrapper element that stays in the page in both states. `ConsentGateProps` also
 declares `noStyle` and `theme`, but the component does not apply them yet;
 style the wrapper with `className` and theme the placeholder through the
 provider `theme` option.
 
 ## Behavior
 
-`Frame` renders a `div` wrapper. Inside it, when the effective permission for
+`ConsentGate` renders a `div` wrapper. Inside it, when the effective permission for
 `category` is granted, it renders the children; otherwise it renders the
 placeholder. Permission is the same value `useConsent(category)` returns,
 so it can be granted under an opt-out rule before the visitor records a
 choice, and a recorded grant can be overridden by a privacy signal.
 
 While effective permission is denied, the children are absent from the DOM,
-so an iframe or a third-party widget inside `Frame` sends no requests. When the visitor later revokes it, the
-children unmount and the embed disappears. `Frame` does not depend on the
+so an iframe or a third-party widget inside `ConsentGate` sends no requests. When the visitor later revokes it, the
+children unmount and the embed disappears. `ConsentGate` does not depend on the
 network blocker or the iframe blocker modules; use those for markup you
 cannot wrap in a component.
 
@@ -89,13 +89,13 @@ A grant in the request cookie allows the embed only when policy and privacy
 signals permit it. Browser privacy signals detected during hydration can
 withdraw that permission. In a browser-only setup the
 provider has no permission until it resolves policy on the client, so
-`Frame` shows the placeholder first and swaps in the embed after resolution
+`ConsentGate` shows the placeholder first and swaps in the embed after resolution
 when the category is already granted.
 
-`Frame` is one component on this page; the per-vendor embed guides for
+`ConsentGate` is one component on this page; the per-vendor embed guides for
 [YouTube](../../../integrations/youtube.md) and
 [Google Maps](../../../integrations/google-maps.md) show a complete embed
-configuration with sizing, titles and the same `Frame` usage across
+configuration with sizing, titles and the same `ConsentGate` usage across
 frameworks.
 
 To read the same permission in your own components, use `useConsent` from
@@ -104,24 +104,24 @@ also import from there.
 
 ## Composition
 
-The placeholder parts are available as `Frame.Root`, `Frame.Title` and
-`Frame.Button` for a custom placeholder that keeps the built-in copy and
-behavior. `Frame.Title` and `Frame.Button` accept `category` and fill in the
+The placeholder parts are available as `ConsentGate.Root`, `ConsentGate.Title` and
+`ConsentGate.Button` for a custom placeholder that keeps the built-in copy and
+behavior. `ConsentGate.Title` and `ConsentGate.Button` accept `category` and fill in the
 translated text; pass children to either to replace it.
 
 ```tsx
-<Frame
+<ConsentGate
   category="marketing"
   placeholder={
-    <Frame.Root>
-      <Frame.Title category="marketing" />
+    <ConsentGate.Root>
+      <ConsentGate.Title category="marketing" />
       <p>The video is also available on our channel.</p>
-      <Frame.Button category="marketing">Choose cookies</Frame.Button>
-    </Frame.Root>
+      <ConsentGate.Button category="marketing">Choose cookies</ConsentGate.Button>
+    </ConsentGate.Root>
   }
 >
   <iframe src="https://www.youtube-nocookie.com/embed/..." title="Product tour" />
-</Frame>
+</ConsentGate>
 ```
 
 The built-in placeholder carries `data-testid="frame-placeholder"` and its
@@ -131,7 +131,7 @@ button `data-testid="frame-open-dialog"`.
 
 The placeholder is plain text and a `button`, so it is readable and
 operable without the embed. Give the iframe a descriptive `title`, and keep a
-transcript, address or link outside the `Frame` for visitors who decline
+transcript, address or link outside the `ConsentGate` for visitors who decline
 the category. A denied category may be fixed by policy, so opening the
 preference center does not guarantee that the visitor can grant it.
 

package/docs/frameworks/react/components/consent-manager-provider.md

@@ -58,5 +58,18 @@ signals. Hydration and notice dismissal do not become explicit choices.
 
 An externally owned runtime can be passed through `runtime`. Its owner must
 start and dispose it. A provider borrowing that runtime must not initialize or
-dispose a second copy. See [consent state](../../../guides/consent-state.md) and
+dispose a second copy. Keep the runtime stable for the provider's lifetime and
+unmount the borrowing provider when disposing the runtime. IAB actions taken
+before its handle is ready wait for that handle. If the provider unmounts first,
+a pending `save()` rejects with an `AbortError` instead of waiting indefinitely.
+See [consent state](../../../guides/consent-state.md) and
 [deployment modes](../../../guides/deployment-modes.md).
+
+## Clear data when consent is denied
+
+Set `options.clearOnRevocation` to declare cookies, localStorage keys, and
+sessionStorage keys by optional consent category. Cleanup waits for policy
+resolution, then clears denied categories and later allowed-to-denied
+transitions. This option is initial-only. See
+[clear on revocation](../../../integrations/clear-on-revocation.md) for examples,
+cookie scopes, and browser limits.