@ahrowe/ui 0.34.0 → 0.36.0

package/dist/cjs-types/common/badge/badge.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { BadgeProps } from './badge.types.js';
+declare function Badge(props: BadgeProps): ReactElement;
+export default Badge;

package/dist/cjs-types/common/badge/badge.types.d.ts

@@ -0,0 +1,31 @@
+import { CSSProperties, ReactNode } from 'react';
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export declare enum BadgeStyleType {
+    Default = "default",
+    Primary = "primary",
+    Success = "success",
+    Info = "info",
+    Warn = "warn",
+    Error = "error"
+}
+export declare enum BadgePosition {
+    TopRight = "top-right",
+    TopLeft = "top-left",
+    BottomRight = "bottom-right",
+    BottomLeft = "bottom-left"
+}
+export type BadgeSlots = 'badge';
+export interface BadgeProps extends Omit<HtmlProps, 'content'> {
+    count?: number;
+    max?: number;
+    content?: ReactNode;
+    dot?: boolean;
+    showZero?: boolean;
+    styleType?: BadgeStyleType;
+    position?: BadgePosition;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    classNames?: SlotClassNames<BadgeSlots>;
+    styles?: SlotStyles<BadgeSlots>;
+}

package/dist/cjs-types/common/badge/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './badge.js';
+export * from './badge.types.js';

package/dist/cjs-types/common/bodyEnd/bodyEnd.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { BodyEndProps } from './bodyEnd.types.js';
+declare function BodyEnd({ children }: BodyEndProps): ReactElement | null;
+export default BodyEnd;

package/dist/cjs-types/common/bodyEnd/bodyEnd.types.d.ts

@@ -0,0 +1,4 @@
+import { ReactNode } from 'react';
+export interface BodyEndProps {
+    children?: ReactNode;
+}

package/dist/cjs-types/common/bodyEnd/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './bodyEnd.js';
+export * from './bodyEnd.types.js';

package/dist/cjs-types/common/breadcrumb/breadcrumb.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { BreadcrumbProps } from './breadcrumb.types.js';
+declare function Breadcrumb(props: BreadcrumbProps): ReactElement;
+export default Breadcrumb;

package/dist/cjs-types/common/breadcrumb/breadcrumb.types.d.ts

@@ -0,0 +1,33 @@
+import { CSSProperties, MouseEvent, ReactNode } from 'react';
+import { IconContent } from '../types/icon.types.js';
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export interface BreadcrumbItem {
+    id?: string;
+    label: ReactNode;
+    href?: string;
+    icon?: IconContent;
+    onClick?: (event: MouseEvent) => void;
+    disabled?: boolean;
+}
+export type BreadcrumbSlots = 'root' | 'list' | 'item' | 'link' | 'icon' | 'separator' | 'current' | 'ellipsis' | 'hiddenList' | 'hiddenItem';
+/** Text Breadcrumb renders of its own, for translating it. */
+export interface BreadcrumbLabels {
+    /** Button that reveals the collapsed middle items, and its tooltip. */
+    showHidden?: string;
+}
+export interface BreadcrumbProps extends HtmlProps {
+    items: BreadcrumbItem[];
+    separator?: ReactNode;
+    /**
+     * When set, and `items.length` exceeds this, collapses the middle items behind a clickable
+     * ellipsis. The ellipsis itself counts as one of the visible slots — e.g. `maxItems={3}` shows
+     * the first item, the ellipsis, and the last item.
+     */
+    maxItems?: number;
+    className?: string;
+    style?: CSSProperties;
+    classNames?: SlotClassNames<BreadcrumbSlots>;
+    styles?: SlotStyles<BreadcrumbSlots>;
+    /** Overrides the text Breadcrumb renders of its own. Merged per key. */
+    labels?: BreadcrumbLabels;
+}

package/dist/cjs-types/common/breadcrumb/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './breadcrumb.js';
+export * from './breadcrumb.types.js';

package/dist/cjs-types/common/button/button.d.ts

