@docusaurus/core 2.0.0-beta.15d451942 → 2.0.0-beta.18

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

@@ -7,32 +7,31 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const lodash_1 = require("lodash");
 const html_tags_1 = tslib_1.__importDefault(require("html-tags"));
 const void_1 = tslib_1.__importDefault(require("html-tags/void"));
+const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
 function assertIsHtmlTagObject(val) {
-    if (!lodash_1.isPlainObject(val)) {
-        throw new Error(`"${val}" is not a valid HTML tag object`);
+    if (typeof val !== 'object' || !val) {
+        throw new Error(`"${val}" is not a valid HTML tag object.`);
     }
-    // @ts-expect-error: If tagName doesn't exist, it will throw.
     if (typeof val.tagName !== 'string') {
-        throw new Error(`${JSON.stringify(val)} is not a valid HTML tag object. "tagName" must be defined as a string`);
+        throw new Error(`${JSON.stringify(val)} is not a valid HTML tag object. "tagName" must be defined as a string.`);
     }
 }
 function htmlTagObjectToString(tagDefinition) {
     assertIsHtmlTagObject(tagDefinition);
     if (html_tags_1.default.indexOf(tagDefinition.tagName) === -1) {
-        throw new Error(`Error loading ${JSON.stringify(tagDefinition)}, "${tagDefinition.tagName}" is not a valid HTML tags`);
+        throw new Error(`Error loading ${JSON.stringify(tagDefinition)}, "${tagDefinition.tagName}" is not a valid HTML tags.`);
     }
     const isVoidTag = void_1.default.indexOf(tagDefinition.tagName) !== -1;
-    const tagAttributes = tagDefinition.attributes || {};
+    const tagAttributes = tagDefinition.attributes ?? {};
     const attributes = Object.keys(tagAttributes)
         .filter((attributeName) => tagAttributes[attributeName] !== false)
         .map((attributeName) => {
         if (tagAttributes[attributeName] === true) {
             return attributeName;
         }
-        return `${attributeName}="${tagAttributes[attributeName]}"`;
+        return `${attributeName}="${(0, escape_html_1.default)(tagAttributes[attributeName])}"`;
     });
     return `<${[tagDefinition.tagName].concat(attributes).join(' ')}>${(!isVoidTag && tagDefinition.innerHTML) || ''}${isVoidTag ? '' : `</${tagDefinition.tagName}>`}`;
 }

package/lib/server/html-tags/index.d.ts

@@ -4,6 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Plugin, InjectedHtmlTags, HtmlTags } from '@docusaurus/types';
-export declare function createHtmlTagsString(tags: HtmlTags): string;
-export declare function loadHtmlTags(plugins: Plugin<unknown>[]): InjectedHtmlTags;
+import type { InjectedHtmlTags, LoadedPlugin } from '@docusaurus/types';
+export declare function loadHtmlTags(plugins: LoadedPlugin[]): InjectedHtmlTags;

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

@@ -6,22 +6,21 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadHtmlTags = exports.createHtmlTagsString = void 0;
+exports.loadHtmlTags = void 0;
 const tslib_1 = require("tslib");
 const htmlTags_1 = tslib_1.__importDefault(require("./htmlTags"));
 function toString(val) {
-    return typeof val === 'string' ? val : htmlTags_1.default(val);
+    return typeof val === 'string' ? val : (0, htmlTags_1.default)(val);
 }
 function createHtmlTagsString(tags) {
     return Array.isArray(tags) ? tags.map(toString).join('\n') : toString(tags);
 }
