rspress-plugin-api-extractor 0.13.3 → 0.15.0

package/layers/config-resolution.js

@@ -2,23 +2,22 @@ import { BuildId } from "../BuildEnv.js";
 import { BuildMetrics } from "./build-metrics.js";
 import { PluginEvent } from "../observability/events.js";
 import { emit, wantsLevel } from "../observability/EventBus.js";
-import { TypeReferenceExtractor } from "../type-reference-extractor.js";
 import { withPhase } from "../observability/spans.js";
 import { normalizeThemeConfig } from "../markdown/shiki-utils.js";
-import { apiScopeOf, deriveOutputPaths, normalizeBaseRoute, unscopedName } from "../path-derivation.js";
 import { classifyApiConfig, extractAutoDetectedPackages, isVersionConfig, mergeLlmsPluginConfig, validateExternalPackages } from "../config-utils.js";
-import { ApiExtractedPackage } from "../api-extracted-package.js";
 import { CategoryResolver } from "../category-resolver.js";
 import { ConfigValidationError } from "../errors.js";
 import { loadApiModel, loadPackageJson, loadVersionModel } from "../model-loader.js";
+import { deriveOutputPaths } from "../path-derivation.js";
 import { DEFAULT_CATEGORIES } from "../schemas/config.js";
 import { PluginConfig } from "../services/PluginConfig.js";
 import { TypeRegistryService } from "../services/TypeRegistryService.js";
 import { emitVfsPayloadEvents, mergeApiResult } from "./api-results.js";
 import { mergeExternalTypes } from "./external-types.js";
 import { registerTypeEnvironments, resolveTsConfigTyped } from "./type-environment.js";
-import path from "node:path";
+import { apiScopeOf, normalizeBaseRoute, unscopedName } from "@tsdoctor/pages";
 import { Effect, Metric } from "effect";
+import { ApiExtractedPackage, TypeReferenceExtractor } from "@tsdoctor/model";
 import { deriveSiteUrl } from "@tsdoctor/seo";
 import { hashContent } from "@tsdoctor/snapshot";
 import { PackageManifest } from "@effected/package-json";
@@ -241,7 +240,7 @@ const makeConfigService = Effect.gen(function* () {
 				});
 				const externalPackages = api.externalPackages || extractAutoDetectedPackages(packageJson, api.autoDetectDependencies);
 				if (externalPackages && externalPackages.length > 0) yield* Metric.update(BuildMetrics.externalPackagesTotal, externalPackages.length);
-				const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).generateVfs();
+				const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).toVfs();
 				const vfsPayloads = prependImportsToVfs(vfs, apiPackage, api.packageName, wantTrace);
 				const resolvedOgImage = api.ogImage ?? options.ogImage;
 				const resolvedTheme = normalizeThemeConfig(api.theme);
