@c15t/react 2.2.0 → 3.0.0-alpha.0

package/dist-types/components/preferences/policy-actions.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import type { HeadlessConsentDialogAction } from '../../component-hooks/use-headless-consent-ui';
+import type { PolicyActionRenderProps } from '../shared/policy-actions';
+export type ConsentWidgetPolicyActionRenderProps = PolicyActionRenderProps<HeadlessConsentDialogAction>;
+export interface ConsentWidgetPolicyActionsProps {
+    renderAction?: (action: HeadlessConsentDialogAction, props: ConsentWidgetPolicyActionRenderProps) => ReactNode;
+}
+export declare const ConsentWidgetPolicyActions: ({ renderAction, }: ConsentWidgetPolicyActionsProps) => import("react").JSX.Element;
+declare const PolicyActions: typeof ConsentWidgetPolicyActions;
+export { PolicyActions };

package/dist-types/components/{consent-banner → prompt}/atoms/overlay.d.ts

@@ -2,7 +2,7 @@
  * @packageDocumentation
  * Provides the overlay backdrop component for the ConsentBanner.
  */
-import { type HTMLAttributes } from 'react';
+import type { HTMLAttributes } from 'react';
 /**
  * Props for the Overlay component.
  *

package/dist-types/components/prompt/atoms/root.d.ts

@@ -0,0 +1,78 @@
+import type * as C15tCoreTypes from '@c15t/core';
+import type { PromptPosition, PromptVariant } from '@c15t/core';
+import type { FC, HTMLAttributes, ReactNode } from 'react';
+/**
+ * Props for the root component of the ConsentBanner.
+ *
+ * @remarks
+ * The root component serves as the top-level container and context provider
+ * for the consent banner. It manages the consent state and styling configuration
+ * for all child components.
+ *
+ * @public
+ */
+interface ConsentBannerRootProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * @remarks
+     * React elements to be rendered within the consent banner.
+     * Typically includes Content, Title, Description, and Actions components.
+     */
+    children: ReactNode;
+    /**
+     * @remarks
+     * When true, removes all default styling from the banner and its children.
+     * Useful when implementing completely custom styles.
+     */
+    noStyle?: boolean;
+    /**
+     * @remarks
+     * When true, disables the entrance/exit animations.
+     * Useful for environments where animations are not desired.
+     */
+    disableAnimation?: boolean;
+    /**
+     * @remarks
+     * When true, the consent banner will lock the scroll of the page.
+     * Useful for implementing a consent banner that locks the scroll of the page.
+     * @default false
+     */
+    scrollLock?: boolean;
+    /**
+     * @remarks
+     * When true, the consent banner will trap focus.
+     * Useful for implementing a consent banner that traps focus.
+     * @default true
+     */
+    trapFocus?: boolean;
+    /**
+     * Which consent models this banner responds to.
+     * @default ['opt-in', 'opt-out']
+     */
+    models?: C15tCoreTypes.Model[];
+    /**
+     * Override the UI source identifier sent with consent API calls.
+     * @default 'banner'
+     */
+    uiSource?: string;
+    /**
+     * Shape of the prompt. Overrides `presentation.prompt.variant`.
+     * @remarks A notice defaults to `bar`; a choice prompt defaults to `floating`.
+     */
+    variant?: PromptVariant;
+    /**
+     * Placement of the prompt. Overrides `presentation.prompt.position`.
+     * @remarks Must be valid for the resolved variant; otherwise the variant
+     * default is used and a development diagnostic is logged. Host-chosen
+     * positions are never mirrored for right-to-left text.
+     */
+    position?: PromptPosition;
+    /**
+     * Backdrop, scroll lock, focus trap and no outside dismissal, as one value.
+     * Overrides `presentation.prompt.blocking`.
+     * @remarks `wall` is always blocking; a notice never is.
+     */
+    blocking?: boolean;
+}
+declare const ConsentBannerRoot: FC<ConsentBannerRootProps>;
+declare const Root: FC<ConsentBannerRootProps>;
+export { ConsentBannerRoot, Root };

package/dist-types/components/{consent-banner → prompt}/components.d.ts

