@base-ui/react 1.7.0 → 1.8.0

package/autocomplete/input-group/AutocompleteInputGroupDataAttributes.d.mts

@@ -1,51 +1,49 @@
-export declare enum AutocompleteInputGroupDataAttributes {
-  /**
-   * Present when the corresponding popup is open.
-   */
-  popupOpen = "data-popup-open",
-  /**
-   * Present when the input group is pressed.
-   */
-  pressed = "data-pressed",
-  /**
-   * Present when the component is disabled.
-   */
-  disabled = "data-disabled",
-  /**
-   * Present when the component is readonly.
-   */
-  readonly = "data-readonly",
-  /**
-   * Indicates which side the corresponding popup is positioned relative to its anchor.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
-   */
-  popupSide = "data-popup-side",
-  /**
-   * Present when the component is in a valid state (when wrapped in Field.Root).
-   */
-  valid = "data-valid",
-  /**
-   * Present when the component is in an invalid state (when wrapped in Field.Root).
-   */
-  invalid = "data-invalid",
-  /**
-   * Present when the component has been touched (when wrapped in Field.Root).
-   */
-  touched = "data-touched",
-  /**
-   * Present when the component's value has changed (when wrapped in Field.Root).
-   */
-  dirty = "data-dirty",
-  /**
-   * Present when the component has a value (when wrapped in Field.Root).
-   */
-  filled = "data-filled",
-  /**
-   * Present when the component is focused (when wrapped in Field.Root).
-   */
-  focused = "data-focused",
-  /**
-   * Present when the corresponding items list is empty.
-   */
-  listEmpty = "data-list-empty",
-}
+/**
+ * Present when the corresponding popup is open.
+ */
+export declare const popupOpen = "data-popup-open";
+/**
+ * Present when the input group is pressed.
+ */
+export declare const pressed = "data-pressed";
+/**
+ * Present when the component is disabled.
+ */
+export declare const disabled = "data-disabled";
+/**
+ * Present when the component is readonly.
+ */
+export declare const readonly = "data-readonly";
+/**
+ * Indicates which side the corresponding popup is positioned relative to its anchor.
+ * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
+ */
+export declare const popupSide = "data-popup-side";
+/**
+ * Present when the component is in a valid state (when wrapped in Field.Root).
+ */
+export declare const valid = "data-valid";
+/**
+ * Present when the component is in an invalid state (when wrapped in Field.Root).
+ */
+export declare const invalid = "data-invalid";
+/**
+ * Present when the component has been touched (when wrapped in Field.Root).
+ */
+export declare const touched = "data-touched";
+/**
+ * Present when the component's value has changed (when wrapped in Field.Root).
+ */
+export declare const dirty = "data-dirty";
+/**
+ * Present when the component has a value (when wrapped in Field.Root).
+ */
+export declare const filled = "data-filled";
+/**
+ * Present when the component is focused (when wrapped in Field.Root).
+ */
+export declare const focused = "data-focused";
+/**
+ * Present when the corresponding items list is empty.
+ */
+export declare const listEmpty = "data-list-empty";

package/autocomplete/input-group/AutocompleteInputGroupDataAttributes.d.ts

