fumadocs-core 16.2.2 → 16.2.3

package/dist/breadcrumb.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { R as Root, N as Node } from './definitions-DbCug1P3.js';
+import { R as Root, N as Node } from './definitions-pJ7PybYY.js';
 
 interface BreadcrumbItem {
     name: ReactNode;

package/dist/{chunk-YDNO7UZ6.js → chunk-5PMI7QDD.js}

@@ -15,6 +15,20 @@ function remarkImage({
     const importsToInject = [];
     const promises = [];
     async function onImage(src, node) {
+      const attributes = [
+        {
+          type: "mdxJsxAttribute",
+          name: "alt",
+          value: node.alt ?? "image"
+        }
+      ];
+      if (node.title) {
+        attributes.push({
+          type: "mdxJsxAttribute",
+          name: "title",
+          value: node.title
+        });
+      }
       if (src.type === "file" && useImport) {
         const variableName = `__img${importsToInject.length}`;
         const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => src.file.endsWith(ext));
@@ -27,37 +41,31 @@ function remarkImage({
           variableName,
           importPath: getImportPath(src.file, file.dirname)
         });
+        attributes.push({
+          type: "mdxJsxAttribute",
+          name: "src",
+          value: {
+            type: "mdxJsxAttributeValueExpression",
+            value: variableName,
+            data: {
+              estree: {
+                body: [
+                  {
+                    type: "ExpressionStatement",
+                    expression: { type: "Identifier", name: variableName }
+                  }
+                ],
+                type: "Program",
+                sourceType: "script"
+              }
+            }
+          }
+        });
         const out = {
           children: [],
           type: "mdxJsxFlowElement",
           name: "img",
-          attributes: [
-            {
-              type: "mdxJsxAttribute",
-              name: "alt",
-              value: node.alt ?? "image"
-            },
-            {
-              type: "mdxJsxAttribute",
-              name: "src",
-              value: {
-                type: "mdxJsxAttributeValueExpression",
-                value: variableName,
-                data: {
-                  estree: {
-                    body: [
-                      {
-                        type: "ExpressionStatement",
-                        expression: { type: "Identifier", name: variableName }
-                      }
-                    ],
-                    type: "Program",
-                    sourceType: "script"
-                  }
-                }
-              }
-            }
-          ]
+          attributes
         };
         if (hasBlur) {
           out.attributes.push({
@@ -77,32 +85,28 @@ function remarkImage({
         );
       });
       if (!size) return;
+      attributes.push(
+        {
+          type: "mdxJsxAttribute",
+          name: "src",
+          // `src` doesn't support file paths, we can use `node.url` for files and let the underlying framework handle it
+          value: src.type === "url" ? src.url.toString() : node.url
+        },
+        {
+          type: "mdxJsxAttribute",
+          name: "width",
+          value: size.width.toString()
+        },
+        {
+          type: "mdxJsxAttribute",
+          name: "height",
+          value: size.height.toString()
+        }
+      );
       return {
         type: "mdxJsxFlowElement",
         name: "img",
-        attributes: [
-          {
-            type: "mdxJsxAttribute",
-            name: "alt",
-            value: node.alt ?? "image"
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "src",
-            // `src` doesn't support file paths, we can use `node.url` for files and let the underlying framework handle it
-            value: src.type === "url" ? src.url.toString() : node.url
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "width",
-            value: size.width.toString()
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "height",
-            value: size.height.toString()
-          }
-        ],
+        attributes,
         children: []
       };
     }

package/dist/{definitions-DbCug1P3.d.ts → definitions-pJ7PybYY.d.ts}

@@ -1,12 +1,12 @@
 import { ReactNode } from 'react';
 
-interface INode {
+interface ID {
     /**
      * ID for the node, unique in all page trees (even across different locales)
      */
     $id?: string;
 }
-interface Root extends INode {
+interface Root extends ID {
     name: ReactNode;
     children: Node[];
     /**
@@ -15,7 +15,7 @@ interface Root extends INode {
     fallback?: Root;
 }
 type Node = Item | Separator | Folder;
-interface Item extends INode {
+interface Item extends ID {
     /**
      * @internal
      */
@@ -34,12 +34,12 @@ interface Item extends INode {
     description?: ReactNode;
     icon?: ReactNode;
 }
-interface Separator extends INode {
+interface Separator extends ID {
     type: 'separator';
     name?: ReactNode;
     icon?: ReactNode;
 }
-interface Folder extends INode {
+interface Folder extends ID {
     /**
      * @internal
      */
@@ -51,6 +51,7 @@ interface Folder extends INode {
     description?: ReactNode;
     root?: boolean;
     defaultOpen?: boolean;
+    collapsible?: boolean;
     index?: Item;
     icon?: ReactNode;
     children: Node[];

package/dist/{loader-Dz9yZIJQ.d.ts → loader-qkSHi822.d.ts}

@@ -1,4 +1,4 @@
-import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-DbCug1P3.js';
+import { R as Root, I as Item, F as Folder, S as Separator } from './definitions-pJ7PybYY.js';
 import { I18nConfig } from './i18n/index.js';
 import { ReactNode } from 'react';
 
@@ -15,6 +15,7 @@ interface MetaData {
     root?: boolean | undefined;
     pages?: string[] | undefined;
     defaultOpen?: boolean | undefined;
+    collapsible?: boolean | undefined;
     description?: string | undefined;
 }
 interface PageData {

package/dist/mdx-plugins/index.js

@@ -1,6 +1,6 @@
 import {
   remarkImage
-} from "../chunk-YDNO7UZ6.js";
+} from "../chunk-5PMI7QDD.js";
 import {
   remarkMdxFiles
 } from "../chunk-ADBHPKXG.js";

package/dist/mdx-plugins/remark-image.js

@@ -1,6 +1,6 @@
 import {
   remarkImage
-} from "../chunk-YDNO7UZ6.js";
+} from "../chunk-5PMI7QDD.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkImage

package/dist/page-tree/index.d.ts

@@ -1,5 +1,5 @@
-import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-DbCug1P3.js';
-export { S as Separator } from '../definitions-DbCug1P3.js';
+import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-pJ7PybYY.js';
+export { S as Separator } from '../definitions-pJ7PybYY.js';
 import 'react';
 
 /**

package/dist/search/server.d.ts

@@ -3,12 +3,12 @@ import { StructuredData } from '../mdx-plugins/remark-structure.js';
 import { SortedResult } from './index.js';
 export { HighlightedText, ReactSortedResult, createContentHighlighter } from './index.js';
 import { I18nConfig } from '../i18n/index.js';
-import { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-Dz9yZIJQ.js';
+import { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-qkSHi822.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'react';
-import '../definitions-DbCug1P3.js';
+import '../definitions-pJ7PybYY.js';
 
 type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
 declare const simpleSchema: {

package/dist/source/client/index.d.ts

@@ -1,4 +1,4 @@
-import { R as Root } from '../../definitions-DbCug1P3.js';
+import { R as Root } from '../../definitions-pJ7PybYY.js';
 import 'react';
 
 declare function deserializePageTree(root: Root): Root;

package/dist/source/index.d.ts

@@ -1,5 +1,5 @@
-export { C as ContentStorage, q as ContentStorageFile, F as FileSystem, i as InferMetaType, I as InferPageType, c as LoaderConfig, d as LoaderOptions, g as LoaderOutput, L as LoaderPlugin, s as LoaderPluginOption, f as Meta, M as MetaData, e as Page, P as PageData, o as PageTreeBuilder, j as PageTreeBuilderContext, n as PageTreeOptions, k as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, r as buildContentStorage, t as buildPlugins, h as createGetUrl, p as createPageTreeBuilder, l as loader, b as map, m as multiple } from '../loader-Dz9yZIJQ.js';
-import '../definitions-DbCug1P3.js';
+export { C as ContentStorage, q as ContentStorageFile, F as FileSystem, i as InferMetaType, I as InferPageType, c as LoaderConfig, d as LoaderOptions, g as LoaderOutput, L as LoaderPlugin, s as LoaderPluginOption, f as Meta, M as MetaData, e as Page, P as PageData, o as PageTreeBuilder, j as PageTreeBuilderContext, n as PageTreeOptions, k as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, r as buildContentStorage, t as buildPlugins, h as createGetUrl, p as createPageTreeBuilder, l as loader, b as map, m as multiple } from '../loader-qkSHi822.js';
+import '../definitions-pJ7PybYY.js';
 import 'react';
 import '../i18n/index.js';
 

package/dist/source/index.js

@@ -399,15 +399,14 @@ function createPageTreeBuilderUtils(ctx) {
         "page"
       );
       let meta = storage.read(metaPath);
-      if (meta?.format !== "meta") {
-        meta = void 0;
-      }
-      const isRoot = meta?.data.root ?? isGlobalRoot;
+      if (meta && meta.format !== "meta") meta = void 0;
+      const metadata = meta?.data ?? {};
+      const { root = isGlobalRoot, pages } = metadata;
       let index;
       let children;
-      if (meta && meta.data.pages) {
-        const resolved = meta.data.pages.flatMap((item) => this.resolveFolderItem(folderPath, item));
-        if (!isRoot && !visitedPaths.has(indexPath)) {
+      if (pages) {
+        const resolved = pages.flatMap((item) => this.resolveFolderItem(folderPath, item));
+        if (!root && !visitedPaths.has(indexPath)) {
           index = this.file(indexPath);
         }
         for (let i = 0; i < resolved.length; i++) {
@@ -422,25 +421,24 @@ function createPageTreeBuilderUtils(ctx) {
         }
         children = resolved;
       } else {
-        if (!isRoot && !visitedPaths.has(indexPath)) {
+        if (!root && !visitedPaths.has(indexPath)) {
           index = this.file(indexPath);
         }
         children = this.buildPaths(
           files.filter((file) => !visitedPaths.has(file))
         );
       }
-      let name = meta?.data.title ?? index?.name;
-      if (!name) {
-        const folderName = basename(folderPath);
-        name = pathToName(group.exec(folderName)?.[1] ?? folderName);
-      }
       let node = {
         type: "folder",
-        name,
-        icon: meta?.data.icon ?? index?.icon,
-        root: meta?.data.root,
-        defaultOpen: meta?.data.defaultOpen,
-        description: meta?.data.description,
+        name: metadata.title ?? index?.name ?? (() => {
+          const folderName = basename(folderPath);
+          return pathToName(group.exec(folderName)?.[1] ?? folderName);
+        })(),
+        icon: metadata.icon,
+        root: metadata.root,
+        defaultOpen: metadata.defaultOpen,
+        description: metadata.description,
+        collapsible: metadata.collapsible,
         index,
         children,
         $id: nextNodeId(folderPath),

package/dist/source/plugins/lucide-icons.d.ts

@@ -1,6 +1,6 @@
-import { L as LoaderPlugin } from '../../loader-Dz9yZIJQ.js';
+import { L as LoaderPlugin } from '../../loader-qkSHi822.js';
 import { icons } from 'lucide-react';
-import '../../definitions-DbCug1P3.js';
+import '../../definitions-pJ7PybYY.js';
 import 'react';
 import '../../i18n/index.js';
 

package/dist/source/schema.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+/**
+ * Zod 4 schema
+ */
+declare const metaSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+    root: z.ZodOptional<z.ZodBoolean>;
+    defaultOpen: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod 4 schema
+ */
+declare const pageSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    full: z.ZodOptional<z.ZodBoolean>;
+    _openapi: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strip>;
+
+export { metaSchema, pageSchema };

package/dist/source/schema.js

@@ -0,0 +1,25 @@
+import "../chunk-U67V476Y.js";
+
+// src/source/schema.ts
+import { z } from "zod";
+var metaSchema = z.object({
+  title: z.string().optional(),
+  pages: z.array(z.string()).optional(),
+  description: z.string().optional(),
+  root: z.boolean().optional(),
+  defaultOpen: z.boolean().optional(),
+  collapsible: z.boolean().optional(),
+  icon: z.string().optional()
+});
+var pageSchema = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  icon: z.string().optional(),
+  full: z.boolean().optional(),
+  // Fumadocs OpenAPI generated
+  _openapi: z.looseObject({}).optional()
+});
+export {
+  metaSchema,
+  pageSchema
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.2",
+  "version": "16.2.3",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Fumadocs",
@@ -52,6 +52,10 @@
       "import": "./dist/source/client/index.js",
       "types": "./dist/source/client/index.d.ts"
     },
+    "./source/schema": {
+      "import": "./dist/source/schema.js",
+      "types": "./dist/source/schema.d.ts"
+    },
     "./source/*": {
       "import": "./dist/source/plugins/*.js",
       "types": "./dist/source/plugins/*.d.ts"
@@ -107,8 +111,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.2",
     "@orama/orama": "^3.1.16",
-    "@shikijs/rehype": "^3.18.0",
-    "@shikijs/transformers": "^3.18.0",
+    "@shikijs/rehype": "^3.19.0",
+    "@shikijs/transformers": "^3.19.0",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -121,7 +125,7 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.18.0",
+    "shiki": "^3.19.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
@@ -140,8 +144,8 @@
     "lucide-react": "^0.555.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "16.0.6",
-    "react-router": "^7.9.6",
+    "next": "16.0.7",
+    "react-router": "^7.10.0",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
@@ -149,8 +153,9 @@
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
     "waku": "^0.27.2",
-    "tsconfig": "0.0.0",
-    "eslint-config-custom": "0.0.0"
+    "zod": "^4.1.13",
+    "eslint-config-custom": "0.0.0",
+    "tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "@mixedbread/sdk": "^0.19.0",
@@ -163,7 +168,8 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-router": "7.x.x",
-    "waku": "^0.26.0 || ^0.27.0"
+    "waku": "^0.26.0 || ^0.27.0",
+    "zod": "*"
   },
   "peerDependenciesMeta": {
     "@mixedbread/sdk": {
@@ -198,6 +204,9 @@
     },
     "lucide-react": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "publishConfig": {