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

package/lib/index.js

@@ -6,22 +6,23 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeHeadingIds = exports.writeTranslations = exports.clear = exports.serve = exports.externalCommand = exports.deploy = exports.swizzle = exports.start = exports.build = void 0;
-var build_1 = require("./commands/build");
-Object.defineProperty(exports, "build", { enumerable: true, get: function () { return __importDefault(build_1).default; } });
-var start_1 = require("./commands/start");
-Object.defineProperty(exports, "start", { enumerable: true, get: function () { return __importDefault(start_1).default; } });
-var swizzle_1 = require("./commands/swizzle");
-Object.defineProperty(exports, "swizzle", { enumerable: true, get: function () { return __importDefault(swizzle_1).default; } });
-var deploy_1 = require("./commands/deploy");
-Object.defineProperty(exports, "deploy", { enumerable: true, get: function () { return __importDefault(deploy_1).default; } });
-var external_1 = require("./commands/external");
-Object.defineProperty(exports, "externalCommand", { enumerable: true, get: function () { return __importDefault(external_1).default; } });
-var serve_1 = require("./commands/serve");
-Object.defineProperty(exports, "serve", { enumerable: true, get: function () { return __importDefault(serve_1).default; } });
-var clear_1 = require("./commands/clear");
-Object.defineProperty(exports, "clear", { enumerable: true, get: function () { return __importDefault(clear_1).default; } });
-var writeTranslations_1 = require("./commands/writeTranslations");
-Object.defineProperty(exports, "writeTranslations", { enumerable: true, get: function () { return __importDefault(writeTranslations_1).default; } });
-var writeHeadingIds_1 = require("./commands/writeHeadingIds");
-Object.defineProperty(exports, "writeHeadingIds", { enumerable: true, get: function () { return __importDefault(writeHeadingIds_1).default; } });
+exports.writeTranslations = exports.writeHeadingIds = exports.swizzle = exports.start = exports.serve = exports.externalCommand = exports.deploy = exports.clear = exports.build = void 0;
+const tslib_1 = require("tslib");
+const build_1 = (0, tslib_1.__importDefault)(require("./commands/build"));
+exports.build = build_1.default;
+const clear_1 = (0, tslib_1.__importDefault)(require("./commands/clear"));
+exports.clear = clear_1.default;
+const deploy_1 = (0, tslib_1.__importDefault)(require("./commands/deploy"));
+exports.deploy = deploy_1.default;
+const external_1 = (0, tslib_1.__importDefault)(require("./commands/external"));
+exports.externalCommand = external_1.default;
+const serve_1 = (0, tslib_1.__importDefault)(require("./commands/serve"));
+exports.serve = serve_1.default;
+const start_1 = (0, tslib_1.__importDefault)(require("./commands/start"));
+exports.start = start_1.default;
+const swizzle_1 = (0, tslib_1.__importDefault)(require("./commands/swizzle"));
+exports.swizzle = swizzle_1.default;
+const writeHeadingIds_1 = (0, tslib_1.__importDefault)(require("./commands/writeHeadingIds"));
+exports.writeHeadingIds = writeHeadingIds_1.default;
+const writeTranslations_1 = (0, tslib_1.__importDefault)(require("./commands/writeTranslations"));
+exports.writeTranslations = writeTranslations_1.default;

package/lib/server/brokenLinks.js

@@ -10,10 +10,11 @@ exports.handleBrokenLinks = exports.filterExistingFileLinks = exports.getBrokenL
 const tslib_1 = require("tslib");
 const react_router_config_1 = require("react-router-config");
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
-const lodash_1 = require("lodash");
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 const utils_2 = require("./utils");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
+const combine_promises_1 = (0, tslib_1.__importDefault)(require("combine-promises"));
 function toReactRouterRoutes(routes) {
     // @ts-expect-error: types incompatible???
     return routes;
@@ -39,19 +40,21 @@ function getPageBrokenLinks({ pagePath, pageLinks, routes, }) {
     }
     return pageLinks.map(resolveLink).filter((l) => isBrokenLink(l.resolvedLink));
 }