@@ -0,0 +1,9 @@
+import { ReactElement } from 'react';
+import { ButtonStyleType, ButtonSize, ButtonType, ButtonProps } from './button.types.js';
+declare function Button(props: ButtonProps): ReactElement;
+declare namespace Button {
+    var StyleType: typeof ButtonStyleType;
+    var Size: typeof ButtonSize;
+    var Type: typeof ButtonType;
+}
+export default Button;

package/dist/cjs-types/common/button/button.types.d.ts

@@ -0,0 +1,42 @@
+import { default as React, CSSProperties } from 'react';
+import { IconContent } from '../types/icon.types.js';
+import { SlotClassNames, SlotStyles, DataProps } from '../types/slots.types.js';
+export declare enum ButtonStyleType {
+    Primary = "primary",
+    Default = "default",
+    Delete = "delete"
+}
+export declare enum ButtonSize {
+    Default = "default",
+    Small = "small",
+    Medium = "medium",
+    Large = "large",
+    /** Square, padding-free button for a lone icon. Give it its own width/height. */
+    Icon = "icon"
+}
+export declare enum ButtonType {
+    Button = "button",
+    Reset = "reset",
+    Submit = "submit"
+}
+export type ButtonSlots = 'background' | 'content' | 'loadingContainer' | 'label';
+/**
+ * `DataProps` supplies the `data-*` index signature, which `ButtonHTMLAttributes` doesn't cover.
+ * `type` and `onClick` below deliberately narrow their inherited counterparts.
+ */
+export interface ButtonProps extends DataProps, React.ButtonHTMLAttributes<HTMLButtonElement> {
+    className?: string;
+    style?: CSSProperties;
+    type?: ButtonType;
+    styleType?: ButtonStyleType;
+    size?: ButtonSize;
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => Promise<void> | void;
+    children?: React.ReactNode;
+    icon?: IconContent;
+    isLoading?: boolean;
+    disabled?: boolean;
+    title?: string;
+    ref?: React.Ref<HTMLButtonElement>;
+    classNames?: SlotClassNames<ButtonSlots>;
+    styles?: SlotStyles<ButtonSlots>;
+}

package/dist/cjs-types/common/button/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './button.js';
+export * from './button.types.js';

package/dist/cjs-types/common/buttonGroup/buttonGroup.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { ButtonGroupProps } from './buttonGroup.types.js';
+declare function ButtonGroup({ children, orientation, className, style, ...rest }: ButtonGroupProps): ReactElement;
+export default ButtonGroup;

package/dist/cjs-types/common/buttonGroup/buttonGroup.types.d.ts

@@ -0,0 +1,12 @@
+import { CSSProperties, ReactNode } from 'react';
+import { HtmlProps } from '../types/slots.types.js';
+export declare enum ButtonGroupOrientation {
+    Horizontal = "horizontal",
+    Vertical = "vertical"
+}
+export interface ButtonGroupProps extends HtmlProps {
+    children?: ReactNode;
+    orientation?: ButtonGroupOrientation;
+    className?: string;
+    style?: CSSProperties;
+}

package/dist/cjs-types/common/buttonGroup/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './buttonGroup.js';
+export * from './buttonGroup.types.js';

package/dist/cjs-types/common/card/Card.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CardProps } from './card.types.js';
+declare function Card(props: CardProps): React.JSX.Element;
+export default Card;

package/dist/cjs-types/common/card/CardActions.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CardActionsProps } from './card.types.js';
+declare function CardActions({ className, actions, children }: CardActionsProps): React.JSX.Element;
+export default CardActions;

package/dist/cjs-types/common/card/CardContent.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CardContentProps } from './card.types.js';
+declare function CardContent({ children }: CardContentProps): React.JSX.Element;
+export default CardContent;

package/dist/cjs-types/common/card/CardHeader.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CardHeaderProps } from './card.types.js';
+declare function CardHeader({ className, title, subTitle, thumbnail, actions, }: CardHeaderProps): React.JSX.Element;
+export default CardHeader;

