fumadocs-core 15.2.8 → 16.4.2

package/README.md

@@ -2,4 +2,4 @@
 
 The core library for Fumadocs.
 
-📘 Learn More: [Documentation](https://fumadocs.vercel.app)
+📘 Learn More: [Documentation](https://fumadocs.dev)

package/dist/advanced-BRT5Ij43.js

@@ -0,0 +1,80 @@
+import { t as createContentHighlighter } from "./search-D6ChCLhY.js";
+import { t as removeUndefined } from "./remove-undefined-Cfs4o_mM.js";
+import { getByID, search } from "@orama/orama";
+
+//#region src/search/orama/search/simple.ts
+async function searchSimple(db, query, params = {}) {
+	const highlighter = createContentHighlighter(query);
+	return (await search(db, {
+		term: query,
+		tolerance: 1,
+		...params,
+		boost: {
+			title: 2,
+			..."boost" in params ? params.boost : void 0
+		}
+	})).hits.map((hit) => ({
+		type: "page",
+		content: hit.document.title,
+		breadcrumbs: hit.document.breadcrumbs,
+		contentWithHighlights: highlighter.highlight(hit.document.title),
+		id: hit.document.url,
+		url: hit.document.url
+	}));
+}
+
+//#endregion
+//#region src/search/orama/search/advanced.ts
+async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...override } = {}) {
+	if (typeof tag === "string") tag = [tag];
+	let params = {
+		...override,
+		mode,
+		where: removeUndefined({
+			tags: tag.length > 0 ? { containsAll: tag } : void 0,
+			...override.where
+		}),
+		groupBy: {
+			properties: ["page_id"],
+			maxResult: 8,
+			...override.groupBy
+		}
+	};
+	if (query.length > 0) params = {
+		...params,
+		term: query,
+		properties: mode === "fulltext" ? ["content"] : ["content", "embeddings"]
+	};
+	const highlighter = createContentHighlighter(query);
+	const result = await search(db, params);
+	const list = [];
+	for (const item of result.groups ?? []) {
+		const pageId = item.values[0];
+		const page = getByID(db, pageId);
+		if (!page) continue;
+		list.push({
+			id: pageId,
+			type: "page",
+			content: page.content,
+			breadcrumbs: page.breadcrumbs,
+			contentWithHighlights: highlighter.highlight(page.content),
+			url: page.url
+		});
+		for (const hit of item.result) {
+			if (hit.document.type === "page") continue;
+			list.push({
+				id: hit.document.id.toString(),
+				content: hit.document.content,
+				breadcrumbs: hit.document.breadcrumbs,
+				contentWithHighlights: highlighter.highlight(hit.document.content),
+				type: hit.document.type,
+				url: hit.document.url
+			});
+		}
+	}
+	return list;
+}
+
+//#endregion
+export { searchSimple as n, searchAdvanced as t };
+//# sourceMappingURL=advanced-BRT5Ij43.js.map

