@c15t/react 3.0.0-alpha.1 → 3.0.0-alpha.11

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

@@ -1,7 +1,7 @@
 import type { ActiveUI, ConsentPresentation, TranslationConfig } from '@c15t/core';
 export declare const useIABConsentManager: (overrides?: ConsentPresentation) => {
     activeUI: ActiveUI;
-    iab: import("../iab-context").ReactIABState | null;
+    iab: import("../iab-context.js").ReactIABState | null;
     model: import("@c15t/core").KernelModel | null;
     policyBanner: {
         allowedActions: import("@c15t/core").PresentationAction[];
@@ -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/use-iab-policy-guard.d.ts

@@ -0,0 +1,35 @@
+import { IABUnavailableError } from '@c15t/core';
+/**
+ * Record that `IABProvider` is part of the app. `@c15t/react/iab` calls
+ * this when it loads.
+ *
+ * @internal
+ */
+export declare const markIABProviderLoaded: () => void;
+/**
+ * The error the standard surfaces throw for an `iab` policy without
+ * `<IABProvider>`.
+ *
+ * @returns A fresh {@link IABUnavailableError}.
+ * @internal
+ */
+export declare const missingIABProviderError: () => IABUnavailableError;
+/**
+ * Throw while rendering when the visitor's policy needs a CMP and the app
+ * has none.
+ *
+ * The standard banner and dialog do not answer for the IAB model, so
+ * without `<IABProvider>` a visitor under an `iab` policy would see no
+ * consent UI at all. Throwing during render reaches error boundaries and
+ * framework error overlays, on the server render and in the browser alike,
+ * since both read the same snapshot.
+ *
+ * `<IABProvider>` usually sits beside the standard surfaces rather than
+ * around them, so a missing IAB context alone does not prove the app has
+ * none. The check also passes once `@c15t/react/iab` has loaded.
+ *
+ * @throws {IABUnavailableError} When the policy needs IAB and neither an
+ * IAB context nor `@c15t/react/iab` is present.
+ * @internal
+ */
+export declare const useIABPolicyGuard: () => void;

package/dist-types/hooks/use-late-entry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether a banner that shows now arrives after the page has painted.
+ *
+ * Decided once each time `shown` turns on, and held while it stays on, so a
+ * re-render never restarts the entry. A banner hydrated from server HTML is
+ * part of the first paint: the hook answers `false` while hydrating, which
+ * also keeps the markup matching the server's.
+ *
+ * @param shown - Whether the banner is rendered.
+ * @returns Whether to mark the mount `data-entry="late"`.
+ *
+ * @internal
+ */
+export declare const useLateEntry: (shown: boolean) => boolean;

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,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-dialog-deferred.d.ts

@@ -0,0 +1,36 @@
+import type { IABConsentDialogCompoundComponent } from './components/iab-panel/index.js';
+/**
+ * The IAB TCF preference centre: purposes, stacks, special features and
+ * per-vendor consent and legitimate-interest controls.
+ *
+ * @remarks
+ * The component code loads on demand. It downloads in the browser's first
+ * idle period after the page's `load` event while the IAB banner is shown,
+ * on hover or focus of the banner's Customize button or partners link, or
+ * when the dialog opens, whichever comes first. `preloadDialog: 'intent'` in
+ * the provider options skips the idle load. `open={true}` or `showTrigger`
+ * loads it on mount under a model `models` lists; under another model,
+ * `showTrigger` loads only the trigger.
+ *
+ * The compound parts (`IABConsentDialog.Root`, `.Card`, `.Header`, `.Tabs`,
+ * `.TabButton`, `.Content`, `.Footer`, `.Overlay`, `.FeatureItem`,
+ * `.PurposeItem`, `.StackItem`, `.VendorList`) load the same module when
+ * they render.
+ *
+ * @example
+ * ```tsx
+ * <IABProvider cmpId={28}>
+ *   <IABConsentBanner />
+ *   <IABConsentDialog />
+ * </IABProvider>
+ * ```
+ *
+ * @public
+ */
+export declare const IABConsentDialog: IABConsentDialogCompoundComponent;
+/**
+ * Reset the warming state shared by mounted dialogs between tests.
+ *
+ * @internal
+ */
+export declare const resetIABDialogWarmingForTests: () => void;

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,9 @@
  *
  * @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 type { IABConsentDialogProps } from './components/iab-panel/index.js';
+export { IABConsentDialog } from './iab-dialog-deferred.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';