rspress-plugin-api-extractor 0.8.1 → 0.8.3

package/build-stages.js

@@ -355,7 +355,8 @@ function generateSinglePage(workItem, ctx) {
 				const existingContent = yield* fileSystem.readFileString(absolutePath).pipe(Effect.orElseSucceed(() => null));
 				if (existingContent !== null) {
 					const { data: existingFrontmatter, content: existingBody } = matter(existingContent);
-					const existingContentHash = hashContent(normalizeMarkdownSpacing(existingBody));
+					const normalizedExistingBody = normalizeMarkdownSpacing(existingBody);
+					const existingContentHash = hashContent(normalizedExistingBody);
 					const existingFrontmatterHash = hashFrontmatter(existingFrontmatter);
 					if (existingContentHash === contentHash && existingFrontmatterHash === frontmatterHash) {
 						publishedTime = existingFrontmatter["article:published_time"] || buildTime;

package/config-helpers.js

@@ -37,7 +37,8 @@ function discoverDir(dir) {
 	};
 }
 function resolveBaseRoute(baseRoute, info) {
-	return normalizeBaseRoute((typeof baseRoute === "function" ? baseRoute(info) : baseRoute).replace(/\{dirname\}/g, info.dirname).replace(/\{packageName\}/g, info.packageName));
+	const interpolated = (typeof baseRoute === "function" ? baseRoute(info) : baseRoute).replace(/\{dirname\}/g, info.dirname).replace(/\{packageName\}/g, info.packageName);
+	return normalizeBaseRoute(interpolated);
 }
 /**
 * Build a `MultiApiConfig` by discovering fields from a single package folder

package/llms-program.js

@@ -200,7 +200,7 @@ function processPrefix(fs, outDir, prefix, buildResults, apiRoutes, llmsPlugin,
 		const llmsFullTxtPath = path.join(prefixDir, "llms-full.txt");
 		const llmsFullTxtContent = (yield* fs.exists(llmsFullTxtPath).pipe(Effect.orElseSucceed(() => false))) ? yield* fs.readFileString(llmsFullTxtPath).pipe(Effect.orDie) : "";
 		if (llmsPlugin.scopes) {
-			const structuredLlmsTxt = generateStructuredLlmsTxt(llmsTxtContent, apiRoutes, buildResults.map((r) => {
+			const packageScopes = buildResults.map((r) => {
 				const pkgRoute = packageRoutes.get(r.packageName) ?? r.baseRoute;
 				return {
 					name: r.apiName ?? r.packageName,
@@ -210,10 +210,12 @@ function processPrefix(fs, outDir, prefix, buildResults, apiRoutes, llmsPlugin,
 					packageRoute: pkgRoute,
 					llmsApiTxtUrl: `${pkgRoute.endsWith("/") ? pkgRoute : `${pkgRoute}/`}llms-api.txt`
 				};
-			}));
+			});
+			const structuredLlmsTxt = generateStructuredLlmsTxt(llmsTxtContent, apiRoutes, packageScopes);
 			yield* fs.writeFileString(llmsTxtPath, structuredLlmsTxt).pipe(Effect.orDie);
 		} else {
-			const filteredLlmsTxt = filterLlmsTxt(llmsTxtContent, apiRoutes, buildPackagePointers(buildResults, prefix, packageRoutes));
+			const pointers = buildPackagePointers(buildResults, prefix, packageRoutes);
+			const filteredLlmsTxt = filterLlmsTxt(llmsTxtContent, apiRoutes, pointers);
 			yield* fs.writeFileString(llmsTxtPath, filteredLlmsTxt).pipe(Effect.orDie);
 		}
 		if (llmsFullTxtContent) {

package/markdown/cross-linker.js

@@ -108,11 +108,12 @@ var MarkdownCrossLinker = class {
 	*/
 	addCrossLinks(text) {
 		if (this.apiItemRoutes.size === 0) return text;
-		return new CrossLinker(Array.from(this.apiItemRoutes.keys()).map((name) => ({
+		const refs = Array.from(this.apiItemRoutes.keys()).map((name) => ({
 			name,
 			kind: "type",
 			slug: name.toLowerCase()
-		})), (ref) => this.apiItemRoutes.get(ref.name) ?? "").addLinks(text);
+		}));
+		return new CrossLinker(refs, (ref) => this.apiItemRoutes.get(ref.name) ?? "").addLinks(text);
 	}
 	/**
 	* Add cross-links to type references in code (HTML format)

package/markdown/helpers.js

@@ -270,7 +270,8 @@ function stripTwoslashDirectives(code) {
 	const cutRanges = [];
 	const cutStartStack = [];
 	for (let i = 0; i < lines.length; i++) {
-		const cutType = classifyCutDirective(lines[i].trim());
+		const trimmed = lines[i].trim();
+		const cutType = classifyCutDirective(trimmed);
 		if (cutType === "cut-before") cutBeforeIndex = i;
 		else if (cutType === "cut-after") cutAfterIndex = i;
 		else if (cutType === "cut-start") cutStartStack.push(i);
@@ -293,7 +294,8 @@ function stripTwoslashDirectives(code) {
 	for (const [start, end] of cutRanges) for (let i = start; i <= end; i++) if (i >= 0 && i < filteredLines.length) excludedLines.add(i);
 	return filteredLines.filter((line, i) => {
 		if (excludedLines.has(i)) return false;
-		if (isTwoslashDirective(line.trim())) return false;
+		const trimmed = line.trim();
+		if (isTwoslashDirective(trimmed)) return false;
 		return true;
 	}).join("\n").trim();
 }

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

@@ -231,7 +231,10 @@ var ClassPageGenerator = class {
 		const signature = this.typeFormatter.format(baseDecl.excerpt).trim();
 		let source = signature;
 		const apiPackage = apiClass.getAssociatedPackage?.();
-		if (apiPackage) source = prependHiddenImports(signature, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(baseDecl));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(baseDecl);
+			source = prependHiddenImports(signature, imports);
+		}
 		const displayCode = stripTwoslashDirectives(source);
 		section += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(source)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
 		return section;
@@ -292,7 +295,10 @@ var ClassPageGenerator = class {
 		const memberSignature = memberItem.excerpt?.text ? this.typeFormatter.format(memberItem.excerpt).trim() : "";
 		const skeleton = `${declaration}\n${memberSignature}\n}`;
 		const apiPackage = apiClass.getAssociatedPackage?.();
-		if (apiPackage) return prependHiddenImports(skeleton, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(targetMember));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(targetMember);
+			return prependHiddenImports(skeleton, imports);
+		}
 		return skeleton;
 	}
 	/**
@@ -302,7 +308,10 @@ var ClassPageGenerator = class {
 	generateClassSkeletonWithTwoslash(apiClass, packageName) {
 		const skeleton = this.generateClassSkeleton(apiClass);
 		const apiPackage = apiClass.getAssociatedPackage?.();
-		if (apiPackage) return prependHiddenImports(skeleton, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiClass));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiClass);
+			return prependHiddenImports(skeleton, imports);
+		}
 		return skeleton;
 	}
 	/**

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

@@ -75,7 +75,10 @@ var FunctionPageGenerator = class {
 			const signature = this.typeFormatter.format(apiFunction.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiFunction.getAssociatedPackage?.();
-			if (apiPackage) signatureWithImports = prependHiddenImports(signature, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiFunction));
+			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`;
 		}

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

@@ -230,7 +230,10 @@ var InterfacePageGenerator = class {
 		const memberSignature = memberItem.excerpt?.text ? this.typeFormatter.format(memberItem.excerpt).trim() : "";
 		const skeleton = `${declaration}\n${memberSignature}\n}`;
 		const apiPackage = apiInterface.getAssociatedPackage?.();
-		if (apiPackage) return prependHiddenImports(skeleton, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(targetMember));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(targetMember);
+			return prependHiddenImports(skeleton, imports);
+		}
 		return skeleton;
 	}
 	/**
@@ -240,7 +243,10 @@ var InterfacePageGenerator = class {
 	generateInterfaceSkeletonWithTwoslash(apiInterface, packageName) {
 		const skeleton = this.generateInterfaceSkeleton(apiInterface);
 		const apiPackage = apiInterface.getAssociatedPackage?.();
-		if (apiPackage) return prependHiddenImports(skeleton, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiInterface));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiInterface);
+			return prependHiddenImports(skeleton, imports);
+		}
 		return skeleton;
 	}
 	/**

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

@@ -157,10 +157,7 @@ var NamespacePageGenerator = class {
 			case ApiItemKind.Enum:
 				enums.push(member);
 				break;
-			case ApiItemKind.Namespace:
-				namespaces.push(member);
-				break;
-			default: break;
+			case ApiItemKind.Namespace: namespaces.push(member);
 		}
 		return {
 			classes,
@@ -202,7 +199,10 @@ var NamespacePageGenerator = class {
 	generateNamespaceSkeletonWithTwoslash(apiNamespace, packageName) {
 		const skeleton = this.generateNamespaceSkeleton(apiNamespace);
 		const apiPackage = apiNamespace.getAssociatedPackage?.();
-		if (apiPackage) return prependHiddenImports(skeleton, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiNamespace));
+		if (apiPackage) {
+			const imports = new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiNamespace);
+			return prependHiddenImports(skeleton, imports);
+		}
 		return skeleton;
 	}
 	/**

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

@@ -71,7 +71,10 @@ var TypeAliasPageGenerator = class {
 			const signature = this.typeFormatter.format(apiTypeAlias.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiTypeAlias.getAssociatedPackage?.();
-			if (apiPackage) signatureWithImports = prependHiddenImports(signature, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiTypeAlias));
+			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`;
 		}

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

@@ -71,7 +71,10 @@ var VariablePageGenerator = class {
 			const signature = this.typeFormatter.format(apiVariable.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiVariable.getAssociatedPackage?.();
-			if (apiPackage) signatureWithImports = prependHiddenImports(signature, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(apiVariable));
+			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`;
 		}

package/observability/sinks/metrics-sink.js

@@ -58,10 +58,7 @@ function makeMetricsSink() {
 				case "PhaseCompleted":
 					Effect.runSync(Metric.update(BuildMetrics.phaseDuration, event.durationMs));
 					break;
-				case "DefaultApplied":
-					Effect.runSync(Metric.update(BuildMetrics.configDefaultsApplied, 1));
-					break;
-				default: break;
+				case "DefaultApplied": Effect.runSync(Metric.update(BuildMetrics.configDefaultsApplied, 1));
 			}
 		}
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.8.1",
+	"version": "0.8.3",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -39,12 +39,12 @@
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-beta.101",
 		"@effect/sql-sqlite-node": "4.0.0-beta.101",
-		"@effected/semver": "^0.2.1",
-		"@effected/store": "^0.1.2",
-		"@effected/tsconfig-json": "^0.4.0",
-		"@effected/xdg": "^0.1.9",
+		"@effected/semver": "^0.3.1",
+		"@effected/store": "^0.1.3",
+		"@effected/tsconfig-json": "^0.4.1",
+		"@effected/xdg": "^0.1.10",
 		"@microsoft/api-extractor-model": "^7.33.10",
-		"@shikijs/twoslash": "^4.3.1",
+		"@shikijs/twoslash": "^4.4.1",
 		"@typescript/vfs": "^1.6.4",
 		"api-extractor-llms": "^0.2.0",
 		"clsx": "^2.1.1",
@@ -58,13 +58,13 @@
 		"open": "^11.0.0",
 		"prettier": "^3.9.6",
 		"react-markdown": "^10.1.0",
-		"shiki": "^4.3.1",
-		"type-registry-effect": "^2.3.1",
+		"shiki": "^4.4.1",
+		"type-registry-effect": "^2.3.2",
 		"typescript": "^6.0.3",
 		"unist-util-visit": "^5.1.0"
 	},
 	"peerDependencies": {
-		"@rspress/core": "^2.0.0",
+		"@rspress/core": "^2.0.19",
 		"react": "^19.2.0",
 		"react-dom": "^19.2.0"
 	},

package/plugin.js

@@ -163,10 +163,11 @@ function ApiExtractorPluginImpl(rawOptions) {
 				});
 				for (const dp of derivedPaths) fs.mkdirSync(dp.outputDir, { recursive: true });
 			} else if (options.apis) for (const api of options.apis) {
+				const baseRoute = normalizeBaseRoute(api.baseRoute ?? `/${unscopedName(api.packageName)}`);
 				const derivedPaths = deriveOutputPaths({
 					mode: "multi",
 					docsRoot: rspressRoot,
-					baseRoute: normalizeBaseRoute(api.baseRoute ?? `/${unscopedName(api.packageName)}`),
+					baseRoute,
 					apiFolder: api.apiFolder ?? "api",
 					locales: rspressLocales,
 					defaultLang: rspressLang,

package/runtime/components/MarkdownText/index.js

@@ -6,7 +6,8 @@ import { Fragment, jsx } from "react/jsx-runtime";
 * Only supports basic markdown links: [text](url)
 */
 function MarkdownText({ children }) {
-	return /* @__PURE__ */ jsx(Fragment, { children: parseMarkdownLinks(children) });
+	const parts = parseMarkdownLinks(children);
+	return /* @__PURE__ */ jsx(Fragment, { children: parts });
 }
 /**
 * Parse markdown links and return array of React nodes

package/runtime/components/MemberSignature/index.css

@@ -1,5 +1,8 @@
+.sBksbq_blockWrapper {
+  padding: var(--api-spacing-xl) 0;
+}
+
 .sBksbq_block {
-  margin: var(--api-spacing-xl) 0;
   border-radius: var(--api-border-radius);
   border: 1px solid var(--api-color-border);
   position: relative;
@@ -13,7 +16,7 @@ html.sBksbq_rp-dark .sBksbq_block {
 .sBksbq_hasParameters {
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
-  margin-bottom: 0;
+  padding-bottom: 0;
 }
 
 .sBksbq_hasParameters .api-signature-code {

package/runtime/components/MemberSignature/index.js

@@ -24,23 +24,26 @@ function MemberSignature({ hast, memberName, id, summary, hasParameters = false
 		if (summary) markdown += `\n\n${summary}`;
 		return /* @__PURE__ */ jsx(Fragment, { children: markdown });
 	}
-	return /* @__PURE__ */ jsxs("div", {
-		className: clsx(index_module_default.block, hasParameters && index_module_default.hasParameters),
-		children: [/* @__PURE__ */ jsx(SignatureToolbar, {
-			heading: {
-				text: memberName,
-				...id != null ? { id } : {},
-				level: "h3"
-			},
-			...summary != null ? { summary } : {},
-			buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
-				wrapped,
-				onToggle: toggleWrap
-			})
-		}), /* @__PURE__ */ jsx(SignatureCode, {
-			hast,
-			wrapped
-		})]
+	return /* @__PURE__ */ jsx("section", {
+		className: clsx(index_module_default.blockWrapper, hasParameters && index_module_default.hasParameters),
+		children: /* @__PURE__ */ jsxs("div", {
+			className: index_module_default.block,
+			children: [/* @__PURE__ */ jsx(SignatureToolbar, {
+				heading: {
+					text: memberName,
+					...id != null ? { id } : {},
+					level: "h3"
+				},
+				...summary != null ? { summary } : {},
+				buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
+					wrapped,
+					onToggle: toggleWrap
+				})
+			}), /* @__PURE__ */ jsx(SignatureCode, {
+				hast,
+				wrapped
+			})]
+		})
 	});
 }
 /**

package/runtime/components/MemberSignature/index.module.js

@@ -2,6 +2,7 @@ import './index.css';
 //#region src/runtime/components/MemberSignature/index.module.css
 var index_module_default = {
 	"block": "sBksbq_block",
+	"blockWrapper": "sBksbq_blockWrapper",
 	"hasParameters": "sBksbq_hasParameters",
 	"rpDark": "sBksbq_rp-dark"
 };

package/runtime/components/SignatureBlock/index.css

@@ -1,5 +1,8 @@
+.PJvwTW_blockWrapper {
+  padding: var(--api-spacing-xl) 0;
+}
+
 .PJvwTW_block {
-  margin: var(--api-spacing-xl) 0;
   border-radius: var(--api-border-radius);
   border: 1px solid var(--api-color-border);
   position: relative;
@@ -11,9 +14,10 @@ html.PJvwTW_rp-dark .PJvwTW_block {
 }
 
 .PJvwTW_hasParameters {
+  border-bottom-width: 0;
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
-  margin-bottom: 0;
+  padding-bottom: 0;
 }
 
 .PJvwTW_hasParameters .api-signature-code {

package/runtime/components/SignatureBlock/index.js

@@ -15,22 +15,26 @@ import clsx from "clsx";
 */
 function SignatureBlock({ hast, heading = "Signature", id = "signature", hasParameters = false }) {
 	const { wrapped, toggleWrap } = useWrapToggle();
-	return /* @__PURE__ */ jsxs("div", {
-		className: clsx(index_module_default.block, hasParameters && index_module_default.hasParameters),
-		children: [/* @__PURE__ */ jsx(SignatureToolbar, {
-			...heading && id ? { heading: {
-				text: heading,
-				id,
-				level: "h2"
-			} } : {},
-			buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
-				wrapped,
-				onToggle: toggleWrap
-			})
-		}), /* @__PURE__ */ jsx(SignatureCode, {
-			hast,
-			wrapped
-		})]
+	return /* @__PURE__ */ jsx("section", {
+		id,
+		className: clsx("rp-toc-include", index_module_default.blockWrapper, hasParameters && index_module_default.hasParameters),
+		children: /* @__PURE__ */ jsxs("div", {
+			className: index_module_default.block,
+			children: [/* @__PURE__ */ jsx(SignatureToolbar, {
+				...heading && id ? { heading: {
+					text: heading,
+					id,
+					level: "h2"
+				} } : {},
+				buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
+					wrapped,
+					onToggle: toggleWrap
+				})
+			}), /* @__PURE__ */ jsx(SignatureCode, {
+				hast,
+				wrapped
+			})]
+		})
 	});
 }
 