@@ -1,51 +1,49 @@
-export declare enum AutocompleteInputGroupDataAttributes {
-  /**
-   * Present when the corresponding popup is open.
-   */
-  popupOpen = "data-popup-open",
-  /**
-   * Present when the input group is pressed.
-   */
-  pressed = "data-pressed",
-  /**
-   * Present when the component is disabled.
-   */
-  disabled = "data-disabled",
-  /**
-   * Present when the component is readonly.
-   */
-  readonly = "data-readonly",
-  /**
-   * Indicates which side the corresponding popup is positioned relative to its anchor.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
-   */
-  popupSide = "data-popup-side",
-  /**
-   * Present when the component is in a valid state (when wrapped in Field.Root).
-   */
-  valid = "data-valid",
-  /**
-   * Present when the component is in an invalid state (when wrapped in Field.Root).
-   */
-  invalid = "data-invalid",
-  /**
-   * Present when the component has been touched (when wrapped in Field.Root).
-   */
-  touched = "data-touched",
-  /**
-   * Present when the component's value has changed (when wrapped in Field.Root).
-   */
-  dirty = "data-dirty",
-  /**
-   * Present when the component has a value (when wrapped in Field.Root).
-   */
-  filled = "data-filled",
-  /**
-   * Present when the component is focused (when wrapped in Field.Root).
-   */
-  focused = "data-focused",
-  /**
-   * Present when the corresponding items list is empty.
-   */
-  listEmpty = "data-list-empty",
-}
+/**
+ * Present when the corresponding popup is open.
+ */
+export declare const popupOpen = "data-popup-open";
+/**
+ * Present when the input group is pressed.
+ */
+export declare const pressed = "data-pressed";
+/**
+ * Present when the component is disabled.
+ */
+export declare const disabled = "data-disabled";
+/**
+ * Present when the component is readonly.
+ */
+export declare const readonly = "data-readonly";
+/**
+ * Indicates which side the corresponding popup is positioned relative to its anchor.
+ * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
+ */
+export declare const popupSide = "data-popup-side";
+/**
+ * Present when the component is in a valid state (when wrapped in Field.Root).
+ */
+export declare const valid = "data-valid";
+/**
+ * Present when the component is in an invalid state (when wrapped in Field.Root).
+ */
+export declare const invalid = "data-invalid";
+/**
+ * Present when the component has been touched (when wrapped in Field.Root).
+ */
+export declare const touched = "data-touched";
+/**
+ * Present when the component's value has changed (when wrapped in Field.Root).
+ */
+export declare const dirty = "data-dirty";
+/**
+ * Present when the component has a value (when wrapped in Field.Root).
+ */
+export declare const filled = "data-filled";
+/**
+ * Present when the component is focused (when wrapped in Field.Root).
+ */
+export declare const focused = "data-focused";
+/**
+ * Present when the corresponding items list is empty.
+ */
+export declare const listEmpty = "data-list-empty";

package/autocomplete/input-group/AutocompleteInputGroupDataAttributes.js

@@ -3,56 +3,53 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AutocompleteInputGroupDataAttributes = void 0;
-let AutocompleteInputGroupDataAttributes = exports.AutocompleteInputGroupDataAttributes = /*#__PURE__*/function (AutocompleteInputGroupDataAttributes) {
-  /**
-   * Present when the corresponding popup is open.
-   */
-  AutocompleteInputGroupDataAttributes["popupOpen"] = "data-popup-open";
-  /**
-   * Present when the input group is pressed.
-   */
-  AutocompleteInputGroupDataAttributes["pressed"] = "data-pressed";
-  /**
-   * Present when the component is disabled.
-   */
-  AutocompleteInputGroupDataAttributes["disabled"] = "data-disabled";
-  /**
-   * Present when the component is readonly.
-   */
-  AutocompleteInputGroupDataAttributes["readonly"] = "data-readonly";
-  /**
-   * Indicates which side the corresponding popup is positioned relative to its anchor.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
-   */
-  AutocompleteInputGroupDataAttributes["popupSide"] = "data-popup-side";
-  /**
-   * Present when the component is in a valid state (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["valid"] = "data-valid";
-  /**
-   * Present when the component is in an invalid state (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["invalid"] = "data-invalid";
-  /**
-   * Present when the component has been touched (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["touched"] = "data-touched";
-  /**
-   * Present when the component's value has changed (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["dirty"] = "data-dirty";
-  /**
-   * Present when the component has a value (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["filled"] = "data-filled";
-  /**
-   * Present when the component is focused (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["focused"] = "data-focused";
-  /**
-   * Present when the corresponding items list is empty.
-   */
-  AutocompleteInputGroupDataAttributes["listEmpty"] = "data-list-empty";
-  return AutocompleteInputGroupDataAttributes;
-}({});
+exports.valid = exports.touched = exports.readonly = exports.pressed = exports.popupSide = exports.popupOpen = exports.listEmpty = exports.invalid = exports.focused = exports.filled = exports.disabled = exports.dirty = void 0;
+/**
+ * Present when the corresponding popup is open.
+ */
+const popupOpen = exports.popupOpen = 'data-popup-open';
+/**
+ * Present when the input group is pressed.
+ */
+const pressed = exports.pressed = 'data-pressed';
+/**
+ * Present when the component is disabled.
+ */
+const disabled = exports.disabled = 'data-disabled';
+/**
+ * Present when the component is readonly.
+ */
+const readonly = exports.readonly = 'data-readonly';
+/**
+ * Indicates which side the corresponding popup is positioned relative to its anchor.
+ * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
+ */
+const popupSide = exports.popupSide = 'data-popup-side';
+/**
+ * Present when the component is in a valid state (when wrapped in Field.Root).
+ */
+const valid = exports.valid = 'data-valid';
+/**
+ * Present when the component is in an invalid state (when wrapped in Field.Root).
+ */
+const invalid = exports.invalid = 'data-invalid';
+/**
+ * Present when the component has been touched (when wrapped in Field.Root).
+ */
+const touched = exports.touched = 'data-touched';
+/**
+ * Present when the component's value has changed (when wrapped in Field.Root).
+ */
+const dirty = exports.dirty = 'data-dirty';
+/**
+ * Present when the component has a value (when wrapped in Field.Root).
+ */
+const filled = exports.filled = 'data-filled';
+/**
+ * Present when the component is focused (when wrapped in Field.Root).
+ */
+const focused = exports.focused = 'data-focused';
+/**
+ * Present when the corresponding items list is empty.
+ */
+const listEmpty = exports.listEmpty = 'data-list-empty';

