@c15t/react 2.0.4 → 2.2.0-canary-20260727202135

package/dist-types/components/consent-banner/components.d.ts

@@ -37,7 +37,7 @@ declare const ConsentBannerTitle: import("react").ForwardRefExoticComponent<Omit
  * ```
  */
 declare const ConsentBannerDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
-    legalLinks?: InlineLegalLinksProps["links"];
+    legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * Footer component for the consent banner.
@@ -129,7 +129,7 @@ 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"> & {
-    legalLinks?: InlineLegalLinksProps["links"];
+    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>>;

package/dist-types/components/consent-banner/policy-actions.d.ts

@@ -6,6 +6,6 @@ export interface ConsentBannerPolicyActionRenderProps extends PolicyActionRender
 export interface ConsentBannerPolicyActionsProps {
     renderAction?: (action: HeadlessConsentBannerAction, props: ConsentBannerPolicyActionRenderProps) => ReactNode;
 }
-export declare function ConsentBannerPolicyActions({ renderAction, }: ConsentBannerPolicyActionsProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConsentBannerPolicyActions({ renderAction, }: ConsentBannerPolicyActionsProps): import("react").JSX.Element;
 declare const PolicyActions: typeof ConsentBannerPolicyActions;
 export { PolicyActions };

package/dist-types/components/consent-dialog/atoms/card.d.ts

@@ -38,7 +38,7 @@ declare const ConsentDialogHeaderTitle: import("react").ForwardRefExoticComponen
  * - Can include legal links inline with the description
  */
 declare const ConsentDialogHeaderDescription: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & {
-    legalLinks?: InlineLegalLinksProps["links"];
+    legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 /**
  * The main content area of the consent dialog.
@@ -65,7 +65,7 @@ type BrandingProps = {
     className?: string;
     'data-testid'?: string;
 };
-export declare function Branding(props: BrandingProps): import("react/jsx-runtime").JSX.Element;
+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.
@@ -91,9 +91,9 @@ export declare function Branding(props: BrandingProps): import("react/jsx-runtim
  */
 declare const ConsentCustomizationCard: ({ noStyle, legalLinks, hideBranding, }: {
     noStyle?: boolean;
-    legalLinks?: InlineLegalLinksProps["links"];
+    legalLinks?: InlineLegalLinksProps['links'];
     hideBranding?: boolean;
-}) => import("react/jsx-runtime").JSX.Element;
+}) => import("react").JSX.Element;
 declare const Card: import("react").ForwardRefExoticComponent<{
     /** The content to be rendered inside the consent dialog card */
     children?: ReactNode;
@@ -101,7 +101,7 @@ declare const Card: import("react").ForwardRefExoticComponent<{
 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"> & {
-    legalLinks?: InlineLegalLinksProps["links"];
+    legalLinks?: InlineLegalLinksProps['links'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 declare const Content: import("react").ForwardRefExoticComponent<Omit<BoxProps, "themeKey"> & import("react").RefAttributes<HTMLDivElement>>;
 declare const Footer: import("react").ForwardRefExoticComponent<BoxProps & {

package/dist-types/components/consent-dialog-trigger/atoms/toolbar.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import type { ClassNameStyle } from '../../../types/theme';
+import type { ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, TriggerOrientation, TriggerSize } from '../types';
+export interface TriggerToolbarProps extends Omit<ClassNameStyle, 'baseClassName'> {
+    /** App-owned actions rendered alongside the preferences action. */
+    actions: readonly ConsentDialogTriggerToolbarAction[];
+    /** Customization for the built-in preferences action. */
+    preferences: ConsentDialogTriggerToolbarPreferences;
+    /** Size of each toolbar item. @default 'md' */
+    size?: TriggerSize;
+    /** Layout direction for the toolbar. @default 'horizontal' */
+    orientation?: TriggerOrientation;
+    /** Accessible name for the toolbar group. @default 'Privacy controls' */
+    ariaLabel?: string;
+}
+/**
+ * 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 namespace TriggerToolbar {
+    var displayName: string;
+}

package/dist-types/components/consent-dialog-trigger/consent-dialog-trigger-toolbar.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Standalone configurable toolbar for resurfacing consent preferences alongside
+ * app-owned controls.
+ *
+ * @packageDocumentation
+ */
+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/index.d.ts

@@ -4,5 +4,6 @@
  * @packageDocumentation
  */
 export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, TriggerRoot, type TriggerRootProps, TriggerText, type TriggerTextProps, useTriggerContext, } from './consent-dialog-trigger';
-export type { ConsentDialogTriggerProps, CornerPosition, TriggerIcon as TriggerIconType, TriggerSize, TriggerVisibility, } from './types';
+export { ConsentDialogTriggerToolbar } from './consent-dialog-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/types.d.ts

@@ -1,12 +1,13 @@
 /**
- * Type definitions for the ConsentDialogTrigger component.
+ * Type definitions for the consent dialog trigger components.
  *
  * @packageDocumentation
  */
 import type { CornerPosition } from '@c15t/ui/utils/trigger-utils';
 import type { ReactNode } from 'react';
+import type { ClassNameStyle } from '../../types/theme';
 /**
- * Icon options for the trigger button.
+ * Icon rendered by a consent dialog trigger control.
  *
  * - `'branding'` - Shows c15t or INTH logo based on branding setting
  * - `'fingerprint'` - Generic fingerprint/privacy icon
@@ -15,7 +16,7 @@ import type { ReactNode } from 'react';
  */
 export type TriggerIcon = 'branding' | 'fingerprint' | 'settings' | ReactNode;
 /**
- * Visibility options for when to show the trigger.
+ * Visibility options for when to show a trigger.
  *
  * - `'always'` - Always visible
  * - `'after-consent'` - Only visible after user has made a consent choice
@@ -23,11 +24,15 @@ export type TriggerIcon = 'branding' | 'fingerprint' | 'settings' | ReactNode;
  */
 export type TriggerVisibility = 'always' | 'after-consent' | 'never';
 /**
- * Size options for the trigger button.
+ * Size options for trigger controls.
  */
 export type TriggerSize = 'sm' | 'md' | 'lg';
 /**
- * Props for the ConsentDialogTrigger component.
+ * Layout direction for the consent dialog trigger toolbar.
+ */
+export type TriggerOrientation = 'horizontal' | 'vertical';
+/**
+ * Props for the existing single-button ConsentDialogTrigger component.
  */
 export interface ConsentDialogTriggerProps {
     /**
@@ -78,7 +83,7 @@ export interface ConsentDialogTriggerProps {
      */
     size?: TriggerSize;
     /**
-     * Callback fired when the trigger is clicked (before opening dialog).
+     * Callback fired when the trigger is clicked, before opening the dialog.
      */
     onClick?: () => void;
     /**
@@ -86,6 +91,106 @@ export interface ConsentDialogTriggerProps {
      */
     onPositionChange?: (position: CornerPosition) => void;
 }
+/**
+ * A custom action displayed in ConsentDialogTriggerToolbar.
+ */
+export interface ConsentDialogTriggerToolbarAction {
+    /** Stable key for the action. */
+    id: string;
+    /** Accessible name announced for the action button. */
+    label: string;
+    /** Icon displayed in the action. */
+    icon: TriggerIcon;
+    /** Callback fired when the action is selected. */
+    onSelect: () => void;
+    /** Whether the action is disabled. */
+    disabled?: boolean;
+    /** Whether the action represents a currently active toggle state. */
+    pressed?: boolean;
+    /** Additional CSS class names for the action button. */
+    className?: string;
+    /** Inline styles for the action button. */
+    style?: ClassNameStyle['style'];
+}
+/**
+ * Customization for the toolbar's built-in privacy preferences action.
+ */
+export interface ConsentDialogTriggerToolbarPreferences {
+    /**
+     * Accessible name announced for the preferences button.
+     *
+     * @default 'Open privacy settings'
+     */
+    label?: string;
+    /**
+     * Icon displayed in the preferences button.
+     *
+     * @default 'branding'
+     */
+    icon?: TriggerIcon;
+    /** Callback fired before the preferences dialog opens. */
+    onSelect?: () => void;
+    /** Additional CSS class names for the preferences button. */
+    className?: string;
+    /** Inline styles for the preferences button. */
+    style?: ClassNameStyle['style'];
+}
+/**
+ * Props for the standalone ConsentDialogTriggerToolbar component.
+ */
+export interface ConsentDialogTriggerToolbarProps extends Omit<ClassNameStyle, 'baseClassName'> {
+    /**
+     * App-owned actions rendered alongside the built-in preferences action.
+     *
+     * @default []
+     */
+    actions?: readonly ConsentDialogTriggerToolbarAction[];
+    /**
+     * Customization for the built-in preferences action. The toolbar always
+     * renders exactly one preferences action.
+     */
+    preferences?: ConsentDialogTriggerToolbarPreferences;
+    /**
+     * Layout direction for the toolbar.
+     *
+     * @default 'horizontal'
+     */
+    orientation?: TriggerOrientation;
+    /**
+     * Default corner position for the toolbar.
+     *
+     * @default 'bottom-right'
+     */
+    defaultPosition?: CornerPosition;
+    /**
+     * Whether to persist the user's position preference in localStorage.
+     *
+     * @default true
+     */
+    persistPosition?: boolean;
+    /**
+     * Accessible label for the toolbar.
+     *
+     * @default 'Privacy controls'
+     */
+    ariaLabel?: string;
+    /**
+     * Controls when the toolbar is visible.
+     *
+     * @default 'always'
+     */
+    showWhen?: TriggerVisibility;
+    /**
+     * Size of each toolbar action.
+     *
+     * @default 'md'
+     */
+    size?: TriggerSize;
+    /**
+     * Callback fired when the corner position changes.
+     */
+    onPositionChange?: (position: CornerPosition) => void;
+}
 /**
  * Re-export CornerPosition for convenience.
  */

package/dist-types/components/consent-widget/atoms/accordion.d.ts

@@ -14,15 +14,15 @@ type ConsentWidgetAccordionProps = Omit<BoxProps, 'themeKey'> & {
     type?: 'multiple' | 'single';
     value?: string | string[];
 };
-declare const ConsentWidgetAccordion: ({ "data-testid": dataTestId, children, className, noStyle, onValueChange, style, type, value, ...props }: ConsentWidgetAccordionProps) => import("react/jsx-runtime").JSX.Element;
-declare const ConsentWidgetAccordionItems: () => import("react/jsx-runtime").JSX.Element[];
+declare const ConsentWidgetAccordion: ({ 'data-testid': dataTestId, children, className, noStyle, onValueChange, style, type, value, ...props }: ConsentWidgetAccordionProps) => import("react").JSX.Element;
+declare const ConsentWidgetAccordionItems: () => import("react").JSX.Element[];
 declare const ConsentWidgetAccordionItem: import("react").ForwardRefExoticComponent<Omit<PreferenceItem.PreferenceItemRootProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 declare const AccordionTriggerInner: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
 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-runtime").JSX.Element;
+declare const Accordion: ({ 'data-testid': dataTestId, children, className, noStyle, onValueChange, style, type, value, ...props }: ConsentWidgetAccordionProps) => import("react").JSX.Element;
 declare const Switch: import("react").ForwardRefExoticComponent<RadixSwitch.SwitchProps & import("react").RefAttributes<HTMLButtonElement>>;
-declare const AccordionItems: () => import("react/jsx-runtime").JSX.Element[];
+declare const AccordionItems: () => import("react").JSX.Element[];
 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/consent-widget.d.ts

@@ -1,2 +1,2 @@
 import type { ConsentWidgetProps } from './types';
-export declare const ConsentWidget: ({ hideBranding, noStyle: localNoStyle, disableAnimation: localDisableAnimation, scrollLock: localScrollLock, trapFocus: localTrapFocus, ...props }: ConsentWidgetProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ConsentWidget: ({ hideBranding, noStyle: localNoStyle, disableAnimation: localDisableAnimation, scrollLock: localScrollLock, trapFocus: localTrapFocus, ...props }: ConsentWidgetProps) => import("react").JSX.Element;

package/dist-types/components/consent-widget/policy-actions.d.ts

@@ -6,6 +6,6 @@ export interface ConsentWidgetPolicyActionRenderProps extends PolicyActionRender
 export interface ConsentWidgetPolicyActionsProps {
     renderAction?: (action: HeadlessConsentDialogAction, props: ConsentWidgetPolicyActionRenderProps) => ReactNode;
 }
-export declare function ConsentWidgetPolicyActions({ renderAction, }: ConsentWidgetPolicyActionsProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConsentWidgetPolicyActions({ renderAction, }: ConsentWidgetPolicyActionsProps): import("react").JSX.Element;
 declare const PolicyActions: typeof ConsentWidgetPolicyActions;
 export { PolicyActions };

package/dist-types/components/integrations/google-map.d.ts

@@ -0,0 +1,82 @@
+import type { AllConsentNames } from 'c15t';
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+export type GoogleMapCoordinates = google.maps.LatLngLiteral;
+export type GoogleMapsApi = typeof google;
+export type GoogleMapInstance = google.maps.Map;
+export type GoogleMapOptions = google.maps.MapOptions;
+export type GoogleMapsLibrary = 'addressValidation' | 'airQuality' | 'core' | 'drawing' | 'elevation' | 'geocoding' | 'geometry' | 'journeySharing' | 'maps' | 'maps3d' | 'marker' | 'places' | 'routes' | 'streetView' | 'visualization';
+export interface GoogleMapProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onError'> {
+    /** Browser API key for the Google Maps JavaScript API. */
+    apiKey: string;
+    /** Initial and controlled center of the map. */
+    center: GoogleMapCoordinates;
+    /**
+     * Initial and controlled zoom level.
+     *
+     * @default 12
+     */
+    zoom?: number;
+    /**
+     * Cloud map id. Changing this value recreates the map because Google treats
+     * it as construction-time configuration.
+     */
+    mapId?: string;
+    /** Additional options passed to the Google Maps constructor. */
+    options?: Omit<GoogleMapOptions, 'center' | 'zoom' | 'mapId'>;
+    /**
+     * Consent category required before the Maps SDK loads.
+     *
+     * @default 'measurement'
+     */
+    consentCategory?: AllConsentNames;
+    /** Google Maps libraries to load with the shared page-level SDK. */
+    libraries?: GoogleMapsLibrary[];
+    /** Language used by Maps controls and service responses. */
+    language?: string;
+    /** Two-character region code used for Maps localization and biasing. */
+    region?: string;
+    /** Google Maps JavaScript API version channel. */
+    version?: string;
+    /** Limits referrer information sent to Google to the current origin. */
+    authReferrerPolicy?: 'origin';
+    /** Google Maps usage-tracking channel. */
+    channel?: string;
+    /** Cloud map ids to preload with the Maps SDK. */
+    mapIds?: string[];
+    /** Google Maps solution-channel identifier. */
+    solutionChannel?: string;
+    /** CSP nonce applied to the Maps script registration. */
+    nonce?: string;
+    /**
+     * Shared c15t script registration id.
+     *
+     * Keep this id and all loader options consistent across the page.
+     *
+     * @default 'c15t-google-maps'
+     */
+    scriptId?: string;
+    /**
+     * Time to wait for the Maps readiness callback before reporting an error.
+     *
+     * @default 15000
+     */
+    timeoutMs?: number;
+    /**
+     * Change this value to retry a failed loader or map initialization.
+     * Successful page-level loader registrations remain shared.
+     *
+     * @default 0
+     */
+    retryKey?: string | number;
+    /** Content shown before the configured consent category is allowed. */
+    placeholder?: ReactNode;
+    /** Content shown while the Maps SDK or map instance is loading. */
+    loadingFallback?: ReactNode;
+    /** Content shown when configuration, loading, authentication, or setup fails. */
+    errorFallback?: ReactNode;
+    /** Called when the map instance is ready. */
+    onReady?: (map: GoogleMapInstance, api: GoogleMapsApi) => void;
+    /** Called when configuration, loading, authentication, or setup fails. */
+    onError?: (error: Error) => void;
+}
+export declare const GoogleMap: import("react").ForwardRefExoticComponent<Omit<GoogleMapProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,2 @@
+export { GoogleMap, type GoogleMapCoordinates, type GoogleMapInstance, type GoogleMapOptions, type GoogleMapProps, type GoogleMapsApi, type GoogleMapsLibrary, } from './google-map';
+export { YouTubeEmbed, type YouTubeEmbedParams, type YouTubeEmbedProps, type YouTubeSrcSource, type YouTubeVideoIdSource, } from './youtube-embed';

package/dist-types/components/integrations/shared.d.ts

@@ -0,0 +1,12 @@
+import type { AllConsentNames } from 'c15t';
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { FrameRoot } from '../frame';
+export declare function IntegrationPlaceholder({ category, children, showButton, ...props }: {
+    category: AllConsentNames;
+    children?: ReactNode;
+    showButton?: boolean;
+} & Omit<ComponentPropsWithoutRef<typeof FrameRoot>, 'children'>): import("react").JSX.Element;
+export declare function IntegrationStatus({ category, status, }: {
+    category: AllConsentNames;
+    status: 'error' | 'loading';
+}): import("react").JSX.Element;

package/dist-types/components/integrations/youtube-embed.d.ts

@@ -0,0 +1,95 @@
+import type { AllConsentNames } from 'c15t';
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type FrameProps } from '../frame';
+export type YouTubeEmbedParams = Record<string, string | number | boolean | null | undefined>;
+interface YouTubeEmbedBaseProps extends Omit<ComponentPropsWithRef<'iframe'>, 'children' | 'src' | 'title'> {
+    /**
+     * Accessible title for the embedded player.
+     */
+    title: string;
+    /**
+     * Consent category required before the iframe mounts.
+     *
+     * @default 'marketing'
+     */
+    consentCategory?: AllConsentNames;
+    /**
+     * Class name for the iframe element targeted by the forwarded ref.
+     */
+    className?: string;
+    /**
+     * Class name for the consent-gated frame wrapper.
+     */
+    wrapperClassName?: string;
+    /**
+     * Placeholder rendered while consent is missing.
+     */
+    placeholder?: ReactNode;
+    /**
+     * Fallback rendered when the iframe cannot be configured or when the
+     * browser reports a native iframe loading error.
+     *
+     * YouTube player-level errors require the IFrame Player API and are not
+     * reported reliably by a standard cross-origin iframe.
+     */
+    errorFallback?: ReactNode;
+    /**
+     * Fallback rendered after consent while the iframe is loading.
+     */
+    loadingFallback?: ReactNode;
+    /**
+     * Additional props passed to the underlying Frame component.
+     */
+    frameProps?: Omit<FrameProps, 'children' | 'category' | 'className' | 'placeholder'>;
+}
+export interface YouTubeVideoIdSource {
+    /**
+     * YouTube video id. Use this for first-party construction of the embed URL.
+     */
+    videoId: string;
+    src?: never;
+    /**
+     * Whether to use youtube-nocookie.com.
+     *
+     * @default true
+     */
+    privacyEnhanced?: boolean;
+    /**
+     * Optional start time in seconds. This takes precedence over `params.start`.
+     */
+    start?: number;
+    /**
+     * Additional query params for the generated embed URL.
+     */
+    params?: YouTubeEmbedParams;
+}
+export interface YouTubeSrcSource {
+    /**
+     * Fully formed YouTube embed URL. Use this when migrating existing embeds.
+     */
+    src: string;
+    videoId?: never;
+    privacyEnhanced?: never;
+    start?: never;
+    params?: never;
+}
+export type YouTubeEmbedProps = YouTubeEmbedBaseProps & (YouTubeVideoIdSource | YouTubeSrcSource);
+/**
+ * Renders a YouTube iframe behind c15t consent gating.
+ *
+ * Use `videoId` for a privacy-enhanced URL built by c15t, or `src` to migrate
+ * an existing complete embed URL. The two source modes are mutually exclusive.
+ * The iframe is mounted only after consent and includes responsive 16:9 layout,
+ * native lazy loading, and a visible loading state by default.
+ *
+ * @example
+ * ```tsx
+ * <YouTubeEmbed
+ *   consentCategory="marketing"
+ *   title="Product demo"
+ *   videoId="dQw4w9WgXcQ"
+ * />
+ * ```
+ */
+export declare const YouTubeEmbed: import("react").ForwardRefExoticComponent<(Omit<YouTubeEmbedBaseProps & YouTubeSrcSource, "ref"> | Omit<YouTubeEmbedBaseProps & YouTubeVideoIdSource, "ref">) & import("react").RefAttributes<HTMLIFrameElement>>;
+export {};

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

@@ -25,5 +25,5 @@ interface PolicyActionsRendererProps<TAction extends string> {
     renderDefaultAction: (action: TAction, props: PolicyActionRenderProps<TAction>) => ReactNode;
     renderAction?: (action: TAction, props: PolicyActionRenderProps<TAction>) => ReactNode;
 }
-export declare function PolicyActionsRenderer<TAction extends string>({ state, Footer, FooterSubGroup, classNames, renderDefaultAction, renderAction, }: PolicyActionsRendererProps<TAction>): import("react/jsx-runtime").JSX.Element;
+export declare function PolicyActionsRenderer<TAction extends string>({ state, Footer, FooterSubGroup, classNames, renderDefaultAction, renderAction, }: PolicyActionsRendererProps<TAction>): import("react").JSX.Element;
 export {};

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

@@ -1,7 +1,41 @@
 import type { AllConsentNames } from 'c15t';
+import { useTheme } from '../../../hooks/use-theme';
 import * as Button from '../ui/button';
+import type { ButtonVariantsProps } from '../ui/button/button';
 import type { ConsentButtonProps } from './button.types';
 type ConsentActionThemeKey = 'accept' | 'reject' | 'customize';
+/**
+ * Resolves the final variant and mode for a consent button.
+ *
+ * @param params.consentAction Semantic consent action key.
+ * @param params.isPrimary Whether the action is primary in the current UI.
+ * @param params.theme Active theme containing `consentActions` overrides.
+ * @param params.variant Explicit `ButtonVariantsProps['variant']` override.
+ * @param params.mode Explicit `ButtonVariantsProps['mode']` override.
+ * @returns The resolved `{ variant, mode }` pair for the button.
+ *
+ * @remarks
+ * Resolution order:
+ * 1. Explicit `variant` / `mode` props
+ * 2. `theme.consentActions[consentAction]`
+ * 3. `theme.consentActions.primary` (when the policy marks the action primary)
+ * 4. `theme.consentActions.default`
+ * 5. `params.fallback`, or the hardcoded fallback based on `isPrimary`
+ */
+export declare function resolveConsentButtonStyle(params: {
+    consentAction?: ConsentActionThemeKey;
+    isPrimary?: boolean;
+    theme?: ReturnType<typeof useTheme>['theme'];
+    variant?: ButtonVariantsProps['variant'];
+    mode?: ButtonVariantsProps['mode'];
+    fallback?: {
+        variant: NonNullable<ButtonVariantsProps['variant']>;
+        mode: NonNullable<ButtonVariantsProps['mode']>;
+    };
+}): {
+    variant: Button.ButtonVariant;
+    mode: Button.ButtonMode;
+};
 /**
  * Button component that allows users to reject non-essential cookies.
  *
@@ -17,10 +51,10 @@ type ConsentActionThemeKey = 'accept' | 'reject' | 'customize';
  *
  * @public
  */
-export declare const ConsentButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & Button.ButtonVariantsProps & {
+export declare const ConsentButton: import("react").ForwardRefExoticComponent<ConsentButtonProps & ButtonVariantsProps & {
     consentAction?: ConsentActionThemeKey;
     isPrimary?: boolean;
-    action: "accept-consent" | "reject-consent" | "custom-consent" | "open-consent-dialog" | "set-consent";
+    action: 'accept-consent' | 'reject-consent' | 'custom-consent' | 'open-consent-dialog' | 'set-consent';
     category?: AllConsentNames;
     closeConsentDialog?: boolean;
     closeConsentBanner?: boolean;

package/dist-types/components/shared/primitives/legal-links/index.d.ts

@@ -42,7 +42,7 @@ export interface InlineLegalLinksProps {
  * />
  * ```
  */
