fumadocs-core 15.7.5 → 15.7.7

package/dist/breadcrumb.js

@@ -81,8 +81,8 @@ function searchPath(nodes, url) {
     }
     return false;
   }
-  run(nodes);
-  return items;
+  if (run(nodes)) return items;
+  return null;
 }
 export {
   getBreadcrumbItems,

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

@@ -193,4 +193,50 @@ interface CodeBlockAttributes<Name extends string = string> {
  */
 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 RemarkImageOptions, type RemarkNpmOptions, type RemarkStepsOptions, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkImage, remarkNpm, remarkSteps, transformerIcon, transformerTab };
+interface FileNode {
+    depth: number;
+    type: 'file';
+    name: string;
+}
+interface FolderNode {
+    depth: number;
+    type: 'folder';
+    name: string;
+    children: Node[];
+}
+type Node = FileNode | FolderNode;
+interface RemarkMdxFilesOptions {
+    /**
+     * @defaultValue files
+     */
+    lang?: string;
+    toMdx?: (node: Node) => MdxJsxFlowElement;
+}
+/**
+ * Convert codeblocks with `files` as lang, like:
+ *
+ * ```files
+ * project
+ * ├── src
+ * │   ├── index.js
+ * │   └── utils
+ * │       └── helper.js
+ * ├── package.json
+ * ```
+ *
+ * into MDX `<Files />` component
+ */
+declare function remarkMdxFiles(options?: RemarkMdxFilesOptions): Transformer<Root$1, Root$1>;
+
+interface RemarkMdxMermaidOptions {
+    /**
+     * @defaultValue mermaid
+     */
+    lang?: string;
+}
+/**
+ * Convert `mermaid` codeblocks into `<Mermaid />` MDX component
+ */
+declare function remarkMdxMermaid(options?: RemarkMdxMermaidOptions): Transformer<Root$1, Root$1>;
+
+export { type CodeBlockAttributes, type CodeBlockIcon, type CodeBlockTabsOptions, type RehypeCodeOptions, type RehypeTocOptions, type RemarkAdmonitionOptions, type RemarkImageOptions, type RemarkMdxFilesOptions, type RemarkMdxMermaidOptions, type RemarkNpmOptions, type RemarkStepsOptions, generateCodeBlockTabs, parseCodeBlockAttributes, rehypeCode, rehypeCodeDefaultOptions, rehypeToc, remarkAdmonition, remarkImage, remarkMdxFiles, remarkMdxMermaid, remarkNpm, remarkSteps, transformerIcon, transformerTab };

package/dist/mdx-plugins/index.js

@@ -1216,6 +1216,107 @@ function remarkNpm({
     });
   };
 }
