fumadocs-core 15.8.1 → 15.8.3

package/README.md

@@ -2,4 +2,4 @@
 
 The core library for Fumadocs.
 
-📘 Learn More: [Documentation](https://fumadocs.vercel.app)
+📘 Learn More: [Documentation](https://fumadocs.dev)

package/dist/breadcrumb.js

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PFNP6PEB.js";
 import {
   findPath
-} from "./chunk-HV3YIUWE.js";
+} from "./chunk-2IYQ7QMS.js";
 import "./chunk-JSBRDJBE.js";
 
 // src/breadcrumb.tsx

package/dist/{chunk-HV3YIUWE.js → chunk-2IYQ7QMS.js}

@@ -1,4 +1,4 @@
-// src/utils/page-tree.tsx
+// src/page-tree/utils.ts
 function flattenTree(nodes) {
   const out = [];
   for (const node of nodes) {
@@ -36,16 +36,6 @@ function getPageTreeRoots(pageTree) {
   if (!("type" in pageTree)) result.push(pageTree);
   return result;
 }
-function separatePageTree(pageTree) {
-  return pageTree.children.flatMap((child) => {
-    if (child.type !== "folder") return [];
-    return {
-      name: child.name,
-      url: child.index?.url,
-      children: child.children
-    };
-  });
-}
 function getPageTreePeers(tree, url) {
   const parent = findParentFromTree(tree, url);
   if (!parent) return [];
@@ -102,7 +92,6 @@ export {
   flattenTree,
   findNeighbour,
   getPageTreeRoots,
-  separatePageTree,
   getPageTreePeers,
   findPath
 };

package/dist/chunk-CX7IQ5Z6.js

@@ -0,0 +1,21 @@
+import {
+  remarkHeading
+} from "./chunk-QMATWJ5F.js";
+
+// src/content/toc.ts
+import { remark } from "remark";
+function getTableOfContents(content, remarkPlugins) {
+  if (remarkPlugins) {
+    return remark().use(remarkPlugins).use(remarkHeading).process(content).then((result2) => {
+      if ("toc" in result2.data) return result2.data.toc;
+      return [];
+    });
+  }
+  const result = remark().use(remarkHeading).processSync(content);
+  if ("toc" in result.data) return result.data.toc;
+  return [];
+}
+
+export {
+  getTableOfContents
+};

package/dist/chunk-DDDU7USP.js

@@ -0,0 +1,19 @@
+// src/source/plugins/icon.ts
+function iconPlugin(resolveIcon) {
+  function replaceIcon(node) {
+    if (node.icon === void 0 || typeof node.icon === "string")
+      node.icon = resolveIcon(node.icon);
+    return node;
+  }
+  return {
+    transformPageTree: {
+      file: replaceIcon,
+      folder: replaceIcon,
+      separator: replaceIcon
+    }
+  };
+}
+
+export {
+  iconPlugin
+};

package/dist/chunk-HSBNG7QC.js

@@ -0,0 +1,42 @@
+// src/content/github.ts
+async function getGithubLastEdit({
+  repo,
+  token,
+  owner,
+  path,
+  sha,
+  options = {},
+  params: customParams = {}
+}) {
+  const headers = new Headers(options.headers);
+  const params = new URLSearchParams();
+  params.set("path", path);
+  params.set("page", "1");
+  params.set("per_page", "1");
+  if (sha) params.set("sha", sha);
+  for (const [key, value] of Object.entries(customParams)) {
+    params.set(key, value);
+  }
+  if (token) {
+    headers.append("authorization", token);
+  }
+  const res = await fetch(
+    `https://api.github.com/repos/${owner}/${repo}/commits?${params.toString()}`,
+    {
+      cache: "force-cache",
+      ...options,
+      headers
+    }
+  );
+  if (!res.ok)
+    throw new Error(
+      `Failed to fetch last edit time from Git ${await res.text()}`
+    );
+  const data = await res.json();
+  if (data.length === 0) return null;
+  return new Date(data[0].commit.committer.date);
+}
+
+export {
+  getGithubLastEdit
+};

package/dist/chunk-YVVDKJ2H.js

@@ -0,0 +1,34 @@
+// src/negotiation/index.ts
+import Negotiator from "negotiator";
+import { compile, match } from "path-to-regexp";
+function getNegotiator(request) {
+  const headers = {};
+  request.headers.forEach((value, key) => {
+    headers[key] = value;
+  });
+  return new Negotiator({ headers });
+}
+function rewritePath(source, destination) {
+  const matcher = match(source, { decode: false });
+  const compiler = compile(destination, { encode: false });
+  return {
+    rewrite(pathname) {
+      const result = matcher(pathname);
+      if (!result) return false;
+      return compiler(result.params);
+    }
+  };
+}
+function isMarkdownPreferred(request, options) {
+  const {
+    markdownMediaTypes = ["text/plain", "text/markdown", "text/x-markdown"]
+  } = options ?? {};
+  const mediaTypes = getNegotiator(request).mediaTypes();
+  return markdownMediaTypes.some((type) => mediaTypes.includes(type));
+}
+
+export {
+  getNegotiator,
+  rewritePath,
+  isMarkdownPreferred
+};

package/dist/{chunk-BDG7Y4PS.js → chunk-Z5V4JSQY.js}

@@ -30,13 +30,6 @@ function parseFilePath(path) {
     }
   };
 }
-function parseFolderPath(path) {
-  return {
-    dirname: dirname(path),
-    name: basename(path),
-    path
-  };
-}
 function splitPath(path) {
   return path.split("/").filter((p) => p.length > 0);
 }
@@ -69,7 +62,6 @@ export {
   extname,
   dirname,
   parseFilePath,
-  parseFolderPath,
   splitPath,
   joinPath,
   slash

package/dist/content/github.d.ts

@@ -0,0 +1,34 @@
+interface GetGithubLastCommitOptions {
+    /**
+     * Repository name, like "fumadocs"
+     */
+    repo: string;
+    /** Owner of repository */
+    owner: string;
+    /**
+     * Path to file
+     */
+    path: string;
+    /**
+     * GitHub access token
+     */
+    token?: string;
+    /**
+     * SHA or ref (branch or tag) name.
+     */
+    sha?: string;
+    /**
+     * Custom query parameters
+     */
+    params?: Record<string, string>;
+    options?: RequestInit;
+}
+/**
+ * Get the last edit time of a file using GitHub API
+ *
+ * By default, this will cache the result forever.
+ * Set `options.next.revalidate` to customise this.
+ */
+declare function getGithubLastEdit({ repo, token, owner, path, sha, options, params: customParams, }: GetGithubLastCommitOptions): Promise<Date | null>;
+
+export { type GetGithubLastCommitOptions, getGithubLastEdit };

package/dist/content/github.js

@@ -0,0 +1,7 @@
+import {
+  getGithubLastEdit
+} from "../chunk-HSBNG7QC.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  getGithubLastEdit
+};

package/dist/{get-toc-Cr2URuiP.d.ts → content/toc.d.ts}

@@ -1,25 +1,20 @@
-import { ReactNode } from 'react';
 import { PluggableList } from 'unified';
 import { Compatible } from 'vfile';
+import { TOCItemType } from '../toc.js';
+import 'react';
 
-interface TOCItemType {
-    title: ReactNode;
-    url: string;
-    depth: number;
-}
-type TableOfContents = TOCItemType[];
 /**
  * Get Table of Contents from markdown/mdx document (using remark)
  *
  * @param content - Markdown content or file
  */
-declare function getTableOfContents(content: Compatible): TableOfContents;
+declare function getTableOfContents(content: Compatible): TOCItemType[];
 /**
  * Get Table of Contents from markdown/mdx document (using remark)
  *
  * @param content - Markdown content or file
  * @param remarkPlugins - remark plugins to be applied first
  */
-declare function getTableOfContents(content: Compatible, remarkPlugins: PluggableList): Promise<TableOfContents>;
+declare function getTableOfContents(content: Compatible, remarkPlugins: PluggableList): Promise<TOCItemType[]>;
 
-export { type TableOfContents as T, type TOCItemType as a, getTableOfContents as g };
+export { getTableOfContents };

package/dist/content/toc.js

@@ -0,0 +1,8 @@
+import {
+  getTableOfContents
+} from "../chunk-CX7IQ5Z6.js";
+import "../chunk-QMATWJ5F.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  getTableOfContents
+};

package/dist/i18n/middleware.js

@@ -1,18 +1,14 @@
+import {
+  getNegotiator
+} from "../chunk-YVVDKJ2H.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/i18n/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";
-import Negotiator from "negotiator";
 import { NextResponse } from "next/server";
 var COOKIE = "FD_LOCALE";
 function getLocale(request, locales, defaultLanguage) {
-  const negotiatorHeaders = {};
-  request.headers.forEach((value, key) => {
-    negotiatorHeaders[key] = value;
-  });
-  const languages = new Negotiator({ headers: negotiatorHeaders }).languages(
-    locales
-  );
+  const languages = getNegotiator(request).languages(locales);
   return matchLocale(languages, locales, defaultLanguage);
 }
 var defaultFormat = (locale, path) => {

package/dist/negotiation/index.d.ts

@@ -0,0 +1,19 @@
+import Negotiator from 'negotiator';
+
+declare function getNegotiator(request: Request): Negotiator;
+/**
+ * Rewrite incoming path matching the `source` pattern into the `destination` pattern.
+ *
+ * See [`path-to-regexp`](https://github.com/pillarjs/path-to-regexp) for accepted pattern formats.
+ *
+ * @param source - the original pattern of incoming paths
+ * @param destination - the target pattern to convert into
+ */
+declare function rewritePath(source: string, destination: string): {
+    rewrite(pathname: string): string | false;
+};
+declare function isMarkdownPreferred(request: Request, options?: {
+    markdownMediaTypes?: string[];
+}): boolean;
+
+export { getNegotiator, isMarkdownPreferred, rewritePath };

package/dist/negotiation/index.js

@@ -0,0 +1,11 @@
+import {
+  getNegotiator,
+  isMarkdownPreferred,
+  rewritePath
+} from "../chunk-YVVDKJ2H.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  getNegotiator,
+  isMarkdownPreferred,
+  rewritePath
+};

package/dist/page-tree/index.d.ts

@@ -0,0 +1,32 @@
+import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-Q95-psoo.js';
+export { S as Separator } from '../definitions-Q95-psoo.js';
+import 'react';
+
+/**
+ * Flatten tree to an array of page nodes
+ */
+declare function flattenTree(nodes: Node[]): Item[];
+/**
+ * Get neighbours of a page, useful for implementing "previous & next" buttons
+ */
+declare function findNeighbour(tree: Root, url: string, options?: {
+    separateRoot?: boolean;
+}): {
+    previous?: Item;
+    next?: Item;
+};
+declare function getPageTreeRoots(pageTree: Root | Folder): (Root | Folder)[];
+/**
+ * Get other page tree nodes that lives under the same parent
+ */
+declare function getPageTreePeers(tree: Root, url: string): Item[];
+/**
+ * Search the path of a node in the tree matched by the matcher.
+ *
+ * @returns The path to the target node (from starting root), or null if the page doesn't exist
+ */
+declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, options?: {
+    includeSeparator?: boolean;
+}): Node[] | null;
+
+export { Folder, Item, Node, Root, findNeighbour, findPath, flattenTree, getPageTreePeers, getPageTreeRoots };

