zudoku 0.82.1 → 0.82.2

package/dist/cli/cli.js

@@ -1,7 +1,12 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)

package/docs/configuration/navigation.mdx

@@ -143,7 +143,10 @@ type NavigationCategory = {
   collapsible?: boolean;
   collapsed?: boolean;
   stack?: boolean; // open the category's items as a stacked sub-nav
-  link?: string | { type: "doc"; file: string; label?: string; path?: string };
+  link?:
+    | string
+    | { type: "doc"; file: string; label?: string; path?: string }
+    | { type: "link"; to: string; label?: string };
   display?:
     | "auth"
     | "anon"
@@ -158,9 +161,11 @@ type NavigationCategory = {
 #### Category links
 
 A category can have a `link` property that makes the category label itself clickable, navigating to
-a document. This is useful when you want a category that acts as both a group and a landing page.
+a document, a path, or an external URL. This is useful when you want a category that acts as both a
+group and a landing page.
 
-The `link` can be a simple string pointing to a file path, or an object for more control:
+The `link` can be a simple string pointing to a file path, a `doc` object for more control, or a
+`link` object that points the category label at an arbitrary path or external URL:
 
 ```tsx title="String shorthand"
 {
@@ -190,7 +195,7 @@ The `link` can be a simple string pointing to a file path, or an object for more
 }
 ```
 
-The object form supports these properties:
+The `doc` object form supports these properties:
 
 | Property | Type     | Description                                              |
 | -------- | -------- | -------------------------------------------------------- |
@@ -199,6 +204,29 @@ The object form supports these properties:
 | `label`  | `string` | Override the label (defaults to the document title)      |
 | `path`   | `string` | Custom URL path (overrides the default file-based route) |
 
+```tsx title="Link form pointing to a path or external URL"
+{
+  type: "category",
+  label: "API Reference",
+  link: {
+    type: "link",
+    to: "/api",
+  },
+  items: [
+    "guides/authentication",
+    "guides/rate-limits",
+  ],
+}
+```
+
+The `link` object form supports these properties:
+
+| Property | Type     | Description                         |
+| -------- | -------- | ----------------------------------- |
+| `type`   | `"link"` | Must be `"link"`                    |
+| `to`     | `string` | Path or external URL to navigate to |
+| `label`  | `string` | Override the category label         |
+
 ### `type: doc`
 
 Doc is used to reference markdown files. The `label` is the text that will be displayed, and the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zudoku",
-  "version": "0.82.1",
+  "version": "0.82.2",
   "type": "module",
   "engines": {
     "node": ">=20.19.0 <21.0.0 || >=22.12.0"
@@ -175,7 +175,7 @@
     "@apidevtools/json-schema-ref-parser": "15.3.5",
     "@base-ui/react": "^1.4.1",
     "@envelop/core": "5.5.1",
-    "@graphiql/toolkit": "0.12.0",
+    "@graphiql/toolkit": "0.12.1",
     "@graphql-typed-document-node/core": "3.2.0",
     "@hono/node-server": "2.0.3",
     "@lekoarts/rehype-meta-as-attributes": "3.0.3",
@@ -229,7 +229,7 @@
     "cmdk": "1.1.1",
     "dotenv": "17.4.2",
     "embla-carousel-react": "8.6.0",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "estree-util-is-identifier-name": "3.0.0",
     "estree-util-value-to-estree": "3.5.0",
     "fast-equals": "6.0.0",
@@ -260,7 +260,7 @@
     "openapi-types": "12.1.3",
     "pagefind": "1.5.2",
     "picocolors": "1.1.1",
-    "piscina": "5.1.4",
+    "piscina": "5.2.0",
     "posthog-node": "5.36.2",
     "quick-lru": "7.3.0",
     "react-error-boundary": "6.1.1",
@@ -288,11 +288,11 @@
     "unist-util-visit": "5.1.0",
     "vaul": "1.1.2",
     "vfile": "6.0.3",
-    "vite": "8.0.13",
+    "vite": "8.0.16",
     "yaml": "2.9.0",
     "yargs": "18.0.0",
     "zod": "4.4.3",
-    "zustand": "5.0.13"
+    "zustand": "5.0.14"
   },
   "devDependencies": {
     "@graphql-codegen/cli": "7.1.1",

package/src/lib/components/navigation/NavigationCategory.tsx

@@ -104,6 +104,7 @@ const NavigationCategoryInner = ({
       defaultOpen={isDefaultOpen}
       open={open}
       onOpenChange={(value) => {
+        if (!isCollapsible) return;
         // Categories with a link navigate on row click, so they only open here
         // (closing is done via the chevron). Without a link the row toggles.
         const nextOpen = category.link ? true : value;

package/src/lib/plugins/markdown/MdxPage.tsx

@@ -24,6 +24,7 @@ import { Popover, PopoverContent, PopoverTrigger } from "zudoku/ui/Popover.js";
 import type { TocEntry } from "../../../vite/mdx/rehype-extract-toc-with-jsx.js";
 import { AiAssistantMenuItems } from "../../components/AiAssistantMenuItems.js";
 import { CategoryHeading } from "../../components/CategoryHeading.js";
+import { useIsClient } from "../../components/ClientOnly.js";
 import { useViewportAnchor } from "../../components/context/ViewportAnchorContext.js";
 import { useZudoku } from "../../components/context/ZudokuContext.js";
 import { DeveloperHint } from "../../components/DeveloperHint.js";
@@ -193,6 +194,8 @@ export const MdxPage = ({
     ? new Date(frontmatter.lastModifiedTime)
     : null;
 
+  const isClient = useIsClient();
+
   const editConfig =
     frontmatter.suggestEdit !== false &&
     (frontmatter.suggestEdit ?? defaultOptions?.suggestEdit);
@@ -400,15 +403,27 @@ export const MdxPage = ({
               <div>
                 {showLastModified && lastModifiedDate && (
                   <div
-                    title={lastModifiedDate.toLocaleString(undefined, {
-                      dateStyle: "full",
-                      timeStyle: "medium",
-                    })}
+                    // Render the tooltip (full date + time in the viewer's local
+                    // timezone) only on the client. It's omitted on the server and
+                    // the first client render, so there's no hydration mismatch,
+                    // then added after mount.
+                    title={
+                      isClient
+                        ? lastModifiedDate.toLocaleString("en-US", {
+                            dateStyle: "full",
+                            timeStyle: "medium",
+                          })
+                        : undefined
+                    }
                   >
                     Last modified on{" "}
                     <time dateTime={lastModifiedDate.toISOString()}>
                       {lastModifiedDate.toLocaleDateString("en-US", {
                         dateStyle: "long",
+                        // Pinned to UTC so the prerendered day matches the client
+                        // render; a local timezone would shift the day near a UTC
+                        // boundary and cause a hydration error (#418).
+                        timeZone: "UTC",
                       })}
                     </time>
                   </div>