@docusaurus/core 3.3.2 → 3.5.0

package/lib/server/plugins/synthetic.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMDXFallbackPlugin = exports.createBootstrapPlugin = void 0;
+exports.createBootstrapPlugin = createBootstrapPlugin;
+exports.createMDXFallbackPlugin = createMDXFallbackPlugin;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 /**
@@ -50,7 +51,6 @@ function createBootstrapPlugin({ siteDir, siteConfig, }) {
         },
     };
 }
-exports.createBootstrapPlugin = createBootstrapPlugin;
 /**
  * Configure Webpack fallback mdx loader for md/mdx files out of content-plugin
  * folders. Adds a "fallback" mdx loader for mdx files that are not processed by
@@ -106,4 +106,3 @@ function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
         },
     };
 }
-exports.createMDXFallbackPlugin = createMDXFallbackPlugin;

package/lib/server/routes.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRoutesPaths = exports.handleDuplicateRoutes = void 0;
+exports.handleDuplicateRoutes = handleDuplicateRoutes;
+exports.getRoutesPaths = getRoutesPaths;
 const tslib_1 = require("tslib");
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
 const utils_1 = require("@docusaurus/utils");
@@ -28,7 +29,6 @@ function handleDuplicateRoutes(routes, onDuplicateRoutes) {
 This could lead to non-deterministic routing behavior.`;
     }
 }
-exports.handleDuplicateRoutes = handleDuplicateRoutes;
 /**
  * Old stuff
  * As far as I understand, this is what permits to SSG the 404.html file
@@ -50,4 +50,3 @@ function getRoutesPaths(routeConfigs, baseUrl) {
         ...(0, utils_1.flattenRoutes)(routeConfigs).map((r) => r.path),
     ];
 }
-exports.getRoutesPaths = getRoutesPaths;

package/lib/server/site.js

@@ -6,7 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reloadSitePlugin = exports.reloadSite = exports.loadSite = exports.loadContext = void 0;
+exports.loadContext = loadContext;
+exports.loadSite = loadSite;
+exports.reloadSite = reloadSite;
+exports.reloadSitePlugin = reloadSitePlugin;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
@@ -21,6 +24,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 +57,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,
@@ -66,11 +72,13 @@ async function loadContext(params) {
         codeTranslations,
     };
 }
-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 +91,7 @@ function createSiteProps(params) {
         siteConfigPath,
         siteMetadata,
         siteVersion,
+        siteStorage,
         siteDir,
         outDir,
         baseUrl,
@@ -101,13 +110,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 +135,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,
@@ -133,21 +143,19 @@ async function loadSite(params) {
     });
     return site;
 }
-exports.loadSite = loadSite;
 async function reloadSite(site) {
     // TODO this can be optimized, for example:
     //  - plugins loading same data as before should not recreate routes/bundles
     //  - codegen does not need to re-run if nothing changed
     return loadSite(site.params);
 }
-exports.reloadSite = reloadSite;
 async function reloadSitePlugin(site, pluginIdentifier) {
     const { plugins, routes, globalData } = await (0, plugins_1.reloadPlugin)({
         pluginIdentifier,
         plugins: site.props.plugins,
         context: site.props,
     });
-    const newProps = await createSiteProps({
+    const newProps = createSiteProps({
         plugins,
         routes,
         globalData,
@@ -161,4 +169,3 @@ async function reloadSitePlugin(site, pluginIdentifier) {
     await createSiteFiles({ site: newSite, globalData });
     return newSite;
 }
-exports.reloadSitePlugin = reloadSitePlugin;

package/lib/server/siteMetadata.js

@@ -6,7 +6,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSiteMetadata = exports.loadPluginVersion = exports.loadSiteVersion = void 0;
+exports.loadSiteVersion = loadSiteVersion;
+exports.loadPluginVersion = loadPluginVersion;
+exports.createSiteMetadata = createSiteMetadata;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -25,7 +27,6 @@ async function loadPackageJsonName(packageJsonPath) {
 async function loadSiteVersion(siteDir) {
     return loadPackageJsonVersion(path_1.default.join(siteDir, 'package.json'));
 }
-exports.loadSiteVersion = loadSiteVersion;
 async function loadPluginVersion(pluginPath, siteDir) {
     let potentialPluginPackageJsonDirectory = path_1.default.dirname(pluginPath);
     while (potentialPluginPackageJsonDirectory !== '/') {
@@ -50,7 +51,6 @@ async function loadPluginVersion(pluginPath, siteDir) {
     // script in the parent directory of the site.
     return { type: 'local' };
 }
-exports.loadPluginVersion = loadPluginVersion;
 /**
  * We want all `@docusaurus/*` packages to have the exact same version!
  * @see https://github.com/facebook/docusaurus/issues/3371
@@ -80,4 +80,3 @@ function createSiteMetadata({ siteVersion, plugins, }) {
     checkDocusaurusPackagesVersion(siteMetadata);
     return siteMetadata;
 }
-exports.createSiteMetadata = createSiteMetadata;

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,35 @@
+"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 = createSiteStorage;
+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,
+    };
+}

package/lib/server/translations/translations.js

@@ -6,7 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSiteCodeTranslations = exports.applyDefaultCodeTranslations = exports.getPluginsDefaultCodeTranslations = exports.loadPluginsDefaultCodeTranslationMessages = exports.mergeCodeTranslations = exports.localizePluginTranslationFile = exports.writePluginTranslations = exports.writeCodeTranslations = exports.readCodeTranslationFileContent = void 0;
+exports.readCodeTranslationFileContent = readCodeTranslationFileContent;
+exports.writeCodeTranslations = writeCodeTranslations;
+exports.writePluginTranslations = writePluginTranslations;
+exports.localizePluginTranslationFile = localizePluginTranslationFile;
+exports.mergeCodeTranslations = mergeCodeTranslations;
+exports.loadPluginsDefaultCodeTranslationMessages = loadPluginsDefaultCodeTranslationMessages;
+exports.getPluginsDefaultCodeTranslations = getPluginsDefaultCodeTranslations;
+exports.applyDefaultCodeTranslations = applyDefaultCodeTranslations;
+exports.loadSiteCodeTranslations = loadSiteCodeTranslations;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -85,7 +93,6 @@ function getCodeTranslationsFilePath(context) {
 async function readCodeTranslationFileContent(context) {
     return readTranslationFileContent(getCodeTranslationsFilePath(context));
 }
-exports.readCodeTranslationFileContent = readCodeTranslationFileContent;
 async function writeCodeTranslations(context, content, options) {
     return writeTranslationFileContent({
         filePath: getCodeTranslationsFilePath(context),
@@ -93,7 +100,6 @@ async function writeCodeTranslations(context, content, options) {
         options,
     });
 }
-exports.writeCodeTranslations = writeCodeTranslations;
 // We ask users to not provide any extension on purpose:
 // maybe some day we'll want to support multiple FS formats?
 // (json/yaml/toml/xml...)
@@ -124,7 +130,6 @@ async function writePluginTranslations({ localizationDir, plugin, translationFil
         options,
     });
 }
-exports.writePluginTranslations = writePluginTranslations;
 async function localizePluginTranslationFile({ localizationDir, plugin, translationFile, }) {
     const filePath = getPluginTranslationFilePath({
         plugin,
@@ -144,23 +149,19 @@ async function localizePluginTranslationFile({ localizationDir, plugin, translat
     }
     return translationFile;
 }
-exports.localizePluginTranslationFile = localizePluginTranslationFile;
 function mergeCodeTranslations(codeTranslations) {
     return codeTranslations.reduce((allCodeTranslations, current) => ({
         ...allCodeTranslations,
         ...current,
     }), {});
 }
-exports.mergeCodeTranslations = mergeCodeTranslations;
 async function loadPluginsDefaultCodeTranslationMessages(plugins) {
     const pluginsMessages = await Promise.all(plugins.map((plugin) => plugin.getDefaultCodeTranslationMessages?.() ?? {}));
     return mergeCodeTranslations(pluginsMessages);
 }
-exports.loadPluginsDefaultCodeTranslationMessages = loadPluginsDefaultCodeTranslationMessages;
 function getPluginsDefaultCodeTranslations({ plugins, }) {
     return mergeCodeTranslations(plugins.map((p) => p.defaultCodeTranslations));
 }
-exports.getPluginsDefaultCodeTranslations = getPluginsDefaultCodeTranslations;
 function applyDefaultCodeTranslations({ extractedCodeTranslations, defaultCodeMessages, }) {
     const unusedDefaultCodeMessages = lodash_1.default.difference(Object.keys(defaultCodeMessages), Object.keys(extractedCodeTranslations));
     if (unusedDefaultCodeMessages.length > 0) {
@@ -172,10 +173,8 @@ Please report this Docusaurus issue. name=${unusedDefaultCodeMessages}`;
         message: defaultCodeMessages[messageId] ?? messageTranslation.message,
     }));
 }
-exports.applyDefaultCodeTranslations = applyDefaultCodeTranslations;
 async function loadSiteCodeTranslations({ localizationDir, }) {
     const codeTranslationFileContent = (await readCodeTranslationFileContent({ localizationDir })) ?? {};
     // We only need key->message for code translations
     return lodash_1.default.mapValues(codeTranslationFileContent, (value) => value.message);
 }
-exports.loadSiteCodeTranslations = loadSiteCodeTranslations;

package/lib/server/translations/translationsExtractor.js

@@ -6,7 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractSourceCodeFileTranslations = exports.extractAllSourceCodeFileTranslations = exports.extractSiteSourceCodeTranslations = exports.globSourceCodeFilePaths = void 0;
+exports.globSourceCodeFilePaths = globSourceCodeFilePaths;
+exports.extractSiteSourceCodeTranslations = extractSiteSourceCodeTranslations;
+exports.extractAllSourceCodeFileTranslations = extractAllSourceCodeFileTranslations;
+exports.extractSourceCodeFileTranslations = extractSourceCodeFileTranslations;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
@@ -50,7 +53,6 @@ async function globSourceCodeFilePaths(dirPaths) {
     const filePaths = await (0, utils_2.safeGlobby)(dirPaths);
     return filePaths.filter(isTranslatableSourceCodePath);
 }
-exports.globSourceCodeFilePaths = globSourceCodeFilePaths;
 async function getSourceCodeFilePaths(siteDir, plugins) {
     const sitePaths = getSiteSourceCodeFilePaths(siteDir);
     // The getPathsToWatch() generally returns the js/jsx/ts/tsx/md/mdx file paths
@@ -76,7 +78,6 @@ async function extractSiteSourceCodeTranslations(siteDir, plugins, babelOptions,
     logSourceCodeFileTranslationsWarnings(sourceCodeFilesTranslations);
     return toTranslationFileContent(sourceCodeFilesTranslations);
 }
-exports.extractSiteSourceCodeTranslations = extractSiteSourceCodeTranslations;
 function logSourceCodeFileTranslationsWarnings(sourceCodeFilesTranslations) {
     sourceCodeFilesTranslations.forEach(({ sourceCodeFilePath, warnings }) => {
         if (warnings.length > 0) {
@@ -87,7 +88,6 @@ function logSourceCodeFileTranslationsWarnings(sourceCodeFilesTranslations) {
 async function extractAllSourceCodeFileTranslations(sourceCodeFilePaths, babelOptions) {
     return Promise.all(sourceCodeFilePaths.flatMap((sourceFilePath) => extractSourceCodeFileTranslations(sourceFilePath, babelOptions)));
 }
-exports.extractAllSourceCodeFileTranslations = extractAllSourceCodeFileTranslations;
 async function extractSourceCodeFileTranslations(sourceCodeFilePath, babelOptions) {
     try {
         const code = await fs_extra_1.default.readFile(sourceCodeFilePath, 'utf8');
@@ -107,7 +107,6 @@ async function extractSourceCodeFileTranslations(sourceCodeFilePath, babelOption
         throw err;
     }
 }
-exports.extractSourceCodeFileTranslations = extractSourceCodeFileTranslations;
 /*
 Need help understanding this?
 

package/lib/server/utils.js

@@ -6,7 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeGlobby = void 0;
+exports.safeGlobby = safeGlobby;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
 const utils_1 = require("@docusaurus/utils");
@@ -18,4 +18,3 @@ async function safeGlobby(patterns, options) {
     const globPaths = patterns.map((dirPath) => (0, utils_1.posixPath)(path_1.default.relative(process.cwd(), dirPath)));
     return (0, utils_1.Globby)(globPaths, options);
 }
-exports.safeGlobby = safeGlobby;

package/lib/ssg.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../src/deps.d.ts" />
 import type { AppRenderer, SiteCollectedData } from './common';
 import type { Manifest } from 'react-loadable-ssr-addon-v5-slorber';
 import type { SSRTemplateCompiled } from './templates/templates';
@@ -30,3 +29,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,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateStaticFiles = exports.loadAppRenderer = void 0;
+exports.loadAppRenderer = loadAppRenderer;
+exports.generateStaticFiles = generateStaticFiles;
+exports.generateHashRouterEntrypoint = generateHashRouterEntrypoint;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const module_1 = require("module");
@@ -49,7 +51,6 @@ async function loadAppRenderer({ serverBundlePath, }) {
     }
     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
@@ -92,7 +93,6 @@ async function generateStaticFiles({ pathnames, renderer, params, }) {
         .value();
     return { collectedData };
 }
-exports.generateStaticFiles = generateStaticFiles;
 async function generateStaticFile({ pathname, renderer, params, }) {
     try {
         // This only renders the app HTML
@@ -133,6 +133,13 @@ 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,
+    });
+}
 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,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderSSRTemplate = exports.compileSSRTemplate = void 0;
+exports.compileSSRTemplate = compileSSRTemplate;
+exports.renderSSRTemplate = renderSSRTemplate;
+exports.renderHashRouterTemplate = renderHashRouterTemplate;
 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");
@@ -16,7 +18,6 @@ async function compileSSRTemplate(template) {
     });
     return (data) => compiledTemplate(data, eta.defaultConfig);
 }
-exports.compileSSRTemplate = compileSSRTemplate;
 /**
  * Given a list of modules that were SSR an d
  * @param modules
@@ -60,4 +61,27 @@ 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);
+}

package/lib/webpack/aliases/index.js

@@ -6,7 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadDocusaurusAliases = exports.loadThemeAliases = exports.createAliasesForTheme = exports.sortAliases = void 0;
+exports.sortAliases = sortAliases;
+exports.createAliasesForTheme = createAliasesForTheme;
+exports.loadThemeAliases = loadThemeAliases;
+exports.loadDocusaurusAliases = loadDocusaurusAliases;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -30,7 +33,6 @@ function sortAliases(aliases) {
     alias1.includes(`${alias2}/`) ? -1 : alias2.includes(`${alias1}/`) ? 1 : 0);
     return Object.fromEntries(entries);
 }
-exports.sortAliases = sortAliases;
 async function createAliasesForTheme(themePath, addOriginalAlias) {
     if (!(await fs_extra_1.default.pathExists(themePath))) {
         return {};
@@ -52,7 +54,6 @@ async function createAliasesForTheme(themePath, addOriginalAlias) {
     });
     return sortAliases(aliases);
 }
-exports.createAliasesForTheme = createAliasesForTheme;
 async function createThemeAliases(themePaths, userThemePaths) {
     const aliases = {};
     for (const themePath of themePaths) {
@@ -84,7 +85,6 @@ function loadThemeAliases({ siteDir, plugins, }) {
     const userTheme = path_1.default.resolve(siteDir, utils_1.THEME_PATH);
     return createThemeAliases([ThemeFallbackDir, ...pluginThemes], [userTheme]);
 }
-exports.loadThemeAliases = loadThemeAliases;
 /**
  * Note: a `@docusaurus` alias would also catch `@docusaurus/theme-common`, so
  * instead of naively aliasing this to `client/exports`, we use fine-grained
@@ -103,4 +103,3 @@ async function loadDocusaurusAliases() {
     });
     return aliases;
 }
-exports.loadDocusaurusAliases = loadDocusaurusAliases;

package/lib/webpack/base.js

@@ -6,7 +6,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBaseConfig = exports.excludeJS = exports.clientDir = void 0;
+exports.clientDir = void 0;
+exports.excludeJS = excludeJS;
+exports.createBaseConfig = createBaseConfig;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -32,7 +34,6 @@ function excludeJS(modulePath) {
         !/docusaurus(?:(?!node_modules).)*\.jsx?$/.test(modulePath) &&
         !LibrariesToTranspileRegex.test(modulePath));
 }
-exports.excludeJS = excludeJS;
 async function createBaseConfig({ props, isServer, minify, }) {
     const { outDir, siteDir, siteConfig, siteConfigPath, baseUrl, generatedFilesDir, routesPaths, siteMetadata, plugins, } = props;
     const totalPages = routesPaths.length;
@@ -79,7 +80,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
@@ -212,4 +213,3 @@ async function createBaseConfig({ props, isServer, minify, }) {
         ],
     };
 }
-exports.createBaseConfig = createBaseConfig;

package/lib/webpack/client.js

@@ -6,10 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createBuildClientConfig = exports.createStartClientConfig = void 0;
+exports.createStartClientConfig = createStartClientConfig;
+exports.createBuildClientConfig = createBuildClientConfig;
 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 +18,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,7 +42,8 @@ async function createBaseClientConfig({ props, hydrate, minify, }) {
             new webpackbar_1.default({
                 name: 'Client',
             }),
-        ],
+            await (0, StaticDirectoriesCopyPlugin_1.createStaticDirectoriesCopyPlugin)({ props }),
+        ].filter(Boolean),
     });
 }
 // client config when running "docusaurus start"
@@ -89,15 +78,18 @@ async function createStartClientConfig({ props, minify, poll, }) {
     });
     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 { 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
@@ -111,4 +103,3 @@ async function createBuildClientConfig({ props, minify, bundleAnalyzer, }) {
     });
     return { config, clientManifestPath };
 }
-exports.createBuildClientConfig = createBuildClientConfig;

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;