update a bunch of stuff, remove some legacy packages

Author: mitchellh

biome.json

@@ -1,16 +1,14 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
   "files": {
-    "include": ["src/**/*.ts", "src/**/*.tsx", "next.config.mjs"]
+    "includes": ["**/src/**/*.ts", "**/src/**/*.tsx", "**/next.config.mjs"]
   },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
     "indentWidth": 2
   },
-  "organizeImports": {
-    "enabled": false
-  },
+  "assist": { "actions": { "source": { "organizeImports": "off" } } },
   "linter": {
     "enabled": true,
     "rules": {

package-lock.json

@@ -12,34 +12,31 @@
   "dependencies": {
     "@r4ai/remark-callout": "^0.6.2",
     "classnames": "^2.5.1",
+    "fast-xml-parser": "^5.3.7",
     "gray-matter": "^4.0.3",
-    "klaw-sync": "^6.0.0",
-    "lucide-react": "^0.424.0",
-    "mermaid": "^11.9.0",
+    "lucide-react": "^0.575.0",
+    "mermaid": "^11.12.3",
     "next": "^16.1.6",
     "next-mdx-remote": "^6.0.0",
     "postcss-flexbugs-fixes": "^5.0.2",
-    "postcss-preset-env": "^9.6.0",
-    "react": "19.2.3",
-    "react-dom": "19.2.3",
-    "react-intersection-observer": "^9.14.0",
-    "rehype-highlight": "^7.0.1",
-    "remark-gfm": "^4.0.0",
+    "postcss-preset-env": "^11.2.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-intersection-observer": "^10.0.3",
+    "rehype-highlight": "^7.0.2",
+    "remark-gfm": "^4.0.1",
     "slugify": "^1.6.6",
-    "xml2js": "^0.6.2",
-    "zustand": "^5.0.2"
+    "zustand": "^5.0.11"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
-    "@types/klaw-sync": "^6.0.5",
-    "@types/node": "20.14.13",
-    "@types/react": "19.2.3",
+    "@biomejs/biome": "^2.4.4",
+    "@types/node": "^25.3.0",
+    "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
-    "@types/xml2js": "^0.4.14",
-    "typescript": "5.5.4"
+    "typescript": "^5.9.3"
   },
   "overrides": {
-    "@types/react": "19.2.3",
+    "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3"
   }
 }

package.json

@@ -1,8 +1,8 @@
 import remarkCallout, {
   type Options as RemarkCalloutOptions,
 } from "@r4ai/remark-callout";
+import { promises as fs } from "node:fs";
 import matter from "gray-matter";
-import recurse, { type Item } from "klaw-sync";
 import type { Root } from "mdast";
 import type { MDXRemoteSerializeResult } from "next-mdx-remote";
 import { serialize } from "next-mdx-remote/serialize";
@@ -209,15 +209,9 @@ function parseAnchorLinks({
 export async function loadAllDocsPageSlugs(
   docsDirectory: string,
 ): Promise<Array<string>> {
-  const allPaths = recurse(docsDirectory, {
-    nodir: true,
-    filter: (file: Item): boolean => {
-      return file.path.endsWith(MDX_EXTENSION);
-    },
-    traverseAll: true,
-  }).map((item: recurse.Item) => {
-    return item.path;
-  });
+  const allPaths = (await collectAllFilesRecursively(docsDirectory)).filter(
+    (path) => path.endsWith(MDX_EXTENSION),
+  );
   const docsPageSlugs: Set<string> = new Set();
   for (let i = 0; i < allPaths.length; i++) {
     const path = allPaths[i];
@@ -253,3 +247,19 @@ function slugFromRelativeFilePath(relativeFilePath: string): string {
       .replaceAll(/\/index$/gi, "")
   );
 }
+
+async function collectAllFilesRecursively(root: string): Promise<string[]> {
+  const files: string[] = [];
+  const entries = await fs.readdir(root, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = nodePath.join(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await collectAllFilesRecursively(fullPath)));
+      continue;
+    }
+    files.push(fullPath);
+  }
+
+  return files;
+}

src/lib/fetch-docs.ts

@@ -1,4 +1,17 @@
-import { parseStringPromise } from "xml2js";
+import { XMLParser } from "fast-xml-parser";
+
+type AppcastItem = {
+  "sparkle:version": string;
+  "sparkle:shortVersionString": string;
+};
+
+type Appcast = {
+  rss?: {
+    channel?: {
+      item?: AppcastItem | AppcastItem[];
+    };
+  };
+};
 
 export async function fetchLatestGhosttyVersion(): Promise<string> {
   // Use the same appcast we use for Sparkle updates to get the
@@ -10,12 +23,15 @@ export async function fetchLatestGhosttyVersion(): Promise<string> {
   }
 
   const xmlContent = await response.text();
-  const parsedXml = await parseStringPromise(xmlContent, {
-    explicitArray: false,
+  const parser = new XMLParser({
+    ignoreAttributes: false,
   });
+  const parsedXml = parser.parse(xmlContent) as Appcast;
 
-  // Extract items
-  const items = parsedXml.rss.channel.item;
+  const items = parsedXml.rss?.channel?.item;
+  if (!items) {
+    throw new Error("Failed to parse appcast XML: no items found");
+  }
 
   // Convert items to an array if it's not already
   const itemsArray = Array.isArray(items) ? items : [items];

src/lib/fetch-latest-ghostty-version.ts

@@ -1,5 +1,4 @@
 import { promises as fs } from "node:fs";
-import recurse, { type Item } from "klaw-sync";
 const nodePath = require("node:path");
 
 const TERMINALS_DIRECTORY = "./terminals";
@@ -10,15 +9,9 @@ export type TerminalsMap = { [k: string]: string[] };
 export async function loadAllTerminalFiles(
   subdirectory?: string,
 ): Promise<TerminalsMap> {
-  const allPaths = recurse(`${TERMINALS_DIRECTORY}${subdirectory}`, {
-    nodir: true,
-    filter: (file: Item): boolean => {
-      return file.path.endsWith(TERMINAL_CONTENT_FILE_EXTENSION);
-    },
-    traverseAll: true,
-  }).map((item: recurse.Item) => {
-    return item.path;
-  });
+  const allPaths = (
+    await collectAllFilesRecursively(`${TERMINALS_DIRECTORY}${subdirectory}`)
+  ).filter((path) => path.endsWith(TERMINAL_CONTENT_FILE_EXTENSION));
 
   const map: Map<string, Array<string>> = new Map<string, Array<string>>();
   for (const path of allPaths) {
@@ -35,3 +28,19 @@ export async function loadAllTerminalFiles(
   }
   return Object.fromEntries(map);
 }
+
+async function collectAllFilesRecursively(root: string): Promise<string[]> {
+  const files: string[] = [];
+  const entries = await fs.readdir(root, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = nodePath.join(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await collectAllFilesRecursively(fullPath)));
+      continue;
+    }
+    files.push(fullPath);
+  }
+
+  return files;
+}

src/lib/fetch-terminal-content.ts

@@ -24,8 +24,6 @@ export function navTreeToBreadcrumbs(
 
   // Go through each URL segment & determine the breadcrumb to push to our array
   while (segments.length) {
-    const currentSegment = segments[0];
-
     // Find the Node which represents the URL segment we're on
     const nextNode: FolderNode | LinkNode | undefined = currentNavTree.find(
       (node) => {
@@ -39,7 +37,7 @@ export function navTreeToBreadcrumbs(
     ) as FolderNode | LinkNode | undefined;
 
     if (typeof nextNode === "undefined") {
-      segments.map((name) => {
+      segments.forEach((name) => {
         accumulatedPath += `/${name}`; // Accumulate the path with the current segment
         breadcrumbs.push({
           text: name, // Use segment (file name) as the breadcrumb title