fumadocs-core 15.8.2 → 15.8.4

package/dist/source/index.js

@@ -1,25 +1,25 @@
 import {
   iconPlugin
-} from "../chunk-DDDU7USP.js";
+} from "../chunk-FAEPKD7U.js";
 import {
   basename,
   dirname,
   extname,
   joinPath,
   parseFilePath,
+  path_exports,
   slash,
   splitPath
-} from "../chunk-Z5V4JSQY.js";
+} from "../chunk-LMRZFODA.js";
 import {
   normalizeUrl
 } from "../chunk-PFNP6PEB.js";
-import "../chunk-JSBRDJBE.js";
+import "../chunk-U67V476Y.js";
 
 // src/source/page-tree/transformer-fallback.ts
 function transformerFallback() {
   const addedFiles = /* @__PURE__ */ new Set();
   return {
-    name: "fumadocs:fallback",
     root(root) {
       const isolatedStorage = new FileSystem();
       for (const file of this.storage.getFiles()) {
@@ -28,10 +28,9 @@ function transformerFallback() {
         if (content) isolatedStorage.write(file, content);
       }
       if (isolatedStorage.getFiles().length === 0) return root;
-      root.fallback = this.builder.build({
+      root.fallback = this.builder.build(isolatedStorage, {
         ...this.options,
         id: `fallback-${root.$id ?? ""}`,
-        storage: isolatedStorage,
         generateFallback: false
       });
       addedFiles.clear();
@@ -145,13 +144,7 @@ function buildFolderNode(folderPath, isGlobalRoot, ctx) {
     ctx.visitedPaths.add(indexPath);
     index = buildFileNode(indexPath, ctx);
   }
-  if (!meta?.data.pages) {
-    setIndexIfUnused();
-    children = buildAll(
-      files.filter((file) => !ctx.visitedPaths.has(file)),
-      ctx
-    );
-  } else {
+  if (meta && meta.data.pages) {
     const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folderPath, item, ctx, i));
     setIndexIfUnused();
     for (let i = 0; i < resolved.length; i++) {
@@ -166,6 +159,12 @@ function buildFolderNode(folderPath, isGlobalRoot, ctx) {
       break;
     }
     children = resolved;
+  } else {
+    setIndexIfUnused();
+    children = buildAll(
+      files.filter((file) => !ctx.visitedPaths.has(file)),
+      ctx
+    );
   }
   let name = meta?.data.title ?? index?.name;
   if (!name) {
@@ -227,10 +226,10 @@ function build(id, ctx) {
   }
   return root;
 }
-function createPageTreeBuilder(getUrl) {
-  function getTransformers(options, generateFallback) {
+function createPageTreeBuilder(getUrl, plugins) {
+  function getTransformers(generateFallback) {
     const transformers = [];
-    for (const plugin of options.plugins ?? []) {
+    for (const plugin of plugins ?? []) {
       if (plugin.transformPageTree) transformers.push(plugin.transformPageTree);
     }
     if (generateFallback) {
@@ -239,28 +238,25 @@ function createPageTreeBuilder(getUrl) {
     return transformers;
   }
   function createFlattenPathResolver(storage) {
-    const map = /* @__PURE__ */ new Map();
+    const map2 = /* @__PURE__ */ new Map();
     const files = storage.getFiles();
     for (const file of files) {
       const content = storage.read(file);
       const flattenPath = file.substring(0, file.length - extname(file).length);
-      map.set(flattenPath + "." + content.format, file);
+      map2.set(flattenPath + "." + content.format, file);
     }
     return (name, format) => {
-      return map.get(name + "." + format);
+      return map2.get(name + "." + format);
     };
   }
   return {
-    build({ storage, id, ...options }) {
+    build(storage, options) {
       const key = "";
-      return this.buildI18n({
-        id,
-        storages: { [key]: storage },
-        ...options
-      })[key];
+      return this.buildI18n({ [key]: storage }, options)[key];
     },
-    buildI18n({ id, storages, generateFallback = true, ...options }) {
-      const transformers = getTransformers(options, generateFallback);
+    buildI18n(storages, options = {}) {
+      const { id, generateFallback = true } = options;
+      const transformers = getTransformers(generateFallback);
       const out = {};
       for (const [locale, storage] of Object.entries(storages)) {
         const resolve = createFlattenPathResolver(storage);
@@ -293,7 +289,7 @@ function pathToName(name) {
   return result.join("");
 }
 
-// src/source/file-system.ts
+// src/source/storage/file-system.ts
 var FileSystem = class {
   constructor(inherit) {
     this.files = /* @__PURE__ */ new Map();
@@ -319,20 +315,31 @@ var FileSystem = class {
     return this.folders.get(path);
   }
   write(path, file) {
-    if (this.files.has(path)) {
-      this.files.set(path, file);
-      return;
+    if (!this.files.has(path)) {
+      const dir = dirname(path);
+      this.makeDir(dir);
+      this.readDir(dir)?.push(path);
     }
-    const dir = dirname(path);
-    this.makeDir(dir);
-    this.readDir(dir)?.push(path);
     this.files.set(path, file);
   }
-  delete(path) {
-    return this.files.delete(path);
-  }
-  deleteDir(path) {
-    return this.folders.delete(path);
+  /**
+   * 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());
@@ -348,7 +355,7 @@ var FileSystem = class {
   }
 };
 
-// src/source/load-files.ts
+// src/source/storage/content.ts
 function isLocaleValid(locale) {
   return locale.length > 0 && !/\d+/.test(locale);
 }
@@ -372,8 +379,7 @@ var parsers = {
     return [path];
   }
 };
-function loadFiles(files, options, i18n) {
-  const { buildFile, plugins = [] } = options;
+function buildContentStorage(files, buildFile, plugins, i18n) {
   const parser = parsers[i18n.parser ?? "dot"];
   const storages = {};
   const normalized = files.map(
@@ -415,8 +421,20 @@ function normalizePath(path) {
 }
 
 // src/source/plugins/index.ts
+var priorityMap = {
+  pre: 1,
+  default: 0,
+  post: -1
+};
 function buildPlugins(plugins) {
-  return plugins;
+  const flatten = [];
+  for (const plugin of plugins) {
+    if (Array.isArray(plugin)) flatten.push(...plugin);
+    else if (plugin) flatten.push(plugin);
+  }
+  return flatten.sort(
+    (a, b) => priorityMap[b.enforce ?? "default"] - priorityMap[a.enforce ?? "default"]
+  );
 }
 
 // src/source/plugins/slugs.ts
@@ -425,6 +443,7 @@ function slugsPlugin(slugsFn) {
     return basename(file, extname(file)) === "index";
   }
   return {
+    name: "fumadocs:slugs",
     transformStorage({ storage }) {
       const indexFiles = /* @__PURE__ */ new Set();
       const taken = /* @__PURE__ */ new Set();
@@ -450,50 +469,69 @@ function slugsPlugin(slugsFn) {
     }
   };
 }
+var GroupRegex = /^\(.+\)$/;
+function getSlugs(file) {
+  if (typeof file !== "string") return getSlugs(file.path);
+  const dir = dirname(file);
+  const name = basename(file, extname(file));
+  const slugs = [];
+  for (const seg of dir.split("/")) {
+    if (seg.length > 0 && !GroupRegex.test(seg)) slugs.push(encodeURI(seg));
+  }
+  if (GroupRegex.test(name))
+    throw new Error(`Cannot use folder group in file names: ${file}`);
+  if (name !== "index") {
+    slugs.push(encodeURI(name));
+  }
+  return slugs;
+}
 
 // src/source/plugins/compat.ts
-function compatPlugin(loader2, {
-  attachFile,
-  attachSeparator,
-  attachFolder,
+function compatPlugin({
+  pageTree,
   transformers
 }) {
-  const chunk = [];
-  chunk.push({
-    transformPageTree: {
-      file(node, file) {
-        if (!attachFile) return node;
-        const content = file ? this.storage.read(file) : void 0;
-        return attachFile(
-          node,
-          content?.format === "page" ? content : void 0
-        );
-      },
-      folder(node, folderPath, metaPath) {
-        if (!attachFolder) return node;
-        const files = this.storage.readDir(folderPath) ?? [];
-        const meta = metaPath ? this.storage.read(metaPath) : void 0;
-        return attachFolder(
-          node,
-          {
-            children: files.flatMap((file) => this.storage.read(file) ?? [])
-          },
-          meta?.format === "meta" ? meta : void 0
-        );
-      },
-      separator(node) {
-        if (!attachSeparator) return node;
-        return attachSeparator(node);
-      }
+  const plugins = [];
+  if (pageTree) {
+    const { attachFile, attachSeparator, attachFolder, transformers: transformers2 } = pageTree;
+    for (const transformer of transformers2 ?? []) {
+      plugins.push(fromPageTreeTransformer(transformer));
     }
-  });
-  for (const transformer of loader2.transformers ?? []) {
-    chunk.push(fromStorageTransformer(transformer));
+    plugins.push(
+      fromPageTreeTransformer({
+        file(node, file) {
+          if (!attachFile) return node;
+          const content = file ? this.storage.read(file) : void 0;
+          return attachFile(
+            node,
+            content?.format === "page" ? content : void 0
+          );
+        },
+        folder(node, folderPath, metaPath) {
+          if (!attachFolder) return node;
+          const files = this.storage.readDir(folderPath) ?? [];
+          const meta = metaPath ? this.storage.read(metaPath) : void 0;
+          return attachFolder(
+            node,
+            {
+              children: files.flatMap((file) => this.storage.read(file) ?? [])
+            },
+            meta?.format === "meta" ? meta : void 0
+          );
+        },
+        separator(node) {
+          if (!attachSeparator) return node;
+          return attachSeparator(node);
+        }
+      })
+    );
   }
-  for (const transformer of transformers ?? []) {
-    chunk.push(fromPageTreeTransformer(transformer));
+  if (transformers) {
+    for (const transformer of transformers) {
+      plugins.push(fromStorageTransformer(transformer));
+    }
   }
-  return chunk;
+  return plugins;
 }
 function fromPageTreeTransformer(transformer) {
   return {
@@ -546,60 +584,57 @@ function createGetUrl(baseUrl, i18n) {
     return `/${paths.filter((v) => v.length > 0).join("/")}`;
   };
 }
-function loader(options) {
-  return createOutput(options);
+function loader(...args) {
+  const resolved = args.length === 2 ? resolveConfig(args[0], args[1]) : resolveConfig(args[0].source, args[0]);
+  return createOutput(resolved);
 }
-function loadSource(source) {
-  const out = [];
-  for (const item of Array.isArray(source) ? source : [source]) {
-    if (typeof item.files === "function") {
-      out.push(...item.files());
-    } else {
-      out.push(...item.files);
-    }
+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,
+    source,
+    plugins: buildPlugins([
+      slugsPlugin(slugs),
+      icon && iconPlugin(icon),
+      compatPlugin(base),
+      ...plugins
+    ])
+  };
+  for (const plugin of config.plugins ?? []) {
+    const result = plugin.config?.(config);
+    if (result) config = result;
   }
-  return out;
+  return config;
 }
-function createOutput(options) {
-  if (!options.url && !options.baseUrl) {
-    console.warn("`loader()` now requires a `baseUrl` option to be defined.");
-  }
-  const { source, baseUrl = "/", i18n, slugs: slugsFn, url: urlFn } = options;
-  const getUrl = urlFn ? (...args) => normalizeUrl(urlFn(...args)) : createGetUrl(baseUrl, i18n);
+function createOutput({
+  source: { files },
+  url: getUrl,
+  i18n,
+  plugins = [],
+  pageTree: pageTreeConfig
+}) {
   const defaultLanguage = i18n?.defaultLanguage ?? "";
-  const files = loadSource(source);
-  const plugins = [slugsPlugin(slugsFn)];
-  if (options.icon) {
-    plugins.push(iconPlugin(options.icon));
-  }
-  if (options.plugins) {
-    plugins.push(...buildPlugins(options.plugins));
-  }
-  if (options.pageTree) {
-    plugins.push(...compatPlugin(options, options.pageTree));
-  }
-  const storages = loadFiles(
+  const storages = buildContentStorage(
     files,
-    {
-      buildFile(file) {
-        if (file.type === "page") {
-          return {
-            format: "page",
-            path: file.path,
-            slugs: file.slugs,
-            data: file.data,
-            absolutePath: file.absolutePath ?? ""
-          };
-        }
+    (file) => {
+      if (file.type === "page") {
         return {
-          format: "meta",
+          format: "page",
           path: file.path,
-          absolutePath: file.absolutePath ?? "",
-          data: file.data
+          slugs: file.slugs,
+          data: file.data,
+          absolutePath: file.absolutePath ?? ""
         };
-      },
-      plugins
+      }
+      return {
+        format: "meta",
+        path: file.path,
+        absolutePath: file.absolutePath ?? "",
+        data: file.data
+      };
     },
+    plugins,
     i18n ?? {
       defaultLanguage,
       parser: "none",
@@ -607,16 +642,12 @@ function createOutput(options) {
     }
   );
   const walker = indexPages(storages, getUrl);
-  const builder = createPageTreeBuilder(getUrl);
+  const builder = createPageTreeBuilder(getUrl, plugins);
   let pageTree;
   return {
     _i18n: i18n,
     get pageTree() {
-      pageTree ??= builder.buildI18n({
-        storages,
-        plugins,
-        ...options.pageTree
-      });
+      pageTree ??= builder.buildI18n(storages, pageTreeConfig);
       return i18n ? pageTree : pageTree[defaultLanguage];
     },
     set pageTree(v) {
@@ -654,8 +685,8 @@ function createOutput(options) {
     },
     getLanguages() {
       const list = [];
-      if (!options.i18n) return list;
-      for (const language of options.i18n.languages) {
+      if (!i18n) return list;
+      for (const language of i18n.languages) {
         list.push({
           language,
           pages: this.getPages(language)
@@ -677,14 +708,14 @@ function createOutput(options) {
       return walker.pathToPage.get(`${language}.${ref}`);
     },
     getPageTree(locale) {
-      if (options.i18n) {
+      if (i18n) {
         return this.pageTree[locale ?? defaultLanguage];
       }
       return this.pageTree;
     },
     // @ts-expect-error -- ignore this
     generateParams(slug, lang) {
-      if (options.i18n) {
+      if (i18n) {
         return this.getLanguages().flatMap(
           (entry) => entry.pages.map((page) => ({
             [slug ?? "slug"]: page.slugs,
@@ -721,28 +752,47 @@ function fileToPage(file, getUrl, locale) {
     locale
   };
 }
-var GroupRegex = /^\(.+\)$/;
-function getSlugs(file) {
-  if (typeof file !== "string") return getSlugs(file.path);
-  const dir = dirname(file);
-  const name = basename(file, extname(file));
-  const slugs = [];
-  for (const seg of dir.split("/")) {
-    if (seg.length > 0 && !GroupRegex.test(seg)) slugs.push(encodeURI(seg));
-  }
-  if (GroupRegex.test(name))
-    throw new Error(`Cannot use folder group in file names: ${file}`);
-  if (name !== "index") {
-    slugs.push(encodeURI(name));
+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 slugs;
+  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,
-  loadFiles,
   loader,
+  map,
+  multiple,
   parseFilePath
 };

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

@@ -1,4 +1,4 @@
-import { LoaderPlugin } from '../index.js';
+import { w as LoaderPlugin } from '../../builder-5BHIAfCi.js';
 import { icons } from 'lucide-react';
 import '../../definitions-Q95-psoo.js';
 import 'react';

package/dist/source/plugins/lucide-icons.js

@@ -1,7 +1,7 @@
 import {
   iconPlugin
-} from "../../chunk-DDDU7USP.js";
-import "../../chunk-JSBRDJBE.js";
+} from "../../chunk-FAEPKD7U.js";
+import "../../chunk-U67V476Y.js";
 
 // src/source/plugins/lucide-icons.ts
 import { icons } from "lucide-react";

package/dist/{static-UVSWNGTY.js → static-A2YJ5TXV.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-XOFXGHS4.js";
 import "./chunk-ZMWYLUDP.js";
 import "./chunk-OTD7MV33.js";
-import "./chunk-JSBRDJBE.js";
+import "./chunk-U67V476Y.js";
 
 // src/search/client/static.ts
 import { create, load } from "@orama/orama";

package/dist/toc.js

@@ -2,7 +2,7 @@
 import {
   useOnChange
 } from "./chunk-EMWGTXSW.js";
-import "./chunk-JSBRDJBE.js";
+import "./chunk-U67V476Y.js";
 
 // src/toc.tsx
 import { createContext, forwardRef, useContext, useMemo, useRef } from "react";

package/dist/utils/use-effect-event.d.ts

@@ -1,8 +1,9 @@
+type UseEffectEvent = <F extends (...params: never[]) => unknown>(callback: F) => F;
 /**
- * Don't use this, could be deleted anytime.
+ * Polyfill for React.js 19.2 `useEffectEvent`.
  *
- * @internal
+ * @internal Don't use this, could be deleted anytime.
  */
-declare function useEffectEvent<F extends (...params: never[]) => unknown>(callback: F): F;
+declare const useEffectEvent: UseEffectEvent;
 
 export { useEffectEvent };

package/dist/utils/use-effect-event.js

@@ -1,13 +1,16 @@
 "use client";
-import "../chunk-JSBRDJBE.js";
+import "../chunk-U67V476Y.js";
 
 // src/utils/use-effect-event.ts
-import { useCallback, useRef } from "react";
-function useEffectEvent(callback) {
-  const ref = useRef(callback);
+import * as React from "react";
+var useEffectEvent = "useEffectEvent" in React ? { ...React }.useEffectEvent : (callback) => {
+  const ref = React.useRef(callback);
   ref.current = callback;
-  return useCallback(((...params) => ref.current(...params)), []);
-}
+  return React.useCallback(
+    ((...params) => ref.current(...params)),
+    []
+  );
+};
 export {
   useEffectEvent
 };

package/dist/utils/use-media-query.js

@@ -1,7 +1,7 @@
 import {
   useMediaQuery
 } from "../chunk-EP5LHGDZ.js";
-import "../chunk-JSBRDJBE.js";
+import "../chunk-U67V476Y.js";
 export {
   useMediaQuery
 };

package/dist/utils/use-on-change.js

@@ -1,7 +1,7 @@
 import {
   useOnChange
 } from "../chunk-EMWGTXSW.js";
-import "../chunk-JSBRDJBE.js";
+import "../chunk-U67V476Y.js";
 export {
   useOnChange
 };