@lumx/react 4.25.1-alpha.3 → 4.25.1-alpha.5

package/index.d.ts

@@ -1369,115 +1369,6 @@ interface ListSubheaderProps extends GenericProps$1 {
  */
 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);
-    /**
-     * Message callback to display the number of available options.
-     * Called with the current visible option count and should return a human-readable string
-     * (e.g. `(n) => \`${n} result(s) available\``).
-     * Displayed when the combobox is open, not empty, not loading, and not in error.
-     * When omitted, no option count message is shown.
-     */
-    nbOptionMessage?: (optionsLength: number) => 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?: {
-        /**
-         * The number of currently visible options.
-         * Driven by the framework wrapper via the combobox handle's `optionsChange` event.
-         */
-        optionsLength?: number;
-        /**
-         * 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.
  */
@@ -1621,273 +1512,44 @@ interface PopoverProps extends GenericProps$1, ReactToJSX<PopoverProps$1, 'ancho
     children: ReactNode;
     /** Element to focus when opening the popover. */
     focusElement?: RefObject<HTMLElement>;
-    /** Reference to the parent element that triggered the popover (will get back focus on close or else fallback on the anchor element). */
-    parentElement?: RefObject<HTMLElement>;
-    /** Whether the popover should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
-    usePortal?: boolean;
-    /** The element in which the focus trap should be set. Default to popover. */
-    focusTrapZoneElement?: RefObject<HTMLElement>;
-    /** On close callback (on click away or Escape pressed). */
-    onClose?(): void;
-}
-/**
- * Popover component.
- *
- * @param  props Component props.
- * @param  ref   Component ref.
- * @return React element.
- */
-declare const Popover: Comp<PopoverProps, HTMLDivElement>;
-
-/**
- * Props for Popover that can be passed to Combobox.Popover.
- * Excludes isOpen, anchorRef, children, and onClose which are managed internally.
- */
-type ComboboxPopoverProps = Partial<Omit<PopoverProps, 'isOpen' | 'anchorRef' | 'children' | 'onClose'>>;
-/**
- * Props for the Combobox.Popover component.
- */
-interface ComboboxPopoverComponentProps extends ComboboxPopoverProps {
-    /** Content (should contain a Combobox.List). */
-    children: ReactNode;
-}
-
-/**
- * Defines the props for the core ComboboxOptionSkeleton template.
- */
-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;
-    /**
-     * Number of skeleton `<li>` elements to render.
-     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
-     * @default 1
-     */
-    count?: number;
-}
-/**
- * Props that React/Vue wrappers need to re-declare with framework-specific types.
- * Used by `ReactToJSX<ComboboxOptionSkeletonProps, ComboboxOptionSkeletonPropsToOverride>`.
- */
-type ComboboxOptionSkeletonPropsToOverride = 'before' | 'after' | 'children';
-
-/**
- * Props for Combobox.OptionSkeleton component.
- */
-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;
-}
-
-/**
- * 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';
-/**
- * Defines the props for the core ComboboxList template.
- */
-interface ComboboxListProps$1 extends HasClassName {
-    /** Accessible label for the listbox (required for accessibility). */
-    'aria-label'?: string;
-    /**
-     * Indicates that the listbox content is incomplete (loading).
-     * Set to `true` when skeleton placeholders are present and no real options have loaded yet.
-     * Omit (or set to `undefined`) when not loading — the attribute is not rendered as `"false"`.
-     */
-    'aria-busy'?: boolean;
-    /**
-     * Allow selecting several options (`aria-multiselectable`).
-     * Also read by `Combobox.SelectionIcon` to pick the checkbox icons.
-     */
-    'aria-multiselectable'?: boolean | 'true' | 'false';
-    /** Content (should be ComboboxOption elements). */
-    children?: JSXElement;
-    /** The ID of the listbox element. */
-    id?: string;
-    /** ref to the root element */
-    ref?: CommonRef;
-    /**
-     * The popup type. Set to "grid" when options have action buttons.
-     * @default 'listbox'
-     */
-    type?: ComboboxListType;
+    /** Reference to the parent element that triggered the popover (will get back focus on close or else fallback on the anchor element). */
+    parentElement?: RefObject<HTMLElement>;
+    /** Whether the popover should be rendered into a DOM node that exists outside the DOM hierarchy of the parent component. */
+    usePortal?: boolean;
+    /** The element in which the focus trap should be set. Default to popover. */
+    focusTrapZoneElement?: RefObject<HTMLElement>;
+    /** On close callback (on click away or Escape pressed). */
+    onClose?(): void;
 }
