@mui/utils 9.0.0-beta.0 → 9.0.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # [Versions](https://mui.com/versions/)
 
+## 9.0.0-beta.1
+
+<!-- generated comparing v9.0.0-beta.0..master -->
+
+_Apr 2, 2026_
+
+A big thanks to the 11 contributors who made this release possible.
+
+### `@mui/material@9.0.0-beta.1`
+
+#### Breaking Changes
+
+- [grid] Remove 'column' and 'column-reverse' options from `direction` prop (#47564) @sai6855
+- [icons] Remove legacy `*Outline` icons (#48116) @mj12albert
+- [list-item-icon] Use theme spacing instead of hardcoded minWidth (#46597) @adiitxa
+
+#### Changes
+
+- [all components] Fix `slotProps.transition` types (#48153) @mj12albert
+- [alert][dialog] Accessibility improvements (#48113) @silviuaavram
+- [autocomplete] Fix helper text focusing input when clicked (#48156) @mj12albert
+- [button-base] Add `nativeButton` prop (#47989) @mj12albert
+- [input] Fix high contrast cutoff on first character (#48150) @silviuaavram
+- [menu] Fix empty roving focus container (#48114) @mj12albert
+- [utils] Explicitly register roving tab items with parent (#48122) @mj12albert
+
+### Docs
+
+- Fix HTML validation errors (#48107) @Janpot
+- Fix duplicate IDs and HTML validation issues (#48095) @Janpot
+- Fix the dark mode footer row shadow for the Data Grid on the advanced components page (#48149) @arminmeh
+- Improve jsdom section (#48098) @oliviertassinari
+- Update "Deprecated APIs removed" section to h2 in "Upgrade to v9" docs (#48115) @ZeeshanTamboli
+- [docs][progress] Label all demo components (#48143) @mj12albert
+- [docs-infra] Add x-scheduler to component API URL resolver (#48097) @rita-codes
+- [docs-infra] Resolve some redirects (#48165) @Janpot
+- [docs-infra] Update v9 Search Index (#48028) @dav-is
+
+### Core
+
+- [code-infra] Discover exports for bundle size report (#48170) @Janpot
+- [internal] Fix use of ellipsis (#48096) @oliviertassinari
+- [test] Add screenshot test for Virtualized Table (#47947) @mnajdova
+- [test] Remove `componentsProp` from `describeConformance` tests (#48142) @ZeeshanTamboli
+- [theme] Do not create channel tokens for custom colors when `nativeColor` is used (#47765) @ZeeshanTamboli
+
+All contributors of this release in alphabetical order: @adiitxa, @arminmeh, @dav-is, @Janpot, @mj12albert, @mnajdova, @oliviertassinari, @rita-codes, @sai6855, @silviuaavram, @ZeeshanTamboli
+
 ## 9.0.0-beta.0
 
 <!-- generated comparing v9.0.0-alpha.4..master -->

package/fastObjectShallowCompare/fastObjectShallowCompare.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;

package/fastObjectShallowCompare/fastObjectShallowCompare.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;

package/fastObjectShallowCompare/fastObjectShallowCompare.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = fastObjectShallowCompare;
+// From mui-x: https://github.com/mui/mui-x/blob/bb92fb0adac6764461adea9a9d7d43f1095f49e5/packages/x-internals/src/fastObjectShallowCompare/fastObjectShallowCompare.ts
+/* eslint-disable guard-for-in */
+
+const is = Object.is;
+
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+function fastObjectShallowCompare(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (!(a instanceof Object) || !(b instanceof Object)) {
+    return false;
+  }
+  let aLength = 0;
+  let bLength = 0;
+  for (const key in a) {
+    aLength += 1;
+    if (!is(a[key], b[key])) {
+      return false;
+    }
+    if (!(key in b)) {
+      return false;
+    }
+  }
+
+  // eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unused-vars
+  for (const _ in b) {
+    bLength += 1;
+  }
+  return aLength === bLength;
+}

package/fastObjectShallowCompare/fastObjectShallowCompare.mjs

@@ -0,0 +1,35 @@
+// From mui-x: https://github.com/mui/mui-x/blob/bb92fb0adac6764461adea9a9d7d43f1095f49e5/packages/x-internals/src/fastObjectShallowCompare/fastObjectShallowCompare.ts
+/* eslint-disable guard-for-in */
+
+const is = Object.is;
+
+/**
+ * Fast shallow compare for plain objects.
+ * Returns `true` when both objects have the same own enumerable keys and each value is equal
+ * according to `Object.is()`.
+ */
+export default function fastObjectShallowCompare(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (!(a instanceof Object) || !(b instanceof Object)) {
+    return false;
+  }
+  let aLength = 0;
+  let bLength = 0;
+  for (const key in a) {
+    aLength += 1;
+    if (!is(a[key], b[key])) {
+      return false;
+    }
+    if (!(key in b)) {
+      return false;
+    }
+  }
+
+  // eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unused-vars
+  for (const _ in b) {
+    bLength += 1;
+  }
+  return aLength === bLength;
+}

package/fastObjectShallowCompare/index.d.mts

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.mjs";

package/fastObjectShallowCompare/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.js";

package/fastObjectShallowCompare/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _fastObjectShallowCompare.default;
+  }
+});
+var _fastObjectShallowCompare = _interopRequireDefault(require("./fastObjectShallowCompare"));

package/fastObjectShallowCompare/index.mjs

@@ -0,0 +1 @@
+export { default } from "./fastObjectShallowCompare.mjs";

package/index.d.mts

@@ -15,6 +15,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.mjs";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.mjs";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.mjs";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.mjs";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.mjs";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.mjs";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.mjs";
@@ -51,5 +52,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.mjs";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.mjs";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.mjs";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.mjs";
 export * from "./types/index.mjs";

package/index.d.ts

@@ -15,6 +15,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.js";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.js";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.js";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.js";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.js";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.js";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.js";
@@ -51,5 +52,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.js";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.js";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.js";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.js";
 export * from "./types/index.js";

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v9.0.0-beta.0
+ * @mui/utils v9.0.0-beta.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -30,6 +30,7 @@ var _exportNames = {
   unstable_debounce: true,
   unstable_deprecatedPropType: true,
   unstable_fastDeepAssign: true,
+  unstable_fastObjectShallowCompare: true,
   unstable_isObjectEmpty: true,
   unstable_isMuiElement: true,
   unstable_ownerDocument: true,
@@ -64,8 +65,7 @@ var _exportNames = {
   unstable_resolveComponentProps: true,
   unstable_extractEventHandlers: true,
   unstable_getReactNodeRef: true,
-  unstable_getReactElementRef: true,
-  unstable_useRovingTabIndex: true
+  unstable_getReactElementRef: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -211,6 +211,12 @@ Object.defineProperty(exports, "unstable_fastDeepAssign", {
     return _fastDeepAssign.default;
   }
 });
+Object.defineProperty(exports, "unstable_fastObjectShallowCompare", {
+  enumerable: true,
+  get: function () {
+    return _fastObjectShallowCompare.default;
+  }
+});
 Object.defineProperty(exports, "unstable_generateUtilityClass", {
   enumerable: true,
   get: function () {
@@ -355,12 +361,6 @@ Object.defineProperty(exports, "unstable_useOnMount", {
     return _useOnMount.default;
   }
 });
-Object.defineProperty(exports, "unstable_useRovingTabIndex", {
-  enumerable: true,
-  get: function () {
-    return _useRovingTabIndex.default;
-  }
-});
 Object.defineProperty(exports, "unstable_useSlotProps", {
   enumerable: true,
   get: function () {
@@ -401,6 +401,7 @@ var _createChainedFunction = _interopRequireDefault(require("./createChainedFunc
 var _debounce = _interopRequireDefault(require("./debounce"));
 var _deprecatedPropType = _interopRequireDefault(require("./deprecatedPropType"));
 var _fastDeepAssign = _interopRequireDefault(require("./fastDeepAssign"));
+var _fastObjectShallowCompare = _interopRequireDefault(require("./fastObjectShallowCompare"));
 var _isObjectEmpty = _interopRequireDefault(require("./isObjectEmpty"));
 var _isMuiElement = _interopRequireDefault(require("./isMuiElement"));
 var _ownerDocument = _interopRequireDefault(require("./ownerDocument"));
@@ -445,7 +446,6 @@ var _resolveComponentProps = _interopRequireDefault(require("./resolveComponentP
 var _extractEventHandlers = _interopRequireDefault(require("./extractEventHandlers"));
 var _getReactNodeRef = _interopRequireDefault(require("./getReactNodeRef"));
 var _getReactElementRef = _interopRequireDefault(require("./getReactElementRef"));
-var _useRovingTabIndex = _interopRequireDefault(require("./useRovingTabIndex"));
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v9.0.0-beta.0
+ * @mui/utils v9.0.0-beta.1
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -22,6 +22,7 @@ export { default as unstable_createChainedFunction } from "./createChainedFuncti
 export { default as unstable_debounce } from "./debounce/index.mjs";
 export { default as unstable_deprecatedPropType } from "./deprecatedPropType/index.mjs";
 export { default as unstable_fastDeepAssign } from "./fastDeepAssign/index.mjs";
+export { default as unstable_fastObjectShallowCompare } from "./fastObjectShallowCompare/index.mjs";
 export { default as unstable_isObjectEmpty } from "./isObjectEmpty/index.mjs";
 export { default as unstable_isMuiElement } from "./isMuiElement/index.mjs";
 export { default as unstable_ownerDocument } from "./ownerDocument/index.mjs";
@@ -57,5 +58,4 @@ export { default as unstable_resolveComponentProps } from "./resolveComponentPro
 export { default as unstable_extractEventHandlers } from "./extractEventHandlers/index.mjs";
 export { default as unstable_getReactNodeRef } from "./getReactNodeRef/index.mjs";
 export { default as unstable_getReactElementRef } from "./getReactElementRef/index.mjs";
-export { default as unstable_useRovingTabIndex } from "./useRovingTabIndex/index.mjs";
 export * from "./types/index.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "9.0.0-beta.0",
+  "version": "9.0.0-beta.1",
   "author": "MUI Team",
   "description": "Utility functions for React components.",
   "keywords": [
@@ -288,6 +288,20 @@
         "default": "./fastDeepAssign/index.mjs"
       }
     },
+    "./fastObjectShallowCompare": {
+      "import": {
+        "types": "./fastObjectShallowCompare/index.d.mts",
+        "default": "./fastObjectShallowCompare/index.mjs"
+      },
+      "require": {
+        "types": "./fastObjectShallowCompare/index.d.ts",
+        "default": "./fastObjectShallowCompare/index.js"
+      },
+      "default": {
+        "types": "./fastObjectShallowCompare/index.d.mts",
+        "default": "./fastObjectShallowCompare/index.mjs"
+      }
+    },
     "./formatMuiErrorMessage": {
       "import": {
         "types": "./formatMuiErrorMessage/index.d.mts",

package/useRovingTabIndex/RovingTabIndexContext.d.mts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { UseRovingTabIndexReturnValue } from "./useRovingTabIndex.mjs";
+type RovingTabIndexContextValue = UseRovingTabIndexReturnValue<unknown>;
+export declare const RovingTabIndexContext: React.Context<RovingTabIndexContextValue | undefined>;
+export declare function useRovingTabIndexContext(): RovingTabIndexContextValue;
+export {};

package/useRovingTabIndex/RovingTabIndexContext.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { UseRovingTabIndexReturnValue } from "./useRovingTabIndex.js";
+type RovingTabIndexContextValue = UseRovingTabIndexReturnValue<unknown>;
+export declare const RovingTabIndexContext: React.Context<RovingTabIndexContextValue | undefined>;
+export declare function useRovingTabIndexContext(): RovingTabIndexContextValue;
+export {};

package/useRovingTabIndex/RovingTabIndexContext.js

@@ -0,0 +1,21 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RovingTabIndexContext = void 0;
+exports.useRovingTabIndexContext = useRovingTabIndexContext;
+var React = _interopRequireWildcard(require("react"));
+const RovingTabIndexContext = exports.RovingTabIndexContext = /*#__PURE__*/React.createContext(undefined);
+if (process.env.NODE_ENV !== 'production') {
+  RovingTabIndexContext.displayName = 'RovingTabIndexContext';
+}
+function useRovingTabIndexContext() {
+  const context = React.useContext(RovingTabIndexContext);
+  if (context === undefined) {
+    throw new Error('MUI: RovingTabIndexContext is missing. Roving tab index items must be placed within a roving tab index provider.');
+  }
+  return context;
+}

package/useRovingTabIndex/RovingTabIndexContext.mjs

@@ -0,0 +1,14 @@
+'use client';
+
+import * as React from 'react';
+export const RovingTabIndexContext = /*#__PURE__*/React.createContext(undefined);
+if (process.env.NODE_ENV !== 'production') {
+  RovingTabIndexContext.displayName = 'RovingTabIndexContext';
+}
+export function useRovingTabIndexContext() {
+  const context = React.useContext(RovingTabIndexContext);
+  if (context === undefined) {
+    throw new Error('MUI: RovingTabIndexContext is missing. Roving tab index items must be placed within a roving tab index provider.');
+  }
+  return context;
+}

package/useRovingTabIndex/index.d.mts

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.mjs";
+export * from "./RovingTabIndexContext.mjs";
+export * from "./useRovingTabIndex.mjs";

package/useRovingTabIndex/index.d.ts

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.js";
+export * from "./RovingTabIndexContext.js";
+export * from "./useRovingTabIndex.js";

package/useRovingTabIndex/index.js

@@ -1,13 +1,27 @@
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "default", {
-  enumerable: true,
-  get: function () {
-    return _useRovingTabIndex.default;
-  }
+var _RovingTabIndexContext = require("./RovingTabIndexContext");
+Object.keys(_RovingTabIndexContext).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _RovingTabIndexContext[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _RovingTabIndexContext[key];
+    }
+  });
 });
-var _useRovingTabIndex = _interopRequireDefault(require("./useRovingTabIndex"));
+var _useRovingTabIndex = require("./useRovingTabIndex");
+Object.keys(_useRovingTabIndex).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useRovingTabIndex[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _useRovingTabIndex[key];
+    }
+  });
+});

package/useRovingTabIndex/index.mjs

@@ -1 +1,2 @@
-export { default } from "./useRovingTabIndex.mjs";
+export * from "./RovingTabIndexContext.mjs";
+export * from "./useRovingTabIndex.mjs";

package/useRovingTabIndex/useRovingTabIndex.d.mts

@@ -1,31 +1,179 @@
 import * as React from 'react';
-export type UseRovingTabIndexOptions = {
-  focusableIndex?: number | undefined;
+export interface Item<Key = unknown> {
+  /**
+   * The logical id used to track the item across reorders and re-renders.
+   * Components such as `Tabs` use the tab value here, while `MenuItem` generates an internal id.
+   */
+  id: Key;
+  /**
+   * The item's current DOM element.
+   */
+  element: HTMLElement | null;
+  /**
+   * Whether the item ignores user interaction.
+   */
+  disabled: boolean;
+  /**
+   * Whether a disabled item should still be allowed to receive roving focus.
+   * `MenuList` uses this for its `disabledItemsFocusable` behavior.
+   */
+  focusableWhenDisabled: boolean;
+  /**
+   * An optional text string used for typeahead matching.
+   */
+  textValue?: string | undefined;
+  /**
+   * Whether the item is currently selected in the consumer component's own state model.
+   * `MenuList` uses this when `variant="selectedMenu"` to prefer the selected item by default,
+   * and `Tabs` sets this on the selected tab.
+   */
+  selected: boolean;
+}
+export interface UseRovingTabIndexParams<Key = unknown> {
+  /**
+   * The logical item id that should own `tabIndex=0`.
+   *
+   * Pass a concrete id when the consumer wants to drive roving focus explicitly.
+   * For example, `Tabs` uses the selected tab value here when focus is outside the list so
+   * that keyboard focus re-enters on the selected tab.
+   *
+   * `undefined` means "the hook should choose the active item using its default-item logic".
+   * `null` means "there is intentionally no preferred item", which also falls back to the
+   * default-item logic.
+   */
+  activeItemId?: Key | null | undefined;
+  /**
+   * Chooses the default item when `activeItemId` is not driving the tab stop directly.
+   *
+   * `MenuList` uses this to prefer the selected item when `variant="selectedMenu"`, then
+   * falls back to the first focusable item.
+   */
+  getDefaultActiveItemId?: ((items: Item<Key>[]) => Key | null) | undefined;
+  /**
+   * The axis used by arrow-key navigation.
+   */
   orientation: 'horizontal' | 'vertical';
+  /**
+   * Whether horizontal keyboard navigation should follow right-to-left semantics.
+   * Only affects horizontal lists.
+   * @default false
+   */
   isRtl?: boolean | undefined;
-  shouldFocus?: ((element: HTMLElement | null) => boolean) | undefined;
-  shouldWrap?: boolean | undefined;
-};
-type UseRovingTabIndexReturn = {
-  getItemProps: (index: number, ref?: React.Ref<HTMLElement>) => {
-    ref: (element: HTMLElement | null) => void;
-    tabIndex: number;
-  };
+  /**
+   * Filters items out of roving navigation without removing them from the registry.
+   * For example, `MenuList` uses this so disabled menu items can stay registered while still
+   * being skipped for roving focus unless `disabledItemsFocusable` is enabled.
+   */
+  isItemFocusable?: ((item: Item<Key>) => boolean) | undefined;
+  /**
+   * Whether keyboard navigation should wrap from the last item back to the first, and vice versa.
+   * @default true
+   */
+  wrap?: boolean | undefined;
+}
+export interface UseRovingTabIndexReturnValue<Key = unknown> {
+  /**
+   * The item id that currently owns `tabIndex=0` for this render.
+   */
+  activeItemId: Key | null;
+  /**
+   * Imperatively moves focus to the next matching item.
+   * Consumers such as `MenuList` use this for typeahead and other non-arrow-key navigation.
+   */
+  focusNext: (isItemFocusableOverride?: (item: Item<Key>) => boolean) => Key | null;
+  /**
+   * Returns the current active item record from a fresh registry snapshot.
+   */
+  getActiveItem: () => Item<Key> | null;
+  /**
+   * Returns the props that enable roving behavior on the container element.
+   *
+   * Spread these props onto the list or composite root element that should listen for focus
+   * and keyboard events.
+   */
   getContainerProps: (ref?: React.Ref<HTMLElement>) => {
+    /**
+     * Keeps the active item in sync when focus moves onto one of the registered items.
+     */
     onFocus: (event: React.FocusEvent<HTMLElement>) => void;
+    /**
+     * Handles arrow-key, Home, and End navigation for the roving set.
+     */
     onKeyDown: (event: React.KeyboardEvent<HTMLElement>) => void;
+    /**
+     * Merges the consumer ref with the internal container ref used by the hook.
+     */
     ref: (element: HTMLElement | null) => void;
   };
-  focusNext: (shouldSkipFocusOverride?: (element: HTMLElement | null) => boolean) => number;
-};
+  /**
+   * Returns the current item registry.
+   * The map is keyed by item id and stores normalized item records.
+   */
+  getItemMap: () => Map<Key, Item<Key>>;
+  /**
+   * Reports whether the supplied item id currently owns `tabIndex=0`.
+   */
+  isItemActive: (itemId: Key) => boolean;
+  /**
+   * Registers or updates an item in the roving registry.
+   */
+  registerItem: (item: Item<Key>) => void;
+  /**
+   * Updates the current active item id.
+   */
+  setActiveItemId: (itemId: Key | null) => void;
+  /**
+   * Removes an item from the roving registry.
+   */
+  unregisterItem: (itemId: Key) => void;
+}
+export interface UseRovingTabIndexItemParams<Key = unknown> {
+  /**
+   * The logical id that will be used as the item's registry key.
+   */
+  id: Key;
+  /**
+   * The consumer's ref for the item's DOM element.
+   * The item hook merges this with its own registration ref callback.
+   */
+  ref?: React.Ref<HTMLElement> | undefined;
+  /**
+   * Whether the item ignores user interaction.
+   * @default false
+   */
+  disabled?: boolean | undefined;
+  /**
+   * Whether the item should still be focusable even when `disabled` is true.
+   * @default false
+   */
+  focusableWhenDisabled?: boolean | undefined;
+  /**
+   * An optional text string used for typeahead matching.
+   */
+  textValue?: string | undefined;
+  /**
+   * Whether the item is selected in the consumer component's state model.
+   * @default false
+   */
+  selected?: boolean | undefined;
+}
+export interface UseRovingTabIndexItemReturnValue {
+  /**
+   * The merged ref callback that registers the item element with the root registry.
+   */
+  ref: React.RefCallback<HTMLElement | null>;
+  /**
+   * The `tabIndex` that should be applied to the item element.
+   * The active item receives `0`; every other item receives `-1`.
+   */
+  tabIndex: number;
+}
 /**
- * Provides roving tab index behavior for a container and its focusable children.
+ * Provides roving tab index behavior for a composite container and its focusable children.
  * This is useful for implementing keyboard navigation in components like menus, tabs, and lists.
  * The hook manages the focus state of child elements and provides props to be spread on both the container and the items.
  * The container will handle keyboard events to move focus between items based on the specified orientation and wrapping behavior.
- *
- * @param options - Configuration options for the roving tab index behavior, including orientation, initial focusable index, RTL support, and custom focus logic.
- * @returns An object containing `getItemProps` and `getContainerProps` functions to be spread on the respective elements, and a `focusNext` function to programmatically move focus to the next item.
  */
-export default function useRovingTabIndex(options: UseRovingTabIndexOptions): UseRovingTabIndexReturn;
-export {};
+export declare function useRovingTabIndexRoot<Key = unknown>(params: UseRovingTabIndexParams<Key>): UseRovingTabIndexReturnValue<Key>;
+export declare function useRovingTabIndexItem<Key = unknown>(params: UseRovingTabIndexItemParams<Key>): UseRovingTabIndexItemReturnValue;
+export declare function isItemFocusable(item: Item<unknown>): boolean;