package/dist/page-tree/index.js

@@ -0,0 +1,15 @@
+import {
+  findNeighbour,
+  findPath,
+  flattenTree,
+  getPageTreePeers,
+  getPageTreeRoots
+} from "../chunk-2IYQ7QMS.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  findNeighbour,
+  findPath,
+  flattenTree,
+  getPageTreePeers,
+  getPageTreeRoots
+};

package/dist/search/server.js

@@ -1,7 +1,3 @@
-import {
-  basename,
-  extname
-} from "../chunk-BDG7Y4PS.js";
 import {
   searchAdvanced,
   searchSimple
@@ -10,9 +6,13 @@ import "../chunk-ZMWYLUDP.js";
 import {
   createContentHighlighter
 } from "../chunk-OTD7MV33.js";
+import {
+  basename,
+  extname
+} from "../chunk-Z5V4JSQY.js";
 import {
   findPath
-} from "../chunk-HV3YIUWE.js";
+} from "../chunk-2IYQ7QMS.js";
 import "../chunk-JSBRDJBE.js";
 
 // src/search/server.ts

package/dist/server/index.d.ts

@@ -1,80 +1,16 @@
-export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-Cr2URuiP.js';
-import { N as Node, I as Item, R as Root, F as Folder } from '../definitions-Q95-psoo.js';
-export { d as PageTree } from '../definitions-Q95-psoo.js';
+export { GetGithubLastCommitOptions, getGithubLastEdit } from '../content/github.js';
 import { Metadata } from 'next';
 import { NextRequest } from 'next/server';
 import { LoaderOutput, LoaderConfig, InferPageType } from '../source/index.js';
