@docusaurus/plugin-content-docs 2.4.0 → 3.0.0-alpha.0

package/lib/routes.js

@@ -6,20 +6,22 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createVersionRoutes = exports.createDocRoutes = exports.createCategoryGeneratedIndexRoutes = void 0;
+exports.createAllRoutes = exports.buildAllRoutes = void 0;
 const tslib_1 = require("tslib");
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const props_1 = require("./props");
-async function createCategoryGeneratedIndexRoutes({ version, actions, docCategoryGeneratedIndexComponent, aliasedSource, }) {
+const tags_1 = require("./tags");
+async function buildVersionCategoryGeneratedIndexRoutes({ version, actions, options, aliasedSource, }) {
     const slugs = (0, utils_1.createSlugger)();
-    async function createCategoryGeneratedIndexRoute(categoryGeneratedIndex) {
+    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: docCategoryGeneratedIndexComponent,
+            component: options.docCategoryGeneratedIndexComponent,
             exact: true,
             modules: {
                 categoryGeneratedIndex: aliasedSource(propData),
@@ -29,23 +31,22 @@ async function createCategoryGeneratedIndexRoutes({ version, actions, docCategor
             ...(sidebar && { sidebar }),
         };
     }
-    return Promise.all(version.categoryGeneratedIndices.map(createCategoryGeneratedIndexRoute));
+    return Promise.all(version.categoryGeneratedIndices.map(buildCategoryGeneratedIndexRoute));
 }
-exports.createCategoryGeneratedIndexRoutes = createCategoryGeneratedIndexRoutes;
-async function createDocRoutes({ docs, actions, docItemComponent, }) {
-    return Promise.all(docs.map(async (metadataItem) => {
+async function buildVersionDocRoutes({ version, actions, options, }) {
+    return Promise.all(version.docs.map(async (metadataItem) => {
         await actions.createData(
         // Note that this created data path must be in sync with
         // metadataPath provided to mdx-loader.
         `${(0, utils_1.docuHash)(metadataItem.source)}.json`, JSON.stringify(metadataItem, null, 2));
         const docRoute = {
             path: metadataItem.permalink,
-            component: docItemComponent,
+            component: options.docItemComponent,
             exact: true,
             modules: {
                 content: metadataItem.source,
             },
-            // Because the parent (DocPage) comp need to access it easily
+            // Because the parent (DocRoot) comp need to access it easily
             // This permits to render the sidebar once without unmount/remount when
             // navigating (and preserve sidebar state)
             ...(metadataItem.sidebar && {
@@ -55,42 +56,113 @@ async function createDocRoutes({ docs, actions, docItemComponent, }) {
         return docRoute;
     }));
 }
-exports.createDocRoutes = createDocRoutes;
-async function createVersionRoutes({ version, actions, docItemComponent, docLayoutComponent, docCategoryGeneratedIndexComponent, pluginId, aliasedSource, }) {
-    async function doCreateVersionRoutes() {
-        const versionMetadata = (0, props_1.toVersionMetadataProp)(pluginId, version);
-        const versionMetadataPropPath = await actions.createData(`${(0, utils_1.docuHash)(`version-${version.versionName}-metadata-prop`)}.json`, JSON.stringify(versionMetadata, null, 2));
-        async function createVersionSubRoutes() {
-            const [docRoutes, sidebarsRoutes] = await Promise.all([
-                createDocRoutes({ docs: version.docs, actions, docItemComponent }),
-                createCategoryGeneratedIndexRoutes({
-                    version,
-                    actions,
-                    docCategoryGeneratedIndexComponent,
-                    aliasedSource,
-                }),
-            ]);
-            const routes = [...docRoutes, ...sidebarsRoutes];
-            return routes.sort((a, b) => a.path.localeCompare(b.path));
+async function buildVersionSidebarRoute(param) {
+    const [docRoutes, categoryGeneratedIndexRoutes] = await Promise.all([
+        buildVersionDocRoutes(param),
+        buildVersionCategoryGeneratedIndexRoutes(param),
+    ]);
+    const subRoutes = [...docRoutes, ...categoryGeneratedIndexRoutes];
+    return {
+        path: param.version.path,
+        exact: false,
+        component: param.options.docRootComponent,
+        routes: subRoutes,
+    };
+}
+async function buildVersionTagsRoutes(param) {
+    const { version, options, actions, aliasedSource } = 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;
         }
-        actions.addRoute({
+        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),
+            },
+        };
+    }
+    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),
+            },
+        };
+    }
+    const [tagsListRoute, allTagsDocListRoutes] = await Promise.all([
+        buildTagsListRoute(),
+        Promise.all(Object.values(versionTags).map(buildTagDocListRoute)),
+    ]);
+    return lodash_1.default.compact([tagsListRoute, ...allTagsDocListRoutes]);
+}
+async function buildVersionRoutes(param) {
+    const { version, actions, options, aliasedSource } = param;
+    async function buildVersionSubRoutes() {
+        const [sidebarRoute, tagsRoutes] = await Promise.all([
+            buildVersionSidebarRoute(param),
+            buildVersionTagsRoutes(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,
-            // Allow matching /docs/* since this is the wrapping route
             exact: false,
-            component: docLayoutComponent,
-            routes: await createVersionSubRoutes(),
+            component: options.docVersionRootComponent,
+            routes: subRoutes,
             modules: {
-                versionMetadata: aliasedSource(versionMetadataPropPath),
+                version: aliasedSource(versionPropPath),
             },
             priority: version.routePriority,
-        });
+        };
     }
     try {
-        return await doCreateVersionRoutes();
+        return await doBuildVersionRoutes();
     }
     catch (err) {
         logger_1.default.error `Can't create version routes for version name=${version.versionName}`;
         throw err;
     }
 }
-exports.createVersionRoutes = createVersionRoutes;
+// TODO we want this buildAllRoutes function to be easily testable
+// Ideally, we should avoid side effects here (ie not injecting actions)
+async function buildAllRoutes(param) {
+    const subRoutes = await Promise.all(param.versions.map((version) => buildVersionRoutes({
+        ...param,
+        version,
+    })));
+    // all docs routes are wrapped under a single parent route, this ensures
+    // the theme layout never unmounts/remounts when navigating between versions
+    return [
+        {
+            path: (0, utils_1.normalizeUrl)([param.baseUrl, param.options.routeBasePath]),
+            exact: false,
+            component: param.options.docsRootComponent,
+            routes: subRoutes,
+        },
+    ];
+}
+exports.buildAllRoutes = buildAllRoutes;
+async function createAllRoutes(param) {
+    const routes = await buildAllRoutes(param);
+    routes.forEach(param.actions.addRoute);
+}
+exports.createAllRoutes = createAllRoutes;

package/lib/sidebars/postProcessor.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { Sidebars, SidebarProcessorParams, ProcessedSidebars } from './types';
-export declare type SidebarPostProcessorParams = SidebarProcessorParams & {
+export type SidebarPostProcessorParams = SidebarProcessorParams & {
     draftIds: Set<string>;
 };
 export declare function postProcessSidebars(sidebars: ProcessedSidebars, params: SidebarProcessorParams): Sidebars;

package/lib/sidebars/types.d.ts

@@ -7,18 +7,18 @@
 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';
-declare type Expand<T extends {
+type Expand<T extends {
     [x: string]: unknown;
 }> = {
     [P in keyof T]: T[P];
 };
-export declare type SidebarItemBase = {
+export type SidebarItemBase = {
     className?: string;
     customProps?: {
         [key: string]: unknown;
     };
 };
-export declare type SidebarItemDoc = SidebarItemBase & {
+export type SidebarItemDoc = SidebarItemBase & {
     type: 'doc' | 'ref';
     label?: string;
     id: string;
@@ -28,34 +28,34 @@ export declare type SidebarItemDoc = SidebarItemBase & {
      */
     translatable?: true;
 };
-export declare type SidebarItemHtml = SidebarItemBase & {
+export type SidebarItemHtml = SidebarItemBase & {
     type: 'html';
     value: string;
     defaultStyle?: boolean;
 };
-export declare type SidebarItemLink = SidebarItemBase & {
+export type SidebarItemLink = SidebarItemBase & {
     type: 'link';
     href: string;
     label: string;
     autoAddBaseUrl?: boolean;
     description?: string;
 };
-export declare type SidebarItemAutogenerated = SidebarItemBase & {
+export type SidebarItemAutogenerated = SidebarItemBase & {
     type: 'autogenerated';
     dirName: string;
 };
-declare type SidebarItemCategoryBase = SidebarItemBase & {
+type SidebarItemCategoryBase = SidebarItemBase & {
     type: 'category';
     label: string;
     collapsed: boolean;
     collapsible: boolean;
     description?: string;
 };
-export declare type SidebarItemCategoryLinkDoc = {
+export type SidebarItemCategoryLinkDoc = {
     type: 'doc';
     id: string;
 };
-export declare type SidebarItemCategoryLinkGeneratedIndexConfig = {
+export type SidebarItemCategoryLinkGeneratedIndexConfig = {
     type: 'generated-index';
     slug?: string;
     title?: string;
@@ -63,7 +63,7 @@ export declare type SidebarItemCategoryLinkGeneratedIndexConfig = {
     image?: string;
     keywords?: string | readonly string[];
 };
-export declare type SidebarItemCategoryLinkGeneratedIndex = {
+export type SidebarItemCategoryLinkGeneratedIndex = {
     type: 'generated-index';
     slug: string;
     permalink: string;
@@ -72,68 +72,70 @@ export declare type SidebarItemCategoryLinkGeneratedIndex = {
     image?: string;
     keywords?: string | readonly string[];
 };
-export declare type SidebarItemCategoryLinkConfig = SidebarItemCategoryLinkDoc | SidebarItemCategoryLinkGeneratedIndexConfig;
-export declare type SidebarItemCategoryLink = SidebarItemCategoryLinkDoc | SidebarItemCategoryLinkGeneratedIndex;
-export declare type SidebarItemCategoryConfig = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
+export type SidebarItemCategoryLinkConfig = SidebarItemCategoryLinkDoc | SidebarItemCategoryLinkGeneratedIndexConfig;
+export type SidebarItemCategoryLink = SidebarItemCategoryLinkDoc | SidebarItemCategoryLinkGeneratedIndex;
+export type SidebarItemCategoryConfig = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
     items: SidebarCategoriesShorthand | SidebarItemConfig[];
     link?: SidebarItemCategoryLinkConfig;
 }>;
-export declare type SidebarCategoriesShorthand = {
+export type SidebarCategoriesShorthand = {
     [sidebarCategory: string]: SidebarCategoriesShorthand | SidebarItemConfig[];
 };
-export declare type SidebarItemConfig = Omit<SidebarItemDoc, 'translatable'> | SidebarItemHtml | SidebarItemLink | SidebarItemAutogenerated | SidebarItemCategoryConfig | string | SidebarCategoriesShorthand;
-export declare type SidebarConfig = SidebarCategoriesShorthand | SidebarItemConfig[];
-export declare type SidebarsConfig = {
+export type SidebarItemConfig = Omit<SidebarItemDoc, 'translatable'> | SidebarItemHtml | SidebarItemLink | SidebarItemAutogenerated | SidebarItemCategoryConfig | string | SidebarCategoriesShorthand;
+export type SidebarConfig = SidebarCategoriesShorthand | SidebarItemConfig[];
+export type SidebarsConfig = {
     [sidebarId: string]: SidebarConfig;
 };
-export declare type NormalizedSidebarItemCategory = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
+export type NormalizedSidebarItemCategory = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
     items: NormalizedSidebarItem[];
     link?: SidebarItemCategoryLinkConfig;
 }>;
-export declare type NormalizedSidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | NormalizedSidebarItemCategory | SidebarItemAutogenerated;
-export declare type NormalizedSidebar = NormalizedSidebarItem[];
-export declare type NormalizedSidebars = {
+export type NormalizedSidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | NormalizedSidebarItemCategory | SidebarItemAutogenerated;
+export type NormalizedSidebar = NormalizedSidebarItem[];
+export type NormalizedSidebars = {
     [sidebarId: string]: NormalizedSidebar;
 };
-export declare type ProcessedSidebarItemCategory = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
+export type ProcessedSidebarItemCategory = Expand<Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
     items: ProcessedSidebarItem[];
     link?: SidebarItemCategoryLinkConfig;
 }>;
-export declare type ProcessedSidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | ProcessedSidebarItemCategory;
-export declare type ProcessedSidebar = ProcessedSidebarItem[];
-export declare type ProcessedSidebars = {
+export type ProcessedSidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | ProcessedSidebarItemCategory;
+export type ProcessedSidebar = ProcessedSidebarItem[];
+export type ProcessedSidebars = {
     [sidebarId: string]: ProcessedSidebar;
 };
-export declare type SidebarItemCategory = Expand<SidebarItemCategoryBase & {
+export type SidebarItemCategory = Expand<SidebarItemCategoryBase & {
     items: SidebarItem[];
     link?: SidebarItemCategoryLink;
 }>;
-export declare type SidebarItemCategoryWithLink = Required<SidebarItemCategory, 'link'>;
-export declare type SidebarItemCategoryWithGeneratedIndex = SidebarItemCategoryWithLink & {
+export type SidebarItemCategoryWithLink = Required<SidebarItemCategory, 'link'>;
+export type SidebarItemCategoryWithGeneratedIndex = SidebarItemCategoryWithLink & {
     link: SidebarItemCategoryLinkGeneratedIndex;
 };
-export declare type SidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | SidebarItemCategory;
-export declare type SidebarNavigationItem = SidebarItemDoc | SidebarItemCategoryWithLink;
-export declare type Sidebar = SidebarItem[];
-export declare type SidebarItemType = SidebarItem['type'];
-export declare type Sidebars = {
+export type SidebarItem = SidebarItemDoc | SidebarItemHtml | SidebarItemLink | SidebarItemCategory;
+export type SidebarNavigationItem = SidebarItemDoc | SidebarItemCategoryWithLink;
+export type Sidebar = SidebarItem[];
+export type SidebarItemType = SidebarItem['type'];
+export type Sidebars = {
     [sidebarId: string]: Sidebar;
 };
-export declare type PropSidebarItemCategory = Expand<SidebarItemCategoryBase & {
+export type PropSidebarItemCategory = Expand<SidebarItemCategoryBase & {
     items: PropSidebarItem[];
     href?: string;
+    linkUnlisted?: boolean;
 }>;
-export declare type PropSidebarItemLink = SidebarItemLink & {
+export type PropSidebarItemLink = SidebarItemLink & {
     docId?: string;
+    unlisted?: boolean;
 };
-export declare type PropSidebarItemHtml = SidebarItemHtml;
-export declare type PropSidebarItem = PropSidebarItemLink | PropSidebarItemCategory | PropSidebarItemHtml;
-export declare type PropSidebar = PropSidebarItem[];
-export declare type PropSidebars = {
+export type PropSidebarItemHtml = SidebarItemHtml;
+export type PropSidebarItem = PropSidebarItemLink | PropSidebarItemCategory | PropSidebarItemHtml;
+export type PropSidebar = PropSidebarItem[];
+export type PropSidebars = {
     [sidebarId: string]: PropSidebar;
 };
-export declare type PropSidebarBreadcrumbsItem = PropSidebarItemLink | PropSidebarItemCategory;
-export declare type CategoryMetadataFile = {
+export type PropSidebarBreadcrumbsItem = PropSidebarItemLink | PropSidebarItemCategory;
+export type CategoryMetadataFile = {
     label?: string;
     position?: number;
     collapsed?: boolean;
@@ -144,9 +146,9 @@ export declare type CategoryMetadataFile = {
         [key: string]: unknown;
     };
 };
-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 = {
+export type SidebarItemsGeneratorDoc = Pick<DocMetadataBase, 'id' | 'unversionedId' | 'title' | 'frontMatter' | 'source' | 'sourceDirName' | 'sidebarPosition'>;
+export type SidebarItemsGeneratorVersion = Pick<VersionMetadata, 'versionName' | 'contentPath'>;
+export type SidebarItemsGeneratorArgs = {
     /** The sidebar item with type "autogenerated" to be transformed. */
     item: SidebarItemAutogenerated;
     /** Useful metadata for the version this sidebar belongs to. */
@@ -165,8 +167,8 @@ export declare type SidebarItemsGeneratorArgs = {
         [filePath: string]: CategoryMetadataFile;
     };
 };
-export declare type SidebarItemsGenerator = (generatorArgs: SidebarItemsGeneratorArgs) => NormalizedSidebar | Promise<NormalizedSidebar>;
-export declare type SidebarItemsGeneratorOption = (generatorArgs: {
+export type SidebarItemsGenerator = (generatorArgs: SidebarItemsGeneratorArgs) => NormalizedSidebar | Promise<NormalizedSidebar>;
+export type SidebarItemsGeneratorOption = (generatorArgs: {
     /**
      * Useful to re-use/enhance the default sidebar generation logic from
      * Docusaurus.
@@ -174,7 +176,7 @@ export declare type SidebarItemsGeneratorOption = (generatorArgs: {
      */
     defaultSidebarItemsGenerator: SidebarItemsGenerator;
 } & SidebarItemsGeneratorArgs) => NormalizedSidebar | Promise<NormalizedSidebar>;
-export declare type SidebarProcessorParams = {
+export type SidebarProcessorParams = {
     sidebarItemsGenerator: SidebarItemsGeneratorOption;
     numberPrefixParser: NumberPrefixParser;
     docs: DocMetadataBase[];

package/lib/sidebars/utils.d.ts

@@ -20,16 +20,21 @@ export declare function collectSidebarsDocIds(sidebars: Sidebars): {
 export declare function collectSidebarsNavigations(sidebars: Sidebars): {
     [sidebarId: string]: SidebarNavigationItem[];
 };
-export declare type SidebarNavigation = {
+export type SidebarNavigation = {
     sidebarName: string | undefined;
     previous: SidebarNavigationItem | undefined;
     next: SidebarNavigationItem | undefined;
 };
-export declare type SidebarsUtils = {
+export type SidebarsUtils = {
     sidebars: Sidebars;
     getFirstDocIdOfFirstSidebar: () => string | undefined;
     getSidebarNameByDocId: (docId: string) => string | undefined;
-    getDocNavigation: (unversionedId: string, versionedId: string, displayedSidebar: string | null | undefined) => SidebarNavigation;
+    getDocNavigation: (params: {
+        unversionedId: string;
+        versionedId: string;
+        displayedSidebar: string | null | undefined;
+        unlistedIds: Set<string>;
+    }) => SidebarNavigation;
     getCategoryGeneratedIndexList: () => SidebarItemCategoryWithGeneratedIndex[];
     getCategoryGeneratedIndexNavigation: (categoryGeneratedIndexPermalink: string) => SidebarNavigation;
     /**

package/lib/sidebars/utils.js

@@ -110,7 +110,7 @@ function createSidebarsUtils(sidebars) {
             next: undefined,
         };
     }
-    function getDocNavigation(unversionedId, versionedId, displayedSidebar) {
+    function getDocNavigation({ unversionedId, versionedId, displayedSidebar, unlistedIds, }) {
         // TODO legacy id retro-compatibility!
         let docId = unversionedId;
         let sidebarName = displayedSidebar === undefined
@@ -123,10 +123,22 @@ function createSidebarsUtils(sidebars) {
         if (!sidebarName) {
             return emptySidebarNavigation();
         }
-        const navigationItems = sidebarNameToNavigationItems[sidebarName];
+        let 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`);
         }
+        // Filter unlisted items from navigation
+        navigationItems = navigationItems.filter((item) => {
+            if (item.type === 'doc' && unlistedIds.has(item.id)) {
+                return false;
+            }
+            if (item.type === 'category' &&
+                item.link.type === 'doc' &&
+                unlistedIds.has(item.link.id)) {
+                return false;
+            }
+            return true;
+        });
         const currentItemIndex = navigationItems.findIndex((item) => {
             if (item.type === 'doc') {
                 return item.id === docId;

package/lib/tags.js

@@ -12,10 +12,17 @@ const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 function getVersionTags(docs) {
     const groups = (0, utils_1.groupTaggedItems)(docs, (doc) => doc.tags);
-    return lodash_1.default.mapValues(groups, (group) => ({
-        label: group.tag.label,
-        docIds: group.items.map((item) => item.id),
-        permalink: group.tag.permalink,
-    }));
+    return lodash_1.default.mapValues(groups, ({ tag, items: tagDocs }) => {
+        const tagVisibility = (0, utils_1.getTagVisibility)({
+            items: tagDocs,
+            isUnlisted: (item) => item.unlisted,
+        });
+        return {
+            label: tag.label,
+            docIds: tagVisibility.listedItems.map((item) => item.id),
+            permalink: tag.permalink,
+            unlisted: tagVisibility.unlisted,
+        };
+    });
 }
 exports.getVersionTags = getVersionTags;

package/lib/types.d.ts

@@ -7,28 +7,29 @@
 import type { BrokenMarkdownLink, Tag } from '@docusaurus/utils';
 import type { VersionMetadata, LoadedVersion, CategoryGeneratedIndexMetadata } from '@docusaurus/plugin-content-docs';
 import type { SidebarsUtils } from './sidebars/utils';
-export declare type DocFile = {
+export type DocFile = {
     contentPath: string;
     filePath: string;
     source: string;
     content: string;
 };
-export declare type SourceToPermalink = {
+export type SourceToPermalink = {
     [source: string]: string;
 };
-export declare type VersionTag = Tag & {
+export type VersionTag = Tag & {
     /** All doc ids having this tag. */
     docIds: string[];
+    unlisted: boolean;
 };
-export declare type VersionTags = {
+export type VersionTags = {
     [permalink: string]: VersionTag;
 };
-export declare type FullVersion = LoadedVersion & {
+export type FullVersion = LoadedVersion & {
     sidebarsUtils: SidebarsUtils;
     categoryGeneratedIndices: CategoryGeneratedIndexMetadata[];
 };
-export declare type DocBrokenMarkdownLink = BrokenMarkdownLink<VersionMetadata>;
-export declare type DocsMarkdownOption = {
+export type DocBrokenMarkdownLink = BrokenMarkdownLink<VersionMetadata>;
+export type DocsMarkdownOption = {
     versionsMetadata: VersionMetadata[];
     siteDir: string;
     sourceToPermalink: SourceToPermalink;

package/lib/versions/index.d.ts

@@ -4,9 +4,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { PluginOptions, VersionBanner, VersionMetadata } from '@docusaurus/plugin-content-docs';
+import type { FullVersion } from '../types';
 import type { LoadContext } from '@docusaurus/types';
-export declare type VersionContext = {
+import type { LoadedVersion, PluginOptions, VersionBanner, VersionMetadata } from '@docusaurus/plugin-content-docs';
+export type VersionContext = {
     /** The version name to get banner of. */
     versionName: string;
     /** All versions, ordered from newest to oldest. */
@@ -35,3 +36,4 @@ export declare function readVersionsMetadata({ context, options, }: {
     context: LoadContext;
     options: PluginOptions;
 }): Promise<VersionMetadata[]>;
+export declare function toFullVersion(version: LoadedVersion): FullVersion;

package/lib/versions/index.js

@@ -6,13 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readVersionsMetadata = exports.filterVersions = exports.getVersionNoIndex = exports.getVersionBadge = exports.getVersionBanner = exports.getDefaultVersionBanner = void 0;
+exports.toFullVersion = exports.readVersionsMetadata = exports.filterVersions = exports.getVersionNoIndex = exports.getVersionBadge = exports.getVersionBanner = exports.getDefaultVersionBanner = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
 const constants_1 = require("../constants");
 const validation_1 = require("./validation");
 const files_1 = require("./files");
+const utils_2 = require("../sidebars/utils");
+const categoryGeneratedIndex_1 = require("../categoryGeneratedIndex");
 function getVersionEditUrls({ contentPath, contentPathLocalized, context, options, }) {
     // If the user is using the functional form of editUrl,
     // she has total freedom and we can't compute a "version edit url"
@@ -157,3 +159,15 @@ async function readVersionsMetadata({ context, options, }) {
     return versionsMetadata;
 }
 exports.readVersionsMetadata = readVersionsMetadata;
+function toFullVersion(version) {
+    const sidebarsUtils = (0, utils_2.createSidebarsUtils)(version.sidebars);
+    return {
+        ...version,
+        sidebarsUtils,
+        categoryGeneratedIndices: (0, categoryGeneratedIndex_1.getCategoryGeneratedIndexMetadataList)({
+            docs: version.docs,
+            sidebarsUtils,
+        }),
+    };
+}
+exports.toFullVersion = toFullVersion;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "2.4.0",
+  "version": "3.0.0-alpha.0",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -35,22 +35,22 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "2.4.0",
-    "@docusaurus/logger": "2.4.0",
-    "@docusaurus/mdx-loader": "2.4.0",
-    "@docusaurus/module-type-aliases": "2.4.0",
-    "@docusaurus/types": "2.4.0",
-    "@docusaurus/utils": "2.4.0",
-    "@docusaurus/utils-validation": "2.4.0",
+    "@docusaurus/core": "3.0.0-alpha.0",
+    "@docusaurus/logger": "3.0.0-alpha.0",
+    "@docusaurus/mdx-loader": "3.0.0-alpha.0",
+    "@docusaurus/module-type-aliases": "3.0.0-alpha.0",
+    "@docusaurus/types": "3.0.0-alpha.0",
+    "@docusaurus/utils": "3.0.0-alpha.0",
+    "@docusaurus/utils-validation": "3.0.0-alpha.0",
     "@types/react-router-config": "^5.0.6",
     "combine-promises": "^1.1.0",
-    "fs-extra": "^10.1.0",
+    "fs-extra": "^11.1.0",
     "import-fresh": "^3.3.0",
     "js-yaml": "^4.1.0",
     "lodash": "^4.17.21",
-    "tslib": "^2.4.0",
+    "tslib": "^2.5.0",
     "utility-types": "^3.10.0",
-    "webpack": "^5.73.0"
+    "webpack": "^5.76.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.5",
@@ -60,11 +60,11 @@
     "shelljs": "^0.8.5"
   },
   "peerDependencies": {
-    "react": "^16.8.4 || ^17.0.0",
-    "react-dom": "^16.8.4 || ^17.0.0"
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
   },
   "engines": {
     "node": ">=16.14"
   },
-  "gitHead": "898b85ef134cc43bf3b1209aad0ca8cdcfb214c5"
+  "gitHead": "7327f7ff880ed97ad7855744e59c9c55d467a950"
 }

package/src/client/index.ts

@@ -37,7 +37,8 @@ export type GlobalDoc = {
    */
   id: string;
   path: string;
-  sidebar: string | undefined;
+  sidebar?: string;
+  unlisted?: boolean;
 };
 
 export type GlobalVersion = {