@lumx/react 4.3.2-alpha.0 → 4.3.2-alpha.2

package/index.d.ts

@@ -1,10 +1,10 @@
-import { Kind as Kind$1, HorizontalAlignment as HorizontalAlignment$1, Size as Size$1, ColorPalette as ColorPalette$1, Theme as Theme$1, GenericProps as GenericProps$1, Orientation as Orientation$1, Alignment as Alignment$1, AspectRatio, ColorWithVariants as ColorWithVariants$1, ColorVariant as ColorVariant$1, Typography as Typography$1, Emphasis as Emphasis$1, GlobalSize, TypographyInterface as TypographyInterface$1 } from '@lumx/core/js/constants';
+import { Kind as Kind$1, HorizontalAlignment as HorizontalAlignment$1, Size as Size$1, ColorPalette as ColorPalette$1, Theme as Theme$1, Orientation as Orientation$1, Alignment as Alignment$1, AspectRatio as AspectRatio$1, ColorWithVariants as ColorWithVariants$1, ColorVariant as ColorVariant$1, Typography as Typography$1, Emphasis as Emphasis$1 } from '@lumx/core/js/constants';
 export * from '@lumx/core/js/constants';
 import * as _lumx_core_js_types from '@lumx/core/js/types';
-import { GenericProps, HasTheme as HasTheme$1, ValueOf, HasAriaDisabled as HasAriaDisabled$1, PartialBy, HasCloseMode, Falsy, HasClassName as HasClassName$1, HeadingElement as HeadingElement$1, HasRequiredLinkHref, HasAriaLabelOrLabelledBy } from '@lumx/core/js/types';
+import { GenericProps, HasTheme as HasTheme$1, ValueOf as ValueOf$1, HasAriaDisabled as HasAriaDisabled$1, HasCloseMode, Falsy, HasClassName as HasClassName$1, HeadingElement as HeadingElement$1, HasRequiredLinkHref, HasAriaLabelOrLabelledBy } from '@lumx/core/js/types';
 export * from '@lumx/core/js/types';
 import * as React$1 from 'react';
-import React__default, { Ref, ReactElement, ReactNode, SyntheticEvent, MouseEventHandler, KeyboardEventHandler, AriaAttributes, ReactText, RefObject, CSSProperties, ImgHTMLAttributes, SetStateAction, Key, ElementType, InputHTMLAttributes, ComponentProps } from 'react';
+import React__default, { Ref, ReactElement, ReactNode, SyntheticEvent, MouseEventHandler, KeyboardEventHandler, AriaAttributes, RefObject, CSSProperties, ImgHTMLAttributes, SetStateAction, Key, ElementType, ComponentProps } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Selector } from '@lumx/core/js/types/Selector';
 
@@ -335,14 +335,14 @@ declare const Alignment: {
     readonly start: "start";
     readonly top: "top";
 };
-type Alignment = ValueOf<typeof Alignment>;
+type Alignment = ValueOf$1<typeof Alignment>;
 type VerticalAlignment = Extract<Alignment, 'top' | 'center' | 'bottom'>;
 type HorizontalAlignment = Extract<Alignment, 'right' | 'center' | 'left'>;
 declare const Theme: {
     readonly light: "light";
     readonly dark: "dark";
 };
