@docusaurus/plugin-content-docs 3.8.0 → 3.8.1

package/lib/index.js

@@ -11,22 +11,20 @@ exports.default = pluginContentDocs;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const mdx_loader_1 = require("@docusaurus/mdx-loader");
 const sidebars_1 = require("./sidebars");
 const generator_1 = require("./sidebars/generator");
-const docs_1 = require("./docs");
-const versions_1 = require("./versions");
+const version_1 = require("./versions/version");
 const cli_1 = tslib_1.__importDefault(require("./cli"));
 const constants_1 = require("./constants");
 const globalData_1 = require("./globalData");
 const translations_1 = require("./translations");
 const routes_1 = require("./routes");
-const utils_2 = require("./sidebars/utils");
 const contentHelpers_1 = require("./contentHelpers");
+const loadVersion_1 = require("./versions/loadVersion");
 // MDX loader is not 100% deterministic, leading to cache invalidation issue
 // This permits to invalidate the MDX loader cache entries when content changes
 // Problem documented here: https://github.com/facebook/docusaurus/pull/10934
@@ -46,7 +44,7 @@ async function pluginContentDocs(context, options) {
     const { siteDir, generatedFilesDir, baseUrl, siteConfig } = context;
     // Mutate options to resolve sidebar path according to siteDir
     options.sidebarPath = (0, sidebars_1.resolveSidebarPathOption)(siteDir, options.sidebarPath);
-    const versionsMetadata = await (0, versions_1.readVersionsMetadata)({ context, options });
+    const versionsMetadata = await (0, version_1.readVersionsMetadata)({ 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);
@@ -95,7 +93,7 @@ async function pluginContentDocs(context, options) {
                 }),
                 markdownConfig: siteConfig.markdown,
                 resolveMarkdownLink: ({ linkPathname, sourceFilePath }) => {
-                    const version = (0, versions_1.getVersionFromSourceFilePath)(sourceFilePath, versionsMetadata);
+                    const version = (0, version_1.getVersionFromSourceFilePath)(sourceFilePath, versionsMetadata);
                     const permalink = (0, utils_1.resolveMarkdownLinkPathname)(linkPathname, {
                         sourceFilePath,
                         sourceToPermalink: contentHelpers.sourceToPermalink,
@@ -150,78 +148,13 @@ async function pluginContentDocs(context, options) {
             return versionsMetadata.flatMap(getVersionPathsToWatch);
         },
         async loadContent() {
-            async function loadVersionDocsBase(versionMetadata, tagsFile) {
-                const docFiles = await (0, docs_1.readVersionDocs)(versionMetadata, options);
-                if (docFiles.length === 0) {
-                    throw new Error(`Docs version "${versionMetadata.versionName}" has no docs! At least one doc should exist at "${path_1.default.relative(siteDir, versionMetadata.contentPath)}".`);
-                }
-                function processVersionDoc(docFile) {
-                    return (0, docs_1.processDocMetadata)({
-                        docFile,
-                        versionMetadata,
-                        context,
-                        options,
-                        env,
-                        tagsFile,
-                    });
-                }
-                return Promise.all(docFiles.map(processVersionDoc));
-            }
-            async function doLoadVersion(versionMetadata) {
-                const tagsFile = await (0, utils_validation_1.getTagsFile)({
-                    contentPaths: versionMetadata,
-                    tags: options.tags,
-                });
-                const docsBase = await loadVersionDocsBase(versionMetadata, tagsFile);
-                // TODO we only ever need draftIds in further code, not full draft items
-                // To simplify and prevent mistakes, avoid exposing draft
-                // replace draft=>draftIds in content loaded
-                const [drafts, docs] = lodash_1.default.partition(docsBase, (doc) => doc.draft);
-                const sidebars = await (0, sidebars_1.loadSidebars)(versionMetadata.sidebarFilePath, {
-                    sidebarItemsGenerator: options.sidebarItemsGenerator,
-                    numberPrefixParser: options.numberPrefixParser,
-                    docs,
-                    drafts,
-                    version: versionMetadata,
-                    sidebarOptions: {
-                        sidebarCollapsed: options.sidebarCollapsed,
-                        sidebarCollapsible: options.sidebarCollapsible,
-                    },
-                    categoryLabelSlugger: (0, utils_1.createSlugger)(),
-                });
-                const sidebarsUtils = (0, utils_2.createSidebarsUtils)(sidebars);
-                const docsById = (0, docs_1.createDocsByIdIndex)(docs);
-                const allDocIds = Object.keys(docsById);
-                sidebarsUtils.checkLegacyVersionedSidebarNames({
-                    sidebarFilePath: versionMetadata.sidebarFilePath,
-                    versionMetadata,
-                });
-                sidebarsUtils.checkSidebarsDocIds({
-                    allDocIds,
-                    sidebarFilePath: versionMetadata.sidebarFilePath,
-                    versionMetadata,
-                });
-                return {
-                    ...versionMetadata,
-                    docs: (0, docs_1.addDocNavigation)({
-                        docs,
-                        sidebarsUtils,
-                    }),
-                    drafts,
-                    sidebars,
-                };
-            }
-            async function loadVersion(versionMetadata) {
-                try {
-                    return await doLoadVersion(versionMetadata);
-                }
-                catch (err) {
-                    logger_1.default.error `Loading of version failed for version name=${versionMetadata.versionName}`;
-                    throw err;
-                }
-            }
             return {
-                loadedVersions: await Promise.all(versionsMetadata.map(loadVersion)),
+                loadedVersions: await Promise.all(versionsMetadata.map((versionMetadata) => (0, loadVersion_1.loadVersion)({
+                    context,
+                    options,
+                    env,
+                    versionMetadata,
+                }))),
             };
         },
         translateContent({ content, translationFiles }) {
@@ -229,7 +162,7 @@ async function pluginContentDocs(context, options) {
         },
         async contentLoaded({ content, actions }) {
             contentHelpers.updateContent(content);
-            const versions = content.loadedVersions.map(versions_1.toFullVersion);
+            const versions = content.loadedVersions.map(version_1.toFullVersion);
             await (0, routes_1.createAllRoutes)({
                 baseUrl,
                 versions,

package/lib/server-export.d.ts

@@ -5,5 +5,5 @@
  * LICENSE file in the root directory of this source tree.
  */
 export { CURRENT_VERSION_NAME, VERSIONED_DOCS_DIR, VERSIONED_SIDEBARS_DIR, VERSIONS_JSON_FILE, } from './constants';
-export { filterVersions, getDefaultVersionBanner, getVersionBadge, getVersionBanner, } from './versions';
+export { filterVersions, getDefaultVersionBanner, getVersionBadge, getVersionBanner, } from './versions/version';
 export { readVersionNames } from './versions/files';

package/lib/server-export.js

@@ -16,10 +16,10 @@ Object.defineProperty(exports, "CURRENT_VERSION_NAME", { enumerable: true, get:
 Object.defineProperty(exports, "VERSIONED_DOCS_DIR", { enumerable: true, get: function () { return constants_1.VERSIONED_DOCS_DIR; } });
 Object.defineProperty(exports, "VERSIONED_SIDEBARS_DIR", { enumerable: true, get: function () { return constants_1.VERSIONED_SIDEBARS_DIR; } });
 Object.defineProperty(exports, "VERSIONS_JSON_FILE", { enumerable: true, get: function () { return constants_1.VERSIONS_JSON_FILE; } });
-var versions_1 = require("./versions");
-Object.defineProperty(exports, "filterVersions", { enumerable: true, get: function () { return versions_1.filterVersions; } });
-Object.defineProperty(exports, "getDefaultVersionBanner", { enumerable: true, get: function () { return versions_1.getDefaultVersionBanner; } });
-Object.defineProperty(exports, "getVersionBadge", { enumerable: true, get: function () { return versions_1.getVersionBadge; } });
-Object.defineProperty(exports, "getVersionBanner", { enumerable: true, get: function () { return versions_1.getVersionBanner; } });
+var version_1 = require("./versions/version");
+Object.defineProperty(exports, "filterVersions", { enumerable: true, get: function () { return version_1.filterVersions; } });
+Object.defineProperty(exports, "getDefaultVersionBanner", { enumerable: true, get: function () { return version_1.getDefaultVersionBanner; } });
+Object.defineProperty(exports, "getVersionBadge", { enumerable: true, get: function () { return version_1.getVersionBadge; } });
+Object.defineProperty(exports, "getVersionBanner", { enumerable: true, get: function () { return version_1.getVersionBanner; } });
 var files_1 = require("./versions/files");
 Object.defineProperty(exports, "readVersionNames", { enumerable: true, get: function () { return files_1.readVersionNames; } });

package/lib/sidebars/utils.d.ts

@@ -62,7 +62,7 @@ export type SidebarsUtils = {
 };
 export declare function createSidebarsUtils(sidebars: Sidebars): SidebarsUtils;
 export declare function toDocNavigationLink(doc: DocMetadataBase, options?: {
-    sidebarItemLabel?: string | undefined;
+    sidebarItemLabel?: string;
 }): PropNavigationLink;
 export declare function toNavigationLink(navigationItem: SidebarNavigationItem | undefined, docsById: {
     [docId: string]: DocMetadataBase;

package/lib/versions/files.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { PluginOptions, VersionMetadata } from '@docusaurus/plugin-content-docs';
-import type { VersionContext } from './index';
+import type { VersionContext } from './version';
 /** `[siteDir]/community_versioned_docs/version-1.0.0` */
 export declare function getVersionDocsDirPath(siteDir: string, pluginId: string, versionName: string): string;
 /** `[siteDir]/community_versioned_sidebars/version-1.0.0-sidebars.json` */

package/lib/versions/loadVersion.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type DocEnv } from '../docs';
+import type { LoadedVersion, PluginOptions, VersionMetadata } from '@docusaurus/plugin-content-docs';
+import type { LoadContext } from '@docusaurus/types';
+export declare function loadVersion({ context, options, versionMetadata, env, }: {
+    context: LoadContext;
+    options: PluginOptions;
+    versionMetadata: VersionMetadata;
+    env: DocEnv;
+}): Promise<LoadedVersion>;

package/lib/versions/loadVersion.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadVersion = loadVersion;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const utils_1 = require("@docusaurus/utils");
+const utils_validation_1 = require("@docusaurus/utils-validation");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const docs_1 = require("../docs");
+const sidebars_1 = require("../sidebars");
+const utils_2 = require("../sidebars/utils");
+async function loadVersion({ context, options, versionMetadata, env, }) {
+    const { siteDir } = context;
+    async function loadVersionDocsBase(tagsFile) {
+        const docFiles = await (0, docs_1.readVersionDocs)(versionMetadata, options);
+        if (docFiles.length === 0) {
+            throw new Error(`Docs version "${versionMetadata.versionName}" has no docs! At least one doc should exist at "${path_1.default.relative(siteDir, versionMetadata.contentPath)}".`);
+        }
+        function processVersionDoc(docFile) {
+            return (0, docs_1.processDocMetadata)({
+                docFile,
+                versionMetadata,
+                context,
+                options,
+                env,
+                tagsFile,
+            });
+        }
+        return Promise.all(docFiles.map(processVersionDoc));
+    }
+    async function doLoadVersion() {
+        const tagsFile = await (0, utils_validation_1.getTagsFile)({
+            contentPaths: versionMetadata,
+            tags: options.tags,
+        });
+        const docsBase = await loadVersionDocsBase(tagsFile);
+        // TODO we only ever need draftIds in further code, not full draft items
+        // To simplify and prevent mistakes, avoid exposing draft
+        // replace draft=>draftIds in content loaded
+        const [drafts, docs] = lodash_1.default.partition(docsBase, (doc) => doc.draft);
+        const sidebars = await (0, sidebars_1.loadSidebars)(versionMetadata.sidebarFilePath, {
+            sidebarItemsGenerator: options.sidebarItemsGenerator,
+            numberPrefixParser: options.numberPrefixParser,
+            docs,
+            drafts,
+            version: versionMetadata,
+            sidebarOptions: {
+                sidebarCollapsed: options.sidebarCollapsed,
+                sidebarCollapsible: options.sidebarCollapsible,
+            },
+            categoryLabelSlugger: (0, utils_1.createSlugger)(),
+        });
+        const sidebarsUtils = (0, utils_2.createSidebarsUtils)(sidebars);
+        const docsById = (0, docs_1.createDocsByIdIndex)(docs);
+        const allDocIds = Object.keys(docsById);
+        sidebarsUtils.checkLegacyVersionedSidebarNames({
+            sidebarFilePath: versionMetadata.sidebarFilePath,
+            versionMetadata,
+        });
+        sidebarsUtils.checkSidebarsDocIds({
+            allDocIds,
+            sidebarFilePath: versionMetadata.sidebarFilePath,
+            versionMetadata,
+        });
+        return {
+            ...versionMetadata,
+            docs: (0, docs_1.addDocNavigation)({
+                docs,
+                sidebarsUtils,
+            }),
+            drafts,
+            sidebars,
+        };
+    }
+    try {
+        return await doLoadVersion();
+    }
+    catch (err) {
+        logger_1.default.error `Loading of version failed for version name=${versionMetadata.versionName}`;
+        throw err;
+    }
+}

package/lib/versions/{index.js → version.js}

@@ -151,14 +151,13 @@ async function readVersionsMetadata({ context, options, }) {
     (0, validation_1.validateVersionsOptions)(allVersionNames, options);
     const versionNames = filterVersions(allVersionNames, options);
     const lastVersionName = getLastVersionName({ versionNames, options });
-    const versionsMetadata = await Promise.all(versionNames.map((versionName) => createVersionMetadata({
+    return Promise.all(versionNames.map((versionName) => createVersionMetadata({
         versionName,
         versionNames,
         lastVersionName,
         context,
         options,
     })));
-    return versionsMetadata;
 }
 function toFullVersion(version) {
     const sidebarsUtils = (0, utils_2.createSidebarsUtils)(version.sidebars);

package/package.json

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

package/src/index.ts

@@ -7,7 +7,6 @@
 
 import path from 'path';
 import fs from 'fs-extra';
-import _ from 'lodash';
 import logger from '@docusaurus/logger';
 import {
   normalizeUrl,
@@ -17,30 +16,19 @@ import {
   posixPath,
   addTrailingPathSeparator,
   createAbsoluteFilePathMatcher,
-  createSlugger,
   resolveMarkdownLinkPathname,
   DEFAULT_PLUGIN_ID,
-  type TagsFile,
 } from '@docusaurus/utils';
-import {
-  getTagsFile,
-  getTagsFilePathsToWatch,
-} from '@docusaurus/utils-validation';
+import {getTagsFilePathsToWatch} from '@docusaurus/utils-validation';
 import {createMDXLoaderRule} from '@docusaurus/mdx-loader';
-import {loadSidebars, resolveSidebarPathOption} from './sidebars';
+import {resolveSidebarPathOption} from './sidebars';
 import {CategoryMetadataFilenamePattern} from './sidebars/generator';
-import {
-  readVersionDocs,
-  processDocMetadata,
-  addDocNavigation,
-  type DocEnv,
-  createDocsByIdIndex,
-} from './docs';
+import {type DocEnv} from './docs';
 import {
   getVersionFromSourceFilePath,
   readVersionsMetadata,
   toFullVersion,
-} from './versions';
+} from './versions/version';
 import cliDocs from './cli';
 import {VERSIONS_JSON_FILE} from './constants';
 import {toGlobalDataVersion} from './globalData';
@@ -49,19 +37,17 @@ import {
   getLoadedContentTranslationFiles,
 } from './translations';
 import {createAllRoutes} from './routes';
-import {createSidebarsUtils} from './sidebars/utils';
 
 import {createContentHelpers} from './contentHelpers';
+import {loadVersion} from './versions/loadVersion';
 import type {
   PluginOptions,
-  DocMetadataBase,
   VersionMetadata,
   DocFrontMatter,
   LoadedContent,
-  LoadedVersion,
 } from '@docusaurus/plugin-content-docs';
 import type {LoadContext, Plugin} from '@docusaurus/types';
-import type {DocFile, FullVersion} from './types';
+import type {FullVersion} from './types';
 import type {RuleSetRule} from 'webpack';
 
 // MDX loader is not 100% deterministic, leading to cache invalidation issue
@@ -243,102 +229,17 @@ export default async function pluginContentDocs(
     },
 
     async loadContent() {
-      async function loadVersionDocsBase(
-        versionMetadata: VersionMetadata,
-        tagsFile: TagsFile | null,
-      ): Promise<DocMetadataBase[]> {
-        const docFiles = await readVersionDocs(versionMetadata, options);
-        if (docFiles.length === 0) {
-          throw new Error(
-            `Docs version "${
-              versionMetadata.versionName
-            }" has no docs! At least one doc should exist at "${path.relative(
-              siteDir,
-              versionMetadata.contentPath,
-            )}".`,
-          );
-        }
-        function processVersionDoc(docFile: DocFile) {
-          return processDocMetadata({
-            docFile,
-            versionMetadata,
-            context,
-            options,
-            env,
-            tagsFile,
-          });
-        }
-        return Promise.all(docFiles.map(processVersionDoc));
-      }
-
-      async function doLoadVersion(
-        versionMetadata: VersionMetadata,
-      ): Promise<LoadedVersion> {
-        const tagsFile = await getTagsFile({
-          contentPaths: versionMetadata,
-          tags: options.tags,
-        });
-
-        const docsBase: DocMetadataBase[] = await loadVersionDocsBase(
-          versionMetadata,
-          tagsFile,
-        );
-
-        // TODO we only ever need draftIds in further code, not full draft items
-        // To simplify and prevent mistakes, avoid exposing draft
-        // replace draft=>draftIds in content loaded
-        const [drafts, docs] = _.partition(docsBase, (doc) => doc.draft);
-
-        const sidebars = await loadSidebars(versionMetadata.sidebarFilePath, {
-          sidebarItemsGenerator: options.sidebarItemsGenerator,
-          numberPrefixParser: options.numberPrefixParser,
-          docs,
-          drafts,
-          version: versionMetadata,
-          sidebarOptions: {
-            sidebarCollapsed: options.sidebarCollapsed,
-            sidebarCollapsible: options.sidebarCollapsible,
-          },
-          categoryLabelSlugger: createSlugger(),
-        });
-
-        const sidebarsUtils = createSidebarsUtils(sidebars);
-
-        const docsById = createDocsByIdIndex(docs);
-        const allDocIds = Object.keys(docsById);
-
-        sidebarsUtils.checkLegacyVersionedSidebarNames({
-          sidebarFilePath: versionMetadata.sidebarFilePath as string,
-          versionMetadata,
-        });
-        sidebarsUtils.checkSidebarsDocIds({
-          allDocIds,
-          sidebarFilePath: versionMetadata.sidebarFilePath as string,
-          versionMetadata,
-        });
-
-        return {
-          ...versionMetadata,
-          docs: addDocNavigation({
-            docs,
-            sidebarsUtils,
-          }),
-          drafts,
-          sidebars,
-        };
-      }
-
-      async function loadVersion(versionMetadata: VersionMetadata) {
-        try {
-          return await doLoadVersion(versionMetadata);
-        } catch (err) {
-          logger.error`Loading of version failed for version name=${versionMetadata.versionName}`;
-          throw err;
-        }
-      }
-
       return {
-        loadedVersions: await Promise.all(versionsMetadata.map(loadVersion)),
+        loadedVersions: await Promise.all(
+          versionsMetadata.map((versionMetadata) =>
+            loadVersion({
+              context,
+              options,
+              env,
+              versionMetadata,
+            }),
+          ),
+        ),
       };
     },
 

package/src/server-export.ts

@@ -22,5 +22,5 @@ export {
   getDefaultVersionBanner,
   getVersionBadge,
   getVersionBanner,
-} from './versions';
+} from './versions/version';
 export {readVersionNames} from './versions/files';

package/src/sidebars/utils.ts

@@ -480,7 +480,7 @@ Available document ids are:
 
 export function toDocNavigationLink(
   doc: DocMetadataBase,
-  options?: {sidebarItemLabel?: string | undefined},
+  options?: {sidebarItemLabel?: string},
 ): PropNavigationLink {
   const {
     title,

package/src/versions/files.ts

@@ -19,7 +19,7 @@ import type {
   PluginOptions,
   VersionMetadata,
 } from '@docusaurus/plugin-content-docs';
-import type {VersionContext} from './index';
+import type {VersionContext} from './version';
 
 /** Add a prefix like `community_version-1.0.0`. No-op for default instance. */
 function addPluginIdPrefix(fileOrDir: string, pluginId: string): string {

package/src/versions/loadVersion.ts

@@ -0,0 +1,130 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import path from 'path';
+import _ from 'lodash';
+import {createSlugger} from '@docusaurus/utils';
+import {getTagsFile} from '@docusaurus/utils-validation';
+import logger from '@docusaurus/logger';
+import {
+  addDocNavigation,
+  createDocsByIdIndex,
+  type DocEnv,
+  processDocMetadata,
+  readVersionDocs,
+} from '../docs';
+import {loadSidebars} from '../sidebars';
+import {createSidebarsUtils} from '../sidebars/utils';
+import type {TagsFile} from '@docusaurus/utils';
+import type {
+  DocMetadataBase,
+  LoadedVersion,
+  PluginOptions,
+  VersionMetadata,
+} from '@docusaurus/plugin-content-docs';
+import type {DocFile} from '../types';
+import type {LoadContext} from '@docusaurus/types';
+
+export async function loadVersion({
+  context,
+  options,
+  versionMetadata,
+  env,
+}: {
+  context: LoadContext;
+  options: PluginOptions;
+  versionMetadata: VersionMetadata;
+  env: DocEnv;
+}): Promise<LoadedVersion> {
+  const {siteDir} = context;
+
+  async function loadVersionDocsBase(
+    tagsFile: TagsFile | null,
+  ): Promise<DocMetadataBase[]> {
+    const docFiles = await readVersionDocs(versionMetadata, options);
+    if (docFiles.length === 0) {
+      throw new Error(
+        `Docs version "${
+          versionMetadata.versionName
+        }" has no docs! At least one doc should exist at "${path.relative(
+          siteDir,
+          versionMetadata.contentPath,
+        )}".`,
+      );
+    }
+    function processVersionDoc(docFile: DocFile) {
+      return processDocMetadata({
+        docFile,
+        versionMetadata,
+        context,
+        options,
+        env,
+        tagsFile,
+      });
+    }
+    return Promise.all(docFiles.map(processVersionDoc));
+  }
+
+  async function doLoadVersion(): Promise<LoadedVersion> {
+    const tagsFile = await getTagsFile({
+      contentPaths: versionMetadata,
+      tags: options.tags,
+    });
+
+    const docsBase: DocMetadataBase[] = await loadVersionDocsBase(tagsFile);
+
+    // TODO we only ever need draftIds in further code, not full draft items
+    // To simplify and prevent mistakes, avoid exposing draft
+    // replace draft=>draftIds in content loaded
+    const [drafts, docs] = _.partition(docsBase, (doc) => doc.draft);
+
+    const sidebars = await loadSidebars(versionMetadata.sidebarFilePath, {
+      sidebarItemsGenerator: options.sidebarItemsGenerator,
+      numberPrefixParser: options.numberPrefixParser,
+      docs,
+      drafts,
+      version: versionMetadata,
+      sidebarOptions: {
+        sidebarCollapsed: options.sidebarCollapsed,
+        sidebarCollapsible: options.sidebarCollapsible,
+      },
+      categoryLabelSlugger: createSlugger(),
+    });
+
+    const sidebarsUtils = createSidebarsUtils(sidebars);
+
+    const docsById = createDocsByIdIndex(docs);
+    const allDocIds = Object.keys(docsById);
+
+    sidebarsUtils.checkLegacyVersionedSidebarNames({
+      sidebarFilePath: versionMetadata.sidebarFilePath as string,
+      versionMetadata,
+    });
+    sidebarsUtils.checkSidebarsDocIds({
+      allDocIds,
+      sidebarFilePath: versionMetadata.sidebarFilePath as string,
+      versionMetadata,
+    });
+
+    return {
+      ...versionMetadata,
+      docs: addDocNavigation({
+        docs,
+        sidebarsUtils,
+      }),
+      drafts,
+      sidebars,
+    };
+  }
+
+  try {
+    return await doLoadVersion();
+  } catch (err) {
+    logger.error`Loading of version failed for version name=${versionMetadata.versionName}`;
+    throw err;
+  }
+}

package/src/versions/{index.ts → version.ts}

@@ -243,7 +243,7 @@ export async function readVersionsMetadata({
   validateVersionsOptions(allVersionNames, options);
   const versionNames = filterVersions(allVersionNames, options);
   const lastVersionName = getLastVersionName({versionNames, options});
-  const versionsMetadata = await Promise.all(
+  return Promise.all(
     versionNames.map((versionName) =>
       createVersionMetadata({
         versionName,
@@ -254,7 +254,6 @@ export async function readVersionsMetadata({
       }),
     ),
   );
-  return versionsMetadata;
 }
 
 export function toFullVersion(version: LoadedVersion): FullVersion {