fumadocs-core 16.14.4 → 16.15.0

package/dist/{advanced-B0__lVW5.js → advanced-Ct13khZr.js}

@@ -47,8 +47,10 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 	if (query.length > 0) params.term = query;
 	const highlighter = createContentHighlighter(query);
 	const result = await search(db, params);
+	const limit = typeof params.limit === "number" ? params.limit : Infinity;
 	const list = [];
 	for (const item of result.groups ?? []) {
+		if (list.length >= limit) break;
 		const pageId = item.values[0];
 		const page = getByID(db, pageId);
 		if (!page) continue;
@@ -60,6 +62,7 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 			url: page.url
 		});
 		for (const hit of item.result) {
+			if (list.length >= limit) break;
 			if (hit.document.type === "page") continue;
 			list.push({
 				id: hit.document.id.toString(),
@@ -70,7 +73,6 @@ async function searchAdvanced(db, query, tag = [], { mode = "fulltext", ...overr
 			});
 		}
 	}
-	if (typeof params.limit === "number" && list.length > params.limit) return list.slice(0, params.limit);
 	return list;
 }
 //#endregion

package/dist/highlight/client.js

@@ -1,5 +1,5 @@
 "use client";
-import { t as applyDefaultThemes } from "../utils-D2T58c9w.js";
+import { t as applyDefaultThemes } from "../utils-Cgs-6U-z.js";
 import { useShiki as useShiki$1 } from "./shiki/react.js";
 import { defaultShikiFactory } from "./shiki/full.js";
 //#region src/highlight/client.ts

package/dist/highlight/index.js

@@ -1,4 +1,4 @@
-import { a as loadMissingTheme, i as loadMissingLanguage, t as applyDefaultThemes } from "../utils-D2T58c9w.js";
+import { a as loadMissingTheme, i as loadMissingLanguage, t as applyDefaultThemes } from "../utils-Cgs-6U-z.js";
 import { highlightHast as highlightHast$1 } from "./shiki/index.js";
 import { defaultShikiFactory, wasmShikiFactory } from "./shiki/full.js";
 import * as JsxRuntime from "react/jsx-runtime";

package/dist/highlight/shiki/index.js

