rspress-plugin-api-extractor 0.14.0 → 0.15.0

package/markdown/helpers.js

@@ -1,43 +1,18 @@
-import { classifyCutDirective, isTwoslashDirective } from "../twoslash-patterns.js";
-import { formatCode } from "../prettier-formatter.js";
-import { TypeReferenceExtractor, emitFrontmatterBlock } from "@tsdoctor/model";
+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.
 *
@@ -52,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}`
@@ -141,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

@@ -23,7 +23,6 @@ function render(event) {
 		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 "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.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)";

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.14.0",
+	"version": "0.15.0",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -41,7 +41,7 @@
 		"@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",
@@ -53,11 +53,12 @@
 		"@microsoft/api-extractor-model": "^7.33.11",
 		"@shikijs/twoslash": "^4.4.3",
 		"@tsdoctor/bundle": "0.2.2",
-		"@tsdoctor/model": "0.5.0",
-		"@tsdoctor/registry": "0.3.0",
+		"@tsdoctor/model": "0.6.0",
+		"@tsdoctor/pages": "0.1.0",
+		"@tsdoctor/registry": "0.3.1",
 		"@tsdoctor/seo": "0.1.1",
 		"@tsdoctor/snapshot": "0.2.3",
-		"@tsdoctor/vfs": "0.1.0",
+		"@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

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:

package/schemas/config.js

@@ -9,24 +9,9 @@ import { ApiItemKind } from "@microsoft/api-extractor-model";
 * an async loader function, or a URL.
 */
 const ModelInput = Schema.declare((input) => typeof input === "string" || typeof input === "function" || input instanceof URL);
-/**
-* Verbosity level for plugin build output.
-*
-* @public
-*/
-const LogLevel = Schema.Literals([
-	"none",
-	"info",
-	"verbose",
-	"debug",
-	"warn",
-	"error"
-]);
 const ExternalPackageSpec = Schema.Struct({
 	name: Schema.String,
-	version: Schema.String,
-	tsconfig: Schema.optional(ModelInput),
-	compilerOptions: Schema.optional(Schema.Unknown)
+	version: Schema.String
 });
 const AutoDetectDependencies = Schema.Struct({
 	dependencies: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
@@ -67,8 +52,6 @@ const CategoryConfig = Schema.Struct({
 	folderName: Schema.String,
 	/** API item kinds included in this category. */
 	itemKinds: Schema.optional(Schema.mutable(Schema.Array(ApiItemKindSchema))),
-	/** TSDoc modifier tag that marks items for this category. */
-	tsdocModifier: Schema.optional(Schema.String),
 	/** Whether the sidebar section is collapsible. Defaults to `true`. */
 	collapsible: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
 	/** Whether the sidebar section starts collapsed. Defaults to `true`. */

package/schemas/observability.js

@@ -22,7 +22,6 @@ const DEFAULT_THRESHOLDS = {
 	slowPageGeneration: 500,
 	slowApiLoad: 1e3,
 	slowFileOperation: 50,
-	slowHttpRequest: 2e3,
 	slowDbOperation: 100
 };
 function normalizeLevel(value) {
@@ -43,7 +42,6 @@ function resolveObservability(input) {
 		slowPageGeneration: merged.slowPageGeneration ?? DEFAULT_THRESHOLDS.slowPageGeneration,
 		slowApiLoad: merged.slowApiLoad ?? DEFAULT_THRESHOLDS.slowApiLoad,
 		slowFileOperation: merged.slowFileOperation ?? DEFAULT_THRESHOLDS.slowFileOperation,
-		slowHttpRequest: merged.slowHttpRequest ?? DEFAULT_THRESHOLDS.slowHttpRequest,
 		slowDbOperation: merged.slowDbOperation ?? DEFAULT_THRESHOLDS.slowDbOperation
 	};
 	const pi = input.observability?.progressInterval;

package/schemas/performance.js

@@ -6,7 +6,6 @@ const PerformanceThresholds = Schema.Struct({
 	slowPageGeneration: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(500))),
 	slowApiLoad: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(1e3))),
 	slowFileOperation: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(50))),
-	slowHttpRequest: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(2e3))),
 	slowDbOperation: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(100)))
 });
 

package/services/TwoslashCacheService.js

@@ -1,6 +1,6 @@
 import { AppDirsLive, PlatformLive } from "../layers/xdg.js";
-import { decodeTwoslashCache, encodeTwoslashCache, makeTwoslashCache, twoslashBlobKey } from "../twoslash-cache.js";
 import { Context, Effect, Layer, Option, Path } from "effect";
+import { decodeTwoslashCache, encodeTwoslashCache, makeTwoslashCache, twoslashBlobKey } from "@tsdoctor/vfs";
 import { Cache } from "@effected/store";
 import { AppDirs } from "@effected/xdg";
 

package/twoslash-transformer.js

@@ -10,9 +10,9 @@ import { toHast } from "mdast-util-to-hast";
 /* v8 ignore start -- Shiki/Twoslash integration, requires full highlighter setup for testing */
 /**
 * Module-level type routes map for resolving link references.
-* This is set by TwoslashManager.setTypeRoutes() before initialization.
+* Populated per build by `addTypeRoutes` and reset by `clearTypeRoutes`.
 */
-let typeRoutes = /* @__PURE__ */ new Map();
+const typeRoutes = /* @__PURE__ */ new Map();
 /**
 * Transform TSDoc link tag syntax to markdown links or plain text.
 *
@@ -396,6 +396,18 @@ var TwoslashEnvironmentRegistry = class {
 		this.handleTwoslashError(error, code, file);
 	}
 };
+/**
+* Cross-link routes used to turn type names in hover docs into links.
+*
+* @remarks
+* These were `static` members of the old singleton, but they are cross-link
+* DATA, not type-checking state — they only ever read and wrote the
+* module-level `typeRoutes` map above, and they share their concern with
+* the prose cross-linker rather than with the environment registry. They
+* are deliberately NOT part of {@link TwoslashEnvironments}: folding them in
+* would widen the service's surface with state that has nothing to do with
+* compiler configurations.
+*/
 /** Merge routes in, so a multi-API build accumulates every scope's names. */
 function addTypeRoutes(routes) {
 	for (const [name, route] of routes) typeRoutes.set(name, route);

package/code-post-processor.js

@@ -1,38 +0,0 @@
-import { isTwoslashDirective } from "./twoslash-patterns.js";
-
-//#region src/code-post-processor.ts
-/**
-* Add logical blank lines between code sections for visual clarity.
-*
-* Runs after Prettier formatting to insert breathing room between
-* imports, comments, and return statements without affecting the
-* structural formatting Prettier already applied.
-*/
-function addLogicalBlankLines(code) {
-	const lines = code.split("\n");
-	const result = [];
-	let inMultiLineImport = false;
-	for (let i = 0; i < lines.length; i++) {
-		const line = lines[i];
-		const trimmed = line.trim();
-		const wasInMultiLineImport = inMultiLineImport;
-		if (!inMultiLineImport && trimmed.startsWith("import ") && !trimmed.endsWith(";")) inMultiLineImport = true;
-		else if (inMultiLineImport && trimmed.endsWith(";")) inMultiLineImport = false;
-		const isCurrentImport = trimmed.startsWith("import ") || wasInMultiLineImport;
-		if (result.length > 0 && !isCurrentImport) {
-			const prevTrimmed = result[result.length - 1].trim();
-			if (prevTrimmed !== "") {
-				const isDirective = isTwoslashDirective(trimmed);
-				const prevIsImportEnd = prevTrimmed.startsWith("import ") && prevTrimmed.endsWith(";") || /}\s*from\s+/.test(prevTrimmed) && prevTrimmed.endsWith(";");
-				if (prevIsImportEnd && trimmed !== "" && !isDirective) result.push("");
-				if (trimmed.startsWith("//") && !isDirective && !prevTrimmed.startsWith("//") && !prevIsImportEnd) result.push("");
-				if (/^return[\s;(]/.test(trimmed) && !prevTrimmed.startsWith("//")) result.push("");
-			}
-		}
-		result.push(line);
-	}
-	return result.join("\n");
-}
-
-//#endregion
-export { addLogicalBlankLines };