@docusaurus/core 2.0.0-beta.20 → 2.0.0-beta.21

package/bin/beforeCli.mjs

@@ -7,16 +7,18 @@
 
 // @ts-check
 
-import logger from '@docusaurus/logger';
 import fs from 'fs-extra';
-import semver from 'semver';
 import path from 'path';
+import {createRequire} from 'module';
+import logger from '@docusaurus/logger';
+import semver from 'semver';
 import updateNotifier from 'update-notifier';
 import boxen from 'boxen';
-import {createRequire} from 'module';
 import {DOCUSAURUS_VERSION} from '@docusaurus/utils';
 
-const packageJson = createRequire(import.meta.url)('../package.json');
+const packageJson = /** @type {import("../package.json")} */ (
+  createRequire(import.meta.url)('../package.json')
+);
 /** @type {Record<string, any>} */
 let sitePkg;
 try {

package/bin/docusaurus.mjs

@@ -8,8 +8,8 @@
 
 // @ts-check
 
-import logger from '@docusaurus/logger';
 import fs from 'fs-extra';
+import logger from '@docusaurus/logger';
 import cli from 'commander';
 import {DOCUSAURUS_VERSION} from '@docusaurus/utils';
 import {
@@ -126,6 +126,10 @@ cli
     '--poll [interval]',
     'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds',
   )
+  .option(
+    '--no-minify',
+    'build website without minimizing JS bundles (default: false)',
+  )
   .action(async (siteDir, options) =>
     start(await resolveDir(siteDir), options),
   );
@@ -144,6 +148,10 @@ cli
   .option('-p, --port <port>', 'use specified port (default: 3000)')
   .option('--build', 'build website before serving (default: false)')
   .option('-h, --host <host>', 'use specified host (default: localhost)')
+  .option(
+    '--no-open',
+    'do not open page in the browser (default: false, or true in CI)',
+  )
   .action(async (siteDir, options) =>
     serve(await resolveDir(siteDir), options),
   );

package/lib/babel/preset.js

@@ -51,7 +51,8 @@ function getTransformOptions(isServer) {
                     // 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,
+                    version: require('@babel/runtime/package.json')
+                        .version,
                     regenerator: true,
                     useESModules: true,
                     // Undocumented option that lets us encapsulate our runtime, ensuring

package/lib/client/App.js

@@ -8,22 +8,22 @@ import React from 'react';
 import '@generated/client-modules';
 import routes from '@generated/routes';
 import { useLocation } from '@docusaurus/router';
-import normalizeLocation from './normalizeLocation';
 import renderRoutes from '@docusaurus/renderRoutes';
+import Root from '@theme/Root';
+import SiteMetadata from '@theme/SiteMetadata';
+import normalizeLocation from './normalizeLocation';
 import { BrowserContextProvider } from './browserContext';
 import { DocusaurusContextProvider } from './docusaurusContext';
 import PendingNavigation from './PendingNavigation';
 import BaseUrlIssueBanner from './BaseUrlIssueBanner';
 import SiteMetadataDefaults from './SiteMetadataDefaults';
-import Root from '@theme/Root';
-import SiteMetadata from '@theme/SiteMetadata';
 // TODO, quick fix for CSS insertion order
+// eslint-disable-next-line import/order
 import ErrorBoundary from '@docusaurus/ErrorBoundary';
-import Error from '@theme/Error';
 export default function App() {
     const routeElement = renderRoutes(routes);
     const location = useLocation();
-    return (<ErrorBoundary fallback={Error}>
+    return (<ErrorBoundary>
       <DocusaurusContextProvider>
         <BrowserContextProvider>
           <Root>

package/lib/client/ClientLifecyclesDispatcher.js

@@ -8,7 +8,7 @@ import { useLayoutEffect } from 'react';
 import clientModules from '@generated/client-modules';
 export function dispatchLifecycleAction(lifecycleAction, ...args) {
     const callbacks = clientModules.map((clientModule) => {
-        const lifecycleFunction = (clientModule?.default?.[lifecycleAction] ??
+        const lifecycleFunction = (clientModule.default?.[lifecycleAction] ??
             clientModule[lifecycleAction]);
         return lifecycleFunction?.(...args);
     });

package/lib/client/PendingNavigation.js

@@ -10,6 +10,8 @@ import ClientLifecyclesDispatcher, { dispatchLifecycleAction, } from './ClientLi
 import ExecutionEnvironment from './exports/ExecutionEnvironment';
 import preload from './preload';
 class PendingNavigation extends React.Component {
+    previousLocation;
+    routeUpdateCleanupCb;
     constructor(props) {
         super(props);
         // previousLocation doesn't affect rendering, hence not stored in state.
@@ -47,7 +49,7 @@ class PendingNavigation extends React.Component {
         // user is on saveData
         preload(nextLocation.pathname)
             .then(() => {
-            this.routeUpdateCleanupCb?.();
+            this.routeUpdateCleanupCb();
             this.setState({ nextRouteHasLoaded: true });
         })
             .catch((e) => console.warn(e));

package/lib/client/SiteMetadataDefaults.js

@@ -9,11 +9,13 @@ import Head from '@docusaurus/Head';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import useBaseUrl from '@docusaurus/useBaseUrl';
 export default function SiteMetadataDefaults() {
-    const { siteConfig: { favicon, tagline, title }, i18n: { currentLocale, localeConfigs }, } = useDocusaurusContext();
+    const { siteConfig: { favicon, title }, i18n: { currentLocale, localeConfigs }, } = useDocusaurusContext();
     const faviconUrl = useBaseUrl(favicon);
     const { htmlLang, direction: htmlDir } = localeConfigs[currentLocale];
-    return (<Head defaultTitle={`${title}${tagline ? ` · ${tagline}` : ''}`}>
+    return (<Head>
       <html lang={htmlLang} dir={htmlDir}/>
+      <title>{title}</title>
+      <meta property="og:title" content={title}/>
       {favicon && <link rel="icon" href={faviconUrl}/>}
     </Head>);
 }

package/lib/client/docusaurus.d.ts

@@ -9,7 +9,7 @@ declare global {
         gca: (name: string) => string;
     };
     interface Navigator {
-        connection: {
+        connection?: {
             effectiveType: string;
             saveData: boolean;
         };

package/lib/client/docusaurus.js

@@ -42,7 +42,7 @@ const docusaurus = {
             // In some cases, webpack might decide to optimize further, leading to
             // the chunk assets being merged to another chunk. In this case, we can
             // safely filter it out and don't need to load it.
-            if (chunkAsset && !/undefined/.test(chunkAsset)) {
+            if (chunkAsset && !chunkAsset.includes('undefined')) {
                 return prefetchHelper(chunkAsset);
             }
             return Promise.resolve();

package/lib/client/exports/ComponentCreator.d.ts

@@ -5,4 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 import Loadable from 'react-loadable';
+declare global {
+    interface NodeRequire {
+        resolveWeak: (name: string) => number;
+    }
+}
 export default function ComponentCreator(path: string, hash: string): ReturnType<typeof Loadable>;

package/lib/client/exports/ComponentCreator.js

@@ -6,9 +6,9 @@
  */
 import React from 'react';
 import Loadable from 'react-loadable';
-import Loading from '@theme/Loading';
 import routesChunkNames from '@generated/routesChunkNames';
 import registry from '@generated/registry';
+import Loading from '@theme/Loading';
 import flat from '../flat';
 import { RouteContextProvider } from '../routeContext';
 export default function ComponentCreator(path, hash) {
@@ -16,11 +16,17 @@ export default function ComponentCreator(path, hash) {
     if (path === '*') {
         return Loadable({
             loading: Loading,
-            loader: () => import('@theme/NotFound').then(({ default: NotFound }) => (props) => (<RouteContextProvider 
-            // Do we want a better name than native-default?
-            value={{ plugin: { name: 'native', id: 'default' } }}>
+            loader: () => import('@theme/NotFound'),
+            modules: ['@theme/NotFound'],
+            webpack: () => [require.resolveWeak('@theme/NotFound')],
+            render(loaded, props) {
+                const NotFound = loaded.default;
+                return (<RouteContextProvider 
+                // Do we want a better name than native-default?
+                value={{ plugin: { name: 'native', id: 'default' } }}>
             <NotFound {...props}/>
-          </RouteContextProvider>)),
+          </RouteContextProvider>);
+            },
         });
     }
     const chunkNames = routesChunkNames[`${path}-${hash}`];
@@ -49,7 +55,7 @@ export default function ComponentCreator(path, hash) {
         loader,
         modules,
         webpack: () => optsWebpack,
-        render: (loaded, props) => {
+        render(loaded, props) {
             // `loaded` will be a map from key path (as returned from the flattened
             // chunk names) to the modules loaded from the loaders. We now have to
             // restore the chunk names' previous shape from this flat record.
@@ -76,7 +82,8 @@ export default function ComponentCreator(path, hash) {
                     Object.keys(loadedModule)
                         .filter((k) => k !== 'default')
                         .forEach((nonDefaultKey) => {
-                        chunk[nonDefaultKey] = loadedModule[nonDefaultKey];
+                        chunk[nonDefaultKey] =
+                            loadedModule[nonDefaultKey];
                     });
                 }
                 // We now have this chunk prepared. Go down the key path and replace the

package/lib/client/exports/ErrorBoundary.js

@@ -6,7 +6,8 @@
  */
 import React from 'react';
 import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
-import DefaultFallback from '@theme/Error';
+import ThemeError from '@theme/Error';
+const DefaultFallback = (params) => (<ThemeError {...params}/>);
 export default class ErrorBoundary extends React.Component {
     constructor(props) {
         super(props);
@@ -22,14 +23,14 @@ export default class ErrorBoundary extends React.Component {
         const { children } = this.props;
         const { error } = this.state;
         if (error) {
-            const fallback = this.props.fallback ?? DefaultFallback;
-            return fallback({
+            const fallbackParams = {
                 error,
                 tryAgain: () => this.setState({ error: null }),
-            });
+            };
+            const fallback = this.props.fallback ?? DefaultFallback;
+            return fallback(fallbackParams);
         }
-        return (children ??
-            // See https://github.com/facebook/docusaurus/issues/6337#issuecomment-1012913647
-            null);
+        // See https://github.com/facebook/docusaurus/issues/6337#issuecomment-1012913647
+        return children ?? null;
     }
 }

package/lib/client/exports/Link.d.ts

@@ -7,5 +7,5 @@
 /// <reference types="@docusaurus/module-type-aliases" />
 import React from 'react';
 import type { Props } from '@docusaurus/Link';
-declare const _default: React.ForwardRefExoticComponent<Pick<Props, "children" | "replace" | "slot" | "style" | "title" | "location" | "component" | "exact" | "sensitive" | "strict" | "type" | "key" | "id" | "lang" | "dir" | "rel" | "href" | "isNavLink" | "className" | "to" | "innerRef" | "download" | "hrefLang" | "media" | "ping" | "target" | "referrerPolicy" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "activeClassName" | "activeStyle" | "isActive" | "data-noBrokenLinkCheck" | "autoAddBaseUrl"> & React.RefAttributes<HTMLAnchorElement>>;
+declare const _default: React.ForwardRefExoticComponent<Pick<Props, "location" | "children" | "replace" | "slot" | "style" | "title" | "component" | "exact" | "sensitive" | "strict" | "type" | "key" | "id" | "lang" | "dir" | "property" | "rel" | "href" | "isNavLink" | "className" | "to" | "innerRef" | "download" | "hrefLang" | "media" | "ping" | "target" | "referrerPolicy" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "activeClassName" | "activeStyle" | "isActive" | "data-noBrokenLinkCheck" | "autoAddBaseUrl"> & React.RefAttributes<HTMLAnchorElement>>;
 export default _default;

package/lib/client/exports/Link.js

@@ -6,12 +6,12 @@
  */
 import React, { useEffect, useImperativeHandle, useRef, } from 'react';
 import { NavLink, Link as RRLink } from 'react-router-dom';
+import { applyTrailingSlash } from '@docusaurus/utils-common';
 import useDocusaurusContext from './useDocusaurusContext';
 import isInternalUrl from './isInternalUrl';
 import ExecutionEnvironment from './ExecutionEnvironment';
 import { useLinksCollector } from '../LinksCollector';
 import { useBaseUrlUtils } from './useBaseUrl';
-import { applyTrailingSlash } from '@docusaurus/utils-common';
 // TODO all this wouldn't be necessary if we used ReactRouter basename feature
 // We don't automatically add base urls to all links,
 // only the "safe" ones, starting with / (like /docs/introduction)

package/lib/client/exports/isInternalUrl.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 export function hasProtocol(url) {
-    return /^(?:\w*:|\/\/)/.test(url) === true;
+    return /^(?:\w*:|\/\/)/.test(url);
 }
 export default function isInternalUrl(url) {
     return typeof url !== 'undefined' && !hasProtocol(url);

package/lib/client/exports/useGlobalData.js

@@ -8,9 +8,6 @@ import useDocusaurusContext from './useDocusaurusContext';
 import { DEFAULT_PLUGIN_ID } from './constants';
 export default function useGlobalData() {
     const { globalData } = useDocusaurusContext();
-    if (!globalData) {
-        throw new Error('Docusaurus global data not found.');
-    }
     return globalData;
 }
 export function useAllPluginInstancesData(pluginName, options = {}) {

package/lib/client/prefetch.js

@@ -7,9 +7,9 @@
 function supports(feature) {
     try {
         const fakeLink = document.createElement('link');
-        return fakeLink.relList?.supports?.(feature);
+        return fakeLink.relList.supports(feature);
     }
-    catch (err) {
+    catch {
         return false;
     }
 }

package/lib/client/preload.js

@@ -16,7 +16,5 @@ import { matchRoutes } from 'react-router-config';
  */
 export default function preload(pathname) {
     const matches = matchRoutes(routes, pathname);
-    return Promise.all(
-    // @ts-expect-error: ComponentCreator injected this method.
-    matches.map((match) => match.route.component?.preload?.()));
+    return Promise.all(matches.map((match) => match.route.component.preload?.()));
 }

package/lib/client/serverEntry.js

@@ -4,22 +4,22 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import * as eta from 'eta';
 import React from 'react';
+import path from 'path';
+import fs from 'fs-extra';
+// eslint-disable-next-line no-restricted-imports
+import _ from 'lodash';
+import chalk from 'chalk';
+import * as eta from 'eta';
 import { StaticRouter } from 'react-router-dom';
 import ReactDOMServer from 'react-dom/server';
 import { HelmetProvider } from 'react-helmet-async';
 import { getBundles } from 'react-loadable-ssr-addon-v5-slorber';
 import Loadable from 'react-loadable';
 import { minify } from 'html-minifier-terser';
-import path from 'path';
-import fs from 'fs-extra';
 import preload from './preload';
 import App from './App';
 import { createStatefulLinksCollector, LinksCollectorProvider, } from './LinksCollector';
-import logger from '@docusaurus/logger';
-// eslint-disable-next-line no-restricted-imports
-import _ from 'lodash';
 const getCompiledSSRTemplate = _.memoize((template) => eta.compile(template.trim(), {
     rmWhitespace: true,
 }));
@@ -32,12 +32,17 @@ export default async function render(locals) {
         return await doRender(locals);
     }
     catch (err) {
-        logger.error `Docusaurus server-side rendering could not render static page with path path=${locals.path}.`;
+        // We are not using logger in this file, because it seems to fail with some
+        // compilers / some polyfill methods. This is very likely a bug, but in the
+        // long term, when we output native ES modules in SSR, the bug will be gone.
+        // prettier-ignore
+        console.error(chalk.red(`${chalk.bold('[ERROR]')} Docusaurus server-side rendering could not render static page with path ${chalk.cyan.underline(locals.path)}.`));
         const isNotDefinedErrorRegex = /(?:window|document|localStorage|navigator|alert|location|buffer|self) is not defined/i;
         if (isNotDefinedErrorRegex.test(err.message)) {
-            logger.info `It looks like you are using code that should run on the client-side only.
-To get around it, try using code=${'<BrowserOnly>'} (url=${'https://docusaurus.io/docs/docusaurus-core/#browseronly'}) or code=${'ExecutionEnvironment'} (url=${'https://docusaurus.io/docs/docusaurus-core/#executionenvironment'}).
-It might also require to wrap your client code in code=${'useEffect'} hook and/or import a third-party library dynamically (if any).`;
+            // prettier-ignore
+            console.info(`${chalk.cyan.bold('[INFO]')} It looks like you are using code that should run on the client-side only.
+To get around it, try using ${chalk.cyan('`<BrowserOnly>`')} (${chalk.cyan.underline('https://docusaurus.io/docs/docusaurus-core/#browseronly')}) or ${chalk.cyan('`ExecutionEnvironment`')} (${chalk.cyan.underline('https://docusaurus.io/docs/docusaurus-core/#executionenvironment')}).
+It might also require to wrap your client code in ${chalk.cyan('`useEffect`')} hook and/or import a third-party library dynamically (if any).`);
         }
         throw err;
     }
@@ -76,7 +81,12 @@ async function doRender(locals) {
     const metaAttributes = metaStrings.filter(Boolean);
     const { generatedFilesDir } = locals;
     const manifestPath = path.join(generatedFilesDir, 'client-manifest.json');
-    const manifest = await fs.readJSON(manifestPath);
+    // Using readJSON seems to fail for users of some plugins, possibly because of
+    // the eval sandbox having a different `Buffer` instance (native one instead
+    // of polyfilled one)
+    const manifest = (await fs
+        .readFile(manifestPath, 'utf-8')
+        .then(JSON.parse));
     // Get all required assets for this particular page based on client
     // manifest information.
     const modulesToBeLoaded = [...manifest.entrypoints, ...Array.from(modules)];
@@ -110,7 +120,8 @@ async function doRender(locals) {
         });
     }
     catch (err) {
-        logger.error `Minification of page path=${locals.path} failed.`;
+        // prettier-ignore
+        console.error(chalk.red(`${chalk.bold('[ERROR]')} Minification of page ${chalk.cyan.underline(locals.path)} failed.`));
         throw err;
     }
 }

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

@@ -7,9 +7,9 @@
 // Should we translate theme-fallback?
 /* eslint-disable @docusaurus/no-untranslated-text */
 import React from 'react';
-import Layout from '@theme/Layout';
-import ErrorBoundary from '@docusaurus/ErrorBoundary';
 import Head from '@docusaurus/Head';
+import ErrorBoundary from '@docusaurus/ErrorBoundary';
+import Layout from '@theme/Layout';
 function ErrorDisplay({ error, tryAgain }) {
     return (<div style={{
             display: 'flex',

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

@@ -27,7 +27,7 @@ export default function Loading({ error, retry, pastDelay, }) {
                 maxWidth: '50%',
                 width: '100%',
             }}>
-        <p>{error.message}</p>
+        <p>{String(error)}</p>
         <div>
           <button type="button" onClick={retry}>
             Retry

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

@@ -7,8 +7,8 @@
 // Should we translate theme-fallback?
 /* eslint-disable @docusaurus/no-untranslated-text */
 import React from 'react';
-import Layout from '@theme/Layout';
 import Head from '@docusaurus/Head';
+import Layout from '@theme/Layout';
 export default function NotFound() {
     return (<>
       <Head>

package/lib/commands/build.js

@@ -8,10 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.build = void 0;
 const tslib_1 = require("tslib");
-const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
-const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
 const path_1 = tslib_1.__importDefault(require("path"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("@docusaurus/utils");
+const copy_webpack_plugin_1 = tslib_1.__importDefault(require("copy-webpack-plugin"));
 const react_loadable_ssr_addon_v5_slorber_1 = tslib_1.__importDefault(require("react-loadable-ssr-addon-v5-slorber"));
 const webpack_bundle_analyzer_1 = require("webpack-bundle-analyzer");
 const webpack_merge_1 = tslib_1.__importDefault(require("webpack-merge"));
@@ -19,10 +20,9 @@ const server_1 = require("../server");
 const brokenLinks_1 = require("../server/brokenLinks");
 const client_1 = tslib_1.__importDefault(require("../webpack/client"));
 const server_2 = tslib_1.__importDefault(require("../webpack/server"));
-const utils_1 = require("../webpack/utils");
+const utils_2 = require("../webpack/utils");
 const CleanWebpackPlugin_1 = tslib_1.__importDefault(require("../webpack/plugins/CleanWebpackPlugin"));
 const i18n_1 = require("../server/i18n");
-const utils_2 = require("@docusaurus/utils");
 async function build(siteDir, cliOptions, 
 // When running build, we force terminate the process to prevent async
 // operations from never returning. However, if run as part of docusaurus
@@ -69,7 +69,7 @@ forceTerminate = true) {
         i18n.defaultLocale,
         ...i18n.locales.filter((locale) => locale !== i18n.defaultLocale),
     ];
-    const results = await (0, utils_2.mapAsyncSequential)(orderedLocales, (locale) => {
+    const results = await (0, utils_1.mapAsyncSequential)(orderedLocales, (locale) => {
         const isLastLocale = orderedLocales.indexOf(locale) === orderedLocales.length - 1;
         return tryToBuildLocale({ locale, isLastLocale });
     });
@@ -139,12 +139,12 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
     plugins.forEach((plugin) => {
         const { configureWebpack, configurePostCss } = plugin;
         if (configurePostCss) {
-            clientConfig = (0, utils_1.applyConfigurePostCss)(configurePostCss.bind(plugin), clientConfig);
+            clientConfig = (0, utils_2.applyConfigurePostCss)(configurePostCss.bind(plugin), clientConfig);
         }
         if (configureWebpack) {
-            clientConfig = (0, utils_1.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
+            clientConfig = (0, utils_2.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
             clientConfig, false, props.siteConfig.webpack?.jsLoader, plugin.content);
-            serverConfig = (0, utils_1.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
+            serverConfig = (0, utils_2.applyConfigureWebpack)(configureWebpack.bind(plugin), // The plugin lifecycle may reference `this`.
             serverConfig, true, props.siteConfig.webpack?.jsLoader, plugin.content);
         }
     });
@@ -154,7 +154,7 @@ async function buildLocale({ siteDir, locale, cliOptions, forceTerminate, isLast
         await fs_extra_1.default.unlink(clientManifestPath);
     }
     // Run webpack to build JS bundle (client) and static html files (server).
-    await (0, utils_1.compile)([clientConfig, serverConfig]);
+    await (0, utils_2.compile)([clientConfig, serverConfig]);
     // Remove server.bundle.js because it is not needed.
     if (typeof serverConfig.output?.filename === 'string') {
         const serverBundle = path_1.default.join(outDir, serverConfig.output.filename);

package/lib/commands/deploy.js

@@ -9,13 +9,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.deploy = void 0;
 const tslib_1 = require("tslib");
 const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const shelljs_1 = tslib_1.__importDefault(require("shelljs"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const os_1 = tslib_1.__importDefault(require("os"));
 const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const shelljs_1 = tslib_1.__importDefault(require("shelljs"));
 const utils_1 = require("@docusaurus/utils");
 const server_1 = require("../server");
 const build_1 = require("./build");
-const path_1 = tslib_1.__importDefault(require("path"));
-const os_1 = tslib_1.__importDefault(require("os"));
 // GIT_PASS env variable should not appear in logs
 function obfuscateGitPass(str) {
     const gitPass = process.env.GIT_PASS;
@@ -55,7 +55,7 @@ This behavior can have SEO impacts and create relative link issues.
         .exec('git config --get remote.origin.url', { silent: true })
         .stdout.trim();
     // The source branch; defaults to the currently checked out branch
-    const sourceBranch = process.env.CURRENT_BRANCH ||
+    const sourceBranch = process.env.CURRENT_BRANCH ??
         shelljs_1.default.exec('git rev-parse --abbrev-ref HEAD', { silent: true }).stdout.trim();
     const gitUser = process.env.GIT_USER;
     let useSSH = process.env.USE_SSH !== undefined &&
@@ -69,22 +69,22 @@ This behavior can have SEO impacts and create relative link issues.
             throw new Error('Please set the GIT_USER environment variable, or explicitly specify USE_SSH instead!');
         }
     }
-    const organizationName = process.env.ORGANIZATION_NAME ||
-        process.env.CIRCLE_PROJECT_USERNAME ||
+    const organizationName = process.env.ORGANIZATION_NAME ??
+        process.env.CIRCLE_PROJECT_USERNAME ??
         siteConfig.organizationName;
     if (!organizationName) {
         throw new Error(`Missing project organization name. Did you forget to define "organizationName" in ${siteConfigPath}? You may also export it via the ORGANIZATION_NAME environment variable.`);
     }
     logger_1.default.info `organizationName: name=${organizationName}`;
-    const projectName = process.env.PROJECT_NAME ||
-        process.env.CIRCLE_PROJECT_REPONAME ||
+    const projectName = process.env.PROJECT_NAME ??
+        process.env.CIRCLE_PROJECT_REPONAME ??
         siteConfig.projectName;
     if (!projectName) {
         throw new Error(`Missing project name. Did you forget to define "projectName" in ${siteConfigPath}? You may also export it via the PROJECT_NAME environment variable.`);
     }
     logger_1.default.info `projectName: name=${projectName}`;
     // We never deploy on pull request.
-    const isPullRequest = process.env.CI_PULL_REQUEST || process.env.CIRCLE_PULL_REQUEST;
+    const isPullRequest = process.env.CI_PULL_REQUEST ?? process.env.CIRCLE_PULL_REQUEST;
     if (isPullRequest) {
         shelljs_1.default.echo('Skipping deploy on a pull request.');
         shelljs_1.default.exit(0);
@@ -102,10 +102,10 @@ This behavior can have SEO impacts and create relative link issues.
 Please provide the branch name to deploy to as an environment variable, for example DEPLOYMENT_BRANCH=main or DEPLOYMENT_BRANCH=master .
 You can also set the deploymentBranch property in docusaurus.config.js .`);
     }
-    const deploymentBranch = process.env.DEPLOYMENT_BRANCH || siteConfig.deploymentBranch || 'gh-pages';
+    const deploymentBranch = process.env.DEPLOYMENT_BRANCH ?? siteConfig.deploymentBranch ?? 'gh-pages';
     logger_1.default.info `deploymentBranch: name=${deploymentBranch}`;
-    const githubHost = process.env.GITHUB_HOST || siteConfig.githubHost || 'github.com';
-    const githubPort = process.env.GITHUB_PORT || siteConfig.githubPort;
+    const githubHost = process.env.GITHUB_HOST ?? siteConfig.githubHost ?? 'github.com';
+    const githubPort = process.env.GITHUB_PORT ?? siteConfig.githubPort;
     let deploymentRepoURL;
     if (useSSH) {
         deploymentRepoURL = (0, utils_1.buildSshUrl)(githubHost, organizationName, projectName, githubPort);
@@ -150,7 +150,7 @@ You can also set the deploymentBranch property in docusaurus.config.js .`);
             throw err;
         }
         shellExecLog('git add --all');
-        const commitMessage = process.env.CUSTOM_COMMIT_MESSAGE ||
+        const commitMessage = process.env.CUSTOM_COMMIT_MESSAGE ??
             `Deploy website - based on ${currentCommit}`;
         const commitResults = shellExecLog(`git commit -m "${commitMessage}"`);
         if (shellExecLog(`git push --force origin ${deploymentBranch}`).code !== 0) {

package/lib/commands/serve.d.ts

@@ -4,10 +4,11 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { LoadContextOptions } from '../server';
 import { type HostPortOptions } from '../server/getHostPort';
+import type { LoadContextOptions } from '../server';
 export declare type ServeCLIOptions = HostPortOptions & Pick<LoadContextOptions, 'config'> & {
     dir?: string;
     build?: boolean;
+    open?: boolean;
 };
 export declare function serve(siteDir: string, cliOptions: Partial<ServeCLIOptions>): Promise<void>;