Bug: Upgrading swagger-ui-react to 5.11 breaks compatibility with React 17

[tudi2d]

In the Backstage project are running into an issue with swagger-ui-react after the 5.11 release.

Expected: The expecation is that swagger-ui-react v5.11 still supports ">= 16.8 <18" as mentioned in the release. We use specific version resolution to use React ^17 in our workspace.

Actual behaviour: After updating to 5.11 creating an app fails with the following issue [1]:

[0] ERROR in ../../node_modules/swagger-ui-react/node_modules/react-redux/dist/react-redux.mjs 1097:18-45
[0] export 'useSyncExternalStore' (imported as 'React2') was not found in 'react' (possible exports: Children, Component, Fragment, Profiler, PureComponent, StrictMode, Suspense, __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED, cloneElement, createContext, createElement, createFactory, createRef, forwardRef, isValidElement, lazy, memo, useCallback, useContext, useDebugValue, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, version)
[0]
[0] webpack compiled with 1 error

[1] For more context checkout the various comments in the issue: backstage/backstage#22142

Q&A (please complete the following information)

• OS: macOS
• Version: swagger-ui-react 5.11
• Method of installation: yarn

[jamieklassen]

Does this become redundant with the upgrade to React 18 in #22297?

[tudi2d]

Hej @jamieklassen. With the PR we do avoid the issue for newly created Backstage instances. At the same time we did expect React 17 to work here & there might be instances still on React 17 running into this issue in the future. And of course other projects might run into similar issues as well :)

[tudi2d]

alright - there is the documentation on this: https://github.com/swagger-api/swagger-ui/wiki/Using-older-version-of-React, which I missed. closing this for now.

[char0n]

Hi @tudi2d,

Glad you found the wiki. The link to wiki is directly in the release notes. Glad it eventually all worked for you.