fumadocs-typescript 5.3.0 → 5.4.0

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import { a as GeneratedDoc, c as RawTag, d as createProject, f as Cache, h as GenerateTypeTableOptions, i as GenerateOptions, l as TypescriptConfig, m as BaseTypeTableProps, n as ShikiOptions, o as Generator, p as generateHash, r as DocEntry, s as GeneratorOptions, t as MarkdownRenderer, u as createGenerator } from "./markdown-CM2iLQC-.js";
+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";
-
 //#region src/lib/remark-auto-type-table.d.ts
 interface RemarkAutoTypeTableOptions {
   /**
@@ -41,4 +40,4 @@ declare function remarkAutoTypeTable(config?: RemarkAutoTypeTableOptions): Trans
 //#region src/cache/fs-cache.d.ts
 declare function createFileSystemGeneratorCache(dir: string): Cache;
 //#endregion
-export { Cache, DocEntry, GenerateOptions, GeneratedDoc, Generator, GeneratorOptions, type MarkdownRenderer, RawTag, RemarkAutoTypeTableOptions, TypeTableProps, TypescriptConfig, createFileSystemGeneratorCache, createGenerator, createProject, generateHash, remarkAutoTypeTable };
+export { Cache, DocEntry, GenerateOptions, GeneratedDoc, Generator, GeneratorOptions, type MarkdownRenderer, type Project, RawTag, RemarkAutoTypeTableOptions, TypeTableProps, type TypescriptConfig, createFileSystemGeneratorCache, createGenerator, createProject, generateHash, remarkAutoTypeTable };

package/dist/index.js

@@ -1,7 +1,9 @@
 import { n as markdownRenderer, t as parseTags } from "./parse-tags-Cikh_NrX.js";
+import { API, NodeBuilderFlags, ObjectFlags, SignatureKind, SymbolFlags, TypeFlags, isIntersectionType, isObjectType, isUnionType } from "typescript/unstable/sync";
 import fs from "node:fs/promises";
 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";
@@ -30,16 +32,150 @@ function generateHash(str) {
 }
 //#endregion
 //#region package.json
-var version = "5.3.0";
+var version = "5.4.0";
 //#endregion
-//#region src/lib/base.ts
+//#region src/lib/get-simple-form.ts
+function getSimpleForm(type, checker, location, options = {}) {
+	const { override, shouldSimplify, noUndefined = false } = options;
+	if ((type.flags & TypeFlags.Undefined) !== 0 && noUndefined) return "";
+	const overridden = override?.({
+		checker,
+		type,
+		location
+	});
+	if (overridden) return overridden;
+	if (shouldSimplify && !shouldSimplify({
+		checker,
+		type,
+		location
+	})) return checker.typeToString(type, location, NodeBuilderFlags.UseAliasDefinedOutsideCurrentScope);
+	const alias = type.getAliasSymbol();
+	if (alias) {
+		const args = type.getAliasTypeArguments();
+		if (args.length === 0) return alias.name;
+		const nextOptions = {
+			...options,
+			noUndefined: false
+		};
+		return `${alias.name}<${args.map((arg) => getSimpleForm(arg, checker, location, nextOptions)).join(", ")}>`;
+	}
+	if (isUnionType(type)) {
+		if (noUndefined) {
+			const members = type.getTypes().filter((t) => (t.flags & TypeFlags.Undefined) === 0);
+			if (members.length === 0) return "undefined";
+			if (members.length === 1) return getSimpleForm(members[0], checker, location, options);
+		}
+		return "union";
+	}
+	if (isIntersectionType(type)) {
+		const types = [];
+		for (const t of type.getTypes()) {
+			const str = getSimpleForm(t, checker, location, options);
+			if (str.length > 0 && str !== "never") types.unshift(str);
+		}
+		return dedupe(types).join(" & ");
+	}
+	if (isObjectType(type)) {
+		if (checker.isTupleType(type)) return "tuple";
+		if (checker.isArrayType(type)) return "array";
+		if (checker.getSignaturesOfType(type, SignatureKind.Call).length > 0) return "function";
+		return "object";
+	}
+	if ((type.flags & (TypeFlags.Primitive | TypeFlags.AnyOrUnknown | TypeFlags.Never)) === 0 && checker.getSignaturesOfType(type, SignatureKind.Call).length > 0) return "function";
+	return checker.typeToString(type, location, NodeBuilderFlags.UseAliasDefinedOutsideCurrentScope);
+}
+function dedupe(arr) {
+	const dedupe = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const item of arr) if (!dedupe.has(item)) {
+		out.push(item);
+		dedupe.add(item);
+	}
+	return out;
+}
+//#endregion
+//#region src/lib/project.ts
+function normalizePath(p) {
+	let out = path.resolve(p).replaceAll("\\", "/");
+	if (process.platform === "win32" && /^[A-Z]:/.test(out)) out = out[0].toLowerCase() + out.slice(1);
+	return out;
+}
+function readDiskFile(filePath) {
+	try {
+		return fs$1.readFileSync(filePath, "utf-8");
+	} catch {
+		return;
+	}
+}
 async function createProject(options = {}) {
-	const { Project } = await import("ts-morph");
-	return new Project({
-		tsConfigFilePath: options.tsconfigPath ?? "./tsconfig.json",
-		skipAddingFilesFromTsConfig: true
+	const tsconfigPath = normalizePath(options.tsconfigPath ?? "./tsconfig.json");
+	if (!fs$1.existsSync(tsconfigPath)) throw new Error(`tsconfig file not found: ${tsconfigPath}`);
+	const dir = path.posix.dirname(tsconfigPath);
+	/** in-memory files, overriding the file system */
+	const virtualFiles = /* @__PURE__ */ new Map();
+	/** root files of the generated tsconfig */
+	const rootFiles = /* @__PURE__ */ new Set();
+	let snapshot;
+	let configPath = `${dir}/tsconfig.fumadocs-typescript.json`;
+	for (let i = 0; fs$1.existsSync(configPath); i++) configPath = `${dir}/tsconfig.fumadocs-typescript.${i}.json`;
+	function writeConfig() {
+		virtualFiles.set(configPath, JSON.stringify({
+			extends: `./${path.posix.basename(tsconfigPath)}`,
+			include: [],
+			files: Array.from(rootFiles)
+		}));
+	}
+	const api = new API({
+		cwd: dir,
+		fs: { readFile: (fileName) => virtualFiles.get(normalizePath(fileName)) }
 	});
+	return {
+		api,
+		tsconfigPath,
+		getSourceFile(filePath, content) {
+			const key = normalizePath(filePath);
+			const changed = [];
+			const created = [];
+			if (content !== void 0) {
+				const current = virtualFiles.has(key) ? virtualFiles.get(key) : readDiskFile(key);
+				if (current !== content) {
+					virtualFiles.set(key, content);
+					if (current !== void 0) changed.push(key);
+					else created.push(key);
+				}
+			}
+			if (!rootFiles.has(key)) {
+				rootFiles.add(key);
+				writeConfig();
+				changed.push(configPath);
+			}
+			if (!snapshot) snapshot = api.updateSnapshot({ openProjects: [configPath] });
+			else if (changed.length > 0 || created.length > 0) {
+				const prev = snapshot;
+				snapshot = api.updateSnapshot({ fileChanges: {
+					changed: changed.length > 0 ? changed : void 0,
+					created: created.length > 0 ? created : void 0
+				} });
+				prev.dispose();
+			}
+			const project = snapshot.getProject(configPath);
+			if (!project) return;
+			const sourceFile = project.program.getSourceFile(key);
+			if (!sourceFile) return;
+			return {
+				project,
+				sourceFile
+			};
+		},
+		close() {
+			snapshot?.dispose();
+			snapshot = void 0;
+			api.close();
+		}
+	};
 }