package/dist/cjs-types/common/card/CardMedia.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CardMediaProps } from './card.types.js';
+declare function CardMedia({ src, alt }: CardMediaProps): React.JSX.Element;
+export default CardMedia;

package/dist/cjs-types/common/card/card.types.d.ts

@@ -0,0 +1,55 @@
+import { default as React, ReactNode } from 'react';
+import { ButtonStyleType } from '../button/button.types.js';
+import { HtmlProps, SlotClassNames, SlotStyles } from '../types/slots.types.js';
+import { IconAction } from '../types/actions.types.js';
+export declare enum CardStyleType {
+    Elevated = "elevated",
+    Outlined = "outlined",
+    Filled = "filled"
+}
+export type CardSlots = 'root' | 'content';
+export interface CardProps extends Omit<HtmlProps, 'tabIndex'> {
+    className?: string | undefined;
+    children?: ReactNode;
+    styleType?: CardStyleType;
+    onClick?: () => void;
+    tabIndex?: number | null;
+    hoverEffect?: boolean;
+    style?: React.CSSProperties;
+    autoGap?: boolean;
+    clip?: boolean;
+    /** Ref to the root element. */
+    ref?: React.Ref<HTMLDivElement>;
+    /** Classes for the inner elements. See `CardSlots`. */
+    classNames?: SlotClassNames<CardSlots>;
+    /** Inline styles for the inner elements. See `CardSlots`. */
+    styles?: SlotStyles<CardSlots>;
+}
+export type CardHeaderAction = IconAction;
+export interface CardHeaderProps {
+    className?: string;
+    title?: ReactNode;
+    subTitle?: ReactNode;
+    /** URL string → rendered as background-image. Any other ReactNode → rendered inside the thumbnail div. */
+    thumbnail?: string | ReactNode;
+    actions?: CardHeaderAction[] | ReactNode;
+}
+export interface CardMediaProps {
+    src?: string;
+    alt?: string;
+}
+export interface CardContentProps {
+    children?: ReactNode;
+}
+export interface CardAction {
+    id?: string;
+    label?: string;
+    styleType?: ButtonStyleType;
+    onClick?: () => void;
+}
+export interface CardActionsProps {
+    className?: string;
+    /** Renders a Button for each action object. Pass `children` for custom content instead. */
+    actions?: CardAction[];
+    children?: ReactNode;
+}

package/dist/cjs-types/common/card/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './Card.js';
+export { default as CardHeader } from './CardHeader.js';
+export { default as CardMedia } from './CardMedia.js';
+export { default as CardContent } from './CardContent.js';
+export { default as CardActions } from './CardActions.js';
+export * from './card.types.js';

package/dist/cjs-types/common/carousel/carousel.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CarouselProps } from './carousel.types.js';
+declare function Carousel(props: CarouselProps): React.JSX.Element;
+export default Carousel;

package/dist/cjs-types/common/carousel/carousel.types.d.ts

@@ -0,0 +1,35 @@
+import { CSSProperties, ReactNode } from 'react';
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export type CarouselSlots = 'root' | 'track' | 'slide' | 'prevButton' | 'nextButton' | 'dots' | 'dot';
+/** Text Carousel renders of its own, for translating it. */
+export interface CarouselLabels {
+    /** Button to the previous slide, and its tooltip. */
+    previous?: string;
+    /** Button to the next slide, and its tooltip. */
+    next?: string;
+    /** The dot strip, read out by screen readers. */
+    slides?: string;
+    /** One dot, given its 1-based slide number. */
+    goToSlide?: (slide: number) => string;
+}
+export interface CarouselProps extends Omit<HtmlProps, 'onChange'> {
+    children?: ReactNode;
+    currentIndex?: number;
+    defaultIndex?: number;
+    onChange?: (index: number) => void;
+    loop?: boolean;
+    autoPlay?: boolean;
+    autoPlayInterval?: number;
+    pauseOnHover?: boolean;
+    showArrows?: boolean;
+    showDots?: boolean;
+    swipeable?: boolean;
+    lazyRender?: boolean;
+    adaptiveHeight?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    classNames?: SlotClassNames<CarouselSlots>;
+    styles?: SlotStyles<CarouselSlots>;
+    /** Overrides the text Carousel renders of its own. Merged per key. */
+    labels?: CarouselLabels;
+}