package/runtime/components/SignatureBlock/index.module.js

@@ -2,6 +2,7 @@ import './index.css';
 //#region src/runtime/components/SignatureBlock/index.module.css
 var index_module_default = {
 	"block": "PJvwTW_block",
+	"blockWrapper": "PJvwTW_blockWrapper",
 	"hasParameters": "PJvwTW_hasParameters",
 	"rpDark": "PJvwTW_rp-dark"
 };

package/runtime/components/SignatureToolbar/index.css

@@ -41,6 +41,7 @@ html.pmgBdW_rp-dark .pmgBdW_toolbar {
   line-height: var(--api-line-height-base);
   user-select: auto;
   margin: 0;
+  scroll-margin-top: 1.5rem;
   position: relative;
   overflow: visible;
 }
@@ -51,13 +52,14 @@ html.pmgBdW_rp-dark .pmgBdW_memberHeading {
 
 .pmgBdW_memberHeading .rp-header-anchor {
   opacity: 0;
-  font-weight: 500;
-  font-size: inherit;
   color: var(--rp-c-brand);
+  font-size: 1.5rem;
+  font-weight: 500;
   text-decoration: none;
   transition: color .25s, opacity .25s;
   position: absolute;
-  left: -1.2rem;
+  top: -.1rem;
+  left: -.6rem;
 }
 
 .pmgBdW_memberHeading:hover .rp-header-anchor {
@@ -65,7 +67,7 @@ html.pmgBdW_rp-dark .pmgBdW_memberHeading {
 }
 
 .pmgBdW_memberHeading .rp-header-anchor:hover {
-  border-bottom: 1px solid var(--rp-c-brand);
+  border-bottom: 0px solid var(--rp-c-brand);
   opacity: .85;
 }
 
@@ -76,6 +78,7 @@ html.pmgBdW_rp-dark .pmgBdW_memberHeading {
   margin-top: 0;
   margin-bottom: 0;
   padding-top: 0;
+  scroll-margin-top: 1.5rem;
   font-weight: 600;
   line-height: 2rem;
 }

package/runtime/components/shared/variables.css

@@ -14,8 +14,8 @@
   --api-spacing-xs: .375rem;
   --api-spacing-sm: .5rem;
   --api-spacing-md: .75rem;
-  --api-spacing-lg: 1rem;
-  --api-spacing-xl: 1.5rem;
+  --api-spacing-lg: 1.15rem;
+  --api-spacing-xl: 1.15rem;
   --api-border-radius: 6px;
   --api-border-radius-sm: 3px;
   --api-border-radius-md: 4px;
@@ -44,6 +44,10 @@
   text-decoration: var(--api-shiki-light-text-decoration, inherit);
 }
 
+.api-doc-code .shiki span.line {
+  padding-left: 0;
+}
+
 html.rp-dark .api-doc-code .shiki, html.rp-dark .api-doc-code .shiki span {
   color: var(--api-shiki-dark);
   background-color: var(--api-shiki-dark-bg, inherit);

package/twoslash-transformer.js

@@ -131,7 +131,8 @@ function renderMarkdown(markdown) {
 	try {
 		let transformed = transformTsDocLinks(markdown);
 		transformed = transformed.split(/\n\n+/).map((para) => para.replace(/\s+/g, " ").trim()).filter((para) => para.length > 0).join("\n\n");
-		const hast = toHast(fromMarkdown(transformed));
+		const mdast = fromMarkdown(transformed);
+		const hast = toHast(mdast);
 		if (hast && "children" in hast) {
 			const children = hast.children;
 			for (const child of children) addLinkClasses(child);