rspress-plugin-api-extractor 0.8.9 → 0.9.0

package/markdown/page-generators/enum-page.js

@@ -1,6 +1,6 @@
-import { ApiParser } from "../../loader.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
+import { linkProse } from "../prose-linker.js";
+import { ApiItems, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/enum-page.ts
 /**
@@ -23,9 +23,9 @@ import { markdownCrossLinker } from "../cross-linker.js";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @see {@link TypeAliasPageGenerator} for type alias documentation
 * @see {@link VariablePageGenerator} for variable/constant documentation
@@ -39,22 +39,22 @@ var EnumPageGenerator = class {
 	async generate(apiEnum, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiEnum.displayName;
-		const summary = ApiParser.getSummary(apiEnum) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiEnum);
+		const summary = Tsdoc.summary(apiEnum) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiEnum);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { EnumMembersTable } from "rspress-plugin-api-extractor/runtime";\n`;
 		content += `import { ApiSignature, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiEnum);
+		const deprecation = Tsdoc.deprecation(apiEnum);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> ⚠️ **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiEnum, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiEnum, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -76,7 +76,7 @@ var EnumPageGenerator = class {
 		if (hasMembers) {
 			const membersData = apiEnum.members.map((member) => {
 				const memberItem = member;
-				const memberSummary = ApiParser.getSummary(member) || "";
+				const memberSummary = Tsdoc.summary(member) || "";
 				let value;
 				if (memberItem.excerpt?.text) {
 					const excerptText = memberItem.excerpt.text.trim();
@@ -86,12 +86,12 @@ var EnumPageGenerator = class {
 				return {
 					name: member.displayName,
 					value,
-					description: markdownCrossLinker.addCrossLinks(memberSummary)
+					description: linkProse(memberSummary)
 				};
 			});
 			content += `<EnumMembersTable members={${JSON.stringify(membersData)}} />\n\n`;
 		}
-		const examples = ApiParser.getExamples(apiEnum);
+		const examples = Tsdoc.examples(apiEnum);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -106,11 +106,11 @@ var EnumPageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiEnum);
+		const seeReferences = Tsdoc.seeReferences(apiEnum);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;

package/markdown/page-generators/function-page.js

@@ -1,8 +1,7 @@
-import { ApiParser } from "../../loader.js";
 import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
-import { TypeSignatureFormatter } from "../../formatter.js";
+import { linkProse } from "../prose-linker.js";
+import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/function-page.ts
 /**
@@ -25,15 +24,14 @@ import { TypeSignatureFormatter } from "../../formatter.js";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @see {@link ClassPageGenerator} for class documentation
 * @see {@link TypeAliasPageGenerator} for type alias documentation
 */
 var FunctionPageGenerator = class {
-	typeFormatter = new TypeSignatureFormatter();
 	/**
 	* Generate a markdown page for a function
 	*
@@ -42,22 +40,22 @@ var FunctionPageGenerator = class {
 	async generate(apiFunction, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiFunction.displayName;
-		const summary = ApiParser.getSummary(apiFunction) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiFunction);
+		const summary = Tsdoc.summary(apiFunction) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiFunction);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { ParametersTable } from "rspress-plugin-api-extractor/runtime";\n`;
 		content += `import { ApiSignature, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiFunction);
+		const deprecation = Tsdoc.deprecation(apiFunction);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> ⚠️ **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiFunction, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiFunction, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -69,10 +67,10 @@ var FunctionPageGenerator = class {
 			}
 			content += `</div>\n\n`;
 		}
-		const params = ApiParser.getParams(apiFunction);
+		const params = Tsdoc.params(apiFunction);
 		const hasParameters = params.length > 0;
 		if (apiFunction.excerpt.text) {
-			const signature = this.typeFormatter.format(apiFunction.excerpt).trim();
+			const signature = Signature.format(apiFunction.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiFunction.getAssociatedPackage?.();
 			if (apiPackage) {
@@ -86,16 +84,16 @@ var FunctionPageGenerator = class {
 			const parametersData = params.map((param) => ({
 				name: param.name,
 				type: param.type,
-				description: escapeMdxGenerics(markdownCrossLinker.addCrossLinks(param.description))
+				description: escapeMdxGenerics(linkProse(param.description))
 			}));
 			content += `<ParametersTable parameters={${JSON.stringify(parametersData)}} />\n\n`;
 		}
-		const returns = ApiParser.getReturns(apiFunction);
+		const returns = Tsdoc.returns(apiFunction);
 		if (returns) {
-			const description = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(returns.description));
+			const description = escapeMdxGenerics(linkProse(returns.description));
 			content += `## Returns\n\n${description}\n\n`;
 		}
-		const examples = ApiParser.getExamples(apiFunction);
+		const examples = Tsdoc.examples(apiFunction);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -110,11 +108,11 @@ var FunctionPageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiFunction);
+		const seeReferences = Tsdoc.seeReferences(apiFunction);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;

package/markdown/page-generators/interface-page.js

@@ -1,8 +1,7 @@
-import { ApiParser } from "../../loader.js";
 import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, sanitizeId, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
-import { TypeSignatureFormatter } from "../../formatter.js";
+import { linkProse } from "../prose-linker.js";
+import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/interface-page.ts
 /**
@@ -32,9 +31,9 @@ import { TypeSignatureFormatter } from "../../formatter.js";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @example
 * ```ts
@@ -56,7 +55,6 @@ import { TypeSignatureFormatter } from "../../formatter.js";
 * @see {@link TypeAliasPageGenerator} for type alias documentation
 */
 var InterfacePageGenerator = class {
-	typeFormatter = new TypeSignatureFormatter();
 	/**
 	* Generate a markdown page for an interface
 	*
@@ -65,22 +63,22 @@ var InterfacePageGenerator = class {
 	async generate(apiInterface, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiInterface.displayName;
-		const summary = ApiParser.getSummary(apiInterface) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiInterface);
+		const summary = Tsdoc.summary(apiInterface) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiInterface);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { ParametersTable } from "rspress-plugin-api-extractor/runtime";\n`;
 		content += `import { ApiSignature, ApiMember, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiInterface);
+		const deprecation = Tsdoc.deprecation(apiInterface);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> ⚠️ **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiInterface, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiInterface, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -99,13 +97,13 @@ var InterfacePageGenerator = class {
 		if (callSignatures.length > 0) {
 			content += `## Call Signatures\n\n`;
 			for (const callSig of callSignatures) {
-				const callSigSummary = ApiParser.getSummary(callSig);
+				const callSigSummary = Tsdoc.summary(callSig);
 				const callSigId = sanitizeId("call-signature");
 				const callSigItem = callSig;
 				if (callSigItem.excerpt?.text) {
-					const memberSignature = this.typeFormatter.format(callSigItem.excerpt).trim();
+					const memberSignature = Signature.format(callSigItem.excerpt).trim();
 					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, callSig, packageName);
-					const summaryMd = callSigSummary ? escapeMdxGenerics(markdownCrossLinker.addCrossLinks(callSigSummary)) : void 0;
+					const summaryMd = callSigSummary ? escapeMdxGenerics(linkProse(callSigSummary)) : void 0;
 					content += `<ApiMember code={${JSON.stringify(memberSignature)}} source={${JSON.stringify(skeletonWithContext)}} apiScope={${JSON.stringify(apiScope)}} memberName="Call Signature"${summaryMd ? ` summary={${JSON.stringify(summaryMd)}}` : ""} id={${JSON.stringify(callSigId)}} />\n\n`;
 				}
 			}
@@ -114,13 +112,13 @@ var InterfacePageGenerator = class {
 		if (constructSignatures.length > 0) {
 			content += `## Construct Signatures\n\n`;
 			for (const constructSig of constructSignatures) {
-				const constructSigSummary = ApiParser.getSummary(constructSig);
+				const constructSigSummary = Tsdoc.summary(constructSig);
 				const constructSigId = sanitizeId("construct-signature");
 				const constructSigItem = constructSig;
 				if (constructSigItem.excerpt?.text) {
-					const memberSignature = this.typeFormatter.format(constructSigItem.excerpt).trim();
+					const memberSignature = Signature.format(constructSigItem.excerpt).trim();
 					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, constructSig, packageName);
-					const summaryMd = constructSigSummary ? escapeMdxGenerics(markdownCrossLinker.addCrossLinks(constructSigSummary)) : void 0;
+					const summaryMd = constructSigSummary ? escapeMdxGenerics(linkProse(constructSigSummary)) : void 0;
 					content += `<ApiMember code={${JSON.stringify(memberSignature)}} source={${JSON.stringify(skeletonWithContext)}} apiScope={${JSON.stringify(apiScope)}} memberName="Construct Signature"${summaryMd ? ` summary={${JSON.stringify(summaryMd)}}` : ""} id={${JSON.stringify(constructSigId)}} />\n\n`;
 				}
 			}
@@ -129,13 +127,13 @@ var InterfacePageGenerator = class {
 		if (indexSignatures.length > 0) {
 			content += `## Index Signature\n\n`;
 			for (const indexSig of indexSignatures) {
-				const indexSigSummary = ApiParser.getSummary(indexSig);
+				const indexSigSummary = Tsdoc.summary(indexSig);
 				const indexSigId = sanitizeId("index-signature");
 				const indexSigItem = indexSig;
 				if (indexSigItem.excerpt?.text) {
-					const memberSignature = this.typeFormatter.format(indexSigItem.excerpt).trim();
+					const memberSignature = Signature.format(indexSigItem.excerpt).trim();
 					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, indexSig, packageName);
-					const summaryMd = indexSigSummary ? escapeMdxGenerics(markdownCrossLinker.addCrossLinks(indexSigSummary)) : void 0;
+					const summaryMd = indexSigSummary ? escapeMdxGenerics(linkProse(indexSigSummary)) : void 0;
 					content += `<ApiMember code={${JSON.stringify(memberSignature)}} source={${JSON.stringify(skeletonWithContext)}} apiScope={${JSON.stringify(apiScope)}} memberName="Index Signature"${summaryMd ? ` summary={${JSON.stringify(summaryMd)}}` : ""} id={${JSON.stringify(indexSigId)}} />\n\n`;
 				}
 			}
@@ -144,13 +142,13 @@ var InterfacePageGenerator = class {
 		if (properties.length > 0) {
 			content += `## Properties\n\n`;
 			for (const prop of properties) {
-				const propSummary = ApiParser.getSummary(prop);
+				const propSummary = Tsdoc.summary(prop);
 				const propId = sanitizeId(prop.displayName);
 				const propItem = prop;
 				if (propItem.excerpt?.text) {
-					const memberSignature = this.typeFormatter.format(propItem.excerpt).trim();
+					const memberSignature = Signature.format(propItem.excerpt).trim();
 					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, prop, packageName);
-					const summaryMd = propSummary ? escapeMdxGenerics(markdownCrossLinker.addCrossLinks(propSummary)) : void 0;
+					const summaryMd = propSummary ? escapeMdxGenerics(linkProse(propSummary)) : void 0;
 					content += `<ApiMember code={${JSON.stringify(memberSignature)}} source={${JSON.stringify(skeletonWithContext)}} apiScope={${JSON.stringify(apiScope)}} memberName={${JSON.stringify(prop.displayName)}}${summaryMd ? ` summary={${JSON.stringify(summaryMd)}}` : ""} id={${JSON.stringify(propId)}} />\n\n`;
 				}
 			}
@@ -159,30 +157,30 @@ var InterfacePageGenerator = class {
 		if (methods.length > 0) {
 			content += `## Methods\n\n`;
 			for (const method of methods) {
-				const methodSummary = ApiParser.getSummary(method);
+				const methodSummary = Tsdoc.summary(method);
 				const methodId = sanitizeId(method.displayName);
 				const methodItem = method;
 				if (methodItem.excerpt?.text) {
-					const memberSignature = this.typeFormatter.format(methodItem.excerpt).trim();
+					const memberSignature = Signature.format(methodItem.excerpt).trim();
 					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, method, packageName);
-					const hasParameters = ApiParser.getParams(method).length > 0;
-					const summaryMd = methodSummary ? escapeMdxGenerics(markdownCrossLinker.addCrossLinks(methodSummary)) : void 0;
+					const hasParameters = Tsdoc.params(method).length > 0;
+					const summaryMd = methodSummary ? escapeMdxGenerics(linkProse(methodSummary)) : void 0;
 					content += `<ApiMember code={${JSON.stringify(memberSignature)}} source={${JSON.stringify(skeletonWithContext)}} apiScope={${JSON.stringify(apiScope)}} memberName={${JSON.stringify(method.displayName)}}${summaryMd ? ` summary={${JSON.stringify(summaryMd)}}` : ""} id={${JSON.stringify(methodId)}} hasParameters={${hasParameters}} />\n\n`;
 				}
-				const params = ApiParser.getParams(method);
+				const params = Tsdoc.params(method);
 				if (params.length > 0) content += `<ParametersTable parameters={${JSON.stringify(params.map((p) => ({
 					name: p.name,
 					type: p.type,
-					description: markdownCrossLinker.addCrossLinks(p.description)
+					description: linkProse(p.description)
 				})))}} />\n\n`;
-				const returns = ApiParser.getReturns(method);
+				const returns = Tsdoc.returns(method);
 				if (returns) {
-					const description = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(returns.description));
+					const description = escapeMdxGenerics(linkProse(returns.description));
 					content += `**Returns:** ${description}\n\n`;
 				}
 			}
 		}
-		const examples = ApiParser.getExamples(apiInterface);
+		const examples = Tsdoc.examples(apiInterface);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -197,11 +195,11 @@ var InterfacePageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiInterface);
+		const seeReferences = Tsdoc.seeReferences(apiInterface);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;
@@ -218,7 +216,7 @@ var InterfacePageGenerator = class {
 	*/
 	generateInterfaceMemberWithContext(apiInterface, targetMember, packageName) {
 		const interfaceName = apiInterface.displayName;
-		const inheritance = ApiParser.getInheritance(apiInterface);
+		const inheritance = ApiItems.inheritance(apiInterface);
 		let declaration = `interface ${interfaceName}`;
 		if (apiInterface.typeParameters && apiInterface.typeParameters.length > 0) {
 			const typeParams = apiInterface.typeParameters.map((tp) => tp.name).join(", ");
@@ -227,7 +225,7 @@ var InterfacePageGenerator = class {
 		if (inheritance.extends && inheritance.extends.length > 0) declaration += ` extends ${inheritance.extends.join(", ")}`;
 		declaration += " {";
 		const memberItem = targetMember;
-		const memberSignature = memberItem.excerpt?.text ? this.typeFormatter.format(memberItem.excerpt).trim() : "";
+		const memberSignature = memberItem.excerpt?.text ? Signature.format(memberItem.excerpt).trim() : "";
 		const skeleton = `${declaration}\n${memberSignature}\n}`;
 		const apiPackage = apiInterface.getAssociatedPackage?.();
 		if (apiPackage) {
@@ -255,7 +253,7 @@ var InterfacePageGenerator = class {
 	generateInterfaceSkeleton(apiInterface) {
 		const lines = [];
 		const interfaceName = apiInterface.displayName;
-		const inheritance = ApiParser.getInheritance(apiInterface);
+		const inheritance = ApiItems.inheritance(apiInterface);
 		let declaration = `interface ${interfaceName}`;
 		if (apiInterface.typeParameters && apiInterface.typeParameters.length > 0) {
 			const typeParams = apiInterface.typeParameters.map((tp) => tp.name).join(", ");
@@ -268,7 +266,7 @@ var InterfacePageGenerator = class {
 		if (callSignatures.length > 0) for (const callSig of callSignatures) {
 			const callSigItem = callSig;
 			if (callSigItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(callSigItem.excerpt).trim();
+				const signature = Signature.format(callSigItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
@@ -276,7 +274,7 @@ var InterfacePageGenerator = class {
 		if (constructSignatures.length > 0) for (const constructSig of constructSignatures) {
 			const constructSigItem = constructSig;
 			if (constructSigItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(constructSigItem.excerpt).trim();
+				const signature = Signature.format(constructSigItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
@@ -284,7 +282,7 @@ var InterfacePageGenerator = class {
 		if (indexSignatures.length > 0) for (const indexSig of indexSignatures) {
 			const indexSigItem = indexSig;
 			if (indexSigItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(indexSigItem.excerpt).trim();
+				const signature = Signature.format(indexSigItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
@@ -292,7 +290,7 @@ var InterfacePageGenerator = class {
 		if (properties.length > 0) for (const prop of properties) {
 			const propItem = prop;
 			if (propItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(propItem.excerpt).trim();
+				const signature = Signature.format(propItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
@@ -300,7 +298,7 @@ var InterfacePageGenerator = class {
 		if (methods.length > 0) for (const method of methods) {
 			const methodItem = method;
 			if (methodItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(methodItem.excerpt).trim();
+				const signature = Signature.format(methodItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}

package/markdown/page-generators/namespace-page.js

@@ -1,9 +1,8 @@
-import { ApiParser } from "../../loader.js";
 import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
-import { TypeSignatureFormatter } from "../../formatter.js";
+import { linkProse } from "../prose-linker.js";
 import { ApiItemKind } from "@microsoft/api-extractor-model";
+import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/namespace-page.ts
 /**
@@ -28,9 +27,9 @@ import { ApiItemKind } from "@microsoft/api-extractor-model";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @example
 * ```ts
@@ -52,7 +51,6 @@ import { ApiItemKind } from "@microsoft/api-extractor-model";
 * @see {@link InterfacePageGenerator} for interface documentation
 */
 var NamespacePageGenerator = class {
-	typeFormatter = new TypeSignatureFormatter();
 	/**
 	* Generate a markdown page for a namespace
 	*
@@ -61,21 +59,21 @@ var NamespacePageGenerator = class {
 	async generate(apiNamespace, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiNamespace.displayName;
-		const summary = ApiParser.getSummary(apiNamespace) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiNamespace);
+		const summary = Tsdoc.summary(apiNamespace) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiNamespace);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { ApiSignature, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiNamespace);
+		const deprecation = Tsdoc.deprecation(apiNamespace);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiNamespace, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiNamespace, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -98,7 +96,7 @@ var NamespacePageGenerator = class {
 		content += this.renderMemberSection("Types", grouped.typeAliases, baseRoute, "type", name);
 		content += this.renderMemberSection("Enums", grouped.enums, baseRoute, "enum", name);
 		content += this.renderMemberSection("Namespaces", grouped.namespaces, baseRoute, "namespace", name);
-		const examples = ApiParser.getExamples(apiNamespace);
+		const examples = Tsdoc.examples(apiNamespace);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -113,11 +111,11 @@ var NamespacePageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiNamespace);
+		const seeReferences = Tsdoc.seeReferences(apiNamespace);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;
@@ -182,10 +180,10 @@ var NamespacePageGenerator = class {
 		let section = `## ${title}\n\n`;
 		for (const member of members) {
 			const memberName = member.displayName;
-			const memberSummary = ApiParser.getSummary(member);
+			const memberSummary = Tsdoc.summary(member);
 			const memberRoute = `${baseRoute}/${categoryFolder}/${`${namespaceName}.${memberName}`.toLowerCase()}`;
 			if (memberSummary) {
-				const escapedSummary = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(memberSummary));
+				const escapedSummary = escapeMdxGenerics(linkProse(memberSummary));
 				section += `- [${memberName}](${memberRoute}) - ${escapedSummary}\n`;
 			} else section += `- [${memberName}](${memberRoute})\n`;
 		}
@@ -216,49 +214,49 @@ var NamespacePageGenerator = class {
 		for (const cls of grouped.classes) {
 			const clsItem = cls;
 			if (clsItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(clsItem.excerpt).trim();
+				const signature = Signature.format(clsItem.excerpt).trim();
 				lines.push(`    ${this.abbreviateDeclaration(signature, "class")} { }`);
 			}
 		}
 		for (const iface of grouped.interfaces) {
 			const ifaceItem = iface;
 			if (ifaceItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(ifaceItem.excerpt).trim();
+				const signature = Signature.format(ifaceItem.excerpt).trim();
 				lines.push(`    ${this.abbreviateDeclaration(signature, "interface")} { }`);
 			}
 		}
 		for (const func of grouped.functions) {
 			const funcItem = func;
 			if (funcItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(funcItem.excerpt).trim();
+				const signature = Signature.format(funcItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
 		for (const variable of grouped.variables) {
 			const varItem = variable;
 			if (varItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(varItem.excerpt).trim();
+				const signature = Signature.format(varItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
 		for (const typeAlias of grouped.typeAliases) {
 			const typeItem = typeAlias;
 			if (typeItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(typeItem.excerpt).trim();
+				const signature = Signature.format(typeItem.excerpt).trim();
 				lines.push(`    ${signature}`);
 			}
 		}
 		for (const enumItem of grouped.enums) {
 			const enumDeclItem = enumItem;
 			if (enumDeclItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(enumDeclItem.excerpt).trim();
+				const signature = Signature.format(enumDeclItem.excerpt).trim();
 				lines.push(`    ${this.abbreviateDeclaration(signature, "enum")} { }`);
 			}
 		}
 		for (const ns of grouped.namespaces) {
 			const nsItem = ns;
 			if (nsItem.excerpt?.text) {
-				const signature = this.typeFormatter.format(nsItem.excerpt).trim();
+				const signature = Signature.format(nsItem.excerpt).trim();
 				lines.push(`    ${this.abbreviateDeclaration(signature, "namespace")} { }`);
 			}
 		}