fumadocs-core 16.16.2 → 16.17.0

package/dist/mdx-plugins/rehype-code.js

@@ -1,5 +1,5 @@
 import { defaultShikiFactory, wasmShikiFactory } from "../highlight/shiki/full.js";
-import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BFENmmvo.js";
+import { n as rehypeCodeDefaultOptions$1, r as transformerTab, t as createRehypeCode } from "../rehype-code.core-BwH0Kyry.js";
 import { transformerIcon } from "./transformer-icon.js";
 //#region src/mdx-plugins/rehype-code.ts
 const rehypeCodeDefaultOptions = {

package/dist/mdx-plugins/rehype-toc.js

@@ -1,5 +1,4 @@
-import { a as toMdxExportRaw, r as handleTag } from "../utils-Yx0IL9eW.js";
-import { visit } from "unist-util-visit";
+import { o as toMdxExportRaw, r as handleTag, s as walk } from "../utils-2pZeFRk8.js";
 import { toEstree } from "hast-util-to-estree";
 //#region src/mdx-plugins/rehype-toc.ts
 const TocOnlyTag = "[toc]";
@@ -31,7 +30,8 @@ function rehypeToc({ exportToc = true } = {}) {
 	if (exportToc === false) return () => void 0;
 	return (tree, file) => {
 		const items = [];
-		visit(tree, "element", (element, idx, parent) => {
+		walk(tree, (element, idx, parent) => {
+			if (element.type !== "element") return;
 			if (!HeadingTags.has(element.tagName) || element.children.length === 0) return;
 			const id = element.properties.id;
 			if (typeof id !== "string") return "skip";

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

@@ -1,5 +1,4 @@
-import { t as flattenNode } from "../utils-Yx0IL9eW.js";
-import { visit } from "unist-util-visit";
+import { s as walk, t as flattenNode } from "../utils-2pZeFRk8.js";
 //#region src/mdx-plugins/remark-admonition.ts
 /**
 * Remark Plugin to support Admonition syntax
@@ -61,7 +60,7 @@ function remarkAdmonition(options = {}) {
 		}
 	}
 	return (tree) => {
-		visit(tree, (node) => {
+		walk(tree, (node) => {
 			if (!("children" in node)) return;
 			replaceNodes(node.children);
 		});

package/dist/mdx-plugins/remark-block-id.js

@@ -1,6 +1,5 @@
-import { t as flattenNode } from "../utils-Yx0IL9eW.js";
+import { s as walk, t as flattenNode } from "../utils-2pZeFRk8.js";
 import Slugger from "github-slugger";
-import { visit } from "unist-util-visit";
 import { createHash } from "node:crypto";
 //#region src/mdx-plugins/remark-block-id.ts
 /**
@@ -19,7 +18,7 @@ function remarkBlockId({ generateId, addDataAttribute = "default", shouldGenerat
 } } = {}) {
 	return (tree) => {
 		const slugger = new Slugger();
-		visit(tree, (node) => {
+		walk(tree, (node) => {
 			if (node.type === "root" || node.data?.hProperties?.id) return;
 			const resolved = shouldGenerate(node);
 			if (resolved === false) return;

package/dist/mdx-plugins/remark-code-tab.js

@@ -1,5 +1,5 @@
+import { s as walk } from "../utils-2pZeFRk8.js";
 import { generateCodeBlockTabs, parseCodeBlockAttributes } from "./codeblock-utils.js";
-import { visit } from "unist-util-visit";
 //#region src/mdx-plugins/remark-code-tab.ts
 const Types = {
 	CodeBlockTabs(processor, nodes, withMdx, withParent) {
@@ -117,7 +117,7 @@ const Types = {
 function remarkCodeTab(options = {}) {
 	const { parseMdx = false, Tabs = "CodeBlockTabs" } = options;
 	return (tree) => {
-		visit(tree, (node) => {
+		walk(tree, (node) => {
 			if (!("children" in node) || node.data?._code_tab_visited) return "skip";
 			let localTabs = Tabs;
 			let localParseMdx = parseMdx;
@@ -180,6 +180,9 @@ function processTabValue(nodes) {
 */
 function mdxToAst(processor, name) {
 	const node = processor.parse(name);
+	walk(node, (child) => {
+		delete child.position;
+	});
 	node.children = node.children.flatMap((child) => {
 		if (child.type === "paragraph") return child.children;
 		return child;

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

@@ -1,4 +1,4 @@
-import { visit } from "unist-util-visit";
+import { s as walk } from "../utils-2pZeFRk8.js";
 //#region src/mdx-plugins/remark-directive-admonition.ts
 /**
 * Remark Plugin to support Admonition syntax in Docusaurus, useful for migrating from Docusaurus.
@@ -15,8 +15,8 @@ function remarkDirectiveAdmonition({ tags: { CalloutContainer = "CalloutContaine
 	success: "success"
 } } = {}) {
 	return (tree) => {
-		visit(tree, "containerDirective", (node) => {
-			if (!(node.name in types)) return;
+		walk(tree, (node) => {
+			if (node.type !== "containerDirective" || !(node.name in types)) return;
 			const attributes = [{
 				type: "mdxJsxAttribute",
 				name: "type",

package/dist/mdx-plugins/remark-feedback-block.js

@@ -1,5 +1,4 @@
-import { t as flattenNode } from "../utils-Yx0IL9eW.js";
-import { visit } from "unist-util-visit";
+import { s as walk, t as flattenNode } from "../utils-2pZeFRk8.js";
 import { createHash } from "node:crypto";
 //#region src/mdx-plugins/remark-feedback-block.ts
 /**
@@ -18,7 +17,7 @@ function remarkFeedbackBlock({ generateHash = ({ body }) => createHash("md5").up
 }, generateBody = true } = {}) {
 	return (tree) => {
 		const counts = /* @__PURE__ */ new Map();
-		visit(tree, (node, index, parent) => {
+		walk(tree, (node, index, parent) => {
 			if (node.type === "root" || !parent || typeof index !== "number") return;
 			const resolved = resolve(node);
 			if (resolved === false) return;
@@ -37,7 +36,6 @@ function remarkFeedbackBlock({ generateHash = ({ body }) => createHash("md5").up
 					name: "id",
 					value: id
 				}],
-				data: { _stringify: "children-only" },
 				children: [node]
 			};
 			if (generateBody) wrapper.attributes.push({

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

@@ -1,8 +1,7 @@
-import { t as flattenNode } from "../utils-Yx0IL9eW.js";
+import { s as walk, t as flattenNode } from "../utils-2pZeFRk8.js";
+import { t as headingIdRegex } from "../heading-id-CUA_RA6B.js";
 import Slugger from "github-slugger";
-import { visit } from "unist-util-visit";
 //#region src/mdx-plugins/remark-heading.ts
-const regex = /\s*\[#(?<slug>[^]+?)]\s*$/;
 /**
 * Add heading ids and extract TOC
 */
@@ -15,13 +14,14 @@ function remarkHeading({ slug, customId = true, generateToc = true } = {}) {
 	return (root, file) => {
 		const toc = [];
 		slugger?.reset();
-		visit(root, "heading", (heading) => {
+		walk(root, (heading) => {
+			if (heading.type !== "heading") return;
 			heading.data ||= {};
 			heading.data.hProperties ||= {};
 			const props = heading.data.hProperties;
 			const lastNode = heading.children.at(-1);
 			if (lastNode?.type === "text" && customId) {
-				const match = regex.exec(lastNode.value);
+				const match = headingIdRegex.exec(lastNode.value);
 				if (match?.[1]) {
 					props.id = match[1];
 					lastNode.value = lastNode.value.slice(0, match.index);

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

@@ -1,4 +1,5 @@
-import { visit } from "unist-util-visit";
+import { s as walk } from "../utils-2pZeFRk8.js";
+import { replaceSource } from "./stringifier.js";
 import * as path$1 from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/mdx-plugins/remark-image.ts
@@ -30,6 +31,7 @@ function remarkImage({ placeholder = "none", external = true, useImport = true,
 					children: [],
 					type: "mdxJsxFlowElement",
 					name: "img",
+					position: node.position,
 					attributes: [{
 						type: "mdxJsxAttribute",
 						name: "alt",
@@ -76,20 +78,21 @@ function remarkImage({ placeholder = "none", external = true, useImport = true,
 			node.data.hProperties.width = size.width.toString();
 			node.data.hProperties.height = size.height.toString();
 		}
-		visit(tree, "image", (node, idx, parent) => {
-			if (typeof idx !== "number" || !parent) return;
+		walk(tree, (node, _, parent) => {
+			if (node.type !== "image" || !parent) return;
 			const src = parseSrc(decodeURI(node.url), publicDir, file.dirname);
 			if (!src) return;
 			const task = updateImage(src, node).catch((e) => {
 				if (onError === "ignore" || node.url.endsWith(".svg")) return;
 				if (onError === "hide") {
-					parent.children.splice(idx, 1);
+					replaceSource(file, node, "");
+					parent.children.splice(parent.children.indexOf(node), 1);
 					return;
 				}
 				if (onError === "error") throw e;
 				onError(e);
 			}).then((res) => {
-				if (res) parent.children[idx] = res;
+				if (res) parent.children[parent.children.indexOf(node)] = res;
 			});
 			promises.push(task);
 		});

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

@@ -1,2 +1,2 @@
-import { n as placeholder, r as remarkLLMs, t as LLMsOptions } from "../remark-llms-DxglVo94.js";
-export { LLMsOptions, placeholder, remarkLLMs };
+import { n as remarkLLMs, t as LLMsOptions } from "../remark-llms-cgVaxL_5.js";
+export { LLMsOptions, remarkLLMs };

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

@@ -1,54 +1,52 @@
-import { i as toMdxExport } from "../utils-Yx0IL9eW.js";
-import { defaultStringifier } from "./stringifier.js";
-import { defaultHandlers } from "mdast-util-to-markdown";
+import { a as toMdxExport, i as isJsxElement } from "../utils-2pZeFRk8.js";
+import { n as stringifyHeadingId } from "../heading-id-CUA_RA6B.js";
+import { createStringifier } from "./stringifier.js";
 //#region src/mdx-plugins/remark-llms.ts
+const componentNameRegex = /^[A-Z][\w$]*$/;
 /**
-* generate `llms.txt` for markdown.
+* Generate Markdown for LLMs from the authored source, other plugins can edit it with
+* `replaceSource()` from `fumadocs-core/mdx-plugins/stringifier`.
 */
-function remarkLLMs({ as = "_markdown", headingIds = true, _data = false, mdxAsPlaceholder, output = "string", ...rest } = {}) {
+function remarkLLMs({ as = "_markdown", headingIds = true, _data = false, mdxAsPlaceholder, output = "string", filterElement } = {}) {
 	const jsx = output === "function";
-	const stringifier = defaultStringifier({
-		...rest,
-		filterElement(node) {
-			switch (node.type) {
-				case "mdxjsEsm": return false;
-				default: return rest.filterElement?.(node) ?? true;
-			}
-		},
-		stringify(node, parent, state, info, collect) {
-			if (mdxAsPlaceholder && !collect) switch (node.type) {
-				case "mdxJsxFlowElement":
-				case "mdxJsxTextElement": if (node.name && mdxAsPlaceholder.includes(node.name)) return placeholder(node, parent, state, info);
+	return (tree, file) => {
+		const s = createStringifier(file);
+		const collect = [];
+		const visit = (nodes) => {
+			for (const node of nodes) {
+				const visibility = node.type === "mdxjsEsm" ? false : filterElement?.(node) ?? true;
+				if (visibility === false) {
+					s.replace(node, "");
+					continue;
+				}
+				if ("children" in node) visit(node.children);
+				if (visibility === "children-only") s.replace(node, (s) => s.inner(node));
+				else if (node.type === "heading") stringifyHeadingId(s, node, headingIds);
+				else if (isJsxElement(node) && node.name) {
+					if (!jsx && mdxAsPlaceholder?.includes(node.name)) s.replace(node, (s) => toPlaceholder(node, s.inner(node)));
+					else if (jsx && componentNameRegex.test(node.name)) s.replace(node, (s) => {
+						let children = s.inner(node);
+						if (children && node.type === "mdxJsxFlowElement") children = `\n${children}\n`;
+						return `\0${collect.push({
+							node,
+							children
+						}) - 1}\0`;
+					});
+				}
 			}
-			const custom = rest.stringify?.(node, parent, state, info, void 0);
-			if (custom) return custom;
-			if (collect) return collectJsx(node, state, info, collect);
-		},
-		handlers: {
-			heading(node, _p, state, info) {
-				const id = node.data?.hProperties?.id;
-				const defaultValue = defaultHandlers.heading(node, _p, state, info);
-				return headingIds && id ? `${defaultValue} [#${id}]` : defaultValue;
-			},
-			...rest.handlers
-		}
-	});
-	return (node, file) => {
+		};
+		visit(tree.children);
+		const text = s.stringify(tree).trim();
+		const value = text ? `${text}\n` : "";
 		if (jsx) {
-			const collect = [];
-			const text = stringifier.call(this, node, collect);
-			node.children.unshift(jsxToEstree(as, toJsxChunks(text, collect)));
+			tree.children.unshift(jsxToEstree(as, toJsxChunks(value, collect)));
 			return;
 		}
-		const value = stringifier.call(this, node, void 0);
-		node.children.unshift(toMdxExport(as, value));
+		tree.children.unshift(toMdxExport(as, value));
 		if (_data) file.data.markdown = value;
 	};
 }
-/**
-* Preserve AST data to render the MDX component at runtime, use `renderPlaceholder()` to render the placeholders.
-*/
-function placeholder(node, _parent, state, info) {
+function toPlaceholder(node, children) {
 	const attributes = {};
 	for (const attr of node.attributes) {
 		if (attr.type === "mdxJsxExpressionAttribute") continue;
@@ -56,32 +54,13 @@ function placeholder(node, _parent, state, info) {
 	}
 	return `\0${JSON.stringify({
 		name: node.name,
-		children: state.containerPhrasing(node, info),
+		children,
 		attributes
 	})}\0`;
 }
-/**
-* `stringify` branch for the `function` output: collect the element and return a marker,
-* resolved later by `toJsxChunks()`. Only components (capitalized names) are kept.
-*/
-function collectJsx(node, state, info, collect) {
-	switch (node.type) {
-		case "mdxJsxFlowElement":
-		case "mdxJsxTextElement": {
-			if (!node.name || !/^[A-Z][\w$]*$/.test(node.name)) return;
-			const entry = {
-				node,
-				children: ""
-			};
-			const marker = `\0${collect.push(entry) - 1}\0`;
-			entry.children = node.type === "mdxJsxTextElement" ? state.containerPhrasing(node, info) : state.containerFlow(node, info);
-			return marker;
-		}
-	}
-}
 const Marker = /\0(\d+)\0/g;
 /**
-* Split stringified Markdown on the markers emitted by `collectJsx()` into
+* Split stringified Markdown on the markers of kept JSX elements into
 * alternating text chunks and kept JSX elements, recursively for their children.
 */
 function toJsxChunks(text, collect) {
@@ -335,4 +314,4 @@ function programExpression(program) {
 	if (statement?.type === "ExpressionStatement") return statement.expression;
 }
 //#endregion
-export { placeholder, remarkLLMs };
+export { remarkLLMs };

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

@@ -1,2 +1,2 @@
-import { a as remarkMdxFiles, i as ToMdxOptions, n as FolderNode, r as RemarkMdxFilesOptions, t as FileNode } from "../remark-mdx-files-Buvxc-sa.js";
+import { a as remarkMdxFiles, i as ToMdxOptions, n as FolderNode, r as RemarkMdxFilesOptions, t as FileNode } from "../remark-mdx-files-NfjIpY1d.js";
 export { FileNode, FolderNode, RemarkMdxFilesOptions, ToMdxOptions, remarkMdxFiles };

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

@@ -1,18 +1,18 @@
-import { visit } from "unist-util-visit";
+import { s as walk } from "../utils-2pZeFRk8.js";
+import { replaceSource } from "./stringifier.js";
 import path from "node:path";
 //#region src/mdx-plugins/remark-mdx-files.ts
 function parseFileTree(code) {
 	const lines = code.split(/\r?\n/);
 	const stack = /* @__PURE__ */ new Map();
+	let root;
 	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++;
-		}
+		const name = line.replace(/^[\s│├└─]+/, "");
 		if (!name) continue;
+		const column = line.length - name.length;
+		let parent;
+		for (let i = column - 1; i >= 0 && !parent; i--) parent = stack.get(i);
+		const depth = parent ? parent.depth + 1 : 0;
 		const node = name.endsWith("/") ? {
 			type: "folder",
 			name,
@@ -23,17 +23,18 @@ function parseFileTree(code) {
 			name,
 			depth
 		};
-		let parent;
-		for (let i = depth - 1; i >= 0 && !parent; i--) parent = stack.get(i);
-		stack.set(depth, node);
-		if (!parent) continue;
+		stack.set(column, node);
+		if (!parent) {
+			root = node;
+			continue;
+		}
 		if (parent.type === "file") Object.assign(parent, {
 			type: "folder",
 			children: []
 		});
 		parent.children.push(node);
 	}
-	return stack.get(0);
+	return root;
 }
 function defaultToMDX(node, options, depth = 0) {
 	if (depth === 0) return {
@@ -98,11 +99,12 @@ function remarkMdxFiles(options = {}) {
 		const baseDir = file.dirname ?? file.cwd;
 		const cwd = dir ? path.join(baseDir, dir) : baseDir;
 		const files = await glob(patterns, { cwd });
+		replaceSource(file, node, `\`\`\`\n${files.join("\n")}\n\`\`\``);
 		Object.assign(node, toMdx(buildFileTreeFromGlob(cwd, files), { defaultOpenAll }));
 	}
 	return async (tree, file) => {
 		const queue = [];
-		visit(tree, ["code", "mdxJsxFlowElement"], (node) => {
+		walk(tree, (node) => {
 			if (node.type === "code") {
 				if (node.lang !== lang || !node.value) return;
 				const fileTree = parseFileTree(node.value);

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

@@ -1,4 +1,5 @@
-import { visit } from "unist-util-visit";
+import { s as walk } from "../utils-2pZeFRk8.js";
+import { replaceSource } from "./stringifier.js";
 //#region src/mdx-plugins/remark-mdx-mermaid.ts
 function toMDX(code) {
 	return {
@@ -17,9 +18,11 @@ function toMDX(code) {
 */
 function remarkMdxMermaid(options = {}) {
 	const { lang = "mermaid" } = options;
-	return (tree) => {
-		visit(tree, "code", (node, idx, parent) => {
+	return (tree, file) => {
+		walk(tree, (node, idx, parent) => {
+			if (node.type !== "code") return;
 			if (node.lang !== lang || !node.value || typeof idx !== "number" || !parent) return;
+			replaceSource(file, node, (s) => s.stringify(node));
 			parent.children[idx] = toMDX(node.value);
 		});
 	};

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

@@ -1,5 +1,6 @@
+import { s as walk } from "../utils-2pZeFRk8.js";
 import { generateCodeBlockTabs } from "./codeblock-utils.js";
-import { visit } from "unist-util-visit";
+import { replaceSource } from "./stringifier.js";
 import convert from "npm-to-yarn";
 //#region src/mdx-plugins/remark-npm.ts
 function convertLines(cmd, to) {
@@ -26,9 +27,9 @@ function remarkNpm({ persist = false, packageManagers = [
 		name: "bun"
 	}
 ] } = {}) {
-	return (tree) => {
-		visit(tree, "code", (node, idx, parent) => {
-			if (typeof idx !== "number" || !parent) return;
+	return (tree, file) => {
+		walk(tree, (node, idx, parent) => {
+			if (node.type !== "code" || typeof idx !== "number" || !parent) return;
 			let code;
 			switch (node.lang) {
 				case "package-install":
@@ -67,6 +68,7 @@ function remarkNpm({ persist = false, packageManagers = [
 					}]
 				});
 			}
+			replaceSource(file, node, (s) => s.stringify(node));
 			parent.children[idx] = generateCodeBlockTabs(options);
 			return "skip";
 		});

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

@@ -1,8 +1,12 @@
-import { r as handleTag } from "../utils-Yx0IL9eW.js";
-import { visit } from "unist-util-visit";
+import { r as handleTag, s as walk } from "../utils-2pZeFRk8.js";
+import { replaceSource } from "./stringifier.js";
 //#region src/mdx-plugins/remark-steps.ts
 const StepRegex = /^(\d+)\.\s(.+)$/;
 const StepTag = "[step]";
+function removeTag(text) {
+	const stripped = handleTag(text, StepTag);
+	return stripped === false ? text : stripped;
+}
 /**
 * Convert headings in the format of `1. Hello World` into steps.
 */
@@ -32,7 +36,7 @@ function remarkSteps({ steps = "fd-steps", step = "fd-step" } = {}) {
 			children
 		};
 	}
-	function handleHeadingStep(node) {
+	function handleHeadingStep(node, file) {
 		const head = node.children[0];
 		if (head && head.type === "text") {
 			const match = StepRegex.exec(head.value);
@@ -46,13 +50,14 @@ function remarkSteps({ steps = "fd-steps", step = "fd-step" } = {}) {
 			const step = handleTag(tail.value, StepTag);
 			if (step !== false) {
 				tail.value = step;
+				replaceSource(file, tail, (s) => removeTag(s.stringify(tail)), "search");
 				return true;
 			}
 		}
 		return false;
 	}
-	return (tree) => {
-		visit(tree, (parent) => {
+	return (tree, file) => {
+		walk(tree, (parent) => {
 			if (!("children" in parent) || parent.type === "heading") return "skip";
 			let startIdx = -1;
 			let i = 0;
@@ -76,7 +81,7 @@ function remarkSteps({ steps = "fd-steps", step = "fd-step" } = {}) {
 						continue;
 					}
 				}
-				if (!handleHeadingStep(node)) {
+				if (!handleHeadingStep(node, file)) {
 					onEnd();
 					continue;
 				}

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

@@ -1,2 +1,2 @@
-import { a as defaultStringifier, c as structure, i as StructuredData, n as StringifyOptions, o as remarkStructure, r as StructureOptions, s as remarkStructureDefaultOptions, t as Stringifier } from "../remark-structure-CnHwvNZr.js";
-export { Stringifier, StringifyOptions, StructureOptions, StructuredData, defaultStringifier, remarkStructure, remarkStructureDefaultOptions, structure };
+import { a as remarkStructureDefaultOptions, i as remarkStructure, n as StructuredData, o as structure, r as StructuredDataContent, t as StructureOptions } from "../remark-structure-C4hp7I5L.js";
+export { StructureOptions, StructuredData, StructuredDataContent, remarkStructure, remarkStructureDefaultOptions, structure };