+export { getTableOfContents } from '../content/toc.js';
+export { TOCItemType, TableOfContents } from '../toc.js';
 export { SortedResult } from '../search/index.js';
+export { findNeighbour, findPath, flattenTree, getPageTreePeers, getPageTreeRoots } from '../page-tree/index.js';
+export { d as PageTree } from '../definitions-Q95-psoo.js';
+import '../i18n/index.js';
 import 'react';
 import 'unified';
 import 'vfile';
-import '../i18n/index.js';
-
-/**
- * Flatten tree to an array of page nodes
- */
-declare function flattenTree(nodes: Node[]): Item[];
-/**
- * Get neighbours of a page, useful for implementing "previous & next" buttons
- */
-declare function findNeighbour(tree: Root, url: string, options?: {
-    separateRoot?: boolean;
-}): {
-    previous?: Item;
-    next?: Item;
-};
-declare function getPageTreeRoots(pageTree: Root | Folder): (Root | Folder)[];
-/**
- * Separate the folder nodes of a root into multiple roots
- *
- * @deprecated it's useless
- */
-declare function separatePageTree(pageTree: Root): Root[];
-/**
- * Get other page tree nodes that lives under the same parent
- */
-declare function getPageTreePeers(tree: Root, url: string): Item[];
-/**
- * Search the path of a node in the tree matched by the matcher.
- *
- * @returns The path to the target node (from starting root), or null if the page doesn't exist
- */
-declare function findPath(nodes: Node[], matcher: (node: Node) => boolean, options?: {
-    includeSeparator?: boolean;
-}): Node[] | null;
-
-interface GetGithubLastCommitOptions {
-    /**
-     * Repository name, like "fumadocs"
-     */
-    repo: string;
-    /** Owner of repository */
-    owner: string;
-    /**
-     * Path to file
-     */
-    path: string;
-    /**
-     * GitHub access token
-     */
-    token?: string;
-    /**
-     * SHA or ref (branch or tag) name.
-     */
-    sha?: string;
-    /**
-     * Custom query parameters
-     */
-    params?: Record<string, string>;
-    options?: RequestInit;
-}
-/**
- * Get the last edit time of a file using GitHub API
- *
- * By default, this will cache the result forever.
- * Set `options.next.revalidate` to customise this.
- */
-declare function getGithubLastEdit({ repo, token, owner, path, sha, options, params: customParams, }: GetGithubLastCommitOptions): Promise<Date | null>;
 
 interface ImageMeta {
     alt: string;
@@ -82,6 +18,9 @@ interface ImageMeta {
     width: number;
     height: number;
 }
+/**
+ * @deprecated Use the SEO features of your own React.js framework instead
+ */
 declare function createMetadataImage<S extends LoaderOutput<LoaderConfig>>(options: {
     source: S;
     /**
@@ -124,4 +63,4 @@ declare function createMetadataImage<S extends LoaderOutput<LoaderConfig>>(optio
     }) => Response | Promise<Response>) => (request: NextRequest, options: any) => Response | Promise<Response>;
 };
 
-export { type GetGithubLastCommitOptions, createMetadataImage, findNeighbour, findPath, flattenTree, getGithubLastEdit, getPageTreePeers, getPageTreeRoots, separatePageTree };
+export { createMetadataImage };

package/dist/server/index.js

@@ -1,72 +1,19 @@
 import {
-  remarkHeading
-} from "../chunk-QMATWJ5F.js";
+  getTableOfContents
+} from "../chunk-CX7IQ5Z6.js";
+import "../chunk-QMATWJ5F.js";
 import {
   findNeighbour,
   findPath,
   flattenTree,
   getPageTreePeers,
-  getPageTreeRoots,
-  separatePageTree
-} from "../chunk-HV3YIUWE.js";
+  getPageTreeRoots
+} from "../chunk-2IYQ7QMS.js";
+import {
+  getGithubLastEdit
+} from "../chunk-HSBNG7QC.js";
 import "../chunk-JSBRDJBE.js";
 
-// src/server/get-toc.ts
-import { remark } from "remark";
-function getTableOfContents(content, remarkPlugins) {
-  if (remarkPlugins) {
-    return remark().use(remarkPlugins).use(remarkHeading).process(content).then((result2) => {
-      if ("toc" in result2.data) return result2.data.toc;
-      return [];
-    });
-  }
-  const result = remark().use(remarkHeading).processSync(content);
-  if ("toc" in result.data) return result.data.toc;
-  return [];
-}
-
-// src/source/page-tree/definitions.ts
-var definitions_exports = {};
-
-// src/server/git-api.ts
-async function getGithubLastEdit({
-  repo,
-  token,
-  owner,
-  path,
-  sha,
-  options = {},
-  params: customParams = {}
-}) {
-  const headers = new Headers(options.headers);
-  const params = new URLSearchParams();
-  params.set("path", path);
-  params.set("page", "1");
-  params.set("per_page", "1");
-  if (sha) params.set("sha", sha);
-  for (const [key, value] of Object.entries(customParams)) {
-    params.set(key, value);
-  }
-  if (token) {
-    headers.append("authorization", token);
-  }
-  const res = await fetch(
-    `https://api.github.com/repos/${owner}/${repo}/commits?${params.toString()}`,
-    {
-      cache: "force-cache",
-      ...options,
-      headers
-    }
-  );
-  if (!res.ok)
-    throw new Error(
-      `Failed to fetch last edit time from Git ${await res.text()}`
-    );
-  const data = await res.json();
-  if (data.length === 0) return null;
-  return new Date(data[0].commit.committer.date);
-}
-
 // src/server/metadata.ts
 function createMetadataImage(options) {
   const { filename = "image.png", imageRoute = "/docs-og" } = options;
@@ -126,7 +73,6 @@ function createMetadataImage(options) {
   };
 }
 export {
-  definitions_exports as PageTree,
   createMetadataImage,
   findNeighbour,
   findPath,
@@ -134,6 +80,5 @@ export {
   getGithubLastEdit,
   getPageTreePeers,
   getPageTreeRoots,
-  getTableOfContents,
-  separatePageTree
+  getTableOfContents
 };

package/dist/source/index.d.ts

@@ -37,57 +37,6 @@ interface FolderInfo {
     dirname: string;
 }
 declare function parseFilePath(path: string): FileInfo;
-/**
- * @deprecated use `dirname` and `basename` directly.
- */
-declare function parseFolderPath(path: string): FolderInfo;
-
-/**
- * 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(path: string): boolean;
-    deleteDir(path: string): boolean;
-    getFiles(): string[];
-    makeDir(path: string): void;
-}
-
-interface LoadOptions {
-    buildFile: (file: VirtualFile) => MetaFile | PageFile;
-    plugins?: LoaderPlugin[];
-}
-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;
-}
-type Transformer = (context: {
-    storage: ContentStorage;
-}) => void;
-/**
- * @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 loadFiles(files: VirtualFile[], options: LoadOptions, i18n: I18nConfig): Record<string, ContentStorage>;
 
 type LoaderPlugins<Page extends PageData, Meta extends MetaData> = LoaderPlugin<Page, Meta>[];
 interface LoaderPlugin<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
@@ -288,6 +237,53 @@ type InferMetaType<Utils extends LoaderOutput<any>> = Utils extends LoaderOutput
  */
 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(path: string): boolean;
+    deleteDir(path: string): boolean;
+    getFiles(): string[];
+    makeDir(path: string): void;
+}
+
+interface LoadOptions {
+    buildFile: (file: VirtualFile) => MetaFile | PageFile;
+    plugins?: LoaderPlugin[];
+}
+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;
+}
+type Transformer = (context: {
+    storage: ContentStorage;
+}) => void;
+/**
+ * @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 loadFiles(files: VirtualFile[], options: LoadOptions, i18n: I18nConfig): Record<string, ContentStorage>;
+
 interface PageTreeBuilderContext<Page extends PageData = PageData, Meta extends MetaData = MetaData> {
     /**
      * @internal resolve paths without extensions
@@ -338,4 +334,4 @@ interface PageTreeBuilder {
 }
 declare function createPageTreeBuilder(getUrl: UrlFn): PageTreeBuilder;
 
-export { type BaseOptions, type ContentStorage, type FileInfo, FileSystem, type FolderInfo, type InferMetaType, type InferPageType, type LanguageEntry, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type LoaderPlugin, type LoaderPlugins, type Meta, type MetaData, type MetaFile, type Page, type PageData, type PageFile, type PageTreeBuilder, type PageTreeBuilderContext, type PageTreeTransformer, type Source, type SourceConfig, type Transformer, type UrlFn, type VirtualFile, buildPlugins, createGetUrl, createPageTreeBuilder, getSlugs, loadFiles, loader, parseFilePath, parseFolderPath };
+export { type BaseOptions, type ContentStorage, type FileInfo, FileSystem, type FolderInfo, type InferMetaType, type InferPageType, type LanguageEntry, type LoadOptions, type LoaderConfig, type LoaderOptions, type LoaderOutput, type LoaderPlugin, type LoaderPlugins, type Meta, type MetaData, type MetaFile, type Page, type PageData, type PageFile, type PageTreeBuilder, type PageTreeBuilderContext, type PageTreeTransformer, type Source, type SourceConfig, type Transformer, type UrlFn, type VirtualFile, buildPlugins, createGetUrl, createPageTreeBuilder, getSlugs, loadFiles, loader, parseFilePath };

package/dist/source/index.js

@@ -1,13 +1,15 @@
+import {
+  iconPlugin
+} from "../chunk-DDDU7USP.js";
 import {
   basename,
   dirname,
   extname,
   joinPath,
   parseFilePath,
-  parseFolderPath,
   slash,
   splitPath
-} from "../chunk-BDG7Y4PS.js";
+} from "../chunk-Z5V4JSQY.js";
 import {
   normalizeUrl
 } from "../chunk-PFNP6PEB.js";
@@ -504,22 +506,6 @@ function fromStorageTransformer(transformer) {
   };
 }
 
-// src/source/plugins/icon.ts
-function iconPlugin(resolveIcon) {
-  function replaceIcon(node) {
-    if (node.icon === void 0 || typeof node.icon === "string")
-      node.icon = resolveIcon(node.icon);
-    return node;
-  }
-  return {
-    transformPageTree: {
-      file: replaceIcon,
-      folder: replaceIcon,
-      separator: replaceIcon
-    }
-  };
-}
-
 // src/source/loader.ts
 function indexPages(storages, getUrl) {
   const result = {
@@ -758,6 +744,5 @@ export {
   getSlugs,
   loadFiles,
   loader,
-  parseFilePath,
-  parseFolderPath
+  parseFilePath
 };

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

@@ -0,0 +1,14 @@
+import { LoaderPlugin } from '../index.js';
+import { icons } from 'lucide-react';
+import '../../definitions-Q95-psoo.js';
+import 'react';
+import '../../i18n/index.js';
+
+/**
+ * Convert icon names into Lucide Icons, requires `lucide-react` to be installed.
+ */
+declare function lucideIconsPlugin(options?: {
+    defaultIcon?: keyof typeof icons;
+}): LoaderPlugin;
+
+export { lucideIconsPlugin };

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

@@ -0,0 +1,23 @@
+import {
+  iconPlugin
+} from "../../chunk-DDDU7USP.js";
+import "../../chunk-JSBRDJBE.js";
+
+// src/source/plugins/lucide-icons.ts
+import { icons } from "lucide-react";
+import { createElement } from "react";
+function lucideIconsPlugin(options = {}) {
+  const { defaultIcon } = options;
+  return iconPlugin((icon = defaultIcon) => {
+    if (icon === void 0) return;
+    const Icon = icons[icon];
+    if (!icon) {
+      console.warn(`[lucide-icons-plugin] Unknown icon detected: ${icon}.`);
+      return;
+    }
+    return createElement(Icon);
+  });
+}
+export {
+  lucideIconsPlugin
+};

package/dist/toc.d.ts

@@ -1,9 +1,12 @@
 import * as react from 'react';
 import { ReactNode, RefObject, AnchorHTMLAttributes } from 'react';
-import { T as TableOfContents } from './get-toc-Cr2URuiP.js';
-import 'unified';
-import 'vfile';
 
+interface TOCItemType {
+    title: ReactNode;
+    url: string;
+    depth: number;
+}
+type TableOfContents = TOCItemType[];
 /**
  * The estimated active heading ID
  */
@@ -37,4 +40,4 @@ interface TOCItemProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'hr
 }
 declare const TOCItem: react.ForwardRefExoticComponent<TOCItemProps & react.RefAttributes<HTMLAnchorElement>>;
 