package/dist/cjs-types/common/carousel/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './carousel.js';
+export * from './carousel.types.js';

package/dist/cjs-types/common/checkbox/checkbox.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { CheckboxProps } from './checkbox.types.js';
+declare function Checkbox(props: CheckboxProps): ReactElement;
+export default Checkbox;

package/dist/cjs-types/common/checkbox/checkbox.types.d.ts

@@ -0,0 +1,27 @@
+import { CSSProperties, ReactNode, Ref } from 'react';
+import { FormValidator } from '../../services/formValidation/index.js';
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export type CheckboxSlots = 'icon' | 'checkmark' | 'label';
+export interface CheckboxProps extends Omit<HtmlProps, 'onToggle'> {
+    label?: string;
+    selected?: boolean;
+    onToggle?: (isToggled: boolean, event?: React.MouseEvent | React.KeyboardEvent) => void;
+    /** Applied to the root wrapper element */
+    className?: string;
+    style?: CSSProperties;
+    disabled?: boolean;
+    lineHeight?: string;
+    title?: string;
+    tabIndex?: number;
+    cursorDefault?: boolean;
+    width?: string;
+    height?: string;
+    formValidator?: FormValidator | null;
+    children?: ReactNode;
+    background?: string | null;
+    isLoading?: boolean;
+    /** Ref to the root element. */
+    ref?: Ref<HTMLDivElement>;
+    classNames?: SlotClassNames<CheckboxSlots>;
+    styles?: SlotStyles<CheckboxSlots>;
+}

package/dist/cjs-types/common/checkbox/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './checkbox.js';
+export * from './checkbox.types.js';

package/dist/cjs-types/common/chip/chip.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { ChipProps } from './chip.types.js';
+declare function Chip(props: ChipProps): React.JSX.Element;
+export default Chip;

package/dist/cjs-types/common/chip/chip.types.d.ts

@@ -0,0 +1,35 @@
+import { HtmlProps, SlotClassNames, SlotStyles } from '../types/slots.types.js';
+export declare enum ChipStyleType {
+    Default = "default",
+    Primary = "primary",
+    Info = "info",
+    Warn = "warn",
+    Error = "error"
+}
+/** Text Chip renders of its own, for translating it. */
+export interface ChipLabels {
+    /** The remove button, read out by screen readers (default `Remove`). */
+    remove?: string;
+}
+export type ChipSlots = 'root' | 'inner' | 'thumbnail' | 'text' | 'removeIcon';
+export interface ChipProps extends HtmlProps {
+    className?: string;
+    text?: string;
+    thumbnail?: React.ReactNode;
+    styleType?: ChipStyleType;
+    showRemoveIcon?: boolean;
+    /** Accessible name for the remove button. Default `'Remove'`. */
+    onClick?: () => void;
+    onRemove?: () => void;
+    /** Overrides the text Chip renders of its own. Merged per key. */
+    labels?: ChipLabels;
+    /** Classes for the inner elements. See `ChipSlots`. */
+    classNames?: SlotClassNames<ChipSlots>;
+    /** Inline styles for the inner elements. See `ChipSlots`. */
+    styles?: SlotStyles<ChipSlots>;
+}
+export interface ChipContainerProps extends HtmlProps {
+    className?: string;
+    children?: React.ReactNode;
+    inline?: boolean;
+}

package/dist/cjs-types/common/chip/chipContainer.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { ChipContainerProps } from './chip.types.js';
+declare function ChipContainer({ className, children, inline, ...rest }: ChipContainerProps): ReactElement;
+export default ChipContainer;