package/dist/advanced-BRT5Ij43.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-BRT5Ij43.js","names":["list: SortedResult[]"],"sources":["../src/search/orama/search/simple.ts","../src/search/orama/search/advanced.ts"],"sourcesContent":["import { type Orama, search, type SearchParams } from '@orama/orama';\nimport { type SimpleDocument, type simpleSchema } from '@/search/orama/create-db';\nimport { createContentHighlighter, type SortedResult } from '@/search';\n\nexport async function searchSimple(\n  db: Orama<typeof simpleSchema>,\n  query: string,\n  params: Partial<SearchParams<Orama<typeof simpleSchema>, SimpleDocument>> = {},\n): Promise<SortedResult[]> {\n  const highlighter = createContentHighlighter(query);\n  const result = await search(db, {\n    term: query,\n    tolerance: 1,\n    ...params,\n    boost: {\n      title: 2,\n      ...('boost' in params ? params.boost : undefined),\n    },\n  });\n\n  return result.hits.map<SortedResult>((hit) => ({\n    type: 'page',\n    content: hit.document.title,\n    breadcrumbs: hit.document.breadcrumbs,\n    contentWithHighlights: highlighter.highlight(hit.document.title),\n    id: hit.document.url,\n    url: hit.document.url,\n  }));\n}\n","import { getByID, type Orama, search, type SearchParams } from '@orama/orama';\nimport { type AdvancedDocument, type advancedSchema } from '@/search/orama/create-db';\nimport { removeUndefined } from '@/utils/remove-undefined';\nimport { createContentHighlighter, type SortedResult } from '@/search';\n\nexport async function searchAdvanced(\n  db: Orama<typeof advancedSchema>,\n  query: string,\n  tag: string | string[] = [],\n  {\n    mode = 'fulltext',\n    ...override\n  }: Partial<SearchParams<Orama<typeof advancedSchema>, AdvancedDocument>> = {},\n): Promise<SortedResult[]> {\n  if (typeof tag === 'string') tag = [tag];\n\n  let params = {\n    ...override,\n    mode,\n    where: removeUndefined({\n      tags:\n        tag.length > 0\n          ? {\n              containsAll: tag,\n            }\n          : undefined,\n      ...override.where,\n    }),\n    groupBy: {\n      properties: ['page_id'],\n      maxResult: 8,\n      ...override.groupBy,\n    },\n  } as SearchParams<typeof db, AdvancedDocument>;\n\n  if (query.length > 0) {\n    params = {\n      ...params,\n      term: query,\n      properties: mode === 'fulltext' ? ['content'] : ['content', 'embeddings'],\n    } as SearchParams<typeof db, AdvancedDocument>;\n  }\n\n  const highlighter = createContentHighlighter(query);\n  const result = await search(db, params);\n  const list: SortedResult[] = [];\n  for (const item of result.groups ?? []) {\n    const pageId = item.values[0] as string;\n\n    const page = getByID(db, pageId);\n    if (!page) continue;\n\n    list.push({\n      id: pageId,\n      type: 'page',\n      content: page.content,\n      breadcrumbs: page.breadcrumbs,\n      contentWithHighlights: highlighter.highlight(page.content),\n      url: page.url,\n    });\n\n    for (const hit of item.result) {\n      if (hit.document.type === 'page') continue;\n\n      list.push({\n        id: hit.document.id.toString(),\n        content: hit.document.content,\n        breadcrumbs: hit.document.breadcrumbs,\n        contentWithHighlights: highlighter.highlight(hit.document.content),\n        type: hit.document.type as SortedResult['type'],\n        url: hit.document.url,\n      });\n    }\n  }\n  return list;\n}\n"],"mappings":";;;;;AAIA,eAAsB,aACpB,IACA,OACA,SAA4E,EAAE,EACrD;CACzB,MAAM,cAAc,yBAAyB,MAAM;AAWnD,SAVe,MAAM,OAAO,IAAI;EAC9B,MAAM;EACN,WAAW;EACX,GAAG;EACH,OAAO;GACL,OAAO;GACP,GAAI,WAAW,SAAS,OAAO,QAAQ;GACxC;EACF,CAAC,EAEY,KAAK,KAAmB,SAAS;EAC7C,MAAM;EACN,SAAS,IAAI,SAAS;EACtB,aAAa,IAAI,SAAS;EAC1B,uBAAuB,YAAY,UAAU,IAAI,SAAS,MAAM;EAChE,IAAI,IAAI,SAAS;EACjB,KAAK,IAAI,SAAS;EACnB,EAAE;;;;;ACtBL,eAAsB,eACpB,IACA,OACA,MAAyB,EAAE,EAC3B,EACE,OAAO,YACP,GAAG,aACsE,EAAE,EACpD;AACzB,KAAI,OAAO,QAAQ,SAAU,OAAM,CAAC,IAAI;CAExC,IAAI,SAAS;EACX,GAAG;EACH;EACA,OAAO,gBAAgB;GACrB,MACE,IAAI,SAAS,IACT,EACE,aAAa,KACd,GACD;GACN,GAAG,SAAS;GACb,CAAC;EACF,SAAS;GACP,YAAY,CAAC,UAAU;GACvB,WAAW;GACX,GAAG,SAAS;GACb;EACF;AAED,KAAI,MAAM,SAAS,EACjB,UAAS;EACP,GAAG;EACH,MAAM;EACN,YAAY,SAAS,aAAa,CAAC,UAAU,GAAG,CAAC,WAAW,aAAa;EAC1E;CAGH,MAAM,cAAc,yBAAyB,MAAM;CACnD,MAAM,SAAS,MAAM,OAAO,IAAI,OAAO;CACvC,MAAMA,OAAuB,EAAE;AAC/B,MAAK,MAAM,QAAQ,OAAO,UAAU,EAAE,EAAE;EACtC,MAAM,SAAS,KAAK,OAAO;EAE3B,MAAM,OAAO,QAAQ,IAAI,OAAO;AAChC,MAAI,CAAC,KAAM;AAEX,OAAK,KAAK;GACR,IAAI;GACJ,MAAM;GACN,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,uBAAuB,YAAY,UAAU,KAAK,QAAQ;GAC1D,KAAK,KAAK;GACX,CAAC;AAEF,OAAK,MAAM,OAAO,KAAK,QAAQ;AAC7B,OAAI,IAAI,SAAS,SAAS,OAAQ;AAElC,QAAK,KAAK;IACR,IAAI,IAAI,SAAS,GAAG,UAAU;IAC9B,SAAS,IAAI,SAAS;IACtB,aAAa,IAAI,SAAS;IAC1B,uBAAuB,YAAY,UAAU,IAAI,SAAS,QAAQ;IAClE,MAAM,IAAI,SAAS;IACnB,KAAK,IAAI,SAAS;IACnB,CAAC;;;AAGN,QAAO"}

package/dist/algolia-CBBN8R6-.d.ts

@@ -0,0 +1,68 @@
+import { n as StructuredData } from "./remark-structure-RZD2gGKp.js";
+import { Algoliasearch } from "algoliasearch";
+
+//#region src/search/algolia.d.ts
+interface DocumentRecord {
+  /**
+   * The ID of document, must be unique
+   */
+  _id: string;
+  title: string;
+  description?: string;
+  breadcrumbs?: string[];
+  /**
+   * URL to the page
+   */
+  url: string;
+  structured: StructuredData;
+  /**
+   * Tag to filter results
+   */
+  tag?: string;
+  /**
+   * Data to be added to each section index
+   */
+  extra_data?: object;
+}
+interface SyncOptions {
+  /**
+   * Index Name for documents.
+   */
+  indexName?: string;
+  /**
+   * Search indexes
+   */
+  documents: DocumentRecord[];
+}
+/**
+ * Update index settings and replace all objects
+ *
+ * @param client - Algolia Admin Client
+ * @param options - Index Options
+ */
+declare function sync(client: Algoliasearch, options: SyncOptions): Promise<void>;
+declare function setIndexSettings(client: Algoliasearch, indexName: string): Promise<void>;
+declare function updateDocuments(client: Algoliasearch, indexName: string, documents: DocumentRecord[]): Promise<void>;
+interface BaseIndex {
+  objectID: string;
+  title: string;
+  url: string;
+  tag?: string;
+  /**
+   * The id of page, used for distinct
+   */
+  page_id: string;
+  /**
+   * Heading content
+   */
+  section?: string;
+  /**
+   * Heading (anchor) id
+   */
+  section_id?: string;
+  breadcrumbs?: string[];
+  content: string;
+}
+//#endregion
+export { sync as a, setIndexSettings as i, DocumentRecord as n, updateDocuments as o, SyncOptions as r, BaseIndex as t };
+//# sourceMappingURL=algolia-CBBN8R6-.d.ts.map