+
+// src/mdx-plugins/remark-mdx-files.ts
+import { visit as visit8 } from "unist-util-visit";
+function parseFileTree(code) {
+  const lines = code.split(/\r?\n/);
+  const stack = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    let depth = 0;
+    let name = line;
+    let match;
+    while (match = /(?:├──|│|└──)\s*/.exec(name)) {
+      name = name.slice(match[0].length);
+      depth++;
+    }
+    if (!name) continue;
+    const node = name.endsWith("/") ? { type: "folder", name, children: [], depth } : { type: "file", name, depth };
+    let parent;
+    for (let i = depth - 1; i >= 0 && !parent; i--) {
+      parent = stack.get(i);
+    }
+    stack.set(depth, node);
+    if (!parent) continue;
+    if (parent.type === "file") {
+      Object.assign(parent, {
+        type: "folder",
+        children: []
+      });
+    }
+    parent.children.push(node);
+  }
+  return stack.get(0);
+}
+function defaultToMDX(node, depth = 0) {
+  if (depth === 0) {
+    return {
+      type: "mdxJsxFlowElement",
+      name: "Files",
+      attributes: [],
+      children: [defaultToMDX(node, depth + 1)]
+    };
+  }
+  const attributes = [
+    { type: "mdxJsxAttribute", name: "name", value: node.name }
+  ];
+  if (node.type === "file") {
+    return {
+      type: "mdxJsxFlowElement",
+      attributes,
+      children: [],
+      name: "File"
+    };
+  }
+  attributes.push({
+    type: "mdxJsxAttribute",
+    name: "defaultOpen",
+    value: null
+  });
+  return {
+    type: "mdxJsxFlowElement",
+    attributes,
+    name: "Folder",
+    children: node.children.map((item) => defaultToMDX(item, depth + 1))
+  };
+}
+function remarkMdxFiles(options = {}) {
+  const { lang = "files", toMdx = defaultToMDX } = options;
+  return (tree) => {
+    visit8(tree, "code", (node) => {
+      if (node.lang !== lang || !node.value) return;
+      const fileTree = parseFileTree(node.value);
+      if (!fileTree) return;
+      Object.assign(node, toMdx(fileTree));
+    });
+  };
+}
+
+// src/mdx-plugins/remark-mdx-mermaid.ts
+import { visit as visit9 } from "unist-util-visit";
+function toMDX(code) {
+  return {
+    type: "mdxJsxFlowElement",
+    name: "Mermaid",
+    attributes: [
+      {
+        type: "mdxJsxAttribute",
+        name: "chart",
+        value: code.trim()
+      }
+    ],
+    children: []
+  };
+}
+function remarkMdxMermaid(options = {}) {
+  const { lang = "mermaid" } = options;
+  return (tree) => {
+    visit9(tree, "code", (node) => {
+      if (node.lang !== lang || !node.value) return;
+      Object.assign(node, toMDX(node.value));
+    });
+  };
+}
 export {
   generateCodeBlockTabs,
   parseCodeBlockAttributes,
@@ -1227,6 +1328,8 @@ export {
   default2 as remarkGfm,
   remarkHeading,
   remarkImage,
+  remarkMdxFiles,
+  remarkMdxMermaid,
   remarkNpm,
   remarkSteps,
   remarkStructure,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-core",
-  "version": "15.7.5",
+  "version": "15.7.7",
   "description": "The library for building a documentation website in Next.js",
   "keywords": [
     "NextJs",
@@ -91,7 +91,7 @@
   ],
   "dependencies": {
     "@formatjs/intl-localematcher": "^0.6.1",
-    "@orama/orama": "^3.1.11",
+    "@orama/orama": "^3.1.12",
     "@shikijs/rehype": "^3.12.0",
     "@shikijs/transformers": "^3.12.0",
     "github-slugger": "^2.0.0",
@@ -109,23 +109,23 @@
     "unist-util-visit": "^5.0.0"
   },
   "devDependencies": {
-    "@mdx-js/mdx": "^3.1.0",
+    "@mdx-js/mdx": "^3.1.1",
     "@mixedbread/sdk": "^0.26.0",
     "@oramacloud/client": "^2.1.4",
-    "@tanstack/react-router": "^1.131.28",
+    "@tanstack/react-router": "^1.131.30",
     "@types/estree-jsx": "^1.0.5",
     "@types/hast": "^3.0.4",
     "@types/mdast": "^4.0.3",
     "@types/negotiator": "^0.6.4",
     "@types/node": "24.3.0",
     "@types/react": "^19.1.12",
-    "@types/react-dom": "^19.1.8",
+    "@types/react-dom": "^19.1.9",
     "algoliasearch": "5.36.0",
     "mdast-util-mdx-jsx": "^3.2.0",
     "mdast-util-mdxjs-esm": "^2.0.1",
     "next": "^15.5.2",
     "react-router": "^7.8.2",
-    "remark-mdx": "^3.1.0",
+    "remark-mdx": "^3.1.1",
     "remove-markdown": "^0.6.2",
     "typescript": "^5.9.2",
     "unified": "^11.0.5",