@@ -3,9 +3,13 @@
  * Provides the core components for building consent banners.
  * Implements accessible, customizable components following GDPR requirements.
  */
-import { type BoxProps } from '../shared/primitives/box';
+import type { PolicyRight } from '@c15t/schema/types';
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+import type { BoxProps } from '../shared/primitives/box';
 import type { ConsentButtonProps } from '../shared/primitives/button.types';
 import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
+/** Rights the banner can expose as links. `disclosure` is carried by legal links. */
+export type ConsentBannerRight = Exclude<PolicyRight, 'disclosure'>;
 /**
  * Title component for the consent banner.
  *
@@ -20,7 +24,7 @@ import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
  * </ConsentBannerTitle>
  * ```
  */
-declare const ConsentBannerTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentBannerTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Description component for the consent banner.
  *
@@ -36,7 +40,7 @@ declare const ConsentBannerTitle: import("react").ForwardRefExoticComponent<Omit
  * </ConsentBannerDescription>
  * ```
  */
-declare const ConsentBannerDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
+declare const ConsentBannerDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & {
     legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 /**
@@ -54,7 +58,7 @@ declare const ConsentBannerDescription: import("react").ForwardRefExoticComponen
  * </ConsentBannerFooter>
  * ```
  */
-declare const ConsentBannerFooter: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentBannerFooter: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Card component for the consent banner.
  *
@@ -71,7 +75,7 @@ declare const ConsentBannerFooter: import("react").ForwardRefExoticComponent<Omi
  * </ConsentBannerCard>
  * ```
  */
-declare const ConsentBannerCard: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentBannerCard: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Header component for the consent banner.
  *
@@ -79,7 +83,7 @@ declare const ConsentBannerCard: import("react").ForwardRefExoticComponent<Omit<
  * Contains the title and description sections.
  * Implements proper spacing and layout for header content.
  */
-declare const ConsentBannerHeader: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentBannerHeader: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Footer sub-group component for organizing related actions.
  *
@@ -87,7 +91,7 @@ declare const ConsentBannerHeader: import("react").ForwardRefExoticComponent<Omi
  * Groups related buttons or controls in the footer.
  * Implements proper spacing and alignment for button groups.
  */
-declare const ConsentBannerFooterSubGroup: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentBannerFooterSubGroup: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Button to reject all non-essential cookies.
  *
@@ -127,15 +131,96 @@ declare const ConsentBannerCustomizeButton: import("react").ForwardRefExoticComp
  * ```
  */
 declare const ConsentBannerAcceptButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
