@docusaurus/core 0.0.0-4517 → 0.0.0-4523

package/bin/beforeCli.js

@@ -20,105 +20,114 @@ const {
   engines: {node: requiredVersion},
 } = require('../package.json');
 
-// Notify user if @docusaurus packages is outdated
-//
-// Note: this is a 2-step process to avoid delaying cli usage by awaiting a response:
-// - 1st run: trigger background job to check releases + store result
-// - 2nd run: display potential update to users
-//
-// Note: even if the
-//
-// cache data is stored in ~/.config/configstore/update-notifier-@docusaurus
-//
-const notifier = updateNotifier({
-  pkg: {
-    name,
-    version,
-  },
-  // Check is in background so it's fine to use a small value like 1h
-  // Use 0 for debugging
-  updateCheckInterval: 1000 * 60 * 60,
-  // updateCheckInterval: 0
-});
-
-// Hacky way to ensure we check for updates on first run
-// Note: the notification will only happen in the 2nd run
-// See https://github.com/yeoman/update-notifier/issues/209
-try {
+// eslint-disable-next-line import/no-dynamic-require
+const sitePkg = require(path.resolve(process.cwd(), 'package.json'));
+
+/**
+ * Notify user if `@docusaurus` packages are outdated
+ *
+ * Note: this is a 2-step process to avoid delaying cli usage by awaiting a
+ * response:
+ * - 1st run: trigger background job to check releases + store result
+ * - 2nd run: display potential update to users
+ *
+ * cache data is stored in `~/.config/configstore/update-notifier-@docusaurus`
+ */
+function beforeCli() {
+  const notifier = updateNotifier({
+    pkg: {
+      name,
+      version,
+    },
+    // Check is in background so it's fine to use a small value like 1h
+    // Use 0 for debugging
+    updateCheckInterval: 1000 * 60 * 60,
+    // updateCheckInterval: 0
+  });
+
+  // Hacky way to ensure we check for updates on first run
+  // Note: the notification will only happen in the 2nd run
+  // See https://github.com/yeoman/update-notifier/issues/209
+  try {
+    if (
+      notifier.config &&
+      // @ts-expect-error: this is an internal API
+      !notifier.disabled &&
+      Date.now() - notifier.config.get('lastUpdateCheck') < 50
+    ) {
+      notifier.config.set('lastUpdateCheck', 0);
+      notifier.check();
+    }
+  } catch (e) {
+    // Do not stop cli if this fails, see https://github.com/facebook/docusaurus/issues/5400
+    logger.error(e);
+  }
+
+  /**
+   * We don't want to display update message for canary releases.
+   * See https://github.com/facebook/docusaurus/issues/5378
+   * @param {import('update-notifier').UpdateInfo} update
+   */
+  function ignoreUpdate(update) {
+    const isCanaryRelease =
+      update && update.current && update.current.startsWith('0.0.0');
+    return isCanaryRelease;
+  }
+
   if (
     notifier.config &&
-    !notifier.disabled &&
-    Date.now() - notifier.config.get('lastUpdateCheck') < 50
+    notifier.update &&
+    semver.lt(notifier.update.current, notifier.update.latest)
   ) {
-    notifier.config.set('lastUpdateCheck', 0);
-    notifier.check();
-  }
-} catch (e) {
-  // Do not stop cli if this fails, see https://github.com/facebook/docusaurus/issues/5400
-  logger.error(e);
-}
+    // Because notifier clears cached data after reading it, leading to notifier
+    // not consistently displaying the update.
+    // See https://github.com/yeoman/update-notifier/issues/209
+    notifier.config.set('update', notifier.update);
 
-// We don't want to display update message for canary releases
-// See https://github.com/facebook/docusaurus/issues/5378
-function ignoreUpdate(update) {
-  const isCanaryRelease =
-    update && update.current && update.current.startsWith('0.0.0');
-  return isCanaryRelease;
-}
+    if (ignoreUpdate(notifier.update)) {
+      return;
+    }
 
-if (
-  notifier.config &&
-  notifier.update &&
-  semver.lt(notifier.update.current, notifier.update.latest)
-) {
-  // Because notifier clears cached data after reading it, leading to notifier not consistently displaying the update
-  // See https://github.com/yeoman/update-notifier/issues/209
-  notifier.config.set('update', notifier.update);
+    const siteDocusaurusPackagesForUpdate = Object.keys({
+      ...sitePkg.dependencies,
+      ...sitePkg.devDependencies,
+    })
+      .filter((p) => p.startsWith('@docusaurus'))
+      .map((p) => p.concat('@latest'))
+      .join(' ');
+    const isYarnUsed = fs.existsSync(path.resolve(process.cwd(), 'yarn.lock'));
+    const upgradeCommand = isYarnUsed
+      ? `yarn upgrade ${siteDocusaurusPackagesForUpdate}`
+      : `npm i ${siteDocusaurusPackagesForUpdate}`;
 
-  if (ignoreUpdate(notifier.update)) {
-    // @ts-expect-error: it works
-    return;
+    /** @type {import('boxen').Options} */
+    const boxenOptions = {
+      padding: 1,
+      margin: 1,
+      align: 'center',
+      borderColor: 'yellow',
+      borderStyle: 'round',
+    };
+
+    const docusaurusUpdateMessage = boxen(
+      `Update available ${logger.dim(
+        `${notifier.update.current}`,
+      )} → ${logger.green(`${notifier.update.latest}`)}
+
+  To upgrade Docusaurus packages with the latest version, run the following command:
+  ${logger.code(upgradeCommand)}`,
+      boxenOptions,
+    );
+
+    console.log(docusaurusUpdateMessage);
   }
 
-  // eslint-disable-next-line import/no-dynamic-require, global-require
-  const sitePkg = require(path.resolve(process.cwd(), 'package.json'));
-  const siteDocusaurusPackagesForUpdate = Object.keys({
-    ...sitePkg.dependencies,
-    ...sitePkg.devDependencies,
-  })
-    .filter((p) => p.startsWith('@docusaurus'))
-    .map((p) => p.concat('@latest'))
-    .join(' ');
-  const isYarnUsed = fs.existsSync(path.resolve(process.cwd(), 'yarn.lock'));
-  const upgradeCommand = isYarnUsed
-    ? `yarn upgrade ${siteDocusaurusPackagesForUpdate}`
-    : `npm i ${siteDocusaurusPackagesForUpdate}`;
-
-  /** @type {import('boxen').Options} */
-  const boxenOptions = {
-    padding: 1,
-    margin: 1,
-    align: 'center',
-    borderColor: 'yellow',
-    borderStyle: 'round',
-  };
-
-  const docusaurusUpdateMessage = boxen(
-    `Update available ${logger.dim(
-      `${notifier.update.current}`,
-    )} → ${logger.green(`${notifier.update.latest}`)}
-
-To upgrade Docusaurus packages with the latest version, run the following command:
-${logger.code(upgradeCommand)}`,
-    boxenOptions,
-  );
-
-  console.log(docusaurusUpdateMessage);
+  // notify user if node version needs to be updated
+  if (!semver.satisfies(process.version, requiredVersion)) {
+    logger.error('Minimum Node.js version not met :(');
+    logger.info`You are using Node.js number=${process.version}, Requirement: Node.js number=${requiredVersion}.`;
+    process.exit(1);
+  }
 }
 
-// notify user if node version needs to be updated
-if (!semver.satisfies(process.version, requiredVersion)) {
-  logger.error('Minimum Node.js version not met :(');
-  logger.info`You are using Node.js number=${process.version}, Requirement: Node.js number=${requiredVersion}.`;
-  process.exit(1);
-}
+module.exports = beforeCli;

package/bin/docusaurus.js

@@ -23,7 +23,9 @@ const {
   writeHeadingIds,
 } = require('../lib');
 
-require('./beforeCli');
+const beforeCli = require('./beforeCli');
+
+beforeCli();
 
 const resolveDir = (dir = '.') => fs.realpathSync(dir);
 
@@ -239,7 +241,6 @@ function isInternalCommand(command) {
 
 async function run() {
   if (!isInternalCommand(process.argv.slice(2)[0])) {
-    // @ts-expect-error: Hmmm
     await externalCommand(cli, resolveDir('.'));
   }
 

package/lib/client/App.js

@@ -17,11 +17,17 @@ import './client-lifecycles-dispatcher';
 import ErrorBoundary from '@docusaurus/ErrorBoundary';
 import Error from '@theme/Error';
 function App() {
-    return (React.createElement(ErrorBoundary, { fallback: Error },
-        React.createElement(DocusaurusContextProvider, null,
-            React.createElement(BrowserContextProvider, null,
-                React.createElement(Root, null,
-                    React.createElement(BaseUrlIssueBanner, null),
-                    React.createElement(PendingNavigation, { routes: routes, delay: 1000 }, renderRoutes(routes)))))));
+    return (<ErrorBoundary fallback={Error}>
+      <DocusaurusContextProvider>
+        <BrowserContextProvider>
+          <Root>
+            <BaseUrlIssueBanner />
+            <PendingNavigation routes={routes} delay={1000}>
+              {renderRoutes(routes)}
+            </PendingNavigation>
+          </Root>
+        </BrowserContextProvider>
+      </DocusaurusContextProvider>
+    </ErrorBoundary>);
 }
 export default App;

package/lib/client/LinksCollector.js

@@ -23,5 +23,5 @@ const Context = createContext({
 });
 export const useLinksCollector = () => useContext(Context);
 export function ProvideLinksCollector({ children, linksCollector, }) {
-    return React.createElement(Context.Provider, { value: linksCollector }, children);
+    return <Context.Provider value={linksCollector}>{children}</Context.Provider>;
 }

package/lib/client/PendingNavigation.js

@@ -92,7 +92,7 @@ class PendingNavigation extends React.Component {
     }
     render() {
         const { children, location } = this.props;
-        return (React.createElement(Route, { location: normalizeLocation(location), render: () => children }));
+        return (<Route location={normalizeLocation(location)} render={() => children}/>);
     }
 }
 export default withRouter(PendingNavigation);

package/lib/client/baseUrlIssueBanner/BaseUrlIssueBanner.js

@@ -67,10 +67,12 @@ function BaseUrlIssueBannerEnabled() {
     useLayoutEffect(() => {
         window[InsertBannerWindowAttribute] = false;
     }, []);
-    return (React.createElement(React.Fragment, null,
-        !ExecutionEnvironment.canUseDOM && (React.createElement(Head, null,
-            React.createElement("script", null, createInlineScript(baseUrl)))),
-        React.createElement("div", { id: BannerContainerId })));
+    return (<>
+      {!ExecutionEnvironment.canUseDOM && (<Head>
+          <script>{createInlineScript(baseUrl)}</script>
+        </Head>)}
+      <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
@@ -83,5 +85,5 @@ export default function BaseUrlIssueBanner() {
     // returns true for the homepage during SRR
     const isHomePage = pathname === baseUrl;
     const enabled = baseUrlIssueBanner && isHomePage;
-    return enabled ? React.createElement(BaseUrlIssueBannerEnabled, null) : null;
+    return enabled ? <BaseUrlIssueBannerEnabled /> : null;
 }

package/lib/client/clientEntry.js

@@ -20,8 +20,9 @@ if (ExecutionEnvironment.canUseDOM) {
     // Note that 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(React.createElement(BrowserRouter, null,
-            React.createElement(App, null)), document.getElementById('__docusaurus'));
+        renderMethod(<BrowserRouter>
+        <App />
+      </BrowserRouter>, document.getElementById('__docusaurus'));
     });
     // Webpack Hot Module Replacement API
     if (module.hot) {

package/lib/client/exports/BrowserOnly.js

@@ -16,7 +16,7 @@ function BrowserOnly({ children, fallback, }) {
             throw new Error(`Docusaurus error: The children of <BrowserOnly> must be a "render function", e.g. <BrowserOnly>{() => <span>{window.location.href}</span>}</BrowserOnly>.
 Current type: ${isValidElement(children) ? 'React element' : typeof children}`);
         }
-        return React.createElement(React.Fragment, null, children());
+        return <>{children()}</>;
     }
     return fallback || null;
 }