+/**
+ * Popover component.
+ *
+ * @param  props Component props.
+ * @param  ref   Component ref.
+ * @return React element.
+ */
+declare const Popover: Comp<PopoverProps, HTMLDivElement>;
 
-/** Props for Combobox.List component. */
-interface ComboboxListProps extends ReactToJSX<ComboboxListProps$1, 'aria-busy'> {
+/**
+ * Props for Popover that can be passed to Combobox.Popover.
+ * Excludes isOpen, anchorRef, children, and onClose which are managed internally.
+ */
+type ComboboxPopoverProps = Partial<Omit<PopoverProps, 'isOpen' | 'anchorRef' | 'children' | 'onClose'>>;
+/**
+ * Props for the Combobox.Popover component.
+ */
+interface ComboboxPopoverComponentProps extends ComboboxPopoverProps {
+    /** Content (should contain a Combobox.List). */
+    children: ReactNode;
 }
 
-/** 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;
+/** Map of listbox event names to their payload types. */
+interface ListboxEventMap {
     /** Fired when the active descendant changes (visual focus). Payload: the option id or null. */
     activeDescendantChange: string | null;
     /**
      * Fired when the visible option count changes.
-     * Payload: the number of visible options plus the current input value.
+     * Payload: the number of visible options plus the current input value (combobox only).
      */
     optionsChange: {
         optionsLength: number;
@@ -1895,14 +1557,20 @@ interface ComboboxEventMap {
     } | 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.
+     * between 0 and >0). Used for empty suppression in ListboxState 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).
+     * Fired after a 500ms debounce when loading persists while the options are visible,
+     * or immediately when loading ends. Used to control the loading message text in the live region.
      */
     loadingAnnouncement: boolean;
+    /**
+     * Fired when the options become visible or hidden (see {@link ListboxHandle.setOpen}).
+     * Inside a combobox, this is the combobox open state. A standalone listbox is open from
+     * creation and never closes. Replayed on subscribe while open.
+     */
+    open: boolean;
     /**
      * Fired only when this option becomes the active descendant (true)
      * or stops being the active descendant (false).
@@ -1910,6 +1578,7 @@ interface ComboboxEventMap {
      */
     [event: OptionActiveEvent]: boolean;
 }