package/dist/cjs-types/common/chip/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './chip.js';
+export { default as ChipContainer } from './chipContainer.js';
+export * from './chip.types.js';

package/dist/cjs-types/common/colorPicker/colorPicker.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { ColorPickerProps } from './colorPicker.types.js';
+declare function ColorPicker({ className, value, onChange, showInput, showAlpha, inline, labels, style, classNames, styles: slotStyles, ...rest }: ColorPickerProps): ReactElement;
+export default ColorPicker;

package/dist/cjs-types/common/colorPicker/colorPicker.types.d.ts

@@ -0,0 +1,25 @@
+import { SlotClassNames, SlotStyles, HtmlProps } from '../types/slots.types.js';
+export type ColorPickerSlots = 'root' | 'swatch' | 'panel' | 'gradient' | 'hueSlider' | 'alphaSlider' | 'hexInput' | 'eyeDropper';
+/** Text ColorPicker renders of its own, for translating it. */
+export interface ColorPickerLabels {
+    /** The eyedropper button, read out by screen readers. */
+    pickFromScreen?: string;
+    /** The saturation and brightness square, read out by screen readers. */
+    saturationAndBrightness?: string;
+    /** Where the square's cursor currently sits, read out after every move. */
+    saturationAndBrightnessValue?: (saturation: number, brightness: number) => string;
+}
+export interface ColorPickerProps extends Omit<HtmlProps, 'onChange'> {
+    className?: string;
+    value?: string;
+    onChange?: (hex: string) => void;
+    showInput?: boolean;
+    showAlpha?: boolean;
+    inline?: boolean;
+    /** Overrides the text ColorPicker renders of its own. Merged per key. */
+    labels?: ColorPickerLabels;
+    /** Classes for the inner elements. See `ColorPickerSlots`. */
+    classNames?: SlotClassNames<ColorPickerSlots>;
+    /** Inline styles for the inner elements. See `ColorPickerSlots`. */
+    styles?: SlotStyles<ColorPickerSlots>;
+}

package/dist/cjs-types/common/colorPicker/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './colorPicker.js';
+export * from './colorPicker.types.js';

package/dist/cjs-types/common/colorPicker/toHex.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalises any CSS colour the browser understands into hex, which is the only form
+ * ColorPicker's own arithmetic can take. Without it every non-hex value — `transparent`,
+ * `rgba(...)`, and above all `oklch(...)`, which a whole theme may be written in — silently
+ * became the picker's default blue: a swatch confidently showing a colour nothing asked for.
+ *
+ * The canvas 2D context is the browser's own colour parser. Under jsdom there is none, so
+ * this returns `undefined` and callers keep their previous fallback — meaning the widened
+ * behaviour is only observable in a real browser, and only `*.browser.test.ts` can cover it.
+ */
+export declare function toHex(value: string | undefined): string | undefined;

package/dist/cjs-types/common/configProvider/configProvider.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ComponentDefaults, ConfigProviderProps } from './configProvider.types.js';
+import { Presentation } from '../configProvider/presentation.types.js';
+export declare const ConfigContext: React.Context<ComponentDefaults | null>;
+/**
+ * One setting for every component that can present as a bottom sheet, kept separate from
+ * `defaultProps` so that turning sheets on (or off) app-wide is a single switch rather than one
+ * entry per component key — the components that can do it are unrelated to each other, and a
+ * consumer who missed one would get sheets in half their app.
+ */
+export declare const PresentationContext: React.Context<Presentation | undefined>;
+declare function ConfigProvider({ children, defaultProps, presentation }: ConfigProviderProps): React.JSX.Element;
+export default ConfigProvider;

package/dist/cjs-types/common/configProvider/configProvider.types.d.ts

