@docusaurus/theme-classic 3.4.0 → 3.5.1

package/lib/theme/Icon/Socials/StackOverflow/index.js

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+// SVG Source: https://svgl.app/
+function StackOverflow(props) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 169.61 200"
+      width="1em"
+      height="1em"
+      {...props}>
+      <path
+        d="M140.44 178.38v-48.65h21.61V200H0v-70.27h21.61v48.65z"
+        fill="#bcbbbb"
+      />
+      <path
+        d="M124.24 140.54l4.32-16.22-86.97-17.83-3.78 17.83zM49.7 82.16L130.72 120l7.56-16.22-81.02-37.83zm22.68-40l68.06 57.3 11.35-13.51-68.6-57.3-11.35 13.51zM116.14 0l-14.59 10.81 53.48 71.89 14.58-10.81zM37.81 162.16h86.43v-16.21H37.81z"
+        fill="#f48024"
+      />
+    </svg>
+  );
+}
+export default StackOverflow;

package/lib/theme/Icon/Socials/Twitter/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.
+ */
+import type { SVGProps } from 'react';
+declare function Twitter(props: SVGProps<SVGSVGElement>): JSX.Element;
+export default Twitter;

package/lib/theme/Icon/Socials/Twitter/index.js

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+// SVG Source: https://svgl.app/
+function Twitter(props) {
+  return (
+    <svg
+      viewBox="0 0 256 209"
+      width="1em"
+      height="1em"
+      xmlns="http://www.w3.org/2000/svg"
+      preserveAspectRatio="xMidYMid"
+      {...props}>
+      <path
+        d="M256 25.45c-9.42 4.177-19.542 7-30.166 8.27 10.845-6.5 19.172-16.793 23.093-29.057a105.183 105.183 0 0 1-33.351 12.745C205.995 7.201 192.346.822 177.239.822c-29.006 0-52.523 23.516-52.523 52.52 0 4.117.465 8.125 1.36 11.97-43.65-2.191-82.35-23.1-108.255-54.876-4.52 7.757-7.11 16.78-7.11 26.404 0 18.222 9.273 34.297 23.365 43.716a52.312 52.312 0 0 1-23.79-6.57c-.003.22-.003.44-.003.661 0 25.447 18.104 46.675 42.13 51.5a52.592 52.592 0 0 1-23.718.9c6.683 20.866 26.08 36.05 49.062 36.475-17.975 14.086-40.622 22.483-65.228 22.483-4.24 0-8.42-.249-12.529-.734 23.243 14.902 50.85 23.597 80.51 23.597 96.607 0 149.434-80.031 149.434-149.435 0-2.278-.05-4.543-.152-6.795A106.748 106.748 0 0 0 256 25.45"
+        fill="#55acee"
+      />
+    </svg>
+  );
+}
+export default Twitter;

package/lib/theme/Icon/Socials/X/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.
+ */
+import type { SVGProps } from 'react';
+declare function X(props: SVGProps<SVGSVGElement>): JSX.Element;
+export default X;

package/lib/theme/Icon/Socials/X/index.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import clsx from 'clsx';
+import styles from './styles.module.css';
+// SVG Source: https://svgl.app/
+function X(props) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      width="1em"
+      height="1em"
+      fill="none"
+      viewBox="0 0 1200 1227"
+      {...props}
+      className={clsx(props.className, styles.xSvg)}
+      style={{'--dark': '#000', '--light': '#fff'}}>
+      <path d="M714.163 519.284 1160.89 0h-105.86L667.137 450.887 357.328 0H0l468.492 681.821L0 1226.37h105.866l409.625-476.152 327.181 476.152H1200L714.137 519.284h.026ZM569.165 687.828l-47.468-67.894-377.686-540.24h162.604l304.797 435.991 47.468 67.894 396.2 566.721H892.476L569.165 687.854v-.026Z" />
+    </svg>
+  );
+}
+export default X;

package/lib/theme/Icon/Socials/X/styles.module.css

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+
+[data-theme='dark'] .xSvg {
+  fill: var(--light);
+}
+
+[data-theme='light'] .xSvg {
+  fill: var(--dark);
+}

