zudoku 0.82.0 → 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/dist/declarations/lib/components/navigation/motionFeatures.d.ts

@@ -1 +1,2 @@
-export { domAnimation as default } from "motion/react";
+import { domAnimation } from "motion/react";
+export default domAnimation;

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,7 +1,10 @@
 {
   "name": "zudoku",
-  "version": "0.82.0",
+  "version": "0.82.2",
   "type": "module",
+  "engines": {
+    "node": ">=20.19.0 <21.0.0 || >=22.12.0"
+  },
   "sideEffects": [
     "**/*.css",
     "**/polyfills.ts"
@@ -172,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",
@@ -226,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",
@@ -234,7 +237,7 @@
     "glob-parent": "6.0.2",
     "graphql": "16.14.0",
     "graphql-type-json": "0.3.2",
-    "graphql-yoga": "5.21.0",
+    "graphql-yoga": "5.21.2",
     "gray-matter": "4.0.3",
     "hast-util-heading-rank": "3.0.0",
     "hast-util-to-jsx-runtime": "2.3.6",
@@ -257,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",
@@ -285,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",
@@ -310,9 +313,10 @@
     "@types/semver": "7.7.1",
     "@types/unist": "3.0.3",
     "@types/yargs": "17.0.35",
+    "@typescript/native-preview": "7.0.0-dev.20260610.1",
     "@vitest/coverage-v8": "4.1.8",
     "happy-dom": "20.10.2",
-    "oxc-parser": "^0.133.0",
+    "oxc-parser": "^0.135.0",
     "react": "19.2.7",
     "react-dom": "19.2.7",
     "tsx": "4.22.4",
@@ -347,7 +351,7 @@
   "scripts": {
     "build": "tsx scripts/build.ts",
     "postbuild": "tsx scripts/check-external-deps.ts",
-    "typecheck": "tsc --project tsconfig.app.json --noEmit",
+    "typecheck": "tsgo --project tsconfig.app.json --noEmit",
     "generate:types": "tsx scripts/generate-types.js && tsx scripts/generate-flat-config.js",
     "generate:sri": "tsx scripts/generate-graphiql-sri.ts",
     "build:standalone": "vite build --mode standalone --config vite.standalone.config.ts --log-level=error",

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/components/navigation/motionFeatures.ts

@@ -1,2 +1,5 @@
-// Lazy-loaded animation features for LazyMotion (keeps the main bundle small).
-export { domAnimation as default } from "motion/react";
+// Lazy load motion features
+// See: https://motion.dev/docs/react-lazy-motion
+import { domAnimation } from "motion/react";
+
+export default domAnimation;

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);
@@ -273,7 +276,7 @@ export const MdxPage = ({
           centered && "xl:mx-auto",
         )}
       >
-        <header className="flow-root">
+        <header className="flow-root isolate">
           {showTocSidebar && (
             <>
               <Slot.Source name="top-navigation-side" type="append">
@@ -289,7 +292,7 @@ export const MdxPage = ({
           )}
           {(copyMarkdownConfig || showTocPopover) && (
             <div
-              className="float-end ms-4 mt-1 flex items-center gap-2"
+              className="relative z-10 float-end ms-4 mt-1 flex items-center gap-2"
               role="group"
               aria-label="Page actions"
             >
@@ -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>