package/dist/algolia-CBBN8R6-.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"algolia-CBBN8R6-.d.ts","names":[],"sources":["../src/search/algolia.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,cAAA;;AAAjB;AA2BA;EAkBsB,GAAA,EAAA,MAAI;EAAS,KAAA,EAAA,MAAA;EAAwB,WAAA,CAAA,EAAA,MAAA;EAAc,WAAA,CAAA,EAAA,MAAA,EAAA;EAAO;AAMhF;AAyDA;EACU,GAAA,EAAA,MAAA;EAEG,UAAA,EAjGC,cAiGD;EACV;;AASH;;;;;;;UA9FiB,WAAA;;;;;;;;aASJ;;;;;;;;iBASS,IAAA,SAAa,wBAAwB,cAAc;iBAMnD,gBAAA,SAAyB,mCAAmC;iBAyD5D,eAAA,SACZ,6CAEG,mBACV;UASc,SAAA"}

package/dist/algolia-CQPXCnjV.js

@@ -0,0 +1,49 @@
+import { t as createContentHighlighter } from "./search-D6ChCLhY.js";
+
+//#region src/search/client/algolia.ts
+function groupResults(hits) {
+	const grouped = [];
+	const scannedUrls = /* @__PURE__ */ new Set();
+	for (const hit of hits) {
+		if (!scannedUrls.has(hit.url)) {
+			scannedUrls.add(hit.url);
+			grouped.push({
+				id: hit.url,
+				type: "page",
+				breadcrumbs: hit.breadcrumbs,
+				url: hit.url,
+				content: hit.title
+			});
+		}
+		grouped.push({
+			id: hit.objectID,
+			type: hit.content === hit.section ? "heading" : "text",
+			url: hit.section_id ? `${hit.url}#${hit.section_id}` : hit.url,
+			content: hit.content
+		});
+	}
+	return grouped;
+}
+async function searchDocs(query, { indexName, onSearch, client, locale, tag }) {
+	if (query.trim().length === 0) return [];
+	const result = onSearch ? await onSearch(query, tag, locale) : await client.searchForHits({ requests: [{
+		type: "default",
+		indexName,
+		query,
+		distinct: 5,
+		hitsPerPage: 10,
+		filters: tag ? `tag:${tag}` : void 0
+	}] });
+	const highlighter = createContentHighlighter(query);
+	return groupResults(result.results[0].hits).flatMap((hit) => {
+		if (hit.type === "page") return {
+			...hit,
+			contentWithHighlights: hit.contentWithHighlights ?? highlighter.highlight(hit.content)
+		};
+		return [];
+	});
+}
+
+//#endregion
+export { searchDocs };
+//# sourceMappingURL=algolia-CQPXCnjV.js.map

