@docusaurus/core 3.1.0 → 3.2.0

package/lib/webpack/server.js

@@ -8,76 +8,67 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 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"));
 const webpackbar_1 = tslib_1.__importDefault(require("webpackbar"));
+const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
 const base_1 = require("./base");
-const WaitPlugin_1 = tslib_1.__importDefault(require("./plugins/WaitPlugin"));
-const ssr_html_template_1 = tslib_1.__importDefault(require("./templates/ssr.html.template"));
-async function createServerConfig({ props, onLinksCollected, onHeadTagsCollected, }) {
-    const { baseUrl, routesPaths, generatedFilesDir, headTags, preBodyTags, postBodyTags, siteConfig: { noIndex, trailingSlash, ssrTemplate }, } = props;
-    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) => {
-        const ssgPath = baseUrl === '/' ? str : str.replace(new RegExp(`^${baseUrl}`), '/');
-        routesLocation[ssgPath] = str;
-        return ssgPath;
+async function createServerConfig(params) {
+    const { props } = params;
+    const baseConfig = await (0, base_1.createBaseConfig)({
+        props,
+        isServer: true,
+        // Minification of server bundle reduces size but doubles bundle time :/
+        minify: false,
     });
-    const serverConfig = (0, webpack_merge_1.default)(config, {
+    const outputFilename = 'server.bundle.js';
+    const serverBundlePath = path_1.default.join(props.outDir, 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: {
-            filename: 'server.bundle.js',
+            filename: outputFilename,
             libraryTarget: 'commonjs2',
             // Workaround for Webpack 4 Bug (https://github.com/webpack/webpack/issues/6522)
             globalObject: 'this',
         },
         plugins: [
-            // Wait until manifest from client bundle is generated
-            new WaitPlugin_1.default({
-                filepath: path_1.default.join(generatedFilesDir, 'client-manifest.json'),
-            }),
-            // Static site generator webpack plugin.
-            new static_site_generator_webpack_plugin_1.default({
-                entry: 'main',
-                locals: {
-                    baseUrl,
-                    generatedFilesDir,
-                    routesLocation,
-                    headTags,
-                    preBodyTags,
-                    postBodyTags,
-                    onLinksCollected,
-                    onHeadTagsCollected,
-                    ssrTemplate: ssrTemplate ?? ssr_html_template_1.default,
-                    noIndex,
-                    DOCUSAURUS_VERSION: utils_1.DOCUSAURUS_VERSION,
-                },
-                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
-                globals: { __filename: '' },
-                // Secret way to set SSR plugin concurrency option
-                // Waiting for feedback before documenting this officially?
-                concurrency: process.env.DOCUSAURUS_SSR_CONCURRENCY
-                    ? parseInt(process.env.DOCUSAURUS_SSR_CONCURRENCY, 10)
-                    : undefined,
-            }),
             // Show compilation progress bar.
             new webpackbar_1.default({
                 name: 'Server',
                 color: 'yellow',
             }),
-        ],
+            await createStaticDirectoriesCopyPlugin(params),
+        ].filter(Boolean),
     });
-    return serverConfig;
+    return { config, serverBundlePath };
 }
 exports.default = createServerConfig;
+async function createStaticDirectoriesCopyPlugin({ props }) {
+    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
+    // just silently filter them out, because user could have never configured it
+    // in the first place (the default option should always "work").
+    const staticDirectories = (await Promise.all(staticDirectoriesOption.map(async (dir) => {
+        const staticDir = path_1.default.resolve(siteDir, dir);
+        if ((await fs_extra_1.default.pathExists(staticDir)) &&
+            (await fs_extra_1.default.readdir(staticDir)).length > 0) {
+            return staticDir;
+        }
+        return '';
+    }))).filter(Boolean);
+    if (staticDirectories.length === 0) {
+        return undefined;
+    }
+    return new copy_webpack_plugin_1.default({
+        patterns: staticDirectories.map((dir) => ({
+            from: dir,
+            to: outDir,
+            toType: 'dir',
+        })),
+    });
+}

package/lib/webpack/utils.d.ts

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 /// <reference types="node" />
-import webpack, { type Configuration, type RuleSetRule, type WebpackPluginInstance } from 'webpack';
+import webpack, { type Configuration, type RuleSetRule } from 'webpack';
 import type { TransformOptions } from '@babel/core';
-import type { Plugin } from '@docusaurus/types';
+import type { Plugin, LoadedPlugin } from '@docusaurus/types';
 export declare function formatStatsErrorMessage(statsJson: ReturnType<webpack.Stats['toJson']> | undefined): string | undefined;
 export declare function printStatsWarnings(statsJson: ReturnType<webpack.Stats['toJson']> | undefined): void;
 export declare function getStyleLoaders(isServer: boolean, cssOptionsArg?: {
@@ -33,15 +33,24 @@ export declare const getCustomizableJSLoader: (jsLoader?: "babel" | ((isServer:
  */
 export declare function applyConfigureWebpack(configureWebpack: NonNullable<Plugin['configureWebpack']>, config: Configuration, isServer: boolean, jsLoader: 'babel' | ((isServer: boolean) => RuleSetRule) | undefined, content: unknown): Configuration;
 export declare function applyConfigurePostCss(configurePostCss: NonNullable<Plugin['configurePostCss']>, config: Configuration): Configuration;
+export declare function executePluginsConfigurePostCss({ plugins, config, }: {
+    plugins: LoadedPlugin[];
+    config: Configuration;
+}): Configuration;
+export declare function executePluginsConfigureWebpack({ plugins, config, isServer, jsLoader, }: {
+    plugins: LoadedPlugin[];
+    config: Configuration;
+    isServer: boolean;
+    jsLoader: 'babel' | ((isServer: boolean) => RuleSetRule) | undefined;
+}): Configuration;
 declare global {
     interface Error {
         /** @see https://webpack.js.org/api/node/#error-handling */
         details: unknown;
     }
 }
-export declare function compile(config: Configuration[]): Promise<void>;
+export declare function compile(config: Configuration[]): Promise<webpack.MultiStats>;
 export declare function getHttpsConfig(): Promise<boolean | {
     cert: Buffer;
     key: Buffer;
 }>;
-export declare function getMinimizer(useSimpleCssMinifier?: boolean): WebpackPluginInstance[];

package/lib/webpack/utils.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMinimizer = exports.getHttpsConfig = exports.compile = exports.applyConfigurePostCss = exports.applyConfigureWebpack = exports.getCustomizableJSLoader = exports.getBabelOptions = exports.getCustomBabelConfigFilePath = exports.getStyleLoaders = exports.printStatsWarnings = exports.formatStatsErrorMessage = void 0;
+exports.getHttpsConfig = exports.compile = exports.executePluginsConfigureWebpack = exports.executePluginsConfigurePostCss = exports.applyConfigurePostCss = exports.applyConfigureWebpack = exports.getCustomizableJSLoader = exports.getBabelOptions = exports.getCustomBabelConfigFilePath = exports.getStyleLoaders = exports.printStatsWarnings = exports.formatStatsErrorMessage = 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"));
@@ -16,8 +16,6 @@ const utils_1 = require("@docusaurus/utils");
 const mini_css_extract_plugin_1 = tslib_1.__importDefault(require("mini-css-extract-plugin"));
 const webpack_merge_1 = require("webpack-merge");
 const webpack_1 = tslib_1.__importDefault(require("webpack"));
-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 formatWebpackMessages_1 = tslib_1.__importDefault(require("react-dev-utils/formatWebpackMessages"));
 function formatStatsErrorMessage(statsJson) {
     if (statsJson?.errors?.length) {
@@ -189,6 +187,31 @@ function applyConfigurePostCss(configurePostCss, config) {
     return config;
 }
 exports.applyConfigurePostCss = applyConfigurePostCss;
+// Plugin Lifecycle - configurePostCss()
+function executePluginsConfigurePostCss({ plugins, config, }) {
+    let resultConfig = config;
+    plugins.forEach((plugin) => {
+        const { configurePostCss } = plugin;
+        if (configurePostCss) {
+            resultConfig = applyConfigurePostCss(configurePostCss.bind(plugin), resultConfig);
+        }
+    });
+    return resultConfig;
+}
+exports.executePluginsConfigurePostCss = executePluginsConfigurePostCss;
+// Plugin Lifecycle - configureWebpack()
+function executePluginsConfigureWebpack({ plugins, config, isServer, jsLoader, }) {
+    let resultConfig = config;
+    plugins.forEach((plugin) => {
+        const { configureWebpack } = plugin;
+        if (configureWebpack) {
+            resultConfig = applyConfigureWebpack(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
+            resultConfig, isServer, jsLoader, plugin.content);
+        }
+    });
+    return resultConfig;
+}
+exports.executePluginsConfigureWebpack = executePluginsConfigureWebpack;
 function compile(config) {
     return new Promise((resolve, reject) => {
         const compiler = (0, webpack_1.default)(config);
@@ -215,7 +238,7 @@ function compile(config) {
                     reject(errClose);
                 }
                 else {
-                    resolve();
+                    resolve(stats);
                 }
             });
         });
@@ -269,82 +292,3 @@ async function getHttpsConfig() {
     return isHttps;
 }
 exports.getHttpsConfig = getHttpsConfig;
-// 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;
-}
-function getMinimizer(useSimpleCssMinifier = false) {
-    const minimizer = [
-        new terser_webpack_plugin_1.default({
-            parallel: getTerserParallel(),
-            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,
-                },
-            },
-        }),
-    ];
-    if (useSimpleCssMinifier) {
-        minimizer.push(new css_minimizer_webpack_plugin_1.default());
-    }
-    else {
-        minimizer.push(
-        // Using the array syntax to add 2 minimizers
-        // see https://github.com/webpack-contrib/css-minimizer-webpack-plugin#array
-        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,
-            ],
-        }));
-    }
-    return minimizer;
-}
-exports.getMinimizer = getMinimizer;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -43,14 +43,13 @@
     "@babel/runtime": "^7.22.6",
     "@babel/runtime-corejs3": "^7.22.6",
     "@babel/traverse": "^7.22.8",
-    "@docusaurus/cssnano-preset": "3.1.0",
-    "@docusaurus/logger": "3.1.0",
-    "@docusaurus/mdx-loader": "3.1.0",
+    "@docusaurus/cssnano-preset": "3.2.0",
+    "@docusaurus/logger": "3.2.0",
+    "@docusaurus/mdx-loader": "3.2.0",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "3.1.0",
-    "@docusaurus/utils-common": "3.1.0",
-    "@docusaurus/utils-validation": "3.1.0",
-    "@slorber/static-site-generator-webpack-plugin": "^4.0.7",
+    "@docusaurus/utils": "3.2.0",
+    "@docusaurus/utils-common": "3.2.0",
+    "@docusaurus/utils-validation": "3.2.0",
     "@svgr/webpack": "^6.5.1",
     "autoprefixer": "^10.4.14",
     "babel-loader": "^9.1.3",
@@ -71,6 +70,7 @@
     "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",
@@ -79,6 +79,7 @@
     "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",
@@ -104,8 +105,9 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.1.0",
-    "@docusaurus/types": "3.1.0",
+    "@docusaurus/module-type-aliases": "3.2.0",
+    "@docusaurus/types": "3.2.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",
@@ -124,5 +126,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "a5e675821f0e8b70b591fcebf19fd60a70d55548"
+  "gitHead": "5af143651b26b39761361acd96e9c5be7ba0cb25"
 }

