fumadocs-core 15.7.1 → 15.7.2

package/dist/{fetch-ITPHBPBE.js → fetch-C3XV44E6.js}

@@ -3,11 +3,12 @@ import "./chunk-JSBRDJBE.js";
 // src/search/client/fetch.ts
 var cache = /* @__PURE__ */ new Map();
 async function fetchDocs(query, { api = "/api/search", locale, tag }) {
-  const params = new URLSearchParams();
-  params.set("query", query);
-  if (locale) params.set("locale", locale);
-  if (tag) params.set("tag", Array.isArray(tag) ? tag.join(",") : tag);
-  const key = `${api}?${params}`;
+  const url = new URL(api, window.location.origin);
+  url.searchParams.set("query", query);
+  if (locale) url.searchParams.set("locale", locale);
+  if (tag)
+    url.searchParams.set("tag", Array.isArray(tag) ? tag.join(",") : tag);
+  const key = `${url.pathname}?${url.searchParams}`;
   const cached = cache.get(key);
   if (cached) return cached;
   const res = await fetch(key);

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

@@ -3,10 +3,10 @@ import { Root } from 'hast';
 import { RehypeShikiOptions } from '@shikijs/rehype';
 import { Processor, Transformer } from 'unified';
 import { ShikiTransformer } from 'shiki';
-import { Root as Root$1, Code } from 'mdast';
+import { Root as Root$1, Code, BlockContent, Text } from 'mdast';
 export { a as StructureOptions, S as StructuredData, r as remarkStructure, s as structure } from '../remark-structure-DVje0Sib.js';
 export { R as RemarkHeadingOptions, r as remarkHeading } from '../remark-heading-BPCoYwjn.js';
-import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
+import { MdxJsxFlowElement, MdxJsxAttribute } from 'mdast-util-mdx-jsx';
 
 interface CodeBlockIcon {
     viewBox: string;
@@ -37,7 +37,7 @@ type RehypeCodeOptions = RehypeShikiOptions & {
      *
      * @defaultValue true
      */
-    tab?: false;
+    tab?: boolean;
     /**
      * Enable Shiki's experimental JS engine
      *
@@ -163,10 +163,14 @@ declare function remarkSteps({ steps, step, }?: RemarkStepsOptions): Transformer
 
 interface PackageManager {
     name: string;
+    /**
+     * Default to `name`
+     */
+    value?: string;
     /**
      * Convert from npm to another package manager
      */
-    command: (command: string) => string;
+    command: (command: string) => string | undefined;
 }
 interface RemarkNpmOptions {
     /**
@@ -184,4 +188,29 @@ interface RemarkNpmOptions {
  */
 declare function remarkNpm({ persist, packageManagers, }?: RemarkNpmOptions): Transformer<Root$1, Root$1>;
 
-export { type CodeBlockIcon, type RehypeCodeOptions, type RehypeTocOptions, type RemarkAdmonitionOptions, type RemarkCodeTabOptions, type RemarkImageOptions, type RemarkNpmOptions, type RemarkStepsOptions, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkImage, remarkNpm, remarkSteps, transformerIcon, transformerTab };
+interface CodeBlockTabsOptions {
+    attributes?: MdxJsxAttribute[];
+    defaultValue?: string;
+    persist?: {
+        id: string;
+    } | false;
+    triggers: {
+        value: string;
+        children: (BlockContent | Text)[];
+    }[];
+    tabs: {
+        value: string;
+        children: BlockContent[];
+    }[];
+}
+declare function generateCodeBlockTabs({ persist, defaultValue, triggers, tabs, ...options }: CodeBlockTabsOptions): MdxJsxFlowElement;
+interface CodeBlockAttributes<Name extends string = string> {
+    attributes: Partial<Record<Name, string>>;
+    rest: string;
+}
+/**
+ * Parse Fumadocs-style code block attributes from meta string, like `title="hello world"`
+ */
+declare function parseCodeBlockAttributes<Name extends string = string>(meta: string, allowedNames?: Name[]): CodeBlockAttributes<Name>;
+
+export { type CodeBlockAttributes, type CodeBlockIcon, type CodeBlockTabsOptions, type RehypeCodeOptions, type RehypeTocOptions, type RemarkAdmonitionOptions, type RemarkCodeTabOptions, type RemarkImageOptions, type RemarkNpmOptions, type RemarkStepsOptions, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkImage, remarkNpm, remarkSteps, transformerIcon, transformerTab };

package/dist/mdx-plugins/index.js

@@ -172,29 +172,87 @@ function transformerIcon(options = {}) {
   };
 }
 
-// src/mdx-plugins/rehype-code.ts
-var metaValues = [
-  {
-    name: "title",
-    regex: /title="(?<value>[^"]*)"/
-  },
-  {
-    name: "custom",
-    regex: /custom="(?<value>[^"]+)"/
-  },
-  {
-    name: "tab",
-    regex: /tab="(?<value>[^"]+)"/
-  },
-  {
-    regex: /lineNumbers=(\d+)|lineNumbers/,
-    onSet(map, args) {
-      map["data-line-numbers"] = true;
-      if (args[0] !== void 0)
-        map["data-line-numbers-start"] = Number(args[0]);
+// src/mdx-plugins/codeblock-utils.ts
+function generateCodeBlockTabs({
+  persist = false,
+  defaultValue,
+  triggers,
+  tabs,
+  ...options
+}) {
+  const attributes = [];
+  if (options.attributes) attributes.push(...options.attributes);
+  if (defaultValue) {
+    attributes.push({
+      type: "mdxJsxAttribute",
+      name: "defaultValue",
+      value: defaultValue
+    });
+  }
+  if (typeof persist === "object") {
+    attributes.push(
+      {
+        type: "mdxJsxAttribute",
+        name: "groupId",
+        value: persist.id
+      },
+      {
+        type: "mdxJsxAttribute",
+        name: "persist",
+        value: null
+      }
+    );
+  }
+  const children = [
+    {
+      type: "mdxJsxFlowElement",
+      name: "CodeBlockTabsList",
+      attributes: [],
+      children: triggers.map(
+        (trigger) => ({
+          type: "mdxJsxFlowElement",
+          attributes: [
+            { type: "mdxJsxAttribute", name: "value", value: trigger.value }
+          ],
+          name: "CodeBlockTabsTrigger",
+          children: trigger.children
+        })
+      )
     }
+  ];
+  for (const tab of tabs) {
+    children.push({
+      type: "mdxJsxFlowElement",
+      name: "CodeBlockTab",
+      attributes: [
+        { type: "mdxJsxAttribute", name: "value", value: tab.value }
+      ],
+      children: tab.children
+    });
   }
-];
+  return {
+    type: "mdxJsxFlowElement",
+    name: "CodeBlockTabs",
+    attributes,
+    children
+  };
+}
+function parseCodeBlockAttributes(meta, allowedNames) {
+  let str = meta;
+  const StringRegex = /(?<=^|\s)(?<name>\w+)=(?:"([^"]*)"|'([^']*)')/g;
+  const attributes = {};
+  str = str.replaceAll(StringRegex, (match, name, value_1, value_2) => {
+    if (allowedNames && !allowedNames.includes(name)) return match;
+    attributes[name] = value_1 ?? value_2;
+    return "";
+  });
+  return {
+    rest: str,
+    attributes
+  };
+}
+
+// src/mdx-plugins/rehype-code.ts
 var rehypeCodeDefaultOptions = {
   lazy: true,
   themes: defaultThemes,
@@ -216,22 +274,21 @@ var rehypeCodeDefaultOptions = {
     })
   ],
   parseMetaString(meta) {
-    const map = {};
-    for (const value of metaValues) {
-      meta = meta.replace(value.regex, (_, ...args) => {
-        if ("onSet" in value) {
-          value.onSet(map, args);
-        } else {
-          const first = args.at(0);
-          map[value.name] = typeof first === "string" ? first : "";
-        }
-        return "";
-      });
-    }
-    map.__parsed_raw = meta;
-    return map;
+    const parsed = parseCodeBlockAttributes(meta);
+    const data = parsed.attributes;
+    parsed.rest = parseLineNumber(parsed.rest, data);
+    data.__parsed_raw = parsed.rest;
+    return data;
   }
 };
