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

package/lib/server/plugins/init.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePluginConfigs = void 0;
 const tslib_1 = require("tslib");
 const module_1 = require("module");
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
@@ -13,7 +14,7 @@ const utils_1 = require("@docusaurus/utils");
 const versions_1 = require("../versions");
 const pluginIds_1 = require("./pluginIds");
 const utils_validation_1 = require("@docusaurus/utils-validation");
-function normalizePluginConfig(pluginConfig, pluginRequire) {
+async function normalizePluginConfig(pluginConfig, pluginRequire) {
     var _a, _b, _c, _d;
     // plugins: ['./plugin']
     if (typeof pluginConfig === 'string') {
@@ -65,15 +66,17 @@ function normalizePluginConfig(pluginConfig, pluginRequire) {
     }
     throw new Error(`Unexpected: can't load plugin for following plugin config.\n${JSON.stringify(pluginConfig)}`);
 }
+async function normalizePluginConfigs(pluginConfigs, pluginRequire) {
+    return Promise.all(pluginConfigs.map((pluginConfig) => normalizePluginConfig(pluginConfig, pluginRequire)));
+}
+exports.normalizePluginConfigs = normalizePluginConfigs;
 function getOptionValidationFunction(normalizedPluginConfig) {
     var _a, _b, _c, _d;
     if (normalizedPluginConfig.pluginModule) {
         // support both commonjs and ES modules
         return ((_c = (_b = (_a = normalizedPluginConfig.pluginModule.module) === null || _a === void 0 ? void 0 : _a.default) === null || _b === void 0 ? void 0 : _b.validateOptions) !== null && _c !== void 0 ? _c : (_d = normalizedPluginConfig.pluginModule.module) === null || _d === void 0 ? void 0 : _d.validateOptions);
     }
-    else {
-        return normalizedPluginConfig.plugin.validateOptions;
-    }
+    return normalizedPluginConfig.plugin.validateOptions;
 }
 function getThemeValidationFunction(normalizedPluginConfig) {
     var _a, _b;
@@ -81,24 +84,21 @@ function getThemeValidationFunction(normalizedPluginConfig) {
         // support both commonjs and ES modules
         return ((_b = (_a = normalizedPluginConfig.pluginModule.module.default) === null || _a === void 0 ? void 0 : _a.validateThemeConfig) !== null && _b !== void 0 ? _b : normalizedPluginConfig.pluginModule.module.validateThemeConfig);
     }
-    else {
-        return normalizedPluginConfig.plugin.validateThemeConfig;
-    }
+    return normalizedPluginConfig.plugin.validateThemeConfig;
 }
 async function initPlugins({ pluginConfigs, context, }) {
-    // We need to resolve plugins from the perspective of the siteDir, since the siteDir's package.json
-    // declares the dependency on these plugins.
+    // 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) {
+    const pluginConfigsNormalized = await normalizePluginConfigs(pluginConfigs, pluginRequire);
+    async function doGetPluginVersion(normalizedPluginConfig) {
         var _a, _b;
         // get plugin version
         if ((_a = normalizedPluginConfig.pluginModule) === null || _a === void 0 ? void 0 : _a.path) {
             const pluginPath = pluginRequire.resolve((_b = normalizedPluginConfig.pluginModule) === null || _b === void 0 ? void 0 : _b.path);
             return (0, versions_1.getPluginVersion)(pluginPath, context.siteDir);
         }
-        else {
-            return { type: 'local' };
-        }
+        return { type: 'local' };
     }
     function doValidateThemeConfig(normalizedPluginConfig) {
         const validateThemeConfig = getThemeValidationFunction(normalizedPluginConfig);
@@ -108,9 +108,7 @@ async function initPlugins({ pluginConfigs, context, }) {
                 themeConfig: context.siteConfig.themeConfig,
             });
         }
-        else {
-            return context.siteConfig.themeConfig;
-        }
+        return context.siteConfig.themeConfig;
     }
     function doValidatePluginOptions(normalizedPluginConfig) {
         var _a;
@@ -121,18 +119,15 @@ async function initPlugins({ pluginConfigs, context, }) {
                 options: normalizedPluginConfig.options,
             });
         }
