multiVersion: sidebar collapses to '/' when both _meta.json and _nav.json exist at version root

[hristototov]

When using multiVersion with both _meta.json and _nav.json at the version root, the sidebar for all versions collapses to a single '/' key in walk.ts:

https://github.com/web-infra-dev/rspress/blob/main/packages/core/src/node/auto-nav-sidebar/walk.ts

This means the last version processed always overwrites earlier ones, so switching versions in the header shows the same sidebar regardless of version.

Root cause: The '/' hardcode in the first branch should use addRoutePrefix(workDir, docsDir, '/') - the same call used in the second branch for per-section keys.

Proposed fix:

- sidebar: { '/': await scanSideMeta(...) }
+ sidebar: { [addRoutePrefix(workDir, docsDir, '/')]: await scanSideMeta(...) }

[SoonIter]

Thanks for the detailed report.

This is by design. When _nav.json and _meta.json both are used at the version root, it follows the global sidebar usage behavior, so the sidebar is keyed by /.

You can refer to the docs here:
https://rspress.rs/guide/basic/auto-nav-sidebar#global-sidebar-usage

[hristototov]

Is there a recommended way to use the global sidebar with multiVersion, as I don't see it in the docs? The '/' key means both versions share the same sidebar, so switching versions doesn't update the sidebar content.

[SoonIter]

@hristototov Thanks for the follow-up. After my diagnosis, I found out that it was actually a bug. :)

I have opened a PR to fix this so global sidebars are isolated correctly across versions:

#3454