-export declare function InlineLegalLinks({ links, themeKey, testIdPrefix, }: InlineLegalLinksProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function InlineLegalLinks({ links, themeKey, testIdPrefix, }: InlineLegalLinksProps): import("react").JSX.Element | null;
 /**
  * Valid theme key prefixes for the LegalLinks component.
  */

package/dist-types/components/shared/ui/accordion/accordion.d.ts

@@ -47,7 +47,7 @@ declare const AccordionTrigger: import("react").ForwardRefExoticComponent<Accord
 export interface AccordionIconBaseProps extends Record<string, unknown> {
     noStyle?: boolean;
 }
-declare function AccordionIcon<T extends ElementType>({ className, noStyle, as, ...rest }: PolymorphicComponentProps<T, AccordionIconBaseProps>): import("react/jsx-runtime").JSX.Element;
+declare function AccordionIcon<T extends ElementType>({ className, noStyle, as, ...rest }: PolymorphicComponentProps<T, AccordionIconBaseProps>): import("react").JSX.Element;
 declare namespace AccordionIcon {
     var displayName: string;
 }
@@ -62,7 +62,7 @@ type AccordionArrowProps = HTMLAttributes<HTMLDivElement> & {
         className?: string;
     };
 };
-declare function AccordionArrow({ closeIcon, className, noStyle, openIcon, ...rest }: AccordionArrowProps): import("react/jsx-runtime").JSX.Element;
+declare function AccordionArrow({ closeIcon, className, noStyle, openIcon, ...rest }: AccordionArrowProps): import("react").JSX.Element;
 declare namespace AccordionArrow {
     var displayName: string;
 }