-exports.createHtmlTagsString = createHtmlTagsString;
 function loadHtmlTags(plugins) {
     const htmlTags = plugins.reduce((acc, plugin) => {
         if (!plugin.injectHtmlTags) {
             return acc;
         }
-        const { headTags, preBodyTags, postBodyTags } = plugin.injectHtmlTags() || {};
+        const { headTags, preBodyTags, postBodyTags } = plugin.injectHtmlTags({ content: plugin.content }) ?? {};
         return {
             headTags: headTags
                 ? `${acc.headTags}\n${createHtmlTagsString(headTags)}`

package/lib/server/i18n.d.ts

@@ -4,10 +4,9 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { I18n, DocusaurusConfig, I18nLocaleConfig } from '@docusaurus/types';
+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?: {
+export declare function loadI18n(config: DocusaurusConfig, options: {
     locale?: string;
 }): Promise<I18n>;
 export declare function localizePath({ pathType, path: originalPath, i18n, options, }: {

package/lib/server/i18n.js

@@ -1,58 +1,46 @@
 "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.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 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
 const rtl_detect_1 = require("rtl-detect");
-const constants_1 = require("../constants");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 function getDefaultLocaleLabel(locale) {
-    // Intl.DisplayNames is ES2021 - Node14+
-    // https://v8.dev/features/intl-displaynames
-    // @ts-expect-error: wait for TS support of ES2021 feature
-    if (typeof Intl.DisplayNames !== 'undefined') {
-        // @ts-expect-error: wait for TS support of ES2021 feature
-        return new Intl.DisplayNames([locale], { type: 'language' }).of(locale);
-    }
-    return locale;
+    const languageName = new Intl.DisplayNames(locale, { type: 'language' }).of(locale);
+    return (languageName.charAt(0).toLocaleUpperCase(locale) + languageName.substring(1));
 }
 function getDefaultLocaleConfig(locale) {
     return {
         label: getDefaultLocaleLabel(locale),
-        direction: rtl_detect_1.getLangDir(locale),
+        direction: (0, rtl_detect_1.getLangDir)(locale),
+        htmlLang: 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;
+async function loadI18n(config, options) {
     const { i18n: i18nConfig } = config;
-    const currentLocale = (_a = options.locale) !== null && _a !== void 0 ? _a : i18nConfig.defaultLocale;
+    const currentLocale = options.locale ?? i18nConfig.defaultLocale;
     if (!i18nConfig.locales.includes(currentLocale)) {
-        console.warn(chalk_1.default.yellow(`The locale=${currentLocale} was not found in your site configuration: config.i18n.locales=[${i18nConfig.locales.join(',')}]
-Note: Docusaurus only support running one locale at a time.`));
+        logger_1.default.warn `The locale name=${currentLocale} was not found in your site configuration: Available locales are: ${i18nConfig.locales}
+Note: Docusaurus only support running one locale at a time.`;
     }
     const locales = i18nConfig.locales.includes(currentLocale)
         ? i18nConfig.locales
         : i18nConfig.locales.concat(currentLocale);
-    if (shouldWarnAboutNodeVersion(constants_1.NODE_MAJOR_VERSION, locales)) {
-        console.warn(chalk_1.default.yellow(`To use Docusaurus i18n, it is strongly advised to use NodeJS >= 14 (instead of ${constants_1.NODE_MAJOR_VERSION})`));
-    }
     function getLocaleConfig(locale) {
         return {
             ...getDefaultLocaleConfig(locale),
             ...i18nConfig.localeConfigs[locale],
         };
     }
-    const localeConfigs = locales.reduce((acc, locale) => {
-        return { ...acc, [locale]: getLocaleConfig(locale) };
-    }, {});
+    const localeConfigs = locales.reduce((acc, locale) => ({ ...acc, [locale]: getLocaleConfig(locale) }), {});
     return {
         defaultLocale: i18nConfig.defaultLocale,
         locales,
@@ -62,26 +50,17 @@ 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 utils_1.normalizeUrl([originalPath, '/', i18n.currentLocale, '/']);
-        }
-        // should never happen
-        else {
-            throw new Error(`unhandled pathType=${pathType}`);
-        }
-    }
-    else {
+    const shouldLocalizePath = 
+    // By default, we don't localize the path of defaultLocale
+    options.localizePath ?? 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
+    return (0, utils_1.normalizeUrl)([originalPath, i18n.currentLocale, '/']);
 }
 exports.localizePath = localizePath;

package/lib/server/index.d.ts

@@ -4,13 +4,20 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { LoadContext, PluginConfig, Props } from '@docusaurus/types';
+import type { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
 export declare type LoadContextOptions = {
     customOutDir?: string;
     customConfigFilePath?: string;
     locale?: string;
     localizePath?: boolean;
 };
+export declare function loadSiteConfig({ siteDir, customConfigFilePath, }: {
+    siteDir: string;
+    customConfigFilePath?: string;
+}): Promise<{
+    siteConfig: DocusaurusConfig;
+    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

@@ -6,60 +6,61 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.load = exports.loadPluginConfigs = exports.loadContext = void 0;
+exports.load = exports.loadPluginConfigs = exports.loadContext = exports.loadSiteConfig = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
-const path_1 = tslib_1.__importStar(require("path"));
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const ssr_html_template_1 = tslib_1.__importDefault(require("../client/templates/ssr.html.template"));
-const constants_1 = require("../constants");
+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 plugins_1 = require("./plugins");
 const presets_1 = tslib_1.__importDefault(require("./presets"));
 const routes_1 = tslib_1.__importDefault(require("./routes"));
-const themes_1 = tslib_1.__importDefault(require("./themes"));
 const html_tags_1 = require("./html-tags");
 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 = 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);
+    return { siteConfig, siteConfigPath };
+}
+exports.loadSiteConfig = loadSiteConfig;
 async function loadContext(siteDir, options = {}) {
-    var _a;
     const { customOutDir, locale, customConfigFilePath } = options;
-    const generatedFilesDir = path_1.default.isAbsolute(constants_1.GENERATED_FILES_DIR_NAME)
-        ? constants_1.GENERATED_FILES_DIR_NAME
-        : path_1.default.resolve(siteDir, constants_1.GENERATED_FILES_DIR_NAME);
-    const siteConfigPathUnresolved = customConfigFilePath !== null && customConfigFilePath !== void 0 ? customConfigFilePath : constants_1.DEFAULT_CONFIG_FILE_NAME;
-    const siteConfigPath = path_1.default.isAbsolute(siteConfigPathUnresolved)
-        ? siteConfigPathUnresolved
-        : path_1.default.resolve(siteDir, siteConfigPathUnresolved);
-    const initialSiteConfig = config_1.default(siteConfigPath);
+    const generatedFilesDir = path_1.default.resolve(siteDir, utils_1.GENERATED_FILES_DIR_NAME);
+    const { siteConfig: initialSiteConfig, siteConfigPath } = await loadSiteConfig({
+        siteDir,
+        customConfigFilePath,
+    });
     const { ssrTemplate } = initialSiteConfig;
-    const baseOutDir = customOutDir
-        ? path_1.default.resolve(customOutDir)
-        : path_1.default.resolve(siteDir, constants_1.DEFAULT_BUILD_DIR_NAME);
-    const i18n = await i18n_1.loadI18n(initialSiteConfig, { locale });
-    const baseUrl = i18n_1.localizePath({
+    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)({
         path: initialSiteConfig.baseUrl,
         i18n,
         options,
         pathType: 'url',
     });
-    const outDir = i18n_1.localizePath({
+    const outDir = (0, i18n_1.localizePath)({
         path: baseOutDir,
         i18n,
         options,
         pathType: 'fs',
     });
     const siteConfig = { ...initialSiteConfig, baseUrl };
-    const codeTranslationFileContent = (_a = (await translations_1.readCodeTranslationFileContent({
+    const codeTranslationFileContent = (await (0, translations_1.readCodeTranslationFileContent)({
         siteDir,
         locale: i18n.currentLocale,
-    }))) !== null && _a !== void 0 ? _a : {};
+    })) ?? {};
     // We only need key->message for code translations
-    const codeTranslations = lodash_1.mapValues(codeTranslationFileContent, (value) => value.message);
+    const codeTranslations = lodash_1.default.mapValues(codeTranslationFileContent, (value) => value.message);
     return {
         siteDir,
         generatedFilesDir,
@@ -68,62 +69,57 @@ async function loadContext(siteDir, options = {}) {
         outDir,
         baseUrl,
         i18n,
-        ssrTemplate,
+        ssrTemplate: ssrTemplate ?? ssr_html_template_1.default,
         codeTranslations,
     };
 }
 exports.loadContext = loadContext;
-function loadPluginConfigs(context) {
-    const { plugins: presetPlugins, themes: presetThemes } = presets_1.default(context);
-    const { siteConfig } = 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) {
+        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.
-        ...(siteConfig.plugins || []),
-        ...(siteConfig.themes || []),
+        ...standalonePlugins,
+        ...standaloneThemes,
     ];
 }
 exports.loadPluginConfigs = loadPluginConfigs;
-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 = loadPluginConfigs(context);
-    const { plugins, pluginsRouteConfigs, globalData, themeConfigTranslated, } = await plugins_1.loadPlugins({
-        pluginConfigs,
-        context,
-    });
-    // Side-effect to replace the untranslated themeConfig by the translated one
-    context.siteConfig.themeConfig = themeConfigTranslated;
-    duplicateRoutes_1.handleDuplicateRoutes(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
-    // Site config must be generated after plugins
-    // We want the generated config to have been normalized by the plugins!
-    const genSiteConfig = utils_1.generate(generatedFilesDir, constants_1.DEFAULT_CONFIG_FILE_NAME, `export default ${JSON.stringify(siteConfig, null, 2)};`);
-    // Themes.
-    const fallbackTheme = path_1.default.resolve(__dirname, '../client/theme-fallback');
-    const pluginThemes = plugins
-        .map((plugin) => plugin.getThemePath && plugin.getThemePath())
-        .filter((x) => Boolean(x));
-    const userTheme = path_1.default.resolve(siteDir, constants_1.THEME_PATH);
-    const alias = themes_1.default([fallbackTheme, ...pluginThemes], [userTheme]);
-    // Make a fake plugin to:
-    // - Resolve aliased theme components
-    // - Inject scripts/stylesheets
-    const { stylesheets = [], scripts = [], clientModules: siteConfigClientModules = [], } = siteConfig;
-    plugins.push({
+// 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',
-        options: {},
+        content: null,
+        options: {
+            id: 'default',
+        },
         version: { type: 'synthetic' },
+        path: siteDir,
         getClientModules() {
             return siteConfigClientModules;
         },
-        configureWebpack: () => ({
-            resolve: {
-                alias,
-            },
-        }),
         injectHtmlTags: () => {
             const stylesheetsTags = stylesheets.map((source) => typeof source === 'string'
                 ? `<link rel="stylesheet" href="${source}">`
@@ -135,11 +131,10 @@ async function load(siteDir, options = {}) {
                     },
                 });
             const scriptsTags = scripts.map((source) => typeof source === 'string'
-                ? `<script type="text/javascript" src="${source}"></script>`
+                ? `<script src="${source}"></script>`
                 : {
                     tagName: 'script',
                     attributes: {
-                        type: 'text/javascript',
                         ...source,
                     },
                 });
@@ -147,39 +142,120 @@ async function load(siteDir, options = {}) {
                 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 });
+    // Side-effect to replace the untranslated themeConfig by the translated one
+    context.siteConfig.themeConfig = themeConfigTranslated;
+    (0, duplicateRoutes_1.handleDuplicateRoutes)(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
+    const genWarning = (0, utils_1.generate)(generatedFilesDir, 'DONT-EDIT-THIS-FOLDER', `This folder stores temp files that Docusaurus' client bundler accesses.
+
+DO NOT hand-modify files in this folder because they will be overwritten in the
+next build. You can clear all build artifacts (including this folder) with the
+\`docusaurus clear\` command.
+`);
+    // Site config must be generated after plugins
+    // We want the generated config to have been normalized by the plugins!
+    const genSiteConfig = (0, utils_1.generate)(generatedFilesDir, utils_1.DEFAULT_CONFIG_FILE_NAME, `/*
+ * AUTOGENERATED - DON'T EDIT
+ * Your edits in this file will be overwritten in the next build!
+ * Modify the docusaurus.config.js file at your site's root instead.
+ */
+export default ${JSON.stringify(siteConfig, null, 2)};
+`);
+    plugins.push(createBootstrapPlugin({ siteDir, siteConfig }), createMDXFallbackPlugin({ siteDir, siteConfig }));
     // Load client modules.
-    const clientModules = client_modules_1.default(plugins);
-    const genClientModules = utils_1.generate(generatedFilesDir, 'client-modules.js', `export default [\n${clientModules
+    const clientModules = (0, client_modules_1.default)(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
         // CSS and the order matters for loading CSS.
-        // We need to JSON.stringify so that if its on windows, backslash are escaped.
-        .map((module) => `  require(${JSON.stringify(module)}),`)
-        .join('\n')}\n];\n`);
+        .map((module) => `  require('${(0, utils_1.escapePath)(module)}'),`)
+        .join('\n')}
+];
+`);
     // Load extra head & body html tags.
-    const { headTags, preBodyTags, postBodyTags } = html_tags_1.loadHtmlTags(plugins);
+    const { headTags, preBodyTags, postBodyTags } = (0, html_tags_1.loadHtmlTags)(plugins);
     // Routing.
-    const { registry, routesChunkNames, routesConfig, routesPaths, } = await routes_1.default(pluginsRouteConfigs, baseUrl);
-    const genRegistry = utils_1.generate(generatedFilesDir, 'registry.js', `export default {
-${Object.keys(registry)
-        .sort()
-        .map((key) => 
-    // We need to JSON.stringify so that if its on windows, backslash are escaped.
-    `  '${key}': [${registry[key].loader}, ${JSON.stringify(registry[key].modulePath)}, require.resolveWeak(${JSON.stringify(registry[key].modulePath)})],`)
-        .join('\n')}};\n`);
-    const genRoutesChunkNames = utils_1.generate(generatedFilesDir, 'routesChunkNames.json', JSON.stringify(routesChunkNames, null, 2));
-    const genRoutes = utils_1.generate(generatedFilesDir, 'routes.js', routesConfig);
-    const genGlobalData = utils_1.generate(generatedFilesDir, 'globalData.json', JSON.stringify(globalData, null, 2));
-    const genI18n = utils_1.generate(generatedFilesDir, 'i18n.json', JSON.stringify(i18n, null, 2));
+    const { registry, routesChunkNames, routesConfig, routesPaths } = await (0, routes_1.default)(pluginsRouteConfigs, baseUrl);
+    const genRegistry = (0, utils_1.generate)(generatedFilesDir, 'registry.js', `export default {
+${Object.entries(registry)
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([key, chunk]) => `  '${key}': [${chunk.loader}, '${(0, utils_1.escapePath)(chunk.modulePath)}', require.resolveWeak('${(0, utils_1.escapePath)(chunk.modulePath)}')],`)
+        .join('\n')}};
+`);
+    const genRoutesChunkNames = (0, utils_1.generate)(generatedFilesDir, 'routesChunkNames.json', JSON.stringify(routesChunkNames, null, 2));
+    const genRoutes = (0, utils_1.generate)(generatedFilesDir, 'routes.js', routesConfig);
+    const genGlobalData = (0, utils_1.generate)(generatedFilesDir, 'globalData.json', JSON.stringify(globalData, null, 2));
+    const genI18n = (0, utils_1.generate)(generatedFilesDir, 'i18n.json', JSON.stringify(i18n, null, 2));
     const codeTranslationsWithFallbacks = {
-        ...(await translations_1.getPluginsDefaultCodeTranslationMessages(plugins)),
+        ...(await (0, translations_1.getPluginsDefaultCodeTranslationMessages)(plugins)),
         ...codeTranslations,
     };
-    const genCodeTranslations = utils_1.generate(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslationsWithFallbacks, null, 2));
+    const genCodeTranslations = (0, utils_1.generate)(generatedFilesDir, 'codeTranslations.json', JSON.stringify(codeTranslationsWithFallbacks, null, 2));
     // Version metadata.
     const siteMetadata = {
-        docusaurusVersion: versions_1.getPackageJsonVersion(path_1.join(__dirname, '../../package.json')),
-        siteVersion: versions_1.getPackageJsonVersion(path_1.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
@@ -188,8 +264,9 @@ ${Object.keys(registry)
         siteMetadata.pluginVersions[name] = version;
     });
     checkDocusaurusPackagesVersion(siteMetadata);
-    const genSiteMetadata = utils_1.generate(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
+    const genSiteMetadata = (0, utils_1.generate)(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
     await Promise.all([
+        genWarning,
         genClientModules,
         genSiteConfig,
         genRegistry,
@@ -215,25 +292,27 @@ ${Object.keys(registry)
         headTags,
         preBodyTags,
         postBodyTags,
-        ssrTemplate: ssrTemplate || ssr_html_template_1.default,
+        ssrTemplate,
         codeTranslations,
     };
     return props;
 }
 exports.load = load;
-// We want all @docusaurus/* packages  to have the exact same version!
+// 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]) => {
-        var _a;
         if (versionInfo.type === 'package' &&
-            ((_a = versionInfo.name) === null || _a === void 0 ? void 0 : _a.startsWith('@docusaurus/')) &&
+            versionInfo.name?.startsWith('@docusaurus/') &&
+            versionInfo.version &&
             versionInfo.version !== docusaurusVersion) {
             // should we throw instead?
             // It still could work with different versions
-            console.warn(chalk_1.default.red(`Bad ${plugin} version ${versionInfo.version}.\nAll official @docusaurus/* packages should have the exact same version as @docusaurus/core (${docusaurusVersion}).\nMaybe you want to check, or regenerate your yarn.lock or package-lock.json file?`));
+            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/moduleShorthand.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+/// <reference types="node" />
+export declare function getNamePatterns(moduleName: string, moduleType: 'preset' | 'theme' | 'plugin'): string[];
+export declare function resolveModuleName(moduleName: string, moduleRequire: NodeRequire, moduleType: 'preset' | 'theme' | 'plugin'): string;