package/lib/client/exports/ComponentCreator.js

@@ -38,11 +38,10 @@ function ComponentCreator(path, hash) {
     Object.keys(flatChunkNames).forEach((key) => {
         const chunkRegistry = registry[flatChunkNames[key]];
         if (chunkRegistry) {
-            /* eslint-disable prefer-destructuring */
+            // eslint-disable-next-line prefer-destructuring
             optsLoader[key] = chunkRegistry[0];
             optsModules.push(chunkRegistry[1]);
             optsWebpack.push(chunkRegistry[2]);
-            /* eslint-enable prefer-destructuring */
         }
     });
     return Loadable.Map({
@@ -70,7 +69,7 @@ function ComponentCreator(path, hash) {
             });
             const Component = loadedModules.component;
             delete loadedModules.component;
-            return React.createElement(Component, { ...loadedModules, ...props });
+            return <Component {...loadedModules} {...props}/>;
         },
     });
 }

package/lib/client/exports/Head.js

@@ -7,6 +7,6 @@
 import React from 'react';
 import { Helmet } from 'react-helmet';
 function Head(props) {
-    return React.createElement(Helmet, { ...props });
+    return <Helmet {...props}/>;
 }
 export default Head;

package/lib/client/exports/Interpolate.js

@@ -44,9 +44,10 @@ export function interpolate(text, values) {
     else {
         return processedText.split(ValueFoundMarker).reduce((array, value, index) => [
             ...array,
-            React.createElement(React.Fragment, { key: index },
-                value,
-                elements[index]),
+            <React.Fragment key={index}>
+          {value}
+          {elements[index]}
+        </React.Fragment>,
         ], []);
     }
 }

