@docusaurus/core 2.0.0-beta.15a2b59f9 → 2.0.0-beta.17

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 (fs_extra_1.existsSync(packageJsonPath)) {
+exports.getPluginVersion = exports.getPackageJsonVersion = void 0;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = 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 (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 = path_1.dirname(pluginPath);
+async function getPluginVersion(pluginPath, siteDir) {
+    let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
-        const packageJsonPath = path_1.join(potentialPluginPackageJsonDirectory, 'package.json');
-        if (fs_extra_1.existsSync(packageJsonPath) && 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 = 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

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

@@ -12,12 +12,10 @@ const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const mini_css_extract_plugin_1 = tslib_1.__importDefault(require("mini-css-extract-plugin"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("./utils");
-const constants_1 = require("../constants");
-const sharedModuleAliases_1 = tslib_1.__importDefault(require("./sharedModuleAliases"));
 const themes_1 = require("../server/themes");
 const utils_2 = require("@docusaurus/utils");
-const CSS_REGEX = /\.css$/;
-const CSS_MODULE_REGEX = /\.module\.css$/;
+const CSS_REGEX = /\.css$/i;
+const CSS_MODULE_REGEX = /\.module\.css$/i;
 exports.clientDir = path_1.default.join(__dirname, '..', 'client');
 const LibrariesToTranspile = [
     'copy-text-to-clipboard', // contains optional catch binding, incompatible with recent versions of Edge
@@ -30,15 +28,15 @@ function excludeJS(modulePath) {
     }
     // Don't transpile node_modules except any docusaurus npm package
     return (/node_modules/.test(modulePath) &&
-        !/(docusaurus)((?!node_modules).)*\.jsx?$/.test(modulePath) &&
+        !/docusaurus(?:(?!node_modules).)*\.jsx?$/.test(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));
@@ -48,17 +46,16 @@ function getDocusaurusAliases() {
     return aliases;
 }
 exports.getDocusaurusAliases = getDocusaurusAliases;
-function createBaseConfig(props, isServer, minify = true) {
-    var _a;
+async function createBaseConfig(props, isServer, minify = true) {
     const { outDir, siteDir, siteConfig, siteConfigPath, baseUrl, generatedFilesDir, routesPaths, siteMetadata, plugins, } = props;
     const totalPages = routesPaths.length;
     const isProd = process.env.NODE_ENV === 'production';
     const minimizeEnabled = minify && isProd && !isServer;
     const useSimpleCssMinifier = process.env.USE_SIMPLE_CSS_MINIFIER === 'true';
-    const fileLoaderUtils = utils_1.getFileLoaderUtils();
+    const fileLoaderUtils = (0, utils_2.getFileLoaderUtils)();
     const name = isServer ? 'server' : 'client';
     const mode = isProd ? 'production' : 'development';
-    const themeAliases = themes_1.loadPluginsThemeAliases({ siteDir, plugins });
+    const themeAliases = await (0, themes_1.loadPluginsThemeAliases)({ siteDir, plugins });
     return {
         mode,
         name,
@@ -71,16 +68,19 @@ function createBaseConfig(props, isServer, minify = true) {
             // When version string changes, cache is evicted
             version: [
                 siteMetadata.docusaurusVersion,
-                // Webpack does not evict the cache correctly on alias/swizzle change, so we force eviction.
+                // Webpack does not evict the cache correctly on alias/swizzle change,
+                // so we force eviction.
                 // See https://github.com/webpack/webpack/issues/13627
-                utils_2.md5Hash(JSON.stringify(themeAliases)),
+                (0, utils_2.md5Hash)(JSON.stringify(themeAliases)),
             ].join('-'),
-            // When one of those modules/dependencies change (including transitive deps), cache is invalidated
+            // When one of those modules/dependencies change (including transitive
+            // deps), cache is invalidated
             buildDependencies: {
                 config: [
                     __filename,
                     path_1.default.join(__dirname, isServer ? 'server.js' : 'client.js'),
-                    // Docusaurus config changes can affect MDX/JSX compilation, so we'd rather evict the cache.
+                    // Docusaurus config changes can affect MDX/JSX compilation, so we'd
+                    // rather evict the cache.
                     // See https://github.com/questdb/questdb.io/issues/493
                     siteConfigPath,
                 ],
@@ -94,6 +94,7 @@ function createBaseConfig(props, isServer, minify = true) {
                 ? 'assets/js/[name].[contenthash:8].js'
                 : '[name].js',
             publicPath: baseUrl,
+            hashFunction: 'xxhash64',
         },
         // Don't throw warning when asset created is over 250kb
         performance: {
@@ -108,28 +109,28 @@ function createBaseConfig(props, isServer, minify = true) {
                 // Allow resolution of url("/fonts/xyz.ttf") by webpack
                 // See https://webpack.js.org/configuration/resolve/#resolveroots
                 // See https://github.com/webpack-contrib/css-loader/issues/1256
-                path_1.default.join(siteDir, constants_1.STATIC_DIR_NAME),
+                ...siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
                 siteDir,
                 process.cwd(),
             ],
             alias: {
-                ...sharedModuleAliases_1.default,
                 '@site': siteDir,
                 '@generated': generatedFilesDir,
                 // 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 modules.
-            // We want `@docusaurus/core` own dependencies/`node_modules` to "win" if there is conflict
-            // Example: if there is core-js@3 in user's own node_modules, but core depends on
-            // core-js@2, we should use core-js@2.
+            // This allows you to set a fallback for where Webpack should look for
+            // modules. We want `@docusaurus/core` own dependencies/`node_modules` to
+            // "win" if there is conflict. Example: if there is core-js@3 in user's
+            // own node_modules, but core depends on core-js@2, we should use
+            // core-js@2.
             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: {
@@ -137,15 +138,18 @@ function createBaseConfig(props, isServer, minify = true) {
         },
         optimization: {
             removeAvailableModules: false,
-            // Only minimize client bundle in production because server bundle is only used for static site generation
+            // Only minimize client bundle in production because server bundle is only
+            // used for static site generation
             minimize: minimizeEnabled,
             minimizer: minimizeEnabled
-                ? utils_1.getMinimizer(useSimpleCssMinifier)
+                ? (0, utils_1.getMinimizer)(useSimpleCssMinifier)
                 : undefined,
             splitChunks: isServer
                 ? false
                 : {
-                    // Since the chunk name includes all origin chunk names it's recommended for production builds with long term caching to NOT include [name] in the filenames
+                    // Since the chunk name includes all origin chunk names it's
+                    // recommended for production builds with long term caching to NOT
+                    // include [name] in the filenames
                     name: false,
                     cacheGroups: {
                         // disable the built-in cacheGroups
@@ -177,19 +181,19 @@ function createBaseConfig(props, isServer, minify = true) {
                 fileLoaderUtils.rules.svg(),
                 fileLoaderUtils.rules.otherAssets(),
                 {
-                    test: /\.(j|t)sx?$/,
+                    test: /\.[jt]sx?$/i,
                     exclude: excludeJS,
                     use: [
-                        utils_1.getCustomizableJSLoader((_a = siteConfig.webpack) === null || _a === void 0 ? void 0 : _a.jsLoader)({
+                        (0, utils_1.getCustomizableJSLoader)(siteConfig.webpack?.jsLoader)({
                             isServer,
-                            babelOptions: utils_1.getCustomBabelConfigFilePath(siteDir),
+                            babelOptions: await (0, utils_1.getCustomBabelConfigFilePath)(siteDir),
                         }),
                     ],
                 },
                 {
                     test: CSS_REGEX,
                     exclude: CSS_MODULE_REGEX,
-                    use: utils_1.getStyleLoaders(isServer, {
+                    use: (0, utils_1.getStyleLoaders)(isServer, {
                         importLoaders: 1,
                         sourceMap: !isProd,
                     }),
@@ -198,7 +202,7 @@ function createBaseConfig(props, isServer, minify = true) {
                 // using the extension .module.css
                 {
                     test: CSS_MODULE_REGEX,
-                    use: utils_1.getStyleLoaders(isServer, {
+                    use: (0, utils_1.getStyleLoaders)(isServer, {
                         modules: {
                             localIdentName: isProd
                                 ? `[local]_[contenthash:base64:4]`
@@ -219,8 +223,9 @@ function createBaseConfig(props, isServer, minify = true) {
                 chunkFilename: isProd
                     ? 'assets/css/[name].[contenthash:8].css'
                     : '[name].css',
-                // remove css order warnings if css imports are not sorted alphabetically
-                // see https://github.com/webpack-contrib/mini-css-extract-plugin/pull/422 for more reasoning
+                // remove css order warnings if css imports are not sorted
+                // alphabetically. See https://github.com/webpack-contrib/mini-css-extract-plugin/pull/422
+                // for more reasoning
                 ignoreOrder: true,
             }),
         ],

package/lib/webpack/client.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 { Configuration } from 'webpack';
-import { Props } from '@docusaurus/types';
-export default function createClientConfig(props: Props, minify?: boolean): Configuration;
+import type { Configuration } from 'webpack';
+import type { Props } from '@docusaurus/types';
+export default function createClientConfig(props: Props, minify?: boolean): Promise<Configuration>;

package/lib/webpack/client.js

@@ -7,28 +7,20 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const base_1 = require("./base");
 const ChunkAssetPlugin_1 = tslib_1.__importDefault(require("./plugins/ChunkAssetPlugin"));
 const LogPlugin_1 = tslib_1.__importDefault(require("./plugins/LogPlugin"));
-function createClientConfig(props, minify = true) {
-    var _a;
-    const isProd = process.env.NODE_ENV === 'production';
+async function createClientConfig(props, minify = true) {
     const isBuilding = process.argv[2] === 'build';
-    const config = base_1.createBaseConfig(props, false, minify);
-    const clientConfig = webpack_merge_1.default(config, {
-        // target: 'browserslist', //  useless, disabled on purpose (errors on existing sites with no browserslist cfg)
-        entry: [
-            // Instead of the default WebpackDevServer client, we use a custom one
-            // like CRA to bring better experience.
-            // note: the one in ./dev is modified to work with Docusaurus
-            // !isProd && require.resolve('react-dev-utils/hotDevServer.js'),
-            !isProd &&
-                require.resolve('./react-dev-utils-webpack5/webpackHotDevClient.js'),
-            path_1.default.resolve(__dirname, '../client/clientEntry.js'),
-        ].filter(Boolean),
+    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)
+        // target: 'browserslist',
+        entry: path_1.default.resolve(__dirname, '../client/clientEntry.js'),
         optimization: {
             // Keep the runtime chunk separated to enable long term caching
             // https://twitter.com/wSokra/status/969679223278505985
@@ -42,13 +34,14 @@ function createClientConfig(props, minify = true) {
             }),
         ],
     });
-    // When building include the plugin to force terminate building if errors happened in the client bundle.
+    // When building, include the plugin to force terminate building if errors
+    // happened in the client bundle.
     if (isBuilding) {
-        (_a = clientConfig.plugins) === null || _a === void 0 ? void 0 : _a.push({
+        clientConfig.plugins?.push({
             apply: (compiler) => {
                 compiler.hooks.done.tap('client:done', (stats) => {
                     if (stats.hasErrors()) {
-                        console.log(chalk_1.default.red('Client bundle compiled with errors therefore further build is impossible.'));
+                        logger_1.default.error('Client bundle compiled with errors therefore further build is impossible.');
                         process.exit(1);
                     }
                 });

package/lib/webpack/plugins/ChunkAssetPlugin.d.ts

@@ -4,8 +4,18 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Compiler } from 'webpack';
-declare class ChunkAssetPlugin {
+import { type Compiler } from 'webpack';
+/**
+ * We modify webpack runtime to add an extra function called
+ * "__webpack_require__.gca" that will allow us to get the corresponding chunk
+ * asset for a webpack chunk. Pass it the chunkName or chunkId you want to load.
+ * For example: if you have a chunk named "my-chunk-name" that will map to
+ * "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
+ * __webpack_require__.gca("my-chunk-name") will return
+ * "/publicPath/0a84b5e7.c8e35c7a.js"
+ *
+ * "gca" stands for "get chunk asset"
+ */
+export default class ChunkAssetPlugin {
     apply(compiler: Compiler): void;
 }
-export default ChunkAssetPlugin;

package/lib/webpack/plugins/ChunkAssetPlugin.js

@@ -8,16 +8,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const webpack_1 = require("webpack");
 const pluginName = 'chunk-asset-plugin';
+/**
+ * We modify webpack runtime to add an extra function called
+ * "__webpack_require__.gca" that will allow us to get the corresponding chunk
+ * asset for a webpack chunk. Pass it the chunkName or chunkId you want to load.
+ * For example: if you have a chunk named "my-chunk-name" that will map to
+ * "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
+ * __webpack_require__.gca("my-chunk-name") will return
+ * "/publicPath/0a84b5e7.c8e35c7a.js"
+ *
+ * "gca" stands for "get chunk asset"
+ */
 class ChunkAssetPlugin {
     apply(compiler) {
         compiler.hooks.thisCompilation.tap(pluginName, ({ mainTemplate }) => {
-            /* We modify webpack runtime to add an extra function called "__webpack_require__.gca"
-            that will allow us to get the corresponding chunk asset for a webpack chunk.
-            Pass it the chunkName or chunkId you want to load.
-            For example: if you have a chunk named "my-chunk-name" that will map to "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
-            __webpack_require__.gca("my-chunk-name") will return "/publicPath/0a84b5e7.c8e35c7a.js"
-            "gca" stands for "get chunk asset"
-            */
             mainTemplate.hooks.requireExtensions.tap(pluginName, (source, chunk) => {
                 const chunkIdToName = chunk.getChunkMaps(false).name;
                 const chunkNameToId = Object.create(null);
@@ -30,10 +34,13 @@ class ChunkAssetPlugin {
                 buf.push(
                 // If chunkName is passed, we convert it to chunk asset url
                 // .p => public path url ("/" or "/baseUrl/")
-                // .u(chunkId) => chunk asset url ("assets/js/x63b64xd.contentHash.js")
-                // not sure where this is documented, but this link was helpful: https://programmer.help/blogs/5d68849083e1a.html
+                // .u(chunkId) =>
+                //   chunk asset url ("assets/js/x63b64xd.contentHash.js")
+                // not sure where this is documented, but this link was helpful:
+                // https://programmer.help/blogs/5d68849083e1a.html
                 //
-                // Note: __webpack_require__.gca() is called in docusaurus.ts for prefetching
+                // Note: __webpack_require__.gca() is called in docusaurus.ts for
+                // prefetching
                 // Note: we previously used jsonpScriptSrc (Webpack 4)
                 `__webpack_require__.gca = function(chunkId) { chunkId = ${JSON.stringify(chunkNameToId)}[chunkId]||chunkId; return __webpack_require__.p + __webpack_require__.u(chunkId); };`);
                 return webpack_1.Template.asString(buf);

package/lib/webpack/plugins/CleanWebpackPlugin.d.ts

@@ -13,8 +13,8 @@
  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  * copies of the Software, and to permit persons to whom the Software is
  * furnished to do so, subject to the following conditions:
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -23,7 +23,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-import { Compiler, Stats } from 'webpack';
+import type { Compiler, Stats } from 'webpack';
 export interface Options {
     /**
      * Write Logs to Console
@@ -54,7 +54,7 @@ export interface Options {
      */
     cleanOnceBeforeBuildPatterns?: string[];
 }
-declare class CleanWebpackPlugin {
+export default class CleanWebpackPlugin {
     private readonly verbose;
     private readonly cleanStaleWebpackAssets;
     private readonly protectWebpackAssets;
@@ -69,10 +69,10 @@ declare class CleanWebpackPlugin {
      *
      * Only happens once.
      *
-     * Warning: It is recommended to initially clean your build directory outside of webpack to minimize unexpected behavior.
+     * Warning: It is recommended to initially clean your build directory outside
+     * of webpack to minimize unexpected behavior.
      */
     handleInitial(): void;
     handleDone(stats: Stats): void;
     removeFiles(patterns: string[]): void;
 }
-export default CleanWebpackPlugin;

package/lib/webpack/plugins/CleanWebpackPlugin.js

@@ -41,7 +41,6 @@ class CleanWebpackPlugin {
     }
     apply(compiler) {
         if (!compiler.options.output || !compiler.options.output.path) {
-            // eslint-disable-next-line no-console
             console.warn('clean-webpack-plugin: options.output.path not defined. Plugin disabled...');
             return;
         }
@@ -61,7 +60,8 @@ class CleanWebpackPlugin {
      *
      * Only happens once.
      *
-     * Warning: It is recommended to initially clean your build directory outside of webpack to minimize unexpected behavior.
+     * Warning: It is recommended to initially clean your build directory outside
+     * of webpack to minimize unexpected behavior.
      */
     handleInitial() {
         if (this.initialClean) {
@@ -76,7 +76,6 @@ class CleanWebpackPlugin {
          */
         if (stats.hasErrors()) {
             if (this.verbose) {
-                // eslint-disable-next-line no-console
                 console.warn('clean-webpack-plugin: pausing due to webpack errors');
             }
             return;
@@ -88,17 +87,13 @@ class CleanWebpackPlugin {
             all: false,
             assets: true,
         }).assets || [];
-        const assets = statsAssets.map((asset) => {
-            return asset.name;
-        });
+        const assets = statsAssets.map((asset) => asset.name);
         /**
          * Get all files that were in the previous build but not the current
          *
          * (relies on del's cwd: outputPath option)
          */
-        const staleFiles = this.currentAssets.filter((previousAsset) => {
-            return assets.includes(previousAsset) === false;
-        });
+        const staleFiles = this.currentAssets.filter((previousAsset) => assets.includes(previousAsset) === false);
         /**
          * Save assets for next compilation
          */
@@ -116,7 +111,7 @@ class CleanWebpackPlugin {
     }
     removeFiles(patterns) {
         try {
-            const deleted = del_1.sync(patterns, {
+            const deleted = (0, del_1.sync)(patterns, {
                 force: false,
                 // Change context to build directory
                 cwd: this.outputPath,
@@ -135,18 +130,17 @@ class CleanWebpackPlugin {
                      * https://github.com/webpack/webpack/issues/1904
                      * https://github.com/johnagan/clean-webpack-plugin/issues/11
                      */
-                    // eslint-disable-next-line no-console
                     console.warn(`clean-webpack-plugin: removed ${filename}`);
                 });
             }
         }
-        catch (error) {
-            const needsForce = /Cannot delete files\/folders outside the current working directory\./.test(error.message);
+        catch (err) {
+            const needsForce = /Cannot delete files\/folders outside the current working directory\./.test(err.message);
             if (needsForce) {
                 const message = 'clean-webpack-plugin: Cannot delete files/folders outside the current working directory. Can be overridden with the "dangerouslyAllowCleanPatternsOutsideProject" option.';
                 throw new Error(message);
             }
-            throw error;
+            throw err;
         }
     }
 }

package/lib/webpack/plugins/LogPlugin.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import WebpackBar from 'webpackbar';
-import { Compiler } from 'webpack';
+import type { Compiler } from 'webpack';
 export default class LogPlugin extends WebpackBar {
     apply(compiler: Compiler): void;
 }

package/lib/webpack/plugins/LogPlugin.js

@@ -1,15 +1,14 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
 /**
  * Copyright (c) Facebook, Inc. and its affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 const webpackbar_1 = tslib_1.__importDefault(require("webpackbar"));
-// import formatWebpackMessages from 'react-dev-utils/formatWebpackMessages';
-const formatWebpackMessages_1 = tslib_1.__importDefault(require("../react-dev-utils-webpack5/formatWebpackMessages"));
+const formatWebpackMessages_1 = tslib_1.__importDefault(require("react-dev-utils/formatWebpackMessages"));
 function showError(arr) {
     console.log(`\n\n${arr.join('\n')}`);
 }
@@ -23,7 +22,7 @@ class LogPlugin extends webpackbar_1.default {
                 // TODO do we really want to keep this legacy logic?
                 // let's wait and see how the react-dev-utils support Webpack5
                 // we probably want to print the error stacktraces here
-                const messages = formatWebpackMessages_1.default(errorsWarnings);
+                const messages = (0, formatWebpackMessages_1.default)(errorsWarnings);
                 if (messages.errors.length) {
                     showError(messages.errors);
                 }

package/lib/webpack/plugins/WaitPlugin.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 { Compiler } from 'webpack';
+import type { Compiler } from 'webpack';
 interface WaitPluginOptions {
     filepath: string;
 }

package/lib/webpack/plugins/WaitPlugin.js

@@ -20,7 +20,7 @@ class WaitPlugin {
             // To prevent 'waitFile' error on waiting non-existing directory
             fs_extra_1.default.ensureDir(path_1.default.dirname(this.filepath), {}, () => {
                 // Wait until file exist
-                wait_on_1.default({
+                (0, wait_on_1.default)({
                     resources: [this.filepath],
                     interval: 300,
                 })

package/lib/webpack/server.d.ts

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

@@ -12,12 +12,12 @@ const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const base_1 = require("./base");
 const WaitPlugin_1 = tslib_1.__importDefault(require("./plugins/WaitPlugin"));
 const LogPlugin_1 = tslib_1.__importDefault(require("./plugins/LogPlugin"));
-const constants_1 = require("../constants");
+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 = 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 = 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) => {
@@ -25,8 +25,8 @@ function createServerConfig({ props, onLinksCollected = () => { }, }) {
         routesLocation[ssgPath] = str;
         return ssgPath;
     });
-    const serverConfig = webpack_merge_1.default(config, {
-        target: `node${constants_1.NODE_MAJOR_VERSION}.${constants_1.NODE_MINOR_VERSION}`,
+    const serverConfig = (0, webpack_merge_1.default)(config, {
+        target: `node${utils_1.NODE_MAJOR_VERSION}.${utils_1.NODE_MINOR_VERSION}`,
         entry: {
             main: path_1.default.resolve(__dirname, '../client/serverEntry.js'),
         },
@@ -57,9 +57,10 @@ function createServerConfig({ props, onLinksCollected = () => { }, }) {
                 },
                 paths: ssgPaths,
                 preferFoldersOutput: trailingSlash,
-                // When using "new URL('file.js', import.meta.url)", Webpack will emit __filename, and this plugin will throw
-                // not sure the __filename value has any importance for this plugin, just using an empty string to avoid the error
-                // See https://github.com/facebook/docusaurus/issues/4922
+                // When using "new URL('file.js', import.meta.url)", Webpack will emit
+                // __filename, and this plugin will throw. not sure the __filename value
+                // has any importance for this plugin, just using an empty string to
+                // avoid the error. See https://github.com/facebook/docusaurus/issues/4922
                 globals: { __filename: '' },
             }),
             // Show compilation progress bar.