-// The route defs can be recursive, and have a parent match-all route
-// We don't want to match broken links like /docs/brokenLink against /docs/*
-// For this reason, we only consider the "final routes", that do not have subroutes
-// We also need to remove the match all 404 route
+/**
+ * The route defs can be recursive, and have a parent match-all route. We don't
+ * want to match broken links like /docs/brokenLink against /docs/*. For this
+ * reason, we only consider the "final routes", that do not have subroutes.
+ * We also need to remove the match all 404 route
+ */
 function filterIntermediateRoutes(routesInput) {
     const routesWithout404 = routesInput.filter((route) => route.path !== '*');
     return (0, utils_2.getAllFinalRoutes)(routesWithout404);
 }
 function getAllBrokenLinks({ allCollectedLinks, routes, }) {
     const filteredRoutes = filterIntermediateRoutes(routes);
-    const allBrokenLinks = (0, lodash_1.mapValues)(allCollectedLinks, (pageLinks, pagePath) => getPageBrokenLinks({ pageLinks, pagePath, routes: filteredRoutes }));
+    const allBrokenLinks = lodash_1.default.mapValues(allCollectedLinks, (pageLinks, pagePath) => getPageBrokenLinks({ pageLinks, pagePath, routes: filteredRoutes }));
     // remove pages without any broken link
-    return (0, lodash_1.pickBy)(allBrokenLinks, (brokenLinks) => brokenLinks.length > 0);
+    return lodash_1.default.pickBy(allBrokenLinks, (brokenLinks) => brokenLinks.length > 0);
 }
 exports.getAllBrokenLinks = getAllBrokenLinks;
 function getBrokenLinksErrorMessage(allBrokenLinks) {
@@ -67,12 +70,14 @@ function getBrokenLinksErrorMessage(allBrokenLinks) {
             .map(brokenLinkMessage)
             .join('\n   -> linking to ')}`;
     }
-    // If there's a broken link appearing very often, it is probably a broken link on the layout!
-    // Add an additional message in such case to help user figure this out.
-    // see https://github.com/facebook/docusaurus/issues/3567#issuecomment-706973805
+    /**
+     * If there's a broken link appearing very often, it is probably a broken link
+     * on the layout. Add an additional message in such case to help user figure
+     * this out. See https://github.com/facebook/docusaurus/issues/3567#issuecomment-706973805
+     */
     function getLayoutBrokenLinksHelpMessage() {
         const flatList = Object.entries(allBrokenLinks).flatMap(([pagePage, brokenLinks]) => brokenLinks.map((brokenLink) => ({ pagePage, brokenLink })));
-        const countedBrokenLinks = (0, lodash_1.countBy)(flatList, (item) => item.brokenLink.link);
+        const countedBrokenLinks = lodash_1.default.countBy(flatList, (item) => item.brokenLink.link);
         const FrequencyThreshold = 5; // Is this a good value?
         const frequentLinks = Object.entries(countedBrokenLinks)
             .filter(([, count]) => count >= FrequencyThreshold)
@@ -89,19 +94,18 @@ function getBrokenLinksErrorMessage(allBrokenLinks) {
 `);
 }
 exports.getBrokenLinksErrorMessage = getBrokenLinksErrorMessage;