package/autocomplete/input-group/AutocompleteInputGroupDataAttributes.mjs

@@ -1,52 +1,49 @@
-export let AutocompleteInputGroupDataAttributes = /*#__PURE__*/function (AutocompleteInputGroupDataAttributes) {
-  /**
-   * Present when the corresponding popup is open.
-   */
-  AutocompleteInputGroupDataAttributes["popupOpen"] = "data-popup-open";
-  /**
-   * Present when the input group is pressed.
-   */
-  AutocompleteInputGroupDataAttributes["pressed"] = "data-pressed";
-  /**
-   * Present when the component is disabled.
-   */
-  AutocompleteInputGroupDataAttributes["disabled"] = "data-disabled";
-  /**
-   * Present when the component is readonly.
-   */
-  AutocompleteInputGroupDataAttributes["readonly"] = "data-readonly";
-  /**
-   * Indicates which side the corresponding popup is positioned relative to its anchor.
-   * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
-   */
-  AutocompleteInputGroupDataAttributes["popupSide"] = "data-popup-side";
-  /**
-   * Present when the component is in a valid state (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["valid"] = "data-valid";
-  /**
-   * Present when the component is in an invalid state (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["invalid"] = "data-invalid";
-  /**
-   * Present when the component has been touched (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["touched"] = "data-touched";
-  /**
-   * Present when the component's value has changed (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["dirty"] = "data-dirty";
-  /**
-   * Present when the component has a value (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["filled"] = "data-filled";
-  /**
-   * Present when the component is focused (when wrapped in Field.Root).
-   */
-  AutocompleteInputGroupDataAttributes["focused"] = "data-focused";
-  /**
-   * Present when the corresponding items list is empty.
-   */
-  AutocompleteInputGroupDataAttributes["listEmpty"] = "data-list-empty";
-  return AutocompleteInputGroupDataAttributes;
-}({});
+/**
+ * Present when the corresponding popup is open.
+ */
+export const popupOpen = 'data-popup-open';
+/**
+ * Present when the input group is pressed.
+ */
+export const pressed = 'data-pressed';
+/**
+ * Present when the component is disabled.
+ */
+export const disabled = 'data-disabled';
+/**
+ * Present when the component is readonly.
+ */
+export const readonly = 'data-readonly';
+/**
+ * Indicates which side the corresponding popup is positioned relative to its anchor.
+ * @type {'top' | 'bottom' | 'left' | 'right' | 'inline-end' | 'inline-start' | null}
+ */
+export const popupSide = 'data-popup-side';
+/**
+ * Present when the component is in a valid state (when wrapped in Field.Root).
+ */
+export const valid = 'data-valid';
+/**
+ * Present when the component is in an invalid state (when wrapped in Field.Root).
+ */
+export const invalid = 'data-invalid';
+/**
+ * Present when the component has been touched (when wrapped in Field.Root).
+ */
+export const touched = 'data-touched';
+/**
+ * Present when the component's value has changed (when wrapped in Field.Root).
+ */
+export const dirty = 'data-dirty';
+/**
+ * Present when the component has a value (when wrapped in Field.Root).
+ */
+export const filled = 'data-filled';
+/**
+ * Present when the component is focused (when wrapped in Field.Root).
+ */
+export const focused = 'data-focused';
+/**
+ * Present when the corresponding items list is empty.
+ */
+export const listEmpty = 'data-list-empty';

