@docusaurus/core 0.0.0-4609 → 0.0.0-4615

package/bin/beforeCli.mjs

@@ -36,7 +36,7 @@ const {
  *
  * cache data is stored in `~/.config/configstore/update-notifier-@docusaurus`
  */
-function beforeCli() {
+async function beforeCli() {
   const notifier = updateNotifier({
     pkg: {
       name,
@@ -98,7 +98,9 @@ function beforeCli() {
       .filter((p) => p.startsWith('@docusaurus'))
       .map((p) => p.concat('@latest'))
       .join(' ');
-    const isYarnUsed = fs.existsSync(path.resolve(process.cwd(), 'yarn.lock'));
+    const isYarnUsed = await fs.pathExists(
+      path.resolve(process.cwd(), 'yarn.lock'),
+    );
     const upgradeCommand = isYarnUsed
       ? `yarn upgrade ${siteDocusaurusPackagesForUpdate}`
       : `npm i ${siteDocusaurusPackagesForUpdate}`;

package/bin/docusaurus.mjs

@@ -9,7 +9,7 @@
 // @ts-check
 
 import logger from '@docusaurus/logger';
-import fs from 'fs';
+import fs from 'fs-extra';
 import cli from 'commander';
 import {createRequire} from 'module';
 import {
@@ -25,9 +25,9 @@ import {
 } from '../lib/index.js';
 import beforeCli from './beforeCli.mjs';
 
-beforeCli();
+await beforeCli();
 
-const resolveDir = (dir = '.') => fs.realpathSync(dir);
+const resolveDir = (dir = '.') => fs.realpath(dir);
 
 cli
   .version(createRequire(import.meta.url)('../package.json').version)
@@ -56,8 +56,8 @@ cli
     '--no-minify',
     'build website without minimizing JS bundles (default: false)',
   )
-  .action((siteDir, {bundleAnalyzer, config, outDir, locale, minify}) => {
-    build(resolveDir(siteDir), {
+  .action(async (siteDir, {bundleAnalyzer, config, outDir, locale, minify}) => {
+    build(await resolveDir(siteDir), {
       bundleAnalyzer,
       outDir,
       config,
@@ -74,8 +74,14 @@ cli
     'copy TypeScript theme files when possible (default: false)',
   )
   .option('--danger', 'enable swizzle for internal component of themes')
-  .action((themeName, componentName, siteDir, {typescript, danger}) => {
-    swizzle(resolveDir(siteDir), themeName, componentName, typescript, danger);
+  .action(async (themeName, componentName, siteDir, {typescript, danger}) => {
+    swizzle(
+      await resolveDir(siteDir),
+      themeName,
+      componentName,
+      typescript,
+      danger,
+    );
   });
 
 cli
@@ -97,8 +103,8 @@ cli
     '--skip-build',
     'skip building website before deploy it (default: false)',
   )
-  .action((siteDir, {outDir, skipBuild, config}) => {
-    deploy(resolveDir(siteDir), {
+  .action(async (siteDir, {outDir, skipBuild, config}) => {
+    deploy(await resolveDir(siteDir), {
       outDir,
       config,
       skipBuild,
@@ -124,17 +130,19 @@ cli
     '--poll [interval]',
     'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds',
   )
-  .action((siteDir, {port, host, locale, config, hotOnly, open, poll}) => {
-    start(resolveDir(siteDir), {
-      port,
-      host,
-      locale,
-      config,
-      hotOnly,
-      open,
-      poll,
-    });
-  });
+  .action(
+    async (siteDir, {port, host, locale, config, hotOnly, open, poll}) => {
+      start(await resolveDir(siteDir), {
+        port,
+        host,
+        locale,
+        config,
+        hotOnly,
+        open,
+        poll,
+      });
+    },
+  );
 
 cli
   .command('serve [siteDir]')
@@ -151,7 +159,7 @@ cli
   .option('--build', 'build website before serving (default: false)')
   .option('-h, --host <host>', 'use specified host (default: localhost)')
   .action(
-    (
+    async (
       siteDir,
       {
         dir = 'build',
@@ -161,7 +169,7 @@ cli
         config,
       },
     ) => {
-      serve(resolveDir(siteDir), {
+      serve(await resolveDir(siteDir), {
         dir,
         port,
         build: buildSite,
@@ -174,8 +182,8 @@ cli
 cli
   .command('clear [siteDir]')
   .description('Remove build artifacts.')
-  .action((siteDir) => {
-    clear(resolveDir(siteDir));
+  .action(async (siteDir) => {
+    clear(await resolveDir(siteDir));
   });
 
 cli
@@ -198,11 +206,11 @@ cli
     'allows to init new written messages with a given prefix. This might help you to highlight untranslated message to make them stand out in the UI',
   )
   .action(
-    (
+    async (
       siteDir,
       {locale = undefined, override = false, messagePrefix = '', config},
     ) => {
-      writeTranslations(resolveDir(siteDir), {
+      writeTranslations(await resolveDir(siteDir), {
         locale,
         override,
         config,
@@ -219,8 +227,8 @@ cli
     "keep the headings' casing, otherwise make all lowercase (default: false)",
   )
   .option('--overwrite', 'overwrite existing heading IDs (default: false)')
-  .action((siteDir, files, options) =>
-    writeHeadingIds(resolveDir(siteDir), files, options),
+  .action(async (siteDir, files, options) =>
+    writeHeadingIds(await resolveDir(siteDir), files, options),
   );
 
 cli.arguments('<command>').action((cmd) => {
@@ -246,7 +254,7 @@ function isInternalCommand(command) {
 
 async function run() {
   if (!isInternalCommand(process.argv.slice(2)[0])) {
-    await externalCommand(cli, resolveDir('.'));
+    await externalCommand(cli, await resolveDir('.'));
   }
 
   cli.parse(process.argv);

package/lib/client/exports/Head.d.ts

@@ -6,6 +6,6 @@
  */
 /// <reference types="@docusaurus/module-type-aliases" />
 /// <reference types="react" />
-import type { HeadProps } from '@docusaurus/Head';
-declare function Head(props: HeadProps): JSX.Element;
+import type { Props } from '@docusaurus/Head';
+declare function Head(props: Props): JSX.Element;
 export default Head;

package/lib/commands/build.js

@@ -75,6 +75,7 @@ forceTerminate = true) {
 }
 exports.default = build;
 async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLastLocale, }) {
+    var _a;
     process.env.BABEL_ENV = 'production';
     process.env.NODE_ENV = 'production';
     logger_1.default.info `name=${`[${locale}]`} Creating an optimized production build...`;
@@ -87,7 +88,7 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
     // Apply user webpack config.
     const { outDir, generatedFilesDir, plugins, siteConfig: { baseUrl, onBrokenLinks, staticDirectories }, routes, } = props;
     const clientManifestPath = path_1.default.join(generatedFilesDir, 'client-manifest.json');
-    let clientConfig = (0, webpack_merge_1.default)((0, client_1.default)(props, cliOptions.minify), {
+    let clientConfig = (0, webpack_merge_1.default)(await (0, client_1.default)(props, cliOptions.minify), {
         plugins: [
             // Remove/clean build folders before building bundles.
             new CleanWebpackPlugin_1.default({ verbose: false }),
@@ -101,22 +102,24 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         ].filter(Boolean),
     });
     const allCollectedLinks = {};
-    let serverConfig = (0, server_2.default)({
+    let serverConfig = await (0, server_2.default)({
         props,
         onLinksCollected: (staticPagePath, links) => {
             allCollectedLinks[staticPagePath] = links;
         },
     });
-    serverConfig = (0, webpack_merge_1.default)(serverConfig, {
-        plugins: [
-            new copy_webpack_plugin_1.default({
-                patterns: staticDirectories
-                    .map((dir) => path_1.default.resolve(siteDir, dir))
-                    .filter(fs_extra_1.default.existsSync)
-                    .map((dir) => ({ from: dir, to: outDir })),
-            }),
-        ],
-    });
+    if (staticDirectories.length > 0) {
+        await Promise.all(staticDirectories.map((dir) => fs_extra_1.default.ensureDir(dir)));
+        serverConfig = (0, webpack_merge_1.default)(serverConfig, {
+            plugins: [
+                new copy_webpack_plugin_1.default({
+                    patterns: staticDirectories
+                        .map((dir) => path_1.default.resolve(siteDir, dir))
+                        .map((dir) => ({ from: dir, to: outDir })),
+                }),
+            ],
+        });
+    }
     // Plugin Lifecycle - configureWebpack and configurePostCss.
     plugins.forEach((plugin) => {
         var _a, _b;
@@ -139,9 +142,7 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
     // Run webpack to build JS bundle (client) and static html files (server).
     await (0, utils_1.compile)([clientConfig, serverConfig]);
     // Remove server.bundle.js because it is not needed.
-    if (serverConfig.output &&
-        serverConfig.output.filename &&
-        typeof serverConfig.output.filename === 'string') {
+    if (typeof ((_a = serverConfig.output) === null || _a === void 0 ? void 0 : _a.filename) === 'string') {
         const serverBundle = path_1.default.join(outDir, serverConfig.output.filename);
         if (await fs_extra_1.default.pathExists(serverBundle)) {
             await fs_extra_1.default.unlink(serverBundle);

package/lib/commands/start.js

@@ -86,14 +86,14 @@ async function start(siteDir, cliOptions) {
             ? cliOptions.poll
             : undefined,
     };
-    const httpsConfig = (0, utils_2.getHttpsConfig)();
+    const httpsConfig = await (0, utils_2.getHttpsConfig)();
     const fsWatcher = chokidar_1.default.watch(pathsToWatch, {
         cwd: siteDir,
         ignoreInitial: true,
         ...{ pollingOptions },
     });
     ['add', 'change', 'unlink', 'addDir', 'unlinkDir'].forEach((event) => fsWatcher.on(event, reload));
-    let config = (0, webpack_merge_1.default)((0, client_1.default)(props), {
+    let config = (0, webpack_merge_1.default)(await (0, client_1.default)(props), {
         infrastructureLogging: {
             // Reduce log verbosity, see https://github.com/facebook/docusaurus/pull/5420#issuecomment-906613105
             level: 'warn',

package/lib/commands/swizzle.js

@@ -8,6 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPluginNames = void 0;
 const tslib_1 = require("tslib");
+/* eslint-disable no-restricted-properties */
 const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));

package/lib/commands/writeTranslations.js

@@ -65,7 +65,7 @@ Available locales are: ${context.i18n.locales.join(',')}.`);
     }
     const babelOptions = (0, utils_1.getBabelOptions)({
         isServer: true,
-        babelOptions: (0, utils_1.getCustomBabelConfigFilePath)(siteDir),
+        babelOptions: await (0, utils_1.getCustomBabelConfigFilePath)(siteDir),
     });
     const extractedCodeTranslations = await (0, translationsExtractor_1.extractSiteSourceCodeTranslations)(siteDir, plugins, babelOptions, await getExtraSourceCodeFilePaths());
     const defaultCodeMessages = await (0, translations_1.getPluginsDefaultCodeTranslationMessages)(plugins);

package/lib/server/brokenLinks.js

@@ -14,6 +14,7 @@ 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;
@@ -93,9 +94,9 @@ 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) {
         return false;
@@ -104,8 +105,7 @@ function isExistingFile(filePath) {
 // 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
@@ -116,9 +116,14 @@ 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 lodash_1.default.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, }) {

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/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,20 +51,20 @@ 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;
+    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, path_1.default.sep, i18n.currentLocale, path_1.default.sep);
+        return path_1.default.join(originalPath, i18n.currentLocale);
     }
-    // Url paths
+    // Url paths; add a trailing slash so it's a valid base URL
     if (pathType === 'url') {
-        return (0, utils_1.normalizeUrl)([originalPath, '/', i18n.currentLocale, '/']);
+        return (0, utils_1.normalizeUrl)([originalPath, i18n.currentLocale, '/']);
     }
     // should never happen
     throw new Error(`Unhandled path type "${pathType}".`);

package/lib/server/index.js

@@ -252,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/plugins/init.js

@@ -85,7 +85,7 @@ 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);
-    function doGetPluginVersion(normalizedPluginConfig) {
+    async function doGetPluginVersion(normalizedPluginConfig) {
         var _a, _b;
         // get plugin version
         if ((_a = normalizedPluginConfig.pluginModule) === null || _a === void 0 ? void 0 : _a.path) {
@@ -122,7 +122,7 @@ async function initPlugins({ pluginConfigs, context, }) {
     }
     async function initializePlugin(pluginConfig) {
         const normalizedPluginConfig = await normalizePluginConfig(pluginConfig, pluginRequire);
-        const pluginVersion = doGetPluginVersion(normalizedPluginConfig);
+        const pluginVersion = await doGetPluginVersion(normalizedPluginConfig);
         const pluginOptions = doValidatePluginOptions(normalizedPluginConfig);
         // Side-effect: merge the normalized theme config in the original one
         context.siteConfig.themeConfig = {

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

@@ -6,4 +6,4 @@
  */
 import type { ThemeAliases } from '@docusaurus/types';
 export declare function sortAliases(aliases: ThemeAliases): ThemeAliases;
-export default function themeAlias(themePath: string, addOriginalAlias: boolean): ThemeAliases;
+export default function themeAlias(themePath: string, addOriginalAlias: boolean): Promise<ThemeAliases>;

package/lib/server/themes/alias.js

@@ -24,12 +24,11 @@ function sortAliases(aliases) {
     return Object.fromEntries(entries);
 }
 exports.sortAliases = sortAliases;
-// TODO make async
-function themeAlias(themePath, addOriginalAlias) {
-    if (!fs_extra_1.default.pathExistsSync(themePath)) {
+async function themeAlias(themePath, addOriginalAlias) {
+    if (!(await fs_extra_1.default.pathExists(themePath))) {
         return {};
     }
-    const themeComponentFiles = utils_1.Globby.sync(['**/*.{js,jsx,ts,tsx}'], {
+    const themeComponentFiles = await (0, utils_1.Globby)(['**/*.{js,jsx,ts,tsx}'], {
         cwd: themePath,
     });
     const aliases = {};

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

@@ -5,8 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
-export declare function loadThemeAliases(themePaths: string[], userThemePaths: string[]): ThemeAliases;
+export declare function loadThemeAliases(themePaths: string[], userThemePaths: string[]): Promise<ThemeAliases>;
 export declare function loadPluginsThemeAliases({ siteDir, plugins, }: {
     siteDir: string;
     plugins: LoadedPlugin[];
-}): ThemeAliases;
+}): Promise<ThemeAliases>;

package/lib/server/themes/index.js

@@ -12,10 +12,10 @@ const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const utils_1 = require("@docusaurus/utils");
 const alias_1 = (0, tslib_1.__importStar)(require("./alias"));
 const ThemeFallbackDir = path_1.default.resolve(__dirname, '../../client/theme-fallback');
-function loadThemeAliases(themePaths, userThemePaths) {
+async function loadThemeAliases(themePaths, userThemePaths) {
     const aliases = {};
-    themePaths.forEach((themePath) => {
-        const themeAliases = (0, alias_1.default)(themePath, true);
+    for (const themePath of themePaths) {
+        const themeAliases = await (0, alias_1.default)(themePath, true);
         Object.keys(themeAliases).forEach((aliasKey) => {
             // If this alias shadows a previous one, use @theme-init to preserve the
             // initial one. @theme-init is only applied once: to the initial theme
@@ -29,11 +29,11 @@ function loadThemeAliases(themePaths, userThemePaths) {
             }
             aliases[aliasKey] = themeAliases[aliasKey];
         });
-    });
-    userThemePaths.forEach((themePath) => {
-        const userThemeAliases = (0, alias_1.default)(themePath, false);
+    }
+    for (const themePath of userThemePaths) {
+        const userThemeAliases = await (0, alias_1.default)(themePath, false);
         Object.assign(aliases, userThemeAliases);
-    });
+    }
     return (0, alias_1.sortAliases)(aliases);
 }
 exports.loadThemeAliases = loadThemeAliases;

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

@@ -5,6 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { DocusaurusPluginVersionInformation } from '@docusaurus/types';
-export declare function getPackageJsonVersion(packageJsonPath: string): string | undefined;
-export declare function getPackageJsonName(packageJsonPath: string): string | undefined;
-export declare function getPluginVersion(pluginPath: string, siteDir: string): DocusaurusPluginVersionInformation;
+export declare function getPackageJsonVersion(packageJsonPath: string): Promise<string | undefined>;
+export declare function getPackageJsonName(packageJsonPath: string): Promise<string | undefined>;
+export declare function getPluginVersion(pluginPath: string, siteDir: string): Promise<DocusaurusPluginVersionInformation>;

package/lib/server/versions/index.js

@@ -7,10 +7,11 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPluginVersion = exports.getPackageJsonName = exports.getPackageJsonVersion = void 0;
-const fs_extra_1 = require("fs-extra");
-const path_1 = require("path");
-function getPackageJsonVersion(packageJsonPath) {
-    if ((0, fs_extra_1.existsSync)(packageJsonPath)) {
+const tslib_1 = require("tslib");
+const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
+const path_1 = (0, tslib_1.__importDefault)(require("path"));
+async function getPackageJsonVersion(packageJsonPath) {
+    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
         // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
         const { version } = require(packageJsonPath);
         return typeof version === 'string' ? version : undefined;
@@ -18,8 +19,8 @@ function getPackageJsonVersion(packageJsonPath) {
     return undefined;
 }
 exports.getPackageJsonVersion = getPackageJsonVersion;
-function getPackageJsonName(packageJsonPath) {
-    if ((0, fs_extra_1.existsSync)(packageJsonPath)) {
+async function getPackageJsonName(packageJsonPath) {
+    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
         // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
         const { name } = require(packageJsonPath);
         return typeof name === 'string' ? name : undefined;
@@ -27,11 +28,12 @@ function getPackageJsonName(packageJsonPath) {
     return undefined;
 }
 exports.getPackageJsonName = getPackageJsonName;
-function getPluginVersion(pluginPath, siteDir) {
-    let potentialPluginPackageJsonDirectory = (0, path_1.dirname)(pluginPath);
+async function getPluginVersion(pluginPath, siteDir) {
+    let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
-        const packageJsonPath = (0, path_1.join)(potentialPluginPackageJsonDirectory, 'package.json');
-        if ((0, fs_extra_1.existsSync)(packageJsonPath) && (0, fs_extra_1.lstatSync)(packageJsonPath).isFile()) {
+        const packageJsonPath = path_1.default.join(potentialPluginPackageJsonDirectory, 'package.json');
+        if ((await fs_extra_1.default.pathExists(packageJsonPath)) &&
+            (await fs_extra_1.default.lstat(packageJsonPath)).isFile()) {
             if (potentialPluginPackageJsonDirectory === siteDir) {
                 // If the plugin belongs to the same docusaurus project, we classify it
                 // as local plugin.
@@ -39,11 +41,11 @@ function getPluginVersion(pluginPath, siteDir) {
             }
             return {
                 type: 'package',
-                name: getPackageJsonName(packageJsonPath),
-                version: getPackageJsonVersion(packageJsonPath),
+                name: await getPackageJsonName(packageJsonPath),
+                version: await getPackageJsonVersion(packageJsonPath),
             };
         }
-        potentialPluginPackageJsonDirectory = (0, path_1.dirname)(potentialPluginPackageJsonDirectory);
+        potentialPluginPackageJsonDirectory = path_1.default.dirname(potentialPluginPackageJsonDirectory);
     }
     // In the case where a plugin is a path where no parent directory contains
     // package.json (e.g. inline plugin), we can only classify it as local.

package/lib/webpack/base.d.ts

@@ -8,5 +8,5 @@ import type { Configuration } from 'webpack';
 import type { Props } from '@docusaurus/types';
 export declare const clientDir: string;
 export declare function excludeJS(modulePath: string): boolean;
-export declare function getDocusaurusAliases(): Record<string, string>;
-export declare function createBaseConfig(props: Props, isServer: boolean, minify?: boolean): Configuration;
+export declare function getDocusaurusAliases(): Promise<Record<string, string>>;
+export declare function createBaseConfig(props: Props, isServer: boolean, minify?: boolean): Promise<Configuration>;

package/lib/webpack/base.js

@@ -32,11 +32,11 @@ function excludeJS(modulePath) {
         !LibrariesToTranspileRegex.test(modulePath));
 }
 exports.excludeJS = excludeJS;
-function getDocusaurusAliases() {
+async function getDocusaurusAliases() {
     const dirPath = path_1.default.resolve(__dirname, '../client/exports');
     const extensions = ['.js', '.ts', '.tsx'];
     const aliases = {};
-    fs_extra_1.default.readdirSync(dirPath)
+    (await fs_extra_1.default.readdir(dirPath))
         .filter((fileName) => extensions.includes(path_1.default.extname(fileName)))
         .forEach((fileName) => {
         const fileNameWithoutExtension = path_1.default.basename(fileName, path_1.default.extname(fileName));
@@ -46,7 +46,7 @@ function getDocusaurusAliases() {
     return aliases;
 }
 exports.getDocusaurusAliases = getDocusaurusAliases;
-function createBaseConfig(props, isServer, minify = true) {
+async function createBaseConfig(props, isServer, minify = true) {
     var _a;
     const { outDir, siteDir, siteConfig, siteConfigPath, baseUrl, generatedFilesDir, routesPaths, siteMetadata, plugins, } = props;
     const totalPages = routesPaths.length;
@@ -56,7 +56,7 @@ function createBaseConfig(props, isServer, minify = true) {
     const fileLoaderUtils = (0, utils_2.getFileLoaderUtils)();
     const name = isServer ? 'server' : 'client';
     const mode = isProd ? 'production' : 'development';
-    const themeAliases = (0, themes_1.loadPluginsThemeAliases)({ siteDir, plugins });
+    const themeAliases = await (0, themes_1.loadPluginsThemeAliases)({ siteDir, plugins });
     return {
         mode,
         name,
@@ -120,7 +120,7 @@ function createBaseConfig(props, isServer, minify = true) {
                 // Note: a @docusaurus alias would also catch @docusaurus/theme-common,
                 // so we use fine-grained aliases instead
                 // '@docusaurus': path.resolve(__dirname, '../client/exports'),
-                ...getDocusaurusAliases(),
+                ...(await getDocusaurusAliases()),
                 ...themeAliases,
             },
             // This allows you to set a fallback for where Webpack should look for
@@ -131,7 +131,7 @@ function createBaseConfig(props, isServer, minify = true) {
             modules: [
                 path_1.default.resolve(__dirname, '..', '..', 'node_modules'),
                 'node_modules',
-                path_1.default.resolve(fs_extra_1.default.realpathSync(process.cwd()), 'node_modules'),
+                path_1.default.resolve(await fs_extra_1.default.realpath(process.cwd()), 'node_modules'),
             ],
         },
         resolveLoader: {
@@ -187,7 +187,7 @@ function createBaseConfig(props, isServer, minify = true) {
                     use: [
                         (0, utils_1.getCustomizableJSLoader)((_a = siteConfig.webpack) === null || _a === void 0 ? void 0 : _a.jsLoader)({
                             isServer,
-                            babelOptions: (0, utils_1.getCustomBabelConfigFilePath)(siteDir),
+                            babelOptions: await (0, utils_1.getCustomBabelConfigFilePath)(siteDir),
                         }),
                     ],
                 },

package/lib/webpack/client.d.ts

@@ -6,4 +6,4 @@
  */
 import type { Configuration } from 'webpack';
 import type { Props } from '@docusaurus/types';
-export default function createClientConfig(props: Props, minify?: boolean): Configuration;
+export default function createClientConfig(props: Props, minify?: boolean): Promise<Configuration>;

package/lib/webpack/client.js

@@ -13,10 +13,10 @@ const webpack_merge_1 = (0, tslib_1.__importDefault)(require("webpack-merge"));
 const base_1 = require("./base");
 const ChunkAssetPlugin_1 = (0, tslib_1.__importDefault)(require("./plugins/ChunkAssetPlugin"));
 const LogPlugin_1 = (0, tslib_1.__importDefault)(require("./plugins/LogPlugin"));
-function createClientConfig(props, minify = true) {
+async function createClientConfig(props, minify = true) {
     var _a;
     const isBuilding = process.argv[2] === 'build';
-    const config = (0, base_1.createBaseConfig)(props, false, minify);
+    const config = await (0, base_1.createBaseConfig)(props, false, minify);
     const clientConfig = (0, webpack_merge_1.default)(config, {
         // useless, disabled on purpose (errors on existing sites with no
         // browserslist config)

package/lib/webpack/server.d.ts

@@ -9,4 +9,4 @@ import type { Props } from '@docusaurus/types';
 export default function createServerConfig({ props, onLinksCollected, }: {
     props: Props;
     onLinksCollected?: (staticPagePath: string, links: string[]) => void;
-}): Configuration;
+}): Promise<Configuration>;

package/lib/webpack/server.js

@@ -15,9 +15,9 @@ const LogPlugin_1 = (0, tslib_1.__importDefault)(require("./plugins/LogPlugin"))
 const utils_1 = require("@docusaurus/utils");
 // Forked for Docusaurus: https://github.com/slorber/static-site-generator-webpack-plugin
 const static_site_generator_webpack_plugin_1 = (0, tslib_1.__importDefault)(require("@slorber/static-site-generator-webpack-plugin"));
-function createServerConfig({ props, onLinksCollected = () => { }, }) {
+async function createServerConfig({ props, onLinksCollected = () => { }, }) {
     const { baseUrl, routesPaths, generatedFilesDir, headTags, preBodyTags, postBodyTags, ssrTemplate, siteConfig: { noIndex, trailingSlash }, } = props;
-    const config = (0, base_1.createBaseConfig)(props, true);
+    const config = await (0, base_1.createBaseConfig)(props, true);
     const routesLocation = {};
     // Array of paths to be rendered. Relative to output directory
     const ssgPaths = routesPaths.map((str) => {

package/lib/webpack/utils.d.ts

@@ -11,7 +11,7 @@ import type { ConfigureWebpackFn, ConfigurePostCssFn } from '@docusaurus/types';
 export declare function getStyleLoaders(isServer: boolean, cssOptionsArg?: {
     [key: string]: unknown;
 }): RuleSetRule[];
-export declare function getCustomBabelConfigFilePath(siteDir: string): string | undefined;
+export declare function getCustomBabelConfigFilePath(siteDir: string): Promise<string | undefined>;
 export declare function getBabelOptions({ isServer, babelOptions, }?: {
     isServer?: boolean;
     babelOptions?: TransformOptions | string;
@@ -32,8 +32,8 @@ export declare const getCustomizableJSLoader: (jsLoader?: "babel" | ((isServer:
 export declare function applyConfigureWebpack(configureWebpack: ConfigureWebpackFn, config: Configuration, isServer: boolean, jsLoader: 'babel' | ((isServer: boolean) => RuleSetRule) | undefined, content: unknown): Configuration;
 export declare function applyConfigurePostCss(configurePostCss: NonNullable<ConfigurePostCssFn>, config: Configuration): Configuration;
 export declare function compile(config: Configuration[]): Promise<void>;
-export declare function getHttpsConfig(): boolean | {
+export declare function getHttpsConfig(): Promise<boolean | {
     cert: Buffer;
     key: Buffer;
-};
+}>;
 export declare function getMinimizer(useSimpleCssMinifier?: boolean): WebpackPluginInstance[];

package/lib/webpack/utils.js

@@ -80,9 +80,9 @@ function getStyleLoaders(isServer, cssOptionsArg = {}) {
     ];
 }
 exports.getStyleLoaders = getStyleLoaders;
-function getCustomBabelConfigFilePath(siteDir) {
+async function getCustomBabelConfigFilePath(siteDir) {
     const customBabelConfigurationPath = path_1.default.join(siteDir, utils_1.BABEL_CONFIG_FILE_NAME);
-    return fs_extra_1.default.existsSync(customBabelConfigurationPath)
+    return (await fs_extra_1.default.pathExists(customBabelConfigurationPath))
         ? customBabelConfigurationPath
         : undefined;
 }
@@ -247,24 +247,24 @@ ${err}`);
     }
 }
 // Read file and throw an error if it doesn't exist
-function readEnvFile(file, type) {
-    if (!fs_extra_1.default.existsSync(file)) {
+async function readEnvFile(file, type) {
+    if (!(await fs_extra_1.default.pathExists(file))) {
         throw new Error(`You specified ${type} in your env, but the file "${file}" can't be found.`);
     }
-    return fs_extra_1.default.readFileSync(file);
+    return fs_extra_1.default.readFile(file);
 }
-const appDirectory = fs_extra_1.default.realpathSync(process.cwd());
 // Get the https config
 // Return cert files if provided in env, otherwise just true or false
-function getHttpsConfig() {
+async function getHttpsConfig() {
+    const appDirectory = await fs_extra_1.default.realpath(process.cwd());
     const { SSL_CRT_FILE, SSL_KEY_FILE, HTTPS } = process.env;
     const isHttps = HTTPS === 'true';
     if (isHttps && SSL_CRT_FILE && SSL_KEY_FILE) {
         const crtFile = path_1.default.resolve(appDirectory, SSL_CRT_FILE);
         const keyFile = path_1.default.resolve(appDirectory, SSL_KEY_FILE);
         const config = {
-            cert: readEnvFile(crtFile, 'SSL_CRT_FILE'),
-            key: readEnvFile(keyFile, 'SSL_KEY_FILE'),
+            cert: await readEnvFile(crtFile, 'SSL_CRT_FILE'),
+            key: await readEnvFile(keyFile, 'SSL_KEY_FILE'),
         };
         validateKeyAndCerts({ ...config, keyFile, crtFile });
         return config;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-4609",
+  "version": "0.0.0-4615",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -41,13 +41,13 @@
     "@babel/runtime": "^7.17.2",
     "@babel/runtime-corejs3": "^7.17.2",
     "@babel/traverse": "^7.17.3",
-    "@docusaurus/cssnano-preset": "0.0.0-4609",
-    "@docusaurus/logger": "0.0.0-4609",
-    "@docusaurus/mdx-loader": "0.0.0-4609",
+    "@docusaurus/cssnano-preset": "0.0.0-4615",
+    "@docusaurus/logger": "0.0.0-4615",
+    "@docusaurus/mdx-loader": "0.0.0-4615",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-4609",
-    "@docusaurus/utils-common": "0.0.0-4609",
-    "@docusaurus/utils-validation": "0.0.0-4609",
+    "@docusaurus/utils": "0.0.0-4615",
+    "@docusaurus/utils-common": "0.0.0-4615",
+    "@docusaurus/utils-validation": "0.0.0-4615",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.1",
     "@svgr/webpack": "^6.2.1",
     "autoprefixer": "^10.4.2",
@@ -56,6 +56,7 @@
     "boxen": "^5.1.2",
     "chokidar": "^3.5.3",
     "clean-css": "^5.2.4",
+    "combine-promises": "^1.1.0",
     "commander": "^5.1.0",
     "copy-webpack-plugin": "^10.2.4",
     "core-js": "^3.21.1",
@@ -104,8 +105,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4609",
-    "@docusaurus/types": "0.0.0-4609",
+    "@docusaurus/module-type-aliases": "0.0.0-4615",
+    "@docusaurus/types": "0.0.0-4615",
     "@types/detect-port": "^1.3.2",
     "@types/nprogress": "^0.2.0",
     "@types/react-dom": "^17.0.11",
@@ -125,5 +126,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "398a24ae6b46221f1b07e23573affd1641861431"
+  "gitHead": "02bd619fc85e38d320177f4d96f39864109300c8"
 }