@docusaurus/bundler 3.5.2 → 3.6.0

package/lib/loaders/styleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleLoader.js","sourceRoot":"","sources":["../../src/loaders/styleLoader.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAKH,8DAqEC;AAxED,sDAAsD;AAG/C,KAAK,UAAU,yBAAyB,CAAC,EAC9C,cAAc,GAGf;IACC,MAAM,gBAAgB,GAAG,MAAM,IAAA,oCAAmB,EAAC,EAAC,cAAc,EAAC,CAAC,CAAC;IAErE,OAAO,SAAS,eAAe,CAC7B,QAAiB,EACjB,gBAEI,EAAE;QAEN,MAAM,UAAU,GAA6B;YAC3C,oFAAoF;YACpF,QAAQ,EAAE,KAAK;YACf,GAAG,aAAa;SACjB,CAAC;QAEF,yDAAyD;QACzD,kEAAkE;QAClE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,OAAO;gBACvB,CAAC,CAAC;oBACE;wBACE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;wBACrC,OAAO,EAAE,UAAU;qBACpB;iBACF;gBACH,CAAC,CAAC,2BAA2B;oBAC3B,CAAC,EAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAC,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL;gBACE,MAAM,EAAE,gBAAgB,CAAC,MAAM;gBAC/B,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;iBACf;aACF;YACD;gBACE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;gBACrC,OAAO,EAAE,UAAU;aACpB;YAED,oEAAoE;YACpE,uDAAuD;YACvD,4EAA4E;YAC5E,0DAA0D;YAC1D,kFAAkF;YAClF;gBACE,0DAA0D;gBAC1D,mEAAmE;gBACnE,eAAe;gBACf,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;gBACzC,OAAO,EAAE;oBACP,cAAc,EAAE;wBACd,6CAA6C;wBAC7C,2DAA2D;wBAC3D,KAAK,EAAE,SAAS;wBAChB,OAAO,EAAE;4BACP,0CAA0C;4BAC1C,OAAO,CAAC,cAAc,CAAC;yBACxB;qBACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/lib/minification.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+import type { WebpackPluginInstance } from 'webpack';
+import type { CurrentBundler, FasterConfig } from '@docusaurus/types';
+export type MinimizersConfig = {
+    faster: Pick<FasterConfig, 'swcJsMinimizer' | 'lightningCssMinimizer'>;
+    currentBundler: CurrentBundler;
+};
+export declare function getMinimizers(params: MinimizersConfig): Promise<WebpackPluginInstance[]>;
+//# sourceMappingURL=minification.d.ts.map

package/lib/minification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minification.d.ts","sourceRoot":"","sources":["../src/minification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAC,cAAc,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,uBAAuB,CAAC,CAAC;IACvE,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAmJF,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAIlC"}

package/lib/minification.js

