@docusaurus/plugin-content-docs 2.0.0-beta.16 → 2.0.0-beta.19

package/lib/sidebars/processor.js

@@ -10,13 +10,14 @@ exports.processSidebars = void 0;
 const tslib_1 = require("tslib");
 const generator_1 = require("./generator");
 const validation_1 = require("./validation");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
-const combine_promises_1 = (0, tslib_1.__importDefault)(require("combine-promises"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
 const docs_1 = require("../docs");
 function toSidebarItemsGeneratorDoc(doc) {
     return lodash_1.default.pick(doc, [
         'id',
         'unversionedId',
+        'title',
         'frontMatter',
         'source',
         'sourceDirName',
@@ -29,7 +30,7 @@ function toSidebarItemsGeneratorVersion(version) {
 // Handle the generation of autogenerated sidebar items and other
 // post-processing checks
 async function processSidebar(unprocessedSidebar, categoriesMetadata, params) {
-    const { sidebarItemsGenerator, numberPrefixParser, docs, version, sidebarOptions, } = params;
+    const { sidebarItemsGenerator, numberPrefixParser, docs, drafts, version } = params;
     // Just a minor lazy transformation optimization
     const getSidebarItemsGeneratorDocsAndVersion = lodash_1.default.memoize(() => ({
         docs: docs.map(toSidebarItemsGeneratorDoc),
@@ -42,7 +43,6 @@ async function processSidebar(unprocessedSidebar, categoriesMetadata, params) {
             defaultSidebarItemsGenerator: generator_1.DefaultSidebarItemsGenerator,
             isCategoryIndex: docs_1.isCategoryIndex,
             ...getSidebarItemsGeneratorDocsAndVersion(),
-            options: sidebarOptions,
             categoriesMetadata,
         });
         // Process again... weird but sidebar item generated might generate some
@@ -51,12 +51,23 @@ async function processSidebar(unprocessedSidebar, categoriesMetadata, params) {
         // more autogenerated items, or when loop count (e.g. 10) is reached
         return processItems(generatedItems);
     }
+    const draftIds = new Set(drafts.flatMap(docs_1.getDocIds));
+    const isDraftItem = (item) => {
+        if (item.type === 'doc' || item.type === 'ref') {
+            return draftIds.has(item.id);
+        }
+        // If a category only contains draft items, it should be filtered entirely.
+        if (item.type === 'category') {
+            return item.items.every(isDraftItem);
+        }
+        return false;
+    };
     async function processItem(item) {
         if (item.type === 'category') {
             return [
                 {
                     ...item,
-                    items: (await Promise.all(item.items.map(processItem))).flat(),
+                    items: await processItems(item.items),
                 },
             ];
         }
@@ -66,7 +77,7 @@ async function processSidebar(unprocessedSidebar, categoriesMetadata, params) {
         return [item];
     }
     async function processItems(items) {
-        return (await Promise.all(items.map(processItem))).flat();
+        return (await Promise.all(items.filter((i) => !isDraftItem(i)).map(processItem))).flat();
     }
     const processedSidebar = await processItems(unprocessedSidebar);
     return processedSidebar;

package/lib/sidebars/types.d.ts

@@ -5,15 +5,18 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { Optional, Required } from 'utility-types';
-import type { DocMetadataBase, VersionMetadata } from '../types';
-import type { NumberPrefixParser, SidebarOptions, CategoryIndexMatcher } from '@docusaurus/plugin-content-docs';
+import type { NumberPrefixParser, SidebarOptions, CategoryIndexMatcher, DocMetadataBase, VersionMetadata } from '@docusaurus/plugin-content-docs';
 import type { Slugger } from '@docusaurus/utils';
-declare type Expand<T extends Record<string, unknown>> = {
+declare type Expand<T extends {
+    [x: string]: unknown;
+}> = {
     [P in keyof T]: T[P];
 };
 export declare type SidebarItemBase = {
     className?: string;
-    customProps?: Record<string, unknown>;
+    customProps?: {
+        [key: string]: unknown;
+    };
 };
 export declare type SidebarItemDoc = SidebarItemBase & {
     type: 'doc' | 'ref';
@@ -122,15 +125,6 @@ export declare type PropSidebars = {
     [sidebarId: string]: PropSidebar;
 };
 export declare type PropSidebarBreadcrumbsItem = PropSidebarItemLink | PropSidebarItemCategory;
-export declare type PropVersionDoc = {
-    id: string;
-    title: string;
-    description?: string;
-    sidebar?: string;
-};
-export declare type PropVersionDocs = {
-    [docId: string]: PropVersionDoc;
-};
 export declare type CategoryMetadataFile = {
     label?: string;
     position?: number;
@@ -138,27 +132,45 @@ export declare type CategoryMetadataFile = {
     collapsible?: boolean;
     className?: string;
     link?: SidebarItemCategoryLinkConfig | null;
+    customProps?: {
+        [key: string]: unknown;
+    };
 };
-export declare type SidebarItemsGeneratorDoc = Pick<DocMetadataBase, 'id' | 'unversionedId' | 'frontMatter' | 'source' | 'sourceDirName' | 'sidebarPosition'>;
+export declare type SidebarItemsGeneratorDoc = Pick<DocMetadataBase, 'id' | 'unversionedId' | 'title' | 'frontMatter' | 'source' | 'sourceDirName' | 'sidebarPosition'>;
 export declare type SidebarItemsGeneratorVersion = Pick<VersionMetadata, 'versionName' | 'contentPath'>;
 export declare type SidebarItemsGeneratorArgs = {
+    /** The sidebar item with type "autogenerated" to be transformed. */
     item: SidebarItemAutogenerated;
+    /** Useful metadata for the version this sidebar belongs to. */
     version: SidebarItemsGeneratorVersion;
+    /** All the docs of that version (unfiltered). */
     docs: SidebarItemsGeneratorDoc[];
+    /** Number prefix parser configured for this plugin. */
     numberPrefixParser: NumberPrefixParser;
+    /** The default category index matcher which you can override. */
     isCategoryIndex: CategoryIndexMatcher;
-    categoriesMetadata: Record<string, CategoryMetadataFile>;
-    options: SidebarOptions;
+    /**
+     * Key is the path relative to the doc content directory, value is the
+     * category metadata file's content.
+     */
+    categoriesMetadata: {
+        [filePath: string]: CategoryMetadataFile;
+    };
 };
 export declare type SidebarItemsGenerator = (generatorArgs: SidebarItemsGeneratorArgs) => Promise<NormalizedSidebar>;
-export declare type SidebarItemsGeneratorOptionArgs = {
+export declare type SidebarItemsGeneratorOption = (generatorArgs: {
+    /**
+     * Useful to re-use/enhance the default sidebar generation logic from
+     * Docusaurus.
+     * @see https://github.com/facebook/docusaurus/issues/4640#issuecomment-822292320
+     */
     defaultSidebarItemsGenerator: SidebarItemsGenerator;
-} & SidebarItemsGeneratorArgs;
-export declare type SidebarItemsGeneratorOption = (generatorArgs: SidebarItemsGeneratorOptionArgs) => Promise<NormalizedSidebarItem[]>;
+} & SidebarItemsGeneratorArgs) => Promise<NormalizedSidebarItem[]>;
 export declare type SidebarProcessorParams = {
     sidebarItemsGenerator: SidebarItemsGeneratorOption;
     numberPrefixParser: NumberPrefixParser;
     docs: DocMetadataBase[];
+    drafts: DocMetadataBase[];
     version: VersionMetadata;
     categoryLabelSlugger: Slugger;
     sidebarOptions: SidebarOptions;

package/lib/sidebars/utils.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { Sidebars, Sidebar, SidebarItem, SidebarItemCategory, SidebarItemLink, SidebarItemDoc, SidebarCategoriesShorthand, SidebarItemConfig, SidebarItemCategoryWithGeneratedIndex, SidebarNavigationItem } from './types';
-import type { DocMetadataBase, DocNavLink } from '../types';
+import type { DocMetadataBase, PropNavigationLink } from '@docusaurus/plugin-content-docs';
 export declare function isCategoriesShorthand(item: SidebarItemConfig): item is SidebarCategoriesShorthand;
 export declare function transformSidebarItems(sidebar: Sidebar, updateFn: (item: SidebarItem) => SidebarItem): Sidebar;
 export declare function collectSidebarDocItems(sidebar: Sidebar): SidebarItemDoc[];
@@ -13,8 +13,12 @@ export declare function collectSidebarCategories(sidebar: Sidebar): SidebarItemC
 export declare function collectSidebarLinks(sidebar: Sidebar): SidebarItemLink[];
 export declare function collectSidebarDocIds(sidebar: Sidebar): string[];
 export declare function collectSidebarNavigation(sidebar: Sidebar): SidebarNavigationItem[];
-export declare function collectSidebarsDocIds(sidebars: Sidebars): Record<string, string[]>;
-export declare function collectSidebarsNavigations(sidebars: Sidebars): Record<string, SidebarNavigationItem[]>;
+export declare function collectSidebarsDocIds(sidebars: Sidebars): {
+    [sidebarId: string]: string[];
+};
+export declare function collectSidebarsNavigations(sidebars: Sidebars): {
+    [sidebarId: string]: SidebarNavigationItem[];
+};
 export declare type SidebarNavigation = {
     sidebarName: string | undefined;
     previous: SidebarNavigationItem | undefined;
@@ -27,17 +31,24 @@ export declare type SidebarsUtils = {
     getDocNavigation: (unversionedId: string, versionedId: string, displayedSidebar: string | null | undefined) => SidebarNavigation;
     getCategoryGeneratedIndexList: () => SidebarItemCategoryWithGeneratedIndex[];
     getCategoryGeneratedIndexNavigation: (categoryGeneratedIndexPermalink: string) => SidebarNavigation;
+    /**
+     * This function may return undefined. This is usually a user mistake, because
+     * it means this sidebar will never be displayed; however, we can still use
+     * `displayed_sidebar` to make it displayed. Pretty weird but valid use-case
+     */
     getFirstLink: (sidebarId: string) => {
         type: 'doc';
         id: string;
         label: string;
     } | {
         type: 'generated-index';
-        slug: string;
+        permalink: string;
         label: string;
     } | undefined;
     checkSidebarsDocIds: (validDocIds: string[], sidebarFilePath: string) => void;
 };
 export declare function createSidebarsUtils(sidebars: Sidebars): SidebarsUtils;
-export declare function toDocNavigationLink(doc: DocMetadataBase): DocNavLink;
-export declare function toNavigationLink(navigationItem: SidebarNavigationItem | undefined, docsById: Record<string, DocMetadataBase>): DocNavLink | undefined;
+export declare function toDocNavigationLink(doc: DocMetadataBase): PropNavigationLink;
+export declare function toNavigationLink(navigationItem: SidebarNavigationItem | undefined, docsById: {
+    [docId: string]: DocMetadataBase;
+}): PropNavigationLink | undefined;

package/lib/sidebars/utils.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toNavigationLink = exports.toDocNavigationLink = exports.createSidebarsUtils = exports.collectSidebarsNavigations = exports.collectSidebarsDocIds = exports.collectSidebarNavigation = exports.collectSidebarDocIds = exports.collectSidebarLinks = exports.collectSidebarCategories = exports.collectSidebarDocItems = exports.transformSidebarItems = exports.isCategoriesShorthand = void 0;
 const tslib_1 = require("tslib");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 function isCategoriesShorthand(item) {
     return typeof item === 'object' && !item.type;
@@ -58,9 +58,8 @@ exports.collectSidebarLinks = collectSidebarLinks;
 // /!\ docId order matters for navigation!
 function collectSidebarDocIds(sidebar) {
     return flattenSidebarItems(sidebar).flatMap((item) => {
-        var _a;
         if (item.type === 'category') {
-            return ((_a = item.link) === null || _a === void 0 ? void 0 : _a.type) === 'doc' ? [item.link.id] : [];
+            return item.link?.type === 'doc' ? [item.link.id] : [];
         }
         if (item.type === 'doc') {
             return [item.id];
@@ -95,8 +94,7 @@ function createSidebarsUtils(sidebars) {
     // Reverse mapping
     const docIdToSidebarName = Object.fromEntries(Object.entries(sidebarNameToDocIds).flatMap(([sidebarName, docIds]) => docIds.map((docId) => [docId, sidebarName])));
     function getFirstDocIdOfFirstSidebar() {
-        var _a;
-        return (_a = Object.values(sidebarNameToDocIds)[0]) === null || _a === void 0 ? void 0 : _a[0];
+        return Object.values(sidebarNameToDocIds)[0]?.[0];
     }
     function getSidebarNameByDocId(docId) {
         return docIdToSidebarName[docId];
@@ -121,10 +119,10 @@ function createSidebarsUtils(sidebars) {
         if (!sidebarName) {
             return emptySidebarNavigation();
         }
-        if (!sidebarNameToNavigationItems[sidebarName]) {
+        const navigationItems = sidebarNameToNavigationItems[sidebarName];
+        if (!navigationItems) {
             throw new Error(`Doc with ID ${docId} wants to display sidebar ${sidebarName} but a sidebar with this name doesn't exist`);
         }
-        const navigationItems = sidebarNameToNavigationItems[sidebarName];
         const currentItemIndex = navigationItems.findIndex((item) => {
             if (item.type === 'doc') {
                 return item.id === docId;
@@ -137,8 +135,11 @@ function createSidebarsUtils(sidebars) {
         if (currentItemIndex === -1) {
             return { sidebarName, next: undefined, previous: undefined };
         }
-        const { previous, next } = (0, utils_1.getElementsAround)(navigationItems, currentItemIndex);
-        return { sidebarName, previous, next };
+        return {
+            sidebarName,
+            previous: navigationItems[currentItemIndex - 1],
+            next: navigationItems[currentItemIndex + 1],
+        };
     }
     function getCategoryGeneratedIndexList() {
         return Object.values(sidebarNameToNavigationItems)
@@ -155,21 +156,19 @@ function createSidebarsUtils(sidebars) {
      * unique). More reliable than using object identity
      */
     function getCategoryGeneratedIndexNavigation(categoryGeneratedIndexPermalink) {
-        var _a;
         function isCurrentCategoryGeneratedIndexItem(item) {
-            var _a;
             return (item.type === 'category' &&
-                ((_a = item.link) === null || _a === void 0 ? void 0 : _a.type) === 'generated-index' &&
+                item.link?.type === 'generated-index' &&
                 item.link.permalink === categoryGeneratedIndexPermalink);
         }
-        const sidebarName = (_a = Object.entries(sidebarNameToNavigationItems).find(([, navigationItems]) => navigationItems.find(isCurrentCategoryGeneratedIndexItem))) === null || _a === void 0 ? void 0 : _a[0];
-        if (!sidebarName) {
-            return emptySidebarNavigation();
-        }
+        const sidebarName = Object.entries(sidebarNameToNavigationItems).find(([, navigationItems]) => navigationItems.find(isCurrentCategoryGeneratedIndexItem))[0];
         const navigationItems = sidebarNameToNavigationItems[sidebarName];
         const currentItemIndex = navigationItems.findIndex(isCurrentCategoryGeneratedIndexItem);
-        const { previous, next } = (0, utils_1.getElementsAround)(navigationItems, currentItemIndex);
-        return { sidebarName, previous, next };
+        return {
+            sidebarName,
+            previous: navigationItems[currentItemIndex - 1],
+            next: navigationItems[currentItemIndex + 1],
+        };
     }
     function checkSidebarsDocIds(validDocIds, sidebarFilePath) {
         const allSidebarDocIds = Object.values(sidebarNameToDocIds).flat();
@@ -184,27 +183,26 @@ Available document ids are:
         }
     }
     function getFirstLink(sidebar) {
-        var _a, _b, _c;
         for (const item of sidebar) {
             if (item.type === 'doc') {
                 return {
                     type: 'doc',
                     id: item.id,
-                    label: (_a = item.label) !== null && _a !== void 0 ? _a : item.id,
+                    label: item.label ?? item.id,
                 };
             }
             else if (item.type === 'category') {
-                if (((_b = item.link) === null || _b === void 0 ? void 0 : _b.type) === 'doc') {
+                if (item.link?.type === 'doc') {
                     return {
                         type: 'doc',
                         id: item.link.id,
                         label: item.label,
                     };
                 }
-                else if (((_c = item.link) === null || _c === void 0 ? void 0 : _c.type) === 'generated-index') {
+                else if (item.link?.type === 'generated-index') {
                     return {
                         type: 'generated-index',
-                        slug: item.link.slug,
+                        permalink: item.link.permalink,
                         label: item.label,
                     };
                 }
@@ -229,9 +227,8 @@ Available document ids are:
 }
 exports.createSidebarsUtils = createSidebarsUtils;
 function toDocNavigationLink(doc) {
-    var _a;
     const { title, permalink, frontMatter: { pagination_label: paginationLabel, sidebar_label: sidebarLabel, }, } = doc;
-    return { title: (_a = paginationLabel !== null && paginationLabel !== void 0 ? paginationLabel : sidebarLabel) !== null && _a !== void 0 ? _a : title, permalink };
+    return { title: paginationLabel ?? sidebarLabel ?? title, permalink };
 }
 exports.toDocNavigationLink = toDocNavigationLink;
 function toNavigationLink(navigationItem, docsById) {
@@ -245,21 +242,14 @@ function toNavigationLink(navigationItem, docsById) {
     if (!navigationItem) {
         return undefined;
     }
-    if (navigationItem.type === 'doc') {
-        return toDocNavigationLink(getDocById(navigationItem.id));
-    }
-    else if (navigationItem.type === 'category') {
-        if (navigationItem.link.type === 'doc') {
-            return toDocNavigationLink(getDocById(navigationItem.link.id));
-        }
-        else if (navigationItem.link.type === 'generated-index') {
-            return {
+    if (navigationItem.type === 'category') {
+        return navigationItem.link.type === 'doc'
+            ? toDocNavigationLink(getDocById(navigationItem.link.id))
+            : {
                 title: navigationItem.label,
                 permalink: navigationItem.link.permalink,
             };
-        }
-        throw new Error('unexpected category link type');
     }
-    throw new Error('unexpected navigation item');
+    return toDocNavigationLink(getDocById(navigationItem.id));
 }
 exports.toNavigationLink = toNavigationLink;

package/lib/sidebars/validation.d.ts

@@ -5,5 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { NormalizedSidebars, CategoryMetadataFile } from './types';
-export declare function validateSidebars(sidebars: Record<string, unknown>): asserts sidebars is NormalizedSidebars;
+export declare function validateSidebars(sidebars: {
+    [sidebarId: string]: unknown;
+}): asserts sidebars is NormalizedSidebars;
 export declare function validateCategoryMetadataFile(unsafeContent: unknown): CategoryMetadataFile;

package/lib/sidebars/validation.js

@@ -130,6 +130,7 @@ const categoryMetadataFileSchema = utils_validation_1.Joi.object({
     collapsible: utils_validation_1.Joi.boolean(),
     className: utils_validation_1.Joi.string(),
     link: sidebarItemCategoryLinkSchema,
+    customProps: utils_validation_1.Joi.object().unknown(),
 });
 function validateCategoryMetadataFile(unsafeContent) {
     return utils_validation_1.Joi.attempt(unsafeContent, categoryMetadataFileSchema);

package/lib/slug.d.ts

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

package/lib/slug.js

@@ -20,7 +20,7 @@ function getSlug({ baseID, frontMatterSlug, source, sourceDirName, stripDirNumbe
         return resolveDirname;
     }
     function computeSlug() {
-        if (frontMatterSlug === null || frontMatterSlug === void 0 ? void 0 : frontMatterSlug.startsWith('/')) {
+        if (frontMatterSlug?.startsWith('/')) {
             return frontMatterSlug;
         }
         const dirNameSlug = getDirNameSlug();
@@ -33,12 +33,11 @@ function getSlug({ baseID, frontMatterSlug, source, sourceDirName, stripDirNumbe
     }
     function ensureValidSlug(slug) {
         if (!(0, utils_1.isValidPathname)(slug)) {
-            throw new Error(`We couldn't compute a valid slug for document with id "${baseID}" in "${sourceDirName}" directory.
+            throw new Error(`We couldn't compute a valid slug for document with ID "${baseID}" in "${sourceDirName}" directory.
 The slug we computed looks invalid: ${slug}.
-Maybe your slug front matter is incorrect or you use weird chars in the file path?
-By using the slug front matter, you should be able to fix this error, by using the slug of your choice:
+Maybe your slug front matter is incorrect or there are special characters in the file path?
+By using front matter to set a custom slug, you should be able to fix this error:
 
-Example =>
 ---
 slug: /my/customDocPath
 ---

package/lib/tags.d.ts

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

package/lib/tags.js

@@ -9,11 +9,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVersionTags = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 function getVersionTags(docs) {
     const groups = (0, utils_1.groupTaggedItems)(docs, (doc) => doc.tags);
     return lodash_1.default.mapValues(groups, (group) => ({
-        name: group.tag.label,
+        label: group.tag.label,
         docIds: group.items.map((item) => item.id),
         permalink: group.tag.permalink,
     }));

package/lib/translations.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { LoadedContent } from './types';
-import type { TranslationFile, TranslationFiles } from '@docusaurus/types';
-export declare function getLoadedContentTranslationFiles(loadedContent: LoadedContent): TranslationFiles;
+import type { LoadedContent } from '@docusaurus/plugin-content-docs';
+import type { TranslationFile } from '@docusaurus/types';
+export declare function getLoadedContentTranslationFiles(loadedContent: LoadedContent): TranslationFile[];
 export declare function translateLoadedContent(loadedContent: LoadedContent, translationFiles: TranslationFile[]): LoadedContent;

package/lib/translations.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.translateLoadedContent = exports.getLoadedContentTranslationFiles = void 0;
 const tslib_1 = require("tslib");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("./sidebars/utils");
 const utils_2 = require("@docusaurus/utils");
 const constants_1 = require("./constants");
@@ -30,49 +30,6 @@ function getNormalizedSidebarName({ versionName, sidebarName, }) {
     const [, ...rest] = sidebarName.split('/');
     return rest.join('/');
 }
-/*
-// Do we need to translate doc metadata?
-// It seems translating front matter labels is good enough
-function getDocTranslations(doc: DocMetadata): TranslationFileContent {
-  return {
-    [`${doc.unversionedId}.title`]: {
-      message: doc.title,
-      description: `The title for doc with id=${doc.unversionedId}`,
-    },
-    ...(doc.sidebar_label
-      ? {
-          [`${doc.unversionedId}.sidebar_label`]: {
-            message: doc.sidebar_label,
-            description:
-              `The sidebar label for doc with id=${doc.unversionedId}`,
-          },
-        }
-      : undefined),
-  };
-}
-function translateDoc(
-  doc: DocMetadata,
-  docsTranslations: TranslationFileContent,
-): DocMetadata {
-  return {
-    ...doc,
-    title: docsTranslations[`${doc.unversionedId}.title`]?.message ?? doc.title,
-    sidebar_label:
-      docsTranslations[`${doc.unversionedId}.sidebar_label`]?.message ??
-      doc.sidebar_label,
-  };
-}
-
-function getDocsTranslations(version: LoadedVersion): TranslationFileContent {
-  return mergeTranslations(version.docs.map(getDocTranslations));
-}
-function translateDocs(
-  docs: DocMetadata[],
-  docsTranslations: TranslationFileContent,
-): DocMetadata[] {
-  return docs.map((doc) => translateDoc(doc, docsTranslations));
-}
- */
 function getSidebarTranslationFileContent(sidebar, sidebarName) {
     const categories = (0, utils_1.collectSidebarCategories)(sidebar);
     const categoryContent = Object.fromEntries(categories.flatMap((category) => {
@@ -84,26 +41,24 @@ function getSidebarTranslationFileContent(sidebar, sidebarName) {
                 description: `The label for category ${category.label} in sidebar ${sidebarName}`,
             },
         ]);
-        if (category.link) {
-            if (category.link.type === 'generated-index') {
-                if (category.link.title) {
-                    entries.push([
-                        `sidebar.${sidebarName}.category.${category.label}.link.generated-index.title`,
-                        {
-                            message: category.link.title,
-                            description: `The generated-index page title for category ${category.label} in sidebar ${sidebarName}`,
-                        },
-                    ]);
-                }
-                if (category.link.description) {
-                    entries.push([
-                        `sidebar.${sidebarName}.category.${category.label}.link.generated-index.description`,
-                        {
-                            message: category.link.description,
-                            description: `The generated-index page description for category ${category.label} in sidebar ${sidebarName}`,
-                        },
-                    ]);
-                }
+        if (category.link?.type === 'generated-index') {
+            if (category.link.title) {
+                entries.push([
+                    `sidebar.${sidebarName}.category.${category.label}.link.generated-index.title`,
+                    {
+                        message: category.link.title,
+                        description: `The generated-index page title for category ${category.label} in sidebar ${sidebarName}`,
+                    },
+                ]);
+            }
+            if (category.link.description) {
+                entries.push([
+                    `sidebar.${sidebarName}.category.${category.label}.link.generated-index.description`,
+                    {
+                        message: category.link.description,
+                        description: `The generated-index page description for category ${category.label} in sidebar ${sidebarName}`,
+                    },
+                ]);
             }
         }
         return entries;
@@ -120,13 +75,12 @@ function getSidebarTranslationFileContent(sidebar, sidebarName) {
 }
 function translateSidebar({ sidebar, sidebarName, sidebarsTranslations, }) {
     function transformSidebarCategoryLink(category) {
-        var _a, _b, _c, _d;
         if (!category.link) {
             return undefined;
         }
         if (category.link.type === 'generated-index') {
-            const title = (_b = (_a = sidebarsTranslations[`sidebar.${sidebarName}.category.${category.label}.link.generated-index.title`]) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : category.link.title;
-            const description = (_d = (_c = sidebarsTranslations[`sidebar.${sidebarName}.category.${category.label}.link.generated-index.description`]) === null || _c === void 0 ? void 0 : _c.message) !== null && _d !== void 0 ? _d : category.link.description;
+            const title = sidebarsTranslations[`sidebar.${sidebarName}.category.${category.label}.link.generated-index.title`]?.message ?? category.link.title;
+            const description = sidebarsTranslations[`sidebar.${sidebarName}.category.${category.label}.link.generated-index.description`]?.message ?? category.link.description;
             return {
                 ...category.link,
                 title,
@@ -136,19 +90,20 @@ function translateSidebar({ sidebar, sidebarName, sidebarsTranslations, }) {
         return category.link;
     }
     return (0, utils_1.transformSidebarItems)(sidebar, (item) => {
-        var _a, _b, _c, _d;
         if (item.type === 'category') {
             const link = transformSidebarCategoryLink(item);
             return {
                 ...item,
-                label: (_b = (_a = sidebarsTranslations[`sidebar.${sidebarName}.category.${item.label}`]) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : item.label,
+                label: sidebarsTranslations[`sidebar.${sidebarName}.category.${item.label}`]
+                    ?.message ?? item.label,
                 ...(link && { link }),
             };
         }
         if (item.type === 'link') {
             return {
                 ...item,
-                label: (_d = (_c = sidebarsTranslations[`sidebar.${sidebarName}.link.${item.label}`]) === null || _c === void 0 ? void 0 : _c.message) !== null && _d !== void 0 ? _d : item.label,
+                label: sidebarsTranslations[`sidebar.${sidebarName}.link.${item.label}`]
+                    ?.message ?? item.label,
             };
         }
         return item;
@@ -176,32 +131,24 @@ function translateSidebars(version, sidebarsTranslations) {
 function getVersionTranslationFiles(version) {
     const versionTranslations = {
         'version.label': {
-            message: version.versionLabel,
+            message: version.label,
             description: `The label for version ${version.versionName}`,
         },
     };
     const sidebarsTranslations = getSidebarsTranslations(version);
-    // const docsTranslations: TranslationFileContent =
-    //   getDocsTranslations(version);
     return [
         {
             path: getVersionFileName(version.versionName),
-            content: (0, utils_2.mergeTranslations)([
-                versionTranslations,
-                sidebarsTranslations,
-                // docsTranslations,
-            ]),
+            content: (0, utils_2.mergeTranslations)([versionTranslations, sidebarsTranslations]),
         },
     ];
 }
 function translateVersion(version, translationFiles) {
-    var _a;
     const versionTranslations = translationFiles[getVersionFileName(version.versionName)].content;
     return {
         ...version,
-        versionLabel: (_a = versionTranslations['version.label']) === null || _a === void 0 ? void 0 : _a.message,
+        label: versionTranslations['version.label']?.message ?? version.label,
         sidebars: translateSidebars(version, versionTranslations),
-        // docs: translateDocs(version.docs, versionTranslations),
     };
 }
 function getVersionsTranslationFiles(versions) {