@docusaurus/core 3.1.0 → 3.2.0

package/lib/ssg.js

@@ -0,0 +1,167 @@
+"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.generateStaticFiles = exports.loadAppRenderer = void 0;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const module_1 = require("module");
+const path_1 = tslib_1.__importDefault(require("path"));
+const lodash_1 = tslib_1.__importDefault(require("lodash"));
+const eval_1 = tslib_1.__importDefault(require("eval"));
+const p_map_1 = tslib_1.__importDefault(require("p-map"));
+const html_minifier_terser_1 = require("html-minifier-terser");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("./utils");
+const templates_1 = require("./templates/templates");
+// Secret way to set SSR plugin concurrency option
+// Waiting for feedback before documenting this officially?
+const Concurrency = process.env.DOCUSAURUS_SSR_CONCURRENCY
+    ? parseInt(process.env.DOCUSAURUS_SSR_CONCURRENCY, 10)
+    : // Not easy to define a reasonable option default
+        // Will still be better than Infinity
+        // See also https://github.com/sindresorhus/p-map/issues/24
+        32;
+async function loadAppRenderer({ serverBundlePath, }) {
+    const source = await utils_1.PerfLogger.async(`Load server bundle`, () => fs_extra_1.default.readFile(serverBundlePath));
+    utils_1.PerfLogger.log(`Server bundle size = ${(source.length / 1024000).toFixed(3)} MB`);
+    const filename = path_1.default.basename(serverBundlePath);
+    const globals = {
+        // 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
+        __filename: '',
+        // This uses module.createRequire() instead of very old "require-like" lib
+        // See also: https://github.com/pierrec/node-eval/issues/33
+        require: (0, module_1.createRequire)(serverBundlePath),
+    };
+    const serverEntry = await utils_1.PerfLogger.async(`Evaluate server bundle`, () => (0, eval_1.default)(source, 
+    /* filename: */ filename, 
+    /* scope: */ globals, 
+    /* includeGlobals: */ true));
+    if (!serverEntry?.default || typeof serverEntry.default !== 'function') {
+        throw new Error(`Server bundle export from "${filename}" must be a function that renders the Docusaurus React app.`);
+    }
+    return serverEntry.default;
+}
+exports.loadAppRenderer = loadAppRenderer;
+function pathnameToFilename({ pathname, trailingSlash, }) {
+    const outputFileName = pathname.replace(/^[/\\]/, ''); // Remove leading slashes for webpack-dev-server
+    // Paths ending with .html are left untouched
+    if (/\.html?$/i.test(outputFileName)) {
+        return outputFileName;
+    }
+    // Legacy retro-compatible behavior
+    if (typeof trailingSlash === 'undefined') {
+        return path_1.default.join(outputFileName, 'index.html');
+    }
+    // New behavior: we can say if we prefer file/folder output
+    // Useful resource: https://github.com/slorber/trailing-slash-guide
+    if (pathname === '' || pathname.endsWith('/') || trailingSlash) {
+        return path_1.default.join(outputFileName, 'index.html');
+    }
+    return `${outputFileName}.html`;
+}
+async function generateStaticFiles({ pathnames, renderer, params, }) {
+    // Note that we catch all async errors on purpose
+    // Docusaurus presents all the SSG errors to the user, not just the first one
+    const results = await (0, p_map_1.default)(pathnames, async (pathname) => generateStaticFile({
+        pathname,
+        renderer,
+        params,
+    }).then((result) => ({ pathname, result, error: null }), (error) => ({ pathname, result: null, error: error })), { concurrency: Concurrency });
+    const [allSSGErrors, allSSGSuccesses] = lodash_1.default.partition(results, (r) => !!r.error);
+    if (allSSGErrors.length > 0) {
+        const message = `Docusaurus static site generation failed for ${allSSGErrors.length} path${allSSGErrors.length ? 's' : ''}:\n- ${allSSGErrors
+            .map((ssgError) => logger_1.default.path(ssgError.pathname))
+            .join('\n- ')}`;
+        // Note logging this error properly require using inspect(error,{depth})
+        // See https://github.com/nodejs/node/issues/51637
+        throw new Error(message, {
+            cause: new AggregateError(allSSGErrors.map((ssgError) => ssgError.error)),
+        });
+    }
+    const collectedData = lodash_1.default.chain(allSSGSuccesses)
+        .keyBy((success) => success.pathname)
+        .mapValues((ssgSuccess) => ssgSuccess.result.collectedData)
+        .value();
+    return { collectedData };
+}
+exports.generateStaticFiles = generateStaticFiles;
+async function generateStaticFile({ pathname, renderer, params, }) {
+    try {
+        // This only renders the app HTML
+        const result = await renderer({
+            pathname,
+        });
+        // This renders the full page HTML, including head tags...
+        const fullPageHtml = (0, templates_1.renderSSRTemplate)({
+            params,
+            result,
+        });
+        const content = await minifyHtml(fullPageHtml);
+        await writeStaticFile({
+            pathname,
+            content,
+            params,
+        });
+        return result;
+    }
+    catch (errorUnknown) {
+        const error = errorUnknown;
+        const tips = getSSGErrorTips(error);
+        const message = logger_1.default.interpolate `Can't render static file for pathname path=${pathname}${tips ? `\n\n${tips}` : ''}`;
+        throw new Error(message, {
+            cause: error,
+        });
+    }
+}
+function getSSGErrorTips(error) {
+    const parts = [];
+    const isNotDefinedErrorRegex = /(?:window|document|localStorage|navigator|alert|location|buffer|self) is not defined/i;
+    if (isNotDefinedErrorRegex.test(error.message)) {
+        parts.push(`It looks like you are using code that should run on the client-side only.
+To get around it, try using one of:
+- ${logger_1.default.code('<BrowserOnly>')} (${logger_1.default.url('https://docusaurus.io/docs/docusaurus-core/#browseronly')})
+- ${logger_1.default.code('ExecutionEnvironment')} (${logger_1.default.url('https://docusaurus.io/docs/docusaurus-core/#executionenvironment')}).
+It might also require to wrap your client code in ${logger_1.default.code('useEffect')} hook and/or import a third-party library dynamically (if any).`);
+    }
+    return parts.join('\n');
+}
+async function writeStaticFile({ content, pathname, params, }) {
+    function removeBaseUrl(p, baseUrl) {
+        return baseUrl === '/' ? p : p.replace(new RegExp(`^${baseUrl}`), '/');
+    }
+    const filename = pathnameToFilename({
+        pathname: removeBaseUrl(pathname, params.baseUrl),
+        trailingSlash: params.trailingSlash,
+    });
+    const filePath = path_1.default.join(params.outDir, filename);
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
+    await fs_extra_1.default.writeFile(filePath, content);
+}
+async function minifyHtml(html) {
+    try {
+        if (process.env.SKIP_HTML_MINIFICATION === 'true') {
+            return html;
+        }
+        // Minify html with https://github.com/DanielRuf/html-minifier-terser
+        return await (0, html_minifier_terser_1.minify)(html, {
+            removeComments: false,
+            removeRedundantAttributes: true,
+            removeEmptyAttributes: true,
+            removeScriptTypeAttributes: true,
+            removeStyleLinkTypeAttributes: true,
+            useShortDoctype: true,
+            minifyJS: true,
+        });
+    }
+    catch (err) {
+        throw new Error('HTML minification failed', { cause: err });
+    }
+}