@@ -0,0 +1,147 @@
+"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.getMinimizers = getMinimizers;
+const tslib_1 = require("tslib");
+const terser_webpack_plugin_1 = tslib_1.__importDefault(require("terser-webpack-plugin"));
+const css_minimizer_webpack_plugin_1 = tslib_1.__importDefault(require("css-minimizer-webpack-plugin"));
+const importFaster_1 = require("./importFaster");
+const currentBundler_1 = require("./currentBundler");
+// See https://github.com/webpack-contrib/terser-webpack-plugin#parallel
+function getTerserParallel() {
+    let terserParallel = true;
+    if (process.env.TERSER_PARALLEL === 'false') {
+        terserParallel = false;
+    }
+    else if (process.env.TERSER_PARALLEL &&
+        parseInt(process.env.TERSER_PARALLEL, 10) > 0) {
+        terserParallel = parseInt(process.env.TERSER_PARALLEL, 10);
+    }
+    return terserParallel;
+}
+async function getJsMinimizer({ faster, }) {
+    if (faster.swcJsMinimizer) {
+        const terserOptions = await (0, importFaster_1.importSwcJsMinimizerOptions)();
+        return new terser_webpack_plugin_1.default({
+            parallel: getTerserParallel(),
+            minify: terser_webpack_plugin_1.default.swcMinify,
+            terserOptions,
+        });
+    }
+    return new terser_webpack_plugin_1.default({
+        parallel: getTerserParallel(),
+        // See https://terser.org/docs/options/
+        terserOptions: {
+            parse: {
+                // We want uglify-js to parse ecma 8 code. However, we don't want it
+                // to apply any minification steps that turns valid ecma 5 code
+                // into invalid ecma 5 code. This is why the 'compress' and 'output'
+                // sections only apply transformations that are ecma 5 safe
+                // https://github.com/facebook/create-react-app/pull/4234
+                ecma: 2020,
+            },
+            compress: {
+                ecma: 5,
+            },
+            mangle: {
+                safari10: true,
+            },
+            output: {
+                ecma: 5,
+                comments: false,
+                // Turned on because emoji and regex is not minified properly using
+                // default. See https://github.com/facebook/create-react-app/issues/2488
+                ascii_only: true,
+            },
+        },
+    });
+}
+async function getLightningCssMinimizer() {
+    return new css_minimizer_webpack_plugin_1.default({
+        minify: css_minimizer_webpack_plugin_1.default.lightningCssMinify,
+        minimizerOptions: await (0, importFaster_1.importLightningCssMinimizerOptions)(),
+    });
+}
+async function getCssNanoMinimizer() {
+    // This is an historical env variable to opt-out of the advanced minimizer
+    // Sometimes there's a bug in it and people are happy to disable it
+    const useSimpleCssMinifier = process.env.USE_SIMPLE_CSS_MINIFIER === 'true';
+    if (useSimpleCssMinifier) {
+        return new css_minimizer_webpack_plugin_1.default();
+    }
+    // Using the array syntax to add 2 minimizers
+    // see https://github.com/webpack-contrib/css-minimizer-webpack-plugin#array
+    return new css_minimizer_webpack_plugin_1.default({
+        minimizerOptions: [
+            // CssNano options
+            {
+                preset: require.resolve('@docusaurus/cssnano-preset'),
+            },
+            // CleanCss options
+            {
+                inline: false,
+                level: {
+                    1: {
+                        all: false,
+                        removeWhitespace: true,
+                    },
+                    2: {
+                        all: true,
+                        restructureRules: true,
+                        removeUnusedAtRules: false,
+                    },
+                },
+            },
+        ],
+        minify: [
+            css_minimizer_webpack_plugin_1.default.cssnanoMinify,
+            css_minimizer_webpack_plugin_1.default.cleanCssMinify,
+        ],
+    });
+}
+async function getCssMinimizer(params) {
+    return params.faster.lightningCssMinimizer
+        ? getLightningCssMinimizer()
+        : getCssNanoMinimizer();
+}
+async function getWebpackMinimizers(params) {
+    return Promise.all([getJsMinimizer(params), getCssMinimizer(params)]);
+}
+async function getRspackMinimizers({ currentBundler, }) {
+    const rspack = (0, currentBundler_1.getCurrentBundlerAsRspack)({ currentBundler });
+    const getBrowserslistQueries = await (0, importFaster_1.importGetBrowserslistQueries)();
+    const browserslistQueries = getBrowserslistQueries({ isServer: false });
+    const swcJsMinimizerOptions = await (0, importFaster_1.importSwcJsMinimizerOptions)();
+    return [
+        // See https://rspack.dev/plugins/rspack/swc-js-minimizer-rspack-plugin
+        // See https://swc.rs/docs/configuration/minification
+        new rspack.SwcJsMinimizerRspackPlugin({
+            minimizerOptions: {
+                minify: true,
+                ...swcJsMinimizerOptions,
+            },
+        }),
+        new rspack.LightningCssMinimizerRspackPlugin({
+            minimizerOptions: {
+                ...(await (0, importFaster_1.importLightningCssMinimizerOptions)()),
+                // Not sure why but Rspack takes browserslist queries directly
+                // While LightningCSS targets are normally not browserslist queries
+                // We have to override the option to avoid errors
+                // See https://rspack.dev/plugins/rspack/lightning-css-minimizer-rspack-plugin#minimizeroptions
+                // See https://lightningcss.dev/transpilation.html
+                targets: browserslistQueries,
+            },
+        }),
+    ];
+}
+async function getMinimizers(params) {
+    return params.currentBundler.name === 'rspack'
+        ? getRspackMinimizers(params)
+        : getWebpackMinimizers(params);
+}
+//# sourceMappingURL=minification.js.map

