Bump docusaurus to 3.0.0-alpha.0 (#1745)

We have some security warnings on a couple packages that are
dependencies of docusaurus, so I decided to upgrade to the latest to
remove those dependencies. Docusaurus uses their nightly version on
their own docs, and things seem to work for us on this version with no
issue, so I think it's ok. In addition, we were violating their peer
dependencies by using react 18; we now no longer need to do that. Also,
this version allows us to use mdx v2, which has a lot of niceties that
we'll probably want as we do our big docs refactor
(#867)

- depends on #1750 to
fix typedoc failure

## Checklist

- [ ] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [ ] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [ ] I have not broken the cheatsheet

Author: pokey

package.json

@@ -41,14 +41,11 @@
   },
   "pnpm": {
     "patchedDependencies": {
-      "@docusaurus/theme-search-algolia@2.3.1": "patches/@[email protected]"
+      "@docusaurus/theme-search-algolia@3.0.0-alpha.0": "patches/@[email protected]"
     },
     "peerDependencyRules": {
       "ignoreMissing": [
-        "@docusaurus/core",
-        "@docusaurus/mdx-loader",
-        "@docusaurus/plugin-content-blog",
-        "@docusaurus/preset-classic"
+        "react-json-view"
       ],
       "allowedVersions": {
         "react": "18",

packages/cursorless-org-docs/package.json

@@ -20,11 +20,12 @@
   "dependencies": {
     "@algolia/client-search": "4.15.0",
     "@docsearch/react": "3.3.3",
-    "@docusaurus/core": "~2.3.1",
-    "@docusaurus/preset-classic": "~2.3.1",
-    "@docusaurus/theme-common": "2.3.1",
-    "@docusaurus/theme-search-algolia": "2.3.1",
-    "@mdx-js/react": "^1.6.22",
+    "@docusaurus/core": "3.0.0-alpha.0",
+    "@docusaurus/preset-classic": "3.0.0-alpha.0",
+    "@docusaurus/theme-classic": "3.0.0-alpha.0",
+    "@docusaurus/theme-common": "3.0.0-alpha.0",
+    "@docusaurus/theme-search-algolia": "3.0.0-alpha.0",
+    "@mdx-js/react": "2.3.0",
     "clsx": "^1.2.1",
     "mdast-util-find-and-replace": "^2.2.2",
     "prism-react-renderer": "^1.3.5",
@@ -45,6 +46,8 @@
     ]
   },
   "devDependencies": {
+    "@docusaurus/module-type-aliases": "3.0.0-alpha.0",
+    "@tsconfig/docusaurus": "2.0.0",
     "docusaurus-plugin-typedoc": "^0.18.0",
     "typedoc": "^0.23.28",
     "typedoc-plugin-markdown": "^3.14.0",

packages/cursorless-org-docs/tsconfig.json

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.base.json",
+  "extends": ["@tsconfig/docusaurus/tsconfig.json", "../../tsconfig.base.json"],
   "compilerOptions": {
     "rootDir": "src",
     "esModuleInterop": true,

packages/meta-updater/package.json

@@ -16,9 +16,10 @@
     "@pnpm/types": "8.9.0",
     "@types/normalize-path": "^3.0.0",
     "js-yaml": "^4.1.0",
+    "lodash": "^4.17.21",
     "normalize-path": "^3.0.0",
     "path-exists": "^4.0.0",
-    "type-fest": "3.6.1"
+    "type-fest": "4.2.0"
   },
   "main": "./out/index.js",
   "types": "./out/index.d.ts",
@@ -31,6 +32,7 @@
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.2",
+    "@types/lodash": "4.14.181",
     "esbuild": "^0.17.11"
   }
 }

packages/meta-updater/src/updateTSConfig.ts

@@ -5,6 +5,7 @@ import exists from "path-exists";
 import { TsConfigJson } from "type-fest";
 import { toPosixPath } from "./toPosixPath";
 import { Context } from "./Context";
+import { uniq } from "lodash";
 
 /**
  * Given a tsconfig.json, update it to match our conventions.  This function is
@@ -76,9 +77,7 @@ export async function updateTSConfig(
 
   return {
     ...input,
-    extends: toPosixPath(
-      path.join(pathFromPackageToRoot, "tsconfig.base.json"),
-    ),
+    extends: getExtends(pathFromPackageToRoot, input.extends),
     compilerOptions: {
       ...(input.compilerOptions ?? {}),
       rootDir: "src",
@@ -99,3 +98,23 @@ export async function updateTSConfig(
     ],
   };
 }
+
+function getExtends(
+  pathFromPackageToRoot: string,
+  inputExtends: string | string[] | undefined,
+) {
+  let extendsList =
+    inputExtends == null
+      ? []
+      : Array.isArray(inputExtends)
+      ? [...inputExtends]
+      : [inputExtends];
+
+  extendsList.push(
+    toPosixPath(path.join(pathFromPackageToRoot, "tsconfig.base.json")),
+  );
+
+  extendsList = uniq(extendsList);
+
+  return extendsList.length === 1 ? extendsList[0] : extendsList;
+}