fumadocs-typescript 5.4.1 → 5.5.1

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { a as GeneratedDoc, c as RawTag, d as TypescriptConfig, f as createProject, g as GenerateTypeTableOptions, h as BaseTypeTableProps, i as GenerateOptions, l as createGenerator, m as generateHash, n as ShikiOptions, o as Generator, p as Cache, r as DocEntry, s as GeneratorOptions, t as MarkdownRenderer, u as Project } from "./markdown-CcCPhMmC.js";
 import { Root } from "mdast";
 import { Transformer } from "unified";
+import { StructuredData } from "fumadocs-core/mdx-plugins/remark-structure";
 //#region src/lib/remark-auto-type-table.d.ts
 export interface RemarkAutoTypeTableOptions {
   /**
@@ -27,6 +28,10 @@ export interface RemarkAutoTypeTableOptions {
   remarkStringify?: boolean;
   generator?: Generator;
 }
+/** the structured data of a type table, a table row without header for each prop, linked to the prop */
+export declare function typeTableToStructuredData(id: string, entries: DocEntry[]): StructuredData['contents'];
+/** a type table as Markdown: a heading, its description, and a table of its props */
+export declare function typeTableToMarkdown(doc: GeneratedDoc): string;
 export interface TypeTableProps extends BaseTypeTableProps {
   cwd?: true;
 }

package/dist/index.js

@@ -5,8 +5,9 @@ import path from "node:path";
 import { createHash } from "node:crypto";
 import fs$1 from "node:fs";
 import { valueToEstree } from "estree-util-value-to-estree";
-import { visit } from "unist-util-visit";
 import { toEstree } from "hast-util-to-estree";
+import { tableRowToStructuredData } from "fumadocs-core/search";
+import { markdownTable, replaceSource } from "fumadocs-core/mdx-plugins/stringifier";
 //#region src/lib/type-table.ts
 async function getTypeTableOutput(gen, { name, type, ...props }, options) {
 	const file = props.path && options?.basePath ? path.join(options.basePath, props.path) : props.path;
@@ -32,7 +33,7 @@ function generateHash(str) {
 }
 //#endregion
 //#region package.json
-var version = "5.4.1";
+var version = "5.5.1";
 //#endregion
 //#region src/lib/get-simple-form.ts
 function getSimpleForm(type, checker, location, options = {}) {
@@ -357,6 +358,39 @@ async function buildTypeProp(entries, renderer) {
 	for (const node of output) prop.addExpressionNode(node.name, node.node);
 	return prop.build();
 }
+/** the structured data of a type table, a table row without header for each prop, linked to the prop */
+function typeTableToStructuredData(id, entries) {
+	const contents = [];
+	for (const entry of entries) contents.push(tableRowToStructuredData({
+		table: id,
+		heading: `${id}-${entry.name}`,
+		row: typeTableRow(entry)
+	}));
+	return contents;
+}
+/** a type table as Markdown: a heading, its description, and a table of its props */
+function typeTableToMarkdown(doc) {
+	let out = `### ${doc.name}\n\n`;
+	if (doc.description) out += `${doc.description.trim()}\n\n`;
+	const rows = [[
+		"Prop",
+		"Type",
+		"Description"
+	]];
+	for (const entry of doc.entries) rows.push(typeTableRow(entry));
+	return out + markdownTable(rows);
+}
+function typeTableRow(entry) {
+	const tags = parseTags(entry.tags);
+	let description = entry.description.replace(/{@link (?<link>[^}]*)}/g, "$1").trim();
+	if (tags.default) description += `${description ? " " : ""}Default: \`${tags.default}\``;
+	if (entry.deprecated) description = `**Deprecated.** ${description}`;
+	return [
+		`\`${entry.name}${entry.required ? "" : "?"}\``,
+		`\`${entry.simplifiedType}\``,
+		description
+	];
+}
 /**
 * Compile `auto-type-table` into Fumadocs UI compatible TypeTable
 *
@@ -409,14 +443,18 @@ function remarkAutoTypeTable(config = {}) {
 				},
 				...attributes
 			],
-			children: []
+			children: [],
+			data: { structuredData: { contents: typeTableToStructuredData(`type-table-${doc.id}`, doc.entries) } }
 		});
-		return rendered;
+		return {
+			output,
+			rendered
+		};
 	}
 	return async (tree, file) => {
 		const queue = [];
-		visit(tree, "mdxJsxFlowElement", (node) => {
-			if (node.name !== name) return;
+		walk(tree, (node) => {
+			if (node.type !== "mdxJsxFlowElement" || node.name !== name) return;
 			const props = {};
 			const attributes = [];
 			const onError = (message, cause) => {
@@ -441,10 +479,13 @@ function remarkAutoTypeTable(config = {}) {
 					default: attributes.push(attr);
 				}
 			}
-			queue.push(generate(file, props, attributes).then((children) => {
+			queue.push(generate(file, props, attributes).then(({ output, rendered }) => {
+				let markdown = "";
+				for (const doc of output) markdown += `${markdown ? "\n\n" : ""}${typeTableToMarkdown(doc)}`;
+				replaceSource(file, node, markdown);
 				Object.assign(node, {
 					type: "root",
-					children
+					children: rendered
 				});
 			}).catch((err) => {
 				onError("failed to generate type table", err);
@@ -454,6 +495,11 @@ function remarkAutoTypeTable(config = {}) {
 		await Promise.all(queue);
 	};
 }
+/** visit a tree in document order, returning `skip` skips the children of a node */
+function walk(node, visitor) {
+	if (visitor(node) === "skip" || !("children" in node)) return;
+	for (const child of node.children) walk(child, visitor);
+}
 //#endregion
 //#region src/cache/fs-cache.ts
 function createFileSystemGeneratorCache(dir) {
@@ -474,4 +520,4 @@ function createFileSystemGeneratorCache(dir) {
 	};
 }
 //#endregion
-export { createFileSystemGeneratorCache, createGenerator, createProject, generateHash, remarkAutoTypeTable };
+export { createFileSystemGeneratorCache, createGenerator, createProject, generateHash, remarkAutoTypeTable, typeTableToMarkdown, typeTableToStructuredData };

package/dist/ui/index.js

@@ -47,7 +47,7 @@ function toJsx(hast) {
 		...JsxRuntime,
 		components: {
 			...defaultMdxComponents,
-			img: void 0
+			img: "img"
 		}
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-typescript",
-  "version": "5.4.1",
+  "version": "5.5.1",
   "description": "Typescript Integration for Fumadocs",
   "keywords": [
     "Docs",
@@ -39,32 +39,31 @@
     "hast-util-to-jsx-runtime": "^2.3.6",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
-    "shiki": "^4.4.3",
+    "shiki": "^4.5.0",
     "typescript": "~7.0.2",
-    "unified": "^11.0.5",
-    "unist-util-visit": "^5.1.0"
+    "unified": "^11.0.5"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@types/estree": "^1.0.9",
     "@types/hast": "^3.0.5",
     "@types/mdast": "^4.0.4",
-    "@types/node": "26.5.0",
-    "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.7",
+    "@types/node": "26.6.4",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "fumadocs-core": "16.17.1",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.17.1",
     "mdast-util-mdx": "^3.0.0",
+    "tsconfig": "0.0.0",
     "tsdown": "0.23.0",
-    "vfile": "^6.0.3",
-    "fumadocs-core": "16.15.11",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.11",
-    "tsconfig": "0.0.0"
+    "vfile": "^6.0.3"
   },
   "peerDependencies": {
     "@types/estree": "*",
     "@types/hast": "*",
     "@types/mdast": "*",
     "@types/react": "*",
-    "fumadocs-core": "^16.7.0",
+    "fumadocs-core": "^16.17.1",
     "fumadocs-ui": "^16.7.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0"