package/lib/templates/templates.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 { SSGParams } from '../ssg';
+import type { AppRenderResult } from '../common';
+export type SSRTemplateData = {
+    appHtml: string;
+    baseUrl: string;
+    htmlAttributes: string;
+    bodyAttributes: string;
+    headTags: string;
+    preBodyTags: string;
+    postBodyTags: string;
+    metaAttributes: string[];
+    scripts: string[];
+    stylesheets: string[];
+    noIndex: boolean;
+    version: string;
+};
+export type SSRTemplateCompiled = (data: SSRTemplateData) => string;
+export declare function compileSSRTemplate(template: string): Promise<SSRTemplateCompiled>;
+export declare function renderSSRTemplate({ params, result, }: {
+    params: SSGParams;
+    result: AppRenderResult;
+}): string;

package/lib/templates/templates.js

@@ -0,0 +1,63 @@
+"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.renderSSRTemplate = exports.compileSSRTemplate = void 0;
+const tslib_1 = require("tslib");
+const eta = tslib_1.__importStar(require("eta"));
+const react_loadable_ssr_addon_v5_slorber_1 = require("react-loadable-ssr-addon-v5-slorber");
+async function compileSSRTemplate(template) {
+    const compiledTemplate = eta.compile(template.trim(), {
+        rmWhitespace: true,
+    });
+    return (data) => compiledTemplate(data, eta.defaultConfig);
+}
+exports.compileSSRTemplate = compileSSRTemplate;
+/**
+ * Given a list of modules that were SSR an d
+ * @param modules
+ * @param manifest
+ */
+function getScriptsAndStylesheets({ modules, manifest, }) {
+    // Get all required assets for this particular page
+    // based on client manifest information.
+    const modulesToBeLoaded = [...manifest.entrypoints, ...Array.from(modules)];
+    const bundles = (0, react_loadable_ssr_addon_v5_slorber_1.getBundles)(manifest, modulesToBeLoaded);
+    const stylesheets = (bundles.css ?? []).map((b) => b.file);
+    const scripts = (bundles.js ?? []).map((b) => b.file);
+    return { scripts, stylesheets };
+}
+function renderSSRTemplate({ params, result, }) {
+    const { baseUrl, headTags, preBodyTags, postBodyTags, manifest, noIndex, DOCUSAURUS_VERSION, ssrTemplate, } = params;
+    const { html: appHtml, collectedData: { modules, helmet }, } = result;
+    const { scripts, stylesheets } = getScriptsAndStylesheets({ manifest, modules });
+    const htmlAttributes = helmet.htmlAttributes.toString();
+    const bodyAttributes = helmet.bodyAttributes.toString();
+    const metaStrings = [
+        helmet.title.toString(),
+        helmet.meta.toString(),
+        helmet.link.toString(),
+        helmet.script.toString(),
+    ];
+    const metaAttributes = metaStrings.filter(Boolean);
+    const data = {
+        appHtml,
+        baseUrl,
+        htmlAttributes,
+        bodyAttributes,
+        headTags,
+        preBodyTags,
+        postBodyTags,
+        metaAttributes,
+        scripts,
+        stylesheets,
+        noIndex,
+        version: DOCUSAURUS_VERSION,
+    };
+    return ssrTemplate(data);
+}
+exports.renderSSRTemplate = renderSSRTemplate;