package/lib/theme/Icon/Success/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Icon/Success';
 export default function IconSuccess(props: Props): JSX.Element;

package/lib/theme/Icon/WordWrap/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Icon/WordWrap';
 export default function IconWordWrap(props: Props): JSX.Element;

package/lib/theme/LastUpdated/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/LastUpdated';
 export default function LastUpdated({ lastUpdatedAt, lastUpdatedBy, }: Props): JSX.Element;

package/lib/theme/Layout/Provider/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Layout/Provider';
 export default function LayoutProvider({ children }: Props): JSX.Element;

package/lib/theme/Layout/Provider/index.js

@@ -9,11 +9,11 @@ import {composeProviders} from '@docusaurus/theme-common';
 import {
   ColorModeProvider,
   AnnouncementBarProvider,
-  DocsPreferredVersionContextProvider,
   ScrollControllerProvider,
   NavbarProvider,
   PluginHtmlClassNameProvider,
 } from '@docusaurus/theme-common/internal';
+import {DocsPreferredVersionContextProvider} from '@docusaurus/plugin-content-docs/client';
 const Provider = composeProviders([
   ColorModeProvider,
   AnnouncementBarProvider,

package/lib/theme/Layout/index.d.ts

@@ -4,8 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
-/// <reference types="@docusaurus/module-type-aliases" />
 import type { Props } from '@theme/Layout';
 export default function Layout(props: Props): JSX.Element;

package/lib/theme/Logo/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Logo';
 export default function Logo(props: Props): JSX.Element;

package/lib/theme/MDXComponents/A.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/A';
 export default function MDXA(props: Props): JSX.Element;

package/lib/theme/MDXComponents/Code.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/Code';
 export default function MDXCode(props: Props): JSX.Element;

package/lib/theme/MDXComponents/Details.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/Details';
 export default function MDXDetails(props: Props): JSX.Element;

package/lib/theme/MDXComponents/Heading.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/Heading';
 export default function MDXHeading(props: Props): JSX.Element;

package/lib/theme/MDXComponents/Img/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/Img';
 export default function MDXImg(props: Props): JSX.Element;

package/lib/theme/MDXComponents/Li.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import { type ReactNode } from 'react';
 import type { Props } from '@theme/MDXComponents/Li';
 export default function MDXLi(props: Props): ReactNode | undefined;

package/lib/theme/MDXComponents/Pre.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import { type ReactNode } from 'react';
 import type { Props } from '@theme/MDXComponents/Pre';
 export default function MDXPre(props: Props): ReactNode | undefined;

package/lib/theme/MDXComponents/Ul/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXComponents/Ul';
 export default function MDXUl(props: Props): JSX.Element;

package/lib/theme/MDXComponents/index.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import type { MDXComponentsObject } from '@theme/MDXComponents';
 declare const MDXComponents: MDXComponentsObject;
 export default MDXComponents;

package/lib/theme/MDXContent/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXContent';
 export default function MDXContent({ children }: Props): JSX.Element;

package/lib/theme/MDXPage/index.d.ts

@@ -4,7 +4,5 @@
  * 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/plugin-content-pages" />
-/// <reference types="react" />
 import type { Props } from '@theme/MDXPage';
 export default function MDXPage(props: Props): JSX.Element;

package/lib/theme/MDXPage/index.js

@@ -14,23 +14,20 @@ import {
 import Layout from '@theme/Layout';
 import MDXContent from '@theme/MDXContent';
 import TOC from '@theme/TOC';
-import Unlisted from '@theme/Unlisted';
+import ContentVisibility from '@theme/ContentVisibility';
 import EditMetaRow from '@theme/EditMetaRow';
 import styles from './styles.module.css';
 export default function MDXPage(props) {
   const {content: MDXPageContent} = props;
+  const {metadata, assets} = MDXPageContent;
   const {
-    metadata: {
-      title,
-      editUrl,
-      description,
-      frontMatter,
-      unlisted,
-      lastUpdatedBy,
-      lastUpdatedAt,
-    },
-    assets,
-  } = MDXPageContent;
+    title,
+    editUrl,
+    description,
+    frontMatter,
+    lastUpdatedBy,
+    lastUpdatedAt,
+  } = metadata;
   const {
     keywords,
     wrapperClassName,
@@ -54,7 +51,7 @@ export default function MDXPage(props) {
         <main className="container container--fluid margin-vert--lg">
           <div className={clsx('row', styles.mdxPageWrapper)}>
             <div className={clsx('col', !hideTableOfContents && 'col--8')}>
-              {unlisted && <Unlisted />}
+              <ContentVisibility metadata={metadata} />
               <article>
                 <MDXContent>
                   <MDXPageContent />

package/lib/theme/Mermaid.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export { default } from '@docusaurus/Noop';

package/lib/theme/Navbar/ColorModeToggle/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Navbar/ColorModeToggle';
 export default function NavbarColorModeToggle({ className, }: Props): JSX.Element | null;

package/lib/theme/Navbar/Content/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarContent(): JSX.Element;

package/lib/theme/Navbar/Layout/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Navbar/Layout';
 export default function NavbarLayout({ children }: Props): JSX.Element;

package/lib/theme/Navbar/Logo/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarLogo(): JSX.Element;

package/lib/theme/Navbar/MobileSidebar/Header/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarMobileSidebarHeader(): JSX.Element;

package/lib/theme/Navbar/MobileSidebar/Layout/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Navbar/MobileSidebar/Layout';
 export default function NavbarMobileSidebarLayout({ header, primaryMenu, secondaryMenu, }: Props): JSX.Element;

package/lib/theme/Navbar/MobileSidebar/PrimaryMenu/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarMobilePrimaryMenu(): JSX.Element;

package/lib/theme/Navbar/MobileSidebar/SecondaryMenu/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarMobileSidebarSecondaryMenu(): JSX.Element | null;

package/lib/theme/Navbar/MobileSidebar/Toggle/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function MobileSidebarToggle(): JSX.Element;

package/lib/theme/Navbar/MobileSidebar/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function NavbarMobileSidebar(): JSX.Element | null;

package/lib/theme/Navbar/Search/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Navbar/Search';
 export default function NavbarSearch({ children, className, }: Props): JSX.Element;

package/lib/theme/Navbar/index.d.ts

@@ -4,5 +4,4 @@
  * 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" />
 export default function Navbar(): JSX.Element;

package/lib/theme/NavbarItem/ComponentTypes.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import type { ComponentTypesObject } from '@theme/NavbarItem/ComponentTypes';
 declare const ComponentTypes: ComponentTypesObject;
 export default ComponentTypes;

package/lib/theme/NavbarItem/DefaultNavbarItem.d.ts

@@ -4,8 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DefaultNavbarItem({ mobile, position, // Need to destructure position from props so that it doesn't get passed on.
 ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocNavbarItem';
 export default function DocNavbarItem({ docId, label: staticLabel, docsPluginId, ...props }: Props): JSX.Element | null;

package/lib/theme/NavbarItem/DocNavbarItem.js

@@ -5,8 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useActiveDocContext} from '@docusaurus/plugin-content-docs/client';
-import {useLayoutDoc} from '@docusaurus/theme-common/internal';
+import {
+  useActiveDocContext,
+  useLayoutDoc,
+} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DocNavbarItem({
   docId,

package/lib/theme/NavbarItem/DocSidebarNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocSidebarNavbarItem';
 export default function DocSidebarNavbarItem({ sidebarId, label, docsPluginId, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocSidebarNavbarItem.js

@@ -5,8 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useActiveDocContext} from '@docusaurus/plugin-content-docs/client';
-import {useLayoutDocsSidebar} from '@docusaurus/theme-common/internal';
+import {
+  useActiveDocContext,
+  useLayoutDocsSidebar,
+} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DocSidebarNavbarItem({
   sidebarId,

package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocsVersionDropdownNavbarItem';
 export default function DocsVersionDropdownNavbarItem({ mobile, docsPluginId, dropdownActiveClassDisabled, dropdownItemsBefore, dropdownItemsAfter, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.js

@@ -8,15 +8,24 @@ import React from 'react';
 import {
   useVersions,
   useActiveDocContext,
+  useDocsVersionCandidates,
+  useDocsPreferredVersion,
 } from '@docusaurus/plugin-content-docs/client';
-import {useDocsPreferredVersion} from '@docusaurus/theme-common';
-import {useDocsVersionCandidates} from '@docusaurus/theme-common/internal';
 import {translate} from '@docusaurus/Translate';
 import {useLocation} from '@docusaurus/router';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 import DropdownNavbarItem from '@theme/NavbarItem/DropdownNavbarItem';
-const getVersionMainDoc = (version) =>
-  version.docs.find((doc) => doc.id === version.mainDocId);
+function getVersionMainDoc(version) {
+  return version.docs.find((doc) => doc.id === version.mainDocId);
+}
+function getVersionTargetDoc(version, activeDocContext) {
+  // We try to link to the same doc, in another version
+  // When not possible, fallback to the "main doc" of the version
+  return (
+    activeDocContext.alternateDocVersions[version.name] ??
+    getVersionMainDoc(version)
+  );
+}
 export default function DocsVersionDropdownNavbarItem({
   mobile,
   docsPluginId,
@@ -29,23 +38,19 @@ export default function DocsVersionDropdownNavbarItem({
   const activeDocContext = useActiveDocContext(docsPluginId);
   const versions = useVersions(docsPluginId);
   const {savePreferredVersionName} = useDocsPreferredVersion(docsPluginId);
-  const versionLinks = versions.map((version) => {
-    // We try to link to the same doc, in another version
-    // When not possible, fallback to the "main doc" of the version
-    const versionDoc =
-      activeDocContext.alternateDocVersions[version.name] ??
-      getVersionMainDoc(version);
+  function versionToLink(version) {
+    const targetDoc = getVersionTargetDoc(version, activeDocContext);
     return {
       label: version.label,
       // preserve ?search#hash suffix on version switches
-      to: `${versionDoc.path}${search}${hash}`,
+      to: `${targetDoc.path}${search}${hash}`,
       isActive: () => version === activeDocContext.activeVersion,
       onClick: () => savePreferredVersionName(version.name),
     };
-  });
+  }
   const items = [
     ...dropdownItemsBefore,
-    ...versionLinks,
+    ...versions.map(versionToLink),
     ...dropdownItemsAfter,
   ];
   const dropdownVersion = useDocsVersionCandidates(docsPluginId)[0];
@@ -62,7 +67,7 @@ export default function DocsVersionDropdownNavbarItem({
   const dropdownTo =
     mobile && items.length > 1
       ? undefined
-      : getVersionMainDoc(dropdownVersion).path;
+      : getVersionTargetDoc(dropdownVersion, activeDocContext).path;
   // We don't want to render a version dropdown with 0 or 1 item. If we build
   // the site with a single docs version (onlyIncludeVersions: ['1.0.0']),
   // We'd rather render a button instead of a dropdown

package/lib/theme/NavbarItem/DocsVersionNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocsVersionNavbarItem';
 export default function DocsVersionNavbarItem({ label: staticLabel, to: staticTo, docsPluginId, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocsVersionNavbarItem.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useDocsVersionCandidates} from '@docusaurus/theme-common/internal';
+import {useDocsVersionCandidates} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 const getVersionMainDoc = (version) =>
   version.docs.find((doc) => doc.id === version.mainDocId);

package/lib/theme/NavbarItem/DropdownNavbarItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DropdownNavbarItem';
 export default function DropdownNavbarItem({ mobile, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/HtmlNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/HtmlNavbarItem';
 export default function HtmlNavbarItem({ value, className, mobile, isDropdownItem, }: Props): JSX.Element;

package/lib/theme/NavbarItem/LocaleDropdownNavbarItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/LocaleDropdownNavbarItem';
 export default function LocaleDropdownNavbarItem({ mobile, dropdownItemsBefore, dropdownItemsAfter, queryString, ...props }: Props): JSX.Element;