fumadocs-core 16.2.3 → 16.2.5

package/dist/chunk-GINBKBVQ.js

@@ -0,0 +1,12 @@
+// src/content/mdx/util.ts
+async function resolvePlugins(def, options = []) {
+  const list = (await Promise.all(def(Array.isArray(options) ? options : []))).filter((v) => v !== false);
+  if (typeof options === "function") {
+    return Promise.all(options(list));
+  }
+  return list;
+}
+
+export {
+  resolvePlugins
+};

package/dist/{chunk-SLIKY7GW.js → chunk-JUF4WZ6G.js}

@@ -1,26 +1,31 @@
 import {
   flattenNode,
   toMdxExport
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-structure.ts
 import Slugger from "github-slugger";
 import { remark } from "remark";
 import remarkGfm from "remark-gfm";
 import { visit } from "unist-util-visit";
-function remarkStructure({
-  types = [
+var remarkStructureDefaultOptions = {
+  types: [
     "heading",
     "paragraph",
     "blockquote",
     "tableCell",
     "mdxJsxFlowElement"
   ],
-  allowedMdxAttributes = (node) => {
+  allowedMdxAttributes: (node) => {
     if (!node.name) return false;
     return ["TypeTable", "Callout"].includes(node.name);
   },
-  exportAs = false
+  exportAs: false
+};
+function remarkStructure({
+  types = remarkStructureDefaultOptions.types,
+  allowedMdxAttributes = remarkStructureDefaultOptions.allowedMdxAttributes,
+  exportAs = remarkStructureDefaultOptions.exportAs
 } = {}) {
   const slugger = new Slugger();
   if (Array.isArray(allowedMdxAttributes)) {
@@ -106,6 +111,7 @@ function structure(content, remarkPlugins = [], options = {}) {
 }
 
 export {
+  remarkStructureDefaultOptions,
   remarkStructure,
   structure
 };

package/dist/{chunk-HNZEUF6C.js → chunk-MA6O2UUE.js}

@@ -1,6 +1,6 @@
 import {
   flattenNode
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-heading.ts
 import Slugger from "github-slugger";

package/dist/{chunk-A4G5V4FQ.js → chunk-VLSDGCJE.js}

@@ -3,7 +3,7 @@ import { valueToEstree } from "estree-util-value-to-estree";
 function flattenNode(node) {
   if ("children" in node)
     return node.children.map((child) => flattenNode(child)).join("");
-  if ("value" in node) return node.value;
+  if ("value" in node && typeof node.value === "string") return node.value;
   return "";
 }
 function toMdxExport(name, value) {

package/dist/{chunk-JOXPHQ2R.js → chunk-W6WTLKRA.js}

@@ -1,6 +1,6 @@
 import {
   flattenNode
-} from "./chunk-A4G5V4FQ.js";
+} from "./chunk-VLSDGCJE.js";
 
 // src/mdx-plugins/remark-admonition.ts
 import { visit } from "unist-util-visit";

package/dist/content/mdx/preset-bundler.d.ts

@@ -0,0 +1,31 @@
+import { ProcessorOptions } from '@mdx-js/mdx';
+import { RehypeCodeOptions } from '../../mdx-plugins/rehype-code.js';
+import { RemarkImageOptions } from '../../mdx-plugins/remark-image.js';
+import { StructureOptions } from '../../mdx-plugins/remark-structure.js';
+import { RemarkHeadingOptions } from '../../mdx-plugins/remark-heading.js';
+import { RemarkCodeTabOptions } from '../../mdx-plugins/remark-code-tab.js';
+import { RemarkNpmOptions } from '../../mdx-plugins/remark-npm.js';
+import { R as ResolvePlugins } from '../../util-bZU2QeJ2.js';
+import 'hast';
+import '@shikijs/rehype';
+import 'unified';
+import 'shiki';
+import 'mdast';
+import 'mdast-util-mdx-jsx';
+
+type MDXBundlerPresetOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins'> & {
+    rehypePlugins?: ResolvePlugins;
+    remarkPlugins?: ResolvePlugins;
+    remarkStructureOptions?: StructureOptions | false;
+    remarkHeadingOptions?: RemarkHeadingOptions;
+    remarkImageOptions?: RemarkImageOptions | false;
+    remarkCodeTabOptions?: RemarkCodeTabOptions | false;
+    remarkNpmOptions?: RemarkNpmOptions | false;
+    rehypeCodeOptions?: RehypeCodeOptions | false;
+};
+/**
+ * apply MDX processor presets
+ */
+declare function mdxPreset(options?: MDXBundlerPresetOptions): Promise<ProcessorOptions>;
+
+export { type MDXBundlerPresetOptions, mdxPreset };

package/dist/content/mdx/preset-bundler.js

@@ -0,0 +1,72 @@
+import {
+  resolvePlugins
+} from "../../chunk-GINBKBVQ.js";
+import "../../chunk-U67V476Y.js";
+
+// src/content/mdx/preset-bundler.ts
+async function mdxPreset(options = {}) {
+  const {
+    rehypeCodeOptions,
+    remarkImageOptions,
+    remarkHeadingOptions,
+    remarkStructureOptions,
+    remarkCodeTabOptions,
+    remarkNpmOptions,
+    ...mdxOptions
+  } = options;
+  const remarkPlugins = await resolvePlugins(
+    (v) => [
+      import("remark-gfm").then((mod) => mod.default),
+      import("../../mdx-plugins/remark-heading.js").then((mod) => [
+        mod.remarkHeading,
+        {
+          generateToc: false,
+          ...remarkHeadingOptions
+        }
+      ]),
+      remarkImageOptions !== false && import("../../mdx-plugins/remark-image.js").then((mod) => [
+        mod.remarkImage,
+        {
+          ...remarkImageOptions,
+          useImport: remarkImageOptions?.useImport ?? true
+        }
+      ]),
+      remarkCodeTabOptions !== false && import("../../mdx-plugins/remark-code-tab.js").then((mod) => [
+        mod.remarkCodeTab,
+        remarkCodeTabOptions
+      ]),
+      remarkNpmOptions !== false && import("../../mdx-plugins/remark-npm.js").then((mod) => [
+        mod.remarkNpm,
+        remarkNpmOptions
+      ]),
+      ...v,
+      remarkStructureOptions !== false && import("../../mdx-plugins/remark-structure.js").then((mod) => [
+        mod.remarkStructure,
+        {
+          exportAs: "structuredData",
+          ...remarkStructureOptions
+        }
+      ])
+    ],
+    mdxOptions.remarkPlugins
+  );
+  const rehypePlugins = await resolvePlugins(
+    (v) => [
+      rehypeCodeOptions !== false && import("../../mdx-plugins/rehype-code.js").then((mod) => [
+        mod.rehypeCode,
+        rehypeCodeOptions
+      ]),
+      ...v,
+      import("../../mdx-plugins/rehype-toc.js").then((mod) => mod.rehypeToc)
+    ],
+    mdxOptions.rehypePlugins
+  );
+  return {
+    ...mdxOptions,
+    remarkPlugins,
+    rehypePlugins
+  };
+}
+export {
+  mdxPreset
+};

package/dist/content/mdx/preset-runtime.d.ts

@@ -0,0 +1,31 @@
+import { ProcessorOptions } from '@mdx-js/mdx';
+import { RehypeCodeOptions } from '../../mdx-plugins/rehype-code.js';
+import { RemarkImageOptions } from '../../mdx-plugins/remark-image.js';
+import { StructureOptions } from '../../mdx-plugins/remark-structure.js';
+import { RemarkHeadingOptions } from '../../mdx-plugins/remark-heading.js';
+import { RemarkCodeTabOptions } from '../../mdx-plugins/remark-code-tab.js';
+import { RemarkNpmOptions } from '../../mdx-plugins/remark-npm.js';
+import { R as ResolvePlugins } from '../../util-bZU2QeJ2.js';
+import 'hast';
+import '@shikijs/rehype';
+import 'unified';
+import 'shiki';
+import 'mdast';
+import 'mdast-util-mdx-jsx';
+
+type MDXRuntimePresetOptions = Omit<NonNullable<ProcessorOptions>, 'rehypePlugins' | 'remarkPlugins'> & {
+    rehypePlugins?: ResolvePlugins;
+    remarkPlugins?: ResolvePlugins;
+    remarkStructureOptions?: StructureOptions | false;
+    remarkHeadingOptions?: RemarkHeadingOptions;
+    remarkImageOptions?: RemarkImageOptions | false;
+    remarkCodeTabOptions?: RemarkCodeTabOptions | false;
+    remarkNpmOptions?: RemarkNpmOptions | false;
+    rehypeCodeOptions?: RehypeCodeOptions | false;
+};
+/**
+ * apply MDX processor presets
+ */
+declare function mdxPreset(options?: MDXRuntimePresetOptions): Promise<ProcessorOptions>;
+
+export { type MDXRuntimePresetOptions, mdxPreset };

package/dist/content/mdx/preset-runtime.js

@@ -0,0 +1,71 @@
+import {
+  resolvePlugins
+} from "../../chunk-GINBKBVQ.js";
+import "../../chunk-U67V476Y.js";
+
+// src/content/mdx/preset-runtime.ts
+async function mdxPreset(options = {}) {
+  const {
+    rehypeCodeOptions,
+    remarkImageOptions,
+    remarkHeadingOptions,
+    remarkStructureOptions,
+    remarkCodeTabOptions,
+    remarkNpmOptions,
+    outputFormat = "function-body",
+    ...mdxOptions
+  } = options;
+  const remarkPlugins = await resolvePlugins(
+    (v) => [
+      import("remark-gfm").then((mod) => mod.default),
+      import("../../mdx-plugins/remark-heading.js").then((mod) => [
+        mod.remarkHeading,
+        {
+          generateToc: false,
+          ...remarkHeadingOptions
+        }
+      ]),
+      remarkImageOptions !== false && import("../../mdx-plugins/remark-image.js").then((mod) => [
+        mod.remarkImage,
+        remarkImageOptions
+      ]),
+      remarkCodeTabOptions !== false && import("../../mdx-plugins/remark-code-tab.js").then((mod) => [
+        mod.remarkCodeTab,
+        remarkCodeTabOptions
+      ]),
+      remarkNpmOptions !== false && import("../../mdx-plugins/remark-npm.js").then((mod) => [
+        mod.remarkNpm,
+        remarkNpmOptions
+      ]),
+      ...v,
+      remarkStructureOptions !== false && import("../../mdx-plugins/remark-structure.js").then((mod) => [
+        mod.remarkStructure,
+        {
+          exportAs: "structuredData",
+          ...remarkStructureOptions
+        }
+      ])
+    ],
+    mdxOptions.remarkPlugins
+  );
+  const rehypePlugins = await resolvePlugins(
+    (v) => [
+      rehypeCodeOptions !== false && import("../../mdx-plugins/rehype-code.js").then((mod) => [
+        mod.rehypeCode,
+        rehypeCodeOptions
+      ]),
+      ...v,
+      import("../../mdx-plugins/rehype-toc.js").then((mod) => mod.rehypeToc)
+    ],
+    mdxOptions.rehypePlugins
+  );
+  return {
+    ...mdxOptions,
+    outputFormat,
+    remarkPlugins,
+    rehypePlugins
+  };
+}
+export {
+  mdxPreset
+};

package/dist/content/toc.js

@@ -1,7 +1,7 @@
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 
 // src/content/toc.ts

package/dist/i18n/middleware.d.ts

@@ -1,12 +1,34 @@
-import { NextProxy } from 'next/dist/server/web/types';
+import { NextProxy } from 'next/server';
 import { I18nConfig } from './index.js';
+import { NextURL } from 'next/dist/server/web/next-url';
 
 interface MiddlewareOptions extends I18nConfig {
     /**
-     * A function that adds the locale prefix to path name
+     * Either:
+     * - A formatter object
+     * - A function that adds the locale prefix to pathname
      */
-    format?: (locale: string, path: string) => string;
+    format?: URLFormatter | ((locale: string, pathname: string) => string);
+    /**
+     * the cookie to store locale code when `hideLocale` is set to `always`.
+     */
+    cookieName?: string;
+}
+interface URLFormatter {
+    /**
+     * get locale code from request URL
+     */
+    get: (url: NextURL) => string | undefined;
+    /**
+     * add locale code to request URL (which is missing the locale).
+     */
+    add: (url: NextURL, locale: string) => URL;
+    /**
+     * remove locale code from request URL
+     */
+    remove: (url: NextURL) => URL;
 }
-declare function createI18nMiddleware({ languages, defaultLanguage, format, hideLocale, }: MiddlewareOptions): NextProxy;
+declare const DefaultFormatter: URLFormatter;
+declare function createI18nMiddleware({ languages, defaultLanguage, format, cookieName, hideLocale, }: MiddlewareOptions): NextProxy;
 
-export { createI18nMiddleware };
+export { DefaultFormatter, type URLFormatter, createI18nMiddleware };

package/dist/i18n/middleware.js

@@ -6,58 +6,71 @@ import "../chunk-U67V476Y.js";
 // src/i18n/middleware.ts
 import { match as matchLocale } from "@formatjs/intl-localematcher";
 import { NextResponse } from "next/server";
-var COOKIE = "FD_LOCALE";
-function getLocale(request, locales, defaultLanguage) {
-  const languages = getNegotiator(request).languages(locales);
-  return matchLocale(languages, locales, defaultLanguage);
-}
-var defaultFormat = (locale, path) => {
-  return `/${locale}${path}`;
+var DefaultFormatter = {
+  get(url) {
+    const segs = url.pathname.split("/");
+    if (segs.length > 1 && segs[1]) return segs[1];
+  },
+  add(url, locale) {
+    const next = new URL(url);
+    next.pathname = `${url.basePath}/${locale}/${url.pathname}`.replaceAll(
+      /\/+/g,
+      "/"
+    );
+    return next;
+  },
+  remove(url) {
+    const next = new URL(url);
+    const pathname = url.pathname.split("/").slice(2).join("/");
+    next.pathname = `${url.basePath}/${pathname}`.replaceAll(/\/+/g, "/");
+    return next;
+  }
 };
 function createI18nMiddleware({
   languages,
   defaultLanguage,
-  format = defaultFormat,
+  format = DefaultFormatter,
+  cookieName = "FD_LOCALE",
   hideLocale = "never"
 }) {
-  function getLocaleUrl(request, locale) {
-    const next = new URL(request.url);
-    next.pathname = format(locale, forceSlashPrefix(request.nextUrl.pathname));
-    return next;
+  let formatter;
+  if (typeof format === "function") {
+    formatter = {
+      ...DefaultFormatter,
+      add(url, locale) {
+        const next = new URL(url);
+        next.pathname = format(locale, url.pathname);
+        return next;
+      }
+    };
+  } else {
+    formatter = format;
   }
   return (request) => {
     const url = request.nextUrl;
-    const pathLocale = languages.find(
-      (locale) => url.pathname.startsWith(`/${locale}/`) || url.pathname === `/${locale}`
-    );
+    let pathLocale = formatter.get(url);
+    if (pathLocale && !languages.includes(pathLocale)) pathLocale = void 0;
     if (!pathLocale) {
       if (hideLocale === "default-locale") {
-        return NextResponse.rewrite(getLocaleUrl(request, defaultLanguage));
+        return NextResponse.rewrite(formatter.add(url, defaultLanguage));
       }
-      const preferred = getLocale(request, languages, defaultLanguage);
+      const finalLanguages = getNegotiator(request).languages(languages);
+      const preferred = matchLocale(finalLanguages, languages, defaultLanguage);
       if (hideLocale === "always") {
-        const locale = request.cookies.get(COOKIE)?.value ?? preferred;
-        return NextResponse.rewrite(getLocaleUrl(request, locale));
+        const locale = request.cookies.get(cookieName)?.value ?? preferred;
+        return NextResponse.rewrite(formatter.add(url, locale));
       }
-      return NextResponse.redirect(getLocaleUrl(request, preferred));
+      return NextResponse.redirect(formatter.add(url, preferred));
     }
     if (hideLocale === "always" || hideLocale === "default-locale" && pathLocale === defaultLanguage) {
-      const res = NextResponse.redirect(
-        new URL(
-          forceSlashPrefix(url.pathname.slice(`/${pathLocale}`.length)),
-          request.url
-        )
-      );
-      res.cookies.set(COOKIE, pathLocale);
+      const res = NextResponse.redirect(formatter.remove(url));
+      res.cookies.set(cookieName, pathLocale);
       return res;
     }
     return NextResponse.next();
   };
 }
-function forceSlashPrefix(v) {
-  if (v.startsWith("/")) return v;
-  return "/" + v;
-}
 export {
+  DefaultFormatter,
   createI18nMiddleware
 };

package/dist/{loader-qkSHi822.d.ts → loader-BvlPPJX0.d.ts}

@@ -59,18 +59,30 @@ type _ConfigUnion_<T extends Record<string, Source>> = {
     } : never;
 }[keyof T];
 declare function multiple<T extends Record<string, Source>>(sources: T): Source<_ConfigUnion_<T>>;
+declare function source<Page extends PageData, Meta extends MetaData>(config: {
+    pages: VirtualPage<Page>[];
+    metas: VirtualMeta<Meta>[];
+}): Source<{
+    pageData: Page;
+    metaData: Meta;
+}>;
 /**
- * map virtual files in source
+ * update a source object in-place.
  */
-declare function map<Config extends SourceConfig>(source: Source<Config>): {
-    page<$Page extends PageData>(fn: (entry: VirtualPage<Config["pageData"]>) => VirtualPage<$Page>): Source<{
-        pageData: $Page;
+declare function update<Config extends SourceConfig>(source: Source<Config>): {
+    files<Page extends PageData, Meta extends MetaData>(fn: (files: VirtualFile<Config>[]) => (VirtualPage<Page> | VirtualMeta<Meta>)[]): typeof update<{
+        pageData: Page;
+        metaData: Meta;
+    }>;
+    page<V extends PageData>(fn: (page: VirtualPage<Config["pageData"]>) => VirtualPage<V>): typeof update<{
+        pageData: V;
         metaData: Config["metaData"];
     }>;
-    meta<$Meta extends MetaData>(fn: (entry: VirtualMeta<Config["metaData"]>) => VirtualMeta<$Meta>): Source<{
+    meta<V extends MetaData>(fn: (meta: VirtualMeta<Config["metaData"]>) => VirtualMeta<V>): typeof update<{
         pageData: Config["pageData"];
-        metaData: $Meta;
+        metaData: V;
     }>;
+    build(): Source<Config>;
 };
 
 /**
@@ -306,4 +318,4 @@ declare function loader<Config extends SourceConfig, I18n extends I18nConfig | u
 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;
 
-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 };
+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, type LoaderConfig as b, type LoaderOptions as c, type Page as d, type Meta as e, type LoaderOutput as f, createGetUrl as g, type InferMetaType as h, type PageTreeBuilderContext as i, type PageTreeTransformer as j, type PageTreeOptions as k, loader as l, multiple as m, type PageTreeBuilder as n, createPageTreeBuilder as o, type ContentStorageFile as p, buildContentStorage as q, type LoaderPluginOption as r, source as s, buildPlugins as t, update as u };

package/dist/mdx-plugins/index.d.ts

@@ -1,7 +1,7 @@
 export { Options as RemarkGfmOptions, default as remarkGfm } from 'remark-gfm';
 export { CodeBlockIcon, RehypeCodeOptions, rehypeCode, rehypeCodeDefaultOptions, transformerIcon, transformerTab } from './rehype-code.js';
 export { RemarkImageOptions, remarkImage } from './remark-image.js';
-export { StructureOptions, StructuredData, remarkStructure, structure } from './remark-structure.js';
+export { StructureOptions, StructuredData, remarkStructure, remarkStructureDefaultOptions, structure } from './remark-structure.js';
 export { RemarkHeadingOptions, remarkHeading } from './remark-heading.js';
 export { RemarkAdmonitionOptions, remarkAdmonition } from './remark-admonition.js';
 export { RemarkDirectiveAdmonitionOptions, remarkDirectiveAdmonition } from './remark-directive-admonition.js';

package/dist/mdx-plugins/index.js

@@ -15,8 +15,9 @@ import {
 } from "../chunk-XJ6ZQNEX.js";
 import {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
-} from "../chunk-SLIKY7GW.js";
+} from "../chunk-JUF4WZ6G.js";
 import {
   rehypeCode,
   rehypeCodeDefaultOptions,
@@ -28,7 +29,7 @@ import {
 } from "../chunk-EFVXL2PP.js";
 import {
   remarkAdmonition
-} from "../chunk-JOXPHQ2R.js";
+} from "../chunk-W6WTLKRA.js";
 import {
   remarkCodeTab
 } from "../chunk-CH7YHH7V.js";
@@ -45,8 +46,8 @@ import {
 import "../chunk-XN2LKXFZ.js";
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   generateCodeBlockTabs,
@@ -65,6 +66,7 @@ export {
   remarkNpm,
   remarkSteps,
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure,
   transformerIcon,
   transformerTab

package/dist/mdx-plugins/remark-admonition.js

@@ -1,7 +1,7 @@
 import {
   remarkAdmonition
-} from "../chunk-JOXPHQ2R.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-W6WTLKRA.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkAdmonition

package/dist/mdx-plugins/remark-heading.js

@@ -1,7 +1,7 @@
 import {
   remarkHeading
-} from "../chunk-HNZEUF6C.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-MA6O2UUE.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkHeading

package/dist/mdx-plugins/remark-structure.d.ts

@@ -52,8 +52,15 @@ declare module 'vfile' {
         structuredData: StructuredData;
     }
 }
+declare const remarkStructureDefaultOptions: {
+    types: string[];
+    allowedMdxAttributes: (node: MdxJsxFlowElement) => boolean;
+    exportAs: false;
+};
 /**
- * Attach structured data to VFile, you can access via `vfile.data.structuredData`.
+ * Extract content into structured data.
+ *
+ * By default, the output is stored into VFile (`vfile.data.structuredData`), you can specify `exportAs` to export it.
  */
 declare function remarkStructure({ types, allowedMdxAttributes, exportAs, }?: StructureOptions): Transformer<Root, Root>;
 /**
@@ -61,4 +68,4 @@ declare function remarkStructure({ types, allowedMdxAttributes, exportAs, }?: St
  */
 declare function structure(content: string, remarkPlugins?: PluggableList, options?: StructureOptions): StructuredData;
 
-export { type StructureOptions, type StructuredData, remarkStructure, structure };
+export { type StructureOptions, type StructuredData, remarkStructure, remarkStructureDefaultOptions, structure };

package/dist/mdx-plugins/remark-structure.js

@@ -1,10 +1,12 @@
 import {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
-} from "../chunk-SLIKY7GW.js";
-import "../chunk-A4G5V4FQ.js";
+} from "../chunk-JUF4WZ6G.js";
+import "../chunk-VLSDGCJE.js";
 import "../chunk-U67V476Y.js";
 export {
   remarkStructure,
+  remarkStructureDefaultOptions,
   structure
 };

package/dist/search/client.d.ts

@@ -1,3 +1,4 @@
+import { DependencyList } from 'react';
 import { AnyOrama } from '@orama/orama';
 import '../mdx-plugins/remark-structure.js';
 import { BaseIndex } from './algolia.js';
@@ -9,7 +10,6 @@ import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';
 import 'algoliasearch';
-import 'react';
 
 interface FetchOptions {
     /**
@@ -120,7 +120,7 @@ type Client = ({
 /**
  * Provide a hook to query different official search clients.
  *
- * Note: it will re-query when its parameters changed, make sure to use `useCallback()` on functions passed to this hook.
+ * Note: it will re-query when its parameters changed, make sure to use `useMemo()` on `clientOptions` or define `deps` array.
  */
 declare function useDocsSearch(clientOptions: Client & {
     /**
@@ -135,6 +135,6 @@ declare function useDocsSearch(clientOptions: Client & {
      * @defaultValue false
      */
     allowEmpty?: boolean;
-}): UseDocsSearch;
+}, deps?: DependencyList): UseDocsSearch;
 
 export { type AlgoliaOptions, type Client, type FetchOptions, type OramaCloudOptions, type StaticOptions, useDocsSearch };

package/dist/search/client.js

@@ -22,20 +22,21 @@ function useDebounce(value, delayMs = 1e3) {
 }
 
 // src/search/client.ts
-function isDifferentDeep(a, b) {
+function isDeepEqual(a, b) {
+  if (a === b) return true;
   if (Array.isArray(a) && Array.isArray(b)) {
-    return b.length !== a.length || a.some((v, i) => isDifferentDeep(v, b[i]));
+    return b.length === a.length && a.every((v, i) => isDeepEqual(v, b[i]));
   }
   if (typeof a === "object" && a && typeof b === "object" && b) {
     const aKeys = Object.keys(a);
     const bKeys = Object.keys(b);
-    return aKeys.length !== bKeys.length || aKeys.some(
-      (key) => isDifferentDeep(a[key], b[key])
+    return aKeys.length === bKeys.length && aKeys.every(
+      (key) => Object.hasOwn(b, key) && isDeepEqual(a[key], b[key])
     );
   }
-  return a !== b;
+  return false;
 }
-function useDocsSearch(clientOptions) {
+function useDocsSearch(clientOptions, deps) {
   const { delayMs = 100, allowEmpty = false, ...client } = clientOptions;
   const [search, setSearch] = useState2("");
   const [results, setResults] = useState2("empty");
@@ -44,7 +45,7 @@ function useDocsSearch(clientOptions) {
   const debouncedValue = useDebounce(search, delayMs);
   const onStart = useRef(void 0);
   useOnChange(
-    [client, debouncedValue],
+    [deps ?? clientOptions, debouncedValue],
     () => {
       if (onStart.current) {
         onStart.current();
@@ -89,7 +90,7 @@ function useDocsSearch(clientOptions) {
         setIsLoading(false);
       });
     },
-    isDifferentDeep
+    deps ? void 0 : (a, b) => !isDeepEqual(a, b)
   );
   return { search, setSearch, query: { isLoading, data: results, error } };
 }

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 { g as LoaderOutput, c as LoaderConfig, I as InferPageType } from '../loader-qkSHi822.js';
+import { f as LoaderOutput, b as LoaderConfig, I as InferPageType } from '../loader-BvlPPJX0.js';
 import 'mdast';
 import 'unified';
 import 'mdast-util-mdx-jsx';

package/dist/source/index.d.ts

@@ -1,4 +1,4 @@
-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-qkSHi822.js';
+export { C as ContentStorage, p as ContentStorageFile, F as FileSystem, h as InferMetaType, I as InferPageType, b as LoaderConfig, c as LoaderOptions, f as LoaderOutput, L as LoaderPlugin, r as LoaderPluginOption, e as Meta, M as MetaData, d as Page, P as PageData, n as PageTreeBuilder, i as PageTreeBuilderContext, k as PageTreeOptions, j as PageTreeTransformer, R as ResolvedLoaderConfig, S as Source, a as SourceConfig, V as VirtualFile, _ as _ConfigUnion_, q as buildContentStorage, t as buildPlugins, g as createGetUrl, o as createPageTreeBuilder, l as loader, m as multiple, s as source, u as update } from '../loader-BvlPPJX0.js';
 import '../definitions-pJ7PybYY.js';
 import 'react';
 import '../i18n/index.js';

package/dist/source/index.js

@@ -21,8 +21,8 @@ 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) {
+  for (const [type, source2] of Object.entries(sources)) {
+    for (const file of source2.files) {
       out.files.push({
         ...file,
         data: {
@@ -34,21 +34,33 @@ function multiple(sources) {
   }
   return out;
 }
-function map(source) {
+function source(config) {
   return {
+    files: [...config.pages, ...config.metas]
+  };
+}
+function update(source2) {
+  return {
+    files(fn) {
+      source2.files = fn(source2.files);
+      return this;
+    },
     page(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "page" ? fn(file) : file
-        )
-      };
+      for (let i = 0; i < source2.files.length; i++) {
+        const file = source2.files[i];
+        if (file.type === "page") source2.files[i] = fn(file);
+      }
+      return this;
     },
     meta(fn) {
-      return {
-        files: source.files.map(
-          (file) => file.type === "meta" ? fn(file) : file
-        )
-      };
+      for (let i = 0; i < source2.files.length; i++) {
+        const file = source2.files[i];
+        if (file.type === "meta") source2.files[i] = fn(file);
+      }
+      return this;
+    },
+    build() {
+      return source2;
     }
   };
 }
@@ -145,7 +157,7 @@ var parsers = {
 };
 function buildContentStorage(loaderConfig, defaultLanguage) {
   const {
-    source,
+    source: source2,
     plugins = [],
     i18n = {
       defaultLanguage,
@@ -156,7 +168,7 @@ function buildContentStorage(loaderConfig, defaultLanguage) {
   const parser = parsers[i18n.parser ?? "dot"];
   const storages = {};
   const normalized = /* @__PURE__ */ new Map();
-  for (const inputFile of source.files) {
+  for (const inputFile of source2.files) {
     let file;
     if (inputFile.type === "page") {
       file = {
@@ -298,15 +310,15 @@ function createPageTreeBuilder(loaderConfig) {
   };
 }
 function createFlattenPathResolver(storage) {
-  const map2 = /* @__PURE__ */ new Map();
+  const map = /* @__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);
-    map2.set(flattenPath + "." + content.format, file);
+    map.set(flattenPath + "." + content.format, file);
   }
   return (name, format) => {
-    return map2.get(name + "." + format) ?? name;
+    return map.get(name + "." + format) ?? name;
   };
 }
 function createPageTreeBuilderUtils(ctx) {
@@ -733,11 +745,11 @@ function loader(...args) {
     }
   };
 }
-function resolveConfig(source, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
+function resolveConfig(source2, { slugs, icon, plugins = [], baseUrl, url, ...base }) {
   let config = {
     ...base,
     url: url ? (...args) => normalizeUrl(url(...args)) : createGetUrl(baseUrl, base.i18n),
-    source,
+    source: source2,
     plugins: buildPlugins([
       slugsPlugin(slugs),
       icon && iconPlugin(icon),
@@ -758,6 +770,7 @@ export {
   createGetUrl,
   getSlugs,
   loader,
-  map,
-  multiple
+  multiple,
+  source,
+  update
 };

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

@@ -1,4 +1,4 @@
-import { L as LoaderPlugin } from '../../loader-qkSHi822.js';
+import { L as LoaderPlugin } from '../../loader-BvlPPJX0.js';
 import { icons } from 'lucide-react';
 import '../../definitions-pJ7PybYY.js';
 import 'react';

package/dist/util-bZU2QeJ2.d.ts

@@ -0,0 +1,6 @@
+import { Pluggable } from 'unified';
+
+type Thenable<T> = T | PromiseLike<T>;
+type ResolvePlugins = Thenable<Pluggable>[] | ((v: Pluggable[]) => Thenable<Pluggable>[]);
+
+export type { ResolvePlugins as R };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "16.2.3",
+  "version": "16.2.5",
   "description": "The React.js library for building a documentation website",
   "keywords": [
     "Fumadocs",
@@ -111,8 +111,8 @@
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.2",
     "@orama/orama": "^3.1.16",
-    "@shikijs/rehype": "^3.19.0",
-    "@shikijs/transformers": "^3.19.0",
+    "@shikijs/rehype": "^3.20.0",
+    "@shikijs/transformers": "^3.20.0",
     "estree-util-value-to-estree": "^3.5.0",
     "github-slugger": "^2.0.0",
     "hast-util-to-estree": "^3.1.3",
@@ -125,34 +125,34 @@
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^3.19.0",
+    "shiki": "^3.20.0",
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
-    "@mixedbread/sdk": "^0.45.0",
-    "@orama/core": "^1.2.13",
+    "@mixedbread/sdk": "^0.46.0",
+    "@orama/core": "^1.2.14",
     "@tanstack/react-router": "1.136.18",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.4",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.10.1",
+    "@types/node": "24.10.2",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "algoliasearch": "5.45.0",
-    "lucide-react": "^0.555.0",
+    "algoliasearch": "5.46.0",
+    "lucide-react": "^0.561.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
-    "next": "16.0.7",
-    "react-router": "^7.10.0",
+    "next": "16.0.10",
+    "react-router": "^7.10.1",
     "remark-directive": "^4.0.0",
     "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "waku": "^0.27.2",
+    "waku": "^0.27.4",
     "zod": "^4.1.13",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"