rspress-plugin-api-extractor 0.13.3 → 0.15.0

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

@@ -1,152 +0,0 @@
-import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, stripTwoslashDirectives } from "../helpers.js";
-import { linkProse } from "../prose-linker.js";
-import { ApiItems, Tsdoc } from "@tsdoctor/model";
-
-//#region src/markdown/page-generators/enum-page.ts
-/**
-* Generates MDX documentation pages for TypeScript enums.
-*
-* This class transforms API Extractor enum models into rich MDX documentation
-* pages with syntax-highlighted signatures, member tables, and cross-linked
-* type references.
-*
-* **Page Structure:**
-* 1. Frontmatter with title, description, and Open Graph metadata
-* 2. Component imports
-* 3. Page title (H1) and summary
-* 4. Optional deprecation warning and release tag badge
-* 5. Source code link toolbar
-* 6. Enum signature block
-* 7. Members table (Name, Value, Description)
-* 8. Examples section with Twoslash-enabled code blocks
-* 9. See Also references
-*
-* **Relationships:**
-* - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - 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
-*/
-var EnumPageGenerator = class {
-	/**
-	* Generate a markdown page for an enum
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiEnum, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiEnum.displayName;
-		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 = Tsdoc.deprecation(apiEnum);
-		if (deprecation) {
-			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 = ApiItems.sourceLink(apiEnum, sourceConfig);
-		if (sourceLink) {
-			content += `<div className="api-docs-toolbar">\n`;
-			content += `  <div className="api-docs-toolbar-left">\n`;
-			content += `    <SourceCode href="${sourceLink}" />\n`;
-			content += `  </div>\n`;
-			if (llmsPlugin?.enabled) {
-				content += `  <div className="api-docs-toolbar-right">\n`;
-				content += `  </div>\n`;
-			}
-			content += `</div>\n\n`;
-		}
-		const skeleton = this.generateEnumSkeleton(apiEnum);
-		const hasMembers = apiEnum.members.length > 0;
-		if (skeleton) {
-			const displayCode = stripTwoslashDirectives(skeleton);
-			const signatureNewlines = hasMembers ? "\n" : "\n\n";
-			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(skeleton)}} apiScope={${JSON.stringify(apiScope)}} hasMembers={${hasMembers}} />${signatureNewlines}`;
-		}
-		if (hasMembers) {
-			const membersData = apiEnum.members.map((member) => {
-				const memberItem = member;
-				const memberSummary = Tsdoc.summary(member) || "";
-				let value;
-				if (memberItem.excerpt?.text) {
-					const excerptText = memberItem.excerpt.text.trim();
-					const equalsIndex = excerptText.indexOf("=");
-					if (equalsIndex !== -1) value = excerptText.substring(equalsIndex + 1).trim().replace(/,\s*$/, "");
-				}
-				return {
-					name: member.displayName,
-					value,
-					description: linkProse(memberSummary)
-				};
-			});
-			content += `<EnumMembersTable members={${JSON.stringify(membersData)}} />\n\n`;
-		}
-		const examples = Tsdoc.examples(apiEnum);
-		if (examples.length > 0) {
-			content += `## Examples\n\n`;
-			for (const example of examples) {
-				const prepared = prepareExampleCode(example, name, packageName, shouldSuppressErrors);
-				const formattedCode = await formatExampleCode(prepared.code, prepared.language, {
-					api: packageName,
-					blockType: "example"
-				});
-				if (prepared.isTypeScript) {
-					const displayCode = stripTwoslashDirectives(formattedCode);
-					content += `<ApiExample code={${JSON.stringify(displayCode)}} source={${JSON.stringify(formattedCode)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
-			}
-		}
-		const seeReferences = Tsdoc.seeReferences(apiEnum);
-		if (seeReferences.length > 0) {
-			content += `## See Also\n\n`;
-			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(linkProse(reference.text));
-				content += `- ${refText}\n`;
-			}
-			content += `\n`;
-		}
-		return {
-			routePath: `${baseRoute}/enum/${name.toLowerCase()}`,
-			content
-		};
-	}
-	/**
-	* Generate a complete enum skeleton showing all members
-	*/
-	generateEnumSkeleton(apiEnum) {
-		const lines = [];
-		const enumName = apiEnum.displayName;
-		lines.push(`enum ${enumName} {`);
-		const members = apiEnum.members;
-		for (let i = 0; i < members.length; i++) {
-			const member = members[i];
-			const memberItem = member;
-			let memberLine = `    ${member.displayName}`;
-			if (memberItem.excerpt?.text) {
-				const excerptText = memberItem.excerpt.text.trim();
-				const equalsIndex = excerptText.indexOf("=");
-				if (equalsIndex !== -1) {
-					const value = excerptText.substring(equalsIndex + 1).trim().replace(/,\s*$/, "");
-					memberLine += ` = ${value}`;
-				}
-			}
-			if (i < members.length - 1) memberLine += ",";
-			lines.push(memberLine);
-		}
-		lines.push("}");
-		return lines.join("\n");
-	}
-};
-
-//#endregion
-export { EnumPageGenerator };

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

