@lumx/react 4.3.2-alpha.1 → 4.3.2-alpha.10

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, 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';
+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 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 as ValueOf$1, HasAriaDisabled as HasAriaDisabled$1, 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, PartialBy, HasCloseMode, HasClassName as HasClassName$1, JSXElement as JSXElement$1, CommonRef as CommonRef$1, Falsy, 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, RefObject, CSSProperties, ImgHTMLAttributes, SetStateAction, Key, ElementType, ComponentProps } from 'react';
+import React__default, { Ref, ReactElement, ReactNode, SyntheticEvent, MouseEventHandler, KeyboardEventHandler, AriaAttributes, ReactText, 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';
 
@@ -512,12 +512,6 @@ 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;
-
-/** Transform the component name into the lumx class name. */
-type LumxClassName<TComponentName extends string> = `lumx-${KebabCase<TComponentName>}`;
-
 type CommonRef = any;
 
 type Booleanish = boolean | 'true' | 'false';
@@ -655,10 +649,6 @@ interface ButtonProps$1 extends BaseButtonProps {
  * Component display name.
  */
 declare const COMPONENT_NAME = "Button";
-/**
- * Component default class name and class prefix.
- */
-declare const CLASSNAME: LumxClassName<typeof COMPONENT_NAME>;
 /**
  * Component default props.
  */
@@ -898,6 +888,503 @@ 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;
 
+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;
+}
+/**
+ * Combobox button trigger.
+ *
+ * @family Combobox
+ */
+declare const ComboboxButton: Comp<ComboboxButtonProps, HTMLElement>;
+
+/** Combobox option divider */
+declare function ComboboxDivider(): react_jsx_runtime.JSX.Element;
+
+/**
+ * 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;
+};
+/**
+ * Combobox input trigger.
+ *
+ * @family Combobox
+ */
+declare const ComboboxInput: ({ hideToggle, inputRef, textFieldRef, afterElement, onFocus, onBlur, onKeyDown, clearButtonProps, hasClearButton, theme, ...textFieldProps }: ComboboxInputProps) => 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 ComboboxOptionSkeletonProps {
+    className?: string;
+    index?: number;
+    children?: ReactNode | ((options: {
+        index?: number;
+    }) => ReactNode);
+    before?: ComboboxOptionProps['before'];
+    after?: ComboboxOptionProps['after'];
+    size?: ComboboxOptionProps['size'];
+}
+/**
+ * Skeleton for a combobox option.
+ * A typography skeleton is rendered by default but can be overridden by passing children.
+ */
+declare const ComboboxOptionSkeleton: ({ className, index, before, after, size, children, }: ComboboxOptionSkeletonProps) => react_jsx_runtime.JSX.Element;
+
+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>;
+}
+/**
+ * The listbox containing the combobox's options.
+ *
+ * @family Combobox
+ * @param ComboboxListBoxProps
+ * @returns ComboboxListBox
+ */
+declare const ComboboxListBox: ({ children, renderItemSkeleton, label, popoverProps, footer, listRef, ...forwardedProps }: ComboboxListBoxProps) => react_jsx_runtime.JSX.Element;
+
+declare const LUMX_CLASSNAME = "lumx-list-item";
+/**
+ * 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;
+}
+/**
+ * Option to set within a combobox list.
+ *
+ * @family Combobox
+ * @param ComboboxOptionProps
+ * @returns ComboboxOption
+ */
+declare const ComboboxOption: Comp<ComboboxOptionComponentProps<any>, HTMLElement>;
+
+interface ComboboxOptionActionProps extends GenericProps {
+    /** Should the action be set as disabled  */
+    isDisabled?: boolean;
+    /** Action to trigger when the action is selected */
+    onClick: () => void;
+    /** Customize the root element. */
+    as?: React__default.ElementType;
+}
+/**
+ * Action to set on a Combobox Option.
+ * Allows to add an interactive element that
+ * can be navigated to and triggered using the keyboard.
+ *
+ * Defaults as "button"
+ *
+ * @family Combobox
+ * @param ComboboxOptionActionProps
+ * @returns ComboboxOptionAction
+ */
+declare const ComboboxOptionAction: (props: ComboboxOptionActionProps) => react_jsx_runtime.JSX.Element;
+
+interface ComboboxOptionMoreInfoProps {
+    buttonProps?: Partial<IconButtonProps>;
+    popoverProps?: PopoverProps;
+    onToggle?: (isOpen: boolean) => void;
+    children?: React__default.ReactNode;
+}
+/**
+ * Display more info on the option as a popover opening on mouse hover or keyboard nav
+ * Please consider using a simpler option description instead for better UX and a11y.
+ *
+ * @family Combobox
+ */
+declare const ComboboxOptionMoreInfo: React__default.FC<ComboboxOptionMoreInfoProps>;
+
+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;
+}
+/**
+ * Section for options of a Combobox.
+ *
+ * @family Combobox
+ * @param ComboboxSectionProps
+ * @returns ComboboxSection
+ */
+declare const ComboboxSection: ({ children, ...props }: ComboboxSectionProps) => react_jsx_runtime.JSX.Element;
+
+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.
  */
