@docusaurus/plugin-content-docs 3.2.1 → 3.3.1

package/lib/categoryGeneratedIndex.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import { type SidebarsUtils } from './sidebars/utils';
 import type { CategoryGeneratedIndexMetadata, DocMetadataBase } from '@docusaurus/plugin-content-docs';
 export declare function getCategoryGeneratedIndexMetadataList({ docs, sidebarsUtils, }: {

package/lib/cli.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { PluginOptions } from '@docusaurus/plugin-content-docs';
 import type { LoadContext } from '@docusaurus/types';
 export declare function cliDocsVersionCommand(version: unknown, { id: pluginId, path: docsPath, sidebarPath }: PluginOptions, { siteDir, i18n }: LoadContext): Promise<void>;

package/lib/docs.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { MetadataOptions, PluginOptions, CategoryIndexMatcher, DocMetadataBase, VersionMetadata, LoadedVersion } from '@docusaurus/plugin-content-docs';
 import type { LoadContext } from '@docusaurus/types';
 import type { SidebarsUtils } from './sidebars/utils';

package/lib/frontMatter.d.ts

@@ -1,3 +1,4 @@
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { DocFrontMatter } from '@docusaurus/plugin-content-docs';
 export declare const DocFrontMatterSchema: import("joi").ObjectSchema<DocFrontMatter>;
 export declare function validateDocFrontMatter(frontMatter: {

package/lib/index.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { PluginOptions, LoadedContent } from '@docusaurus/plugin-content-docs';
 import type { LoadContext, Plugin } from '@docusaurus/types';
 export default function pluginContentDocs(context: LoadContext, options: PluginOptions): Promise<Plugin<LoadedContent>>;

package/lib/index.js

@@ -30,6 +30,9 @@ async function pluginContentDocs(context, options) {
     const pluginId = options.id;
     const pluginDataDirRoot = path_1.default.join(generatedFilesDir, 'docusaurus-plugin-content-docs');
     const dataDir = path_1.default.join(pluginDataDirRoot, pluginId);
+    // TODO Docusaurus v4 breaking change
+    //  module aliasing should be automatic
+    //  we should never find local absolute FS paths in the codegen registry
     const aliasedSource = (source) => `~docs/${(0, utils_1.posixPath)(path_1.default.relative(pluginDataDirRoot, source))}`;
     // TODO env should be injected into all plugins
     const env = process.env.NODE_ENV;

package/lib/numberPrefix.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { NumberPrefixParser } from '@docusaurus/plugin-content-docs';
 export declare const DefaultNumberPrefixParser: NumberPrefixParser;
 export declare const DisabledNumberPrefixParser: NumberPrefixParser;

package/lib/options.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { OptionValidationContext } from '@docusaurus/types';
 import type { PluginOptions, Options } from '@docusaurus/plugin-content-docs';
 export declare const DEFAULT_OPTIONS: Omit<PluginOptions, 'id' | 'sidebarPath'>;

package/lib/options.js

@@ -14,10 +14,10 @@ const utils_1 = require("@docusaurus/utils");
 const generator_1 = require("./sidebars/generator");
 const numberPrefix_1 = require("./numberPrefix");
 exports.DEFAULT_OPTIONS = {
-    path: 'docs',
-    routeBasePath: 'docs',
-    tagsBasePath: 'tags',
-    include: ['**/*.{md,mdx}'],
+    path: 'docs', // Path to data on filesystem, relative to site dir.
+    routeBasePath: 'docs', // URL Route.
+    tagsBasePath: 'tags', // URL Tags Route.
+    include: ['**/*.{md,mdx}'], // Extensions to include.
     exclude: utils_1.GlobExcludeDefault,
     sidebarItemsGenerator: generator_1.DefaultSidebarItemsGenerator,
     numberPrefixParser: numberPrefix_1.DefaultNumberPrefixParser,

package/lib/props.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { VersionTag, VersionTags } from './types';
 import type { SidebarItemDoc } from './sidebars/types';
 import type { PropSidebars, PropVersionMetadata, PropTagDocList, PropTagsListPage, PropSidebarItemLink, DocMetadata, LoadedVersion } from '@docusaurus/plugin-content-docs';

package/lib/routes.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { PluginContentLoadedActions, RouteConfig } from '@docusaurus/types';
 import type { FullVersion } from './types';
 import type { PluginOptions } from '@docusaurus/plugin-content-docs';

package/lib/routes.js

@@ -19,22 +19,20 @@ function createDocRouteMetadata(docMeta) {
         lastUpdatedAt: docMeta.lastUpdatedAt,
     };
 }
-async function buildVersionCategoryGeneratedIndexRoutes({ version, actions, options, aliasedSource, }) {
-    const slugs = (0, utils_1.createSlugger)();
+async function buildVersionCategoryGeneratedIndexRoutes({ version, options, }) {
     async function buildCategoryGeneratedIndexRoute(categoryGeneratedIndex) {
-        const { sidebar, ...prop } = categoryGeneratedIndex;
-        const propFileName = slugs.slug(`${version.path}-${categoryGeneratedIndex.sidebar}-category-${categoryGeneratedIndex.title}`);
-        const propData = await actions.createData(`${(0, utils_1.docuHash)(`category/${propFileName}`)}.json`, JSON.stringify(prop, null, 2));
         return {
             path: categoryGeneratedIndex.permalink,
             component: options.docCategoryGeneratedIndexComponent,
             exact: true,
-            modules: {
-                categoryGeneratedIndex: aliasedSource(propData),
+            props: {
+                categoryGeneratedIndex,
             },
             // Same as doc, this sidebar route attribute permits to associate this
             // subpage to the given sidebar
-            ...(sidebar && { sidebar }),
+            ...(categoryGeneratedIndex.sidebar && {
+                sidebar: categoryGeneratedIndex.sidebar,
+            }),
         };
     }
     return Promise.all(version.categoryGeneratedIndices.map(buildCategoryGeneratedIndexRoute));
@@ -44,7 +42,7 @@ async function buildVersionDocRoutes({ version, actions, options, }) {
         await actions.createData(
         // Note that this created data path must be in sync with
         // metadataPath provided to mdx-loader.
-        `${(0, utils_1.docuHash)(doc.source)}.json`, JSON.stringify(doc, null, 2));
+        `${(0, utils_1.docuHash)(doc.source)}.json`, doc);
         const docRoute = {
             path: doc.permalink,
             component: options.docItemComponent,
@@ -77,37 +75,33 @@ async function buildVersionSidebarRoute(param) {
     };
 }
 async function buildVersionTagsRoutes(param) {
-    const { version, options, actions, aliasedSource } = param;
+    const { version, options } = param;
     const versionTags = (0, tags_1.getVersionTags)(version.docs);
     async function buildTagsListRoute() {
         // Don't create a tags list page if there's no tag
         if (Object.keys(versionTags).length === 0) {
             return null;
         }
-        const tagsProp = (0, props_1.toTagsListTagsProp)(versionTags);
-        const tagsPropPath = await actions.createData(`${(0, utils_1.docuHash)(`tags-list-${version.versionName}-prop`)}.json`, JSON.stringify(tagsProp, null, 2));
         return {
             path: version.tagsPath,
             exact: true,
             component: options.docTagsListComponent,
-            modules: {
-                tags: aliasedSource(tagsPropPath),
+            props: {
+                tags: (0, props_1.toTagsListTagsProp)(versionTags),
             },
         };
     }
     async function buildTagDocListRoute(tag) {
-        const tagProps = (0, props_1.toTagDocListProp)({
-            allTagsPath: version.tagsPath,
-            tag,
-            docs: version.docs,
-        });
-        const tagPropPath = await actions.createData(`${(0, utils_1.docuHash)(`tag-${tag.permalink}`)}.json`, JSON.stringify(tagProps, null, 2));
         return {
             path: tag.permalink,
             component: options.docTagDocListComponent,
             exact: true,
-            modules: {
-                tag: aliasedSource(tagPropPath),
+            props: {
+                tag: (0, props_1.toTagDocListProp)({
+                    allTagsPath: version.tagsPath,
+                    tag,
+                    docs: version.docs,
+                }),
             },
         };
     }
@@ -118,7 +112,7 @@ async function buildVersionTagsRoutes(param) {
     return lodash_1.default.compact([tagsListRoute, ...allTagsDocListRoutes]);
 }
 async function buildVersionRoutes(param) {
-    const { version, actions, options, aliasedSource } = param;
+    const { version, options } = param;
     async function buildVersionSubRoutes() {
         const [sidebarRoute, tagsRoutes] = await Promise.all([
             buildVersionSidebarRoute(param),
@@ -127,16 +121,15 @@ async function buildVersionRoutes(param) {
         return [sidebarRoute, ...tagsRoutes];
     }
     async function doBuildVersionRoutes() {
-        const versionProp = (0, props_1.toVersionMetadataProp)(options.id, version);
-        const versionPropPath = await actions.createData(`${(0, utils_1.docuHash)(`version-${version.versionName}-metadata-prop`)}.json`, JSON.stringify(versionProp, null, 2));
-        const subRoutes = await buildVersionSubRoutes();
         return {
             path: version.path,
             exact: false,
             component: options.docVersionRootComponent,
-            routes: subRoutes,
-            modules: {
-                version: aliasedSource(versionPropPath),
+            routes: await buildVersionSubRoutes(),
+            props: {
+                // TODO Docusaurus v4 breaking change?
+                //  expose version metadata as route context instead of props
+                version: (0, props_1.toVersionMetadataProp)(options.id, version),
             },
             priority: version.routePriority,
         };

package/lib/sidebars/index.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { PluginOptions } from '@docusaurus/plugin-content-docs';
 import type { SidebarsConfig, Sidebars, SidebarProcessorParams } from './types';
 export declare const DefaultSidebars: SidebarsConfig;

package/lib/sidebars/types.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { Optional, Required } from 'utility-types';
 import type { NumberPrefixParser, SidebarOptions, CategoryIndexMatcher, DocMetadataBase, VersionMetadata } from '@docusaurus/plugin-content-docs';
 import type { Slugger } from '@docusaurus/utils';

package/lib/sidebars/utils.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { Sidebars, Sidebar, SidebarItem, SidebarItemCategory, SidebarItemLink, SidebarItemDoc, SidebarCategoriesShorthand, SidebarItemConfig, SidebarItemCategoryWithGeneratedIndex, SidebarNavigationItem } from './types';
 import type { DocMetadataBase, PropNavigationLink, VersionMetadata } from '@docusaurus/plugin-content-docs';
 export declare function isCategoriesShorthand(item: SidebarItemConfig): item is SidebarCategoriesShorthand;
@@ -61,7 +62,9 @@ export type SidebarsUtils = {
     }) => void;
 };
 export declare function createSidebarsUtils(sidebars: Sidebars): SidebarsUtils;
-export declare function toDocNavigationLink(doc: DocMetadataBase): PropNavigationLink;
+export declare function toDocNavigationLink(doc: DocMetadataBase, options?: {
+    sidebarItemLabel?: string | undefined;
+}): PropNavigationLink;
 export declare function toNavigationLink(navigationItem: SidebarNavigationItem | undefined, docsById: {
     [docId: string]: DocMetadataBase;
 }): PropNavigationLink | undefined;

package/lib/sidebars/utils.js

@@ -294,9 +294,12 @@ Available document ids are:
     };
 }
 exports.createSidebarsUtils = createSidebarsUtils;
-function toDocNavigationLink(doc) {
+function toDocNavigationLink(doc, options) {
     const { title, permalink, frontMatter: { pagination_label: paginationLabel, sidebar_label: sidebarLabel, }, } = doc;
-    return { title: paginationLabel ?? sidebarLabel ?? title, permalink };
+    return {
+        title: paginationLabel ?? sidebarLabel ?? options?.sidebarItemLabel ?? title,
+        permalink,
+    };
 }
 exports.toDocNavigationLink = toDocNavigationLink;
 function toNavigationLink(navigationItem, docsById) {
@@ -318,6 +321,8 @@ function toNavigationLink(navigationItem, docsById) {
                 permalink: navigationItem.link.permalink,
             };
     }
-    return toDocNavigationLink(getDocById(navigationItem.id));
+    return toDocNavigationLink(getDocById(navigationItem.id), {
+        sidebarItemLabel: navigationItem?.label,
+    });
 }
 exports.toNavigationLink = toNavigationLink;

package/lib/slug.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { NumberPrefixParser, DocMetadataBase } from '@docusaurus/plugin-content-docs';
 export default function getSlug({ baseID, frontMatterSlug, source, sourceDirName, stripDirNumberPrefixes, numberPrefixParser, }: {
     baseID: string;

package/lib/tags.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { VersionTags } from './types';
 import type { DocMetadata } from '@docusaurus/plugin-content-docs';
 export declare function getVersionTags(docs: DocMetadata[]): VersionTags;

package/lib/translations.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { LoadedContent } from '@docusaurus/plugin-content-docs';
 import type { TranslationFile } from '@docusaurus/types';
 export declare function getLoadedContentTranslationFiles(loadedContent: LoadedContent): TranslationFile[];

package/lib/types.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../src/plugin-content-docs.d.ts" />
 import type { BrokenMarkdownLink, Tag } from '@docusaurus/utils';
 import type { VersionMetadata, LoadedVersion, CategoryGeneratedIndexMetadata } from '@docusaurus/plugin-content-docs';
 import type { SidebarsUtils } from './sidebars/utils';

package/lib/versions/files.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { PluginOptions, VersionMetadata } from '@docusaurus/plugin-content-docs';
 import type { VersionContext } from './index';
 /** `[siteDir]/community_versioned_docs/version-1.0.0` */

package/lib/versions/index.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { FullVersion } from '../types';
 import type { LoadContext } from '@docusaurus/types';
 import type { LoadedVersion, PluginOptions, VersionBanner, VersionMetadata } from '@docusaurus/plugin-content-docs';

package/lib/versions/validation.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/// <reference path="../../src/plugin-content-docs.d.ts" />
 import type { VersionsOptions } from '@docusaurus/plugin-content-docs';
 export declare function validateVersionName(name: unknown): asserts name is string;
 export declare function validateVersionNames(names: unknown): asserts names is string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "3.2.1",
+  "version": "3.3.1",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -35,14 +35,14 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "3.2.1",
-    "@docusaurus/logger": "3.2.1",
-    "@docusaurus/mdx-loader": "3.2.1",
-    "@docusaurus/module-type-aliases": "3.2.1",
-    "@docusaurus/types": "3.2.1",
-    "@docusaurus/utils": "3.2.1",
-    "@docusaurus/utils-common": "3.2.1",
-    "@docusaurus/utils-validation": "3.2.1",
+    "@docusaurus/core": "3.3.1",
+    "@docusaurus/logger": "3.3.0",
+    "@docusaurus/mdx-loader": "3.3.0",
+    "@docusaurus/module-type-aliases": "3.3.1",
+    "@docusaurus/types": "3.3.0",
+    "@docusaurus/utils": "3.3.0",
+    "@docusaurus/utils-common": "3.3.0",
+    "@docusaurus/utils-validation": "3.3.0",
     "@types/react-router-config": "^5.0.7",
     "combine-promises": "^1.1.0",
     "fs-extra": "^11.1.1",
@@ -66,5 +66,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "f268e15264e208e6faf26117258162e988b53773"
+  "gitHead": "f3524cf332e803ff82783ee9c1c86c4342fc1f71"
 }

package/src/index.ts

@@ -73,6 +73,9 @@ export default async function pluginContentDocs(
     'docusaurus-plugin-content-docs',
   );
   const dataDir = path.join(pluginDataDirRoot, pluginId);
+  // TODO Docusaurus v4 breaking change
+  //  module aliasing should be automatic
+  //  we should never find local absolute FS paths in the codegen registry
   const aliasedSource = (source: string) =>
     `~docs/${posixPath(path.relative(pluginDataDirRoot, source))}`;
 

package/src/routes.ts

@@ -9,7 +9,6 @@ import _ from 'lodash';
 import logger from '@docusaurus/logger';
 import {
   docuHash,
-  createSlugger,
   normalizeUrl,
   aliasedSitePathToRelativePath,
 } from '@docusaurus/utils';
@@ -29,7 +28,6 @@ import type {
   CategoryGeneratedIndexMetadata,
   DocMetadata,
   PluginOptions,
-  PropTagsListPage,
 } from '@docusaurus/plugin-content-docs';
 
 function createDocRouteMetadata(docMeta: DocMetadata): RouteMetadata {
@@ -41,36 +39,23 @@ function createDocRouteMetadata(docMeta: DocMetadata): RouteMetadata {
 
 async function buildVersionCategoryGeneratedIndexRoutes({
   version,
-  actions,
   options,
-  aliasedSource,
 }: BuildVersionRoutesParam): Promise<RouteConfig[]> {
-  const slugs = createSlugger();
-
   async function buildCategoryGeneratedIndexRoute(
     categoryGeneratedIndex: CategoryGeneratedIndexMetadata,
   ): Promise<RouteConfig> {
-    const {sidebar, ...prop} = categoryGeneratedIndex;
-
-    const propFileName = slugs.slug(
-      `${version.path}-${categoryGeneratedIndex.sidebar}-category-${categoryGeneratedIndex.title}`,
-    );
-
-    const propData = await actions.createData(
-      `${docuHash(`category/${propFileName}`)}.json`,
-      JSON.stringify(prop, null, 2),
-    );
-
     return {
       path: categoryGeneratedIndex.permalink,
       component: options.docCategoryGeneratedIndexComponent,
       exact: true,
-      modules: {
-        categoryGeneratedIndex: aliasedSource(propData),
+      props: {
+        categoryGeneratedIndex,
       },
       // Same as doc, this sidebar route attribute permits to associate this
       // subpage to the given sidebar
-      ...(sidebar && {sidebar}),
+      ...(categoryGeneratedIndex.sidebar && {
+        sidebar: categoryGeneratedIndex.sidebar,
+      }),
     };
   }
 
@@ -90,7 +75,7 @@ async function buildVersionDocRoutes({
         // Note that this created data path must be in sync with
         // metadataPath provided to mdx-loader.
         `${docuHash(doc.source)}.json`,
-        JSON.stringify(doc, null, 2),
+        doc,
       );
 
       const docRoute: RouteConfig = {
@@ -131,7 +116,7 @@ async function buildVersionSidebarRoute(param: BuildVersionRoutesParam) {
 async function buildVersionTagsRoutes(
   param: BuildVersionRoutesParam,
 ): Promise<RouteConfig[]> {
-  const {version, options, actions, aliasedSource} = param;
+  const {version, options} = param;
   const versionTags = getVersionTags(version.docs);
 
   async function buildTagsListRoute(): Promise<RouteConfig | null> {
@@ -139,37 +124,27 @@ async function buildVersionTagsRoutes(
     if (Object.keys(versionTags).length === 0) {
       return null;
     }
-    const tagsProp: PropTagsListPage['tags'] = toTagsListTagsProp(versionTags);
-    const tagsPropPath = await actions.createData(
-      `${docuHash(`tags-list-${version.versionName}-prop`)}.json`,
-      JSON.stringify(tagsProp, null, 2),
-    );
     return {
       path: version.tagsPath,
       exact: true,
       component: options.docTagsListComponent,
-      modules: {
-        tags: aliasedSource(tagsPropPath),
+      props: {
+        tags: toTagsListTagsProp(versionTags),
       },
     };
   }
 
   async function buildTagDocListRoute(tag: VersionTag): Promise<RouteConfig> {
-    const tagProps = toTagDocListProp({
-      allTagsPath: version.tagsPath,
-      tag,
-      docs: version.docs,
-    });
-    const tagPropPath = await actions.createData(
-      `${docuHash(`tag-${tag.permalink}`)}.json`,
-      JSON.stringify(tagProps, null, 2),
-    );
     return {
       path: tag.permalink,
       component: options.docTagDocListComponent,
       exact: true,
-      modules: {
-        tag: aliasedSource(tagPropPath),
+      props: {
+        tag: toTagDocListProp({
+          allTagsPath: version.tagsPath,
+          tag,
+          docs: version.docs,
+        }),
       },
     };
   }
@@ -189,7 +164,7 @@ type BuildVersionRoutesParam = Omit<BuildAllRoutesParam, 'versions'> & {
 async function buildVersionRoutes(
   param: BuildVersionRoutesParam,
 ): Promise<RouteConfig> {
-  const {version, actions, options, aliasedSource} = param;
+  const {version, options} = param;
 
   async function buildVersionSubRoutes() {
     const [sidebarRoute, tagsRoutes] = await Promise.all([
@@ -201,19 +176,15 @@ async function buildVersionRoutes(
   }
 
   async function doBuildVersionRoutes(): Promise<RouteConfig> {
-    const versionProp = toVersionMetadataProp(options.id, version);
-    const versionPropPath = await actions.createData(
-      `${docuHash(`version-${version.versionName}-metadata-prop`)}.json`,
-      JSON.stringify(versionProp, null, 2),
-    );
-    const subRoutes = await buildVersionSubRoutes();
     return {
       path: version.path,
       exact: false,
       component: options.docVersionRootComponent,
-      routes: subRoutes,
-      modules: {
-        version: aliasedSource(versionPropPath),
+      routes: await buildVersionSubRoutes(),
+      props: {
+        // TODO Docusaurus v4 breaking change?
+        //  expose version metadata as route context instead of props
+        version: toVersionMetadataProp(options.id, version),
       },
       priority: version.routePriority,
     };

package/src/sidebars/utils.ts

@@ -478,7 +478,10 @@ Available document ids are:
   };
 }
 
-export function toDocNavigationLink(doc: DocMetadataBase): PropNavigationLink {
+export function toDocNavigationLink(
+  doc: DocMetadataBase,
+  options?: {sidebarItemLabel?: string | undefined},
+): PropNavigationLink {
   const {
     title,
     permalink,
@@ -487,7 +490,11 @@ export function toDocNavigationLink(doc: DocMetadataBase): PropNavigationLink {
       sidebar_label: sidebarLabel,
     },
   } = doc;
-  return {title: paginationLabel ?? sidebarLabel ?? title, permalink};
+  return {
+    title:
+      paginationLabel ?? sidebarLabel ?? options?.sidebarItemLabel ?? title,
+    permalink,
+  };
 }
 
 export function toNavigationLink(
@@ -516,5 +523,7 @@ export function toNavigationLink(
           permalink: navigationItem.link.permalink,
         };
   }
-  return toDocNavigationLink(getDocById(navigationItem.id));
+  return toDocNavigationLink(getDocById(navigationItem.id), {
+    sidebarItemLabel: navigationItem?.label,
+  });
 }