@mui/material 7.0.1 → 7.0.2

package/esm/useAutocomplete/useAutocomplete.js

@@ -47,8 +47,8 @@ const defaultFilterOptions = createFilterOptions();
 const pageSize = 5;
 const defaultIsActiveElementInListbox = listboxRef => listboxRef.current !== null && listboxRef.current.parentElement?.contains(document.activeElement);
 const MULTIPLE_DEFAULT_VALUE = [];
-function getInputValue(value, multiple, getOptionLabel) {
-  if (multiple || value == null) {
+function getInputValue(value, multiple, getOptionLabel, renderValue) {
+  if (multiple || value == null || renderValue) {
     return '';
   }
   const optionLabel = getOptionLabel(value);
@@ -95,6 +95,7 @@ function useAutocomplete(props) {
     openOnFocus = false,
     options,
     readOnly = false,
+    renderValue,
     selectOnFocus = !props.freeSolo,
     value: valueProp
   } = props;
@@ -116,13 +117,13 @@ function useAutocomplete(props) {
   const inputRef = React.useRef(null);
   const listboxRef = React.useRef(null);
   const [anchorEl, setAnchorEl] = React.useState(null);
-  const [focusedTag, setFocusedTag] = React.useState(-1);
+  const [focusedItem, setFocusedItem] = React.useState(-1);
   const defaultHighlighted = autoHighlight ? 0 : -1;
   const highlightedIndexRef = React.useRef(defaultHighlighted);
 
   // Calculate the initial inputValue on mount only.
-  // Using useRef since defaultValue doesn't need to update inputValue dynamically.
-  const initialInputValue = React.useRef(getInputValue(defaultValue, multiple, getOptionLabel)).current;
+  // useRef ensures it doesn't update dynamically with defaultValue or value props.
+  const initialInputValue = React.useRef(getInputValue(defaultValue ?? valueProp, multiple, getOptionLabel)).current;
   const [value, setValueState] = useControlled({
     controlled: valueProp,
     default: defaultValue,
@@ -142,7 +143,7 @@ function useAutocomplete(props) {
     if (!isOptionSelected && !clearOnBlur) {
       return;
     }
-    const newInputValue = getInputValue(newValue, multiple, getOptionLabel);
+    const newInputValue = getInputValue(newValue, multiple, getOptionLabel, renderValue);
     if (inputValue === newInputValue) {
       return;
     }
@@ -150,7 +151,7 @@ function useAutocomplete(props) {
     if (onInputChange) {
       onInputChange(event, newInputValue, reason);
     }
-  }, [getOptionLabel, inputValue, multiple, onInputChange, setInputValueState, clearOnBlur, value]);
+  }, [getOptionLabel, inputValue, multiple, onInputChange, setInputValueState, clearOnBlur, value, renderValue]);
   const [open, setOpenState] = useControlled({
     controlled: openProp,
     default: false,
@@ -190,21 +191,23 @@ function useAutocomplete(props) {
     resetInputValue(null, value, 'reset');
   }, [value, resetInputValue, focused, previousProps.value, freeSolo]);
   const listboxAvailable = open && filteredOptions.length > 0 && !readOnly;
-  const focusTag = useEventCallback(tagToFocus => {
-    if (tagToFocus === -1) {
+  const focusItem = useEventCallback(itemToFocus => {
+    if (itemToFocus === -1) {
       inputRef.current.focus();
     } else {
-      anchorEl.querySelector(`[data-tag-index="${tagToFocus}"]`).focus();
+      // Using `data-tag-index` for deprecated `renderTags`. Remove when `renderTags` is gone.
+      const indexType = renderValue ? 'data-item-index' : 'data-tag-index';
+      anchorEl.querySelector(`[${indexType}="${itemToFocus}"]`).focus();
     }
   });
 
-  // Ensure the focusedTag is never inconsistent
+  // Ensure the focusedItem is never inconsistent
   React.useEffect(() => {
-    if (multiple && focusedTag > value.length - 1) {
-      setFocusedTag(-1);
-      focusTag(-1);
+    if (multiple && focusedItem > value.length - 1) {
+      setFocusedItem(-1);
+      focusItem(-1);
     }
-  }, [value, multiple, focusedTag, focusTag]);
+  }, [value, multiple, focusedItem, focusItem]);
   function validOptionIndex(index, direction) {
     if (!listboxRef.current || index < 0 || index >= filteredOptions.length) {
       return -1;
@@ -529,7 +532,7 @@ function useAutocomplete(props) {
       inputRef.current.blur();
     }
   };
-  function validTagIndex(index, direction) {
+  function validItemIndex(index, direction) {
     if (index === -1) {
       return -1;
     }
@@ -539,7 +542,10 @@ function useAutocomplete(props) {
       if (direction === 'next' && nextFocus === value.length || direction === 'previous' && nextFocus === -1) {
         return -1;
       }
-      const option = anchorEl.querySelector(`[data-tag-index="${nextFocus}"]`);
+
+      // Using `data-tag-index` for deprecated `renderTags`. Remove when `renderTags` is removed.
+      const indexType = renderValue ? 'data-item-index' : 'data-tag-index';
+      const option = anchorEl.querySelector(`[${indexType}="${nextFocus}"]`);
 
       // Same logic as MenuList.js
       if (!option || !option.hasAttribute('tabindex') || option.disabled || option.getAttribute('aria-disabled') === 'true') {
@@ -549,30 +555,30 @@ function useAutocomplete(props) {
       }
     }
   }
-  const handleFocusTag = (event, direction) => {
+  const handleFocusItem = (event, direction) => {
     if (!multiple) {
       return;
     }
     if (inputValue === '') {
       handleClose(event, 'toggleInput');
     }
-    let nextTag = focusedTag;
-    if (focusedTag === -1) {
+    let nextItem = focusedItem;
+    if (focusedItem === -1) {
       if (inputValue === '' && direction === 'previous') {
-        nextTag = value.length - 1;
+        nextItem = value.length - 1;
       }
     } else {
-      nextTag += direction === 'next' ? 1 : -1;
-      if (nextTag < 0) {
-        nextTag = 0;
+      nextItem += direction === 'next' ? 1 : -1;
+      if (nextItem < 0) {
+        nextItem = 0;
       }
-      if (nextTag === value.length) {
-        nextTag = -1;
+      if (nextItem === value.length) {
+        nextItem = -1;
       }
     }
-    nextTag = validTagIndex(nextTag, direction);
-    setFocusedTag(nextTag);
-    focusTag(nextTag);
+    nextItem = validItemIndex(nextItem, direction);
+    setFocusedItem(nextItem);
+    focusItem(nextItem);
   };
   const handleClear = event => {
     ignoreFocus.current = true;
@@ -589,9 +595,9 @@ function useAutocomplete(props) {
     if (event.defaultMuiPrevented) {
       return;
     }
-    if (focusedTag !== -1 && !['ArrowLeft', 'ArrowRight'].includes(event.key)) {
-      setFocusedTag(-1);
-      focusTag(-1);
+    if (focusedItem !== -1 && !['ArrowLeft', 'ArrowRight'].includes(event.key)) {
+      setFocusedItem(-1);
+      focusItem(-1);
     }
 
     // Wait until IME is settled.
@@ -666,10 +672,18 @@ function useAutocomplete(props) {
           handleOpen(event);
           break;
         case 'ArrowLeft':
-          handleFocusTag(event, 'previous');
+          if (!multiple && renderValue) {
+            focusItem(0);
+          } else {
+            handleFocusItem(event, 'previous');
+          }
           break;
         case 'ArrowRight':
-          handleFocusTag(event, 'next');
+          if (!multiple && renderValue) {
+            focusItem(-1);
+          } else {
+            handleFocusItem(event, 'next');
+          }
           break;
         case 'Enter':
           if (highlightedIndexRef.current !== -1 && popupOpen) {
@@ -702,7 +716,7 @@ function useAutocomplete(props) {
             // Avoid the Modal to handle the event.
             event.stopPropagation();
             handleClose(event, 'escape');
-          } else if (clearOnEscape && (inputValue !== '' || multiple && value.length > 0)) {
+          } else if (clearOnEscape && (inputValue !== '' || multiple && value.length > 0 || renderValue)) {
             // Avoid Opera to exit fullscreen mode.
             event.preventDefault();
             // Avoid the Modal to handle the event.
@@ -713,24 +727,32 @@ function useAutocomplete(props) {
         case 'Backspace':
           // Remove the value on the left of the "cursor"
           if (multiple && !readOnly && inputValue === '' && value.length > 0) {
-            const index = focusedTag === -1 ? value.length - 1 : focusedTag;
+            const index = focusedItem === -1 ? value.length - 1 : focusedItem;
             const newValue = value.slice();
             newValue.splice(index, 1);
             handleValue(event, newValue, 'removeOption', {
               option: value[index]
             });
           }
+          if (!multiple && renderValue && !readOnly) {
+            setValueState(null);
+            focusItem(-1);
+          }
           break;
         case 'Delete':
           // Remove the value on the right of the "cursor"
-          if (multiple && !readOnly && inputValue === '' && value.length > 0 && focusedTag !== -1) {
-            const index = focusedTag;
+          if (multiple && !readOnly && inputValue === '' && value.length > 0 && focusedItem !== -1) {
+            const index = focusedItem;
             const newValue = value.slice();
             newValue.splice(index, 1);
             handleValue(event, newValue, 'removeOption', {
               option: value[index]
             });
           }
+          if (!multiple && renderValue && !readOnly) {
+            setValueState(null);
+            focusItem(-1);
+          }
           break;
         default:
       }
@@ -800,13 +822,18 @@ function useAutocomplete(props) {
     selectNewValue(event, filteredOptions[index], 'selectOption');
     isTouch.current = false;
   };
-  const handleTagDelete = index => event => {
+  const handleItemDelete = index => event => {
     const newValue = value.slice();
     newValue.splice(index, 1);
     handleValue(event, newValue, 'removeOption', {
       option: value[index]
     });
   };
+  const handleSingleItemDelete = event => {
+    handleValue(event, null, 'removeOption', {
+      option: value
+    });
+  };
   const handlePopupIndicator = event => {
     if (open) {
       handleClose(event, 'toggleInput');
@@ -913,11 +940,28 @@ function useAutocomplete(props) {
       type: 'button',
       onClick: handleClear
     }),
+    getItemProps: ({
+      index = 0
+    } = {}) => ({
+      ...(multiple && {
+        key: index
+      }),
+      ...(renderValue ? {
+        'data-item-index': index
+      } : {
+        'data-tag-index': index
+      }),
+      tabIndex: -1,
+      ...(!readOnly && {
+        onDelete: multiple ? handleItemDelete(index) : handleSingleItemDelete
+      })
+    }),
     getPopupIndicatorProps: () => ({
       tabIndex: -1,
       type: 'button',
       onClick: handlePopupIndicator
     }),
+    // deprecated
     getTagProps: ({
       index
     }) => ({
@@ -925,7 +969,7 @@ function useAutocomplete(props) {
       'data-tag-index': index,
       tabIndex: -1,
       ...(!readOnly && {
-        onDelete: handleTagDelete(index)
+        onDelete: handleItemDelete(index)
       })
     }),
     getListboxProps: () => ({
@@ -963,10 +1007,12 @@ function useAutocomplete(props) {
     dirty,
     expanded: popupOpen && anchorEl,
     popupOpen,
-    focused: focused || focusedTag !== -1,
+    focused: focused || focusedItem !== -1,
     anchorEl,
     setAnchorEl,
-    focusedTag,
+    focusedItem,
+    // deprecated
+    focusedTag: focusedItem,
     groupedOptions
   };
 }

package/esm/utils/memoTheme.d.ts

@@ -3,5 +3,5 @@ declare const memoTheme: (styleFn: (props: {
   theme: Theme;
 }) => import("@mui/styled-engine").CSSInterpolation) => (props: {
   theme: Theme;
-}) => string | number | boolean | import("@mui/styled-engine").CSSObject | import("@mui/styled-engine").ComponentSelector | import("@mui/styled-engine").Keyframes | import("@mui/styled-engine").SerializedStyles | import("@mui/styled-engine").ArrayCSSInterpolation | null;
+}) => string | number | boolean | import("@mui/styled-engine").ComponentSelector | import("@mui/styled-engine").Keyframes | import("@mui/styled-engine").SerializedStyles | import("@mui/styled-engine").CSSObject | import("@mui/styled-engine").ArrayCSSInterpolation | null;
 export default memoTheme;

package/esm/version/index.js

@@ -1,6 +1,6 @@
-export const version = "7.0.1";
+export const version = "7.0.2";
 export const major = Number("7");
 export const minor = Number("0");
-export const patch = Number("1");
+export const patch = Number("2");
 export const prerelease = undefined;
 export default version;

package/index.d.ts

@@ -37,7 +37,6 @@ StyledComponentProps<never> & {
 };
 export namespace PropTypes {
   // keeping the type structure for backwards compat
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   type Color = 'inherit' | 'primary' | 'secondary' | 'default';
 }
 

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/material v7.0.1
+ * @mui/material v7.0.2
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/modern/Autocomplete/Autocomplete.d.ts

@@ -35,6 +35,25 @@ export type AutocompleteRenderGetTagProps = ({
   tabIndex: -1;
   onDelete: (event: any) => void;
 };
+export type AutocompleteRenderValueGetItemProps<Multiple extends boolean | undefined> = Multiple extends true ? (args: {
+  index: number;
+}) => {
+  key: number;
+  className: string;
+  disabled: boolean;
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+} : (args?: {
+  index?: number;
+}) => {
+  className: string;
+  disabled: boolean;
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+};
+export type AutocompleteRenderValue<Value, Multiple, FreeSolo> = Multiple extends true ? Array<Value | AutocompleteFreeSoloValueMapping<FreeSolo>> : NonNullable<Value | AutocompleteFreeSoloValueMapping<FreeSolo>>;
 export interface AutocompleteRenderOptionState {
   inputValue: string;
   index: number;
@@ -258,7 +277,9 @@ export interface AutocompleteProps<Value, Multiple extends boolean | undefined,
     key: any;
   }, option: Value, state: AutocompleteRenderOptionState, ownerState: AutocompleteOwnerState<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>) => React.ReactNode;
   /**
-   * Render the selected value.
+   * Render the selected value when doing multiple selections.
+   *
+   * @deprecated Use `renderValue` prop instead
    *
    * @param {Value[]} value The `value` provided to the component.
    * @param {function} getTagProps A tag props getter.
@@ -266,6 +287,15 @@ export interface AutocompleteProps<Value, Multiple extends boolean | undefined,
    * @returns {ReactNode}
    */
   renderTags?: (value: Value[], getTagProps: AutocompleteRenderGetTagProps, ownerState: AutocompleteOwnerState<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>) => React.ReactNode;
+  /**
+   * Renders the selected value(s) as rich content in the input for both single and multiple selections.
+   *
+   * @param {AutocompleteRenderValue<Value, Multiple, FreeSolo>} value The `value` provided to the component.
+   * @param {function} getItemProps The value item props.
+   * @param {object} ownerState The state of the Autocomplete component.
+   * @returns {ReactNode}
+   */
+  renderValue?: (value: AutocompleteRenderValue<Value, Multiple, FreeSolo>, getItemProps: AutocompleteRenderValueGetItemProps<Multiple>, ownerState: AutocompleteOwnerState<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>) => React.ReactNode;
   /**
    * The size of the component.
    * @default 'medium'

package/modern/Dialog/dialogClasses.d.ts

@@ -9,9 +9,13 @@ export interface DialogClasses {
   container: string;
   /** Styles applied to the Paper component. */
   paper: string;
-  /** Styles applied to the Paper component if `scroll="paper"`. */
+  /** Styles applied to the Paper component if `scroll="paper"`.
+   * @deprecated Combine the [.MuiDialog-paper](/material-ui/api/dialog/#dialog-classes-paper) and [.MuiDialog-scrollPaper](/material-ui/api/dialog/#dialog-classes-scrollPaper) classes instead. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
+   */
   paperScrollPaper: string;
-  /** Styles applied to the Paper component if `scroll="body"`. */
+  /** Styles applied to the Paper component if `scroll="body"`.
+   * @deprecated Combine the [.MuiDialog-paper](/material-ui/api/dialog/#dialog-classes-paper) and [.MuiDialog-scrollBody](/material-ui/api/dialog/#dialog-classes-scrollBody) classes instead. See [Migrating from deprecated APIs](/material-ui/migration/migrating-from-deprecated-apis/) for more details.
+   */
   paperScrollBody: string;
   /** Styles applied to the Paper component if `maxWidth=false`. */
   paperWidthFalse: string;

package/modern/SvgIcon/SvgIcon.d.ts

@@ -42,7 +42,7 @@ export interface SvgIconOwnProps {
   inheritViewBox?: boolean;
   /**
    * The shape-rendering attribute. The behavior of the different options is described on the
-   * [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/shape-rendering).
+   * [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/shape-rendering).
    * If you are having issues with blurry icons you should investigate this prop.
    */
   shapeRendering?: string;

package/modern/index.d.ts

@@ -37,7 +37,6 @@ StyledComponentProps<never> & {
 };
 export namespace PropTypes {
   // keeping the type structure for backwards compat
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   type Color = 'inherit' | 'primary' | 'secondary' | 'default';
 }
 

package/modern/useAutocomplete/useAutocomplete.d.ts

@@ -281,6 +281,20 @@ export interface AutocompleteChangeDetails<Value = string> {
 }
 export type AutocompleteCloseReason = 'createOption' | 'toggleInput' | 'escape' | 'selectOption' | 'removeOption' | 'blur';
 export type AutocompleteInputChangeReason = 'input' | 'reset' | 'clear' | 'blur' | 'selectOption' | 'removeOption';
+export type AutocompleteGetItemProps<Multiple extends boolean | undefined> = Multiple extends true ? (args: {
+  index: number;
+}) => {
+  key: number;
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+} : (args?: {
+  index?: number;
+}) => {
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+};
 export type AutocompleteGetTagProps = ({
   index
 }: {
@@ -331,12 +345,18 @@ export interface UseAutocompleteReturnValue<Value, Multiple extends boolean | un
    * @returns props that should be spread on the *clear* button element
    */
   getClearProps: () => React.HTMLAttributes<HTMLButtonElement>;
+  /**
+   * An item props getter
+   */
+  getItemProps: AutocompleteGetItemProps<Multiple>;
   /**
    * Resolver for the popup icon's props.
    * @returns props that should be spread on the popup icon
    */
   getPopupIndicatorProps: () => React.HTMLAttributes<HTMLButtonElement>;
   /**
+   * @deprecated Use `getItemProps` instead
+   *
    * A tag props getter.
    */
   getTagProps: AutocompleteGetTagProps;
@@ -391,6 +411,12 @@ export interface UseAutocompleteReturnValue<Value, Multiple extends boolean | un
    */
   setAnchorEl: () => void;
   /**
+   * Index of the focused item for the component.
+   */
+  focusedItem: number;
+  /**
+   * @deprecated Use `focusedItem` instead
+   *
    * Index of the focused tag for the component.
    */
   focusedTag: number;

package/modern/utils/memoTheme.d.ts

@@ -3,5 +3,5 @@ declare const memoTheme: (styleFn: (props: {
   theme: Theme;
 }) => import("@mui/styled-engine").CSSInterpolation) => (props: {
   theme: Theme;
-}) => string | number | boolean | import("@mui/styled-engine").CSSObject | import("@mui/styled-engine").ComponentSelector | import("@mui/styled-engine").Keyframes | import("@mui/styled-engine").SerializedStyles | import("@mui/styled-engine").ArrayCSSInterpolation | null;
+}) => string | number | boolean | import("@mui/styled-engine").ComponentSelector | import("@mui/styled-engine").Keyframes | import("@mui/styled-engine").SerializedStyles | import("@mui/styled-engine").CSSObject | import("@mui/styled-engine").ArrayCSSInterpolation | null;
 export default memoTheme;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/material",
-  "version": "7.0.1",
+  "version": "7.0.2",
   "private": false,
   "author": "MUI Team",
   "description": "Material UI is an open-source React component library that implements Google's Material Design. It's comprehensive and can be used in production out of the box.",
@@ -27,18 +27,18 @@
     "url": "https://opencollective.com/mui-org"
   },
   "dependencies": {
-    "@babel/runtime": "^7.26.10",
+    "@babel/runtime": "^7.27.0",
     "@popperjs/core": "^2.11.8",
     "@types/react-transition-group": "^4.4.12",
     "clsx": "^2.1.1",
     "csstype": "^3.1.3",
     "prop-types": "^15.8.1",
-    "react-is": "^19.0.0",
+    "react-is": "^19.1.0",
     "react-transition-group": "^4.4.5",
-    "@mui/core-downloads-tracker": "^7.0.1",
-    "@mui/types": "^7.4.0",
-    "@mui/system": "^7.0.1",
-    "@mui/utils": "^7.0.1"
+    "@mui/core-downloads-tracker": "^7.0.2",
+    "@mui/types": "^7.4.1",
+    "@mui/utils": "^7.0.2",
+    "@mui/system": "^7.0.2"
   },
   "peerDependencies": {
     "@emotion/react": "^11.5.0",
@@ -46,7 +46,7 @@
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0",
     "react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0",
-    "@mui/material-pigment-css": "^7.0.1"
+    "@mui/material-pigment-css": "^7.0.2"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -80,10 +80,6 @@
       "import": {
         "types": "./esm/index.d.ts",
         "default": "./esm/index.js"
-      },
-      "mui-modern": {
-        "types": "./modern/index.d.ts",
-        "default": "./modern/index.js"
       }
     },
     "./*": {
@@ -94,10 +90,6 @@
       "import": {
         "types": "./esm/*/index.d.ts",
         "default": "./esm/*/index.js"
-      },
-      "mui-modern": {
-        "types": "./modern/*/index.d.ts",
-        "default": "./modern/*/index.js"
       }
     },
     "./esm": null,
@@ -110,10 +102,6 @@
       "import": {
         "types": "./esm/ButtonBase/TouchRipple.d.ts",
         "default": "./esm/ButtonBase/TouchRipple.js"
-      },
-      "mui-modern": {
-        "types": "./modern/ButtonBase/TouchRipple.d.ts",
-        "default": "./modern/ButtonBase/TouchRipple.js"
       }
     }
   },

package/useAutocomplete/useAutocomplete.d.ts

@@ -281,6 +281,20 @@ export interface AutocompleteChangeDetails<Value = string> {
 }
 export type AutocompleteCloseReason = 'createOption' | 'toggleInput' | 'escape' | 'selectOption' | 'removeOption' | 'blur';
 export type AutocompleteInputChangeReason = 'input' | 'reset' | 'clear' | 'blur' | 'selectOption' | 'removeOption';
+export type AutocompleteGetItemProps<Multiple extends boolean | undefined> = Multiple extends true ? (args: {
+  index: number;
+}) => {
+  key: number;
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+} : (args?: {
+  index?: number;
+}) => {
+  'data-item-index': number;
+  tabIndex: -1;
+  onDelete: (event: any) => void;
+};
 export type AutocompleteGetTagProps = ({
   index
 }: {
@@ -331,12 +345,18 @@ export interface UseAutocompleteReturnValue<Value, Multiple extends boolean | un
    * @returns props that should be spread on the *clear* button element
    */
   getClearProps: () => React.HTMLAttributes<HTMLButtonElement>;
+  /**
+   * An item props getter
+   */
+  getItemProps: AutocompleteGetItemProps<Multiple>;
   /**
    * Resolver for the popup icon's props.
    * @returns props that should be spread on the popup icon
    */
   getPopupIndicatorProps: () => React.HTMLAttributes<HTMLButtonElement>;
   /**
+   * @deprecated Use `getItemProps` instead
+   *
    * A tag props getter.
    */
   getTagProps: AutocompleteGetTagProps;
@@ -391,6 +411,12 @@ export interface UseAutocompleteReturnValue<Value, Multiple extends boolean | un
    */
   setAnchorEl: () => void;
   /**
+   * Index of the focused item for the component.
+   */
+  focusedItem: number;
+  /**
+   * @deprecated Use `focusedItem` instead
+   *
    * Index of the focused tag for the component.
    */
   focusedTag: number;