@@ -1,128 +0,0 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
-import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { linkProse } from "../prose-linker.js";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
-
-//#region src/markdown/page-generators/function-page.ts
-/**
-* Generates MDX documentation pages for TypeScript/JavaScript functions.
-*
-* This class transforms API Extractor function models into rich MDX documentation
-* pages with syntax-highlighted signatures and cross-linked type references.
-*
-* **Page Structure:**
-* 1. Frontmatter with title, description, and Open Graph metadata
-* 2. Component imports
-* 3. Page title (H1) and summary
-* 4. Optional deprecation warning and release tag badge
-* 5. Source code link toolbar
-* 6. Function signature block
-* 7. Parameters documentation
-* 8. Returns documentation
-* 9. Examples section with Twoslash-enabled code blocks
-* 10. See Also references
-*
-* **Relationships:**
-* - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - 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 {
-	/**
-	* Generate a markdown page for a function
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiFunction, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiFunction.displayName;
-		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 = Tsdoc.deprecation(apiFunction);
-		if (deprecation) {
-			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 = ApiItems.sourceLink(apiFunction, sourceConfig);
-		if (sourceLink) {
-			content += `<div className="api-docs-toolbar">\n`;
-			content += `  <div className="api-docs-toolbar-left">\n`;
-			content += `    <SourceCode href="${sourceLink}" />\n`;
-			content += `  </div>\n`;
-			if (llmsPlugin?.enabled) {
-				content += `  <div className="api-docs-toolbar-right">\n`;
-				content += `  </div>\n`;
-			}
-			content += `</div>\n\n`;
-		}
-		const params = Tsdoc.params(apiFunction);
-		const hasParameters = params.length > 0;
-		if (apiFunction.excerpt.text) {
-			const signature = Signature.format(apiFunction.excerpt).trim();
-			let signatureWithImports = signature;
-			const apiPackage = apiFunction.getAssociatedPackage?.();
-			if (apiPackage) {
-				const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiFunction);
-				signatureWithImports = prependHiddenImports(signature, imports);
-			}
-			const displayCode = stripTwoslashDirectives(signatureWithImports);
-			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(signatureWithImports)}} apiScope={${JSON.stringify(apiScope)}} hasParameters={${hasParameters}} />\n\n`;
-		}
-		if (hasParameters) {
-			const parametersData = params.map((param) => ({
-				name: param.name,
-				type: param.type,
-				description: escapeMdxGenerics(linkProse(param.description))
-			}));
-			content += `<ParametersTable parameters={${JSON.stringify(parametersData)}} />\n\n`;
-		}
-		const returns = Tsdoc.returns(apiFunction);
-		if (returns) {
-			const description = escapeMdxGenerics(linkProse(returns.description));
-			content += `## Returns\n\n${description}\n\n`;
-		}
-		const examples = Tsdoc.examples(apiFunction);
-		if (examples.length > 0) {
-			content += `## Examples\n\n`;
-			for (const example of examples) {
-				const prepared = prepareExampleCode(example, name, packageName, shouldSuppressErrors);
-				const formattedCode = await formatExampleCode(prepared.code, prepared.language, {
-					api: packageName,
-					blockType: "example"
-				});
-				if (prepared.isTypeScript) {
-					const displayCode = stripTwoslashDirectives(formattedCode);
-					content += `<ApiExample code={${JSON.stringify(displayCode)}} source={${JSON.stringify(formattedCode)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
-			}
-		}
-		const seeReferences = Tsdoc.seeReferences(apiFunction);
-		if (seeReferences.length > 0) {
-			content += `## See Also\n\n`;
-			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(linkProse(reference.text));
-				content += `- ${refText}\n`;
-			}
-			content += `\n`;
-		}
-		return {
-			routePath: `${baseRoute}/function/${name.toLowerCase()}`,
-			content
-		};
-	}
-};
-
-//#endregion
-export { FunctionPageGenerator };

package/markdown/page-generators/index-pages.js

@@ -1,25 +0,0 @@
-import { emitFrontmatterBlock } from "../../frontmatter.js";
-
-//#region src/markdown/page-generators/index-pages.ts
-/**
-* Generator for main API index page with only frontmatter (no content)
-*/
-var MainIndexPageGenerator = class {
-	/**
-	* Generate the main API index page
-	*/
-	generate(packageName, baseRoute, _categoryCounts) {
-		const content = emitFrontmatterBlock({
-			title: "API Reference",
-			description: `Auto-generated API documentation for ${packageName}`,
-			overview: true
-		});
-		return {
-			routePath: `${baseRoute}/index`,
-			content
-		};
-	}
-};
-
-//#endregion
-export { MainIndexPageGenerator };

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

