@docusaurus/theme-classic 0.0.0-4224 → 0.0.0-4241

package/lib/theme/DocCard/index.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = DocCard;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _Link = _interopRequireDefault(require("@docusaurus/Link"));
+
+var _themeCommon = require("@docusaurus/theme-common");
+
+var _clsx = _interopRequireDefault(require("clsx"));
+
+var _stylesModule = _interopRequireDefault(require("./styles.module.css"));
+
+var _isInternalUrl = _interopRequireDefault(require("@docusaurus/isInternalUrl"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * 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.
+ */
+function CardContainer({
+  href,
+  children
+}) {
+  const className = (0, _clsx.default)('card margin-bottom--lg padding--lg', _stylesModule.default.cardContainer, href && _stylesModule.default.cardContainerLink);
+  return href ? <_Link.default href={href} className={className}>
+      {children}
+    </_Link.default> : <div className={className}>{children}</div>;
+}
+
+function CardLayout({
+  href,
+  icon,
+  title,
+  description
+}) {
+  return <CardContainer href={href}>
+      <h2 className={(0, _clsx.default)('text--truncate', _stylesModule.default.cardTitle)} title={title}>
+        {icon} {title}
+      </h2>
+      <div className={(0, _clsx.default)('text--truncate', _stylesModule.default.cardDescription)} title={description}>
+        {description}
+      </div>
+    </CardContainer>;
+}
+
+function CardCategory({
+  item
+}) {
+  const href = (0, _themeCommon.findFirstCategoryLink)(item);
+  return <CardLayout href={href} icon="🗃️" title={item.label} description={`${item.items.length} items`} />;
+}
+
+function CardLink({
+  item
+}) {
+  var _item$docId;
+
+  const icon = (0, _isInternalUrl.default)(item.href) ? '📄️' : '🔗';
+  const doc = (0, _themeCommon.useDocById)((_item$docId = item.docId) !== null && _item$docId !== void 0 ? _item$docId : undefined);
+  return <CardLayout href={item.href} icon={icon} title={item.label} description={doc === null || doc === void 0 ? void 0 : doc.description} />;
+}
+
+function DocCard({
+  item
+}) {
+  switch (item.type) {
+    case 'link':
+      return <CardLink item={item} />;
+
+    case 'category':
+      return <CardCategory item={item} />;
+
+    default:
+      throw new Error(`unknown item type ${JSON.stringify(item)}`);
+  }
+}

package/lib/theme/DocCard/styles.module.css

@@ -0,0 +1,43 @@
+/**
+ * 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.
+ */
+
+.cardContainer {
+  height: 8rem;
+
+  color: var(--ifm-color-emphasis-800);
+  --ifm-link-color: var(--ifm-color-emphasis-800);
+  --ifm-link-hover-color: var(--ifm-color-emphasis-800);
+  --ifm-link-hover-decoration: none;
+
+  /* box-shadow: var(--ifm-global-shadow-lw); */
+  box-shadow: 0 1.5px 3px 0 rgba(0, 0, 0, 0.15);
+  border: 1px solid var(--ifm-color-emphasis-200);
+  transition: box-shadow var(--ifm-transition-fast) ease,
+    background-color var(--ifm-transition-fast) ease;
+}
+
+.cardContainer.cardContainerLink:hover {
+  /* box-shadow: var(--ifm-global-shadow-md); */
+  box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);
+}
+html[data-theme='dark'] .cardContainer.cardContainerLink:hover {
+  --ifm-card-background-color: #2d2d2d; /* original, non-hovered color is #242526 */
+}
+
+.cardContainer:not(.cardContainerLink) {
+  cursor: not-allowed;
+}
+
+.cardTitle {
+  font-size: 1.2rem;
+  min-height: 1.2rem;
+}
+
+.cardDescription {
+  font-size: 0.8rem;
+  min-height: 0.8rem;
+}

package/lib/theme/DocCardList/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = DocCardList;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _DocCard = _interopRequireDefault(require("@theme/DocCard"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * 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.
+ */
+function DocCardList({
+  items
+}) {
+  return <div className="row">
+      {items.map((item, index) => <article key={index} className="col col--6">
+          <_DocCard.default item={item} />
+        </article>)}
+    </div>;
+}

package/lib/theme/DocCategoryGeneratedIndexPage/index.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = DocCategoryGeneratedIndexPage;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _themeCommon = require("@docusaurus/theme-common");
+
+var _DocCardList = _interopRequireDefault(require("@theme/DocCardList"));
+
+var _DocPaginator = _interopRequireDefault(require("@theme/DocPaginator"));
+
+var _Seo = _interopRequireDefault(require("@theme/Seo"));
+
+var _DocVersionBanner = _interopRequireDefault(require("@theme/DocVersionBanner"));
+
+var _DocVersionBadge = _interopRequireDefault(require("@theme/DocVersionBadge"));
+
+var _Heading = require("@theme/Heading");
+
+var _stylesModule = _interopRequireDefault(require("./styles.module.css"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * 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.
+ */
+function DocCategoryGeneratedIndexPage({
+  categoryGeneratedIndex
+}) {
+  const category = (0, _themeCommon.useCurrentSidebarCategory)();
+  return <>
+      <_Seo.default title={categoryGeneratedIndex.title} description={categoryGeneratedIndex.description} />
+      <div className={_stylesModule.default.generatedIndexPage}>
+        <_DocVersionBanner.default />
+        <_DocVersionBadge.default />
+        <header>
+          <_Heading.MainHeading className={_stylesModule.default.title}>
+            {categoryGeneratedIndex.title}
+          </_Heading.MainHeading>
+          {categoryGeneratedIndex.description && <p>{categoryGeneratedIndex.description}</p>}
+        </header>
+        <main className="margin-top--lg">
+          <_DocCardList.default items={category.items} />
+        </main>
+        <footer className="margin-top--lg">
+          <_DocPaginator.default previous={categoryGeneratedIndex.navigation.previous} next={categoryGeneratedIndex.navigation.next} />
+        </footer>
+      </div>
+    </>;
+}

package/lib/theme/DocCategoryGeneratedIndexPage/styles.module.css

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+
+@media (min-width: 997px) {
+  .generatedIndexPage {
+    max-width: 75% !important;
+  }
+}
+
+/* Duplicated from .markdown h1 */
+.title {
+  --ifm-h1-font-size: 3rem;
+  margin-bottom: calc(1.25 * var(--ifm-leading));
+}

package/lib/theme/DocItem/index.js

@@ -15,6 +15,8 @@ var _DocPaginator = _interopRequireDefault(require("@theme/DocPaginator"));
 
 var _DocVersionBanner = _interopRequireDefault(require("@theme/DocVersionBanner"));
 
+var _DocVersionBadge = _interopRequireDefault(require("@theme/DocVersionBadge"));
+
 var _Seo = _interopRequireDefault(require("@theme/Seo"));
 
 var _DocItemFooter = _interopRequireDefault(require("@theme/DocItemFooter"));
@@ -39,8 +41,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  */
 function DocItem(props) {
   const {
-    content: DocContent,
-    versionMetadata
+    content: DocContent
   } = props;
   const {
     metadata,
@@ -77,12 +78,10 @@ function DocItem(props) {
         <div className={(0, _clsx.default)('col', {
         [_stylesModule.default.docItemCol]: !hideTableOfContents
       })}>
-          <_DocVersionBanner.default versionMetadata={versionMetadata} />
+          <_DocVersionBanner.default />
           <div className={_stylesModule.default.docItemContainer}>
             <article>
-              {versionMetadata.badge && <span className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docVersionBadge, 'badge badge--secondary')}>
-                  Version: {versionMetadata.label}
-                </span>}
+              <_DocVersionBadge.default />
 
               {canRenderTOC && <_TOCCollapsible.default toc={DocContent.toc} minHeadingLevel={tocMinHeadingLevel} maxHeadingLevel={tocMaxHeadingLevel} className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docTocMobile, _stylesModule.default.tocMobile)} />}
 
@@ -102,7 +101,7 @@ function DocItem(props) {
               <_DocItemFooter.default {...props} />
             </article>
 
-            <_DocPaginator.default metadata={metadata} />
+            <_DocPaginator.default previous={metadata.previous} next={metadata.next} />
           </div>
         </div>
         {renderTocDesktop && <div className="col col--3">

package/lib/theme/DocPage/index.js

@@ -50,14 +50,14 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
 function DocPageContent({
   currentDocRoute,
   versionMetadata,
-  children
+  children,
+  sidebarName
 }) {
+  const sidebar = (0, _themeCommon.useDocsSidebar)();
   const {
     pluginId,
     version
   } = versionMetadata;
-  const sidebarName = currentDocRoute.sidebar;
-  const sidebar = sidebarName ? versionMetadata.docsSidebars[sidebarName] : undefined;
   const [hiddenSidebarContainer, setHiddenSidebarContainer] = (0, _react.useState)(false);
   const [hiddenSidebar, setHiddenSidebar] = (0, _react.useState)(false);
   const toggleSidebar = (0, _react.useCallback)(() => {
@@ -126,8 +126,11 @@ function DocPage(props) {
 
   if (!currentDocRoute) {
     return <_NotFound.default />;
-  }
+  } // For now, the sidebarName is added as route config: not ideal!
+
 
+  const sidebarName = currentDocRoute.sidebar;
+  const sidebar = sidebarName ? versionMetadata.docsSidebars[sidebarName] : null;
   return <>
       <_Head.default>
         {
@@ -135,11 +138,15 @@ function DocPage(props) {
       }
         <html className={versionMetadata.className} />
       </_Head.default>
-      <DocPageContent currentDocRoute={currentDocRoute} versionMetadata={versionMetadata}>
-        {(0, _renderRoutes.default)(docRoutes, {
-        versionMetadata
-      })}
-      </DocPageContent>
+      <_themeCommon.DocsVersionProvider version={versionMetadata}>
+        <_themeCommon.DocsSidebarProvider sidebar={sidebar}>
+          <DocPageContent currentDocRoute={currentDocRoute} versionMetadata={versionMetadata} sidebarName={sidebarName}>
+            {(0, _renderRoutes.default)(docRoutes, {
+            versionMetadata
+          })}
+          </DocPageContent>
+        </_themeCommon.DocsSidebarProvider>
+      </_themeCommon.DocsVersionProvider>
     </>;
 }
 

package/lib/theme/DocPaginator/index.js

@@ -25,7 +25,8 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  */
 function DocPaginator(props) {
   const {
-    metadata
+    previous,
+    next
   } = props;
   return <nav className="pagination-nav docusaurus-mt-lg" aria-label={(0, _Translate.translate)({
     id: 'theme.docs.paginator.navAriaLabel',
@@ -33,27 +34,25 @@ function DocPaginator(props) {
     description: 'The ARIA label for the docs pagination'
   })}>
       <div className="pagination-nav__item">
-        {metadata.previous && <_Link.default className="pagination-nav__link" to={metadata.previous.permalink}>
+        {previous && <_Link.default className="pagination-nav__link" to={previous.permalink}>
             <div className="pagination-nav__sublabel">
               <_Translate.default id="theme.docs.paginator.previous" description="The label used to navigate to the previous doc">
                 Previous
               </_Translate.default>
             </div>
             <div className="pagination-nav__label">
-              &laquo; {metadata.previous.title}
+              &laquo; {previous.title}
             </div>
           </_Link.default>}
       </div>
       <div className="pagination-nav__item pagination-nav__item--next">
-        {metadata.next && <_Link.default className="pagination-nav__link" to={metadata.next.permalink}>
+        {next && <_Link.default className="pagination-nav__link" to={next.permalink}>
             <div className="pagination-nav__sublabel">
               <_Translate.default id="theme.docs.paginator.next" description="The label used to navigate to the next doc">
                 Next
               </_Translate.default>
             </div>
-            <div className="pagination-nav__label">
-              {metadata.next.title} &raquo;
-            </div>
+            <div className="pagination-nav__label">{next.title} &raquo;</div>
           </_Link.default>}
       </div>
     </nav>;

package/lib/theme/DocSidebar/index.js

@@ -101,7 +101,16 @@ const DocSidebarMobileSecondaryMenu = ({
   sidebar,
   path
 }) => <ul className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docSidebarMenu, 'menu__list')}>
-    <_DocSidebarItem.DocSidebarItems items={sidebar} activePath={path} onItemClick={() => toggleSidebar()} level={1} />
+    <_DocSidebarItem.DocSidebarItems items={sidebar} activePath={path} onItemClick={item => {
+    // Mobile sidebar should only be closed if the category has a link
+    if (item.type === 'category' && item.href) {
+      toggleSidebar();
+    }
+
+    if (item.type === 'link') {
+      toggleSidebar();
+    }
+  }} level={1} />
   </ul>;
 
 function DocSidebarMobile(props) {

package/lib/theme/DocSidebarItem/index.js

@@ -16,10 +16,14 @@ var _Link = _interopRequireDefault(require("@docusaurus/Link"));
 
 var _isInternalUrl = _interopRequireDefault(require("@docusaurus/isInternalUrl"));
 
+var _Translate = require("@docusaurus/Translate");
+
 var _IconExternalLink = _interopRequireDefault(require("@theme/IconExternalLink"));
 
 var _stylesModule = _interopRequireDefault(require("./styles.module.css"));
 
+var _useIsBrowser = _interopRequireDefault(require("@docusaurus/useIsBrowser"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -32,21 +36,9 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-const isActiveSidebarItem = (item, activePath) => {
-  if (item.type === 'link') {
-    return (0, _themeCommon.isSamePath)(item.href, activePath);
-  }
-
-  if (item.type === 'category') {
-    return item.items.some(subItem => isActiveSidebarItem(subItem, activePath));
-  }
-
-  return false;
-}; // Optimize sidebar at each "level"
+// Optimize sidebar at each "level"
 // TODO this item should probably not receive the "activePath" props
 // TODO this triggers whole sidebar re-renders on navigation
-
-
 const DocSidebarItems = (0, _react.memo)(({
   items,
   ...props
@@ -88,6 +80,28 @@ function useAutoExpandActiveCategory({
       setCollapsed(false);
     }
   }, [isActive, wasActive, collapsed, setCollapsed]);
+} // When a collapsible category has no link, we still link it to its first child during SSR as a temporary fallback
+// This allows to be able to navigate inside the category even when JS fails to load, is delayed or simply disabled
+// React hydration becomes an optional progressive enhancement
+// see https://github.com/facebookincubator/infima/issues/36#issuecomment-772543188
+// see https://github.com/facebook/docusaurus/issues/3030
+
+
+function useCategoryHrefWithSSRFallback(item) {
+  const isBrowser = (0, _useIsBrowser.default)();
+  return (0, _react.useMemo)(() => {
+    if (item.href) {
+      return item.href;
+    } // In these cases, it's not necessary to render a fallback
+    // We skip the "findFirstCategoryLink" computation
+
+
+    if (isBrowser || !item.collapsible) {
+      return undefined;
+    }
+
+    return (0, _themeCommon.findFirstCategoryLink)(item);
+  }, [item, isBrowser]);
 }
 
 function DocSidebarItemCategory({
@@ -101,9 +115,11 @@ function DocSidebarItemCategory({
     items,
     label,
     collapsible,
-    className
+    className,
+    href
   } = item;
-  const isActive = isActiveSidebarItem(item, activePath);
+  const hrefWithSSRFallback = useCategoryHrefWithSSRFallback(item);
+  const isActive = (0, _themeCommon.isActiveSidebarItem)(item, activePath);
   const {
     collapsed,
     setCollapsed,
@@ -127,19 +143,37 @@ function DocSidebarItemCategory({
   return <li className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docSidebarItemCategory, _themeCommon.ThemeClassNames.docs.docSidebarItemCategoryLevel(level), 'menu__list-item', {
     'menu__list-item--collapsed': collapsed
   }, className)}>
-      {
-      /* eslint-disable-next-line jsx-a11y/anchor-is-valid */
-    }
-      <a className={(0, _clsx.default)('menu__link', {
-      'menu__link--sublist': collapsible,
-      'menu__link--active': collapsible && isActive,
-      [_stylesModule.default.menuLinkText]: !collapsible
-    })} onClick={collapsible ? e => {
-      e.preventDefault();
-      toggleCollapsed();
-    } : undefined} href={collapsible ? '#' : undefined} {...props}>
-        {label}
-      </a>
+      <div className="menu__list-item-collapsible">
+        <_Link.default className={(0, _clsx.default)('menu__link', {
+        'menu__link--sublist': collapsible && !href,
+        'menu__link--active': isActive,
+        [_stylesModule.default.menuLinkText]: !collapsible,
+        [_stylesModule.default.hasHref]: !!hrefWithSSRFallback
+      })} onClick={collapsible ? e => {
+        onItemClick === null || onItemClick === void 0 ? void 0 : onItemClick(item);
+
+        if (href) {
+          setCollapsed(false);
+        } else {
+          e.preventDefault();
+          toggleCollapsed();
+        }
+      } : () => {
+        onItemClick === null || onItemClick === void 0 ? void 0 : onItemClick(item);
+      }} href={collapsible ? hrefWithSSRFallback !== null && hrefWithSSRFallback !== void 0 ? hrefWithSSRFallback : '#' : hrefWithSSRFallback} {...props}>
+          {label}
+        </_Link.default>
+        {href && collapsible && <button aria-label={(0, _Translate.translate)({
+        id: 'theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel',
+        message: "Toggle the collapsible sidebar category '{label}'",
+        description: 'The ARIA label to toggle the collapsible sidebar category'
+      }, {
+        label
+      })} type="button" className="clean-btn menu__caret" onClick={e => {
+        e.preventDefault();
+        toggleCollapsed();
+      }} />}
+      </div>
 
       <_themeCommon.Collapsible lazy as="ul" className="menu__list" collapsed={collapsed}>
         <DocSidebarItems items={items} tabIndex={collapsed ? -1 : 0} onItemClick={onItemClick} activePath={activePath} level={level + 1} />
@@ -159,12 +193,12 @@ function DocSidebarItemLink({
     label,
     className
   } = item;
-  const isActive = isActiveSidebarItem(item, activePath);
+  const isActive = (0, _themeCommon.isActiveSidebarItem)(item, activePath);
   return <li className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docSidebarItemLink, _themeCommon.ThemeClassNames.docs.docSidebarItemLinkLevel(level), 'menu__list-item', className)} key={label}>
       <_Link.default className={(0, _clsx.default)('menu__link', {
       'menu__link--active': isActive
     })} aria-current={isActive ? 'page' : undefined} to={href} {...(0, _isInternalUrl.default)(href) && {
-      onClick: onItemClick
+      onClick: onItemClick ? () => onItemClick(item) : undefined
     }} {...props}>
         {(0, _isInternalUrl.default)(href) ? label : <span>
             {label}

package/lib/theme/DocSidebarItem/styles.module.css

@@ -12,4 +12,8 @@
   .menuLinkText:hover {
     background: none;
   }
+
+  .menuLinkText.hasHref {
+    cursor: pointer;
+  }
 }

package/lib/theme/DocVersionBadge/index.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = DocVersionBadge;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _themeCommon = require("@docusaurus/theme-common");
+
+var _clsx = _interopRequireDefault(require("clsx"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * 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.
+ */
+function DocVersionBadge({
+  className
+}) {
+  const versionMetadata = (0, _themeCommon.useDocsVersion)();
+
+  if (versionMetadata.badge) {
+    return <span className={(0, _clsx.default)(className, _themeCommon.ThemeClassNames.docs.docVersionBadge, 'badge badge--secondary')}>
+        Version: {versionMetadata.label}
+      </span>;
+  }
+
+  return null;
+}

package/lib/theme/DocVersionBanner/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.default = DocVersionBanner;
 
 var _react = _interopRequireDefault(require("react"));
 
@@ -81,6 +81,7 @@ function LatestVersionSuggestionLabel({
 }
 
 function DocVersionBannerEnabled({
+  className,
   versionMetadata
 }) {
   const {
@@ -106,7 +107,7 @@ function DocVersionBannerEnabled({
   // fallback to main doc of latest version
 
   const latestVersionSuggestedDoc = latestDocSuggestion !== null && latestDocSuggestion !== void 0 ? latestDocSuggestion : getVersionMainDoc(latestVersionSuggestion);
-  return <div className={(0, _clsx.default)(_themeCommon.ThemeClassNames.docs.docVersionBanner, 'alert alert--warning margin-bottom--md')} role="alert">
+  return <div className={(0, _clsx.default)(className, _themeCommon.ThemeClassNames.docs.docVersionBanner, 'alert alert--warning margin-bottom--md')} role="alert">
       <div>
         <BannerLabel siteTitle={siteTitle} versionMetadata={versionMetadata} />
       </div>
@@ -117,14 +118,13 @@ function DocVersionBannerEnabled({
 }
 
 function DocVersionBanner({
-  versionMetadata
+  className
 }) {
+  const versionMetadata = (0, _themeCommon.useDocsVersion)();
+
   if (versionMetadata.banner) {
-    return <DocVersionBannerEnabled versionMetadata={versionMetadata} />;
+    return <DocVersionBannerEnabled className={className} versionMetadata={versionMetadata} />;
   }
 
   return null;
-}
-
-var _default = DocVersionBanner;
-exports.default = _default;
+}

package/lib/theme-classic.d.ts

@@ -107,11 +107,12 @@ declare module '@theme/CodeBlock' {
 }
 
 declare module '@theme/DocPaginator' {
+  import type {PropNavigation} from '@docusaurus/plugin-content-docs';
+
   type PageInfo = {readonly permalink: string; readonly title: string};
 
-  export interface Props {
-    readonly metadata: {readonly previous?: PageInfo; readonly next?: PageInfo};
-  }
+  // May be simpler to provide a {navigation: PropNavigation} prop?
+  export interface Props extends PropNavigation {}
 
   const DocPaginator: (props: Props) => JSX.Element;
   export default DocPaginator;
@@ -138,7 +139,7 @@ declare module '@theme/DocSidebarItem' {
 
   type DocSidebarPropsBase = {
     readonly activePath: string;
-    readonly onItemClick?: () => void;
+    readonly onItemClick?: (item: PropSidebarItem) => void;
     readonly level: number;
     readonly tabIndex?: number;
   };