@lumx/react 4.9.0-next.7 → 4.9.0-next.9

package/index.d.ts

@@ -1,10 +1,10 @@
 import { Kind as Kind$1, HorizontalAlignment as HorizontalAlignment$1, Theme as Theme$1, Size as Size$1, Orientation as Orientation$1, Alignment as Alignment$1, AspectRatio as AspectRatio$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 as GenericProps$1, HasTheme as HasTheme$1, ValueOf as ValueOf$1, PropsToOverride, HasCloseMode as HasCloseMode$1, HasClassName as HasClassName$1, JSXElement as JSXElement$1, CommonRef as CommonRef$1, Falsy, HeadingElement as HeadingElement$1, HasAriaDisabled as HasAriaDisabled$1, HasRequiredLinkHref as HasRequiredLinkHref$1, HasAriaLabelOrLabelledBy as HasAriaLabelOrLabelledBy$1 } from '@lumx/core/js/types';
+import { GenericProps as GenericProps$1, HasTheme as HasTheme$1, ValueOf as ValueOf$1, PropsToOverride, HasAriaDisabled as HasAriaDisabled$1, HasRequiredLinkHref as HasRequiredLinkHref$1, HasClassName as HasClassName$1, HasCloseMode as HasCloseMode$1, JSXElement as JSXElement$1, CommonRef as CommonRef$1, Falsy, HeadingElement as HeadingElement$1, HasAriaLabelOrLabelledBy as HasAriaLabelOrLabelledBy$1 } 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, RefObject, CSSProperties, ImgHTMLAttributes, AriaAttributes as AriaAttributes$1, SetStateAction, Key, ElementType as ElementType$1, HTMLInputTypeAttribute, ComponentProps } from 'react';
+import React__default, { Ref, ReactElement, ReactNode, SyntheticEvent, MouseEventHandler, KeyboardEventHandler, RefObject, SetStateAction, Key, CSSProperties, ElementType as ElementType$1, HTMLInputTypeAttribute, ComponentProps, ImgHTMLAttributes, AriaAttributes as AriaAttributes$1 } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** LumX Component Type. */
@@ -32,6 +32,13 @@ type ComponentRef<C> = C extends keyof JSX.IntrinsicElements ? JSX.IntrinsicElem
     ref?: infer R;
 }> ? R : never;
 