+function parseLineNumber(str, data) {
+  return str.replace(/lineNumbers=(\d+)|lineNumbers/, (_, ...args) => {
+    data["data-line-numbers"] = true;
+    if (args[0] !== void 0)
+      data["data-line-numbers-start"] = Number(args[0]);
+    return "";
+  });
+}
 function rehypeCode(_options = {}) {
   const options = {
     ...rehypeCodeDefaultOptions,
@@ -1159,78 +1216,45 @@ function remarkNpm({
 } = {}) {
   return (tree) => {
     visit7(tree, "code", (node) => {
-      if (!node.lang || !aliases.includes(node.lang)) return "skip";
-      const value = node.value.startsWith("npm") || node.value.startsWith("npx") ? node.value : `npm install ${node.value}`;
-      const attributes = [
-        {
-          type: "mdxJsxAttribute",
-          name: "defaultValue",
-          value: packageManagers[0].name
-        }
-      ];
-      if (typeof persist === "object") {
-        attributes.push(
-          {
-            type: "mdxJsxAttribute",
-            name: "groupId",
-            value: persist.id
-          },
-          {
-            type: "mdxJsxAttribute",
-            name: "persist",
-            value: null
-          }
-        );
+      if (!node.lang || !aliases.includes(node.lang)) return;
+      let code = node.value;
+      if (node.lang === "package-install" && !code.startsWith("npm") && !code.startsWith("npx")) {
+        code = `npm install ${code}`;
       }
-      const children = [
-        {
-          type: "mdxJsxFlowElement",
-          name: "CodeBlockTabsList",
-          attributes: [],
-          children: packageManagers.map(
-            ({ name }) => ({
-              type: "mdxJsxFlowElement",
-              attributes: [
-                { type: "mdxJsxAttribute", name: "value", value: name }
-              ],
-              name: "CodeBlockTabsTrigger",
-              children: [
-                {
-                  type: "text",
-                  value: name
-                }
-              ]
-            })
-          )
-        }
-      ];
-      for (const { name, command } of packageManagers) {
-        children.push({
-          type: "mdxJsxFlowElement",
-          name: "CodeBlockTab",
-          attributes: [{ type: "mdxJsxAttribute", name: "value", value: name }],
+      const options = {
+        persist,
+        tabs: [],
+        triggers: []
+      };
+      for (const manager of packageManagers) {
+        const value = manager.value ?? manager.name;
+        const command = manager.command(code);
+        if (!command || command.length === 0) continue;
+        options.defaultValue ??= value;
+        options.triggers.push({
+          value,
+          children: [{ type: "text", value: manager.name }]
+        });
+        options.tabs.push({
+          value,
           children: [
             {
               type: "code",
               lang: "bash",
               meta: node.meta,
-              value: command(value)
+              value: command
             }
           ]
         });
       }
-      const tab = {
-        type: "mdxJsxFlowElement",
-        name: "CodeBlockTabs",
-        attributes,
-        children
-      };
-      Object.assign(node, tab);
-      return;
+      Object.assign(node, generateCodeBlockTabs(options));
+      return "skip";
     });
   };
 }
 export {
+  generateCodeBlockTabs,
+  parseCodeBlockAttributes,
   rehypeCode,
   rehypeCodeDefaultOptions,
   rehypeToc,

package/dist/search/client.js

@@ -65,7 +65,7 @@ function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty
       async function run() {
         if (debouncedValue.length === 0 && !allowEmpty) return "empty";
         if (client.type === "fetch") {
-          const { fetchDocs } = await import("../fetch-ITPHBPBE.js");
+          const { fetchDocs } = await import("../fetch-C3XV44E6.js");
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {

package/dist/source/index.d.ts

@@ -266,6 +266,7 @@ interface PageTreeBuilderContext<Page extends PageData = PageData, Meta extends
     getUrl: UrlFn;
     storages?: Record<string, ContentStorage<Page, Meta>>;
     locale?: string;
+    visitedPaths: Set<string>;
 }
 interface PageTreeTransformer<Page extends PageData = any, Meta extends MetaData = any> {
     name?: string;

package/dist/source/index.js

@@ -83,24 +83,26 @@ var rest = "...";
 var restReversed = "z...a";
 var extractPrefix = "...";
 var excludePrefix = "!";
-function buildAll(paths, ctx, filter, reversed = false) {
-  const output = [];
-  const sortedPaths = (filter ? paths.filter(filter) : [...paths]).sort(
+function buildAll(paths, ctx, reversed = false) {
+  const items = [];
+  const folders = [];
+  const sortedPaths = paths.sort(
     (a, b) => a.localeCompare(b) * (reversed ? -1 : 1)
   );
   for (const path of sortedPaths) {
+    ctx.visitedPaths.add(path);
     const fileNode = buildFileNode(path, ctx);
-    if (!fileNode) continue;
-    if (basename(path, extname(path)) === "index") output.unshift(fileNode);
-    else output.push(fileNode);
-  }
-  for (const dir of sortedPaths) {
-    const dirNode = buildFolderNode(dir, false, ctx);
-    if (dirNode) output.push(dirNode);
+    if (fileNode) {
+      if (basename(path, extname(path)) === "index") items.unshift(fileNode);
+      else items.push(fileNode);
+      continue;
+    }
+    const dirNode = buildFolderNode(path, false, ctx);
+    if (dirNode) folders.push(dirNode);
   }
-  return output;
+  return [...items, ...folders];
 }
-function resolveFolderItem(folderPath, item, ctx, idx, restNodePaths) {
+function resolveFolderItem(folderPath, item, ctx, idx) {
   if (item === rest || item === restReversed) return item;
   const { options, resolveName } = ctx;
   let match = separator.exec(item);
@@ -143,7 +145,7 @@ function resolveFolderItem(folderPath, item, ctx, idx, restNodePaths) {
     filename = item.slice(extractPrefix.length);
   }
   const path = resolveName(joinPath(folderPath, filename), "page");
-  restNodePaths.delete(path);
+  ctx.visitedPaths.add(path);
   if (isExcept) return [];
   const dirNode = buildFolderNode(path, false, ctx);
   if (dirNode) {
@@ -162,27 +164,29 @@ function buildFolderNode(folderPath, isGlobalRoot, ctx) {
   if (meta?.format !== "meta") {
     meta = void 0;
   }
-  let indexDisabled = meta?.data.root ?? isGlobalRoot;
+  const isRoot = meta?.data.root ?? isGlobalRoot;
+  let index;
   let children;
+  function setIndexIfUnused() {
+    if (isRoot || ctx.visitedPaths.has(indexPath)) return;
+    ctx.visitedPaths.add(indexPath);
+    index = buildFileNode(indexPath, ctx);
+  }
   if (!meta?.data.pages) {
+    setIndexIfUnused();
     children = buildAll(
-      files,
-      ctx,
-      (file) => indexDisabled || file !== indexPath
+      files.filter((file) => !ctx.visitedPaths.has(file)),
+      ctx
     );
   } else {
-    const restItems = new Set(files);
-    const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folderPath, item, ctx, i, restItems));
-    if (!indexDisabled && !restItems.has(indexPath)) {
-      indexDisabled = true;
-    }
+    const resolved = meta.data.pages.flatMap((item, i) => resolveFolderItem(folderPath, item, ctx, i));
+    setIndexIfUnused();
     for (let i = 0; i < resolved.length; i++) {
       const item = resolved[i];
       if (item !== rest && item !== restReversed) continue;
       const items = buildAll(
-        files,
+        files.filter((file) => !ctx.visitedPaths.has(file)),
         ctx,
-        (file) => (indexDisabled || file !== indexPath) && restItems.has(file),
         item === restReversed
       );
       resolved.splice(i, 1, ...items);
@@ -190,7 +194,6 @@ function buildFolderNode(folderPath, isGlobalRoot, ctx) {
     }
     children = resolved;
   }
-  const index = !indexDisabled ? buildFileNode(indexPath, ctx) : void 0;
   let name = meta?.data.title ?? index?.name;
   if (!name) {
     const folderName = basename(folderPath);
@@ -297,6 +300,7 @@ function createPageTreeBuilder(getUrl) {
           locale,
           storage,
           storages,
+          visitedPaths: /* @__PURE__ */ new Set(),
           resolveName(name, format) {
             return resolve(name, format) ?? name;
           }
@@ -574,7 +578,7 @@ function createOutput(options) {
         pageTree = v;
       } else {
         pageTree = {
-          defaultLanguage: v
+          [defaultLanguage]: v
         };
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.7.1",
+  "version": "15.7.2",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -118,21 +118,21 @@
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
     "@types/node": "24.3.0",
-    "@types/react": "^19.1.10",
+    "@types/react": "^19.1.11",
     "@types/react-dom": "^19.1.7",
     "algoliasearch": "5.35.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "^15.5.0",
-    "react-router": "^7.8.1",
+    "react-router": "^7.8.2",
     "remark-mdx": "^3.1.0",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.2",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
     "waku": "^0.25.0",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@mixedbread/sdk": "^0.19.0",