package/autocomplete/item/AutocompleteItemDataAttributes.d.mts

@@ -1,10 +1,8 @@
-export declare enum AutocompleteItemDataAttributes {
-  /**
-   * Present when the item is highlighted.
-   */
-  highlighted = "data-highlighted",
-  /**
-   * Present when the item is disabled.
-   */
-  disabled = "data-disabled",
-}
+/**
+ * Present when the item is highlighted.
+ */
+export declare const highlighted = "data-highlighted";
+/**
+ * Present when the item is disabled.
+ */
+export declare const disabled = "data-disabled";

package/autocomplete/item/AutocompleteItemDataAttributes.d.ts

@@ -1,10 +1,8 @@
-export declare enum AutocompleteItemDataAttributes {
-  /**
-   * Present when the item is highlighted.
-   */
-  highlighted = "data-highlighted",
-  /**
-   * Present when the item is disabled.
-   */
-  disabled = "data-disabled",
-}
+/**
+ * Present when the item is highlighted.
+ */
+export declare const highlighted = "data-highlighted";
+/**
+ * Present when the item is disabled.
+ */
+export declare const disabled = "data-disabled";

package/autocomplete/item/AutocompleteItemDataAttributes.js

@@ -1,18 +1,16 @@
 "use strict";
 
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AutocompleteItemDataAttributes = void 0;
-var _ComboboxItemDataAttributes = require("../../combobox/item/ComboboxItemDataAttributes");
-let AutocompleteItemDataAttributes = exports.AutocompleteItemDataAttributes = function (AutocompleteItemDataAttributes) {
-  /**
-   * Present when the item is highlighted.
-   */
-  AutocompleteItemDataAttributes[AutocompleteItemDataAttributes["highlighted"] = _ComboboxItemDataAttributes.ComboboxItemDataAttributes.highlighted] = "highlighted";
-  /**
-   * Present when the item is disabled.
-   */
-  AutocompleteItemDataAttributes[AutocompleteItemDataAttributes["disabled"] = _ComboboxItemDataAttributes.ComboboxItemDataAttributes.disabled] = "disabled";
-  return AutocompleteItemDataAttributes;
-}({});
+exports.highlighted = exports.disabled = void 0;
+var ComboboxItemDataAttributes = _interopRequireWildcard(require("../../combobox/item/ComboboxItemDataAttributes"));
+/**
+ * Present when the item is highlighted.
+ */
+const highlighted = exports.highlighted = ComboboxItemDataAttributes.highlighted;
+/**
+ * Present when the item is disabled.
+ */
+const disabled = exports.disabled = ComboboxItemDataAttributes.disabled;

package/autocomplete/item/AutocompleteItemDataAttributes.mjs

@@ -1,12 +1,10 @@
-import { ComboboxItemDataAttributes } from "../../combobox/item/ComboboxItemDataAttributes.mjs";
-export let AutocompleteItemDataAttributes = function (AutocompleteItemDataAttributes) {
-  /**
-   * Present when the item is highlighted.
-   */
-  AutocompleteItemDataAttributes[AutocompleteItemDataAttributes["highlighted"] = ComboboxItemDataAttributes.highlighted] = "highlighted";
-  /**
-   * Present when the item is disabled.
-   */
-  AutocompleteItemDataAttributes[AutocompleteItemDataAttributes["disabled"] = ComboboxItemDataAttributes.disabled] = "disabled";
-  return AutocompleteItemDataAttributes;
-}({});
+import * as ComboboxItemDataAttributes from "../../combobox/item/ComboboxItemDataAttributes.mjs";
+
+/**
+ * Present when the item is highlighted.
+ */
+export const highlighted = ComboboxItemDataAttributes.highlighted;
+/**
+ * Present when the item is disabled.
+ */
+export const disabled = ComboboxItemDataAttributes.disabled;

