@docusaurus/theme-classic 3.6.3 → 3.7.0

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NavbarItem/HtmlNavbarItem';
-export default function HtmlNavbarItem({ value, className, mobile, isDropdownItem, }: Props): JSX.Element;
+export default function HtmlNavbarItem({ value, className, mobile, isDropdownItem, }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NavbarItem/LocaleDropdownNavbarItem';
-export default function LocaleDropdownNavbarItem({ mobile, dropdownItemsBefore, dropdownItemsAfter, queryString, ...props }: Props): JSX.Element;
+export default function LocaleDropdownNavbarItem({ mobile, dropdownItemsBefore, dropdownItemsAfter, queryString, ...props }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NavbarItem/NavbarNavLink';
-export default function NavbarNavLink({ activeBasePath, activeBaseRegex, to, href, label, html, isDropdownLink, prependBaseUrlToHref, ...props }: Props): JSX.Element;
+export default function NavbarNavLink({ activeBasePath, activeBaseRegex, to, href, label, html, isDropdownLink, prependBaseUrlToHref, ...props }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NavbarItem/SearchNavbarItem';
-export default function SearchNavbarItem({ mobile, className, }: Props): JSX.Element | null;
+export default function SearchNavbarItem({ mobile, className, }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NavbarItem';
-export default function NavbarItem({ type, ...props }: Props): JSX.Element;
+export default function NavbarItem({ type, ...props }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/NotFound/Content';
-export default function NotFoundContent({ className }: Props): JSX.Element;
+export default function NotFoundContent({ className }: Props): ReactNode;

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

@@ -4,4 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export default function Index(): JSX.Element;
+import { type ReactNode } from 'react';
+export default function Index(): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/PaginatorNavLink';
-export default function PaginatorNavLink(props: Props): JSX.Element;
+export default function PaginatorNavLink(props: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/SearchMetadata';
-export default function SearchMetadata({ locale, version, tag, }: Props): JSX.Element;
+export default function SearchMetadata({ locale, version, tag, }: Props): ReactNode;

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

@@ -4,4 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export default function SiteMetadata(): JSX.Element;
+import { type ReactNode } from 'react';
+export default function SiteMetadata(): ReactNode;

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

@@ -4,4 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export default function SkipToContent(): JSX.Element;
+import { type ReactNode } from 'react';
+export default function SkipToContent(): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TOC';
-export default function TOC({ className, ...props }: Props): JSX.Element;
+export default function TOC({ className, ...props }: Props): ReactNode;

package/lib/theme/TOCCollapsible/CollapseButton/index.d.ts

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TOCCollapsible/CollapseButton';
-export default function TOCCollapsibleCollapseButton({ collapsed, ...props }: Props): JSX.Element;
+export default function TOCCollapsibleCollapseButton({ collapsed, ...props }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TOCCollapsible';
-export default function TOCCollapsible({ toc, className, minHeadingLevel, maxHeadingLevel, }: Props): JSX.Element;
+export default function TOCCollapsible({ toc, className, minHeadingLevel, maxHeadingLevel, }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TOCInline';
-export default function TOCInline({ toc, minHeadingLevel, maxHeadingLevel, }: Props): JSX.Element;
+export default function TOCInline({ toc, minHeadingLevel, maxHeadingLevel, }: Props): ReactNode;

package/lib/theme/TOCItems/Tree.d.ts

@@ -4,8 +4,8 @@
  * 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 React, { type ReactNode } from 'react';
 import type { Props } from '@theme/TOCItems/Tree';
-declare function TOCItemTree({ toc, className, linkClassName, isChild, }: Props): JSX.Element | null;
+declare function TOCItemTree({ toc, className, linkClassName, isChild, }: Props): ReactNode;
 declare const _default: React.MemoExoticComponent<typeof TOCItemTree>;
 export default _default;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TOCItems';
-export default function TOCItems({ toc, className, linkClassName, linkActiveClassName, minHeadingLevel: minHeadingLevelOption, maxHeadingLevel: maxHeadingLevelOption, ...props }: Props): JSX.Element | null;
+export default function TOCItems({ toc, className, linkClassName, linkActiveClassName, minHeadingLevel: minHeadingLevelOption, maxHeadingLevel: maxHeadingLevelOption, ...props }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TabItem';
-export default function TabItem({ children, hidden, className, }: Props): JSX.Element;
+export default function TabItem({ children, hidden, className, }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/Tabs';
-export default function Tabs(props: Props): JSX.Element;
+export default function Tabs(props: Props): ReactNode;

package/lib/theme/Tabs/index.js

@@ -66,7 +66,9 @@ function TabList({className, block, selectedValue, selectValue, tabValues}) {
           tabIndex={selectedValue === value ? 0 : -1}
           aria-selected={selectedValue === value}
           key={value}
-          ref={(tabControl) => tabRefs.push(tabControl)}
+          ref={(tabControl) => {
+            tabRefs.push(tabControl);
+          }}
           onKeyDown={handleKeydown}
           onClick={handleTabChange}
           {...attributes}

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/Tag';
-export default function Tag({ permalink, label, count, description, }: Props): JSX.Element;
+export default function Tag({ permalink, label, count, description, }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TagsListByLetter';
-export default function TagsListByLetter({ tags }: Props): JSX.Element;
+export default function TagsListByLetter({ tags }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/TagsListInline';
-export default function TagsListInline({ tags }: Props): JSX.Element;
+export default function TagsListInline({ tags }: Props): ReactNode;

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

@@ -4,5 +4,6 @@
  * 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';
 import type { Props } from '@theme/ThemedImage';
-export default function ThemedImage(props: Props): JSX.Element;
+export default function ThemedImage(props: Props): ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "3.6.3",
+  "version": "3.7.0",
   "description": "Classic theme for Docusaurus",
   "main": "lib/index.js",
   "types": "src/theme-classic.d.ts",
@@ -20,19 +20,19 @@
     "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch"
   },
   "dependencies": {
-    "@docusaurus/core": "3.6.3",
-    "@docusaurus/logger": "3.6.3",
-    "@docusaurus/mdx-loader": "3.6.3",
-    "@docusaurus/module-type-aliases": "3.6.3",
-    "@docusaurus/plugin-content-blog": "3.6.3",
-    "@docusaurus/plugin-content-docs": "3.6.3",
-    "@docusaurus/plugin-content-pages": "3.6.3",
-    "@docusaurus/theme-common": "3.6.3",
-    "@docusaurus/theme-translations": "3.6.3",
-    "@docusaurus/types": "3.6.3",
-    "@docusaurus/utils": "3.6.3",
-    "@docusaurus/utils-common": "3.6.3",
-    "@docusaurus/utils-validation": "3.6.3",
+    "@docusaurus/core": "3.7.0",
+    "@docusaurus/logger": "3.7.0",
+    "@docusaurus/mdx-loader": "3.7.0",
+    "@docusaurus/module-type-aliases": "3.7.0",
+    "@docusaurus/plugin-content-blog": "3.7.0",
+    "@docusaurus/plugin-content-docs": "3.7.0",
+    "@docusaurus/plugin-content-pages": "3.7.0",
+    "@docusaurus/theme-common": "3.7.0",
+    "@docusaurus/theme-translations": "3.7.0",
+    "@docusaurus/types": "3.7.0",
+    "@docusaurus/utils": "3.7.0",
+    "@docusaurus/utils-common": "3.7.0",
+    "@docusaurus/utils-validation": "3.7.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "copy-text-to-clipboard": "^3.2.0",
@@ -56,11 +56,11 @@
     "utility-types": "^3.10.0"
   },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "9c0e19c669ffcbc0972bfd8527e8b93f1f74e7d8"
+  "gitHead": "dd59750c16fe6908a26f18806a54d4c3dbe6db43"
 }

package/src/options.ts

@@ -308,6 +308,7 @@ const FooterLinkItemSchema = Joi.object({
   href: URISchema,
   html: Joi.string(),
   label: Joi.string(),
+  className: Joi.string(),
 })
   .xor('to', 'href', 'html')
   .with('to', 'label')
@@ -317,6 +318,12 @@ const FooterLinkItemSchema = Joi.object({
   // attributes like target, aria-role, data-customAttribute...)
   .unknown();
 
+const FooterColumnItemSchema = Joi.object({
+  title: Joi.string().allow(null).default(null),
+  className: Joi.string(),
+  items: Joi.array().items(FooterLinkItemSchema).default([]),
+});
+
 const LogoSchema = Joi.object({
   alt: Joi.string().allow(''),
   src: Joi.string().required(),
@@ -384,12 +391,7 @@ export const ThemeConfigSchema = Joi.object<ThemeConfig>({
     logo: LogoSchema,
     copyright: Joi.string(),
     links: Joi.alternatives(
-      Joi.array().items(
-        Joi.object({
-          title: Joi.string().allow(null).default(null),
-          items: Joi.array().items(FooterLinkItemSchema).default([]),
-        }),
-      ),
+      Joi.array().items(FooterColumnItemSchema),
       Joi.array().items(FooterLinkItemSchema),
     )
       .messages({

package/src/theme/Admonition/Icon/Danger.tsx

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import type {Props} from '@theme/Admonition/Icon/Danger';
 
-export default function AdmonitionIconDanger(props: Props): JSX.Element {
+export default function AdmonitionIconDanger(props: Props): ReactNode {
   return (
     <svg viewBox="0 0 12 16" {...props}>
       <path

package/src/theme/Admonition/Icon/Info.tsx

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import type {Props} from '@theme/Admonition/Icon/Info';
 
-export default function AdmonitionIconInfo(props: Props): JSX.Element {
+export default function AdmonitionIconInfo(props: Props): ReactNode {
   return (
     <svg viewBox="0 0 14 16" {...props}>
       <path

package/src/theme/Admonition/Icon/Note.tsx

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import type {Props} from '@theme/Admonition/Icon/Note';
 
-export default function AdmonitionIconNote(props: Props): JSX.Element {
+export default function AdmonitionIconNote(props: Props): ReactNode {
   return (
     <svg viewBox="0 0 14 16" {...props}>
       <path

package/src/theme/Admonition/Icon/Tip.tsx

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import type {Props} from '@theme/Admonition/Icon/Tip';
 
-export default function AdmonitionIconTip(props: Props): JSX.Element {
+export default function AdmonitionIconTip(props: Props): ReactNode {
   return (
     <svg viewBox="0 0 12 16" {...props}>
       <path

package/src/theme/Admonition/Icon/Warning.tsx

@@ -5,10 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import type {Props} from '@theme/Admonition/Icon/Warning';
 
-export default function AdmonitionIconCaution(props: Props): JSX.Element {
+export default function AdmonitionIconCaution(props: Props): ReactNode {
   return (
     <svg viewBox="0 0 16 16" {...props}>
       <path

package/src/theme/Admonition/Layout/index.tsx

@@ -46,7 +46,7 @@ function AdmonitionContent({children}: Pick<Props, 'children'>) {
   ) : null;
 }
 
-export default function AdmonitionLayout(props: Props): JSX.Element {
+export default function AdmonitionLayout(props: Props): ReactNode {
   const {type, icon, title, children, className} = props;
   return (
     <AdmonitionContainer type={type} className={className}>

package/src/theme/Admonition/Type/Caution.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Caution';
@@ -27,7 +27,7 @@ const defaultProps = {
 
 // TODO remove before v4: Caution replaced by Warning
 // see https://github.com/facebook/docusaurus/issues/7558
-export default function AdmonitionTypeCaution(props: Props): JSX.Element {
+export default function AdmonitionTypeCaution(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/Type/Danger.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Danger';
@@ -25,7 +25,7 @@ const defaultProps = {
   ),
 };
 
-export default function AdmonitionTypeDanger(props: Props): JSX.Element {
+export default function AdmonitionTypeDanger(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/Type/Info.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Info';
@@ -25,7 +25,7 @@ const defaultProps = {
   ),
 };
 
-export default function AdmonitionTypeInfo(props: Props): JSX.Element {
+export default function AdmonitionTypeInfo(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/Type/Note.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Note';
@@ -25,7 +25,7 @@ const defaultProps = {
   ),
 };
 
-export default function AdmonitionTypeNote(props: Props): JSX.Element {
+export default function AdmonitionTypeNote(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/Type/Tip.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Tip';
@@ -25,7 +25,7 @@ const defaultProps = {
   ),
 };
 
-export default function AdmonitionTypeTip(props: Props): JSX.Element {
+export default function AdmonitionTypeTip(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/Type/Warning.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Warning';
@@ -25,7 +25,7 @@ const defaultProps = {
   ),
 };
 
-export default function AdmonitionTypeWarning(props: Props): JSX.Element {
+export default function AdmonitionTypeWarning(props: Props): ReactNode {
   return (
     <AdmonitionLayout
       {...defaultProps}

package/src/theme/Admonition/index.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, {type ComponentType} from 'react';
+import React, {type ComponentType, type ReactNode} from 'react';
 import {processAdmonitionProps} from '@docusaurus/theme-common';
 import type {Props} from '@theme/Admonition';
 import AdmonitionTypes from '@theme/Admonition/Types';
@@ -21,7 +21,7 @@ function getAdmonitionTypeComponent(type: string): ComponentType<Props> {
   return AdmonitionTypes.info!;
 }
 
-export default function Admonition(unprocessedProps: Props): JSX.Element {
+export default function Admonition(unprocessedProps: Props): ReactNode {
   const props = processAdmonitionProps(unprocessedProps);
   const AdmonitionTypeComponent = getAdmonitionTypeComponent(props.type);
   return <AdmonitionTypeComponent {...props} />;

package/src/theme/AnnouncementBar/CloseButton/index.tsx

@@ -5,16 +5,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import {translate} from '@docusaurus/Translate';
 import IconClose from '@theme/Icon/Close';
 import type {Props} from '@theme/AnnouncementBar/CloseButton';
 import styles from './styles.module.css';
 
-export default function AnnouncementBarCloseButton(
-  props: Props,
-): JSX.Element | null {
+export default function AnnouncementBarCloseButton(props: Props): ReactNode {
   return (
     <button
       type="button"

package/src/theme/AnnouncementBar/Content/index.tsx

@@ -5,15 +5,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import {useThemeConfig} from '@docusaurus/theme-common';
 import type {Props} from '@theme/AnnouncementBar/Content';
 import styles from './styles.module.css';
 
-export default function AnnouncementBarContent(
-  props: Props,
-): JSX.Element | null {
+export default function AnnouncementBarContent(props: Props): ReactNode {
   const {announcementBar} = useThemeConfig();
   const {content} = announcementBar!;
   return (

package/src/theme/AnnouncementBar/index.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import {useThemeConfig} from '@docusaurus/theme-common';
 import {useAnnouncementBar} from '@docusaurus/theme-common/internal';
 import AnnouncementBarCloseButton from '@theme/AnnouncementBar/CloseButton';
@@ -13,7 +13,7 @@ import AnnouncementBarContent from '@theme/AnnouncementBar/Content';
 
 import styles from './styles.module.css';
 
-export default function AnnouncementBar(): JSX.Element | null {
+export default function AnnouncementBar(): ReactNode {
   const {announcementBar} = useThemeConfig();
   const {isActive, close} = useAnnouncementBar();
   if (!isActive) {

package/src/theme/BackToTopButton/index.tsx

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import React from 'react';
+import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import {translate} from '@docusaurus/Translate';
 import {ThemeClassNames} from '@docusaurus/theme-common';
@@ -13,7 +13,7 @@ import {useBackToTopButton} from '@docusaurus/theme-common/internal';
 
 import styles from './styles.module.css';
 
-export default function BackToTopButton(): JSX.Element {
+export default function BackToTopButton(): ReactNode {
   const {shown, scrollToTop} = useBackToTopButton({threshold: 300});
   return (
     <button