+type HasPolymorphicAs$1<E extends React.ElementType> = React.ComponentPropsWithoutRef<E> & {
+    /**
+     * Customize the rendered component.
+     */
+    as?: E;
+};
+
 interface AlertDialogProps extends Omit<DialogProps, 'header' | 'footer'> {
     /** Message variant. */
     kind?: Kind$1;
@@ -1067,248 +1074,349 @@ interface SelectionChipGroupProps<O> extends GenericProps$1 {
  */
 declare const SelectionChipGroup: <O>({ onChange, value, getOptionId, getOptionName, inputRef, inputLabel, renderChip, theme, isDisabled, chipTooltipLabel, label, ...forwardedProps }: SelectionChipGroupProps<O>) => react_jsx_runtime.JSX.Element;
 
+type Listener = (evt: KeyboardEvent) => void;
+interface UseKeyboardListNavigationType {
+    /** the current active index */
+    activeItemIndex: number;
+    /** callback to be used when a key is pressed. usually used with the native prop `onKeyDown` */
+    onKeyboardNavigation: Listener;
+    /** Resets the active index to the initial state */
+    resetActiveIndex(): void;
+    /** Sets the active index to a given value */
+    setActiveItemIndex(value: SetStateAction<number>): void;
+}
+type useKeyboardListNavigationType = <I>(items: I[], ref: RefObject<HTMLElement>, onListItemSelected: (itemSelected: I) => void, onListItemNavigated?: (itemSelected: I) => void, onEnterPressed?: (itemSelected: string) => void, onBackspacePressed?: Listener, keepFocusAfterSelection?: boolean, initialIndex?: number, preventTabOnEnteredValue?: boolean) => UseKeyboardListNavigationType;
+
+/** List item padding size. */
+type ListItemPadding = Extract<Size, 'big' | 'huge'>;
 /**
- * Comment block variants.
+ * Defines the props of the component.
  */
-declare const CommentBlockVariant: {
-    readonly indented: "indented";
-    readonly linear: "linear";
-};
-type CommentBlockVariant = ValueOf$1<typeof CommentBlockVariant>;
+interface ListProps$1 extends HasClassName {
+    /** List content (should be ListItem, ListDivider, etc.). */
+    children?: JSXElement;
+    /** Item padding size. */
+    itemPadding?: ListItemPadding;
+    /** ref to the root element */
+    ref?: CommonRef;
+}
+
 /**
  * Defines the props of the component.
  */
-interface CommentBlockProps extends GenericProps$1, HasTheme$1 {
-    /** Action toolbar content. */
-    actions?: ReactNode;
-    /** Props to pass to the avatar. */
-    avatarProps: AvatarProps;
-    /** Comment block replies. */
-    children?: ReactNode;
-    /** Comment date with the minimal timestamp information (xx minutes, x hours, yesterday, 6 days, Month Day, Month Day Year)*/
-    date?: string;
-    /** Comment date with the full timestamp information (day, month, year, time) */
-    fullDate?: string;
-    /** Whether the component has actions to display or not. */
-    hasActions?: boolean;
-    /** Action toolbar header content. */
-    headerActions?: ReactNode;
-    /** Whether the component is open or not. */
-    isOpen?: boolean;
-    /** Whether the comment is relevant or not. */
-    isRelevant?: boolean;
-    /** Comment author name. */
-    name?: React.ReactNode;
-    /**
-     * On click callback.
-     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
-     */
-    onClick?(): void;
-    /**
-     * On mouse enter callback.
-     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
-     */
-    onMouseEnter?(): void;
+interface ListProps extends GenericProps$1, ReactToJSX<ListProps$1> {
     /**
-     * On mouse leave callback.
-     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
+     * Whether the list items are clickable.
+     * @deprecated not needed anymore.
      */
-    onMouseLeave?(): void;
-    /** Comment content. */
-    text: ReactNode | string;
-    /** Comment variant. */
-    variant?: CommentBlockVariant;
+    isClickable?: boolean;
+    /** Tab index of the list. */
+    tabIndex?: number;
+    /** @deprecated not supported since v4.0.0 */
+    onListItemSelected?(key: Key, index: number, evt: SyntheticEvent): void;
 }
+declare const List: Comp<ListProps, HTMLUListElement> & {
+    useKeyboardListNavigation: useKeyboardListNavigationType;
+};
+
 /**
- * CommentBlock component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
+ * ListItemAction props.
  */
-declare const CommentBlock: Comp<CommentBlockProps, HTMLDivElement>;
+type ListItemActionProps<E extends ClickableElement = 'button'> = RawClickableProps<E> & HasClassName;
 
+/** ListItem size variants. */
+type ListItemSize = Extract<Size, 'tiny' | 'regular' | 'big' | 'huge'>;
 /**
  * Defines the props of the component.
  */
-interface DatePickerProps extends GenericProps$1 {
-    /** Default month. */
-    defaultMonth?: Date;
-    /** Locale (language or region) to use. */
-    locale?: string;
-    /** Date after which dates can't be selected. */
-    maxDate?: Date;
-    /** Date before which dates can't be selected. */
-    minDate?: Date;
-    /** Props to pass to the next month button (minus those already set by the DatePickerControlled props). */
-    nextButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
-    /** Props to pass to the previous month button (minus those already set by the DatePickerControlled props). */
-    previousButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
-    /** Reference to the <button> element corresponding to the current date or the selected date. */
-    todayOrSelectedDateRef?: Ref<HTMLButtonElement>;
-    /** Currently selected date. */
-    value: Date | undefined;
-    /** On change callback. */
-    onChange(value: Date | undefined): void;
+interface ListItemProps$1 extends HasClassName, HasAriaDisabled {
+    /** A component to be rendered after the content. */
+    after?: JSXElement;
+    /** A component to be rendered before the content. */
+    before?: JSXElement;
+    /** Content. */
+    children?: JSXElement;
+    /** Whether the list item should be highlighted or not. */
+    isHighlighted?: boolean;
+    /** Whether the component is selected or not. */
+    isSelected?: boolean;
+    /** Whether link/button is disabled or not. */
+    isDisabled?: boolean;
+    /** Custom component for the link (can be used to inject router Link). */
+    linkAs?: 'a' | any;
+    /** Props that will be passed on to the Link. */
+    linkProps?: GenericProps;
+    /** Reference to the link element. */
+    linkRef?: CommonRef;
+    /** Size variant. */
+    size?: ListItemSize;
+    /** ref to the root <li> element */
+    ref?: CommonRef;
+    /** On click callback. */
+    handleClick?: (event: any) => void;
 }
-
-/**
- * DatePicker component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const DatePicker: Comp<DatePickerProps, HTMLDivElement>;
+type ListItemPropsToOverride = 'after' | 'before' | 'children' | 'handleClick';
 
 /**
  * Defines the props of the component.
  */
-interface DatePickerControlledProps extends DatePickerProps {
-    /** Selected month to display. */
-    selectedMonth: Date;
-    /** On previous month change callback. */
-    onPrevMonthChange(): void;
-    /** On next month change callback. */
-    onNextMonthChange(): void;
-    /** On month/year change callback. */
-    onMonthChange?: (newMonth: Date) => void;
+interface ListItemProps extends GenericProps$1, HasAriaDisabled$1, ReactToJSX<ListItemProps$1, ListItemPropsToOverride> {
+    /** A component to be rendered after the content. */
+    after?: ReactNode;
+    /** A component to be rendered before the content. */
+    before?: ReactNode;
+    /** Content. */
+    children: string | ReactNode;
+    /** Reference to the <li> element. */
+    listItemRef?: Ref<HTMLLIElement>;
+    /** Reference to the link element. */
+    linkRef?: Ref<HTMLAnchorElement>;
+    /** On click callback. */
+    onClick?(event: SyntheticEvent): void;
+    /** @alias onClick */
+    onItemSelected?(evt: SyntheticEvent): void;
 }
 /**
- * DatePickerControlled component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
+ * ListItem component with Action sub-component.
  */
-declare const DatePickerControlled: Comp<DatePickerControlledProps, HTMLDivElement>;
+declare const ListItem: Comp<ListItemProps, HTMLLIElement> & {
+    /** Sub-component that renders the default action (button or link) for the action area pattern. */
+    Action: (<E extends React$1.ElementType = "button">(props: React$1.PropsWithoutRef<React$1.ComponentProps<E>> & {
+        as?: E | undefined;
+    } & GenericProps$1 & ReactToJSX<ListItemActionProps, "children"> & _lumx_core_js_types.HasRequiredLinkHref<E> & {
+        children: ReactNode;
+        onClick?(evt: SyntheticEvent): void;
+    } & React$1.ComponentProps<E> & {
+        ref?: ComponentRef<E> | undefined;
+    }) => React.JSX.Element) & {
+        displayName: string;
+        className: string;
+        defaultProps: Partial<ListItemActionProps<"button">>;
+    };
+};
 
 /**
  * Defines the props of the component.
  */
-interface DatePickerFieldProps extends Omit<TextFieldProps, 'value' | 'onChange'>, GenericProps$1 {
-    /** Default month. */
-    defaultMonth?: Date;
-    /** Locale (language or region) to use. */
-    locale?: string;
-    /** Date after which dates can't be selected. */
-    maxDate?: Date;
-    /** Date before which dates can't be selected. */
-    minDate?: Date;
-    /** Props to pass to the next month button (minus those already set by the DatePickerControlled props). */
-    nextButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
-    /** Props to pass to the previous month button (minus those already set by the DatePickerControlled props). */
-    previousButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
-    /** Currently selected date. */
-    value: Date | undefined;
-    /** On change callback. */
-    onChange(value: Date | undefined, name?: string, event?: SyntheticEvent): void;
+interface ListDividerProps$1 extends HasClassName {
+    /** ref to the root element */
+    ref?: CommonRef;
 }
+
 /**
- * DatePickerField component.
+ * Defines the props of the component.
+ */
+type ListDividerProps = GenericProps$1 & ReactToJSX<ListDividerProps$1>;
+/**
+ * ListDivider component.
+ * Purely decorative, consider a `ListSection` with label for a better list structure.
  *
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const DatePickerField: Comp<DatePickerFieldProps, HTMLDivElement>;
+declare const ListDivider: Comp<ListDividerProps, HTMLLIElement>;
 
 /**
  * Defines the props of the component.
  */
-interface DialogProps extends GenericProps$1, HasCloseMode$1 {
-    /** Footer content. */
-    footer?: ReactNode;
-    /** Whether the divider between the dialog content and the footer is always displayed (instead of showing it on scroll). */
-    forceFooterDivider?: boolean;
-    /** Header content. */
-    header?: ReactNode;
-    /** Whether the divider between the dialog content and the footer is always displayed (instead of showing it on scroll). */
-    forceHeaderDivider?: boolean;
-    /** Whether the indefinite progress indicator over the dialog content is displayed or not. */
-    isLoading?: boolean;
-    /** Whether the component is open or not. */
-    isOpen?: boolean;
-    /** Reference to the parent element that triggered modal opening (will get back focus on close). */
-    parentElement?: RefObject<HTMLElement>;
-    /** Reference to the dialog content element. */
-    contentRef?: Ref<HTMLDivElement>;
-    /** Reference to the of the element that should get the focus when the dialogs opens. By default, the first child will take focus. */
-    focusElement?: RefObject<HTMLElement>;
-    /** Whether to keep the dialog open on clickaway or escape press. */
-    preventAutoClose?: boolean;
-    /** Whether to keep the dialog open on escape press. */
-    preventCloseOnEscape?: boolean;
-    /** Whether to keep the dialog open on clickaway. */
-    preventCloseOnClick?: boolean;
-    /** Size variant. */
-    size?: DialogSizes;
-    /** Z-axis position. */
-    zIndex?: number;
-    /** Z-axis position. */
-    dialogProps?: GenericProps$1;
-    /** On close callback. */
-    onClose?(): void;
-    /** Callback called when the open animation starts and the close animation finishes. */
-    onVisibilityChange?(isVisible: boolean): void;
-    /** whether to disable the scroll on the body or not */
-    disableBodyScroll?: boolean;
-    /** Children */
-    children?: React__default.ReactNode;
+interface TextProps$1 extends HasClassName {
+    /**
+     * Color variant.
+     */
+    color?: ColorWithVariants;
+    /**
+     * Lightened or darkened variant of the selected color.
+     */
+    colorVariant?: ColorVariant;
+    /**
+     * Typography variant.
+     */
+    typography?: Typography;
+    /**
+     * Custom component to render the text.
+     */
+    as: TextElement;
+    /**
+     * Control whether the text should truncate or not.
+     * Setting as `true` will make the text truncate on a single line.
+     * Setting as `{ lines: number }` will make the text truncate on a multiple lines.
+     */
+    truncate?: boolean | {
+        lines: number;
+    };
+    /**
+     * Prevents text to wrap on multiple lines
+     * (automatically activated when single line text truncate is activated).
+     */
+    noWrap?: boolean;
+    /**
+     * WhiteSpace variant
+     * Ignored when `noWrap` is set to true
+     * Ignored when `truncate` is set to true or lines: 1
+     * */
+    whiteSpace?: WhiteSpace;
+    /**
+     * Children
+     */
+    children?: JSXElement;
+    /** list of styles to apply */
+    style?: CSSProperties;
 }
-type DialogSizes = Extract<Size$1, 'tiny' | 'regular' | 'big' | 'huge'>;
-/**
- * Dialog component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const Dialog: Comp<DialogProps, HTMLDivElement>;
 
 /**
  * Defines the props of the component.
  */
-interface DividerProps$1 extends HasTheme, HasClassName {
-    /** reference to the root element */
+interface ListSectionProps$1 extends HasClassName {
+    /** Section label displayed as the group title. Accepts a plain string or custom JSX content. */
+    label?: string | JSXElement;
+    /** Section icon */
+    icon?: string;
+    /** List items (should be ListItem, ListDivider, etc.). */
+    children: JSXElement;
+    /** Items wrapper forwarded props */
+    itemsWrapperProps?: Record<string, any>;
+    /** ID for the label element (used for aria-labelledby). */
+    id: string;
+    /** ref to the root element */
     ref?: CommonRef;
+    /** Text component to use for rendering the label */
+    Text: (props: TextProps$1 & Record<string, any>) => any;
 }
 
 /**
  * Defines the props of the component.
  */
-interface DividerProps extends GenericProps$1, ReactToJSX<DividerProps$1> {
+interface ListSectionProps extends GenericProps$1, ReactToJSX<ListSectionProps$1, 'children' | 'id' | 'Text'> {
+    /** Section content */
+    children: ReactNode;
 }
 /**
- * Divider component.
+ * ListSection component.
  *
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const Divider: Comp<DividerProps, HTMLHRElement>;
-
-/**
- * Defines the props of the component.
- */
-interface DragHandleProps$1 extends HasTheme, HasClassName {
-    /** Reference to the root element */
-    ref?: CommonRef;
-}
+declare const ListSection: Comp<ListSectionProps, HTMLLIElement>;
 
 /**
  * Defines the props of the component.
  */
-interface DragHandleProps extends GenericProps$1, ReactToJSX<DragHandleProps$1> {
+interface ListSubheaderProps extends GenericProps$1 {
+    /** Content. */
+    children: string | ReactNode;
 }
 /**
- * DragHandle component.
+ * ListSubheader component.
+ * @deprecated ListSubheader produces improper list structure. use ListSection instead.
  *
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const DragHandle: Comp<DragHandleProps, HTMLDivElement>;
+declare const ListSubheader: Comp<ListSubheaderProps, HTMLLIElement>;
+
+/**
+ * Defines the props for the core ComboboxState template.
+ */
+interface ComboboxStateProps$1 {
+    /**
+     * Message to display when the list has no visible options.
+     * Can be a plain string or a function receiving the current input value (for dynamic messages).
+     * When omitted, the empty state is not shown.
+     */
+    emptyMessage?: string | ((inputValue: string) => string);
+    /**
+     * Error state title message.
+     * When provided, the error state is active (takes priority over the empty state).
+     * When omitted, the error state is not shown.
+     */
+    errorMessage?: string;
+    /**
+     * Secondary error message (e.g. "Please try again").
+     * Only rendered when `errorMessage` is provided.
+     */
+    errorTryReloadMessage?: string;
+    /**
+     * Message to announce when loading persists (after a 500ms debounce).
+     * When omitted, no loading announcement is made.
+     */
+    loadingMessage?: string;
+    /**
+     * List state
+     */
+    state?: {
+        /**
+         * Whether the list currently has no visible options.
+         * Driven by the framework wrapper via the combobox handle's `emptyChange` event.
+         */
+        isEmpty?: boolean;
+        /**
+         * The current value of the combobox input.
+         * Passed to `emptyMessage` when it is a function.
+         */
+        inputValue?: string;
+        /**
+         * Whether loading is active (immediate, from `loadingChange` event).
+         * Used to suppress false "empty" state while data is loading.
+         */
+        isLoading?: boolean;
+        /**
+         * Whether the combobox popover is open.
+         * Used to gate live region content so screen readers announce messages
+         * when the popover opens (content insertion triggers `aria-live` announcement).
+         */
+        isOpen?: boolean;
+    };
+}
+
+/**
+ * Props for Combobox.State component.
+ */
+interface ComboboxStateProps extends ReactToJSX<ComboboxStateProps$1, 'state'> {
+    /** Additional content rendered after the state message. */
+    children?: ReactNode;
+}
+
+/**
+ * Defines the props for the core ComboboxSection template.
+ */
+interface ComboboxSectionProps$1 extends HasClassName {
+    /** Section label displayed as the group title. Accepts a plain string or custom JSX content. */
+    label?: string | JSXElement;
+    /** Section icon */
+    icon?: string;
+    /** Section content (should be ComboboxOption elements). */
+    children: JSXElement;
+    /** ref to the root element. */
+    ref?: CommonRef;
+    /**
+     * When true, the section renders as a bare `<li hidden>` wrapper, keeping children
+     * mounted (so option registrations stay alive) but invisible to the user and screen readers.
+     * Set automatically by the React/Vue wrapper when all child options are filtered out.
+     */
+    hidden?: boolean;
+    /**
+     * When true, the section is visually rendered (label + content) but hidden from assistive
+     * technology. Used for skeleton-only sections: the visual skeleton provides feedback to
+     * sighted users, while the live region (`ComboboxState`) handles the loading announcement.
+     */
+    'aria-hidden'?: boolean;
+}
+/**
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ * Used by `ReactToJSX<ComboboxSectionProps, ComboboxSectionPropsToOverride>`.
+ */
+type ComboboxSectionPropsToOverride = 'children';
+
+/**
+ * Props for Combobox.Section component.
+ */
+interface ComboboxSectionProps extends GenericProps$1, ReactToJSX<ComboboxSectionProps$1, ComboboxSectionPropsToOverride> {
+    /** Section content (should be Combobox.Option elements). */
+    children: ReactNode;
+}
 
 /**
  * Different possible placements for the popover.
@@ -1445,164 +1553,939 @@ interface PopoverProps extends GenericProps$1, ReactToJSX<PopoverProps$1, 'ancho
 declare const Popover: Comp<PopoverProps, HTMLDivElement>;
 
 /**
- * Defines the props of the component.
+ * Props for Popover that can be passed to Combobox.Popover.
+ * Excludes isOpen, anchorRef, children, and onClose which are managed internally.
  */
-interface DropdownProps extends GenericProps$1 {
-    /**
-     * Reference to the element around which the dropdown is placed.
-     * @see {@link PopoverProps#anchorRef}
-     */
-    anchorRef: PopoverProps['anchorRef'];
-    /** Dropdown content. */
-    children: React.ReactNode;
-    /**
-     * Whether a click anywhere out of the Dropdown would close it or not.
-     * @see {@link PopoverProps#closeOnClickAway}
-     */
-    closeOnClickAway?: boolean;
-    /**
-     * Whether to close the Dropdown when clicking in it or not.
-     */
-    closeOnClick?: boolean;
-    /**
-     * Whether an escape key press would close the Dropdown or not.
-     * @see {@link PopoverProps#closeOnEscape}
-     */
-    closeOnEscape?: boolean;
-    /**
-     * Manage dropdown width:
-     *   - `maxWidth`: dropdown not bigger than anchor
-     *   - `minWidth` or `true`: dropdown not smaller than anchor
-     *   - `width`: dropdown equal to the anchor.
-     * @see {@link PopoverProps#fitToAnchorWidth}
-     */
-    fitToAnchorWidth?: PopoverProps['fitToAnchorWidth'];
-    /**
-     * Whether the dropdown should shrink to fit within the viewport height or not.
-     * @see {@link PopoverProps#fitWithinViewportHeight}
-     */
-    fitWithinViewportHeight?: boolean;
-    /**
-     * Whether the dropdown should be displayed or not. Useful to control the Dropdown from outside the component.
-     * @see {@link PopoverProps#isOpen}
-     */
-    isOpen: boolean;
-    /**
-     * Offset applied to the Dropdown position.
-     * @see {@link PopoverProps#offset}
-     */
-    offset?: Offset;
-    /**
-     * Preferred Dropdown placement against the anchor element.
-     * @see {@link PopoverProps#placement}
-     */
-    placement?: Placement;
-    /** Whether the focus should be set on the list when the dropdown is open or not. */
-    shouldFocusOnOpen?: boolean;
-    /** Whether the dropdown should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
-    usePortal?: boolean;
-    /** Whether the focus should go back on the anchor when dropdown closes and focus is within. */
-    focusAnchorOnClose?: boolean;
-    /**
-     * Z-axis position.
-     * @see {@link PopoverProps#zIndex}
-     */
-    zIndex?: number;
-    /**
-     * On close callback.
-     * @see {@link PopoverProps#onClose}
-     */
-    onClose?(): void;
-    /** On scroll end callback. */
-    onInfiniteScroll?(): void;
-}
+type ComboboxPopoverProps = Partial<Omit<PopoverProps, 'isOpen' | 'anchorRef' | 'children' | 'onClose'>>;
 /**
- * Dropdown component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
+ * Props for the Combobox.Popover component.
  */
-declare const Dropdown: Comp<DropdownProps, HTMLDivElement>;
+interface ComboboxPopoverComponentProps extends ComboboxPopoverProps {
+    /** Content (should contain a Combobox.List). */
+    children: ReactNode;
+}
 
 /**
- * Defines the props of the component.
+ * Defines the props for the core ComboboxOptionSkeleton template.
  */
-interface ExpansionPanelProps extends GenericProps$1, HasCloseMode$1, HasTheme$1 {
-    /** Whether the expansion panel has a background. */
-    hasBackground?: boolean;
-    /** Whether the header has a divider. */
-    hasHeaderDivider?: boolean;
-    /** Whether the component is open or not. */
-    isOpen?: boolean;
-    /** Label text (overwritten if a `<header>` is provided in the children). */
-    label?: string;
-    /** On open callback. */
-    onOpen?: (event: React__default.MouseEvent) => void;
-    /** On close callback. */
-    onClose?: (event: React__default.MouseEvent) => void;
-    /** Props to pass to the toggle button (minus those already set by the ExpansionPanel props). */
-    toggleButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis' | 'color'>;
-    /** On toggle open or close callback. */
-    onToggleOpen?(shouldOpen: boolean, event: React__default.MouseEvent): void;
-    /** Children */
-    children?: React__default.ReactNode;
+interface ComboboxOptionSkeletonProps$1 extends HasClassName {
+    /** Content rendered before the skeleton text (e.g. SkeletonCircle for avatar placeholders). */
+    before?: JSXElement;
+    /** Content rendered after the skeleton text. */
+    after?: JSXElement;
+    /** Show a secondary skeleton line (mirrors ComboboxOption's `description` prop). */
+    hasDescription?: boolean;
+    /** Override the default SkeletonTypography content entirely. */
+    children?: JSXElement;
+    /** ref to the root <li> element. */
+    ref?: CommonRef;
 }
 /**
- * ExpansionPanel component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ * Used by `ReactToJSX<ComboboxOptionSkeletonProps, ComboboxOptionSkeletonPropsToOverride>`.
  */
-declare const ExpansionPanel: Comp<ExpansionPanelProps, HTMLDivElement>;
+type ComboboxOptionSkeletonPropsToOverride = 'before' | 'after' | 'children';
 
 /**
- * Defines the props of the component.
+ * Props for Combobox.OptionSkeleton component.
  */
-interface TextProps$1 extends HasClassName {
+interface ComboboxOptionSkeletonProps extends GenericProps$1, ReactToJSX<ComboboxOptionSkeletonProps$1, ComboboxOptionSkeletonPropsToOverride> {
+    /** Content rendered before the skeleton text (e.g. SkeletonCircle for avatar placeholders). */
+    before?: ReactNode;
+    /** Content rendered after the skeleton text. */
+    after?: ReactNode;
+    /** Override the default SkeletonTypography content entirely. */
+    children?: ReactNode;
     /**
-     * Color variant.
+     * Number of skeleton `<li>` elements to render.
+     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
+     * @default 1
      */
-    color?: ColorWithVariants;
-    /**
-     * Lightened or darkened variant of the selected color.
+    count?: number;
+}
+
+/**
+ * Defines the props for the core ComboboxOptionMoreInfo template.
+ */
+interface ComboboxOptionMoreInfoProps$1 extends HasClassName {
+    /** Popover content (additional details about the option). */
+    children?: JSXElement;
+    /** Whether the popover is open. */
+    isOpen?: boolean;
+    /** ID for the popover element (used for aria-describedby on the parent option). */
+    popoverId: string;
+    /** Ref for the anchor element (icon button). */
+    ref?: CommonRef;
+    /** Mouse enter callback. */
+    onMouseEnter?(): void;
+    /** Mouse leave callback. */
+    onMouseLeave?(): void;
+    /** Props forwarded to the IconButton. */
+    buttonProps?: Record<string, any>;
+}
+/**
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ */
+type ComboboxOptionMoreInfoPropsToOverride = 'children' | 'popoverId' | 'isOpen';
+
+/**
+ * Props for Combobox.OptionMoreInfo component.
+ */
+interface ComboboxOptionMoreInfoProps extends ReactToJSX<ComboboxOptionMoreInfoProps$1, ComboboxOptionMoreInfoPropsToOverride> {
+    /** Content of the popover (additional details about the option). */
+    children?: ReactNode;
+    /** Callback when the popover opens or closes. */
+    onToggle?(isOpen: boolean): void;
+    /** Props forwarded to the IconButton. */
+    buttonProps?: Partial<IconButtonProps>;
+}
+
+/**
+ * Defines the props for the core ComboboxOption template.
+ */
+interface ComboboxOptionProps$1 extends HasClassName {
+    /** A component to be rendered before the content (e.g. an icon or avatar). */
+    before?: JSXElement;
+    /** A component to be rendered after the content (e.g. ComboboxOptionAction elements). */
+    after?: JSXElement;
+    /** Content (option label). */
+    children?: JSXElement;
+    /** Props forwarded to a Tooltip wrapping the role="option" / role="gridcell" element. */
+    tooltipProps?: Record<string, any>;
+    /** Helper description. */
+    description?: string;
+    /** Unique ID for the option element. */
+    id?: string;
+    /** Unique ID for the description element (for aria-describedby). */
+    descriptionId?: string;
+    /** Whether the option is disabled. */
+    isDisabled?: boolean;
+    /** Whether the option is selected. */
+    isSelected?: boolean;
+    /** Whether the parent list is in grid mode. */
+    isGrid?: boolean;
+    /**
+     * Whether the option is hidden (filtered out by auto-filter).
+     * When true, renders a bare `<li hidden>` with only the children text — no ARIA roles,
+     * no classes, no visual structure. This keeps the element in the DOM so its textContent
+     * can be read for future filter evaluations, while naturally excluding it from
+     * `[role="option"]` queries (focus navigation) and `.lumx-combobox-option` CSS rules
+     * (section/popover auto-hide).
+     */
+    hidden?: boolean;
+    /** On click callback. */
+    handleClick?(): void;
+    /** Extra props forwarded to the inner action element (e.g. link props when as="a"). */
+    actionProps?: Record<string, any>;
+    /** ref to the root <li> element. */
+    ref?: CommonRef;
+    /** The value for this option (used for selection). */
+    value?: string;
+}
+/**
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ * Used by `ReactToJSX<ComboboxOptionProps, ComboboxOptionPropsToOverride>`.
+ */
+type ComboboxOptionPropsToOverride = 'before' | 'after' | 'children' | 'tooltipProps' | 'actionProps';
+
+declare const ARIA_LINK_MODES: readonly ["aria-describedby", "aria-labelledby"];
+
+/** Position of the tooltip relative to the anchor element. */
+type TooltipPlacement = 'top' | 'right' | 'bottom' | 'left';
+/**
+ * Framework-agnostic tooltip props (shared between React and Vue wrappers).
+ */
+interface TooltipProps$1 extends HasCloseMode {
+    /** Delay (in ms) before closing the tooltip. */
+    delay?: number;
+    /** Whether the tooltip is displayed even without the mouse hovering the anchor. */
+    forceOpen?: boolean;
+    /** Label text. */
+    label?: string | null | false;
+    /** Placement of the tooltip relative to the anchor. */
+    placement?: TooltipPlacement;
+    /** Choose how the tooltip text should link to the anchor */
+    ariaLinkMode?: (typeof ARIA_LINK_MODES)[number];
+    /** Z-index for the tooltip */
+    zIndex?: number;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TooltipProps extends GenericProps$1, TooltipProps$1 {
+    /** Anchor (element on which we activate the tooltip). */
+    children: ReactNode;
+}
+/**
+ * Tooltip component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const Tooltip: Comp<TooltipProps, HTMLDivElement>;
+
+/**
+ * Props forwarded to the inner action element (button or link).
+ */
+type ComboboxOptionActionProps$1<E extends ElementType$1 = 'button'> = HasPolymorphicAs$1<E> & HasRequiredLinkHref$1<E>;
+/**
+ * Props for Combobox.Option component.
+ */
+interface ComboboxOptionProps extends GenericProps$1, ReactToJSX<ComboboxOptionProps$1, ComboboxOptionPropsToOverride> {
+    /** Display label for the option. */
+    children?: ReactNode;
+    /** On option clicked (or activated with keyboard) */
+    onClick?(): void;
+    /** Content rendered before the option label (e.g. an icon or avatar). */
+    before?: ReactNode;
+    /**
+     * Content rendered after the option label.
+     * In grid mode (`type="grid"` on the parent Combobox.List), use `Combobox.OptionAction` elements here
+     * to add secondary action buttons. Each action becomes an independent `role="gridcell"`.
+     */
+    after?: ReactNode;
+    /** Props forwarded to a Tooltip wrapping the role="option" / role="gridcell" trigger element. */
+    tooltipProps?: Partial<TooltipProps>;
+    /** Props forwarded to the inner action element (e.g. `{ as: 'a', href: '/foo' }`). */
+    actionProps?: ComboboxOptionActionProps$1<any>;
+}
+
+/**
+ * Popup type for the combobox listbox.
+ * - `'listbox'`: Standard listbox with `role="listbox"` and `role="option"` items.
+ * - `'grid'`: Grid mode with `role="grid"` and `role="gridcell"` items, enabling 2D keyboard navigation.
+ */
+type ComboboxListType = 'listbox' | 'grid';
+
+/**
+ * Props for Combobox.List component.
+ * Note: role, id are set internally and cannot be overridden.
+ */
+interface ComboboxListProps extends ListProps {
+    /** Accessible label for the listbox (required for accessibility). */
+    'aria-label': string;
+    /**
+     * The popup type. Set to "grid" when options have action buttons (Combobox.OptionAction).
+     * Enables 2D keyboard navigation and switches ARIA roles from listbox/option to grid/gridcell.
+     * @default 'listbox'
+     */
+    type?: ComboboxListType;
+}
+
+interface InputLabelProps$1 extends HasClassName, HasTheme {
+    /** Typography variant. */
+    typography?: Typography;
+    /** Label content. */
+    children: JSXElement;
+    /** Native htmlFor property. */
+    htmlFor: string;
+    /** Whether the component is required or not. */
+    isRequired?: boolean;
+    /** ref to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface TextFieldProps$1 extends HasClassName, HasTheme, HasAriaDisabled, HasDisabled {
+    /** Chip Group to be rendered before the main text input. */
+    chips?: JSXElement;
+    /** Props to pass to the clear button (minus those already set by the TextField props). If not specified, the button won't be displayed. */
+    clearButtonProps?: GenericProps;
+    /** Error message. */
+    error?: string | JSXElement;
+    /** Whether we force the focus style or not. */
+    forceFocusStyle?: boolean;
+    /** Whether the text field is displayed with error style or not. */
+    hasError?: boolean;
+    /** Additional element to put at the end of the text field. */
+    afterElement?: JSXElement;
+    /** Helper text. */
+    helper?: string | JSXElement;
+    /** Icon (SVG path). */
+    icon?: string;
+    /** Native input id property (generated if not provided to link the label element). */
+    id?: string;
+    /** Generated helper id for accessibility attributes. */
+    helperId?: string;
+    /** Generated error id for accessibility attributes. */
+    errorId?: string;
+    /** Whether the component is required or not. */
+    isRequired?: boolean;
+    /** Whether the text field is displayed with valid style or not. */
+    isValid?: boolean;
+    /** Label text. */
+    label?: string;
+    /** Additional label props. */
+    labelProps?: InputLabelProps$1;
+    /** Max string length the input accepts (constrains the input and displays a character counter). */
+    maxLength?: number;
+    /** Whether the text field is a textarea or an input. */
+    multiline?: boolean;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Reference to the wrapper. */
+    textFieldRef?: CommonRef;
+    /** Value. */
+    value?: string;
+    /** Whether any part is disabled. */
+    isAnyDisabled?: boolean;
+    /** The input element (input or textarea). */
+    input: JSXElement;
+    /** Whether the input is focused. */
+    isFocus?: boolean;
+    /** IconButton component. */
+    IconButton: (props: Record<string, any>) => any;
+    /** Ref to the component root. */
+    ref?: CommonRef;
+}
+type TextFieldPropsToOverride = 'input' | 'IconButton' | 'labelProps' | 'textFieldRef' | 'clearButtonProps' | 'helperId' | 'errorId' | 'isAnyDisabled' | 'isFocus';
+
+/**
+ * Defines the props of the component.
+ */
+interface TextFieldProps extends GenericProps$1, ReactToJSX<TextFieldProps$1, TextFieldPropsToOverride> {
+    /** Props to pass to the clear button (minus those already set by the TextField props). If not specified, the button won't be displayed. */
+    clearButtonProps?: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
+    /** Reference to the <input> or <textarea> element. */
+    inputRef?: Ref<HTMLInputElement | HTMLTextAreaElement>;
+    /** Additional label props. */
+    labelProps?: InputLabelProps;
+    /** Minimum number of rows displayed in multiline mode (requires `multiline` to be enabled). */
+    minimumRows?: number;
+    /** Native input name property. */
+    name?: string;
+    /** Reference to the wrapper. */
+    textFieldRef?: Ref<HTMLDivElement>;
+    /** Native input type (only when `multiline` is disabled). */
+    type?: React.ComponentProps<'input'>['type'];
+    /** On blur callback. */
+    onBlur?(event: React.FocusEvent): void;
+    /** On change callback. */
+    onChange(value: string, name?: string, event?: SyntheticEvent): void;
+    /** On clear callback. */
+    onClear?(event?: SyntheticEvent): void;
+    /** On focus callback. */
+    onFocus?(event: React.FocusEvent): void;
+}
+/**
+ * TextField component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const TextField: Comp<TextFieldProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface RawInputTextProps$1 extends HasTheme, HasClassName {
+    value?: string;
+    type?: HTMLInputTypeAttribute;
+    name?: string | undefined;
+    ref?: CommonRef;
+    handleChange?: (value: string, name?: string, event?: any) => void;
+}
+
+type NativeInputProps = Omit<ComponentProps<'input'>, 'value' | 'onChange'>;
+/**
+ * Defines the props of the component.
+ */
+interface RawInputTextProps extends NativeInputProps, ReactToJSX<RawInputTextProps$1> {
+    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
+}
+
+/**
+ * Raw input text component
+ * (input element without any decoration)
+ */
+declare const RawInputText: Comp<RawInputTextProps, HTMLInputElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface RawInputTextareaProps$1 extends HasTheme, HasClassName {
+    value?: string;
+    rows?: number;
+    name?: string | undefined;
+    ref?: CommonRef;
+    handleChange?: (value: string, name?: string, event?: any) => void;
+}
+
+type NativeTextareaProps = Omit<ComponentProps<'textarea'>, 'value' | 'onChange'>;
+/**
+ * Defines the props of the component.
+ */
+interface RawInputTextareaProps extends NativeTextareaProps, ReactToJSX<RawInputTextareaProps$1, 'rows'> {
+    minimumRows?: number;
+    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
+}
+/**
+ * Raw input text area component
+ * (textarea element without any decoration)
+ */
+declare const RawInputTextarea: Comp<Omit<RawInputTextareaProps, "type">, HTMLTextAreaElement>;
+
+/**
+ * Props for Combobox.Input component.
+ * Note: role, aria-autocomplete, aria-controls, aria-expanded are set internally and cannot be overridden.
+ */
+interface ComboboxInputProps extends TextFieldProps {
+    /** Reference to the input element. */
+    inputRef?: Ref<HTMLInputElement>;
+    /**
+     * Props for the toggle button.
+     * When provided, a chevron button will be rendered in the text field's afterElement
+     * to toggle the listbox visibility.
+     */
+    toggleButtonProps?: Pick<IconButtonProps, 'label'> & Partial<Omit<IconButtonProps, 'label'>>;
+    /** Called when an option is selected. */
+    onSelect?: (option: {
+        value: string;
+    }) => void;
+    /**
+     * When true (default), the combobox automatically filters options as the user types.
+     * Each `Combobox.Option` registers itself and hides when it doesn't match the input value.
+     *
+     * Set to false when you handle filtering yourself (e.g. async search, consumer-side
+     * pre-filtering). Options will not be auto-filtered.
+     */
+    autoFilter?: boolean;
+}
+
+/**
+ * Label display mode for the ComboboxButton.
+ * - `'show-selection'`: Show the selected value if available, otherwise the label.
+ * - `'show-label'`: Always show the label.
+ * - `'show-tooltip'`: Show nothing in the button; label appears only in tooltip.
+ */
+type ComboboxButtonLabelDisplayMode = 'show-selection' | 'show-label' | 'show-tooltip';
+/**
+ * Defines the props for the core ComboboxButton template.
+ */
+interface ComboboxButtonProps$1 extends HasClassName {
+    /** The label for the button (used for ARIA and tooltip). */
+    label: string;
+    /** The currently selected value to display. */
+    value?: string;
+    /** Controls how the label/value is displayed. */
+    labelDisplayMode?: ComboboxButtonLabelDisplayMode;
+    /** The ID of the listbox element (for aria-controls). */
+    listboxId?: string;
+    /** Whether the combobox is open. */
+    isOpen?: boolean;
+    /** ref to the root button element. */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface ComboboxProviderProps {
+    /** Combobox content. */
+    children?: ReactNode;
+}
+/**
+ * Combobox.Provider component.
+ *
+ * Provides shared context to sub-components. The vanilla JS combobox handle is
+ * created by the trigger sub-component (Combobox.Input or Combobox.Button) on mount.
+ *
+ * @param props Component props.
+ * @return React element.
+ */
+declare function ComboboxProvider(props: ComboboxProviderProps): react_jsx_runtime.JSX.Element;
+declare namespace ComboboxProvider {
+    var displayName: string;
+}
+
+/** Map of combobox event names to their payload types. */
+interface ComboboxEventMap {
+    /** Fired when the combobox open state changes. Payload: whether the combobox is open. */
+    open: boolean;
+    /** Fired when the active descendant changes (visual focus). Payload: the option id or null. */
+    activeDescendantChange: string | null;
+    /**
+     * Fired when the visible option count transitions between empty and non-empty.
+     * Payload: whether the list is empty plus the current input value.
+     */
+    emptyChange: {
+        isEmpty?: boolean;
+        inputValue?: string;
+    } | undefined;
+    /**
+     * Fired immediately when the aggregate loading state changes (skeleton count transitions
+     * between 0 and >0). Used for empty suppression in ComboboxState and for aria-busy on the listbox.
+     */
+    loadingChange: boolean;
+    /**
+     * Fired after a 500ms debounce when loading persists, or immediately when loading ends.
+     * Used to control the loading message text in the live region (ComboboxState).
+     */
+    loadingAnnouncement: boolean;
+}
+
+/**
+ * Hook to subscribe to a combobox event via the handle's subscriber system.
+ * Re-subscribes when the handle changes (e.g. trigger mount/unmount).
+ */
+declare function useComboboxEvent<K extends keyof ComboboxEventMap>(event: K, initialValue: ComboboxEventMap[K]): ComboboxEventMap[K];
+
+/**
+ * Props for Combobox.Button component.
+ *
+ * Polymorphic component — use `as` to render the trigger as a different element or component
+ * (e.g., `as="a"`, `as={RouterLink}`). Defaults to the LumX `Button` component.
+ */
+type ComboboxButtonProps<E extends ElementType$1 = typeof Button> = Omit<HasPolymorphicAs$1<E>, 'children' | 'role' | 'aria-controls' | 'aria-haspopup' | 'aria-expanded' | 'aria-activedescendant'> & HasRequiredLinkHref$1<E> & ReactToJSX<ComboboxButtonProps$1> & {
+    /** Called when an option is selected. */
+    onSelect?: (option: {
+        value: string;
+    }) => void;
+};
+
+/**
+ * Combobox.OptionAction props.
+ *
+ * Polymorphic component — use `as` to render as a different element or component
+ * (e.g., `as={IconButton}`, `as={Button}`). Defaults to `'button'`.
+ */
+type ComboboxOptionActionProps<E extends ElementType$1 = 'button'> = HasPolymorphicAs$1<E> & HasClassName$1 & HasRequiredLinkHref$1<E> & {
+    /** Content of the action (icon, label, etc.). Optional when using a polymorphic `as` that provides its own content (e.g., IconButton). */
+    children?: ReactNode;
+    /** Whether the action is disabled. */
+    isDisabled?: boolean;
+    /** On click callback. */
+    onClick?(evt: SyntheticEvent): void;
+};
+
+/**
+ * Combobox compound component namespace.
+ */
+declare const Combobox: {
+    /** Provides shared combobox context (handle, listbox ID, anchor ref) to all sub-components. */
+    Provider: typeof ComboboxProvider;
+    /** Button trigger for select-only combobox mode with keyboard navigation and typeahead. */
+    Button: (<E extends React$1.ElementType = Comp<ButtonProps, HTMLButtonElement | HTMLAnchorElement>>(props: Omit<HasPolymorphicAs$1<E>, "children" | "aria-expanded" | "aria-haspopup" | "role" | "aria-controls" | "aria-activedescendant"> & _lumx_core_js_types.HasRequiredLinkHref<E> & ReactToJSX<ComboboxButtonProps$1> & {
+        onSelect?: (option: {
+            value: string;
+        }) => void;
+    } & React$1.ComponentProps<E> & {
+        ref?: ComponentRef<E> | undefined;
+    }) => React.JSX.Element) & {
+        displayName: string;
+        className: "lumx-combobox-button";
+    };
+    /** Text input trigger for autocomplete combobox mode with optional toggle button and filtering. */
+    Input: Comp<ComboboxInputProps, HTMLDivElement>;
+    /** Listbox container that registers with the combobox handle and tracks loading state. */
+    List: Comp<ComboboxListProps, HTMLUListElement>;
+    /** Selectable option item with filtering and keyboard navigation support. */
+    Option: Comp<ComboboxOptionProps, HTMLLIElement>;
+    /** Secondary action button within a grid-mode option row, rendered as an independent gridcell. */
+    OptionAction: (<E extends React$1.ElementType = "button">(props: React$1.PropsWithoutRef<React$1.ComponentProps<E>> & {
+        as?: E | undefined;
+    } & _lumx_core_js_types.HasClassName & _lumx_core_js_types.HasRequiredLinkHref<E> & {
+        children?: React$1.ReactNode;
+        isDisabled?: boolean;
+        onClick?(evt: React$1.SyntheticEvent): void;
+    } & React$1.ComponentProps<E> & {
+        ref?: ComponentRef<E> | undefined;
+    }) => React.JSX.Element) & {
+        displayName: string;
+        className: "lumx-combobox-option-action";
+    };
+    /** Info button on an option that shows a popover on hover or keyboard highlight. */
+    OptionMoreInfo: {
+        (props: ComboboxOptionMoreInfoProps): react_jsx_runtime.JSX.Element;
+        displayName: string;
+        className: "lumx-combobox-option-more-info";
+    };
+    /** Loading placeholder skeleton(s) that auto-register loading state with the combobox handle. */
+    OptionSkeleton: {
+        (props: ComboboxOptionSkeletonProps): react_jsx_runtime.JSX.Element[];
+        displayName: string;
+        className: "lumx-combobox-option-skeleton";
+    };
+    /** Floating popover container that auto-binds to the combobox anchor and open/close state. */
+    Popover: {
+        (props: ComboboxPopoverComponentProps): react_jsx_runtime.JSX.Element;
+        displayName: string;
+        className: "lumx-combobox-popover";
+    };
+    /** Labelled group of options that auto-hides when all its child options are filtered out. */
+    Section: Comp<ComboboxSectionProps, HTMLLIElement>;
+    /** Displays empty, error, and loading state messages for the combobox list. */
+    State: {
+        (props: ComboboxStateProps): react_jsx_runtime.JSX.Element;
+        displayName: string;
+        className: "lumx-combobox-state";
+    };
+    /** Visual separator between option groups (alias for ListDivider). Purely decorative — invisible to screen readers. */
+    Divider: Comp<ListDividerProps, HTMLLIElement>;
+    /** Hook to subscribe to combobox events. Must be used within a Combobox.Provider. */
+    useComboboxEvent: typeof useComboboxEvent;
+};
+
+/**
+ * Comment block variants.
+ */
+declare const CommentBlockVariant: {
+    readonly indented: "indented";
+    readonly linear: "linear";
+};
+type CommentBlockVariant = ValueOf$1<typeof CommentBlockVariant>;
+/**
+ * Defines the props of the component.
+ */
+interface CommentBlockProps extends GenericProps$1, HasTheme$1 {
+    /** Action toolbar content. */
+    actions?: ReactNode;
+    /** Props to pass to the avatar. */
+    avatarProps: AvatarProps;
+    /** Comment block replies. */
+    children?: ReactNode;
+    /** Comment date with the minimal timestamp information (xx minutes, x hours, yesterday, 6 days, Month Day, Month Day Year)*/
+    date?: string;
+    /** Comment date with the full timestamp information (day, month, year, time) */
+    fullDate?: string;
+    /** Whether the component has actions to display or not. */
+    hasActions?: boolean;
+    /** Action toolbar header content. */
+    headerActions?: ReactNode;
+    /** Whether the component is open or not. */
+    isOpen?: boolean;
+    /** Whether the comment is relevant or not. */
+    isRelevant?: boolean;
+    /** Comment author name. */
+    name?: React.ReactNode;
+    /**
+     * On click callback.
+     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
+     */
+    onClick?(): void;
+    /**
+     * On mouse enter callback.
+     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
+     */
+    onMouseEnter?(): void;
+    /**
+     * On mouse leave callback.
+     * @deprecated Use avatarProps instead and/or inject a clickable component in `name`
+     */
+    onMouseLeave?(): void;
+    /** Comment content. */
+    text: ReactNode | string;
+    /** Comment variant. */
+    variant?: CommentBlockVariant;
+}
+/**
+ * CommentBlock component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const CommentBlock: Comp<CommentBlockProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DatePickerProps extends GenericProps$1 {
+    /** Default month. */
+    defaultMonth?: Date;
+    /** Locale (language or region) to use. */
+    locale?: string;
+    /** Date after which dates can't be selected. */
+    maxDate?: Date;
+    /** Date before which dates can't be selected. */
+    minDate?: Date;
+    /** Props to pass to the next month button (minus those already set by the DatePickerControlled props). */
+    nextButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
+    /** Props to pass to the previous month button (minus those already set by the DatePickerControlled props). */
+    previousButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
+    /** Reference to the <button> element corresponding to the current date or the selected date. */
+    todayOrSelectedDateRef?: Ref<HTMLButtonElement>;
+    /** Currently selected date. */
+    value: Date | undefined;
+    /** On change callback. */
+    onChange(value: Date | undefined): void;
+}
+
+/**
+ * DatePicker component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const DatePicker: Comp<DatePickerProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DatePickerControlledProps extends DatePickerProps {
+    /** Selected month to display. */
+    selectedMonth: Date;
+    /** On previous month change callback. */
+    onPrevMonthChange(): void;
+    /** On next month change callback. */
+    onNextMonthChange(): void;
+    /** On month/year change callback. */
+    onMonthChange?: (newMonth: Date) => void;
+}
+/**
+ * DatePickerControlled component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const DatePickerControlled: Comp<DatePickerControlledProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DatePickerFieldProps extends Omit<TextFieldProps, 'value' | 'onChange'>, GenericProps$1 {
+    /** Default month. */
+    defaultMonth?: Date;
+    /** Locale (language or region) to use. */
+    locale?: string;
+    /** Date after which dates can't be selected. */
+    maxDate?: Date;
+    /** Date before which dates can't be selected. */
+    minDate?: Date;
+    /** Props to pass to the next month button (minus those already set by the DatePickerControlled props). */
+    nextButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
+    /** Props to pass to the previous month button (minus those already set by the DatePickerControlled props). */
+    previousButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
+    /** Currently selected date. */
+    value: Date | undefined;
+    /** On change callback. */
+    onChange(value: Date | undefined, name?: string, event?: SyntheticEvent): void;
+}
+/**
+ * DatePickerField component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const DatePickerField: Comp<DatePickerFieldProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DialogProps extends GenericProps$1, HasCloseMode$1 {
+    /** Footer content. */
+    footer?: ReactNode;
+    /** Whether the divider between the dialog content and the footer is always displayed (instead of showing it on scroll). */
+    forceFooterDivider?: boolean;
+    /** Header content. */
+    header?: ReactNode;
+    /** Whether the divider between the dialog content and the footer is always displayed (instead of showing it on scroll). */
+    forceHeaderDivider?: boolean;
+    /** Whether the indefinite progress indicator over the dialog content is displayed or not. */
+    isLoading?: boolean;
+    /** Whether the component is open or not. */
+    isOpen?: boolean;
+    /** Reference to the parent element that triggered modal opening (will get back focus on close). */
+    parentElement?: RefObject<HTMLElement>;
+    /** Reference to the dialog content element. */
+    contentRef?: Ref<HTMLDivElement>;
+    /** Reference to the of the element that should get the focus when the dialogs opens. By default, the first child will take focus. */
+    focusElement?: RefObject<HTMLElement>;
+    /** Whether to keep the dialog open on clickaway or escape press. */
+    preventAutoClose?: boolean;
+    /** Whether to keep the dialog open on escape press. */
+    preventCloseOnEscape?: boolean;
+    /** Whether to keep the dialog open on clickaway. */
+    preventCloseOnClick?: boolean;
+    /** Size variant. */
+    size?: DialogSizes;
+    /** Z-axis position. */
+    zIndex?: number;
+    /** Z-axis position. */
+    dialogProps?: GenericProps$1;
+    /** On close callback. */
+    onClose?(): void;
+    /** Callback called when the open animation starts and the close animation finishes. */
+    onVisibilityChange?(isVisible: boolean): void;
+    /** whether to disable the scroll on the body or not */
+    disableBodyScroll?: boolean;
+    /** Children */
+    children?: React__default.ReactNode;
+}
+type DialogSizes = Extract<Size$1, 'tiny' | 'regular' | 'big' | 'huge'>;
+/**
+ * Dialog component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const Dialog: Comp<DialogProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DividerProps$1 extends HasTheme, HasClassName {
+    /** reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface DividerProps extends GenericProps$1, ReactToJSX<DividerProps$1> {
+}
+/**
+ * Divider component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const Divider: Comp<DividerProps, HTMLHRElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DragHandleProps$1 extends HasTheme, HasClassName {
+    /** Reference to the root element */
+    ref?: CommonRef;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface DragHandleProps extends GenericProps$1, ReactToJSX<DragHandleProps$1> {
+}
+/**
+ * DragHandle component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const DragHandle: Comp<DragHandleProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface DropdownProps extends GenericProps$1 {
+    /**
+     * Reference to the element around which the dropdown is placed.
+     * @see {@link PopoverProps#anchorRef}
      */
-    colorVariant?: ColorVariant;
+    anchorRef: PopoverProps['anchorRef'];
+    /** Dropdown content. */
+    children: React.ReactNode;
     /**
-     * Typography variant.
+     * Whether a click anywhere out of the Dropdown would close it or not.
+     * @see {@link PopoverProps#closeOnClickAway}
      */
-    typography?: Typography;
+    closeOnClickAway?: boolean;
     /**
-     * Custom component to render the text.
+     * Whether to close the Dropdown when clicking in it or not.
      */
-    as: TextElement;
+    closeOnClick?: boolean;
     /**
-     * Control whether the text should truncate or not.
-     * Setting as `true` will make the text truncate on a single line.
-     * Setting as `{ lines: number }` will make the text truncate on a multiple lines.
+     * Whether an escape key press would close the Dropdown or not.
+     * @see {@link PopoverProps#closeOnEscape}
      */
-    truncate?: boolean | {
-        lines: number;
-    };
+    closeOnEscape?: boolean;
     /**
-     * Prevents text to wrap on multiple lines
-     * (automatically activated when single line text truncate is activated).
+     * Manage dropdown width:
+     *   - `maxWidth`: dropdown not bigger than anchor
+     *   - `minWidth` or `true`: dropdown not smaller than anchor
+     *   - `width`: dropdown equal to the anchor.
+     * @see {@link PopoverProps#fitToAnchorWidth}
      */
-    noWrap?: boolean;
+    fitToAnchorWidth?: PopoverProps['fitToAnchorWidth'];
     /**
-     * WhiteSpace variant
-     * Ignored when `noWrap` is set to true
-     * Ignored when `truncate` is set to true or lines: 1
-     * */
-    whiteSpace?: WhiteSpace;
+     * Whether the dropdown should shrink to fit within the viewport height or not.
+     * @see {@link PopoverProps#fitWithinViewportHeight}
+     */
+    fitWithinViewportHeight?: boolean;
     /**
-     * Children
+     * Whether the dropdown should be displayed or not. Useful to control the Dropdown from outside the component.
+     * @see {@link PopoverProps#isOpen}
      */
-    children?: JSXElement;
-    /** list of styles to apply */
-    style?: CSSProperties;
+    isOpen: boolean;
+    /**
+     * Offset applied to the Dropdown position.
+     * @see {@link PopoverProps#offset}
+     */
+    offset?: Offset;
+    /**
+     * Preferred Dropdown placement against the anchor element.
+     * @see {@link PopoverProps#placement}
+     */
+    placement?: Placement;
+    /** Whether the focus should be set on the list when the dropdown is open or not. */
+    shouldFocusOnOpen?: boolean;
+    /** Whether the dropdown should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
+    usePortal?: boolean;
+    /** Whether the focus should go back on the anchor when dropdown closes and focus is within. */
+    focusAnchorOnClose?: boolean;
+    /**
+     * Z-axis position.
+     * @see {@link PopoverProps#zIndex}
+     */
+    zIndex?: number;
+    /**
+     * On close callback.
+     * @see {@link PopoverProps#onClose}
+     */
+    onClose?(): void;
+    /** On scroll end callback. */
+    onInfiniteScroll?(): void;
+}
+/**
+ * Dropdown component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const Dropdown: Comp<DropdownProps, HTMLDivElement>;
+
+/**
+ * Defines the props of the component.
+ */
+interface ExpansionPanelProps extends GenericProps$1, HasCloseMode$1, HasTheme$1 {
+    /** Whether the expansion panel has a background. */
+    hasBackground?: boolean;
+    /** Whether the header has a divider. */
+    hasHeaderDivider?: boolean;
+    /** Whether the component is open or not. */
+    isOpen?: boolean;
+    /** Label text (overwritten if a `<header>` is provided in the children). */
+    label?: string;
+    /** On open callback. */
+    onOpen?: (event: React__default.MouseEvent) => void;
+    /** On close callback. */
+    onClose?: (event: React__default.MouseEvent) => void;
+    /** Props to pass to the toggle button (minus those already set by the ExpansionPanel props). */
+    toggleButtonProps: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis' | 'color'>;
+    /** On toggle open or close callback. */
+    onToggleOpen?(shouldOpen: boolean, event: React__default.MouseEvent): void;
+    /** Children */
+    children?: React__default.ReactNode;
 }
+/**
+ * ExpansionPanel component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const ExpansionPanel: Comp<ExpansionPanelProps, HTMLDivElement>;
 
 interface FlagProps$1 extends HasClassName, HasTheme {
     /** Color of the component. */
@@ -1696,7 +2579,7 @@ declare const GenericBlockGapSize: Pick<{
     readonly medium: "medium";
     readonly big: "big";
     readonly huge: "huge";
-}, "tiny" | "regular" | "medium" | "big" | "huge">;
+}, "big" | "medium" | "tiny" | "regular" | "huge">;
 type GenericBlockGapSize = ValueOf<typeof GenericBlockGapSize>;
 
 interface GenericBlockProps$1 extends FlexBoxProps$1 {
@@ -1926,7 +2809,7 @@ interface GridColumnProps extends GenericProps$1, ReactToJSX<GridColumnProps$1>
  */
 declare const GridColumn: Comp<GridColumnProps, HTMLElement>;
 
-declare const ICON_SIZES: ("xxs" | "xs" | "s" | "m" | "l" | "xl" | "xxl")[];
+declare const ICON_SIZES: ("m" | "s" | "xxs" | "xs" | "l" | "xl" | "xxl")[];
 
 type IconSizes = (typeof ICON_SIZES)[number];
 /**
@@ -2307,19 +3190,6 @@ interface InputHelperProps extends ReactToJSX<InputHelperProps$1>, GenericProps$
  */
 declare const InputHelper: Comp<InputHelperProps, HTMLParagraphElement>;
 
-interface InputLabelProps$1 extends HasClassName, HasTheme {
-    /** Typography variant. */
-    typography?: Typography;
-    /** Label content. */
-    children: JSXElement;
-    /** Native htmlFor property. */
-    htmlFor: string;
-    /** Whether the component is required or not. */
-    isRequired?: boolean;
-    /** ref to the root element */
-    ref?: CommonRef;
-}
-
 interface InputLabelProps extends ReactToJSX<InputLabelProps$1>, GenericProps$1 {
 }
 /**
@@ -2360,286 +3230,90 @@ interface LightboxProps extends GenericProps$1, HasTheme$1, Pick<AriaAttributes$
  * @return React element.
  */
 declare const Lightbox: Comp<LightboxProps, HTMLDivElement>;
-
-/**
- * Defines the props of the component.
- */
-interface LinkProps$1 extends HasClassName, HasAriaDisabled, HasDisabled {
-    /** Children content */
-    children?: JSXElement;
-    /** Color variant. */
-    color?: ColorWithVariants;
-    /** Lightened or darkened variant of the selected icon color. */
-    colorVariant?: ColorVariant;
-    /** Link href. */
-    href?: string;
-    /** Whether the component is disabled or not. */
-    isDisabled?: boolean;
-    /** Custom element/component for the link. */
-    linkAs?: string | any;
-    /** Click handler (framework wrappers convert onClick to handleClick). */
-    handleClick?: (event: any) => void;
-    /** Link target. */
-    target?: string;
-    /** Typography variant. */
-    typography?: Typography;
-    /** Element ref. */
-    ref?: CommonRef;
-}
-
-/**
- * Defines the props of the component.
- */
-interface LinkProps extends GenericProps$1, ReactToJSX<LinkProps$1> {
-    /**
-     * Left icon (SVG path).
-     * @deprecated Instead, simply nest `<Icon />` in the children
-     */
-    leftIcon?: string;
-    /** Click handler. */
-    onClick?: (event: React.MouseEvent) => void;
-    /**
-     * Right icon (SVG path).
-     * @deprecated Instead, simply nest `<Icon />` in the children
-     */
-    rightIcon?: string;
-    /** Children */
-    children?: React.ReactNode;
-}
-/**
- * Link component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const Link: Comp<LinkProps, HTMLButtonElement | HTMLAnchorElement>;
-
-/**
- * Defines the props of the component.
- */
-interface LinkPreviewProps extends GenericProps$1, HasTheme$1 {
-    /** Description. */
-    description?: string;
-    /** Link URL. */
-    link: string;
-    /** Custom react component for the link (can be used to inject react router Link). */
-    linkAs?: 'a' | any;
-    /** Props to pass to the link (minus those already set by the LinkPreview props). */
-    linkProps?: Omit<LinkProps, 'color' | 'colorVariant' | 'href' | 'target'>;
-    /** Size variant. */
-    size?: Extract<Size$1, 'regular' | 'big'>;
-    /** Thumbnail for the link preview. */
-    thumbnailProps?: ThumbnailProps;
-    /** Title. */
-    title?: string;
-    /** Customize the title heading tag. */
-    titleHeading?: HeadingElement$1;
-}
-/**
- * LinkPreview component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const LinkPreview: Comp<LinkPreviewProps, HTMLDivElement>;
-
-type Listener = (evt: KeyboardEvent) => void;
-interface UseKeyboardListNavigationType {
-    /** the current active index */
-    activeItemIndex: number;
-    /** callback to be used when a key is pressed. usually used with the native prop `onKeyDown` */
-    onKeyboardNavigation: Listener;
-    /** Resets the active index to the initial state */
-    resetActiveIndex(): void;
-    /** Sets the active index to a given value */
-    setActiveItemIndex(value: SetStateAction<number>): void;
-}
-type useKeyboardListNavigationType = <I>(items: I[], ref: RefObject<HTMLElement>, onListItemSelected: (itemSelected: I) => void, onListItemNavigated?: (itemSelected: I) => void, onEnterPressed?: (itemSelected: string) => void, onBackspacePressed?: Listener, keepFocusAfterSelection?: boolean, initialIndex?: number, preventTabOnEnteredValue?: boolean) => UseKeyboardListNavigationType;
-
-/** List item padding size. */
-type ListItemPadding = Extract<Size, 'big' | 'huge'>;
-/**
- * Defines the props of the component.
- */
-interface ListProps$1 extends HasClassName {
-    /** List content (should be ListItem, ListDivider, etc.). */
-    children?: JSXElement;
-    /** Item padding size. */
-    itemPadding?: ListItemPadding;
-    /** ref to the root element */
-    ref?: CommonRef;
-}
-
-/**
- * Defines the props of the component.
- */
-interface ListProps extends GenericProps$1, ReactToJSX<ListProps$1> {
-    /**
-     * Whether the list items are clickable.
-     * @deprecated not needed anymore.
-     */
-    isClickable?: boolean;
-    /** Tab index of the list. */
-    tabIndex?: number;
-    /** @deprecated not supported since v4.0.0 */
-    onListItemSelected?(key: Key, index: number, evt: SyntheticEvent): void;
-}
-declare const List: Comp<ListProps, HTMLUListElement> & {
-    useKeyboardListNavigation: useKeyboardListNavigationType;
-};
-
-/**
- * ListItemAction props.
- */
-type ListItemActionProps<E extends ClickableElement = 'button'> = RawClickableProps<E> & HasClassName;
-
-/** ListItem size variants. */
-type ListItemSize = Extract<Size, 'tiny' | 'regular' | 'big' | 'huge'>;
-/**
- * Defines the props of the component.
- */
-interface ListItemProps$1 extends HasClassName, HasAriaDisabled {
-    /** A component to be rendered after the content. */
-    after?: JSXElement;
-    /** A component to be rendered before the content. */
-    before?: JSXElement;
-    /** Content. */
-    children?: JSXElement;
-    /** Whether the list item should be highlighted or not. */
-    isHighlighted?: boolean;
-    /** Whether the component is selected or not. */
-    isSelected?: boolean;
-    /** Whether link/button is disabled or not. */
-    isDisabled?: boolean;
-    /** Custom component for the link (can be used to inject router Link). */
-    linkAs?: 'a' | any;
-    /** Props that will be passed on to the Link. */
-    linkProps?: GenericProps;
-    /** Reference to the link element. */
-    linkRef?: CommonRef;
-    /** Size variant. */
-    size?: ListItemSize;
-    /** ref to the root <li> element */
-    ref?: CommonRef;
-    /** On click callback. */
-    handleClick?: (event: any) => void;
-}
-type ListItemPropsToOverride = 'after' | 'before' | 'children' | 'handleClick';
-
-/**
- * Defines the props of the component.
- */
-interface ListItemProps extends GenericProps$1, HasAriaDisabled$1, ReactToJSX<ListItemProps$1, ListItemPropsToOverride> {
-    /** A component to be rendered after the content. */
-    after?: ReactNode;
-    /** A component to be rendered before the content. */
-    before?: ReactNode;
-    /** Content. */
-    children: string | ReactNode;
-    /** Reference to the <li> element. */
-    listItemRef?: Ref<HTMLLIElement>;
-    /** Reference to the link element. */
-    linkRef?: Ref<HTMLAnchorElement>;
-    /** On click callback. */
-    onClick?(event: SyntheticEvent): void;
-    /** @alias onClick */
-    onItemSelected?(evt: SyntheticEvent): void;
-}
-/**
- * ListItem component with Action sub-component.
- */
-declare const ListItem: Comp<ListItemProps, HTMLLIElement> & {
-    /** Sub-component that renders the default action (button or link) for the action area pattern. */
-    Action: (<E extends React$1.ElementType = "button">(props: React$1.PropsWithoutRef<React$1.ComponentProps<E>> & {
-        as?: E | undefined;
-    } & GenericProps$1 & ReactToJSX<ListItemActionProps, "children"> & _lumx_core_js_types.HasRequiredLinkHref<E> & {
-        children: ReactNode;
-        onClick?(evt: SyntheticEvent): void;
-    } & React$1.ComponentProps<E> & {
-        ref?: ComponentRef<E> | undefined;
-    }) => React.JSX.Element) & {
-        displayName: string;
-        className: string;
-        defaultProps: Partial<ListItemActionProps<"button">>;
-    };
-};
-
-/**
- * Defines the props of the component.
- */
-interface ListDividerProps$1 extends HasClassName {
-    /** ref to the root element */
-    ref?: CommonRef;
-}
-
-/**
- * Defines the props of the component.
- */
-type ListDividerProps = GenericProps$1 & ReactToJSX<ListDividerProps$1>;
-/**
- * ListDivider component.
- * Purely decorative, consider a `ListSection` with label for a better list structure.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const ListDivider: Comp<ListDividerProps, HTMLLIElement>;
-
-/**
- * Defines the props of the component.
- */
-interface ListSectionProps$1 extends HasClassName {
-    /** Section label displayed as the group title. */
-    label?: string;
-    /** Section icon */
-    icon?: string;
-    /** List items (should be ListItem, ListDivider, etc.). */
-    children: JSXElement;
-    /** Items wrapper forwarded props */
-    itemsWrapperProps?: Record<string, any>;
-    /** ID for the label element (used for aria-labelledby). */
-    id: string;
-    /** ref to the root element */
+
+/**
+ * Defines the props of the component.
+ */
+interface LinkProps$1 extends HasClassName, HasAriaDisabled, HasDisabled {
+    /** Children content */
+    children?: JSXElement;
+    /** Color variant. */
+    color?: ColorWithVariants;
+    /** Lightened or darkened variant of the selected icon color. */
+    colorVariant?: ColorVariant;
+    /** Link href. */
+    href?: string;
+    /** Whether the component is disabled or not. */
+    isDisabled?: boolean;
+    /** Custom element/component for the link. */
+    linkAs?: string | any;
+    /** Click handler (framework wrappers convert onClick to handleClick). */
+    handleClick?: (event: any) => void;
+    /** Link target. */
+    target?: string;
+    /** Typography variant. */
+    typography?: Typography;
+    /** Element ref. */
     ref?: CommonRef;
-    /** Text component to use for rendering the label */
-    Text: (props: TextProps$1 & Record<string, any>) => any;
 }
 
 /**
  * Defines the props of the component.
  */
-interface ListSectionProps extends GenericProps$1, ReactToJSX<ListSectionProps$1, 'children' | 'id' | 'Text'> {
-    /** Section content */
-    children: ReactNode;
+interface LinkProps extends GenericProps$1, ReactToJSX<LinkProps$1> {
+    /**
+     * Left icon (SVG path).
+     * @deprecated Instead, simply nest `<Icon />` in the children
+     */
+    leftIcon?: string;
+    /** Click handler. */
+    onClick?: (event: React.MouseEvent) => void;
+    /**
+     * Right icon (SVG path).
+     * @deprecated Instead, simply nest `<Icon />` in the children
+     */
+    rightIcon?: string;
+    /** Children */
+    children?: React.ReactNode;
 }
 /**
- * ListSection component.
+ * Link component.
  *
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const ListSection: Comp<ListSectionProps, HTMLLIElement>;
+declare const Link: Comp<LinkProps, HTMLButtonElement | HTMLAnchorElement>;
 
 /**
  * Defines the props of the component.
  */
-interface ListSubheaderProps extends GenericProps$1 {
-    /** Content. */
-    children: string | ReactNode;
+interface LinkPreviewProps extends GenericProps$1, HasTheme$1 {
+    /** Description. */
+    description?: string;
+    /** Link URL. */
+    link: string;
+    /** Custom react component for the link (can be used to inject react router Link). */
+    linkAs?: 'a' | any;
+    /** Props to pass to the link (minus those already set by the LinkPreview props). */
+    linkProps?: Omit<LinkProps, 'color' | 'colorVariant' | 'href' | 'target'>;
+    /** Size variant. */
+    size?: Extract<Size$1, 'regular' | 'big'>;
+    /** Thumbnail for the link preview. */
+    thumbnailProps?: ThumbnailProps;
+    /** Title. */
+    title?: string;
+    /** Customize the title heading tag. */
+    titleHeading?: HeadingElement$1;
 }
 /**
- * ListSubheader component.
- * @deprecated ListSubheader produces improper list structure. use ListSection instead.
+ * LinkPreview component.
  *
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
  */
-declare const ListSubheader: Comp<ListSubheaderProps, HTMLLIElement>;
+declare const LinkPreview: Comp<LinkPreviewProps, HTMLDivElement>;
 
 /**
  * Defines the props of the component.
@@ -3858,6 +4532,10 @@ interface TabProps$1 extends HasClassName {
     changeToTab?: () => void;
     /** Tab index for roving tabindex management. */
     tabIndex?: number;
+    /** Name of the prop used to set tab index (framework-dependent). */
+    tabIndexProp?: string;
+    /** Name of the prop used to attach the keypress event (framework-dependent). */
+    keyPressProp?: string;
     /** ID applied to the tab button element (for aria-labelledby on the panel). */
     tabId?: string;
     /** ID of the associated tab panel (for aria-controls). */
@@ -3869,7 +4547,7 @@ interface TabProps$1 extends HasClassName {
     /** Forward ref to the underlying button element. */
     ref?: CommonRef;
 }
-type TabPropsToOverride = 'isAnyDisabled' | 'shouldActivateOnFocus' | 'changeToTab' | 'tabIndex' | 'tabId' | 'tabPanelId' | 'Icon' | 'Text';
+type TabPropsToOverride = 'isAnyDisabled' | 'shouldActivateOnFocus' | 'changeToTab' | 'tabIndex' | 'tabIndexProp' | 'keyPressProp' | 'tabId' | 'tabPanelId' | 'Icon' | 'Text';
 
 /**
  * Defines the props of the component.
@@ -3915,10 +4593,12 @@ interface TabPanelProps$1 extends HasClassName {
     tabId?: string;
     /** ID of the associated tab panel (for aria-controls). */
     id?: string;
+    /** Name of the prop used to set tab index (framework-dependent). */
+    tabIndexProp?: string;
     /** Forward ref to the underlying button element. */
     ref?: CommonRef;
 }
-type TabPanelPropsToOverride = 'tabId';
+type TabPanelPropsToOverride = 'tabId' | 'isLazy' | 'tabIndexProp';
 
 /**
  * Defines the props of the component.
@@ -3949,149 +4629,6 @@ interface TextProps extends ReactToJSX<TextProps$1>, GenericProps$1 {
  */
 declare const Text: Comp<TextProps, HTMLElement>;
 
-/**
- * Defines the props of the component.
- */
-interface TextFieldProps$1 extends HasClassName, HasTheme, HasAriaDisabled, HasDisabled {
-    /** Chip Group to be rendered before the main text input. */
-    chips?: JSXElement;
-    /** Props to pass to the clear button (minus those already set by the TextField props). If not specified, the button won't be displayed. */
-    clearButtonProps?: GenericProps;
-    /** Error message. */
-    error?: string | JSXElement;
-    /** Whether we force the focus style or not. */
-    forceFocusStyle?: boolean;
-    /** Whether the text field is displayed with error style or not. */
-    hasError?: boolean;
-    /** Additional element to put at the end of the text field. */
-    afterElement?: JSXElement;
-    /** Helper text. */
-    helper?: string | JSXElement;
-    /** Icon (SVG path). */
-    icon?: string;
-    /** Native input id property (generated if not provided to link the label element). */
-    id?: string;
-    /** Generated helper id for accessibility attributes. */
-    helperId?: string;
-    /** Generated error id for accessibility attributes. */
-    errorId?: string;
-    /** Whether the component is required or not. */
-    isRequired?: boolean;
-    /** Whether the text field is displayed with valid style or not. */
-    isValid?: boolean;
-    /** Label text. */
-    label?: string;
-    /** Additional label props. */
-    labelProps?: InputLabelProps$1;
-    /** Max string length the input accepts (constrains the input and displays a character counter). */
-    maxLength?: number;
-    /** Whether the text field is a textarea or an input. */
-    multiline?: boolean;
-    /** Placeholder text. */
-    placeholder?: string;
-    /** Reference to the wrapper. */
-    textFieldRef?: CommonRef;
-    /** Value. */
-    value?: string;
-    /** Whether any part is disabled. */
-    isAnyDisabled?: boolean;
-    /** The input element (input or textarea). */
-    input: JSXElement;
-    /** Whether the input is focused. */
-    isFocus?: boolean;
-    /** IconButton component. */
-    IconButton: (props: Record<string, any>) => any;
-    /** Ref to the component root. */
-    ref?: CommonRef;
-}
-type TextFieldPropsToOverride = 'input' | 'IconButton' | 'labelProps' | 'textFieldRef' | 'clearButtonProps' | 'helperId' | 'errorId' | 'isAnyDisabled' | 'isFocus';
-
-/**
- * Defines the props of the component.
- */
-interface TextFieldProps extends GenericProps$1, ReactToJSX<TextFieldProps$1, TextFieldPropsToOverride> {
-    /** Props to pass to the clear button (minus those already set by the TextField props). If not specified, the button won't be displayed. */
-    clearButtonProps?: Pick<IconButtonProps, 'label'> & Omit<IconButtonProps, 'label' | 'onClick' | 'icon' | 'emphasis'>;
-    /** Reference to the <input> or <textarea> element. */
-    inputRef?: Ref<HTMLInputElement | HTMLTextAreaElement>;
-    /** Additional label props. */
-    labelProps?: InputLabelProps;
-    /** Minimum number of rows displayed in multiline mode (requires `multiline` to be enabled). */
-    minimumRows?: number;
-    /** Native input name property. */
-    name?: string;
-    /** Reference to the wrapper. */
-    textFieldRef?: Ref<HTMLDivElement>;
-    /** Native input type (only when `multiline` is disabled). */
-    type?: React.ComponentProps<'input'>['type'];
-    /** On blur callback. */
-    onBlur?(event: React.FocusEvent): void;
-    /** On change callback. */
-    onChange(value: string, name?: string, event?: SyntheticEvent): void;
-    /** On clear callback. */
-    onClear?(event?: SyntheticEvent): void;
-    /** On focus callback. */
-    onFocus?(event: React.FocusEvent): void;
-}
-/**
- * TextField component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const TextField: Comp<TextFieldProps, HTMLDivElement>;
-
-/**
- * Defines the props of the component.
- */
-interface RawInputTextProps$1 extends HasTheme, HasClassName {
-    value?: string;
-    type?: HTMLInputTypeAttribute;
-    name?: string | undefined;
-    ref?: CommonRef;
-    handleChange?: (value: string, name?: string, event?: any) => void;
-}
-
-type NativeInputProps = Omit<ComponentProps<'input'>, 'value' | 'onChange'>;
-/**
- * Defines the props of the component.
- */
-interface RawInputTextProps extends NativeInputProps, ReactToJSX<RawInputTextProps$1> {
-    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
-}
-
-/**
- * Raw input text component
- * (input element without any decoration)
- */
-declare const RawInputText: Comp<RawInputTextProps, HTMLInputElement>;
-
-/**
- * Defines the props of the component.
- */
-interface RawInputTextareaProps$1 extends HasTheme, HasClassName {
-    value?: string;
-    rows?: number;
-    name?: string | undefined;
-    ref?: CommonRef;
-    handleChange?: (value: string, name?: string, event?: any) => void;
-}
-
-type NativeTextareaProps = Omit<ComponentProps<'textarea'>, 'value' | 'onChange'>;
-/**
- * Defines the props of the component.
- */
-interface RawInputTextareaProps extends NativeTextareaProps, ReactToJSX<RawInputTextareaProps$1, 'rows'> {
-    minimumRows?: number;
-    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
-}
-/**
- * Raw input text area component
- * (textarea element without any decoration)
- */
-declare const RawInputTextarea: Comp<Omit<RawInputTextareaProps, "type">, HTMLTextAreaElement>;
-
 declare const useFocusPointStyle: ({ image, aspectRatio, focusPoint, imgProps: { width, height } }: ThumbnailProps, element: HTMLImageElement | undefined, isLoaded: boolean) => CSSProperties;
 
 /**
@@ -4128,44 +4665,6 @@ interface ToolbarProps extends GenericProps$1, ReactToJSX<ToolbarProps$1> {
  */
 declare const Toolbar: Comp<ToolbarProps, HTMLDivElement>;
 
-declare const ARIA_LINK_MODES: readonly ["aria-describedby", "aria-labelledby"];
-
-/** Position of the tooltip relative to the anchor element. */
-type TooltipPlacement = 'top' | 'right' | 'bottom' | 'left';
-/**
- * Framework-agnostic tooltip props (shared between React and Vue wrappers).
- */
-interface TooltipProps$1 extends HasCloseMode {
-    /** Delay (in ms) before closing the tooltip. */
-    delay?: number;
-    /** Whether the tooltip is displayed even without the mouse hovering the anchor. */
-    forceOpen?: boolean;
-    /** Label text. */
-    label?: string | null | false;
-    /** Placement of the tooltip relative to the anchor. */
-    placement?: TooltipPlacement;
-    /** Choose how the tooltip text should link to the anchor */
-    ariaLinkMode?: (typeof ARIA_LINK_MODES)[number];
-    /** Z-index for the tooltip */
-    zIndex?: number;
-}
-
-/**
- * Defines the props of the component.
- */
-interface TooltipProps extends GenericProps$1, TooltipProps$1 {
-    /** Anchor (element on which we activate the tooltip). */
-    children: ReactNode;
-}
-/**
- * Tooltip component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const Tooltip: Comp<TooltipProps, HTMLDivElement>;
-
 /**
  * Uploader variants.
  */
@@ -4386,5 +4885,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, ListSection, 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, TableCellVariant as TableCellVariantType, TableHeader, TableRow, Text, TextField, ThOrder, ThOrder as ThOrderType, ThemeProvider, Thumbnail, ThumbnailAspectRatio, ThumbnailObjectFit, ThumbnailVariant, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, 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, GenericBlockSectionProps, GridColumnGapSize, GridColumnProps, GridItemProps, GridProps, HeadingLevelProviderProps, HeadingProps, IconButtonProps, IconProps, IconSizes, ImageBlockProps, ImageBlockSize, ImageLightboxProps, InlineListProps, InputHelperProps, InputLabelProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, 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, 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, ListSection, 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, TableCellVariant as TableCellVariantType, TableHeader, TableRow, Text, TextField, ThOrder, ThOrder as ThOrderType, ThemeProvider, Thumbnail, ThumbnailAspectRatio, ThumbnailObjectFit, ThumbnailVariant, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, useFocusPointStyle, useHeadingLevel, useTheme };
+export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CheckboxProps, ChipGroupProps, ChipProps, ComboboxButtonProps, ComboboxInputProps, ComboboxListProps, ComboboxOptionActionProps, ComboboxOptionMoreInfoProps, ComboboxOptionProps, ComboboxOptionSkeletonProps, ComboboxPopoverComponentProps, ComboboxPopoverProps, ComboboxProviderProps, ComboboxSectionProps, ComboboxStateProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogProps, DialogSizes, DividerProps, DragHandleProps, DropdownProps, Elevation, ExpansionPanelProps, FlagProps, FlexBoxProps, FlexHorizontalAlignment, FlexVerticalAlignment, FocusPoint, GapSize, GenericBlockProps, GenericBlockSectionProps, GridColumnGapSize, GridColumnProps, GridItemProps, GridProps, HeadingLevelProviderProps, HeadingProps, IconButtonProps, IconProps, IconSizes, ImageBlockProps, ImageBlockSize, ImageLightboxProps, InlineListProps, InputHelperProps, InputLabelProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, 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 };