package/lib/client/exports/Link.js

@@ -107,7 +107,9 @@ function Link({ isNavLink, to, href, activeClassName, isActive, 'data-noBrokenLi
     }
     return isRegularHtmlLink ? (
     // eslint-disable-next-line jsx-a11y/anchor-has-content
-    React.createElement("a", { href: targetLink, ...(targetLinkUnprefixed &&
-            !isInternal && { target: '_blank', rel: 'noopener noreferrer' }), ...props })) : (React.createElement(LinkComponent, { ...props, onMouseEnter: onMouseEnter, innerRef: handleRef, to: targetLink || '', ...(isNavLink && { isActive, activeClassName }) }));
+    <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"
+    {...(isNavLink && { isActive, activeClassName })}/>);
 }
 export default Link;

package/lib/client/exports/browserContext.js

@@ -17,5 +17,5 @@ export function BrowserContextProvider({ children, }) {
     useEffect(() => {
         setIsBrowser(true);
     }, []);
-    return React.createElement(Context.Provider, { value: isBrowser }, children);
+    return <Context.Provider value={isBrowser}>{children}</Context.Provider>;
 }

package/lib/client/exports/docusaurusContext.js

@@ -21,5 +21,5 @@ const contextValue = {
 };
 export const Context = React.createContext(contextValue);
 export function DocusaurusContextProvider({ children, }) {
-    return React.createElement(Context.Provider, { value: contextValue }, children);
+    return <Context.Provider value={contextValue}>{children}</Context.Provider>;
 }

