@docusaurus/core 0.0.0-4798 → 0.0.0-4799

package/lib/server/index.js

@@ -6,29 +6,24 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.load = exports.loadPluginConfigs = exports.loadContext = exports.loadSiteConfig = void 0;
+exports.load = exports.loadContext = exports.loadSiteConfig = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const ssr_html_template_1 = tslib_1.__importDefault(require("../webpack/templates/ssr.html.template"));
-const client_modules_1 = tslib_1.__importDefault(require("./client-modules"));
-const config_1 = tslib_1.__importDefault(require("./config"));
+const clientModules_1 = require("./clientModules");
+const config_1 = require("./config");
 const plugins_1 = require("./plugins");
-const presets_1 = tslib_1.__importDefault(require("./presets"));
-const routes_1 = tslib_1.__importDefault(require("./routes"));
-const html_tags_1 = require("./html-tags");
-const versions_1 = require("./versions");
+const routes_1 = require("./routes");
+const htmlTags_1 = require("./htmlTags");
+const siteMetadata_1 = require("./siteMetadata");
 const duplicateRoutes_1 = require("./duplicateRoutes");
 const i18n_1 = require("./i18n");
 const translations_1 = require("./translations/translations");
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const remark_admonitions_1 = tslib_1.__importDefault(require("remark-admonitions"));
-const module_1 = require("module");
-const moduleShorthand_1 = require("./moduleShorthand");
 async function loadSiteConfig({ siteDir, customConfigFilePath, }) {
     const siteConfigPath = path_1.default.resolve(siteDir, customConfigFilePath ?? utils_1.DEFAULT_CONFIG_FILE_NAME);
-    const siteConfig = await (0, config_1.default)(siteConfigPath);
+    const siteConfig = await (0, config_1.loadConfig)(siteConfigPath);
     return { siteConfig, siteConfigPath };
 }
 exports.loadSiteConfig = loadSiteConfig;
