@docusaurus/theme-classic 3.9.1 → 3.9.2

package/lib/theme/EditMetaRow/index.js

@@ -17,7 +17,9 @@ export default function EditMetaRow({
 }) {
   return (
     <div className={clsx('row', className)}>
-      <div className="col">{editUrl && <EditThisPage editUrl={editUrl} />}</div>
+      <div className={clsx('col', styles.noPrint)}>
+        {editUrl && <EditThisPage editUrl={editUrl} />}
+      </div>
       <div className={clsx('col', styles.lastUpdated)}>
         {(lastUpdatedAt || lastUpdatedBy) && (
           <LastUpdated

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

@@ -16,3 +16,9 @@
     text-align: right;
   }
 }
+
+@media print {
+  .noPrint {
+    display: none;
+  }
+}

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

@@ -6,4 +6,5 @@
  */
 import { type ReactNode } from 'react';
 import type { Props } from '@theme/Heading';
+import './styles.module.css';
 export default function Heading({ as: As, id, ...props }: Props): ReactNode;

package/lib/theme/Heading/index.js

@@ -7,15 +7,13 @@
 import React from 'react';
 import clsx from 'clsx';
 import {translate} from '@docusaurus/Translate';
-import {useThemeConfig} from '@docusaurus/theme-common';
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
 import Link from '@docusaurus/Link';
 import useBrokenLinks from '@docusaurus/useBrokenLinks';
-import styles from './styles.module.css';
+import './styles.module.css';
 export default function Heading({as: As, id, ...props}) {
   const brokenLinks = useBrokenLinks();
-  const {
-    navbar: {hideOnScroll},
-  } = useThemeConfig();
+  const anchorTargetClassName = useAnchorTargetClassName(id);
   // H1 headings do not need an id because they don't appear in the TOC.
   if (As === 'h1' || !id) {
     return <As {...props} id={undefined} />;
@@ -34,13 +32,7 @@ export default function Heading({as: As, id, ...props}) {
   return (
     <As
       {...props}
-      className={clsx(
-        'anchor',
-        hideOnScroll
-          ? styles.anchorWithHideOnScrollNavbar
-          : styles.anchorWithStickyNavbar,
-        props.className,
-      )}
+      className={clsx('anchor', anchorTargetClassName, props.className)}
       id={id}>
       {props.children}
       <Link

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

@@ -5,19 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-/*
-When the navbar is sticky, ensure that on anchor click,
-the browser does not scroll that anchor behind the navbar
-See https://x.com/JoshWComeau/status/1332015868725891076
- */
-.anchorWithStickyNavbar {
-  scroll-margin-top: calc(var(--ifm-navbar-height) + 0.5rem);
-}
-
-.anchorWithHideOnScrollNavbar {
-  scroll-margin-top: 0.5rem;
-}
-
 :global(.hash-link) {
   opacity: 0;
   padding-left: 0.5rem;

package/lib/theme/MDXComponents/A/index.js

@@ -7,30 +7,11 @@
 import React from 'react';
 import clsx from 'clsx';
 import Link from '@docusaurus/Link';
-import {useThemeConfig} from '@docusaurus/theme-common';
-import styles from './styles.module.css';
-function isFootnoteRef(props) {
-  return props['data-footnote-ref'] === true;
-}
-function FootnoteRefLink(props) {
-  const {
-    navbar: {hideOnScroll},
-  } = useThemeConfig();
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
+export default function MDXA(props) {
+  // MDX Footnotes have ids such as <a id="user-content-fn-1-953011" ...>
+  const anchorTargetClassName = useAnchorTargetClassName(props.id);
   return (
-    <Link
-      {...props}
-      className={clsx(
-        hideOnScroll
-          ? styles.footnoteRefHideOnScrollNavbar
-          : styles.footnoteRefStickyNavbar,
-        props.className,
-      )}
-    />
+    <Link {...props} className={clsx(anchorTargetClassName, props.className)} />
   );
 }
-export default function MDXA(props) {
-  if (isFootnoteRef(props)) {
-    return <FootnoteRefLink {...props} />;
-  }
-  return <Link {...props} />;
-}

package/lib/theme/MDXComponents/Li.js

@@ -5,9 +5,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
+import clsx from 'clsx';
 import useBrokenLinks from '@docusaurus/useBrokenLinks';
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
 export default function MDXLi(props) {
   // MDX Footnotes have ids such as <li id="user-content-fn-1-953011">
   useBrokenLinks().collectAnchor(props.id);
-  return <li {...props} />;
+  const anchorTargetClassName = useAnchorTargetClassName(props.id);
+  return (
+    <li className={clsx(anchorTargetClassName, props.className)} {...props} />
+  );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "3.9.1",
+  "version": "3.9.2",
   "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.9.1",
-    "@docusaurus/logger": "3.9.1",
-    "@docusaurus/mdx-loader": "3.9.1",
-    "@docusaurus/module-type-aliases": "3.9.1",
-    "@docusaurus/plugin-content-blog": "3.9.1",
-    "@docusaurus/plugin-content-docs": "3.9.1",
-    "@docusaurus/plugin-content-pages": "3.9.1",
-    "@docusaurus/theme-common": "3.9.1",
-    "@docusaurus/theme-translations": "3.9.1",
-    "@docusaurus/types": "3.9.1",
-    "@docusaurus/utils": "3.9.1",
-    "@docusaurus/utils-common": "3.9.1",
-    "@docusaurus/utils-validation": "3.9.1",
+    "@docusaurus/core": "3.9.2",
+    "@docusaurus/logger": "3.9.2",
+    "@docusaurus/mdx-loader": "3.9.2",
+    "@docusaurus/module-type-aliases": "3.9.2",
+    "@docusaurus/plugin-content-blog": "3.9.2",
+    "@docusaurus/plugin-content-docs": "3.9.2",
+    "@docusaurus/plugin-content-pages": "3.9.2",
+    "@docusaurus/theme-common": "3.9.2",
+    "@docusaurus/theme-translations": "3.9.2",
+    "@docusaurus/types": "3.9.2",
+    "@docusaurus/utils": "3.9.2",
+    "@docusaurus/utils-common": "3.9.2",
+    "@docusaurus/utils-validation": "3.9.2",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "infima": "0.2.0-alpha.45",
@@ -61,5 +61,5 @@
   "engines": {
     "node": ">=20.0"
   },
-  "gitHead": "c0dd59f0e712f85b6053c59e46b0514b5d2d1414"
+  "gitHead": "abfbe5621b08407bc3dcbe6111ff118d4c22f7a1"
 }

package/src/theme/EditMetaRow/index.tsx

@@ -20,7 +20,9 @@ export default function EditMetaRow({
 }: Props): ReactNode {
   return (
     <div className={clsx('row', className)}>
-      <div className="col">{editUrl && <EditThisPage editUrl={editUrl} />}</div>
+      <div className={clsx('col', styles.noPrint)}>
+        {editUrl && <EditThisPage editUrl={editUrl} />}
+      </div>
       <div className={clsx('col', styles.lastUpdated)}>
         {(lastUpdatedAt || lastUpdatedBy) && (
           <LastUpdated

package/src/theme/EditMetaRow/styles.module.css

@@ -16,3 +16,9 @@
     text-align: right;
   }
 }
+
+@media print {
+  .noPrint {
+    display: none;
+  }
+}

package/src/theme/Heading/index.tsx

@@ -8,18 +8,16 @@
 import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import {translate} from '@docusaurus/Translate';
-import {useThemeConfig} from '@docusaurus/theme-common';
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
 import Link from '@docusaurus/Link';
 import useBrokenLinks from '@docusaurus/useBrokenLinks';
 import type {Props} from '@theme/Heading';
-
-import styles from './styles.module.css';
+import './styles.module.css';
 
 export default function Heading({as: As, id, ...props}: Props): ReactNode {
   const brokenLinks = useBrokenLinks();
-  const {
-    navbar: {hideOnScroll},
-  } = useThemeConfig();
+  const anchorTargetClassName = useAnchorTargetClassName(id);
+
   // H1 headings do not need an id because they don't appear in the TOC.
   if (As === 'h1' || !id) {
     return <As {...props} id={undefined} />;
@@ -41,13 +39,7 @@ export default function Heading({as: As, id, ...props}: Props): ReactNode {
   return (
     <As
       {...props}
-      className={clsx(
-        'anchor',
-        hideOnScroll
-          ? styles.anchorWithHideOnScrollNavbar
-          : styles.anchorWithStickyNavbar,
-        props.className,
-      )}
+      className={clsx('anchor', anchorTargetClassName, props.className)}
       id={id}>
       {props.children}
       <Link

package/src/theme/Heading/styles.module.css

@@ -5,19 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-/*
-When the navbar is sticky, ensure that on anchor click,
-the browser does not scroll that anchor behind the navbar
-See https://x.com/JoshWComeau/status/1332015868725891076
- */
-.anchorWithStickyNavbar {
-  scroll-margin-top: calc(var(--ifm-navbar-height) + 0.5rem);
-}
-
-.anchorWithHideOnScrollNavbar {
-  scroll-margin-top: 0.5rem;
-}
-
 :global(.hash-link) {
   opacity: 0;
   padding-left: 0.5rem;

package/src/theme/MDXComponents/A/index.tsx

@@ -8,35 +8,14 @@
 import React, {type ReactNode} from 'react';
 import clsx from 'clsx';
 import Link from '@docusaurus/Link';
-import {useThemeConfig} from '@docusaurus/theme-common';
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
 import type {Props} from '@theme/MDXComponents/A';
-import styles from './styles.module.css';
 
-function isFootnoteRef(props: Props) {
-  return props['data-footnote-ref'] === true;
-}
+export default function MDXA(props: Props): ReactNode {
+  // MDX Footnotes have ids such as <a id="user-content-fn-1-953011" ...>
+  const anchorTargetClassName = useAnchorTargetClassName(props.id);
 
-function FootnoteRefLink(props: Props) {
-  const {
-    navbar: {hideOnScroll},
-  } = useThemeConfig();
   return (
-    <Link
-      {...props}
-      className={clsx(
-        hideOnScroll
-          ? styles.footnoteRefHideOnScrollNavbar
-          : styles.footnoteRefStickyNavbar,
-
-        props.className,
-      )}
-    />
+    <Link {...props} className={clsx(anchorTargetClassName, props.className)} />
   );
 }
-
-export default function MDXA(props: Props): ReactNode {
-  if (isFootnoteRef(props)) {
-    return <FootnoteRefLink {...props} />;
-  }
-  return <Link {...props} />;
-}

package/src/theme/MDXComponents/Li.tsx

@@ -6,12 +6,17 @@
  */
 
 import React, {type ReactNode} from 'react';
+import clsx from 'clsx';
 import useBrokenLinks from '@docusaurus/useBrokenLinks';
+import {useAnchorTargetClassName} from '@docusaurus/theme-common';
 import type {Props} from '@theme/MDXComponents/Li';
 
 export default function MDXLi(props: Props): ReactNode | undefined {
   // MDX Footnotes have ids such as <li id="user-content-fn-1-953011">
   useBrokenLinks().collectAnchor(props.id);
+  const anchorTargetClassName = useAnchorTargetClassName(props.id);
 
-  return <li {...props} />;
+  return (
+    <li className={clsx(anchorTargetClassName, props.className)} {...props} />
+  );
 }

package/lib/theme/MDXComponents/A/styles.module.css

@@ -1,20 +0,0 @@
-/**
- * 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.
- */
-
-/*
-When the navbar is sticky, ensure that on footnote click,
-the browser does not scroll to the ref behind the navbar
-See https://github.com/facebook/docusaurus/issues/11232
-See also headings case https://x.com/JoshWComeau/status/1332015868725891076
- */
-.footnoteRefStickyNavbar {
-  scroll-margin-top: calc(var(--ifm-navbar-height) + 0.5rem);
-}
-
-.footnoteRefHideOnScrollNavbar {
-  scroll-margin-top: 0.5rem;
-}

package/src/theme/MDXComponents/A/styles.module.css

@@ -1,20 +0,0 @@
-/**
- * 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.
- */
-
-/*
-When the navbar is sticky, ensure that on footnote click,
-the browser does not scroll to the ref behind the navbar
-See https://github.com/facebook/docusaurus/issues/11232
-See also headings case https://x.com/JoshWComeau/status/1332015868725891076
- */
-.footnoteRefStickyNavbar {
-  scroll-margin-top: calc(var(--ifm-navbar-height) + 0.5rem);
-}
-
-.footnoteRefHideOnScrollNavbar {
-  scroll-margin-top: 0.5rem;
-}