package/lib/utils.d.ts

@@ -0,0 +1,9 @@
+export declare const PerfDebuggingEnabled: boolean;
+type PerfLoggerAPI = {
+    start: (label: string) => void;
+    end: (label: string) => void;
+    log: (message: string) => void;
+    async: <Result>(label: string, asyncFn: () => Result | Promise<Result>) => Promise<Result>;
+};
+export declare const PerfLogger: PerfLoggerAPI;
+export {};

package/lib/utils.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerfLogger = exports.PerfDebuggingEnabled = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const async_hooks_1 = require("async_hooks");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+// For now this is a private env variable we use internally
+// But we'll want to expose this feature officially some day
+exports.PerfDebuggingEnabled = !!process.env.DOCUSAURUS_PERF_LOGGER;
+const Thresholds = {
+    min: 5,
+    yellow: 100,
+    red: 1000,
+};
+const PerfPrefix = logger_1.default.yellow(`[PERF] `);
+// This is what enables to "see the parent stack" for each log
+// Parent1 > Parent2 > Parent3 > child trace
+const ParentPrefix = new async_hooks_1.AsyncLocalStorage();
+function applyParentPrefix(label) {
+    const parentPrefix = ParentPrefix.getStore();
+    return parentPrefix ? `${parentPrefix} > ${label}` : label;
+}
+function createPerfLogger() {
+    if (!exports.PerfDebuggingEnabled) {
+        const noop = () => { };
+        return {
+            start: noop,
+            end: noop,
+            log: noop,
+            async: async (_label, asyncFn) => asyncFn(),
+        };
+    }
+    const formatDuration = (duration) => {
+        if (duration > Thresholds.red) {
+            return logger_1.default.red(`${(duration / 1000).toFixed(2)} seconds!`);
+        }
+        else if (duration > Thresholds.yellow) {
+            return logger_1.default.yellow(`${duration.toFixed(2)} ms`);
+        }
+        else {
+            return logger_1.default.green(`${duration.toFixed(2)} ms`);
+        }
+    };
+    const logDuration = (label, duration) => {
+        if (duration < Thresholds.min) {
+            return;
+        }
+        console.log(`${PerfPrefix + label} - ${formatDuration(duration)}`);
+    };
+    const start = (label) => performance.mark(label);
+    const end = (label) => {
+        const { duration } = performance.measure(label);
+        performance.clearMarks(label);
+        logDuration(applyParentPrefix(label), duration);
+    };
+    const log = (label) => console.log(PerfPrefix + applyParentPrefix(label));
+    const async = async (label, asyncFn) => {
+        const finalLabel = applyParentPrefix(label);
+        const before = performance.now();
+        const result = await ParentPrefix.run(finalLabel, () => asyncFn());
+        const duration = performance.now() - before;
+        logDuration(finalLabel, duration);
+        return result;
+    };
+    return {
+        start,
+        end,
+        log,
+        async,
+    };
+}
+exports.PerfLogger = createPerfLogger();

