[useTabs] Add explicit return type

docs/pages/base/api/use-tabs.json

@@ -28,7 +28,15 @@
       "type": { "name": "string | number | false", "description": "string | number | false" }
     }
   },
-  "returnValue": {},
+  "returnValue": {
+    "tabsContextValue": {
+      "type": {
+        "name": "{\n  idPrefix: string | undefined\n  value: string | number | false\n  onSelected: (e: React.SyntheticEvent, newValue: string | number | false) =&gt void\n  orientation?: 'horizontal' | 'vertical'\n  direction: 'ltr' | 'rtl' | undefined\n  selectionFollowsFocus: boolean | undefined\n}",
+        "description": "{\n  idPrefix: string | undefined\n  value: string | number | false\n  onSelected: (e: React.SyntheticEvent, newValue: string | number | false) =&gt void\n  orientation?: 'horizontal' | 'vertical'\n  direction: 'ltr' | 'rtl' | undefined\n  selectionFollowsFocus: boolean | undefined\n}"
+      },
+      "required": true
+    }
+  },
   "name": "useTabs",
   "filename": "/packages/mui-base/src/useTabs/useTabs.ts",
   "demos": "<ul><li><a href=\"/base/react-tabs/#hooks\">Unstyled Tabs</a></li></ul>"

packages/mui-base/src/useTabs/index.ts

@@ -1,2 +1,2 @@
 export { default } from './useTabs';
-export * from './useTabs';
+export * from './useTabs.types';

packages/mui-base/src/useTabs/useTabs.ts

@@ -1,36 +1,7 @@
 import * as React from 'react';
 import { unstable_useControlled as useControlled, unstable_useId as useId } from '@mui/utils';
+import { UseTabsParameters, UseTabsReturnValue } from './useTabs.types';
 
-export interface UseTabsParameters {
-  /**
-   * The value of the currently selected `Tab`.
-   * If you don't want any selected `Tab`, you can set this prop to `false`.
-   */
-  value?: string | number | false;
-  /**
-   * The default value. Use when the component is not controlled.
-   */
-  defaultValue?: string | number | false;
-  /**
-   * The component orientation (layout flow direction).
-   * @default 'horizontal'
-   */
-  orientation?: 'horizontal' | 'vertical';
-  /**
-   * The direction of the text.
-   * @default 'ltr'
-   */
-  direction?: 'ltr' | 'rtl';
-  /**
-   * Callback invoked when new value is being set.
-   */
-  onChange?: (event: React.SyntheticEvent, value: number | string | boolean) => void;
-  /**
-   * If `true` the selected tab changes on focus. Otherwise it only
-   * changes on activation.
-   */
-  selectionFollowsFocus?: boolean;
-}
 /**
  *
  * Demos:
@@ -41,7 +12,7 @@ export interface UseTabsParameters {
  *
  * - [useTabs API](https://mui.com/base/api/use-tabs/)
  */
-function useTabs(parameters: UseTabsParameters) {
+function useTabs(parameters: UseTabsParameters): UseTabsReturnValue {
   const {
     value: valueProp,
     defaultValue,

packages/mui-base/src/useTabs/useTabs.types.ts

@@ -0,0 +1,41 @@
+export interface UseTabsParameters {
+  /**
+   * The value of the currently selected `Tab`.
+   * If you don't want any selected `Tab`, you can set this prop to `false`.
+   */
+  value?: string | number | false;
+  /**
+   * The default value. Use when the component is not controlled.
+   */
+  defaultValue?: string | number | false;
+  /**
+   * The component orientation (layout flow direction).
+   * @default 'horizontal'
+   */
+  orientation?: 'horizontal' | 'vertical';
+  /**
+   * The direction of the text.
+   * @default 'ltr'
+   */
+  direction?: 'ltr' | 'rtl';
+  /**
+   * Callback invoked when new value is being set.
+   */
+  onChange?: (event: React.SyntheticEvent, value: number | string | boolean) => void;
+  /**
+   * If `true` the selected tab changes on focus. Otherwise it only
+   * changes on activation.
+   */
+  selectionFollowsFocus?: boolean;
+}
+
+export interface UseTabsReturnValue {
+  tabsContextValue: {
+    idPrefix: string | undefined;
+    value: string | number | false;
+    onSelected: (e: React.SyntheticEvent, newValue: string | number | false) => void;
+    orientation?: 'horizontal' | 'vertical';
+    direction: 'ltr' | 'rtl' | undefined;
+    selectionFollowsFocus: boolean | undefined;
+  };
+}