+
 /** Callbacks provided by the consumer (React/Vue) to react to combobox state changes. */
 interface ComboboxCallbacks {
     /** Called when an option is selected (click or keyboard). */
@@ -2125,148 +1794,477 @@ interface RawInputTextProps$1 extends HasTheme, HasClassName {
     handleBlur?: (event?: any) => void;
 }
 
-type NativeInputProps = Omit<ComponentProps<'input'>, 'value' | 'onChange'>;
+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;
+    handleInput?: (value: string, name?: string, event?: any) => void;
+    handleFocus?: (event?: any) => void;
+    handleBlur?: (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, ReactToJSX<ComboboxInputProps$1, ComboboxInputPropsToOverride> {
+    /**
+     * 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'>>;
+}
+
+/**
+ * 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, ComboboxCallbacks {
+    /** 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;
+    /** Custom render button */
+    renderButton?: (buttonProps: Record<string, any>) => JSXElement;
+}
+
+/**
+ * Defines the props of the component.
+ */
+interface ComboboxProviderProps {
+    /** Combobox content. */
+    children?: ReactNode;
+    /** Callback fired when the combobox open state changes. */
+    onOpen?: (isOpen: boolean) => void;
+}
+/**
+ * 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;
+}
+
+/**
+ * Hook to subscribe to a combobox event (`open`, `optionsChange`, `loadingChange`,
+ * `activeDescendantChange`, …). Must be used within a `Combobox.Provider`.
+ *
+ * The events are dispatched by the listbox handle of the combobox (see {@link useListboxEvent}).
+ */
+declare function useComboboxEvent<K extends keyof ListboxEventMap>(event: K, initialValue: ListboxEventMap[K]): ListboxEventMap[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>;
+
+/**
+ * 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 ListboxListType = 'listbox' | 'grid';
+/**
+ * Defines the props for the core ListboxList template.
+ */
+interface ListboxListProps$1 extends HasClassName {
+    /** Accessible label for the listbox (required for accessibility). */
+    'aria-label'?: string;
+    /**
+     * Indicates that the listbox content is incomplete (loading).
+     * Set to `true` when skeleton placeholders are present and no real options have loaded yet.
+     * Omit (or set to `undefined`) when not loading — the attribute is not rendered as `"false"`.
+     */
+    'aria-busy'?: boolean;
+    /**
+     * Allow selecting several options (`aria-multiselectable`).
+     * Also read by `Combobox.SelectionIcon` to pick the checkbox icons.
+     */
+    'aria-multiselectable'?: boolean | 'true' | 'false';
+    /** Content (should be ListboxOption elements). */
+    children?: JSXElement;
+    /** The ID of the listbox element. */
+    id?: string;
+    /** ref to the root element */
+    ref?: CommonRef;
+    /**
+     * The popup type. Set to "grid" when options have action buttons.
+     * @default 'listbox'
+     */
+    type?: ListboxListType;
+}
+
+/** Props of the list component (`Combobox.List` and `Listbox.List`). */
+interface ListboxListProps extends ReactToJSX<ListboxListProps$1, 'aria-busy'> {
+}
+
+/**
+ * Defines the props for the core ListboxOption template.
+ */
+interface ListboxOptionProps$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. ListboxOptionAction 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-listbox-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<ListboxOptionProps, ListboxOptionPropsToOverride>`.
+ */
+type ListboxOptionPropsToOverride = '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>;
+
 /**
- * Defines the props of the component.
+ * Props forwarded to the inner action element (button or link).
  */
-interface RawInputTextProps extends NativeInputProps, ReactToJSX<RawInputTextProps$1> {
-    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
+type ListboxOptionActionProps$1<E extends ElementType$1 = 'button'> = HasPolymorphicAs$1<E> & HasRequiredLinkHref$1<E>;
+/**
+ * Props for Combobox.Option component.
+ */
+interface ListboxOptionProps extends GenericProps$1, ReactToJSX<ListboxOptionProps$1, ListboxOptionPropsToOverride> {
+    /** 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?: ListboxOptionActionProps$1<any>;
 }
 
 /**
- * Raw input text component
- * (input element without any decoration)
+ * Combobox.OptionAction props.
+ *
+ * Polymorphic component — use `as` to render as a different element or component
+ * (e.g., `as={IconButton}`, `as={Button}`). Defaults to `'button'`.
  */
-declare const RawInputText: Comp<RawInputTextProps, HTMLInputElement>;
+type ListboxOptionActionProps<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;
+};
 
 /**
- * Defines the props of the component.
+ * Defines the props for the core ListboxOptionMoreInfo template.
  */
-interface RawInputTextareaProps$1 extends HasTheme, HasClassName {
-    value?: string;
-    rows?: number;
-    name?: string | undefined;
+interface ListboxOptionMoreInfoProps$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;
-    handleChange?: (value: string, name?: string, event?: any) => void;
-    handleInput?: (value: string, name?: string, event?: any) => void;
-    handleFocus?: (event?: any) => void;
-    handleBlur?: (event?: any) => void;
+    /** Mouse enter callback. */
+    onMouseEnter?(): void;
+    /** Mouse leave callback. */
+    onMouseLeave?(): void;
+    /** Props forwarded to the IconButton. */
+    buttonProps?: Record<string, any>;
 }
-
-type NativeTextareaProps = Omit<ComponentProps<'textarea'>, 'value' | 'onChange'>;
 /**
- * Defines the props of the component.
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
  */
-interface RawInputTextareaProps extends NativeTextareaProps, ReactToJSX<RawInputTextareaProps$1, 'rows'> {
-    minimumRows?: number;
-    onChange?: (value: string, name?: string, event?: SyntheticEvent) => void;
-}
+type ListboxOptionMoreInfoPropsToOverride = 'children' | 'popoverId' | 'isOpen';
+
 /**
- * Raw input text area component
- * (textarea element without any decoration)
+ * Props for Combobox.OptionMoreInfo component.
  */
-declare const RawInputTextarea: Comp<Omit<RawInputTextareaProps, "type">, HTMLTextAreaElement>;
+interface ListboxOptionMoreInfoProps extends ReactToJSX<ListboxOptionMoreInfoProps$1, ListboxOptionMoreInfoPropsToOverride> {
+    /** 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>;
+}
 
 /**
- * Props for Combobox.Input component.
- * Note: role, aria-autocomplete, aria-controls, aria-expanded are set internally and cannot be overridden.
+ * Defines the props for the core ListboxOptionSkeleton template.
  */
-interface ComboboxInputProps extends TextFieldProps, ReactToJSX<ComboboxInputProps$1, ComboboxInputPropsToOverride> {
+interface ListboxOptionSkeletonProps$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 ListboxOption's `description` prop). */
+    hasDescription?: boolean;
+    /** Override the default SkeletonTypography content entirely. */
+    children?: JSXElement;
+    /** ref to the root <li> element. */
+    ref?: CommonRef;
     /**
-     * Props for the toggle button.
-     * When provided, a chevron button will be rendered in the text field's afterElement
-     * to toggle the listbox visibility.
+     * Number of skeleton `<li>` elements to render.
+     * Each is an independent element with `:nth-child` width cycling applied by SCSS.
+     * @default 1
      */
-    toggleButtonProps?: Pick<IconButtonProps, 'label'> & Partial<Omit<IconButtonProps, 'label'>>;
+    count?: number;
 }
-
 /**
- * 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.
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ * Used by `ReactToJSX<ListboxOptionSkeletonProps, ListboxOptionSkeletonPropsToOverride>`.
  */
-type ComboboxButtonLabelDisplayMode = 'show-selection' | 'show-label' | 'show-tooltip';
+type ListboxOptionSkeletonPropsToOverride = 'before' | 'after' | 'children';
+
 /**
- * Defines the props for the core ComboboxButton template.
+ * Props for Combobox.OptionSkeleton component.
  */
-interface ComboboxButtonProps$1 extends HasClassName, ComboboxCallbacks {
-    /** 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;
-    /** Custom render button */
-    renderButton?: (buttonProps: Record<string, any>) => JSXElement;
+interface ListboxOptionSkeletonProps extends GenericProps$1, ReactToJSX<ListboxOptionSkeletonProps$1, ListboxOptionSkeletonPropsToOverride> {
+    /** 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;
 }
 
 /**
- * Defines the props of the component.
+ * Defines the props for the core ListboxSection template.
  */
-interface ComboboxProviderProps {
-    /** Combobox content. */
-    children?: ReactNode;
-    /** Callback fired when the combobox open state changes. */
-    onOpen?: (isOpen: boolean) => void;
+interface ListboxSectionProps$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 ListboxOption 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 (`ListboxState`) handles the loading announcement.
+     */
+    'aria-hidden'?: boolean;
 }
 /**
- * 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.
+ * Props that React/Vue wrappers need to re-declare with framework-specific types.
+ * Used by `ReactToJSX<ListboxSectionProps, ListboxSectionPropsToOverride>`.
  */
-declare function ComboboxProvider(props: ComboboxProviderProps): react_jsx_runtime.JSX.Element;
-declare namespace ComboboxProvider {
-    var displayName: string;
-}
+type ListboxSectionPropsToOverride = 'children';
 
 /**
- * Hook to subscribe to a combobox event via the handle's subscriber system.
- *
- * Uses `useSyncExternalStore` (shim, for React 17 support) reading the handle's synchronous
- * `getSnapshot` — the correct pattern for an external (non-React) store. It reads the current
- * value during commit, so a consumer doesn't miss changes that happened between its render and its
- * subscription (e.g. options registered by child effects before this consumer subscribed, since
- * `optionsChange` is not replayed on subscribe), and it is tearing-safe under concurrent rendering.
- *
- * The handle dispatches synchronously, so the store update fires within the triggering render/event
- * (inside React's `act` in tests) rather than a deferred microtask. Re-subscribes when the handle
- * changes (e.g. trigger mount/unmount).
+ * Props for Combobox.Section component.
  */
-declare function useComboboxEvent<K extends keyof ComboboxEventMap>(event: K, initialValue: ComboboxEventMap[K]): ComboboxEventMap[K];
+interface ListboxSectionProps extends GenericProps$1, ReactToJSX<ListboxSectionProps$1, ListboxSectionPropsToOverride> {
+    /** Section content (should be Combobox.Option elements). */
+    children: ReactNode;
+}
 
 /**
- * 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.
+ * Defines the props for the core ListboxState template.
  */
-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>;
+interface ListboxStateProps$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);
+    /**
+     * Message callback to display the number of available options.
+     * Called with the current visible option count and should return a human-readable string
+     * (e.g. `(n) => \`${n} result(s) available\``).
+     * Displayed when the combobox is open, not empty, not loading, and not in error.
+     * When omitted, no option count message is shown.
+     */
+    nbOptionMessage?: (optionsLength: number) => 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?: {
+        /**
+         * The number of currently visible options.
+         * Driven by the framework wrapper via the combobox handle's `optionsChange` event.
+         */
+        optionsLength?: number;
+        /**
+         * 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;
+    };
+}
 
 /**
- * Combobox.OptionAction props.
- *
- * Polymorphic component — use `as` to render as a different element or component
- * (e.g., `as={IconButton}`, `as={Button}`). Defaults to `'button'`.
+ * Props for Combobox.State component.
  */
-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). */
+interface ListboxStateProps extends ReactToJSX<ListboxStateProps$1, 'state'> {
+    /** Additional content rendered after the state message. */
     children?: ReactNode;
-    /** Whether the action is disabled. */
-    isDisabled?: boolean;
-    /** On click callback. */
-    onClick?(evt: SyntheticEvent): void;
-};
+}
 
 /**
  * Combobox compound component namespace.
@@ -2283,10 +2281,10 @@ declare const Combobox: {
     };
     /** 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>;
+    /** Listbox container linked to the combobox trigger (must be rendered inside `Combobox.Provider`). */
+    List: Comp<ListboxListProps, HTMLUListElement>;
     /** Selectable option item with filtering and keyboard navigation support. */
-    Option: Comp<ComboboxOptionProps, HTMLLIElement>;
+    Option: Comp<ListboxOptionProps, 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;
@@ -2298,19 +2296,19 @@ declare const Combobox: {
         ref?: ComponentRef<E> | undefined;
     }) => React.JSX.Element) & {
         displayName: string;
-        className: "lumx-combobox-option-action";
+        className: "lumx-listbox-option-action";
     };
     /** Info button on an option that shows a popover on hover or keyboard highlight. */
     OptionMoreInfo: {
-        (props: ComboboxOptionMoreInfoProps): react_jsx_runtime.JSX.Element;
+        (props: ListboxOptionMoreInfoProps): react_jsx_runtime.JSX.Element;
         displayName: string;
-        className: "lumx-combobox-option-more-info";
+        className: "lumx-listbox-option-more-info";
     };
     /** Loading placeholder skeleton(s) that auto-register loading state with the combobox handle. */
     OptionSkeleton: {
-        (props: ComboboxOptionSkeletonProps): react_jsx_runtime.JSX.Element;
+        (props: ListboxOptionSkeletonProps): react_jsx_runtime.JSX.Element;
         displayName: string;
-        className: "lumx-combobox-option-skeleton";
+        className: "lumx-listbox-option-skeleton";
     };
     /** Selection state icon (check circle / radio, or checkbox in multiple lists) for the `after` slot of an option. Reads the option `isSelected` and the list `aria-multiselectable`. */
     SelectionIcon: {
@@ -2324,12 +2322,12 @@ declare const Combobox: {
         className: "lumx-combobox-popover";
     };
     /** Labelled group of options that auto-hides when all its child options are filtered out. */
-    Section: Comp<ComboboxSectionProps, HTMLLIElement>;
+    Section: Comp<ListboxSectionProps, HTMLLIElement>;
     /** Displays empty, error, and loading state messages for the combobox list. */
     State: {
-        (props: ComboboxStateProps): react_jsx_runtime.JSX.Element;
+        (props: ListboxStateProps): react_jsx_runtime.JSX.Element;
         displayName: string;
-        className: "lumx-combobox-state";
+        className: "lumx-listbox-state";
     };
     /** Visual separator between option groups (alias for ListDivider). Purely decorative — invisible to screen readers. */
     Divider: Comp<ListDividerProps, HTMLLIElement>;
@@ -4324,12 +4322,6 @@ interface RenderOptionContext {
     isSelected: boolean;
     /** Resolved description string (from `getOptionDescription`), if any. Should be forwarded as `description`. */
     description?: string | null;
-    /**
-     * Selection state icon to render after the option label
-     * (single selection: check circle when selected, blank radio otherwise; multiple selection: checkbox).
-     * Should be forwarded as `after` (appended after any custom `after` content).
-     */
-    after?: JSXElement;
 }
 interface BaseSelectProps<O> {
     /** List of option objects. */
@@ -4498,6 +4490,8 @@ interface BaseSelectTextFieldWrapperProps<O> extends Pick<BaseSelectProps<O>, 'o
     maxLength?: number;
     /** Accessible label for the input element (overrides the visual label for screen readers). */
     ariaLabel?: string;
+    /** Additional props forwarded to the field label (e.g. `className: 'visually-hidden'`, `typography`). */
+    labelProps?: Partial<Omit<InputLabelProps$1, 'children' | 'htmlFor' | 'id'>>;
     /** Additional props forwarded to the Combobox.Input (and ultimately to TextField). */
     inputProps?: Record<string, any>;
     /** Props forwarded to the Combobox.Popover. */
@@ -4655,7 +4649,7 @@ declare const SelectButton: {
     displayName?: string;
 } & {
     /** Selectable option within the dropdown list. */
-    Option: Comp<ComboboxOptionProps, HTMLLIElement>;
+    Option: Comp<ListboxOptionProps, HTMLLIElement>;
 };
 
 interface BaseSelectTextFieldProps<O = any> extends BaseSelectTextFieldWrapperProps<O>, HasClassName$1 {
@@ -4738,20 +4732,20 @@ declare const SelectTextField: {
     displayName: string;
 } & {
     /** Selectable option within the dropdown list. */
-    Option: Comp<ComboboxOptionProps, HTMLLIElement>;
+    Option: Comp<ListboxOptionProps, HTMLLIElement>;
     /** Labelled group of options. */
-    Section: Comp<ComboboxSectionProps, HTMLLIElement>;
+    Section: Comp<ListboxSectionProps, HTMLLIElement>;
     /** Info icon on an option that reveals a popover with additional details. */
     OptionMoreInfo: {
-        (props: ComboboxOptionMoreInfoProps): react_jsx_runtime.JSX.Element;
+        (props: ListboxOptionMoreInfoProps): react_jsx_runtime.JSX.Element;
         displayName: string;
-        className: "lumx-combobox-option-more-info";
+        className: "lumx-listbox-option-more-info";
     };
     /** Skeleton loading placeholder for options being fetched. */
     OptionSkeleton: {
-        (props: ComboboxOptionSkeletonProps): react_jsx_runtime.JSX.Element;
+        (props: ListboxOptionSkeletonProps): react_jsx_runtime.JSX.Element;
         displayName: string;
-        className: "lumx-combobox-option-skeleton";
+        className: "lumx-listbox-option-skeleton";
     };
     /** Visual separator between option groups (alias for ListDivider). Purely decorative — invisible to screen readers. */
     Divider: Comp<ListDividerProps, HTMLLIElement>;
@@ -5700,14 +5694,14 @@ interface TimePickerFieldWrapperProps {
     /**
      * Callback to customize individual option props.
      * Called for each time option with the hour and minute.
-     * Return partial `ComboboxOptionProps` to override default option rendering
+     * Return partial `ListboxOptionProps` to override default option rendering
      * (e.g. `before`, `after`, `children`, `tooltipProps`, `actionProps`).
      * `isDisabled` is merged with the out-of-range state using `||`.
      */
     getOptionProps?: ({ hour, minute }: {
         hour: number;
         minute: number;
-    }) => Partial<ComboboxOptionProps$1>;
+    }) => Partial<ListboxOptionProps$1>;
 }
 /**
  * `SelectTextField` props managed internally by the `TimePickerField` wrappers
@@ -6000,4 +5994,4 @@ declare const ThemeProvider: React__default.FC<{
 declare function useTheme(): ThemeContextValue;
 
 export { AlertDialog, Autocomplete, AutocompleteMultiple, Avatar, Badge, BadgeWrapper, Button, ButtonEmphasis, ButtonGroup, CLASSNAME$2 as CLASSNAME, COMPONENT_NAME$2 as COMPONENT_NAME, Card, Checkbox, Chip, ChipGroup, Combobox, CommentBlock, CommentBlockVariant, DEFAULT_PROPS$1 as DEFAULT_PROPS, DatePicker, DatePickerControlled, DatePickerField, Dialog, DialogHeading, Divider, DragHandle, Dropdown, ExpansionPanel, Flag, FlexBox, GenericBlock, GenericBlockGapSize, Grid, GridColumn, GridItem, Heading, HeadingLevelProvider, Icon, IconButton, ImageBlock, ImageBlockCaptionPosition, ImageLightbox, InlineList, InputHelper, InputLabel, InputRequiredLegend, Lightbox, Link, LinkPreview, List, ListDivider, ListItem, ListSection, ListSubheader, MenuButton, ListDivider as MenuDivider, MenuItem, Message, Mosaic, Navigation, Notification, Placement, Popover, PopoverDialog, PostBlock, Progress, ProgressCircular, ProgressLinear, ProgressTracker, ProgressTrackerProvider, ProgressTrackerStep, ProgressTrackerStepPanel, ProgressVariant, RadioButton, RadioGroup, RawInputText, RawInputTextarea, Select, SelectButton, SelectMultiple, SelectMultipleField, SelectTextField, SelectVariant, SelectionChipGroup, SideNavigation, SideNavigationItem, SkeletonCircle, SkeletonRectangle, SkeletonRectangleVariant, SkeletonTypography, Slider, Slides, Slideshow, SlideshowControls, SlideshowItem, Switch, CLASSNAME as TIME_PICKER_FIELD_CLASSNAME, COMPONENT_NAME as TIME_PICKER_FIELD_COMPONENT_NAME, 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, TimePickerField, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, useFocusPointStyle, useHeadingLevel, useTheme };
-export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CardProps, CheckboxProps, ChipGroupProps, ChipProps, ComboboxButtonProps, ComboboxInputProps, ComboboxListProps, ComboboxOptionActionProps, ComboboxOptionMoreInfoProps, ComboboxOptionProps, ComboboxOptionSkeletonProps, ComboboxPopoverComponentProps, ComboboxPopoverProps, ComboboxProviderProps, ComboboxSectionProps, ComboboxStateProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogHeadingProps, 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, InputRequiredLegendProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, ListSubheaderProps, MarginAutoAlignment, MenuButtonProps, ListDividerProps as MenuDividerProps, MenuItemActionProps, MenuItemProps, MessageProps, MosaicProps, MultipleSelectButtonProps, MultipleSelectTextFieldProps, NavigationProps, NotificationProps, Offset, PopoverDialogProps, PopoverHeight, PopoverProps, PopoverWidth, PostBlockProps, ProgressCircularProps, ProgressCircularSize, ProgressLinearProps, ProgressProps, ProgressTrackerProps, ProgressTrackerProviderProps, ProgressTrackerStepPanelProps, ProgressTrackerStepProps, RadioButtonProps, RadioGroupProps, RawInputTextProps, RawInputTextareaProps, SelectButtonProps, SelectListStatus as SelectButtonStatus, SelectButtonTranslations, SelectListStatus, SelectMultipleProps, SelectProps, SelectTextFieldProps, SelectListStatus as SelectTextFieldStatus, SelectTextFieldTranslations, SelectionChipGroupProps, SideNavigationItemProps, SideNavigationProps, SingleSelectButtonProps, SingleSelectTextFieldProps, SkeletonCircleProps, SkeletonRectangleProps, SkeletonTypographyProps, SliderProps, SlidesProps, SlideshowControlsProps, SlideshowItemProps, SlideshowProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabProviderProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TextFieldProps, TextProps, ThumbnailProps, ThumbnailSize, TimePickerFieldProps, ToolbarProps, TooltipPlacement, TooltipProps, UploaderProps, UploaderSize, UserBlockProps, UserBlockSize };
+export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CardProps, CheckboxProps, ChipGroupProps, ChipProps, ComboboxButtonProps, ComboboxInputProps, ListboxListProps as ComboboxListProps, ListboxOptionActionProps as ComboboxOptionActionProps, ListboxOptionMoreInfoProps as ComboboxOptionMoreInfoProps, ListboxOptionProps as ComboboxOptionProps, ListboxOptionSkeletonProps as ComboboxOptionSkeletonProps, ComboboxPopoverComponentProps, ComboboxPopoverProps, ComboboxProviderProps, ListboxSectionProps as ComboboxSectionProps, ListboxStateProps as ComboboxStateProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogHeadingProps, 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, InputRequiredLegendProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, ListSubheaderProps, MarginAutoAlignment, MenuButtonProps, ListDividerProps as MenuDividerProps, MenuItemActionProps, MenuItemProps, MessageProps, MosaicProps, MultipleSelectButtonProps, MultipleSelectTextFieldProps, NavigationProps, NotificationProps, Offset, PopoverDialogProps, PopoverHeight, PopoverProps, PopoverWidth, PostBlockProps, ProgressCircularProps, ProgressCircularSize, ProgressLinearProps, ProgressProps, ProgressTrackerProps, ProgressTrackerProviderProps, ProgressTrackerStepPanelProps, ProgressTrackerStepProps, RadioButtonProps, RadioGroupProps, RawInputTextProps, RawInputTextareaProps, SelectButtonProps, SelectListStatus as SelectButtonStatus, SelectButtonTranslations, SelectListStatus, SelectMultipleProps, SelectProps, SelectTextFieldProps, SelectListStatus as SelectTextFieldStatus, SelectTextFieldTranslations, SelectionChipGroupProps, SideNavigationItemProps, SideNavigationProps, SingleSelectButtonProps, SingleSelectTextFieldProps, SkeletonCircleProps, SkeletonRectangleProps, SkeletonTypographyProps, SliderProps, SlidesProps, SlideshowControlsProps, SlideshowItemProps, SlideshowProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabProviderProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TextFieldProps, TextProps, ThumbnailProps, ThumbnailSize, TimePickerFieldProps, ToolbarProps, TooltipPlacement, TooltipProps, UploaderProps, UploaderSize, UserBlockProps, UserBlockSize };