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

package/dist-types/hooks.d.ts

@@ -17,7 +17,8 @@
  * 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, ConsentPresentation, ExperimentAssignment, PromptPresentation, PreferencesPresentation, ConsentSnapshot, ConsentState, KernelActiveUI, KernelBranding, KernelIABState, KernelModel, KernelOverrides, KernelTranslations, KernelUser, LocationResponse, PolicyScopeMode, ResolvedVendor, VendorChoice } from '@c15t/core';
+import type { Theme } from './types/theme/index.js';
 /**
  * Full snapshot accessor. Escape hatch for consumers that genuinely need
  * multiple slices. Prefer narrow hooks for re-render isolation.
@@ -65,6 +66,8 @@ export declare const useHasConsentPolicy: () => boolean;
  * {@link useHasConsentPolicy}.
  */
 export declare const useHasConsentUI: () => boolean;
+/** Whether c15t or an external CMP offers a preferences control. */
+export declare const useHasConsentPreferences: () => boolean;
 /**
  * Derived consent model (opt-in / opt-out / iab), or `null` while no policy
  * rule is resolved. The kernel keeps a safe fallback rule internally; this
@@ -81,26 +84,91 @@ 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;
+/**
+ * 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 may load: it is declared, its category condition
+ * passes, and outside IAB the visitor has not turned it off.
+ *
+ * @param vendorId - Vendor id as declared in `vendors`, on a script or by
+ * the backend.
+ * @returns `true` while the vendor may load. An id nothing declares, such
+ * as a typo, returns `false` and logs a development warning.
+ */
+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).
  */
 export declare const useSetOverrides: () => (input: KernelOverrides) => void;
 /**
- * Sync mutation: switch active language.
+ * Switch the consent language and load its copy.
+ *
+ * Stores the language override and runs init again, so the banner and
+ * dialog show copy in that language: a hosted backend returns it, and
+ * offline mode takes it from the bundled translations and `i18n.messages`.
+ * Setting the current language does nothing. A disabled provider stores
+ * the language without running init.
+ *
+ * @returns A setter that takes a language code such as `'de'`.
+ *
+ * @example
+ * ```tsx
+ * const setLanguage = useSetLanguage();
+ * <button onClick={() => setLanguage('de')}>Deutsch</button>
+ * ```
  */
 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;
 /**
@@ -132,8 +200,6 @@ export declare const usePromptRequirement: () => ConsentSnapshot['promptRequirem
 export declare const useNoticeDismissal: () => ConsentSnapshot['noticeDismissal'];
 /** Read privacySignals from the kernel without a competing projection. */
 export declare const usePrivacySignals: () => ConsentSnapshot['privacySignals'];
-/** Read optOutDirectives from the kernel without a competing projection. */
-export declare const useOptOutDirectives: () => ConsentSnapshot['optOutDirectives'];
 /** Read resolution from the kernel without a competing projection. */
 export declare const usePolicyResolution: () => ConsentSnapshot['resolution'];
 /** Read policyRule from the kernel without a competing projection. */
@@ -142,7 +208,36 @@ export declare const usePolicyRule: () => ConsentSnapshot['policyRule'];
 export declare const useRestrictions: () => ConsentSnapshot['restrictions'];
 /** Dismiss the current local notice without recording a category choice. */
 export declare const useDismissNotice: () => ConsentKernel['commands']['dismissNotice'];
-/** Host first-layer presentation. */
+/**
+ * The presentation experiment arm this visitor runs. Built-in assignment
+ * lands after mount; a host-resolved `variant` is known at once.
+ *
+ * @returns The assignment, or `null` while no experiment is configured, the
+ * arm is not assigned yet, or the visitor's policy rejects it.
+ *
+ * @example
+ * ```tsx
+ * const arm = useExperiment();
+ * return arm ? <p>{arm.id}: {arm.variant}</p> : null;
+ * ```
+ */
+export declare const useExperiment: () => Readonly<ExperimentAssignment> | null;
+/**
+ * The host presentation with the assigned experiment arm merged over it.
+ *
+ * @returns The presentation to render: `options.presentation` itself while
+ * no arm is assigned.
+ */
+export declare const useResolvedPresentation: () => ConsentPresentation | undefined;
+/**
+ * The host theme with the assigned experiment arm's `theme` merged over it.
+ * Render its tokens with `<ConsentTheme theme={useResolvedTheme()} />`.
+ *
+ * @returns The theme to render: `options.theme` itself while no arm is
+ * assigned or the arm has no theme.
+ */
+export declare const useResolvedTheme: () => Theme | undefined;
+/** Host first-layer presentation, with the experiment arm applied. */
 export declare const usePromptPresentation: () => PromptPresentation;