package/lib/webpack/base.d.ts

@@ -8,4 +8,8 @@ import type { Configuration } from 'webpack';
 import type { Props } from '@docusaurus/types';
 export declare const clientDir: string;
 export declare function excludeJS(modulePath: string): boolean;
-export declare function createBaseConfig(props: Props, isServer: boolean, minify?: boolean): Promise<Configuration>;
+export declare function createBaseConfig({ props, isServer, minify, }: {
+    props: Props;
+    isServer: boolean;
+    minify: boolean;
+}): Promise<Configuration>;

package/lib/webpack/base.js

@@ -13,6 +13,7 @@ const path_1 = tslib_1.__importDefault(require("path"));
 const mini_css_extract_plugin_1 = tslib_1.__importDefault(require("mini-css-extract-plugin"));
 const utils_1 = require("@docusaurus/utils");
 const utils_2 = require("./utils");
+const minification_1 = require("./minification");
 const aliases_1 = require("./aliases");
 const CSS_REGEX = /\.css$/i;
 const CSS_MODULE_REGEX = /\.module\.css$/i;
@@ -32,12 +33,11 @@ function excludeJS(modulePath) {
         !LibrariesToTranspileRegex.test(modulePath));
 }
 exports.excludeJS = excludeJS;
-async function createBaseConfig(props, isServer, minify = true) {
+async function createBaseConfig({ props, isServer, minify, }) {
     const { outDir, siteDir, siteConfig, siteConfigPath, baseUrl, generatedFilesDir, routesPaths, siteMetadata, plugins, } = props;
     const totalPages = routesPaths.length;
     const isProd = process.env.NODE_ENV === 'production';
-    const minimizeEnabled = minify && isProd && !isServer;
-    const useSimpleCssMinifier = process.env.USE_SIMPLE_CSS_MINIFIER === 'true';
+    const minimizeEnabled = minify && isProd;
     const fileLoaderUtils = (0, utils_1.getFileLoaderUtils)();
     const name = isServer ? 'server' : 'client';
     const mode = isProd ? 'production' : 'development';
@@ -124,9 +124,7 @@ async function createBaseConfig(props, isServer, minify = true) {
             // Only minimize client bundle in production because server bundle is only
             // used for static site generation
             minimize: minimizeEnabled,
-            minimizer: minimizeEnabled
-                ? (0, utils_2.getMinimizer)(useSimpleCssMinifier)
-                : undefined,
+            minimizer: minimizeEnabled ? (0, minification_1.getMinimizer)() : undefined,
             splitChunks: isServer
                 ? false
                 : {

package/lib/webpack/client.d.ts

@@ -6,4 +6,18 @@
  */
 import type { Props } from '@docusaurus/types';
 import type { Configuration } from 'webpack';
-export default function createClientConfig(props: Props, minify?: boolean, hydrate?: boolean): Promise<Configuration>;
+export declare function createStartClientConfig({ props, minify, poll, }: {
+    props: Props;
+    minify: boolean;
+    poll: number | boolean | undefined;
+}): Promise<{
+    clientConfig: Configuration;
+}>;
+export declare function createBuildClientConfig({ props, minify, bundleAnalyzer, }: {
+    props: Props;
+    minify: boolean;
+    bundleAnalyzer: boolean;
+}): Promise<{
+    config: Configuration;
+    clientManifestPath: string;
+}>;

package/lib/webpack/client.js

@@ -6,19 +6,36 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBuildClientConfig = exports.createStartClientConfig = void 0;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
 const webpackbar_1 = tslib_1.__importDefault(require("webpackbar"));
-const webpack_1 = require("webpack");
+const webpack_1 = tslib_1.__importDefault(require("webpack"));
+const webpack_bundle_analyzer_1 = require("webpack-bundle-analyzer");
+const react_loadable_ssr_addon_v5_slorber_1 = tslib_1.__importDefault(require("react-loadable-ssr-addon-v5-slorber"));
+const html_webpack_plugin_1 = tslib_1.__importDefault(require("html-webpack-plugin"));
 const base_1 = require("./base");
 const ChunkAssetPlugin_1 = tslib_1.__importDefault(require("./plugins/ChunkAssetPlugin"));
 const utils_1 = require("./utils");
-async function createClientConfig(props, minify = true, hydrate = true) {
-    const isBuilding = process.argv[2] === 'build';
-    const config = await (0, base_1.createBaseConfig)(props, false, minify);
-    const clientConfig = (0, webpack_merge_1.default)(config, {
+const CleanWebpackPlugin_1 = tslib_1.__importDefault(require("./plugins/CleanWebpackPlugin"));
+// When building, include the plugin to force terminate building if errors
+// happened in the client bundle.
+class ForceTerminatePlugin {
+    apply(compiler) {
+        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)}`);
+                process.exit(1);
+            }
+        });
+    }
+}
+async function createBaseClientConfig({ props, hydrate, minify, }) {
+    const baseConfig = await (0, base_1.createBaseConfig)({ props, isServer: false, minify });
+    return (0, webpack_merge_1.default)(baseConfig, {
         // Useless, disabled on purpose (errors on existing sites with no
         // browserslist config)
         // target: 'browserslist',
@@ -29,7 +46,7 @@ async function createClientConfig(props, minify = true, hydrate = true) {
             runtimeChunk: true,
         },
         plugins: [
-            new webpack_1.DefinePlugin({
+            new webpack_1.default.DefinePlugin({
                 'process.env.HYDRATE_CLIENT_ENTRY': JSON.stringify(hydrate),
             }),
             new ChunkAssetPlugin_1.default(),
@@ -39,21 +56,59 @@ async function createClientConfig(props, minify = true, hydrate = true) {
             }),
         ],
     });
-    // When building, include the plugin to force terminate building if errors
-    // happened in the client bundle.
-    if (isBuilding) {
-        clientConfig.plugins?.push({
-            apply: (compiler) => {
-                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)}`);
-                        process.exit(1);
-                    }
-                });
-            },
-        });
-    }
-    return clientConfig;
 }