@@ -1,10 +1,14 @@
-import { a as loadMissingTheme, r as getRequiredThemes } from "../../utils-D2T58c9w.js";
+import { a as loadMissingTheme, r as getRequiredThemes } from "../../utils-Cgs-6U-z.js";
 //#region src/highlight/shiki/index.ts
 function createShikiFactory(config) {
 	let instance;
 	return {
 		init(options) {
-			return instance = config.init(options);
+			const created = config.init(options);
+			if (created instanceof Promise) created.catch(() => {
+				if (instance === created) instance = void 0;
+			});
+			return instance = created;
 		},
 		getOrInit() {
 			return instance ?? this.init();
@@ -14,8 +18,9 @@ function createShikiFactory(config) {
 async function highlightHast(highlighter, code, options) {
 	const { fallbackLanguage = "text", ...resolved } = options;
 	const { isSpecialLang } = await import("shiki/core");
-	if (!isSpecialLang(resolved.lang) && !(resolved.lang in highlighter.getBundledLanguages()) && !highlighter.getLoadedLanguages().includes(resolved.lang)) resolved.lang = fallbackLanguage;
-	await Promise.all([loadMissingTheme(highlighter, getRequiredThemes(resolved)), highlighter.loadLanguage(resolved.lang)]);
+	const loaded = highlighter.getLoadedLanguages();
+	if (!isSpecialLang(resolved.lang) && !(resolved.lang in highlighter.getBundledLanguages()) && !loaded.includes(resolved.lang)) resolved.lang = fallbackLanguage;
+	await Promise.all([loadMissingTheme(highlighter, getRequiredThemes(resolved)), !isSpecialLang(resolved.lang) && !loaded.includes(resolved.lang) && highlighter.loadLanguage(resolved.lang)]);
 	return highlighter.codeToHast(code, resolved);
 }
 //#endregion

package/dist/{index-ByMgvmTr2.d.ts → index-C8oBtRaX2.d.ts}

@@ -109,13 +109,23 @@ interface PageTreeBuilder {
 //#endregion
 //#region src/source/plugins/slugs.d.ts
 /**
- * a function to generate slugs, return `undefined` to fallback to default generation.
+ * a function to generate slugs, return `undefined` to generate default slugs.
+ *
+ * conflicting cases like `dir/index.mdx` vs `dir.mdx` are resolved after the function returns.
+ *
+ * @param next - generate the default slugs from file path (before conflict resolution).
  */
-type SlugFn<S extends ContentStorage = ContentStorage> = (file: S['$inferPage']) => string[] | undefined;
+type SlugFn<S extends ContentStorage = ContentStorage> = (file: S['$inferPage'], next: () => string[]) => string[] | undefined;
+interface SlugsPluginOptions<S extends ContentStorage = ContentStorage> {
+  /** Slugs to prepend to every page. */
+  baseSlugs?: string[];
+  /** generate default slugs for pages */
+  slugs?: SlugFn<S>;
+}
 /**
- * Generate slugs for pages if missing
+ * Generate slugs for pages if missing.
  */
-declare function slugsPlugin(slugFn?: SlugFn): LoaderPlugin;
+declare function slugsPlugin(optsOrFn?: SlugsPluginOptions | SlugFn): LoaderPlugin;
 /**
  * Generate slugs from file data (e.g. frontmatter).
  *
@@ -146,7 +156,7 @@ interface LoaderConfig {
   meta: Meta;
   i18n: I18nConfig | undefined;
 }
-interface LoaderOptions<S extends ContentStorage = ContentStorage, I18n extends I18nConfig | undefined = I18nConfig | undefined> {
+interface LoaderOptions<S extends ContentStorage = ContentStorage, I18n extends I18nConfig | undefined = I18nConfig | undefined> extends SlugsPluginOptions<S> {
   baseUrl: string;
   i18n?: I18n;
   url?: (slugs: string[], locale?: string) => string;
@@ -158,7 +168,6 @@ interface LoaderOptions<S extends ContentStorage = ContentStorage, I18n extends
     typedPlugin: (plugin: LoaderPlugin<S>) => LoaderPlugin;
   }) => LoaderPluginOption[]);
   icon?: IconResolver;
-  slugs?: SlugFn<S>;
 }
 interface ResolvedLoaderConfig {
   input: ResolvedInput;
@@ -256,11 +265,13 @@ interface LoaderOutput<Config extends LoaderConfig = LoaderConfig> {
   serializePageTree: (tree: Root) => Promise<SerializedPageTree>;
 }
 declare function createGetUrl(baseUrl: string, i18n?: I18nConfig): ResolvedLoaderConfig['url'];
+/** content loader API for static content sources */
 declare function loader<I extends ResolvedInput, I18n extends I18nConfig | undefined = undefined>(source: I, options: LoaderOptions<NoInfer<GenerateStorage<I>>, I18n>): LoaderOutput<{
   meta: GenerateMeta<I>;
   page: GeneratePage<I>;
   i18n: I18n;
 }>;
+/** content loader API for static content sources */
 declare function loader<I extends ResolvedInput, I18n extends I18nConfig | undefined = undefined>(options: LoaderOptions<NoInfer<GenerateStorage<I>>, I18n> & {
   source: I;
 }): LoaderOutput<{
@@ -296,20 +307,20 @@ type InferPageType<Utils extends LoaderOutput<any>> = Utils['$inferPage'];
 type InferMetaType<Utils extends LoaderOutput<any>> = Utils['$inferMeta'];
 //#endregion
 //#region src/source/dynamic.d.ts
-type Input = SourceUnion | Record<string, SourceUnion>;
 interface DynamicLoaderConfig extends LoaderConfig {
   source: string | undefined;
 }
 interface DynamicLoader<Config extends DynamicLoaderConfig = DynamicLoaderConfig> {
   get: () => Promise<LoaderOutput<Config>>;
-  /** update & re-compute dynamic sources */
+  /** invalidate & re-compute dynamic sources immediately */
   revalidate: (source?: Config['source']) => Promise<void>;
   /** remove computed cache of dynamic sources */
   invalidate: (source?: Config['source']) => void;
   get $inferPage(): Config['page'];
   get $inferMeta(): Config['meta'];
 }
-declare function dynamicLoader<I extends Input, I18n extends I18nConfig | undefined = undefined>(input: I, options: LoaderOptions<NoInfer<GenerateStorage<I>>, I18n>): DynamicLoader<{
+/** content loader API for static & dynamic content sources, with in-memory cache. */
+declare function dynamicLoader<I extends SourceUnion | Record<string, SourceUnion>, I18n extends I18nConfig | undefined = undefined>(input: I, options: LoaderOptions<NoInfer<GenerateStorage<I>>, I18n>): DynamicLoader<{
   i18n: I18n;
   meta: NoInfer<GenerateMeta<I>>;
   page: NoInfer<GeneratePage<I>>;
@@ -324,10 +335,37 @@ type SourceUnion<Config extends SourceConfig = SourceConfig> = StaticSource<Conf
 type Source<Config extends SourceConfig = SourceConfig> = StaticSource<Config>;
 interface StaticSource<Config extends SourceConfig = SourceConfig> {
   files: VirtualFile<Config>[];
+  /**
+   * called when the source is attached to a new static loader, before loader output is accessible.
+   **/
+  configureStatic?: (opts: {
+    loader: LoaderOutput;
+    source?: string;
+  }) => void;
 }
+/** one dynamic source object can only be used by one dynamic loader */
 interface DynamicSource<Config extends SourceConfig = SourceConfig> {
+  /**
+   * - `memory`: the dynamic loader's in-memory cache handles caching.
+   * - `custom`: the source handles caching itself. When the newer result of `files()` is (shallowly) different from the previous result, the source is considered revalidated, and all associated properties will be re-computed.
+   *
+   * @default 'memory'
+   **/
+  cache?: 'memory' | 'custom';
   files: () => Awaitable<VirtualFile<Config>[]>;
-  configure?: (loader: DynamicLoader) => void;
+  configure?: (loader: DynamicLoader, opts: {
+    source?: string;
+  }) => void;
+  /**
+   * called when the source is attached to a new static loader, before loader output is accessible.
+   *
+   * it can be called multiple times, when the parent dynamic loader creates a different static loader.
+   **/
+  configureStatic?: (opts: {
+    loader: LoaderOutput;
+    source?: string;
+  }) => void;
+  invalidate?: () => void;
 }
 type SourceConfig = {
   pageData: PageData;
@@ -465,4 +503,4 @@ declare function llms<C extends LoaderConfig = LoaderConfig>(loader: LoaderOutpu
   indexNode(node: Node, lang?: string): string;
 };
 //#endregion
-export { SlugFn as A, ContentStoragePageFile as B, LoaderPluginOption as C, createGetUrl as D, ResolvedLoaderConfig as E, PageTreeBuilderContext as F, PageTreeOptions as I, PageTreeTransformer as L, slugsFromData as M, slugsPlugin as N, loader as O, PageTreeBuilder as P, ContentStorage as R, LoaderPlugin as S, Page as T, FileSystem as V, InferMetaType as _, MetaData as a, LoaderOptions as b, SourceUnion as c, multiple as d, source as f, dynamicLoader as g, DynamicLoaderConfig as h, DynamicSource as i, getSlugs as j, types_d_exports as k, StaticSource as l, DynamicLoader as m, llms as n, PageData as o, update as p, path_d_exports as r, Source as s, LLMsConfig as t, VirtualFile as u, InferPageType as v, Meta as w, LoaderOutput as x, LoaderConfig as y, ContentStorageMetaFile as z };
+export { SlugFn as A, ContentStorageMetaFile as B, LoaderPluginOption as C, createGetUrl as D, ResolvedLoaderConfig as E, PageTreeBuilder as F, FileSystem as H, PageTreeBuilderContext as I, PageTreeOptions as L, getSlugs as M, slugsFromData as N, loader as O, slugsPlugin as P, PageTreeTransformer as R, LoaderPlugin as S, Page as T, ContentStoragePageFile as V, InferMetaType as _, MetaData as a, LoaderOptions as b, SourceUnion as c, multiple as d, source as f, dynamicLoader as g, DynamicLoaderConfig as h, DynamicSource as i, SlugsPluginOptions as j, types_d_exports as k, StaticSource as l, DynamicLoader as m, llms as n, PageData as o, update as p, path_d_exports as r, Source as s, LLMsConfig as t, VirtualFile as u, InferPageType as v, Meta as w, LoaderOutput as x, LoaderConfig as y, ContentStorage as z };

package/dist/{loader-cKlyDdAK.js → loader-BfwY7fPX.js}

@@ -12,7 +12,7 @@ var FileSystem = class {
 		this.files = /* @__PURE__ */ new Map();
 		this.folders = /* @__PURE__ */ new Map();
 		if (inherit) {
-			for (const [k, v] of inherit.folders) this.folders.set(k, v);
+			for (const [k, v] of inherit.folders) this.folders.set(k, [...v]);
 			for (const [k, v] of inherit.files) this.files.set(k, v);
 		} else this.folders.set("", []);
 	}
@@ -601,6 +601,7 @@ function createPageIndexer({ url }) {
 	const pages = /* @__PURE__ */ new Map();
 	const pathToMeta = /* @__PURE__ */ new Map();
 	const pathToPage = /* @__PURE__ */ new Map();
+	const urlToPage = /* @__PURE__ */ new Map();
 	return {
 		scan(storage, lang) {
 			for (const filePath of storage.getFiles()) {
@@ -627,11 +628,15 @@ function createPageIndexer({ url }) {
 				};
 				pathToPage.set(path, page);
 				pages.set(prefix + page.slugs.join("/"), page);
+				urlToPage.set(prefix + page.url, page);
 			}
 		},
 		getPage(path, lang = "") {
 			return pathToPage.get(`${lang}.${path}`);
 		},
+		getPageByUrl(url, lang = "") {
+			return urlToPage.get(`${lang}.${url}`);
+		},
 		getMeta(path, lang = "") {
 			return pathToMeta.get(`${lang}.${path}`);
 		},
@@ -687,7 +692,7 @@ function loader(...args) {
 			return pageTrees = out;
 		}
 	}
-	return {
+	const out = {
 		_i18n: i18n,
 		get pageTree() {
 			return getPageTrees();
@@ -705,7 +710,7 @@ function loader(...args) {
 				} catch {}
 				const path = joinPath(dir, decoded);
 				target = indexer.getPage(path, language);
-			} else target = this.getPages(language).find((item) => item.url === value);
+			} else target = indexer.getPageByUrl(value, language);
 			if (target) return {
 				page: target,
 				hash
@@ -775,8 +780,14 @@ function loader(...args) {
 			};
 		}
 	};
+	if (isStaticSource(loaderConfig.input)) loaderConfig.input.configureStatic?.({ loader: out });
+	else for (const [k, v] of Object.entries(loaderConfig.input)) v.configureStatic?.({
+		loader: out,
+		source: k
+	});
+	return out;
 }
-function resolveConfig(input, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
+function resolveConfig(input, { slugs, baseSlugs, icon, plugins = [], baseUrl, url, ...base }) {
 	let config = {
 		...base,
 		url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
@@ -784,7 +795,10 @@ function resolveConfig(input, { slugs, icon, plugins = [], baseUrl, url, ...base
 		plugins: buildPlugins([
 			icon && iconPlugin(icon),
 			...typeof plugins === "function" ? plugins({ typedPlugin: (plugin) => plugin }) : plugins,
-			slugsPlugin(slugs)
+			slugsPlugin({
+				slugs,
+				baseSlugs
+			})
 		])
 	};
 	for (const plugin of config.plugins) {

package/dist/mdx-plugins/index.js

@@ -1,7 +1,7 @@
 import { remarkHeading } from "./remark-heading.js";
 import { generateCodeBlockTabs, parseCodeBlockAttributes } from "./codeblock-utils.js";
 import { remarkGfm } from "./remark-gfm.js";
-import { r as transformerTab } from "../rehype-code.core-CWlREGfK.js";
+import { r as transformerTab } from "../rehype-code.core-BUwNuchP.js";
 import { transformerIcon } from "./transformer-icon.js";
 import { rehypeCode, rehypeCodeDefaultOptions } from "./rehype-code.js";
 import { remarkImage } from "./remark-image.js";

package/dist/mdx-plugins/rehype-code.core.js

@@ -1,3 +1,3 @@
-import { n as rehypeCodeDefaultOptions, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-CWlREGfK.js";
+import { n as rehypeCodeDefaultOptions, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BUwNuchP.js";
 import { transformerIcon } from "./transformer-icon.js";
 export { createRehypeCode, rehypeCodeDefaultOptions, transformerIcon, transformerTab };

package/dist/mdx-plugins/rehype-code.js

@@ -1,5 +1,5 @@
 import { defaultShikiFactory, wasmShikiFactory } from "../highlight/shiki/full.js";
-import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-CWlREGfK.js";
+import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BUwNuchP.js";
 import { transformerIcon } from "./transformer-icon.js";
 //#region src/mdx-plugins/rehype-code.ts
 const rehypeCodeDefaultOptions = {

package/dist/{rehype-code.core-CWlREGfK.js → rehype-code.core-BUwNuchP.js}

@@ -1,5 +1,5 @@
 import { n as flattenNodeHast } from "./utils-Yx0IL9eW.js";
-import { n as defaultThemes, r as getRequiredThemes } from "./utils-D2T58c9w.js";
+import { n as defaultThemes, r as getRequiredThemes } from "./utils-Cgs-6U-z.js";
 import { parseCodeBlockAttributes } from "./mdx-plugins/codeblock-utils.js";
 import { transformerIcon } from "./mdx-plugins/transformer-icon.js";
 import { visit } from "unist-util-visit";

package/dist/search/client/algolia.js

@@ -43,13 +43,9 @@ function algoliaClient(options) {
 				filters: tag ? `tag:${tag}` : void 0
 			}] });
 			const highlighter = createContentHighlighter(query);
-			return groupResults(result.results[0].hits).flatMap((hit) => {
-				if (hit.type === "page") return {
-					...hit,
-					content: highlighter.highlightMarkdown(hit.content)
-				};
-				return [];
-			});
+			const results = groupResults(result.results[0].hits);
+			for (const item of results) item.content = highlighter.highlightMarkdown(item.content);
+			return results;
 		}
 	};
 }

package/dist/search/client/orama-static.js

@@ -1,5 +1,5 @@
 import { n as join, t as BASE_PATH } from "../../url-BVHvi3_K.js";
-import { n as searchSimple, t as searchAdvanced } from "../../advanced-B0__lVW5.js";
+import { n as searchSimple, t as searchAdvanced } from "../../advanced-Ct13khZr.js";
 import { create, load } from "zbsearch";
 //#region src/search/client/orama-static.ts
 const cache = /* @__PURE__ */ new Map();

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-fnyWR-fq.js";
-import { x as LoaderOutput, y as LoaderConfig } from "../index-ByMgvmTr2.js";
+import { m as SharedIndex, n as SearchAPI, t as QueryOptions } from "../server-ugF9hnpc.js";
+import { x as LoaderOutput, y as LoaderConfig } from "../index-C8oBtRaX2.js";
 import { DocumentData, DocumentOptions } from "flexsearch";
 //#region src/search/server/build-doc.d.ts
 interface SharedDocument {

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-fnyWR-fq.js";
+import { n as SearchAPI } from "../server-ugF9hnpc.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-fnyWR-fq.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-ugF9hnpc.js";
 export { AdvancedIndex, AdvancedOptions, ExportedData, Index, QueryOptions, SearchAPI, SearchServer, SimpleOptions, createFromSource, createI18nSearchAPI, createSearchAPI, initAdvancedSearch, initSimpleSearch };

package/dist/search/server.js

@@ -1,7 +1,7 @@
 import { n as defaultReadOptions, t as createEndpoint } from "../endpoint-MyoBU5IC.js";
 import { n as buildBreadcrumbs, r as buildIndexDefault, t as buildDocuments } from "../build-doc-SC7P37WG.js";
-import { n as searchSimple, t as searchAdvanced } from "../advanced-B0__lVW5.js";
-import { create, insertMultiple, save } from "zbsearch";
+import { n as searchSimple, t as searchAdvanced } from "../advanced-Ct13khZr.js";
+import { create, insertMultipleAsync, save } from "zbsearch";
 //#region src/search/zbsearch/create-db.ts
 const simpleSchema = {
 	url: "string",
@@ -36,7 +36,7 @@ async function createDB({ indexes, tokenizer, language = DefaultLanguage, search
 		}
 	});
 	const mapTo = buildDocuments(items);
-	await insertMultiple(db, mapTo);
+	await insertMultipleAsync(db, mapTo);
 	return db;
 }
 async function createDBSimple({ indexes, tokenizer, language = DefaultLanguage, search: _, localeFilter: __, ...rest }) {
@@ -51,7 +51,7 @@ async function createDBSimple({ indexes, tokenizer, language = DefaultLanguage,
 			tokenizer: resolvedTokenizer
 		}
 	});
-	await insertMultiple(db, items.map((page) => ({
+	await insertMultipleAsync(db, items.map((page) => ({
 		title: page.title,
 		description: page.description,
 		breadcrumbs: page.breadcrumbs,
@@ -207,8 +207,12 @@ function createFromSource(loader, options = {}) {
 		const l = typeof loader === "function" ? await loader() : loader;
 		let server = cache.get(l);
 		if (!server) {
-			server = initServer(l);
-			cache.set(l, server);
+			const promise = initServer(l);
+			promise.catch(() => {
+				if (cache.get(l) === promise) cache.delete(l);
+			});
+			cache.set(l, promise);
+			server = promise;
 		}
 		return await server;
 	}

package/dist/{server-fnyWR-fq.d.ts → server-ugF9hnpc.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 { x as LoaderOutput, y as LoaderConfig } from "./index-ByMgvmTr2.js";
+import { x as LoaderOutput, y as LoaderConfig } from "./index-C8oBtRaX2.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/dynamic.d.ts

@@ -1,2 +1,2 @@
-import { g as dynamicLoader, h as DynamicLoaderConfig, m as DynamicLoader } from "../index-ByMgvmTr2.js";
+import { g as dynamicLoader, h as DynamicLoaderConfig, m as DynamicLoader } from "../index-C8oBtRaX2.js";
 export { DynamicLoader, DynamicLoaderConfig, dynamicLoader };

package/dist/source/dynamic.js

@@ -1,31 +1,32 @@
-import { i as isStaticSource, n as loader, r as isDynamicSource } from "../loader-cKlyDdAK.js";
+import { t as isEqualShallow } from "../is-equal-LdLqRs0o.js";
+import { i as isStaticSource, n as loader, r as isDynamicSource } from "../loader-BfwY7fPX.js";
 import { cache } from "react";
 //#region src/source/dynamic.ts
+/** content loader API for static & dynamic content sources, with in-memory cache. */
 function dynamicLoader(input, options) {
 	let loaderCacheKey;
 	let loaderCache;
-	const sourceCache = /* @__PURE__ */ new Map();
-	function configureSources() {
-		if (isStaticSource(input)) return;
-		if (isDynamicSource(input)) {
-			input.configure?.(dynamicLoader);
-			return;
-		}
-		for (const v of Object.values(input)) if (isDynamicSource(v)) v.configure?.(dynamicLoader);
-	}
-	async function resolveSources(skipCache = false) {
-		if (isStaticSource(input) || isDynamicSource(input)) return resolveSource(input, skipCache);
-		const entries = await Promise.all(Object.entries(input).map(async ([k, v]) => [k, await resolveSource(v, skipCache)]));
+	const memoryCache = /* @__PURE__ */ new Map();
+	async function resolveSources() {
+		if (isStaticSource(input) || isDynamicSource(input)) return resolveSource(input);
+		const entries = await Promise.all(Object.entries(input).map(async ([k, v]) => [k, await resolveSource(v)]));
 		return Object.fromEntries(entries);
 	}
-	function resolveSource(v, skipCache = false) {
+	function resolveSource(v) {
 		if (isStaticSource(v)) return v;
-		let resolved = skipCache ? void 0 : sourceCache.get(v);
-		if (resolved) return resolved;
-		const files = v.files();
-		if ("then" in files) resolved = files.then((res) => ({ files: res }));
-		else resolved = { files };
-		sourceCache.set(v, resolved);
+		const cache = v.cache ?? "memory";
+		if (cache === "memory") {
+			const cached = memoryCache.get(v);
+			if (cached) return cached;
+		}
+		const resolved = Promise.resolve(v.files()).then((res) => ({
+			files: res,
+			configureStatic: v.configureStatic
+		})).catch((e) => {
+			if (cache === "memory" && memoryCache.get(v) === resolved) memoryCache.delete(v);
+			throw e;
+		});
+		if (cache === "memory") memoryCache.set(v, resolved);
 		return resolved;
 	}
 	const dynamicLoader = {
@@ -39,27 +40,34 @@ function dynamicLoader(input, options) {
 		$inferPage: void 0,
 		$inferMeta: void 0,
 		async revalidate(name) {
-			if (name === void 0) await resolveSources(true);
-			else if (!isStaticSource(input) && !isDynamicSource(input)) await resolveSource(input[name], true);
+			dynamicLoader.invalidate(name);
+			if (name === void 0) await resolveSources();
+			else if (!isStaticSource(input) && !isDynamicSource(input)) await resolveSource(input[name]);
 		},
 		invalidate(name) {
-			if (name === void 0) sourceCache.clear();
-			else if (!isStaticSource(input) && !isDynamicSource(input)) {
-				const s = input[name];
-				if (isDynamicSource(s)) sourceCache.delete(s);
+			if (isStaticSource(input)) return;
+			if (name === void 0) {
+				memoryCache.clear();
+				if (isDynamicSource(input)) input.invalidate?.();
+				else for (const v of Object.values(input)) if (isDynamicSource(v)) v.invalidate?.();
+				return;
 			}
+			if (isDynamicSource(input)) return;
+			const s = input[name];
+			if (!isDynamicSource(s)) return;
+			memoryCache.delete(s);
+			s.invalidate?.();
 		}
 	};
-	configureSources();
+	if (isDynamicSource(input)) input.configure?.(dynamicLoader, {});
+	else if (!isStaticSource(input)) {
+		for (const [k, v] of Object.entries(input)) if (isDynamicSource(v)) v.configure?.(dynamicLoader, { source: k });
+	}
 	return dynamicLoader;
 }
 function isEqual(a, b) {
-	if (isStaticSource(a) && isStaticSource(b)) return a === b;
-	if (!isStaticSource(a) && !isStaticSource(b)) {
-		const aKeys = Object.keys(a);
-		const bKeys = Object.keys(b);
-		return aKeys.length === bKeys.length && aKeys.every((k) => a[k] === b[k]);
-	}
+	if (isStaticSource(a) && isStaticSource(b)) return isEqualShallow(a.files, b.files);
+	if (!isStaticSource(a) && !isStaticSource(b)) return Object.keys(b).every((k) => isEqualShallow(a[k].files, b[k].files));
 	return false;
 }
 //#endregion

package/dist/source/index.d.ts

@@ -1,2 +1,2 @@
-import { B as ContentStoragePageFile, C as LoaderPluginOption, D as createGetUrl, E as ResolvedLoaderConfig, F as PageTreeBuilderContext, I as PageTreeOptions, L as PageTreeTransformer, O as loader, P as PageTreeBuilder, R as ContentStorage, S as LoaderPlugin, T as Page, V as FileSystem, _ as InferMetaType, a as MetaData, b as LoaderOptions, c as SourceUnion, d as multiple, f as source, i as DynamicSource, j as getSlugs, k as types_d_exports, l as StaticSource, n as llms, o as PageData, p as update, r as path_d_exports, s as Source, t as LLMsConfig, u as VirtualFile, v as InferPageType, w as Meta, x as LoaderOutput, y as LoaderConfig, z as ContentStorageMetaFile } from "../index-ByMgvmTr2.js";
+import { B as ContentStorageMetaFile, C as LoaderPluginOption, D as createGetUrl, E as ResolvedLoaderConfig, F as PageTreeBuilder, H as FileSystem, I as PageTreeBuilderContext, L as PageTreeOptions, M as getSlugs, O as loader, R as PageTreeTransformer, S as LoaderPlugin, T as Page, V as ContentStoragePageFile, _ as InferMetaType, a as MetaData, b as LoaderOptions, c as SourceUnion, d as multiple, f as source, i as DynamicSource, k as types_d_exports, l as StaticSource, n as llms, o as PageData, p as update, r as path_d_exports, s as Source, t as LLMsConfig, u as VirtualFile, v as InferPageType, w as Meta, x as LoaderOutput, y as LoaderConfig, z as ContentStorage } from "../index-C8oBtRaX2.js";
 export { type ContentStorage, type ContentStorageMetaFile, type ContentStoragePageFile, 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, getSlugs, llms, loader, multiple, source, update };

package/dist/source/index.js

@@ -1,5 +1,5 @@
 import { o as path_exports } from "../path-1H5VzYiT.js";
-import { a as multiple, c as FileSystem, n as loader, o as source, s as update, t as createGetUrl } from "../loader-cKlyDdAK.js";
+import { a as multiple, c as FileSystem, n as loader, o as source, s as update, t as createGetUrl } from "../loader-BfwY7fPX.js";
 import { getSlugs } from "./plugins/slugs.js";
 import { llms } from "./llms.js";
 export { FileSystem, path_exports as PathUtils, createGetUrl, getSlugs, llms, loader, multiple, source, update };

package/dist/source/llms.d.ts

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

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

@@ -1,4 +1,4 @@
-import { S as LoaderPlugin } from "../../index-ByMgvmTr2.js";
+import { S as LoaderPlugin } from "../../index-C8oBtRaX2.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 SlugFn, M as slugsFromData, N as slugsPlugin, j as getSlugs } from "../../index-ByMgvmTr2.js";
-export { SlugFn, getSlugs, slugsFromData, slugsPlugin };
+import { A as SlugFn, M as getSlugs, N as slugsFromData, P as slugsPlugin, j as SlugsPluginOptions } from "../../index-C8oBtRaX2.js";
+export { SlugFn, SlugsPluginOptions, getSlugs, slugsFromData, slugsPlugin };

package/dist/source/plugins/slugs.js

@@ -1,11 +1,15 @@
 import { n as dirname, r as extname, t as basename } from "../../path-1H5VzYiT.js";
 //#region src/source/plugins/slugs.ts
 /**
-* Generate slugs for pages if missing
+* Generate slugs for pages if missing.
 */
-function slugsPlugin(slugFn) {
-	function isIndex(file) {
-		return basename(file, extname(file)) === "index";
+function slugsPlugin(optsOrFn = {}) {
+	const prepended = /* @__PURE__ */ new WeakSet();
+	const { baseSlugs = [], slugs: slugFn } = typeof optsOrFn === "function" ? { slugs: optsOrFn } : optsOrFn;
+	function generateSlugs(path, file) {
+		const out = slugFn?.(file, () => getSlugs(path)) ?? getSlugs(path);
+		prepended.add(file);
+		return baseSlugs.length > 0 ? [...baseSlugs, ...out] : out;
 	}
 	return {
 		name: "fumadocs:slugs",
@@ -14,13 +18,19 @@ function slugsPlugin(slugFn) {
 			const taken = /* @__PURE__ */ new Set();
 			for (const path of storage.getFiles()) {
 				const file = storage.read(path);
-				if (!file || file.format !== "page" || file.slugs) continue;
-				const customSlugs = slugFn?.(file);
-				if (customSlugs === void 0 && isIndex(path)) {
+				if (!file || file.format !== "page") continue;
+				if (file.slugs) {
+					if (baseSlugs.length > 0 && !prepended.has(file)) {
+						file.slugs = [...baseSlugs, ...file.slugs];
+						prepended.add(file);
+					}
+					continue;
+				}
+				if (basename(path, extname(path)) === "index") {
 					indexFiles.push(path);
 					continue;
 				}
-				file.slugs = customSlugs ?? getSlugs(path);
+				file.slugs = generateSlugs(path, file);
 				const key = file.slugs.join("/");
 				if (taken.has(key)) throw new Error(`Duplicated slugs: ${key}`);
 				taken.add(key);
@@ -28,8 +38,11 @@ function slugsPlugin(slugFn) {
 			for (const path of indexFiles) {
 				const file = storage.read(path);
 				if (file?.format !== "page") continue;
-				file.slugs = getSlugs(path);
-				if (taken.has(file.slugs.join("/"))) file.slugs.push("index");
+				file.slugs = generateSlugs(path, file);
+				if (taken.has(file.slugs.join("/"))) file.slugs = [...file.slugs, "index"];
+				const key = file.slugs.join("/");
+				if (taken.has(key)) throw new Error(`Duplicated slugs: ${key}`);
+				taken.add(key);
 			}
 		}
 	};

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 { S as LoaderPlugin } from "../../index-ByMgvmTr2.js";
+import { S as LoaderPlugin } from "../../index-C8oBtRaX2.js";
 import { ReactNode } from "react";
 //#region src/source/plugins/status-badges.d.ts
 interface Item extends Item$1 {

package/dist/{utils-D2T58c9w.js → utils-Cgs-6U-z.js}

@@ -1,27 +1,19 @@
 //#region src/highlight/utils.ts
 async function loadMissingTheme(highlighter, themes) {
 	const bundled = highlighter.getBundledThemes();
+	const loaded = highlighter.getLoadedThemes();
 	const missingThemes = themes.filter((theme) => {
-		if (typeof theme === "string" && !(theme in bundled)) return false;
-		try {
-			highlighter.getTheme(theme);
-			return false;
-		} catch {
-			return true;
-		}
+		if (typeof theme === "string") return theme in bundled && !loaded.includes(theme);
+		return theme.name === void 0 || !loaded.includes(theme.name);
 	});
 	if (missingThemes.length > 0) await highlighter.loadTheme(...missingThemes);
 }
 async function loadMissingLanguage(highlighter, langs) {
 	const bundled = highlighter.getBundledLanguages();
+	const loaded = highlighter.getLoadedLanguages();
 	const missingLangs = langs.filter((lang) => {
-		if (typeof lang === "string" && !(lang in bundled)) return false;
-		try {
-			highlighter.getLanguage(lang);
-			return false;
-		} catch {
-			return true;
-		}
+		if (typeof lang === "string") return lang in bundled && !loaded.includes(lang);
+		return !loaded.includes(lang.name);
 	});
 	if (missingLangs.length > 0) await highlighter.loadLanguage(...missingLangs);
 }

package/package.json

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