-/** Host persistent preferences presentation. */
+/** Host persistent preferences presentation, with the experiment arm applied. */
 export declare const usePreferencesPresentation: () => PreferencesPresentation;

package/dist-types/iab.d.ts

@@ -1,5 +1,5 @@
 /**
- * IAB TCF 2.3 React components and hooks.
+ * IAB TCF 2.4 React components and hooks.
  *
  * This subpath export contains all IAB-specific React UI. It is only
  * loaded when explicitly imported from '@c15t/react/iab'.
@@ -12,7 +12,7 @@
  * import { IABProvider, IABConsentBanner, IABConsentDialog } from '@c15t/react/iab';
  *
  * <ConsentProvider
- *   options={{ mode: hosted({ url: '/api/c15t' }) }}
+ *   options={{ mode: hosted({ backendURL: '/api/c15t' }) }}
  * >
  *   <IABProvider cmpId={28}>
  *     <IABConsentBanner />
@@ -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-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 } from '../components/consent-gate/index.js';

package/dist-types/index-parts/core.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 { createConsentKernel, custom } from '@c15t/core';

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/frame.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 { Frame } from '../components/consent-gate/frame.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/hosted.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 { hosted } from '@c15t/core';

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/offline.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 { offline } from '../transports/offline.js';

package/dist-types/index-parts/presets.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 { policyRulePresets } from '@c15t/core';

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

@@ -11,7 +11,7 @@
  *
  *   function App({ children }) {
  *     return (
- *       <ConsentProvider options={{ mode: hosted({ url: '/api/c15t' }) }}>
+ *       <ConsentProvider options={{ mode: hosted({ backendURL: '/api/c15t' }) }}>
  *         {children}
  *       </ConsentProvider>
  *     );
@@ -31,31 +31,35 @@
  *   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 { 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 { 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 type { ConsentBannerButton, ConsentBannerLayout, ConsentBannerProps, ConsentBannerRight, ConsentBannerRightLinkProps, ConsentBannerRightsProps, ConsentBannerSurface, } from './components/prompt/index.js';
+export type { ConsentDialogCompoundComponent, ConsentDialogProps, } from './components/panel/index.js';
+export type { ConsentDialogLinkProps } from './components/panel-link/index.js';
+export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, ConsentDialogTriggerToolbarProps, TriggerOrientation, } 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 type { ConsentDraftHandle, ConsentDraftProviderProps, VendorDraftHandle, } from './draft.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';
+export type { Theme } from './types/theme/index.js';
+export type { ConsentBannerCompoundComponent } from './components/prompt/index.js';
+export type { ReactUIOptions } from './types/manager.js';
 export type { ConsentPresentation, PromptPresentation, PreferencesPresentation, PresentationAction, PromptPosition, PromptVariant, ResolvedConsentPresentation, } from '@c15t/core';
+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';

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

@@ -0,0 +1,68 @@
+/**
+ * Kernel access for the hooks and the stock components. The component
+ * selectors below each read a single derived value, so a component
+ * re-renders only when that value changes. Not exported from any package
+ * entry.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+import type { AllConsentNames, ConsentKernel, ConsentSnapshot } from '@c15t/core';
+/**
+ * Reads the kernel from the nearest provider.
+ *
+ * @returns The provider's kernel.
+ * @throws {Error} When called outside a `ConsentProvider`.
+ * @internal
+ */
+export declare const useKernel: () => ConsentKernel;
+/**
+ * Reads the snapshot hydration renders: the kernel's server snapshot, or,
+ * inside a streamed consent surface, the snapshot the server rendered that
+ * surface from.
+ *
+ * @param kernel - The provider's kernel.
+ * @returns A `getServerSnapshot` for `useSyncExternalStore`.
+ * @internal
+ */
+export declare const useServerSnapshot: (kernel: ConsentKernel | null) => () => ConsentSnapshot | undefined;
+/**
+ * Subscribes to one slice of the kernel snapshot. React re-renders the
+ * caller only when the selected value `Object.is`-differs, so a selector
+ * must return a primitive or a reference the snapshot already holds.
+ *
+ * @param selector - Picks the slice from a snapshot.
+ * @returns The selected slice.
+ * @internal
+ */
+export declare const useKernelSelector: <SliceType>(selector: (snap: ConsentSnapshot) => SliceType) => SliceType;
+/**
+ * Like `useKernelSelector`, for selectors that evaluate a gate at a point in
+ * time. The server render and hydration evaluate at the snapshot's own
+ * `evaluatedAt`, so they never read the clock: a Next.js `cacheComponents`
+ * prerender rejects `Date.now()` in a Client Component. In the browser the
+ * gate is evaluated at `Date.now()`, so an expiry the kernel's deadline
+ * timer has not processed yet still denies.
+ *
+ * @param selector - Picks the slice from a snapshot at the given time.
+ * @returns The selected slice.
+ * @internal
+ */
+export declare const useGateSelector: <SliceType>(selector: (snap: ConsentSnapshot, now: number) => SliceType) => SliceType;
+/**
+ * Whether content gated on one category may render, with the kernel's gate
+ * semantics. Server rendering and hydration read no clock; see
+ * `useGateSelector`.
+ *
+ * @param category - Category the content needs.
+ * @returns `true` while the category is permitted.
+ * @internal
+ */
+export declare const useCategoryAllowed: (category: AllConsentNames) => boolean;
+/**
+ * Language of the active translation bundle.
+ *
+ * @returns The bundle's language, or the default language before one loads.
+ * @internal
+ */
+export declare const useTranslationLanguage: () => string;