-declare const Title: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const Description: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
+/**
+ * Button that acknowledges a notice prompt.
+ *
+ * @remarks
+ * Records a notice dismissal without recording a category choice, so no
+ * choice callbacks fire. Only rendered when the active policy requires a
+ * notice. Uses `common.acknowledge`, with `common.dismiss` as a fallback.
+ * Children or `dismissButtonText` override the label.
+ * Themed through `theme.consentActions.dismiss`.
+ *
+ * @example
+ * ```tsx
+ * <ConsentBannerDismissButton>
+ *   Got it
+ * </ConsentBannerDismissButton>
+ * ```
+ */
+declare const ConsentBannerDismissButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+/**
+ * Props for {@link ConsentBannerRightLink}.
+ * @public
+ */
+export interface ConsentBannerRightLinkProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type'> {
+    /** Which persistent right the control keeps reachable. */
+    right: ConsentBannerRight;
+    /** Custom label. Defaults to the `rights` translation for `right`. */
+    children?: ReactNode;
+    /** Render the child element instead of a button, keeping the behavior. */
+    asChild?: boolean;
+    /** Skip the banner stylesheet for this control. */
+    noStyle?: boolean;
+}
+/**
+ * Underlined text control that keeps a persistent right reachable from the
+ * banner.
+ *
+ * @remarks
+ * Opens the preference center, where the subject can opt out or change
+ * category preferences. Renders as plain underlined text through the
+ * `rightLink` class and the `banner.rightLink` slot so the primary action
+ * beside it keeps the emphasis. The label comes from the `rights`
+ * translations and children override it. Carries `data-action="right"`,
+ * `data-right`, and `data-c15t-rights` for styling hooks. With `asChild`
+ * the child element, such as a link to a dedicated opt-out page, receives
+ * the same class, attributes, and click handling.
+ *
+ * @example
+ * ```tsx
+ * <ConsentBannerRightLink right="opt-out" />
+ * ```
+ */
+declare const ConsentBannerRightLink: import("react").ForwardRefExoticComponent<ConsentBannerRightLinkProps & import("react").RefAttributes<HTMLButtonElement>>;
+/**
+ * Props for {@link ConsentBannerRights}.
+ * @public
+ */
+export interface ConsentBannerRightsProps extends Omit<BoxProps, 'slotKey'> {
+    /**
+     * Additional preferences buttons to render. Defaults to the resolved
+     * presentation recommendation: a notice under an opt-out rule shows the
+     * opt-out control (which also keeps preferences reachable), and a choice
+     * prompt with customize shows nothing.
+     */
+    rights?: readonly PolicyRight[];
+}
+/**
+ * Group of additional buttons that open preferences.
+ *
+ * @remarks
+ * Renders nothing when no additional preferences button is recommended. Children replace the default
+ * controls; use {@link ConsentBannerRightLink} to keep the behavior.
+ *
+ * @example
+ * ```tsx
+ * <ConsentBannerRights />
+ * ```
+ */
+declare const ConsentBannerRights: import("react").ForwardRefExoticComponent<ConsentBannerRightsProps & import("react").RefAttributes<HTMLDivElement>>;
+declare const Title: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const Description: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & {
     legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
-declare const Footer: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const FooterSubGroup: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const Card: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const Header: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const Footer: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const FooterSubGroup: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const Card: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const Header: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 declare const RejectButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 declare const CustomizeButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 declare const AcceptButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
-export { AcceptButton, Card, ConsentBannerAcceptButton, ConsentBannerCard, ConsentBannerCustomizeButton, ConsentBannerDescription, ConsentBannerFooter, ConsentBannerFooterSubGroup, ConsentBannerHeader, ConsentBannerRejectButton, ConsentBannerTitle, CustomizeButton, Description, Footer, FooterSubGroup, Header, RejectButton, Title, };
+declare const DismissButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+declare const Rights: import("react").ForwardRefExoticComponent<ConsentBannerRightsProps & import("react").RefAttributes<HTMLDivElement>>;
+declare const RightLink: import("react").ForwardRefExoticComponent<ConsentBannerRightLinkProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { AcceptButton, Card, ConsentBannerAcceptButton, ConsentBannerCard, ConsentBannerCustomizeButton, ConsentBannerDescription, ConsentBannerDismissButton, ConsentBannerFooter, ConsentBannerFooterSubGroup, ConsentBannerHeader, ConsentBannerRejectButton, ConsentBannerRightLink, ConsentBannerRights, ConsentBannerTitle, CustomizeButton, Description, DismissButton, Footer, FooterSubGroup, Header, RejectButton, RightLink, Rights, Title, };

package/dist-types/components/{consent-banner → prompt}/error-boundary.d.ts

@@ -1,4 +1,5 @@
-import { Component, type ErrorInfo, type ReactNode } from 'react';
+import { Component } from 'react';
+import type { ErrorInfo, ReactNode } from 'react';
 /**
  * Props for the ErrorBoundary component.
  *
@@ -47,6 +48,7 @@ interface ErrorBoundaryState {
  * @public
  */
 export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    private errorInfo;
     constructor(props: ErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;

package/dist-types/components/{consent-banner → prompt}/index.d.ts

@@ -10,9 +10,9 @@
 import type { FC } from 'react';
 import { Overlay } from './atoms/overlay';
 import { Root } from './atoms/root';
-import { AcceptButton, Card, CustomizeButton, Description, Footer, FooterSubGroup, Header, RejectButton, Title } from './components';
-import { type ConsentBannerButton, type ConsentBannerLayout, type ConsentBannerProps } from './consent-banner';
+import { AcceptButton, Card, CustomizeButton, Description, DismissButton, Footer, FooterSubGroup, Header, RejectButton, RightLink, Rights, Title } from './components';
 import { PolicyActions } from './policy-actions';
+import type { ConsentBannerButton, ConsentBannerLayout, ConsentBannerProps } from './prompt';
 /**
  * This interface extends the base ConsentBanner component with additional sub-components
  * that can be used to compose the banner's structure.
@@ -29,6 +29,9 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
     RejectButton: typeof RejectButton;
     CustomizeButton: typeof CustomizeButton;
     AcceptButton: typeof AcceptButton;
+    DismissButton: typeof DismissButton;
+    Rights: typeof Rights;
+    RightLink: typeof RightLink;
     Overlay: typeof Overlay;
 }
 /**
@@ -37,7 +40,7 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
  * @remarks
  * This component serves as the main entry point for rendering a consent banner.
  * Start with the pre-built component and its existing configuration surface.
- * For most customization, use `ConsentManagerProvider` options, theme tokens,
+ * For most customization, use `ConsentProvider` options, theme tokens,
  * slots, and `theme.consentActions` before reaching for compound composition.
  *
  * Key features:
@@ -55,10 +58,11 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
  * ```
  *
  * @example
- * Preferred customization via provider `i18n`, theme tokens, and slots:
+ * Preferred customization via provider `i18n`, theme tokens, and components:
  * ```tsx
- * <ConsentManagerProvider
+ * <ConsentProvider
  *   options={{
+ *     mode: hosted({ url: '/api/c15t' }),
  *     i18n: {
  *       locale: 'en',
  *       messages: {
@@ -72,15 +76,17 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
  *         surface: '#fffdf8',
  *         surfaceHover: '#f6f3ee',
  *       },
- *       slots: {
- *         consentBannerCard: 'rounded-3xl',
- *         consentBannerFooter: 'border-t border-black/10',
+ *     },
+ *     components: {
+ *       banner: {
+ *         card: { className: 'rounded-3xl' },
+ *         footer: { className: 'border-t border-black/10' },
  *       },
  *     },
  *   }}
  * >
  *   <ConsentBanner primaryButton="accept" />
- * </ConsentManagerProvider>
+ * </ConsentProvider>
  * ```
  *
  * @example
@@ -110,6 +116,8 @@ declare const ConsentBanner: ConsentBannerCompoundComponent;
 export default ConsentBanner;
 export { ConsentBannerOverlay, Overlay } from './atoms/overlay';
 export { ConsentBannerRoot, Root } from './atoms/root';
-export { AcceptButton, Card, ConsentBannerAcceptButton, ConsentBannerCard, ConsentBannerCustomizeButton, ConsentBannerDescription, ConsentBannerFooter, ConsentBannerFooterSubGroup, ConsentBannerHeader, ConsentBannerRejectButton, ConsentBannerTitle, CustomizeButton, Description, Footer, FooterSubGroup, Header, RejectButton, Title, } from './components';
+export { AcceptButton, Card, ConsentBannerAcceptButton, ConsentBannerCard, ConsentBannerCustomizeButton, ConsentBannerDescription, ConsentBannerDismissButton, ConsentBannerFooter, ConsentBannerFooterSubGroup, ConsentBannerHeader, ConsentBannerRejectButton, type ConsentBannerRight, ConsentBannerRightLink, type ConsentBannerRightLinkProps, ConsentBannerRights, type ConsentBannerRightsProps, ConsentBannerTitle, CustomizeButton, Description, DismissButton, Footer, FooterSubGroup, Header, RejectButton, RightLink, Rights, Title, } from './components';
+export { type ConsentBannerSurface, useConsentBannerSurface, } from './surface-context';
+export { useBannerCopy } from './use-banner-copy';
 export { type ConsentBannerPolicyActionRenderProps, ConsentBannerPolicyActions, type ConsentBannerPolicyActionsProps, PolicyActions, } from './policy-actions';
 export { ConsentBanner, type ConsentBannerButton, type ConsentBannerLayout, type ConsentBannerProps, };

package/dist-types/components/prompt/policy-actions.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react';
+import type { HeadlessConsentBannerAction } from '../../component-hooks/use-headless-consent-ui';
+import type { PolicyActionRenderProps } from '../shared/policy-actions';
+export type ConsentBannerPolicyActionRenderProps = PolicyActionRenderProps<HeadlessConsentBannerAction>;
+export interface ConsentBannerPolicyActionsProps {
+    /** Replaces the default preferences buttons before the policy actions. */
+    children?: ReactNode;
+    renderAction?: (action: HeadlessConsentBannerAction, props: ConsentBannerPolicyActionRenderProps) => ReactNode;
+}
+export declare const ConsentBannerPolicyActions: ({ children, renderAction, }: ConsentBannerPolicyActionsProps) => import("react").JSX.Element;
+declare const PolicyActions: typeof ConsentBannerPolicyActions;
+export { PolicyActions };

package/dist-types/components/{consent-banner/consent-banner.d.ts → prompt/prompt.d.ts}

@@ -1,11 +1,13 @@
-import { type PolicyUiActionDirection } from '@c15t/ui/utils';
-import { type FC, type ReactNode } from 'react';
+import type * as C15tCoreTypes from '@c15t/core';
+import type { PromptPosition, PromptVariant } from '@c15t/core';
+import type { SurfacePresentation } from '@c15t/ui/utils';
+import type { FC, ReactNode } from 'react';
 import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
 /**
  * Identifiers for the available buttons in the consent banner.
  * @public
  */
-export type ConsentBannerButton = 'reject' | 'accept' | 'customize';
+export type ConsentBannerButton = 'reject' | 'accept' | 'customize' | 'dismiss' | 'save';
 /**
  * Structure for defining the layout of buttons in the consent banner.
  * Supports nesting for grouping buttons.
@@ -59,15 +61,20 @@ export interface ConsentBannerProps {
      */
     acceptButtonText?: ReactNode;
     /**
-     * When true, the consent banner will lock the scroll of the page
-     * @remarks Useful for implementing a consent banner that locks the scroll of the page
-     * @default false
+     * Content to display on the dismiss button
+     * @remarks Only rendered when the active policy requires a notice prompt
+     * @default undefined
+     */
+    dismissButtonText?: ReactNode;
+    /**
+     * Legacy setting for a blocking banner.
+     * @deprecated Use `blocking` to control focus, scroll and backdrop together.
      */
     scrollLock?: boolean;
     /**
      * When true, the consent banner will trap focus
      * @remarks Useful for implementing a consent banner that traps focus
-     * @default true
+     * @deprecated Use `blocking` to control focus, scroll and backdrop together.
      */
     trapFocus?: boolean;
     /**
@@ -98,7 +105,7 @@ export interface ConsentBannerProps {
      * ```
      *
      * @remarks
-     * You must set the legal links in the ConsentManagerProvider options.
+     * You must set the legal links in the ConsentProvider options.
      */
     legalLinks?: InlineLegalLinksProps['links'];
     /**
@@ -118,7 +125,7 @@ export interface ConsentBannerProps {
      *
      * @defaultValue 'row'
      */
-    direction?: PolicyUiActionDirection;
+    direction?: SurfacePresentation['direction'];
     /**
      * Specifies which button(s) should be highlighted as the primary action.
      *
@@ -129,12 +136,31 @@ export interface ConsentBannerProps {
      * Which consent models this banner responds to.
      * @default ['opt-in']
      */
-    models?: import('c15t').Model[];
+    models?: C15tCoreTypes.Model[];
     /**
      * Override the UI source identifier sent with consent API calls.
      * @default 'banner'
      */
     uiSource?: string;
+    /**
+     * Shape of the prompt: `floating` card, full-width `bar`, compact
+     * `widget`, or centered `wall`. Overrides `presentation.prompt.variant`.
+     * @remarks Every prompt defaults to `floating`. Notices cannot use `wall`.
+     */
+    variant?: PromptVariant;
+    /**
+     * Placement of the prompt. Overrides `presentation.prompt.position`.
+     * @remarks Must be valid for the resolved variant; otherwise the variant
+     * default is used and a development diagnostic is logged. Host-chosen
+     * positions are never mirrored for right-to-left text.
+     */
+    position?: PromptPosition;
+    /**
+     * Backdrop, scroll lock, focus trap and no outside dismissal, as one
+     * value. Overrides `presentation.prompt.blocking`.
+     * @remarks `wall` is always blocking; a notice never is.
+     */
+    blocking?: boolean;
 }
 export declare const ConsentBanner: FC<ConsentBannerProps>;
 /**

package/dist-types/components/prompt/resolve-banner-primary-actions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Primary actions for the banner, with dismiss promoted on a bare notice.
+ *
+ * @remarks
+ * The resolver's default primary is `customize`, which a notice never
+ * offers, so a notice resolves with no primary action. When dismiss is the
+ * only control on the surface it is the primary one.
+ *
+ * @param primaryActions - Primary actions from the resolved presentation.
+ * @param orderedActions - Every action the surface renders, in order.
+ * @returns The primary actions the banner should style.
+ * @internal
+ */
+export declare const resolveBannerPrimaryActions: <Action extends string>(primaryActions: readonly Action[], orderedActions: readonly Action[]) => readonly Action[];

