@docusaurus/plugin-content-docs 0.0.0-5980 → 0.0.0-5983

package/lib/categoryGeneratedIndex.d.ts

@@ -4,7 +4,6 @@
  * 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/categoryGeneratedIndex.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCategoryGeneratedIndexMetadataList = void 0;
+exports.getCategoryGeneratedIndexMetadataList = getCategoryGeneratedIndexMetadataList;
 const utils_1 = require("./sidebars/utils");
 const docs_1 = require("./docs");
 function getCategoryGeneratedIndexMetadata({ category, sidebarsUtils, docsById, }) {
@@ -34,4 +34,3 @@ function getCategoryGeneratedIndexMetadataList({ docs, sidebarsUtils, }) {
         docsById,
     }));
 }
-exports.getCategoryGeneratedIndexMetadataList = getCategoryGeneratedIndexMetadataList;

package/lib/cli.d.ts

@@ -4,7 +4,6 @@
  * 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/cli.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cliDocsVersionCommand = void 0;
+exports.cliDocsVersionCommand = cliDocsVersionCommand;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -89,4 +89,3 @@ async function cliDocsVersionCommand(version, { id: pluginId, path: docsPath, si
     await fs_extra_1.default.outputFile((0, files_1.getVersionsFilePath)(siteDir, pluginId), `${JSON.stringify(versions, null, 2)}\n`);
     logger_1.default.success `name=${pluginIdLogPrefix}: version name=${version} created!`;
 }
-exports.cliDocsVersionCommand = cliDocsVersionCommand;

package/lib/docs.d.ts

@@ -4,7 +4,6 @@
  * 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 { TagsFile } from '@docusaurus/utils';
 import type { MetadataOptions, PluginOptions, CategoryIndexMatcher, DocMetadataBase, VersionMetadata, LoadedVersion } from '@docusaurus/plugin-content-docs';
 import type { LoadContext } from '@docusaurus/types';

package/lib/docs.js

@@ -6,7 +6,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDocsByIdIndex = exports.toCategoryIndexMatcherParam = exports.isCategoryIndex = exports.getMainDocId = exports.addDocNavigation = exports.processDocMetadata = exports.readVersionDocs = exports.readDocFile = void 0;
+exports.isCategoryIndex = void 0;
+exports.readDocFile = readDocFile;
+exports.readVersionDocs = readVersionDocs;
+exports.processDocMetadata = processDocMetadata;
+exports.addDocNavigation = addDocNavigation;
+exports.getMainDocId = getMainDocId;
+exports.toCategoryIndexMatcherParam = toCategoryIndexMatcherParam;
+exports.createDocsByIdIndex = createDocsByIdIndex;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -22,7 +29,6 @@ async function readDocFile(versionMetadata, source) {
     const content = await fs_extra_1.default.readFile(filePath, 'utf-8');
     return { source, content, contentPath, filePath };
 }
-exports.readDocFile = readDocFile;
 async function readVersionDocs(versionMetadata, options) {
     const sources = await (0, utils_1.Globby)(options.include, {
         cwd: versionMetadata.contentPath,
@@ -30,7 +36,6 @@ async function readVersionDocs(versionMetadata, options) {
     });
     return Promise.all(sources.map((source) => readDocFile(versionMetadata, source)));
 }
-exports.readVersionDocs = readVersionDocs;
 async function doProcessDocMetadata({ docFile, versionMetadata, context, options, env, tagsFile, }) {
     const { source, content, contentPath, filePath } = docFile;
     const { siteDir, siteConfig: { markdown: { parseFrontMatter }, }, } = context;
@@ -146,7 +151,6 @@ async function processDocMetadata(args) {
         throw new Error(`Can't process doc metadata for doc at path path=${args.docFile.filePath} in version name=${args.versionMetadata.versionName}`, { cause: err });
     }
 }
-exports.processDocMetadata = processDocMetadata;
 function getUnlistedIds(docs) {
     return new Set(docs.filter((doc) => doc.unlisted).map((doc) => doc.id));
 }
@@ -188,7 +192,6 @@ function addDocNavigation({ docs, sidebarsUtils, }) {
     docsWithNavigation.sort((a, b) => a.id.localeCompare(b.id));
     return docsWithNavigation;
 }
-exports.addDocNavigation = addDocNavigation;
 /**
  * The "main doc" is the "version entry point"
  * We browse this doc by clicking on a version:
@@ -210,7 +213,6 @@ function getMainDocId({ docs, sidebarsUtils, }) {
     }
     return getMainDoc().id;
 }
-exports.getMainDocId = getMainDocId;
 // By convention, Docusaurus considers some docs are "indexes":
 // - index.md
 // - readme.md
@@ -242,9 +244,7 @@ function toCategoryIndexMatcherParam({ source, sourceDirName, }) {
         directories: sourceDirName.split(path_1.default.posix.sep).reverse(),
     };
 }
-exports.toCategoryIndexMatcherParam = toCategoryIndexMatcherParam;
 // Docs are indexed by their id
 function createDocsByIdIndex(docs) {
     return lodash_1.default.keyBy(docs, (d) => d.id);
 }
-exports.createDocsByIdIndex = createDocsByIdIndex;

package/lib/frontMatter.d.ts

@@ -1,4 +1,3 @@
-/// <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/frontMatter.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateDocFrontMatter = exports.DocFrontMatterSchema = void 0;
+exports.DocFrontMatterSchema = void 0;
+exports.validateDocFrontMatter = validateDocFrontMatter;
 /**
  * Copyright (c) Facebook, Inc. and its affiliates.
  *
@@ -42,4 +43,3 @@ exports.DocFrontMatterSchema = utils_validation_1.JoiFrontMatter.object({
 function validateDocFrontMatter(frontMatter) {
     return (0, utils_validation_1.validateFrontMatter)(frontMatter, exports.DocFrontMatterSchema);
 }
-exports.validateDocFrontMatter = validateDocFrontMatter;

package/lib/globalData.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toGlobalDataVersion = void 0;
+exports.toGlobalDataVersion = toGlobalDataVersion;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const docs_1 = require("./docs");
@@ -57,4 +57,3 @@ function toGlobalDataVersion(version) {
         sidebars: toGlobalSidebars(version.sidebars, version),
     };
 }
-exports.toGlobalDataVersion = toGlobalDataVersion;

package/lib/index.d.ts

@@ -4,7 +4,6 @@
  * 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

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateOptions = void 0;
+exports.default = pluginContentDocs;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
@@ -190,7 +191,7 @@ async function pluginContentDocs(context, options) {
             });
         },
         configureWebpack(_config, isServer, utils, content) {
-            const { rehypePlugins, remarkPlugins, beforeDefaultRehypePlugins, beforeDefaultRemarkPlugins, } = options;
+            const { rehypePlugins, remarkPlugins, recmaPlugins, beforeDefaultRehypePlugins, beforeDefaultRemarkPlugins, } = options;
             const contentDirs = versionsMetadata
                 .flatMap(utils_1.getContentPathList)
                 // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
@@ -200,6 +201,7 @@ async function pluginContentDocs(context, options) {
                     admonitions: options.admonitions,
                     remarkPlugins,
                     rehypePlugins,
+                    recmaPlugins,
                     beforeDefaultRehypePlugins,
                     beforeDefaultRemarkPlugins,
                     staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
@@ -260,6 +262,5 @@ async function pluginContentDocs(context, options) {
         },
     };
 }
-exports.default = pluginContentDocs;
 var options_1 = require("./options");
 Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/numberPrefix.d.ts

@@ -4,7 +4,6 @@
  * 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/numberPrefix.js

@@ -6,7 +6,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stripPathNumberPrefixes = exports.stripNumberPrefix = exports.DisabledNumberPrefixParser = exports.DefaultNumberPrefixParser = void 0;
+exports.DisabledNumberPrefixParser = exports.DefaultNumberPrefixParser = void 0;
+exports.stripNumberPrefix = stripNumberPrefix;
+exports.stripPathNumberPrefixes = stripPathNumberPrefixes;
 // Best-effort to avoid parsing some patterns as number prefix
 // ignore common date-like patterns: https://github.com/facebook/docusaurus/issues/4640
 // ignore common versioning patterns: https://github.com/facebook/docusaurus/issues/4653
@@ -39,7 +41,6 @@ exports.DisabledNumberPrefixParser = DisabledNumberPrefixParser;
 function stripNumberPrefix(str, parser) {
     return parser(str).filename;
 }
-exports.stripNumberPrefix = stripNumberPrefix;
 // 0-myFolder/0-mySubfolder/0-myDoc => myFolder/mySubfolder/myDoc
 function stripPathNumberPrefixes(path, parser) {
     return path
@@ -47,4 +48,3 @@ function stripPathNumberPrefixes(path, parser) {
         .map((segment) => stripNumberPrefix(segment, parser))
         .join('/');
 }
-exports.stripPathNumberPrefixes = stripPathNumberPrefixes;

package/lib/options.d.ts

@@ -4,7 +4,6 @@
  * 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

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateOptions = exports.DEFAULT_OPTIONS = void 0;
+exports.DEFAULT_OPTIONS = void 0;
+exports.validateOptions = validateOptions;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_validation_1 = require("@docusaurus/utils-validation");
@@ -30,6 +31,7 @@ exports.DEFAULT_OPTIONS = {
     docCategoryGeneratedIndexComponent: '@theme/DocCategoryGeneratedIndexPage',
     remarkPlugins: [],
     rehypePlugins: [],
+    recmaPlugins: [],
     beforeDefaultRemarkPlugins: [],
     beforeDefaultRehypePlugins: [],
     showLastUpdateTime: false,
@@ -91,6 +93,7 @@ const OptionsSchema = utils_validation_1.Joi.object({
     docCategoryGeneratedIndexComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.docCategoryGeneratedIndexComponent),
     remarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.remarkPlugins),
     rehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.rehypePlugins),
+    recmaPlugins: utils_validation_1.RecmaPluginsSchema.default(exports.DEFAULT_OPTIONS.recmaPlugins),
     beforeDefaultRemarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRemarkPlugins),
     beforeDefaultRehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRehypePlugins),
     admonitions: utils_validation_1.AdmonitionsSchema.default(exports.DEFAULT_OPTIONS.admonitions),
@@ -133,4 +136,3 @@ function validateOptions({ validate, options: userOptions, }) {
     const normalizedOptions = validate(OptionsSchema, options);
     return normalizedOptions;
 }
-exports.validateOptions = validateOptions;

package/lib/props.d.ts

@@ -4,7 +4,6 @@
  * 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/props.js

@@ -6,7 +6,11 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toTagsListTagsProp = exports.toTagDocListProp = exports.toVersionMetadataProp = exports.toSidebarsProp = exports.toSidebarDocItemLinkProp = void 0;
+exports.toSidebarDocItemLinkProp = toSidebarDocItemLinkProp;
+exports.toSidebarsProp = toSidebarsProp;
+exports.toVersionMetadataProp = toVersionMetadataProp;
+exports.toTagDocListProp = toTagDocListProp;
+exports.toTagsListTagsProp = toTagsListTagsProp;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const docs_1 = require("./docs");
@@ -22,7 +26,6 @@ function toSidebarDocItemLinkProp({ item, doc, }) {
         unlisted,
     };
 }
-exports.toSidebarDocItemLinkProp = toSidebarDocItemLinkProp;
 function toSidebarsProp(loadedVersion) {
     const docsById = (0, docs_1.createDocsByIdIndex)(loadedVersion.docs);
     function getDocById(docId) {
@@ -92,7 +95,6 @@ Available document ids are:
     // This is what will be passed as props to the UI component.
     return lodash_1.default.mapValues(loadedVersion.sidebars, (items) => items.map(normalizeItem));
 }
-exports.toSidebarsProp = toSidebarsProp;
 function toVersionDocsProp(loadedVersion) {
     return Object.fromEntries(loadedVersion.docs.map((doc) => [
         doc.id,
@@ -118,7 +120,6 @@ function toVersionMetadataProp(pluginId, loadedVersion) {
         docs: toVersionDocsProp(loadedVersion),
     };
 }
-exports.toVersionMetadataProp = toVersionMetadataProp;
 function toTagDocListProp({ allTagsPath, tag, docs, }) {
     function toDocListProp() {
         const list = lodash_1.default.compact(tag.docIds.map((id) => docs.find((doc) => doc.id === id)));
@@ -141,7 +142,6 @@ function toTagDocListProp({ allTagsPath, tag, docs, }) {
         unlisted: tag.unlisted,
     };
 }
-exports.toTagDocListProp = toTagDocListProp;
 function toTagsListTagsProp(versionTags) {
     return Object.values(versionTags)
         .filter((tagValue) => !tagValue.unlisted)
@@ -152,4 +152,3 @@ function toTagsListTagsProp(versionTags) {
         count: tagValue.docIds.length,
     }));
 }
-exports.toTagsListTagsProp = toTagsListTagsProp;

package/lib/routes.d.ts

@@ -4,7 +4,6 @@
  * 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

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAllRoutes = exports.buildAllRoutes = void 0;
+exports.buildAllRoutes = buildAllRoutes;
+exports.createAllRoutes = createAllRoutes;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
@@ -177,9 +178,7 @@ async function buildAllRoutes(param) {
         },
     ];
 }
-exports.buildAllRoutes = buildAllRoutes;
 async function createAllRoutes(param) {
     const routes = await buildAllRoutes(param);
     routes.forEach(param.actions.addRoute);
 }
-exports.createAllRoutes = createAllRoutes;

package/lib/sidebars/index.d.ts

@@ -4,7 +4,6 @@
  * 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/index.js

@@ -6,7 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSidebars = exports.loadSidebarsFile = exports.resolveSidebarPathOption = exports.DisabledSidebars = exports.DefaultSidebars = void 0;
+exports.DisabledSidebars = exports.DefaultSidebars = void 0;
+exports.resolveSidebarPathOption = resolveSidebarPathOption;
+exports.loadSidebarsFile = loadSidebarsFile;
+exports.loadSidebars = loadSidebars;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -34,7 +37,6 @@ function resolveSidebarPathOption(siteDir, sidebarPathOption) {
         ? path_1.default.resolve(siteDir, sidebarPathOption)
         : sidebarPathOption;
 }
-exports.resolveSidebarPathOption = resolveSidebarPathOption;
 async function readCategoriesMetadata(contentPath) {
     const categoryFiles = await (0, utils_1.Globby)('**/_category_.{json,yml,yaml}', {
         cwd: contentPath,
@@ -80,7 +82,6 @@ async function loadSidebarsFile(sidebarFilePath) {
     // TODO unsafe, need to refactor and improve validation
     return sidebars;
 }
-exports.loadSidebarsFile = loadSidebarsFile;
 async function loadSidebars(sidebarFilePath, options) {
     try {
         const sidebarsConfig = await loadSidebarsFileUnsafe(sidebarFilePath);
@@ -95,4 +96,3 @@ async function loadSidebars(sidebarFilePath, options) {
         throw err;
     }
 }
-exports.loadSidebars = loadSidebars;

package/lib/sidebars/normalization.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeSidebars = exports.normalizeItem = void 0;
+exports.normalizeItem = normalizeItem;
+exports.normalizeSidebars = normalizeSidebars;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
@@ -43,7 +44,6 @@ function normalizeItem(item) {
     }
     return [item];
 }
-exports.normalizeItem = normalizeItem;
 function normalizeSidebar(sidebar, place) {
     if (!Array.isArray(sidebar) && !(0, utils_1.isCategoriesShorthand)(sidebar)) {
         throw new Error(logger_1.default.interpolate `Invalid sidebar items collection code=${JSON.stringify(sidebar)} in ${place}: it must either be an array of sidebar items or a shorthand notation (which doesn't contain a code=${'type'} property). See url=${'https://docusaurus.io/docs/sidebar/items'} for all valid syntaxes.`);
@@ -56,4 +56,3 @@ function normalizeSidebar(sidebar, place) {
 function normalizeSidebars(sidebars) {
     return lodash_1.default.mapValues(sidebars, (sidebar, id) => normalizeSidebar(sidebar, logger_1.default.interpolate `sidebar name=${id}`));
 }
-exports.normalizeSidebars = normalizeSidebars;

package/lib/sidebars/postProcessor.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.postProcessSidebars = void 0;
+exports.postProcessSidebars = postProcessSidebars;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
@@ -77,4 +77,3 @@ function postProcessSidebars(sidebars, params) {
         .map((item) => postProcessSidebarItem(item, { ...params, draftIds }))
         .filter((v) => Boolean(v)));
 }
-exports.postProcessSidebars = postProcessSidebars;

package/lib/sidebars/processor.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.processSidebars = void 0;
+exports.processSidebars = processSidebars;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const combine_promises_1 = tslib_1.__importDefault(require("combine-promises"));
@@ -75,4 +75,3 @@ async function processSidebars(unprocessedSidebars, categoriesMetadata, params)
     (0, validation_1.validateSidebars)(processedSidebars);
     return processedSidebars;
 }
-exports.processSidebars = processSidebars;

package/lib/sidebars/types.d.ts

@@ -4,7 +4,6 @@
  * 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,7 +4,6 @@
  * 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;

package/lib/sidebars/utils.js

@@ -6,14 +6,25 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toNavigationLink = exports.toDocNavigationLink = exports.createSidebarsUtils = exports.collectSidebarsNavigations = exports.collectSidebarsDocIds = exports.collectSidebarNavigation = exports.collectSidebarDocIds = exports.collectSidebarRefs = exports.collectSidebarLinks = exports.collectSidebarCategories = exports.collectSidebarDocItems = exports.transformSidebarItems = exports.isCategoriesShorthand = void 0;
+exports.isCategoriesShorthand = isCategoriesShorthand;
+exports.transformSidebarItems = transformSidebarItems;
+exports.collectSidebarDocItems = collectSidebarDocItems;
+exports.collectSidebarCategories = collectSidebarCategories;
+exports.collectSidebarLinks = collectSidebarLinks;
+exports.collectSidebarRefs = collectSidebarRefs;
+exports.collectSidebarDocIds = collectSidebarDocIds;
+exports.collectSidebarNavigation = collectSidebarNavigation;
+exports.collectSidebarsDocIds = collectSidebarsDocIds;
+exports.collectSidebarsNavigations = collectSidebarsNavigations;
+exports.createSidebarsUtils = createSidebarsUtils;
+exports.toDocNavigationLink = toDocNavigationLink;
+exports.toNavigationLink = toNavigationLink;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 function isCategoriesShorthand(item) {
     return typeof item === 'object' && !item.type;
 }
-exports.isCategoriesShorthand = isCategoriesShorthand;
 function transformSidebarItems(sidebar, updateFn) {
     function transformRecursive(item) {
         if (item.type === 'category') {
@@ -26,7 +37,6 @@ function transformSidebarItems(sidebar, updateFn) {
     }
     return sidebar.map(transformRecursive);
 }
-exports.transformSidebarItems = transformSidebarItems;
 /**
  * Flatten sidebar items into a single flat array (containing categories/docs on
  * the same level). Order matters (useful for next/prev nav), top categories
@@ -46,19 +56,15 @@ function collectSidebarItemsOfType(type, sidebar) {
 function collectSidebarDocItems(sidebar) {
     return collectSidebarItemsOfType('doc', sidebar);
 }
-exports.collectSidebarDocItems = collectSidebarDocItems;
 function collectSidebarCategories(sidebar) {
     return collectSidebarItemsOfType('category', sidebar);
 }
-exports.collectSidebarCategories = collectSidebarCategories;
 function collectSidebarLinks(sidebar) {
     return collectSidebarItemsOfType('link', sidebar);
 }
-exports.collectSidebarLinks = collectSidebarLinks;
 function collectSidebarRefs(sidebar) {
     return collectSidebarItemsOfType('ref', sidebar);
 }
-exports.collectSidebarRefs = collectSidebarRefs;
 // /!\ docId order matters for navigation!
 function collectSidebarDocIds(sidebar) {
     return flattenSidebarItems(sidebar).flatMap((item) => {
@@ -71,7 +77,6 @@ function collectSidebarDocIds(sidebar) {
         return [];
     });
 }
-exports.collectSidebarDocIds = collectSidebarDocIds;
 function collectSidebarNavigation(sidebar) {
     return flattenSidebarItems(sidebar).flatMap((item) => {
         if (item.type === 'category' && item.link) {
@@ -83,15 +88,12 @@ function collectSidebarNavigation(sidebar) {
         return [];
     });
 }
-exports.collectSidebarNavigation = collectSidebarNavigation;
 function collectSidebarsDocIds(sidebars) {
     return lodash_1.default.mapValues(sidebars, collectSidebarDocIds);
 }
-exports.collectSidebarsDocIds = collectSidebarsDocIds;
 function collectSidebarsNavigations(sidebars) {
     return lodash_1.default.mapValues(sidebars, collectSidebarNavigation);
 }
-exports.collectSidebarsNavigations = collectSidebarsNavigations;
 function createSidebarsUtils(sidebars) {
     const sidebarNameToDocIds = collectSidebarsDocIds(sidebars);
     const sidebarNameToNavigationItems = collectSidebarsNavigations(sidebars);
@@ -293,7 +295,6 @@ Available document ids are:
         getFirstLink: (id) => getFirstLink(sidebars[id]),
     };
 }
-exports.createSidebarsUtils = createSidebarsUtils;
 function toDocNavigationLink(doc, options) {
     const { title, permalink, frontMatter: { pagination_label: paginationLabel, sidebar_label: sidebarLabel, }, } = doc;
     return {
@@ -301,7 +302,6 @@ function toDocNavigationLink(doc, options) {
         permalink,
     };
 }
-exports.toDocNavigationLink = toDocNavigationLink;
 function toNavigationLink(navigationItem, docsById) {
     function getDocById(docId) {
         const doc = docsById[docId];
@@ -325,4 +325,3 @@ function toNavigationLink(navigationItem, docsById) {
         sidebarItemLabel: navigationItem?.label,
     });
 }
-exports.toNavigationLink = toNavigationLink;

package/lib/sidebars/validation.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateCategoryMetadataFile = exports.validateSidebars = void 0;
+exports.validateSidebars = validateSidebars;
+exports.validateCategoryMetadataFile = validateCategoryMetadataFile;
 const utils_validation_1 = require("@docusaurus/utils-validation");
 // NOTE: we don't add any default values during validation on purpose!
 // Config types are exposed to users for typechecking and we use the same type
@@ -130,7 +131,6 @@ function validateSidebars(sidebars) {
         sidebar.forEach(validateSidebarItem);
     });
 }
-exports.validateSidebars = validateSidebars;
 const categoryMetadataFileSchema = utils_validation_1.Joi.object({
     label: utils_validation_1.Joi.string(),
     position: utils_validation_1.Joi.number(),
@@ -147,4 +147,3 @@ function validateCategoryMetadataFile(unsafeContent) {
     }
     return value;
 }
-exports.validateCategoryMetadataFile = validateCategoryMetadataFile;

package/lib/slug.d.ts

@@ -4,7 +4,6 @@
  * 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/slug.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getSlug;
 const utils_1 = require("@docusaurus/utils");
 const utils_common_1 = require("@docusaurus/utils-common");
 const numberPrefix_1 = require("./numberPrefix");
@@ -48,4 +49,3 @@ slug: /my/customDocPath
     }
     return ensureValidSlug(computeSlug());
 }
-exports.default = getSlug;

package/lib/translations.d.ts

@@ -4,7 +4,6 @@
  * 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/translations.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.translateLoadedContent = exports.getLoadedContentTranslationFiles = void 0;
+exports.getLoadedContentTranslationFiles = getLoadedContentTranslationFiles;
+exports.translateLoadedContent = translateLoadedContent;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
@@ -158,11 +159,9 @@ function translateVersions(versions, translationFiles) {
 function getLoadedContentTranslationFiles(loadedContent) {
     return getVersionsTranslationFiles(loadedContent.loadedVersions);
 }
-exports.getLoadedContentTranslationFiles = getLoadedContentTranslationFiles;
 function translateLoadedContent(loadedContent, translationFiles) {
     const translationFilesMap = lodash_1.default.keyBy(translationFiles, (f) => f.path);
     return {
         loadedVersions: translateVersions(loadedContent.loadedVersions, translationFilesMap),
     };
 }
-exports.translateLoadedContent = translateLoadedContent;

package/lib/types.d.ts

@@ -4,7 +4,6 @@
  * 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 { TagMetadata } from '@docusaurus/utils';
 import type { LoadedVersion, CategoryGeneratedIndexMetadata } from '@docusaurus/plugin-content-docs';
 import type { SidebarsUtils } from './sidebars/utils';

package/lib/versions/files.d.ts

@@ -4,7 +4,6 @@
  * 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/files.js

@@ -6,7 +6,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVersionMetadataPaths = exports.readVersionNames = exports.readVersionsFile = exports.getVersionsFilePath = exports.getDocsDirPathLocalized = exports.getVersionSidebarsPath = exports.getVersionDocsDirPath = void 0;
+exports.getVersionDocsDirPath = getVersionDocsDirPath;
+exports.getVersionSidebarsPath = getVersionSidebarsPath;
+exports.getDocsDirPathLocalized = getDocsDirPathLocalized;
+exports.getVersionsFilePath = getVersionsFilePath;
+exports.readVersionsFile = readVersionsFile;
+exports.readVersionNames = readVersionNames;
+exports.getVersionMetadataPaths = getVersionMetadataPaths;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -23,12 +29,10 @@ function addPluginIdPrefix(fileOrDir, pluginId) {
 function getVersionDocsDirPath(siteDir, pluginId, versionName) {
     return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONED_DOCS_DIR, pluginId), `version-${versionName}`);
 }
-exports.getVersionDocsDirPath = getVersionDocsDirPath;
 /** `[siteDir]/community_versioned_sidebars/version-1.0.0-sidebars.json` */
 function getVersionSidebarsPath(siteDir, pluginId, versionName) {
     return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONED_SIDEBARS_DIR, pluginId), `version-${versionName}-sidebars.json`);
 }
-exports.getVersionSidebarsPath = getVersionSidebarsPath;
 function getDocsDirPathLocalized({ localizationDir, pluginId, versionName, }) {
     return (0, utils_1.getPluginI18nPath)({
         localizationDir,
@@ -41,12 +45,10 @@ function getDocsDirPathLocalized({ localizationDir, pluginId, versionName, }) {
         ],
     });
 }
-exports.getDocsDirPathLocalized = getDocsDirPathLocalized;
 /** `community` => `[siteDir]/community_versions.json` */
 function getVersionsFilePath(siteDir, pluginId) {
     return path_1.default.join(siteDir, addPluginIdPrefix(constants_1.VERSIONS_JSON_FILE, pluginId));
 }
-exports.getVersionsFilePath = getVersionsFilePath;
 /**
  * Reads the plugin's respective `versions.json` file, and returns its content.
  *
@@ -62,7 +64,6 @@ async function readVersionsFile(siteDir, pluginId) {
     }
     return null;
 }
-exports.readVersionsFile = readVersionsFile;
 /**
  * Reads the `versions.json` file, and returns an ordered list of version names.
  *
@@ -98,7 +99,6 @@ async function readVersionNames(siteDir, options) {
     }
     return versions;
 }
-exports.readVersionNames = readVersionNames;
 /**
  * Gets the path-related version metadata.
  *
@@ -138,4 +138,3 @@ Please set the docs "sidebarPath" field in your config file to:
     }
     return { contentPath, contentPathLocalized, sidebarFilePath };
 }
-exports.getVersionMetadataPaths = getVersionMetadataPaths;

package/lib/versions/index.d.ts

@@ -4,7 +4,6 @@
  * 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/index.js

@@ -6,7 +6,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVersionFromSourceFilePath = exports.toFullVersion = exports.readVersionsMetadata = exports.filterVersions = exports.getVersionNoIndex = exports.getVersionBadge = exports.getVersionBanner = exports.getDefaultVersionBanner = void 0;
+exports.getDefaultVersionBanner = getDefaultVersionBanner;
+exports.getVersionBanner = getVersionBanner;
+exports.getVersionBadge = getVersionBadge;
+exports.getVersionNoIndex = getVersionNoIndex;
+exports.filterVersions = filterVersions;
+exports.readVersionsMetadata = readVersionsMetadata;
+exports.toFullVersion = toFullVersion;
+exports.getVersionFromSourceFilePath = getVersionFromSourceFilePath;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
@@ -55,7 +62,6 @@ function getDefaultVersionBanner({ versionName, versionNames, lastVersionName, }
     // Older versions: display unmaintained banner
     return 'unmaintained';
 }
-exports.getDefaultVersionBanner = getDefaultVersionBanner;
 function getVersionBanner(context) {
     const { versionName, options } = context;
     const versionBannerOption = options.versions[versionName]?.banner;
@@ -64,7 +70,6 @@ function getVersionBanner(context) {
     }
     return getDefaultVersionBanner(context);
 }
-exports.getVersionBanner = getVersionBanner;
 function getVersionBadge({ versionName, versionNames, options, }) {
     // If site is not versioned or only one version is included
     // we don't show the version badge by default
@@ -72,11 +77,9 @@ function getVersionBadge({ versionName, versionNames, options, }) {
     const defaultVersionBadge = versionNames.length !== 1;
     return options.versions[versionName]?.badge ?? defaultVersionBadge;
 }
-exports.getVersionBadge = getVersionBadge;
 function getVersionNoIndex({ versionName, options, }) {
     return options.versions[versionName]?.noIndex ?? false;
 }
-exports.getVersionNoIndex = getVersionNoIndex;
 function getVersionClassName({ versionName, options, }) {
     const defaultVersionClassName = `docs-version-${versionName}`;
     return options.versions[versionName]?.className ?? defaultVersionClassName;
@@ -138,7 +141,6 @@ function filterVersions(versionNamesUnfiltered, options) {
     }
     return versionNamesUnfiltered;
 }
-exports.filterVersions = filterVersions;
 function getLastVersionName({ versionNames, options, }) {
     return (options.lastVersion ??
         versionNames.find((name) => name !== constants_1.CURRENT_VERSION_NAME) ??
@@ -158,7 +160,6 @@ async function readVersionsMetadata({ context, options, }) {
     })));
     return versionsMetadata;
 }
-exports.readVersionsMetadata = readVersionsMetadata;
 function toFullVersion(version) {
     const sidebarsUtils = (0, utils_2.createSidebarsUtils)(version.sidebars);
     return {
@@ -170,7 +171,6 @@ function toFullVersion(version) {
         }),
     };
 }
-exports.toFullVersion = toFullVersion;
 function getVersionFromSourceFilePath(filePath, versionsMetadata) {
     const versionFound = versionsMetadata.find((version) => (0, utils_1.getContentPathList)(version).some((docsDirPath) => filePath.startsWith(docsDirPath)));
     if (!versionFound) {
@@ -178,4 +178,3 @@ function getVersionFromSourceFilePath(filePath, versionsMetadata) {
     }
     return versionFound;
 }
-exports.getVersionFromSourceFilePath = getVersionFromSourceFilePath;

package/lib/versions/validation.d.ts

@@ -4,7 +4,6 @@
  * 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/lib/versions/validation.js

@@ -6,7 +6,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateVersionsOptions = exports.validateVersionNames = exports.validateVersionName = void 0;
+exports.validateVersionName = validateVersionName;
+exports.validateVersionNames = validateVersionNames;
+exports.validateVersionsOptions = validateVersionsOptions;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 function validateVersionName(name) {
@@ -29,14 +31,12 @@ function validateVersionName(name) {
         }
     });
 }
-exports.validateVersionName = validateVersionName;
 function validateVersionNames(names) {
     if (!Array.isArray(names)) {
         throw new Error(`The versions file should contain an array of version names! Found content: ${JSON.stringify(names)}`);
     }
     names.forEach(validateVersionName);
 }
-exports.validateVersionNames = validateVersionNames;
 /**
  * @throws Throws for one of the following invalid options:
  * - `lastVersion` is non-existent
@@ -68,4 +68,3 @@ function validateVersionsOptions(availableVersionNames, options) {
         }
     }
 }
-exports.validateVersionsOptions = validateVersionsOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-docs",
-  "version": "0.0.0-5980",
+  "version": "0.0.0-5983",
   "description": "Docs plugin for Docusaurus.",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -35,14 +35,14 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "0.0.0-5980",
-    "@docusaurus/logger": "0.0.0-5980",
-    "@docusaurus/mdx-loader": "0.0.0-5980",
-    "@docusaurus/module-type-aliases": "0.0.0-5980",
-    "@docusaurus/types": "0.0.0-5980",
-    "@docusaurus/utils": "0.0.0-5980",
-    "@docusaurus/utils-common": "0.0.0-5980",
-    "@docusaurus/utils-validation": "0.0.0-5980",
+    "@docusaurus/core": "0.0.0-5983",
+    "@docusaurus/logger": "0.0.0-5983",
+    "@docusaurus/mdx-loader": "0.0.0-5983",
+    "@docusaurus/module-type-aliases": "0.0.0-5983",
+    "@docusaurus/types": "0.0.0-5983",
+    "@docusaurus/utils": "0.0.0-5983",
+    "@docusaurus/utils-common": "0.0.0-5983",
+    "@docusaurus/utils-validation": "0.0.0-5983",
     "@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": "4e1df4e2a6167a6c8dfe3f0a1912b69cad0d6d5f"
+  "gitHead": "303ced3b8c9e4b7674a42ebbbe73d24debeb211a"
 }

package/src/index.ts

@@ -293,6 +293,7 @@ export default async function pluginContentDocs(
       const {
         rehypePlugins,
         remarkPlugins,
+        recmaPlugins,
         beforeDefaultRehypePlugins,
         beforeDefaultRemarkPlugins,
       } = options;
@@ -307,6 +308,7 @@ export default async function pluginContentDocs(
           admonitions: options.admonitions,
           remarkPlugins,
           rehypePlugins,
+          recmaPlugins,
           beforeDefaultRehypePlugins,
           beforeDefaultRemarkPlugins,
           staticDirs: siteConfig.staticDirectories.map((dir) =>

package/src/options.ts

@@ -10,6 +10,7 @@ import {
   Joi,
   RemarkPluginsSchema,
   RehypePluginsSchema,
+  RecmaPluginsSchema,
   AdmonitionsSchema,
   RouteBasePathSchema,
   URISchema,
@@ -40,6 +41,7 @@ export const DEFAULT_OPTIONS: Omit<PluginOptions, 'id' | 'sidebarPath'> = {
   docCategoryGeneratedIndexComponent: '@theme/DocCategoryGeneratedIndexPage',
   remarkPlugins: [],
   rehypePlugins: [],
+  recmaPlugins: [],
   beforeDefaultRemarkPlugins: [],
   beforeDefaultRehypePlugins: [],
   showLastUpdateTime: false,
@@ -123,6 +125,7 @@ const OptionsSchema = Joi.object<PluginOptions>({
   ),
   remarkPlugins: RemarkPluginsSchema.default(DEFAULT_OPTIONS.remarkPlugins),
   rehypePlugins: RehypePluginsSchema.default(DEFAULT_OPTIONS.rehypePlugins),
+  recmaPlugins: RecmaPluginsSchema.default(DEFAULT_OPTIONS.recmaPlugins),
   beforeDefaultRemarkPlugins: RemarkPluginsSchema.default(
     DEFAULT_OPTIONS.beforeDefaultRemarkPlugins,
   ),