-type Theme = ValueOf<typeof Theme>;
+type Theme = ValueOf$1<typeof Theme>;
 declare const Size: {
     readonly xxs: "xxs";
     readonly xs: "xs";
@@ -357,18 +357,19 @@ declare const Size: {
     readonly big: "big";
     readonly huge: "huge";
 };
-type Size = ValueOf<typeof Size>;
+type Size = ValueOf$1<typeof Size>;
+type GlobalSize = Extract<Size, 'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl'>;
 declare const Orientation: {
     readonly horizontal: "horizontal";
     readonly vertical: "vertical";
 };
-type Orientation = ValueOf<typeof Orientation>;
+type Orientation = ValueOf$1<typeof Orientation>;
 declare const Emphasis: {
     readonly low: "low";
     readonly medium: "medium";
     readonly high: "high";
 };
-type Emphasis = ValueOf<typeof Emphasis>;
+type Emphasis = ValueOf$1<typeof Emphasis>;
 /**
  * List of typographies that can't be customized.
  */
@@ -383,7 +384,7 @@ declare const TypographyInterface: {
     readonly headline: "headline";
     readonly display1: "display1";
 };
-type TypographyInterface = ValueOf<typeof TypographyInterface>;
+type TypographyInterface = ValueOf$1<typeof TypographyInterface>;
 /**
  * List of typographies that can be customized (via CSS variables).
  */
@@ -401,7 +402,7 @@ declare const TypographyCustom: {
     readonly title5: "custom-title5";
     readonly title6: "custom-title6";
 };
-type TypographyCustom = ValueOf<typeof TypographyCustom>;
+type TypographyCustom = ValueOf$1<typeof TypographyCustom>;
 /**
  * List of all typographies.
  */
@@ -431,6 +432,26 @@ declare const Typography: {
     readonly display1: "display1";
 };
 type Typography = TypographyInterface | TypographyCustom;
+/**
+ * All available aspect ratios.
+ */
+declare const AspectRatio: {
+    /** Intrinsic content ratio. */
+    readonly original: "original";
+    /** Ratio 3:1 */
+    readonly panoramic: "panoramic";
+    /** Ratio 16:9 */
+    readonly wide: "wide";
+    /** Ratio 3:2 */
+    readonly horizontal: "horizontal";
+    /** Ratio 3:2 */
+    readonly vertical: "vertical";
+    /** Ratio 1:1 */
+    readonly square: "square";
+    /** Ratio constrained by the parent. */
+    readonly free: "free";
+};
+type AspectRatio = ValueOf$1<typeof AspectRatio>;
 /**
  * Semantic info about the purpose of the component
  */
@@ -440,7 +461,7 @@ declare const Kind: {
     readonly warning: "warning";
     readonly error: "error";
 };
-type Kind = ValueOf<typeof Kind>;
+type Kind = ValueOf$1<typeof Kind>;
 /**
  * All available white-space values
  * */
@@ -452,7 +473,7 @@ declare const WhiteSpace: {
     'pre-line': string;
     'break-spaces': string;
 };
-type WhiteSpace = ValueOf<typeof WhiteSpace>;
+type WhiteSpace = ValueOf$1<typeof WhiteSpace>;
 /**
  * See SCSS variable $lumx-color-palette
  */
@@ -467,7 +488,7 @@ declare const ColorPalette: {
     readonly light: "light";
     readonly grey: "grey";
 };
-type ColorPalette = ValueOf<typeof ColorPalette>;
+type ColorPalette = ValueOf$1<typeof ColorPalette>;
 /**
  * See SCSS variable $lumx-color-variants
  */
@@ -482,7 +503,7 @@ declare const ColorVariant: {
     readonly L6: "L6";
     readonly N: "N";
 };
-type ColorVariant = ValueOf<typeof ColorVariant>;
+type ColorVariant = ValueOf$1<typeof ColorVariant>;
 /** ColorPalette with all possible color variant combination */
 type ColorWithVariants = ColorPalette | Exclude<`${ColorPalette}-${ColorVariant}`, `light-D${number}` | `dark-D${number}`>;
 
@@ -514,6 +535,9 @@ type HeadingElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
 /** Union type of all text elements */
 type TextElement = 'span' | 'p' | HeadingElement;
 
+/** Get types of the values of a record. */
+type ValueOf<T extends Record<any, any>> = T[keyof T];
+
 /** Transform a string literal into kebab case */
 type KebabCase<S> = S extends `${infer C}${infer T}` ? T extends Uncapitalize<T> ? `${Uncapitalize<C>}${KebabCase<T>}` : `${Uncapitalize<C>}-${KebabCase<T>}` : S;
 
@@ -529,14 +553,25 @@ interface HasAriaDisabled {
     'aria-disabled'?: Booleanish;
 }
 
-type BaseClickableProps = {
-    children?: JSXElement;
+interface HasChecked<C = boolean> {
+    /** Component checked state. */
+    isChecked?: C;
+    /** @alias isChecked */
+    checked?: boolean;
+}
+
+interface HasDisabled {
+    /** Whether the component is disabled or not. */
     isDisabled?: boolean;
+    /** @alias isDisabled */
     disabled?: boolean;
-    'aria-disabled'?: Booleanish;
+}
+
+interface BaseClickableProps extends HasDisabled, HasAriaDisabled {
+    children?: JSXElement;
     onClick?: (event?: any) => void;
     ref?: CommonRef;
-};
+}
 
 /**
  * Button size definition.
@@ -641,7 +676,7 @@ interface IconButtonProps$1 extends BaseButtonProps {
     title?: string;
 }
 
-interface IconButtonProps extends GenericProps, Omit<IconButtonProps$1, 'title'> {
+interface IconButtonProps extends GenericProps, Omit<IconButtonProps$1, 'title' | 'children'> {
     /**
      * Props to pass to the tooltip.
      * If undefined or if tooltipProps.label is undefined, the label prop will be used as tooltip label.
@@ -685,16 +720,11 @@ declare const ButtonGroup: Comp<ButtonGroupProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface CheckboxProps$1 extends HasTheme, HasClassName, HasAriaDisabled {
+interface CheckboxProps$1 extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled, HasChecked<boolean | 'intermediate'> {
     /** Helper text. */
     helper?: string;
     /** Native input id property. */
     id?: string;
-    /** Whether it is checked or not or intermediate. */
-    isChecked?: boolean | 'intermediate';
-    checked?: boolean;
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
     /** Label text. */
     label?: JSXElement;
     /** Native input name property. */
@@ -849,423 +879,6 @@ interface SelectionChipGroupProps<O> extends GenericProps {
  */
 declare const SelectionChipGroup: <O>({ onChange, value, getOptionId, getOptionName, inputRef, inputLabel, renderChip, theme, isDisabled, chipTooltipLabel, label, ...forwardedProps }: SelectionChipGroupProps<O>) => react_jsx_runtime.JSX.Element;
 
-/**
- * The source of the combobox option selection
- * It could either be on click / touch or keyboard selection
- */
-type ComboboxOptionSelectEventSource = 'keyboard' | 'click';
-type ComboboxSelectionType = 'single' | 'multiple';
-type BaseLoadingStatus = 'loading' | 'loadingMore' | 'idle' | 'error' | 'debouncing' | 'filtering' | 'empty';
-/**
- * Options related types
- */
-/** All possible values a combobox option can have  */
-type BaseComboboxOptionProps<O = any> = {
-    /**
-     * A unique id to track the option
-     */
-    id: string;
-    /**
-     * Whether the current input value should filter this option.
-     */
-    filterFromInput?: boolean;
-    /**
-     * Callback to call when the option is selected.
-     * This should only be used to add custom actions on options.
-     * For most cases, the "onSelect" on the Combobox root component should be enough.
-     */
-    onSelect?: (option: O, eventSource?: ComboboxOptionSelectEventSource) => void;
-    /**
-     * Additional data to link to the option. This can be useful to retrieve with `onSelect`.
-     */
-    data?: O;
-    /**
-     * Whether the option is disabled
-     */
-    isDisabled?: boolean;
-    /**
-     * The components to use to visually customize options.
-     * ! Options must not have interactive elements.
-     * ! If you need additional actions, you might need to create custom options and search how to
-     * ! make them accessible.
-     */
-    children?: ReactNode;
-    /**
-     * The text value the option has.
-     * This is the value used to filter the options by when manual filtering is disabled
-     * and that will be used as input value when an option is selected
-     */
-    textValue?: string;
-    /**
-     * Element to display before the content of the option.
-     * ! Options must not have interactive elements.
-     * ! If you need additional actions, you might need to create custom options and search how to
-     * ! make them accessible.
-     */
-    before?: ReactNode;
-    /**
-     * Element to display after the content of the option.
-     * ! Options must not have interactive elements.
-     * ! If you need additional actions, you might need to create custom options and search how to
-     * ! make them accessible.
-     */
-    after?: ReactNode;
-    /**
-     * Size of the list item.
-     * Default to tiny
-     */
-    size?: ListItemSize;
-    /**
-     * Fill to activate a tooltip on mouse over
-     */
-    tooltipProps?: Partial<TooltipProps>;
-};
-/**
- * Props for when an option has no children.
- * In these case, we need at least the text value to know what to display
- * */
-type TextValueOnly<O = any> = BaseComboboxOptionProps<O> & {
-    children?: never;
-    textValue: string;
-};
-/**
- * Props for when an option has a react element as string
- * In that case, we can use the children as the textValue without having
- * to set a manual props.
- * The props is still available to have a text value different than the displayed value.
- */
-type StringOption<O = any> = BaseComboboxOptionProps<O> & {
-    children: ReactText;
-    textValue?: string;
-};
-/**
- * Props for when an option has a react element as children
- * In that case, we cannot know what the actual value of the
- * option is, so the `textValue` prop has to be set.
- */
-type NodeOption<O = any> = BaseComboboxOptionProps<O> & {
-    children: Exclude<ReactNode, ReactText>;
-    textValue: string;
-};
-/** Props for the ComboboxOption component */
-type ComboboxOptionProps<O = any> = TextValueOnly<O> | StringOption<O> | NodeOption<O>;
-/** Shared data between all combobox option types. */
-interface BaseRegisteredComboboxOption {
-    id: string;
-    /** The id that was generated for this option */
-    generatedId: string;
-    /** Whether the "option" is an action */
-    isAction?: boolean;
-    /** Whether the "option" is disabled */
-    isDisabled?: boolean;
-}
-/** Combobox value */
-interface RegisteredComboboxOptionValue<O = any> extends BaseRegisteredComboboxOption, Pick<ComboboxOptionProps<O>, 'data' | 'filterFromInput' | 'textValue' | 'onSelect'> {
-    /** The section the option is a child of. */
-    sectionId?: string;
-    /** Whether the "option" is an action */
-    isAction?: never;
-}
-type OnComboboxSelect<O = any> = (option: RegisteredComboboxOptionValue<O>) => void;
-type OnComboboxInputChange = TextFieldProps['onChange'];
-type ComboboxTranslations = {
-    clearLabel: string;
-    showSuggestionsLabel: string;
-    loadingLabel: string;
-    noResultsForInputLabel: (input?: string) => string;
-    serviceUnavailableLabel: string;
-    tryReloadLabel: string;
-    nbOptionsLabel: (options: number) => string;
-};
-/** Props for the main combobox component. */
-type ComboboxProps<O = any> = {
-    /**
-     * HTML id
-     */
-    id?: string;
-    /**
-     * The current option id to set as selected.
-     * If omitted, the local state will be used instead;
-     */
-    selectedIds?: Array<string | number>;
-    /**
-     * The current value for the combobox input.
-     * If omitted, the input is controlled locally */
-    inputValue?: string;
-    /**
-     * The default value to set on the input.
-     * Use this if you want to initialize the input with a value and not control it
-     */
-    defaultInputValue?: string;
-    /**
-     * Whether the options should be automatically filtered or not.
-     * By default, the combobox will try to filter the options from the current input value
-     * using a "contains" strategy.
-     * If this is `false`, the option will not be automatically filtered and must be manually filtered by the parent.
-     * Useful for asynchronous comboboxes.
-     */
-    autoFilter: boolean;
-    /**
-     * Whether the combobox should open on focus
-     */
-    openOnFocus?: boolean;
-    /**
-     * Whether the combobox should open on click
-     */
-    openOnClick?: boolean;
-    /**
-     * Status of the combobox
-     */
-    status?: BaseLoadingStatus;
-    /**
-     * Callback when the input changes.
-     */
-    onInputChange?: OnComboboxInputChange;
-    /**
-     * Callback for when an option is selected
-     */
-    onSelect?: OnComboboxSelect<O>;
-    /**
-     * Callback called when the combobox opens
-     */
-    onOpen?: (options: {
-        currentValue?: string;
-        manual: boolean;
-    }) => void;
-    /**
-     * The combobox components to render.
-     * Must be one of the exposed components (Combobox.Input, Combobox.ListBox etc...)
-     */
-    children: ReactNode;
-    /**
-     * The combobox can have a specific selection type:
-     * - Single: only one item is selected
-     * - Multiple: several items can be selected (this impacts the combobox list, which will now not close when selectiong an option)
-     */
-    selectionType?: ComboboxSelectionType;
-    /**
-     * Whether the error state should be displayed when the status is in error.
-     * @default `true` if `status` is defined
-     */
-    showErrorState?: boolean;
-    /**
-     * Whether the empty state should be displayed when there is no results.
-     * @default `true` if `autoFilter=false`
-     */
-    showEmptyState?: boolean;
-    /** custom className */
-    className?: string;
-    /** translations to be used across the combobox */
-    translations: ComboboxTranslations;
-};
-
-interface ComboboxButtonProps extends GenericProps {
-    /**
-     * Label of the combobox button trigger.
-     */
-    label: string;
-    /**
-     * Controls how the `label` is displayed:
-     *  - `show-selection` (default): Displays the current selection as the label, or falls back to the provided `label`
-     *     if there is no selection. The `label` will still appear as a tooltip in this mode.
-     *  - `show-label`: Always displays the provided `label` as the visual label.
-     *  - `show-tooltip`: Always displays the provided `label` as the visual a tooltip.
-     *     (useful for IconButton combobox)
-     * In all cases, the given `label` is the ARIA label in use
-     */
-    labelDisplayMode?: 'show-selection' | 'show-label' | 'show-tooltip';
-    /**
-     * Focus event handler
-     */
-    onFocus?: React__default.FocusEventHandler;
-    /**
-     * Blur event handler
-     */
-    onBlur?: React__default.FocusEventHandler;
-    /** Customize the root element. */
-    as?: React__default.ElementType;
-}
-
-interface ComboboxOptionSkeletonProps {
-    className?: string;
-    index?: number;
-    children?: ReactNode | ((options: {
-        index?: number;
-    }) => ReactNode);
-    before?: ComboboxOptionProps['before'];
-    after?: ComboboxOptionProps['after'];
-    size?: ComboboxOptionProps['size'];
-}
-
-interface ComboboxListSkeletonProps {
-    isLoadingMore?: boolean;
-    children?: ComboboxOptionSkeletonProps['children'];
-}
-
-interface ComboboxListBoxProps extends GenericProps$1, React__default.ComponentProps<'ul'> {
-    /** Options display in the combobox */
-    children?: ReactNode;
-    /**
-     * Component to use as skeleton for each option instead of the default one.
-     * Can either be a react node or a component that receives the index as prop
-     */
-    renderItemSkeleton?: ComboboxListSkeletonProps['children'];
-    /** Label for the list */
-    label?: string;
-    /** Props of the popover element. */
-    popoverProps?: Partial<PopoverProps>;
-    /**
-     * An element to display at the bottom of the listbox.
-     * No interactive element must be set here as they will not be accessible.
-     */
-    footer?: ReactNode;
-    /** List ref */
-    listRef?: React__default.Ref<HTMLElement>;
-}
-
-/**
- * All TextField props that are extended.
- * We can't use "Omit" here as it is not compatible with the "GenericProps" type from the DS,
- * meaning we would loose all props.
- *
- */
-type ExtendedTextFieldProps = PartialBy<Pick<TextFieldProps, 'ariaLabel' | 'chips' | 'error' | 'forceFocusStyle' | 'hasError' | 'afterElement' | 'helper' | 'icon' | 'inputRef' | 'textFieldRef' | 'isDisabled' | 'className' | 'isRequired' | 'isValid' | 'label' | 'maxLength' | 'minimumRows' | 'multiline' | 'id' | 'name' | 'placeholder' | 'onBlur' | 'onClear' | 'onKeyDown' | 'onFocus' | 'theme'>, 'ariaLabel' | 'onKeyDown'>;
-type ComboboxInputProps = ExtendedTextFieldProps & {
-    /** Whether the toggle button should be hidden */
-    hideToggle?: boolean;
-    /** Activate the clear button */
-    hasClearButton?: boolean;
-    /** Clear button forwarded props */
-    clearButtonProps?: Omit<TextFieldProps['clearButtonProps'], 'label'>;
-    /** Make input read only */
-    readOnly?: boolean;
-};
-
-interface ComboboxSectionProps {
-    /** Forwarded class name */
-    className?: string;
-    /** The title of the section */
-    title?: string;
-    /** Whether the section should be displayed as loading */
-    isLoading?: boolean;
-    /** Custom skeletons to use for loading state */
-    renderItemSkeleton?: ComboboxListSkeletonProps['children'];
-    /** Options to display */
-    children: ReactNode;
-}
-
-/**
- * Props for ComboboxOption with additional generic properties.
- */
-interface ComboboxOptionComponentProps<O extends object = any> extends GenericProps, Omit<ComboboxOptionProps<O>, 'as'> {
-    /** Customize the root element. */
-    as?: React__default.ElementType;
-}
-
-declare const SUB_COMPONENTS: {
-    /**
-     * Option to set within a combobox list.
-     *
-     * @family Combobox
-     * @param ComboboxOptionProps
-     * @returns ComboboxOption
-     */
-    readonly Option: Comp<ComboboxOptionComponentProps<any>, HTMLElement>;
-    /**
-     * Skeleton for a combobox option.
-     * A typography skeleton is rendered by default but can be overridden by passing children.
-     */
-    readonly OptionSkeleton: ({ className, index, before, after, size, children, }: ComboboxOptionSkeletonProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Section for options of a Combobox.
-     *
-     * @family Combobox
-     * @param ComboboxSectionProps
-     * @returns ComboboxSection
-     */
-    readonly Section: ({ children, ...props }: ComboboxSectionProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Combobox input trigger.
-     *
-     * @family Combobox
-     */
-    readonly Input: ({ hideToggle, inputRef, textFieldRef, afterElement, onFocus, onBlur, onKeyDown, clearButtonProps, hasClearButton, theme, ...textFieldProps }: ComboboxInputProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * The listbox containing the combobox's options.
-     *
-     * @family Combobox
-     * @param ComboboxListBoxProps
-     * @returns ComboboxListBox
-     */
-    readonly List: ({ children, renderItemSkeleton, label, popoverProps, footer, listRef, ...forwardedProps }: ComboboxListBoxProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Combobox button trigger.
-     *
-     * @family Combobox
-     */
-    readonly Button: Comp<ComboboxButtonProps, HTMLElement>;
-};
-/**
- *
- * A Combobox is a combination of two components:
- * * An input to enter the user's value
- * * A popover with a list of suggestions to fill the value.
- *
- * These two components are included via the Combobox.Input and Combobox.ListBox components.
- *
- * In its simplest implementation the component will automatically filter the given options
- * from the value of the input and fill the input with the textValue of the selected option.
- *
- * Props are available for more complex implementations.
- *
- * @family Combobox
- * @param ComboboxProps
- * @returns Combobox
- */
-declare const Combobox: (<O>({ id: htmlId, inputValue, defaultInputValue, autoFilter, openOnClick, openOnFocus, status, showEmptyState, showErrorState, selectedIds, onInputChange, onSelect, onOpen, children, selectionType, translations, }: ComboboxProps<O>) => react_jsx_runtime.JSX.Element) & {
-    /**
-     * Option to set within a combobox list.
-     *
-     * @family Combobox
-     * @param ComboboxOptionProps
-     * @returns ComboboxOption
-     */
-    readonly Option: Comp<ComboboxOptionComponentProps<any>, HTMLElement>;
-    /**
-     * Skeleton for a combobox option.
-     * A typography skeleton is rendered by default but can be overridden by passing children.
-     */
-    readonly OptionSkeleton: ({ className, index, before, after, size, children, }: ComboboxOptionSkeletonProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Section for options of a Combobox.
-     *
-     * @family Combobox
-     * @param ComboboxSectionProps
-     * @returns ComboboxSection
-     */
-    readonly Section: ({ children, ...props }: ComboboxSectionProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Combobox input trigger.
-     *
-     * @family Combobox
-     */
-    readonly Input: ({ hideToggle, inputRef, textFieldRef, afterElement, onFocus, onBlur, onKeyDown, clearButtonProps, hasClearButton, theme, ...textFieldProps }: ComboboxInputProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * The listbox containing the combobox's options.
-     *
-     * @family Combobox
-     * @param ComboboxListBoxProps
-     * @returns ComboboxListBox
-     */
-    readonly List: ({ children, renderItemSkeleton, label, popoverProps, footer, listRef, ...forwardedProps }: ComboboxListBoxProps) => react_jsx_runtime.JSX.Element;
-    /**
-     * Combobox button trigger.
-     *
-     * @family Combobox
-     */
-    readonly Button: Comp<ComboboxButtonProps, HTMLElement>;
-};
-
 /**
  * Comment block variants.
  */
@@ -1273,7 +886,7 @@ declare const CommentBlockVariant: {
     readonly indented: "indented";
     readonly linear: "linear";
 };
-type CommentBlockVariant = ValueOf<typeof CommentBlockVariant>;
+type CommentBlockVariant = ValueOf$1<typeof CommentBlockVariant>;
 /**
  * Defines the props of the component.
  */
@@ -1468,7 +1081,15 @@ declare const Dialog: Comp<DialogProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface DividerProps extends GenericProps, HasTheme$1 {
+interface DividerProps$1 extends HasTheme, HasClassName {
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface DividerProps extends GenericProps, DividerProps$1 {
 }
 /**
  * Divider component.
@@ -1513,7 +1134,7 @@ declare const Placement: {
     readonly LEFT_END: "left-end";
     readonly LEFT_START: "left-start";
 };
-type Placement = ValueOf<typeof Placement>;
+type Placement = ValueOf$1<typeof Placement>;
 /**
  * Offset of the popover.
  */
@@ -1535,7 +1156,7 @@ declare const FitAnchorWidth: {
     readonly MIN_WIDTH: "minWidth";
     readonly WIDTH: "width";
 };
-type FitAnchorWidth = ValueOf<typeof FitAnchorWidth>;
+type FitAnchorWidth = ValueOf$1<typeof FitAnchorWidth>;
 
 /**
  * Defines the props of the component.
@@ -1849,7 +1470,7 @@ declare const GenericBlockGapSize: Pick<{
     readonly big: "big";
     readonly huge: "huge";
 }, "medium" | "tiny" | "regular" | "big" | "huge">;
-type GenericBlockGapSize = ValueOf<typeof GenericBlockGapSize>;
+type GenericBlockGapSize = ValueOf$1<typeof GenericBlockGapSize>;
 
 interface GenericBlockProps extends FlexBoxProps {
     /**
@@ -2105,7 +1726,7 @@ declare module 'react' {
  * All available aspect ratios.
  * @deprecated
  */
-declare const ThumbnailAspectRatio: Record<string, AspectRatio>;
+declare const ThumbnailAspectRatio: Record<string, AspectRatio$1>;
 /**
  *  Thumbnail sizes.
  */
@@ -2117,7 +1738,7 @@ declare const ThumbnailVariant: {
     readonly squared: "squared";
     readonly rounded: "rounded";
 };
-type ThumbnailVariant = ValueOf<typeof ThumbnailVariant>;
+type ThumbnailVariant = ValueOf$1<typeof ThumbnailVariant>;
 /**
  * Thumbnail object fit.
  */
@@ -2125,7 +1746,7 @@ declare const ThumbnailObjectFit: {
     readonly cover: "cover";
     readonly contain: "contain";
 };
-type ThumbnailObjectFit = ValueOf<typeof ThumbnailObjectFit>;
+type ThumbnailObjectFit = ValueOf$1<typeof ThumbnailObjectFit>;
 
 type ImgHTMLProps = ImgHTMLAttributes<HTMLImageElement>;
 /**
@@ -2137,7 +1758,7 @@ interface ThumbnailProps extends GenericProps, HasTheme$1 {
     /** Image alternative text. */
     alt: string;
     /** Image aspect ratio. */
-    aspectRatio?: AspectRatio;
+    aspectRatio?: AspectRatio$1;
     /** Badge. */
     badge?: ReactElement | Falsy;
     /** Image cross origin resource policy. */
@@ -2209,7 +1830,7 @@ declare const ImageBlockCaptionPosition: {
     readonly below: "below";
     readonly over: "over";
 };
-type ImageBlockCaptionPosition = ValueOf<typeof ImageBlockCaptionPosition>;
+type ImageBlockCaptionPosition = ValueOf$1<typeof ImageBlockCaptionPosition>;
 /**
  *  Image block sizes.
  */
@@ -2419,37 +2040,55 @@ interface LightboxProps extends GenericProps, HasTheme$1, Pick<AriaAttributes, '
  */
 declare const Lightbox: Comp<LightboxProps, HTMLDivElement>;
 
-type HTMLAnchorProps = React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>;
 /**
  * Defines the props of the component.
  */
-interface LinkProps extends GenericProps, HasAriaDisabled$1 {
+interface LinkProps$1 extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled {
+    /** Link label content. */
+    label?: JSXElement;
     /** Color variant. */
     color?: ColorWithVariants$1;
     /** Lightened or darkened variant of the selected icon color. */
     colorVariant?: ColorVariant$1;
     /** Link href. */
-    href?: HTMLAnchorProps['href'];
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
+    href?: string;
     /**
      * Left icon (SVG path).
-     * @deprecated Instead, simply nest `<Icon />` in the children
+     * @deprecated Instead, simply nest `<Icon />` in the label
      */
     leftIcon?: string;
-    /** Custom react component for the link (can be used to inject react router Link). */
-    linkAs?: 'a' | any;
+    /** Element type or custom component for the link. */
+    as?: string | any;
     /**
      * Right icon (SVG path).
-     * @deprecated Instead, simply nest `<Icon />` in the children
+     * @deprecated Instead, simply nest `<Icon />` in the label
      */
     rightIcon?: string;
     /** Link target. */
+    target?: string;
+    /** Typography variant. */
+    typography?: string;
+    /** Click handler. */
+    onClick?: (event: any) => void;
+    /** Reference to the root element. */
+    ref?: CommonRef;
+}
+
+type HTMLAnchorProps = React__default.DetailedHTMLProps<React__default.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>;
+/**
+ * Defines the props of the component.
+ */
+interface LinkProps extends GenericProps, Omit<LinkProps$1, 'label'> {
+    /** Link href. */
+    href?: HTMLAnchorProps['href'];
+    /** Custom react component for the link (can be used to inject react router Link). */
+    linkAs?: 'a' | any;
+    /** Link target. */
     target?: HTMLAnchorProps['target'];
     /** Typography variant. */
     typography?: Typography$1;
     /** Children */
-    children?: React.ReactNode;
+    children?: React__default.ReactNode;
 }
 /**
  * Link component.
@@ -2787,7 +2426,7 @@ declare const ProgressVariant: {
     readonly linear: "linear";
     readonly circular: "circular";
 };
-type ProgressVariant = ValueOf<typeof ProgressVariant>;
+type ProgressVariant = ValueOf$1<typeof ProgressVariant>;
 /**
  * Defines the props of the component.
  */
@@ -2945,27 +2584,33 @@ declare const ProgressTrackerStepPanel: Comp<ProgressTrackerStepPanelProps, HTML
 /**
  * Defines the props of the component.
  */
-interface RadioButtonProps extends GenericProps, HasTheme$1, HasAriaDisabled$1 {
+interface RadioButtonProps$1 extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled, HasChecked {
     /** Helper text. */
     helper?: string;
     /** Native input id property. */
     id?: string;
-    /** Native input ref. */
-    inputRef?: React.Ref<HTMLInputElement>;
-    /** Whether it is checked or not. */
-    isChecked?: boolean;
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
     /** Label content. */
-    label?: ReactNode;
+    label?: JSXElement;
     /** Native input name property. */
     name?: string;
     /** Native input value property. */
     value?: string;
-    /** On change callback. */
-    onChange?(value?: string, name?: string, event?: SyntheticEvent): void;
     /** optional props for input */
-    inputProps?: InputHTMLAttributes<HTMLInputElement>;
+    inputProps?: Record<string, any>;
+    /** Native input ref. */
+    inputRef?: CommonRef;
+    /** Native input id. */
+    inputId: string;
+    /** On change callback. */
+    onChange?(value?: string, name?: string, event?: any): void;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface RadioButtonProps extends GenericProps, Omit<RadioButtonProps$1, 'inputId'> {
 }
 /**
  * RadioButton component.
@@ -2999,7 +2644,7 @@ declare const SelectVariant: {
     readonly input: "input";
     readonly chip: "chip";
 };
-type SelectVariant = ValueOf<typeof SelectVariant>;
+type SelectVariant = ValueOf$1<typeof SelectVariant>;
 interface CoreSelectProps extends GenericProps, HasTheme$1 {
     /** Props to pass to the clear button (minus those already set by the Select props). If not specified, the button won't be displayed. */
     clearButtonProps?: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
@@ -3132,20 +2777,14 @@ declare const SideNavigationItem: Comp<SideNavigationItemProps, HTMLLIElement>;
 /**
  * Defines the props of the component.
  */
-interface SkeletonCircleProps extends GenericProps, HasTheme$1 {
+interface SkeletonCircleProps$1 extends HasTheme, HasClassName {
     /** Size variant. */
     size: GlobalSize;
     /** The color of the skeleton. */
-    color?: ColorPalette$1;
+    color?: ColorPalette;
+    /** Reference to the root element. */
+    ref?: CommonRef;
 }
-/**
- * SkeletonCircle component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const SkeletonCircle: Comp<SkeletonCircleProps, HTMLDivElement>;
 
 /**
  * Skeleton variants.
@@ -3159,7 +2798,7 @@ type SkeletonRectangleVariant = ValueOf<typeof SkeletonRectangleVariant>;
 /**
  * Defines the props of the component.
  */
-interface SkeletonRectangleProps extends GenericProps, HasTheme$1 {
+interface SkeletonRectangleProps$1 extends HasTheme, HasClassName {
     /** Aspect ratio (use with width and not height). */
     aspectRatio?: Extract<AspectRatio, 'square' | 'horizontal' | 'vertical' | 'wide'>;
     /** Height size. */
@@ -3169,7 +2808,45 @@ interface SkeletonRectangleProps extends GenericProps, HasTheme$1 {
     /** Width size. */
     width?: GlobalSize;
     /** The color of the skeleton. */
-    color?: ColorPalette$1;
+    color?: ColorPalette;
+    /** Reference to the root element. */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface SkeletonTypographyProps$1 extends HasTheme, HasClassName {
+    /** Typography variant. */
+    typography: TypographyInterface;
+    /** Width CSS property. */
+    width?: CSSProperties['width'];
+    /** The color of the skeleton. */
+    color?: ColorPalette;
+    /** Reference to the root element. */
+    ref?: CommonRef;
+    /** Style object. */
+    style?: CSSProperties;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface SkeletonCircleProps extends GenericProps, SkeletonCircleProps$1 {
+}
+/**
+ * SkeletonCircle component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const SkeletonCircle: Comp<SkeletonCircleProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface SkeletonRectangleProps extends GenericProps, SkeletonRectangleProps$1 {
 }
 /**
  * SkeletonRectangle component.
@@ -3183,13 +2860,7 @@ declare const SkeletonRectangle: Comp<SkeletonRectangleProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface SkeletonTypographyProps extends GenericProps, HasTheme$1 {
-    /** Typography variant. */
-    typography: TypographyInterface$1;
-    /** Width CSS property. */
-    width?: CSSProperties['width'];
-    /** The color of the skeleton. */
-    color?: ColorPalette$1;
+interface SkeletonTypographyProps extends GenericProps, SkeletonTypographyProps$1 {
 }
 /**
  * SkeletonTypography component.
@@ -3257,7 +2928,7 @@ declare const SlideMode: {
     /** Move slides native scroll snap (available only on supported browsers) */
     readonly scrollSnap: "scroll-snap";
 };
-type SlideMode = ValueOf<typeof SlideMode>;
+type SlideMode = ValueOf$1<typeof SlideMode>;
 
 /**
  * Defines the props of the component.
@@ -3456,25 +3127,37 @@ declare const Slides: Comp<SlidesProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface SwitchProps extends GenericProps, HasTheme$1, HasAriaDisabled$1 {
+interface SwitchProps$1 extends HasTheme, HasClassName, HasAriaDisabled, HasDisabled, HasChecked {
     /** Helper text. */
     helper?: string;
-    /** Whether it is checked or not. */
-    isChecked?: boolean;
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
+    /** Native input id property. */
+    id?: string;
+    /** Label text. */
+    label?: JSXElement;
     /** Native input name property. */
     name?: string;
-    /** Position of the switch relative to the label. */
-    position?: Extract<Alignment$1, 'right' | 'left'>;
     /** Native input value property. */
     value?: string;
-    /** On change callback. */
-    onChange?(isChecked: boolean, value?: string, name?: string, event?: SyntheticEvent): void;
     /** optional props for input */
-    inputProps?: InputHTMLAttributes<HTMLInputElement>;
-    /** Children */
-    children?: React.ReactNode;
+    inputProps?: Record<string, any>;
+    /** Native input ref. */
+    inputRef?: CommonRef;
+    /** Native input id. */
+    inputId: string;
+    /** On change callback. */
+    onChange?(isChecked: boolean, value?: string, name?: string, event?: any): void;
+    /** Position of the switch relative to the label. */
+    position?: 'left' | 'right';
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface SwitchProps extends GenericProps, Omit<SwitchProps$1, 'inputId' | 'label'> {
+    /** Children (label content). */
+    children?: React__default.ReactNode;
 }
 /**
  * Switch component.
@@ -3528,7 +3211,7 @@ declare const ThOrder: {
     readonly asc: "asc";
     readonly desc: "desc";
 };
-type ThOrder = ValueOf<typeof ThOrder>;
+type ThOrder = ValueOf$1<typeof ThOrder>;
 /**
  * Table cell variants.
  */
@@ -3536,7 +3219,7 @@ declare const TableCellVariant: {
     readonly body: "body";
     readonly head: "head";
 };
-type TableCellVariant = ValueOf<typeof TableCellVariant>;
+type TableCellVariant = ValueOf$1<typeof TableCellVariant>;
 /**
  * Defines the props of the component.
  */
@@ -3872,7 +3555,7 @@ declare const UploaderVariant: {
     readonly rounded: "rounded";
     readonly circle: "circle";
 };
-type UploaderVariant = ValueOf<typeof UploaderVariant>;
+type UploaderVariant = ValueOf$1<typeof UploaderVariant>;
 /**
  * Uploader sizes.
  */
@@ -3888,7 +3571,7 @@ interface FileInputProps extends Omit<React__default.ComponentProps<'input'>, 'o
  */
 interface UploaderProps extends GenericProps, HasTheme$1, HasAriaDisabled$1 {
     /** Image aspect ratio. */
-    aspectRatio?: AspectRatio;
+    aspectRatio?: AspectRatio$1;
     /** Icon (SVG path). */
     icon?: string;
     /** Disabled state */
@@ -3970,5 +3653,5 @@ declare const ThemeProvider: React__default.FC<{
 /** Get the theme in the current context. */
 declare function useTheme(): ThemeContextValue;
 
-export { AlertDialog, Autocomplete, AutocompleteMultiple, Avatar, Badge, BadgeWrapper, Button, ButtonEmphasis, ButtonGroup, CLASSNAME, COMPONENT_NAME, Checkbox, Chip, ChipGroup, Combobox, CommentBlock, CommentBlockVariant, DEFAULT_PROPS, DatePicker, DatePickerControlled, DatePickerField, Dialog, Divider, DragHandle, Dropdown, ExpansionPanel, Flag, FlexBox, GenericBlock, GenericBlockGapSize, Grid, GridColumn, GridItem, Heading, HeadingLevelProvider, Icon, IconButton, ImageBlock, ImageBlockCaptionPosition, ImageLightbox, InlineList, InputHelper, InputLabel, Lightbox, Link, LinkPreview, List, ListDivider, ListItem, ListSubheader, Message, Mosaic, Navigation, Notification, Placement, Popover, PopoverDialog, PostBlock, Progress, ProgressCircular, ProgressLinear, ProgressTracker, ProgressTrackerProvider, ProgressTrackerStep, ProgressTrackerStepPanel, ProgressVariant, RadioButton, RadioGroup, RawInputText, RawInputTextarea, SUB_COMPONENTS, Select, SelectMultiple, SelectMultipleField, SelectVariant, SelectionChipGroup, SideNavigation, SideNavigationItem, SkeletonCircle, SkeletonRectangle, SkeletonRectangleVariant, SkeletonTypography, Slider, Slides, Slideshow, SlideshowControls, SlideshowItem, Switch, Tab, TabList, TabListLayout, TabPanel, TabProvider, Table, TableBody, TableCell, TableCellVariant, TableHeader, TableRow, Text, TextField, ThOrder, ThemeProvider, Thumbnail, ThumbnailAspectRatio, ThumbnailObjectFit, ThumbnailVariant, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, isClickable, useFocusPointStyle, useHeadingLevel, useTheme };
+export { AlertDialog, Autocomplete, AutocompleteMultiple, Avatar, Badge, BadgeWrapper, Button, ButtonEmphasis, ButtonGroup, CLASSNAME, COMPONENT_NAME, Checkbox, Chip, ChipGroup, CommentBlock, CommentBlockVariant, DEFAULT_PROPS, DatePicker, DatePickerControlled, DatePickerField, Dialog, Divider, DragHandle, Dropdown, ExpansionPanel, Flag, FlexBox, GenericBlock, GenericBlockGapSize, Grid, GridColumn, GridItem, Heading, HeadingLevelProvider, Icon, IconButton, ImageBlock, ImageBlockCaptionPosition, ImageLightbox, InlineList, InputHelper, InputLabel, Lightbox, Link, LinkPreview, List, ListDivider, ListItem, ListSubheader, Message, Mosaic, Navigation, Notification, Placement, Popover, PopoverDialog, PostBlock, Progress, ProgressCircular, ProgressLinear, ProgressTracker, ProgressTrackerProvider, ProgressTrackerStep, ProgressTrackerStepPanel, ProgressVariant, RadioButton, RadioGroup, RawInputText, RawInputTextarea, Select, SelectMultiple, SelectMultipleField, SelectVariant, SelectionChipGroup, SideNavigation, SideNavigationItem, SkeletonCircle, SkeletonRectangle, SkeletonRectangleVariant, SkeletonTypography, Slider, Slides, Slideshow, SlideshowControls, SlideshowItem, Switch, Tab, TabList, TabListLayout, TabPanel, TabProvider, Table, TableBody, TableCell, TableCellVariant, TableHeader, TableRow, Text, TextField, ThOrder, ThemeProvider, Thumbnail, ThumbnailAspectRatio, ThumbnailObjectFit, ThumbnailVariant, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, isClickable, useFocusPointStyle, useHeadingLevel, useTheme };
 export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CheckboxProps, ChipGroupProps, ChipProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogProps, DialogSizes, DividerProps, DragHandleProps, DropdownProps, Elevation, ExpansionPanelProps, FlagProps, FlexBoxProps, FlexHorizontalAlignment, FlexVerticalAlignment, FocusPoint, GapSize, GenericBlockProps, GridColumnGapSize, GridColumnProps, GridItemProps, GridProps, HeadingLevelProviderProps, HeadingProps, IconButtonProps, IconProps, IconSizes, ImageBlockProps, ImageBlockSize, ImageLightboxProps, InlineListProps, InputHelperProps, InputLabelProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSubheaderProps, MarginAutoAlignment, MessageProps, MosaicProps, NavigationProps, NotificationProps, Offset, PopoverDialogProps, PopoverProps, PostBlockProps, ProgressCircularProps, ProgressCircularSize, ProgressLinearProps, ProgressProps, ProgressTrackerProps, ProgressTrackerProviderProps, ProgressTrackerStepPanelProps, ProgressTrackerStepProps, RadioButtonProps, RadioGroupProps, RawInputTextProps, RawInputTextareaProps, SelectMultipleProps, SelectProps, SelectionChipGroupProps, SideNavigationItemProps, SideNavigationProps, SkeletonCircleProps, SkeletonRectangleProps, SkeletonTypographyProps, SliderProps, SlidesProps, SlideshowControlsProps, SlideshowItemProps, SlideshowProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabProviderProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TextFieldProps, TextProps, ThumbnailProps, ThumbnailSize, ToolbarProps, TooltipPlacement, TooltipProps, UploaderProps, UploaderSize, UserBlockProps, UserBlockSize };