@@ -0,0 +1,133 @@
+import { default as React } from 'react';
+import { InputProps } from '../input/input.types.js';
+import { TextareaProps } from '../textarea/textarea.types.js';
+import { NumberInputProps } from '../numberInput/numberInput.types.js';
+import { DropdownProps } from '../dropdown/dropdown.types.js';
+import { InputDropdownProps } from '../inputDropdown/inputDropdown.types.js';
+import { CheckboxProps } from '../checkbox/checkbox.types.js';
+import { SwitchProps } from '../switch/switch.types.js';
+import { RadioGroupProps } from '../radioGroup/radioGroup.types.js';
+import { DatePickerProps } from '../datePicker/datePicker.types.js';
+import { ColorPickerLabels } from '../colorPicker/colorPicker.types.js';
+import { EmptyStateLabels } from '../emptyState/emptyState.types.js';
+import { KlipyPickerLabels } from '../klipyPicker/klipyPicker.types.js';
+import { SearchInputLabels } from '../searchInput/searchInput.types.js';
+import { TooltipLabels } from '../tooltip/tooltip.types.js';
+import { VirtualListLabels } from '../virtualList/virtualList.types.js';
+import { ButtonProps } from '../button/button.types.js';
+import { ActionButtonsProps } from '../actionButtons/actionButtons.types.js';
+import { ConfirmModalProps } from '../confirmModal/confirmModal.types.js';
+import { BadgeProps } from '../badge/badge.types.js';
+import { ChipProps } from '../chip/chip.types.js';
+import { CardProps } from '../card/card.types.js';
+import { SectionHeaderProps } from '../sectionHeader/sectionHeader.types.js';
+import { SkeletonProps } from '../skeleton/skeleton.types.js';
+import { AccordionProps } from '../accordion/accordion.types.js';
+import { DividerProps } from '../divider/divider.types.js';
+import { AlertProps } from '../alert/alert.types.js';
+import { CarouselProps } from '../carousel/carousel.types.js';
+import { BreadcrumbProps } from '../breadcrumb/breadcrumb.types.js';
+import { RatingProps } from '../rating/rating.types.js';
+import { SplitButtonProps } from '../splitButton/splitButton.types.js';
+import { RevealLensProps } from '../revealLens/revealLens.types.js';
+import { TiltProps } from '../tilt/tilt.types.js';
+import { FlipProps } from '../flip/flip.types.js';
+import { OptionPickerProps } from '../optionPicker/optionPicker.types.js';
+import { TimerProps } from '../timer/timer.types.js';
+import { OtpInputProps } from '../otpInput/otpInput.types.js';
+import { MultiSelectProps } from '../multiSelect/multiSelect.types.js';
+import { PaginationProps } from '../pagination/pagination.types.js';
+import { TreeProps } from '../tree/tree.types.js';
+import { RoomDrawerProps } from '../roomDrawer/roomDrawer.types.js';
+import { RoomViewerProps } from '../roomViewer/roomViewer.types.js';
+import { PopoverProps } from '../popover/popover.types.js';
+import { ModalProps } from '../modal/modal.types.js';
+import { Presentation } from '../configProvider/presentation.types.js';
+/**
+ * Global default props keyed by component name.
+ *
+ * Each entry is merged **under** a component's explicitly-passed props:
+ * an explicit prop always wins, a global default fills in only the props the
+ * caller omitted, and the component's own built-in default applies when
+ * neither is set.
+ *
+ * Add a key here whenever a new component adopts `useComponentDefaults`.
+ *
+ * Note: `Textarea`, `NumberInput`, and `DatePicker` are built on top of `Input`,
+ * so they also inherit `Input` defaults for the props they forward to it — their
+ * own component-keyed defaults take precedence for props they handle themselves.
+ */
+export interface ComponentDefaults {
+    /**
+     * Labels only. These components take no other global defaults: `ColorPicker`
+     * and `Toast` are configured elsewhere, and `VirtualList`'s props are generic,
+     * which a per-key default map can't express.
+     */
+    ColorPicker?: {
+        labels?: ColorPickerLabels;
+    };
+    EmptyState?: {
+        labels?: EmptyStateLabels;
+    };
+    KlipyPicker?: {
+        labels?: KlipyPickerLabels;
+    };
+    SearchInput?: {
+        labels?: SearchInputLabels;
+    };
+    Tooltip?: {
+        labels?: TooltipLabels;
+    };
+    VirtualList?: {
+        labels?: VirtualListLabels;
+    };
+    Input?: Partial<InputProps>;
+    Textarea?: Partial<TextareaProps>;
+    NumberInput?: Partial<NumberInputProps>;
+    Dropdown?: Partial<DropdownProps>;
+    InputDropdown?: Partial<InputDropdownProps>;
+    Checkbox?: Partial<CheckboxProps>;
+    Switch?: Partial<SwitchProps>;
+    RadioGroup?: Partial<RadioGroupProps>;
+    DatePicker?: Partial<DatePickerProps>;
+    Button?: Partial<ButtonProps>;
+    ActionButtons?: Partial<ActionButtonsProps>;
+    ConfirmModal?: Partial<ConfirmModalProps>;
+    Badge?: Partial<BadgeProps>;
+    Chip?: Partial<ChipProps>;
+    Card?: Partial<CardProps>;
+    SectionHeader?: Partial<SectionHeaderProps>;
+    Skeleton?: Partial<SkeletonProps>;
+    Accordion?: Partial<AccordionProps>;
+    Divider?: Partial<DividerProps>;
+    Alert?: Partial<AlertProps>;
+    Carousel?: Partial<CarouselProps>;
+    Breadcrumb?: Partial<BreadcrumbProps>;
+    Rating?: Partial<RatingProps>;
+    SplitButton?: Partial<SplitButtonProps>;
+    RevealLens?: Partial<RevealLensProps>;
+    Tilt?: Partial<TiltProps>;
+    Flip?: Partial<FlipProps>;
+    OptionPicker?: Partial<OptionPickerProps>;
+    Timer?: Partial<TimerProps>;
+    OtpInput?: Partial<OtpInputProps>;
+    MultiSelect?: Partial<MultiSelectProps>;
+    Pagination?: Partial<PaginationProps>;
+    Tree?: Partial<TreeProps>;
+    RoomDrawer?: Partial<RoomDrawerProps>;
+    RoomViewer?: Partial<RoomViewerProps>;
+    Popover?: Partial<PopoverProps>;
+    Modal?: Partial<ModalProps>;
+}
+export interface ConfigProviderProps {
+    children: React.ReactNode;
+    /** Global default props, keyed by component name. */
+    defaultProps?: ComponentDefaults;
+    /**
+     * How every sheet-capable component presents by default: anchored to its trigger, always a
+     * bottom sheet, or a sheet only on a small touch screen. One switch for `Popover`,
+     * `Dropdown`, `Popover` and `Modal` at once (and so for everything built on them). A
+     * component-keyed entry in `defaultProps` overrides it, and an explicit prop overrides both.
+     */
+    presentation?: Presentation;
+}

package/dist/cjs-types/common/configProvider/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './configProvider.js';
+export { useComponentDefaults } from './useComponentDefaults.js';
+export { useLabels } from './useLabels.js';
+export { usePresentationDefault } from './usePresentationDefault.js';
+export type { ComponentDefaults, ConfigProviderProps } from './configProvider.types.js';
+export { Presentation } from './presentation.types.js';

package/dist/cjs-types/common/configProvider/presentation.types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * How a surface is presented on screen. Lives here rather than with any one of
+ * the components that read it: `Modal`, `Popover`, `Dropdown` and `MultiSelect`
+ * all take it, and `ConfigProvider` owns the app-wide switch that sets it for
+ * every one of them at once.
+ */
+export declare enum Presentation {
+    /** Wherever the component normally puts it: anchored to its trigger, or centred for a Modal. */
+    Default = "default",
+    /** Pinned to the bottom of the screen, full width up to a maximum. */
+    Sheet = "sheet",
+    /** A sheet on touch devices with a small screen, anchored everywhere else. */
+    Auto = "auto"
+}