package/lib/client/serverEntry.js

@@ -54,10 +54,13 @@ async function doRender(locals) {
     const modules = new Set();
     const context = {};
     const linksCollector = createStatefulLinksCollector();
-    const appHtml = ReactDOMServer.renderToString(React.createElement(Loadable.Capture, { report: (moduleName) => modules.add(moduleName) },
-        React.createElement(StaticRouter, { location: location, context: context },
-            React.createElement(ProvideLinksCollector, { linksCollector: linksCollector },
-                React.createElement(App, null)))));
+    const appHtml = ReactDOMServer.renderToString(<Loadable.Capture report={(moduleName) => modules.add(moduleName)}>
+      <StaticRouter location={location} context={context}>
+        <ProvideLinksCollector linksCollector={linksCollector}>
+          <App />
+        </ProvideLinksCollector>
+      </StaticRouter>
+    </Loadable.Capture>);
     onLinksCollected(location, linksCollector.getCollectedLinks());
     const helmet = Helmet.renderStatic();
     const htmlAttributes = helmet.htmlAttributes.toString();

package/lib/client/theme-fallback/Error/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/// <reference types="@docusaurus/module-type-aliases" />
+/// <reference types="react" />
+import type { Props } from '@theme/Error';
+declare function Error({ error, tryAgain }: Props): JSX.Element;
+export default Error;

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

@@ -4,44 +4,35 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
 import Layout from '@theme/Layout';
 import ErrorBoundary from '@docusaurus/ErrorBoundary';
-
-function ErrorDisplay({error, tryAgain}) {
-  return (
-    <div
-      style={{
-        display: 'flex',
-        flexDirection: 'column',
-        justifyContent: 'center',
-        alignItems: 'center',
-        height: '50vh',
-        width: '100%',
-        fontSize: '20px',
-      }}>
+function ErrorDisplay({ error, tryAgain }) {
+    return (<div style={{
+            display: 'flex',
+            flexDirection: 'column',
+            justifyContent: 'center',
+            alignItems: 'center',
+            height: '50vh',
+            width: '100%',
+            fontSize: '20px',
+        }}>
       <h1>This page crashed.</h1>
       <p>{error.message}</p>
       <button type="button" onClick={tryAgain}>
         Try again
       </button>
-    </div>
-  );
+    </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
-  return (
-    <ErrorBoundary
-      // Note: we display the original error here, not the error that we captured in this extra error boundary
-      fallback={() => <ErrorDisplay error={error} tryAgain={tryAgain} />}>
+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
+    return (<ErrorBoundary 
+    // 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} />
+        <ErrorDisplay error={error} tryAgain={tryAgain}/>
       </Layout>
-    </ErrorBoundary>
-  );
+    </ErrorBoundary>);
 }
-
 export default Error;

package/lib/client/theme-fallback/Layout/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/// <reference types="@docusaurus/module-type-aliases" />
+/// <reference types="react" />
+import type { Props } from '@theme/Layout';
+declare function Layout({ children, title, description }: Props): JSX.Element;
+export default Layout;

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

@@ -4,31 +4,23 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
 import Head from '@docusaurus/Head';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import useBaseUrl from '@docusaurus/useBaseUrl';
-
-function Layout(props) {
-  const context = useDocusaurusContext();
-  const {siteConfig = {}} = context;
-  const {favicon, tagline = '', title: defaultTitle} = siteConfig;
-  const {children, title, description} = props;
-  const faviconUrl = useBaseUrl(favicon);
-  return (
-    <>
+function Layout({ children, title, description }) {
+    const context = useDocusaurusContext();
+    const { siteConfig } = context;
+    const { favicon, tagline, title: defaultTitle } = siteConfig;
+    const faviconUrl = useBaseUrl(favicon);
+    return (<>
       <Head defaultTitle={`${defaultTitle}${tagline ? ` · ${tagline}` : ''}`}>
         {title && <title>{`${title} · ${tagline}`}</title>}
-        {favicon && <link rel="icon" href={faviconUrl} />}
-        {description && <meta name="description" content={description} />}
-        {description && (
-          <meta property="og:description" content={description} />
-        )}
+        {favicon && <link rel="icon" href={faviconUrl}/>}
+        {description && <meta name="description" content={description}/>}
+        {description && (<meta property="og:description" content={description}/>)}
       </Head>
       {children}
-    </>
-  );
+    </>);
 }
-
 export default Layout;

package/lib/client/theme-fallback/Loading/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/// <reference types="react" />
+import type { LoadingComponentProps } from 'react-loadable';
+export default function Loading({ error, retry, pastDelay, }: LoadingComponentProps): JSX.Element | null;

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

@@ -4,133 +4,65 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
-
-export default function Loading({error, retry, pastDelay}) {
-  if (error) {
-    return (
-      <div
-        style={{
-          align: 'center',
-          color: '#fff',
-          backgroundColor: '#fa383e',
-          borderColor: '#fa383e',
-          borderStyle: 'solid',
-          borderRadius: '0.25rem',
-          borderWidth: '1px',
-          boxSizing: 'border-box',
-          display: 'block',
-          padding: '1rem',
-          flex: '0 0 50%',
-          marginLeft: '25%',
-          marginRight: '25%',
-          marginTop: '5rem',
-          maxWidth: '50%',
-          width: '100%',
-        }}>
+export default function Loading({ error, retry, pastDelay, }) {
+    if (error) {
+        return (<div style={{
+                textAlign: 'center',
+                color: '#fff',
+                backgroundColor: '#fa383e',
+                borderColor: '#fa383e',
+                borderStyle: 'solid',
+                borderRadius: '0.25rem',
+                borderWidth: '1px',
+                boxSizing: 'border-box',
+                display: 'block',
+                padding: '1rem',
+                flex: '0 0 50%',
+                marginLeft: '25%',
+                marginRight: '25%',
+                marginTop: '5rem',
+                maxWidth: '50%',
+                width: '100%',
+            }}>
         <p>{error.message}</p>
         <div>
           <button type="button" onClick={retry}>
             Retry
           </button>
         </div>
-      </div>
-    );
-  }
-
-  if (pastDelay) {
-    return (
-      <div
-        style={{
-          display: 'flex',
-          justifyContent: 'center',
-          alignItems: 'center',
-          height: '100vh',
-        }}>
-        <svg
-          id="loader"
-          style={{
-            width: 128,
-            height: 110,
-            position: 'absolute',
-            top: 'calc(100vh - 64%)',
-          }}
-          viewBox="0 0 45 45"
-          xmlns="http://www.w3.org/2000/svg"
-          stroke="#61dafb">
-          <g
-            fill="none"
-            fillRule="evenodd"
-            transform="translate(1 1)"
-            strokeWidth="2">
+      </div>);
+    }
+    if (pastDelay) {
+        return (<div style={{
+                display: 'flex',
+                justifyContent: 'center',
+                alignItems: 'center',
+                height: '100vh',
+            }}>
+        <svg id="loader" style={{
+                width: 128,
+                height: 110,
+                position: 'absolute',
+                top: 'calc(100vh - 64%)',
+            }} viewBox="0 0 45 45" xmlns="http://www.w3.org/2000/svg" stroke="#61dafb">
+          <g fill="none" fillRule="evenodd" transform="translate(1 1)" strokeWidth="2">
             <circle cx="22" cy="22" r="6" strokeOpacity="0">
-              <animate
-                attributeName="r"
-                begin="1.5s"
-                dur="3s"
-                values="6;22"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-opacity"
-                begin="1.5s"
-                dur="3s"
-                values="1;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-width"
-                begin="1.5s"
-                dur="3s"
-                values="2;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="1.5s" dur="3s" values="6;22" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-opacity" begin="1.5s" dur="3s" values="1;0" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-width" begin="1.5s" dur="3s" values="2;0" calcMode="linear" repeatCount="indefinite"/>
             </circle>
             <circle cx="22" cy="22" r="6" strokeOpacity="0">
-              <animate
-                attributeName="r"
-                begin="3s"
-                dur="3s"
-                values="6;22"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-opacity"
-                begin="3s"
-                dur="3s"
-                values="1;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
-              <animate
-                attributeName="stroke-width"
-                begin="3s"
-                dur="3s"
-                values="2;0"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="3s" dur="3s" values="6;22" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-opacity" begin="3s" dur="3s" values="1;0" calcMode="linear" repeatCount="indefinite"/>
+              <animate attributeName="stroke-width" begin="3s" dur="3s" values="2;0" calcMode="linear" repeatCount="indefinite"/>
             </circle>
             <circle cx="22" cy="22" r="8">
-              <animate
-                attributeName="r"
-                begin="0s"
-                dur="1.5s"
-                values="6;1;2;3;4;5;6"
-                calcMode="linear"
-                repeatCount="indefinite"
-              />
+              <animate attributeName="r" begin="0s" dur="1.5s" values="6;1;2;3;4;5;6" calcMode="linear" repeatCount="indefinite"/>
             </circle>
           </g>
         </svg>
-      </div>
-    );
-  }
-
-  return null;
+      </div>);
+    }
+    return null;
 }

package/lib/client/theme-fallback/NotFound/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/// <reference types="react" />
+declare function NotFound(): JSX.Element;
+export default NotFound;

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

@@ -4,25 +4,19 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 import React from 'react';
 import Layout from '@theme/Layout';
-
 function NotFound() {
-  return (
-    <Layout title="Page Not Found">
-      <div
-        style={{
-          display: 'flex',
-          justifyContent: 'center',
-          alignItems: 'center',
-          height: '50vh',
-          fontSize: '20px',
+    return (<Layout title="Page Not Found">
+      <div style={{
+            display: 'flex',
+            justifyContent: 'center',
+            alignItems: 'center',
+            height: '50vh',
+            fontSize: '20px',
         }}>
         <h1>Oops, page not found </h1>
       </div>
-    </Layout>
-  );
+    </Layout>);
 }
-
 export default NotFound;

package/lib/client/theme-fallback/Root/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { ReactNode } from 'react';
+declare function Root({ children }: {
+    children: ReactNode;
+}): ReactNode;
+export default Root;

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

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-
 // Wrapper at the very top of the app, that is applied constantly
 // and does not depend on current route (unlike the layout)
 //
@@ -12,8 +11,7 @@
 // and these providers won't reset state when we navigate
 //
 // See https://github.com/facebook/docusaurus/issues/3919
-function Root({children}) {
-  return children;
+function Root({ children }) {
+    return children;
 }
-
 export default Root;

package/lib/commands/external.d.ts

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { Command } from 'commander';
-export default function externalCommand(cli: Command, siteDir: string): Promise<void>;
+import type { CommanderStatic } from 'commander';
+export default function externalCommand(cli: CommanderStatic, siteDir: string): Promise<void>;

package/lib/server/configValidation.d.ts

@@ -7,6 +7,6 @@
 import type { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
 import { Joi } from '@docusaurus/utils-validation';
 export declare const DEFAULT_I18N_CONFIG: I18nConfig;
-export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'baseUrlIssueBanner' | 'staticDirectories'>;
+export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'tagline' | 'baseUrlIssueBanner' | 'staticDirectories'>;
 export declare const ConfigSchema: Joi.ObjectSchema<any>;
 export declare function validateConfig(config: Partial<DocusaurusConfig>): DocusaurusConfig;

package/lib/server/configValidation.js

@@ -29,6 +29,7 @@ exports.DEFAULT_CONFIG = {
     themeConfig: {},
     titleDelimiter: '|',
     noIndex: false,
+    tagline: '',
     baseUrlIssueBanner: true,
     staticDirectories: [utils_1.STATIC_DIR_NAME],
 };
@@ -143,7 +144,7 @@ exports.ConfigSchema = utils_validation_1.Joi.object({
         type: utils_validation_1.Joi.string(),
     }).unknown()),
     clientModules: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()),
-    tagline: utils_validation_1.Joi.string().allow(''),
+    tagline: utils_validation_1.Joi.string().allow('').default(exports.DEFAULT_CONFIG.tagline),
     titleDelimiter: utils_validation_1.Joi.string().default('|'),
     noIndex: utils_validation_1.Joi.bool().default(false),
     webpack: utils_validation_1.Joi.object({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-4517",
+  "version": "0.0.0-4523",
   "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-4517",
-    "@docusaurus/logger": "0.0.0-4517",
-    "@docusaurus/mdx-loader": "0.0.0-4517",
+    "@docusaurus/cssnano-preset": "0.0.0-4523",
+    "@docusaurus/logger": "0.0.0-4523",
+    "@docusaurus/mdx-loader": "0.0.0-4523",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-4517",
-    "@docusaurus/utils-common": "0.0.0-4517",
-    "@docusaurus/utils-validation": "0.0.0-4517",
+    "@docusaurus/utils": "0.0.0-4523",
+    "@docusaurus/utils-common": "0.0.0-4523",
+    "@docusaurus/utils-validation": "0.0.0-4523",
     "@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-4517",
-    "@docusaurus/types": "0.0.0-4517",
+    "@docusaurus/module-type-aliases": "0.0.0-4523",
+    "@docusaurus/types": "0.0.0-4523",
     "@types/copy-webpack-plugin": "^8.0.1",
     "@types/detect-port": "^1.3.0",
     "@types/mini-css-extract-plugin": "^1.4.3",
@@ -116,6 +116,7 @@
     "@types/react-router-config": "^5.0.1",
     "@types/rtl-detect": "^1.0.0",
     "@types/serve-handler": "^6.1.1",
+    "@types/update-notifier": "^5.1.0",
     "@types/wait-on": "^5.2.0",
     "@types/webpack-bundle-analyzer": "^4.4.1",
     "react-test-renderer": "^17.0.2",
@@ -128,5 +129,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "8025e5a9a77a8efc6977252c1e43c150f12bc15c"
+  "gitHead": "e78e68d4bc6a23f7e616eb7b59da9c79d9fb7452"
 }