fumadocs-core 16.15.4 → 16.15.5

package/dist/breadcrumb.d.ts

@@ -1,4 +1,4 @@
-import { i as Root, r as Node, t as Folder } from "./definitions-D8-KI7Uy.js";
+import { i as Root, r as Node, t as Folder } from "./definitions-CFOhwE1k.js";
 import { ReactNode } from "react";
 //#region src/breadcrumb.d.ts
 interface BreadcrumbItem {

package/dist/breadcrumb.js

@@ -1,5 +1,5 @@
 import { r as normalizeUrl } from "./url-BVHvi3_K.js";
-import { r as findPath } from "./utils-Dn9VIXRN.js";
+import { r as findPath } from "./utils-DEVq3cEC.js";
 import { useMemo } from "react";
 //#region src/breadcrumb.tsx
 function useBreadcrumb(url, tree, options) {

package/dist/{build-doc-CX-PNB-q.js → build-doc-4OvfjVN2.js}

@@ -1,4 +1,4 @@
-import { r as findPath } from "./utils-Dn9VIXRN.js";
+import { r as findPath } from "./utils-DEVq3cEC.js";
 import { r as extname, t as basename } from "./path-1H5VzYiT.js";
 //#region src/search/server/build-index.ts
 async function buildIndexDefault(page) {

package/dist/{definitions-D8-KI7Uy.d.ts → definitions-CFOhwE1k.d.ts}

@@ -54,7 +54,14 @@ interface Folder extends ID {
   type: 'folder';
   name: ReactNode;
   description?: ReactNode;
-  root?: boolean;
+  /**
+   * Mark as a root folder, `true` for the default type.
+   *
+   * A string value specifies its **root type**: root folders of the same type
+   * under the same parent scope are interchangeable (e.g. versions), and pages
+   * can map to their structural projection in another root.
+   */
+  root?: boolean | string;
   defaultOpen?: boolean;
   collapsible?: boolean;
   index?: Item;

package/dist/{dynamic-Dgf8t2t2.js → dynamic-CTsodhTH.js}

@@ -1,5 +1,5 @@
 import { r as normalizeUrl } from "./url-BVHvi3_K.js";
-import { c as visit } from "./utils-Dn9VIXRN.js";
+import { l as visit } from "./utils-DEVq3cEC.js";
 import { t as isEqualShallow } from "./is-equal-LdLqRs0o.js";
 import { a as normalize, i as joinPath, n as dirname, r as extname, t as basename } from "./path-1H5VzYiT.js";
 import { slugsPlugin } from "./source/plugins/slugs.js";

package/dist/{index-CdZGMKDG.d.ts → index-B-0R0VbS.d.ts}

@@ -1,5 +1,5 @@
-import { i as Root } from "./definitions-D8-KI7Uy.js";
-import "./index-DZN5OrTa.js";
+import { i as Root } from "./definitions-CFOhwE1k.js";
+import "./index-E8Qh_yQs.js";
 //#region src/source/client/index.d.ts
 interface SerializedPageTree {
   $fumadocs_loader: 'page-tree';

package/dist/{index-19nHQs6M.d.ts → index-BL0I0wLZ.d.ts}

@@ -1,10 +1,10 @@
-import { a as Separator, i as Root, n as Item, r as Node, t as Folder } from "./definitions-D8-KI7Uy.js";
+import { a as Separator, i as Root, n as Item, r as Node, t as Folder } from "./definitions-CFOhwE1k.js";
 import { t as Awaitable } from "./types-D89QoQR-.js";
 import { i as StructuredData } from "./remark-structure-CnHwvNZr.js";
 import "./index-BhgPrb5p.js";
 import { n as I18nConfig } from "./index-DydiXvgS.js";
-import "./index-DZN5OrTa.js";
-import { n as SerializedPageTree } from "./index-CdZGMKDG.js";
+import "./index-E8Qh_yQs.js";
+import { n as SerializedPageTree } from "./index-B-0R0VbS.js";
 import { ReactNode } from "react";
 //#region src/source/storage/file-system.d.ts
 /**
@@ -388,7 +388,7 @@ type SourceConfig = {
 interface MetaData {
   icon?: string | undefined;
   title?: string | undefined;
-  root?: boolean | undefined;
+  root?: boolean | string | undefined;
   pages?: string[] | undefined;
   pagesIndex?: string | undefined;
   defaultOpen?: boolean | undefined;

package/dist/{index-DZN5OrTa.d.ts → index-E8Qh_yQs.d.ts}

@@ -1,4 +1,4 @@
-import { i as Root, n as Item, r as Node, t as Folder } from "./definitions-D8-KI7Uy.js";
+import { i as Root, n as Item, r as Node, t as Folder } from "./definitions-CFOhwE1k.js";
 //#region src/page-tree/utils.d.ts
 /**
  * Flatten tree to an array of page nodes
@@ -33,6 +33,11 @@ declare function findParent(from: Root | Folder, url: string): Root | Folder | u
 declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, options?: {
   includeSeparator?: boolean;
 }): Node[] | null;
+/**
+ * Find the structural projection of `page` (under the root folder `from`) in `to`:
+ * the page at the same file path relative to the root folder.
+ */
+declare function findProjection(from: Folder, to: Folder, page: Item): Item | undefined;
 /**
  * Perform a depth-first search on page tree visiting every node.
  *
@@ -41,4 +46,4 @@ declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, optio
  */
 declare function visit<Root$1 extends Node | Root>(root: Root$1, visitor: <T extends Node | Root>(node: T, parent?: Root | Folder) => 'skip' | 'break' | T | void): Root$1;
 //#endregion
-export { flattenTree as a, visit as c, findSiblings as i, findParent as n, getPageTreePeers as o, findPath as r, getPageTreeRoots as s, findNeighbour as t };
+export { findSiblings as a, getPageTreeRoots as c, findProjection as i, visit as l, findParent as n, flattenTree as o, findPath as r, getPageTreePeers as s, findNeighbour as t };

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

@@ -1,3 +1,3 @@
-import { a as Separator, i as Root, n as Item, r as Node, t as Folder } from "../definitions-D8-KI7Uy.js";
-import { a as flattenTree, c as visit, i as findSiblings, n as findParent, o as getPageTreePeers, r as findPath, s as getPageTreeRoots, t as findNeighbour } from "../index-DZN5OrTa.js";
-export { Folder, Item, Node, Root, Separator, findNeighbour, findParent, findPath, findSiblings, flattenTree, getPageTreePeers, getPageTreeRoots, visit };
+import { a as Separator, i as Root, n as Item, r as Node, t as Folder } from "../definitions-CFOhwE1k.js";
+import { a as findSiblings, c as getPageTreeRoots, i as findProjection, l as visit, n as findParent, o as flattenTree, r as findPath, s as getPageTreePeers, t as findNeighbour } from "../index-E8Qh_yQs.js";
+export { Folder, Item, Node, Root, Separator, findNeighbour, findParent, findPath, findProjection, findSiblings, flattenTree, getPageTreePeers, getPageTreeRoots, visit };

package/dist/page-tree/index.js

@@ -1,2 +1,2 @@
-import { a as flattenTree, c as visit, i as findSiblings, n as findParent, o as getPageTreePeers, r as findPath, s as getPageTreeRoots, t as findNeighbour } from "../utils-Dn9VIXRN.js";
-export { findNeighbour, findParent, findPath, findSiblings, flattenTree, getPageTreePeers, getPageTreeRoots, visit };
+import { a as findSiblings, c as getPageTreeRoots, i as findProjection, l as visit, n as findParent, o as flattenTree, r as findPath, s as getPageTreePeers, t as findNeighbour } from "../utils-DEVq3cEC.js";
+export { findNeighbour, findParent, findPath, findProjection, findSiblings, flattenTree, getPageTreePeers, getPageTreeRoots, visit };

package/dist/search/flexsearch.d.ts

@@ -1,8 +1,8 @@
 import { t as Awaitable } from "../types-D89QoQR-.js";
 import { n as I18nConfig } from "../index-DydiXvgS.js";
 import "../index-BM36H-xw.js";
-import { m as SharedIndex, n as SearchAPI, t as QueryOptions } from "../server-C8FDQbVc.js";
-import { b as LoaderOutput, v as LoaderConfig } from "../index-19nHQs6M.js";
+import { m as SharedIndex, n as SearchAPI, t as QueryOptions } from "../server-k_q58LOn.js";
+import { b as LoaderOutput, v as LoaderConfig } from "../index-BL0I0wLZ.js";
 import { DocumentData, DocumentOptions } from "flexsearch";
 //#region src/search/server/build-doc.d.ts
 interface SharedDocument {

package/dist/search/flexsearch.js

@@ -1,5 +1,5 @@
 import { t as createEndpoint } from "../endpoint-MyoBU5IC.js";
-import { n as buildBreadcrumbs, r as buildIndexDefault, t as buildDocuments } from "../build-doc-CX-PNB-q.js";
+import { n as buildBreadcrumbs, r as buildIndexDefault, t as buildDocuments } from "../build-doc-4OvfjVN2.js";
 import { n as search, t as createDocument } from "../utils-Bvy3V-fv.js";
 import Search from "flexsearch";
 //#region src/search/flexsearch.ts

package/dist/search/mixedbread.d.ts

@@ -1,5 +1,5 @@
 import { r as SortedResult } from "../index-BM36H-xw.js";
-import { n as SearchAPI } from "../server-C8FDQbVc.js";
+import { n as SearchAPI } from "../server-k_q58LOn.js";
 import Mixedbread from "@mixedbread/sdk";
 import { StoreSearchResponse } from "@mixedbread/sdk/resources/stores";
 //#region src/search/mixedbread.d.ts

package/dist/search/server.d.ts

@@ -1,2 +1,2 @@
-import { a as AdvancedOptions, c as SimpleOptions, d as createSearchAPI, f as initAdvancedSearch, i as AdvancedIndex, l as createFromSource, n as SearchAPI, o as ExportedData, p as initSimpleSearch, r as SearchServer, s as Index, t as QueryOptions, u as createI18nSearchAPI } from "../server-C8FDQbVc.js";
+import { a as AdvancedOptions, c as SimpleOptions, d as createSearchAPI, f as initAdvancedSearch, i as AdvancedIndex, l as createFromSource, n as SearchAPI, o as ExportedData, p as initSimpleSearch, r as SearchServer, s as Index, t as QueryOptions, u as createI18nSearchAPI } from "../server-k_q58LOn.js";
 export { AdvancedIndex, AdvancedOptions, ExportedData, Index, QueryOptions, SearchAPI, SearchServer, SimpleOptions, createFromSource, createI18nSearchAPI, createSearchAPI, initAdvancedSearch, initSimpleSearch };

package/dist/search/server.js

@@ -1,5 +1,5 @@
 import { n as defaultReadOptions, t as createEndpoint } from "../endpoint-MyoBU5IC.js";
-import { n as buildBreadcrumbs, r as buildIndexDefault, t as buildDocuments } from "../build-doc-CX-PNB-q.js";
+import { n as buildBreadcrumbs, r as buildIndexDefault, t as buildDocuments } from "../build-doc-4OvfjVN2.js";
 import { n as searchSimple, t as searchAdvanced } from "../advanced-Ct13khZr.js";
 import { create, insertMultipleAsync, save } from "zbsearch";
 //#region src/search/zbsearch/create-db.ts

package/dist/{server-C8FDQbVc.d.ts → server-k_q58LOn.d.ts}

@@ -2,7 +2,7 @@ import { t as Awaitable } from "./types-D89QoQR-.js";
 import { i as StructuredData } from "./remark-structure-CnHwvNZr.js";
 import { n as I18nConfig } from "./index-DydiXvgS.js";
 import { r as SortedResult } from "./index-BM36H-xw.js";
-import { b as LoaderOutput, v as LoaderConfig } from "./index-19nHQs6M.js";
+import { b as LoaderOutput, v as LoaderConfig } from "./index-BL0I0wLZ.js";
 import { Language, RawData, SearchParams, TypedDocument, ZBSearch, create } from "zbsearch";
 //#region src/search/zbsearch/create-db.d.ts
 type SimpleDocument = TypedDocument<ZBSearch<typeof simpleSchema>>;

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

@@ -1,2 +1,2 @@
-import { i as useFumadocsLoader, n as SerializedPageTree, r as deserializePageTree, t as Serialized } from "../../index-CdZGMKDG.js";
+import { i as useFumadocsLoader, n as SerializedPageTree, r as deserializePageTree, t as Serialized } from "../../index-B-0R0VbS.js";
 export { Serialized, SerializedPageTree, deserializePageTree, useFumadocsLoader };

package/dist/source/client/index.js

@@ -1,4 +1,4 @@
-import { c as visit } from "../../utils-Dn9VIXRN.js";
+import { l as visit } from "../../utils-DEVq3cEC.js";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/source/client/index.tsx

package/dist/source/dynamic.d.ts

@@ -1,2 +1,2 @@
-import { h as dynamicLoader, m as DynamicLoaderConfig, p as DynamicLoader } from "../index-19nHQs6M.js";
+import { h as dynamicLoader, m as DynamicLoaderConfig, p as DynamicLoader } from "../index-BL0I0wLZ.js";
 export { DynamicLoader, DynamicLoaderConfig, dynamicLoader };

package/dist/source/dynamic.js

@@ -1,2 +1,2 @@
-import { t as dynamicLoader } from "../dynamic-Dgf8t2t2.js";
+import { t as dynamicLoader } from "../dynamic-CTsodhTH.js";
 export { dynamicLoader };

package/dist/source/index.d.ts

@@ -1,2 +1,2 @@
-import { B as ContentStoragePageFile, C as Meta, D as loader, E as createGetUrl, F as PageTreeBuilderContext, I as PageTreeOptions, L as PageTreeTransformer, O as types_d_exports, P as PageTreeBuilder, R as ContentStorage, S as LoaderPluginOption, T as ResolvedLoaderConfig, V as FileSystem, _ as InferPageType, a as MetaData, b as LoaderOutput, c as SourceUnion, d as multiple, f as update, g as InferMetaType, h as dynamicLoader, i as DynamicSource, j as getSlugs, l as StaticSource, m as DynamicLoaderConfig, n as llms, o as PageData, p as DynamicLoader, r as path_d_exports, s as Source, t as LLMsConfig, u as VirtualFile, v as LoaderConfig, w as Page, x as LoaderPlugin, y as LoaderOptions, z as ContentStorageMetaFile } from "../index-19nHQs6M.js";
+import { B as ContentStoragePageFile, C as Meta, D as loader, E as createGetUrl, F as PageTreeBuilderContext, I as PageTreeOptions, L as PageTreeTransformer, O as types_d_exports, P as PageTreeBuilder, R as ContentStorage, S as LoaderPluginOption, T as ResolvedLoaderConfig, V as FileSystem, _ as InferPageType, a as MetaData, b as LoaderOutput, c as SourceUnion, d as multiple, f as update, g as InferMetaType, h as dynamicLoader, i as DynamicSource, j as getSlugs, l as StaticSource, m as DynamicLoaderConfig, n as llms, o as PageData, p as DynamicLoader, r as path_d_exports, s as Source, t as LLMsConfig, u as VirtualFile, v as LoaderConfig, w as Page, x as LoaderPlugin, y as LoaderOptions, z as ContentStorageMetaFile } from "../index-BL0I0wLZ.js";
 export { type ContentStorage, type ContentStorageMetaFile, type ContentStoragePageFile, type DynamicLoader, type DynamicLoaderConfig, type DynamicSource, FileSystem, InferMetaType, InferPageType, LLMsConfig, LoaderConfig, LoaderOptions, LoaderOutput, LoaderPlugin, LoaderPluginOption, Meta, type MetaData, Page, type PageData, type PageTreeBuilder, type PageTreeBuilderContext, type PageTreeOptions, type PageTreeTransformer, path_d_exports as PathUtils, ResolvedLoaderConfig, type Source, type SourceUnion, type StaticSource, type VirtualFile, type types_d_exports as _Internal, createGetUrl, dynamicLoader, getSlugs, llms, loader, multiple, update };

package/dist/source/index.js

@@ -1,5 +1,5 @@
 import { o as path_exports } from "../path-1H5VzYiT.js";
-import { a as update, i as multiple, n as createGetUrl, o as FileSystem, r as loader, t as dynamicLoader } from "../dynamic-Dgf8t2t2.js";
+import { a as update, i as multiple, n as createGetUrl, o as FileSystem, r as loader, t as dynamicLoader } from "../dynamic-CTsodhTH.js";
 import { getSlugs } from "./plugins/slugs.js";
 import { llms } from "./llms.js";
 export { FileSystem, path_exports as PathUtils, createGetUrl, dynamicLoader, getSlugs, llms, loader, multiple, update };

package/dist/source/llms.d.ts

@@ -1,2 +1,2 @@
-import { n as llms, t as LLMsConfig } from "../index-19nHQs6M.js";
+import { n as llms, t as LLMsConfig } from "../index-BL0I0wLZ.js";
 export { LLMsConfig, llms };

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

@@ -1,4 +1,4 @@
-import { x as LoaderPlugin } from "../../index-19nHQs6M.js";
+import { x as LoaderPlugin } from "../../index-BL0I0wLZ.js";
 import { icons } from "lucide-react";
 //#region src/source/plugins/lucide-icons.d.ts
 /**

package/dist/source/plugins/slugs.d.ts

@@ -1,2 +1,2 @@
-import { A as SlugsPluginOptions, M as slugsFromData, N as slugsPlugin, j as getSlugs, k as SlugFn } from "../../index-19nHQs6M.js";
+import { A as SlugsPluginOptions, M as slugsFromData, N as slugsPlugin, j as getSlugs, k as SlugFn } from "../../index-BL0I0wLZ.js";
 export { SlugFn, SlugsPluginOptions, getSlugs, slugsFromData, slugsPlugin };

package/dist/source/plugins/status-badges.d.ts

@@ -1,5 +1,5 @@
-import { a as Separator$1, n as Item$1, t as Folder$1 } from "../../definitions-D8-KI7Uy.js";
-import { x as LoaderPlugin } from "../../index-19nHQs6M.js";
+import { a as Separator$1, n as Item$1, t as Folder$1 } from "../../definitions-CFOhwE1k.js";
+import { x as LoaderPlugin } from "../../index-BL0I0wLZ.js";
 import { ReactNode } from "react";
 //#region src/source/plugins/status-badges.d.ts
 interface Item extends Item$1 {

package/dist/source/schema.d.ts

@@ -8,7 +8,7 @@ declare const metaSchema: z.ZodObject<{
   pages: z.ZodOptional<z.ZodArray<z.ZodString>>;
   pagesIndex: z.ZodOptional<z.ZodString>;
   description: z.ZodOptional<z.ZodString>;
-  root: z.ZodOptional<z.ZodBoolean>;
+  root: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
   defaultOpen: z.ZodOptional<z.ZodBoolean>;
   collapsible: z.ZodOptional<z.ZodBoolean>;
   icon: z.ZodOptional<z.ZodString>;

package/dist/source/schema.js

@@ -9,7 +9,7 @@ const metaSchema = z.object({
 	/** specify a index page for folder */
 	pagesIndex: z.string().optional(),
 	description: z.string().optional(),
-	root: z.boolean().optional(),
+	root: z.union([z.boolean(), z.string()]).optional(),
 	defaultOpen: z.boolean().optional(),
 	collapsible: z.boolean().optional(),
 	icon: z.string().optional()

package/dist/{utils-Dn9VIXRN.js → utils-DEVq3cEC.js}

@@ -103,6 +103,23 @@ function findPath(nodes, matcher, options = {}) {
 	}
 	return run(nodes) ?? null;
 }
+/**
+* Find the structural projection of `page` (under the root folder `from`) in `to`:
+* the page at the same file path relative to the root folder.
+*/
+function findProjection(from, to, page) {
+	const prefix = from.$ref && `${from.$ref.folder}/`;
+	if (!prefix || !to.$ref || !page.$ref?.startsWith(prefix)) return;
+	const target = `${to.$ref.folder}/${page.$ref.slice(prefix.length)}`;
+	let result;
+	visit(to, (node) => {
+		if (node.type === "page" && node.$ref === target) {
+			result = node;
+			return "break";
+		}
+	});
+	return result;
+}
 const VisitBreak = Symbol("VisitBreak");
 /**
 * Perform a depth-first search on page tree visiting every node.
@@ -131,4 +148,4 @@ function visit(root, visitor) {
 	}
 }
 //#endregion
-export { flattenTree as a, visit as c, findSiblings as i, findParent as n, getPageTreePeers as o, findPath as r, getPageTreeRoots as s, findNeighbour as t };
+export { findSiblings as a, getPageTreeRoots as c, findProjection as i, visit as l, findParent as n, flattenTree as o, findPath as r, getPageTreePeers as s, findNeighbour as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.15.4",
+  "version": "16.15.5",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Docs",