-export { AnchorProvider, type AnchorProviderProps, ScrollProvider, type ScrollProviderProps, TOCItem, type TOCItemProps, useActiveAnchor, useActiveAnchors };
+export { AnchorProvider, type AnchorProviderProps, ScrollProvider, type ScrollProviderProps, TOCItem, type TOCItemProps, type TOCItemType, type TableOfContents, useActiveAnchor, useActiveAnchors };

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

@@ -2,12 +2,15 @@
 import "../chunk-JSBRDJBE.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/package.json

@@ -1,12 +1,12 @@
 {
   "name": "fumadocs-core",
-  "version": "15.8.1",
-  "description": "The library for building a documentation website in Next.js",
+  "version": "15.8.3",
+  "description": "The library for building a documentation website in any React.js framework",
   "keywords": [
-    "NextJs",
+    "Fumadocs",
     "Docs"
   ],
-  "homepage": "https://fumadocs.vercel.app",
+  "homepage": "https://fumadocs.dev",
   "repository": "github:fuma-nama/fumadocs",
   "license": "MIT",
   "author": "Fuma Nama",
@@ -28,10 +28,22 @@
       "import": "./dist/content/index.js",
       "types": "./dist/content/index.d.ts"
     },
+    "./content/*": {
+      "import": "./dist/content/*.js",
+      "types": "./dist/content/*.d.ts"
+    },
     "./hide-if-empty": {
       "import": "./dist/hide-if-empty.js",
       "types": "./dist/hide-if-empty.d.ts"
     },
