fumadocs-core 15.5.5 → 15.6.0

package/dist/{chunk-WFUH5VBX.js → chunk-62HKBTBF.js}

@@ -24,10 +24,14 @@ async function searchSimple(db, query, params = {}) {
 
 // src/search/orama/search/advanced.ts
 import { getByID, search as search2 } from "@orama/orama";
-async function searchAdvanced(db, query, tag, extraParams = {}) {
+async function searchAdvanced(db, query, tag = [], extraParams = {}) {
+  if (typeof tag === "string") tag = [tag];
   let params = {
+    ...extraParams,
     where: removeUndefined({
-      tag,
+      tags: tag.length > 0 ? {
+        containsAll: tag
+      } : void 0,
       ...extraParams.where
     }),
     groupBy: {
@@ -40,10 +44,7 @@ async function searchAdvanced(db, query, tag, extraParams = {}) {
     params = {
       ...params,
       term: query,
-      properties: ["content", "keywords"],
-      ...extraParams,
-      where: params.where,
-      groupBy: params.groupBy
+      properties: ["content"]
     };
   }
   const result = await search2(db, params);

package/dist/{fetch-ZSD7GUCX.js → fetch-YKY7NMVE.js}

@@ -4,7 +4,7 @@ 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", tag);
+  if (tag) params.set("tag", Array.isArray(tag) ? tag.join(",") : tag);
   const key = `${api}?${params}`;
   const cached = cache.get(key);
   if (cached) return cached;

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 } from 'mdast';
+import { Root as Root$1, Code } 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 'mdast-util-mdx-jsx';
+import { MdxJsxFlowElement } from 'mdast-util-mdx-jsx';
 
 interface CodeBlockIcon {
     viewBox: string;
@@ -112,7 +112,9 @@ interface RehypeTocOptions {
 }
 declare function rehypeToc(this: Processor, { exportToc }?: RehypeTocOptions): Transformer<Root, Root>;
 
+type TabType = keyof typeof Types;
 interface RemarkCodeTabOptions {
+    Tabs?: TabType;
     /**
      * Parse MDX in tab values
      *
@@ -120,6 +122,14 @@ interface RemarkCodeTabOptions {
      */
     parseMdx?: boolean;
 }
+declare const Types: {
+    CodeBlockTabs: {
+        convert(processor: Processor, nodes: Code[], withMdx?: boolean, withParent?: boolean): MdxJsxFlowElement;
+    };
+    Tabs: {
+        convert(processor: Processor, nodes: Code[], withMdx?: boolean, withParent?: boolean): MdxJsxFlowElement;
+    };
+};
 declare function remarkCodeTab(this: Processor, options?: RemarkCodeTabOptions): Transformer<Root$1, Root$1>;
 
 interface RemarkStepsOptions {
@@ -141,4 +151,27 @@ interface RemarkStepsOptions {
  */
 declare function remarkSteps({ steps, step, }?: RemarkStepsOptions): Transformer<Root$1, Root$1>;
 
-export { type CodeBlockIcon, type RehypeCodeOptions, type RehypeTocOptions, type RemarkAdmonitionOptions, type RemarkCodeTabOptions, type RemarkImageOptions, type RemarkStepsOptions, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkCodeTab, remarkImage, remarkSteps, transformerIcon, transformerTab };
+interface PackageManager {
+    name: string;
+    /**
+     * Convert from npm to another package manager
+     */
+    command: (command: string) => string;
+}
+interface RemarkNpmOptions {
+    /**
+     * Persist Tab value (Fumadocs UI only)
+     *
+     * @defaultValue false
+     */
+    persist?: {
+        id: string;
+    } | false;
+    packageManagers?: PackageManager[];
+}
+/**
+ * It generates multiple tabs of codeblocks for different package managers from a npm command codeblock.
+ */
+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 };

package/dist/mdx-plugins/index.js

@@ -281,6 +281,9 @@ function transformerTab() {
     root(root) {
       const value = this.options.meta?.tab;
       if (typeof value !== "string") return root;
+      console.warn(
+        '[Fumadocs] For `tab="value" in codeblocks, please use `remarkCodeTab` plugin instead.'
+      );
       return {
         type: "root",
         children: [
@@ -760,120 +763,61 @@ function rehypeToc({ exportToc = true } = {}) {
 // src/mdx-plugins/remark-code-tab.ts
 import { visit as visit5 } from "unist-util-visit";
 var TabRegex = /tab="(.+?)"/;
-function remarkCodeTab(options = {}) {
-  return (tree) => {
-    visit5(tree, (node) => {
-      if (!("children" in node)) return;
-      if (node.type === "mdxJsxFlowElement" && node.name === "Tabs") return;
-      let start = -1;
-      let i = 0;
-      while (i < node.children.length) {
-        const child = node.children[i];
-        const isSwitcher = child.type === "code" && child.meta && child.meta.match(TabRegex);
-        if (isSwitcher && start === -1) {
-          start = i;
-        }
-        const isLast = i === node.children.length - 1;
-        if (start !== -1 && (isLast || !isSwitcher)) {
-          const end = isSwitcher ? i + 1 : i;
-          const targets = node.children.slice(start, end);
-          node.children.splice(
-            start,
-            end - start,
-            options.parseMdx ? toTabMdx(this, targets) : toTab(targets)
-          );
-          if (isLast) break;
-          i = start + 1;
-          start = -1;
-        } else {
-          i++;
-        }
-      }
-    });
-  };
-}
-function processTabValue(nodes) {
-  return nodes.map((node, i) => {
-    let title = `Tab ${i + 1}`;
-    node.meta = node.meta?.replace(TabRegex, (_, value) => {
-      title = value;
-      return "";
-    });
-    return title;
-  });
-}
-function toTab(nodes) {
-  const names = processTabValue(nodes);
-  return {
-    type: "mdxJsxFlowElement",
-    name: "Tabs",
-    attributes: [
-      {
-        type: "mdxJsxAttribute",
-        name: "items",
-        value: {
-          type: "mdxJsxAttributeValueExpression",
-          value: names.join(", "),
-          data: {
-            estree: {
-              type: "Program",
-              sourceType: "module",
-              comments: [],
-              body: [
-                {
-                  type: "ExpressionStatement",
-                  expression: {
-                    type: "ArrayExpression",
-                    elements: names.map((name) => ({
-                      type: "Literal",
-                      value: name
-                    }))
-                  }
-                }
-              ]
+var Tabs = {
+  convert(processor, nodes, withMdx = false, withParent = true) {
+    const names = processTabValue(nodes);
+    if (!withMdx) {
+      const children2 = nodes.map((node, i) => {
+        return {
+          type: "mdxJsxFlowElement",
+          name: "Tab",
+          attributes: [
+            {
+              type: "mdxJsxAttribute",
+              name: "value",
+              value: names[i]
             }
-          }
-        }
-      }
-    ],
-    children: nodes.map((node, i) => {
+          ],
+          children: [node]
+        };
+      });
+      if (!withParent) return createFragment(children2);
       return {
         type: "mdxJsxFlowElement",
-        name: "Tab",
+        name: "Tabs",
         attributes: [
           {
             type: "mdxJsxAttribute",
-            name: "value",
-            value: names[i]
+            name: "items",
+            value: {
+              type: "mdxJsxAttributeValueExpression",
+              value: names.join(", "),
+              data: {
+                estree: {
+                  type: "Program",
+                  sourceType: "module",
+                  comments: [],
+                  body: [
+                    {
+                      type: "ExpressionStatement",
+                      expression: {
+                        type: "ArrayExpression",
+                        elements: names.map((name) => ({
+                          type: "Literal",
+                          value: name
+                        }))
+                      }
+                    }
+                  ]
+                }
+              }
+            }
           }
         ],
-        children: [node]
+        children: children2
       };
-    })
-  };
-}
-function toTabMdx(processor, nodes) {
-  const names = processTabValue(nodes);
-  function inline(node) {
-    if (node.type === "root") {
-      node.children = node.children.flatMap((child) => {
-        if (child.type === "paragraph") return child.children;
-        return child;
-      });
     }
-    return node;
-  }
-  return {
-    type: "mdxJsxFlowElement",
-    name: "Tabs",
-    attributes: [
-      {
-        type: "mdxJsxAttribute",
-        name: "defaultValue",
-        value: names[0]
-      }
-    ],
-    children: [
+    const children = [
       {
         type: "mdxJsxFlowElement",
         name: "TabsList",
@@ -890,7 +834,7 @@ function toTabMdx(processor, nodes) {
           ],
           children: [
             // eslint-disable-next-line @typescript-eslint/no-explicit-any -- needed
-            inline(processor.parse(name))
+            mdxToAst(processor, name)
           ]
         }))
       },
@@ -908,7 +852,159 @@ function toTabMdx(processor, nodes) {
           children: [node]
         })
       )
-    ]
+    ];
+    if (!withParent) return createFragment(children);
+    return {
+      type: "mdxJsxFlowElement",
+      name: "Tabs",
+      attributes: [
+        {
+          type: "mdxJsxAttribute",
+          name: "defaultValue",
+          value: names[0]
+        }
+      ],
+      children
+    };
+  }
+};
+var CodeBlockTabs = {
+  convert(processor, nodes, withMdx = false, withParent = true) {
+    const names = processTabValue(nodes);
+    const children = [
+      {
+        type: "mdxJsxFlowElement",
+        name: "CodeBlockTabsList",
+        attributes: [],
+        children: names.map((name) => {
+          return {
+            type: "mdxJsxFlowElement",
+            name: "CodeBlockTabsTrigger",
+            attributes: [
+              {
+                type: "mdxJsxAttribute",
+                name: "value",
+                value: name
+              }
+            ],
+            children: [
+              withMdx ? (
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- needed
+                mdxToAst(processor, name)
+              ) : {
+                type: "text",
+                value: name
+              }
+            ]
+          };
+        })
+      },
+      ...nodes.map((node, i) => {
+        return {
+          type: "mdxJsxFlowElement",
+          name: "CodeBlockTab",
+          attributes: [
+            {
+              type: "mdxJsxAttribute",
+              name: "value",
+              value: names[i]
+            }
+          ],
+          children: [node]
+        };
+      })
+    ];
+    if (!withParent) return createFragment(children);
+    return {
+      type: "mdxJsxFlowElement",
+      name: "CodeBlockTabs",
+      attributes: [
+        {
+          type: "mdxJsxAttribute",
+          name: "defaultValue",
+          value: names[0]
+        }
+      ],
+      children
+    };
+  }
+};
+var Types = {
+  CodeBlockTabs,
+  Tabs
+};
+function remarkCodeTab(options = {}) {
+  const { parseMdx = false, Tabs: Tabs2 = "CodeBlockTabs" } = options;
+  return (tree) => {
+    visit5(tree, (node) => {
+      if (!("children" in node)) return;
+      let start = -1;
+      let i = 0;
+      let localTabs = Tabs2;
+      let localParseMdx = parseMdx;
+      let withParent = true;
+      if (node.type === "mdxJsxFlowElement" && node.name && node.name in Types) {
+        withParent = false;
+        localTabs = node.name;
+        if (node.name === "Tabs") {
+          localParseMdx = node.attributes.every(
+            (attribute) => attribute.type !== "mdxJsxAttribute" || attribute.name !== "items"
+          );
+        }
+      }
+      while (i < node.children.length) {
+        const child = node.children[i];
+        const isSwitcher = child.type === "code" && child.meta && child.meta.match(TabRegex);
+        if (isSwitcher && start === -1) {
+          start = i;
+        }
+        const isLast = i === node.children.length - 1;
+        if (start !== -1 && (isLast || !isSwitcher)) {
+          const end = isSwitcher ? i + 1 : i;
+          const targets = node.children.slice(start, end);
+          const replacement = Types[localTabs].convert(
+            this,
+            targets,
+            localParseMdx,
+            withParent
+          );
+          node.children.splice(start, end - start, replacement);
+          if (isLast) break;
+          i = start + 1;
+          start = -1;
+        } else {
+          i++;
+        }
+      }
+    });
+  };
+}
+function processTabValue(nodes) {
+  return nodes.map((node, i) => {
+    let title = `Tab ${i + 1}`;
+    node.meta = node.meta?.replace(TabRegex, (_, value) => {
+      title = value;
+      return "";
+    });
+    return title;
+  });
+}
+function mdxToAst(processor, name) {
+  const node = processor.parse(name);
+  if (node.type === "root") {
+    node.children = node.children.flatMap((child) => {
+      if (child.type === "paragraph") return child.children;
+      return child;
+    });
+  }
+  return node;
+}
+function createFragment(children) {
+  return {
+    type: "mdxJsxFlowElement",
+    name: null,
+    attributes: [],
+    children
   };
 }
 
@@ -999,6 +1095,93 @@ function remarkSteps({
     });
   };
 }
+
+// src/mdx-plugins/remark-npm.ts
+import { visit as visit7 } from "unist-util-visit";
+import convert from "npm-to-yarn";
+var aliases = ["npm", "package-install"];
+function remarkNpm({
+  persist = false,
+  packageManagers = [
+    { command: (cmd) => convert(cmd, "npm"), name: "npm" },
+    { command: (cmd) => convert(cmd, "pnpm"), name: "pnpm" },
+    { command: (cmd) => convert(cmd, "yarn"), name: "yarn" },
+    { command: (cmd) => convert(cmd, "bun"), name: "bun" }
+  ]
+} = {}) {
+  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
+          }
+        );
+      }
+      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 }],
+          children: [
+            {
+              type: "code",
+              lang: "bash",
+              meta: node.meta,
+              value: command(value)
+            }
+          ]
+        });
+      }
+      const tab = {
+        type: "mdxJsxFlowElement",
+        name: "CodeBlockTabs",
+        attributes,
+        children
+      };
+      Object.assign(node, tab);
+      return;
+    });
+  };
+}
 export {
   rehypeCode,
   rehypeCodeDefaultOptions,
@@ -1008,6 +1191,7 @@ export {
   default2 as remarkGfm,
   remarkHeading,
   remarkImage,
+  remarkNpm,
   remarkSteps,
   remarkStructure,
   structure,

package/dist/search/client.d.ts

@@ -17,9 +17,9 @@ interface FetchOptions {
      */
     api?: string;
     /**
-     * Filter results with specific tag.
+     * Filter results with specific tag(s).
      */
-    tag?: string;
+    tag?: string | string[];
     /**
      * Filter by locale
      */
@@ -35,9 +35,9 @@ interface StaticOptions {
     from?: string;
     initOrama?: (locale?: string) => AnyOrama | Promise<AnyOrama>;
     /**
-     * Filter results with specific tag.
+     * Filter results with specific tag(s).
      */
-    tag?: string;
+    tag?: string | string[];
     /**
      * Filter by locale (unsupported at the moment)
      */

package/dist/search/client.js

@@ -64,7 +64,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-ZSD7GUCX.js");
+          const { fetchDocs } = await import("../fetch-YKY7NMVE.js");
           return fetchDocs(debouncedValue, client);
         }
         if (client.type === "algolia") {
@@ -76,7 +76,7 @@ function useDocsSearch(clientOptions, _locale, _tag, _delayMs = 100, _allowEmpty
           return searchDocs(debouncedValue, client);
         }
         if (client.type === "static") {
-          const { search: search2 } = await import("../static-QTPM5MZT.js");
+          const { search: search2 } = await import("../static-5YPNWD5F.js");
           return search2(debouncedValue, client);
         }
         throw new Error("unknown search client");

package/dist/search/server.d.ts

@@ -15,8 +15,7 @@ declare const advancedSchema: {
     readonly content: "string";
     readonly page_id: "string";
     readonly type: "string";
-    readonly keywords: "string";
-    readonly tag: "string";
+    readonly tags: "enum[]";
     readonly url: "string";
 };
 type SimpleDocument = TypedDocument<Orama<typeof simpleSchema>>;
@@ -66,7 +65,7 @@ type ExportedData = (RawData & {
 interface SearchServer {
     search: (query: string, options?: {
         locale?: string;
-        tag?: string;
+        tag?: string | string[];
     }) => Promise<SortedResult[]>;
     /**
      * Export the database
@@ -118,11 +117,14 @@ interface AdvancedIndex {
     id: string;
     title: string;
     description?: string;
+    /**
+     * @deprecated No longer used
+     */
     keywords?: string;
     /**
      * Required if tag filter is enabled
      */
-    tag?: string;
+    tag?: string | string[];
     /**
      * preprocess mdx content with `structure`
      */

package/dist/search/server.js

@@ -1,7 +1,7 @@
 import {
   searchAdvanced,
   searchSimple
-} from "../chunk-WFUH5VBX.js";
+} from "../chunk-62HKBTBF.js";
 import "../chunk-KAOEMCTI.js";
 import {
   basename,
@@ -27,7 +27,7 @@ function createEndpoint(server) {
       if (!query) return Response.json([]);
       return Response.json(
         await search(query, {
-          tag: url.searchParams.get("tag") ?? void 0,
+          tag: url.searchParams.get("tag")?.split(",") ?? void 0,
           locale: url.searchParams.get("locale") ?? void 0
         })
       );
@@ -44,8 +44,7 @@ var advancedSchema = {
   content: "string",
   page_id: "string",
   type: "string",
-  keywords: "string",
-  tag: "string",
+  tags: "enum[]",
   url: "string"
 };
 async function createDB({
@@ -65,6 +64,7 @@ async function createDB({
   });
   const mapTo = [];
   items.forEach((page) => {
+    const tags = Array.isArray(page.tag) ? page.tag : page.tag ? [page.tag] : [];
     const data = page.structuredData;
     let id = 0;
     mapTo.push({
@@ -72,15 +72,14 @@ async function createDB({
       page_id: page.id,
       type: "page",
       content: page.title,
-      keywords: page.keywords,
-      tag: page.tag,
+      tags,
       url: page.url
     });
     if (page.description) {
       mapTo.push({
         id: `${page.id}-${(id++).toString()}`,
         page_id: page.id,
-        tag: page.tag,
+        tags,
         type: "text",
         url: page.url,
         content: page.description
@@ -91,7 +90,7 @@ async function createDB({
         id: `${page.id}-${(id++).toString()}`,
         page_id: page.id,
         type: "heading",
-        tag: page.tag,
+        tags,
         url: `${page.url}#${heading.id}`,
         content: heading.content
       });
@@ -100,7 +99,7 @@ async function createDB({
       mapTo.push({
         id: `${page.id}-${(id++).toString()}`,
         page_id: page.id,
-        tag: page.tag,
+        tags,
         type: "text",
         url: content.heading ? `${page.url}#${content.heading}` : page.url,
         content: content.content

package/dist/{static-QTPM5MZT.js → static-5YPNWD5F.js}

@@ -1,7 +1,7 @@
 import {
   searchAdvanced,
   searchSimple
-} from "./chunk-WFUH5VBX.js";
+} from "./chunk-62HKBTBF.js";
 import "./chunk-KAOEMCTI.js";
 
 // src/search/client/static.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.5.5",
+  "version": "15.6.0",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -94,6 +94,7 @@
     "hast-util-to-jsx-runtime": "^2.3.6",
     "image-size": "^2.0.2",
     "negotiator": "^1.0.0",
+    "npm-to-yarn": "^3.0.1",
     "react-remove-scroll": "^2.7.1",
     "remark": "^15.0.0",
     "remark-gfm": "^4.0.1",
@@ -105,19 +106,19 @@
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.0",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.121.34",
+    "@tanstack/react-router": "^1.123.0",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
-    "@types/node": "24.0.3",
+    "@types/node": "24.0.7",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "algoliasearch": "5.29.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "^15.3.4",
-    "react-router": "^7.6.2",
+    "react-router": "^7.6.3",
     "remark-mdx": "^3.1.0",
     "typescript": "^5.8.3",
     "unified": "^11.0.5",