package/dist-types/modes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `@c15t/react/modes` — the single-page app modes, defaulting to what the
+ * build integration downloaded.
+ *
+ * `manifest()` and `hosted()` here read `@c15t/core/generated`, which
+ * `consentManifest()` from `c15t/build` fills with the policy snapshot and
+ * the backend URL. `c15t/react` exports these in place of the plain
+ * `hosted()` from `@c15t/react`.
+ *
+ * The package index does not import this module. Server-framework packages
+ * re-export the index, and their browser bundles must not import
+ * `@c15t/core/generated`: Next.js fails the build when they do.
+ *
+ * @example
+ * ```tsx
+ * import { ConsentProvider, manifest } from 'c15t/react';
+ *
+ * <ConsentProvider options={{ mode: manifest() }}>{children}</ConsentProvider>;
+ * ```
+ */
+export { hosted } from './transports/hosted.js';
+export type { HostedOptions } from './transports/hosted.js';
+export { manifest } from './transports/manifest.js';
+export type { BrowserManifestModeFactory, ManifestModeOptions, } from './transports/manifest.js';
+export { offline } from './transports/offline.js';
+export type { OfflineModeOptions } from './transports/offline.js';

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

@@ -1,6 +1,38 @@
-import type { IframeBlockerHandle } from '@c15t/core/modules/iframe-blocker';
+import type { ConsentKernel } from '@c15t/core';
+import type { IframeBlockerHandle, IframeBlockerOptions } from '@c15t/core/modules/iframe-blocker';
 export interface UseIframeBlockerOptions {
     disableAutomaticBlocking?: boolean;
 }
 export declare const useIframeBlocker: (options?: UseIframeBlockerOptions) => IframeBlockerHandle;