-        else {
-            // Important to ensure all plugins have an id
-            // as we don't go through the Joi schema that adds it
-            return {
-                ...normalizedPluginConfig.options,
-                id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
-            };
-        }
+        // Important to ensure all plugins have an id
+        // as we don't go through the Joi schema that adds it
+        return {
+            ...normalizedPluginConfig.options,
+            id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
+        };
     }
-    async function initializePlugin(pluginConfig) {
-        const normalizedPluginConfig = normalizePluginConfig(pluginConfig, pluginRequire);
-        const pluginVersion = doGetPluginVersion(normalizedPluginConfig);
+    async function initializePlugin(normalizedPluginConfig) {
+        const pluginVersion = await doGetPluginVersion(normalizedPluginConfig);
         const pluginOptions = doValidatePluginOptions(normalizedPluginConfig);
         // Side-effect: merge the normalized theme config in the original one
         context.siteConfig.themeConfig = {
@@ -146,7 +141,7 @@ async function initPlugins({ pluginConfigs, context, }) {
             version: pluginVersion,
         };
     }
-    const plugins = (await Promise.all(pluginConfigs.map((pluginConfig) => {
+    const plugins = (await Promise.all(pluginConfigsNormalized.map((pluginConfig) => {
         if (!pluginConfig) {
             return null;
         }

package/lib/server/plugins/pluginIds.js

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

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

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { LoadContext, PluginConfig } from '@docusaurus/types';
-export default function loadPresets(context: LoadContext): {
+export default function loadPresets(context: LoadContext): Promise<{
     plugins: PluginConfig[];
     themes: PluginConfig[];
-};
+}>;

package/lib/server/presets/index.js

@@ -10,9 +10,9 @@ const tslib_1 = require("tslib");
 const module_1 = require("module");
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
 const moduleShorthand_1 = require("../moduleShorthand");
-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.
+async function loadPresets(context) {
+    // We need to resolve presets from the perspective of the siteDir, since the
+    // siteDir's package.json declares the dependency on these presets.
     const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
     const presets = context.siteConfig.presets || [];
     const unflatPlugins = [];

package/lib/server/routes.js

@@ -7,11 +7,10 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("@docusaurus/utils");
-const lodash_1 = require("lodash");
 const querystring_1 = require("querystring");
 function indent(str) {
     const spaces = '  ';
-    return `${spaces}${str.replace(/(\n)/g, `\n${spaces}`)}`;
+    return `${spaces}${str.replace(/\n/g, `\n${spaces}`)}`;
 }
 const createRouteCodeString = ({ routePath, routeHash, exact, subroutesCodeStrings, props, }) => {
     const parts = [
@@ -46,10 +45,15 @@ const RoutesImportsCode = [
     `import ComponentCreator from '@docusaurus/ComponentCreator';`,
 ].join('\n');
 function isModule(value) {
-    if ((0, lodash_1.isString)(value)) {
+    var _a, _b;
+    if (typeof value === 'string') {
         return true;
     }
-    if ((0, lodash_1.isPlainObject)(value) && (0, lodash_1.has)(value, '__import') && (0, lodash_1.has)(value, 'path')) {
+    if (typeof value === 'object' &&
+        (
+        // eslint-disable-next-line no-underscore-dangle
+        (_a = value) === null || _a === void 0 ? void 0 : _a.__import) &&
+        ((_b = value) === null || _b === void 0 ? void 0 : _b.path)) {
         return true;
     }
     return false;
@@ -68,12 +72,14 @@ async function loadRoutes(pluginsRouteConfigs, baseUrl) {
     // This is the higher level overview of route code generation.
     function generateRouteCode(routeConfig) {
         const { path: routePath, component, modules = {}, routes: subroutes, exact, priority, ...props } = routeConfig;
-        if (!(0, lodash_1.isString)(routePath) || !component) {
-            throw new Error(`Invalid route config: path must be a string and component is required.\n${JSON.stringify(routeConfig)}`);
+        if (typeof routePath !== 'string' || !component) {
+            throw new Error(`Invalid route config: path must be a string and component is required.
+${JSON.stringify(routeConfig)}`);
         }
         // Collect all page paths for injecting it later in the plugin lifecycle
         // This is useful for plugins like sitemaps, redirects etc...
-        // If a route has subroutes, it is not necessarily a valid page path (more likely to be a wrapper)
+        // If a route has subroutes, it is not necessarily a valid page path (more
+        // likely to be a wrapper)
         if (!subroutes) {
             routesPaths.push(routePath);
         }

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

@@ -11,25 +11,24 @@ 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"));
 const utils_1 = require("@docusaurus/utils");
-const lodash_1 = require("lodash");
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
 // Order of Webpack aliases is important because one alias can shadow another
 // This ensure @theme/NavbarItem alias is after @theme/NavbarItem/LocaleDropdown
 // See https://github.com/facebook/docusaurus/pull/3922
 // See https://github.com/facebook/docusaurus/issues/5382
 function sortAliases(aliases) {
     // Alphabetical order by default
-    const entries = (0, lodash_1.sortBy)(Object.entries(aliases), ([alias]) => alias);
+    const entries = lodash_1.default.sortBy(Object.entries(aliases), ([alias]) => alias);
     // @theme/NavbarItem should be after @theme/NavbarItem/LocaleDropdown
     entries.sort(([alias1], [alias2]) => alias1.includes(`${alias2}/`) ? -1 : 0);
     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,13 +12,14 @@ 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 that provided this component
+            // 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
+            // that provided this component
             if (aliasKey in aliases) {
                 const componentName = aliasKey.substring(aliasKey.indexOf('/') + 1);
                 const initAlias = `@theme-init/${componentName}`;
@@ -28,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/translations/translations.js

@@ -10,7 +10,7 @@ exports.applyDefaultCodeTranslations = exports.getPluginsDefaultCodeTranslationM
 const tslib_1 = require("tslib");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
-const lodash_1 = require("lodash");
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
 const utils_validation_1 = require("@docusaurus/utils-validation");
 const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
@@ -35,8 +35,9 @@ async function readTranslationFileContent(filePath) {
             ensureTranslationFileContent(content);
             return content;
         }
-        catch (e) {
-            throw new Error(`Invalid translation file at ${filePath}.\n${e.message}`);
+        catch (err) {
+            logger_1.default.error `Invalid translation file at path=${filePath}.`;
+            throw err;
         }
     }
     return undefined;
@@ -44,7 +45,7 @@ async function readTranslationFileContent(filePath) {
 exports.readTranslationFileContent = readTranslationFileContent;
 function mergeTranslationFileContent({ existingContent = {}, newContent, options, }) {
     // Apply messagePrefix to all messages
-    const newContentTransformed = (0, lodash_1.mapValues)(newContent, (value) => {
+    const newContentTransformed = lodash_1.default.mapValues(newContent, (value) => {
         var _a;
         return ({
             ...value,
@@ -56,7 +57,7 @@ function mergeTranslationFileContent({ existingContent = {}, newContent, options
     Object.entries(newContentTransformed).forEach(([key, { message, description }]) => {
         var _a, _b;
         result[key] = {
-            // If the messages already exist, we don't override them (unless requested)
+            // If messages already exist, we don't override them (unless requested)
             message: options.override
                 ? message
                 : (_b = (_a = existingContent[key]) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : message,
@@ -68,7 +69,7 @@ function mergeTranslationFileContent({ existingContent = {}, newContent, options
 async function writeTranslationFileContent({ filePath, content: newContent, options = {}, }) {
     const existingContent = await readTranslationFileContent(filePath);
     // Warn about potential legacy keys
-    const unknownKeys = (0, lodash_1.difference)(Object.keys(existingContent !== null && existingContent !== void 0 ? existingContent : {}), Object.keys(newContent));
+    const unknownKeys = lodash_1.default.difference(Object.keys(existingContent !== null && existingContent !== void 0 ? existingContent : {}), Object.keys(newContent));
     if (unknownKeys.length > 0) {
         logger_1.default.warn `Some translation keys looks unknown to us in file path=${filePath}.
 Maybe you should remove them? ${unknownKeys}`;
@@ -162,9 +163,7 @@ async function localizePluginTranslationFile({ siteDir, plugin, locale, translat
             },
         };
     }
-    else {
-        return translationFile;
-    }
+    return translationFile;
 }
 exports.localizePluginTranslationFile = localizePluginTranslationFile;
 async function getPluginsDefaultCodeTranslationMessages(plugins) {
@@ -173,12 +172,12 @@ async function getPluginsDefaultCodeTranslationMessages(plugins) {
 }
 exports.getPluginsDefaultCodeTranslationMessages = getPluginsDefaultCodeTranslationMessages;
 function applyDefaultCodeTranslations({ extractedCodeTranslations, defaultCodeMessages, }) {
-    const unusedDefaultCodeMessages = (0, lodash_1.difference)(Object.keys(defaultCodeMessages), Object.keys(extractedCodeTranslations));
+    const unusedDefaultCodeMessages = lodash_1.default.difference(Object.keys(defaultCodeMessages), Object.keys(extractedCodeTranslations));
     if (unusedDefaultCodeMessages.length > 0) {
         logger_1.default.warn `Unused default message codes found.
 Please report this Docusaurus issue. name=${unusedDefaultCodeMessages}`;
     }
-    return (0, lodash_1.mapValues)(extractedCodeTranslations, (messageTranslation, messageId) => {
+    return lodash_1.default.mapValues(extractedCodeTranslations, (messageTranslation, messageId) => {
         var _a;
         return ({
             ...messageTranslation,

package/lib/server/translations/translationsExtractor.js

@@ -36,8 +36,9 @@ function getSiteSourceCodeFilePaths(siteDir) {
 function getPluginSourceCodeFilePaths(plugin) {
     var _a, _b, _c;
     // The getPathsToWatch() generally returns the js/jsx/ts/tsx/md/mdx file paths
-    // We can use this method as well to know which folders we should try to extract translations from
-    // Hacky/implicit, but do we want to introduce a new lifecycle method just for that???
+    // We can use this method as well to know which folders we should try to
+    // extract translations from. Hacky/implicit, but do we want to introduce a
+    // new lifecycle method just for that???
     const codePaths = (_b = (_a = plugin.getPathsToWatch) === null || _a === void 0 ? void 0 : _a.call(plugin)) !== null && _b !== void 0 ? _b : [];
     // We also include theme code
     const themePath = (_c = plugin.getThemePath) === null || _c === void 0 ? void 0 : _c.call(plugin);
@@ -54,14 +55,16 @@ exports.globSourceCodeFilePaths = globSourceCodeFilePaths;
 async function getSourceCodeFilePaths(siteDir, plugins) {
     const sitePaths = getSiteSourceCodeFilePaths(siteDir);
     // The getPathsToWatch() generally returns the js/jsx/ts/tsx/md/mdx file paths
-    // We can use this method as well to know which folders we should try to extract translations from
-    // Hacky/implicit, but do we want to introduce a new lifecycle method for that???
+    // We can use this method as well to know which folders we should try to
+    // extract translations from. Hacky/implicit, but do we want to introduce a
+    // new lifecycle method for that???
     const pluginsPaths = plugins.flatMap(getPluginSourceCodeFilePaths);
     const allPaths = [...sitePaths, ...pluginsPaths];
     return globSourceCodeFilePaths(allPaths);
 }
 async function extractSiteSourceCodeTranslations(siteDir, plugins, babelOptions, extraSourceCodeFilePaths = []) {
-    // Should we warn here if the same translation "key" is found in multiple source code files?
+    // Should we warn here if the same translation "key" is found in multiple
+    // source code files?
     function toTranslationFileContent(sourceCodeFileTranslations) {
         return sourceCodeFileTranslations.reduce((acc, item) => ({ ...acc, ...item.translations }), {});
     }
@@ -92,18 +95,17 @@ async function extractSourceCodeFileTranslations(sourceCodeFilePath, babelOption
         const ast = (0, core_1.parse)(code, {
             ...babelOptions,
             ast: true,
-            // filename is important, because babel does not process the same files according to their js/ts extensions
-            // see  see https://twitter.com/NicoloRibaudo/status/1321130735605002243
+            // filename is important, because babel does not process the same files
+            // according to their js/ts extensions.
+            // See https://twitter.com/NicoloRibaudo/status/1321130735605002243
             filename: sourceCodeFilePath,
         });
         const translations = await extractSourceCodeAstTranslations(ast, sourceCodeFilePath);
         return translations;
     }
-    catch (e) {
-        if (e instanceof Error) {
-            e.message = `Error while attempting to extract Docusaurus translations from source code file at path=${sourceCodeFilePath}\n${e.message}`;
-        }
-        throw e;
+    catch (err) {
+        logger_1.default.error `Error while attempting to extract Docusaurus translations from source code file at path=${sourceCodeFilePath}.`;
+        throw err;
     }
 }
 exports.extractSourceCodeFileTranslations = extractSourceCodeFileTranslations;
@@ -169,12 +171,10 @@ Full code: ${(0, generator_1.default)(node).code}`;
                             typeof attributeValueEvaluated.value === 'string') {
                             return attributeValueEvaluated.value;
                         }
-                        else {
-                            warnings.push(`<Translate> prop=${propName} should be a statically evaluable object.
+                        warnings.push(`<Translate> prop=${propName} should be a statically evaluable object.
 Example: <Translate id="optional id" description="optional description">Message</Translate>
 Dynamically constructed values are not allowed, because they prevent translations to be extracted.
 ${sourceWarningPart(path.node)}`);
-                        }
                     }
                     return undefined;
                 }
@@ -191,7 +191,7 @@ ${sourceWarningPart(path.node)}`);
                     }
                     else {
                         translations[id] = {
-                            message: message !== null && message !== void 0 ? message : id,
+                            message: id,
                             ...(description && { description }),
                         };
                     }
@@ -199,8 +199,9 @@ ${sourceWarningPart(path.node)}`);
                 }
                 // Handle single non-empty content
                 const singleChildren = childrenPath
-                    // Remove empty/useless text nodes that might be around our translation!
-                    // Makes the translation system more reliable to JSX formatting issues
+                    // Remove empty/useless text nodes that might be around our
+                    // translation! Makes the translation system more reliable to JSX
+                    // formatting issues
                     .filter((children) => !(children.isJSXText() &&
                     children.node.value.replace('\n', '').trim() === ''))
                     .pop();
@@ -231,7 +232,7 @@ ${sourceWarningPart(path.node)}`);
                 const args = path.get('arguments');
                 if (args.length === 1 || args.length === 2) {
                     const firstArgPath = args[0];
-                    // evaluation allows translate("x" + "y"); to be considered as translate("xy");
+                    // translate("x" + "y"); => translate("xy");
                     const firstArgEvaluated = firstArgPath.evaluate();
                     if (firstArgEvaluated.confident &&
                         typeof firstArgEvaluated.value === 'object') {

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

@@ -5,6 +5,5 @@
  * 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 getPluginVersion(pluginPath: string, siteDir: string): Promise<DocusaurusPluginVersionInformation>;

package/lib/server/versions/index.js

@@ -6,45 +6,46 @@
  * LICENSE file in the root directory of this source tree.
  */
 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)) {
+exports.getPluginVersion = exports.getPackageJsonVersion = void 0;
+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;
+        return require(packageJsonPath).version;
     }
     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;
+        return require(packageJsonPath).name;
     }
     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.
+                // If the plugin belongs to the same docusaurus project, we classify it
+                // as local plugin.
                 return { type: 'project' };
             }
             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 rare cases where a plugin is a path where no parent directory contains package.json, we can only classify it as local.
+    // 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.
     return { type: 'local' };
 }
 exports.getPluginVersion = getPluginVersion;

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>;