@docusaurus/core 2.0.0-beta.16 → 2.0.0-beta.19

package/lib/server/plugins/index.js

@@ -6,169 +6,102 @@
  * 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 = (0, tslib_1.__importDefault)(require("fs-extra"));
-const path_1 = (0, tslib_1.__importDefault)(require("path"));
-const init_1 = (0, tslib_1.__importDefault)(require("./init"));
-const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const init_1 = require("./init");
+const synthetic_1 = require("./synthetic");
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const translations_1 = require("../translations/translations");
-const applyRouteTrailingSlash_1 = (0, 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) => {
-        var _a;
-        (_a = routeConfig.routes) === null || _a === void 0 ? void 0 : _a.sort((a, b) => a.path.localeCompare(b.path));
-    });
-}
-exports.sortConfig = sortConfig;
-async function loadPlugins({ pluginConfigs, context, }) {
+const routeConfig_1 = require("./routeConfig");
+/**
+ * Initializes the plugins, runs `loadContent`, `translateContent`,
+ * `contentLoaded`, and `translateThemeConfig`. Because `contentLoaded` is
+ * side-effect-ful (it generates temp files), so is this function. This function
+ * would also mutate `context.siteConfig.themeConfig` to translate it.
+ */
+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
     // need to run in certain order or depend on others for data.
+    // This would also translate theme config and content upfront, given the
+    // translation files that the plugin declares.
     const loadedPlugins = await Promise.all(plugins.map(async (plugin) => {
-        const content = plugin.loadContent ? await plugin.loadContent() : null;
-        return { ...plugin, content };
-    }));
-    const contentLoadedTranslatedPlugins = await Promise.all(loadedPlugins.map(async (contentLoadedPlugin) => {
-        var _a, _b;
-        const translationFiles = (_b = (await ((_a = contentLoadedPlugin === null || contentLoadedPlugin === void 0 ? void 0 : contentLoadedPlugin.getTranslationFiles) === null || _a === void 0 ? void 0 : _a.call(contentLoadedPlugin, {
-            content: contentLoadedPlugin.content,
-        })))) !== null && _b !== void 0 ? _b : [];
-        const localizedTranslationFiles = await Promise.all(translationFiles.map((translationFile) => (0, translations_1.localizePluginTranslationFile)({
+        const content = await plugin.loadContent?.();
+        const rawTranslationFiles = (await plugin?.getTranslationFiles?.({ content })) ?? [];
+        const translationFiles = await Promise.all(rawTranslationFiles.map((translationFile) => (0, translations_1.localizePluginTranslationFile)({
             locale: context.i18n.currentLocale,
             siteDir: context.siteDir,
             translationFile,
-            plugin: contentLoadedPlugin,
+            plugin,
         })));
-        return {
-            ...contentLoadedPlugin,
-            translationFiles: localizedTranslationFiles,
-        };
+        const translatedContent = plugin.translateContent?.({ content, translationFiles }) ?? content;
+        const translatedThemeConfigSlice = plugin.translateThemeConfig?.({
+            themeConfig: context.siteConfig.themeConfig,
+            translationFiles,
+        });
+        // Side-effect to merge theme config translations. A plugin should only
+        // translate its own slice of theme config and should make no assumptions
+        // about other plugins' keys, so this is safe to run in parallel.
+        Object.assign(context.siteConfig.themeConfig, translatedThemeConfigSlice);
+        return { ...plugin, content: translatedContent };
     }));
     const allContent = lodash_1.default.chain(loadedPlugins)
         .groupBy((item) => item.name)
         .mapValues((nameItems) => lodash_1.default.chain(nameItems)
-        .groupBy((item) => { var _a; return (_a = item.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID; })
+        .groupBy((item) => item.options.id)
         .mapValues((idItems) => idItems[0].content)
         .value())
         .value();
     // 3. Plugin Lifecycle - contentLoaded.
     const pluginsRouteConfigs = [];
     const globalData = {};
-    await Promise.all(contentLoadedTranslatedPlugins.map(async ({ content, translationFiles, ...plugin }) => {
-        var _a, _b, _c;
+    await Promise.all(loadedPlugins.map(async ({ content, ...plugin }) => {
         if (!plugin.contentLoaded) {
             return;
         }
-        const pluginId = (_a = plugin.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID;
-        // plugins data files are namespaced by pluginName/pluginId
-        const dataDirRoot = path_1.default.join(context.generatedFilesDir, plugin.name);
-        const dataDir = path_1.default.join(dataDirRoot, pluginId);
-        const addRoute = (initialRouteConfig) => {
-            // Trailing slash behavior is handled in a generic way for all plugins
-            const finalRouteConfig = (0, applyRouteTrailingSlash_1.default)(initialRouteConfig, {
-                trailingSlash: context.siteConfig.trailingSlash,
-                baseUrl: context.siteConfig.baseUrl,
-            });
-            pluginsRouteConfigs.push(finalRouteConfig);
-        };
-        const createData = async (name, data) => {
-            const modulePath = path_1.default.join(dataDir, name);
-            await fs_extra_1.default.ensureDir(path_1.default.dirname(modulePath));
-            await (0, utils_1.generate)(dataDir, name, data);
-            return modulePath;
-        };
-        // the plugins global data are namespaced to avoid data conflicts:
-        // - by plugin name
-        // - by plugin id (allow using multiple instances of the same plugin)
-        const setGlobalData = (data) => {
-            var _a;
-            globalData[plugin.name] = (_a = globalData[plugin.name]) !== null && _a !== void 0 ? _a : {};
-            globalData[plugin.name][pluginId] = data;
+        const pluginId = plugin.options.id;
+        // Plugins data files are namespaced by pluginName/pluginId
+        const dataDir = path_1.default.join(context.generatedFilesDir, plugin.name, pluginId);
+        const pluginRouteContextModulePath = path_1.default.join(dataDir, `${(0, utils_1.docuHash)('pluginRouteContextModule')}.json`);
+        const pluginRouteContext = {
+            name: plugin.name,
+            id: pluginId,
         };
+        await (0, utils_1.generate)('/', pluginRouteContextModulePath, JSON.stringify(pluginRouteContext, null, 2));
         const actions = {
-            addRoute,
-            createData,
-            setGlobalData,
+            addRoute(initialRouteConfig) {
+                // Trailing slash behavior is handled generically for all plugins
+                const finalRouteConfig = (0, routeConfig_1.applyRouteTrailingSlash)(initialRouteConfig, context.siteConfig);
+                pluginsRouteConfigs.push({
+                    ...finalRouteConfig,
+                    context: {
+                        ...(finalRouteConfig.context && { data: finalRouteConfig.context }),
+                        plugin: pluginRouteContextModulePath,
+                    },
+                });
+            },
+            async createData(name, data) {
+                const modulePath = path_1.default.join(dataDir, name);
+                await (0, utils_1.generate)(dataDir, name, data);
+                return modulePath;
+            },
+            setGlobalData(data) {
+                var _a;
+                globalData[_a = plugin.name] ?? (globalData[_a] = {});
+                globalData[plugin.name][pluginId] = data;
+            },
         };
-        const translatedContent = (_c = (_b = plugin.translateContent) === null || _b === void 0 ? void 0 : _b.call(plugin, { content, translationFiles })) !== null && _c !== void 0 ? _c : content;
-        await plugin.contentLoaded({
-            content: translatedContent,
-            actions,
-            allContent,
-        });
-    }));
-    // 4. Plugin Lifecycle - routesLoaded.
-    // Currently plugins run lifecycle methods in parallel and are not
-    // order-dependent. We could change this in future if there are plugins which
-    // need to run in certain order or depend on others for data.
-    await Promise.all(contentLoadedTranslatedPlugins.map(async (plugin) => {
-        if (!plugin.routesLoaded) {
-            return null;
-        }
-        // TODO remove this deprecated lifecycle soon
-        // deprecated since alpha-60
-        // TODO, 1 user reported usage of this lifecycle! https://github.com/facebook/docusaurus/issues/3918
-        logger_1.default.error `Plugin code=${'routesLoaded'} lifecycle is deprecated. If you think we should keep this lifecycle, please report here: path=${'https://github.com/facebook/docusaurus/issues/3918'}`;
-        return plugin.routesLoaded(pluginsRouteConfigs);
+        await plugin.contentLoaded({ content, actions, allContent });
     }));
     // Sort the route config. This ensures that route with nested
     // routes are always placed last.
-    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) => {
-            var _a;
-            const translatedThemeConfigSlice = (_a = plugin.translateThemeConfig) === null || _a === void 0 ? void 0 : _a.call(plugin, {
-                themeConfig: currentThemeConfig,
-                translationFiles: plugin.translationFiles,
-            });
-            return {
-                ...currentThemeConfig,
-                ...translatedThemeConfigSlice,
-            };
-        }, untranslatedThemeConfig);
-    }
-    return {
-        plugins: loadedPlugins,
-        pluginsRouteConfigs,
-        globalData,
-        themeConfigTranslated: translateThemeConfig(context.siteConfig.themeConfig),
-    };
+    (0, routeConfig_1.sortConfig)(pluginsRouteConfigs, context.siteConfig.baseUrl);
+    return { plugins: loadedPlugins, pluginsRouteConfigs, globalData };
 }
 exports.loadPlugins = loadPlugins;

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

@@ -4,18 +4,9 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference types="node" />
-import type { ImportedPluginModule, LoadContext, PluginModule, PluginConfig, PluginOptions, InitializedPlugin } from '@docusaurus/types';
-export declare type NormalizedPluginConfig = {
-    plugin: PluginModule;
-    options: PluginOptions;
-    pluginModule?: {
-        path: string;
-        module: ImportedPluginModule;
-    };
-};
-export declare function normalizePluginConfigs(pluginConfigs: PluginConfig[], pluginRequire: NodeRequire): Promise<NormalizedPluginConfig[]>;
-export default function initPlugins({ pluginConfigs, context, }: {
-    pluginConfigs: PluginConfig[];
-    context: LoadContext;
-}): Promise<InitializedPlugin[]>;
+import type { LoadContext, InitializedPlugin } from '@docusaurus/types';
+/**
+ * Runs the plugin constructors and returns their return values. It would load
+ * plugin configs from `plugins`, `themes`, and `presets`.
+ */
+export declare function initPlugins(context: LoadContext): Promise<InitializedPlugin[]>;

package/lib/server/plugins/init.js

@@ -6,97 +6,44 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePluginConfigs = void 0;
+exports.initPlugins = void 0;
 const tslib_1 = require("tslib");
 const module_1 = require("module");
-const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
+const path_1 = tslib_1.__importDefault(require("path"));
 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");
-async function normalizePluginConfig(pluginConfig, pluginRequire) {
-    var _a, _b, _c, _d;
-    // plugins: ['./plugin']
-    if (typeof pluginConfig === 'string') {
-        const pluginModuleImport = pluginConfig;
-        const pluginPath = pluginRequire.resolve(pluginModuleImport);
-        const pluginModule = (0, import_fresh_1.default)(pluginPath);
-        return {
-            plugin: (_a = pluginModule === null || pluginModule === void 0 ? void 0 : pluginModule.default) !== null && _a !== void 0 ? _a : pluginModule,
-            options: {},
-            pluginModule: {
-                path: pluginModuleImport,
-                module: pluginModule,
-            },
-        };
-    }
-    // plugins: [function plugin() { }]
-    if (typeof pluginConfig === 'function') {
-        return {
-            plugin: pluginConfig,
-            options: {},
-        };
-    }
-    if (Array.isArray(pluginConfig)) {
-        // plugins: [
-        //   ['./plugin',options],
-        // ]
-        if (typeof pluginConfig[0] === 'string') {
-            const pluginModuleImport = pluginConfig[0];
-            const pluginPath = pluginRequire.resolve(pluginModuleImport);
-            const pluginModule = (0, import_fresh_1.default)(pluginPath);
-            return {
-                plugin: (_b = pluginModule === null || pluginModule === void 0 ? void 0 : pluginModule.default) !== null && _b !== void 0 ? _b : pluginModule,
-                options: (_c = pluginConfig[1]) !== null && _c !== void 0 ? _c : {},
-                pluginModule: {
-                    path: pluginModuleImport,
-                    module: pluginModule,
-                },
-            };
-        }
-        // plugins: [
-        //   [function plugin() { },options],
-        // ]
-        if (typeof pluginConfig[0] === 'function') {
-            return {
-                plugin: pluginConfig[0],
-                options: (_d = pluginConfig[1]) !== null && _d !== void 0 ? _d : {},
-            };
-        }
-    }
-    throw new Error(`Unexpected: can't load plugin for following plugin config.\n${JSON.stringify(pluginConfig)}`);
-}
-async function normalizePluginConfigs(pluginConfigs, pluginRequire) {
-    return Promise.all(pluginConfigs.map((pluginConfig) => normalizePluginConfig(pluginConfig, pluginRequire)));
-}
-exports.normalizePluginConfigs = normalizePluginConfigs;
+const configs_1 = require("./configs");
 function getOptionValidationFunction(normalizedPluginConfig) {
-    var _a, _b, _c, _d;
     if (normalizedPluginConfig.pluginModule) {
-        // support both commonjs and ES modules
-        return ((_c = (_b = (_a = normalizedPluginConfig.pluginModule.module) === null || _a === void 0 ? void 0 : _a.default) === null || _b === void 0 ? void 0 : _b.validateOptions) !== null && _c !== void 0 ? _c : (_d = normalizedPluginConfig.pluginModule.module) === null || _d === void 0 ? void 0 : _d.validateOptions);
+        // Support both CommonJS and ES modules
+        return (normalizedPluginConfig.pluginModule.module?.default?.validateOptions ??
+            normalizedPluginConfig.pluginModule.module?.validateOptions);
     }
     return normalizedPluginConfig.plugin.validateOptions;
 }
 function getThemeValidationFunction(normalizedPluginConfig) {
-    var _a, _b;
     if (normalizedPluginConfig.pluginModule) {
-        // support both commonjs and ES modules
-        return ((_b = (_a = normalizedPluginConfig.pluginModule.module.default) === null || _a === void 0 ? void 0 : _a.validateThemeConfig) !== null && _b !== void 0 ? _b : normalizedPluginConfig.pluginModule.module.validateThemeConfig);
+        // Support both CommonJS and ES modules
+        return (normalizedPluginConfig.pluginModule.module.default?.validateThemeConfig ??
+            normalizedPluginConfig.pluginModule.module.validateThemeConfig);
     }
     return normalizedPluginConfig.plugin.validateThemeConfig;
 }
-async function initPlugins({ pluginConfigs, context, }) {
-    // We need to resolve plugins from the perspective of the siteDir, since the
-    // siteDir's package.json declares the dependency on these plugins.
+/**
+ * Runs the plugin constructors and returns their return values. It would load
+ * plugin configs from `plugins`, `themes`, and `presets`.
+ */
+async function initPlugins(context) {
+    // We need to resolve plugins from the perspective of the site config, as if
+    // we are using `require.resolve` on those module names.
     const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
-    const pluginConfigsNormalized = await normalizePluginConfigs(pluginConfigs, pluginRequire);
+    const pluginConfigs = await (0, configs_1.loadPluginConfigs)(context);
     async function doGetPluginVersion(normalizedPluginConfig) {
-        var _a, _b;
-        // get plugin version
-        if ((_a = normalizedPluginConfig.pluginModule) === null || _a === void 0 ? void 0 : _a.path) {
-            const pluginPath = pluginRequire.resolve((_b = normalizedPluginConfig.pluginModule) === null || _b === void 0 ? void 0 : _b.path);
-            return (0, versions_1.getPluginVersion)(pluginPath, context.siteDir);
+        if (normalizedPluginConfig.pluginModule?.path) {
+            const pluginPath = pluginRequire.resolve(normalizedPluginConfig.pluginModule?.path);
+            return (0, siteMetadata_1.getPluginVersion)(pluginPath, context.siteDir);
         }
         return { type: 'local' };
     }
@@ -111,7 +58,6 @@ async function initPlugins({ pluginConfigs, context, }) {
         return context.siteConfig.themeConfig;
     }
     function doValidatePluginOptions(normalizedPluginConfig) {
-        var _a;
         const validateOptions = getOptionValidationFunction(normalizedPluginConfig);
         if (validateOptions) {
             return validateOptions({
@@ -123,7 +69,7 @@ async function initPlugins({ pluginConfigs, context, }) {
         // as we don't go through the Joi schema that adds it
         return {
             ...normalizedPluginConfig.options,
-            id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
+            id: normalizedPluginConfig.options.id ?? utils_1.DEFAULT_PLUGIN_ID,
         };
     }
     async function initializePlugin(normalizedPluginConfig) {
@@ -139,15 +85,11 @@ async function initPlugins({ pluginConfigs, context, }) {
             ...pluginInstance,
             options: pluginOptions,
             version: pluginVersion,
+            path: path_1.default.dirname(normalizedPluginConfig.entryPath),
         };
     }
-    const plugins = (await Promise.all(pluginConfigsNormalized.map((pluginConfig) => {
-        if (!pluginConfig) {
-            return null;
-        }
-        return initializePlugin(pluginConfig);
-    }))).filter((item) => Boolean(item));
+    const plugins = await Promise.all(pluginConfigs.map(initializePlugin));
     (0, pluginIds_1.ensureUniquePluginInstanceIds)(plugins);
     return plugins;
 }
-exports.default = initPlugins;
+exports.initPlugins = initPlugins;

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

@@ -5,4 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { InitializedPlugin } from '@docusaurus/types';
+/**
+ * It is forbidden to have 2 plugins of the same name sharing the same ID.
+ * This is required to support multi-instance plugins without conflict.
+ */
 export declare function ensureUniquePluginInstanceIds(plugins: InitializedPlugin[]): void;

package/lib/server/plugins/pluginIds.js

@@ -8,14 +8,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureUniquePluginInstanceIds = void 0;
 const tslib_1 = require("tslib");
-const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
-// It is forbidden to have 2 plugins of the same name sharing the same id
-// this is required to support multi-instance plugins without conflict
+/**
+ * It is forbidden to have 2 plugins of the same name sharing the same ID.
+ * This is required to support multi-instance plugins without conflict.
+ */
 function ensureUniquePluginInstanceIds(plugins) {
     const pluginsByName = lodash_1.default.groupBy(plugins, (p) => p.name);
     Object.entries(pluginsByName).forEach(([pluginName, pluginInstances]) => {
-        const pluginInstancesById = lodash_1.default.groupBy(pluginInstances, (p) => { var _a; return (_a = p.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID; });
+        const pluginInstancesById = lodash_1.default.groupBy(pluginInstances, (p) => p.options.id ?? utils_1.DEFAULT_PLUGIN_ID);
         Object.entries(pluginInstancesById).forEach(([pluginId, pluginInstancesWithId]) => {
             if (pluginInstancesWithId.length !== 1) {
                 throw new Error(`Plugin "${pluginName}" is used ${pluginInstancesWithId.length} times with ID "${pluginId}".\nTo use the same plugin multiple times on a Docusaurus site, you need to assign a unique ID to each plugin instance.${pluginId === utils_1.DEFAULT_PLUGIN_ID

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

@@ -0,0 +1,12 @@
+/**
+ * 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 { LoadContext, DocusaurusConfig } from '@docusaurus/types';
+/**
+ * Calls preset functions, aggregates each of their return values, and returns
+ * the plugin and theme configs.
+ */
+export declare function loadPresets(context: LoadContext): Promise<Pick<DocusaurusConfig, 'plugins' | 'themes'>>;

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

@@ -6,43 +6,44 @@
  * 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 = (0, tslib_1.__importDefault)(require("import-fresh"));
-const moduleShorthand_1 = require("../moduleShorthand");
+const import_fresh_1 = tslib_1.__importDefault(require("import-fresh"));
+const moduleShorthand_1 = require("./moduleShorthand");
+/**
+ * Calls preset functions, aggregates each of their return values, and returns
+ * the plugin and theme configs.
+ */
 async function loadPresets(context) {
-    // We need to resolve presets from the perspective of the siteDir, since the
-    // siteDir's package.json declares the dependency on these presets.
+    // We need to resolve plugins from the perspective of the site config, as if
+    // we are using `require.resolve` on those module names.
     const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
-    const presets = context.siteConfig.presets || [];
-    const unflatPlugins = [];
-    const unflatThemes = [];
+    const { presets } = context.siteConfig;
+    const plugins = [];
+    const themes = [];
     presets.forEach((presetItem) => {
-        var _a;
         let presetModuleImport;
         let presetOptions = {};
+        if (!presetItem) {
+            return;
+        }
         if (typeof presetItem === 'string') {
             presetModuleImport = presetItem;
         }
-        else if (Array.isArray(presetItem)) {
-            [presetModuleImport, presetOptions = {}] = presetItem;
-        }
         else {
-            throw new Error('Invalid presets format detected in config.');
+            [presetModuleImport, presetOptions] = presetItem;
         }
         const presetName = (0, moduleShorthand_1.resolveModuleName)(presetModuleImport, presetRequire, 'preset');
         const presetModule = (0, import_fresh_1.default)(presetRequire.resolve(presetName));
-        const preset = ((_a = presetModule.default) !== null && _a !== void 0 ? _a : presetModule)(context, presetOptions);
+        const preset = (presetModule.default ?? presetModule)(context, presetOptions);
         if (preset.plugins) {
-            unflatPlugins.push(preset.plugins);
+            plugins.push(...preset.plugins);
         }
         if (preset.themes) {
-            unflatThemes.push(preset.themes);
+            themes.push(...preset.themes);
         }
     });
-    return {
-        plugins: unflatPlugins.flat().filter(Boolean),
-        themes: unflatThemes.flat().filter(Boolean),
-    };
+    return { plugins, themes };
 }
-exports.default = loadPresets;
+exports.loadPresets = loadPresets;

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

@@ -6,4 +6,6 @@
  */
 import type { RouteConfig } from '@docusaurus/types';
 import { type ApplyTrailingSlashParams } from '@docusaurus/utils-common';
-export default function applyRouteTrailingSlash(route: RouteConfig, params: ApplyTrailingSlashParams): RouteConfig;
+/** Recursively applies trailing slash config to all nested routes. */
+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,54 @@
+"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");
+/** Recursively applies trailing slash config to all nested routes. */
+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;