package/autocomplete/root/AutocompleteRoot.d.mts

@@ -1,5 +1,7 @@
 import * as React from 'react';
 import { AriaCombobox, type AriaComboboxState } from "../../combobox/root/AriaCombobox.mjs";
+import type { BaseUIChangeEventDetails } from "../../internals/createBaseUIEventDetails.mjs";
+import { type Group } from "../../internals/resolveValueLabel.mjs";
 /**
  * Groups all parts of the autocomplete.
  * Doesn't render its own HTML element.
@@ -12,6 +14,7 @@ export declare function AutocompleteRoot<Items extends readonly {
   /**
    * The items to be displayed in the list.
    * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
    */
   items: Items;
 }): React.JSX.Element;
@@ -19,6 +22,7 @@ export declare function AutocompleteRoot<ItemValue>(props: Omit<AutocompleteRoot
   /**
    * The items to be displayed in the list.
    * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
    */
   items?: readonly ItemValue[] | undefined;
 }): React.JSX.Element;
@@ -27,15 +31,33 @@ export interface AutocompleteRootActions {
   unmount: () => void;
 }
 export type AutocompleteRootChangeEventReason = AriaCombobox.ChangeEventReason;
-export type AutocompleteRootChangeEventDetails = AriaCombobox.ChangeEventDetails;
+export type AutocompleteRootChangeEventDetails = BaseUIChangeEventDetails<AutocompleteRootChangeEventReason>;
 export type AutocompleteRootHighlightEventReason = AriaCombobox.HighlightEventReason;
 export type AutocompleteRootHighlightEventDetails = AriaCombobox.HighlightEventDetails;
-export interface AutocompleteRootProps<ItemValue> extends Omit<AriaCombobox.Props<ItemValue, 'none'>, 'selectionMode' | 'selectedValue' | 'defaultSelectedValue' | 'onSelectedValueChange' | 'fillInputOnItemPress' | 'itemToStringValue' | 'isItemEqualToValue' | 'inputValue' | 'defaultInputValue' | 'onInputValueChange' | 'autoComplete' | 'formAutoComplete' | 'itemToStringLabel' | 'inline' | 'autoHighlight' | 'keepHighlight' | 'highlightItemOnHover' | 'actionsRef' | 'onOpenChange' | 'openOnInputClick' | 'form'> {
+export interface AutocompleteRootProps<ItemValue> extends Omit<AriaCombobox.Props<ItemValue, 'none'>, 'selectionMode' | 'selectedValue' | 'defaultSelectedValue' | 'onSelectedValueChange' | 'fillInputOnItemPress' | 'itemToStringValue' | 'isItemEqualToValue' | 'inputValue' | 'defaultInputValue' | 'onInputValueChange' | 'autoComplete' | 'formAutoComplete' | 'itemToStringLabel' | 'inline' | 'autoHighlight' | 'keepHighlight' | 'highlightItemOnHover' | 'actionsRef' | 'onOpenChange' | 'openOnInputClick' | 'form' | 'items' | 'filteredItems' | 'filter'> {
   /**
    * Identifies the form that owns the internal input.
    * Useful when the autocomplete is rendered outside the form.
    */
   form?: string | undefined;
+  /**
+   * The items to be displayed in the list.
+   * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
+   */
+  items?: readonly ItemValue[] | readonly Group<ItemValue>[] | undefined;
+  /**
+   * Filtered items to display in the list.
+   * When provided, the list uses these items instead of filtering the `items` prop internally.
+   * When `items` is also provided, this array must preserve its flat or grouped structure.
+   * Nullish entries are not supported, as in `items`.
+   * Use when you want to control filtering logic externally with the `useFilter()` hook.
+   */
+  filteredItems?: readonly ItemValue[] | readonly Group<ItemValue>[] | undefined;
+  /**
+   * Filter function used to match items against the input query.
+   */
+  filter?: AriaCombobox.Props<ItemValue, 'none'>['filter'] | undefined;
   /**
    * Controls how the autocomplete behaves with respect to list filtering and inline autocompletion.
    * - `list` (default): items are dynamically filtered based on the input value. The input value does not change based on the active item.

package/autocomplete/root/AutocompleteRoot.d.ts

@@ -1,5 +1,7 @@
 import * as React from 'react';
 import { AriaCombobox, type AriaComboboxState } from "../../combobox/root/AriaCombobox.js";
+import type { BaseUIChangeEventDetails } from "../../internals/createBaseUIEventDetails.js";
+import { type Group } from "../../internals/resolveValueLabel.js";
 /**
  * Groups all parts of the autocomplete.
  * Doesn't render its own HTML element.
@@ -12,6 +14,7 @@ export declare function AutocompleteRoot<Items extends readonly {
   /**
    * The items to be displayed in the list.
    * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
    */
   items: Items;
 }): React.JSX.Element;