package/dist-types/components/prompt/surface-context.d.ts

@@ -0,0 +1,45 @@
+import type { PromptPosition, PromptVariant } from '@c15t/core';
+/**
+ * Geometry the banner root resolved for the active prompt: the shape it
+ * takes, where it sits, whether that position came from the host, and
+ * whether it blocks the page.
+ *
+ * @public
+ */
+export interface ConsentBannerSurface {
+    /** Shape of the first-layer prompt. */
+    variant: PromptVariant;
+    /** Placement, already mirrored for right-to-left text when defaulted. */
+    position: PromptPosition;
+    /** Whether the host chose the position or the resolver defaulted it. */
+    positionSource: 'host' | 'default';
+    /** Backdrop, scroll lock, focus trap and no outside dismissal. */
+    blocking: boolean;
+}
+/** Shape a compound banner takes before `ConsentBanner.Root` resolves one. */
+export declare const DEFAULT_CONSENT_BANNER_SURFACE: ConsentBannerSurface;
+export declare const ConsentBannerSurfaceContext: import("react").Context<ConsentBannerSurface>;
+/**
+ * Read the geometry `ConsentBanner.Root` resolved for the active prompt.
+ *
+ * @remarks
+ * Outside a root this returns the floating bottom-left default so compound
+ * parts still render.
+ *
+ * @returns The resolved variant, position, its source and blocking state.
+ * @public
+ */
+export declare const useConsentBannerSurface: () => ConsentBannerSurface;
+/**
+ * Mirror a defaulted corner for right-to-left text so the banner keeps
+ * hugging the reading start. Host-chosen positions and edge or center
+ * placements are returned unchanged.
+ *
+ * @param position - The resolved position.
+ * @param positionSource - Whether the host chose it.
+ * @param variant - The resolved variant; only corners of floating and widget mirror.
+ * @param textDirection - Document text direction.
+ * @returns The position to render.
+ * @internal
+ */
+export declare const mirrorDefaultPosition: (position: PromptPosition, positionSource: 'host' | 'default', variant: PromptVariant, textDirection: 'ltr' | 'rtl') => PromptPosition;

