[base] Add explicit interfaces for the return values of the public hooks

[mnajdova]

Summary 💡

As we are adding API pages for the public hooks of MUI Base, we need to have explicit interfaces for the return values. The interfaces' names should follow the naming pattern: ${HookName}ReturnValue, for example: UseButtonReturnValue. This is the list of all hooks we have at this moment:

• useAutocomplete - the type is already defined, the only thing missing is adding JS Docs descriptions & extracting it as named interface [Autocomplete] Add docs interface for the hook #36242
• useBadge - [useBadge] Add interface for the return value #36042
• useButton - [docs] Add hooks API pages for MUI Base #35828
• useFormControlUnstyledContext - [docs][base] Add return type for useFormControlUnstyledContext hook #36302
• useInput - [useInput] Add return value interface #36036
• useMenu - [useMenu][base] Add return interface for useMenu hook #36376
• useMenuItem - [useMenuItem] Add explicit return type #36359
• useSelect - [base] Refactor the compound components building blocks #36400
• useSlider - [useSlider][base] Add API docs for the hook parameters and return type #36576
• useSnackbar - [useSnackbar] Add explicit return type #36052
• useSwitch - [useSwitch] Add explicit return type #36050
• useTab
• useTabPanel - [UseTabPanel] Add explicit return type #36053
• useTabs - [useTabs] Add explicit return type #36047
• useTabsList - [useTabsList] Add explicit return type #36048

If you plan to work on some of the hooks, please leave a comment on the issue.

Examples 🌈

As an example, you can take a look at the UseButtonReturnValue. This is how the API page section for the return value will look like: https://deploy-preview-35828--material-ui.netlify.app/base/api/use-button/#return-value

Motivation 🔦

Having explicit hooks for the return values will help with the type check performances, and will allow us to extract the values in the API pages.

[HeVictor]

Hi, I'd like to give the useAutocomplete hook task a crack if that's alright. Thanks!

[skevprog]

Hi! I would like to take the useBadge hook if it's ok.

[the-mgi]

hello, i'd like to take useMenu.

[rayrw]

Hi! I'd like to take useMenuItem.

[the-mgi]

created a PR for useSlider.

[varunmulay22]

Hey I'd like to take useSelect, thanks

[michaldudak]

I'm doing a pretty big refactoring in the useSelect hook, and I'll add these types in the process.
@varunmulay22 could you take useSlider instead?

[varunmulay22]

sure happy to do so thanks

[varunmulay22]

@michaldudak @mnajdova created a PR for useSlider thanks

[Kimzify]

Is it possible to take useFormControlUnstyledContext or useSelect? thanks.

[ZeeshanTamboli]

Is it possible to take useFormControlUnstyledContext or useSelect? thanks.

@kimiyahajizadeh useFormControlUnstyledContext had a PR already created in #36302, while useSelect is undergoing a major refactoring during which the type will be added.

[michaldudak]

All done.