fumadocs-core 16.6.9 → 16.6.10

package/dist/content/mdx/preset-bundler.d.ts

@@ -1,11 +1,9 @@
-import "../../transformer-icon-BtBormWx.js";
 import { RehypeCodeOptions } from "../../mdx-plugins/rehype-code.js";
 import { RemarkImageOptions } from "../../mdx-plugins/remark-image.js";
 import { StructureOptions } from "../../mdx-plugins/remark-structure.js";
 import { RemarkHeadingOptions } from "../../mdx-plugins/remark-heading.js";
 import { RemarkCodeTabOptions } from "../../mdx-plugins/remark-code-tab.js";
 import { RemarkNpmOptions } from "../../mdx-plugins/remark-npm.js";
-import "../../mdx-plugins/index.js";
 import { t as ResolvePlugins } from "../../util-DJ5AvEKK.js";
 import { ProcessorOptions } from "@mdx-js/mdx";
 

package/dist/content/mdx/preset-runtime.d.ts

@@ -1,11 +1,9 @@
-import "../../transformer-icon-BtBormWx.js";
 import { RehypeCodeOptions } from "../../mdx-plugins/rehype-code.js";
 import { RemarkImageOptions } from "../../mdx-plugins/remark-image.js";
 import { StructureOptions } from "../../mdx-plugins/remark-structure.js";
 import { RemarkHeadingOptions } from "../../mdx-plugins/remark-heading.js";
 import { RemarkCodeTabOptions } from "../../mdx-plugins/remark-code-tab.js";
 import { RemarkNpmOptions } from "../../mdx-plugins/remark-npm.js";
-import "../../mdx-plugins/index.js";
 import { t as ResolvePlugins } from "../../util-DJ5AvEKK.js";
 import { ProcessorOptions } from "@mdx-js/mdx";
 

package/dist/{create-i18n-7AVERQc8.d.ts → create-i18n-BakPYec9.d.ts}

@@ -1,6 +1,6 @@
 import { t as Awaitable } from "./types-BKxquRYN.js";
 import { I18nConfig } from "./i18n/index.js";
-import { i as LoaderConfig, o as LoaderOutput, u as Page } from "./path-B8CdvN3q.js";
+import { i as LoaderConfig, o as LoaderOutput, u as Page } from "./path-oEC3g6wP.js";
 import { AdvancedIndex, AdvancedOptions, Dynamic, Index, SearchAPI, SimpleOptions } from "./search/server.js";
 import { Language, Orama, TypedDocument } from "@orama/orama";
 

package/dist/{path-B8CdvN3q.d.ts → path-oEC3g6wP.d.ts}

@@ -128,15 +128,6 @@ interface ContentStoragePageFile<Config extends SourceConfig = SourceConfig> {
   slugs: string[];
   data: Config['pageData'];
 }
