fumadocs-core 16.2.2 → 16.2.4

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/{chunk-SLIKY7GW.js → chunk-JUF4WZ6G.js}

@@ -1,26 +1,31 @@
 import {
   flattenNode,
   toMdxExport
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-structure.ts
 import Slugger from "github-slugger";
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import { visit } from "unist-util-visit";
-function remarkStructure({
-  types = [
+var remarkStructureDefaultOptions = {
+  types: [
     "heading",
     "paragraph",
     "blockquote",
     "tableCell",
     "mdxJsxFlowElement"
   ],
-  allowedMdxAttributes = (node) => {
+  allowedMdxAttributes: (node) => {
     if (!node.name) return false;
     return ["TypeTable", "Callout"].includes(node.name);
   },
-  exportAs = false
+  exportAs: false
+};
+function remarkStructure({
+  types = remarkStructureDefaultOptions.types,
+  allowedMdxAttributes = remarkStructureDefaultOptions.allowedMdxAttributes,
+  exportAs = remarkStructureDefaultOptions.exportAs
 } = {}) {
   const slugger = new Slugger();
   if (Array.isArray(allowedMdxAttributes)) {
@@ -106,6 +111,7 @@ function structure(content, remarkPlugins = [], options = {}) {
 }
 
 export {
+  remarkStructureDefaultOptions,
   remarkStructure,
   structure
 };

package/dist/{chunk-HNZEUF6C.js → chunk-MA6O2UUE.js}

@@ -1,6 +1,6 @@
 import {
   flattenNode
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-heading.ts
 import Slugger from "github-slugger";

package/dist/{chunk-A4G5V4FQ.js → chunk-VLSDGCJE.js}

@@ -3,7 +3,7 @@ import { valueToEstree } from "estree-util-value-to-estree";
 function flattenNode(node) {
   if ("children" in node)
     return node.children.map((child) => flattenNode(child)).join("");
-  if ("value" in node) return node.value;
+  if ("value" in node && typeof node.value === "string") return node.value;
   return "";
 }
 function toMdxExport(name, value) {

package/dist/{chunk-JOXPHQ2R.js → chunk-W6WTLKRA.js}

@@ -1,6 +1,6 @@
 import {
   flattenNode
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-admonition.ts
 import { visit } from "unist-util-visit";

package/dist/content/toc.js

@@ -1,7 +1,7 @@
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 
 // src/content/toc.ts

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/i18n/middleware.d.ts

@@ -1,12 +1,34 @@
-import { NextProxy } from 'next/dist/server/web/types';
+import { NextProxy } from 'next/server';
 import { I18nConfig } from './index.js';
+import { NextURL } from 'next/dist/server/web/next-url';
 
 interface MiddlewareOptions extends I18nConfig {
     /**
-     * A function that adds the locale prefix to path name
+     * Either:
+     * - A formatter object
+     * - A function that adds the locale prefix to pathname
      */
-    format?: (locale: string, path: string) => string;
+    format?: URLFormatter | ((locale: string, pathname: string) => string);
+    /**
+     * the cookie to store locale code when `hideLocale` is set to `always`.
+     */
+    cookieName?: string;
+}
+interface URLFormatter {
+    /**
+     * get locale code from request URL
+     */
+    get: (url: NextURL) => string | undefined;
+    /**
+     * add locale code to request URL (which is missing the locale).
+     */
+    add: (url: NextURL, locale: string) => URL;
+    /**
+     * remove locale code from request URL
+     */
+    remove: (url: NextURL) => URL;
 }
-declare function createI18nMiddleware({ languages, defaultLanguage, format, hideLocale, }: MiddlewareOptions): NextProxy;
+declare const DefaultFormatter: URLFormatter;
+declare function createI18nMiddleware({ languages, defaultLanguage, format, cookieName, hideLocale, }: MiddlewareOptions): NextProxy;
 
-export { createI18nMiddleware };
+export { DefaultFormatter, type URLFormatter, createI18nMiddleware };

package/dist/i18n/middleware.js

@@ -6,58 +6,71 @@ import "../chunk-U67V476Y.js";
 // src/i18n/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";
 import { NextResponse } from "next/server";
-var COOKIE = "FD_LOCALE";
-function getLocale(request, locales, defaultLanguage) {
-  const languages = getNegotiator(request).languages(locales);
-  return matchLocale(languages, locales, defaultLanguage);
-}
-var defaultFormat = (locale, path) => {
-  return `/${locale}${path}`;
+var DefaultFormatter = {
+  get(url) {
+    const segs = url.pathname.split("/");
+    if (segs.length > 1 && segs[1]) return segs[1];
+  },
+  add(url, locale) {
+    const next = new URL(url);
+    next.pathname = `${url.basePath}/${locale}/${url.pathname}`.replaceAll(
+      /\/+/g,
+      "/"
+    );
+    return next;
+  },
+  remove(url) {
+    const next = new URL(url);
+    const pathname = url.pathname.split("/").slice(2).join("/");
+    next.pathname = `${url.basePath}/${pathname}`.replaceAll(/\/+/g, "/");
+    return next;
+  }
 };
 function createI18nMiddleware({
   languages,
   defaultLanguage,
-  format = defaultFormat,
+  format = DefaultFormatter,
+  cookieName = "FD_LOCALE",
   hideLocale = "never"
 }) {
-  function getLocaleUrl(request, locale) {
-    const next = new URL(request.url);
-    next.pathname = format(locale, forceSlashPrefix(request.nextUrl.pathname));
-    return next;
+  let formatter;
+  if (typeof format === "function") {
+    formatter = {
+      ...DefaultFormatter,
+      add(url, locale) {
+        const next = new URL(url);
+        next.pathname = format(locale, url.pathname);
+        return next;
+      }
+    };
+  } else {
+    formatter = format;
   }
   return (request) => {
     const url = request.nextUrl;
-    const pathLocale = languages.find(
-      (locale) => url.pathname.startsWith(`/${locale}/`) || url.pathname === `/${locale}`
-    );
+    let pathLocale = formatter.get(url);
+    if (pathLocale && !languages.includes(pathLocale)) pathLocale = void 0;
     if (!pathLocale) {
       if (hideLocale === "default-locale") {
-        return NextResponse.rewrite(getLocaleUrl(request, defaultLanguage));
+        return NextResponse.rewrite(formatter.add(url, defaultLanguage));
       }
-      const preferred = getLocale(request, languages, defaultLanguage);
+      const finalLanguages = getNegotiator(request).languages(languages);
+      const preferred = matchLocale(finalLanguages, languages, defaultLanguage);
       if (hideLocale === "always") {
-        const locale = request.cookies.get(COOKIE)?.value ?? preferred;
-        return NextResponse.rewrite(getLocaleUrl(request, locale));
+        const locale = request.cookies.get(cookieName)?.value ?? preferred;
+        return NextResponse.rewrite(formatter.add(url, locale));
       }
-      return NextResponse.redirect(getLocaleUrl(request, preferred));
+      return NextResponse.redirect(formatter.add(url, preferred));
     }
     if (hideLocale === "always" || hideLocale === "default-locale" && pathLocale === defaultLanguage) {
-      const res = NextResponse.redirect(
-        new URL(
-          forceSlashPrefix(url.pathname.slice(`/${pathLocale}`.length)),
-          request.url
-        )
-      );
-      res.cookies.set(COOKIE, pathLocale);
+      const res = NextResponse.redirect(formatter.remove(url));
+      res.cookies.set(cookieName, pathLocale);
       return res;
     }
     return NextResponse.next();
   };
 }
-function forceSlashPrefix(v) {
-  if (v.startsWith("/")) return v;
-  return "/" + v;
-}
 export {
+  DefaultFormatter,
   createI18nMiddleware
 };

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.d.ts

@@ -1,7 +1,7 @@
 export { Options as RemarkGfmOptions, default as remarkGfm } from 'remark-gfm';
 export { CodeBlockIcon, RehypeCodeOptions, rehypeCode, rehypeCodeDefaultOptions, transformerIcon, transformerTab } from './rehype-code.js';
 export { RemarkImageOptions, remarkImage } from './remark-image.js';
-export { StructureOptions, StructuredData, remarkStructure, structure } from './remark-structure.js';
+export { StructureOptions, StructuredData, remarkStructure, remarkStructureDefaultOptions, structure } from './remark-structure.js';
 export { RemarkHeadingOptions, remarkHeading } from './remark-heading.js';
 export { RemarkAdmonitionOptions, remarkAdmonition } from './remark-admonition.js';
 export { RemarkDirectiveAdmonitionOptions, remarkDirectiveAdmonition } from './remark-directive-admonition.js';

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";
@@ -15,8 +15,9 @@ import {
 } from "../chunk-XJ6ZQNEX.js";
 import {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
-} from "../chunk-SLIKY7GW.js";
+} from "../chunk-JUF4WZ6G.js";
 import {
   rehypeCode,
   rehypeCodeDefaultOptions,
@@ -28,7 +29,7 @@ import {
 } from "../chunk-EFVXL2PP.js";
 import {
   remarkAdmonition
-} from "../chunk-JOXPHQ2R.js";
+} from "../chunk-W6WTLKRA.js";
 import {
   remarkCodeTab
 } from "../chunk-CH7YHH7V.js";
@@ -45,8 +46,8 @@ import {
 import "../chunk-XN2LKXFZ.js";
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   generateCodeBlockTabs,
@@ -65,6 +66,7 @@ export {
   remarkNpm,
   remarkSteps,
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure,
   transformerIcon,
   transformerTab

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

@@ -1,7 +1,7 @@
 import {
   remarkAdmonition
-} from "../chunk-JOXPHQ2R.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-W6WTLKRA.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkAdmonition

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

@@ -1,7 +1,7 @@
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkHeading

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/mdx-plugins/remark-structure.d.ts

@@ -52,8 +52,15 @@ declare module 'vfile' {
         structuredData: StructuredData;
     }
 }
+declare const remarkStructureDefaultOptions: {
+    types: string[];
+    allowedMdxAttributes: (node: MdxJsxFlowElement) => boolean;
+    exportAs: false;
+};
 /**
- * Attach structured data to VFile, you can access via `vfile.data.structuredData`.
+ * Extract content into structured data.
+ *
+ * By default, the output is stored into VFile (`vfile.data.structuredData`), you can specify `exportAs` to export it.
  */
 declare function remarkStructure({ types, allowedMdxAttributes, exportAs, }?: StructureOptions): Transformer<Root, Root>;
 /**
@@ -61,4 +68,4 @@ declare function remarkStructure({ types, allowedMdxAttributes, exportAs, }?: St
  */
 declare function structure(content: string, remarkPlugins?: PluggableList, options?: StructureOptions): StructuredData;
 
-export { type StructureOptions, type StructuredData, remarkStructure, structure };
+export { type StructureOptions, type StructuredData, remarkStructure, remarkStructureDefaultOptions, structure };

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

@@ -1,10 +1,12 @@
 import {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
-} from "../chunk-SLIKY7GW.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-JUF4WZ6G.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
 };

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/client.d.ts

@@ -1,3 +1,4 @@
+import { DependencyList } from 'react';
 import { AnyOrama } from '@orama/orama';
 import '../mdx-plugins/remark-structure.js';
 import { BaseIndex } from './algolia.js';
@@ -9,7 +10,6 @@ import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'algoliasearch';
-import 'react';
 
 interface FetchOptions {
     /**
@@ -120,7 +120,7 @@ type Client = ({
 /**
  * Provide a hook to query different official search clients.
  *
- * Note: it will re-query when its parameters changed, make sure to use `useCallback()` on functions passed to this hook.
+ * Note: it will re-query when its parameters changed, make sure to use `useMemo()` on `clientOptions` or define `deps` array.
  */
 declare function useDocsSearch(clientOptions: Client & {
     /**
@@ -135,6 +135,6 @@ declare function useDocsSearch(clientOptions: Client & {
      * @defaultValue false
      */
     allowEmpty?: boolean;
-}): UseDocsSearch;
+}, deps?: DependencyList): UseDocsSearch;
 
 export { type AlgoliaOptions, type Client, type FetchOptions, type OramaCloudOptions, type StaticOptions, useDocsSearch };

package/dist/search/client.js

@@ -22,20 +22,21 @@ function useDebounce(value, delayMs = 1e3) {
 }
 
 // src/search/client.ts
-function isDifferentDeep(a, b) {
+function isDeepEqual(a, b) {
+  if (a === b) return true;
   if (Array.isArray(a) && Array.isArray(b)) {
-    return b.length !== a.length || a.some((v, i) => isDifferentDeep(v, b[i]));
+    return b.length === a.length && a.every((v, i) => isDeepEqual(v, b[i]));
   }
   if (typeof a === "object" && a && typeof b === "object" && b) {
     const aKeys = Object.keys(a);
     const bKeys = Object.keys(b);
-    return aKeys.length !== bKeys.length || aKeys.some(
-      (key) => isDifferentDeep(a[key], b[key])
+    return aKeys.length === bKeys.length && aKeys.every(
+      (key) => Object.hasOwn(b, key) && isDeepEqual(a[key], b[key])
     );
   }
-  return a !== b;
+  return false;
 }
-function useDocsSearch(clientOptions) {
+function useDocsSearch(clientOptions, deps) {
   const { delayMs = 100, allowEmpty = false, ...client } = clientOptions;
   const [search, setSearch] = useState2("");
   const [results, setResults] = useState2("empty");
@@ -44,7 +45,7 @@ function useDocsSearch(clientOptions) {
   const debouncedValue = useDebounce(search, delayMs);
   const onStart = useRef(void 0);
   useOnChange(
-    [client, debouncedValue],
+    [deps ?? clientOptions, debouncedValue],
     () => {
       if (onStart.current) {
         onStart.current();
@@ -89,7 +90,7 @@ function useDocsSearch(clientOptions) {
         setIsLoading(false);
       });
     },
-    isDifferentDeep
+    deps ? void 0 : (a, b) => !isDeepEqual(a, b)
   );
   return { search, setSearch, query: { isLoading, data: results, error } };
 }

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.4",
   "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,36 +125,37 @@
     "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": {
     "@mdx-js/mdx": "^3.1.1",
-    "@mixedbread/sdk": "^0.45.0",
+    "@mixedbread/sdk": "^0.46.0",
     "@orama/core": "^1.2.13",
-    "@tanstack/react-router": "1.136.18",
+    "@tanstack/react-router": "1.140.0",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.10.1",
+    "@types/node": "24.10.2",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "algoliasearch": "5.45.0",
-    "lucide-react": "^0.555.0",
+    "algoliasearch": "5.46.0",
+    "lucide-react": "^0.556.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.8",
+    "react-router": "^7.10.1",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.27.2",
-    "tsconfig": "0.0.0",
-    "eslint-config-custom": "0.0.0"
+    "waku": "^0.27.3",
+    "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": {