@@ -19,6 +22,7 @@ export declare function AutocompleteRoot<ItemValue>(props: Omit<AutocompleteRoot
   /**
    * The items to be displayed in the list.
    * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
    */
   items?: readonly ItemValue[] | undefined;
 }): React.JSX.Element;
@@ -27,15 +31,33 @@ export interface AutocompleteRootActions {
   unmount: () => void;
 }
 export type AutocompleteRootChangeEventReason = AriaCombobox.ChangeEventReason;
-export type AutocompleteRootChangeEventDetails = AriaCombobox.ChangeEventDetails;
+export type AutocompleteRootChangeEventDetails = BaseUIChangeEventDetails<AutocompleteRootChangeEventReason>;
 export type AutocompleteRootHighlightEventReason = AriaCombobox.HighlightEventReason;
 export type AutocompleteRootHighlightEventDetails = AriaCombobox.HighlightEventDetails;
-export interface AutocompleteRootProps<ItemValue> extends Omit<AriaCombobox.Props<ItemValue, 'none'>, 'selectionMode' | 'selectedValue' | 'defaultSelectedValue' | 'onSelectedValueChange' | 'fillInputOnItemPress' | 'itemToStringValue' | 'isItemEqualToValue' | 'inputValue' | 'defaultInputValue' | 'onInputValueChange' | 'autoComplete' | 'formAutoComplete' | 'itemToStringLabel' | 'inline' | 'autoHighlight' | 'keepHighlight' | 'highlightItemOnHover' | 'actionsRef' | 'onOpenChange' | 'openOnInputClick' | 'form'> {
+export interface AutocompleteRootProps<ItemValue> extends Omit<AriaCombobox.Props<ItemValue, 'none'>, 'selectionMode' | 'selectedValue' | 'defaultSelectedValue' | 'onSelectedValueChange' | 'fillInputOnItemPress' | 'itemToStringValue' | 'isItemEqualToValue' | 'inputValue' | 'defaultInputValue' | 'onInputValueChange' | 'autoComplete' | 'formAutoComplete' | 'itemToStringLabel' | 'inline' | 'autoHighlight' | 'keepHighlight' | 'highlightItemOnHover' | 'actionsRef' | 'onOpenChange' | 'openOnInputClick' | 'form' | 'items' | 'filteredItems' | 'filter'> {
   /**
    * Identifies the form that owns the internal input.
    * Useful when the autocomplete is rendered outside the form.
    */
   form?: string | undefined;
+  /**
+   * The items to be displayed in the list.
+   * Can be either a flat array of items or an array of groups with items.
+   * Nullish entries are not supported: remove them from the data before passing it.
+   */
+  items?: readonly ItemValue[] | readonly Group<ItemValue>[] | undefined;
+  /**
+   * Filtered items to display in the list.
+   * When provided, the list uses these items instead of filtering the `items` prop internally.
+   * When `items` is also provided, this array must preserve its flat or grouped structure.
+   * Nullish entries are not supported, as in `items`.
+   * Use when you want to control filtering logic externally with the `useFilter()` hook.
+   */
+  filteredItems?: readonly ItemValue[] | readonly Group<ItemValue>[] | undefined;
+  /**
+   * Filter function used to match items against the input query.
+   */
+  filter?: AriaCombobox.Props<ItemValue, 'none'>['filter'] | undefined;
   /**
    * Controls how the autocomplete behaves with respect to list filtering and inline autocompletion.
    * - `list` (default): items are dynamically filtered based on the input value. The input value does not change based on the active item.