package/dist-types/components/shared/ui/branding.d.ts

@@ -21,7 +21,7 @@ type BrandingCompactLogoProps = SVGProps<SVGSVGElement> & {
 };
 export declare function resolveBranding(branding: Branding | string): ResolvedBranding;
 export declare function getBrandingHref(branding: Branding | string, refParam?: string): string;
-export declare function BrandingFullLogo({ branding, className, }: BrandingFullLogoProps): import("react/jsx-runtime").JSX.Element;
-export declare function BrandingCompactLogo({ branding, ...props }: BrandingCompactLogoProps): import("react/jsx-runtime").JSX.Element;
-export declare function BrandingLink({ hideBranding, variant, themeKey, className, style, 'data-testid': testId, }: BrandingProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BrandingFullLogo({ branding, className, }: BrandingFullLogoProps): import("react").JSX.Element;
+export declare function BrandingCompactLogo({ branding, ...props }: BrandingCompactLogoProps): import("react").JSX.Element;
+export declare function BrandingLink({ hideBranding, variant, themeKey, className, style, 'data-testid': testId, }: BrandingProps): import("react").JSX.Element | null;
 export {};

package/dist-types/components/shared/ui/button/button.d.ts

@@ -64,7 +64,7 @@ declare const ButtonRoot: import("react").ForwardRefExoticComponent<ButtonVarian
  *
  * @public
  */
-declare function ButtonIcon<T extends ElementType>({ variant, mode, size, as, className, ...rest }: PolymorphicComponentProps<T, ButtonIconProps>): import("react/jsx-runtime").JSX.Element;
+declare function ButtonIcon<T extends ElementType>({ variant, mode, size, as, className, ...rest }: PolymorphicComponentProps<T, ButtonIconProps>): import("react").JSX.Element;
 declare namespace ButtonIcon {
     var displayName: string;
 }