package/dist/algolia-CQPXCnjV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algolia-CQPXCnjV.js","names":["grouped: SortedResult[]"],"sources":["../src/search/client/algolia.ts"],"sourcesContent":["import type { BaseIndex } from '@/search/algolia';\nimport type { Hit, LiteClient, SearchResponse } from 'algoliasearch/lite';\nimport { createContentHighlighter, type SortedResult } from '@/search';\n\nexport interface AlgoliaOptions {\n  indexName: string;\n  client: LiteClient;\n\n  /**\n   * Filter results with specific tag.\n   */\n  tag?: string;\n\n  locale?: string;\n\n  onSearch?: (\n    query: string,\n    tag?: string,\n    locale?: string,\n  ) => Promise<{\n    results: SearchResponse<BaseIndex>[];\n  }>;\n}\n\nexport function groupResults(hits: Hit<BaseIndex>[]): SortedResult[] {\n  const grouped: SortedResult[] = [];\n  const scannedUrls = new Set<string>();\n\n  for (const hit of hits) {\n    if (!scannedUrls.has(hit.url)) {\n      scannedUrls.add(hit.url);\n\n      grouped.push({\n        id: hit.url,\n        type: 'page',\n        breadcrumbs: hit.breadcrumbs,\n        url: hit.url,\n        content: hit.title,\n      });\n    }\n\n    grouped.push({\n      id: hit.objectID,\n      type: hit.content === hit.section ? 'heading' : 'text',\n      url: hit.section_id ? `${hit.url}#${hit.section_id}` : hit.url,\n      content: hit.content,\n    });\n  }\n\n  return grouped;\n}\n\nexport async function searchDocs(\n  query: string,\n  { indexName, onSearch, client, locale, tag }: AlgoliaOptions,\n): Promise<SortedResult[]> {\n  if (query.trim().length === 0) return [];\n\n  const result = onSearch\n    ? await onSearch(query, tag, locale)\n    : await client.searchForHits<BaseIndex>({\n        requests: [\n          {\n            type: 'default',\n            indexName,\n            query,\n            distinct: 5,\n            hitsPerPage: 10,\n            filters: tag ? `tag:${tag}` : undefined,\n          },\n        ],\n      });\n\n  const highlighter = createContentHighlighter(query);\n  return groupResults(result.results[0].hits).flatMap((hit) => {\n    if (hit.type === 'page') {\n      return {\n        ...hit,\n        contentWithHighlights: hit.contentWithHighlights ?? highlighter.highlight(hit.content),\n      };\n    }\n\n    return [];\n  });\n}\n"],"mappings":";;;AAwBA,SAAgB,aAAa,MAAwC;CACnE,MAAMA,UAA0B,EAAE;CAClC,MAAM,8BAAc,IAAI,KAAa;AAErC,MAAK,MAAM,OAAO,MAAM;AACtB,MAAI,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE;AAC7B,eAAY,IAAI,IAAI,IAAI;AAExB,WAAQ,KAAK;IACX,IAAI,IAAI;IACR,MAAM;IACN,aAAa,IAAI;IACjB,KAAK,IAAI;IACT,SAAS,IAAI;IACd,CAAC;;AAGJ,UAAQ,KAAK;GACX,IAAI,IAAI;GACR,MAAM,IAAI,YAAY,IAAI,UAAU,YAAY;GAChD,KAAK,IAAI,aAAa,GAAG,IAAI,IAAI,GAAG,IAAI,eAAe,IAAI;GAC3D,SAAS,IAAI;GACd,CAAC;;AAGJ,QAAO;;AAGT,eAAsB,WACpB,OACA,EAAE,WAAW,UAAU,QAAQ,QAAQ,OACd;AACzB,KAAI,MAAM,MAAM,CAAC,WAAW,EAAG,QAAO,EAAE;CAExC,MAAM,SAAS,WACX,MAAM,SAAS,OAAO,KAAK,OAAO,GAClC,MAAM,OAAO,cAAyB,EACpC,UAAU,CACR;EACE,MAAM;EACN;EACA;EACA,UAAU;EACV,aAAa;EACb,SAAS,MAAM,OAAO,QAAQ;EAC/B,CACF,EACF,CAAC;CAEN,MAAM,cAAc,yBAAyB,MAAM;AACnD,QAAO,aAAa,OAAO,QAAQ,GAAG,KAAK,CAAC,SAAS,QAAQ;AAC3D,MAAI,IAAI,SAAS,OACf,QAAO;GACL,GAAG;GACH,uBAAuB,IAAI,yBAAyB,YAAY,UAAU,IAAI,QAAQ;GACvF;AAGH,SAAO,EAAE;GACT"}

package/dist/breadcrumb.d.ts

@@ -1,32 +1,35 @@
-import { ReactNode } from 'react';
-import { R as Root, N as Node } from './page-tree-BG3wP0gU.js';
+import { i as Root, r as Node } from "./definitions-DuxDer_c.js";
+import { ReactNode } from "react";
 
+//#region src/breadcrumb.d.ts
 interface BreadcrumbItem {
-    name: ReactNode;
-    url?: string;
+  name: ReactNode;
+  url?: string;
 }
 interface BreadcrumbOptions {
+  /**
+   * Include the root folders in the breadcrumb items array.
+   *
+   * @defaultValue false
+   */
+  includeRoot?: boolean | {
     /**
-     * Include the root itself in the breadcrumb items array.
-     * Specify the url by passing an object instead
-     *
-     * @defaultValue false
+     * Specify the url of root
      */
-    includeRoot?: boolean | {
-        url: string;
-    };
-    /**
-     * Include the page itself in the breadcrumb items array
-     *
-     * @defaultValue true
-     */
-    includePage?: boolean;
-    /**
-     * Count separator as an item
-     *
-     * @defaultValue false
-     */
-    includeSeparator?: boolean;
+    url: string;
+  };
+  /**
+   * Include the page itself in the breadcrumb items array
+   *
+   * @defaultValue false
+   */
+  includePage?: boolean;
+  /**
+   * Count separator as an item
+   *
+   * @defaultValue false
+   */
+  includeSeparator?: boolean;
 }
 declare function useBreadcrumb(url: string, tree: Root, options?: BreadcrumbOptions): BreadcrumbItem[];
 declare function getBreadcrumbItems(url: string, tree: Root, options?: BreadcrumbOptions): BreadcrumbItem[];
