@bazza-ui/react 0.0.0 → 0.1.0-canary.2

package/dist/select/index.d.cts

@@ -0,0 +1,927 @@
+import { V as VirtualItem } from '../ListboxStore-BtcTXpzi.cjs';
+export { F as SelectFilterFn, I as SelectItemRegistration, b as SelectStore, L as SelectStoreContext, a as SelectStoreState } from '../ListboxStore-BtcTXpzi.cjs';
+import { i as PopupMenuPopup, R as PopupMenuPopupState, P as PopupMenuDebugOptions, a as PopupMenuRootActions, n as PopupMenuSurface, J as PopupMenuSurfaceProps, b as PopupMenuArrow, c as PopupMenuBackdrop, d as PopupMenuEmpty, e as PopupMenuGroup, f as PopupMenuGroupLabel, g as PopupMenuIcon, h as PopupMenuList, j as PopupMenuPortal, k as PopupMenuScrollDownArrow, l as PopupMenuScrollUpArrow, m as PopupMenuSeparator } from '../separator-BmbUeeaT.cjs';
+export { o as SelectArrowProps, p as SelectBackdropProps, q as SelectEmptyProps, r as SelectEmptyState, s as SelectGroupLabelProps, t as SelectGroupLabelState, u as SelectGroupProps, v as SelectGroupState, w as SelectIconProps, x as SelectIconState, y as SelectListChildrenState, L as SelectListCssVars, z as SelectListProps, A as SelectListState, C as SelectPortalProps, M as SelectPositionerCssVars, D as SelectScrollArrowProps, E as SelectScrollArrowState, F as SelectScrollDownArrowProps, G as SelectScrollUpArrowProps, H as SelectSeparatorProps, I as SelectSeparatorState, K as SelectSurfaceState } from '../separator-BmbUeeaT.cjs';
+import { P as PopupMenuInput } from '../input-BoIK003I.cjs';
+export { a as SelectInputProps, b as SelectInputState } from '../input-BoIK003I.cjs';
+import * as React from 'react';
+import { C as ComponentProps } from '../types-9vS1uLIK.cjs';
+import { PopoverPositionerProps, Popover, PopoverRootProps } from '@base-ui/react/popover';
+import { I as ItemEqualityComparer } from '../item-equality-B6TbXlBT.cjs';
+import { C as ChangeEventDetails, t as triggerPress, e as escapeKey, o as outsidePress, f as focusOut, i as itemPress, l as listNavigation, g as imperativeAction, n as none, G as GenericEventDetails, p as pointer, k as keyboard } from '../events-BPr8sRGH.cjs';
+export { S as SurfaceContextValue, c as commandScore, d as defaultFilter, u as useMaybeSurfaceContext, a as useSurfaceContext } from '../command-score-YjNr3ZWi.cjs';
+import '@base-ui/utils/store';
+
+declare const SelectItemDataAttributes: {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-item'}
+     */
+    readonly slot: "bazzaui-select-item";
+    /**
+     * Present when the item is highlighted via keyboard or pointer.
+     */
+    readonly highlighted: "data-highlighted";
+    /**
+     * Present when the item is disabled.
+     */
+    readonly disabled: "data-disabled";
+    /**
+     * Present when the item is currently selected.
+     */
+    readonly selected: "data-selected";
+};
+
+interface SelectItemState extends Record<string, unknown> {
+    /**
+     * Whether the item is highlighted (via keyboard or pointer).
+     */
+    highlighted: boolean;
+    /**
+     * Whether the item is disabled.
+     */
+    disabled: boolean;
+    /**
+     * Whether the item is currently selected.
+     */
+    selected: boolean;
+}
+interface SelectItemProps<Value = unknown> extends ComponentProps<'div', SelectItem.State> {
+    /**
+     * The value of this item. Required and must be unique within the Select.
+     * Can be a primitive or an object.
+     */
+    value: Value;
+    /**
+     * Text value to use for display in Select.Value when this item is selected.
+     * If not provided, the text content of the item will be used.
+     * For object values, this can be auto-detected from `{ label }` shape.
+     */
+    textValue?: string;
+    /**
+     * Additional keywords to match against when filtering.
+     * Useful for aliases or synonyms.
+     */
+    keywords?: string[];
+    /**
+     * Whether this item is disabled.
+     * Disabled items are not selectable and are skipped during keyboard navigation.
+     */
+    disabled?: boolean;
+    /**
+     * Callback when this item is selected.
+     */
+    onSelect?: () => void;
+    /**
+     * Whether to force render this item regardless of filter results.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+declare const SelectItem: <Value = unknown>(props: SelectItemProps<Value> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
+declare namespace SelectItem {
+    type State = SelectItemState;
+    interface Props<Value = unknown> extends SelectItemProps<Value> {
+    }
+}
+
+declare const SelectItemIndicatorDataAttributes: {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-item-indicator'}
+     */
+    readonly slot: "bazzaui-select-item-indicator";
+    /**
+     * Present when the parent item is selected.
+     */
+    readonly selected: "data-selected";
+};
+
+interface SelectItemIndicatorState extends Record<string, unknown> {
+    /**
+     * Whether the item is selected.
+     */
+    selected: boolean;
+}
+interface SelectItemIndicatorProps extends Omit<ComponentProps<'span', SelectItemIndicator.State>, 'children'> {
+    /**
+     * Whether to force render even when the item is not selected.
+     * @default false
+     */
+    forceMount?: boolean;
+    /**
+     * Whether to keep the element mounted even when not selected.
+     * Unlike forceMount, this still conditionally renders children.
+     * Useful for checkbox-style indicators where the container is always visible.
+     * @default false
+     */
+    keepMounted?: boolean;
+    /**
+     * Content to render. Can be a ReactNode or a function that receives state.
+     */
+    children?: React.ReactNode | ((state: SelectItemIndicator.State) => React.ReactNode);
+}
+/**
+ * Indicator that shows when the item is selected.
+ * Typically renders a checkmark icon.
+ * Only renders when the item is selected (unless forceMount or keepMounted is true).
+ * Renders a `<span>` element.
+ */
+declare const SelectItemIndicator: React.ForwardRefExoticComponent<Omit<SelectItemIndicator.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare namespace SelectItemIndicator {
+    interface Props extends SelectItemIndicatorProps {
+    }
+    type State = SelectItemIndicatorState;
+}
+
+interface SelectItemLabelState extends Record<string, unknown> {
+    /**
+     * The serialized string key for the parent item's value.
+     * For object values, this is the result of `itemToStringValue` or the auto-detected `.value` property.
+     */
+    value: string;
+    /**
+     * Whether the parent item is selected.
+     */
+    selected: boolean;
+    /**
+     * Whether the parent item is highlighted.
+     */
+    highlighted: boolean;
+    /**
+     * Whether the parent item is disabled.
+     */
+    disabled: boolean;
+}
+interface SelectItemLabelProps extends ComponentProps<'span', SelectItemLabel.State> {
+}
+/**
+ * The label/text content of a Select.Item.
+ *
+ * When no children are provided, automatically renders the label from the
+ * `items` prop passed to `Select.Root`. If children are provided, they
+ * override the automatic label.
+ *
+ * Also captures the text for display in `Select.Value` when the item is selected,
+ * and provides the text element reference for `alignItemWithTrigger` positioning.
+ *
+ * Renders a `<span>` element.
+ */
+declare const SelectItemLabel: React.ForwardRefExoticComponent<Omit<SelectItemLabel.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare namespace SelectItemLabel {
+    interface Props extends SelectItemLabelProps {
+    }
+    type State = SelectItemLabelState;
+}
+
+interface SelectPopupState extends PopupMenuPopupState {
+    /**
+     * Whether the popup is currently using align-item-with-trigger positioning.
+     * This reflects the actual state, not just the prop value - it will be false
+     * if alignment couldn't be applied (e.g., not enough space, no selected item).
+     */
+    alignItemWithTriggerActive: boolean;
+}
+interface SelectPopupProps extends Omit<PopupMenuPopup.Props, 'className'> {
+    /**
+     * CSS class applied to the element, or a function that
+     * returns a class based on the component's state.
+     */
+    className?: string | ((state: SelectPopupState) => string);
+}
+/**
+ * A container for the select popup contents.
+ * Extends PopupMenuPopup with Select-specific state including alignItemWithTriggerActive.
+ *
+ * Renders a `<div>` element.
+ */
+declare const SelectPopup: React.ForwardRefExoticComponent<SelectPopupProps & React.RefAttributes<HTMLDivElement>>;
+declare namespace SelectPopup {
+    type Props = SelectPopupProps;
+    type State = SelectPopupState;
+}
+
+declare const SelectPositionerDataAttributes: {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-positioner'}
+     */
+    readonly slot: "bazzaui-select-positioner";
+};
+
+interface SelectPositionerProps extends PopoverPositionerProps {
+    /**
+     * Whether the positioner overlaps the trigger so the selected item's text
+     * is aligned with the trigger's value text.
+     *
+     * This is automatically disabled if:
+     * - There is not enough space in the viewport
+     * - The trigger is too close to the viewport edges
+     * - Touch input is detected (better UX to show full list)
+     *
+     * @default true
+     */
+    alignItemWithTrigger?: boolean;
+}
+/**
+ * Positions the select popup against its trigger.
+ * Supports aligning the selected item with the trigger for a native select feel.
+ *
+ * Renders a `<div>` element.
+ */
+declare const SelectPositioner: React.ForwardRefExoticComponent<SelectPositionerProps & React.RefAttributes<HTMLDivElement>>;
+declare namespace SelectPositioner {
+    type Props = SelectPositionerProps;
+    type State = Popover.Positioner.State;
+}
+
+/**
+ * Reasons why the select's open state changed.
+ */
+type SelectOpenChangeReason = typeof triggerPress | typeof escapeKey | typeof outsidePress | typeof focusOut | typeof itemPress | typeof listNavigation | typeof imperativeAction | typeof none;
+/**
+ * Event details passed to the `onOpenChange` callback.
+ */
+type SelectOpenChangeEventDetails = ChangeEventDetails<SelectOpenChangeReason>;
+/**
+ * Reasons why highlight changed.
+ */
+type SelectHighlightChangeReason = typeof pointer | typeof keyboard | typeof none;
+/**
+ * Event details passed to the `onHighlightChange` callback.
+ */
+type SelectHighlightChangeEventDetails = GenericEventDetails<SelectHighlightChangeReason, {
+    index: number;
+}>;
+
+/**
+ * Helper type to determine the value type based on the multiple flag.
+ */
+type SelectValue$1<Value, Multiple extends boolean | undefined> = Multiple extends true ? Value[] : Value | null;
+interface SelectRootProps<Value = unknown, Multiple extends boolean | undefined = false> extends Omit<PopoverRootProps, 'open' | 'onOpenChange' | 'defaultOpen' | 'actionsRef'> {
+    /**
+     * Whether the select is open.
+     * Use for controlled mode.
+     */
+    open?: boolean;
+    /**
+     * Callback when the open state changes.
+     * The second parameter contains event details including the reason for the change.
+     */
+    onOpenChange?: (open: boolean, eventDetails: SelectOpenChangeEventDetails) => void;
+    /**
+     * Callback called after any animations complete when the select opens or closes.
+     * Useful for resetting state after exit animations finish.
+     */
+    onOpenChangeComplete?: (open: boolean) => void;
+    /**
+     * A ref to imperative actions.
+     * - `close`: closes the menu imperatively.
+     * - `unmount`: unmounts the popup imperatively (when keep-mounted mode is enabled).
+     * - `setDisabled`: enables/disables the menu imperatively.
+     */
+    actionsRef?: React.RefObject<SelectRoot.Actions | null>;
+    /**
+     * Whether the select is initially open.
+     * Use for uncontrolled mode.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Current selected value (single-select mode).
+     * Use for controlled mode.
+     * Can be a primitive or an object.
+     */
+    value?: SelectValue$1<Value, Multiple>;
+    /**
+     * Default selected value (single-select mode).
+     * Use for uncontrolled mode.
+     */
+    defaultValue?: SelectValue$1<Value, Multiple>;
+    /**
+     * Callback when the selected value changes (single-select mode).
+     */
+    onValueChange?: (value: Value) => void;
+    /**
+     * Whether multi-select mode is enabled.
+     * @default false
+     */
+    multiple?: Multiple;
+    /**
+     * Current selected values (multi-select mode).
+     * Use for controlled mode.
+     */
+    values?: Value[];
+    /**
+     * Default selected values (multi-select mode).
+     * Use for uncontrolled mode.
+     */
+    defaultValues?: Value[];
+    /**
+     * Callback when the selected values change (multi-select mode).
+     */
+    onValuesChange?: (values: Value[]) => void;
+    /**
+     * Custom comparison logic used to determine if a select item value
+     * matches the current selected value.
+     * Useful when item values are objects without matching referentially.
+     * Defaults to Object.is comparison.
+     */
+    isItemEqualToValue?: ItemEqualityComparer<Value>;
+    /**
+     * When the item values are objects (`<Select.Item value={object}>`),
+     * this function converts the object value to a string representation
+     * for display in the trigger.
+     * If the shape of the object is `{ value, label }`, the label will be
+     * used automatically without needing to specify this prop.
+     */
+    itemToStringLabel?: (itemValue: Value) => string;
+    /**
+     * When the item values are objects (`<Select.Item value={object}>`),
+     * this function converts the object value to a string representation
+     * for form submission.
+     * If the shape of the object is `{ value, label }`, the value will be
+     * used automatically without needing to specify this prop.
+     */
+    itemToStringValue?: (itemValue: Value) => string;
+    /**
+     * Form field name for submission.
+     * When set, hidden input(s) will be rendered for form submission.
+     */
+    name?: string;
+    /**
+     * Associate with a form by ID.
+     */
+    form?: string;
+    /**
+     * Whether this field is required.
+     */
+    required?: boolean;
+    /**
+     * Whether the select is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Placeholder text when no value is selected.
+     * @default "Select..."
+     */
+    placeholder?: string;
+    /**
+     * Data structure of the items rendered in the select popup.
+     * When specified, `<Select.Value>` renders the label of the selected item
+     * instead of the raw value.
+     *
+     * Can be a record mapping values to labels, or an array of { value, label } objects.
+     * @example
+     * ```tsx
+     * // Record format
+     * <Select.Root items={{ us: 'United States', uk: 'United Kingdom' }}>
+     *
+     * // Array format
+     * <Select.Root items={[
+     *   { value: 'us', label: 'United States' },
+     *   { value: 'uk', label: 'United Kingdom' },
+     * ]}>
+     * ```
+     */
+    items?: Record<string, React.ReactNode> | Array<{
+        value: string;
+        label: React.ReactNode;
+    }>;
+    /**
+     * Determines if the select enters a modal state when open.
+     *
+     * - `true`: user interaction is limited to the select: document page scroll
+     *   is locked, and pointer interactions on outside elements are disabled.
+     * - `false`: user interaction with the rest of the document is allowed.
+     * - `'trap-focus'`: focus is trapped inside the select, but document page
+     *   scroll is not locked and pointer interactions outside of it remain enabled.
+     *
+     * @default true
+     */
+    modal?: boolean | 'trap-focus';
+    /**
+     * Whether virtualization mode is enabled.
+     * When true, items should provide an explicit `index` prop and
+     * the `virtualItems` prop should be provided for navigation to work correctly.
+     * @default false
+     */
+    virtualized?: boolean;
+    /**
+     * Pre-registered items for virtualization.
+     * When provided with `virtualized={true}`, this allows navigation to work
+     * for items that aren't currently mounted in the DOM.
+     */
+    virtualItems?: VirtualItem[];
+    /**
+     * Callback when the highlighted item changes.
+     * Useful for synchronizing with a virtualizer (e.g., scrollToIndex) or other UI state.
+     * The third parameter contains event details including the reason for the change.
+     */
+    onHighlightChange?: (id: string | null, index: number, eventDetails: SelectHighlightChangeEventDetails) => void;
+    /**
+     * Debug visualization options for submenu interaction heuristics.
+     */
+    debug?: PopupMenuDebugOptions;
+    children: React.ReactNode;
+}
+/**
+ * Groups all parts of the select.
+ * Manages open state, selection state, and provides context to children.
+ * Doesn't render its own HTML element.
+ *
+ * @template Value - The type of the select value (can be a primitive or object)
+ * @template Multiple - Whether multiple selection is enabled
+ */
+declare function SelectRoot<Value = unknown, Multiple extends boolean | undefined = false>(props: SelectRootProps<Value, Multiple>): React.JSX.Element;
+declare namespace SelectRoot {
+    interface Props<Value = unknown, Multiple extends boolean | undefined = false> extends SelectRootProps<Value, Multiple> {
+    }
+    type OpenChangeEventDetails = SelectOpenChangeEventDetails;
+    type HighlightChangeEventDetails = SelectHighlightChangeEventDetails;
+    type Actions = PopupMenuRootActions;
+}
+
+interface SelectSurfaceProps extends Omit<PopupMenuSurfaceProps, 'autoHighlightFirst'> {
+    /**
+     * Controls auto-highlighting behavior when the select opens.
+     * - `true`: highlight the first item (default when alignItemWithTrigger is inactive)
+     * - `false`: don't auto-highlight any item
+     * - `'selected'`: highlight the currently selected item, or first item if none selected
+     * - `string`: highlight the item with this specific value
+     *
+     * Note: When the Positioner's `alignItemWithTrigger` is active and this prop
+     * is not explicitly set, the selected item is automatically highlighted.
+     *
+     * @default true (or selected value when alignItemWithTrigger is active)
+     */
+    autoHighlightFirst?: boolean | 'selected' | string;
+}
+/**
+ * Provides search context and manages item registration for Select.
+ * Automatically configures `autoHighlightFirst` based on the Positioner's
+ * `alignItemWithTrigger` prop - when active, highlights the selected item
+ * instead of the first item.
+ *
+ * Place inside Select.Popup to enable search functionality.
+ * Renders a `<div>` element.
+ */
+declare const SelectSurface: React.ForwardRefExoticComponent<Omit<SelectSurface.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace SelectSurface {
+    type State = PopupMenuSurface.State;
+    interface Props extends SelectSurfaceProps {
+    }
+}
+
+declare const SelectTriggerDataAttributes: {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-trigger'}
+     */
+    readonly slot: "bazzaui-select-trigger";
+    /**
+     * Present when the select dropdown is open.
+     */
+    readonly open: "data-open";
+    /**
+     * Present when the select dropdown is closed.
+     */
+    readonly closed: "data-closed";
+    /**
+     * Present when the trigger is disabled.
+     */
+    readonly disabled: "data-disabled";
+    /**
+     * Present when no value is selected (showing placeholder).
+     */
+    readonly placeholder: "data-placeholder";
+};
+
+interface SelectTriggerState extends Record<string, unknown> {
+    /**
+     * Whether the select is open.
+     */
+    open: boolean;
+    /**
+     * Whether the select is disabled.
+     */
+    disabled: boolean;
+    /**
+     * Whether the select currently shows placeholder (no value selected).
+     */
+    placeholder: boolean;
+}
+interface SelectTriggerProps extends ComponentProps<'button', SelectTrigger.State> {
+    /**
+     * Whether the trigger is disabled.
+     */
+    disabled?: boolean;
+}
+/**
+ * A button that opens the select dropdown.
+ * Renders a `<button>` element with combobox ARIA semantics.
+ */
+declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectTrigger.Props, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare namespace SelectTrigger {
+    interface Props extends SelectTriggerProps {
+    }
+    type State = SelectTriggerState;
+}
+
+interface SelectValueState<Value = unknown> extends Record<string, unknown> {
+    /**
+     * The currently selected value (single-select mode).
+     */
+    value: Value | null;
+    /**
+     * The currently selected values (multi-select mode).
+     */
+    values: Value[];
+    /**
+     * Whether the select is in multi-select mode.
+     */
+    multiple: boolean;
+    /**
+     * Whether a value is currently selected.
+     */
+    hasValue: boolean;
+    /**
+     * The placeholder text.
+     */
+    placeholder: string;
+    /**
+     * Get the display content for a value.
+     * First checks the item text registry (populated when items mount),
+     * then falls back to the `items` prop passed to SelectRoot,
+     * then falls back to `itemToStringLabel` for object values.
+     */
+    getValueText: (value: Value) => React.ReactNode | undefined;
+}
+interface SelectValueProps<Value = unknown> extends Omit<ComponentProps<'span', SelectValueState<Value>>, 'children'> {
+    /**
+     * Placeholder text when no value is selected.
+     * Overrides the placeholder set on Select.Root.
+     */
+    placeholder?: string;
+    /**
+     * Custom render function for the selected value content.
+     * Receives the current state and should return the content to render.
+     * This is different from the `render` prop which replaces the element.
+     */
+    children?: React.ReactNode | ((state: SelectValueState<Value>) => React.ReactNode);
+}
+declare const SelectValue: <Value = unknown>(props: SelectValueProps<Value> & React.RefAttributes<HTMLSpanElement>) => React.ReactElement;
+declare namespace SelectValue {
+    interface Props extends SelectValueProps<unknown> {
+    }
+    type State = SelectValueState<unknown>;
+}
+
+type index_parts_SelectPopupProps = SelectPopupProps;
+type index_parts_SelectPopupState = SelectPopupState;
+declare const index_parts_VirtualItem: typeof VirtualItem;
+declare namespace index_parts {
+  export { PopupMenuArrow as Arrow, PopupMenuBackdrop as Backdrop, PopupMenuEmpty as Empty, PopupMenuGroup as Group, PopupMenuGroupLabel as GroupLabel, PopupMenuIcon as Icon, PopupMenuInput as Input, SelectItem as Item, SelectItemIndicator as ItemIndicator, SelectItemLabel as ItemLabel, PopupMenuList as List, SelectPopup as Popup, PopupMenuPortal as Portal, SelectPositioner as Positioner, SelectRoot as Root, PopupMenuScrollDownArrow as ScrollDownArrow, PopupMenuScrollUpArrow as ScrollUpArrow, type index_parts_SelectPopupProps as SelectPopupProps, type index_parts_SelectPopupState as SelectPopupState, PopupMenuSeparator as Separator, SelectSurface as Surface, SelectTrigger as Trigger, SelectValue as Value, index_parts_VirtualItem as VirtualItem };
+}
+
+declare enum SelectArrowDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-arrow'}
+     */
+    slot = "bazzaui-select-arrow",
+    /**
+     * Present when the popup menu is open.
+     */
+    open = "data-open",
+    /**
+     * Present when the popup menu is closed.
+     */
+    closed = "data-closed",
+    /**
+     * Indicates which side the popup is positioned relative to the trigger.
+     * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start'}
+     */
+    side = "data-side",
+    /**
+     * Indicates how the popup is aligned relative to specified side.
+     * @type {'start' | 'center' | 'end'}
+     */
+    align = "data-align",
+    /**
+     * Present when the arrow is not centered due to collision avoidance.
+     */
+    uncentered = "data-uncentered"
+}
+
+declare enum SelectBackdropDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-backdrop'}
+     */
+    slot = "bazzaui-select-backdrop",
+    /**
+     * Present when the popup menu is open.
+     */
+    open = "data-open",
+    /**
+     * Present when the popup menu is closed.
+     */
+    closed = "data-closed",
+    /**
+     * Present when the popup menu is animating in.
+     */
+    startingStyle = "data-starting-style",
+    /**
+     * Present when the popup menu is animating out.
+     */
+    endingStyle = "data-ending-style"
+}
+
+/**
+ * Data attributes applied to Select.Empty for styling.
+ * Displayed when no items match the current search filter.
+ *
+ * @example
+ * ```css
+ * [data-bazzaui-select-empty] {
+ *   padding: 8px 16px;
+ *   color: var(--muted);
+ *   text-align: center;
+ * }
+ * ```
+ */
+declare enum SelectEmptyDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-empty'}
+     */
+    slot = "bazzaui-select-empty"
+}
+
+declare enum SelectGroupDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-group'}
+     */
+    slot = "bazzaui-select-group"
+}
+
+declare enum SelectGroupLabelDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-group-label'}
+     */
+    slot = "bazzaui-select-group-label"
+}
+
+declare const SelectIconDataAttributes: {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-icon'}
+     */
+    readonly slot: "bazzaui-select-icon";
+    /** Present when the popup is open. */
+    readonly open: "data-popup-open";
+};
+
+declare enum SelectInputDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-input'}
+     */
+    slot = "bazzaui-select-input",
+    /**
+     * Present when the popup menu is open.
+     */
+    open = "data-open",
+    /**
+     * Present when the popup menu is closed.
+     */
+    closed = "data-closed"
+}
+
+/**
+ * Data attributes applied to Select.List for styling.
+ * Container for select items with role="listbox".
+ *
+ * @example
+ * ```css
+ * [data-bazzaui-select-list] {
+ *   max-height: 300px;
+ *   overflow-y: auto;
+ * }
+ * ```
+ */
+declare enum SelectListDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-list'}
+     */
+    slot = "bazzaui-select-list",
+    /**
+     * Always present on the list element.
+     * Used for styling and by useStickyRowWidth to find the list container.
+     */
+    list = "data-popup-menu-list"
+}
+
+/**
+ * Select-specific popup data attributes (in addition to PopupMenuPopupDataAttributes).
+ */
+declare enum SelectPopupDataAttributes {
+    /**
+     * Present when the popup is using align-item-with-trigger positioning.
+     * This reflects the actual state, not just the prop value.
+     */
+    alignItemWithTrigger = "data-align-item-with-trigger"
+}
+
+declare const SelectScrollArrowDataAttributes: {
+    /**
+     * Identifies the component part for scroll up arrow.
+     * @type {'bazzaui-select-scroll-up-arrow'}
+     */
+    readonly slotUp: "bazzaui-select-scroll-up-arrow";
+    /**
+     * Identifies the component part for scroll down arrow.
+     * @type {'bazzaui-select-scroll-down-arrow'}
+     */
+    readonly slotDown: "bazzaui-select-scroll-down-arrow";
+    /**
+     * Direction of the scroll arrow.
+     * @type {'up' | 'down'}
+     */
+    readonly direction: "data-direction";
+    /**
+     * Side of the popup.
+     * @type {'top' | 'bottom' | 'left' | 'right'}
+     */
+    readonly side: "data-side";
+};
+
+declare enum SelectSeparatorDataAttributes {
+    /**
+     * Identifies the component part.
+     * @type {'bazzaui-select-separator'}
+     */
+    slot = "bazzaui-select-separator"
+}
+
+/**
+ * Item text registry for displaying selected values.
+ * Maps serialized item value to its text content.
+ */
+type ItemTextRegistry = Map<string, string>;
+/**
+ * Context value for Select components.
+ * Provides value state, callbacks, and form integration.
+ *
+ * @template Value - The type of the select value (can be a primitive or object)
+ */
+interface SelectContextValue<Value = unknown> {
+    /** Whether multi-select mode is enabled */
+    multiple: boolean;
+    /** Current selected value (single-select mode) */
+    value: Value | null;
+    /** Current selected values (multi-select mode) */
+    values: Value[];
+    /** Callback when value changes (single-select mode) */
+    onValueChange: (value: Value) => void;
+    /** Callback when values change (multi-select mode) */
+    onValuesChange: (values: Value[]) => void;
+    /**
+     * Custom comparison logic used to determine if a select item value
+     * matches the current selected value.
+     * Useful when item values are objects without matching referentially.
+     * Defaults to Object.is comparison.
+     */
+    isItemEqualToValue: ItemEqualityComparer<Value>;
+    /**
+     * When the item values are objects, this function converts the object
+     * value to a string representation for display in the trigger.
+     * If the shape of the object is { value, label }, the label will be
+     * used automatically without needing to specify this prop.
+     */
+    itemToStringLabel?: (itemValue: Value) => string;
+    /**
+     * When the item values are objects, this function converts the object
+     * value to a string representation for form submission.
+     * If the shape of the object is { value, label }, the value will be
+     * used automatically without needing to specify this prop.
+     */
+    itemToStringValue?: (itemValue: Value) => string;
+    /** Form field name for submission */
+    name?: string;
+    /** Associate with a form by ID */
+    form?: string;
+    /** Whether this field is required */
+    required?: boolean;
+    /** Whether the select is disabled */
+    disabled: boolean;
+    /** Placeholder text when no value selected */
+    placeholder: string;
+    /** Registry of item values to their text content */
+    itemTextRegistry: ItemTextRegistry;
+    /** Register an item's text content */
+    registerItemText: (value: string, text: string) => () => void;
+    /**
+     * Data structure of the items for label resolution.
+     * Used to display labels before items mount (e.g., on initial render with defaultValue).
+     * Can be a record mapping values to labels, or an array of { value, label } objects.
+     */
+    items?: Record<string, React.ReactNode> | Array<{
+        value: string;
+        label: React.ReactNode;
+    }>;
+    /** ID for the listbox element */
+    listId: string;
+    /** Ref to the trigger element */
+    triggerRef: React.RefObject<HTMLElement | null>;
+    /** Ref to the value display element (text in trigger) */
+    valueRef: React.RefObject<HTMLElement | null>;
+    /** Ref to the selected item's text element */
+    selectedItemTextRef: React.MutableRefObject<HTMLElement | null>;
+    /** Ref to the first item's text element (used when no selection for alignItemWithTrigger) */
+    firstItemTextRef: React.MutableRefObject<HTMLElement | null>;
+    /** Callback to set the trigger element */
+    setTriggerElement: (element: HTMLElement | null) => void;
+    /** Callback to set the value element */
+    setValueElement: (element: HTMLElement | null) => void;
+    /** Register a callback to reset positioning state after close animation */
+    registerResetPositioningCallback: (callback: (() => void) | null) => () => void;
+}
+/**
+ * Hook to access the Select context.
+ * Throws if used outside a Select.Root.
+ */
+declare function useSelectContext<Value = unknown>(): SelectContextValue<Value>;
+/**
+ * Hook to optionally access the Select context.
+ * Returns null if used outside a Select.Root.
+ */
+declare function useMaybeSelectContext<Value = unknown>(): SelectContextValue<Value> | null;
+
+type Side = 'top' | 'bottom' | 'left' | 'right';
+type Align = 'start' | 'center' | 'end';
+/**
+ * Context value for Select Positioner.
+ * Provides alignment state for coordinating positioning behavior.
+ */
+interface SelectPositionerContextValue {
+    /**
+     * Whether alignItemWithTrigger is actively being used.
+     * This may be false even if the prop is true (e.g., fallback scenarios).
+     */
+    alignItemWithTriggerActive: boolean;
+    /**
+     * The rendered side of the popup (or 'none' when using align-item-with-trigger).
+     */
+    side: Side | 'none';
+    /**
+     * The rendered alignment of the popup.
+     */
+    align: Align;
+    /**
+     * Ref for the scroll up arrow element.
+     */
+    scrollUpArrowRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Ref for the scroll down arrow element.
+     */
+    scrollDownArrowRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Callback to disable alignItemWithTrigger (fallback to normal positioning).
+     */
+    setAlignItemWithTriggerActive: (active: boolean) => void;
+    /**
+     * Callback to reset positioning state after close animation completes.
+     * This preserves positioning during exit animations.
+     */
+    resetPositioningState: () => void;
+}
+/**
+ * Hook to access the Select Positioner context.
+ * Returns null if used outside a SelectPositioner.
+ */
+declare function useSelectPositionerContext(): SelectPositionerContextValue | null;
+
+interface SelectItemContextValue<Value = unknown> {
+    /** Unique ID for this item (for DOM id attribute) */
+    id: string;
+    /** The value of this item */
+    value: Value;
+    /** The text value/label for this item */
+    textValue: string | undefined;
+    /** Whether the item is highlighted */
+    highlighted: boolean;
+    /** Whether the item is disabled */
+    disabled: boolean;
+    /** Whether the item is selected */
+    selected: boolean;
+}
+declare function useSelectItemContext<Value = unknown>(): SelectItemContextValue<Value>;
+declare function useMaybeSelectItemContext<Value = unknown>(): SelectItemContextValue<Value> | null;
+
+export { index_parts as Select, PopupMenuArrow as SelectArrow, SelectArrowDataAttributes, PopupMenuBackdrop as SelectBackdrop, SelectBackdropDataAttributes, type SelectContextValue, PopupMenuEmpty as SelectEmpty, SelectEmptyDataAttributes, PopupMenuGroup as SelectGroup, SelectGroupDataAttributes, PopupMenuGroupLabel as SelectGroupLabel, SelectGroupLabelDataAttributes, SelectIconDataAttributes, PopupMenuInput as SelectInput, SelectInputDataAttributes, SelectItem, type SelectItemContextValue, SelectItemDataAttributes, SelectItemIndicator, SelectItemIndicatorDataAttributes, type SelectItemIndicatorProps, type SelectItemIndicatorState, SelectItemLabel, type SelectItemLabelProps, type SelectItemProps, type SelectItemState, PopupMenuList as SelectList, SelectListDataAttributes, SelectPopup, SelectPopupDataAttributes, type SelectPopupProps, type SelectPopupState, PopupMenuPortal as SelectPortal, SelectPositioner, type Align as SelectPositionerAlign, type SelectPositionerContextValue, SelectPositionerDataAttributes, type SelectPositionerProps, type Side as SelectPositionerSide, SelectRoot, type SelectRootProps, SelectScrollArrowDataAttributes, PopupMenuSeparator as SelectSeparator, SelectSeparatorDataAttributes, SelectSurface, type SelectSurfaceProps, SelectTrigger, SelectTriggerDataAttributes, type SelectTriggerProps, type SelectTriggerState, SelectValue, type SelectValueProps, type SelectValueState, VirtualItem as SelectVirtualItem, useMaybeSelectContext, useMaybeSelectItemContext, useSelectContext, useSelectItemContext, useSelectPositionerContext };