fumadocs-core 16.0.15 → 16.1.0

package/dist/{builder-W853MYyx.d.ts → loader-DgL6G4CA.d.ts}

@@ -2,7 +2,164 @@ import { R as Root, I as Item, F as Folder, S as Separator } from './definitions
 import { I18nConfig } from './i18n/index.js';
 import { ReactNode } from 'react';
 
-interface LoaderPlugin<Config extends SourceConfig = SourceConfig> {
+interface Source<Config extends SourceConfig = SourceConfig> {
+    files: VirtualFile<Config>[];
+}
+interface SourceConfig {
+    pageData: PageData;
+    metaData: MetaData;
+}
+interface MetaData {
+    icon?: string | undefined;
+    title?: string | undefined;
+    root?: boolean | undefined;
+    pages?: string[] | undefined;
+    defaultOpen?: boolean | undefined;
+    description?: string | undefined;
+}
+interface PageData {
+    icon?: string | undefined;
+    title?: string;
+    description?: string | undefined;
+}
+type VirtualFile<Config extends SourceConfig = SourceConfig> = VirtualPage<Config['pageData']> | VirtualMeta<Config['metaData']>;
+interface BaseVirtualFile {
+    /**
+     * Virtualized path (relative to content directory)
+     *
+     * @example `docs/page.mdx`
+     */
+    path: string;
+    /**
+     * Absolute path of the file
+     */
+    absolutePath?: string;
+}
+interface VirtualPage<Data extends PageData> extends BaseVirtualFile {
+    type: 'page';
+    /**
+     * Specified Slugs for page
+     */
+    slugs?: string[];
+    data: Data;
+}
+interface VirtualMeta<Data extends MetaData> extends BaseVirtualFile {
+    type: 'meta';
+    data: Data;
+}
+type _ConfigUnion_<T extends Record<string, Source>> = {
+    [K in keyof T]: T[K] extends Source<infer Config> ? {
+        pageData: Config['pageData'] & {
+            type: K;
+        };
+        metaData: Config['metaData'] & {
+            type: K;
+        };
+    } : never;
+}[keyof T];
+declare function multiple<T extends Record<string, Source>>(sources: T): Source<_ConfigUnion_<T>>;
+/**
+ * map virtual files in source
+ */
+declare function map<Config extends SourceConfig>(source: Source<Config>): {
+    page<$Page extends PageData>(fn: (entry: VirtualPage<Config["pageData"]>) => VirtualPage<$Page>): Source<{
+        pageData: $Page;
+        metaData: Config["metaData"];
+    }>;
+    meta<$Meta extends MetaData>(fn: (entry: VirtualMeta<Config["metaData"]>) => VirtualMeta<$Meta>): Source<{
+        pageData: Config["pageData"];
+        metaData: $Meta;
+    }>;
+};
+
+/**
+ * In memory file system.
+ */
+declare class FileSystem<File> {
+    files: Map<string, File>;
+    folders: Map<string, string[]>;
+    constructor(inherit?: FileSystem<File>);
+    read(path: string): File | undefined;
+    /**
+     * get the direct children of folder (in virtual file path)
+     */
+    readDir(path: string): string[] | undefined;
+    write(path: string, file: File): void;
+    /**
+     * Delete files at specified path.
+     *
+     * @param path - the target path.
+     * @param [recursive=false] - if set to `true`, it will also delete directories.
+     */
+    delete(path: string, recursive?: boolean): boolean;
+    getFiles(): string[];
+    makeDir(path: string): void;
+}
+
+type ContentStorage<Config extends SourceConfig = SourceConfig> = FileSystem<ContentStorageFile<Config>>;
+type ContentStorageFile<Config extends SourceConfig = SourceConfig> = {
+    path: string;
+    absolutePath?: string;
+    format: 'meta';
+    data: Config['metaData'];
+} | {
+    path: string;
+    absolutePath?: string;
+    format: 'page';
+    slugs: string[];
+    data: Config['pageData'];
+};
+/**
+ * @param defaultLanguage - language to use when i18n is not configured.
+ * @returns a map of locale and its content storage.
+ *
+ * in the storage, locale codes are removed from file paths, hence the same file will have same file paths in every storage.
+ */
+declare function buildContentStorage(loaderConfig: ResolvedLoaderConfig, defaultLanguage: string): Record<string, ContentStorage>;
+
+interface PageTreeBuilderContext<Config extends SourceConfig = SourceConfig> {
+    rootId: string;
+    generateNodeId: () => string;
+    options: PageTreeOptions;
+    transformers: PageTreeTransformer<Config>[];
+    builder: PageTreeBuilder;
+    storage: ContentStorage<Config>;
+    getUrl: ResolvedLoaderConfig['url'];
+    storages?: Record<string, ContentStorage<Config>>;
+    locale?: string;
+}
+interface PageTreeTransformer<Config extends SourceConfig = SourceConfig> {
+    file?: (this: PageTreeBuilderContext<Config>, node: Item, filePath?: string) => Item;
+    folder?: (this: PageTreeBuilderContext<Config>, node: Folder, folderPath: string, metaPath?: string) => Folder;
+    separator?: (this: PageTreeBuilderContext<Config>, node: Separator) => Separator;
+    root?: (this: PageTreeBuilderContext<Config>, node: Root) => Root;
+}
+interface PageTreeOptions<Config extends LoaderConfig = LoaderConfig> {
+    id?: string;
+    /**
+     * Remove references to the file path of original nodes (`$ref`)
+     *
+     * @defaultValue false
+     */
+    noRef?: boolean;
+    /**
+     * generate fallback page tree
+     *
+     * @defaultValue true
+     */
+    generateFallback?: boolean;
+    /**
+     * Additional page tree transformers to apply
+     */
+    transformers?: PageTreeTransformer<Config['source']>[];
+}
+interface PageTreeBuilder {
+    build: (storage: ContentStorage, options?: PageTreeOptions) => Root;
+    buildI18n: (storages: Record<string, ContentStorage>, options?: PageTreeOptions) => Record<string, Root>;
+}
+declare function createPageTreeBuilder(loaderConfig: ResolvedLoaderConfig): PageTreeBuilder;
+
+interface LoaderPlugin<Config extends LoaderConfig = LoaderConfig> {
     name?: string;
     /**
      * Change the order of plugin:
@@ -18,14 +175,15 @@ interface LoaderPlugin<Config extends SourceConfig = SourceConfig> {
      * transform the storage after loading
      */
     transformStorage?: (context: {
-        storage: ContentStorage<Config['pageData'], Config['metaData']>;
+        storage: ContentStorage<Config['source']>;
     }) => void;
     /**
      * transform the generated page tree
      */
-    transformPageTree?: PageTreeTransformer<Config['pageData'], Config['metaData']>;
+    transformPageTree?: PageTreeTransformer<Config['source']>;
 }
-declare function buildPlugins(plugins: (LoaderPlugin | LoaderPlugin[] | undefined)[]): LoaderPlugin[];
+type LoaderPluginOption<Config extends LoaderConfig = LoaderConfig> = LoaderPlugin<Config> | LoaderPluginOption<Config>[] | undefined;
+declare function buildPlugins(plugins: LoaderPluginOption[], sort?: boolean): LoaderPlugin[];
 
 type IconResolver = (icon: string | undefined) => ReactNode;
 
@@ -33,19 +191,17 @@ interface LoaderConfig {
     source: SourceConfig;
     i18n: I18nConfig | undefined;
 }
-interface SourceConfig {
-    pageData: PageData;
-    metaData: MetaData;
-}
-interface LoaderOptions<S extends SourceConfig = SourceConfig, I18n extends I18nConfig | undefined = I18nConfig | undefined> {
+interface LoaderOptions<C extends LoaderConfig = LoaderConfig> {
     baseUrl: string;
-    i18n?: I18n;
-    url?: UrlFn;
+    i18n?: C['i18n'];
+    url?: (slugs: string[], locale?: string) => string;
     /**
      * Additional options for page tree builder
      */
-    pageTree?: PageTreeOptions<S>;
-    plugins?: (LoaderPlugin<S> | LoaderPlugin<S>[] | undefined)[];
+    pageTree?: PageTreeOptions<C>;
+    plugins?: LoaderPluginOption[] | ((context: {
+        typedPlugin: (plugin: LoaderPlugin<C>) => LoaderPlugin;
+    }) => LoaderPluginOption[]);
     icon?: IconResolver;
     slugs?: (info: {
         path: string;
@@ -53,14 +209,11 @@ interface LoaderOptions<S extends SourceConfig = SourceConfig, I18n extends I18n
 }
 interface ResolvedLoaderConfig {
     source: Source;
-    url: UrlFn;
+    url: (slugs: string[], locale?: string) => string;
     plugins?: LoaderPlugin[];
     pageTree?: PageTreeOptions;
     i18n?: I18nConfig | undefined;
 }
-interface Source<Config extends SourceConfig = SourceConfig> {
-    files: VirtualFile<Config>[];
-}
 interface SharedFileInfo {
     /**
      * Virtualized file path (relative to content directory)
@@ -69,9 +222,9 @@ interface SharedFileInfo {
      */
     path: string;
     /**
-     * Absolute path of the file (can be empty)
+     * Absolute path of the file
      */
-    absolutePath: string;
+    absolutePath?: string;
 }
 interface Page<Data = PageData> extends SharedFileInfo {
     slugs: string[];
@@ -113,7 +266,7 @@ interface LoaderOutput<Config extends LoaderConfig> {
         pages: Page<Config['source']['pageData']>[];
     }[];
     /**
-     * Get page with slugs
+     * Get page with slugs, the slugs can also be URI encoded.
      *
      * @param language - If empty, the default language will be used
      */
@@ -128,166 +281,24 @@ interface LoaderOutput<Config extends LoaderConfig> {
      */
     generateParams: <TSlug extends string = 'slug', TLang extends string = 'lang'>(slug?: TSlug, lang?: TLang) => (Record<TSlug, string[]> & Record<TLang, string>)[];
 }
-declare function createGetUrl(baseUrl: string, i18n?: I18nConfig): UrlFn;
-declare function loader<Config extends SourceConfig, I18n extends I18nConfig | undefined = undefined>(source: Source<Config>, options: LoaderOptions<NoInfer<Config>, I18n>): LoaderOutput<{
+declare function createGetUrl(baseUrl: string, i18n?: I18nConfig): ResolvedLoaderConfig['url'];
+declare function loader<Config extends SourceConfig, I18n extends I18nConfig | undefined = undefined>(source: Source<Config>, options: LoaderOptions<{
+    source: NoInfer<Config>;
+    i18n: I18n;
+}>): LoaderOutput<{
     source: Config;
     i18n: I18n;
 }>;
-declare function loader<Config extends SourceConfig, I18n extends I18nConfig | undefined = undefined>(options: LoaderOptions<NoInfer<Config>, I18n> & {
+declare function loader<Config extends SourceConfig, I18n extends I18nConfig | undefined = undefined>(options: LoaderOptions<{
+    source: NoInfer<Config>;
+    i18n: I18n;
+}> & {
     source: Source<Config>;
 }): LoaderOutput<{
     source: Config;
     i18n: I18n;
 }>;
-type _ConfigUnion_<T extends Record<string, Source>> = {
-    [K in keyof T]: T[K] extends Source<infer Config> ? {
-        pageData: Config['pageData'] & {
-            type: K;
-        };
-        metaData: Config['metaData'] & {
-            type: K;
-        };
-    } : never;
-}[keyof T];
-declare function multiple<T extends Record<string, Source>>(sources: T): Source<_ConfigUnion_<T>>;
-/**
- * map virtual files in source
- */
-declare function map<Config extends SourceConfig>(source: Source<Config>): {
-    page<$Page extends PageData>(fn: (entry: VirtualPage<Config["pageData"]>) => VirtualPage<$Page>): Source<{
-        pageData: $Page;
-        metaData: Config["metaData"];
-    }>;
-    meta<$Meta extends MetaData>(fn: (entry: VirtualMeta<Config["metaData"]>) => VirtualMeta<$Meta>): Source<{
-        pageData: Config["pageData"];
-        metaData: $Meta;
-    }>;
-};
-
-interface MetaData {
-    icon?: string | undefined;
-    title?: string | undefined;
-    root?: boolean | undefined;
-    pages?: string[] | undefined;
-    defaultOpen?: boolean | undefined;
-    description?: string | undefined;
-}
-interface PageData {
-    icon?: string | undefined;
-    title?: string;
-    description?: string | undefined;
-}
-interface BaseVirtualFile {
-    /**
-     * Virtualized path (relative to content directory)
-     *
-     * @example `docs/page.mdx`
-     */
-    path: string;
-    /**
-     * Absolute path of the file
-     */
-    absolutePath?: string;
-}
-interface VirtualPage<Data extends PageData> extends BaseVirtualFile {
-    type: 'page';
-    /**
-     * Specified Slugs for page
-     */
-    slugs?: string[];
-    data: Data;
-}
-interface VirtualMeta<Data extends MetaData> extends BaseVirtualFile {
-    type: 'meta';
-    data: Data;
-}
-type VirtualFile<Config extends SourceConfig = SourceConfig> = VirtualPage<Config['pageData']> | VirtualMeta<Config['metaData']>;
 type InferPageType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Page<Config['source']['pageData']> : never;
 type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput<infer Config> ? Meta<Config['source']['metaData']> : never;
-/**
- * @internal
- */
-type UrlFn = (slugs: string[], locale?: string) => string;
-
-/**
- * In memory file system.
- */
-declare class FileSystem<File> {
-    files: Map<string, File>;
-    folders: Map<string, string[]>;
-    constructor(inherit?: FileSystem<File>);
-    read(path: string): File | undefined;
-    /**
-     * get the direct children of folder (in virtual file path)
-     */
-    readDir(path: string): string[] | undefined;
-    write(path: string, file: File): void;
-    /**
-     * Delete files at specified path.
-     *
-     * @param path - the target path.
-     * @param [recursive=false] - if set to `true`, it will also delete directories.
-     */
-    delete(path: string, recursive?: boolean): boolean;
-    getFiles(): string[];
-    makeDir(path: string): void;
-}
-
-type ContentStorage<Page extends PageData = PageData, Meta extends MetaData = MetaData> = FileSystem<MetaFile<Meta> | PageFile<Page>>;
-interface MetaFile<Data extends MetaData = MetaData> {
-    path: string;
-    absolutePath: string;
-    format: 'meta';
-    data: Data;
-}
-interface PageFile<Data extends PageData = PageData> {
-    path: string;
-    absolutePath: string;
-    format: 'page';
-    slugs: string[];
-    data: Data;
-}
-
-interface PageTreeBuilderContext<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
-    rootId: string;
-    generateNodeId: () => string;
-    options: PageTreeOptions;
-    transformers: PageTreeTransformer<Page, Meta>[];
-    builder: PageTreeBuilder;
-    storage: ContentStorage<Page, Meta>;
-    getUrl: UrlFn;
-    storages?: Record<string, ContentStorage<Page, Meta>>;
-    locale?: string;
-}
-interface PageTreeTransformer<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
-    file?: (this: PageTreeBuilderContext<Page, Meta>, node: Item, filePath?: string) => Item;
-    folder?: (this: PageTreeBuilderContext<Page, Meta>, node: Folder, folderPath: string, metaPath?: string) => Folder;
-    separator?: (this: PageTreeBuilderContext<Page, Meta>, node: Separator) => Separator;
-    root?: (this: PageTreeBuilderContext<Page, Meta>, node: Root) => Root;
-}
-interface PageTreeOptions<Config extends SourceConfig = SourceConfig> {
-    id?: string;
-    /**
-     * Remove references to the file path of original nodes (`$ref`)
-     *
-     * @defaultValue false
-     */
-    noRef?: boolean;
-    /**
-     * generate fallback page tree
-     *
-     * @defaultValue true
-     */
-    generateFallback?: boolean;
-    /**
-     * Additional page tree transformers to apply
-     */
-    transformers?: PageTreeTransformer<Config['pageData'], Config['metaData']>[];
-}
-interface PageTreeBuilder {
-    build: (storage: ContentStorage, options?: PageTreeOptions) => Root;
-    buildI18n: (storages: Record<string, ContentStorage>, options?: PageTreeOptions) => Record<string, Root>;
-}
-declare function createPageTreeBuilder(getUrl: UrlFn, plugins?: LoaderPlugin[]): PageTreeBuilder;
 
-export { type ContentStorage as C, FileSystem as F, type InferPageType as I, type LoaderPlugin as L, type MetaFile as M, type PageTreeTransformer as P, type ResolvedLoaderConfig as R, type SourceConfig as S, type UrlFn as U, type VirtualPage as V, type _ConfigUnion_ as _, type PageTreeBuilder as a, type PageTreeBuilderContext as b, createPageTreeBuilder as c, type PageTreeOptions as d, type PageFile as e, type LoaderConfig as f, type LoaderOptions as g, type Source as h, type Page as i, type Meta as j, type LoaderOutput as k, createGetUrl as l, loader as m, multiple as n, map as o, type MetaData as p, type PageData as q, type VirtualMeta as r, type VirtualFile as s, type InferMetaType as t, buildPlugins as u };
+export { type ContentStorage as C, FileSystem as F, type InferPageType as I, type LoaderPlugin as L, type MetaData as M, type PageData as P, type ResolvedLoaderConfig as R, type Source as S, type VirtualFile as V, type _ConfigUnion_ as _, type SourceConfig as a, map as b, type LoaderConfig as c, type LoaderOptions as d, type Page as e, type Meta as f, type LoaderOutput as g, createGetUrl as h, type InferMetaType as i, type PageTreeBuilderContext as j, type PageTreeTransformer as k, loader as l, multiple as m, type PageTreeOptions as n, type PageTreeBuilder as o, createPageTreeBuilder as p, type ContentStorageFile as q, buildContentStorage as r, type LoaderPluginOption as s, buildPlugins as t };

package/dist/search/server.d.ts

@@ -3,7 +3,7 @@ import { StructuredData } from '../mdx-plugins/remark-structure.js';
 import { SortedResult } from './index.js';
 export { HighlightedText, ReactSortedResult, createContentHighlighter } from './index.js';
 import { I18nConfig } from '../i18n/index.js';
-import { k as LoaderOutput, f as LoaderConfig, I as InferPageType } from '../builder-W853MYyx.js';
+import { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-DgL6G4CA.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';

package/dist/source/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ContentStorage, F as FileSystem, t as InferMetaType, I as InferPageType, f as LoaderConfig, g as LoaderOptions, k as LoaderOutput, L as LoaderPlugin, j as Meta, p as MetaData, M as MetaFile, i as Page, q as PageData, e as PageFile, a as PageTreeBuilder, b as PageTreeBuilderContext, d as PageTreeOptions, P as PageTreeTransformer, R as ResolvedLoaderConfig, h as Source, S as SourceConfig, U as UrlFn, s as VirtualFile, r as VirtualMeta, V as VirtualPage, _ as _ConfigUnion_, u as buildPlugins, l as createGetUrl, c as createPageTreeBuilder, m as loader, o as map, n as multiple } from '../builder-W853MYyx.js';
+export { C as ContentStorage, q as ContentStorageFile, F as FileSystem, i as InferMetaType, I as InferPageType, c as LoaderConfig, d as LoaderOptions, g as LoaderOutput, L as LoaderPlugin, s as LoaderPluginOption, f as Meta, M as MetaData, e as Page, P as PageData, o as PageTreeBuilder, j as PageTreeBuilderContext, n as PageTreeOptions, k as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, r as buildContentStorage, t as buildPlugins, h as createGetUrl, p as createPageTreeBuilder, l as loader, b as map, m as multiple } from '../loader-DgL6G4CA.js';
 import '../definitions-DbCug1P3.js';
 import 'react';
 import '../i18n/index.js';

package/dist/source/index.js

@@ -15,6 +15,204 @@ import {
 } from "../chunk-PFNP6PEB.js";
 import "../chunk-U67V476Y.js";
 
+// src/source/source.ts
+function multiple(sources) {
+  const out = { files: [] };
+  for (const [type, source] of Object.entries(sources)) {
+    for (const file of source.files) {
+      out.files.push({
+        ...file,
+        data: {
+          ...file.data,
+          type
+        }
+      });
+    }
+  }
+  return out;
+}
+function map(source) {
+  return {
+    page(fn) {
+      return {
+        files: source.files.map(
+          (file) => file.type === "page" ? fn(file) : file
+        )
+      };
+    },
+    meta(fn) {
+      return {
+        files: source.files.map(
+          (file) => file.type === "meta" ? fn(file) : file
+        )
+      };
+    }
+  };
+}
+
+// src/source/storage/file-system.ts
+var FileSystem = class {
+  constructor(inherit) {
+    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.files) {
+        this.files.set(k, v);
+      }
+    } else {
+      this.folders.set("", []);
+    }
+  }
+  read(path) {
+    return this.files.get(path);
+  }
+  /**
+   * get the direct children of folder (in virtual file path)
+   */
+  readDir(path) {
+    return this.folders.get(path);
+  }
+  write(path, file) {
+    if (!this.files.has(path)) {
+      const dir = dirname(path);
+      this.makeDir(dir);
+      this.readDir(dir)?.push(path);
+    }
+    this.files.set(path, file);
+  }
+  /**
+   * Delete files at specified path.
+   *
+   * @param path - the target path.
+   * @param [recursive=false] - if set to `true`, it will also delete directories.
+   */
+  delete(path, recursive = false) {
+    if (this.files.delete(path)) return true;
+    if (recursive) {
+      const folder = this.folders.get(path);
+      if (!folder) return false;
+      this.folders.delete(path);
+      for (const child of folder) {
+        this.delete(child);
+      }
+      return true;
+    }
+    return false;
+  }
+  getFiles() {
+    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);
+    }
+  }
+};
+
+// src/source/storage/content.ts
+function isLocaleValid(locale) {
+  return locale.length > 0 && !/\d+/.test(locale);
+}
+var parsers = {
+  dir(path) {
+    const [locale, ...segs] = path.split("/");
+    if (locale && segs.length > 0 && isLocaleValid(locale))
+      return [segs.join("/"), locale];
+    return [path];
+  },
+  dot(path) {
+    const dir = dirname(path);
+    const base = basename(path);
+    const parts = base.split(".");
+    if (parts.length < 3) return [path];
+    const [locale] = parts.splice(parts.length - 2, 1);
+    if (!isLocaleValid(locale)) return [path];
+    return [joinPath(dir, parts.join(".")), locale];
+  },
+  none(path) {
+    return [path];
+  }
+};
+function buildContentStorage(loaderConfig, defaultLanguage) {
+  const {
+    source,
+    plugins = [],
+    i18n = {
+      defaultLanguage,
+      parser: "none",
+      languages: [defaultLanguage]
+    }
+  } = loaderConfig;
+  const parser = parsers[i18n.parser ?? "dot"];
+  const storages = {};
+  const normalized = /* @__PURE__ */ new Map();
+  for (const inputFile of source.files) {
+    let file;
+    if (inputFile.type === "page") {
+      file = {
+        format: "page",
+        path: normalizePath(inputFile.path),
+        // will be generated by the slugs plugin if unspecified
+        slugs: inputFile.slugs,
+        data: inputFile.data,
+        absolutePath: inputFile.absolutePath
+      };
+    } else {
+      file = {
+        format: "meta",
+        path: normalizePath(inputFile.path),
+        absolutePath: inputFile.absolutePath,
+        data: inputFile.data
+      };
+    }
+    const [pathWithoutLocale, locale = i18n.defaultLanguage] = parser(
+      file.path
+    );
+    const list = normalized.get(locale) ?? [];
+    list.push({
+      pathWithoutLocale,
+      file
+    });
+    normalized.set(locale, list);
+  }
+  const fallbackLang = i18n.fallbackLanguage !== null ? i18n.fallbackLanguage ?? i18n.defaultLanguage : null;
+  function scan(lang) {
+    if (storages[lang]) return;
+    let storage;
+    if (fallbackLang && fallbackLang !== lang) {
+      scan(fallbackLang);
+      storage = new FileSystem(storages[fallbackLang]);
+    } else {
+      storage = new FileSystem();
+    }
+    for (const { pathWithoutLocale, file } of normalized.get(lang) ?? []) {
+      storage.write(pathWithoutLocale, file);
+    }
+    const context = {
+      storage
+    };
+    for (const plugin of plugins) {
+      plugin.transformStorage?.(context);
+    }
+    storages[lang] = storage;
+  }
+  for (const lang of i18n.languages) scan(lang);
+  return storages;
+}
+function normalizePath(path) {
+  const segments = splitPath(slash(path));
+  if (segments[0] === "." || segments[0] === "..")
+    throw new Error("It must not start with './' or '../'");
+  return segments.join("/");
+}
+
 // src/source/page-tree/transformer-fallback.ts
 function transformerFallback() {
   const addedFiles = /* @__PURE__ */ new Set();
@@ -54,20 +252,21 @@ var rest = "...";
 var restReversed = "z...a";
 var extractPrefix = "...";
 var excludePrefix = "!";
-function createPageTreeBuilder(getUrl, plugins) {
+function createPageTreeBuilder(loaderConfig) {
+  const { plugins = [], url, pageTree: defaultOptions = {} } = loaderConfig;
   return {
-    build(storage, options) {
+    build(storage, options = defaultOptions) {
       const key = "";
       return this.buildI18n({ [key]: storage }, options)[key];
     },
-    buildI18n(storages, options = {}) {
+    buildI18n(storages, options = defaultOptions) {
       let nextId = 0;
       const out = {};
       const transformers = [];
       if (options.transformers) {
         transformers.push(...options.transformers);
       }
-      for (const plugin of plugins ?? []) {
+      for (const plugin of plugins) {
         if (plugin.transformPageTree)
           transformers.push(plugin.transformPageTree);
       }
@@ -82,7 +281,7 @@ function createPageTreeBuilder(getUrl, plugins) {
           transformers,
           builder: this,
           options,
-          getUrl,
+          getUrl: url,
           locale,
           storage,
           storages,
@@ -300,152 +499,23 @@ function pathToName(name) {
   return result.join("");
 }
 
-// src/source/storage/file-system.ts
-var FileSystem = class {
-  constructor(inherit) {
-    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.files) {
-        this.files.set(k, v);
-      }
-    } else {
-      this.folders.set("", []);
-    }
-  }
-  read(path) {
-    return this.files.get(path);
-  }
-  /**
-   * get the direct children of folder (in virtual file path)
-   */
-  readDir(path) {
-    return this.folders.get(path);
-  }
-  write(path, file) {
-    if (!this.files.has(path)) {
-      const dir = dirname(path);
-      this.makeDir(dir);
-      this.readDir(dir)?.push(path);
-    }
-    this.files.set(path, file);
-  }
-  /**
-   * Delete files at specified path.
-   *
-   * @param path - the target path.
-   * @param [recursive=false] - if set to `true`, it will also delete directories.
-   */
-  delete(path, recursive = false) {
-    if (this.files.delete(path)) return true;
-    if (recursive) {
-      const folder = this.folders.get(path);
-      if (!folder) return false;
-      this.folders.delete(path);
-      for (const child of folder) {
-        this.delete(child);
-      }
-      return true;
-    }
-    return false;
-  }
-  getFiles() {
-    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);
-    }
-  }
-};
-
-// src/source/storage/content.ts
-function isLocaleValid(locale) {
-  return locale.length > 0 && !/\d+/.test(locale);
-}
-var parsers = {
-  dir(path) {
-    const [locale, ...segs] = path.split("/");
-    if (locale && segs.length > 0 && isLocaleValid(locale))
-      return [segs.join("/"), locale];
-    return [path];
-  },
-  dot(path) {
-    const dir = dirname(path);
-    const base = basename(path);
-    const parts = base.split(".");
-    if (parts.length < 3) return [path];
-    const [locale] = parts.splice(parts.length - 2, 1);
-    if (!isLocaleValid(locale)) return [path];
-    return [joinPath(dir, parts.join(".")), locale];
-  },
-  none(path) {
-    return [path];
-  }
-};
-function buildContentStorage(files, buildFile, plugins, i18n) {
-  const parser = parsers[i18n.parser ?? "dot"];
-  const storages = {};
-  const normalized = files.map(
-    (file) => buildFile({
-      ...file,
-      path: normalizePath(file.path)
-    })
-  );
-  const fallbackLang = i18n.fallbackLanguage !== null ? i18n.fallbackLanguage ?? i18n.defaultLanguage : null;
-  function scan(lang) {
-    if (storages[lang]) return;
-    let storage;
-    if (fallbackLang && fallbackLang !== lang) {
-      scan(fallbackLang);
-      storage = new FileSystem(storages[fallbackLang]);
-    } else {
-      storage = new FileSystem();
-    }
-    for (const item of normalized) {
-      const [path, locale = i18n.defaultLanguage] = parser(item.path);
-      if (locale === lang) storage.write(path, item);
-    }
-    const context = {
-      storage
-    };
-    for (const plugin of plugins) {
-      plugin.transformStorage?.(context);
-    }
-    storages[lang] = storage;
-  }
-  for (const lang of i18n.languages) scan(lang);
-  return storages;
-}
-function normalizePath(path) {
-  const segments = splitPath(slash(path));
-  if (segments[0] === "." || segments[0] === "..")
-    throw new Error("It must not start with './' or '../'");
-  return segments.join("/");
-}
-
 // src/source/plugins/index.ts
 var priorityMap = {
   pre: 1,
   default: 0,
   post: -1
 };
-function buildPlugins(plugins) {
+function buildPlugins(plugins, sort = true) {
   const flatten = [];
   for (const plugin of plugins) {
-    if (Array.isArray(plugin)) flatten.push(...plugin);
+    if (Array.isArray(plugin)) flatten.push(...buildPlugins(plugin, false));
     else if (plugin) flatten.push(plugin);
   }
-  return flatten.sort(
-    (a, b) => priorityMap[b.enforce ?? "default"] - priorityMap[a.enforce ?? "default"]
-  );
+  if (sort)
+    return flatten.sort(
+      (a, b) => priorityMap[b.enforce ?? "default"] - priorityMap[a.enforce ?? "default"]
+    );
+  return flatten;
 }
 
 // src/source/plugins/slugs.ts
@@ -497,7 +567,7 @@ function getSlugs(file) {
 }
 
 // src/source/loader.ts
-function indexPages(storages, getUrl) {
+function indexPages(storages, { url }) {
   const result = {
     // (locale.slugs -> page)
     pages: /* @__PURE__ */ new Map(),
@@ -511,10 +581,21 @@ function indexPages(storages, getUrl) {
       const item = storage.read(filePath);
       const path = `${lang}.${filePath}`;
       if (item.format === "meta") {
-        result.pathToMeta.set(path, fileToMeta(item));
+        result.pathToMeta.set(path, {
+          path: item.path,
+          absolutePath: item.absolutePath,
+          data: item.data
+        });
         continue;
       }
-      const page = fileToPage(item, getUrl, lang);
+      const page = {
+        absolutePath: item.absolutePath,
+        path: item.path,
+        url: url(item.slugs, lang),
+        slugs: item.slugs,
+        data: item.data,
+        locale: lang
+      };
       result.pathToPage.set(path, page);
       result.pages.set(`${lang}.${page.slugs.join("/")}`, page);
     }
@@ -541,15 +622,16 @@ function loader(...args) {
   return createOutput(resolved);
 }
 function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
-  const getUrl = url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n);
   let config = {
     ...base,
-    url: getUrl,
+    url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
     source,
     plugins: buildPlugins([
       slugsPlugin(slugs),
       icon && iconPlugin(icon),
-      ...plugins
+      ...typeof plugins === "function" ? plugins({
+        typedPlugin: (plugin) => plugin
+      }) : plugins
     ])
   };
   for (const plugin of config.plugins ?? []) {
@@ -558,47 +640,17 @@ function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...bas
   }
   return config;
 }
-function createOutput({
-  source: { files },
-  url: getUrl,
-  i18n,
-  plugins = [],
-  pageTree: pageTreeConfig
-}) {
+function createOutput(loaderConfig) {
+  const { i18n } = loaderConfig;
   const defaultLanguage = i18n?.defaultLanguage ?? "";
-  const storages = buildContentStorage(
-    files,
-    (file) => {
-      if (file.type === "page") {
-        return {
-          format: "page",
-          path: file.path,
-          slugs: file.slugs,
-          data: file.data,
-          absolutePath: file.absolutePath ?? ""
-        };
-      }
-      return {
-        format: "meta",
-        path: file.path,
-        absolutePath: file.absolutePath ?? "",
-        data: file.data
-      };
-    },
-    plugins,
-    i18n ?? {
-      defaultLanguage,
-      parser: "none",
-      languages: [defaultLanguage]
-    }
-  );
-  const walker = indexPages(storages, getUrl);
-  const builder = createPageTreeBuilder(getUrl, plugins);
+  const storages = buildContentStorage(loaderConfig, defaultLanguage);
+  const walker = indexPages(storages, loaderConfig);
+  const builder = createPageTreeBuilder(loaderConfig);
   let pageTree;
   return {
     _i18n: i18n,
     get pageTree() {
-      pageTree ??= builder.buildI18n(storages, pageTreeConfig);
+      pageTree ??= builder.buildI18n(storages);
       return i18n ? pageTree : pageTree[defaultLanguage];
     },
     set pageTree(v) {
@@ -645,8 +697,13 @@ function createOutput({
       }
       return list;
     },
+    // the slugs plugin generates encoded slugs by default.
+    // we can assume page slugs are always URI encoded.
     getPage(slugs = [], language = defaultLanguage) {
-      return walker.pages.get(`${language}.${slugs.join("/")}`);
+      let page = walker.pages.get(`${language}.${slugs.join("/")}`);
+      if (page) return page;
+      page = walker.pages.get(`${language}.${slugs.map(decodeURI).join("/")}`);
+      if (page) return page;
     },
     getNodeMeta(node, language = defaultLanguage) {
       const ref = node.$ref?.metaFile;
@@ -680,61 +737,10 @@ function createOutput({
     }
   };
 }
-function fileToMeta(file) {
-  return {
-    path: file.path,
-    absolutePath: file.absolutePath,
-    data: file.data
-  };
-}
-function fileToPage(file, getUrl, locale) {
-  return {
-    absolutePath: file.absolutePath,
-    path: file.path,
-    url: getUrl(file.slugs, locale),
-    slugs: file.slugs,
-    data: file.data,
-    locale
-  };
-}
-function multiple(sources) {
-  const out = { files: [] };
-  for (const [type, source] of Object.entries(sources)) {
-    for (const file of source.files) {
-      out.files.push({
-        ...file,
-        data: {
-          ...file.data,
-          type
-        }
-      });
-    }
-  }
-  return out;
-}
-function map(source) {
-  return {
-    page(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "page" ? fn(file) : file
-        )
-      };
-    },
-    meta(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "meta" ? fn(file) : file
-        )
-      };
-    }
-  };
-}
 export {
   FileSystem,
   path_exports as PathUtils,
   createGetUrl,
-  createPageTreeBuilder,
   getSlugs,
   loader,
   map,

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

@@ -1,4 +1,4 @@
-import { L as LoaderPlugin } from '../../builder-W853MYyx.js';
+import { L as LoaderPlugin } from '../../loader-DgL6G4CA.js';
 import { icons } from 'lucide-react';
 import '../../definitions-DbCug1P3.js';
 import 'react';

package/package.json

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