package/dist-types/components/prompt/use-banner-copy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Title and description for the banner under the active policy prompt.
+ *
+ * @remarks
+ * A notice prompt reads the `noticeTitle` and `noticeDescription` copy so
+ * it informs rather than asks. Languages that have not translated the notice
+ * copy fall back to the choice copy rather than to English.
+ *
+ * @returns The copy the banner should render when no props override it.
+ * @public
+ */
+export declare const useBannerCopy: () => {
+    title: string | undefined;
+    description: string | undefined;
+    prompt: 'choice' | 'notice' | 'none';
+};

package/dist-types/components/shared/libs/polymorphic.d.ts

@@ -1,7 +1,7 @@
 import type { ComponentPropsWithoutRef, ElementType, PropsWithChildren } from 'react';
-type AsProp<T extends ElementType> = {
+interface AsProp<T extends ElementType> {
     as?: T;
-};
+}
 type PropsToOmit<T extends ElementType, P> = keyof (AsProp<T> & P);
 type PolymorphicComponentProp<T extends ElementType, Props extends Record<string, unknown> = Record<string, unknown>> = PropsWithChildren<Props & AsProp<T>> & Omit<ComponentPropsWithoutRef<T>, PropsToOmit<T, Props>>;
 export type PolymorphicComponentProps<T extends ElementType, P extends Record<string, unknown> = Record<string, unknown>> = PolymorphicComponentProp<T, P>;

