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

package/dist-types/components/panel-trigger/atoms/button.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { TriggerSize } from '../types';
+import type { TriggerSize } from '../types.js';
 /**
  * Props for the Button component.
  */

package/dist-types/components/panel-trigger/atoms/icon.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { TriggerIcon as TriggerIconType } from '../types';
+import type { TriggerIcon as TriggerIconType } from '../types.js';
 /**
  * Props for the Icon component.
  */

package/dist-types/components/panel-trigger/atoms/root.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { CornerPosition, TriggerVisibility } from '../types';
-import type { UseDraggableReturn } from '../use-draggable';
+import type { CornerPosition, TriggerVisibility } from '../types.js';
+import type { UseDraggableReturn } from '../use-draggable.js';
 /**
  * Context value for the ConsentDialogTrigger compound component.
  */

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

@@ -5,8 +5,8 @@
  */
 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';
+import type { ClassNameStyle } from '../../../types/theme/index.js';
+import type { ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, TriggerOrientation, TriggerSize } from '../types.js';
 /** 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'> {

package/dist-types/components/panel-trigger/atoms/trigger-icons.d.ts

@@ -0,0 +1,25 @@
+import type { SVGProps } from 'react';
+/**
+ * Dialog-trigger icons, kept apart from the branding logos: the banner renders
+ * the logos on every page, while these only ship with the dialog trigger.
+ */
+interface IconProps {
+    title?: string;
+    titleId?: string;
+}
+/**
+ * Fingerprint icon for privacy/consent contexts.
+ * A generic icon representing user identity and privacy.
+ */
+export declare const FingerprintIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
+/**
+ * Settings/gear icon for preference contexts.
+ * A generic icon representing configuration and settings.
+ */
+export declare const SettingsIcon: ({ title, titleId, ...props }: SVGProps<SVGSVGElement> & IconProps) => import("react").JSX.Element;
+/**
+ * Code icon for the DevTools item a trigger shows while `<ConsentDevTools>`
+ * is mounted. Decorative; the item carries the accessible name.
+ */
+export declare const DevToolsIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export {};

package/dist-types/components/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 './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';
+export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, TriggerRoot, type TriggerRootProps, TriggerText, type TriggerTextProps, useTriggerContext, } from './panel-trigger.js';
+export { ConsentDialogTriggerToolbar } from './panel-trigger-toolbar.js';
+export type { ConsentDialogTriggerProps, ConsentDialogTriggerToolbarAction, ConsentDialogTriggerToolbarPreferences, ConsentDialogTriggerToolbarProps, CornerPosition, TriggerIcon as TriggerIconType, TriggerOrientation, TriggerSize, TriggerVisibility, } from './types.js';
+export { type UseDraggableOptions, type UseDraggableReturn, useDraggable, } from './use-draggable.js';

package/dist-types/components/panel-trigger/panel-trigger-toolbar.d.ts

@@ -5,7 +5,7 @@
  * @packageDocumentation
  */
 import type { ReactNode } from 'react';
-import type { ConsentDialogTriggerToolbarProps } from './types';
+import type { ConsentDialogTriggerToolbarProps } from './types.js';
 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/panel-trigger/panel-trigger.d.ts

@@ -1,21 +1,13 @@
-/**
- * ConsentDialogTrigger compound component.
- *
- * A draggable floating button that opens the consent dialog.
- * Supports drag-to-corner positioning and configurable icons.
- *
- * @packageDocumentation
- */
 import type { FC } from 'react';
-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';
+import { TriggerButton } from './atoms/button.js';
+import type { TriggerButtonProps } from './atoms/button.js';
+import { TriggerIcon } from './atoms/icon.js';
+import type { TriggerIconProps } from './atoms/icon.js';
+import { TriggerRoot, useTriggerContext } from './atoms/root.js';
+import type { TriggerRootProps } from './atoms/root.js';
+import { TriggerText } from './atoms/text.js';
+import type { TriggerTextProps } from './atoms/text.js';
+import type { ConsentDialogTriggerProps } from './types.js';
 /**
  * Compound component interface for ConsentDialogTrigger.
  */

