fumadocs-core 16.14.4 → 16.14.5

package/dist/{index-ByMgvmTr2.d.ts → index-BNgjXvXj2.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;
@@ -465,4 +474,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-9mGcCnIF.js}

@@ -776,7 +776,7 @@ function loader(...args) {
 		}
 	};
 }
-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 +784,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/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-BYa_JUH1.js";
+import { x as LoaderOutput, y as LoaderConfig } from "../index-BNgjXvXj2.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-BYa_JUH1.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-BYa_JUH1.js";
 export { AdvancedIndex, AdvancedOptions, ExportedData, Index, QueryOptions, SearchAPI, SearchServer, SimpleOptions, createFromSource, createI18nSearchAPI, createSearchAPI, initAdvancedSearch, initSimpleSearch };

package/dist/{server-fnyWR-fq.d.ts → server-BYa_JUH1.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-BNgjXvXj2.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-BNgjXvXj2.js";
 export { DynamicLoader, DynamicLoaderConfig, dynamicLoader };

package/dist/source/dynamic.js

@@ -1,4 +1,4 @@
-import { i as isStaticSource, n as loader, r as isDynamicSource } from "../loader-cKlyDdAK.js";
+import { i as isStaticSource, n as loader, r as isDynamicSource } from "../loader-9mGcCnIF.js";
 import { cache } from "react";
 //#region src/source/dynamic.ts
 function dynamicLoader(input, options) {

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-BNgjXvXj2.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-9mGcCnIF.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-BNgjXvXj2.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-BNgjXvXj2.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-BNgjXvXj2.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-BNgjXvXj2.js";
 import { ReactNode } from "react";
 //#region src/source/plugins/status-badges.d.ts
 interface Item extends Item$1 {

package/package.json

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