@c15t/react 2.2.1 → 3.0.0-alpha.0

package/dist-types/components/{consent-dialog → panel}/atoms/card.d.ts

@@ -1,7 +1,7 @@
-import { type ReactNode } from 'react';
-import { type BoxProps } from '../../shared/primitives/box';
+import type { ReactNode } from 'react';
+import type { BoxProps } from '../../shared/primitives/box';
 import type { InlineLegalLinksProps } from '../../shared/primitives/legal-links';
-import { type BrandingVariant } from '../../shared/ui/branding';
+import type { BrandingSlotContext, BrandingVariant } from '../../shared/ui/branding';
 import type { ClassNameStyle } from '../../../types/theme';
 declare const ConsentDialogCard: import("react").ForwardRefExoticComponent<{
     /** The content to be rendered inside the consent dialog card */
@@ -16,7 +16,7 @@ declare const ConsentDialogCard: import("react").ForwardRefExoticComponent<{
  * - Should be the first child of ConsentDialogCard
  * - Styled according to the theme configuration
  */
-declare const ConsentDialogHeader: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentDialogHeader: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * The title component for the consent dialog header.
  * Displays the main heading of the consent management interface.
@@ -26,7 +26,7 @@ declare const ConsentDialogHeader: import("react").ForwardRefExoticComponent<Omi
  * - Should be used within ConsentDialogHeader
  * - Supports theme customization
  */
-declare const ConsentDialogHeaderTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentDialogHeaderTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * The description component for the consent dialog header.
  * Provides additional context about privacy settings and consent choices.
@@ -37,7 +37,7 @@ declare const ConsentDialogHeaderTitle: import("react").ForwardRefExoticComponen
  * - Important for explaining privacy choices to users
  * - Can include legal links inline with the description
  */
-declare const ConsentDialogHeaderDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
+declare const ConsentDialogHeaderDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & {
     legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 /**
@@ -49,23 +49,23 @@ declare const ConsentDialogHeaderDescription: import("react").ForwardRefExoticCo
  * - Supports custom content and styling
  * - Handles user interactions with privacy settings
  */
-declare const ConsentDialogContent: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const ConsentDialogContent: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * The footer section of the consent dialog.
  * This contains the branding but can be overidden with a custom footer.
  */
+export declare const Branding: (props: BrandingProps) => import("react").JSX.Element;
 declare const ConsentDialogFooter: import("react").ForwardRefExoticComponent<BoxProps & {
     hideBranding?: boolean;
     'data-testid'?: string;
 } & import("react").RefAttributes<HTMLDivElement>>;
-type BrandingProps = {
+interface BrandingProps {
     hideBranding: boolean;
     variant?: BrandingVariant;
-    themeKey?: import('../../shared/ui/branding').BrandingThemeKey;
+    slotContext?: BrandingSlotContext;
     className?: string;
     'data-testid'?: string;
-};
-export declare function Branding(props: BrandingProps): import("react").JSX.Element;
+}
 /**
  * A pre-configured privacy settings card.
  * Combines all consent dialog components with default content for privacy customization.
@@ -98,12 +98,12 @@ declare const Card: import("react").ForwardRefExoticComponent<{
     /** The content to be rendered inside the consent dialog card */
     children?: ReactNode;
 } & ClassNameStyle<Record<string, string | number>> & import("react").RefAttributes<HTMLDivElement>>;
-declare const Header: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const HeaderTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
-declare const HeaderDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
+declare const Header: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const HeaderTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const HeaderDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & {
     legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
-declare const Content: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const Content: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 declare const Footer: import("react").ForwardRefExoticComponent<BoxProps & {
     hideBranding?: boolean;
     'data-testid'?: string;

package/dist-types/components/{consent-dialog → panel}/atoms/overlay.d.ts

@@ -3,7 +3,7 @@
  * Provides the overlay backdrop component for the consent management interface.
  * Implements accessible modal behavior with animation support.
  */
-import { type CSSProperties, type HTMLAttributes } from 'react';
+import type { FC, PropsWithChildren } from 'react';
 import type { ThemeValue } from '../../../types/theme';
 /**
  * Props for the Overlay component.
@@ -15,17 +15,25 @@ import type { ThemeValue } from '../../../types/theme';
  *
  * @public
  */
-export interface OverlayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+/**
+ * Props for the Overlay component.
+ *
+ * @remarks
+ * Extends {@link PropsWithChildren} so that the overlay can optionally wrap
+ * its compound components (e.g. `ConsentDialog.Card`). This resolves
+ * TypeScript errors when consumers nest elements inside
+ * `<ConsentDialog.Root>`.
+ */
+export type OverlayProps = PropsWithChildren<{
     /**
      * Custom styles to override default overlay styling.
      *
      * @remarks
-     * - Accepts normal React inline styles
-     * - Also accepts the legacy string class name or object with className and style properties
+     * - Can be a string class name or an object with className and style properties
      * - Styles are merged with theme styles and default styles
      * - Useful for customizing overlay appearance while maintaining functionality
      */
-    style?: CSSProperties | ThemeValue;
+    style?: ThemeValue;
     /**
      * Disables default styling when true.
      *
@@ -35,7 +43,15 @@ export interface OverlayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'styl
      * - Maintains functionality without visual opinions
      */
     noStyle?: boolean;
-}
-declare const ConsentDialogOverlay: import("react").ForwardRefExoticComponent<OverlayProps & import("react").RefAttributes<HTMLDivElement>>;
-declare const Overlay: import("react").ForwardRefExoticComponent<OverlayProps & import("react").RefAttributes<HTMLDivElement>>;
+    /**
+     * Whether the dialog the overlay backs is open.
+     *
+     * `ConsentDialog.Root` passes its own open state, so a dialog opened
+     * through the `open` prop rather than the consent manager still fades
+     * its backdrop in. Falls back to the manager's active surface.
+     */
+    open?: boolean;
+}>;
+declare const ConsentDialogOverlay: FC<OverlayProps>;
+declare const Overlay: FC<OverlayProps>;
 export { ConsentDialogOverlay, Overlay };

package/dist-types/components/{consent-dialog → panel}/atoms/root.d.ts

@@ -1,10 +1,11 @@
+import type * as C15tCoreTypes from '@c15t/core';
 import type { FC, HTMLAttributes, ReactNode } from 'react';
 /**
  * Props for the root component of the ConsentDialog.
  *
  * @public
  */
-export interface ConsentDialogRootProps extends HTMLAttributes<HTMLDialogElement> {
+export interface ConsentDialogRootProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * React children that will be rendered inside the dialog container.
      * Typically this includes `ConsentDialog.Card` and its sub-components.
@@ -17,9 +18,9 @@ export interface ConsentDialogRootProps extends HTMLAttributes<HTMLDialogElement
     open?: boolean;
     /**
      * Which consent models this dialog responds to.
-     * @default ['opt-in', 'opt-out']
+     * @default ['opt-in', 'opt-out', 'none']
      */
-    models?: import('c15t').Model[];
+    models?: C15tCoreTypes.Model[];
     /**
      * When true, the component will not apply any internal styles.
      */

package/dist-types/components/{consent-dialog → panel}/index.d.ts

@@ -10,7 +10,7 @@ import type { FC } from 'react';
 import { Card, ConsentCustomizationCard, ConsentDialogContent, ConsentDialogFooter, ConsentDialogHeader, ConsentDialogHeaderDescription, ConsentDialogHeaderTitle, Content, Footer, Header, HeaderDescription, HeaderTitle } from './atoms/card';
 import { Overlay } from './atoms/overlay';
 import { Root } from './atoms/root';
-import { type ConsentDialogProps } from './consent-dialog';
+import type { ConsentDialogProps } from './panel';
 export type { ConsentDialogProps };
 /**
  * This interface extends the base ConsentDialog component with additional sub-components
@@ -55,19 +55,24 @@ export interface ConsentDialogCompoundComponent extends FC<ConsentDialogProps> {
  * @example
  * Preferred customization with stock structure:
  * ```tsx
- * <ConsentManagerProvider
+ * <ConsentProvider
  *   options={{
- *     theme: {
- *       slots: {
- *         consentDialogCard: 'rounded-3xl shadow-xl',
- *         consentWidgetFooter: 'gap-3 pt-6',
- *         consentDialogTag: 'shadow-none',
+ *     mode: hosted({ url: '/api/c15t' }),
+ *     components: {
+ *       dialog: {
+ *         card: { className: 'rounded-3xl shadow-xl' },
+ *       },
+ *       manager: {
+ *         footer: { className: 'gap-3 pt-6' },
+ *       },
+ *       tag: {
+ *         dialog: { className: 'shadow-none' },
  *       },
  *     },
  *   }}
  * >
  *   <ConsentDialog hideBranding showTrigger />
- * </ConsentManagerProvider>
+ * </ConsentProvider>
  * ```
  *
  * @example

package/dist-types/components/{consent-dialog/consent-dialog.d.ts → panel/panel.d.ts}

@@ -1,3 +1,4 @@
+import type * as C15tCoreTypes from '@c15t/core';
 /**
  * @packageDocumentation
  * Default implementation of the Consent Dialog that ships with c15t.
@@ -7,7 +8,7 @@
  * prefer a one-line `<ConsentDialog />` usage still have it.
  */
 import type { FC } from 'react';
-import { type ConsentDialogTriggerProps } from '../consent-dialog-trigger';
+import type { ConsentDialogTriggerProps } from '../panel-trigger';
 import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
 /**
  * Props for the `<ConsentDialog />` convenience component.
@@ -15,7 +16,7 @@ import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
 export interface ConsentDialogProps {
     /**
      * Theme configuration override (deprecated)
-     * @deprecated Theme should be set on the ConsentManagerProvider
+     * @deprecated Theme should be set on the ConsentProvider
      */
     theme?: never;
     /**
@@ -61,7 +62,7 @@ export interface ConsentDialogProps {
      * ```
      *
      * @remarks
-     * You must set the legal links in the ConsentManagerProvider options.
+     * You must set the legal links in the ConsentProvider options.
      */
     legalLinks?: InlineLegalLinksProps['links'];
     /**
@@ -83,9 +84,9 @@ export interface ConsentDialogProps {
     showTrigger?: boolean | ConsentDialogTriggerProps;
     /**
      * Which consent models this dialog responds to.
-     * @default ['opt-in', 'opt-out']
+     * @default ['opt-in', 'opt-out', 'none']
      */
-    models?: import('c15t').Model[];
+    models?: C15tCoreTypes.Model[];
     /**
      * Override the UI source identifier sent with consent API calls.
      * @default 'dialog'

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/atoms/button.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { TriggerSize } from '../types';
 /**
  * Props for the Button component.
@@ -24,6 +24,7 @@ export interface TriggerButtonProps {
      * @default false
      */
     noStyle?: boolean;
+    'data-testid'?: string;
 }
 /**
  * The clickable button element for the trigger.

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/atoms/icon.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { TriggerIcon as TriggerIconType } from '../types';
 /**
  * Props for the Icon component.
@@ -24,21 +24,6 @@ export interface TriggerIconProps {
      */
     noStyle?: boolean;
 }
-/**
- * Icon component that renders the appropriate icon based on branding.
- *
- * @example
- * ```tsx
- * // Default branding icon
- * <ConsentDialogTrigger.Icon />
- *
- * // Fingerprint icon
- * <ConsentDialogTrigger.Icon icon="fingerprint" />
- *
- * // Custom icon
- * <ConsentDialogTrigger.Icon icon={<MyCustomIcon />} />
- * ```
- */
 export declare function TriggerIcon({ icon, className, noStyle, }: TriggerIconProps): ReactNode;
 export declare namespace TriggerIcon {
     var displayName: string;

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/atoms/root.d.ts

@@ -1,12 +1,6 @@
-/**
- * Root component for the ConsentDialogTrigger compound component.
- * Provides context and handles portal rendering.
- *
- * @packageDocumentation
- */
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { CornerPosition, TriggerVisibility } from '../types';
-import { type UseDraggableReturn } from '../use-draggable';
+import type { UseDraggableReturn } from '../use-draggable';
 /**
  * Context value for the ConsentDialogTrigger compound component.
  */
@@ -35,7 +29,7 @@ declare const TriggerContext: import("react").Context<TriggerContextValue | null
  * Hook to access the trigger context.
  * Must be used within a ConsentDialogTrigger.Root component.
  */
-export declare function useTriggerContext(): TriggerContextValue;
+export declare const useTriggerContext: () => TriggerContextValue;
 /**
  * Props for the Root component.
  */
@@ -53,9 +47,15 @@ export interface TriggerRootProps {
     persistPosition?: boolean;
     /**
      * Controls when the trigger is visible.
-     * @default 'after-consent'
+     * @default 'always'
      */
     showWhen?: TriggerVisibility;
+    /**
+     * Replaces the `showWhen` calculation with a host-computed value. The
+     * toolbar uses it so app-owned actions stay mounted while only the
+     * built-in preferences action follows the prompt state.
+     */
+    visible?: boolean;
     /**
      * Callback when position changes.
      */
@@ -65,19 +65,7 @@ export interface TriggerRootProps {
      */
     onClick?: () => void;
 }
-/**
- * Root component that provides context and handles positioning.
- *
- * @example
- * ```tsx
- * <ConsentDialogTrigger.Root>
- *   <ConsentDialogTrigger.Button>
- *     <ConsentDialogTrigger.Icon />
- *   </ConsentDialogTrigger.Button>
- * </ConsentDialogTrigger.Root>
- * ```
- */
-export declare function TriggerRoot({ children, defaultPosition, persistPosition: shouldPersist, showWhen, onPositionChange, onClick, }: TriggerRootProps): ReactNode;
+export declare function TriggerRoot({ children, defaultPosition, persistPosition: shouldPersist, showWhen, visible, onPositionChange, onClick, }: TriggerRootProps): ReactNode;
 export declare namespace TriggerRoot {
     var displayName: string;
 }

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/atoms/text.d.ts

@@ -14,17 +14,6 @@ export interface TriggerTextProps {
      */
     noStyle?: boolean;
 }
-/**
- * Text component for adding labels to the trigger button.
- *
- * @example
- * ```tsx
- * <ConsentDialogTrigger.Button>
- *   <ConsentDialogTrigger.Icon />
- *   <ConsentDialogTrigger.Text>Privacy Settings</ConsentDialogTrigger.Text>
- * </ConsentDialogTrigger.Button>
- * ```
- */
 export declare function TriggerText({ children, className, noStyle, }: TriggerTextProps): ReactNode;
 export declare namespace TriggerText {
     var displayName: string;

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/atoms/toolbar.d.ts

@@ -1,6 +1,14 @@
+/**
+ * Internal toolbar view for ConsentDialogTriggerToolbar.
+ *
+ * @packageDocumentation
+ */
+import type { PolicyRight } from '@c15t/schema/types';
 import type { ReactNode } from 'react';
 import type { ClassNameStyle } from '../../../types/theme';
 import type { ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, TriggerOrientation, TriggerSize } from '../types';
+/** Right the built-in action stands for; opt-out wins when the rule carries it. */
+export type ToolbarPreferencesRight = Extract<PolicyRight, 'opt-out' | 'preferences'>;
 export interface TriggerToolbarProps extends Omit<ClassNameStyle, 'baseClassName'> {
     /** App-owned actions rendered alongside the preferences action. */
     actions: readonly ConsentDialogTriggerToolbarAction[];
@@ -12,11 +20,14 @@ export interface TriggerToolbarProps extends Omit<ClassNameStyle, 'baseClassName
     orientation?: TriggerOrientation;
     /** Accessible name for the toolbar group. @default 'Privacy controls' */
     ariaLabel?: string;
+    /**
+     * Whether the built-in preferences action is rendered. App-owned
+     * actions render regardless.
+     * @default true
+     */
+    showPreferences?: boolean;
 }
-/**
- * A draggable group of app-owned actions and one built-in preferences action.
- */
-export declare function TriggerToolbar({ actions, preferences, size, orientation, ariaLabel, className, style, noStyle, }: TriggerToolbarProps): ReactNode;
+export declare function TriggerToolbar({ actions, preferences, size, orientation, ariaLabel, showPreferences, className, style, noStyle, }: TriggerToolbarProps): ReactNode;
 export declare namespace TriggerToolbar {
     var displayName: string;
 }

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/index.d.ts

@@ -3,7 +3,7 @@
  *
  * @packageDocumentation
  */
-export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, TriggerRoot, type TriggerRootProps, TriggerText, type TriggerTextProps, useTriggerContext, } from './consent-dialog-trigger';
-export { ConsentDialogTriggerToolbar } from './consent-dialog-trigger-toolbar';
+export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, TriggerRoot, type TriggerRootProps, TriggerText, type TriggerTextProps, useTriggerContext, } from './panel-trigger';
+export { ConsentDialogTriggerToolbar } from './panel-trigger-toolbar';
 export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, ConsentDialogTriggerToolbarProps, CornerPosition, TriggerIcon as TriggerIconType, TriggerOrientation, TriggerSize, TriggerVisibility, } from './types';
 export { type UseDraggableOptions, type UseDraggableReturn, useDraggable, } from './use-draggable';

package/dist-types/components/{consent-dialog-trigger/consent-dialog-trigger-toolbar.d.ts → panel-trigger/panel-trigger-toolbar.d.ts}

@@ -6,29 +6,6 @@
  */
 import type { ReactNode } from 'react';
 import type { ConsentDialogTriggerToolbarProps } from './types';
-/**
- * A draggable toolbar that always includes one action for opening consent
- * preferences and can include app-owned actions such as theme or support
- * controls.
- *
- * @example
- * ```tsx
- * <ConsentDialogTriggerToolbar
- *   ariaLabel="Website controls"
- *   actions={[
- *     {
- *       id: 'theme',
- *       label: 'Switch to dark theme',
- *       icon: <MoonIcon />,
- *       pressed: isDark,
- *       onSelect: toggleTheme,
- *     },
- *   ]}
- * />
- * ```
- *
- * @returns The toolbar portal, or `null` while hidden or server-rendered.
- */
 export declare function ConsentDialogTriggerToolbar({ actions, preferences, orientation, defaultPosition, persistPosition, ariaLabel, showWhen, size, className, style, noStyle, onPositionChange, }: ConsentDialogTriggerToolbarProps): ReactNode;
 export declare namespace ConsentDialogTriggerToolbar {
     var displayName: string;

package/dist-types/components/{consent-dialog-trigger/consent-dialog-trigger.d.ts → panel-trigger/panel-trigger.d.ts}

@@ -7,10 +7,14 @@
  * @packageDocumentation
  */
 import type { FC } from 'react';
-import { TriggerButton, type TriggerButtonProps } from './atoms/button';
-import { TriggerIcon, type TriggerIconProps } from './atoms/icon';
-import { TriggerRoot, type TriggerRootProps, useTriggerContext } from './atoms/root';
-import { TriggerText, type TriggerTextProps } from './atoms/text';
+import { TriggerButton } from './atoms/button';
+import type { TriggerButtonProps } from './atoms/button';
+import { TriggerIcon } from './atoms/icon';
+import type { TriggerIconProps } from './atoms/icon';
+import { TriggerRoot, useTriggerContext } from './atoms/root';
+import type { TriggerRootProps } from './atoms/root';
+import { TriggerText } from './atoms/text';
+import type { TriggerTextProps } from './atoms/text';
 import type { ConsentDialogTriggerProps } from './types';
 /**
  * Compound component interface for ConsentDialogTrigger.

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/types.d.ts

@@ -18,11 +18,13 @@ export type TriggerIcon = 'branding' | 'fingerprint' | 'settings' | ReactNode;
 /**
  * Visibility options for when to show a trigger.
  *
- * - `'always'` - Always visible
- * - `'after-consent'` - Only visible after user has made a consent choice
+ * - `'always'` - Visible whenever the preference center is closed
+ * - `'after-prompt'` - Visible only once no prompt is owed: after a choice
+ *   is saved or a notice is dismissed, and hidden again while a policy
+ *   change asks for a new answer
  * - `'never'` - Never visible (useful for programmatic control)
  */
-export type TriggerVisibility = 'always' | 'after-consent' | 'never';
+export type TriggerVisibility = 'always' | 'after-prompt' | 'never';
 /**
  * Size options for trigger controls.
  */
@@ -119,7 +121,10 @@ export interface ConsentDialogTriggerToolbarPreferences {
     /**
      * Accessible name announced for the preferences button.
      *
-     * @default 'Open privacy settings'
+     * Defaults to the active rule's rights: the translated opt-out label
+     * ("Do not sell or share my data") when the rule
+     * carries the `opt-out` right, otherwise the translated preferences
+     * label ("Manage preferences").
      */
     label?: string;
     /**
@@ -146,8 +151,8 @@ export interface ConsentDialogTriggerToolbarProps extends Omit<ClassNameStyle, '
      */
     actions?: readonly ConsentDialogTriggerToolbarAction[];
     /**
-     * Customization for the built-in preferences action. The toolbar always
-     * renders exactly one preferences action.
+     * Customization for the built-in preferences action. The toolbar renders
+     * at most one preferences action; `showWhen` decides whether it is shown.
      */
     preferences?: ConsentDialogTriggerToolbarPreferences;
     /**
@@ -175,7 +180,11 @@ export interface ConsentDialogTriggerToolbarProps extends Omit<ClassNameStyle, '
      */
     ariaLabel?: string;
     /**
-     * Controls when the toolbar is visible.
+     * Controls when the built-in preferences action is visible. App-owned
+     * `actions` always render, so a theme toggle stays available while a
+     * prompt is owed; `after-prompt` hides only the preferences action until
+     * the visitor has answered, and `never` omits it. The toolbar renders
+     * nothing only when it has no visible item.
      *
      * @default 'always'
      */

package/dist-types/components/{consent-dialog-trigger → panel-trigger}/use-draggable.d.ts

@@ -1,11 +1,4 @@
-/**
- * React hook for drag-to-corner functionality.
- *
- * Wraps the framework-agnostic utilities from @c15t/ui with React state management.
- *
- * @packageDocumentation
- */
-import { type CornerPosition } from '@c15t/ui/utils/trigger-utils';
+import type { CornerPosition } from '@c15t/ui/utils/trigger-utils';
 /**
  * Options for the useDraggable hook.
  */
@@ -73,4 +66,4 @@ export interface UseDraggableReturn {
  * }
  * ```
  */
-export declare function useDraggable(options?: UseDraggableOptions): UseDraggableReturn;
+export declare const useDraggable: (options?: UseDraggableOptions) => UseDraggableReturn;

package/dist-types/components/{consent-widget → preferences}/atoms/accordion.d.ts

@@ -1,5 +1,5 @@
-import { type ReactNode } from 'react';
-import { type BoxProps } from '../../shared/primitives/box';
+import type { ReactNode } from 'react';
+import type { BoxProps } from '../../shared/primitives/box';
 import * as PreferenceItem from '../../shared/ui/preference-item';
 import * as RadixSwitch from '../../shared/ui/switch';
 declare const ConsentWidgetAccordionTrigger: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -7,7 +7,7 @@ declare const ConsentWidgetAccordionTriggerInner: import("react").ForwardRefExot
 declare const ConsentWidgetAccordionContent: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemContentProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const ConsentWidgetAccordionArrow: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemSlotProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const ConsentWidgetSwitch: import("react").ForwardRefExoticComponent<RadixSwitch.SwitchProps & import("react").RefAttributes<HTMLButtonElement>>;
-type ConsentWidgetAccordionProps = Omit<BoxProps, 'themeKey'> & {
+type ConsentWidgetAccordionProps = Omit<BoxProps, 'slotKey'> & {
     'data-testid'?: string;
     children: ReactNode;
     onValueChange?: (value: string | string[]) => void;
@@ -21,8 +21,8 @@ declare const AccordionTriggerInner: import("react").ForwardRefExoticComponent<P
 declare const AccordionTrigger: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const AccordionContent: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemContentProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const AccordionArrow: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemSlotProps & import("react").RefAttributes<HTMLDivElement>>;
-declare const Accordion: ({ 'data-testid': dataTestId, children, className, noStyle, onValueChange, style, type, value, ...props }: ConsentWidgetAccordionProps) => import("react").JSX.Element;
+declare const Accordion: typeof ConsentWidgetAccordion;
 declare const Switch: import("react").ForwardRefExoticComponent<RadixSwitch.SwitchProps & import("react").RefAttributes<HTMLButtonElement>>;
-declare const AccordionItems: () => import("react").JSX.Element[];
+declare const AccordionItems: typeof ConsentWidgetAccordionItems;
 declare const AccordionItem: import("react").ForwardRefExoticComponent<Omit<PreferenceItem.PreferenceItemRootProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export { Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, ConsentWidgetAccordion, ConsentWidgetAccordionArrow, ConsentWidgetAccordionContent, ConsentWidgetAccordionItem, ConsentWidgetAccordionItems, ConsentWidgetAccordionTrigger, ConsentWidgetAccordionTriggerInner, ConsentWidgetSwitch, Switch, };

package/dist-types/components/{consent-widget → preferences}/atoms/footer.d.ts

@@ -1,4 +1,4 @@
-import { type BoxProps } from '../../shared/primitives/box';
+import type { BoxProps } from '../../shared/primitives/box';
 /**
  * Footer component for consent management actions.
  *
@@ -7,8 +7,8 @@ import { type BoxProps } from '../../shared/primitives/box';
  * - Supports customization through theme
  * - Maintains consistent layout
  */
-export declare const ConsentWidgetFooter: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const ConsentWidgetFooter: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;
 export declare const ConsentWidgetFooterSubGroup: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
-declare const Footer: 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<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
 export { Footer, FooterSubGroup };

package/dist-types/components/{consent-widget → preferences}/atoms/root.d.ts

@@ -1,5 +1,5 @@
 import type { FC, ReactNode } from 'react';
-import { type ThemeContextValue } from '../../../context/theme-context';
+import type { ThemeContextValue } from '../../../context/theme-context';
 /**
  * Props for the ConsentWidgetRoot component.
  *

package/dist-types/components/{consent-widget → preferences}/index.d.ts

@@ -61,21 +61,23 @@ export interface ConsentWidgetCompoundComponent extends FC<ConsentWidgetProps> {
  * ```
  *
  * @example
- * Preferred stock customization with theme slots:
+ * Preferred stock customization with component slots:
  * ```tsx
- * <ConsentManagerProvider
+ * <ConsentProvider
  *   options={{
- *     theme: {
- *       slots: {
- *         consentWidgetAccordion: 'rounded-3xl border border-black/10',
- *         consentWidgetFooter: 'border-t border-black/10',
- *         consentWidgetFooterSubGroup: 'gap-3',
+ *     mode: hosted({ url: '/api/c15t' }),
+ *     components: {
+ *       accordion: {
+ *         root: { className: 'rounded-3xl border border-black/10' },
+ *       },
+ *       manager: {
+ *         footer: { className: 'border-t border-black/10' },
  *       },
  *     },
  *   }}
  * >
  *   <ConsentWidget hideBranding />
- * </ConsentManagerProvider>
+ * </ConsentProvider>
  * ```
  *
  * @example
@@ -95,6 +97,6 @@ export default ConsentWidget;
 export { Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, ConsentWidgetAccordion, ConsentWidgetAccordionArrow, ConsentWidgetAccordionContent, ConsentWidgetAccordionItem, ConsentWidgetAccordionItems, ConsentWidgetAccordionTrigger, ConsentWidgetAccordionTriggerInner, ConsentWidgetSwitch, Switch, } from './atoms/accordion';
 export { AcceptAllButton, ConsentWidgetAcceptAllButton, ConsentWidgetCustomizeButton, ConsentWidgetRejectButton, ConsentWidgetSaveButton, CustomizeButton, RejectButton, SaveButton, } from './atoms/button';
 export { ConsentWidgetFooter, ConsentWidgetFooterSubGroup, Footer, FooterSubGroup, } from './atoms/footer';
-export { ConsentWidgetRoot, Root, } from './atoms/root';
+export { ConsentWidgetRoot, Root } from './atoms/root';
 export { type ConsentWidgetPolicyActionRenderProps, ConsentWidgetPolicyActions, type ConsentWidgetPolicyActionsProps, PolicyActions, } from './policy-actions';
 export { ConsentWidget };