+/**
+ * Call `onFound` when a gated iframe is on the page: at once when one is
+ * there already, and again for each batch of gated frames that arrives.
+ *
+ * Until the returned stop function runs, a gated frame that arrives with a
+ * `src` the snapshot does not clearly allow is paused (`src` moved to
+ * `data-src`), as the loaded blocker would pause it. Frames on the page at
+ * the first call are left to the blocker, which is what happens when it
+ * loads with the provider.
+ *
+ * @param kernel - The kernel whose snapshot decides what is clearly allowed.
+ * @param onFound - Called for every sighting; the caller dedupes.
+ * @returns Stops watching.
+ * @internal
+ */
+export declare const watchGatedIframes: (kernel: ConsentKernel, onFound: () => void) => () => void;
+/**
+ * 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.
+ *
+ * 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 createIframeBlockerOnDemand: ({ disableAutomaticBlocking, kernel, }: IframeBlockerOptions) => IframeBlockerHandle;
 export type { IframeBlockerHandle };

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

@@ -5,5 +5,28 @@ export interface UseNetworkBlockerOptions {
     logBlockedRequests?: boolean;
     onRequestBlocked?: (info: BlockedRequestInfo) => void;
 }
+/**
+ * Block `fetch` and XHR requests that match `rules` until the visitor's
+ * consent allows them.
+ *
+ * Blocking starts during the first render in the browser: matching requests
+ * wait from then on, including ones sent from this component's children's
+ * mount effects and from effects that run before this component's. The
+ * blocker loads after mount and decides each waiting request. On the
+ * server the hook does nothing.
+ *
+ * Rendering has a side effect: the first render patches `fetch` and
+ * `XMLHttpRequest` to hold matching requests. If React discards that
+ * render and never commits it, the hold ends after 10 seconds. Nothing
+ * checked consent for the requests it held, so they fail as blocked: a 451
+ * response for `fetch`, a failed XHR.
+ *
+ * Prefer the provider's `networkBlocker` option. It starts blocking when
+ * the provider renders, so it also covers components rendered before this
+ * one.
+ *
+ * @param options - Rules and logging options.
+ * @returns A handle to update rules or toggle blocking.
+ */
 export declare const useNetworkBlocker: (options: UseNetworkBlockerOptions) => NetworkBlockerHandle;
 export type { BlockedRequestInfo, NetworkBlockerHandle, NetworkBlockerRule };

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

@@ -0,0 +1,47 @@
+import type { NetworkBlockerRule } from '@c15t/core/modules/network-blocker';
+import type { NetworkHold } from '@c15t/core/modules/network-hold';
+/**
+ * How long a hold started during render waits for its component to commit.
+ * A render React throws away never commits, so nothing else would end its
+ * hold. When this runs out the hold ends, and since nothing checked consent
+ * for the requests it held, they get the blocker's answer for a blocked
+ * request instead of being sent.
+ * @internal
+ */
+export declare const UNCOMMITTED_HOLD_MS = 10000;
+/**
+ * The render-time hold behind one network blocker mount.
+ * @internal
+ */
+export interface EarlyNetworkHold {
+    /**
+     * Call from the mount effect, before loading the blocker. Keeps the hold
+     * from expiring, starts a new one if it already ended (a StrictMode or
+     * kernel re-run after the blocker took over, or a commit that came after
+     * the expiry), and returns it for `createNetworkBlocker({ hold })`. A
+     * disabled blocker gets a hold that holds nothing, so it cannot end
+     * another caller's hold.
+     */
+    claim: (rules: readonly NetworkBlockerRule[], enabled: boolean | undefined) => NetworkHold;
+    /**
+     * Call from the mount effect's cleanup. Ends a hold no blocker took
+     * over, unless the effect runs again first (StrictMode, a kernel change).
+     * Nothing checked consent for what that hold held, so those requests get
+     * the blocker's answer for a blocked request instead of being sent.
+     */
+    unmount: () => void;
+}
+/**
+ * Hold requests matching `rules` from this component's first render in the
+ * browser, before any child renders or runs an effect. The network blocker
+ * loads after mount and takes the hold over.
+ *
+ * Rendering is not side-effect free: the first render patches `fetch` and
+ * `XMLHttpRequest`. That is safe because the hold only delays matching
+ * requests, a render React discards ends its hold after
+ * {@link UNCOMMITTED_HOLD_MS} (failing what it held as blocked), and on the
+ * server it does nothing.
+ *
+ * @internal
+ */
+export declare const useEarlyNetworkHold: (rules: readonly NetworkBlockerRule[], enabled: boolean | undefined) => EarlyNetworkHold;