Skip to content

Bug Report - version 4.4.0 & Docusaurus 3.7.0 issueΒ #1157

Open
@Devon-White

Description

@Devon-White

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions