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

package/lib/server/brokenLinks.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleBrokenLinks = exports.filterExistingFileLinks = exports.getBrokenLinksErrorMessage = exports.getAllBrokenLinks = void 0;
 const tslib_1 = require("tslib");
 const react_router_config_1 = require("react-router-config");
-const resolve_pathname_1 = (0, tslib_1.__importDefault)(require("resolve-pathname"));
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const lodash_1 = require("lodash");
 const utils_1 = require("@docusaurus/utils");
@@ -29,7 +28,7 @@ function getPageBrokenLinks({ pagePath, pageLinks, routes, }) {
     // we must resolve the links before using matchRoutes
     // resolvePathname is used internally by ReactRouter
     function resolveLink(link) {
-        const resolvedLink = (0, resolve_pathname_1.default)(onlyPathname(link), pagePath);
+        const resolvedLink = (0, utils_1.resolvePathname)(onlyPathname(link), pagePath);
         return { link, resolvedLink };
     }
     function isBrokenLink(link) {

package/lib/server/client-modules/index.d.ts

@@ -4,5 +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 } from '@docusaurus/types';
+import type { Plugin } from '@docusaurus/types';
 export default function loadClientModules(plugins: Plugin<unknown>[]): string[];

package/lib/server/config.d.ts

@@ -4,5 +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 { DocusaurusConfig } from '@docusaurus/types';
-export default function loadConfig(configPath: string): DocusaurusConfig;
+import type { DocusaurusConfig } from '@docusaurus/types';
+export default function loadConfig(configPath: string): Promise<DocusaurusConfig>;

package/lib/server/config.js

@@ -10,11 +10,14 @@ const tslib_1 = require("tslib");
 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");
-function loadConfig(configPath) {
+async function loadConfig(configPath) {
     if (!fs_extra_1.default.existsSync(configPath)) {
         throw new Error(`Config file at "${configPath}" not found.`);
     }
-    const loadedConfig = (0, import_fresh_1.default)(configPath);
+    const importedConfig = (0, import_fresh_1.default)(configPath);
+    const loadedConfig = importedConfig instanceof Function
+        ? await importedConfig()
+        : await importedConfig;
     return (0, configValidation_1.validateConfig)(loadedConfig);
 }
 exports.default = loadConfig;

package/lib/server/configValidation.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
+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'>;

package/lib/server/configValidation.js

@@ -7,6 +7,8 @@
  */
 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';
@@ -34,9 +36,7 @@ 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))
-    // TODO isn't there a simpler way to customize the default Joi error message???
-    // Not sure why Joi makes it complicated to add a custom error message...
-    // See https://stackoverflow.com/a/54657686/82609
+    // @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}].
@@ -58,6 +58,7 @@ const ThemeSchema = utils_validation_1.Joi.alternatives().try(utils_validation_1
 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(),
+    htmlLang: utils_validation_1.Joi.string(),
     direction: utils_validation_1.Joi.string().equal('ltr', 'rtl').default('ltr'),
 });
 const I18N_CONFIG_SCHEMA = utils_validation_1.Joi.object({
@@ -147,7 +148,7 @@ function validateConfig(config) {
     if (error) {
         (0, utils_validation_1.logValidationBugReportHint)();
         if (utils_validation_1.isValidationDisabledEscapeHatch) {
-            console.error(error);
+            logger_1.default.error(error.message);
             return config;
         }
         const unknownFields = error.details.reduce((formattedError, err) => {

package/lib/server/duplicateRoutes.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ReportingSeverity, RouteConfig } from '@docusaurus/types';
+import type { ReportingSeverity, RouteConfig } from '@docusaurus/types';
 export declare function getAllDuplicateRoutes(pluginsRouteConfigs: RouteConfig[]): string[];
 export declare function getDuplicateRoutesMessage(allDuplicateRoutes: string[]): string;
 export declare function handleDuplicateRoutes(pluginsRouteConfigs: RouteConfig[], onDuplicateRoutes: ReportingSeverity): void;

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

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

package/lib/server/i18n.d.ts

@@ -4,7 +4,7 @@
  * 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?: {

package/lib/server/i18n.js

@@ -11,21 +11,16 @@ const tslib_1 = require("tslib");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const utils_1 = require("@docusaurus/utils");
 const rtl_detect_1 = require("rtl-detect");
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 function getDefaultLocaleLabel(locale) {
-    // Intl.DisplayNames is ES2021 - Node14+
-    // https://v8.dev/features/intl-displaynames
-    if (typeof Intl.DisplayNames !== 'undefined') {
-        const languageName = new Intl.DisplayNames(locale, { type: 'language' }).of(locale);
-        return (languageName.charAt(0).toLocaleUpperCase(locale) +
-            languageName.substring(1));
-    }
-    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: (0, rtl_detect_1.getLangDir)(locale),
+        htmlLang: locale,
     };
 }
 exports.getDefaultLocaleConfig = getDefaultLocaleConfig;
@@ -40,15 +35,12 @@ async function loadI18n(config, options = {}) {
     const { i18n: i18nConfig } = config;
     const currentLocale = (_a = options.locale) !== null && _a !== void 0 ? _a : i18nConfig.defaultLocale;
     if (!i18nConfig.locales.includes(currentLocale)) {
-        console.warn(chalk_1.default.yellow(`The locale "${currentLocale}" was not found in your site configuration: Available locales are: ${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(utils_1.NODE_MAJOR_VERSION, locales)) {
-        console.warn(chalk_1.default.yellow(`To use Docusaurus i18n, it is strongly advised to use Node.js 14 or later (instead of ${utils_1.NODE_MAJOR_VERSION}).`));
-    }
     function getLocaleConfig(locale) {
         return {
             ...getDefaultLocaleConfig(locale),

package/lib/server/index.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
+import type { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
 export declare type LoadContextOptions = {
     customOutDir?: string;
     customConfigFilePath?: string;

package/lib/server/index.js

@@ -9,9 +9,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.load = exports.loadPluginConfigs = exports.loadContext = exports.loadSiteConfig = void 0;
 const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
-const path_1 = (0, tslib_1.__importStar)(require("path"));
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
-const ssr_html_template_1 = (0, tslib_1.__importDefault)(require("../client/templates/ssr.html.template"));
+const path_1 = (0, tslib_1.__importDefault)(require("path"));
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const ssr_html_template_1 = (0, tslib_1.__importDefault)(require("../webpack/templates/ssr.html.template"));
 const client_modules_1 = (0, tslib_1.__importDefault)(require("./client-modules"));
 const config_1 = (0, tslib_1.__importDefault)(require("./config"));
 const plugins_1 = require("./plugins");
@@ -77,7 +77,7 @@ async function loadContext(siteDir, options = {}) {
         outDir,
         baseUrl,
         i18n,
-        ssrTemplate,
+        ssrTemplate: ssrTemplate !== null && ssrTemplate !== void 0 ? ssrTemplate : ssr_html_template_1.default,
         codeTranslations,
     };
 }
@@ -150,7 +150,7 @@ function createBootstrapPlugin({ siteConfig, }) {
         },
     };
 }
-// Configurer Webpack fallback mdx loader for md/mdx files out of content-plugin folders
+// 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
@@ -208,9 +208,19 @@ async function load(siteDir, options = {}) {
     // 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, `export default ${JSON.stringify(siteConfig, null, 2)};`);
+    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({ siteConfig }));
     plugins.push(createMDXFallbackPlugin({ siteDir, siteConfig }));
     // Load client modules.
@@ -218,8 +228,7 @@ async function load(siteDir, options = {}) {
     const genClientModules = (0, utils_1.generate)(generatedFilesDir, 'client-modules.js', `export default [\n${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)}),`)
+        .map((module) => `  require('${(0, utils_1.escapePath)(module)}'),`)
         .join('\n')}\n];\n`);
     // Load extra head & body html tags.
     const { headTags, preBodyTags, postBodyTags } = (0, html_tags_1.loadHtmlTags)(plugins);
@@ -228,9 +237,7 @@ async function load(siteDir, options = {}) {
     const genRegistry = (0, 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)})],`)
+        .map((key) => `  '${key}': [${registry[key].loader}, '${(0, utils_1.escapePath)(registry[key].modulePath)}', require.resolveWeak('${(0, utils_1.escapePath)(registry[key].modulePath)}')],`)
         .join('\n')}};\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);
@@ -243,8 +250,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)((0, path_1.join)(__dirname, '../../package.json')),
-        siteVersion: (0, versions_1.getPackageJsonVersion)((0, path_1.join)(siteDir, 'package.json')),
+        docusaurusVersion: (0, versions_1.getPackageJsonVersion)(path_1.default.join(__dirname, '../../package.json')),
+        siteVersion: (0, versions_1.getPackageJsonVersion)(path_1.default.join(siteDir, 'package.json')),
         pluginVersions: {},
     };
     plugins
@@ -255,6 +262,7 @@ ${Object.keys(registry)
     checkDocusaurusPackagesVersion(siteMetadata);
     const genSiteMetadata = (0, utils_1.generate)(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
     await Promise.all([
+        genWarning,
         genClientModules,
         genSiteConfig,
         genRegistry,
@@ -280,7 +288,7 @@ ${Object.keys(registry)
         headTags,
         preBodyTags,
         postBodyTags,
-        ssrTemplate: ssrTemplate || ssr_html_template_1.default,
+        ssrTemplate,
         codeTranslations,
     };
     return props;
@@ -295,10 +303,13 @@ function checkDocusaurusPackagesVersion(siteMetadata) {
         var _a;
         if (versionInfo.type === 'package' &&
             ((_a = versionInfo.name) === null || _a === void 0 ? void 0 : _a.startsWith('@docusaurus/')) &&
+            versionInfo.version &&
             versionInfo.version !== docusaurusVersion) {
             // should we throw instead?
             // It still could work with different versions
-            console.warn(chalk_1.default.red(`Invalid ${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/loadSetup.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Props } from '@docusaurus/types';
+import type { Props } from '@docusaurus/types';
 declare const loadSetup: (name: string) => Promise<Props>;
 export default loadSetup;

package/lib/server/moduleShorthand.js

@@ -28,15 +28,19 @@ function getNamePatterns(moduleName, moduleType) {
 exports.getNamePatterns = getNamePatterns;
 function resolveModuleName(moduleName, moduleRequire, moduleType) {
     const modulePatterns = getNamePatterns(moduleName, moduleType);
-    // eslint-disable-next-line no-restricted-syntax
-    for (const module of modulePatterns) {
+    const module = modulePatterns.find((m) => {
         try {
-            moduleRequire.resolve(module);
-            return module;
+            moduleRequire.resolve(m);
+            return true;
         }
-        catch (e) { }
+        catch {
+            return false;
+        }
+    });
+    if (!module) {
+        throw new Error(`Docusaurus was unable to resolve the "${moduleName}" ${moduleType}. Make sure one of the following packages are installed:
+${modulePatterns.map((m) => `- ${m}`).join('\n')}`);
     }
-    throw new Error(`Docusaurus was unable to resolve the "${moduleName}" ${moduleType}. Make sure one of the following packages are installed:
-${modulePatterns.map((module) => `- ${module}`).join('\n')}`);
+    return module;
 }
 exports.resolveModuleName = resolveModuleName;

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

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { RouteConfig } from '@docusaurus/types';
-import { ApplyTrailingSlashParams } from '@docusaurus/utils-common';
+import type { RouteConfig } from '@docusaurus/types';
+import { type ApplyTrailingSlashParams } from '@docusaurus/utils-common';
 export default function applyRouteTrailingSlash(route: RouteConfig, params: ApplyTrailingSlashParams): RouteConfig;

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

@@ -4,7 +4,7 @@
  * 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, RouteConfig, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
+import type { LoadContext, PluginConfig, RouteConfig, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
 export declare function sortConfig(routeConfigs: RouteConfig[], baseUrl?: string): void;
 export declare function loadPlugins({ pluginConfigs, context, }: {
     pluginConfigs: PluginConfig[];

package/lib/server/plugins/index.js

@@ -12,7 +12,7 @@ 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 chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 const lodash_1 = require("lodash");
 const translations_1 = require("../translations/translations");
 const applyRouteTrailingSlash_1 = (0, tslib_1.__importDefault)(require("./applyRouteTrailingSlash"));
@@ -52,7 +52,7 @@ function sortConfig(routeConfigs, baseUrl = '/') {
 exports.sortConfig = sortConfig;
 async function loadPlugins({ pluginConfigs, context, }) {
     // 1. Plugin Lifecycle - Initialization/Constructor.
-    const plugins = (0, init_1.default)({
+    const plugins = await (0, init_1.default)({
         pluginConfigs,
         context,
     });
@@ -144,7 +144,7 @@ async function loadPlugins({ pluginConfigs, context, }) {
         // 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
-        console.error(chalk_1.default.red('Plugin routesLoaded lifecycle is deprecated. If you think we should keep this lifecycle, please report here: 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);
     }));
     // Sort the route config. This ensures that route with nested

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

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

package/lib/server/plugins/init.js

@@ -85,7 +85,7 @@ function getThemeValidationFunction(normalizedPluginConfig) {
         return normalizedPluginConfig.plugin.validateThemeConfig;
     }
 }
-function initPlugins({ pluginConfigs, context, }) {
+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.
     const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
@@ -130,11 +130,7 @@ function initPlugins({ pluginConfigs, context, }) {
             };
         }
     }
-    const plugins = pluginConfigs
-        .map((pluginConfig) => {
-        if (!pluginConfig) {
-            return null;
-        }
+    async function initializePlugin(pluginConfig) {
         const normalizedPluginConfig = normalizePluginConfig(pluginConfig, pluginRequire);
         const pluginVersion = doGetPluginVersion(normalizedPluginConfig);
         const pluginOptions = doValidatePluginOptions(normalizedPluginConfig);
@@ -143,14 +139,19 @@ function initPlugins({ pluginConfigs, context, }) {
             ...context.siteConfig.themeConfig,
             ...doValidateThemeConfig(normalizedPluginConfig),
         };
-        const pluginInstance = normalizedPluginConfig.plugin(context, pluginOptions);
+        const pluginInstance = await normalizedPluginConfig.plugin(context, pluginOptions);
         return {
             ...pluginInstance,
             options: pluginOptions,
             version: pluginVersion,
         };
-    })
-        .filter((item) => Boolean(item));
+    }
+    const plugins = (await Promise.all(pluginConfigs.map((pluginConfig) => {
+        if (!pluginConfig) {
+            return null;
+        }
+        return initializePlugin(pluginConfig);
+    }))).filter((item) => Boolean(item));
     (0, pluginIds_1.ensureUniquePluginInstanceIds)(plugins);
     return plugins;
 }

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

@@ -4,5 +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 { InitializedPlugin } from '@docusaurus/types';
+import type { InitializedPlugin } from '@docusaurus/types';
 export declare function ensureUniquePluginInstanceIds(plugins: InitializedPlugin[]): void;

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

@@ -4,7 +4,7 @@
  * 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 } from '@docusaurus/types';
+import type { LoadContext, PluginConfig } from '@docusaurus/types';
 export default function loadPresets(context: LoadContext): {
     plugins: PluginConfig[];
     themes: PluginConfig[];

package/lib/server/presets/index.js

@@ -14,7 +14,7 @@ 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.
     const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
-    const presets = (context.siteConfig || {}).presets || [];
+    const presets = context.siteConfig.presets || [];
     const unflatPlugins = [];
     const unflatThemes = [];
     presets.forEach((presetItem) => {

package/lib/server/routes.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ChunkRegistry, RouteConfig, ChunkNames } from '@docusaurus/types';
+import type { ChunkRegistry, RouteConfig, ChunkNames } from '@docusaurus/types';
 declare type LoadedRoutes = {
     registry: {
         [chunkName: string]: ChunkRegistry;

package/lib/server/routes.js

@@ -122,8 +122,7 @@ registry, value, prefix, name) {
     if (isModule(value)) {
         const modulePath = getModulePath(value);
         const chunkName = (0, utils_1.genChunkName)(modulePath, prefix, name);
-        // We need to JSON.stringify so that if its on windows, backslashes are escaped.
-        const loader = `() => import(/* webpackChunkName: '${chunkName}' */ ${JSON.stringify(modulePath)})`;
+        const loader = `() => import(/* webpackChunkName: '${chunkName}' */ '${(0, utils_1.escapePath)(modulePath)}')`;
         registry[chunkName] = {
             loader,
             modulePath,

package/lib/server/themes/alias.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ThemeAliases } from '@docusaurus/types';
+import type { ThemeAliases } from '@docusaurus/types';
 export declare function sortAliases(aliases: ThemeAliases): ThemeAliases;
 export default function themeAlias(themePath: string, addOriginalAlias: boolean): ThemeAliases;

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

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
+import type { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
 export declare function loadThemeAliases(themePaths: string[], userThemePaths: string[]): ThemeAliases;
 export declare function loadPluginsThemeAliases({ siteDir, plugins, }: {
     siteDir: string;

package/lib/server/translations/translations.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { TranslationFileContent, TranslationFile, TranslationMessage, InitializedPlugin } from '@docusaurus/types';
+import type { TranslationFileContent, TranslationFile, TranslationMessage, InitializedPlugin } from '@docusaurus/types';
 export declare type WriteTranslationsOptions = {
     override?: boolean;
     messagePrefix?: string;

package/lib/server/translations/translations.js

@@ -13,7 +13,7 @@ const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const lodash_1 = require("lodash");
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 const TranslationFileContentSchema = utils_validation_1.Joi.object()
     .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.object({
     message: utils_validation_1.Joi.string().allow('').required(),
@@ -70,9 +70,8 @@ async function writeTranslationFileContent({ filePath, content: newContent, opti
     // Warn about potential legacy keys
     const unknownKeys = (0, lodash_1.difference)(Object.keys(existingContent !== null && existingContent !== void 0 ? existingContent : {}), Object.keys(newContent));
     if (unknownKeys.length > 0) {
-        console.warn(chalk_1.default.yellow(`Some translation keys looks unknown to us in file ${filePath}
-Maybe you should remove them?
-- ${unknownKeys.join('\n- ')}`));
+        logger_1.default.warn `Some translation keys looks unknown to us in file path=${filePath}.
+Maybe you should remove them? ${unknownKeys}`;
     }
     const mergedContent = mergeTranslationFileContent({
         existingContent,
@@ -81,11 +80,9 @@ Maybe you should remove them?
     });
     // Avoid creating empty translation files
     if (Object.keys(mergedContent).length > 0) {
-        console.log(`${Object.keys(mergedContent)
-            .length.toString()
-            .padStart(3, ' ')} translations will be written at "${(0, utils_1.toMessageRelativeFilePath)(filePath)}".`);
+        logger_1.default.info `number=${Object.keys(mergedContent).length} translations will be written at path=${(0, utils_1.toMessageRelativeFilePath)(filePath)}.`;
         await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
-        await fs_extra_1.default.writeFile(filePath, JSON.stringify(mergedContent, null, 2));
+        await fs_extra_1.default.writeFile(filePath, `${JSON.stringify(mergedContent, null, 2)}\n`);
     }
 }
 exports.writeTranslationFileContent = writeTranslationFileContent;
@@ -178,10 +175,8 @@ exports.getPluginsDefaultCodeTranslationMessages = getPluginsDefaultCodeTranslat
 function applyDefaultCodeTranslations({ extractedCodeTranslations, defaultCodeMessages, }) {
     const unusedDefaultCodeMessages = (0, lodash_1.difference)(Object.keys(defaultCodeMessages), Object.keys(extractedCodeTranslations));
     if (unusedDefaultCodeMessages.length > 0) {
-        console.warn(chalk_1.default.yellow(`Unused default message codes found.
-Please report this Docusaurus issue.
-- ${unusedDefaultCodeMessages.join('\n- ')}
-`));
+        logger_1.default.warn `Unused default message codes found.
+Please report this Docusaurus issue. name=${unusedDefaultCodeMessages}`;
     }
     return (0, lodash_1.mapValues)(extractedCodeTranslations, (messageTranslation, messageId) => {
         var _a;

package/lib/server/translations/translationsExtractor.d.ts

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { TransformOptions } from '@babel/core';
-import { InitializedPlugin, TranslationFileContent, TranslationMessage } from '@docusaurus/types';
+import { type TransformOptions } from '@babel/core';
+import type { InitializedPlugin, TranslationFileContent, TranslationMessage } from '@docusaurus/types';
 export declare function globSourceCodeFilePaths(dirPaths: string[]): Promise<string[]>;
 export declare function extractSiteSourceCodeTranslations(siteDir: string, plugins: InitializedPlugin[], babelOptions: TransformOptions, extraSourceCodeFilePaths?: string[]): Promise<TranslationFileContent>;
 declare type SourceCodeFileTranslations = {