package/dist-types/components/shared/libs/recursive-clone-children.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 /**
  * Recursively clones React children, adding additional props to components with matched display names.
  *
@@ -10,4 +10,4 @@ import { type ReactNode } from 'react';
  *
  * @returns The cloned node(s) with the additional props applied to the matched components.
  */
-export declare function recursiveCloneChildren(children: ReactNode, additionalProps: Record<string, unknown>, displayNames: string[], uniqueId: string, asChild?: boolean): ReactNode | ReactNode[];
+export declare const recursiveCloneChildren: (children: ReactNode, additionalProps: Record<string, unknown>, displayNames: string[], uniqueId: string, asChild?: boolean) => ReactNode | ReactNode[];

package/dist-types/components/shared/libs/slot.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 type SlotProps = Record<string, unknown> & {
     children: ReactNode;
 };

package/dist-types/components/shared/libs/use-controllable-state.d.ts

@@ -3,5 +3,5 @@ interface UseControllableStateOptions<T> {
     onChange?: (value: T) => void;
     value?: T;
 }
-export declare function useControllableState<T>({ defaultValue, onChange, value, }: UseControllableStateOptions<T>): readonly [T, (nextValue: T) => void];
+export declare const useControllableState: <T>({ defaultValue, onChange, value, }: UseControllableStateOptions<T>) => readonly [T, (nextValue: T) => void];
 export {};

