fumadocs-core 13.2.1 → 13.3.0

package/dist/chunk-MXOJWF66.js

@@ -0,0 +1,67 @@
+// 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
+  );
+  return matchLocale(languages, locales, defaultLanguage);
+}
+var defaultFormat = (locale, path) => {
+  return `/${locale}/${path}`;
+};
+function createI18nMiddleware({
+  languages,
+  defaultLanguage,
+  format = defaultFormat,
+  hideLocale = "never"
+}) {
+  function getUrl(request, pathname, locale) {
+    if (!locale) {
+      return new URL(
+        pathname.startsWith("/") ? pathname : `/${pathname}`,
+        request.url
+      );
+    }
+    return new URL(
+      format(locale, pathname.startsWith("/") ? pathname.slice(1) : pathname),
+      request.url
+    );
+  }
+  return (request) => {
+    const { pathname } = request.nextUrl;
+    const pathLocale = languages.find(
+      (locale) => pathname.startsWith(`/${locale}/`) || pathname === `/${locale}`
+    );
+    if (!pathLocale) {
+      if (hideLocale === "default-locale") {
+        return NextResponse.rewrite(getUrl(request, pathname, defaultLanguage));
+      }
+      const preferred = getLocale(request, languages, defaultLanguage);
+      if (hideLocale === "always") {
+        const locale = request.cookies.get(COOKIE)?.value ?? preferred;
+        return NextResponse.rewrite(getUrl(request, pathname, locale));
+      }
+      return NextResponse.redirect(getUrl(request, pathname, preferred));
+    }
+    if (hideLocale === "always") {
+      const path = pathname.slice(`/${pathLocale}`.length);
+      const res = NextResponse.redirect(getUrl(request, path));
+      res.cookies.set(COOKIE, pathLocale);
+      return res;
+    }
+    if (hideLocale === "default-locale" && pathLocale === defaultLanguage) {
+      const path = pathname.slice(`/${pathLocale}`.length);
+      return NextResponse.redirect(getUrl(request, path));
+    }
+    return NextResponse.next();
+  };
+}
+
+export {
+  createI18nMiddleware
+};

package/dist/{chunk-YKIM647L.js → chunk-UQV4A7HQ.js}

