@docusaurus/core 0.0.0-6081 → 0.0.0-6083

package/lib/webpack/configure.js

@@ -11,16 +11,15 @@ exports.applyConfigureWebpack = applyConfigureWebpack;
 exports.applyConfigurePostCss = applyConfigurePostCss;
 exports.executePluginsConfigureWebpack = executePluginsConfigureWebpack;
 const webpack_merge_1 = require("webpack-merge");
-const utils_1 = require("./utils");
-const currentBundler_1 = require("./currentBundler");
+const bundler_1 = require("@docusaurus/bundler");
 /**
  * Creates convenient utils to inject into the configureWebpack() lifecycle
  * @param config the Docusaurus config
  */
 async function createConfigureWebpackUtils({ siteConfig, }) {
-    const currentBundler = await (0, currentBundler_1.getCurrentBundler)({ siteConfig });
-    const getStyleLoaders = await (0, utils_1.createStyleLoadersFactory)({ currentBundler });
-    const getJSLoader = await (0, utils_1.createJsLoaderFactory)({ siteConfig });
+    const currentBundler = await (0, bundler_1.getCurrentBundler)({ siteConfig });
+    const getStyleLoaders = await (0, bundler_1.createStyleLoadersFactory)({ currentBundler });
+    const getJSLoader = await (0, bundler_1.createJsLoaderFactory)({ siteConfig });
     return {
         currentBundler,
         getStyleLoaders,

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,9 +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 type { CurrentBundler, Props } from '@docusaurus/types';
+import type { Props } from '@docusaurus/types';
 import type { WebpackPluginInstance } from 'webpack';
-export declare function createStaticDirectoriesCopyPlugin({ props, currentBundler, }: {
+export declare function createStaticDirectoriesCopyPlugin({ props, }: {
     props: Props;
-    currentBundler: CurrentBundler;
 }): Promise<WebpackPluginInstance | undefined>;

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -10,10 +10,10 @@ 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 currentBundler_1 = require("../currentBundler");
-async function createStaticDirectoriesCopyPlugin({ props, currentBundler, }) {
-    const CopyPlugin = await (0, currentBundler_1.getCopyPlugin)({
-        currentBundler,
+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

package/lib/webpack/server.js

@@ -11,7 +11,7 @@ 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({ props, configureWebpackUtils, }) {
     const baseConfig = await (0, base_1.createBaseConfig)({
@@ -21,6 +21,9 @@ async function createServerConfig({ props, configureWebpackUtils, }) {
         faster: props.siteConfig.future.experimental_faster,
         configureWebpackUtils,
     });
+    const ProgressBarPlugin = await (0, bundler_1.getProgressBarPlugin)({
+        currentBundler: props.currentBundler,
+    });
     const outputFilename = 'server.bundle.js';
     const outputDir = path_1.default.join(props.outDir, '__server');
     const serverBundlePath = path_1.default.join(outputDir, outputFilename);
@@ -35,8 +38,7 @@ async function createServerConfig({ props, configureWebpackUtils, }) {
             libraryTarget: 'commonjs2',
         },
         plugins: [
-            // Show compilation progress bar.
-            new webpackbar_1.default({
+            new ProgressBarPlugin({
                 name: 'Server',
                 color: 'yellow',
             }),

package/lib/{server/utils.d.ts → webpack/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 { Globby } from '@docusaurus/utils';
-export declare function safeGlobby(patterns: string[], options?: Globby.GlobbyOptions): Promise<string[]>;
+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": "0.0.0-6081",
+  "version": "0.0.0-6083",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,54 +33,32 @@
     "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": "0.0.0-6081",
-    "@docusaurus/logger": "0.0.0-6081",
-    "@docusaurus/mdx-loader": "0.0.0-6081",
-    "@docusaurus/utils": "0.0.0-6081",
-    "@docusaurus/utils-common": "0.0.0-6081",
-    "@docusaurus/utils-validation": "0.0.0-6081",
-    "autoprefixer": "^10.4.14",
-    "babel-loader": "^9.1.3",
-    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "@docusaurus/babel": "0.0.0-6083",
+    "@docusaurus/bundler": "0.0.0-6083",
+    "@docusaurus/logger": "0.0.0-6083",
+    "@docusaurus/mdx-loader": "0.0.0-6083",
+    "@docusaurus/utils": "0.0.0-6083",
+    "@docusaurus/utils-common": "0.0.0-6083",
+    "@docusaurus/utils-validation": "0.0.0-6083",
     "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",
     "leven": "^3.1.0",
     "lodash": "^4.17.21",
-    "mini-css-extract-plugin": "^2.7.6",
-    "null-loader": "^4.0.1",
     "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",
@@ -93,19 +71,16 @@
     "semver": "^7.5.4",
     "serve-handler": "npm:@docusaurus/serve-handler@6.2.0",
     "shelljs": "^0.8.5",
-    "terser-webpack-plugin": "^5.3.10",
     "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-merge": "^5.9.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-6081",
-    "@docusaurus/types": "0.0.0-6081",
+    "@docusaurus/module-type-aliases": "0.0.0-6083",
+    "@docusaurus/types": "0.0.0-6083",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/detect-port": "^1.3.3",
     "@types/react-dom": "^18.2.7",
@@ -132,5 +107,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "610c0dfb7990452f8e0eeb0c8bea792d0d0c0a0c"
+  "gitHead": "474967f4f49da90a1fca9f9034b0c054c5e29c7f"
 }

package/lib/faster.d.ts

@@ -1,10 +0,0 @@
-/**
- * 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 { ConfigureWebpackUtils } from '@docusaurus/types';
-import type { MinimizerOptions, CustomOptions } from 'terser-webpack-plugin';
-export declare function importSwcJsLoaderFactory(): Promise<ConfigureWebpackUtils['getJSLoader']>;
-export declare function importSwcJsMinifierOptions(): Promise<MinimizerOptions<CustomOptions>>;

package/lib/faster.js

@@ -1,29 +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.importSwcJsLoaderFactory = importSwcJsLoaderFactory;
-exports.importSwcJsMinifierOptions = importSwcJsMinifierOptions;
-async function importFaster() {
-    return import('@docusaurus/faster');
-}
-async function ensureFaster() {
-    try {
-        return await importFaster();
-    }
-    catch (error) {
-        throw new Error('Your Docusaurus site need to add the @docusaurus/faster package as a dependency.', { cause: error });
-    }
-}
-async function importSwcJsLoaderFactory() {
-    const faster = await ensureFaster();
-    return faster.getSwcJsLoaderFactory;
-}
-async function importSwcJsMinifierOptions() {
-    const faster = await ensureFaster();
-    return faster.getSwcJsMinifierOptions();
-}

package/lib/server/utils.js

@@ -1,20 +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.safeGlobby = safeGlobby;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const utils_1 = require("@docusaurus/utils");
-// Globby that fix Windows path patterns
-// See https://github.com/facebook/docusaurus/pull/4222#issuecomment-795517329
-async function safeGlobby(patterns, options) {
-    // Required for Windows support, as paths using \ should not be used by globby
-    // (also using the windows hard drive prefix like c: is not a good idea)
-    const globPaths = patterns.map((dirPath) => (0, utils_1.posixPath)(path_1.default.relative(process.cwd(), dirPath)));
-    return (0, utils_1.Globby)(globPaths, options);
-}

package/lib/webpack/currentBundler.d.ts

@@ -1,24 +0,0 @@
-/**
- * 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 MiniCssExtractPlugin from 'mini-css-extract-plugin';
-import CopyWebpackPlugin from 'copy-webpack-plugin';
-import type { CurrentBundler, DocusaurusConfig } from '@docusaurus/types';
-type SiteConfigSlice = {
-    future: {
-        experimental_faster: Pick<DocusaurusConfig['future']['experimental_faster'], 'rspackBundler'>;
-    };
-};
-export declare function getCurrentBundler({ siteConfig, }: {
-    siteConfig: SiteConfigSlice;
-}): Promise<CurrentBundler>;
-export declare function getCSSExtractPlugin({ currentBundler, }: {
-    currentBundler: CurrentBundler;
-}): Promise<typeof MiniCssExtractPlugin>;
-export declare function getCopyPlugin({ currentBundler, }: {
-    currentBundler: CurrentBundler;
-}): Promise<typeof CopyWebpackPlugin>;
-export {};

package/lib/webpack/currentBundler.js

@@ -1,42 +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.getCurrentBundler = getCurrentBundler;
-exports.getCSSExtractPlugin = getCSSExtractPlugin;
-exports.getCopyPlugin = getCopyPlugin;
-const tslib_1 = require("tslib");
-const webpack_1 = tslib_1.__importDefault(require("webpack"));
-const mini_css_extract_plugin_1 = tslib_1.__importDefault(require("mini-css-extract-plugin"));
-const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-function isRspack(siteConfig) {
-    return siteConfig.future.experimental_faster.rspackBundler;
-}
-async function getCurrentBundler({ siteConfig, }) {
-    if (isRspack(siteConfig)) {
-        // TODO add support for Rspack
-        logger_1.default.error('Rspack bundler is not supported yet, will use Webpack instead');
-    }
-    return {
-        name: 'webpack',
-        instance: webpack_1.default,
-    };
-}
-async function getCSSExtractPlugin({ currentBundler, }) {
-    if (currentBundler.name === 'rspack') {
-        throw new Error('Rspack bundler is not supported yet');
-    }
-    return mini_css_extract_plugin_1.default;
-}
-async function getCopyPlugin({ currentBundler, }) {
-    if (currentBundler.name === 'rspack') {
-        throw new Error('Rspack bundler is not supported yet');
-    }
-    // https://github.com/webpack-contrib/copy-webpack-plugin
-    return copy_webpack_plugin_1.default;
-}

package/lib/webpack/minification.d.ts

@@ -1,12 +0,0 @@
-/**
- * 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 { FasterConfig } from '@docusaurus/types';
-export type MinimizersConfig = {
-    faster: Pick<FasterConfig, 'swcJsMinimizer'>;
-};
-export declare function getMinimizers(params: MinimizersConfig): Promise<WebpackPluginInstance[]>;

package/lib/webpack/minification.js

@@ -1,106 +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.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 faster_1 = require("../faster");
-// 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, faster_1.importSwcJsMinifierOptions)();
-        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(),
-        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,
-            },
-        },
-    });
-}
-function getAdvancedCssMinifier() {
-    // 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,
-        ],
-    });
-}
-function getCssMinimizer() {
-    // This is an historical env variable to opt-out of the advanced minifier
-    // 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();
-    }
-    else {
-        return getAdvancedCssMinifier();
-    }
-}
-async function getMinimizers(params) {
-    return Promise.all([getJsMinimizer(params), getCssMinimizer()]);
-}

package/lib/webpack/utils.d.ts

@@ -1,38 +0,0 @@
-/**
- * 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, { type Configuration } from 'webpack';
-import type { ConfigureWebpackUtils, CurrentBundler, DocusaurusConfig } from '@docusaurus/types';
-import type { TransformOptions } from '@babel/core';
-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 createStyleLoadersFactory({ currentBundler, }: {
-    currentBundler: CurrentBundler;
-}): Promise<ConfigureWebpackUtils['getStyleLoaders']>;
-export declare function getCustomBabelConfigFilePath(siteDir: string): Promise<string | undefined>;
-export declare function getBabelOptions({ isServer, babelOptions, }?: {
-    isServer?: boolean;
-    babelOptions?: TransformOptions | string;
-}): TransformOptions;
-export declare function createJsLoaderFactory({ siteConfig, }: {
-    siteConfig: {
-        webpack?: DocusaurusConfig['webpack'];
-        future?: {
-            experimental_faster: DocusaurusConfig['future']['experimental_faster'];
-        };
-    };
-}): Promise<ConfigureWebpackUtils['getJSLoader']>;
-declare global {
-    interface Error {
-        /** @see https://webpack.js.org/api/node/#error-handling */
-        details: unknown;
-    }
-}
-export declare function compile(config: Configuration[]): Promise<webpack.MultiStats>;
-export declare function getHttpsConfig(): Promise<boolean | {
-    cert: Buffer;
-    key: Buffer;
-}>;