@docusaurus/core 0.0.0-4523 → 0.0.0-4524

package/lib/babel/preset.js

@@ -11,7 +11,8 @@ const path_1 = (0, tslib_1.__importDefault)(require("path"));
 function getTransformOptions(isServer) {
     const absoluteRuntimePath = path_1.default.dirname(require.resolve(`@babel/runtime/package.json`));
     return {
-        // All optional newlines and whitespace will be omitted when generating code in compact mode
+        // All optional newlines and whitespace will be omitted when generating code
+        // in compact mode
         compact: true,
         presets: [
             isServer
@@ -46,9 +47,9 @@ function getTransformOptions(isServer) {
                 {
                     corejs: false,
                     helpers: true,
-                    // By default, it assumes @babel/runtime@7.0.0. Since we use >7.0.0, better to
-                    // explicitly specify the version so that it can reuse the helper better
-                    // See https://github.com/babel/babel/issues/10261
+                    // By default, it assumes @babel/runtime@7.0.0. Since we use >7.0.0,
+                    // better to explicitly specify the version so that it can reuse the
+                    // helper better. See https://github.com/babel/babel/issues/10261
                     // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
                     version: require('@babel/runtime/package.json').version,
                     regenerator: true,

package/lib/client/PendingNavigation.d.ts

@@ -23,9 +23,9 @@ declare class PendingNavigation extends React.Component<Props, State> {
     progressBarTimeout: NodeJS.Timeout | null;
     constructor(props: Props);
     shouldComponentUpdate(nextProps: Props, nextState: State): boolean;
-    clearProgressBarTimeout(): void;
-    startProgressBar(delay: number): void;
-    stopProgressBar(): void;
+    private clearProgressBarTimeout;
+    private startProgressBar;
+    private stopProgressBar;
     render(): JSX.Element;
 }
 declare const _default: React.ComponentClass<Pick<Props, "routes" | "delay">, any> & import("react-router").WithRouterStatics<typeof PendingNavigation>;

package/lib/client/PendingNavigation.js

@@ -27,8 +27,8 @@ class PendingNavigation extends React.Component {
     shouldComponentUpdate(nextProps, nextState) {
         const routeDidChange = nextProps.location !== this.props.location;
         const { routes, delay } = this.props;
-        // If `routeDidChange` is true, means the router is trying to navigate to a new
-        // route. We will preload the new route.
+        // If `routeDidChange` is true, means the router is trying to navigate to a
+        // new route. We will preload the new route.
         if (routeDidChange) {
             const nextLocation = normalizeLocation(nextProps.location);
             this.startProgressBar(delay);

package/lib/client/baseUrlIssueBanner/BaseUrlIssueBanner.d.ts

@@ -11,4 +11,12 @@ declare global {
         __DOCUSAURUS_INSERT_BASEURL_BANNER: boolean;
     }
 }
+/**
+ * We want to help the users with a bad baseUrl configuration (very common
+ * error) Help message is inlined, and hidden if JS or CSS is able to load
+ * Note: it might create false positives (ie network failures): not a big deal
+ * Note: we only inline this for the homepage to avoid polluting all the site's
+ * pages
+ * @see https://github.com/facebook/docusaurus/pull/3621
+ */
 export default function BaseUrlIssueBanner(): JSX.Element | null;

package/lib/client/baseUrlIssueBanner/BaseUrlIssueBanner.js

@@ -74,11 +74,14 @@ function BaseUrlIssueBannerEnabled() {
       <div id={BannerContainerId}/>
     </>);
 }
-// We want to help the users with a bad baseUrl configuration (very common error)
-// Help message is inlined, and hidden if JS or CSS is able to load
-// Note: it might create false positives (ie network failures): not a big deal
-// Note: we only inline this for the homepage to avoid polluting all the site's pages
-// See https://github.com/facebook/docusaurus/pull/3621
+/**
+ * We want to help the users with a bad baseUrl configuration (very common
+ * error) Help message is inlined, and hidden if JS or CSS is able to load
+ * Note: it might create false positives (ie network failures): not a big deal
+ * Note: we only inline this for the homepage to avoid polluting all the site's
+ * pages
+ * @see https://github.com/facebook/docusaurus/pull/3621
+ */
 export default function BaseUrlIssueBanner() {
     const { siteConfig: { baseUrl, baseUrlIssueBanner }, } = useDocusaurusContext();
     const { pathname } = useLocation();

package/lib/client/clientEntry.js

@@ -12,12 +12,14 @@ import ExecutionEnvironment from './exports/ExecutionEnvironment';
 import App from './App';
 import preload from './preload';
 import docusaurus from './docusaurus';
-// Client-side render (e.g: running in browser) to become single-page application (SPA).
+// Client-side render (e.g: running in browser) to become single-page
+// application (SPA).
 if (ExecutionEnvironment.canUseDOM) {
     window.docusaurus = docusaurus;
-    // For production, attempt to hydrate existing markup for performant first-load experience.
+    // For production, attempt to hydrate existing markup for performant
+    // first-load experience.
     // For development, there is no existing markup so we had to render it.
-    // Note that we also preload async component to avoid first-load loading screen.
+    // We also preload async component to avoid first-load loading screen.
     const renderMethod = process.env.NODE_ENV === 'production' ? hydrate : render;
     preload(routes, window.location.pathname).then(() => {
         renderMethod(<BrowserRouter>

package/lib/client/docusaurus.js

@@ -41,11 +41,13 @@ const docusaurus = {
         const chunkNamesNeeded = matches.flatMap((match) => getChunkNamesToLoad(match.route.path));
         // Prefetch all webpack chunk assets file needed.
         chunkNamesNeeded.forEach((chunkName) => {
-            // "__webpack_require__.gca" is a custom function provided by ChunkAssetPlugin.
-            // Pass it the chunkName or chunkId you want to load and it will return the URL for that chunk.
+            // "__webpack_require__.gca" is a custom function provided by
+            // ChunkAssetPlugin. Pass it the chunkName or chunkId you want to load and
+            // it will return the URL for that chunk.
             // eslint-disable-next-line camelcase
             const chunkAsset = __webpack_require__.gca(chunkName);
-            // In some cases, webpack might decide to optimize further & hence the chunk assets are merged to another chunk/previous chunk.
+            // In some cases, webpack might decide to optimize further & hence the
+            // chunk assets are merged to another chunk/previous chunk.
             // Hence, we can safely filter it out/don't need to load it.
             if (chunkAsset && !/undefined/.test(chunkAsset)) {
                 prefetchHelper(chunkAsset);

package/lib/client/exports/ComponentCreator.js

@@ -32,7 +32,10 @@ function ComponentCreator(path, hash) {
         content.foo: () => import('./doc1.md'),
       }
     - optsModules: ['./Pages.js', './doc1.md']
-    - optsWebpack: [require.resolveWeak('./Pages.js'), require.resolveWeak('./doc1.md')]
+    - optsWebpack: [
+        require.resolveWeak('./Pages.js'),
+        require.resolveWeak('./doc1.md'),
+      ]
     */
     const flatChunkNames = flat(chunkNames);
     Object.keys(flatChunkNames).forEach((key) => {

package/lib/client/exports/Interpolate.js

@@ -26,30 +26,26 @@ export function interpolate(text, values) {
             elements.push(element);
             return ValueFoundMarker;
         }
-        else {
-            return match; // no match? add warning?
-        }
+        return match; // no match? add warning?
     });
     // No interpolation to be done: just return the text
     if (elements.length === 0) {
         return text;
     }
     // Basic string interpolation: returns interpolated string
-    else if (elements.every((el) => typeof el === 'string')) {
+    if (elements.every((el) => typeof el === 'string')) {
         return processedText
             .split(ValueFoundMarker)
             .reduce((str, value, index) => { var _a; return str.concat(value).concat((_a = elements[index]) !== null && _a !== void 0 ? _a : ''); }, '');
     }
     // JSX interpolation: returns ReactNode
-    else {
-        return processedText.split(ValueFoundMarker).reduce((array, value, index) => [
-            ...array,
-            <React.Fragment key={index}>
-          {value}
-          {elements[index]}
-        </React.Fragment>,
-        ], []);
-    }
+    return processedText.split(ValueFoundMarker).reduce((array, value, index) => [
+        ...array,
+        <React.Fragment key={index}>
+        {value}
+        {elements[index]}
+      </React.Fragment>,
+    ], []);
 }
 export default function Interpolate({ children, values, }) {
     if (typeof children !== 'string') {

package/lib/client/exports/Link.js

@@ -57,7 +57,7 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
         ioRef.current = new window.IntersectionObserver((entries) => {
             entries.forEach((entry) => {
                 if (el === entry.target) {
-                    // If element is in viewport, stop listening/observing and run callback.
+                    // If element is in viewport, stop observing and run callback.
                     // https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API
                     if (entry.isIntersecting || entry.intersectionRatio > 0) {
                         ioRef.current.unobserve(el);
@@ -72,7 +72,7 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     };
     const handleRef = (ref) => {
         if (IOSupported && ref && isInternal) {
-            // If IO supported and element reference found, setup Observer functionality.
+            // If IO supported and element reference found, set up Observer.
             handleIntersection(ref, () => {
                 if (targetLink != null) {
                     window.docusaurus.prefetch(targetLink);
@@ -109,7 +109,8 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     // eslint-disable-next-line jsx-a11y/anchor-has-content
     <a href={targetLink} {...(targetLinkUnprefixed &&
         !isInternal && { target: '_blank', rel: 'noopener noreferrer' })} {...props}/>) : (<LinkComponent {...props} onMouseEnter={onMouseEnter} innerRef={handleRef} to={targetLink || ''} 
-    // avoid "React does not recognize the `activeClassName` prop on a DOM element"
+    // avoid "React does not recognize the `activeClassName` prop on a DOM
+    // element"
     {...(isNavLink && { isActive, activeClassName })}/>);
 }
 export default Link;

package/lib/client/exports/Translate.js

@@ -22,7 +22,8 @@ export function translate({ message, id }, values) {
     return interpolate(localizedMessage, values);
 }
 // Maybe we'll want to improve this component with additional features
-// Like toggling a translation mode that adds a little translation button near the text?
+// Like toggling a translation mode that adds a little translation button near
+// the text?
 export default function Translate({ children, id, values, }) {
     if (children && typeof children !== 'string') {
         console.warn('Illegal <Translate> children', children);

package/lib/client/exports/browserContext.js

@@ -10,7 +10,8 @@ import React, { useEffect, useState } from 'react';
 // On first client-side render, we need to render exactly as the server rendered
 // isBrowser is set to true only after a successful hydration
 // Note, isBrowser is not part of useDocusaurusContext() for perf reasons
-// Using useDocusaurusContext() (much more common need) should not trigger re-rendering after a successful hydration
+// Using useDocusaurusContext() (much more common need) should not trigger
+// re-rendering after a successful hydration
 export const Context = React.createContext(false);
 export function BrowserContextProvider({ children, }) {
     const [isBrowser, setIsBrowser] = useState(false);

package/lib/client/preload.d.ts

@@ -7,7 +7,8 @@
 import { type RouteConfig } from 'react-router-config';
 /**
  * Helper function to make sure all async components for that particular route
- * is preloaded before rendering. This is especially useful to avoid loading screens.
+ * is preloaded before rendering. This is especially useful to avoid loading
+ * screens.
  *
  * @param routes react-router-config
  * @param pathname the route pathname, example: /docs/installation

package/lib/client/preload.js

@@ -7,7 +7,8 @@
 import { matchRoutes } from 'react-router-config';
 /**
  * Helper function to make sure all async components for that particular route
- * is preloaded before rendering. This is especially useful to avoid loading screens.
+ * is preloaded before rendering. This is especially useful to avoid loading
+ * screens.
  *
  * @param routes react-router-config
  * @param pathname the route pathname, example: /docs/installation

package/lib/client/serverEntry.js

@@ -46,7 +46,7 @@ It might also require to wrap your client code in code=${'useEffect'} hook and/o
         throw new Error('Server-side rendering fails due to the error above.');
     }
 }
-// Renderer for static-site-generator-webpack-plugin (async rendering via promises).
+// Renderer for static-site-generator-webpack-plugin (async rendering).
 async function doRender(locals) {
     const { routesLocation, headTags, preBodyTags, postBodyTags, onLinksCollected, baseUrl, ssrTemplate, noIndex, } = locals;
     const location = routesLocation[locals.path];

package/lib/client/theme-fallback/Error/index.js

@@ -25,10 +25,12 @@ function ErrorDisplay({ error, tryAgain }) {
     </div>);
 }
 function Error({ error, tryAgain }) {
-    // We wrap the error in its own error boundary because the layout can actually throw too...
-    // Only the ErrorDisplay component is simple enough to be considered safe to never throw
+    // We wrap the error in its own error boundary because the layout can actually
+    // throw too... Only the ErrorDisplay component is simple enough to be
+    // considered safe to never throw
     return (<ErrorBoundary 
-    // Note: we display the original error here, not the error that we captured in this extra error boundary
+    // Note: we display the original error here, not the error that we
+    // captured in this extra error boundary
     fallback={() => <ErrorDisplay error={error} tryAgain={tryAgain}/>}>
       <Layout title="Page Error">
         <ErrorDisplay error={error} tryAgain={tryAgain}/>

package/lib/commands/build.js

@@ -58,22 +58,20 @@ forceTerminate = true) {
     if (cliOptions.locale) {
         return tryToBuildLocale({ locale: cliOptions.locale, isLastLocale: true });
     }
-    else {
-        if (i18n.locales.length > 1) {
-            logger_1.default.info `Website will be built for all these locales: ${i18n.locales}`;
-        }
-        // We need the default locale to always be the 1st in the list
-        // If we build it last, it would "erase" the localized sites built in sub-folders
-        const orderedLocales = [
-            i18n.defaultLocale,
-            ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
-        ];
-        const results = await (0, utils_2.mapAsyncSequential)(orderedLocales, (locale) => {
-            const isLastLocale = orderedLocales.indexOf(locale) === orderedLocales.length - 1;
-            return tryToBuildLocale({ locale, isLastLocale });
-        });
-        return results[0];
+    if (i18n.locales.length > 1) {
+        logger_1.default.info `Website will be built for all these locales: ${i18n.locales}`;
     }
+    // We need the default locale to always be the 1st in the list. If we build it
+    // last, it would "erase" the localized sites built in sub-folders
+    const orderedLocales = [
+        i18n.defaultLocale,
+        ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
+    ];
+    const results = await (0, utils_2.mapAsyncSequential)(orderedLocales, (locale) => {
+        const isLastLocale = orderedLocales.indexOf(locale) === orderedLocales.length - 1;
+        return tryToBuildLocale({ locale, isLastLocale });
+    });
+    return results[0];
 }
 exports.default = build;
 async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLastLocale, }) {
@@ -93,7 +91,8 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         plugins: [
             // 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.
+            // Visualize size of webpack output files with an interactive zoomable
+            // tree map.
             cliOptions.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({
@@ -153,7 +152,6 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         if (!plugin.postBuild) {
             return;
         }
-        // The plugin may reference `this`. We manually bind it again to prevent any bugs.
         await plugin.postBuild({ ...props, content: plugin.content });
     }));
     await (0, brokenLinks_1.handleBrokenLinks)({

package/lib/commands/deploy.js

@@ -114,8 +114,8 @@ This behavior can have SEO impacts and create relative link issues.
         shelljs_1.default.echo('Skipping deploy on a pull request.');
         shelljs_1.default.exit(0);
     }
-    // github.io indicates organization repos that deploy via default branch. All others use gh-pages.
-    // Organization deploys looks like:
+    // github.io indicates organization repos that deploy via default branch.
+    // All others use gh-pages. Organization deploys looks like:
     // - Git repo: https://github.com/<organization>/<organization>.github.io
     // - Site url: https://<organization>.github.io
     const isGitHubPagesOrganizationDeploy = projectName.includes('.github.io');
@@ -196,7 +196,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
         }
     };
     if (!cliOptions.skipBuild) {
-        // Build static html files, then push to deploymentBranch branch of specified repo.
+        // Build site, then push to deploymentBranch branch of specified repo.
         try {
             await runDeploy(await (0, build_1.default)(siteDir, cliOptions, false));
         }

package/lib/commands/serve.js

@@ -44,8 +44,8 @@ async function serve(siteDir, cliOptions) {
             res.end();
             return;
         }
-        // Remove baseUrl before calling serveHandler
-        // Reason: /baseUrl/ should serve /build/index.html, not /build/baseUrl/index.html (does not exist)
+        // Remove baseUrl before calling serveHandler, because /baseUrl/ should
+        // serve /build/index.html, not /build/baseUrl/index.html (does not exist)
         req.url = (_b = req.url) === null || _b === void 0 ? void 0 : _b.replace(baseUrl, '/');
         (0, serve_handler_1.default)(req, res, {
             cleanUrls: true,

package/lib/commands/swizzle.js

@@ -185,7 +185,8 @@ async function swizzle(siteDir, themeName, componentName, typescript, danger) {
         let score = formattedComponentName.length;
         components.forEach((component) => {
             if (component.toLowerCase() === formattedComponentName.toLowerCase()) {
-                // may be components with same lowercase key, try to match closest component
+                // may be components with same lowercase key, try to match closest
+                // component
                 const currentScore = (0, leven_1.default)(formattedComponentName, component);
                 if (currentScore < score) {
                     score = currentScore;
@@ -202,7 +203,8 @@ async function swizzle(siteDir, themeName, componentName, typescript, danger) {
     let fromPath = path_1.default.join(themePath, mostSuitableComponent);
     let toPath = path_1.default.resolve(siteDir, utils_1.THEME_PATH, mostSuitableComponent);
     // Handle single TypeScript/JavaScript file only.
-    // E.g: if <fromPath> does not exist, we try to swizzle <fromPath>.(ts|tsx|js) instead
+    // E.g: if <fromPath> does not exist, we try to swizzle
+    // <fromPath>.(ts|tsx|js) instead
     if (!fs_extra_1.default.existsSync(fromPath)) {
         if (fs_extra_1.default.existsSync(`${fromPath}.ts`)) {
             [fromPath, toPath] = [`${fromPath}.ts`, `${toPath}.ts`];

package/lib/commands/writeHeadingIds.js

@@ -48,9 +48,7 @@ function transformMarkdownLine(line, slugger, options) {
     if (line.startsWith('##')) {
         return transformMarkdownHeadingLine(line, slugger, options);
     }
-    else {
-        return line;
-    }
+    return line;
 }
 function transformMarkdownLines(lines, options) {
     let inCode = false;
@@ -60,12 +58,10 @@ function transformMarkdownLines(lines, options) {
             inCode = !inCode;
             return line;
         }
-        else {
-            if (inCode) {
-                return line;
-            }
-            return transformMarkdownLine(line, slugger, options);
+        if (inCode) {
+            return line;
         }
+        return transformMarkdownLine(line, slugger, options);
     });
 }
 function transformMarkdownContent(content, options) {
@@ -81,9 +77,12 @@ async function transformMarkdownFile(filepath, options) {
     }
     return undefined;
 }
-// We only handle the "paths to watch" because these are the paths where the markdown files are
-// Also we don't want to transform the site md docs that do not belong to a content plugin
-// For example ./README.md should not be transformed
+/**
+ * We only handle the "paths to watch" because these are the paths where the
+ * markdown files are. Also we don't want to transform the site md docs that do
+ * not belong to a content plugin. For example ./README.md should not be
+ * transformed
+ */
 async function getPathsToWatch(siteDir) {
     const context = await (0, server_1.loadContext)(siteDir);
     const pluginConfigs = (0, server_1.loadPluginConfigs)(context);

package/lib/commands/writeTranslations.js

@@ -13,10 +13,13 @@ const init_1 = (0, tslib_1.__importDefault)(require("../server/plugins/init"));
 const translations_1 = require("../server/translations/translations");
 const translationsExtractor_1 = require("../server/translations/translationsExtractor");
 const utils_1 = require("../webpack/utils");
-// This is a hack, so that @docusaurus/theme-common translations are extracted!
-// A theme doesn't have a way to express that one of its dependency (like @docusaurus/theme-common) also has translations to extract
-// Instead of introducing a new lifecycle (like plugin.getThemeTranslationPaths() ?)
-// We just make an exception and assume that Docusaurus user is using an official theme
+/**
+ * This is a hack, so that @docusaurus/theme-common translations are extracted!
+ * A theme doesn't have a way to express that one of its dependency (like
+ * @docusaurus/theme-common) also has translations to extract.
+ * Instead of introducing a new lifecycle (like `getThemeTranslationPaths()`?)
+ * We just make an exception and assume that user is using an official theme
+ */
 async function getExtraSourceCodeFilePaths() {
     try {
         const themeCommonSourceDir = path_1.default.dirname(require.resolve('@docusaurus/theme-common/lib'));

package/lib/server/brokenLinks.js

@@ -39,10 +39,12 @@ function getPageBrokenLinks({ pagePath, pageLinks, routes, }) {
     }
     return pageLinks.map(resolveLink).filter((l) => isBrokenLink(l.resolvedLink));
 }
-// The route defs can be recursive, and have a parent match-all route
-// We don't want to match broken links like /docs/brokenLink against /docs/*
-// For this reason, we only consider the "final routes", that do not have subroutes
-// We also need to remove the match all 404 route
+/**
+ * The route defs can be recursive, and have a parent match-all route. We don't
+ * want to match broken links like /docs/brokenLink against /docs/*. For this
+ * reason, we only consider the "final routes", that do not have subroutes.
+ * We also need to remove the match all 404 route
+ */
 function filterIntermediateRoutes(routesInput) {
     const routesWithout404 = routesInput.filter((route) => route.path !== '*');
     return (0, utils_2.getAllFinalRoutes)(routesWithout404);
@@ -67,9 +69,11 @@ function getBrokenLinksErrorMessage(allBrokenLinks) {
             .map(brokenLinkMessage)
             .join('\n   -> linking to ')}`;
     }
-    // If there's a broken link appearing very often, it is probably a broken link on the layout!
-    // Add an additional message in such case to help user figure this out.
-    // see https://github.com/facebook/docusaurus/issues/3567#issuecomment-706973805
+    /**
+     * If there's a broken link appearing very often, it is probably a broken link
+     * on the layout. Add an additional message in such case to help user figure
+     * this out. See https://github.com/facebook/docusaurus/issues/3567#issuecomment-706973805
+     */
     function getLayoutBrokenLinksHelpMessage() {
         const flatList = Object.entries(allBrokenLinks).flatMap(([pagePage, brokenLinks]) => brokenLinks.map((brokenLink) => ({ pagePage, brokenLink })));
         const countedBrokenLinks = (0, lodash_1.countBy)(flatList, (item) => item.brokenLink.link);
@@ -121,8 +125,9 @@ async function handleBrokenLinks({ allCollectedLinks, onBrokenLinks, routes, bas
     if (onBrokenLinks === 'ignore') {
         return;
     }
-    // If we link to a file like /myFile.zip, and the file actually exist for the file system
-    // it is not a broken link, it may simply be a link to an existing static file...
+    // If we link to a file like /myFile.zip, and the file actually exist for the
+    // file system. It is not a broken link, it may simply be a link to an
+    // existing static file...
     const allCollectedLinksFiltered = await filterExistingFileLinks({
         allCollectedLinks,
         baseUrl,

package/lib/server/duplicateRoutes.js

@@ -16,10 +16,8 @@ function getAllDuplicateRoutes(pluginsRouteConfigs) {
         if (Object.prototype.hasOwnProperty.call(seenRoutes, route)) {
             return true;
         }
-        else {
-            seenRoutes[route] = true;
-            return false;
-        }
+        seenRoutes[route] = true;
+        return false;
     });
 }
 exports.getAllDuplicateRoutes = getAllDuplicateRoutes;

package/lib/server/i18n.js

@@ -61,22 +61,18 @@ function localizePath({ pathType, path: originalPath, i18n, options = {}, }) {
         ? // By default, we don't localize the path of defaultLocale
             i18n.currentLocale !== i18n.defaultLocale
         : options.localizePath;
-    if (shouldLocalizePath) {
-        // FS paths need special care, for Windows support
-        if (pathType === 'fs') {
-            return path_1.default.join(originalPath, path_1.default.sep, i18n.currentLocale, path_1.default.sep);
-        }
-        // Url paths
-        else if (pathType === 'url') {
-            return (0, utils_1.normalizeUrl)([originalPath, '/', i18n.currentLocale, '/']);
-        }
-        // should never happen
-        else {
-            throw new Error(`Unhandled path type "${pathType}".`);
-        }
-    }
-    else {
+    if (!shouldLocalizePath) {
         return originalPath;
     }
+    // FS paths need special care, for Windows support
+    if (pathType === 'fs') {
+        return path_1.default.join(originalPath, path_1.default.sep, i18n.currentLocale, path_1.default.sep);
+    }
+    // Url paths
+    if (pathType === 'url') {
+        return (0, utils_1.normalizeUrl)([originalPath, '/', i18n.currentLocale, '/']);
+    }
+    // should never happen
+    throw new Error(`Unhandled path type "${pathType}".`);
 }
 exports.localizePath = localizePath;

package/lib/server/index.js

@@ -150,10 +150,12 @@ function createBootstrapPlugin({ siteConfig, }) {
         },
     };
 }
-// 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 content plugins
-// This allows to do things such as importing repo/README.md as a partial from another doc
-// Not ideal solution though, but good enough for now
+/**
+ * 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
+ * content plugins. This allows to do things such as importing repo/README.md as
+ * a partial from another doc. Not ideal solution, but good enough for now
+ */
 function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
     return {
         name: 'docusaurus-mdx-fallback-plugin',
@@ -161,9 +163,9 @@ function createMDXFallbackPlugin({ siteDir, siteConfig, }) {
         options: {},
         version: { type: 'synthetic' },
         configureWebpack(config, isServer, { getJSLoader }) {
-            // We need the mdx fallback loader to exclude files that were already processed by content plugins mdx loaders
-            // This works, but a bit hacky...
-            // Not sure there's a way to handle that differently in webpack :s
+            // We need the mdx fallback loader to exclude files that were already
+            // processed by content plugins mdx loaders. This works, but a bit
+            // hacky... Not sure there's a way to handle that differently in webpack
             function getMDXFallbackExcludedPaths() {
                 var _a;
                 const rules = (_a = config === null || config === void 0 ? void 0 : config.module) === null || _a === void 0 ? void 0 : _a.rules;

package/lib/server/plugins/index.js

@@ -57,9 +57,9 @@ async function loadPlugins({ pluginConfigs, context, }) {
         context,
     });
     // 2. Plugin Lifecycle - loadContent.
-    // Currently plugins run lifecycle methods in parallel and are not order-dependent.
-    // We could change this in future if there are plugins which need to
-    // run in certain order or depend on others for data.
+    // Currently plugins run lifecycle methods in parallel and are not
+    // order-dependent. We could change this in future if there are plugins which
+    // need to run in certain order or depend on others for data.
     const loadedPlugins = await Promise.all(plugins.map(async (plugin) => {
         const content = plugin.loadContent ? await plugin.loadContent() : null;
         return { ...plugin, content };
@@ -134,9 +134,9 @@ async function loadPlugins({ pluginConfigs, context, }) {
         });
     }));
     // 4. Plugin Lifecycle - routesLoaded.
-    // Currently plugins run lifecycle methods in parallel and are not order-dependent.
-    // We could change this in future if there are plugins which need to
-    // run in certain order or depend on others for data.
+    // Currently plugins run lifecycle methods in parallel and are not
+    // order-dependent. We could change this in future if there are plugins which
+    // need to run in certain order or depend on others for data.
     await Promise.all(contentLoadedTranslatedPlugins.map(async (plugin) => {
         if (!plugin.routesLoaded) {
             return null;

package/lib/server/plugins/init.js

@@ -71,9 +71,7 @@ function getOptionValidationFunction(normalizedPluginConfig) {
         // support both commonjs and ES modules
         return ((_c = (_b = (_a = normalizedPluginConfig.pluginModule.module) === null || _a === void 0 ? void 0 : _a.default) === null || _b === void 0 ? void 0 : _b.validateOptions) !== null && _c !== void 0 ? _c : (_d = normalizedPluginConfig.pluginModule.module) === null || _d === void 0 ? void 0 : _d.validateOptions);
     }
-    else {
-        return normalizedPluginConfig.plugin.validateOptions;
-    }
+    return normalizedPluginConfig.plugin.validateOptions;
 }
 function getThemeValidationFunction(normalizedPluginConfig) {
     var _a, _b;
@@ -81,13 +79,11 @@ function getThemeValidationFunction(normalizedPluginConfig) {
         // support both commonjs and ES modules
         return ((_b = (_a = normalizedPluginConfig.pluginModule.module.default) === null || _a === void 0 ? void 0 : _a.validateThemeConfig) !== null && _b !== void 0 ? _b : normalizedPluginConfig.pluginModule.module.validateThemeConfig);
     }
-    else {
-        return normalizedPluginConfig.plugin.validateThemeConfig;
-    }
+    return normalizedPluginConfig.plugin.validateThemeConfig;
 }
 async function initPlugins({ pluginConfigs, context, }) {
-    // We need to resolve plugins from the perspective of the siteDir, since the siteDir's package.json
-    // declares the dependency on these plugins.
+    // We need to resolve plugins from the perspective of the siteDir, since the
+    // siteDir's package.json declares the dependency on these plugins.
     const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
     function doGetPluginVersion(normalizedPluginConfig) {
         var _a, _b;
@@ -96,9 +92,7 @@ async function initPlugins({ pluginConfigs, context, }) {
             const pluginPath = pluginRequire.resolve((_b = normalizedPluginConfig.pluginModule) === null || _b === void 0 ? void 0 : _b.path);
             return (0, versions_1.getPluginVersion)(pluginPath, context.siteDir);
         }
-        else {
-            return { type: 'local' };
-        }
+        return { type: 'local' };
     }
     function doValidateThemeConfig(normalizedPluginConfig) {
         const validateThemeConfig = getThemeValidationFunction(normalizedPluginConfig);
@@ -108,9 +102,7 @@ async function initPlugins({ pluginConfigs, context, }) {
                 themeConfig: context.siteConfig.themeConfig,
             });
         }
-        else {
-            return context.siteConfig.themeConfig;
-        }
+        return context.siteConfig.themeConfig;
     }
     function doValidatePluginOptions(normalizedPluginConfig) {
         var _a;
@@ -121,14 +113,12 @@ async function initPlugins({ pluginConfigs, context, }) {
                 options: normalizedPluginConfig.options,
             });
         }
-        else {
-            // Important to ensure all plugins have an id
-            // as we don't go through the Joi schema that adds it
-            return {
-                ...normalizedPluginConfig.options,
-                id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
-            };
-        }
+        // Important to ensure all plugins have an id
+        // as we don't go through the Joi schema that adds it
+        return {
+            ...normalizedPluginConfig.options,
+            id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
+        };
     }
     async function initializePlugin(pluginConfig) {
         const normalizedPluginConfig = normalizePluginConfig(pluginConfig, pluginRequire);

package/lib/server/presets/index.js

@@ -11,8 +11,8 @@ const module_1 = require("module");
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
 const moduleShorthand_1 = require("../moduleShorthand");
 function loadPresets(context) {
-    // We need to resolve presets from the perspective of the siteDir, since the siteDir's package.json
-    // declares the dependency on these presets.
+    // We need to resolve presets from the perspective of the siteDir, since the
+    // siteDir's package.json declares the dependency on these presets.
     const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
     const presets = context.siteConfig.presets || [];
     const unflatPlugins = [];

package/lib/server/routes.js

@@ -73,7 +73,8 @@ async function loadRoutes(pluginsRouteConfigs, baseUrl) {
         }
         // Collect all page paths for injecting it later in the plugin lifecycle
         // This is useful for plugins like sitemaps, redirects etc...
-        // If a route has subroutes, it is not necessarily a valid page path (more likely to be a wrapper)
+        // If a route has subroutes, it is not necessarily a valid page path (more
+        // likely to be a wrapper)
         if (!subroutes) {
             routesPaths.push(routePath);
         }

package/lib/server/themes/index.js

@@ -17,8 +17,9 @@ function loadThemeAliases(themePaths, userThemePaths) {
     themePaths.forEach((themePath) => {
         const themeAliases = (0, alias_1.default)(themePath, true);
         Object.keys(themeAliases).forEach((aliasKey) => {
-            // If this alias shadows a previous one, use @theme-init to preserve the initial one.
-            // @theme-init is only applied once: to the initial theme that provided this component
+            // If this alias shadows a previous one, use @theme-init to preserve the
+            // initial one. @theme-init is only applied once: to the initial theme
+            // that provided this component
             if (aliasKey in aliases) {
                 const componentName = aliasKey.substring(aliasKey.indexOf('/') + 1);
                 const initAlias = `@theme-init/${componentName}`;

package/lib/server/translations/translations.js

@@ -56,7 +56,7 @@ function mergeTranslationFileContent({ existingContent = {}, newContent, options
     Object.entries(newContentTransformed).forEach(([key, { message, description }]) => {
         var _a, _b;
         result[key] = {
-            // If the messages already exist, we don't override them (unless requested)
+            // If messages already exist, we don't override them (unless requested)
             message: options.override
                 ? message
                 : (_b = (_a = existingContent[key]) === null || _a === void 0 ? void 0 : _a.message) !== null && _b !== void 0 ? _b : message,
@@ -162,9 +162,7 @@ async function localizePluginTranslationFile({ siteDir, plugin, locale, translat
             },
         };
     }
-    else {
-        return translationFile;
-    }
+    return translationFile;
 }
 exports.localizePluginTranslationFile = localizePluginTranslationFile;
 async function getPluginsDefaultCodeTranslationMessages(plugins) {

package/lib/server/translations/translationsExtractor.js

@@ -36,8 +36,9 @@ function getSiteSourceCodeFilePaths(siteDir) {
 function getPluginSourceCodeFilePaths(plugin) {
     var _a, _b, _c;
     // The getPathsToWatch() generally returns the js/jsx/ts/tsx/md/mdx file paths
-    // We can use this method as well to know which folders we should try to extract translations from
-    // Hacky/implicit, but do we want to introduce a new lifecycle method just for that???
+    // We can use this method as well to know which folders we should try to
+    // extract translations from. Hacky/implicit, but do we want to introduce a
+    // new lifecycle method just for that???
     const codePaths = (_b = (_a = plugin.getPathsToWatch) === null || _a === void 0 ? void 0 : _a.call(plugin)) !== null && _b !== void 0 ? _b : [];
     // We also include theme code
     const themePath = (_c = plugin.getThemePath) === null || _c === void 0 ? void 0 : _c.call(plugin);
@@ -54,14 +55,16 @@ 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
-    // We can use this method as well to know which folders we should try to extract translations from
-    // Hacky/implicit, but do we want to introduce a new lifecycle method for that???
+    // We can use this method as well to know which folders we should try to
+    // extract translations from. Hacky/implicit, but do we want to introduce a
+    // new lifecycle method for that???
     const pluginsPaths = plugins.flatMap(getPluginSourceCodeFilePaths);
     const allPaths = [...sitePaths, ...pluginsPaths];
     return globSourceCodeFilePaths(allPaths);
 }
 async function extractSiteSourceCodeTranslations(siteDir, plugins, babelOptions, extraSourceCodeFilePaths = []) {
-    // Should we warn here if the same translation "key" is found in multiple source code files?
+    // Should we warn here if the same translation "key" is found in multiple
+    // source code files?
     function toTranslationFileContent(sourceCodeFileTranslations) {
         return sourceCodeFileTranslations.reduce((acc, item) => ({ ...acc, ...item.translations }), {});
     }
@@ -92,8 +95,9 @@ async function extractSourceCodeFileTranslations(sourceCodeFilePath, babelOption
         const ast = (0, core_1.parse)(code, {
             ...babelOptions,
             ast: true,
-            // filename is important, because babel does not process the same files according to their js/ts extensions
-            // see  see https://twitter.com/NicoloRibaudo/status/1321130735605002243
+            // filename is important, because babel does not process the same files
+            // according to their js/ts extensions.
+            // See https://twitter.com/NicoloRibaudo/status/1321130735605002243
             filename: sourceCodeFilePath,
         });
         const translations = await extractSourceCodeAstTranslations(ast, sourceCodeFilePath);
@@ -169,12 +173,10 @@ Full code: ${(0, generator_1.default)(node).code}`;
                             typeof attributeValueEvaluated.value === 'string') {
                             return attributeValueEvaluated.value;
                         }
-                        else {
-                            warnings.push(`<Translate> prop=${propName} should be a statically evaluable object.
+                        warnings.push(`<Translate> prop=${propName} should be a statically evaluable object.
 Example: <Translate id="optional id" description="optional description">Message</Translate>
 Dynamically constructed values are not allowed, because they prevent translations to be extracted.
 ${sourceWarningPart(path.node)}`);
-                        }
                     }
                     return undefined;
                 }
@@ -191,7 +193,7 @@ ${sourceWarningPart(path.node)}`);
                     }
                     else {
                         translations[id] = {
-                            message: message !== null && message !== void 0 ? message : id,
+                            message: id,
                             ...(description && { description }),
                         };
                     }
@@ -199,8 +201,9 @@ ${sourceWarningPart(path.node)}`);
                 }
                 // Handle single non-empty content
                 const singleChildren = childrenPath
-                    // Remove empty/useless text nodes that might be around our translation!
-                    // Makes the translation system more reliable to JSX formatting issues
+                    // Remove empty/useless text nodes that might be around our
+                    // translation! Makes the translation system more reliable to JSX
+                    // formatting issues
                     .filter((children) => !(children.isJSXText() &&
                     children.node.value.replace('\n', '').trim() === ''))
                     .pop();
@@ -231,7 +234,7 @@ ${sourceWarningPart(path.node)}`);
                 const args = path.get('arguments');
                 if (args.length === 1 || args.length === 2) {
                     const firstArgPath = args[0];
-                    // evaluation allows translate("x" + "y"); to be considered as translate("xy");
+                    // translate("x" + "y"); => translate("xy");
                     const firstArgEvaluated = firstArgPath.evaluate();
                     if (firstArgEvaluated.confident &&
                         typeof firstArgEvaluated.value === 'object') {

package/lib/server/versions/index.js

@@ -33,7 +33,8 @@ function getPluginVersion(pluginPath, siteDir) {
         const packageJsonPath = (0, path_1.join)(potentialPluginPackageJsonDirectory, 'package.json');
         if ((0, fs_extra_1.existsSync)(packageJsonPath) && (0, fs_extra_1.lstatSync)(packageJsonPath).isFile()) {
             if (potentialPluginPackageJsonDirectory === siteDir) {
-                // If the plugin belongs to the same docusaurus project, we classify it as local plugin.
+                // If the plugin belongs to the same docusaurus project, we classify it
+                // as local plugin.
                 return { type: 'project' };
             }
             return {
@@ -44,7 +45,8 @@ function getPluginVersion(pluginPath, siteDir) {
         }
         potentialPluginPackageJsonDirectory = (0, path_1.dirname)(potentialPluginPackageJsonDirectory);
     }
-    // In rare cases where a plugin is a path where no parent directory contains package.json, we can only classify it as local.
+    // In the case where a plugin is a path where no parent directory contains
+    // package.json (e.g. inline plugin), we can only classify it as local.
     return { type: 'local' };
 }
 exports.getPluginVersion = getPluginVersion;

package/lib/webpack/base.js

@@ -69,16 +69,19 @@ function createBaseConfig(props, isServer, minify = true) {
             // When version string changes, cache is evicted
             version: [
                 siteMetadata.docusaurusVersion,
-                // Webpack does not evict the cache correctly on alias/swizzle change, so we force eviction.
+                // Webpack does not evict the cache correctly on alias/swizzle change,
+                // so we force eviction.
                 // See https://github.com/webpack/webpack/issues/13627
                 (0, utils_2.md5Hash)(JSON.stringify(themeAliases)),
             ].join('-'),
-            // When one of those modules/dependencies change (including transitive deps), cache is invalidated
+            // When one of those modules/dependencies change (including transitive
+            // deps), cache is invalidated
             buildDependencies: {
                 config: [
                     __filename,
                     path_1.default.join(__dirname, isServer ? 'server.js' : 'client.js'),
-                    // Docusaurus config changes can affect MDX/JSX compilation, so we'd rather evict the cache.
+                    // Docusaurus config changes can affect MDX/JSX compilation, so we'd
+                    // rather evict the cache.
                     // See https://github.com/questdb/questdb.io/issues/493
                     siteConfigPath,
                 ],
@@ -120,10 +123,11 @@ function createBaseConfig(props, isServer, minify = true) {
                 ...getDocusaurusAliases(),
                 ...themeAliases,
             },
-            // This allows you to set a fallback for where Webpack should look for modules.
-            // We want `@docusaurus/core` own dependencies/`node_modules` to "win" if there is conflict
-            // Example: if there is core-js@3 in user's own node_modules, but core depends on
-            // core-js@2, we should use core-js@2.
+            // This allows you to set a fallback for where Webpack should look for
+            // modules. We want `@docusaurus/core` own dependencies/`node_modules` to
+            // "win" if there is conflict. Example: if there is core-js@3 in user's
+            // own node_modules, but core depends on core-js@2, we should use
+            // core-js@2.
             modules: [
                 path_1.default.resolve(__dirname, '..', '..', 'node_modules'),
                 'node_modules',
@@ -135,7 +139,8 @@ function createBaseConfig(props, isServer, minify = true) {
         },
         optimization: {
             removeAvailableModules: false,
-            // Only minimize client bundle in production because server bundle is only used for static site generation
+            // Only minimize client bundle in production because server bundle is only
+            // used for static site generation
             minimize: minimizeEnabled,
             minimizer: minimizeEnabled
                 ? (0, utils_1.getMinimizer)(useSimpleCssMinifier)
@@ -143,7 +148,9 @@ function createBaseConfig(props, isServer, minify = true) {
             splitChunks: isServer
                 ? false
                 : {
-                    // Since the chunk name includes all origin chunk names it's recommended for production builds with long term caching to NOT include [name] in the filenames
+                    // Since the chunk name includes all origin chunk names it's
+                    // recommended for production builds with long term caching to NOT
+                    // include [name] in the filenames
                     name: false,
                     cacheGroups: {
                         // disable the built-in cacheGroups
@@ -217,8 +224,9 @@ function createBaseConfig(props, isServer, minify = true) {
                 chunkFilename: isProd
                     ? 'assets/css/[name].[contenthash:8].css'
                     : '[name].css',
-                // remove css order warnings if css imports are not sorted alphabetically
-                // see https://github.com/webpack-contrib/mini-css-extract-plugin/pull/422 for more reasoning
+                // remove css order warnings if css imports are not sorted
+                // alphabetically. See https://github.com/webpack-contrib/mini-css-extract-plugin/pull/422
+                // for more reasoning
                 ignoreOrder: true,
             }),
         ],

package/lib/webpack/client.js

@@ -18,7 +18,9 @@ function createClientConfig(props, minify = true) {
     const isBuilding = process.argv[2] === 'build';
     const config = (0, base_1.createBaseConfig)(props, false, minify);
     const clientConfig = (0, webpack_merge_1.default)(config, {
-        // target: 'browserslist', //  useless, disabled on purpose (errors on existing sites with no browserslist cfg)
+        // useless, disabled on purpose (errors on existing sites with no
+        // browserslist config)
+        // target: 'browserslist',
         entry: path_1.default.resolve(__dirname, '../client/clientEntry.js'),
         optimization: {
             // Keep the runtime chunk separated to enable long term caching
@@ -33,7 +35,8 @@ function createClientConfig(props, minify = true) {
             }),
         ],
     });
-    // When building include the plugin to force terminate building if errors happened in the client bundle.
+    // When building, include the plugin to force terminate building if errors
+    // happened in the client bundle.
     if (isBuilding) {
         (_a = clientConfig.plugins) === null || _a === void 0 ? void 0 : _a.push({
             apply: (compiler) => {

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

@@ -5,6 +5,17 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type Compiler } from 'webpack';
+/**
+ * We modify webpack runtime to add an extra function called
+ * "__webpack_require__.gca" that will allow us to get the corresponding chunk
+ * asset for a webpack chunk. Pass it the chunkName or chunkId you want to load.
+ * For example: if you have a chunk named "my-chunk-name" that will map to
+ * "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
+ * __webpack_require__.gca("my-chunk-name") will return
+ * "/publicPath/0a84b5e7.c8e35c7a.js"
+ *
+ * "gca" stands for "get chunk asset"
+ */
 declare class ChunkAssetPlugin {
     apply(compiler: Compiler): void;
 }

package/lib/webpack/plugins/ChunkAssetPlugin.js

@@ -8,16 +8,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const webpack_1 = require("webpack");
 const pluginName = 'chunk-asset-plugin';
+/**
+ * We modify webpack runtime to add an extra function called
+ * "__webpack_require__.gca" that will allow us to get the corresponding chunk
+ * asset for a webpack chunk. Pass it the chunkName or chunkId you want to load.
+ * For example: if you have a chunk named "my-chunk-name" that will map to
+ * "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
+ * __webpack_require__.gca("my-chunk-name") will return
+ * "/publicPath/0a84b5e7.c8e35c7a.js"
+ *
+ * "gca" stands for "get chunk asset"
+ */
 class ChunkAssetPlugin {
     apply(compiler) {
         compiler.hooks.thisCompilation.tap(pluginName, ({ mainTemplate }) => {
-            /* We modify webpack runtime to add an extra function called "__webpack_require__.gca"
-            that will allow us to get the corresponding chunk asset for a webpack chunk.
-            Pass it the chunkName or chunkId you want to load.
-            For example: if you have a chunk named "my-chunk-name" that will map to "/publicPath/0a84b5e7.c8e35c7a.js" as its corresponding output path
-            __webpack_require__.gca("my-chunk-name") will return "/publicPath/0a84b5e7.c8e35c7a.js"
-            "gca" stands for "get chunk asset"
-            */
             mainTemplate.hooks.requireExtensions.tap(pluginName, (source, chunk) => {
                 const chunkIdToName = chunk.getChunkMaps(false).name;
                 const chunkNameToId = Object.create(null);
@@ -30,10 +34,13 @@ class ChunkAssetPlugin {
                 buf.push(
                 // If chunkName is passed, we convert it to chunk asset url
                 // .p => public path url ("/" or "/baseUrl/")
-                // .u(chunkId) => chunk asset url ("assets/js/x63b64xd.contentHash.js")
-                // not sure where this is documented, but this link was helpful: https://programmer.help/blogs/5d68849083e1a.html
+                // .u(chunkId) =>
+                //   chunk asset url ("assets/js/x63b64xd.contentHash.js")
+                // not sure where this is documented, but this link was helpful:
+                // https://programmer.help/blogs/5d68849083e1a.html
                 //
-                // Note: __webpack_require__.gca() is called in docusaurus.ts for prefetching
+                // Note: __webpack_require__.gca() is called in docusaurus.ts for
+                // prefetching
                 // Note: we previously used jsonpScriptSrc (Webpack 4)
                 `__webpack_require__.gca = function(chunkId) { chunkId = ${JSON.stringify(chunkNameToId)}[chunkId]||chunkId; return __webpack_require__.p + __webpack_require__.u(chunkId); };`);
                 return webpack_1.Template.asString(buf);

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

@@ -13,8 +13,8 @@
  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  * copies of the Software, and to permit persons to whom the Software is
  * furnished to do so, subject to the following conditions:
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -69,7 +69,8 @@ declare class CleanWebpackPlugin {
      *
      * Only happens once.
      *
-     * Warning: It is recommended to initially clean your build directory outside of webpack to minimize unexpected behavior.
+     * Warning: It is recommended to initially clean your build directory outside
+     * of webpack to minimize unexpected behavior.
      */
     handleInitial(): void;
     handleDone(stats: Stats): void;

package/lib/webpack/plugins/CleanWebpackPlugin.js

@@ -60,7 +60,8 @@ class CleanWebpackPlugin {
      *
      * Only happens once.
      *
-     * Warning: It is recommended to initially clean your build directory outside of webpack to minimize unexpected behavior.
+     * Warning: It is recommended to initially clean your build directory outside
+     * of webpack to minimize unexpected behavior.
      */
     handleInitial() {
         if (this.initialClean) {

package/lib/webpack/server.js

@@ -57,9 +57,10 @@ function createServerConfig({ props, onLinksCollected = () => { }, }) {
                 },
                 paths: ssgPaths,
                 preferFoldersOutput: trailingSlash,
-                // When using "new URL('file.js', import.meta.url)", Webpack will emit __filename, and this plugin will throw
-                // not sure the __filename value has any importance for this plugin, just using an empty string to avoid the error
-                // See https://github.com/facebook/docusaurus/issues/4922
+                // When using "new URL('file.js', import.meta.url)", Webpack will emit
+                // __filename, and this plugin will throw. not sure the __filename value
+                // has any importance for this plugin, just using an empty string to
+                // avoid the error. See https://github.com/facebook/docusaurus/issues/4922
                 globals: { __filename: '' },
             }),
             // Show compilation progress bar.

package/lib/webpack/utils.js

@@ -95,13 +95,12 @@ function getBabelOptions({ isServer, babelOptions, } = {}) {
             caller: { name: isServer ? 'server' : 'client' },
         };
     }
-    else {
-        return Object.assign(babelOptions !== null && babelOptions !== void 0 ? babelOptions : { presets: [require.resolve('../babel/preset')] }, {
-            babelrc: false,
-            configFile: false,
-            caller: { name: isServer ? 'server' : 'client' },
-        });
-    }
+    return {
+        ...(babelOptions !== null && babelOptions !== void 0 ? babelOptions : { presets: [require.resolve('../babel/preset')] }),
+        babelrc: false,
+        configFile: false,
+        caller: { name: isServer ? 'server' : 'client' },
+    };
 }
 exports.getBabelOptions = getBabelOptions;
 // Name is generic on purpose
@@ -308,8 +307,8 @@ function getMinimizer(useSimpleCssMinifier = false) {
                 output: {
                     ecma: 5,
                     comments: false,
-                    // Turned on because emoji and regex is not minified properly using default
-                    // https://github.com/facebook/create-react-app/issues/2488
+                    // 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,
                 },
             },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-4523",
+  "version": "0.0.0-4524",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -41,13 +41,13 @@
     "@babel/runtime": "^7.16.3",
     "@babel/runtime-corejs3": "^7.16.3",
     "@babel/traverse": "^7.16.3",
-    "@docusaurus/cssnano-preset": "0.0.0-4523",
-    "@docusaurus/logger": "0.0.0-4523",
-    "@docusaurus/mdx-loader": "0.0.0-4523",
+    "@docusaurus/cssnano-preset": "0.0.0-4524",
+    "@docusaurus/logger": "0.0.0-4524",
+    "@docusaurus/mdx-loader": "0.0.0-4524",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-4523",
-    "@docusaurus/utils-common": "0.0.0-4523",
-    "@docusaurus/utils-validation": "0.0.0-4523",
+    "@docusaurus/utils": "0.0.0-4524",
+    "@docusaurus/utils-common": "0.0.0-4524",
+    "@docusaurus/utils-validation": "0.0.0-4524",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.0",
     "@svgr/webpack": "^6.0.0",
     "autoprefixer": "^10.3.5",
@@ -105,8 +105,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4523",
-    "@docusaurus/types": "0.0.0-4523",
+    "@docusaurus/module-type-aliases": "0.0.0-4524",
+    "@docusaurus/types": "0.0.0-4524",
     "@types/copy-webpack-plugin": "^8.0.1",
     "@types/detect-port": "^1.3.0",
     "@types/mini-css-extract-plugin": "^1.4.3",
@@ -129,5 +129,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "e78e68d4bc6a23f7e616eb7b59da9c79d9fb7452"
+  "gitHead": "41a6bff3a67446f7d2a2972cbe4d05fec7378a15"
 }