Description
First Issue: Package Manager Issue
Describe the bug
First off, the bug can be experienced here: https://codesandbox.io/p/github/Devon-White/api-plugin-test/main?embed=1
I created a demo that showcases installing the plugin with yarn
and npm
.
You will notice that when you run build/start on the docs site after the plugin is set up, and your package manager is yarn, that the site will have no (immediately seen) issues. However, running npm test will leave you with a React hook error:
Hook useDoc is called outside the <DocProvider>
This error first occurred to me on my docs site when attempting to upgrade to Docusaurus 3.8, then I was able to replicate it on Docusaurus 3.7 on a fresh docs site/build.
Expected behavior
The package manager shouldn't matter.
Current behavior
NPM tends to not behave well with the plugin.
Possible solution
Avoid NPM.
Steps to reproduce
Follow the README in the linked demo.
Second Issue: Auth doesn't update
This can be witnessed currently at our site at: https://developer.signalwire.com/rest/signalwire-rest/endpoints/calling/calls-create
The auth field is auto-populated as username:password
in base64. When you start to fill in your credentials, it doesn't update.
Additionally, if you run the above demo for issue 1, and install/run it with yarn
, you will experience the same issue. To fix this issue, I had to go back to Docusaurus 3.6.3 and the compatible version of the plugin.
Additional Context
I tried downgrading from React 19 to 18, no luck.