[docs] Enable synthetic default imports in TypeScript config

[morozow]

Added allowSyntheticDefaultImports to TypeScript configuration for better compatibility with CommonJS modules. This helps to simplify imports and improves integration with various libraries.

Fix #43700

[Janpot]

This seems reasonable. Thank you!

[morozow]

@Janpot I’ve partially tested a solution to comply with a GitHub build checks as I do not have permissions to re-run. However, I haven’t found any information on how to run the expected checks. I tried it locally on CircleCI but the credentials don’t permit some actions. Can we run the remaining checks or is the PR now waiting due to some external reason?

[morozow]

@Janpot It seems that the markdown hasn't been deployed to the website https://mui.com/material-ui/guides/typescript/. The documentation link points to a corrected version yet the production still shows an outdated default tsconfig.json value. Could we re-run circleci or simply update production as the current situation is somewhat confusing?

[Janpot]

To avoid having documentation online for unreleased features, we only deploy the docs when we publish a new release. It will be live on the next release.

[oliviertassinari]

I have learned a few things here:

• Doing esModuleInterop actually set allowSyntheticDefaultImports esModuleInterop does not implicitly enable allowSyntheticDefaultImports microsoft/TypeScript#26193
• If we import React from 'react'; from https://github.com/morozow/material-ui-tsc-fix reproduction, we have the same problem but a different error message:

1 import React from 'react';
~~~~~

node_modules/.pnpm/@types[email protected]/node_modules/@types/react/index.d.ts:46:1
46 export = React;
~~~~~~~~~~~~~~~
This module is declared with 'export =', and can only be used with a default import when using the 'esModuleInterop' flag.

• Because the error is clearer, making this change [prop-types] Fix export DefinitelyTyped/DefinitelyTyped#70539 makes sense, it allows a better DX in the worst case scenario.