package/dist-types/components/shared/policy-actions.d.ts

@@ -1,5 +1,5 @@
-import { type ComponentType, type ReactNode } from 'react';
-import type { HeadlessConsentSurfaceState } from '../../hooks/use-headless-consent-ui';
+import type { ComponentType, ReactNode } from 'react';
+import type { HeadlessConsentSurfaceState } from '../../component-hooks/use-headless-consent-ui';
 import type { CSSPropertiesWithVars, CSSVariables } from '../../types/theme';
 export interface PolicyActionRenderProps<TAction extends string> {
     key: string;
@@ -10,6 +10,9 @@ export interface PolicyActionRenderProps<TAction extends string> {
 interface PolicyActionsLayoutProps {
     children?: ReactNode;
     className?: string;
+    'data-direction'?: string;
+    'data-fill'?: true | undefined;
+    'data-split'?: true | undefined;
 }
 interface PolicyActionsClassNames {
     footerFill?: string;
@@ -24,6 +27,8 @@ interface PolicyActionsRendererProps<TAction extends string> {
     classNames: PolicyActionsClassNames;
     renderDefaultAction: (action: TAction, props: PolicyActionRenderProps<TAction>) => ReactNode;
     renderAction?: (action: TAction, props: PolicyActionRenderProps<TAction>) => ReactNode;
+    /** Rendered inside the footer before the action groups, such as right links. */
+    leading?: ReactNode;
 }
-export declare function PolicyActionsRenderer<TAction extends string>({ state, Footer, FooterSubGroup, classNames, renderDefaultAction, renderAction, }: PolicyActionsRendererProps<TAction>): import("react").JSX.Element;
+export declare const PolicyActionsRenderer: <TAction extends string>({ state, Footer, FooterSubGroup, classNames, renderDefaultAction, renderAction, leading, }: PolicyActionsRendererProps<TAction>) => import("react").JSX.Element;
 export {};

package/dist-types/components/shared/primitives/box.d.ts

@@ -1,4 +1,5 @@
-import { type HTMLAttributes } from 'react';
+import type { ConsentComponentSlotKey } from '@c15t/schema/config';
+import type { HTMLAttributes } from 'react';
 import type { ExtendThemeKeys } from '../../../types/theme';
 /**
  * Props for the description text component of the CookieBanner.
@@ -8,6 +9,7 @@ import type { ExtendThemeKeys } from '../../../types/theme';
  */
 export interface BoxProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'>, ExtendThemeKeys {
     asChild?: boolean;
+    slotKey?: ConsentComponentSlotKey;
 }
 /**
  * Renders the descriptive text content within a CookieBanner.