@@ -262,7 +261,6 @@ const makeConfigService = Effect.gen(function* () {
 						...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
 						...siteUrl != null ? { siteUrl } : {},
 						...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-						docsDir: path.dirname(outputDir),
 						...docsRoot != null ? { docsRoot } : {},
 						...resolvedTheme != null ? { theme: resolvedTheme } : {}
 					}
@@ -321,7 +319,7 @@ const makeConfigService = Effect.gen(function* () {
 							const autoDetectOptions = versionAutoDetectDependencies || api.autoDetectDependencies;
 							const externalPackages = versionExternalPackages || api.externalPackages || extractAutoDetectedPackages(packageJson, autoDetectOptions);
 							if (externalPackages && externalPackages.length > 0) yield* Metric.update(BuildMetrics.externalPackagesTotal, externalPackages.length);
-							const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).generateVfs();
+							const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).toVfs();
 							const vfsPayloads = prependImportsToVfs(vfs, apiPackage, api.packageName, wantTrace);
 							const resolvedOgImage = versionOgImage ?? api.ogImage ?? options.ogImage;
 							const resolvedTheme = normalizeThemeConfig(api.theme);
@@ -344,7 +342,6 @@ const makeConfigService = Effect.gen(function* () {
 									...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
 									...siteUrl != null ? { siteUrl } : {},
 									...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-									docsDir: path.dirname(outputDir),
 									...docsRoot != null ? { docsRoot } : {},
 									...resolvedTheme != null ? { theme: resolvedTheme } : {}
 								}

package/layers/type-environment.js

@@ -1,11 +1,10 @@
 import { PluginEvent } from "../observability/events.js";
 import { emit } from "../observability/EventBus.js";
-import { resolveTypeScriptConfig } from "../typescript-config.js";
 import { TwoslashEnvironments } from "../services/TwoslashEnvironments.js";
 import { ConfigValidationError } from "../errors.js";
-import { twoslashEnvHash } from "../twoslash-cache.js";
 import { TwoslashCacheService } from "../services/TwoslashCacheService.js";
 import { Effect } from "effect";
+import { resolveTypeScriptConfig, twoslashEnvHash } from "@tsdoctor/vfs";
 import ts from "typescript";
 
 //#region src/layers/type-environment.ts
@@ -64,12 +63,14 @@ const resolveTsConfigTyped = (projectRoot, config) => Effect.tryPromise({
 */
 const registerTypeEnvironments = (input) => Effect.gen(function* () {
 	const twoslashEnv = twoslashEnvHash(input.combinedVfs, `typescript@${ts.version}`);
-	const twoslashCache = yield* (yield* TwoslashCacheService).open(twoslashEnv);
+	const cacheSvc = yield* TwoslashCacheService;
+	const twoslashCache = yield* cacheSvc.open(twoslashEnv);
 	yield* emit(PluginEvent.TwoslashCacheLoaded({
 		ctx: {},
 		level: "debug",
 		envHash: twoslashEnv,
-		entries: twoslashCache.entries().size
+		entries: twoslashCache.entries().size,
+		degraded: cacheSvc.degraded
 	}));
 	const twoslashStartMs = performance.now();
 	const environments = yield* TwoslashEnvironments;

package/llms-program.js

@@ -1,14 +1,14 @@
 import { PluginEvent } from "./observability/events.js";
 import { emit } from "./observability/EventBus.js";
-import { filterLlmsFullTxt, filterLlmsTxt, generatePackageLlmsFullTxt, generatePackageLlmsTxt, generateStructuredLlmsTxt, parseLlmsTxtLine } from "./llms-processing.js";
 import path from "node:path";
+import { filterLlmsFullTxt, filterLlmsTxt, generatePackageLlmsFullTxt, generatePackageLlmsTxt, generateStructuredLlmsTxt, parseLlmsTxtLine } from "@tsdoctor/pages";
 import { Effect, FileSystem } from "effect";
 
 //#region src/llms-program.ts
 /**
 * Effect program for post-processing LLMs text files in afterBuild.
 *
-* Wires the pure processing functions from llms-processing.ts into the
+* Wires the pure processing functions from @tsdoctor/pages into the
 * plugin lifecycle, handling file I/O via the core `effect` FileSystem service.
 *
 * Responsibilities:
@@ -89,7 +89,7 @@ function buildPackagePointers(buildResults, prefix, packageRoutes) {
 * Collect API page entries from the global llms.txt for a specific package.
 *
 * Parses the global llms.txt to find entries whose URLs match this package's
-* generated API routes, building the LlmsTxtEntry array for per-package files.
+* generated API routes, building the `LlmsTxtEntry` array for per-package files.
 */
 function collectApiEntries(globalLlmsTxtContent, result) {
 	const base = result.baseRoute.endsWith("/") ? result.baseRoute : `${result.baseRoute}/`;

package/markdown/helpers.js

@@ -1,44 +1,18 @@
-import { emitFrontmatterBlock } from "../frontmatter.js";
-import { classifyCutDirective, isTwoslashDirective } from "../twoslash-patterns.js";
-import { formatCode } from "../prettier-formatter.js";
-import { TypeReferenceExtractor } from "../type-reference-extractor.js";
+import { emitFrontmatterBlock } from "@tsdoctor/model";
 
 //#region src/markdown/helpers.ts
 /**
-* Generate an "Available from" line for items exported from multiple entry points.
-* Returns empty string if only one entry point or none provided.
-*/
-function generateAvailableFrom(packageName, availableFrom) {
-	if (!availableFrom || availableFrom.length <= 1) return "";
-	return `Available from: ${availableFrom.map((ep) => ep === "default" ? `\`${packageName}\`` : `\`${packageName}/${ep}\``).join(", ")}\n\n`;
-}
-/**
-* Prepare example code for Twoslash rendering.
+* Frontmatter assembly for generated pages: the structured title and the
+* rendering of neutral `@tsdoctor/seo` head tags into RSPress `head` pairs.
 *
-* Prepares the code with imports and error directives but does NOT render HTML.
-* Use this for raw markdown output or as input to pre-rendering.
+* @remarks
+* This stays adapter-side on purpose. The snapshot frontmatter hash is
+* taken over the FINAL assembled block in the generate stage, and the
+* `children` spelling for a JSON-LD script body is RSPress's — the IR
+* carries facts and a `HeadTag[]`, not a frontmatter block.
 *
-* @param example - The example with language and code
-* @param apiItemName - The name of the API item being documented
-* @param packageName - The package name for imports
-* @param suppressErrors - Whether to suppress all TypeScript errors (default: true)
-* @returns Object with prepared code and whether it's TypeScript
+* @packageDocumentation
 */
-function prepareExampleCode(example, apiItemName, packageName, suppressErrors = true) {
-	const { language, code } = example;
-	if (!(language === "typescript" || language === "ts" || language === "javascript" || language === "js")) return {
-		code,
-		isTypeScript: false,
-		language
-	};
-	const importLine = `import { ${apiItemName} } from "${packageName}";`;
-	const finalCode = code.includes(`from "${packageName}"`) || code.includes(`from '${packageName}'`) ? code : `${importLine}\n${code}`;
-	return {
-		code: `${suppressErrors ? "// @noErrors\n" : ""}${finalCode}`,
-		isTypeScript: true,
-		language: "typescript"
-	};
-}
 /**
 * Collapse newlines and runs of whitespace to single spaces, and trim.
 *
@@ -53,28 +27,6 @@ function cleanYamlValue(value) {
 	return value.replace(/[\r\n]+/g, " ").replace(/\s+/g, " ").trim();
 }
 /**
-* Escape generic type parameters in MDX by wrapping them in backticks.
-*
-* Prevents MDX from interpreting `<T>`, `<TEnv>`, etc. as JSX tags by
-* wrapping them in inline code backticks.
-*
-* @param text - The text containing generic type parameters
-* @returns Text with generics wrapped in backticks
-*
-* @example
-* ```ts
-* escapeMdxGenerics("Returns Promise<T>");        // "Returns Promise`<T>`"
-* escapeMdxGenerics("Map<K, V> extends...");      // "Map`<K, V>` extends..."
-* escapeMdxGenerics("`Pipeline<I, O>`");           // "`Pipeline<I, O>`" (unchanged)
-* ```
-*/
-function escapeMdxGenerics(text) {
-	return text.split(/(`[^`]+`)/g).map((part) => {
-		if (part.startsWith("`") && part.endsWith("`")) return part;
-		return part.replace(/<([A-Z][A-Za-z0-9_]*(?:\s+extends\s+[^>]+)?(?:,\s*[A-Z][A-Za-z0-9_]*(?:\s+extends\s+[^>]+)?)*)>/g, "`<$1>`");
-	}).join("");
-}
-/**
 * Build a structured page title for API documentation.
 *
 * Creates a title in the format: `{entityName} | {singularName} | API | {apiName}`
@@ -142,125 +94,6 @@ function generateFrontmatter(entityName, description, singularName, apiName, tag
 	if (headEntries.length > 0) data.head = headEntries;
 	return emitFrontmatterBlock(data);
 }
-/**
-* Strip Twoslash directives from code for display purposes.
-*
-* Removes Twoslash directive comments like `// @noErrors`, `// @errors: 2304`,
-* `// @filename: ...`, etc. from code so users see clean output and don't
-* copy directives when using the copy button.
-*
-* Also handles cut directives:
-* - `// ---cut---` - Removes this line and all lines before it
-* - `// ---cut-before---` - Same as ---cut---
-* - `// ---cut-after---` - Removes this line and all lines after it
-*
-* @param code - The code containing Twoslash directives
-* @returns Code with Twoslash directives removed
-*
-* @example
-* ```ts
-* const display = stripTwoslashDirectives("// @noErrors\nconst x = 1;");
-* // Returns: "const x = 1;"
-* ```
-*/
-function stripTwoslashDirectives(code) {
-	const lines = code.split("\n");
-	let cutBeforeIndex = -1;
-	let cutAfterIndex = -1;
-	const cutRanges = [];
-	const cutStartStack = [];
-	for (let i = 0; i < lines.length; i++) {
-		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);
-		else if (cutType === "cut-end") {
-			const startIdx = cutStartStack.pop();
-			if (startIdx !== void 0) cutRanges.push([startIdx, i]);
-		}
-	}
-	let filteredLines = lines;
-	if (cutBeforeIndex >= 0) {
-		filteredLines = filteredLines.slice(cutBeforeIndex + 1);
-		if (cutAfterIndex >= 0) cutAfterIndex = cutAfterIndex - cutBeforeIndex - 1;
-		for (const range of cutRanges) {
-			range[0] -= cutBeforeIndex + 1;
-			range[1] -= cutBeforeIndex + 1;
-		}
-	}
-	if (cutAfterIndex >= 0) filteredLines = filteredLines.slice(0, cutAfterIndex);
-	const excludedLines = /* @__PURE__ */ new Set();
-	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;
-		const trimmed = line.trim();
-		if (isTwoslashDirective(trimmed)) return false;
-		return true;
-	}).join("\n").trim();
-}
-/**
-* Format import statements with cut directive for hidden imports.
-*
-* Prepends import statements followed by `// ---cut---` so Twoslash can
-* resolve the types but the imports are hidden from rendered output.
-*
-* @param imports - Import statements to format
-* @returns Formatted import block with cut directive, or empty string if no imports
-*
-* @example
-* ```ts
-* const imports = [{ packageName: "zod", symbols: new Set(["ZodType"]), typeOnly: true }];
-* const block = formatImportsWithCut(imports);
-* // Returns:
-* // import type { ZodType } from "zod";
-* // // ---cut---
-* ```
-*/
-function formatImportsWithCut(imports) {
-	if (imports.length === 0) return "";
-	return `${TypeReferenceExtractor.formatImports(imports).join("\n")}\n// ---cut---\n`;
-}
-/**
-* Prepend hidden imports to code using the Twoslash cut directive.
-*
-* This enables type resolution for external types while hiding the import
-* statements from rendered output. The existing `stripTwoslashDirectives()`
-* function handles removing the cut block for clipboard copying.
-*
-* @param code - The code to prepend imports to
-* @param imports - Import statements to add
-* @returns Code with imports prepended (if any), or original code if no imports
-*
-* @example
-* ```ts
-* const code = "function foo(): RsbuildPlugin";
-* const imports = [{ packageName: "@rsbuild/core", symbols: new Set(["RsbuildPlugin"]), typeOnly: true }];
-* const result = prependHiddenImports(code, imports);
-* // Returns:
-* // import type { RsbuildPlugin } from "@rsbuild/core";
-* // // ---cut---
-* // function foo(): RsbuildPlugin
-* ```
-*/
-function prependHiddenImports(code, imports) {
-	const importBlock = formatImportsWithCut(imports);
-	return importBlock ? importBlock + code : code;
-}
-/**
-* Format example code using Prettier for consistent styling.
-*
-* Wraps the Prettier formatter with error handling and context tracking.
-* If formatting fails, returns the original code (fallthrough behavior).
-*
-* @param code - The code to format
-* @param language - The code fence language (e.g., "typescript", "ts")
-* @param _context - Optional context (reserved for future use)
-* @returns The formatted code (or original if formatting fails)
-*/
-async function formatExampleCode(code, language, _context) {
-	return (await formatCode(code, language)).code;
-}
 
 //#endregion
-export { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives };
+export { generateFrontmatter };

package/observability/sinks/console-sink.js

@@ -22,12 +22,10 @@ function render(event) {
 		case "SlowOperation": return `slow ${event.operation}: ${event.durationMs}ms (>${event.threshold}ms)`;
 		case "ConfigCascadeWarning": return event.ignored.length > 2 ? `${event.field}: using '${event.chosen}', ignoring ${event.ignored.length} alternatives (first configured value wins)` : `${event.field}: using '${event.chosen}', ignoring ${event.ignored.join(", ")}`;
 		case "ConfigValidationWarning": return `${event.field}: rejected '${event.value}'${event.reason ? ` — ${event.reason}` : ""}`;
-		case "DeprecatedConfigUsed": return `option '${event.key}' is deprecated; use ${event.replacement}`;
 		case "ModelLoaded": return `loaded model: ${event.itemCount} items, ${event.entryPoints} entry point(s) (${event.durationMs}ms)`;
-		case "ConfigResolved": return `resolved ${event.baseRoute}: ${event.categoryCount} categories, ${event.externalCount} external`;
 		case "TwoslashDiagnostic": return `Twoslash TS${event.code} in ${event.file}:${event.line}:${event.col}: ${event.message}`;
 		case "TwoslashCheckFailed": return `Twoslash check failed (TS${event.code}) in ${event.file}; ${event.fsMapKeys.length} VFS files`;
-		case "TwoslashCacheLoaded": return event.entries > 0 ? `Twoslash cache: restored ${event.entries} cached result(s)` : "Twoslash cache: cold (no cached results for this type environment)";
+		case "TwoslashCacheLoaded": return event.degraded ? "Twoslash cache: DEGRADED (unusable cache directory) — every block will be type-checked, every build" : event.entries > 0 ? `Twoslash cache: restored ${event.entries} cached result(s)` : "Twoslash cache: cold (no cached results for this type environment)";
 		case "TwoslashCacheSaved": {
 			const total = event.hits + event.misses;
 			const pct = total > 0 ? Math.round(event.hits / total * 100) : 0;

package/observability/sinks/metrics-sink.js

@@ -100,8 +100,6 @@ function makeMetricsSink(context) {
 				case "PhaseCompleted":
 					update(BuildMetrics.phaseDuration, event.durationMs);
 					both(BuildMetrics.phaseTimeMs, event.durationMs, { phase: event.phase });
-					break;
-				case "DefaultApplied": update(BuildMetrics.configDefaultsApplied, 1);
 			}
 		}
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.13.3",
+	"version": "0.15.0",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -41,22 +41,24 @@
 		"@effected/github": "^0.8.0",
 		"@effected/glob": "^0.4.0",
 		"@effected/jsonc": "^0.8.1",
-		"@effected/markdown": "^0.7.0",
+		"@effected/markdown": "^0.8.0",
 		"@effected/npm": "^0.12.1",
 		"@effected/package-json": "^0.13.0",
 		"@effected/semver": "^0.5.0",
-		"@effected/store": "^0.5.0",
-		"@effected/tsconfig-json": "^0.6.1",
+		"@effected/store": "^0.6.0",
+		"@effected/tsconfig-json": "^0.7.0",
 		"@effected/walker": "^0.5.0",
 		"@effected/xdg": "^0.3.0",
 		"@effected/yaml": "^0.12.0",
 		"@microsoft/api-extractor-model": "^7.33.11",
 		"@shikijs/twoslash": "^4.4.3",
 		"@tsdoctor/bundle": "0.2.2",
-		"@tsdoctor/model": "0.4.1",
-		"@tsdoctor/registry": "0.2.2",
+		"@tsdoctor/model": "0.6.0",
+		"@tsdoctor/pages": "0.1.0",
+		"@tsdoctor/registry": "0.3.1",
 		"@tsdoctor/seo": "0.1.1",
-		"@tsdoctor/snapshot": "0.2.2",
+		"@tsdoctor/snapshot": "0.2.3",
+		"@tsdoctor/vfs": "0.2.0",
 		"@typescript/vfs": "^1.6.4",
 		"clsx": "^2.1.1",
 		"effect": "4.0.0-rc.109",

package/path-derivation.js

@@ -1,16 +1,6 @@
 import path from "node:path";
 
 //#region src/path-derivation.ts
-/** Extract unscoped name from a potentially scoped package name */
-function unscopedName(packageName) {
-	return packageName.startsWith("@") ? packageName.split("/")[1] ?? packageName : packageName;
-}
-/** Normalize baseRoute: ensure leading slash, strip trailing slash, preserve root "/" */
-function normalizeBaseRoute(route) {
-	const withSlash = route.startsWith("/") ? route : `/${route}`;
-	const stripped = withSlash.endsWith("/") ? withSlash.slice(0, -1) : withSlash;
-	return stripped === "" ? "/" : stripped;
-}
 function deriveOutputPaths(input) {
 	const { docsRoot, baseRoute, apiFolder, locales, defaultLang, versions, defaultVersion } = input;
 	const results = [];
@@ -43,24 +33,6 @@ function deriveOutputPaths(input) {
 	}
 	return results;
 }
-/**
-* The API scope key derived from a base route.
-*
-* @remarks
-* Load-bearing and previously duplicated. Config resolution registers each
-* API's Twoslash environment under this key and the build program looks it up
-* by the same key; if the two derivations disagree, every lookup misses and
-* `getTransformer` falls back to the build-wide environment. Per-scope
-* type-checking degrades to build-wide with no error and nothing visibly
-* wrong in the output — the failure mode is silent, which is why one
-* definition matters more here than the duplication was costing.
-*
-* Falls back to the package name so a single-API site mounted at `/` still
-* gets a non-empty scope.
-*/
-function apiScopeOf(baseRoute, packageName) {
-	return baseRoute.replace(/^\//, "").split("/")[0] || packageName;
-}
 
 //#endregion
-export { apiScopeOf, deriveOutputPaths, normalizeBaseRoute, unscopedName };
+export { deriveOutputPaths };

package/plugin.js

@@ -6,9 +6,9 @@ import { clearTypeRoutes } from "./twoslash-transformer.js";
 import { TwoslashEnvironments } from "./services/TwoslashEnvironments.js";
 import { VfsRegistry } from "./vfs-registry.js";
 import { generateApiDocs } from "./build-program.js";
-import { deriveOutputPaths, normalizeBaseRoute, unscopedName } from "./path-derivation.js";
 import { fromDir, fromParentDir } from "./config-helpers.js";
 import { classifyApiConfig, mergeLlmsPluginConfig } from "./config-utils.js";
+import { deriveOutputPaths } from "./path-derivation.js";
 import { resolveObservability } from "./schemas/observability.js";
 import { PluginOptions } from "./schemas/config.js";
 import { TwoslashCacheService } from "./services/TwoslashCacheService.js";
@@ -27,6 +27,7 @@ import fsSync from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { normalizeBaseRoute, unscopedName } from "@tsdoctor/pages";
 import { Effect, FileSystem, ManagedRuntime, Option, Ref, Schema } from "effect";
 
 //#region src/plugin.ts
@@ -54,10 +55,8 @@ function ApiExtractorPluginImpl(rawOptions) {
 	const isInert = classifyApiConfig(options) === "disabled";
 	const envLogLevel = process.env.LOG_LEVEL?.toLowerCase();
 	const buildId = `${process.pid}-${performance.now().toString(36)}`;
-	const { resolved: obs, deprecations } = resolveObservability({
+	const { resolved: obs } = resolveObservability({
 		...options.observability ? { observability: options.observability } : {},
-		...options.logLevel ? { logLevel: options.logLevel } : {},
-		...options.performance ? { performance: { ...options.performance.thresholds !== void 0 ? { thresholds: options.performance.thresholds } : {} } } : {},
 		...envLogLevel ? { envLogLevel } : {},
 		cwd: process.cwd(),
 		buildId
@@ -184,12 +183,6 @@ function ApiExtractorPluginImpl(rawOptions) {
 			clearTypeRoutes();
 			fileContextMap.clear();
 			issuesSink.reset();
-			for (const dep of deprecations) emitSync(PluginEvent.DeprecatedConfigUsed({
-				ctx: { buildId },
-				level: "warn",
-				key: dep.key,
-				replacement: dep.replacement
-			}));
 			if (!isInert) try {
 				const rspressConfigSubset = {
 					...rspressMultiVersion != null ? { multiVersion: rspressMultiVersion } : {},

package/prettier-formatter.js

@@ -1,37 +1,17 @@
-import { addLogicalBlankLines } from "./code-post-processor.js";
 import { PluginEvent } from "./observability/events.js";
 import { emitSync, syncBuildId } from "./observability/sync-emitter.js";
-import { format } from "prettier";
+import { formatExampleCode } from "@tsdoctor/pages";
+import { Effect, Result } from "effect";
 
 //#region src/prettier-formatter.ts
 /* v8 ignore start -- Prettier integration wrapper, tested via page generator integration tests */
 /**
-* Map code fence languages to Prettier parsers
-*/
-const LANGUAGE_TO_PARSER = {
-	typescript: "typescript",
-	ts: "typescript",
-	tsx: "typescript",
-	javascript: "babel",
-	js: "babel",
-	jsx: "babel",
-	node: "babel"
-};
-/**
-* Default Prettier options for consistent formatting
-*/
-const PRETTIER_OPTIONS = {
-	printWidth: 80,
-	tabWidth: 2,
-	useTabs: false,
-	semi: true,
-	singleQuote: false,
-	trailingComma: "es5",
-	bracketSpacing: true,
-	arrowParens: "always"
-};
-/**
-* Format code using Prettier
+* Format code using Prettier.
+*
+* The formatting itself is `formatExampleCode` in `@tsdoctor/pages`, so both
+* adapters format identically. This wrapper keeps the adapter's fallthrough
+* contract: a typed `ExampleFormatError` becomes a `PrettierError` event on
+* the bus and the original code is returned.
 *
 * @param code - The code to format
 * @param language - The code fence language (e.g., "typescript", "ts", "js")
@@ -39,39 +19,27 @@ const PRETTIER_OPTIONS = {
 */
 async function formatCode(code, language) {
 	const start = performance.now();
-	const parser = LANGUAGE_TO_PARSER[language.toLowerCase()];
-	if (!parser) return {
-		code,
+	const result = await Effect.runPromise(Effect.result(formatExampleCode(code, language)));
+	const formatTime = performance.now() - start;
+	if (Result.isSuccess(result)) return {
+		code: result.success,
 		success: true,
-		formatTime: performance.now() - start
+		formatTime
+	};
+	const cause = result.failure.cause;
+	const errorMsg = cause instanceof Error ? cause.message : String(cause);
+	emitSync(PluginEvent.PrettierError({
+		ctx: { buildId: syncBuildId() },
+		file: "unknown",
+		reason: errorMsg,
+		level: "warn"
+	}));
+	return {
+		code,
+		success: false,
+		error: errorMsg,
+		formatTime
 	};
-	try {
-		const formatted = await format(code, {
-			...PRETTIER_OPTIONS,
-			parser
-		});
-		const formatTime = performance.now() - start;
-		return {
-			code: addLogicalBlankLines(formatted.trim()),
-			success: true,
-			formatTime
-		};
-	} catch (error) {
-		const formatTime = performance.now() - start;
-		const errorMsg = error instanceof Error ? error.message : String(error);
-		emitSync(PluginEvent.PrettierError({
-			ctx: { buildId: syncBuildId() },
-			file: "unknown",
-			reason: errorMsg,
-			level: "warn"
-		}));
-		return {
-			code,
-			success: false,
-			error: errorMsg,
-			formatTime
-		};
-	}
 }
 
 //#endregion

package/remark-with-api.js

@@ -1,15 +1,16 @@
 import { PluginEvent } from "./observability/events.js";
 import { emitSync, syncBuildId, syncSlowCodeBlockMs } from "./observability/sync-emitter.js";
-import { formatCode } from "./prettier-formatter.js";
-import { stripTwoslashDirectives } from "./markdown/helpers.js";
 import { DEFAULT_SHIKI_THEMES } from "./markdown/shiki-utils.js";
 import { VfsRegistry } from "./vfs-registry.js";
 import { setTwoslashFile } from "./twoslash-access.js";
 import { createTwoslashTimingWrapper } from "./twoslash-timing-wrapper.js";
+import { formatCode } from "./prettier-formatter.js";
+import { stripTwoslashDirectives } from "@tsdoctor/pages";
 import { codeToHast, hastToHtml } from "shiki";
 import { visit } from "unist-util-visit";
 
 //#region src/remark-with-api.ts
+/* v8 ignore start -- remark plugin, requires MDX compilation context */
 /**
 * Supported languages for with-api code blocks
 * Based on GitHub Linguist standard aliases: