@docusaurus/core 3.3.2 → 3.4.0

package/lib/server/i18n.js

@@ -10,8 +10,32 @@ exports.loadI18n = exports.getDefaultLocaleConfig = void 0;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const rtl_detect_1 = require("rtl-detect");
+function inferLanguageDisplayName(locale) {
+    const tryLocale = (l) => {
+        try {
+            return new Intl.DisplayNames(l, {
+                type: 'language',
+                fallback: 'code',
+            }).of(l);
+        }
+        catch (e) {
+            // This is to compensate "of()" that is a bit strict
+            // Looks like starting Node 22, this locale throws: "en-US-u-ca-buddhist"
+            // RangeError: invalid_argument
+            return null;
+        }
+    };
+    const parts = locale.split('-');
+    // This is a best effort, we try various locale forms that could give a result
+    return (tryLocale(locale) ??
+        tryLocale(`${parts[0]}-${parts[1]}`) ??
+        tryLocale(parts[0]));
+}
 function getDefaultLocaleLabel(locale) {
-    const languageName = new Intl.DisplayNames(locale, { type: 'language' }).of(locale);
+    const languageName = inferLanguageDisplayName(locale);
+    if (!languageName) {
+        return locale;
+    }
     return (languageName.charAt(0).toLocaleUpperCase(locale) + languageName.substring(1));
 }
 function getDefaultCalendar(localeStr) {
@@ -34,13 +58,18 @@ function getDefaultCalendar(localeStr) {
     return 'gregory';
 }
 function getDefaultLocaleConfig(locale) {
-    return {
-        label: getDefaultLocaleLabel(locale),
-        direction: (0, rtl_detect_1.getLangDir)(locale),
-        htmlLang: locale,
-        calendar: getDefaultCalendar(locale),
-        path: locale,
-    };
+    try {
+        return {
+            label: getDefaultLocaleLabel(locale),
+            direction: (0, rtl_detect_1.getLangDir)(locale),
+            htmlLang: locale,
+            calendar: getDefaultCalendar(locale),
+            path: locale,
+        };
+    }
+    catch (e) {
+        throw new Error(`Docusaurus couldn't get default locale config for ${locale}`, { cause: e });
+    }
 }
 exports.getDefaultLocaleConfig = getDefaultLocaleConfig;
 async function loadI18n(config, options) {

package/lib/server/site.js

@@ -21,6 +21,7 @@ const translations_1 = require("./translations/translations");
 const utils_2 = require("../utils");
 const codegen_1 = require("./codegen/codegen");
 const routes_1 = require("./routes");
+const storage_1 = require("./storage");
 /**
  * Loading context is the very first step in site building. Its params are
  * directly acquired from CLI options. It mainly loads `siteConfig` and the i18n
@@ -53,9 +54,11 @@ async function loadContext(params) {
     const localizationDir = path_1.default.resolve(siteDir, i18n.path, i18n.localeConfigs[i18n.currentLocale].path);
     const siteConfig = { ...initialSiteConfig, baseUrl };
     const codeTranslations = await (0, translations_1.loadSiteCodeTranslations)({ localizationDir });
+    const siteStorage = (0, storage_1.createSiteStorage)(siteConfig);
     return {
         siteDir,
         siteVersion,
+        siteStorage,
         generatedFilesDir,
         localizationDir,
         siteConfig,
@@ -69,8 +72,11 @@ async function loadContext(params) {
 exports.loadContext = loadContext;
 function createSiteProps(params) {
     const { plugins, routes, context } = params;
-    const { generatedFilesDir, siteDir, siteVersion, siteConfig, siteConfigPath, outDir, baseUrl, i18n, localizationDir, codeTranslations: siteCodeTranslations, } = context;
-    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)(plugins);
+    const { generatedFilesDir, siteDir, siteVersion, siteConfig, siteConfigPath, siteStorage, outDir, baseUrl, i18n, localizationDir, codeTranslations: siteCodeTranslations, } = context;
+    const { headTags, preBodyTags, postBodyTags } = (0, htmlTags_1.loadHtmlTags)({
+        plugins,
+        router: siteConfig.future.experimental_router,
+    });
     const siteMetadata = (0, siteMetadata_1.createSiteMetadata)({ plugins, siteVersion });
     const codeTranslations = {
         ...(0, translations_1.getPluginsDefaultCodeTranslations)({ plugins }),
@@ -83,6 +89,7 @@ function createSiteProps(params) {
         siteConfigPath,
         siteMetadata,
         siteVersion,
+        siteStorage,
         siteDir,
         outDir,
         baseUrl,
@@ -101,13 +108,14 @@ function createSiteProps(params) {
 // TODO global data should be part of site props?
 async function createSiteFiles({ site, globalData, }) {
     return utils_2.PerfLogger.async('Create site files', async () => {
-        const { props: { plugins, generatedFilesDir, siteConfig, siteMetadata, i18n, codeTranslations, routes, baseUrl, }, } = site;
+        const { props: { plugins, generatedFilesDir, siteConfig, siteMetadata, siteStorage, i18n, codeTranslations, routes, baseUrl, }, } = site;
         const clientModules = (0, clientModules_1.getAllClientModules)(plugins);
         await (0, codegen_1.generateSiteFiles)({
             generatedFilesDir,
             clientModules,
             siteConfig,
             siteMetadata,
+            siteStorage,
             i18n,
             codeTranslations,
             globalData,
@@ -125,7 +133,7 @@ async function createSiteFiles({ site, globalData, }) {
 async function loadSite(params) {
     const context = await utils_2.PerfLogger.async('Load context', () => loadContext(params));
     const { plugins, routes, globalData } = await (0, plugins_1.loadPlugins)(context);
-    const props = await createSiteProps({ plugins, routes, globalData, context });
+    const props = createSiteProps({ plugins, routes, globalData, context });
     const site = { props, params };
     await createSiteFiles({
         site,
@@ -147,7 +155,7 @@ async function reloadSitePlugin(site, pluginIdentifier) {
         plugins: site.props.plugins,
         context: site.props,
     });
-    const newProps = await createSiteProps({
+    const newProps = createSiteProps({
         plugins,
         routes,
         globalData,

package/lib/server/storage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 { DocusaurusConfig, SiteStorage } from '@docusaurus/types';
+type PartialFuture = Pick<DocusaurusConfig['future'], 'experimental_storage'>;
+type PartialConfig = Pick<DocusaurusConfig, 'url' | 'baseUrl'> & {
+    future: PartialFuture;
+};
+export declare function createSiteStorage(config: PartialConfig): SiteStorage;
+export {};

package/lib/server/storage.js

@@ -0,0 +1,36 @@
+"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.createSiteStorage = void 0;
+const utils_1 = require("@docusaurus/utils");
+const utils_common_1 = require("@docusaurus/utils-common");
+function automaticNamespace(config) {
+    const normalizedUrl = (0, utils_common_1.addTrailingSlash)((0, utils_1.normalizeUrl)([config.url, config.baseUrl]));
+    return (0, utils_1.simpleHash)(normalizedUrl, 3);
+}
+function getNamespaceString(config) {
+    if (config.future.experimental_storage.namespace === true) {
+        return automaticNamespace(config);
+    }
+    else if (config.future.experimental_storage.namespace === false) {
+        return null;
+    }
+    else {
+        return config.future.experimental_storage.namespace;
+    }
+}
+function createSiteStorage(config) {
+    const { type } = config.future.experimental_storage;
+    const namespaceString = getNamespaceString(config);
+    const namespace = namespaceString ? `-${namespaceString}` : '';
+    return {
+        type,
+        namespace,
+    };
+}
+exports.createSiteStorage = createSiteStorage;

package/lib/ssg.d.ts

@@ -30,3 +30,7 @@ export declare function generateStaticFiles({ pathnames, renderer, params, }: {
 }): Promise<{
     collectedData: SiteCollectedData;
 }>;
+export declare function generateHashRouterEntrypoint({ content, params, }: {
+    content: string;
+    params: SSGParams;
+}): Promise<void>;

package/lib/ssg.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateStaticFiles = exports.loadAppRenderer = void 0;
+exports.generateHashRouterEntrypoint = 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");
@@ -133,6 +133,14 @@ It might also require to wrap your client code in ${logger_1.default.code('useEf
     }
     return parts.join('\n');
 }
+async function generateHashRouterEntrypoint({ content, params, }) {
+    await writeStaticFile({
+        pathname: '/',
+        content,
+        params,
+    });
+}
+exports.generateHashRouterEntrypoint = generateHashRouterEntrypoint;
 async function writeStaticFile({ content, pathname, params, }) {
     function removeBaseUrl(p, baseUrl) {
         return baseUrl === '/' ? p : p.replace(new RegExp(`^${baseUrl}`), '/');

package/lib/templates/templates.d.ts

@@ -26,3 +26,6 @@ export declare function renderSSRTemplate({ params, result, }: {
     params: SSGParams;
     result: AppRenderResult;
 }): string;
+export declare function renderHashRouterTemplate({ params, }: {
+    params: SSGParams;
+}): string;

package/lib/templates/templates.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderSSRTemplate = exports.compileSSRTemplate = void 0;
+exports.renderHashRouterTemplate = 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");
@@ -61,3 +61,28 @@ function renderSSRTemplate({ params, result, }) {
     return ssrTemplate(data);
 }
 exports.renderSSRTemplate = renderSSRTemplate;
+function renderHashRouterTemplate({ params, }) {
+    const { 
+    // baseUrl,
+    headTags, preBodyTags, postBodyTags, manifest, DOCUSAURUS_VERSION, ssrTemplate, } = params;
+    const { scripts, stylesheets } = getScriptsAndStylesheets({
+        manifest,
+        modules: [],
+    });
+    const data = {
+        appHtml: '',
+        baseUrl: './',
+        htmlAttributes: '',
+        bodyAttributes: '',
+        headTags,
+        preBodyTags,
+        postBodyTags,
+        metaAttributes: [],
+        scripts,
+        stylesheets,
+        noIndex: false,
+        version: DOCUSAURUS_VERSION,
+    };
+    return ssrTemplate(data);
+}
+exports.renderHashRouterTemplate = renderHashRouterTemplate;

package/lib/webpack/base.js

@@ -79,7 +79,7 @@ async function createBaseConfig({ props, isServer, minify, }) {
             chunkFilename: isProd
                 ? 'assets/js/[name].[contenthash:8].js'
                 : '[name].js',
-            publicPath: baseUrl,
+            publicPath: siteConfig.future.experimental_router === 'hash' ? 'auto' : baseUrl,
             hashFunction: 'xxhash64',
         },
         // Don't throw warning when asset created is over 250kb

package/lib/webpack/client.js

@@ -9,7 +9,6 @@ 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 = tslib_1.__importDefault(require("webpack"));
@@ -18,21 +17,9 @@ const react_loadable_ssr_addon_v5_slorber_1 = tslib_1.__importDefault(require("r
 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");
 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);
-            }
-        });
-    }
-}
+const ForceTerminatePlugin_1 = tslib_1.__importDefault(require("./plugins/ForceTerminatePlugin"));
+const StaticDirectoriesCopyPlugin_1 = require("./plugins/StaticDirectoriesCopyPlugin");
 async function createBaseClientConfig({ props, hydrate, minify, }) {
     const baseConfig = await (0, base_1.createBaseConfig)({ props, isServer: false, minify });
     return (0, webpack_merge_1.default)(baseConfig, {
@@ -54,6 +41,7 @@ async function createBaseClientConfig({ props, hydrate, minify, }) {
             new webpackbar_1.default({
                 name: 'Client',
             }),
+            await (0, StaticDirectoriesCopyPlugin_1.createStaticDirectoriesCopyPlugin)({ props }),
         ],
     });
 }
@@ -93,11 +81,15 @@ exports.createStartClientConfig = createStartClientConfig;
 // client config when running "docusaurus build"
 async function createBuildClientConfig({ props, minify, bundleAnalyzer, }) {
     // Apply user webpack config.
-    const { generatedFilesDir } = props;
+    const { generatedFilesDir, siteConfig } = props;
+    const router = siteConfig.future.experimental_router;
+    // With the hash router, we don't hydrate the React app, even in build mode!
+    // This is because it will always be a client-rendered React app
+    const hydrate = router !== 'hash';
     const clientManifestPath = path_1.default.join(generatedFilesDir, 'client-manifest.json');
-    const config = (0, webpack_merge_1.default)(await createBaseClientConfig({ props, minify, hydrate: true }), {
+    const config = (0, webpack_merge_1.default)(await createBaseClientConfig({ props, minify, hydrate }), {
         plugins: [
-            new ForceTerminatePlugin(),
+            new ForceTerminatePlugin_1.default(),
             // Remove/clean build folders before building bundles.
             new CleanWebpackPlugin_1.default({ verbose: false }),
             // Visualize size of webpack output files with an interactive zoomable

package/lib/webpack/configure.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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, RuleSetRule } from 'webpack';
+import type { Plugin, LoadedPlugin } from '@docusaurus/types';
+/**
+ * Helper function to modify webpack config
+ * @param configureWebpack a webpack config or a function to modify config
+ * @param config initial webpack config
+ * @param isServer indicates if this is a server webpack configuration
+ * @param jsLoader custom js loader config
+ * @param content content loaded by the plugin
+ * @returns final/ modified webpack config
+ */
+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 executePluginsConfigureWebpack({ plugins, config, isServer, jsLoader, }: {
+    plugins: LoadedPlugin[];
+    config: Configuration;
+    isServer: boolean;
+    jsLoader: 'babel' | ((isServer: boolean) => RuleSetRule) | undefined;
+}): Configuration;

package/lib/webpack/configure.js

@@ -0,0 +1,100 @@
+"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.executePluginsConfigureWebpack = exports.applyConfigurePostCss = exports.applyConfigureWebpack = void 0;
+const webpack_merge_1 = require("webpack-merge");
+const utils_1 = require("./utils");
+/**
+ * Helper function to modify webpack config
+ * @param configureWebpack a webpack config or a function to modify config
+ * @param config initial webpack config
+ * @param isServer indicates if this is a server webpack configuration
+ * @param jsLoader custom js loader config
+ * @param content content loaded by the plugin
+ * @returns final/ modified webpack config
+ */
+function applyConfigureWebpack(configureWebpack, config, isServer, jsLoader, content) {
+    // Export some utility functions
+    const utils = {
+        getStyleLoaders: utils_1.getStyleLoaders,
+        getJSLoader: (0, utils_1.getCustomizableJSLoader)(jsLoader),
+    };
+    if (typeof configureWebpack === 'function') {
+        const { mergeStrategy, ...res } = configureWebpack(config, isServer, utils, content) ?? {};
+        const customizeRules = mergeStrategy ?? {};
+        return (0, webpack_merge_1.mergeWithCustomize)({
+            customizeArray: (0, webpack_merge_1.customizeArray)(customizeRules),
+            customizeObject: (0, webpack_merge_1.customizeObject)(customizeRules),
+        })(config, res);
+    }
+    return config;
+}
+exports.applyConfigureWebpack = applyConfigureWebpack;
+function applyConfigurePostCss(configurePostCss, config) {
+    // Not ideal heuristic but good enough for our use-case?
+    function isPostCssLoader(loader) {
+        return !!loader?.options?.postcssOptions;
+    }
+    // Does not handle all edge cases, but good enough for now
+    function overridePostCssOptions(entry) {
+        if (isPostCssLoader(entry)) {
+            entry.options.postcssOptions = configurePostCss(entry.options.postcssOptions);
+        }
+        else if (Array.isArray(entry.oneOf)) {
+            entry.oneOf.forEach((r) => {
+                if (r) {
+                    overridePostCssOptions(r);
+                }
+            });
+        }
+        else if (Array.isArray(entry.use)) {
+            entry.use
+                .filter((u) => typeof u === 'object')
+                .forEach((rule) => overridePostCssOptions(rule));
+        }
+    }
+    config.module?.rules?.forEach((rule) => overridePostCssOptions(rule));
+    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;
+}
+// Plugin Lifecycle - configureWebpack()
+function executePluginsConfigureWebpack({ plugins, config, isServer, jsLoader, }) {
+    // Step1 - Configure Webpack
+    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);
+        }
+    });
+    // Step2 - For client code, configure PostCSS
+    // The order matters! We want to configure PostCSS on loaders
+    // that were potentially added by configureWebpack
+    // See https://github.com/facebook/docusaurus/issues/10106
+    // Note: it's useless to configure postCSS for the server
+    if (!isServer) {
+        resultConfig = executePluginsConfigurePostCss({
+            plugins,
+            config: resultConfig,
+        });
+    }
+    return resultConfig;
+}
+exports.executePluginsConfigureWebpack = executePluginsConfigureWebpack;

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

@@ -0,0 +1,10 @@
+/**
+ * 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 webpack from 'webpack';
+export default class ForceTerminatePlugin implements webpack.WebpackPluginInstance {
+    apply(compiler: webpack.Compiler): void;
+}

package/lib/webpack/plugins/ForceTerminatePlugin.js

@@ -0,0 +1,25 @@
+"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 });
+const tslib_1 = require("tslib");
+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 {
+    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);
+            }
+        });
+    }
+}
+exports.default = ForceTerminatePlugin;

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

@@ -0,0 +1,11 @@
+/**
+ * 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 CopyWebpackPlugin from 'copy-webpack-plugin';
+import type { Props } from '@docusaurus/types';
+export declare function createStaticDirectoriesCopyPlugin({ props, }: {
+    props: Props;
+}): Promise<CopyWebpackPlugin | undefined>;

package/lib/webpack/plugins/StaticDirectoriesCopyPlugin.js

@@ -0,0 +1,39 @@
+"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.createStaticDirectoriesCopyPlugin = void 0;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
+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',
+        })),
+    });
+}
+exports.createStaticDirectoriesCopyPlugin = createStaticDirectoriesCopyPlugin;

package/lib/webpack/server.js

@@ -8,11 +8,9 @@
 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");
 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");
 async function createServerConfig(params) {
     const { props } = params;
@@ -41,34 +39,8 @@ async function createServerConfig(params) {
                 name: 'Server',
                 color: 'yellow',
             }),
-            await createStaticDirectoriesCopyPlugin(params),
         ].filter(Boolean),
     });
     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

@@ -7,7 +7,6 @@
 /// <reference types="node" />
 import webpack, { type Configuration, type RuleSetRule } from 'webpack';
 import type { TransformOptions } from '@babel/core';
-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?: {
@@ -22,27 +21,6 @@ export declare const getCustomizableJSLoader: (jsLoader?: 'babel' | ((isServer:
     isServer: boolean;
     babelOptions?: TransformOptions | string;
 }) => RuleSetRule;
-/**
- * Helper function to modify webpack config
- * @param configureWebpack a webpack config or a function to modify config
- * @param config initial webpack config
- * @param isServer indicates if this is a server webpack configuration
- * @param jsLoader custom js loader config
- * @param content content loaded by the plugin
- * @returns final/ modified webpack config
- */
-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 */