+    "./negotiation": {
+      "import": "./dist/negotiation/index.js",
+      "types": "./dist/negotiation/index.d.ts"
+    },
+    "./page-tree": {
+      "import": "./dist/page-tree/index.js",
+      "types": "./dist/page-tree/index.d.ts"
+    },
     "./search": {
       "import": "./dist/search/index.js",
       "types": "./dist/search/index.d.ts"
@@ -48,6 +60,10 @@
       "import": "./dist/source/index.js",
       "types": "./dist/source/index.d.ts"
     },
+    "./source/*": {
+      "import": "./dist/source/plugins/*.js",
+      "types": "./dist/source/plugins/*.d.ts"
+    },
     "./utils/*": {
       "import": "./dist/utils/*.js",
       "types": "./dist/utils/*.d.ts"
@@ -104,6 +120,7 @@
     "image-size": "^2.0.2",
     "negotiator": "^1.0.0",
     "npm-to-yarn": "^3.0.1",
+    "path-to-regexp": "^8.3.0",
     "react-remove-scroll": "^2.7.1",
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.1",
@@ -114,24 +131,25 @@
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
-    "@mixedbread/sdk": "^0.29.0",
+    "@mixedbread/sdk": "^0.31.1",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.132.7",
+    "@tanstack/react-router": "^1.132.31",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.5.2",
-    "@types/react": "^19.1.14",
-    "@types/react-dom": "^19.1.9",
+    "@types/node": "24.6.2",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
     "algoliasearch": "5.39.0",
+    "lucide-react": "^0.544.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "^15.5.4",
     "react-router": "^7.9.3",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
     "waku": "^0.26.1",
@@ -144,6 +162,7 @@
     "@tanstack/react-router": "1.x.x",
     "@types/react": "*",
     "algoliasearch": "5.x.x",
+    "lucide-react": "*",
     "next": "14.x.x || 15.x.x",
     "react": "18.x.x || 19.x.x",
     "react-dom": "18.x.x || 19.x.x",
@@ -180,6 +199,9 @@
     },
     "@tanstack/react-router": {
       "optional": true
+    },
+    "lucide-react": {
+      "optional": true
     }
   },
   "publishConfig": {