+//#endregion
+//#region src/lib/base.ts
 function createGenerator(options = {}) {
 	const cache = options?.cache ? options.cache : null;
 	let instance = options?.project;
@@ -47,18 +183,6 @@ function createGenerator(options = {}) {
 		if (instance) return instance;
 		return instance = createProject(options);
 	}
-	function getSourceFile(project, filePath, fileContent) {
-		const ext = path.extname(filePath);
-		const fileBase = filePath.slice(0, -ext.length);
-		let i = 0;
-		let sourceFile = project.getSourceFile(filePath);
-		while (sourceFile && sourceFile.getFullText() !== fileContent) {
-			filePath = `${fileBase}.${i++}${ext}`;
-			sourceFile = project.getSourceFile(filePath);
-		}
-		if (sourceFile) return sourceFile;
-		return project.createSourceFile(filePath, fileContent, { overwrite: true });
-	}
 	return {
 		async generateDocumentation(file, name, options = {}) {
 			const fullPath = path.resolve(file.path);
@@ -69,20 +193,29 @@ function createGenerator(options = {}) {
 				const cached = await cache.read(cacheKey);
 				if (cached) return cached;
 			}
-			const project = await getProject();
-			const sourceFile = getSourceFile(project, fullPath, content);
+			const loaded = (await getProject()).getSourceFile(fullPath, file.content);
+			if (!loaded) throw new Error(`failed to load ${fullPath} into TypeScript project.`);
+			const { project: tsProject, sourceFile } = loaded;
+			const { checker } = tsProject;
 			const out = [];
-			for (const [k, d] of sourceFile.getExportedDeclarations()) {
-				if (d.length === 0 || !name || name !== k) continue;
-				if (d.length > 1) console.warn(`export ${k} should not have more than one type declaration.`);
-				const declaration = d[0];
+			const moduleSymbol = name ? checker.getSymbolAtLocation(sourceFile) : void 0;
+			if (moduleSymbol && name) for (const exported of checker.getExportsOfModule(moduleSymbol)) {
+				if (exported.name !== name) continue;
+				const symbol = (exported.flags & SymbolFlags.Alias) !== 0 ? checker.getAliasedSymbol(exported) : exported;
+				if (symbol.declarations.length === 0) continue;
+				if (symbol.declarations.length > 1) console.warn(`export ${name} should not have more than one type declaration.`);
+				const declaration = symbol.declarations[0].resolve(tsProject);
+				if (!declaration) continue;
+				const type = checker.getTypeAtLocation(declaration);
+				if (!type) continue;
 				const entryContext = {
 					...options,
-					program: project,
-					type: declaration.getType(),
+					program: tsProject,
+					checker,
+					type,
 					declaration
 				};
-				out.push(await generate(encodeURI(`${path.basename(file.path)}-${name}`), k, entryContext));
+				out.push(generate(encodeURI(`${path.basename(file.path)}-${name}`), name, symbol, entryContext));
 			}
 			if (cache && cacheKey) await cache.write(cacheKey, out);
 			return out;
@@ -92,43 +225,48 @@ function createGenerator(options = {}) {
 		}
 	};
 }
-async function generate(id, name, entryContext) {
-	const { ts } = await import("ts-morph");
-	const { declaration, program } = entryContext;
-	const comment = declaration.getSymbol()?.compilerSymbol.getDocumentationComment(program.getTypeChecker().compilerObject);
+function generate(id, name, symbol, entryContext) {
+	const { checker, type } = entryContext;
 	const entries = [];
-	for (const prop of declaration.getType().getProperties()) {
-		const out = await getDocEntry(prop, entryContext);
+	for (const prop of checker.getPropertiesOfType(type)) {
+		const out = getDocEntry(prop, entryContext);
 		if (out) entries.push(out);
 	}
 	return {
 		id,
 		name,
-		description: comment ? ts.displayPartsToString(comment) : void 0,
+		description: checker.getDocumentationCommentOfSymbol(symbol),
 		entries
 	};
 }
-async function getDocEntry(prop, context) {
-	const { ts } = await import("ts-morph");
-	const { getSimpleForm } = await import("./get-simple-form-B_lm5cA2.js");
-	const { transform, allowInternal = false, program } = context;
-	if (context.type.isClass() && prop.getName().startsWith("#")) return;
-	const subType = prop.getTypeAtLocation(context.declaration);
-	const isOptional = prop.isOptional();
+function isClassType(type) {
+	return isObjectType(type) && (type.objectFlags & ObjectFlags.Class) !== 0;
+}
+/**
+* Private class members (`#name`) are exposed with their escaped name (`__#1@#name`) by TypeScript.
+*/
+function isPrivateIdentifierName(name) {
+	return name.startsWith("#") || name.startsWith("__#");
+}
+function getDocEntry(prop, context) {
+	const { transform, allowInternal = false, checker, declaration } = context;
+	if (isClassType(context.type) && isPrivateIdentifierName(prop.name)) return;
+	const subType = checker.getTypeOfSymbolAtLocation(prop, declaration);
+	const isOptional = (prop.flags & SymbolFlags.Optional) !== 0;
 	const tags = [];
-	for (const tag of prop.getJsDocTags()) {
-		if (!allowInternal && tag.getName() === "internal") return;
+	for (const tag of checker.getJsDocTagsOfSymbol(prop)) {
+		if (!allowInternal && tag.name === "internal") return;
 		tags.push({
-			name: tag.getName(),
-			text: ts.displayPartsToString(tag.getText())
+			name: tag.name,
+			text: tag.text ?? ""
 		});
 	}
 	const entry = {
-		name: prop.getName(),
-		description: ts.displayPartsToString(prop.compilerSymbol.getDocumentationComment(program.getTypeChecker().compilerObject)),
+		name: prop.name,
+		description: checker.getDocumentationCommentOfSymbol(prop),
 		tags,
-		type: subType.getText(context.declaration, ts.TypeFormatFlags.UseAliasDefinedOutsideCurrentScope | ts.TypeFormatFlags.NoTruncation),
-		simplifiedType: getSimpleForm(subType, program.getTypeChecker(), context.declaration, {
+		type: checker.typeToString(subType, declaration, NodeBuilderFlags.UseAliasDefinedOutsideCurrentScope | NodeBuilderFlags.NoTruncation),
+		simplifiedType: getSimpleForm(subType, checker, declaration, {
 			...context.typeSimplifier,
 			noUndefined: isOptional
 		}),
@@ -151,9 +289,7 @@ async function getDocEntry(prop, context) {
 			if (content.length > 0) entry.typeHref = content;
 			break;
 		}
-		case "deprecated":
-			entry.deprecated = true;
-			break;
+		case "deprecated": entry.deprecated = true;
 	}
 	transform?.call(context, entry, subType, prop);
 	return entry;

package/dist/{markdown-CM2iLQC-.d.ts → markdown-CcCPhMmC.d.ts}

@@ -1,7 +1,7 @@
-import { ExportedDeclarations, Node, Project, Symbol, Type, TypeChecker } from "ts-morph";
+import { API, Checker, Project, Symbol, Type } from "typescript/unstable/sync";
+import { Node, SourceFile } from "typescript/unstable/ast";
 import { Nodes } from "hast";
 import { BundledTheme, CodeOptionsThemes, CodeToHastOptionsCommon } from "shiki";
-
 //#region src/lib/type-table.d.ts
 interface BaseTypeTableProps {
   /**
@@ -52,7 +52,7 @@ declare function generateHash(str: string): string;
 //#region src/lib/get-simple-form.d.ts
 interface TypeSimplifierContext {
   type: Type;
-  checker: TypeChecker;
+  checker: Checker;
   location?: Node;
 }
 interface TypeSimplifierOptions {
@@ -66,6 +66,32 @@ interface TypeSimplifierOptions {
   noUndefined?: boolean;
 }
 //#endregion
+//#region src/lib/project.d.ts
+interface TypescriptConfig {
+  tsconfigPath?: string;
+}
+interface Project$1 {
+  /**
+   * The underlying `typescript/unstable/sync` API instance (a native TypeScript process).
+   */
+  readonly api: API;
+  readonly tsconfigPath: string;
+  /**
+   * Load a source file into the project, and optionally override its content with an in-memory version.
+   *
+   * Only loaded files (and the files they import) are part of the program, similar to `tsc` with `files` set.
+   */
+  getSourceFile(filePath: string, content?: string): {
+    project: Project;
+    sourceFile: SourceFile;
+  } | undefined;
+  /**
+   * Stop the TypeScript process.
+   */
+  close(): void;
+}
+declare function createProject(options?: TypescriptConfig): Promise<Project$1>;
+//#endregion
 //#region src/lib/base.d.ts
 interface GeneratedDoc {
   /**
@@ -91,9 +117,13 @@ interface RawTag {
   text: string;
 }
 interface EntryContext extends GenerateOptions {
+  /**
+   * The TypeScript project (from `typescript/unstable/sync`) containing the declaration.
+   */
   program: Project;
+  checker: Checker;
   type: Type;
-  declaration: ExportedDeclarations;
+  declaration: Node;
 }
 type Transformer = (this: EntryContext, entry: DocEntry, propertyType: Type, propertySymbol: Symbol) => void;
 interface GenerateOptions {
@@ -117,12 +147,8 @@ interface GeneratorOptions extends TypescriptConfig {
    * @defaultValue false
    */
   cache?: Cache | false;
-  project?: Project;
-}
-interface TypescriptConfig {
-  tsconfigPath?: string;
+  project?: Project$1;
 }
-declare function createProject(options?: TypescriptConfig): Promise<Project>;
 declare function createGenerator(options?: GeneratorOptions): {
   generateDocumentation(file: {
     path: string;
@@ -138,4 +164,4 @@ interface MarkdownRenderer {
 }
 type ShikiOptions = Omit<CodeToHastOptionsCommon, 'lang'> & CodeOptionsThemes<BundledTheme>;
 //#endregion
-export { GeneratedDoc as a, RawTag as c, createProject as d, Cache as f, GenerateTypeTableOptions as h, GenerateOptions as i, TypescriptConfig as l, BaseTypeTableProps as m, ShikiOptions as n, Generator as o, generateHash as p, DocEntry as r, GeneratorOptions as s, MarkdownRenderer as t, createGenerator as u };
+export { GeneratedDoc as a, RawTag as c, TypescriptConfig as d, createProject as f, GenerateTypeTableOptions as g, BaseTypeTableProps as h, GenerateOptions as i, createGenerator as l, generateHash as m, ShikiOptions as n, Generator as o, Cache as p, DocEntry as r, GeneratorOptions as s, MarkdownRenderer as t, Project$1 as u };

package/dist/ui/index.d.ts

@@ -1,7 +1,6 @@
-import { h as GenerateTypeTableOptions, m as BaseTypeTableProps, n as ShikiOptions, o as Generator } from "../markdown-CM2iLQC-.js";
+import { g as GenerateTypeTableOptions, h as BaseTypeTableProps, n as ShikiOptions, o as Generator } from "../markdown-CcCPhMmC.js";
 import * as JsxRuntime from "react/jsx-runtime";
 import { ComponentProps, ReactNode } from "react";
-
 //#region src/ui/auto-type-table.d.ts
 interface AutoTypeTableProps extends BaseTypeTableProps, ComponentProps<'div'> {
   generator: Generator;
@@ -11,16 +10,6 @@ interface AutoTypeTableProps extends BaseTypeTableProps, ComponentProps<'div'> {
   renderMarkdown?: (md: string) => Promise<ReactNode>;
   renderType?: (type: string) => Promise<ReactNode>;
 }
-declare function AutoTypeTable({
-  generator,
-  options,
-  renderType,
-  renderMarkdown,
-  shiki,
-  name,
-  path,
-  type,
-  ...props
-}: AutoTypeTableProps): Promise<Promise<JsxRuntime.JSX.Element>[]>;
+declare function AutoTypeTable({ generator, options, renderType, renderMarkdown, shiki, name, path, type, ...props }: AutoTypeTableProps): Promise<Promise<JsxRuntime.JSX.Element>[]>;
 //#endregion
 export { AutoTypeTable, AutoTypeTableProps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-typescript",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "Typescript Integration for Fumadocs",
   "keywords": [
     "Docs",
@@ -38,25 +38,24 @@
     "hast-util-to-jsx-runtime": "^2.3.6",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.2",
-    "shiki": "^4.3.1",
-    "ts-morph": "^28.0.0",
+    "shiki": "^4.4.3",
+    "typescript": "~7.0.2",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.1.0"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@types/estree": "^1.0.9",
-    "@types/hast": "^3.0.4",
+    "@types/hast": "^3.0.5",
     "@types/mdast": "^4.0.4",
-    "@types/node": "26.1.0",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
+    "@types/node": "26.4.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
     "mdast-util-mdx": "^3.0.0",
-    "tsdown": "0.22.3",
-    "typescript": "^6.0.3",
+    "tsdown": "0.22.14",
     "vfile": "^6.0.3",
-    "fumadocs-ui": "npm:@fumadocs/base-ui@16.11.0",
-    "fumadocs-core": "16.11.0",
+    "fumadocs-core": "16.15.6",
+    "fumadocs-ui": "npm:@fumadocs/base-ui@16.15.6",
     "tsconfig": "0.0.0"
   },
   "peerDependencies": {

package/dist/get-simple-form-B_lm5cA2.js

@@ -1,59 +0,0 @@
-import { TypeFormatFlags } from "ts-morph";
-//#region src/lib/get-simple-form.ts
-function getSimpleForm(type, checker, location, options = {}) {
-	const { override, shouldSimplify, noUndefined = false } = options;
-	if (type.isUndefined() && noUndefined) return "";
-	const overridden = override?.({
-		checker,
-		type,
-		location
-	});
-	if (overridden) return overridden;
-	if (shouldSimplify && !shouldSimplify({
-		checker,
-		type,
-		location
-	})) return type.getText(location, TypeFormatFlags.UseAliasDefinedOutsideCurrentScope);
-	const alias = type.getAliasSymbol();
-	if (alias) {
-		const args = type.getAliasTypeArguments();
-		if (args.length === 0) return alias.getName();
-		const nextOptions = {
-			...options,
-			noUndefined: false
-		};
-		return `${alias.getName()}<${args.map((arg) => getSimpleForm(arg, checker, location, nextOptions)).join(", ")}>`;
-	}
-	if (type.isUnion()) {
-		if (noUndefined) {
-			const members = type.getUnionTypes().filter((t) => !t.isUndefined());
-			if (members.length === 0) return "undefined";
-			if (members.length === 1) return getSimpleForm(members[0], checker, location, options);
-		}
-		return "union";
-	}
-	if (type.isIntersection()) {
-		const types = [];
-		for (const t of type.getIntersectionTypes()) {
-			const str = getSimpleForm(t, checker, location, options);
-			if (str.length > 0 && str !== "never") types.unshift(str);
-		}
-		return dedupe(types).join(" & ");
-	}
-	if (type.isTuple()) return "tuple";
-	if (type.isArray() || type.isReadonlyArray()) return "array";
-	if (type.getCallSignatures().length > 0) return "function";
-	if (type.isClassOrInterface() || type.isObject()) return "object";
-	return type.getText(location, TypeFormatFlags.UseAliasDefinedOutsideCurrentScope);
-}
-function dedupe(arr) {
-	const dedupe = /* @__PURE__ */ new Set();
-	const out = [];
-	for (const item of arr) if (!dedupe.has(item)) {
-		out.push(item);
-		dedupe.add(item);
-	}
-	return out;
-}
-//#endregion
-export { getSimpleForm };