perf: docusaurus version upgrade [3.6.3] (#558)

docusaurus.config.ts

@@ -59,6 +59,9 @@ export default {
       },
     },
   },
+  future: {
+    experimental_faster: true, // Required for faster production builds. For reference: https://docusaurus.io/blog/releases/3.6#adoption-strategy
+  },
   presets: [
     [
       "classic",
@@ -160,6 +163,7 @@ export default {
           type: "all",
           copyright: `Copyright © ${new Date().getFullYear()} Tailcall, Inc.`,
         },
+        onInlineAuthors: "ignore", // TODO: Create an authors.yml file to reduce authors info. redundancy
       },
     ],
     [

package.json

@@ -23,13 +23,14 @@
     "cypress": "cypress run"
   },
   "dependencies": {
-    "@docusaurus/core": "3.4.0",
-    "@docusaurus/plugin-client-redirects": "3.4.0",
-    "@docusaurus/plugin-content-blog": "^3.4.0",
-    "@docusaurus/plugin-google-gtag": "^3.4.0",
-    "@docusaurus/plugin-ideal-image": "^3.4.0",
-    "@docusaurus/preset-classic": "3.4.0",
-    "@docusaurus/theme-search-algolia": "3.4.0",
+    "@docusaurus/core": "3.6.3",
+    "@docusaurus/faster": "3.6.3",
+    "@docusaurus/plugin-client-redirects": "3.6.3",
+    "@docusaurus/plugin-content-blog": "3.6.3",
+    "@docusaurus/plugin-google-gtag": "3.6.3",
+    "@docusaurus/plugin-ideal-image": "3.6.3",
+    "@docusaurus/preset-classic": "3.6.3",
+    "@docusaurus/theme-search-algolia": "3.6.3",
     "@mdx-js/react": "^3.0.1",
     "autoprefixer": "^10.4.19",
     "clsx": "^2.1.1",
@@ -53,10 +54,10 @@
   "devDependencies": {
     "@babel/core": "^7.24.7",
     "@babel/eslint-parser": "^7.24.7",
-    "@docusaurus/eslint-plugin": "^3.4.0",
-    "@docusaurus/module-type-aliases": "3.4.0",
-    "@docusaurus/tsconfig": "3.4.0",
-    "@docusaurus/types": "3.4.0",
+    "@docusaurus/eslint-plugin": "3.6.3",
+    "@docusaurus/module-type-aliases": "3.6.3",
+    "@docusaurus/tsconfig": "3.6.3",
+    "@docusaurus/types": "3.6.3",
     "@giscus/react": "^3.0.0",
     "@typescript-eslint/eslint-plugin": "^7.14.1",
     "@typescript-eslint/parser": "^7.14.1",

src/theme/BlogPostItem/Category/index.tsx

@@ -1,6 +1,6 @@
 import React from "react"
 import {BlogPostFrontMatter} from "@docusaurus/plugin-content-blog"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 
 export default function BlogPostItemCategory(): JSX.Element {
   const {frontMatter} = useBlogPost()

src/theme/BlogPostItem/Content/index.tsx

@@ -1,7 +1,7 @@
 import React from "react"
 import clsx from "clsx"
 import {blogPostContainerID} from "@docusaurus/utils-common"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import MDXContent from "@theme/MDXContent"
 import type {Props} from "@theme/BlogPostItem/Content"
 

src/theme/BlogPostItem/Footer/index.tsx

@@ -1,6 +1,6 @@
 import React from "react"
 import clsx from "clsx"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import {ThemeClassNames} from "@docusaurus/theme-common"
 import EditMetaRow from "@theme/EditMetaRow"
 import ReadMoreLink from "@theme/BlogPostItem/Footer/ReadMoreLink"

src/theme/BlogPostItem/Header/Author/index.tsx

@@ -2,7 +2,7 @@ import React from "react"
 import clsx from "clsx"
 import Link, {type Props as LinkProps} from "@docusaurus/Link"
 
-import type {Props} from "@theme/BlogPostItem/Header/Author"
+import type {Props} from "@theme/Blog/Components/Author"
 
 function MaybeLink(props: LinkProps): JSX.Element {
   if (props.href) {

src/theme/BlogPostItem/Header/Authors/index.tsx

@@ -1,7 +1,7 @@
 import React from "react"
 import clsx from "clsx"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
-import BlogPostItemHeaderAuthor from "@theme/BlogPostItem/Header/Author"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
+import BlogAuthor from "@theme/Blog/Components/Author"
 import type {Props} from "@theme/BlogPostItem/Header/Authors"
 import styles from "./styles.module.css"
 
@@ -23,7 +23,7 @@ export default function BlogPostItemHeaderAuthors({className}: Props): JSX.Eleme
           className={clsx(!imageOnly && "col col--6", imageOnly ? styles.imageOnlyAuthorCol : styles.authorCol)}
           key={idx}
         >
-          <BlogPostItemHeaderAuthor
+          <BlogAuthor
             author={{
               ...author,
               // Handle author images using relative paths

src/theme/BlogPostItem/Header/Info/index.tsx

@@ -2,7 +2,8 @@ import React from "react"
 import clsx from "clsx"
 import {translate} from "@docusaurus/Translate"
 import {usePluralForm} from "@docusaurus/theme-common"
-import {useBlogPost, useDateTimeFormat} from "@docusaurus/theme-common/internal"
+import {useDateTimeFormat} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import type {Props} from "@theme/BlogPostItem/Header/Info"
 
 import styles from "./styles.module.css"

src/theme/BlogPostItem/Header/Title/index.tsx

@@ -1,7 +1,7 @@
 import React from "react"
 import clsx from "clsx"
 import Link from "@docusaurus/Link"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import type {Props} from "@theme/BlogPostItem/Header/Title"
 
 import styles from "./styles.module.css"

src/theme/BlogPostItem/Header/index.tsx

@@ -2,7 +2,7 @@ import React from "react"
 import BlogPostItemHeaderTitle from "@theme/BlogPostItem/Header/Title"
 import BlogPostItemHeaderInfo from "@theme/BlogPostItem/Header/Info"
 import BlogBackButton from "./Back"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import BlogPostItemCategory from "../Category"
 
 export default function BlogPostItemHeader(): JSX.Element {

src/theme/BlogPostItem/index.tsx

@@ -1,6 +1,6 @@
 import React from "react"
 import clsx from "clsx"
-import {useBlogPost} from "@docusaurus/theme-common/internal"
+import {useBlogPost} from "@docusaurus/plugin-content-blog/client"
 import BlogPostItemContainer from "@theme/BlogPostItem/Container"
 import BlogPostItemHeader from "@theme/BlogPostItem/Header"
 import BlogPostItemContent from "@theme/BlogPostItem/Content"

src/theme/DocItem/Layout/index.tsx

@@ -1,7 +1,7 @@
 import React from "react"
 import clsx from "clsx"
 import {useWindowSize} from "@docusaurus/theme-common"
-import {useDoc} from "@docusaurus/theme-common/internal"
+import {useDoc} from "@docusaurus/plugin-content-docs/client"
 import DocItemPaginator from "@theme/DocItem/Paginator"
 import DocVersionBanner from "@theme/DocVersionBanner"
 import DocVersionBadge from "@theme/DocVersionBadge"

src/theme/Layout/Provider/index.tsx

@@ -3,11 +3,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"
 import GithubStarsProvider from "@site/src/components/shared/GithubStarsProvider"
 import Footer from "@site/src/components/shared/Footer"
 import Announcement from "@site/src/components/shared/Announcement"