@docusaurus/core 3.5.2 → 3.6.0

package/lib/webpack/plugins/ChunkAssetPlugin.js

@@ -8,44 +8,59 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const webpack_1 = tslib_1.__importDefault(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"
+// Adds a custom Docusaurus Webpack runtime function `__webpack_require__.gca`
+// gca = Get Chunk Asset, it converts a chunkName to a JS asset URL
+// It is called in Core client/docusaurus.ts for chunk preloading/prefetching
+// Example: gca("814f3328") = "/baseUrl/assets/js/814f3328.03fcc178.js"
+// See also: https://github.com/facebook/docusaurus/pull/10485
+// The name of the custom Docusaurus Webpack runtime function
+const DocusaurusGetChunkAssetFn = '__webpack_require__.gca';
+const PluginName = 'Docusaurus-ChunkAssetPlugin';
+function generateGetChunkAssetRuntimeCode(chunk) {
+    const chunkIdToName = chunk.getChunkMaps(false).name;
+    const chunkNameToId = Object.fromEntries(Object.entries(chunkIdToName).map(([chunkId, chunkName]) => [
+        chunkName,
+        chunkId,
+    ]));
+    const { 
+    // publicPath = __webpack_require__.p
+    // Example: "/" or "/baseUrl/"
+    // https://github.com/webpack/webpack/blob/v5.94.0/lib/runtime/PublicPathRuntimeModule.js
+    publicPath, 
+    // getChunkScriptFilename = __webpack_require__.u
+    // Example: getChunkScriptFilename("814f3328") = "814f3328.03fcc178.js"
+    // https://github.com/webpack/webpack/blob/v5.94.0/lib/runtime/GetChunkFilenameRuntimeModule.js
+    getChunkScriptFilename, } = webpack_1.default.RuntimeGlobals;
+    const code = `// Docusaurus function to get chunk asset
+${DocusaurusGetChunkAssetFn} = function(chunkId) { chunkId = ${JSON.stringify(chunkNameToId)}[chunkId]||chunkId; return ${publicPath} + ${getChunkScriptFilename}(chunkId); };`;
+    return webpack_1.default.Template.asString(code);
+}
+/*
+ Note: we previously used `MainTemplate.hooks.requireExtensions.tap()`
+ But it will be removed in Webpack 6 and is not supported by Rspack
+ So instead we use equivalent code inspired by:
+ - https://github.com/webpack/webpack/blob/v5.94.0/lib/RuntimePlugin.js#L462
+ - https://github.com/webpack/webpack/blob/v5.94.0/lib/runtime/CompatRuntimeModule.js
  */
 class ChunkAssetPlugin {
     apply(compiler) {
-        compiler.hooks.thisCompilation.tap(pluginName, ({ mainTemplate }) => {
-            mainTemplate.hooks.requireExtensions.tap(pluginName, (source, chunk) => {
-                const chunkIdToName = chunk.getChunkMaps(false).name;
-                const chunkNameToId = Object.fromEntries(Object.entries(chunkIdToName).map(([chunkId, chunkName]) => [
-                    chunkName,
-                    chunkId,
-                ]));
-                const buf = [source];
-                buf.push('// function to get chunk asset');
-                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
-                //
-                // 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.default.Template.asString(buf);
+        compiler.hooks.thisCompilation.tap(PluginName, (compilation) => {
+            compilation.hooks.additionalTreeRuntimeRequirements.tap(PluginName, (chunk) => {
+                compilation.addRuntimeModule(chunk, new ChunkAssetRuntimeModule());
             });
         });
     }
 }
 exports.default = ChunkAssetPlugin;
+// Inspired by https://github.com/webpack/webpack/blob/v5.94.0/lib/runtime/CompatRuntimeModule.js
+// See also https://rspack.dev/api/javascript-api/compilation#addruntimemodule
+// See also https://rspack.dev/api/plugin-api/compilation-hooks#additionaltreeruntimerequirements
+class ChunkAssetRuntimeModule extends webpack_1.default.RuntimeModule {
+    constructor() {
+        super('ChunkAssetRuntimeModule', webpack_1.default.RuntimeModule.STAGE_ATTACH);
+        this.fullHash = true;
+    }
+    generate() {
+        return generateGetChunkAssetRuntimeCode(this.chunk);
+    }
+}

package/lib/webpack/plugins/ForceTerminatePlugin.js

@@ -7,8 +7,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+const bundler_1 = require("@docusaurus/bundler");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const utils_1 = require("../utils");
 // When building, include the plugin to force terminate building if errors
 // happened in the client bundle.
 class ForceTerminatePlugin {
@@ -16,7 +16,7 @@ class ForceTerminatePlugin {
         compiler.hooks.done.tap('client:done', (stats) => {
             if (stats.hasErrors()) {
                 const errorsWarnings = stats.toJson('errors-warnings');
-                logger_1.default.error(`Client bundle compiled with errors therefore further build is impossible.\n${(0, utils_1.formatStatsErrorMessage)(errorsWarnings)}`);
+                logger_1.default.error(`Client bundle compiled with errors therefore further build is impossible.\n${(0, bundler_1.formatStatsErrorMessage)(errorsWarnings)}`);
                 process.exit(1);
             }
         });

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

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import CopyWebpackPlugin from 'copy-webpack-plugin';
 import type { Props } from '@docusaurus/types';
+import type { WebpackPluginInstance } from 'webpack';
 export declare function createStaticDirectoriesCopyPlugin({ props, }: {
     props: Props;
-}): Promise<CopyWebpackPlugin | undefined>;
+}): Promise<WebpackPluginInstance | undefined>;

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -10,8 +10,11 @@ exports.createStaticDirectoriesCopyPlugin = createStaticDirectoriesCopyPlugin;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
+const bundler_1 = require("@docusaurus/bundler");
 async function createStaticDirectoriesCopyPlugin({ props, }) {
+    const CopyPlugin = await (0, bundler_1.getCopyPlugin)({
+        currentBundler: props.currentBundler,
+    });
     const { outDir, siteDir, siteConfig: { staticDirectories: staticDirectoriesOption }, } = props;
     // The staticDirectories option can contain empty directories, or non-existent
     // directories (e.g. user deleted `static`). Instead of issuing an error, we
@@ -28,7 +31,7 @@ async function createStaticDirectoriesCopyPlugin({ props, }) {
     if (staticDirectories.length === 0) {
         return undefined;
     }
-    return new copy_webpack_plugin_1.default({
+    return new CopyPlugin({
         patterns: staticDirectories.map((dir) => ({
             from: dir,
             to: outDir,

package/lib/webpack/server.d.ts

@@ -4,10 +4,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { Props } from '@docusaurus/types';
+import type { ConfigureWebpackUtils, Props } from '@docusaurus/types';
 import type { Configuration } from 'webpack';
-export default function createServerConfig(params: {
+export default function createServerConfig({ props, configureWebpackUtils, }: {
     props: Props;
+    configureWebpackUtils: ConfigureWebpackUtils;
 }): Promise<{
     config: Configuration;
     serverBundlePath: string;

package/lib/webpack/server.js

@@ -11,36 +11,38 @@ const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const utils_1 = require("@docusaurus/utils");
-const webpackbar_1 = tslib_1.__importDefault(require("webpackbar"));
+const bundler_1 = require("@docusaurus/bundler");
 const base_1 = require("./base");
-async function createServerConfig(params) {
-    const { props } = params;
+async function createServerConfig({ props, configureWebpackUtils, }) {
     const baseConfig = await (0, base_1.createBaseConfig)({
         props,
         isServer: true,
-        // Minification of server bundle reduces size but doubles bundle time :/
         minify: false,
+        faster: props.siteConfig.future.experimental_faster,
+        configureWebpackUtils,
+    });
+    const ProgressBarPlugin = await (0, bundler_1.getProgressBarPlugin)({
+        currentBundler: props.currentBundler,
     });
     const outputFilename = 'server.bundle.js';
-    const serverBundlePath = path_1.default.join(props.outDir, outputFilename);
+    const outputDir = path_1.default.join(props.outDir, '__server');
+    const serverBundlePath = path_1.default.join(outputDir, outputFilename);
     const config = (0, webpack_merge_1.default)(baseConfig, {
         target: `node${utils_1.NODE_MAJOR_VERSION}.${utils_1.NODE_MINOR_VERSION}`,
         entry: {
             main: path_1.default.resolve(__dirname, '../client/serverEntry.js'),
         },
         output: {
+            path: outputDir,
             filename: outputFilename,
             libraryTarget: 'commonjs2',
-            // Workaround for Webpack 4 Bug (https://github.com/webpack/webpack/issues/6522)
-            globalObject: 'this',
         },
         plugins: [
-            // Show compilation progress bar.
-            new webpackbar_1.default({
+            new ProgressBarPlugin({
                 name: 'Server',
                 color: 'yellow',
             }),
-        ].filter(Boolean),
+        ],
     });
     return { config, serverBundlePath };
 }

package/lib/webpack/{minification.d.ts → utils/getHttpsConfig.d.ts}

@@ -4,5 +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 type { WebpackPluginInstance } from 'webpack';
-export declare function getMinimizer(): WebpackPluginInstance[];
+export default function getHttpsConfig(): Promise<boolean | {
+    cert: Buffer;
+    key: Buffer;
+}>;

package/lib/webpack/utils/getHttpsConfig.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getHttpsConfig;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const crypto_1 = tslib_1.__importDefault(require("crypto"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+// Ensure the certificate and key provided are valid and if not
+// throw an easy to debug error
+function validateKeyAndCerts({ cert, key, keyFile, crtFile, }) {
+    let encrypted;
+    try {
+        // publicEncrypt will throw an error with an invalid cert
+        encrypted = crypto_1.default.publicEncrypt(cert, Buffer.from('test'));
+    }
+    catch (err) {
+        logger_1.default.error `The certificate path=${crtFile} is invalid.`;
+        throw err;
+    }
+    try {
+        // privateDecrypt will throw an error with an invalid key
+        crypto_1.default.privateDecrypt(key, encrypted);
+    }
+    catch (err) {
+        logger_1.default.error `The certificate key path=${keyFile} is invalid.`;
+        throw err;
+    }
+}
+// Read file and throw an error if it doesn't exist
+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.readFile(file);
+}
+// Get the https config
+// Return cert files if provided in env, otherwise just true or false
+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: await readEnvFile(crtFile, 'SSL_CRT_FILE'),
+            key: await readEnvFile(keyFile, 'SSL_KEY_FILE'),
+        };
+        validateKeyAndCerts({ ...config, keyFile, crtFile });
+        return config;
+    }
+    return isHttps;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,53 +33,31 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@babel/core": "^7.23.3",
-    "@babel/generator": "^7.23.3",
-    "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-    "@babel/plugin-transform-runtime": "^7.22.9",
-    "@babel/preset-env": "^7.22.9",
-    "@babel/preset-react": "^7.22.5",
-    "@babel/preset-typescript": "^7.22.5",
-    "@babel/runtime": "^7.22.6",
-    "@babel/runtime-corejs3": "^7.22.6",
-    "@babel/traverse": "^7.22.8",
-    "@docusaurus/cssnano-preset": "3.5.2",
-    "@docusaurus/logger": "3.5.2",
-    "@docusaurus/mdx-loader": "3.5.2",
-    "@docusaurus/utils": "3.5.2",
-    "@docusaurus/utils-common": "3.5.2",
-    "@docusaurus/utils-validation": "3.5.2",
-    "autoprefixer": "^10.4.14",
-    "babel-loader": "^9.1.3",
-    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "@docusaurus/babel": "3.6.0",
+    "@docusaurus/bundler": "3.6.0",
+    "@docusaurus/logger": "3.6.0",
+    "@docusaurus/mdx-loader": "3.6.0",
+    "@docusaurus/utils": "3.6.0",
+    "@docusaurus/utils-common": "3.6.0",
+    "@docusaurus/utils-validation": "3.6.0",
     "boxen": "^6.2.1",
     "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
-    "clean-css": "^5.3.2",
     "cli-table3": "^0.6.3",
     "combine-promises": "^1.1.0",
     "commander": "^5.1.0",
-    "copy-webpack-plugin": "^11.0.0",
     "core-js": "^3.31.1",
-    "css-loader": "^6.8.1",
-    "css-minimizer-webpack-plugin": "^5.0.1",
-    "cssnano": "^6.1.2",
     "del": "^6.1.1",
     "detect-port": "^1.5.1",
     "escape-html": "^1.0.3",
     "eta": "^2.2.0",
     "eval": "^0.1.8",
-    "file-loader": "^6.2.0",
     "fs-extra": "^11.1.1",
-    "html-minifier-terser": "^7.2.0",
     "html-tags": "^3.3.1",
-    "html-webpack-plugin": "^5.5.3",
+    "html-webpack-plugin": "^5.6.0",
     "leven": "^3.1.0",
     "lodash": "^4.17.21",
-    "mini-css-extract-plugin": "^2.7.6",
     "p-map": "^4.0.0",
-    "postcss": "^8.4.26",
-    "postcss-loader": "^7.3.3",
     "prompts": "^2.4.2",
     "react-dev-utils": "^12.0.1",
     "react-helmet-async": "^1.3.0",
@@ -90,29 +68,26 @@
     "react-router-dom": "^5.3.4",
     "rtl-detect": "^1.0.4",
     "semver": "^7.5.4",
-    "serve-handler": "^6.1.5",
+    "serve-handler": "^6.1.6",
     "shelljs": "^0.8.5",
-    "terser-webpack-plugin": "^5.3.9",
     "tslib": "^2.6.0",
     "update-notifier": "^6.0.2",
-    "url-loader": "^4.1.1",
-    "webpack": "^5.88.1",
-    "webpack-bundle-analyzer": "^4.9.0",
-    "webpack-dev-server": "^4.15.1",
-    "webpack-merge": "^5.9.0",
-    "webpackbar": "^5.0.2"
+    "webpack": "^5.95.0",
+    "webpack-bundle-analyzer": "^4.10.2",
+    "webpack-dev-server": "^4.15.2",
+    "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.5.2",
-    "@docusaurus/types": "3.5.2",
+    "@docusaurus/module-type-aliases": "3.6.0",
+    "@docusaurus/types": "3.6.0",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
     "@types/react-router-config": "^5.0.7",
     "@types/rtl-detect": "^1.0.0",
-    "@types/serve-handler": "^6.1.1",
+    "@types/serve-handler": "^6.1.4",
     "@types/update-notifier": "^6.0.4",
-    "@types/webpack-bundle-analyzer": "^4.6.0",
+    "@types/webpack-bundle-analyzer": "^4.7.0",
     "react-test-renderer": "^18.0.0",
     "tmp-promise": "^3.0.3",
     "tree-node-cli": "^1.6.0"
@@ -125,5 +100,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "eeec303dd773774ed5a023884800da0b061f6942"
+  "gitHead": "05bba6d4f495ef6b0bec5d41453932bb97981830"
 }

package/lib/commands/build.js

@@ -1,240 +0,0 @@
-"use strict";
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.build = build;
-const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const utils_1 = require("@docusaurus/utils");
-const site_1 = require("../server/site");
-const brokenLinks_1 = require("../server/brokenLinks");
-const client_1 = require("../webpack/client");
-const server_1 = tslib_1.__importDefault(require("../webpack/server"));
-const configure_1 = require("../webpack/configure");
-const utils_2 = require("../webpack/utils");
-const utils_3 = require("../utils");
-const i18n_1 = require("../server/i18n");
-const ssg_1 = require("../ssg");
-const templates_1 = require("../templates/templates");
-const ssr_html_template_1 = tslib_1.__importDefault(require("../templates/ssr.html.template"));
-async function build(siteDirParam = '.', cliOptions = {}, 
-// When running build, we force terminate the process to prevent async
-// operations from never returning. However, if run as part of docusaurus
-// deploy, we have to let deploy finish.
-// See https://github.com/facebook/docusaurus/pull/2496
-forceTerminate = true) {
-    process.env.BABEL_ENV = 'production';
-    process.env.NODE_ENV = 'production';
-    process.env.DOCUSAURUS_CURRENT_LOCALE = cliOptions.locale;
-    if (cliOptions.dev) {
-        logger_1.default.info `Building in dev mode`;
-        process.env.BABEL_ENV = 'development';
-        process.env.NODE_ENV = 'development';
-    }
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
-    ['SIGINT', 'SIGTERM'].forEach((sig) => {
-        process.on(sig, () => process.exit());
-    });
-    async function tryToBuildLocale({ locale }) {
-        try {
-            await utils_3.PerfLogger.async(`${logger_1.default.name(locale)}`, () => buildLocale({
-                siteDir,
-                locale,
-                cliOptions,
-            }));
-        }
-        catch (err) {
-            throw new Error(logger_1.default.interpolate `Unable to build website for locale name=${locale}.`, {
-                cause: err,
-            });
-        }
-    }
-    const locales = await utils_3.PerfLogger.async('Get locales to build', () => getLocalesToBuild({ siteDir, cliOptions }));
-    if (locales.length > 1) {
-        logger_1.default.info `Website will be built for all these locales: ${locales}`;
-    }
-    await utils_3.PerfLogger.async(`Build`, () => (0, utils_1.mapAsyncSequential)(locales, async (locale) => {
-        const isLastLocale = locales.indexOf(locale) === locales.length - 1;
-        await tryToBuildLocale({ locale });
-        if (isLastLocale) {
-            logger_1.default.info `Use code=${'npm run serve'} command to test your build locally.`;
-        }
-        // TODO do we really need this historical forceTerminate exit???
-        if (forceTerminate && isLastLocale && !cliOptions.bundleAnalyzer) {
-            process.exit(0);
-        }
-    }));
-}
-async function getLocalesToBuild({ siteDir, cliOptions, }) {
-    if (cliOptions.locale) {
-        return [cliOptions.locale];
-    }
-    const context = await (0, site_1.loadContext)({
-        siteDir,
-        outDir: cliOptions.outDir,
-        config: cliOptions.config,
-        locale: cliOptions.locale,
-        localizePath: cliOptions.locale ? false : undefined,
-    });
-    const i18n = await (0, i18n_1.loadI18n)(context.siteConfig, {
-        locale: cliOptions.locale,
-    });
-    if (i18n.locales.length > 1) {
-        logger_1.default.info `Website will be built for all these locales: ${i18n.locales}`;
-    }
-    // We need the default locale to always be the 1st in the list. If we build it
-    // last, it would "erase" the localized sites built in sub-folders
-    return [
-        i18n.defaultLocale,
-        ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
-    ];
-}
-async function buildLocale({ siteDir, locale, cliOptions, }) {
-    // Temporary workaround to unlock the ability to translate the site config
-    // We'll remove it if a better official API can be designed
-    // See https://github.com/facebook/docusaurus/issues/4542
-    process.env.DOCUSAURUS_CURRENT_LOCALE = locale;
-    logger_1.default.info `name=${`[${locale}]`} Creating an optimized production build...`;
-    const site = await utils_3.PerfLogger.async('Load site', () => (0, site_1.loadSite)({
-        siteDir,
-        outDir: cliOptions.outDir,
-        config: cliOptions.config,
-        locale,
-        localizePath: cliOptions.locale ? false : undefined,
-    }));
-    const { props } = site;
-    const { outDir, plugins, siteConfig } = props;
-    const router = siteConfig.future.experimental_router;
-    // We can build the 2 configs in parallel
-    const [{ clientConfig, clientManifestPath }, { serverConfig, serverBundlePath }] = await utils_3.PerfLogger.async('Creating webpack configs', () => Promise.all([
-        getBuildClientConfig({
-            props,
-            cliOptions,
-        }),
-        getBuildServerConfig({
-            props,
-        }),
-    ]));
-    // Run webpack to build JS bundle (client) and static html files (server).
-    await utils_3.PerfLogger.async('Bundling with Webpack', () => {
-        if (router === 'hash') {
-            return (0, utils_2.compile)([clientConfig]);
-        }
-        else {
-            return (0, utils_2.compile)([clientConfig, serverConfig]);
-        }
-    });
-    const { collectedData } = await utils_3.PerfLogger.async('SSG', () => executeSSG({
-        props,
-        serverBundlePath,
-        clientManifestPath,
-        router,
-    }));
-    // Remove server.bundle.js because it is not needed.
-    await utils_3.PerfLogger.async('Deleting server bundle', () => ensureUnlink(serverBundlePath));
-    // Plugin Lifecycle - postBuild.
-    await utils_3.PerfLogger.async('postBuild()', () => executePluginsPostBuild({ plugins, props, collectedData }));
-    // TODO execute this in parallel to postBuild?
-    await utils_3.PerfLogger.async('Broken links checker', () => executeBrokenLinksCheck({ props, collectedData }));
-    logger_1.default.success `Generated static files in path=${path_1.default.relative(process.cwd(), outDir)}.`;
-    return outDir;
-}
-async function executeSSG({ props, serverBundlePath, clientManifestPath, router, }) {
-    const manifest = await utils_3.PerfLogger.async('Read client manifest', () => fs_extra_1.default.readJSON(clientManifestPath, 'utf-8'));
-    const ssrTemplate = await utils_3.PerfLogger.async('Compile SSR template', () => (0, templates_1.compileSSRTemplate)(props.siteConfig.ssrTemplate ?? ssr_html_template_1.default));
-    const params = {
-        trailingSlash: props.siteConfig.trailingSlash,
-        outDir: props.outDir,
-        baseUrl: props.baseUrl,
-        manifest,
-        headTags: props.headTags,
-        preBodyTags: props.preBodyTags,
-        postBodyTags: props.postBodyTags,
-        ssrTemplate,
-        noIndex: props.siteConfig.noIndex,
-        DOCUSAURUS_VERSION: utils_1.DOCUSAURUS_VERSION,
-    };
-    if (router === 'hash') {
-        utils_3.PerfLogger.start('Generate Hash Router entry point');
-        const content = (0, templates_1.renderHashRouterTemplate)({ params });
-        await (0, ssg_1.generateHashRouterEntrypoint)({ content, params });
-        utils_3.PerfLogger.end('Generate Hash Router entry point');
-        return { collectedData: {} };
-    }
-    const renderer = await utils_3.PerfLogger.async('Load App renderer', () => (0, ssg_1.loadAppRenderer)({
-        serverBundlePath,
-    }));
-    const ssgResult = await utils_3.PerfLogger.async('Generate static files', () => (0, ssg_1.generateStaticFiles)({
-        pathnames: props.routesPaths,
-        renderer,
-        params,
-    }));
-    return ssgResult;
-}
-async function executePluginsPostBuild({ plugins, props, collectedData, }) {
-    const head = lodash_1.default.mapValues(collectedData, (d) => d.helmet);
-    await Promise.all(plugins.map(async (plugin) => {
-        if (!plugin.postBuild) {
-            return;
-        }
-        await plugin.postBuild({
-            ...props,
-            head,
-            content: plugin.content,
-        });
-    }));
-}
-async function executeBrokenLinksCheck({ props: { routes, siteConfig: { onBrokenLinks, onBrokenAnchors }, }, collectedData, }) {
-    const collectedLinks = lodash_1.default.mapValues(collectedData, (d) => ({
-        links: d.links,
-        anchors: d.anchors,
-    }));
-    await (0, brokenLinks_1.handleBrokenLinks)({
-        collectedLinks,
-        routes,
-        onBrokenLinks,
-        onBrokenAnchors,
-    });
-}
-async function getBuildClientConfig({ props, cliOptions, }) {
-    const { plugins } = props;
-    const result = await (0, client_1.createBuildClientConfig)({
-        props,
-        minify: cliOptions.minify ?? true,
-        bundleAnalyzer: cliOptions.bundleAnalyzer ?? false,
-    });
-    let { config } = result;
-    config = (0, configure_1.executePluginsConfigureWebpack)({
-        plugins,
-        config,
-        isServer: false,
-        jsLoader: props.siteConfig.webpack?.jsLoader,
-    });
-    return { clientConfig: config, clientManifestPath: result.clientManifestPath };
-}
-async function getBuildServerConfig({ props }) {
-    const { plugins } = props;
-    const result = await (0, server_1.default)({
-        props,
-    });
-    let { config } = result;
-    config = (0, configure_1.executePluginsConfigureWebpack)({
-        plugins,
-        config,
-        isServer: true,
-        jsLoader: props.siteConfig.webpack?.jsLoader,
-    });
-    return { serverConfig: config, serverBundlePath: result.serverBundlePath };
-}
-async function ensureUnlink(filepath) {
-    if (await fs_extra_1.default.pathExists(filepath)) {
-        await fs_extra_1.default.unlink(filepath);
-    }
-}