package/dist-types/components/panel-trigger/types.d.ts

@@ -5,7 +5,7 @@
  */
 import type { CornerPosition } from '@c15t/ui/utils/trigger-utils';
 import type { ReactNode } from 'react';
-import type { ClassNameStyle } from '../../types/theme';
+import type { ClassNameStyle } from '../../types/theme/index.js';
 /**
  * Icon rendered by a consent dialog trigger control.
  *

package/dist-types/components/preferences/atoms/accordion.d.ts

@@ -1,7 +1,8 @@
 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';
+import type { BoxProps } from '../../shared/primitives/box.js';
+import * as PreferenceItem from '../../shared/ui/preference-item/index.js';
+import * as RadixSwitch from '../../shared/ui/switch/index.js';
+import { ConsentWidgetVendorList } from './vendor-list.js';
 declare const ConsentWidgetAccordionTrigger: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
 declare const ConsentWidgetAccordionTriggerInner: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
 declare const ConsentWidgetAccordionContent: import("react").ForwardRefExoticComponent<PreferenceItem.PreferenceItemContentProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -25,4 +26,5 @@ declare const Accordion: typeof ConsentWidgetAccordion;
 declare const Switch: import("react").ForwardRefExoticComponent<RadixSwitch.SwitchProps & import("react").RefAttributes<HTMLButtonElement>>;
 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, };
+declare const VendorList: typeof ConsentWidgetVendorList;
+export { ConsentWidgetVendorList, VendorList, Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, ConsentWidgetAccordion, ConsentWidgetAccordionArrow, ConsentWidgetAccordionContent, ConsentWidgetAccordionItem, ConsentWidgetAccordionItems, ConsentWidgetAccordionTrigger, ConsentWidgetAccordionTriggerInner, ConsentWidgetSwitch, Switch, };

package/dist-types/components/preferences/atoms/button.d.ts

@@ -1,4 +1,4 @@
-import type { ConsentButtonProps } from '../../shared/primitives/button.types';
+import type { ConsentButtonProps } from '../../shared/primitives/button.types.js';
 /**
  * Button to accept all available cookies.
  *

package/dist-types/components/preferences/atoms/footer.d.ts

@@ -1,4 +1,4 @@
-import type { BoxProps } from '../../shared/primitives/box';
+import type { BoxProps } from '../../shared/primitives/box.js';
 /**
  * Footer component for consent management actions.
  *

package/dist-types/components/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.js';
 /**
  * Props for the ConsentWidgetRoot component.
  *

package/dist-types/components/preferences/atoms/vendor-list.d.ts

@@ -0,0 +1,23 @@
+import type { AllConsentNames } from '@c15t/core';
+import type { BoxProps } from '../../shared/primitives/box.js';
+export interface ConsentWidgetVendorListProps extends Omit<BoxProps, 'children' | 'slotKey'> {
+    /** Category whose vendors to list. */
+    category: AllConsentNames;
+}
+/**
+ * Vendor rows nested inside one category's accordion content, each a
+ * collapsed card of its own that opens for its description and privacy
+ * policy link. A long list stays one line per vendor.
+ *
+ * Renders nothing when the category has no presentable vendor or the model
+ * is `iab`. Each row's switch stages a per-vendor grant on the same draft
+ * the category switches use; nothing is recorded until Save. While the
+ * parent category is off in the draft, the vendor switches are disabled: a
+ * vendor toggle never grants a category on its own. A `disabled` vendor is
+ * listed without a switch.
+ *
+ * @param props - The category whose vendors to list, plus `Box` attributes.
+ * @returns The vendor list, or `null` when there is nothing to list.
+ * @public
+ */
+export declare const ConsentWidgetVendorList: ({ category, className, noStyle, ...props }: ConsentWidgetVendorListProps) => import("react").JSX.Element | null;

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