-function isExistingFile(filePath) {
+async function isExistingFile(filePath) {
     try {
-        return fs_extra_1.default.statSync(filePath).isFile();
+        return (await fs_extra_1.default.stat(filePath)).isFile();
     }
-    catch (e) {
+    catch {
         return false;
     }
 }
 // If a file actually exist on the file system, we know the link is valid
 // even if docusaurus does not know about this file, so we don't report it
 async function filterExistingFileLinks({ baseUrl, outDir, allCollectedLinks, }) {
-    // not easy to make this async :'(
-    function linkFileExists(link) {
+    async function linkFileExists(link) {
         // /baseUrl/javadoc/ -> /outDir/javadoc
         const baseFilePath = (0, utils_1.removeSuffix)(`${outDir}/${(0, utils_1.removePrefix)(link, baseUrl)}`, '/');
         // -> /outDir/javadoc
@@ -112,17 +116,23 @@ async function filterExistingFileLinks({ baseUrl, outDir, allCollectedLinks, })
             filePathsToTry.push(`${baseFilePath}.html`);
             filePathsToTry.push(path_1.default.join(baseFilePath, 'index.html'));
         }
-        return filePathsToTry.some(isExistingFile);
+        for (const file of filePathsToTry) {
+            if (await isExistingFile(file)) {
+                return true;
+            }
+        }
+        return false;
     }
-    return (0, lodash_1.mapValues)(allCollectedLinks, (links) => links.filter((link) => !linkFileExists(link)));
+    return (0, combine_promises_1.default)(lodash_1.default.mapValues(allCollectedLinks, async (links) => (await Promise.all(links.map(async (link) => ((await linkFileExists(link)) ? '' : link)))).filter(Boolean)));
 }
 exports.filterExistingFileLinks = filterExistingFileLinks;
 async function handleBrokenLinks({ allCollectedLinks, onBrokenLinks, routes, baseUrl, outDir, }) {
     if (onBrokenLinks === 'ignore') {
         return;
     }
-    // If we link to a file like /myFile.zip, and the file actually exist for the file system
-    // it is not a broken link, it may simply be a link to an existing static file...
+    // If we link to a file like /myFile.zip, and the file actually exist for the
+    // file system. It is not a broken link, it may simply be a link to an
+    // existing static file...
     const allCollectedLinksFiltered = await filterExistingFileLinks({
         allCollectedLinks,
         baseUrl,

package/lib/server/config.js

@@ -11,7 +11,7 @@ const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
 const configValidation_1 = require("./configValidation");
 async function loadConfig(configPath) {
-    if (!fs_extra_1.default.existsSync(configPath)) {
+    if (!(await fs_extra_1.default.pathExists(configPath))) {
         throw new Error(`Config file at "${configPath}" not found.`);
     }
     const importedConfig = (0, import_fresh_1.default)(configPath);

package/lib/server/configValidation.d.ts

@@ -7,6 +7,6 @@
 import type { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
 import { Joi } from '@docusaurus/utils-validation';
 export declare const DEFAULT_I18N_CONFIG: I18nConfig;
-export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'baseUrlIssueBanner' | 'staticDirectories'>;
+export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'tagline' | 'baseUrlIssueBanner' | 'staticDirectories'>;
 export declare const ConfigSchema: Joi.ObjectSchema<any>;
 export declare function validateConfig(config: Partial<DocusaurusConfig>): DocusaurusConfig;

package/lib/server/configValidation.js

@@ -7,8 +7,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateConfig = exports.ConfigSchema = exports.DEFAULT_CONFIG = exports.DEFAULT_I18N_CONFIG = void 0;
-const tslib_1 = require("tslib");
-const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const DEFAULT_I18N_LOCALE = 'en';
@@ -29,18 +27,30 @@ exports.DEFAULT_CONFIG = {
     themeConfig: {},
     titleDelimiter: '|',
     noIndex: false,
+    tagline: '',
     baseUrlIssueBanner: true,
     staticDirectories: [utils_1.STATIC_DIR_NAME],
 };
-const PluginSchema = utils_validation_1.Joi.alternatives()
-    .try(utils_validation_1.Joi.function(), utils_validation_1.Joi.array().ordered(utils_validation_1.Joi.function().required(), utils_validation_1.Joi.object().required()), utils_validation_1.Joi.string(), utils_validation_1.Joi.array()
-    .ordered(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required())
-    .length(2), utils_validation_1.Joi.bool().equal(false))
-    // @ts-expect-error: bad lib def, doesn't recognize an array of reports
-    .error((errors) => {
-    errors.forEach((error) => {
-        error.message = ` => Bad Docusaurus plugin value as path [${error.path}].
-Example valid plugin config:
+function createPluginSchema(theme = false) {
+    return (utils_validation_1.Joi.alternatives()
+        .try(utils_validation_1.Joi.function(), utils_validation_1.Joi.array().ordered(utils_validation_1.Joi.function().required(), utils_validation_1.Joi.object().required()), utils_validation_1.Joi.string(), utils_validation_1.Joi.array()
+        .ordered(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required())
+        .length(2), utils_validation_1.Joi.bool().equal(false))
+        // @ts-expect-error: bad lib def, doesn't recognize an array of reports
+        .error((errors) => {
+        errors.forEach((error) => {
+            const validConfigExample = theme
+                ? `Example valid theme config:
+{
+  themes: [
+    ["@docusaurus/theme-classic",options],
+    "./myTheme",
+    ["./myTheme",{someOption: 42}],
+    function myTheme() { },
+    [function myTheme() { },options]
+  ],
+};`
+                : `Example valid plugin config:
 {
   plugins: [
     ["@docusaurus/plugin-content-docs",options],
@@ -49,12 +59,16 @@ Example valid plugin config:
     function myPlugin() { },
     [function myPlugin() { },options]
   ],
-};
+};`;
+            error.message = ` => Bad Docusaurus ${theme ? 'theme' : 'plugin'} value as path [${error.path}].
+${validConfigExample}
 `;
-    });
-    return errors;
-});
-const ThemeSchema = utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required()).length(2));
+        });
+        return errors;
+    }));
+}
+const PluginSchema = createPluginSchema(false);
+const ThemeSchema = createPluginSchema(true);
 const PresetSchema = utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required()).length(2));
 const LocaleConfigSchema = utils_validation_1.Joi.object({
     label: utils_validation_1.Joi.string(),
@@ -79,7 +93,7 @@ const SiteUrlSchema = utils_validation_1.URISchema.required().custom((value, hel
             });
         }
     }
-    catch (e) { }
+    catch { }
     return value;
 }, 'siteUrlCustomValidation');
 // TODO move to @docusaurus/utils-validation
@@ -128,7 +142,7 @@ exports.ConfigSchema = utils_validation_1.Joi.object({
         type: utils_validation_1.Joi.string(),
     }).unknown()),
     clientModules: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()),
-    tagline: utils_validation_1.Joi.string().allow(''),
+    tagline: utils_validation_1.Joi.string().allow('').default(exports.DEFAULT_CONFIG.tagline),
     titleDelimiter: utils_validation_1.Joi.string().default('|'),
     noIndex: utils_validation_1.Joi.bool().default(false),
     webpack: utils_validation_1.Joi.object({
@@ -146,11 +160,6 @@ function validateConfig(config) {
     });
     (0, utils_validation_1.printWarning)(warning);
     if (error) {
-        (0, utils_validation_1.logValidationBugReportHint)();
-        if (utils_validation_1.isValidationDisabledEscapeHatch) {
-            logger_1.default.error(error.message);
-            return config;
-        }
         const unknownFields = error.details.reduce((formattedError, err) => {
             if (err.type === 'object.unknown') {
                 return `${formattedError}"${err.path}",`;

package/lib/server/duplicateRoutes.js

@@ -16,10 +16,8 @@ function getAllDuplicateRoutes(pluginsRouteConfigs) {
         if (Object.prototype.hasOwnProperty.call(seenRoutes, route)) {
             return true;
         }
-        else {
-            seenRoutes[route] = true;
-            return false;
-        }
+        seenRoutes[route] = true;
+        return false;
     });
 }
 exports.getAllDuplicateRoutes = getAllDuplicateRoutes;

package/lib/server/html-tags/htmlTags.js

@@ -7,12 +7,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const lodash_1 = require("lodash");
 const html_tags_1 = (0, tslib_1.__importDefault)(require("html-tags"));
 const void_1 = (0, tslib_1.__importDefault)(require("html-tags/void"));
 const escape_html_1 = (0, tslib_1.__importDefault)(require("escape-html"));
 function assertIsHtmlTagObject(val) {
-    if (!(0, lodash_1.isPlainObject)(val)) {
+    if (typeof val !== 'object' || !val) {
         throw new Error(`"${val}" is not a valid HTML tag object.`);
     }
     if (typeof val.tagName !== 'string') {

package/lib/server/i18n.d.ts

@@ -6,7 +6,6 @@
  */
 import type { I18n, DocusaurusConfig, I18nLocaleConfig } from '@docusaurus/types';
 export declare function getDefaultLocaleConfig(locale: string): I18nLocaleConfig;
-export declare function shouldWarnAboutNodeVersion(version: number, locales: string[]): boolean;
 export declare function loadI18n(config: DocusaurusConfig, options?: {
     locale?: string;
 }): Promise<I18n>;

package/lib/server/i18n.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localizePath = exports.loadI18n = exports.shouldWarnAboutNodeVersion = exports.getDefaultLocaleConfig = void 0;
+exports.localizePath = exports.loadI18n = exports.getDefaultLocaleConfig = void 0;
 const tslib_1 = require("tslib");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const utils_1 = require("@docusaurus/utils");
@@ -24,12 +24,6 @@ function getDefaultLocaleConfig(locale) {
     };
 }
 exports.getDefaultLocaleConfig = getDefaultLocaleConfig;
-function shouldWarnAboutNodeVersion(version, locales) {
-    const isOnlyEnglish = locales.length === 1 && locales.includes('en');
-    const isOlderNodeVersion = version < 14;
-    return isOlderNodeVersion && !isOnlyEnglish;
-}
-exports.shouldWarnAboutNodeVersion = shouldWarnAboutNodeVersion;
 async function loadI18n(config, options = {}) {
     var _a;
     const { i18n: i18nConfig } = config;
@@ -57,26 +51,22 @@ Note: Docusaurus only support running one locale at a time.`;
 }
 exports.loadI18n = loadI18n;
 function localizePath({ pathType, path: originalPath, i18n, options = {}, }) {
-    const shouldLocalizePath = typeof options.localizePath === 'undefined'
-        ? // By default, we don't localize the path of defaultLocale
-            i18n.currentLocale !== i18n.defaultLocale
-        : options.localizePath;
-    if (shouldLocalizePath) {
-        // FS paths need special care, for Windows support
-        if (pathType === 'fs') {
-            return path_1.default.join(originalPath, path_1.default.sep, i18n.currentLocale, path_1.default.sep);
-        }
-        // Url paths
-        else if (pathType === 'url') {
-            return (0, utils_1.normalizeUrl)([originalPath, '/', i18n.currentLocale, '/']);
-        }
-        // should never happen
-        else {
-            throw new Error(`Unhandled path type "${pathType}".`);
-        }
-    }
-    else {
+    var _a;
+    const shouldLocalizePath = 
+    // By default, we don't localize the path of defaultLocale
+    (_a = options.localizePath) !== null && _a !== void 0 ? _a : i18n.currentLocale !== i18n.defaultLocale;
+    if (!shouldLocalizePath) {
         return originalPath;
     }
+    // FS paths need special care, for Windows support
+    if (pathType === 'fs') {
+        return path_1.default.join(originalPath, i18n.currentLocale);
+    }
+    // Url paths; add a trailing slash so it's a valid base URL
+    if (pathType === 'url') {
+        return (0, utils_1.normalizeUrl)([originalPath, i18n.currentLocale, '/']);
+    }
+    // should never happen
+    throw new Error(`Unhandled path type "${pathType}".`);
 }
 exports.localizePath = localizePath;

package/lib/server/index.d.ts

@@ -19,5 +19,5 @@ export declare function loadSiteConfig({ siteDir, customConfigFilePath, }: {
     siteConfigPath: string;
 }>;
 export declare function loadContext(siteDir: string, options?: LoadContextOptions): Promise<LoadContext>;
-export declare function loadPluginConfigs(context: LoadContext): PluginConfig[];
+export declare function loadPluginConfigs(context: LoadContext): Promise<PluginConfig[]>;
 export declare function load(siteDir: string, options?: LoadContextOptions): Promise<Props>;

package/lib/server/index.js

@@ -22,7 +22,7 @@ const versions_1 = require("./versions");
 const duplicateRoutes_1 = require("./duplicateRoutes");
 const i18n_1 = require("./i18n");
 const translations_1 = require("./translations/translations");
-const lodash_1 = require("lodash");
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
 const remark_admonitions_1 = (0, tslib_1.__importDefault)(require("remark-admonitions"));
 const module_1 = require("module");
 const moduleShorthand_1 = require("./moduleShorthand");
@@ -68,7 +68,7 @@ async function loadContext(siteDir, options = {}) {
         locale: i18n.currentLocale,
     }))) !== null && _a !== void 0 ? _a : {};
     // We only need key->message for code translations
-    const codeTranslations = (0, lodash_1.mapValues)(codeTranslationFileContent, (value) => value.message);
+    const codeTranslations = lodash_1.default.mapValues(codeTranslationFileContent, (value) => value.message);
     return {
         siteDir,
         generatedFilesDir,
@@ -82,8 +82,8 @@ async function loadContext(siteDir, options = {}) {
     };
 }
 exports.loadContext = loadContext;
-function loadPluginConfigs(context) {
-    let { plugins: presetPlugins, themes: presetThemes } = (0, presets_1.default)(context);
+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) {
@@ -150,10 +150,12 @@ function createBootstrapPlugin({ siteConfig, }) {
         },
     };
 }
-// 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 though, but good enough for now
+/**
+ * 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',
@@ -161,9 +163,9 @@ function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
         options: {},
         version: { type: 'synthetic' },
         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 :s
+            // 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() {
                 var _a;
                 const rules = (_a = config === null || config === void 0 ? void 0 : config.module) === null || _a === void 0 ? void 0 : _a.rules;
@@ -176,7 +178,7 @@ function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
                 module: {
                     rules: [
                         {
-                            test: /(\.mdx?)$/,
+                            test: /\.mdx?$/i,
                             exclude: getMDXFallbackExcludedPaths(),
                             use: [
                                 getJSLoader({ isServer }),
@@ -203,7 +205,7 @@ async function load(siteDir, options = {}) {
     const context = await loadContext(siteDir, options);
     const { generatedFilesDir, siteConfig, siteConfigPath, outDir, baseUrl, i18n, ssrTemplate, codeTranslations, } = context;
     // Plugins.
-    const pluginConfigs = loadPluginConfigs(context);
+    const pluginConfigs = await loadPluginConfigs(context);
     const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated } = await (0, plugins_1.loadPlugins)({ pluginConfigs, context });
     // Side-effect to replace the untranslated themeConfig by the translated one
     context.siteConfig.themeConfig = themeConfigTranslated;
@@ -250,8 +252,8 @@ ${Object.keys(registry)
     const genCodeTranslations = (0, utils_1.generate)(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslationsWithFallbacks, null, 2));
     // Version metadata.
     const siteMetadata = {
-        docusaurusVersion: (0, versions_1.getPackageJsonVersion)(path_1.default.join(__dirname, '../../package.json')),
-        siteVersion: (0, versions_1.getPackageJsonVersion)(path_1.default.join(siteDir, 'package.json')),
+        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

package/lib/server/loadSetup.d.ts

@@ -5,5 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { Props } from '@docusaurus/types';
-declare const loadSetup: (name: string) => Promise<Props>;
-export default loadSetup;
+export default function loadSetup(name: string): Promise<Props>;

package/lib/server/loadSetup.js

@@ -10,7 +10,7 @@ const tslib_1 = require("tslib");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const index_1 = require("./index");
 // Helper methods to setup dummy/fake projects.
-const loadSetup = async (name) => {
+async function loadSetup(name) {
     const fixtures = path_1.default.join(__dirname, '__tests__', '__fixtures__');
     const simpleSite = path_1.default.join(fixtures, 'simple-site');
     const customSite = path_1.default.join(fixtures, 'custom-site');
@@ -21,5 +21,5 @@ const loadSetup = async (name) => {
         default:
             return (0, index_1.load)(simpleSite);
     }
-};
+}
 exports.default = loadSetup;

package/lib/server/moduleShorthand.js

@@ -13,7 +13,7 @@ function getNamePatterns(moduleName, moduleType) {
         if (!moduleName.includes('/')) {
             return [`${moduleName}/docusaurus-${moduleType}`];
         }
-        const [scope, packageName] = moduleName.split(/\/(.*)/);
+        const [scope, packageName] = moduleName.split(/\/(?<rest>.*)/);
         return [
             `${scope}/${packageName}`,
             `${scope}/docusaurus-${moduleType}-${packageName}`,

package/lib/server/plugins/index.js

@@ -13,7 +13,7 @@ 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 = require("lodash");
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
 const translations_1 = require("../translations/translations");
 const applyRouteTrailingSlash_1 = (0, tslib_1.__importDefault)(require("./applyRouteTrailingSlash"));
 function sortConfig(routeConfigs, baseUrl = '/') {
@@ -57,9 +57,9 @@ async function loadPlugins({ pluginConfigs, context, }) {
         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.
+    // 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.
     const loadedPlugins = await Promise.all(plugins.map(async (plugin) => {
         const content = plugin.loadContent ? await plugin.loadContent() : null;
         return { ...plugin, content };
@@ -80,9 +80,9 @@ async function loadPlugins({ pluginConfigs, context, }) {
             translationFiles: localizedTranslationFiles,
         };
     }));
-    const allContent = (0, lodash_1.chain)(loadedPlugins)
+    const allContent = lodash_1.default.chain(loadedPlugins)
         .groupBy((item) => item.name)
-        .mapValues((nameItems) => (0, lodash_1.chain)(nameItems)
+        .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; })
         .mapValues((idItems) => idItems[0].content)
         .value())
@@ -134,9 +134,9 @@ async function loadPlugins({ pluginConfigs, context, }) {
         });
     }));
     // 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.
+    // 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;

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

@@ -4,7 +4,17 @@
  * 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, InitializedPlugin } from '@docusaurus/types';
+/// <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;