@@ -1,311 +0,0 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
-import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { linkProse } from "../prose-linker.js";
-import { ApiItems, Routes, Signature, Tsdoc } from "@tsdoctor/model";
-
-//#region src/markdown/page-generators/interface-page.ts
-/**
-* Generates MDX documentation pages for TypeScript interfaces.
-*
-* This class transforms API Extractor interface models into rich MDX documentation
-* pages with syntax-highlighted signatures, cross-linked type references, and
-* interactive features.
-*
-* **Page Structure:**
-* 1. Frontmatter with title, description, and Open Graph metadata
-* 2. Component imports (SourceCode, ParametersTable, ApiSignature, etc.)
-* 3. Page title (H1) and summary
-* 4. Optional deprecation warning and release tag badge
-* 5. Source code link toolbar
-* 6. Full interface signature block showing all members
-* 7. Member sections: Call Signatures, Construct Signatures, Index Signatures, Properties, Methods
-* 8. Examples section with Twoslash-enabled code blocks
-* 9. See Also references
-*
-* **Interface-Specific Features:**
-* - Handles type parameters (generics) in interface declarations
-* - Supports call signatures for callable interfaces
-* - Supports construct signatures for constructable interfaces
-* - Supports index signatures for dictionary-like interfaces
-* - Handles extends clauses for interface inheritance
-*
-* **Relationships:**
-* - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - 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
-* const generator = new InterfacePageGenerator();
-* const { routePath, content } = await generator.generate(
-*   apiInterface,
-*   "/api/my-package",
-*   "my-package",
-*   "Interface",
-*   "My Package",
-*   sourceConfig,
-*   true, // suppressExampleErrors
-*   undefined, // llmsPlugin
-*   "claude-binary-plugin", // apiScope
-* );
-* ```
-*
-* @see {@link ClassPageGenerator} for class documentation
-* @see {@link TypeAliasPageGenerator} for type alias documentation
-*/
-var InterfacePageGenerator = class {
-	/**
-	* Generate a markdown page for an interface
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiInterface, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiInterface.displayName;
-		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 = Tsdoc.deprecation(apiInterface);
-		if (deprecation) {
-			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 = ApiItems.sourceLink(apiInterface, sourceConfig);
-		if (sourceLink) {
-			content += `<div className="api-docs-toolbar">\n`;
-			content += `  <div className="api-docs-toolbar-left">\n`;
-			content += `    <SourceCode href="${sourceLink}" />\n`;
-			content += `  </div>\n`;
-			if (llmsPlugin?.enabled) {
-				content += `  <div className="api-docs-toolbar-right">\n`;
-				content += `  </div>\n`;
-			}
-			content += `</div>\n\n`;
-		}
-		const skeleton = this.generateInterfaceSkeletonWithTwoslash(apiInterface, packageName);
-		const displayCode = stripTwoslashDirectives(skeleton);
-		content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(skeleton)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-		const callSignatures = apiInterface.members.filter((m) => m.kind === "CallSignature");
-		if (callSignatures.length > 0) {
-			content += `## Call Signatures\n\n`;
-			for (const callSig of callSignatures) {
-				const callSigSummary = Tsdoc.summary(callSig);
-				const callSigId = Routes.memberAnchor("call-signature");
-				const callSigItem = callSig;
-				if (callSigItem.excerpt?.text) {
-					const memberSignature = Signature.format(callSigItem.excerpt).trim();
-					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, callSig, packageName);
-					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`;
-				}
-			}
-		}
-		const constructSignatures = apiInterface.members.filter((m) => m.kind === "ConstructSignature");
-		if (constructSignatures.length > 0) {
-			content += `## Construct Signatures\n\n`;
-			for (const constructSig of constructSignatures) {
-				const constructSigSummary = Tsdoc.summary(constructSig);
-				const constructSigId = Routes.memberAnchor("construct-signature");
-				const constructSigItem = constructSig;
-				if (constructSigItem.excerpt?.text) {
-					const memberSignature = Signature.format(constructSigItem.excerpt).trim();
-					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, constructSig, packageName);
-					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`;
-				}
-			}
-		}
-		const indexSignatures = apiInterface.members.filter((m) => m.kind === "IndexSignature");
-		if (indexSignatures.length > 0) {
-			content += `## Index Signature\n\n`;
-			for (const indexSig of indexSignatures) {
-				const indexSigSummary = Tsdoc.summary(indexSig);
-				const indexSigId = Routes.memberAnchor("index-signature");
-				const indexSigItem = indexSig;
-				if (indexSigItem.excerpt?.text) {
-					const memberSignature = Signature.format(indexSigItem.excerpt).trim();
-					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, indexSig, packageName);
-					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`;
-				}
-			}
-		}
-		const properties = apiInterface.members.filter((m) => m.kind === "PropertySignature");
-		if (properties.length > 0) {
-			content += `## Properties\n\n`;
-			for (const prop of properties) {
-				const propSummary = Tsdoc.summary(prop);
-				const propId = Routes.memberAnchor(prop.displayName);
-				const propItem = prop;
-				if (propItem.excerpt?.text) {
-					const memberSignature = Signature.format(propItem.excerpt).trim();
-					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, prop, packageName);
-					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`;
-				}
-			}
-		}
-		const methods = apiInterface.members.filter((m) => m.kind === "MethodSignature");
-		if (methods.length > 0) {
-			content += `## Methods\n\n`;
-			for (const method of methods) {
-				const methodSummary = Tsdoc.summary(method);
-				const methodId = Routes.memberAnchor(method.displayName);
-				const methodItem = method;
-				if (methodItem.excerpt?.text) {
-					const memberSignature = Signature.format(methodItem.excerpt).trim();
-					const skeletonWithContext = this.generateInterfaceMemberWithContext(apiInterface, method, packageName);
-					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 = Tsdoc.params(method);
-				if (params.length > 0) content += `<ParametersTable parameters={${JSON.stringify(params.map((p) => ({
-					name: p.name,
-					type: p.type,
-					description: linkProse(p.description)
-				})))}} />\n\n`;
-				const returns = Tsdoc.returns(method);
-				if (returns) {
-					const description = escapeMdxGenerics(linkProse(returns.description));
-					content += `**Returns:** ${description}\n\n`;
-				}
-			}
-		}
-		const examples = Tsdoc.examples(apiInterface);
-		if (examples.length > 0) {
-			content += `## Examples\n\n`;
-			for (const example of examples) {
-				const prepared = prepareExampleCode(example, name, packageName, shouldSuppressErrors);
-				const formattedCode = await formatExampleCode(prepared.code, prepared.language, {
-					api: packageName,
-					blockType: "example"
-				});
-				if (prepared.isTypeScript) {
-					const displayCode = stripTwoslashDirectives(formattedCode);
-					content += `<ApiExample code={${JSON.stringify(displayCode)}} source={${JSON.stringify(formattedCode)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
-			}
-		}
-		const seeReferences = Tsdoc.seeReferences(apiInterface);
-		if (seeReferences.length > 0) {
-			content += `## See Also\n\n`;
-			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(linkProse(reference.text));
-				content += `- ${refText}\n`;
-			}
-			content += `\n`;
-		}
-		return {
-			routePath: `${baseRoute}/interface/${name.toLowerCase()}`,
-			content
-		};
-	}
-	/**
-	* Generate an interface member signature with full interface context
-	* Includes hidden imports with cut directive for external type resolution
-	* Uses the simplified approach: 3 lines (interface opening, member, closing)
-	*/
-	generateInterfaceMemberWithContext(apiInterface, targetMember, packageName) {
-		const interfaceName = apiInterface.displayName;
-		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(", ");
-			declaration += `<${typeParams}>`;
-		}
-		if (inheritance.extends && inheritance.extends.length > 0) declaration += ` extends ${inheritance.extends.join(", ")}`;
-		declaration += " {";
-		const memberItem = targetMember;
-		const memberSignature = memberItem.excerpt?.text ? Signature.format(memberItem.excerpt).trim() : "";
-		const skeleton = `${declaration}\n${memberSignature}\n}`;
-		const apiPackage = apiInterface.getAssociatedPackage?.();
-		if (apiPackage) {
-			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(targetMember);
-			return prependHiddenImports(skeleton, imports);
-		}
-		return skeleton;
-	}
-	/**
-	* Generate an interface skeleton for signature blocks
-	* Includes hidden imports with cut directive for external type resolution
-	*/
-	generateInterfaceSkeletonWithTwoslash(apiInterface, packageName) {
-		const skeleton = this.generateInterfaceSkeleton(apiInterface);
-		const apiPackage = apiInterface.getAssociatedPackage?.();
-		if (apiPackage) {
-			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiInterface);
-			return prependHiddenImports(skeleton, imports);
-		}
-		return skeleton;
-	}
-	/**
-	* Generate a complete interface skeleton showing all members
-	*/
-	generateInterfaceSkeleton(apiInterface) {
-		const lines = [];
-		const interfaceName = apiInterface.displayName;
-		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(", ");
-			declaration += `<${typeParams}>`;
-		}
-		if (inheritance.extends && inheritance.extends.length > 0) declaration += ` extends ${inheritance.extends.join(", ")}`;
-		declaration += " {";
-		lines.push(declaration);
-		const callSignatures = apiInterface.members.filter((m) => m.kind === "CallSignature");
-		if (callSignatures.length > 0) for (const callSig of callSignatures) {
-			const callSigItem = callSig;
-			if (callSigItem.excerpt?.text) {
-				const signature = Signature.format(callSigItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		const constructSignatures = apiInterface.members.filter((m) => m.kind === "ConstructSignature");
-		if (constructSignatures.length > 0) for (const constructSig of constructSignatures) {
-			const constructSigItem = constructSig;
-			if (constructSigItem.excerpt?.text) {
-				const signature = Signature.format(constructSigItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		const indexSignatures = apiInterface.members.filter((m) => m.kind === "IndexSignature");
-		if (indexSignatures.length > 0) for (const indexSig of indexSignatures) {
-			const indexSigItem = indexSig;
-			if (indexSigItem.excerpt?.text) {
-				const signature = Signature.format(indexSigItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		const properties = apiInterface.members.filter((m) => m.kind === "PropertySignature");
-		if (properties.length > 0) for (const prop of properties) {
-			const propItem = prop;
-			if (propItem.excerpt?.text) {
-				const signature = Signature.format(propItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		const methods = apiInterface.members.filter((m) => m.kind === "MethodSignature");
-		if (methods.length > 0) for (const method of methods) {
-			const methodItem = method;
-			if (methodItem.excerpt?.text) {
-				const signature = Signature.format(methodItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		lines.push("}");
-		return lines.join("\n");
-	}
-};
-
-//#endregion
-export { InterfacePageGenerator };