@@ -37,8 +40,9 @@ declare function getBreadcrumbItemsFromPath(tree: Root, path: Node[], options: B
  * - When the page doesn't exist, return null
  *
  * @returns The path to the target node from root
- * @internal
+ * @internal Don't use this on your own
  */
 declare function searchPath(nodes: Node[], url: string): Node[] | null;
-
-export { type BreadcrumbItem, type BreadcrumbOptions, getBreadcrumbItems, getBreadcrumbItemsFromPath, searchPath, useBreadcrumb };
+//#endregion
+export { BreadcrumbItem, BreadcrumbOptions, getBreadcrumbItems, getBreadcrumbItemsFromPath, searchPath, useBreadcrumb };
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","names":[],"sources":["../src/breadcrumb.tsx"],"sourcesContent":[],"mappings":";;;;UAKiB,cAAA;QACT;EADS,GAAA,CAAA,EAAA,MAAA;AAKjB;AA8BgB,UA9BC,iBAAA,CA8BY;EAErB;;;;AAMR;EAEQ,WAAA,CAAA,EAAA,OAAA,GAAA;IACG;;;IAKK,GAAA,EAAA,MAAA;EACR,CAAA;EACA;;;;AAyDR;;;;;;;;;iBA3EgB,aAAA,oBAER,gBACI,oBACT;iBAIa,kBAAA,oBAER,gBACG,oBACR;iBAIa,0BAAA,OACR,YACA,iBACG,oBACR;;;;;;;;;iBAuDa,UAAA,QAAkB,sBAA+B"}

package/dist/breadcrumb.js

@@ -1,87 +1,64 @@
-import "./chunk-MLKGABMK.js";
-
-// src/breadcrumb.tsx
+import { t as normalizeUrl } from "./normalize-url-DP9-1I-S.js";
+import { r as findPath } from "./utils-DUvi2WkD.js";
 import { useMemo } from "react";
+
+//#region src/breadcrumb.tsx
 function useBreadcrumb(url, tree, options) {
-  return useMemo(
-    () => getBreadcrumbItems(url, tree, options),
-    [tree, url, options]
-  );
+	return useMemo(() => getBreadcrumbItems(url, tree, options), [
+		tree,
+		url,
+		options
+	]);
 }
 function getBreadcrumbItems(url, tree, options = {}) {
-  return getBreadcrumbItemsFromPath(
-    tree,
-    searchPath(tree.children, url) ?? [],
-    options
-  );
+	return getBreadcrumbItemsFromPath(tree, searchPath(tree.children, url) ?? [], options);
 }
 function getBreadcrumbItemsFromPath(tree, path, options) {
-  const { includePage = true, includeSeparator = false, includeRoot } = options;
-  let items = [];
-  path.forEach((item, i) => {
-    if (item.type === "separator" && includeSeparator) {
-      items.push({
-        name: item.name
-      });
-    }
-    if (item.type === "folder") {
-      const next = path.at(i + 1);
-      if (next && item.index === next) return;
-      if (item.root) {
-        items = [];
-        return;
-      }
-      items.push({
-        name: item.name,
-        url: item.index?.url
-      });
-    }
-    if (item.type === "page" && includePage) {
-      items.push({
-        name: item.name,
-        url: item.url
-      });
-    }
-  });
-  if (includeRoot) {
-    items.unshift({
-      name: tree.name,
-      url: typeof includeRoot === "object" ? includeRoot.url : void 0
-    });
-  }
-  return items;
+	const { includePage = false, includeSeparator = false, includeRoot = false } = options;
+	let items = [];
+	for (let i = 0; i < path.length; i++) {
+		const item = path[i];
+		switch (item.type) {
+			case "page":
+				if (includePage) items.push({
+					name: item.name,
+					url: item.url
+				});
+				break;
+			case "folder":
+				if (item.root && !includeRoot) {
+					items = [];
+					break;
+				}
+				if (i === path.length - 1 || item.index !== path[i + 1]) items.push({
+					name: item.name,
+					url: item.index?.url
+				});
+				break;
+			case "separator":
+				if (item.name && includeSeparator) items.push({ name: item.name });
+				break;
+		}
+	}
+	if (includeRoot) items.unshift({
+		name: tree.name,
+		url: typeof includeRoot === "object" ? includeRoot.url : void 0
+	});
+	return items;
 }
+/**
+* Search the path of a node in the tree by a specified url
+*
+* - When the page doesn't exist, return null
+*
+* @returns The path to the target node from root
+* @internal Don't use this on your own
+*/
 function searchPath(nodes, url) {
-  if (url.endsWith("/")) url = url.slice(0, -1);
-  let separator;
-  for (const node of nodes) {
-    if (node.type === "separator") separator = node;
-    if (node.type === "folder") {
-      if (node.index?.url === url) {
-        const items2 = [];
-        if (separator) items2.push(separator);
-        items2.push(node, node.index);
-        return items2;
-      }
-      const items = searchPath(node.children, url);
-      if (items) {
-        items.unshift(node);
-        if (separator) items.unshift(separator);
-        return items;
-      }
-    }
-    if (node.type === "page" && node.url === url) {
-      const items = [];
-      if (separator) items.push(separator);
-      items.push(node);
-      return items;
-    }
-  }
-  return null;
+	const normalizedUrl = normalizeUrl(url);
+	return findPath(nodes, (node) => node.type === "page" && node.url === normalizedUrl);
 }
-export {
-  getBreadcrumbItems,
-  getBreadcrumbItemsFromPath,
-  searchPath,
-  useBreadcrumb
-};
+
+//#endregion
+export { getBreadcrumbItems, getBreadcrumbItemsFromPath, searchPath, useBreadcrumb };
+//# sourceMappingURL=breadcrumb.js.map

package/dist/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","names":["items: BreadcrumbItem[]"],"sources":["../src/breadcrumb.tsx"],"sourcesContent":["import { type ReactNode, useMemo } from 'react';\nimport type * as PageTree from '@/page-tree/definitions';\nimport { normalizeUrl } from '@/utils/normalize-url';\nimport { findPath } from '@/page-tree/utils';\n\nexport interface BreadcrumbItem {\n  name: ReactNode;\n  url?: string;\n}\n\nexport interface BreadcrumbOptions {\n  /**\n   * Include the root folders in the breadcrumb items array.\n   *\n   * @defaultValue false\n   */\n  includeRoot?:\n    | boolean\n    | {\n        /**\n         * Specify the url of root\n         */\n        url: string;\n      };\n\n  /**\n   * Include the page itself in the breadcrumb items array\n   *\n   * @defaultValue false\n   */\n  includePage?: boolean;\n\n  /**\n   * Count separator as an item\n   *\n   * @defaultValue false\n   */\n  includeSeparator?: boolean;\n}\n\nexport function useBreadcrumb(\n  url: string,\n  tree: PageTree.Root,\n  options?: BreadcrumbOptions,\n): BreadcrumbItem[] {\n  return useMemo(() => getBreadcrumbItems(url, tree, options), [tree, url, options]);\n}\n\nexport function getBreadcrumbItems(\n  url: string,\n  tree: PageTree.Root,\n  options: BreadcrumbOptions = {},\n): BreadcrumbItem[] {\n  return getBreadcrumbItemsFromPath(tree, searchPath(tree.children, url) ?? [], options);\n}\n\nexport function getBreadcrumbItemsFromPath(\n  tree: PageTree.Root,\n  path: PageTree.Node[],\n  options: BreadcrumbOptions,\n): BreadcrumbItem[] {\n  const { includePage = false, includeSeparator = false, includeRoot = false } = options;\n  let items: BreadcrumbItem[] = [];\n  for (let i = 0; i < path.length; i++) {\n    const item = path[i];\n\n    switch (item.type) {\n      case 'page':\n        if (includePage)\n          items.push({\n            name: item.name,\n            url: item.url,\n          });\n        break;\n      case 'folder':\n        if (item.root && !includeRoot) {\n          items = [];\n          break;\n        }\n\n        // only show the index node of folders if possible\n        if (i === path.length - 1 || item.index !== path[i + 1]) {\n          items.push({\n            name: item.name,\n            url: item.index?.url,\n          });\n        }\n        break;\n      case 'separator':\n        if (item.name && includeSeparator)\n          items.push({\n            name: item.name,\n          });\n        break;\n    }\n  }\n\n  if (includeRoot) {\n    items.unshift({\n      name: tree.name,\n      url: typeof includeRoot === 'object' ? includeRoot.url : undefined,\n    });\n  }\n\n  return items;\n}\n\n/**\n * Search the path of a node in the tree by a specified url\n *\n * - When the page doesn't exist, return null\n *\n * @returns The path to the target node from root\n * @internal Don't use this on your own\n */\nexport function searchPath(nodes: PageTree.Node[], url: string): PageTree.Node[] | null {\n  const normalizedUrl = normalizeUrl(url);\n\n  return findPath(nodes, (node) => node.type === 'page' && node.url === normalizedUrl);\n}\n"],"mappings":";;;;;AAwCA,SAAgB,cACd,KACA,MACA,SACkB;AAClB,QAAO,cAAc,mBAAmB,KAAK,MAAM,QAAQ,EAAE;EAAC;EAAM;EAAK;EAAQ,CAAC;;AAGpF,SAAgB,mBACd,KACA,MACA,UAA6B,EAAE,EACb;AAClB,QAAO,2BAA2B,MAAM,WAAW,KAAK,UAAU,IAAI,IAAI,EAAE,EAAE,QAAQ;;AAGxF,SAAgB,2BACd,MACA,MACA,SACkB;CAClB,MAAM,EAAE,cAAc,OAAO,mBAAmB,OAAO,cAAc,UAAU;CAC/E,IAAIA,QAA0B,EAAE;AAChC,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,OAAO,KAAK;AAElB,UAAQ,KAAK,MAAb;GACE,KAAK;AACH,QAAI,YACF,OAAM,KAAK;KACT,MAAM,KAAK;KACX,KAAK,KAAK;KACX,CAAC;AACJ;GACF,KAAK;AACH,QAAI,KAAK,QAAQ,CAAC,aAAa;AAC7B,aAAQ,EAAE;AACV;;AAIF,QAAI,MAAM,KAAK,SAAS,KAAK,KAAK,UAAU,KAAK,IAAI,GACnD,OAAM,KAAK;KACT,MAAM,KAAK;KACX,KAAK,KAAK,OAAO;KAClB,CAAC;AAEJ;GACF,KAAK;AACH,QAAI,KAAK,QAAQ,iBACf,OAAM,KAAK,EACT,MAAM,KAAK,MACZ,CAAC;AACJ;;;AAIN,KAAI,YACF,OAAM,QAAQ;EACZ,MAAM,KAAK;EACX,KAAK,OAAO,gBAAgB,WAAW,YAAY,MAAM;EAC1D,CAAC;AAGJ,QAAO;;;;;;;;;;AAWT,SAAgB,WAAW,OAAwB,KAAqC;CACtF,MAAM,gBAAgB,aAAa,IAAI;AAEvC,QAAO,SAAS,QAAQ,SAAS,KAAK,SAAS,UAAU,KAAK,QAAQ,cAAc"}

package/dist/chunk-B-ezknvj.js

@@ -0,0 +1,42 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+export { __exportAll as n, __toESM as r, __commonJSMin as t };

package/dist/codeblock-utils-lld8UiQo.d.ts

@@ -0,0 +1,37 @@
+import { BlockContent, Text } from "mdast";
+import { MdxJsxAttribute, MdxJsxFlowElement } from "mdast-util-mdx-jsx";
+
+//#region src/mdx-plugins/codeblock-utils.d.ts
+interface CodeBlockTabsOptions {
+  attributes?: MdxJsxAttribute[];
+  defaultValue?: string;
+  persist?: {
+    id: string;
+  } | false;
+  triggers: {
+    value: string;
+    children: (BlockContent | Text)[];
+  }[];
+  tabs: {
+    value: string;
+    children: BlockContent[];
+  }[];
+}
+declare function generateCodeBlockTabs({
+  persist,
+  defaultValue,
+  triggers,
+  tabs,
+  ...options
+}: CodeBlockTabsOptions): MdxJsxFlowElement;
+interface CodeBlockAttributes<Name extends string = string> {
+  attributes: Partial<Record<Name, string | null>>;
+  rest: string;
+}
+/**
+ * Parse Fumadocs-style code block attributes from meta string, like `title="hello world"`
+ */
+declare function parseCodeBlockAttributes<Name extends string = string>(meta: string, allowedNames?: Name[]): CodeBlockAttributes<Name>;
+//#endregion
+export { parseCodeBlockAttributes as i, CodeBlockTabsOptions as n, generateCodeBlockTabs as r, CodeBlockAttributes as t };
+//# sourceMappingURL=codeblock-utils-lld8UiQo.d.ts.map

package/dist/codeblock-utils-lld8UiQo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeblock-utils-lld8UiQo.d.ts","names":[],"sources":["../src/mdx-plugins/codeblock-utils.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,oBAAA;eACF;EADE,YAAA,CAAA,EAAA,MAAA;EACF,OAAA,CAAA,EAAA;IASA,EAAA,EAAA,MAAA;EAAe,CAAA,GAAA,KAAA;EAIhB,QAAA,EAAA;IAAY,KAAA,EAAA,MAAA;IAIV,QAAA,EAAA,CARD,YAQsB,GARP,IAQO,CAAA,EAAA;EACnC,CAAA,EAAA;EACA,IAAA,EAAA;IACA,KAAA,EAAA,MAAA;IACA,QAAA,EARY,YAQZ,EAAA;EAEC,CAAA,EAAA;;AAAwC,iBAN3B,qBAAA,CAM2B;EAAA,OAAA;EAAA,YAAA;EAAA,QAAA;EAAA,IAAA;EAAA,GAAA;AAAA,CAAA,EAAxC,oBAAwC,CAAA,EAAjB,iBAAiB;AA6D1B,UAAA,mBAAmB,CAAA,aAAA,MAAA,GAAA,MAAA,CAAA,CAAA;EACP,UAAA,EAAf,OAAe,CAAP,MAAO,CAAA,IAAA,EAAA,MAAA,GAAA,IAAA,CAAA,CAAA;EAAP,IAAA,EAAA,MAAA;;;AAOtB;;AAGuB,iBAHP,wBAGO,CAAA,aAAA,MAAA,GAAA,MAAA,CAAA,CAAA,IAAA,EAAA,MAAA,EAAA,YAAA,CAAA,EADN,IACM,EAAA,CAAA,EAApB,mBAAoB,CAAA,IAAA,CAAA"}

package/dist/content/github.d.ts

@@ -0,0 +1,51 @@
+//#region src/content/github.d.ts
+interface GetGithubLastCommitOptions {
+  /**
+   * Repository name, like "fumadocs"
+   */
+  repo: string;
+  /** Owner of repository */
+  owner: string;
+  /**
+   * Path to file
+   */
+  path: string;
+  /**
+   * GitHub access token
+   */
+  token?: string;
+  /**
+   * SHA or ref (branch or tag) name.
+   */
+  sha?: string;
+  /**
+   * Base URL for GitHub API
+   * @default "https://api.github.com"
+   * @link https://docs.github.com/en/get-started/using-github-docs/about-versions-of-github-docs#determining-which-github-product-you-use
+   */
+  baseUrl?: string;
+  /**
+   * Custom query parameters
+   */
+  params?: Record<string, string>;
+  options?: RequestInit;
+}
+/**
+ * Get the last edit time of a file using GitHub API
+ *
+ * By default, this will cache the result forever.
+ * Set `options.next.revalidate` to customise this.
+ */
+declare function getGithubLastEdit({
+  repo,
+  token,
+  owner,
+  path,
+  sha,
+  baseUrl,
+  options,
+  params: customParams
+}: GetGithubLastCommitOptions): Promise<Date | null>;
+//#endregion
+export { GetGithubLastCommitOptions, getGithubLastEdit };
+//# sourceMappingURL=github.d.ts.map

package/dist/content/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","names":[],"sources":["../../src/content/github.ts"],"sourcesContent":[],"mappings":";UAQiB,0BAAA;EAAA;AA6CjB;;EAEE,IAAA,EAAA,MAAA;EACA;EACA,KAAA,EAAA,MAAA;EACA;;;EAGQ,IAAA,EAAA,MAAA;EACP;;;EAAoC,KAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;;WApB5B;YAEC;;;;;;;;iBASU,iBAAA;;;;;;;;UAQZ;GACP,6BAA6B,QAAQ"}

package/dist/content/github.js

@@ -0,0 +1,30 @@
+//#region src/content/github.ts
+/**
+* Get the last edit time of a file using GitHub API
+*
+* By default, this will cache the result forever.
+* Set `options.next.revalidate` to customise this.
+*/
+async function getGithubLastEdit({ repo, token, owner, path, sha, baseUrl = "https://api.github.com", options = {}, params: customParams = {} }) {
+	const headers = new Headers(options.headers);
+	const params = new URLSearchParams();
+	params.set("path", path);
+	params.set("page", "1");
+	params.set("per_page", "1");
+	if (sha) params.set("sha", sha);
+	for (const [key, value] of Object.entries(customParams)) params.set(key, value);
+	if (token) headers.append("authorization", token);
+	const res = await fetch(`${baseUrl}/repos/${owner}/${repo}/commits?${params.toString()}`, {
+		cache: "force-cache",
+		...options,
+		headers
+	});
+	if (!res.ok) throw new Error(`Failed to fetch last edit time from Git ${await res.text()}`);
+	const data = await res.json();
+	if (data.length === 0) return null;
+	return new Date(data[0].commit.committer.date);
+}
+
+//#endregion
+export { getGithubLastEdit };
+//# sourceMappingURL=github.js.map

package/dist/content/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","names":[],"sources":["../../src/content/github.ts"],"sourcesContent":["type Response = {\n  commit: {\n    committer: {\n      date: string;\n    };\n  };\n}[];\n\nexport interface GetGithubLastCommitOptions {\n  /**\n   * Repository name, like \"fumadocs\"\n   */\n  repo: string;\n\n  /** Owner of repository */\n  owner: string;\n\n  /**\n   * Path to file\n   */\n  path: string;\n\n  /**\n   * GitHub access token\n   */\n  token?: string;\n\n  /**\n   * SHA or ref (branch or tag) name.\n   */\n  sha?: string;\n\n  /**\n   * Base URL for GitHub API\n   * @default \"https://api.github.com\"\n   * @link https://docs.github.com/en/get-started/using-github-docs/about-versions-of-github-docs#determining-which-github-product-you-use\n   */\n  baseUrl?: string;\n\n  /**\n   * Custom query parameters\n   */\n  params?: Record<string, string>;\n\n  options?: RequestInit;\n}\n\n/**\n * Get the last edit time of a file using GitHub API\n *\n * By default, this will cache the result forever.\n * Set `options.next.revalidate` to customise this.\n */\nexport async function getGithubLastEdit({\n  repo,\n  token,\n  owner,\n  path,\n  sha,\n  baseUrl = 'https://api.github.com',\n  options = {},\n  params: customParams = {},\n}: GetGithubLastCommitOptions): Promise<Date | null> {\n  const headers = new Headers(options.headers);\n  const params = new URLSearchParams();\n  params.set('path', path);\n  params.set('page', '1');\n  params.set('per_page', '1');\n\n  if (sha) params.set('sha', sha);\n\n  for (const [key, value] of Object.entries(customParams)) {\n    params.set(key, value);\n  }\n\n  if (token) {\n    headers.append('authorization', token);\n  }\n\n  const res = await fetch(`${baseUrl}/repos/${owner}/${repo}/commits?${params.toString()}`, {\n    cache: 'force-cache',\n    ...options,\n    headers,\n  });\n\n  if (!res.ok) throw new Error(`Failed to fetch last edit time from Git ${await res.text()}`);\n  const data = (await res.json()) as Response;\n\n  if (data.length === 0) return null;\n  return new Date(data[0].commit.committer.date);\n}\n"],"mappings":";;;;;;;AAqDA,eAAsB,kBAAkB,EACtC,MACA,OACA,OACA,MACA,KACA,UAAU,0BACV,UAAU,EAAE,EACZ,QAAQ,eAAe,EAAE,IAC0B;CACnD,MAAM,UAAU,IAAI,QAAQ,QAAQ,QAAQ;CAC5C,MAAM,SAAS,IAAI,iBAAiB;AACpC,QAAO,IAAI,QAAQ,KAAK;AACxB,QAAO,IAAI,QAAQ,IAAI;AACvB,QAAO,IAAI,YAAY,IAAI;AAE3B,KAAI,IAAK,QAAO,IAAI,OAAO,IAAI;AAE/B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,QAAO,IAAI,KAAK,MAAM;AAGxB,KAAI,MACF,SAAQ,OAAO,iBAAiB,MAAM;CAGxC,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,SAAS,MAAM,GAAG,KAAK,WAAW,OAAO,UAAU,IAAI;EACxF,OAAO;EACP,GAAG;EACH;EACD,CAAC;AAEF,KAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,2CAA2C,MAAM,IAAI,MAAM,GAAG;CAC3F,MAAM,OAAQ,MAAM,IAAI,MAAM;AAE9B,KAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,QAAO,IAAI,KAAK,KAAK,GAAG,OAAO,UAAU,KAAK"}

package/dist/content/index.d.ts

@@ -0,0 +1,23 @@
+import * as react3 from "react";
+import { ReactNode } from "react";
+import { Components } from "hast-util-to-jsx-runtime";
+import { Compatible } from "vfile";
+import { PluggableList } from "unified";
+
+//#region src/content/index.d.ts
+interface MarkdownProps {
+  components?: Components;
+}
+declare function Markdown({
+  children: content,
+  remarkPlugins,
+  rehypePlugins,
+  ...options
+}: MarkdownProps & {
+  remarkPlugins?: PluggableList;
+  rehypePlugins?: PluggableList;
+  children: Compatible;
+}): Promise<react3.ReactElement<unknown, string | react3.JSXElementConstructor<any>> | Iterable<ReactNode> | (string | number | bigint | boolean | react3.ReactPortal | react3.ReactElement<unknown, string | react3.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined)>;
+//#endregion
+export { Markdown, MarkdownProps };
+//# sourceMappingURL=index.d.ts.map