From e8f496831089145a55f32bb8d19fa6300d774641 Mon Sep 17 00:00:00 2001 From: Martin Hochel Date: Thu, 5 Jun 2025 17:32:56 +0200 Subject: [PATCH 1/2] feat(docsite-v9): add official platform support docs including React Versions --- .../Concepts/ReactVersionSupport.stories.mdx | 68 +++++++++++++++++++ .../Concepts/SupportedPlatforms.stories.mdx | 23 +++++++ 2 files changed, 91 insertions(+) create mode 100644 apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx create mode 100644 apps/public-docsite-v9/src/Concepts/SupportedPlatforms.stories.mdx diff --git a/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx b/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx new file mode 100644 index 00000000000000..a52f16fb551ede --- /dev/null +++ b/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx @@ -0,0 +1,68 @@ +import { Meta } from '@storybook/addon-docs'; + + + +# React Version Support + +> ℹ️ **Note**: Our migration docs focus solely on FluentUI related changes. + +If you're migrating between React major versions, please refer to the official React documentation for comprehensive migration guides. + +For migrating your codebase TypeScript types, you can leverage [Types React Codemod](https://github.com/eps1lon/types-react-codemod) + +## React 17 + +Full support starting `@fluentui/react-components` v9.0.0. + +## React 18 + +Full support starting `@fluentui/react-components` v9.65.0. + +### Migration + +> 💡 Check Following PR for further details https://github.com/microsoft/fluentui/pull/34456 + +#### Runtime/API changes: + +NONE + +#### TypeScript types changes: + +##### Slot Children as a Function + +Because `@types/react@18` Breaking Changes, we needed to loosen `Slot` children property to `any`. + +This change will affect users that use `Slot` children as a function in conjunction with TypeScript strict mode. + +If that's your case, TypeScript will fail on `noImplicitAny`. To mitigate this you need to add type assertions (`satisfies SlotRenderFunction`) + +Before: + +```tsx +import * as React from 'React'; + + +``` + +After: + +```tsx +import * as React from 'React'; +import { type SlotRenderFunction } from '@fluentui/react-utilities'; + +; +``` diff --git a/apps/public-docsite-v9/src/Concepts/SupportedPlatforms.stories.mdx b/apps/public-docsite-v9/src/Concepts/SupportedPlatforms.stories.mdx new file mode 100644 index 00000000000000..a78f01c8a93832 --- /dev/null +++ b/apps/public-docsite-v9/src/Concepts/SupportedPlatforms.stories.mdx @@ -0,0 +1,23 @@ +import { Meta } from '@storybook/addon-docs'; + + + +# Supported Platforms + +Learn about the platforms that are supported by Fluent UI React. + +## Browser + +Fluent UI supports the latest, stable releases of all major browsers and platforms. + +Please refer to the [Browser Support Matrix](/docs/concepts-developer-browser-support-matrix--docs) for more details. + +## React + +Fluent UI fully supports React versions 17 and 18. + +Please refer to the [React Version Support](/docs/concepts-developer-react-version-support--docs) for more details. + +## TypeScript + +Fluent UI fully supports TypeScript versions >=3.9. From 2c2da3197f0eef767fb99c10f83d8307dcecef85 Mon Sep 17 00:00:00 2001 From: Martin Hochel Date: Thu, 12 Jun 2025 11:53:38 +0200 Subject: [PATCH 2/2] fixup! feat(docsite-v9): add official platform support docs including React Versions --- .../src/Concepts/ReactVersionSupport.stories.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx b/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx index a52f16fb551ede..dd862d68f87323 100644 --- a/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx +++ b/apps/public-docsite-v9/src/Concepts/ReactVersionSupport.stories.mdx @@ -16,7 +16,7 @@ Full support starting `@fluentui/react-components` v9.0.0. ## React 18 -Full support starting `@fluentui/react-components` v9.65.0. +Full support starting `@fluentui/react-components` v9.66.0. ### Migration