@@ -1658,22 +2145,37 @@ interface GridItemProps extends GenericProps {
  */
 declare const GridItem: Comp<GridItemProps, HTMLDivElement>;
 
-type GridColumnGapSize = Extract<Size$1, 'tiny' | 'regular' | 'big' | 'huge'>;
+type GridColumnGapSize = Extract<Size, 'tiny' | 'regular' | 'big' | 'huge'>;
 /**
  * Defines the props of the component.
  */
-interface GridColumnProps extends GenericProps {
+interface GridColumnProps$1 extends HasClassName {
     /** Customize the root element. */
-    as?: React.ElementType;
+    as?: any;
     /** Children elements. */
-    children?: ReactNode;
+    children?: JSXElement;
     /** Space between columns and rows. */
     gap?: GridColumnGapSize;
     /** Ideal number of columns. */
     maxColumns?: number;
     /** Minimum width for each item, reduce the number of column if there is not enough space. */
     itemMinWidth?: number;
+    /** Custom styles. */
+    style?: any;
+    /** reference to the root element */
+    ref?: CommonRef;
 }
+
+/**
+ * Defines the props of the component.
+ */
+interface GridColumnProps extends GenericProps, GridColumnProps$1 {
+    /** Customize the root element. */
+    as?: React.ElementType;
+    /** Children elements. */
+    children?: React.ReactNode;
+}
+
 /**
  * The GridColumn is a layout component that can display children in a grid
  * with custom display properties. It also comes with a responsive design,
@@ -1724,54 +2226,42 @@ interface IconProps extends Omit<IconProps$1, 'children'>, GenericProps {
  */
 declare const Icon: Comp<IconProps, HTMLElement>;
 
-/**
- *  Focal point using vertical alignment, horizontal alignment or coordinates (from -1 to 1).
- */
-type FocusPoint = {
-    x?: number;
-    y?: number;
-};
 /**
  * Loading attribute is not yet supported in typescript, so we need
  * to add it in order to avoid a ts error.
  * https://github.com/typescript-cheatsheets/react-typescript-cheatsheet/blob/master/ADVANCED.md#adding-non-standard-attributes
  */
 declare module 'react' {
-    interface ImgHTMLAttributes<T> extends React__default.HTMLAttributes<T> {
+    interface ImgHTMLAttributes<T> extends React.HTMLAttributes<T> {
         loading?: 'eager' | 'lazy';
     }
 }
-/**
- * All available aspect ratios.
- * @deprecated
- */
-declare const ThumbnailAspectRatio: Record<string, AspectRatio$1>;
 /**
  *  Thumbnail sizes.
  */
-type ThumbnailSize = Extract<Size$1, 'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl'>;
+type ThumbnailSize$1 = Extract<Size, 'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl'>;
 /**
  * Thumbnail variants.
  */
-declare const ThumbnailVariant: {
+declare const ThumbnailVariant$1: {
     readonly squared: "squared";
     readonly rounded: "rounded";
 };
-type ThumbnailVariant = ValueOf$1<typeof ThumbnailVariant>;
+type ThumbnailVariant$1 = ValueOf<typeof ThumbnailVariant$1>;
 /**
  * Thumbnail object fit.
  */
-declare const ThumbnailObjectFit: {
+declare const ThumbnailObjectFit$1: {
     readonly cover: "cover";
     readonly contain: "contain";
 };
-type ThumbnailObjectFit = ValueOf$1<typeof ThumbnailObjectFit>;
+type ThumbnailObjectFit$1 = ValueOf<typeof ThumbnailObjectFit$1>;
 
 type ImgHTMLProps = ImgHTMLAttributes<HTMLImageElement>;
 /**
  * Defines the props of the component.
  */
-interface ThumbnailProps extends GenericProps, HasTheme$1 {
+interface ThumbnailProps$1 extends HasTheme$1, HasClassName$1 {
     /** Alignment of the thumbnail in it's parent (requires flex parent). */
     align?: HorizontalAlignment$1;
     /** Image alternative text. */
@@ -1779,41 +2269,98 @@ interface ThumbnailProps extends GenericProps, HasTheme$1 {
     /** Image aspect ratio. */
     aspectRatio?: AspectRatio$1;
     /** Badge. */
-    badge?: ReactElement | Falsy;
+    badge?: JSXElement$1;
     /** Image cross origin resource policy. */
     crossOrigin?: ImgHTMLProps['crossOrigin'];
     /** Fallback icon (SVG path) or react node when image fails to load. */
-    fallback?: string | ReactNode;
+    fallback?: string | JSXElement$1;
     /** Whether the thumbnail should fill it's parent size (requires flex parent) or not. */
     fillHeight?: boolean;
-    /** Apply relative vertical and horizontal shift (from -1 to 1) on the image position inside the thumbnail. */
-    focusPoint?: FocusPoint;
     /** Image URL. */
     image: string;
+    loadingState: string;
     /** Props to inject into the native <img> element. */
     imgProps?: ImgHTMLProps;
     /** Reference to the native <img> element. */
-    imgRef?: Ref<HTMLImageElement>;
+    imgRef?: CommonRef$1;
+    ref?: CommonRef$1;
     /** Set to true to force the display of the loading skeleton. */
     isLoading?: boolean;
     /** Set how the image should fit when its aspect ratio is constrained */
-    objectFit?: ThumbnailObjectFit;
+    objectFit?: ThumbnailObjectFit$1;
     /** Size variant of the component. */
-    size?: ThumbnailSize;
+    size?: ThumbnailSize$1;
     /** Image loading mode. */
-    loading?: ImgHTMLProps['loading'];
+    loading?: 'eager' | 'lazy';
     /** Ref of an existing placeholder image to display while loading. */
-    loadingPlaceholderImageRef?: React__default.RefObject<HTMLImageElement>;
+    loadingPlaceholderImageRef?: React.RefObject<HTMLImageElement>;
     /** On click callback. */
-    onClick?: MouseEventHandler<HTMLDivElement>;
+    onClick?: (event: any) => void;
     /** On key press callback. */
-    onKeyPress?: KeyboardEventHandler<HTMLDivElement>;
+    onKeyPress?: (event: any) => void;
     /** Variant of the component. */
-    variant?: ThumbnailVariant;
+    variant?: ThumbnailVariant$1;
     /** Props to pass to the link wrapping the thumbnail. */
-    linkProps?: React__default.DetailedHTMLProps<React__default.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>;
+    linkProps?: GenericProps;
+    focusPointStyle?: GenericProps;
+    disabledStateProps?: GenericProps;
+    isAnyDisabled?: boolean;
     /** Custom react component for the link (can be used to inject react router Link). */
     linkAs?: 'a' | any;
+    'aria-label'?: string;
+}
+
+/**
+ *  Focal point using vertical alignment, horizontal alignment or coordinates (from -1 to 1).
+ */
+type FocusPoint = {
+    x?: number;
+    y?: number;
+};
+/**
+ * Loading attribute is not yet supported in typescript, so we need
+ * to add it in order to avoid a ts error.
+ * https://github.com/typescript-cheatsheets/react-typescript-cheatsheet/blob/master/ADVANCED.md#adding-non-standard-attributes
+ */
+declare module 'react' {
+    interface ImgHTMLAttributes<T> extends React__default.HTMLAttributes<T> {
+        loading?: 'eager' | 'lazy';
+    }
+}
+/**
+ * All available aspect ratios.
+ * @deprecated
+ */
+declare const ThumbnailAspectRatio: Record<string, AspectRatio$1>;
+/**
+ *  Thumbnail sizes.
+ */
+type ThumbnailSize = Extract<Size$1, 'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl'>;
+/**
+ * Thumbnail variants.
+ */
+declare const ThumbnailVariant: {
+    readonly squared: "squared";
+    readonly rounded: "rounded";
+};
+type ThumbnailVariant = ValueOf$1<typeof ThumbnailVariant>;
+/**
+ * Thumbnail object fit.
+ */
+declare const ThumbnailObjectFit: {
+    readonly cover: "cover";
+    readonly contain: "contain";
+};
+type ThumbnailObjectFit = ValueOf$1<typeof ThumbnailObjectFit>;
+
+/**
+ * Defines the props of the component.
+ */
+interface ThumbnailProps extends GenericProps, Omit<ThumbnailProps$1, 'loadingState' | 'isAnyDisabled' | 'focusPointStyle' | 'disabledStateProps' | 'badge'> {
+    /** Apply relative vertical and horizontal shift (from -1 to 1) on the image position inside the thumbnail. */
+    focusPoint?: FocusPoint;
+    /** Badge. */
+    badge?: ReactElement | Falsy;
 }
 /**
  * Thumbnail component.
@@ -2059,37 +2606,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.
@@ -3172,11 +3737,21 @@ declare const Switch: Comp<SwitchProps, HTMLDivElement>;
 /**
  * Defines the props of the component.
  */
-interface TableProps extends GenericProps, HasTheme$1 {
+interface TableProps$1 extends HasTheme, HasClassName {
     /** Whether the table has checkbox or thumbnail on first cell or not. */
     hasBefore?: boolean;
     /** Whether the table has dividers or not. */
     hasDividers?: boolean;
+    /** Children */
+    children?: JSXElement;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TableProps extends GenericProps, Omit<TableProps$1, 'ref'> {
     /** Children */
     children?: React.ReactNode;
 }
@@ -3192,7 +3767,17 @@ declare const Table: Comp<TableProps, HTMLTableElement>;
 /**
  * Defines the props of the component.
  */
-interface TableBodyProps extends GenericProps {
+interface TableBodyProps$1 extends HasClassName {
+    /** Children */
+    children?: JSXElement;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TableBodyProps extends GenericProps, Omit<TableBodyProps$1, 'ref'> {
     /** Children */
     children?: React.ReactNode;
 }
@@ -3212,7 +3797,7 @@ declare const ThOrder: {
     readonly asc: "asc";
     readonly desc: "desc";
 };
-type ThOrder = ValueOf$1<typeof ThOrder>;
+type ThOrder = ValueOf<typeof ThOrder>;
 /**
  * Table cell variants.
  */
@@ -3220,11 +3805,11 @@ declare const TableCellVariant: {
     readonly body: "body";
     readonly head: "head";
 };
-type TableCellVariant = ValueOf$1<typeof TableCellVariant>;
+type TableCellVariant = ValueOf<typeof TableCellVariant>;
 /**
  * Defines the props of the component.
  */
-interface TableCellProps extends GenericProps {
+interface TableCellProps$1 extends HasClassName {
     /** Icon (SVG path).(thead only). */
     icon?: string;
     /** Whether the column is sortable or not (thead only). */
@@ -3235,6 +3820,16 @@ interface TableCellProps extends GenericProps {
     variant?: TableCellVariant;
     /** On header cell click callback. */
     onHeaderClick?(): void;
+    /** Children */
+    children?: JSXElement;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TableCellProps extends GenericProps, Omit<TableCellProps$1, 'ref'> {
     /** Children */
     children?: React.ReactNode;
 }
@@ -3250,7 +3845,17 @@ declare const TableCell: Comp<TableCellProps, HTMLTableCellElement>;
 /**
  * Defines the props of the component.
  */
-interface TableHeaderProps extends GenericProps {
+interface TableHeaderProps$1 extends HasClassName {
+    /** Children */
+    children?: JSXElement;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TableHeaderProps extends GenericProps, Omit<TableHeaderProps$1, 'ref'> {
     /** Children */
     children?: React.ReactNode;
 }
@@ -3266,13 +3871,25 @@ declare const TableHeader: Comp<TableHeaderProps, HTMLTableSectionElement>;
 /**
  * Defines the props of the component.
  */
-interface TableRowProps extends GenericProps {
+interface TableRowProps$1 extends HasClassName, HasAriaDisabled {
     /** Whether the component is clickable or not. */
     isClickable?: boolean;
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
     /** Whether the component is selected or not. */
     isSelected?: boolean;
+    /** Tab index */
+    tabIndex?: number;
+    /** Children */
+    children?: JSXElement;
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TableRowProps extends GenericProps, Omit<TableRowProps$1, 'ref' | 'tabIndex' | 'aria-disabled'> {
+    /** Whether the component is disabled or not. */
+    isDisabled?: boolean;
     /** Children */
     children?: React.ReactNode;
 }
@@ -3654,5 +4271,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, 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 };
+export { AlertDialog, Autocomplete, AutocompleteMultiple, Avatar, Badge, BadgeWrapper, Button, ButtonEmphasis, ButtonGroup, COMPONENT_NAME, Checkbox, Chip, ChipGroup, Combobox, ComboboxButton, ComboboxDivider, ComboboxInput, ComboboxListBox, ComboboxOption, ComboboxOptionAction, ComboboxOptionMoreInfo, ComboboxOptionSkeleton, ComboboxSection, 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, LUMX_CLASSNAME, 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, TableCellVariant as TableCellVariantType, TableHeader, TableRow, Text, TextField, ThOrder, ThOrder as ThOrderType, 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, ComboboxButtonProps, ComboboxInputProps, ComboboxListBoxProps, ComboboxOptionComponentProps, ComboboxOptionMoreInfoProps, ComboboxOptionSkeletonProps, ComboboxSectionProps, 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 };