@@ -8,12 +8,12 @@
  *
  */
 import type { FC } from 'react';
-import { Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, Switch } from './atoms/accordion';
-import { AcceptAllButton, CustomizeButton, RejectButton, SaveButton } from './atoms/button';
-import { Footer, FooterSubGroup } from './atoms/footer';
-import { Root } from './atoms/root';
-import { PolicyActions } from './policy-actions';
-import type { ConsentWidgetProps } from './types';
+import { Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, Switch, VendorList } from './atoms/accordion.js';
+import { AcceptAllButton, CustomizeButton, RejectButton, SaveButton } from './atoms/button.js';
+import { Footer, FooterSubGroup } from './atoms/footer.js';
+import { Root } from './atoms/root.js';
+import { PolicyActions } from './policy-actions.js';
+import type { ConsentWidgetProps } from './types.js';
 export type { ConsentWidgetProps };
 /**
  * This interface extends the base ConsentWidget component with additional sub-components
@@ -31,6 +31,8 @@ export interface ConsentWidgetCompoundComponent extends FC<ConsentWidgetProps> {
     Switch: typeof Switch;
     AccordionItems: typeof AccordionItems;
     AccordionItem: typeof AccordionItem;
+    /** Vendor rows for one category, nested by `AccordionItems`. */
+    VendorList: typeof VendorList;
     Root: typeof Root;
     AcceptAllButton: typeof AcceptAllButton;
     CustomizeButton: typeof CustomizeButton;
