@central-ui/react 0.0.0-stage → 0.1.0

package/dist/components/combobox/index.d.ts

@@ -0,0 +1,427 @@
+import { Combobox as BaseCombobox } from '@base-ui/react/combobox';
+import type { LucideProps } from 'lucide-react';
+import type { ComponentProps, ComponentPropsWithRef, ReactElement, ReactNode } from 'react';
+type StyleProps = {
+    /**
+     * Disables preset styling for this element.
+     * Rarely needed: prefer className for normal overrides. Use only when explicitly
+     * choosing to redesign this part, or when extensive overrides justify starting
+     * from an unstyled baseline instead of overriding the preset.
+     * Your className and core inline styles still apply.
+     * Does not disable other Combobox parts or the preset's global styles.
+     *
+     * @default false
+     */
+    disableStyle?: boolean;
+};
+/** Keep extra application data on items; callbacks preserve those fields. */
+export type ItemShape = {
+    /** Label used automatically for input display and built-in text filtering. */
+    label: string;
+    /** Unique identifier used for equality checks and form submission. */
+    value: string;
+};
+/** The items data defines grouping; the component does not group by a field. */
+export type GroupShape = {
+    /** Group heading. Use an empty string for an unlabeled group and omit GroupLabel. */
+    label: string;
+    /** Items belonging to this group. Keep this group wrapper even for a flat list. */
+    items: readonly ItemShape[];
+};
+/** Manually type a GroupsList callback argument with GroupType<typeof rootItems>, using the exact items variable passed to Root. Preserves custom fields. */
+export type GroupType<T extends readonly GroupShape[]> = T[number];
+/** Manually type an ItemsList callback argument with ItemType<typeof rootItems>, using the exact items variable passed to Root. Preserves custom fields. */
+export type ItemType<T extends readonly GroupShape[]> = GroupType<T>['items'][number];
+/** Manually type a ChipsList callback argument with ChipsType<typeof rootItems>, using the exact items variable passed to Root. Also useful for multiple-selection state. */
+export type ChipsType<T extends readonly GroupShape[]> = ItemType<T>[];
+export type RootProps<T extends readonly GroupShape[], Multiple extends boolean | undefined = false> = Omit<BaseCombobox.Root.Props<ItemType<T>, Multiple>, 'items' | 'filteredItems' | 'itemToStringLabel' | 'itemToStringValue' | 'isItemEqualToValue' | 'id'> & {
+    /** Input id, also used automatically by Label. Omit to generate a stable id. */
+    id?: BaseCombobox.Root.Props<ItemType<T>, Multiple>['id'];
+    /**
+     * Required source of truth for grouping. Prepare any grouping in your data before passing items.
+     * For a flat list, supply one group with label: '' and omit GroupLabel.
+     * Always keep Group around its ItemsList, regardless of whether it has a heading.
+     * Labels, text filtering, form values, and equality by item.value are built in.
+     */
+    items: T;
+    /**
+     * Optional externally filtered groups, with the same shape as items.
+     * Omit this to use built-in filtering. Supply it only when your application
+     * performs filtering itself, such as filtering results on a server.
+     */
+    filteredItems?: readonly GroupType<T>[];
+    /** Visual validation tone only; does not validate or change selection. @default 'neutral' */
+    tone?: 'neutral' | 'valid' | 'invalid';
+};
+/**
+ * Searchable selection using Base UI's built-in filtering and keyboard handling.
+ * Does not render an element. Keep all parts inside Root.
+ * Supply grouped items even for a visually flat list: one unlabeled Group is flat.
+ * IMPORTANT: children callbacks do not infer your data shape from the surrounding Root.
+ * Manually annotate their data arguments with Combobox.GroupType, Combobox.ItemType,
+ * or Combobox.ChipsType. Pass typeof the SAME items variable supplied to Root;
+ * do not use typeof a single group's items or an unrelated data array.
+ * Use Input directly inside InputGroup for the usual input composition.
+ * To display multiple selections as chips, replace that Input with ChipsList
+ * containing chips followed by one Input; do not keep a second Input beside ChipsList.
+ * Container is optional when you supply your own layout. The popup nesting stays the same.
+ * Examples below reuse the cities and groups from the first example.
+ *
+ * To virtualize, import useVirtualizedCombobox from '@central-ui/react'.
+ * See the hook's types and documentation for configuration and integration examples.
+ *
+ * @example Complete grouped composition
+ * import { Combobox } from '@central-ui/react'
+ *
+ * const cities = [
+ *   { value: 'city_1', label: 'Casablanca', country: 'Morocco', population: 3359818 },
+ *   { value: 'city_2', label: 'Rabat', country: 'Morocco', population: 580000 },
+ *   { value: 'city_3', label: 'Paris', country: 'France', population: 2102650 },
+ * ]
+ * // Prepare groups in your data; there is no groupBy prop.
+ * const groups = [
+ *   { label: 'Morocco', items: cities.filter((city) => city.country === 'Morocco') },
+ *   { label: 'France', items: cities.filter((city) => city.country === 'France') },
+ * ]
+ * // Callback annotations below use typeof groups because Root receives items={groups}.
+ *
+ * function CityCombobox() {
+ *   return (
+ *     <Combobox.Root items={groups}>
+ *       <Combobox.Container>
+ *         <Combobox.Label>City</Combobox.Label>
+ *         <Combobox.InputGroup>
+ *           <Combobox.Input placeholder="Search cities" />
+ *           <Combobox.Addon>
+ *             <Combobox.AddonOpenButton aria-label="Show cities">
+ *               <Combobox.AddonOpenButtonIcon />
+ *             </Combobox.AddonOpenButton>
+ *             <Combobox.AddonClearButton aria-label="Clear city">
+ *               <Combobox.AddonClearButtonIcon />
+ *             </Combobox.AddonClearButton>
+ *           </Combobox.Addon>
+ *         </Combobox.InputGroup>
+ *         <Combobox.Popup>
+ *           <Combobox.Empty // Required: keep mounted; contents show only for no matches.
+ *           >
+ *             <Combobox.EmptyText>No cities found.</Combobox.EmptyText>
+ *           </Combobox.Empty>
+ *           <Combobox.ScrollArea // Required: provides listbox semantics and keyboard handling.
+ *           >
+ *             <Combobox.GroupsList // Required: renders the filtered groups automatically.
+ *             >
+ *               {(group: Combobox.GroupType<typeof groups>, groupIndex) => (
+ *                 <Combobox.Group
+ *                   key={groupIndex}
+ *                   items={group.items} // Required even without a heading.
+ *                 >
+ *                   <Combobox.GroupLabel // Optional: display the group label; omit for a flat list.
+ *                   >
+ *                     {group.label}
+ *                   </Combobox.GroupLabel>
+ *                   <Combobox.ItemsList // Required: renders this group's filtered items.
+ *                   >
+ *                     {(city: Combobox.ItemType<typeof groups>) => (
+ *                       <Combobox.Item
+ *                         key={city.value}
+ *                         value={city} // Required: pass the complete item object.
+ *                       >
+ *                         <Combobox.ItemText>{city.label}</Combobox.ItemText>
+ *                         <Combobox.ItemIndicator // Built-in checkmark; no children needed.
+ *                         />
+ *                       </Combobox.Item>
+ *                     )}
+ *                   </Combobox.ItemsList>
+ *                 </Combobox.Group>
+ *               )}
+ *             </Combobox.GroupsList>
+ *           </Combobox.ScrollArea>
+ *         </Combobox.Popup>
+ *       </Combobox.Container>
+ *     </Combobox.Root>
+ *   )
+ * }
+ *
+ * @example Flat data uses the same composition
+ * // Keep Group and ItemsList; omit only GroupLabel in the composition above.
+ * ;<Combobox.Root items={[{ label: '', items: cities }]}>
+ *   {
+ *     // Rest of components here
+ *   }
+ * </Combobox.Root>
+ *
+ * @example Controlled single selection
+ * import { useState } from 'react'
+ * function ControlledCityCombobox() {
+ *   const [city, setCity] = useState<Combobox.ItemType<typeof groups> | null>(null)
+ *   return (
+ *     <Combobox.Root items={groups} value={city} onValueChange={setCity}>
+ *       {
+ *         // Rest of components here
+ *       }
+ *     </Combobox.Root>
+ *   )
+ * }
+ *
+ * @example Controlled multiple selection
+ * function MultipleCityCombobox() {
+ *   const [selectedCities, setSelectedCities] = useState<Combobox.ChipsType<typeof groups>>(
+ *     [],
+ *   )
+ *   return (
+ *     <Combobox.Root
+ *       items={groups}
+ *       multiple
+ *       value={selectedCities}
+ *       onValueChange={setSelectedCities}
+ *     >
+ *       {
+ *         // Rest of components here
+ *       }
+ *     </Combobox.Root>
+ *   )
+ * }
+ *
+ * @example Optional loading message for asynchronous items
+ * // Inside Popup, below Empty and above ScrollArea. isLoading comes from your request state.
+ * // Unlike Empty, Loading does not detect requests: you control its contents.
+ * // Keep Loading mounted so screen readers can announce changes.
+ * // Omit Loading entirely when items are not fetched asynchronously.
+ * ;<Combobox.Loading>
+ *   {isLoading && (
+ *     <>
+ *       <Combobox.LoadingIcon />
+ *       <Combobox.LoadingText>Loading cities…</Combobox.LoadingText>
+ *     </>
+ *   )}
+ * </Combobox.Loading>
+ *
+ * @example Style only one part yourself
+ * // Other parts keep the imported preset. Core inline styles are preserved.
+ * ;<Combobox.AddonOpenButton
+ *   disableStyle
+ *   className="rounded-full bg-blue-600 p-2"
+ *   aria-label="Show cities"
+ * >
+ *   <Combobox.AddonOpenButtonIcon />
+ * </Combobox.AddonOpenButton>
+ */
+export declare function Root<T extends readonly GroupShape[], Multiple extends boolean | undefined = false>({ children, id, tone, open, defaultOpen, onOpenChange, onItemHighlighted, ...props }: RootProps<T, Multiple>): import("react").JSX.Element;
+/** Use for the standard stacked layout, or omit when supplying your own layout. */
+export declare const Container: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Labels the input automatically using Root's id. Supply the visible label as children; no htmlFor needed. */
+export declare const Label: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, "htmlFor"> & StyleProps, "ref"> & import("react").RefAttributes<HTMLLabelElement>>;
+/** Search input with built-in filtering and selected-label display. Its id is managed by Root. Inside ChipsList, the preset automatically uses the compact chip-input sizing. */
+export declare const Input: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").AutocompleteInputProps, "className" | "id"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
+export type ChipsListProps<Item extends ItemShape = ItemShape> = Omit<ComponentPropsWithRef<typeof BaseCombobox.Chips>, 'children' | 'className'> & {
+    className?: string;
+    /**
+     * Keep Input after the chips so keyboard navigation can move between them.
+     * IMPORTANT: manually annotate selected as Combobox.ChipsType<typeof rootItems>,
+     * where rootItems is the exact items variable passed to Root; the surrounding
+     * Root does not infer this callback's data shape.
+     */
+    children: ReactNode | ((selected: Item[]) => ReactNode);
+} & StyleProps;
+/**
+ * Selected-item chips inside InputGroup for multiple selection.
+ * Its children callback supplies selected item objects automatically.
+ * Manually annotate selected with Combobox.ChipsType<typeof groups> when Root
+ * receives items={groups}; the data shape is not inferred from the surrounding Root.
+ * Keep Input inside ChipsList, after the chips, for keyboard chip navigation.
+ *
+ * @example Chips composition inside a multiple Root
+ * ;<Combobox.InputGroup>
+ *   <Combobox.ChipsList>
+ *     {(selected: Combobox.ChipsType<typeof groups>) => (
+ *       <>
+ *         {selected.map((city) => (
+ *           <Combobox.Chip key={city.value} aria-label={city.label}>
+ *             {city.label}
+ *             <Combobox.ChipRemoveButton aria-label={'Remove ' + city.label}>
+ *               <Combobox.ChipRemoveButtonIcon />
+ *             </Combobox.ChipRemoveButton>
+ *           </Combobox.Chip>
+ *         ))}
+ *         <Combobox.Input placeholder="Choose cities" />
+ *       </>
+ *     )}
+ *   </Combobox.ChipsList>
+ * </Combobox.InputGroup>
+ */
+export declare const ChipsList: <Item extends ItemShape = ItemShape>(props: ChipsListProps<Item>) => ReactElement;
+/** Reads Base UI selection without rendering its own element. Use its children callback only when you need a custom selection display; Input already displays the selected label automatically. */
+export declare const Value: typeof BaseCombobox.Value;
+export type ScrollAreaProps = Omit<ComponentPropsWithRef<typeof BaseCombobox.List>, 'children' | 'className'> & {
+    className?: string;
+    /** Required groups composition. Use GroupsList rather than another listbox primitive. */
+    children?: ReactNode;
+} & StyleProps;
+/** Required listbox and scroll viewport inside Popup. Place GroupsList inside it. Owns keyboard/listbox semantics; do not nest another listbox primitive. */
+export declare const ScrollArea: import("react").ForwardRefExoticComponent<Omit<ScrollAreaProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export type GroupsListProps<Group extends GroupShape = GroupShape> = Omit<ComponentPropsWithRef<'div'>, 'children'> & {
+    /**
+     * Return Group with its ItemsList; the collection already performs filtering.
+     * IMPORTANT: manually annotate group as Combobox.GroupType<typeof rootItems>,
+     * where rootItems is the exact items variable passed to Root; the surrounding
+     * Root does not infer this callback's data shape.
+     */
+    children: ReactNode | ((group: Group, index: number) => ReactNode);
+} & StyleProps;
+/** Required groups container inside ScrollArea. A children callback receives each automatically filtered group; do not filter or map the original groups again. Manually annotate group with Combobox.GroupType<typeof rootItems>, using the exact items variable passed to Root. */
+export declare function GroupsList<Group extends GroupShape = GroupShape>({ disableStyle, children, className, style, ...props }: GroupsListProps<Group>): import("react").JSX.Element;
+export type ItemsListProps<Item extends ItemShape = ItemShape> = Omit<ComponentPropsWithRef<'div'>, 'children' | 'className'> & {
+    className?: string;
+    /**
+     * Return Item with ItemText and ItemIndicator; do not filter the collection a second time.
+     * IMPORTANT: manually annotate item as Combobox.ItemType<typeof rootItems>,
+     * where rootItems is the exact items variable passed to Root; the surrounding
+     * Root does not infer this callback's data shape.
+     */
+    children?: ReactNode | ((item: Item, index: number) => ReactNode);
+} & StyleProps;
+/** Required items container inside Group. A children callback receives the filtered items belonging to that Group; do not repeat filtering yourself. Manually annotate item with Combobox.ItemType<typeof rootItems>, using the exact items variable passed to Root. */
+export declare function ItemsList<Item extends ItemShape = ItemShape>({ disableStyle, children, className, style, ...props }: ItemsListProps<Item>): import("react").JSX.Element;
+export type GroupProps<Item extends ItemShape = ItemShape> = Omit<ComponentPropsWithRef<typeof BaseCombobox.Group>, 'items' | 'className'> & {
+    className?: string;
+    /** Items for this group; pass group.items from GroupsList. Required even for a flat list. */
+    items: readonly Item[];
+} & StyleProps;
+/** Required wrapper around ItemsList, even for a visually flat list. Pass group.items. A GroupLabel is optional; omit it when the group has an empty label. */
+export declare function Group<Item extends ItemShape = ItemShape>({ disableStyle, className, style, ...props }: GroupProps<Item>): import("react").JSX.Element;
+export type ItemProps<Item extends ItemShape = ItemShape> = Omit<ComponentPropsWithRef<typeof BaseCombobox.Item>, 'value' | 'className'> & {
+    className?: string;
+    /** Pass the item supplied by ItemsList so selection can match it by item.value. */
+    value: Item;
+} & StyleProps;
+/** Required selectable row inside ItemsList. Pass the complete item object as value, with ItemText and ItemIndicator inside. Selection, highlighting, and keyboard behavior are built in. */
+export declare function Item<Item extends ItemShape = ItemShape>({ disableStyle, className, style, ...props }: ItemProps<Item>): import("react").JSX.Element;
+export type PopupProps = Omit<ComponentPropsWithRef<typeof BaseCombobox.Popup>, 'className'> & {
+    className?: string;
+} & Pick<BaseCombobox.Portal.Props, 'container' | 'keepMounted'> & Pick<BaseCombobox.Positioner.Props, 'anchor' | 'positionMethod' | 'alignOffset' | 'collisionBoundary' | 'collisionPadding' | 'sticky' | 'arrowPadding' | 'disableAnchorTracking' | 'collisionAvoidance'> & {
+    /** Preferred popup side; collision handling may choose another side. @default 'bottom' */
+    side?: BaseCombobox.Positioner.Props['side'];
+    /** Gap between the anchor and popup in pixels. @default 5 */
+    sideOffset?: BaseCombobox.Positioner.Props['sideOffset'];
+    /** Popup alignment relative to its anchor. @default 'start' */
+    align?: BaseCombobox.Positioner.Props['align'];
+} & StyleProps;
+/** Popup containing Empty, an optional Loading message, and ScrollArea, in that order. Already includes the portal and positioner: do not add either yourself. Defaults to bottom/start with a 5px gap. Core available-space and anchor-width inline styles stay active when preset styling is disabled. */
+export declare function Popup({ disableStyle, container, keepMounted, anchor, positionMethod, side, sideOffset, align, alignOffset, collisionBoundary, collisionPadding, sticky, arrowPadding, disableAnchorTracking, collisionAvoidance, className, style, ...props }: PopupProps): import("react").JSX.Element;
+/** Optional decorative popup arrow. Place inside Popup; the SVG and direction handling are supplied. No children needed. */
+export declare const Arrow: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").SVGProps<SVGSVGElement>, "children" | "dangerouslySetInnerHTML"> & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Behavior only: turns its single child element into the popup trigger. Adds no preset styling and has no disableStyle prop. Use an accessible button child; pass className to the child for its appearance. */
+export declare const PopupOpenHandler: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxTriggerProps, "children" | "className" | "render"> & {
+    /** Additional classes forwarded to the trigger element. This handler has no preset styles. */
+    className?: string;
+    /** Single element to receive the behavior. Use a button with an accessible name. */
+    children: ReactElement;
+}, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Behavior only: turns its single child element into a removal control for the surrounding Chip. Adds no preset styling and has no disableStyle prop. Use an accessible button child. */
+export declare const ChipRemoveHandler: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxChipRemoveProps, "children" | "className" | "render"> & {
+    /** Additional classes forwarded to the removal element. This handler has no preset styles. */
+    className?: string;
+    /** Single element to receive the behavior. Use a button with an accessible name. */
+    children: ReactElement;
+}, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Optional input adornment container inside InputGroup. Wraps icons, text, or buttons without adding trigger behavior. */
+export declare const Addon: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & {
+    /** Preset adornment appearance. Does not add button behavior. @default 'normal' */
+    variant?: "normal" | "emphasized";
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Clones one supplied icon element, forwarding its ref and preserving its classes. Decorative only; does not open the popup or perform an action. */
+export declare const AddonIcon: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "strokeWidth"> & {
+    /** @default 1.5 */
+    strokeWidth?: LucideProps["strokeWidth"];
+} & {
+    /** One icon element to clone. Its own className is preserved. */
+    children: ReactElement<LucideProps>;
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Optional general-purpose button inside Addon. Supply its action yourself. Automatically disabled when Root is disabled or readOnly; defaults to type="button". */
+export declare const AddonButton: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "type" | "disabled"> & {
+    /** Button type. @default 'button' */
+    type?: ComponentProps<"button">["type"];
+    /** Disables this button. Root disabled or readOnly also disables it automatically. */
+    disabled?: ComponentProps<"button">["disabled"];
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Input control wrapper. Place Input (or ChipsList containing Input) and optional Addon controls inside. Root tone controls its preset validation border. */
+export declare const InputGroup: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxInputGroupProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Displays one selected item inside ChipsList. Keep chips in selected-item order so Base UI can remove the matching item. Supply the item label and an optional removal control. */
+export declare const Chip: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxChipProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Removes the surrounding Chip from selection automatically; no onClick handler needed. Supply its content, normally ChipRemoveButtonIcon, and an accessible label. */
+export declare const ChipRemoveButton: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxChipRemoveProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Opens and closes the popup automatically; no click handler needed. Supply its content, normally AddonOpenButtonIcon, and an accessible label. */
+export declare const AddonOpenButton: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxTriggerProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Clears the selection automatically; no click handler needed. Supply its content, normally AddonClearButtonIcon, and an accessible label. */
+export declare const AddonClearButton: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").AutocompleteClearProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+/** Optional heading inside Group. Supply group.label as children. Omit this part for an empty label; always keep Group and ItemsList. */
+export declare const GroupLabel: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").AutocompleteGroupLabelProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Required empty-results message inside Popup, before optional Loading and ScrollArea. Keep mounted statically: Base UI renders its children only when no items match. Do not manually toggle, hide, or conditionally mount it. */
+export declare const Empty: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").AutocompleteEmptyProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Optional visual separator inside the popup. Does not replace Group or any required list containers. */
+export declare const Separator: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").ComboboxSeparatorProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Required label content inside Item. Supply item.label as children; does not derive text from the item automatically. */
+export declare const ItemText: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLSpanElement>>;
+/** Optional decorative text inside Addon. Supply the text as children. */
+export declare const AddonText: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLSpanElement> & import("react").HTMLAttributes<HTMLSpanElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLSpanElement>>;
+/** Text content inside Empty. Supply your empty-result message; Empty handles its visibility automatically. */
+export declare const EmptyText: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Optional supporting text. Supply its content; it does not connect itself to the input with aria-describedby. Use matching id and Input aria-describedby when needed. */
+export declare const Description: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Optional alert message. You control when it is rendered and its contents; tone does not validate or show this message automatically. */
+export declare const Error: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Optional success status. You control when it is rendered and its contents; tone does not show this message automatically. */
+export declare const Success: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Built-in decorative open-button icon. Place inside AddonOpenButton; no children needed. Defaults to strokeWidth 1.5. */
+export declare const AddonOpenButtonIcon: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "strokeWidth"> & {
+    /** @default 1.5 */
+    strokeWidth?: LucideProps["strokeWidth"];
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Built-in decorative clear icon. Place inside AddonClearButton; no children needed. Defaults to strokeWidth 1.5. */
+export declare const AddonClearButtonIcon: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "strokeWidth"> & {
+    /** @default 1.5 */
+    strokeWidth?: LucideProps["strokeWidth"];
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Built-in decorative removal icon. Place inside ChipRemoveButton; no children needed. Defaults to strokeWidth 1.5. */
+export declare const ChipRemoveButtonIcon: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "strokeWidth"> & {
+    /** @default 1.5 */
+    strokeWidth?: LucideProps["strokeWidth"];
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Optional spinner inside Addon. Does not detect requests: you decide when to render it. Defaults to strokeWidth 1.5. */
+export declare const AddonLoadingIcon: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "strokeWidth"> & {
+    /** @default 1.5 */
+    strokeWidth?: LucideProps["strokeWidth"];
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Required selection indicator inside Item. Visibility is automatic and a checkmark is supplied: no children or selection condition needed. Pass children only to replace the built-in checkmark. */
+export declare const ItemIndicator: import("react").ForwardRefExoticComponent<Omit<Omit<LucideProps, "children"> & Pick<import("@base-ui/react").ComboboxItemIndicatorProps, "keepMounted"> & {
+    /** Optional replacement SVG icon. It receives this indicator's props and ref. */
+    children?: ReactElement<LucideProps>;
+} & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/** Optional async status inside Popup, below Empty and above ScrollArea. Omit entirely for synchronous items. For async items, keep Loading mounted and conditionally render only LoadingIcon and LoadingText from your request state. Does not detect requests or manage visibility. */
+export declare const Loading: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").AutocompleteStatusProps, "className"> & {
+    className?: string;
+} & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Text inside Loading. Supply the message only while your request is loading; this part does not detect request state. */
+export declare const LoadingText: import("react").ForwardRefExoticComponent<Omit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & StyleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+/** Built-in decorative spinner for Loading. No children needed; you control when it is rendered. */
+export declare const LoadingIcon: import("react").ForwardRefExoticComponent<Omit<LucideProps & StyleProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/components/combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/combobox/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAS/C,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACV,MAAM,OAAO,CAAA;AASd,KAAK,UAAU,GAAG;IAChB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG;IACtB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AACD,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG;IACvB,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAC5B,CAAA;AACD,6JAA6J;AAC7J,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;AAClE,4JAA4J;AAC5J,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAClD,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAC/B,6KAA6K;AAC7K,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;AAEtE,MAAM,MAAM,SAAS,CACnB,CAAC,SAAS,SAAS,UAAU,EAAE,EAC/B,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,KAAK,IAC1C,IAAI,CACN,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAC5C,OAAO,GACP,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,IAAI,CACP,GAAG;IACF,gFAAgF;IAChF,EAAE,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA;IACzD;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAA;IACR;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IACvC,6FAA6F;IAC7F,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CACvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwJG;AACH,wBAAgB,IAAI,CAClB,CAAC,SAAS,SAAS,UAAU,EAAE,EAC/B,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,KAAK,EAC5C,EACA,QAAQ,EACR,EAAE,EACF,IAAgB,EAChB,IAAI,EACJ,WAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,+BA8BxB;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS,uNAapB,CAAA;AAEF,+GAA+G;AAC/G,eAAO,MAAM,KAAK,oPAiBhB,CAAA;AAEF,iLAAiL;AACjL,eAAO,MAAM,KAAK;gBAGF,MAAM;yEAiBpB,CAAA;AAEF,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,IAAI,IAAI,CACnE,qBAAqB,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,EAChD,UAAU,GAAG,WAAW,CACzB,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,SAAS,CAAC,CAAA;CACxD,GAAG,UAAU,CAAA;AA8Bd;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,SAAS,EAAiC,CACrD,IAAI,SAAS,SAAS,GAAG,SAAS,EAElC,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,KACxB,YAAY,CAAA;AACjB,mMAAmM;AACnM,eAAO,MAAM,KAAK,2BAAqB,CAAA;AAIvC,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,qBAAqB,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,EAC/C,UAAU,GAAG,WAAW,CACzB,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,GAAG,UAAU,CAAA;AACd,6JAA6J;AAC7J,eAAO,MAAM,UAAU,yHAatB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,UAAU,GAAG,UAAU,IAAI,IAAI,CACvE,qBAAqB,CAAC,KAAK,CAAC,EAC5B,UAAU,CACX,GAAG;IACF;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAA;CACnE,GAAG,UAAU,CAAA;AACd,qRAAqR;AACrR,wBAAgB,UAAU,CAAC,KAAK,SAAS,UAAU,GAAG,UAAU,EAAE,EAChE,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,KAAK,CAAC,+BAgBxB;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,IAAI,IAAI,CACnE,qBAAqB,CAAC,KAAK,CAAC,EAC5B,UAAU,GAAG,WAAW,CACzB,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAA;CAClE,GAAG,UAAU,CAAA;AACd,wQAAwQ;AACxQ,wBAAgB,SAAS,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,IAAI,CAAC,+BAgBtB;AAED,MAAM,MAAM,UAAU,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,IAAI,IAAI,CAC/D,qBAAqB,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,EAChD,OAAO,GAAG,WAAW,CACtB,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6FAA6F;IAC7F,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;CACvB,GAAG,UAAU,CAAA;AACd,+JAA+J;AAC/J,wBAAgB,KAAK,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,EAAE,EACxD,YAAY,EACZ,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,CAAC,IAAI,CAAC,+BAUlB;AAED,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,IAAI,IAAI,CAC9D,qBAAqB,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,EAC/C,OAAO,GAAG,WAAW,CACtB,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,KAAK,EAAE,IAAI,CAAA;CACZ,GAAG,UAAU,CAAA;AACd,6LAA6L;AAC7L,wBAAgB,IAAI,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,EAAE,EACvD,YAAY,EACZ,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,IAAI,CAAC,+BAUjB;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,qBAAqB,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,EAChD,WAAW,CACZ,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC,GAC9D,IAAI,CACF,YAAY,CAAC,UAAU,CAAC,KAAK,EAC3B,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,mBAAmB,GACnB,kBAAkB,GAClB,QAAQ,GACR,cAAc,GACd,uBAAuB,GACvB,oBAAoB,CACvB,GAAG;IACF,0FAA0F;IAC1F,IAAI,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACxD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;CAC/C,GAAG,UAAU,CAAA;AAEhB,4SAA4S;AAC5S,wBAAgB,KAAK,CAAC,EACpB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,MAAM,EACN,cAAc,EACd,IAAe,EACf,UAAc,EACd,KAAe,EACf,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,+BAoCZ;AAED,4HAA4H;AAC5H,eAAO,MAAM,KAAK,2MAoChB,CAAA;AAEF,iNAAiN;AACjN,eAAO,MAAM,gBAAgB;IAGzB,8FAA8F;gBAClF,MAAM;IAClB,oFAAoF;cAC1E,YAAY;6DAIxB,CAAA;AACF,0LAA0L;AAC1L,eAAO,MAAM,iBAAiB;IAG1B,8FAA8F;gBAClF,MAAM;IAClB,oFAAoF;cAC1E,YAAY;6DAIxB,CAAA;AAEF,2HAA2H;AAC3H,eAAO,MAAM,KAAK;IAGd,mFAAmF;cACzE,QAAQ,GAAG,YAAY;uEAiBnC,CAAA;AACF,sJAAsJ;AACtJ,eAAO,MAAM,SAAS;IAxtBpB,mBAAmB;kBACL,WAAW,CAAC,aAAa,CAAC;;IA0tBtC,iEAAiE;cACvD,YAAY,CAAC,WAAW,CAAC;sEAoBrC,CAAA;AACF,qKAAqK;AACrK,eAAO,MAAM,WAAW;IAGpB,qCAAqC;WAC9B,cAAc,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACvC,sFAAsF;eAC3E,cAAc,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC;0EAoBjD,CAAA;AAEF,8JAA8J;AAC9J,eAAO,MAAM,UAAU;gBAGP,MAAM;uEAepB,CAAA;AAEF,qLAAqL;AACrL,eAAO,MAAM,IAAI;gBAGD,MAAM;uEAapB,CAAA;AAEF,wKAAwK;AACxK,eAAO,MAAM,gBAAgB;gBAGb,MAAM;0EAapB,CAAA;AAEF,oJAAoJ;AACpJ,eAAO,MAAM,eAAe;gBAGZ,MAAM;0EAapB,CAAA;AAEF,+IAA+I;AAC/I,eAAO,MAAM,gBAAgB;gBAGb,MAAM;0EAapB,CAAA;AAEF,yIAAyI;AACzI,eAAO,MAAM,UAAU;gBAGP,MAAM;uEAapB,CAAA;AAEF,oOAAoO;AACpO,eAAO,MAAM,KAAK;gBAGF,MAAM;uEAapB,CAAA;AAEF,0GAA0G;AAC1G,eAAO,MAAM,SAAS;gBAGN,MAAM;uEAapB,CAAA;AAEF,2HAA2H;AAC3H,eAAO,MAAM,QAAQ,0NAenB,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,SAAS,0NAepB,CAAA;AAEF,+GAA+G;AAC/G,eAAO,MAAM,SAAS,uNAepB,CAAA;AAEF,2KAA2K;AAC3K,eAAO,MAAM,WAAW,uNAetB,CAAA;AAEF,2IAA2I;AAC3I,eAAO,MAAM,KAAK,uNAiBhB,CAAA;AAEF,gIAAgI;AAChI,eAAO,MAAM,OAAO,uNAiBlB,CAAA;AAEF,2HAA2H;AAC3H,eAAO,MAAM,mBAAmB;IAzhC9B,mBAAmB;kBACL,WAAW,CAAC,aAAa,CAAC;sEA4iCxC,CAAA;AAEF,sHAAsH;AACtH,eAAO,MAAM,oBAAoB;IAhjC/B,mBAAmB;kBACL,WAAW,CAAC,aAAa,CAAC;sEAmkCxC,CAAA;AAEF,wHAAwH;AACxH,eAAO,MAAM,oBAAoB;IAvkC/B,mBAAmB;kBACL,WAAW,CAAC,aAAa,CAAC;sEA0lCxC,CAAA;AAEF,0HAA0H;AAC1H,eAAO,MAAM,gBAAgB;IA9lC3B,mBAAmB;kBACL,WAAW,CAAC,aAAa,CAAC;sEAinCxC,CAAA;AAEF,sMAAsM;AACtM,eAAO,MAAM,aAAa;IAIpB,iFAAiF;eACtE,YAAY,CAAC,WAAW,CAAC;sEAqBxC,CAAA;AACF,yRAAyR;AACzR,eAAO,MAAM,OAAO;gBAGJ,MAAM;uEAapB,CAAA;AAEF,2HAA2H;AAC3H,eAAO,MAAM,WAAW,uNAatB,CAAA;AAEF,oGAAoG;AACpG,eAAO,MAAM,WAAW,iIAcvB,CAAA"}