@@ -20,6 +20,12 @@ function remarkHeading({
   return (root, file) => {
     const toc = [];
     slugger.reset();
+    if (file.data.frontmatter) {
+      const frontmatter = file.data.frontmatter;
+      if (frontmatter._openapi?.toc) {
+        toc.push(...frontmatter._openapi.toc);
+      }
+    }
     visit(root, "heading", (heading) => {
       heading.data ||= {};
       heading.data.hProperties ||= {};

package/dist/config-inq6kP6y.d.ts

@@ -0,0 +1,26 @@
+interface I18nConfig {
+    /**
+     * Supported locale codes.
+     *
+     * A page tree will be built for each language.
+     */
+    languages: string[];
+    /**
+     * Default locale if not specified
+     */
+    defaultLanguage: string;
+    /**
+     * Don't show the locale prefix on URL.
+     *
+     * - `always`: Always hide the prefix
+     * - `default-locale`: Only hide the default locale
+     * - `never`: Never hide the prefix
+     *
+     * This API uses `NextResponse.rewrite`.
+     *
+     * @defaultValue 'never'
+     */
+    hideLocale?: 'always' | 'default-locale' | 'never';
+}
+
+export type { I18nConfig as I };

package/dist/i18n/index.d.ts

@@ -0,0 +1,12 @@
+import { I as I18nConfig } from '../config-inq6kP6y.js';
+import { NextMiddleware } from 'next/dist/server/web/types';
+
+interface MiddlewareOptions extends I18nConfig {
+    /**
+     * A function that adds the locale prefix to path name
+     */
+    format?: (locale: string, path: string) => string;
+}
+declare function createI18nMiddleware({ languages, defaultLanguage, format, hideLocale, }: MiddlewareOptions): NextMiddleware;
+
+export { I18nConfig, createI18nMiddleware };

package/dist/i18n/index.js

@@ -0,0 +1,7 @@
+import {
+  createI18nMiddleware
+} from "../chunk-MXOJWF66.js";
+import "../chunk-MLKGABMK.js";
+export {
+  createI18nMiddleware
+};

package/dist/mdx-plugins/index.js

@@ -1,7 +1,7 @@
 import {
   flattenNode,
   remarkHeading
-} from "../chunk-YKIM647L.js";
+} from "../chunk-UQV4A7HQ.js";
 import {
   slash
 } from "../chunk-UWEEHUJV.js";
@@ -325,7 +325,10 @@ function remarkImage({
         const hasBlur = placeholder === "blur" && VALID_BLUR_EXT.some((ext) => src.endsWith(ext));
         importsToInject.push({
           variableName,
-          importPath: slash(resolveSrc(src, publicDir))
+          importPath: slash(
+            // with imports, relative paths don't have to be absolute
+            src.startsWith("/") ? path.join(publicDir, src) : src
+          )
         });
         Object.assign(node, {
           type: "mdxJsxFlowElement",
@@ -417,6 +420,13 @@ function remarkStructure({
     slugger.reset();
     const data = { contents: [], headings: [] };
     let lastHeading = "";
+    if (file.data.frontmatter) {
+      const frontmatter = file.data.frontmatter;
+      if (frontmatter._openapi?.structuredData) {
+        data.headings.push(...frontmatter._openapi.structuredData.headings);
+        data.contents.push(...frontmatter._openapi.structuredData.contents);
+      }
+    }
     visit2(node, types, (element) => {
       if (element.type === "root") return;
       const content = flattenNode(element).trim();

package/dist/middleware.d.ts

@@ -1,31 +1,3 @@
-import { NextMiddleware } from 'next/dist/server/web/types';
-
-interface MiddlewareOptions {
-    /**
-     * Supported locale codes
-     */
-    languages: string[];
-    /**
-     * Default locale if not specified
-     */
-    defaultLanguage: string;
-    /**
-     * A function that adds the locale prefix to path name
-     */
-    format?: (locale: string, path: string) => string;
-    /**
-     * Don't show the locale prefix on URL.
-     *
-     * - `always`: Always hide the prefix
-     * - `default-locale`: Only hide the default locale
-     * - `never`: Never hide the prefix
-     *
-     * This API uses `NextResponse.rewrite`.
-     *
-     * @defaultValue 'never'
-     */
-    hideLocale?: 'always' | 'default-locale' | 'never';
-}
-declare function createI18nMiddleware({ languages, defaultLanguage, format, hideLocale, }: MiddlewareOptions): NextMiddleware;
-
-export { createI18nMiddleware };
+export { createI18nMiddleware } from './i18n/index.js';
+import './config-inq6kP6y.js';
+import 'next/dist/server/web/types';

package/dist/middleware.js

@@ -1,52 +1,7 @@
+import {
+  createI18nMiddleware
+} from "./chunk-MXOJWF66.js";
 import "./chunk-MLKGABMK.js";
-
-// src/middleware.ts
-import { match as matchLocale } from "@formatjs/intl-localematcher";
-import Negotiator from "negotiator";
-import { NextResponse } from "next/server";
-function getLocale(request, locales, defaultLanguage) {
-  const negotiatorHeaders = {};
-  request.headers.forEach((value, key) => negotiatorHeaders[key] = value);
-  const languages = new Negotiator({ headers: negotiatorHeaders }).languages(
-    locales
-  );
-  return matchLocale(languages, locales, defaultLanguage);
-}
-var defaultFormat = (locale, path) => {
-  return `/${locale}/${path}`;
-};
-function createI18nMiddleware({
-  languages,
-  defaultLanguage,
-  format = defaultFormat,
-  hideLocale = "never"
-}) {
-  function shouldHideLocale(locale) {
-    return hideLocale === "always" || hideLocale === "default-locale" && locale === defaultLanguage;
-  }
-  return (request) => {
-    const { pathname } = request.nextUrl;
-    const pathLocale = languages.find(
-      (locale) => pathname.startsWith(`/${locale}/`) || pathname === `/${locale}`
-    );
-    if (!pathLocale) {
-      const locale = getLocale(request, languages, defaultLanguage);
-      let path = pathname;
-      while (path.startsWith("/")) {
-        path = path.slice(1);
-      }
-      const url = new URL(format(locale, path), request.url);
-      return shouldHideLocale(locale) ? NextResponse.rewrite(url) : NextResponse.redirect(url);
-    }
-    if (hideLocale === "default-locale" && pathLocale === defaultLanguage) {
-      const path = pathname.slice(`/${pathLocale}`.length);
-      return NextResponse.redirect(
-        new URL(path.startsWith("/") ? path : `/${path}`, request.url)
-      );
-    }
-    return NextResponse.next();
-  };
-}
 export {
   createI18nMiddleware
 };

package/dist/search/server.d.ts

@@ -1,9 +1,33 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { S as StructuredData } from '../remark-structure-Dj8oa5Ba.js';
 import { SortedResult } from './shared.js';
+import { I as I18nConfig } from '../config-inq6kP6y.js';
 import 'mdast';
 import 'unified';
 
+interface I18nSimpleOptions extends Omit<SimpleOptions, 'language' | 'indexes'> {
+    i18n: I18nConfig;
+    indexes: WithLocale<Index>[] | Dynamic<WithLocale<Index>>;
+}
+interface I18nAdvancedOptions extends Omit<AdvancedOptions, 'language' | 'indexes'> {
+    i18n: I18nConfig;
+    indexes: WithLocale<AdvancedIndex>[] | Dynamic<WithLocale<AdvancedIndex>>;
+}
+type WithLocale<T> = T & {
+    locale: string;
+};
+declare function createI18nSearchAPI$1<T extends 'simple' | 'advanced'>(type: T, options: T extends 'simple' ? I18nSimpleOptions : I18nAdvancedOptions): SearchAPI;
+
+type ToI18n<T extends {
+    indexes: unknown;
+}> = Omit<T, 'indexes' | 'language'> & {
+    indexes: ([language: string, indexes: T['indexes']] | {
+        language: string;
+        indexes: T['indexes'];
+    })[];
+};
+declare function createI18nSearchAPI<T extends 'simple' | 'advanced'>(type: T, options: T extends 'simple' ? ToI18n<SimpleOptions> : ToI18n<AdvancedOptions>): SearchAPI;
+
 interface SearchAPI {
     GET: (request: NextRequest) => Promise<NextResponse<SortedResult[]>>;
     search: (query: string, options?: {
@@ -29,16 +53,7 @@ interface AdvancedOptions {
     tag?: boolean;
     language?: string;
 }
-type ToI18n<T extends {
-    indexes: unknown;
-}> = Omit<T, 'indexes' | 'language'> & {
-    indexes: ([language: string, indexes: T['indexes']] | {
-        language: string;
-        indexes: T['indexes'];
-    })[];
-};
 declare function createSearchAPI<T extends 'simple' | 'advanced'>(type: T, options: T extends 'simple' ? SimpleOptions : AdvancedOptions): SearchAPI;
-declare function createI18nSearchAPI<T extends 'simple' | 'advanced'>(type: T, options: T extends 'simple' ? ToI18n<SimpleOptions> : ToI18n<AdvancedOptions>): SearchAPI;
 interface Index {
     title: string;
     description?: string;
@@ -64,4 +79,4 @@ interface AdvancedIndex {
 }
 declare function initSearchAPIAdvanced({ indexes, language, tag, }: AdvancedOptions): SearchAPI;
 
-export { type AdvancedIndex, type Index, createI18nSearchAPI, createSearchAPI, initSearchAPI, initSearchAPIAdvanced };
+export { type AdvancedIndex, type AdvancedOptions, type Dynamic, type Index, type SearchAPI, type SimpleOptions, createI18nSearchAPI, createI18nSearchAPI$1 as createI18nSearchAPIExperimental, createSearchAPI, initSearchAPI, initSearchAPIAdvanced };

package/dist/search/server.js

@@ -2,8 +2,10 @@ import "../chunk-MLKGABMK.js";
 
 // src/search/server.ts
 import { Document } from "flexsearch";
+
+// src/search/create-endpoint.ts
 import { NextResponse } from "next/server";
-function create(search) {
+function createEndpoint(search) {
   return {
     search,
     async GET(request) {
@@ -18,13 +20,32 @@ function create(search) {
     }
   };
 }
-function createSearchAPI(type, options) {
-  if (type === "simple") {
-    return initSearchAPI(options);
-  }
-  return initSearchAPIAdvanced(options);
-}
+
+// src/search/i18n-api.ts
 function createI18nSearchAPI(type, options) {
+  const map = /* @__PURE__ */ new Map();
+  return createEndpoint(async (query, searchOptions) => {
+    if (map.size === 0) {
+      const indexes = typeof options.indexes === "function" ? await options.indexes() : options.indexes;
+      for (const locale of options.i18n.languages) {
+        const api = createSearchAPI(type, {
+          ...options,
+          language: locale,
+          indexes: indexes.filter((index) => index.locale === locale)
+        });
+        map.set(locale, api);
+      }
+    }
+    const handler = map.get(
+      searchOptions?.locale ?? options.i18n.defaultLanguage
+    );
+    if (handler) return handler.search(query, searchOptions);
+    return [];
+  });
+}
+
+// src/search/legacy-i18n-api.ts
+function createI18nSearchAPI2(type, options) {
   const map = /* @__PURE__ */ new Map();
   for (const entry of options.indexes) {
     const v = Array.isArray(entry) ? { language: entry[0], indexes: entry[1] } : entry;
@@ -38,7 +59,7 @@ function createI18nSearchAPI(type, options) {
       })
     );
   }
-  return create(async (query, searchOptions) => {
+  return createEndpoint(async (query, searchOptions) => {
     if (searchOptions?.locale) {
       const handler = map.get(searchOptions.locale);
       if (handler) return handler.search(query, searchOptions);
@@ -46,6 +67,14 @@ function createI18nSearchAPI(type, options) {
     return [];
   });
 }
+
+// src/search/server.ts
+function createSearchAPI(type, options) {
+  if (type === "simple") {
+    return initSearchAPI(options);
+  }
+  return initSearchAPIAdvanced(options);
+}
 function initSearchAPI({ indexes, language }) {
   const store = ["title", "url"];
   async function getDocument() {
@@ -99,7 +128,7 @@ function initSearchAPI({ indexes, language }) {
     return index;
   }
   const doc = getDocument();
-  return create(async (query) => {
+  return createEndpoint(async (query) => {
     const results = (await doc).search(query, 5, {
       enrich: true,
       suggest: true
@@ -189,7 +218,7 @@ function initSearchAPIAdvanced({
     return index;
   }
   const doc = getDocument();
-  return create(async (query, options) => {
+  return createEndpoint(async (query, options) => {
     const index = await doc;
     const results = index.search(query, 5, {
       enrich: true,
@@ -229,7 +258,8 @@ function initSearchAPIAdvanced({
   });
 }
 export {
-  createI18nSearchAPI,
+  createI18nSearchAPI2 as createI18nSearchAPI,
+  createI18nSearchAPI as createI18nSearchAPIExperimental,
   createSearchAPI,
   initSearchAPI,
   initSearchAPIAdvanced

package/dist/server/index.d.ts

@@ -1,6 +1,7 @@
 export { a as TOCItemType, T as TableOfContents, g as getTableOfContents } from '../get-toc-CM4X3hbw.js';
 import { N as Node, I as Item, R as Root } from '../page-tree-BTCDMLTU.js';
 export { p as PageTree } from '../page-tree-BTCDMLTU.js';
+export { SortedResult } from '../search/shared.js';
 import 'react';
 
 /**

package/dist/server/index.js

@@ -1,6 +1,6 @@
 import {
   remarkHeading
-} from "../chunk-YKIM647L.js";
+} from "../chunk-UQV4A7HQ.js";
 import "../chunk-MLKGABMK.js";
 
 // src/server/get-toc.ts

package/dist/sidebar.js

@@ -1,3 +1,4 @@
+"use client";
 import "./chunk-MLKGABMK.js";
 
 // src/sidebar.tsx

package/dist/source/index.d.ts

@@ -1,4 +1,5 @@
 import { ReactElement } from 'react';
+import { I as I18nConfig } from '../config-inq6kP6y.js';
 import { R as Root, I as Item, F as Folder$1, S as Separator } from '../page-tree-BTCDMLTU.js';
 
 interface FileInfo {
@@ -49,7 +50,7 @@ interface SourceConfig {
     pageData: PageData;
     metaData: MetaData;
 }
-interface LoaderOptions extends Pick<BuildPageTreeOptionsWithI18n, 'languages' | 'defaultLanguage'> {
+interface LoaderOptions {
     /**
      * @defaultValue `''`
      */
@@ -67,6 +68,24 @@ interface LoaderOptions extends Pick<BuildPageTreeOptionsWithI18n, 'languages' |
      * Additional options for page tree builder
      */
     pageTree?: Partial<Omit<BuildPageTreeOptions, 'storage' | 'getUrl'>>;
+    /**
+     * Configure i18n
+     */
+    i18n?: I18nConfig;
+    /**
+     * Accepted languages.
+     *
+     * A page tree will be built for each language.
+     *
+     * @deprecated Use `i18n` instead
+     */
+    languages?: string[];
+    /**
+     * Default locale when locale is not provided.
+     *
+     * @deprecated Use `i18n` instead
+     */
+    defaultLanguage?: string;
 }
 interface Source<Config extends SourceConfig> {
     /**
@@ -109,7 +128,7 @@ declare function getSlugs(info: FileInfo): string[];
 type InferSourceConfig<T> = T extends Source<infer Config> ? Config : never;
 declare function loader<Options extends LoaderOptions>(options: Options): LoaderOutput<{
     source: InferSourceConfig<Options['source']>;
-    i18n: Options['languages'] extends string[] ? true : false;
+    i18n: Options['i18n'] extends I18nConfig ? true : Options['languages'] extends string[] ? true : false;
 }>;
 
 interface MetaData {
@@ -201,14 +220,7 @@ interface BuildPageTreeOptions {
     resolveIcon?: (icon: string | undefined) => ReactElement | undefined;
 }
 interface BuildPageTreeOptionsWithI18n extends BuildPageTreeOptions {
-    /**
-     * Build a page tree for each language
-     */
-    languages?: string[];
-    /**
-     * Hide the locale prefix from URLs if it is same as the specified default locale.
-     */
-    defaultLanguage?: string;
+    i18n: I18nConfig;
 }
 interface PageTreeBuilder {
     build: (options: BuildPageTreeOptions) => Root;

package/dist/source/index.js

@@ -6,30 +6,33 @@ import {
 } from "../chunk-MLKGABMK.js";
 
 // src/source/path.ts
-import { parse } from "path";
 function parseFilePath(path) {
-  const normalized = normalizePath(path);
-  const parsed = parse(normalized);
-  const flattenedPath = [parsed.dir, parsed.name].filter((p) => p.length > 0).join("/");
-  const [name, locale] = parsed.name.split(".");
+  const segments = splitPath(slash(path));
+  const dirname = segments.slice(0, -1).join("/");
+  const base = segments.at(-1) ?? "";
+  const dotIdx = base.lastIndexOf(".");
+  const nameWithLocale = dotIdx !== -1 ? base.slice(0, dotIdx) : base;
+  const flattenedPath = [dirname, nameWithLocale].filter((p) => p.length > 0).join("/");
+  const [name, locale] = nameWithLocale.split(".");
   return {
-    dirname: parsed.dir,
+    dirname,
     name,
     flattenedPath,
     locale,
-    path: normalized
+    path: segments.join("/")
   };
 }
 function parseFolderPath(path) {
-  const normalized = normalizePath(path);
-  const parsed = parse(normalized);
-  const [name, locale] = parsed.base.split(".");
+  const segments = splitPath(slash(path));
+  const base = segments.at(-1) ?? "";
+  const [name, locale] = base.split(".");
+  const flattenedPath = segments.join("/");
   return {
-    dirname: parsed.dir,
+    dirname: segments.slice(0, -1).join("/"),
     name,
-    flattenedPath: normalized,
+    flattenedPath,
     locale,
-    path: normalized
+    path: flattenedPath
   };
 }
 function normalizePath(path) {
@@ -63,6 +66,8 @@ var group = /^\((?<name>.+)\)$/;
 var link = /^\[(?<text>.+)]\((?<url>.+)\)$/;
 var separator = /^---(?<name>.*?)---$/;
 var rest = "...";
+var extractPrefix = "...";
+var excludePrefix = "!";
 function buildAll(nodes, ctx, skipIndex) {
   const output = [];
   const folders = [];
@@ -106,12 +111,12 @@ function resolveFolderItem(folder, item, ctx, addedNodePaths) {
     };
     return [ctx.options.attachFile?.(node) ?? node];
   }
-  const isExcept = item.startsWith("!"), isExtract = item.startsWith("...");
+  const isExcept = item.startsWith(excludePrefix), isExtract = item.startsWith(extractPrefix);
   let filename = item;
   if (isExcept) {
-    filename = item.slice(1);
+    filename = item.slice(excludePrefix.length);
   } else if (isExtract) {
-    filename = item.slice(3);
+    filename = item.slice(extractPrefix.length);
   }
   const path = resolvePath(folder.file.path, filename);
   const itemNode = ctx.storage.readDir(path) ?? ctx.storage.read(path, "page");
@@ -173,12 +178,19 @@ function buildFolderNode(folder, isGlobalRoot, ctx) {
   );
 }
 function buildFileNode(file, ctx) {
+  let urlLocale;
   const localized = findLocalizedFile(file.file.flattenedPath, "page", ctx) ?? file;
+  const hideLocale = ctx.i18n?.hideLocale ?? "never";
+  if (hideLocale === "never") {
+    urlLocale = ctx.lang;
+  } else if (hideLocale === "default-locale" && ctx.lang !== ctx.i18n?.defaultLanguage) {
+    urlLocale = ctx.lang;
+  }
   const item = {
     type: "page",
     name: localized.data.data.title,
     icon: ctx.options.resolveIcon?.(localized.data.data.icon),
-    url: ctx.options.getUrl(localized.data.slugs, ctx.lang)
+    url: ctx.options.getUrl(localized.data.slugs, urlLocale)
   };
   return removeUndefined(ctx.options.attachFile?.(item, file) ?? item);
 }
@@ -199,13 +211,14 @@ function createPageTreeBuilder() {
         storage: options.storage
       });
     },
-    buildI18n({ languages = [], defaultLanguage, ...options }) {
-      const entries = languages.map((lang) => {
+    buildI18n({ i18n, ...options }) {
+      const entries = i18n.languages.map((lang) => {
         const tree = build({
-          lang: lang === defaultLanguage ? void 0 : lang,
+          lang,
           options,
           builder: this,
-          storage: options.storage
+          storage: options.storage,
+          i18n
         });
         return [lang, tree];
       });
@@ -324,7 +337,7 @@ function loadFiles(files, options) {
 }
 
 // src/source/loader.ts
-function buildPageMap(storage, languages, getUrl) {
+function buildPageMap(storage, getUrl, languages = []) {
   const map = /* @__PURE__ */ new Map();
   const defaultMap = /* @__PURE__ */ new Map();
   map.set("", defaultMap);
@@ -361,19 +374,30 @@ function getSlugs(info) {
   );
 }
 function loader(options) {
+  if (options.languages) {
+    console.warn(
+      "Fumadocs: It's highly recommended to use `i18n` config instead of passing `languages` to loader."
+    );
+    return createOutput({
+      ...options,
+      i18n: {
+        languages: options.languages,
+        defaultLanguage: options.defaultLanguage
+      }
+    });
+  }
   return createOutput(options);
 }
 function createOutput({
   source,
   icon: resolveIcon,
-  languages,
   rootDir = "",
   transformers,
   baseUrl = "/",
   slugs: slugsFn = getSlugs,
   url: getUrl = createGetUrl(baseUrl),
-  defaultLanguage,
-  pageTree: pageTreeOptions = {}
+  pageTree: pageTreeOptions = {},
+  i18n
 }) {
   const storage = loadFiles(
     typeof source.files === "function" ? source.files(rootDir) : source.files,
@@ -383,25 +407,24 @@ function createOutput({
       getSlugs: slugsFn
     }
   );
-  const i18nMap = buildPageMap(storage, languages ?? [], getUrl);
+  const i18nMap = buildPageMap(storage, getUrl, i18n?.languages);
   const builder = createPageTreeBuilder();
-  const pageTree = languages === void 0 ? builder.build({
+  const pageTree = i18n === void 0 ? builder.build({
     storage,
     resolveIcon,
     getUrl,
     ...pageTreeOptions
   }) : builder.buildI18n({
-    languages,
     storage,
     resolveIcon,
     getUrl,
-    defaultLanguage,
+    i18n,
     ...pageTreeOptions
   });
   return {
     pageTree,
     files: storage.list(),
-    getPages(language = "") {
+    getPages(language = i18n?.defaultLanguage ?? "") {
       return Array.from(i18nMap.get(language)?.values() ?? []);
     },
     getLanguages() {
@@ -415,7 +438,7 @@ function createOutput({
       }
       return list;
     },
-    getPage(slugs = [], language = "") {
+    getPage(slugs = [], language = i18n?.defaultLanguage ?? "") {
       return i18nMap.get(language)?.get(slugs.join("/"));
     }
   };

package/dist/toc.d.ts

@@ -3,11 +3,21 @@ import { ReactNode, RefObject, AnchorHTMLAttributes } from 'react';
 import { T as TableOfContents } from './get-toc-CM4X3hbw.js';
 
 /**
- * The id of active anchor (doesn't include hash)
+ * The estimated active heading ID
  */
 declare function useActiveAnchor(): string | undefined;
+/**
+ * The id of visible anchors
+ */
+declare function useActiveAnchors(): string[];
 interface AnchorProviderProps {
     toc: TableOfContents;
+    /**
+     * Only accept one active item at most
+     *
+     * @defaultValue true
+     */
+    single?: boolean;
     children?: ReactNode;
 }
 interface ScrollProviderProps {
@@ -18,11 +28,11 @@ interface ScrollProviderProps {
     children?: ReactNode;
 }
 declare function ScrollProvider({ containerRef, children, }: ScrollProviderProps): React.ReactElement;
-declare function AnchorProvider({ toc, children, }: AnchorProviderProps): React.ReactElement;
+declare function AnchorProvider({ toc, single, children, }: AnchorProviderProps): React.ReactElement;
 interface TOCItemProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
     href: string;
     onActiveChange?: (v: boolean) => void;
 }
 declare const TOCItem: react.ForwardRefExoticComponent<TOCItemProps & react.RefAttributes<HTMLAnchorElement>>;
 
-export { AnchorProvider, type AnchorProviderProps, ScrollProvider, type ScrollProviderProps, TOCItem, type TOCItemProps, useActiveAnchor };
+export { AnchorProvider, type AnchorProviderProps, ScrollProvider, type ScrollProviderProps, TOCItem, type TOCItemProps, useActiveAnchor, useActiveAnchors };

package/dist/toc.js

@@ -1,3 +1,4 @@
+"use client";
 import {
   useOnChange
 } from "./chunk-KGMG4N3Y.js";
@@ -22,52 +23,59 @@ function mergeRefs(...refs) {
 
 // src/utils/use-anchor-observer.ts
 import { useEffect, useState } from "react";
-function useAnchorObserver(watch) {
-  const [activeAnchor, setActiveAnchor] = useState();
+function useAnchorObserver(watch, single) {
+  const [activeAnchor, setActiveAnchor] = useState([]);
   useEffect(() => {
+    let visible = [];
     const observer = new IntersectionObserver(
       (entries) => {
-        setActiveAnchor((f) => {
-          for (const entry of entries) {
-            if (entry.isIntersecting) {
-              return entry.target.id;
-            }
+        for (const entry of entries) {
+          if (entry.isIntersecting && !visible.includes(entry.target.id)) {
+            visible = [...visible, entry.target.id];
+          } else if (!entry.isIntersecting && visible.includes(entry.target.id)) {
+            visible = visible.filter((v) => v !== entry.target.id);
           }
-          return f ?? watch[0];
-        });
+        }
+        if (visible.length > 0) setActiveAnchor(visible);
       },
-      { rootMargin: `-80px 0% -78% 0%`, threshold: 1 }
+      {
+        rootMargin: single ? "-80px 0% -70% 0%" : `-20px 0% -40% 0%`,
+        threshold: 1
+      }
     );
-    const scroll = () => {
+    function onScroll() {
       const element = document.scrollingElement;
       if (!element) return;
-      if (element.scrollTop === 0) {
-        setActiveAnchor(watch.at(0));
-      } else if (element.scrollTop >= // assume you have a 10px margin
-      element.scrollHeight - element.clientHeight - 10) {
-        setActiveAnchor(watch.at(-1));
+      if (element.scrollTop === 0 && single) setActiveAnchor(watch.slice(0, 1));
+      else if (element.scrollTop + element.clientHeight >= element.scrollHeight - 6) {
+        setActiveAnchor((active) => {
+          const last = active.at(-1);
+          return last ? watch.slice(watch.indexOf(last)) : active;
+        });
       }
-    };
-    window.addEventListener("scroll", scroll);
+    }
     for (const heading of watch) {
       const element = document.getElementById(heading);
-      if (element !== null) {
-        observer.observe(element);
-      }
+      if (element) observer.observe(element);
     }
+    onScroll();
+    window.addEventListener("scroll", onScroll);
     return () => {
-      window.removeEventListener("scroll", scroll);
+      window.removeEventListener("scroll", onScroll);
       observer.disconnect();
     };
-  }, [watch]);
-  return activeAnchor;
+  }, [single, watch]);
+  return single ? activeAnchor.slice(0, 1) : activeAnchor;
 }
 
 // src/toc.tsx
 import { jsx } from "react/jsx-runtime";
-var ActiveAnchorContext = createContext(void 0);
+var ActiveAnchorContext = createContext([]);
 var ScrollContext = createContext({ current: null });
 function useActiveAnchor() {
+  return useContext(ActiveAnchorContext).at(-1);
+}
+function useActiveAnchors() {
   return useContext(ActiveAnchorContext);
 }
 function ScrollProvider({
@@ -78,21 +86,21 @@ function ScrollProvider({
 }
 function AnchorProvider({
   toc,
+  single = true,
   children
 }) {
   const headings = useMemo(() => {
     return toc.map((item) => item.url.split("#")[1]);
   }, [toc]);
-  const activeAnchor = useAnchorObserver(headings);
-  return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: activeAnchor, children });
+  return /* @__PURE__ */ jsx(ActiveAnchorContext.Provider, { value: useAnchorObserver(headings, single), children });
 }
 var TOCItem = forwardRef(
   ({ onActiveChange, ...props }, ref) => {
     const containerRef = useContext(ScrollContext);
-    const activeAnchor = useActiveAnchor();
+    const anchors = useActiveAnchors();
     const anchorRef = useRef(null);
     const mergedRef = mergeRefs(anchorRef, ref);
-    const isActive = activeAnchor === props.href.split("#")[1];
+    const isActive = anchors.includes(props.href.slice(1));
     useOnChange(isActive, (v) => {
       const element = anchorRef.current;
       if (!element) return;
@@ -115,5 +123,6 @@ export {
   AnchorProvider,
   ScrollProvider,
   TOCItem,
-  useActiveAnchor
+  useActiveAnchor,
+  useActiveAnchors
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "13.2.1",
+  "version": "13.3.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -67,6 +67,10 @@
     "./search-algolia/server": {
       "import": "./dist/search-algolia/server.js",
       "types": "./dist/search-algolia/server.d.ts"
+    },
+    "./i18n": {
+      "import": "./dist/i18n/index.js",
+      "types": "./dist/i18n/index.d.ts"
     }
   },
   "typesVersions": {
@@ -112,6 +116,9 @@
       ],
       "search-algolia/server": [
         "./dist/search-algolia/server.d.ts"
+      ],
+      "i18n": [
+        "./dist/i18n/index.d.ts"
       ]
     }
   },
@@ -120,8 +127,8 @@
   ],
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.5.4",
-    "@shikijs/rehype": "^1.12.1",
-    "@shikijs/transformers": "^1.12.1",
+    "@shikijs/rehype": "^1.13.0",
+    "@shikijs/transformers": "^1.13.0",
     "flexsearch": "0.7.21",
     "github-slugger": "^2.0.0",
     "image-size": "^1.1.1",
@@ -132,7 +139,7 @@
     "remark-gfm": "^4.0.0",
     "remark-mdx": "^3.0.1",
     "scroll-into-view-if-needed": "^3.1.0",
-    "shiki": "^1.12.1",
+    "shiki": "^1.13.0",
     "swr": "^2.2.5",
     "unist-util-visit": "^5.0.0"
   },
@@ -144,7 +151,7 @@
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.3",
-    "@types/node": "20.14.12",
+    "@types/node": "22.3.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "algoliasearch": "^4.24.0",