-exports.default = createClientConfig;
+// client config when running "docusaurus start"
+async function createStartClientConfig({ props, minify, poll, }) {
+    const { siteConfig, headTags, preBodyTags, postBodyTags } = props;
+    const clientConfig = (0, webpack_merge_1.default)(await createBaseClientConfig({
+        props,
+        minify,
+        hydrate: false,
+    }), {
+        watchOptions: {
+            ignored: /node_modules\/(?!@docusaurus)/,
+            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, '../templates/dev.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,
+            }),
+        ],
+    });
+    return { clientConfig };
+}
+exports.createStartClientConfig = createStartClientConfig;
+// client config when running "docusaurus build"
+async function createBuildClientConfig({ props, minify, bundleAnalyzer, }) {
+    // Apply user webpack config.
+    const { generatedFilesDir } = props;
+    const clientManifestPath = path_1.default.join(generatedFilesDir, 'client-manifest.json');
+    const config = (0, webpack_merge_1.default)(await createBaseClientConfig({ props, minify, hydrate: true }), {
+        plugins: [
+            new ForceTerminatePlugin(),
+            // Remove/clean build folders before building bundles.
+            new CleanWebpackPlugin_1.default({ verbose: false }),
+            // Visualize size of webpack output files with an interactive zoomable
+            // tree map.
+            bundleAnalyzer && new webpack_bundle_analyzer_1.BundleAnalyzerPlugin(),
+            // Generate client manifests file that will be used for server bundle.
+            new react_loadable_ssr_addon_v5_slorber_1.default({
+                filename: clientManifestPath,
+            }),
+        ].filter((x) => Boolean(x)),
+    });
+    return { config, clientManifestPath };
+}
+exports.createBuildClientConfig = createBuildClientConfig;

package/lib/webpack/minification.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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';
+export declare function getMinimizer(): WebpackPluginInstance[];

package/lib/webpack/minification.js

@@ -0,0 +1,97 @@
+"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.getMinimizer = void 0;
+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"));
+// 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 getJsMinifierPlugin() {
+    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 getMinimizer() {
+    // 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';
+    const minimizer = [getJsMinifierPlugin()];
+    if (useSimpleCssMinifier) {
+        minimizer.push(new css_minimizer_webpack_plugin_1.default());
+    }
+    else {
+        minimizer.push(getAdvancedCssMinifier());
+    }
+    return minimizer;
+}
+exports.getMinimizer = getMinimizer;

package/lib/webpack/server.d.ts

@@ -4,9 +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 Locals } from '@slorber/static-site-generator-webpack-plugin';
 import type { Props } from '@docusaurus/types';
 import type { Configuration } from 'webpack';
-export default function createServerConfig({ props, onLinksCollected, onHeadTagsCollected, }: Pick<Locals, 'onLinksCollected' | 'onHeadTagsCollected'> & {
+export default function createServerConfig(params: {
     props: Props;
-}): Promise<Configuration>;
+}): Promise<{
+    config: Configuration;
+    serverBundlePath: string;
+}>;