-/**
- * convert input files into virtual file system.
- *
- * in the storage, locale codes are removed from file paths, hence the same file will have same file paths in every storage.
- */
-declare function createContentStorageBuilder(loaderConfig: ResolvedLoaderConfig): {
-  i18n(): Record<string, ContentStorage>;
-  single(): ContentStorage;
-};
 //#endregion
 //#region src/source/page-tree/builder.d.ts
 interface PageTreeBuilderContext<Config extends SourceConfig = SourceConfig> {
@@ -213,6 +204,22 @@ declare class PageTreeBuilder {
 //#region src/source/plugins/icon.d.ts
 type IconResolver = (icon: string | undefined) => ReactNode;
 //#endregion
+//#region src/source/loader/llms.d.ts
+interface Context {
+  lang?: string;
+}
+interface LLMsConfig {
+  TAB?: string;
+  renderName?: (item: Node | Root, ctx: Context) => string;
+  renderDescription?: (item: Item | Folder, ctx: Context) => string;
+}
+declare function llms<C extends LoaderConfig>(loader: LoaderOutput<C>, config?: LLMsConfig): {
+  /**
+   * generate `llms.txt` content in Markdown format.
+   */
+  index: (lang?: string) => string;
+};
+//#endregion
 //#region src/source/loader.d.ts
 interface LoaderConfig {
   source: SourceConfig;
@@ -235,7 +242,7 @@ interface LoaderOptions<C extends LoaderConfig = LoaderConfig> {
 interface ResolvedLoaderConfig {
   source: Source;
   url: (slugs: string[], locale?: string) => string;
-  plugins?: LoaderPlugin[];
+  plugins: LoaderPlugin[];
   pageTree?: Partial<PageTreeOptions>;
   i18n?: I18nConfig | undefined;
 }
@@ -389,4 +396,4 @@ declare function splitPath(path: string): string[];
 declare function joinPath(...paths: string[]): string;
 declare function slash(path: string): string;
 //#endregion
-export { _SourceUpdate_ as A, FileSystem as C, SourceConfig as D, Source as E, source as M, update as N, VirtualFile as O, createContentStorageBuilder as S, PageData as T, PageTreeTransformer as _, LoaderOptions as a, ContentStorageMetaFile as b, LoaderPluginOption as c, ResolvedLoaderConfig as d, createGetUrl as f, PageTreeOptions as g, PageTreeBuilderContext as h, LoaderConfig as i, multiple as j, _ConfigUnion_ as k, Meta as l, PageTreeBuilder as m, InferMetaType as n, LoaderOutput as o, loader as p, InferPageType as r, LoaderPlugin as s, path_d_exports as t, Page as u, ContentStorage as v, MetaData as w, ContentStoragePageFile as x, ContentStorageFile as y };
+export { _ConfigUnion_ as A, ContentStoragePageFile as C, Source as D, PageData as E, multiple as M, source as N, SourceConfig as O, update as P, ContentStorageMetaFile as S, MetaData as T, PageTreeBuilderContext as _, LoaderOptions as a, ContentStorage as b, LoaderPluginOption as c, ResolvedLoaderConfig as d, createGetUrl as f, PageTreeBuilder as g, llms as h, LoaderConfig as i, _SourceUpdate_ as j, VirtualFile as k, Meta as l, LLMsConfig as m, InferMetaType as n, LoaderOutput as o, loader as p, InferPageType as r, LoaderPlugin as s, path_d_exports as t, Page as u, PageTreeOptions as v, FileSystem as w, ContentStorageFile as x, PageTreeTransformer as y };

package/dist/search/client.d.ts

@@ -1,10 +1,5 @@
-import "../definitions-VpSOvVeD.js";
-import "../utils-DWLhAKwM.js";
 import { BaseIndex } from "./algolia.js";
 import { SortedResult } from "./index.js";
-import "../create-i18n-7AVERQc8.js";
-import "../path-B8CdvN3q.js";
-import "./server.js";
 import { DependencyList } from "react";
 import { AnyOrama } from "@orama/orama";
 import { LiteClient, SearchResponse } from "algoliasearch/lite";

package/dist/search/mixedbread.d.ts

@@ -1,8 +1,4 @@
-import "../definitions-VpSOvVeD.js";
-import "../utils-DWLhAKwM.js";
 import { SortedResult } from "./index.js";
-import "../create-i18n-7AVERQc8.js";
-import "../path-B8CdvN3q.js";
 import { SearchAPI } from "./server.js";
 import Mixedbread from "@mixedbread/sdk";
 import { StoreSearchResponse } from "@mixedbread/sdk/resources/stores";

package/dist/search/orama-cloud-legacy.d.ts

@@ -1,6 +1,4 @@
-import "../transformer-icon-BtBormWx.js";
 import { StructuredData } from "../mdx-plugins/remark-structure.js";
-import "../mdx-plugins/index.js";
 import { CloudManager } from "@oramacloud/client";
 
 //#region src/search/orama-cloud-legacy.d.ts

package/dist/search/orama-cloud.d.ts

@@ -1,6 +1,4 @@
-import "../transformer-icon-BtBormWx.js";
 import { StructuredData } from "../mdx-plugins/remark-structure.js";
-import "../mdx-plugins/index.js";
 import { OramaCloud } from "@orama/core";
 
 //#region src/search/orama-cloud.d.ts

package/dist/search/server.d.ts

@@ -1,9 +1,6 @@
-import "../definitions-VpSOvVeD.js";
 import { StructuredData } from "../mdx-plugins/remark-structure.js";
-import "../utils-DWLhAKwM.js";
 import { HighlightedText, ReactSortedResult, SortedResult, createContentHighlighter } from "./index.js";
-import { a as advancedSchema, i as SimpleDocument, n as createFromSource, o as simpleSchema, r as AdvancedDocument, t as createI18nSearchAPI } from "../create-i18n-7AVERQc8.js";
-import "../path-B8CdvN3q.js";
+import { a as advancedSchema, i as SimpleDocument, n as createFromSource, o as simpleSchema, r as AdvancedDocument, t as createI18nSearchAPI } from "../create-i18n-BakPYec9.js";
 import { Orama, RawData, SearchParams, create } from "@orama/orama";
 
 //#region src/search/server.d.ts

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

@@ -1,7 +1,4 @@
 import { i as Root } from "../../definitions-VpSOvVeD.js";
-import "../../utils-DWLhAKwM.js";
-import "../../page-tree/index.js";
-
 //#region src/source/client/index.d.ts
 interface SerializedPageTree {
   $fumadocs_loader: 'page-tree';

package/dist/source/index.d.ts

@@ -1,5 +1,3 @@
-import "../definitions-VpSOvVeD.js";
-import "../utils-DWLhAKwM.js";
-import { A as _SourceUpdate_, C as FileSystem, D as SourceConfig, E as Source, M as source, N as update, O as VirtualFile, S as createContentStorageBuilder, T as PageData, _ as PageTreeTransformer, a as LoaderOptions, b as ContentStorageMetaFile, c as LoaderPluginOption, d as ResolvedLoaderConfig, f as createGetUrl, g as PageTreeOptions, h as PageTreeBuilderContext, i as LoaderConfig, j as multiple, k as _ConfigUnion_, l as Meta, m as PageTreeBuilder, n as InferMetaType, o as LoaderOutput, p as loader, r as InferPageType, s as LoaderPlugin, t as path_d_exports, u as Page, v as ContentStorage, w as MetaData, x as ContentStoragePageFile, y as ContentStorageFile } from "../path-B8CdvN3q.js";
+import { A as _ConfigUnion_, C as ContentStoragePageFile, D as Source, E as PageData, M as multiple, N as source, O as SourceConfig, P as update, S as ContentStorageMetaFile, T as MetaData, _ as PageTreeBuilderContext, a as LoaderOptions, b as ContentStorage, c as LoaderPluginOption, d as ResolvedLoaderConfig, f as createGetUrl, g as PageTreeBuilder, h as llms, i as LoaderConfig, j as _SourceUpdate_, k as VirtualFile, l as Meta, m as LLMsConfig, n as InferMetaType, o as LoaderOutput, p as loader, r as InferPageType, s as LoaderPlugin, t as path_d_exports, u as Page, v as PageTreeOptions, w as FileSystem, x as ContentStorageFile, y as PageTreeTransformer } from "../path-oEC3g6wP.js";
 import { getSlugs } from "./plugins/slugs.js";
-export { ContentStorage, ContentStorageFile, ContentStorageMetaFile, ContentStoragePageFile, FileSystem, InferMetaType, InferPageType, LoaderConfig, LoaderOptions, LoaderOutput, LoaderPlugin, LoaderPluginOption, Meta, MetaData, Page, PageData, type PageTreeBuilder, type PageTreeBuilderContext, type PageTreeOptions, type PageTreeTransformer, path_d_exports as PathUtils, ResolvedLoaderConfig, Source, SourceConfig, VirtualFile, _ConfigUnion_, _SourceUpdate_, createContentStorageBuilder, createGetUrl, getSlugs, loader, multiple, source, update };
+export { type ContentStorage, type ContentStorageFile, type ContentStorageMetaFile, type ContentStoragePageFile, FileSystem, InferMetaType, InferPageType, LLMsConfig, LoaderConfig, LoaderOptions, LoaderOutput, LoaderPlugin, LoaderPluginOption, Meta, MetaData, Page, PageData, type PageTreeBuilder, type PageTreeBuilderContext, type PageTreeOptions, type PageTreeTransformer, path_d_exports as PathUtils, ResolvedLoaderConfig, Source, SourceConfig, VirtualFile, _ConfigUnion_, _SourceUpdate_, createGetUrl, getSlugs, llms, loader, multiple, source, update };

package/dist/source/index.js

@@ -101,12 +101,13 @@ var FileSystem = class {
 		return Array.from(this.files.keys());
 	}
 	makeDir(path) {
-		const segments = splitPath(path);
-		for (let i = 0; i < segments.length; i++) {
-			const segment = segments.slice(0, i + 1).join("/");
-			if (this.folders.has(segment)) continue;
-			this.folders.set(segment, []);
-			this.folders.get(dirname(segment)).push(segment);
+		const cur = [];
+		for (const seg of splitPath(path)) {
+			cur.push(seg);
+			const curPath = cur.join("/");
+			if (this.folders.has(curPath)) continue;
+			this.folders.set(curPath, []);
+			this.folders.get(dirname(curPath)).push(curPath);
 		}
 	}
 };
@@ -141,7 +142,7 @@ const EmptyLang = Symbol();
 * in the storage, locale codes are removed from file paths, hence the same file will have same file paths in every storage.
 */
 function createContentStorageBuilder(loaderConfig) {
-	const { source, plugins = [], i18n } = loaderConfig;
+	const { source, plugins, i18n } = loaderConfig;
 	const parser = i18n ? parsers[i18n.parser ?? "dot"] : parsers.none;
 	const normalized = /* @__PURE__ */ new Map();
 	for (const inputFile of source.files) {
@@ -160,12 +161,15 @@ function createContentStorageBuilder(loaderConfig) {
 			data: inputFile.data
 		};
 		const [pathWithoutLocale, locale = i18n ? i18n.defaultLanguage : EmptyLang] = parser(file.path);
-		const list = normalized.get(locale) ?? [];
+		let list = normalized.get(locale);
+		if (!list) {
+			list = [];
+			normalized.set(locale, list);
+		}
 		list.push({
 			pathWithoutLocale,
 			file
 		});
-		normalized.set(locale, list);
 	}
 	function makeStorage(locale, inherit) {
 		const storage = new FileSystem(inherit);
@@ -523,6 +527,65 @@ function pathToName(name) {
 	return result.join("");
 }
 
+//#endregion
+//#region src/source/loader/llms.ts
+function llms(loader, config = {}) {
+	const { TAB = "  ", renderName = (node, ctx) => {
+		if (typeof node.name === "string") return node.name;
+		if ("type" in node && node.type === "page") {
+			const page = loader.getNodePage(node, ctx.lang);
+			if (page) return page.data.title ?? "";
+		}
+		return String(node.name);
+	}, renderDescription = (node, ctx) => {
+		if (typeof node.description === "string") return node.description;
+		if ("type" in node && node.type === "page") {
+			const page = loader.getNodePage(node, ctx.lang);
+			if (page) return page.data.description ?? "";
+		}
+		return String(node.description);
+	} } = config;
+	function index(lang) {
+		if (loader._i18n && lang === void 0) {
+			const { languages } = loader._i18n;
+			return languages.map(index).join("\n\n");
+		}
+		const pageTree = loader.getPageTree(lang);
+		const out = [];
+		const ctx = { lang };
+		out.push(`# ${renderName(pageTree, ctx)}`);
+		out.push("");
+		function item(name, description, indent) {
+			const prefix = TAB.repeat(indent);
+			description = description.trim();
+			if (description.length > 0) return `${prefix}- ${name}: ${description}`;
+			return `${prefix}- ${name}`;
+		}
+		function onNode(node, indent) {
+			switch (node.type) {
+				case "page":
+					out.push(item(formatMarkdownLink(renderName(node, ctx), node.url), renderDescription(node, ctx), indent));
+					break;
+				case "folder":
+					out.push(item(renderName(node, ctx), renderDescription(node, ctx), indent));
+					if (node.index) onNode(node.index, indent + 1);
+					for (const child of node.children) onNode(child, indent + 1);
+					break;
+				case "separator":
+					if (node.name) out.push(item(`**${renderName(node, ctx)}**`, "", indent));
+					out.push("");
+					break;
+			}
+		}
+		for (const child of pageTree.children) onNode(child, 0);
+		return out.join("\n");
+	}
+	return { index };
+}
+function formatMarkdownLink(title, url) {
+	return `[${title.replace(/([[\]])/g, "\\$1")}](${url.replace(/([()])/g, "\\$1")})`;
+}
+
 //#endregion
 //#region src/source/loader.ts
 function createPageIndexer({ url }) {
@@ -596,7 +659,7 @@ function loader(...args) {
 	let pageTrees;
 	function getPageTrees() {
 		if (pageTrees) return pageTrees;
-		const { plugins = [], url, pageTree: pageTreeConfig } = loaderConfig;
+		const { plugins, url, pageTree: pageTreeConfig } = loaderConfig;
 		const transformers = [];
 		if (pageTreeConfig?.transformers) transformers.push(...pageTreeConfig.transformers);
 		for (const plugin of plugins) if (plugin.transformPageTree) transformers.push(plugin.transformPageTree);
@@ -708,7 +771,7 @@ function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...bas
 			slugsPlugin(slugs)
 		])
 	};
-	for (const plugin of config.plugins ?? []) {
+	for (const plugin of config.plugins) {
 		const result = plugin.config?.(config);
 		if (result) config = result;
 	}
@@ -728,4 +791,4 @@ function buildPlugins(plugins, sort = true) {
 }
 
 //#endregion
-export { FileSystem, path_exports as PathUtils, createGetUrl, getSlugs, loader, multiple, source, update };
+export { FileSystem, path_exports as PathUtils, createGetUrl, getSlugs, llms, loader, multiple, source, update };

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

@@ -1,7 +1,4 @@
-import "../../definitions-VpSOvVeD.js";
-import "../../utils-DWLhAKwM.js";
-import { s as LoaderPlugin } from "../../path-B8CdvN3q.js";
-import "../index.js";
+import { s as LoaderPlugin } from "../../path-oEC3g6wP.js";
 import { icons } from "lucide-react";
 
 //#region src/source/plugins/lucide-icons.d.ts

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

@@ -1,6 +1,4 @@
-import "../../definitions-VpSOvVeD.js";
-import "../../utils-DWLhAKwM.js";
-import { i as LoaderConfig, s as LoaderPlugin, x as ContentStoragePageFile } from "../../path-B8CdvN3q.js";
+import { C as ContentStoragePageFile, i as LoaderConfig, s as LoaderPlugin } from "../../path-oEC3g6wP.js";
 
 //#region src/source/plugins/slugs.d.ts
 /**

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

@@ -1,6 +1,5 @@
 import { a as Separator$1, n as Item$1, t as Folder$1 } from "../../definitions-VpSOvVeD.js";
-import "../../utils-DWLhAKwM.js";
-import { s as LoaderPlugin } from "../../path-B8CdvN3q.js";
+import { s as LoaderPlugin } from "../../path-oEC3g6wP.js";
 import { ReactNode } from "react";
 
 //#region src/source/plugins/status-badges.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.6.9",
+  "version": "16.6.10",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Docs",
@@ -118,8 +118,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.8.1",
     "@orama/orama": "^3.1.18",
-    "@shikijs/rehype": "^4.0.0",
-    "@shikijs/transformers": "^4.0.0",
+    "@shikijs/rehype": "^4.0.1",
+    "@shikijs/transformers": "^4.0.1",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -134,7 +134,7 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^4.0.0",
+    "shiki": "^4.0.1",
     "tinyglobby": "^0.2.15",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0",
@@ -145,7 +145,7 @@
     "@mixedbread/sdk": "^0.56.0",
     "@orama/core": "^1.2.19",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "1.163.3",
+    "@tanstack/react-router": "1.166.2",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
@@ -154,7 +154,7 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "algoliasearch": "5.49.1",
-    "lucide-react": "^0.575.0",
+    "lucide-react": "^0.577.0",
     "next": "16.1.6",
     "react-router": "^7.13.1",
     "remark-directive": "^4.0.0",