@@ -42,13 +37,13 @@ async function loadContext(siteDir, options = {}) {
     const { ssrTemplate } = initialSiteConfig;
     const baseOutDir = path_1.default.resolve(siteDir, customOutDir ?? utils_1.DEFAULT_BUILD_DIR_NAME);
     const i18n = await (0, i18n_1.loadI18n)(initialSiteConfig, { locale });
-    const baseUrl = (0, i18n_1.localizePath)({
+    const baseUrl = (0, utils_1.localizePath)({
         path: initialSiteConfig.baseUrl,
         i18n,
         options,
         pathType: 'url',
     });
-    const outDir = (0, i18n_1.localizePath)({
+    const outDir = (0, utils_1.localizePath)({
         path: baseOutDir,
         i18n,
         options,
@@ -74,136 +69,12 @@ async function loadContext(siteDir, options = {}) {
     };
 }
 exports.loadContext = loadContext;
-async function loadPluginConfigs(context) {
-    let { plugins: presetPlugins, themes: presetThemes } = await (0, presets_1.default)(context);
-    const { siteConfig, siteConfigPath } = context;
-    const require = (0, module_1.createRequire)(siteConfigPath);
-    function normalizeShorthand(pluginConfig, pluginType) {
-        if (typeof pluginConfig === 'string') {
-            return (0, moduleShorthand_1.resolveModuleName)(pluginConfig, require, pluginType);
-        }
-        else if (Array.isArray(pluginConfig) &&
-            typeof pluginConfig[0] === 'string') {
-            return [
-                (0, moduleShorthand_1.resolveModuleName)(pluginConfig[0], require, pluginType),
-                pluginConfig[1] ?? {},
-            ];
-        }
-        return pluginConfig;
-    }
-    presetPlugins = presetPlugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
-    presetThemes = presetThemes.map((theme) => normalizeShorthand(theme, 'theme'));
-    const standalonePlugins = siteConfig.plugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
-    const standaloneThemes = siteConfig.themes.map((theme) => normalizeShorthand(theme, 'theme'));
-    return [
-        ...presetPlugins,
-        ...presetThemes,
-        // Site config should be the highest priority.
-        ...standalonePlugins,
-        ...standaloneThemes,
-    ];
-}
-exports.loadPluginConfigs = loadPluginConfigs;
-// Make a fake plugin to:
-// - Resolve aliased theme components
-// - Inject scripts/stylesheets
-function createBootstrapPlugin({ siteDir, siteConfig, }) {
-    const { stylesheets, scripts, clientModules: siteConfigClientModules, } = siteConfig;
-    return {
-        name: 'docusaurus-bootstrap-plugin',
-        content: null,
-        options: {
-            id: 'default',
-        },
-        version: { type: 'synthetic' },
-        path: siteDir,
-        getClientModules() {
-            return siteConfigClientModules;
-        },
-        injectHtmlTags: () => {
-            const stylesheetsTags = stylesheets.map((source) => typeof source === 'string'
-                ? `<link rel="stylesheet" href="${source}">`
-                : {
-                    tagName: 'link',
-                    attributes: {
-                        rel: 'stylesheet',
-                        ...source,
-                    },
-                });
-            const scriptsTags = scripts.map((source) => typeof source === 'string'
-                ? `<script src="${source}"></script>`
-                : {
-                    tagName: 'script',
-                    attributes: {
-                        ...source,
-                    },
-                });
-            return {
-                headTags: [...stylesheetsTags, ...scriptsTags],
-            };
-        },
-    };
-}
-/**
- * Configure Webpack fallback mdx loader for md/mdx files out of content-plugin
- * folders. Adds a "fallback" mdx loader for mdx files that are not processed by
- * content plugins. This allows to do things such as importing repo/README.md as
- * a partial from another doc. Not ideal solution, but good enough for now
- */
-function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
-    return {
-        name: 'docusaurus-mdx-fallback-plugin',
-        content: null,
-        options: {
-            id: 'default',
-        },
-        version: { type: 'synthetic' },
-        // Synthetic, the path doesn't matter much
-        path: '.',
-        configureWebpack(config, isServer, { getJSLoader }) {
-            // We need the mdx fallback loader to exclude files that were already
-            // processed by content plugins mdx loaders. This works, but a bit
-            // hacky... Not sure there's a way to handle that differently in webpack
-            function getMDXFallbackExcludedPaths() {
-                const rules = config?.module?.rules;
-                return rules.flatMap((rule) => {
-                    const isMDXRule = rule.test instanceof RegExp && rule.test.test('x.mdx');
-                    return isMDXRule ? rule.include : [];
-                });
-            }
-            return {
-                module: {
-                    rules: [
-                        {
-                            test: /\.mdx?$/i,
-                            exclude: getMDXFallbackExcludedPaths(),
-                            use: [
-                                getJSLoader({ isServer }),
-                                {
-                                    loader: require.resolve('@docusaurus/mdx-loader'),
-                                    options: {
-                                        staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
-                                        siteDir,
-                                        isMDXPartial: () => true,
-                                        isMDXPartialFrontMatterWarningDisabled: true,
-                                        remarkPlugins: [remark_admonitions_1.default],
-                                    },
-                                },
-                            ],
-                        },
-                    ],
-                },
-            };
-        },
-    };
-}
 async function load(siteDir, options = {}) {
     // Context.
     const context = await loadContext(siteDir, options);
     const { generatedFilesDir, siteConfig, siteConfigPath, outDir, baseUrl, i18n, ssrTemplate, codeTranslations, } = context;
     // Plugins.
-    const pluginConfigs = await loadPluginConfigs(context);
-    const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated } = await (0, plugins_1.loadPlugins)({ pluginConfigs, context });
+    const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated } = await (0, plugins_1.loadPlugins)(context);
     // Side-effect to replace the untranslated themeConfig by the translated one
     context.siteConfig.themeConfig = themeConfigTranslated;
     (0, duplicateRoutes_1.handleDuplicateRoutes)(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
@@ -222,9 +93,8 @@ next build. You can clear all build artifacts (including this folder) with the
  */
 export default ${JSON.stringify(siteConfig, null, 2)};
 `);
-    plugins.push(createBootstrapPlugin({ siteDir, siteConfig }), createMDXFallbackPlugin({ siteDir, siteConfig }));
     // Load client modules.
-    const clientModules = (0, client_modules_1.default)(plugins);
+    const clientModules = (0, clientModules_1.loadClientModules)(plugins);
     const genClientModules = (0, utils_1.generate)(generatedFilesDir, 'client-modules.js', `export default [
 ${clientModules
         // import() is async so we use require() because client modules can have
@@ -234,9 +104,9 @@ ${clientModules
 ];
 `);
     // Load extra head & body html tags.
-    const { headTags, preBodyTags, postBodyTags } = (0, html_tags_1.loadHtmlTags)(plugins);
+    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)(plugins);
     // Routing.
-    const { registry, routesChunkNames, routesConfig, routesPaths } = await (0, routes_1.default)(pluginsRouteConfigs, baseUrl);
+    const { registry, routesChunkNames, routesConfig, routesPaths } = await (0, routes_1.loadRoutes)(pluginsRouteConfigs, baseUrl);
     const genRegistry = (0, utils_1.generate)(generatedFilesDir, 'registry.js', `export default {
 ${Object.entries(registry)
         .sort((a, b) => a[0].localeCompare(b[0]))
@@ -253,17 +123,7 @@ ${Object.entries(registry)
     };
     const genCodeTranslations = (0, utils_1.generate)(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslationsWithFallbacks, null, 2));
     // Version metadata.
-    const siteMetadata = {
-        docusaurusVersion: (await (0, versions_1.getPackageJsonVersion)(path_1.default.join(__dirname, '../../package.json'))),
-        siteVersion: await (0, versions_1.getPackageJsonVersion)(path_1.default.join(siteDir, 'package.json')),
-        pluginVersions: {},
-    };
-    plugins
-        .filter(({ version: { type } }) => type !== 'synthetic')
-        .forEach(({ name, version }) => {
-        siteMetadata.pluginVersions[name] = version;
-    });
-    checkDocusaurusPackagesVersion(siteMetadata);
+    const siteMetadata = await (0, siteMetadata_1.loadSiteMetadata)({ plugins, siteDir });
     const genSiteMetadata = (0, utils_1.generate)(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
     await Promise.all([
         genWarning,
@@ -298,21 +158,3 @@ ${Object.entries(registry)
     return props;
 }
 exports.load = load;
-// We want all @docusaurus/* packages to have the exact same version!
-// See https://github.com/facebook/docusaurus/issues/3371
-// See https://github.com/facebook/docusaurus/pull/3386
-function checkDocusaurusPackagesVersion(siteMetadata) {
-    const { docusaurusVersion } = siteMetadata;
-    Object.entries(siteMetadata.pluginVersions).forEach(([plugin, versionInfo]) => {
-        if (versionInfo.type === 'package' &&
-            versionInfo.name?.startsWith('@docusaurus/') &&
-            versionInfo.version &&
-            versionInfo.version !== docusaurusVersion) {
-            // should we throw instead?
-            // It still could work with different versions
-            logger_1.default.error `Invalid name=${plugin} version number=${versionInfo.version}.
-All official @docusaurus/* packages should have the exact same version as @docusaurus/core (number=${docusaurusVersion}).
-Maybe you want to check, or regenerate your yarn.lock or package-lock.json file?`;
-        }
-    });
-}

package/lib/server/{html-tags/htmlTags.d.ts → plugins/configs.d.ts}

@@ -4,4 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export default function htmlTagObjectToString(tagDefinition: unknown): string;
+import type { LoadContext, PluginConfig } from '@docusaurus/types';
+export declare function loadPluginConfigs(context: LoadContext): Promise<PluginConfig[]>;

package/lib/server/plugins/configs.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPluginConfigs = void 0;
+const module_1 = require("module");
+const presets_1 = require("./presets");
+const moduleShorthand_1 = require("../moduleShorthand");
+async function loadPluginConfigs(context) {
+    const preset = await (0, presets_1.loadPresets)(context);
+    const { siteConfig, siteConfigPath } = context;
+    const require = (0, module_1.createRequire)(siteConfigPath);
+    function normalizeShorthand(pluginConfig, pluginType) {
+        if (typeof pluginConfig === 'string') {
+            return (0, moduleShorthand_1.resolveModuleName)(pluginConfig, require, pluginType);
+        }
+        else if (Array.isArray(pluginConfig) &&
+            typeof pluginConfig[0] === 'string') {
+            return [
+                (0, moduleShorthand_1.resolveModuleName)(pluginConfig[0], require, pluginType),
+                pluginConfig[1] ?? {},
+            ];
+        }
+        return pluginConfig;
+    }
+    preset.plugins = preset.plugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
+    preset.themes = preset.themes.map((theme) => normalizeShorthand(theme, 'theme'));
+    const standalonePlugins = siteConfig.plugins.map((plugin) => normalizeShorthand(plugin, 'plugin'));
+    const standaloneThemes = siteConfig.themes.map((theme) => normalizeShorthand(theme, 'theme'));
+    return [
+        ...preset.plugins,
+        ...preset.themes,
+        // Site config should be the highest priority.
+        ...standalonePlugins,
+        ...standaloneThemes,
+    ];
+}
+exports.loadPluginConfigs = loadPluginConfigs;

package/lib/server/plugins/index.d.ts

@@ -4,12 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { LoadContext, PluginConfig, RouteConfig, GlobalData, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
-export declare function sortConfig(routeConfigs: RouteConfig[], baseUrl?: string): void;
-export declare function loadPlugins({ pluginConfigs, context, }: {
-    pluginConfigs: PluginConfig[];
-    context: LoadContext;
-}): Promise<{
+import type { LoadContext, RouteConfig, GlobalData, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
+export declare function loadPlugins(context: LoadContext): Promise<{
     plugins: LoadedPlugin[];
     pluginsRouteConfigs: RouteConfig[];
     globalData: GlobalData;

package/lib/server/plugins/index.js

@@ -6,55 +6,21 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadPlugins = exports.sortConfig = void 0;
+exports.loadPlugins = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const init_1 = tslib_1.__importDefault(require("./init"));
+const init_1 = require("./init");
+const synthetic_1 = require("./synthetic");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const translations_1 = require("../translations/translations");
-const applyRouteTrailingSlash_1 = tslib_1.__importDefault(require("./applyRouteTrailingSlash"));
-function sortConfig(routeConfigs, baseUrl = '/') {
-    // Sort the route config. This ensures that route with nested
-    // routes is always placed last.
-    routeConfigs.sort((a, b) => {
-        // Root route should get placed last.
-        if (a.path === baseUrl && b.path !== baseUrl) {
-            return 1;
-        }
-        if (a.path !== baseUrl && b.path === baseUrl) {
-            return -1;
-        }
-        if (a.routes && !b.routes) {
-            return 1;
-        }
-        if (!a.routes && b.routes) {
-            return -1;
-        }
-        // Higher priority get placed first.
-        if (a.priority || b.priority) {
-            const priorityA = a.priority || 0;
-            const priorityB = b.priority || 0;
-            const score = priorityB - priorityA;
-            if (score !== 0) {
-                return score;
-            }
-        }
-        return a.path.localeCompare(b.path);
-    });
-    routeConfigs.forEach((routeConfig) => {
-        routeConfig.routes?.sort((a, b) => a.path.localeCompare(b.path));
-    });
-}
-exports.sortConfig = sortConfig;
-async function loadPlugins({ pluginConfigs, context, }) {
+const routeConfig_1 = require("./routeConfig");
+async function loadPlugins(context) {
     // 1. Plugin Lifecycle - Initialization/Constructor.
-    const plugins = await (0, init_1.default)({
-        pluginConfigs,
-        context,
-    });
+    const plugins = await (0, init_1.initPlugins)(context);
+    plugins.push((0, synthetic_1.createBootstrapPlugin)(context), (0, synthetic_1.createMDXFallbackPlugin)(context));
     // 2. Plugin Lifecycle - loadContent.
     // Currently plugins run lifecycle methods in parallel and are not
     // order-dependent. We could change this in future if there are plugins which
@@ -111,7 +77,7 @@ async function loadPlugins({ pluginConfigs, context, }) {
         const pluginRouteContextModulePath = await createData(`${(0, utils_1.docuHash)('pluginRouteContextModule')}.json`, JSON.stringify(pluginRouteContext, null, 2));
         const addRoute = (initialRouteConfig) => {
             // Trailing slash behavior is handled in a generic way for all plugins
-            const finalRouteConfig = (0, applyRouteTrailingSlash_1.default)(initialRouteConfig, {
+            const finalRouteConfig = (0, routeConfig_1.applyRouteTrailingSlash)(initialRouteConfig, {
                 trailingSlash: context.siteConfig.trailingSlash,
                 baseUrl: context.siteConfig.baseUrl,
             });
@@ -158,7 +124,7 @@ async function loadPlugins({ pluginConfigs, context, }) {
     }));
     // Sort the route config. This ensures that route with nested
     // routes are always placed last.
-    sortConfig(pluginsRouteConfigs, context.siteConfig.baseUrl);
+    (0, routeConfig_1.sortConfig)(pluginsRouteConfigs, context.siteConfig.baseUrl);
     // Apply each plugin one after the other to translate the theme config
     function translateThemeConfig(untranslatedThemeConfig) {
         return contentLoadedTranslatedPlugins.reduce((currentThemeConfig, plugin) => {

package/lib/server/plugins/init.d.ts

@@ -19,7 +19,4 @@ export declare type NormalizedPluginConfig = {
     entryPath: string;
 };
 export declare function normalizePluginConfigs(pluginConfigs: PluginConfig[], configPath: string): Promise<NormalizedPluginConfig[]>;
-export default function initPlugins({ pluginConfigs, context, }: {
-    pluginConfigs: PluginConfig[];
-    context: LoadContext;
-}): Promise<InitializedPlugin[]>;
+export declare function initPlugins(context: LoadContext): Promise<InitializedPlugin[]>;

package/lib/server/plugins/init.js

@@ -6,15 +6,16 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePluginConfigs = void 0;
+exports.initPlugins = exports.normalizePluginConfigs = void 0;
 const tslib_1 = require("tslib");
 const module_1 = require("module");
 const path_1 = tslib_1.__importDefault(require("path"));
 const import_fresh_1 = tslib_1.__importDefault(require("import-fresh"));
 const utils_1 = require("@docusaurus/utils");
-const versions_1 = require("../versions");
+const siteMetadata_1 = require("../siteMetadata");
 const pluginIds_1 = require("./pluginIds");
 const utils_validation_1 = require("@docusaurus/utils-validation");
+const configs_1 = require("./configs");
 async function normalizePluginConfig(pluginConfig, configPath) {
     const pluginRequire = (0, module_1.createRequire)(configPath);
     // plugins: ['./plugin']
@@ -86,16 +87,17 @@ function getThemeValidationFunction(normalizedPluginConfig) {
     }
     return normalizedPluginConfig.plugin.validateThemeConfig;
 }
-async function initPlugins({ pluginConfigs, context, }) {
+async function initPlugins(context) {
     // We need to resolve plugins from the perspective of the siteDir, since the
     // siteDir's package.json declares the dependency on these plugins.
     const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
+    const pluginConfigs = await (0, configs_1.loadPluginConfigs)(context);
     const pluginConfigsNormalized = await normalizePluginConfigs(pluginConfigs, context.siteConfigPath);
     async function doGetPluginVersion(normalizedPluginConfig) {
         // get plugin version
         if (normalizedPluginConfig.pluginModule?.path) {
             const pluginPath = pluginRequire.resolve(normalizedPluginConfig.pluginModule?.path);
-            return (0, versions_1.getPluginVersion)(pluginPath, context.siteDir);
+            return (0, siteMetadata_1.getPluginVersion)(pluginPath, context.siteDir);
         }
         return { type: 'local' };
     }
@@ -144,4 +146,4 @@ async function initPlugins({ pluginConfigs, context, }) {
     (0, pluginIds_1.ensureUniquePluginInstanceIds)(plugins);
     return plugins;
 }
-exports.default = initPlugins;
+exports.initPlugins = initPlugins;

package/lib/server/{presets/index.d.ts → plugins/presets.d.ts}

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadContext, PluginConfig } from '@docusaurus/types';
-export default function loadPresets(context: LoadContext): Promise<{
+export declare function loadPresets(context: LoadContext): Promise<{
     plugins: PluginConfig[];
     themes: PluginConfig[];
 }>;

package/lib/server/{presets/index.js → plugins/presets.js}

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPresets = void 0;
 const tslib_1 = require("tslib");
 const module_1 = require("module");
 const import_fresh_1 = tslib_1.__importDefault(require("import-fresh"));
@@ -38,4 +39,4 @@ async function loadPresets(context) {
     });
     return { plugins, themes };
 }
-exports.default = loadPresets;
+exports.loadPresets = loadPresets;

package/lib/server/plugins/{applyRouteTrailingSlash.d.ts → routeConfig.d.ts}

@@ -6,4 +6,5 @@
  */
 import type { RouteConfig } from '@docusaurus/types';
 import { type ApplyTrailingSlashParams } from '@docusaurus/utils-common';
-export default function applyRouteTrailingSlash(route: RouteConfig, params: ApplyTrailingSlashParams): RouteConfig;
+export declare function applyRouteTrailingSlash(route: RouteConfig, params: ApplyTrailingSlashParams): RouteConfig;
+export declare function sortConfig(routeConfigs: RouteConfig[], baseUrl?: string): void;

package/lib/server/plugins/routeConfig.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortConfig = exports.applyRouteTrailingSlash = void 0;
+const utils_common_1 = require("@docusaurus/utils-common");
+function applyRouteTrailingSlash(route, params) {
+    return {
+        ...route,
+        path: (0, utils_common_1.applyTrailingSlash)(route.path, params),
+        ...(route.routes && {
+            routes: route.routes.map((subroute) => applyRouteTrailingSlash(subroute, params)),
+        }),
+    };
+}
+exports.applyRouteTrailingSlash = applyRouteTrailingSlash;
+function sortConfig(routeConfigs, baseUrl = '/') {
+    // Sort the route config. This ensures that route with nested
+    // routes is always placed last.
+    routeConfigs.sort((a, b) => {
+        // Root route should get placed last.
+        if (a.path === baseUrl && b.path !== baseUrl) {
+            return 1;
+        }
+        if (a.path !== baseUrl && b.path === baseUrl) {
+            return -1;
+        }
+        if (a.routes && !b.routes) {
+            return 1;
+        }
+        if (!a.routes && b.routes) {
+            return -1;
+        }
+        // Higher priority get placed first.
+        if (a.priority || b.priority) {
+            const priorityA = a.priority || 0;
+            const priorityB = b.priority || 0;
+            const score = priorityB - priorityA;
+            if (score !== 0) {
+                return score;
+            }
+        }
+        return a.path.localeCompare(b.path);
+    });
+    routeConfigs.forEach((routeConfig) => {
+        routeConfig.routes?.sort((a, b) => a.path.localeCompare(b.path));
+    });
+}
+exports.sortConfig = sortConfig;

package/lib/server/plugins/synthetic.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { LoadedPlugin, LoadContext } from '@docusaurus/types';
+/**
+ * Make a synthetic plugin to:
+ * - Inject site client modules
+ * - Inject scripts/stylesheets
+ */
+export declare function createBootstrapPlugin({ siteDir, siteConfig, }: LoadContext): LoadedPlugin;
+/**
+ * Configure Webpack fallback mdx loader for md/mdx files out of content-plugin
+ * folders. Adds a "fallback" mdx loader for mdx files that are not processed by
+ * content plugins. This allows to do things such as importing repo/README.md as
+ * a partial from another doc. Not ideal solution, but good enough for now
+ */
+export declare function createMDXFallbackPlugin({ siteDir, siteConfig, }: LoadContext): LoadedPlugin;