rspress-plugin-api-extractor 0.13.3 → 0.15.0

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

@@ -1,278 +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 { ApiItemKind } from "@microsoft/api-extractor-model";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
-
-//#region src/markdown/page-generators/namespace-page.ts
-/**
-* Generates MDX documentation pages for TypeScript namespaces.
-*
-* This class transforms API Extractor namespace models into rich MDX documentation pages
-* with syntax-highlighted signatures, cross-linked type references, and member listings.
-*
-* **Page Structure:**
-* 1. Frontmatter with title, description, and Open Graph metadata
-* 2. Component imports (SourceCode, ApiSignature, etc.)
-* 3. Page title (H1) and summary
-* 4. Optional deprecation warning and release tag badge
-* 5. Source code link toolbar
-* 6. Full namespace signature block showing all members
-* 7. Member sections: Classes, Interfaces, Functions, Variables, Types, Enums, Namespaces
-* 8. Examples section with Twoslash-enabled code blocks
-* 9. See Also references
-*
-* **Member Rendering:**
-* Each member section lists members with links to their individual documentation pages.
-*
-* **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 NamespacePageGenerator();
-* const { routePath, content } = await generator.generate(
-*   apiNamespace,
-*   "/api/my-package",
-*   "my-package",
-*   "Namespace",
-*   "My Package",
-*   sourceConfig,
-*   true, // suppressExampleErrors
-*   undefined, // llmsPlugin
-*   "my-scope"
-* );
-* ```
-*
-* @see {@link ClassPageGenerator} for class documentation
-* @see {@link InterfacePageGenerator} for interface documentation
-*/
-var NamespacePageGenerator = class {
-	/**
-	* Generate a markdown page for a namespace
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiNamespace, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiNamespace.displayName;
-		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 = Tsdoc.deprecation(apiNamespace);
-		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(apiNamespace, 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.generateNamespaceSkeletonWithTwoslash(apiNamespace, packageName);
-		const displayCode = stripTwoslashDirectives(skeleton);
-		content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(skeleton)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-		const grouped = this.groupNamespaceMembers(apiNamespace.members);
-		content += this.renderMemberSection("Classes", grouped.classes, baseRoute, "class", name);
-		content += this.renderMemberSection("Interfaces", grouped.interfaces, baseRoute, "interface", name);
-		content += this.renderMemberSection("Functions", grouped.functions, baseRoute, "function", name);
-		content += this.renderMemberSection("Variables", grouped.variables, baseRoute, "variable", name);
-		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 = Tsdoc.examples(apiNamespace);
-		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(apiNamespace);
-		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}/namespace/${name.toLowerCase()}`,
-			content
-		};
-	}
-	/**
-	* Group namespace members by their type
-	*/
-	groupNamespaceMembers(members) {
-		const classes = [];
-		const interfaces = [];
-		const functions = [];
-		const variables = [];
-		const typeAliases = [];
-		const enums = [];
-		const namespaces = [];
-		for (const member of members) switch (member.kind) {
-			case ApiItemKind.Class:
-				classes.push(member);
-				break;
-			case ApiItemKind.Interface:
-				interfaces.push(member);
-				break;
-			case ApiItemKind.Function:
-				functions.push(member);
-				break;
-			case ApiItemKind.Variable:
-				variables.push(member);
-				break;
-			case ApiItemKind.TypeAlias:
-				typeAliases.push(member);
-				break;
-			case ApiItemKind.Enum:
-				enums.push(member);
-				break;
-			case ApiItemKind.Namespace: namespaces.push(member);
-		}
-		return {
-			classes,
-			interfaces,
-			functions,
-			variables,
-			typeAliases,
-			enums,
-			namespaces
-		};
-	}
-	/**
-	* Render a section of members with links to their pages
-	* @param title - Section heading
-	* @param members - Array of API items to list
-	* @param baseRoute - Base API route (e.g., /api/package)
-	* @param categoryFolder - Category folder name (e.g., "class", "function")
-	* @param namespaceName - Parent namespace name for qualified routes
-	*/
-	renderMemberSection(title, members, baseRoute, categoryFolder, namespaceName) {
-		if (members.length === 0) return "";
-		let section = `## ${title}\n\n`;
-		for (const member of members) {
-			const memberName = member.displayName;
-			const memberSummary = Tsdoc.summary(member);
-			const memberRoute = `${baseRoute}/${categoryFolder}/${`${namespaceName}.${memberName}`.toLowerCase()}`;
-			if (memberSummary) {
-				const escapedSummary = escapeMdxGenerics(linkProse(memberSummary));
-				section += `- [${memberName}](${memberRoute}) - ${escapedSummary}\n`;
-			} else section += `- [${memberName}](${memberRoute})\n`;
-		}
-		section += `\n`;
-		return section;
-	}
-	/**
-	* Generate a namespace skeleton for signature blocks
-	* Includes hidden imports with cut directive for external type resolution
-	*/
-	generateNamespaceSkeletonWithTwoslash(apiNamespace, packageName) {
-		const skeleton = this.generateNamespaceSkeleton(apiNamespace);
-		const apiPackage = apiNamespace.getAssociatedPackage?.();
-		if (apiPackage) {
-			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiNamespace);
-			return prependHiddenImports(skeleton, imports);
-		}
-		return skeleton;
-	}
-	/**
-	* Generate a complete namespace skeleton showing all members
-	*/
-	generateNamespaceSkeleton(apiNamespace) {
-		const lines = [];
-		const namespaceName = apiNamespace.displayName;
-		lines.push(`namespace ${namespaceName} {`);
-		const grouped = this.groupNamespaceMembers(apiNamespace.members);
-		for (const cls of grouped.classes) {
-			const clsItem = cls;
-			if (clsItem.excerpt?.text) {
-				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 = 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 = Signature.format(funcItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		for (const variable of grouped.variables) {
-			const varItem = variable;
-			if (varItem.excerpt?.text) {
-				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 = Signature.format(typeItem.excerpt).trim();
-				lines.push(`    ${signature}`);
-			}
-		}
-		for (const enumItem of grouped.enums) {
-			const enumDeclItem = enumItem;
-			if (enumDeclItem.excerpt?.text) {
-				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 = Signature.format(nsItem.excerpt).trim();
-				lines.push(`    ${this.abbreviateDeclaration(signature, "namespace")} { }`);
-			}
-		}
-		lines.push("}");
-		return lines.join("\n");
-	}
-	/**
-	* Abbreviate a full declaration to just its header
-	* For example, `class Foo extends Bar implements Baz \{ ... \}` becomes `class Foo extends Bar implements Baz`
-	*/
-	abbreviateDeclaration(signature, _keyword) {
-		const braceIndex = signature.indexOf("{");
-		if (braceIndex === -1) return signature;
-		return signature.substring(0, braceIndex).trim();
-	}
-};
-
-//#endregion
-export { NamespacePageGenerator };

package/markdown/page-generators/type-alias-page.js

@@ -1,111 +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/type-alias-page.ts
-/**
-* Generates MDX documentation pages for TypeScript type aliases.
-*
-* This class transforms API Extractor type alias 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. Type alias signature block (full type definition)
-* 7. Examples section with Twoslash-enabled code blocks
-* 8. 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 InterfacePageGenerator} for interface documentation
-* @see {@link EnumPageGenerator} for enum documentation
-*/
-var TypeAliasPageGenerator = class {
-	/**
-	* Generate a markdown page for a type alias
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiTypeAlias, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiTypeAlias.displayName;
-		const summary = Tsdoc.summary(apiTypeAlias) || "No description available.";
-		const releaseTag = Tsdoc.releaseTag(apiTypeAlias);
-		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(apiTypeAlias);
-		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(apiTypeAlias, 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`;
-		}
-		if (apiTypeAlias.excerpt.text) {
-			const signature = Signature.format(apiTypeAlias.excerpt).trim();
-			let signatureWithImports = signature;
-			const apiPackage = apiTypeAlias.getAssociatedPackage?.();
-			if (apiPackage) {
-				const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiTypeAlias);
-				signatureWithImports = prependHiddenImports(signature, imports);
-			}
-			const displayCode = stripTwoslashDirectives(signatureWithImports);
-			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(signatureWithImports)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-		}
-		const examples = Tsdoc.examples(apiTypeAlias);
-		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(apiTypeAlias);
-		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}/type/${name.toLowerCase()}`,
-			content
-		};
-	}
-};
-
-//#endregion
-export { TypeAliasPageGenerator };

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

@@ -1,111 +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/variable-page.ts
-/**
-* Generates MDX documentation pages for exported variables and constants.
-*
-* This class transforms API Extractor variable 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. Variable signature block (const/let declaration with type)
-* 7. Examples section with Twoslash-enabled code blocks
-* 8. 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 FunctionPageGenerator} for function documentation
-* @see {@link EnumPageGenerator} for enum documentation
-*/
-var VariablePageGenerator = class {
-	/**
-	* Generate a markdown page for a variable
-	*
-	* @param apiScope - API scope identifier for VFS lookup
-	*/
-	async generate(apiVariable, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
-		const shouldSuppressErrors = suppressExampleErrors ?? true;
-		const name = apiVariable.displayName;
-		const summary = Tsdoc.summary(apiVariable) || "No description available.";
-		const releaseTag = Tsdoc.releaseTag(apiVariable);
-		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(apiVariable);
-		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(apiVariable, 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`;
-		}
-		if (apiVariable.excerpt.text) {
-			const signature = Signature.format(apiVariable.excerpt).trim();
-			let signatureWithImports = signature;
-			const apiPackage = apiVariable.getAssociatedPackage?.();
-			if (apiPackage) {
-				const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiVariable);
-				signatureWithImports = prependHiddenImports(signature, imports);
-			}
-			const displayCode = stripTwoslashDirectives(signatureWithImports);
-			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(signatureWithImports)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
-		}
-		const examples = Tsdoc.examples(apiVariable);
-		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(apiVariable);
-		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}/variable/${name.toLowerCase()}`,
-			content
-		};
-	}
-};
-
-//#endregion
-export { VariablePageGenerator };

package/markdown/prose-linker.js

@@ -1,22 +0,0 @@
-import { CrossLinker } from "@tsdoctor/model";
-
-//#region src/markdown/prose-linker.ts
-/**
-* Per-build prose cross-linker holder. Adapter wiring, not logic: the build
-* program installs the immutable `@tsdoctor/model` CrossLinker built from the
-* routes `prepareWorkItems` computed, and page generators link prose through
-* it. Page generators run synchronously outside any service context, hence
-* the module-level holder (the same shape as the sync-island event emitters).
-*/
-let current = CrossLinker.empty;
-/** Install the cross-linker for the current API build from its route map. */
-function setProseLinker(routes) {
-	current = CrossLinker.fromRoutes(routes);
-}
-/** Cross-link prose text with the currently installed linker. */
-function linkProse(text) {
-	return current.link(text);
-}
-
-//#endregion
-export { linkProse, setProseLinker };

package/tsconfig-parser.js

@@ -1,115 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { TsconfigLoaderSync } from "@effected/tsconfig-json";
-
-//#region src/tsconfig-parser.ts
-/**
-* Reading a `tsconfig.json` into the compiler options the plugin consumes.
-*
-* @remarks
-* A thin adapter over `@effected/tsconfig-json`'s `TsconfigLoaderSync`, which
-* owns `extends` chain resolution (including package specifiers), JSONC
-* parsing and relative-path handling. This module used to hand-roll all three
-* over TypeScript's `parseJsonConfigFileContent`.
-*
-* **The loader returns the tsconfig SPELLING, not the programmatic one.**
-* `target` is `"es2025"` rather than `ts.ScriptTarget.ES2025`, and `lib` is
-* `["esnext"]` rather than `["lib.esnext.d.ts"]`. That is fine, and it is why
-* the normalization seam had to land first: `toProgrammaticCompilerOptions`
-* (`twoslash-transformer.ts`) converts at ONE place, and
-* {@link TypeResolutionCompilerOptions} accepts both spellings by design. Do
-* not convert here — a second conversion site is exactly the drift that made
-* three of four resolution paths load zero lib files once already.
-*
-* @packageDocumentation
-*/
-/**
-* Error thrown when tsconfig.json parsing fails.
-*
-* @remarks
-* Retained as the plugin's own type rather than surfacing the kit's
-* `TsconfigParseError`/`TsconfigExtendsError` directly: `typescript-config.ts`
-* branches on `instanceof TsConfigParseError` to decide whether a failure is
-* already reported, and both kit errors mean the same thing to that caller.
-*/
-var TsConfigParseError = class extends Error {
-	configPath;
-	cause;
-	constructor(configPath, message, cause) {
-		super(`Failed to parse tsconfig at ${configPath}: ${message}`);
-		this.configPath = configPath;
-		this.cause = cause;
-		this.name = "TsConfigParseError";
-	}
-};
-/**
-* The sync host the kit loader reads through.
-*
-* @remarks
-* `node:path` satisfies `SyncPath` verbatim. The filesystem half is two
-* functions, so no shim module is needed.
-*/
-const syncHost = {
-	fileSystem: {
-		exists: existsSync,
-		readFile: (filePath) => readFileSync(filePath, "utf8")
-	},
-	path
-};
-/**
-* Parse a `tsconfig.json` and extract the compiler options used for type
-* resolution.
-*
-* @param configPath - Path to tsconfig.json (relative or absolute)
-* @param projectRoot - Project root directory for resolving relative paths
-* @returns The declared compiler options, in the tsconfig spelling
-* @throws TsConfigParseError if the config cannot be read or parsed
-*
-* @example
-* ```ts
-* const options = parseTsConfig("tsconfig.json", "/path/to/project");
-* // Returns: { target: "es2025", module: "nodenext", lib: ["esnext"], ... }
-* ```
-*/
-function parseTsConfig(configPath, projectRoot) {
-	const absolutePath = path.isAbsolute(configPath) ? configPath : path.resolve(projectRoot, configPath);
-	if (!existsSync(absolutePath)) throw new TsConfigParseError(absolutePath, "File not found");
-	let options;
-	try {
-		options = TsconfigLoaderSync.compilerOptions(absolutePath, syncHost);
-	} catch (error) {
-		throw new TsConfigParseError(absolutePath, error instanceof Error ? error.message : String(error), error);
-	}
-	return extractTypeResolutionOptions(options);
-}
-/**
-* Narrow the full compiler options to the ones the plugin actually consumes.
-*
-* @remarks
-* Deliberately a whitelist. Everything here reaches Twoslash's TypeScript
-* environment, and passing through options the plugin does not understand
-* would let a consumer's unrelated build setting change how examples
-* type-check.
-*/
-function extractTypeResolutionOptions(options) {
-	const result = {};
-	const scalar = (value) => typeof value === "string" || typeof value === "number" ? value : void 0;
-	const target = scalar(options.target);
-	if (target !== void 0) result.target = target;
-	const module_ = scalar(options.module);
-	if (module_ !== void 0) result.module = module_;
-	const moduleResolution = scalar(options.moduleResolution);
-	if (moduleResolution !== void 0) result.moduleResolution = moduleResolution;
-	const jsx = scalar(options.jsx);
-	if (jsx !== void 0) result.jsx = jsx;
-	if (typeof options.strict === "boolean") result.strict = options.strict;
-	if (typeof options.skipLibCheck === "boolean") result.skipLibCheck = options.skipLibCheck;
-	if (typeof options.esModuleInterop === "boolean") result.esModuleInterop = options.esModuleInterop;
-	if (typeof options.allowSyntheticDefaultImports === "boolean") result.allowSyntheticDefaultImports = options.allowSyntheticDefaultImports;
-	if (Array.isArray(options.lib) && options.lib.length > 0) result.lib = options.lib.map(String);
-	if (Array.isArray(options.types) && options.types.length > 0) result.types = options.types.map(String);
-	return result;
-}
-
-//#endregion
-export { TsConfigParseError, parseTsConfig };