@@ -65,7 +67,7 @@ export interface ConsentWidgetCompoundComponent extends FC<ConsentWidgetProps> {
  * ```tsx
  * <ConsentProvider
  *   options={{
- *     mode: hosted({ url: '/api/c15t' }),
+ *     mode: hosted({ backendURL: '/api/c15t' }),
  *     components: {
  *       accordion: {
  *         root: { className: 'rounded-3xl border border-black/10' },
@@ -94,9 +96,9 @@ export interface ConsentWidgetCompoundComponent extends FC<ConsentWidgetProps> {
  */
 declare const ConsentWidget: ConsentWidgetCompoundComponent;
 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 { type ConsentWidgetPolicyActionRenderProps, ConsentWidgetPolicyActions, type ConsentWidgetPolicyActionsProps, PolicyActions, } from './policy-actions';
+export { Accordion, AccordionArrow, AccordionContent, AccordionItem, AccordionItems, AccordionTrigger, AccordionTriggerInner, ConsentWidgetAccordion, ConsentWidgetAccordionArrow, ConsentWidgetAccordionContent, ConsentWidgetAccordionItem, ConsentWidgetAccordionItems, ConsentWidgetAccordionTrigger, ConsentWidgetAccordionTriggerInner, ConsentWidgetSwitch, ConsentWidgetVendorList, Switch, VendorList, } from './atoms/accordion.js';
+export { AcceptAllButton, ConsentWidgetAcceptAllButton, ConsentWidgetCustomizeButton, ConsentWidgetRejectButton, ConsentWidgetSaveButton, CustomizeButton, RejectButton, SaveButton, } from './atoms/button.js';
+export { ConsentWidgetFooter, ConsentWidgetFooterSubGroup, Footer, FooterSubGroup, } from './atoms/footer.js';
+export { ConsentWidgetRoot, Root } from './atoms/root.js';
+export { type ConsentWidgetPolicyActionRenderProps, ConsentWidgetPolicyActions, type ConsentWidgetPolicyActionsProps, PolicyActions, } from './policy-actions.js';
 export { ConsentWidget };

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

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { HeadlessConsentDialogAction } from '../../component-hooks/use-headless-consent-ui';
-import type { PolicyActionRenderProps } from '../shared/policy-actions';
+import type { HeadlessConsentDialogAction } from '../../component-hooks/use-headless-consent-ui.js';
+import type { PolicyActionRenderProps } from '../shared/policy-actions.js';
 export type ConsentWidgetPolicyActionRenderProps = PolicyActionRenderProps<HeadlessConsentDialogAction>;
 export interface ConsentWidgetPolicyActionsProps {
     renderAction?: (action: HeadlessConsentDialogAction, props: ConsentWidgetPolicyActionRenderProps) => ReactNode;

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

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

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { InlineLegalLinksProps } from '../shared/primitives/legal-links';
+import type { InlineLegalLinksProps } from '../shared/primitives/legal-links/index.js';
 export interface ConsentWidgetRootProps {
     children: ReactNode;
     useProvider?: boolean;

package/dist-types/components/prompt/atoms/early-tap-script.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Keeps a banner tap made before hydration.
+ *
+ * A server-rendered banner shows long before React attaches its handlers.
+ * The inline script records an accept, reject, dismiss or customize tap in
+ * that gap and hides the banner. Once this component mounts, the banner's
+ * own handlers work: it stops the script and records the tap when the
+ * runtime has started. See `@c15t/core/surface-actions`.
+ *
+ * The script is in the server HTML. A banner that hydrates keeps it, inert
+ * once claimed, so hydration changes nothing in the markup. A banner React
+ * renders in the browser has its handlers at once, and a script it inserts
+ * would never run, so there it renders nothing.
+ *
+ * @internal
+ */
+export declare const EarlyTapScript: () => import("react").JSX.Element | null;

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

@@ -73,6 +73,10 @@ interface ConsentBannerRootProps extends HTMLAttributes<HTMLDivElement> {
      */
     blocking?: boolean;
 }
+/**
+ * The banner, rendered where the server can stream it: see
+ * `StreamedSurface`.
+ */
 declare const ConsentBannerRoot: FC<ConsentBannerRootProps>;
 declare const Root: FC<ConsentBannerRootProps>;
 export { ConsentBannerRoot, Root };

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

@@ -5,9 +5,9 @@
  */
 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';
+import type { BoxProps } from '../shared/primitives/box.js';
+import type { ConsentButtonProps } from '../shared/primitives/button.types.js';
+import type { InlineLegalLinksProps } from '../shared/primitives/legal-links/index.js';
 /** Rights the banner can expose as links. `disclosure` is carried by legal links. */
 export type ConsentBannerRight = Exclude<PolicyRight, 'disclosure'>;
 /**
@@ -16,12 +16,18 @@ export type ConsentBannerRight = Exclude<PolicyRight, 'disclosure'>;
  * @remarks
  * Provides the main heading for the consent notice.
  * Implements proper heading semantics and supports theming.
+ * Renders an `h2`. With `asChild`, the child element, such as an `h1`,
+ * takes its place and receives the title's class and attributes.
  *
  * @example
  * ```tsx
  * <ConsentBannerTitle>
  *   Cookie Preferences
  * </ConsentBannerTitle>
+ *
+ * <ConsentBannerTitle asChild>
+ *   <h1>Cookie Preferences</h1>
+ * </ConsentBannerTitle>
  * ```
  */
 declare const ConsentBannerTitle: import("react").ForwardRefExoticComponent<Omit<BoxProps, "slotKey"> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -8,11 +8,11 @@
  *
  */
 import type { FC } from 'react';
-import { Overlay } from './atoms/overlay';
-import { Root } from './atoms/root';
-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';
+import { Overlay } from './atoms/overlay.js';
+import { Root } from './atoms/root.js';
+import { AcceptButton, Card, CustomizeButton, Description, DismissButton, Footer, FooterSubGroup, Header, RejectButton, RightLink, Rights, Title } from './components.js';
+import { PolicyActions } from './policy-actions.js';
+import type { ConsentBannerButton, ConsentBannerLayout, ConsentBannerProps } from './prompt.js';
 /**
  * This interface extends the base ConsentBanner component with additional sub-components
  * that can be used to compose the banner's structure.
@@ -62,7 +62,7 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
  * ```tsx
  * <ConsentProvider
  *   options={{
- *     mode: hosted({ url: '/api/c15t' }),
+ *     mode: hosted({ backendURL: '/api/c15t' }),
  *     i18n: {
  *       locale: 'en',
  *       messages: {
@@ -114,10 +114,10 @@ export interface ConsentBannerCompoundComponent extends FC<ConsentBannerProps> {
  */
 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, 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 { ConsentBannerOverlay, Overlay } from './atoms/overlay.js';
+export { ConsentBannerRoot, Root } from './atoms/root.js';
+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.js';
+export { type ConsentBannerSurface, useConsentBannerSurface, } from './surface-context.js';
+export { useBannerCopy } from './use-banner-copy.js';
+export { type ConsentBannerPolicyActionRenderProps, ConsentBannerPolicyActions, type ConsentBannerPolicyActionsProps, PolicyActions, } from './policy-actions.js';
 export { ConsentBanner, type ConsentBannerButton, type ConsentBannerLayout, type ConsentBannerProps, };

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

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
-import type { HeadlessConsentBannerAction } from '../../component-hooks/use-headless-consent-ui';
-import type { PolicyActionRenderProps } from '../shared/policy-actions';
+import type { HeadlessConsentBannerAction } from '../../component-hooks/use-headless-consent-ui.js';
+import type { PolicyActionRenderProps } from '../shared/policy-actions.js';
 export type ConsentBannerPolicyActionRenderProps = PolicyActionRenderProps<HeadlessConsentBannerAction>;
 export interface ConsentBannerPolicyActionsProps {
     /** Replaces the default preferences buttons before the policy actions. */

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

@@ -2,7 +2,7 @@ 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';
+import type { InlineLegalLinksProps } from '../shared/primitives/legal-links/index.js';
 /**
  * Identifiers for the available buttons in the consent banner.
  * @public
@@ -162,6 +162,10 @@ export interface ConsentBannerProps {
      */
     blocking?: boolean;
 }
+/**
+ * The stock banner. It reads the policy to choose its buttons, so all of
+ * it renders where the server can stream it: see `StreamedSurface`.
+ */
 export declare const ConsentBanner: FC<ConsentBannerProps>;
 /**
  * Component type definition for the ConsentBanner with its compound components.

package/dist-types/components/shared/dialog-sheets.d.ts

@@ -0,0 +1,9 @@
+import type { SurfaceStyleSheet } from './surface-styles.js';
+/**
+ * What the dialog and the preference widget render: the first-paint sheet,
+ * then the dialog and widget rules. Only their lazy chunks import this, so
+ * the dialog rules load with the dialog's code.
+ *
+ * @internal
+ */
+export declare const DIALOG_SHEETS: readonly SurfaceStyleSheet[];

package/dist-types/components/shared/first-paint-sheets.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceStyleSheet } from './surface-styles.js';
+/**
+ * What the banner, trigger and ConsentGate render: tokens, every c15t
+ * variable and the first-paint rules of `styles.css`.
+ *
+ * @internal
+ */
+export declare const FIRST_PAINT_SHEETS: readonly SurfaceStyleSheet[];

package/dist-types/components/shared/iab-dialog-sheets.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceStyleSheet } from './surface-styles.js';
+/** Styles for a standalone IAB dialog, loaded with its code. @internal */
+export declare const IAB_DIALOG_SHEETS: readonly SurfaceStyleSheet[];

package/dist-types/components/shared/iab-first-paint-sheets.d.ts

@@ -0,0 +1,3 @@
+import type { SurfaceStyleSheet } from './surface-styles.js';
+/** The shared tokens and IAB banner rules. @internal */
+export declare const IAB_FIRST_PAINT_SHEETS: readonly SurfaceStyleSheet[];

package/dist-types/components/shared/libs/compose-refs.d.ts

@@ -0,0 +1,20 @@
+import type { Ref, RefCallback } from 'react';
+/**
+ * Combine refs so one element fills all of them.
+ *
+ * @param refs - Callback refs, object refs, or `undefined`.
+ * @returns A callback ref that calls or assigns each ref in order.
+ * @internal
+ */
+export declare const composeRefs: <ElementType>(...refs: (Ref<ElementType> | undefined)[]) => RefCallback<ElementType>;
+/**
+ * {@link composeRefs} for two refs, with a stable identity while they stay
+ * the same, so React does not detach and reattach the element on every
+ * render.
+ *
+ * @param first - A callback ref, object ref, or `undefined`.
+ * @param second - A callback ref, object ref, or `undefined`.
+ * @returns A memoized callback ref.
+ * @internal
+ */
+export declare const useComposedRefs: <ElementType>(first: Ref<ElementType> | undefined, second: Ref<ElementType> | undefined) => RefCallback<ElementType>;

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

@@ -1,6 +1,6 @@
 import type { ComponentType, ReactNode } from 'react';
-import type { HeadlessConsentSurfaceState } from '../../component-hooks/use-headless-consent-ui';
-import type { CSSPropertiesWithVars, CSSVariables } from '../../types/theme';
+import type { HeadlessConsentSurfaceState } from '../../component-hooks/use-headless-consent-ui.js';
+import type { CSSPropertiesWithVars, CSSVariables } from '../../types/theme/index.js';
 export interface PolicyActionRenderProps<TAction extends string> {
     key: string;
     consentAction: TAction;

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

@@ -1,6 +1,6 @@
 import type { ConsentComponentSlotKey } from '@c15t/schema/config';
 import type { HTMLAttributes } from 'react';
-import type { ExtendThemeKeys } from '../../../types/theme';
+import type { ExtendThemeKeys } from '../../../types/theme/index.js';
 /**
  * Props for the description text component of the CookieBanner.
  * Extends standard HTML div attributes.

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

@@ -1,6 +1,6 @@
 import type { AllConsentNames } from '@c15t/core';
-import type { ButtonVariantsProps } from '../ui/button/button';
-import type { ConsentButtonProps } from './button.types';
+import type { ButtonVariantsProps } from '../ui/button/button.js';
+import type { ConsentButtonProps } from './button.types.js';
 type ConsentActionThemeKey = 'accept' | 'reject' | 'customize' | 'dismiss' | 'save';
 /**
  * Button component that allows users to reject non-essential cookies.

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

@@ -1,7 +1,7 @@
 import type { ConsentComponentSlotKey } from '@c15t/schema/config';
 import type { ButtonMode } from '@c15t/ui/styles/primitives';
 import type { ComponentRef, HTMLAttributes, MouseEvent } from 'react';
-import type { CSSVariables, ExtendThemeKeys } from '../../../types/theme';
+import type { CSSVariables, ExtendThemeKeys } from '../../../types/theme/index.js';
 export type ConsentButtonElement = ComponentRef<'button'>;
 /**
  * Props for CookieBanner button components.

package/dist-types/components/shared/streamed-surface.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import type { ReactNode } from 'react';
+/**
+ * React 18's way to suspend: throw the promise, and read its recorded
+ * result on the retry. The runtime's `settled` records its own result.
+ * Exported for tests.
+ *
+ * @internal
+ */
+export declare const readRecorded: <Value>(thenable: PromiseLike<Value>) => Value;
+/**
+ * Renders a consent surface the server can stream. While the provider's
+ * `prefetch` is a promise, the surface waits for it in its own Suspense
+ * boundary: the rest of the page streams at once, and the surface follows
+ * in a later chunk of the same response, rendered from the resolved
+ * config. It shows only when that config carries a policy that shows it.
+ * Hydration reads the same config, so the surface hydrates in place.
+ *
+ * @internal
+ */
+export declare const StreamedSurface: ({ children }: {
+    children: ReactNode;
+}) => string | number | bigint | boolean | React.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | null | undefined> | null | undefined;

package/dist-types/components/shared/surface-styles.d.ts

@@ -0,0 +1,36 @@
+/** A stylesheet from `@c15t/ui/styles/sheets/*`. */
+export interface SurfaceStyleSheet {
+    /** Dedupes the stylesheet: a page renders each `id` once. */
+    id: string;
+    /** The stylesheet text. */
+    css: string;
+}
+/**
+ * Renders the stylesheets a stock surface needs as `<style>` elements.
+ *
+ * The banner, trigger, ConsentGate, dialog and widget each render the
+ * sheets they use, so an app that imports no c15t stylesheet still gets
+ * styled surfaces, and no stylesheet `<link>` holds back the first paint.
+ * A server-rendered surface puts its rules in the HTML. A surface that
+ * renders in the browser, like the dialog, inserts them with its own code.
+ *
+ * In React 19 the elements move to `<head>` and each `id` renders once per
+ * page; later sheets follow earlier ones, which keeps the cascade order of
+ * `styles.css`. React 18 renders them in place, next to the surface, and
+ * so does React 19 when the provider sets a `nonce`: React drops the nonce
+ * from a style it moves to `<head>` unless the app passed the same nonce to
+ * React's server renderer, and a style without it would break a
+ * nonce-based policy.
+ *
+ * Renders nothing when the provider sets `styles: false` (the app imports
+ * `styles.css` itself) or `noStyle`.
+ *
+ * @param props.sheets - The stylesheets, in cascade order.
+ * @param props.noStyle - The surface's own `noStyle` prop.
+ * @returns The `<style>` elements, or `null`.
+ * @internal
+ */
+export declare const SurfaceStyles: ({ sheets, noStyle, }: {
+    sheets: readonly SurfaceStyleSheet[];
+    noStyle?: boolean;
+}) => import("react").JSX.Element[] | null;

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

@@ -1,7 +1,7 @@
 import type { AccordionType } from '@c15t/ui/primitives/accordion';
 import type { ButtonHTMLAttributes, ElementType, HTMLAttributes } from 'react';
-import type { PolymorphicComponentProps } from '../../libs/polymorphic';
-import type { ThemeValue } from '../../../../types/theme';
+import type { PolymorphicComponentProps } from '../../libs/polymorphic.js';
+import type { ThemeValue } from '../../../../types/theme/index.js';
 export type AccordionVariant = 'default' | 'bordered';
 export type AccordionSize = 'medium' | 'small';
 export interface AccordionVariantsProps {

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

@@ -1,2 +1,2 @@
-export * from './accordion';
-export * from './accordion.types';
+export * from './accordion.js';
+export * from './accordion.types.js';

package/dist-types/components/shared/ui/animated-collapse/index.d.ts

@@ -1,2 +1,2 @@
-export type { AnimatedCollapseProps } from './animated-collapse';
-export { AnimatedCollapse } from './animated-collapse';
+export type { AnimatedCollapseProps } from './animated-collapse.js';
+export { AnimatedCollapse } from './animated-collapse.js';

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

@@ -1,6 +1,6 @@
 import type { Branding } from '@c15t/core';
 import type { SVGProps } from 'react';
-import type { CSSPropertiesWithVars } from '../../../types/theme';
+import type { CSSPropertiesWithVars } from '../../../types/theme/index.js';
 export type ResolvedBranding = 'c15t' | 'inth' | 'none';
 export type BrandingVariant = 'footer' | 'dialog-tag' | 'banner-tag';
 export type BrandingSlotContext = 'banner' | 'dialog' | 'manager' | 'iab-banner' | 'iab-dialog';

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

@@ -1,5 +1,5 @@
 import type { ButtonHTMLAttributes, ElementType } from 'react';
-import type { PolymorphicComponentProps } from '../../libs/polymorphic';
+import type { PolymorphicComponentProps } from '../../libs/polymorphic.js';
 export type ButtonVariant = 'primary' | 'neutral' | 'secondary';
 export type ButtonMode = 'filled' | 'stroke' | 'lighter' | 'ghost';
 export type ButtonSize = 'medium' | 'small' | 'xsmall' | 'xxsmall';