Release Notes

What changed in each release of @viteplus/versions. The current line is v2.0.x; for the previous line see Earlier releases.

v2.0.7

Packaging correctness and toolchain modernization, plus a fix so external nav links are no longer version-prefixed.

• Added: A package.json exports map for the entry point and the ./components/* subpath, so @viteplus/versions and its Vue components resolve correctly under modern ESM bundlers.
• Fixed: External links in the navigation are left untouched — isNavItemWithLink now excludes http(s) links, so they are no longer rewritten with a version path prefix.
• Changed: Migrated the toolchain from npm to pnpm, refactored CI/CD into dedicated workflows, modernized the ESLint config, and switched tsconfig to project references emitting declarations only.

v2.0.6

Sidebar and routing robustness, plus a documentation "suggest changes" edit link.

• Added: An edit link on every docs page that opens a pre-filled GitHub issue for suggesting changes.
• Changed: Route rewriting resolves the active locale through a shared extractLocale helper.
• Changed: The sidebar falls back gracefully when a locale has no entries, and path joining uses a safe utility so versioned links stay correct across platforms.

v2.0.5

Multi-locale, multi-version support across the sidebar, navigation, and rewrites.

• Added: Per-locale navigation resolution, so each language can define its own nav.
• Added: Language-and-region locale keys such as fr-FR are matched to their base language.
• Added: External links (starting with http) in nav and sidebar are left untouched, as if marked skipVersioning.
• Changed: parseSidebar renamed to parseSidebars.
• Changed: Sidebar and route parsing reworked to resolve the active locale and version dynamically.

v2.0.4

• Changed: The version switcher renders only when archived versions exist.
• Changed: Locale handling in themeConfig refined.

v2.0.3

• Added: Compatibility with the stable vitepress@2.0.0 release.
• Fixed: Navbar icon rendering.

v2.0.2

• Fixed: The version switcher no longer chains version prefixes when switching repeatedly.

v2.0.1

• Changed: Default version switcher placement in the nav bar.

v2.0.0

Full rewrite around a new defineVersionedConfig API, a src + archive layout, and per-version navigation and sidebars.

// .vitepress/config.ts
import { defineVersionedConfig } from '@viteplus/versions';

export default defineVersionedConfig({
    versionsConfig: {
        current: 'v2.0.x',
        versionSwitcher: { text: 'Version', includeCurrentVersion: true }
    }
});

• Added: Localization with version-aware locales.
• Added: Version-specific navigation and sidebars.
• Added: Custom URL structure through the rewritesHook.
• Added: The VersionSwitcher component.
• Added: Markdown linting and support for vitepress@2.0.0-alpha.12.
• Changed: Configuration moved from the old versioning block to versionsConfig, and archived content moved from versions/ to archive/.

Earlier releases

• v1.0.0 - initial release (archived docs).

See also

• Getting Started
• Configuration