[useAutocomplete] Improve isOptionEqualToValue value argument type

[silviuaavram]

• I have followed (at least) the PR section of the contributing guide.

It's this PR #37291 from @newsiberian but the files have changed since then so created a new PR with the changes on the updated file structure. Same changes, but:

• docs/data/base/components/autocomplete/AutocompleteIntroduction/tailwind/index.js
  • removed, not found anymore.
• docs/pages/base-ui/api/use-autocomplete.json
  • removed, not found anymore
• packages/mui-base/src/useAutocomplete/useAutocomplete.d.ts
  • changed to packages/mui-material/src/useAutocomplete/useAutocomplete.d.ts

Fixes #38322

[mui-bot]

Netlify deploy preview

• docs/data/material/migration/upgrade-to-v9/upgrade-to-v9.md

Bundle size report

Bundle	Parsed size	Gzip size
@mui/material	0B(0.00%)	0B(0.00%)
@mui/lab	0B(0.00%)	0B(0.00%)
@mui/system	0B(0.00%)	0B(0.00%)
@mui/utils	0B(0.00%)	0B(0.00%)

Details of bundle changes

Generated by 🚫 dangerJS against a200669

[Copilot]

Pull request overview

This PR improves the TypeScript type definitions for the isOptionEqualToValue and getOptionLabel props in the Autocomplete component to correctly reflect that in freeSolo mode, the value parameter can be either the option type or a string. This addresses a type safety issue where developers using freeSolo mode were not getting accurate type information.

Changes:

• Introduced a new AutocompleteValueOrFreeSoloValueMapping type helper that resolves to Value | string when FreeSolo is true, otherwise just Value
• Updated type definitions and documentation for getOptionLabel and isOptionEqualToValue to use this new type helper
• Added demo examples showing proper usage of isOptionEqualToValue with freeSolo mode

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/mui-material/src/useAutocomplete/useAutocomplete.d.ts	Added new type helper and updated type definitions for getOptionLabel and isOptionEqualToValue
packages/mui-material/src/Autocomplete/Autocomplete.js	Updated JSDoc comments to reflect that parameters can be Value or string
packages/mui-joy/src/Autocomplete/AutocompleteProps.ts	Updated import to use new type helper and applied it to getOptionLabel
packages/mui-joy/src/Autocomplete/Autocomplete.tsx	Updated JSDoc comments to reflect that parameters can be Value or string
docs/pages/material-ui/api/autocomplete.json	Updated API documentation signatures to show Value or string types
docs/pages/joy-ui/api/autocomplete.json	Updated API documentation signatures to show Value or string types
docs/data/material/components/autocomplete/FreeSolo.tsx	Added example demonstrating isOptionEqualToValue with freeSolo mode
docs/data/material/components/autocomplete/FreeSolo.js	Added example demonstrating isOptionEqualToValue with freeSolo mode

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This import references AutocompleteValueOrFreeSoloValueMapping from the external @mui/base package. Please verify that this type has been added to @mui/base (version 7.0.0-beta.4 or the version being used) before merging this PR. If this type doesn't exist in the current version of @mui/base, this will cause a TypeScript compilation error.

[siriwatknp]

same here, need to add to upgrading guide

[siriwatknp]

When it's related to types, I recommend adding .spec.tsx to confirm the behavior.
In this case, let's add a fail case (missing typeof check) and a success case (similar to the demo but can be shorter).

Take a look at packages/mui-material/src/Autocomplete/Autocomplete.spec.tsx

[siriwatknp]

👍 Please check my last comment related to the spec.

[siriwatknp]

👍