package/lib/minification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minification.js","sourceRoot":"","sources":["../src/minification.ts"],"names":[],"mappings":"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"}

package/lib/minifyHtml.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export type HtmlMinifierType = 'swc' | 'terser';
+export type HtmlMinifierResult = {
+    code: string;
+    warnings: string[];
+};
+export type HtmlMinifier = {
+    minify: (html: string) => Promise<HtmlMinifierResult>;
+};
+export declare function getHtmlMinifier({ type, }: {
+    type: HtmlMinifierType;
+}): Promise<HtmlMinifier>;
+//# sourceMappingURL=minifyHtml.d.ts.map

package/lib/minifyHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minifyHtml.d.ts","sourceRoot":"","sources":["../src/minifyHtml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AAMF,wBAAsB,eAAe,CAAC,EACpC,IAAI,GACL,EAAE;IACD,IAAI,EAAE,gBAAgB,CAAC;CACxB,GAAG,OAAO,CAAC,YAAY,CAAC,CASxB"}

package/lib/minifyHtml.js

@@ -0,0 +1,91 @@
+"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.getHtmlMinifier = getHtmlMinifier;
+const html_minifier_terser_1 = require("html-minifier-terser");
+const importFaster_1 = require("./importFaster");
+// Historical env variable
+const SkipHtmlMinification = process.env.SKIP_HTML_MINIFICATION === 'true';
+const NoopMinifier = {
+    minify: async (html) => ({ code: html, warnings: [] }),
+};
+async function getHtmlMinifier({ type, }) {
+    if (SkipHtmlMinification) {
+        return NoopMinifier;
+    }
+    if (type === 'swc') {
+        return getSwcMinifier();
+    }
+    else {
+        return getTerserMinifier();
+    }
+}
+// Minify html with https://github.com/DanielRuf/html-minifier-terser
+async function getTerserMinifier() {
+    return {
+        minify: async function minifyHtmlWithTerser(html) {
+            try {
+                const code = await (0, html_minifier_terser_1.minify)(html, {
+                    removeComments: false,
+                    removeRedundantAttributes: true,
+                    removeEmptyAttributes: true,
+                    removeScriptTypeAttributes: true,
+                    removeStyleLinkTypeAttributes: true,
+                    useShortDoctype: true,
+                    minifyJS: true,
+                });
+                return { code, warnings: [] };
+            }
+            catch (err) {
+                throw new Error(`HTML minification failed (Terser)`, {
+                    cause: err,
+                });
+            }
+        },
+    };
+}
+// Minify html with @swc/html
+// Not well-documented but fast!
+// See https://github.com/swc-project/swc/discussions/9616
+async function getSwcMinifier() {
+    const swcHtmlMinifier = await (0, importFaster_1.importSwcHtmlMinifier)();
+    return {
+        minify: async function minifyHtmlWithSwc(html) {
+            try {
+                const result = await swcHtmlMinifier(Buffer.from(html), {
+                    // Removing comments can lead to React hydration errors
+                    // See https://x.com/sebastienlorber/status/1841966927440478577
+                    removeComments: false,
+                    // TODO maybe it's fine to only keep <!-- --> React comments?
+                    preserveComments: [],
+                    // Sorting these attributes (class) can lead to React hydration errors
+                    sortSpaceSeparatedAttributeValues: false,
+                    sortAttributes: false,
+                    removeRedundantAttributes: 'all',
+                    removeEmptyAttributes: true,
+                    minifyJs: true,
+                    minifyJson: true,
+                    minifyCss: true,
+                });
+                const warnings = (result.errors ?? []).map((diagnostic) => {
+                    return `[HTML minifier diagnostic - ${diagnostic.level}] ${diagnostic.message} - ${JSON.stringify(diagnostic.span)}`;
+                });
+                return {
+                    code: result.code,
+                    warnings,
+                };
+            }
+            catch (err) {
+                throw new Error(`HTML minification failed (SWC)`, {
+                    cause: err,
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=minifyHtml.js.map

package/lib/minifyHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minifyHtml.js","sourceRoot":"","sources":["../src/minifyHtml.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAuBH,0CAaC;AAlCD,+DAAkE;AAClE,iDAAqD;AAErD,0BAA0B;AAC1B,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,MAAM,CAAC;AAa3E,MAAM,YAAY,GAAiB;IACjC,MAAM,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAC,CAAC;CAC7D,CAAC;AAEK,KAAK,UAAU,eAAe,CAAC,EACpC,IAAI,GAGL;IACC,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,KAAK,UAAU,iBAAiB;IAC9B,OAAO;QACL,MAAM,EAAE,KAAK,UAAU,oBAAoB,CAAC,IAAI;YAC9C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAA,6BAAkB,EAAC,IAAI,EAAE;oBAC1C,cAAc,EAAE,KAAK;oBACrB,yBAAyB,EAAE,IAAI;oBAC/B,qBAAqB,EAAE,IAAI;oBAC3B,0BAA0B,EAAE,IAAI;oBAChC,6BAA6B,EAAE,IAAI;oBACnC,eAAe,EAAE,IAAI;oBACrB,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;gBACH,OAAO,EAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE;oBACnD,KAAK,EAAE,GAAY;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6BAA6B;AAC7B,gCAAgC;AAChC,0DAA0D;AAC1D,KAAK,UAAU,cAAc;IAC3B,MAAM,eAAe,GAAG,MAAM,IAAA,oCAAqB,GAAE,CAAC;IACtD,OAAO;QACL,MAAM,EAAE,KAAK,UAAU,iBAAiB,CAAC,IAAI;YAC3C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACtD,uDAAuD;oBACvD,+DAA+D;oBAC/D,cAAc,EAAE,KAAK;oBACrB,6DAA6D;oBAC7D,gBAAgB,EAAE,EAAE;oBAEpB,sEAAsE;oBACtE,iCAAiC,EAAE,KAAK;oBACxC,cAAc,EAAE,KAAK;oBAErB,yBAAyB,EAAE,KAAK;oBAChC,qBAAqB,EAAE,IAAI;oBAC3B,QAAQ,EAAE,IAAI;oBACd,UAAU,EAAE,IAAI;oBAChB,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;gBAEH,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;oBACxD,OAAO,+BAA+B,UAAU,CAAC,KAAK,KACpD,UAAU,CAAC,OACb,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,CAAC,CAAC,CAAC;gBAEH,OAAO;oBACL,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,QAAQ;iBACT,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,EAAE;oBAChD,KAAK,EAAE,GAAY;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/bundler",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "description": "Docusaurus util package to abstract the current bundler.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,15 +18,45 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/logger": "3.5.2",
-    "@docusaurus/types": "3.5.2",
+    "@babel/core": "^7.25.9",
+    "@docusaurus/babel": "3.6.0",
+    "@docusaurus/cssnano-preset": "3.6.0",
+    "@docusaurus/logger": "3.6.0",
+    "@docusaurus/types": "3.6.0",
+    "@docusaurus/utils": "3.6.0",
+    "autoprefixer": "^10.4.14",
+    "babel-loader": "^9.2.1",
+    "clean-css": "^5.3.2",
     "copy-webpack-plugin": "^11.0.0",
+    "css-loader": "^6.8.1",
+    "css-minimizer-webpack-plugin": "^5.0.1",
+    "cssnano": "^6.1.2",
+    "file-loader": "^6.2.0",
+    "html-minifier-terser": "^7.2.0",
     "mini-css-extract-plugin": "^2.9.1",
+    "null-loader": "^4.0.1",
+    "postcss": "^8.4.26",
+    "postcss-loader": "^7.3.3",
+    "react-dev-utils": "^12.0.1",
+    "terser-webpack-plugin": "^5.3.9",
     "tslib": "^2.6.0",
-    "webpack": "^5.88.1",
+    "url-loader": "^4.1.1",
+    "webpack": "^5.95.0",
     "webpackbar": "^6.0.1"
   },
+  "peerDependencies": {
+    "@docusaurus/faster": "3.5.2"
+  },
+  "peerDependenciesMeta": {
+    "@docusaurus/faster": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@total-typescript/shoehorn": "^0.1.2"
+  },
   "engines": {
     "node": ">=18.0"
-  }
+  },
+  "gitHead": "05bba6d4f495ef6b0bec5d41453932bb97981830"
 }

package/src/compiler.ts

@@ -0,0 +1,87 @@
+/**
+ * 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.
+ */
+
+import {type Configuration} from 'webpack';
+import logger from '@docusaurus/logger';
+import formatWebpackMessages from 'react-dev-utils/formatWebpackMessages';
+import type webpack from 'webpack';
+import type {CurrentBundler} from '@docusaurus/types';
+
+export function formatStatsErrorMessage(
+  statsJson: ReturnType<webpack.Stats['toJson']> | undefined,
+): string | undefined {
+  if (statsJson?.errors?.length) {
+    // TODO formatWebpackMessages does not print stack-traces
+    // Also the error causal chain is lost here
+    // We log the stacktrace inside serverEntry.tsx for now (not ideal)
+    const {errors} = formatWebpackMessages(statsJson);
+    return errors
+      .map((str) => logger.red(str))
+      .join(`\n\n${logger.yellow('--------------------------')}\n\n`);
+  }
+  return undefined;
+}
+
+export function printStatsWarnings(
+  statsJson: ReturnType<webpack.Stats['toJson']> | undefined,
+): void {
+  if (statsJson?.warnings?.length) {
+    statsJson.warnings?.forEach((warning) => {
+      logger.warn(warning);
+    });
+  }
+}
+
+declare global {
+  interface Error {
+    /** @see https://webpack.js.org/api/node/#error-handling */
+    details?: unknown;
+  }
+}
+
+export function compile({
+  configs,
+  currentBundler,
+}: {
+  configs: Configuration[];
+  currentBundler: CurrentBundler;
+}): Promise<webpack.MultiStats> {
+  return new Promise((resolve, reject) => {
+    const compiler = currentBundler.instance(configs);
+    compiler.run((err, stats) => {
+      if (err) {
+        logger.error(err.stack ?? err);
+        if (err.details) {
+          logger.error(err.details);
+        }
+        reject(err);
+      }
+      // Let plugins consume all the stats
+      const errorsWarnings = stats?.toJson('errors-warnings');
+      if (stats?.hasErrors()) {
+        const statsErrorMessage = formatStatsErrorMessage(errorsWarnings);
+        reject(
+          new Error(
+            `Failed to compile due to Webpack errors.\n${statsErrorMessage}`,
+          ),
+        );
+      }
+      printStatsWarnings(errorsWarnings);
+
+      // Webpack 5 requires calling close() so that persistent caching works
+      // See https://github.com/webpack/webpack.js.org/pull/4775
+      compiler.close((errClose) => {
+        if (errClose) {
+          logger.error(`Error while closing Webpack compiler: ${errClose}`);
+          reject(errClose);
+        } else {
+          resolve(stats!);
+        }
+      });
+    });
+  });
+}

package/src/currentBundler.ts

@@ -0,0 +1,106 @@
+/**
+ * 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.
+ */
+
+import webpack from 'webpack';
+import WebpackBar from 'webpackbar';
+import MiniCssExtractPlugin from 'mini-css-extract-plugin';
+import CopyWebpackPlugin from 'copy-webpack-plugin';
+import {importRspack} from './importFaster';
+import type {FasterModule} from './importFaster';
+import type {CurrentBundler, DocusaurusConfig} from '@docusaurus/types';
+
+// We inject a site config slice because the Rspack flag might change place
+type SiteConfigSlice = {
+  future: {
+    experimental_faster: Pick<
+      DocusaurusConfig['future']['experimental_faster'],
+      'rspackBundler'
+    >;
+  };
+};
+
+function isRspack(siteConfig: SiteConfigSlice): boolean {
+  return siteConfig.future.experimental_faster.rspackBundler;
+}
+
+export async function getCurrentBundler({
+  siteConfig,
+}: {
+  siteConfig: SiteConfigSlice;
+}): Promise<CurrentBundler> {
+  if (isRspack(siteConfig)) {
+    return {
+      name: 'rspack',
+      instance: (await importRspack()) as unknown as typeof webpack,
+    };
+  }
+  return {
+    name: 'webpack',
+    instance: webpack,
+  };
+}
+
+export function getCurrentBundlerAsRspack({
+  currentBundler,
+}: {
+  currentBundler: CurrentBundler;
+}): FasterModule['rspack'] {
+  if (currentBundler.name !== 'rspack') {
+    throw new Error(
+      `Can't getCurrentBundlerAsRspack() because current bundler is ${currentBundler.name}`,
+    );
+  }
+  return currentBundler.instance as unknown as FasterModule['rspack'];
+}
+
+export async function getCSSExtractPlugin({
+  currentBundler,
+}: {
+  currentBundler: CurrentBundler;
+}): Promise<typeof MiniCssExtractPlugin> {
+  if (currentBundler.name === 'rspack') {
+    // @ts-expect-error: this exists only in Rspack
+    return currentBundler.instance.CssExtractRspackPlugin;
+  }
+  return MiniCssExtractPlugin;
+}
+
+export async function getCopyPlugin({
+  currentBundler,
+}: {
+  currentBundler: CurrentBundler;
+}): Promise<typeof CopyWebpackPlugin> {
+  if (currentBundler.name === 'rspack') {
+    // @ts-expect-error: this exists only in Rspack
+    return currentBundler.instance.CopyRspackPlugin;
+  }
+  return CopyWebpackPlugin;
+}
+
+export async function getProgressBarPlugin({
+  currentBundler,
+}: {
+  currentBundler: CurrentBundler;
+}): Promise<typeof WebpackBar> {
+  if (currentBundler.name === 'rspack') {
+    const rspack = getCurrentBundlerAsRspack({currentBundler});
+    class CustomRspackProgressPlugin extends rspack.ProgressPlugin {
+      constructor({name, color = 'green'}: {name?: string; color?: string}) {
+        // Unfortunately rspack.ProgressPlugin does not have name/color options
+        // See https://rspack.dev/plugins/webpack/progress-plugin
+        super({
+          prefix: name,
+          template: `● {prefix:.bold} {bar:50.${color}/white.dim} ({percent}%) {wide_msg:.dim}`,
+          progressChars: '■■',
+        });
+      }
+    }
+    return CustomRspackProgressPlugin as unknown as typeof WebpackBar;
+  }
+
+  return WebpackBar;
+}

package/src/importFaster.ts

@@ -0,0 +1,77 @@
+/**
+ * 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.
+ */
+
+import logger from '@docusaurus/logger';
+import type {
+  MinimizerOptions as JsMinimizerOptions,
+  CustomOptions,
+} from 'terser-webpack-plugin';
+import type {MinimizerOptions as CssMinimizerOptions} from 'css-minimizer-webpack-plugin';
+
+export type FasterModule = Awaited<typeof import('@docusaurus/faster')>;
+
+async function importFaster(): Promise<FasterModule> {
+  return import('@docusaurus/faster');
+}
+
+async function ensureFaster(): Promise<FasterModule> {
+  try {
+    return await importFaster();
+  } catch (error) {
+    throw new Error(
+      `To enable Docusaurus Faster options, your site must add the ${logger.name(
+        '@docusaurus/faster',
+      )} package as a dependency.`,
+      {cause: error},
+    );
+  }
+}
+
+export async function importRspack(): Promise<FasterModule['rspack']> {
+  const faster = await ensureFaster();
+  return faster.rspack;
+}
+
+export async function importSwcLoader(): Promise<string> {
+  const faster = await ensureFaster();
+  return faster.swcLoader;
+}
+
+export async function importGetSwcLoaderOptions(): Promise<
+  FasterModule['getSwcLoaderOptions']
+> {
+  const faster = await ensureFaster();
+  return faster.getSwcLoaderOptions;
+}
+
+export async function importSwcJsMinimizerOptions(): Promise<
+  JsMinimizerOptions<CustomOptions>
+> {
+  const faster = await ensureFaster();
+  return faster.getSwcJsMinimizerOptions() as JsMinimizerOptions<CustomOptions>;
+}
+
+export async function importSwcHtmlMinifier(): Promise<
+  ReturnType<FasterModule['getSwcHtmlMinifier']>
+> {
+  const faster = await ensureFaster();
+  return faster.getSwcHtmlMinifier();
+}
+
+export async function importGetBrowserslistQueries(): Promise<
+  FasterModule['getBrowserslistQueries']
+> {
+  const faster = await ensureFaster();
+  return faster.getBrowserslistQueries;
+}
+
+export async function importLightningCssMinimizerOptions(): Promise<
+  CssMinimizerOptions<CustomOptions>
+> {
+  const faster = await ensureFaster();
+  return faster.getLightningCssMinimizerOptions() as CssMinimizerOptions<CustomOptions>;
+}