package/lib/commands/start.js

@@ -1,212 +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.start = 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"));
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const utils_1 = require("@docusaurus/utils");
-const chokidar_1 = tslib_1.__importDefault(require("chokidar"));
-const html_webpack_plugin_1 = tslib_1.__importDefault(require("html-webpack-plugin"));
-const openBrowser_1 = tslib_1.__importDefault(require("react-dev-utils/openBrowser"));
-const WebpackDevServerUtils_1 = require("react-dev-utils/WebpackDevServerUtils");
-const evalSourceMapMiddleware_1 = tslib_1.__importDefault(require("react-dev-utils/evalSourceMapMiddleware"));
-const webpack_1 = tslib_1.__importDefault(require("webpack"));
-const webpack_dev_server_1 = tslib_1.__importDefault(require("webpack-dev-server"));
-const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
-const server_1 = require("../server");
-const client_1 = tslib_1.__importDefault(require("../webpack/client"));
-const utils_2 = require("../webpack/utils");
-const getHostPort_1 = require("../server/getHostPort");
-async function start(siteDirParam = '.', 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 = cliOptions.locale;
-    const siteDir = await fs_extra_1.default.realpath(siteDirParam);
-    logger_1.default.info('Starting the development server...');
-    function loadSite() {
-        return (0, server_1.load)({
-            siteDir,
-            config: cliOptions.config,
-            locale: cliOptions.locale,
-            localizePath: undefined, // Should this be configurable?
-        });
-    }
-    // Process all related files as a prop.
-    const props = await loadSite();
-    const protocol = process.env.HTTPS === 'true' ? 'https' : 'http';
-    const { host, port } = await (0, getHostPort_1.getHostPort)(cliOptions);
-    if (port === null) {
-        process.exit();
-    }
-    const { baseUrl, headTags, preBodyTags, postBodyTags } = props;
-    const urls = (0, WebpackDevServerUtils_1.prepareUrls)(protocol, host, port);
-    const openUrl = (0, utils_1.normalizeUrl)([urls.localUrlForBrowser, baseUrl]);
-    logger_1.default.success `Docusaurus website is running at: url=${openUrl}`;
-    // Reload files processing.
-    const reload = lodash_1.default.debounce(() => {
-        loadSite()
-            .then(({ baseUrl: newBaseUrl }) => {
-            const newOpenUrl = (0, utils_1.normalizeUrl)([urls.localUrlForBrowser, newBaseUrl]);
-            if (newOpenUrl !== openUrl) {
-                logger_1.default.success `Docusaurus website is running at: url=${newOpenUrl}`;
-            }
-        })
-            .catch((err) => {
-            logger_1.default.error(err.stack);
-        });
-    }, 500);
-    const { siteConfig, plugins, localizationDir } = props;
-    const normalizeToSiteDir = (filepath) => {
-        if (filepath && path_1.default.isAbsolute(filepath)) {
-            return (0, utils_1.posixPath)(path_1.default.relative(siteDir, filepath));
-        }
-        return (0, utils_1.posixPath)(filepath);
-    };
-    const pluginPaths = plugins
-        .flatMap((plugin) => plugin.getPathsToWatch?.() ?? [])
-        .filter(Boolean)
-        .map(normalizeToSiteDir);
-    const pathsToWatch = [...pluginPaths, props.siteConfigPath, localizationDir];
-    const pollingOptions = {
-        usePolling: !!cliOptions.poll,
-        interval: Number.isInteger(cliOptions.poll)
-            ? cliOptions.poll
-            : undefined,
-    };
-    const httpsConfig = await (0, utils_2.getHttpsConfig)();
-    const fsWatcher = chokidar_1.default.watch(pathsToWatch, {
-        cwd: siteDir,
-        ignoreInitial: true,
-        ...{ pollingOptions },
-    });
-    ['add', 'change', 'unlink', 'addDir', 'unlinkDir'].forEach((event) => fsWatcher.on(event, reload));
-    let config = (0, webpack_merge_1.default)(await (0, client_1.default)(props, cliOptions.minify, false), {
-        watchOptions: {
-            ignored: /node_modules\/(?!@docusaurus)/,
-            poll: cliOptions.poll,
-        },
-        infrastructureLogging: {
-            // Reduce log verbosity, see https://github.com/facebook/docusaurus/pull/5420#issuecomment-906613105
-            level: 'warn',
-        },
-        plugins: [
-            // Generates an `index.html` file with the <script> injected.
-            new html_webpack_plugin_1.default({
-                template: path_1.default.join(__dirname, '../webpack/templates/index.html.template.ejs'),
-                // So we can define the position where the scripts are injected.
-                inject: false,
-                filename: 'index.html',
-                title: siteConfig.title,
-                headTags,
-                preBodyTags,
-                postBodyTags,
-            }),
-        ],
-    });
-    // Plugin Lifecycle - configureWebpack and configurePostCss.
-    plugins.forEach((plugin) => {
-        const { configureWebpack, configurePostCss } = plugin;
-        if (configurePostCss) {
-            config = (0, utils_2.applyConfigurePostCss)(configurePostCss.bind(plugin), config);
-        }
-        if (configureWebpack) {
-            config = (0, utils_2.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
-            config, false, props.siteConfig.webpack?.jsLoader, plugin.content);
-        }
-    });
-    const compiler = (0, webpack_1.default)(config);
-    compiler.hooks.done.tap('done', (stats) => {
-        const errorsWarnings = stats.toJson('errors-warnings');
-        const statsErrorMessage = (0, utils_2.formatStatsErrorMessage)(errorsWarnings);
-        if (statsErrorMessage) {
-            console.error(statsErrorMessage);
-        }
-        (0, utils_2.printStatsWarnings)(errorsWarnings);
-        if (process.env.E2E_TEST) {
-            if (stats.hasErrors()) {
-                logger_1.default.error('E2E_TEST: Project has compiler errors.');
-                process.exit(1);
-            }
-            logger_1.default.success('E2E_TEST: Project can compile.');
-            process.exit(0);
-        }
-    });
-    // https://webpack.js.org/configuration/dev-server
-    const defaultDevServerConfig = {
-        hot: cliOptions.hotOnly ? 'only' : true,
-        liveReload: false,
-        client: {
-            progress: true,
-            overlay: {
-                warnings: false,
-                errors: true,
-            },
-            webSocketURL: {
-                hostname: '0.0.0.0',
-                port: 0,
-            },
-        },
-        headers: {
-            'access-control-allow-origin': '*',
-        },
-        devMiddleware: {
-            publicPath: baseUrl,
-            // Reduce log verbosity, see https://github.com/facebook/docusaurus/pull/5420#issuecomment-906613105
-            stats: 'summary',
-        },
-        static: siteConfig.staticDirectories.map((dir) => ({
-            publicPath: baseUrl,
-            directory: path_1.default.resolve(siteDir, dir),
-            watch: {
-                // Useful options for our own monorepo using symlinks!
-                // See https://github.com/webpack/webpack/issues/11612#issuecomment-879259806
-                followSymlinks: true,
-                ignored: /node_modules\/(?!@docusaurus)/,
-                ...{ pollingOptions },
-            },
-        })),
-        ...(httpsConfig && {
-            server: typeof httpsConfig === 'object'
-                ? {
-                    type: 'https',
-                    options: httpsConfig,
-                }
-                : 'https',
-        }),
-        historyApiFallback: {
-            rewrites: [{ from: /\/*/, to: baseUrl }],
-        },
-        allowedHosts: 'all',
-        host,
-        port,
-        setupMiddlewares: (middlewares, devServer) => {
-            // This lets us fetch source contents from webpack for the error overlay.
-            middlewares.unshift((0, evalSourceMapMiddleware_1.default)(devServer));
-            return middlewares;
-        },
-    };
-    // Allow plugin authors to customize/override devServer config
-    const devServerConfig = (0, webpack_merge_1.default)([defaultDevServerConfig, config.devServer].filter(Boolean));
-    const devServer = new webpack_dev_server_1.default(devServerConfig, compiler);
-    devServer.startCallback(() => {
-        if (cliOptions.open) {
-            (0, openBrowser_1.default)(openUrl);
-        }
-    });
-    ['SIGINT', 'SIGTERM'].forEach((sig) => {
-        process.on(sig, () => {
-            devServer.stop();
-            process.exit();
-        });
-    });
-}
-exports.start = start;