rspress-plugin-api-extractor 0.2.2 → 0.3.1

package/schemas/config.js

@@ -1,5 +1,6 @@
-import { OpenGraphImageConfig } from "./opengraph.js";
 import { PerformanceConfig } from "./performance.js";
+import { ObservabilityConfig } from "./observability.js";
+import { OpenGraphImageConfig } from "./opengraph.js";
 import { Schema } from "effect";
 import { ApiItemKind } from "@microsoft/api-extractor-model";
 
@@ -9,6 +10,11 @@ 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$1 = Schema.Literal("none", "info", "verbose", "debug", "warn", "error");
 const ExternalPackageSpec = Schema.mutable(Schema.Struct({
 	name: Schema.String,
@@ -17,7 +23,7 @@ const ExternalPackageSpec = Schema.mutable(Schema.Struct({
 	compilerOptions: Schema.optional(Schema.Unknown)
 }));
 const AutoDetectDependencies = Schema.mutable(Schema.Struct({
-	dependencies: Schema.optionalWith(Schema.Boolean, { default: () => false }),
+	dependencies: Schema.optionalWith(Schema.Boolean, { default: () => true }),
 	devDependencies: Schema.optionalWith(Schema.Boolean, { default: () => false }),
 	peerDependencies: Schema.optionalWith(Schema.Boolean, { default: () => true }),
 	autoDependencies: Schema.optionalWith(Schema.Boolean, { default: () => true })
@@ -37,18 +43,38 @@ const LlmsPlugin = Schema.mutable(Schema.Struct({
 	] })
 }));
 const ApiItemKindSchema = Schema.declare((input) => typeof input === "number");
+/**
+* Configuration for a single documentation category (e.g. Classes, Functions).
+*
+* @public
+*/
 const CategoryConfig = Schema.mutable(Schema.Struct({
+	/** Human-readable plural display name shown in the sidebar. */
 	displayName: Schema.String,
+	/** Human-readable singular name used in page titles. */
 	singularName: Schema.String,
+	/** Folder name under the API base route (URL segment). */
 	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.optionalWith(Schema.Boolean, { default: () => true }),
+	/** Whether the sidebar section starts collapsed. Defaults to `true`. */
 	collapsed: Schema.optionalWith(Schema.Boolean, { default: () => true }),
+	/** Heading levels shown in the overview. Defaults to `[2]`. */
 	overviewHeaders: Schema.optionalWith(Schema.mutable(Schema.Array(Schema.Number)), { default: () => [2] })
 }));
+/**
+* Source repository link configuration for an API.
+*
+* @public
+*/
 const SourceConfig = Schema.mutable(Schema.Struct({
+	/** Base URL of the source repository (e.g. `"https://github.com/org/repo/blob/main/src"`). */
 	url: Schema.String,
+	/** Optional git ref (branch, tag, or commit SHA) appended to source links. */
 	ref: Schema.optional(Schema.String)
 }));
 const ThemeConfig = Schema.Union(Schema.String, Schema.mutable(Schema.Struct({
@@ -59,7 +85,10 @@ const ThemeConfig = Schema.Union(Schema.String, Schema.mutable(Schema.Struct({
 	value: Schema.Unknown
 })));
 /**
-* Built-in default categories
+* Built-in default category definitions covering Classes, Interfaces, Functions,
+* Types, Enums, Variables, and Namespaces.
+*
+* @public
 */
 const DEFAULT_CATEGORIES = {
 	classes: {
@@ -131,68 +160,140 @@ const CategoriesRecord = Schema.mutable(Schema.Record({
 	key: Schema.String,
 	value: CategoryConfig
 }));
+/**
+* Configuration for a single version of an API within a multi-version setup.
+*
+* @public
+*/
 const VersionConfig = Schema.mutable(Schema.Struct({
+	/** Path or loader for the `.api.json` model file for this version. */
 	model: ModelInput,
+	/** Path or loader for the `package.json` for this version. */
 	packageJson: Schema.optional(ModelInput),
+	/** Category overrides for this version. */
 	categories: Schema.optional(CategoriesRecord),
+	/** Source repository link configuration for this version. */
 	source: Schema.optional(SourceConfig),
+	/** External npm packages whose types should be loaded for Twoslash. */
 	externalPackages: Schema.optional(Schema.mutable(Schema.Array(ExternalPackageSpec))),
+	/** Auto-detect external packages from `package.json` dependency fields. */
 	autoDetectDependencies: Schema.optional(AutoDetectDependencies),
+	/** Open Graph image configuration for this version. */
 	ogImage: Schema.optional(OpenGraphImageConfig),
+	/** LLMs integration options for this version. */
 	llmsPlugin: Schema.optional(LlmsPlugin),
+	/** Path to a `tsconfig.json` for this version. */
 	tsconfig: Schema.optional(ModelInput),
+	/** TypeScript compiler options for Twoslash. */
 	compilerOptions: Schema.optional(Schema.Unknown)
 }));
 /** Union for the versions record value: can be a path/function OR a full VersionConfig */
 const VersionValue = Schema.Union(ModelInput, VersionConfig);
+/**
+* Configuration for a single-package API documentation site (the `api:` option).
+*
+* @public
+*/
 const SingleApiConfig = Schema.mutable(Schema.Struct({
+	/** npm package name of the documented package. */
 	packageName: Schema.String,
+	/** Optional display name shown in the sidebar and page titles. */
 	name: Schema.optional(Schema.String),
+	/** Base URL route for API pages (defaults to `/api`). */
 	baseRoute: Schema.optional(Schema.String),
+	/** Subfolder name under `baseRoute` for API pages, or `null` to omit. */
 	apiFolder: Schema.optional(Schema.Union(Schema.String, Schema.Null)),
+	/** Path or loader for the `.api.json` model file. */
 	model: Schema.optional(ModelInput),
+	/** Path or loader for the `package.json`. */
 	packageJson: Schema.optional(ModelInput),
+	/** Versioned models keyed by version label. */
 	versions: Schema.optional(Schema.mutable(Schema.Record({
 		key: Schema.String,
 		value: VersionValue
 	}))),
+	/** Shiki syntax-highlighting theme. */
 	theme: Schema.optional(ThemeConfig),
+	/** Category definitions (defaults to {@link DEFAULT_CATEGORIES}). */
 	categories: Schema.optional(CategoriesRecord),
+	/** Source repository link configuration. */
 	source: Schema.optional(SourceConfig),
+	/** External npm packages whose types should be loaded for Twoslash. */
 	externalPackages: Schema.optional(Schema.mutable(Schema.Array(ExternalPackageSpec))),
+	/** Auto-detect external packages from `package.json` dependency fields. */
 	autoDetectDependencies: Schema.optional(AutoDetectDependencies),
+	/** Open Graph image configuration. */
 	ogImage: Schema.optional(OpenGraphImageConfig),
+	/** LLMs integration options. */
 	llmsPlugin: Schema.optional(LlmsPlugin),
+	/** Path to a `tsconfig.json` for Twoslash. */
 	tsconfig: Schema.optional(ModelInput),
+	/** TypeScript compiler options for Twoslash. */
 	compilerOptions: Schema.optional(Schema.Unknown)
 }));
+/**
+* Configuration for one package in a multi-API portal (each element of the `apis:` array).
+*
+* @public
+*/
 const MultiApiConfig = Schema.mutable(Schema.Struct({
+	/** npm package name of the documented package. */
 	packageName: Schema.String,
+	/** Optional display name shown in the sidebar and page titles. */
 	name: Schema.optional(Schema.String),
+	/** Base URL route for this package's API pages. */
 	baseRoute: Schema.optional(Schema.String),
+	/** Subfolder name under `baseRoute` for API pages, or `null` to omit. */
 	apiFolder: Schema.optional(Schema.Union(Schema.String, Schema.Null)),
+	/** Path or loader for the `.api.json` model file (required). */
 	model: ModelInput,
+	/** Path or loader for the `package.json`. */
 	packageJson: Schema.optional(ModelInput),
+	/** Shiki syntax-highlighting theme. */
 	theme: Schema.optional(ThemeConfig),
+	/** Category definitions (defaults to {@link DEFAULT_CATEGORIES}). */
 	categories: Schema.optional(CategoriesRecord),
+	/** Source repository link configuration. */
 	source: Schema.optional(SourceConfig),
+	/** External npm packages whose types should be loaded for Twoslash. */
 	externalPackages: Schema.optional(Schema.mutable(Schema.Array(ExternalPackageSpec))),
+	/** Auto-detect external packages from `package.json` dependency fields. */
 	autoDetectDependencies: Schema.optional(AutoDetectDependencies),
+	/** Open Graph image configuration. */
 	ogImage: Schema.optional(OpenGraphImageConfig),
+	/** LLMs integration options. */
 	llmsPlugin: Schema.optional(LlmsPlugin),
+	/** Path to a `tsconfig.json` for Twoslash. */
 	tsconfig: Schema.optional(ModelInput),
+	/** TypeScript compiler options for Twoslash. */
 	compilerOptions: Schema.optional(Schema.Unknown)
 }));
+/**
+* Top-level options passed to {@link ApiExtractorPlugin}.
+*
+* @public
+*/
 const PluginOptions = Schema.mutable(Schema.Struct({
+	/** Single-API configuration (mutually exclusive with `apis`). */
 	api: Schema.optional(SingleApiConfig),
+	/** Multi-API portal configuration (mutually exclusive with `api`). */
 	apis: Schema.optional(Schema.mutable(Schema.Array(MultiApiConfig))),
+	/** Canonical site URL used for Open Graph absolute URLs. */
 	siteUrl: Schema.optional(Schema.String),
+	/** Global Open Graph image configuration (overridden per-API). */
 	ogImage: Schema.optional(OpenGraphImageConfig),
+	/** Override the default category definitions for all APIs. */
 	defaultCategories: Schema.optional(CategoriesRecord),
+	/** Error display options for code examples. */
 	errors: Schema.optional(ErrorConfig),
+	/** LLMs integration options, or `false` to disable. */
 	llmsPlugin: Schema.optional(Schema.Union(Schema.Boolean, LlmsPlugin)),
+	/** Verbosity level for plugin build output. @deprecated Use `observability.logLevel`. */
 	logLevel: Schema.optional(LogLevel$1),
-	performance: Schema.optional(PerformanceConfig)
+	/** Performance tuning options. @deprecated Use `observability.thresholds`. */
+	performance: Schema.optional(PerformanceConfig),
+	/** Unified observability configuration (logLevel, trace artifact, thresholds). */
+	observability: Schema.optional(ObservabilityConfig)
 }));
 
 //#endregion

package/schemas/index.js

@@ -1,5 +1,6 @@
-import { OpenGraphImageConfig, OpenGraphImageMetadata } from "./opengraph.js";
 import { PerformanceConfig, PerformanceThresholds } from "./performance.js";
+import { EventLevelSchema, ObservabilityConfig, resolveObservability } from "./observability.js";
+import { OpenGraphImageConfig, OpenGraphImageMetadata } from "./opengraph.js";
 import { AutoDetectDependencies, CategoryConfig, DEFAULT_CATEGORIES, ErrorConfig, ExternalPackageSpec, LlmsPlugin, LogLevel, ModelInput, MultiApiConfig, PluginOptions, SingleApiConfig, SourceConfig, ThemeConfig, VersionConfig } from "./config.js";
 
-export {  };
+export { DEFAULT_CATEGORIES, PluginOptions };

package/schemas/observability.js

@@ -0,0 +1,62 @@
+import { PerformanceThresholds } from "./performance.js";
+import { Schema } from "effect";
+
+//#region src/schemas/observability.ts
+const EventLevelSchema = Schema.Literal("none", "error", "warn", "info", "debug", "trace", "verbose");
+const ObservabilityConfig = Schema.mutable(Schema.Struct({
+	logLevel: Schema.optional(EventLevelSchema),
+	trace: Schema.optional(Schema.Union(Schema.Boolean, Schema.String)),
+	thresholds: Schema.optional(PerformanceThresholds)
+}));
+const DEFAULT_THRESHOLDS = {
+	slowCodeBlock: 500,
+	slowPageGeneration: 500,
+	slowApiLoad: 1e3,
+	slowFileOperation: 50,
+	slowHttpRequest: 2e3,
+	slowDbOperation: 100
+};
+function normalizeLevel(value) {
+	if (value === void 0) return void 0;
+	if (value === "verbose") return "debug";
+	return value;
+}
+function resolveObservability(input) {
+	const deprecations = [];
+	if (input.logLevel !== void 0) deprecations.push({
+		key: "logLevel",
+		replacement: "observability.logLevel"
+	});
+	if (input.performance !== void 0) deprecations.push({
+		key: "performance",
+		replacement: "observability.thresholds"
+	});
+	const level = normalizeLevel(input.envLogLevel) ?? normalizeLevel(input.observability?.logLevel) ?? normalizeLevel(input.logLevel) ?? "info";
+	const traceOpt = input.observability?.trace;
+	const tracePath = typeof traceOpt === "string" ? traceOpt : traceOpt === true ? `${input.outDir}/.api-extractor/trace-${input.buildId}.jsonl` : null;
+	const merged = {
+		...DEFAULT_THRESHOLDS,
+		...input.performance?.thresholds ?? {},
+		...input.observability?.thresholds ?? {}
+	};
+	const thresholds = {
+		slowCodeBlock: merged.slowCodeBlock ?? DEFAULT_THRESHOLDS.slowCodeBlock,
+		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
+	};
+	return {
+		resolved: {
+			logLevel: level,
+			json: level === "debug",
+			tracePath,
+			thresholds
+		},
+		deprecations
+	};
+}
+
+//#endregion
+export { EventLevelSchema, ObservabilityConfig, resolveObservability };

package/schemas/opengraph.js

@@ -1,24 +1,54 @@
 import { Schema } from "effect";
 
 //#region src/schemas/opengraph.ts
+/**
+* Structured Open Graph image metadata (alternative to a plain URL string).
+*
+* @public
+*/
 const OpenGraphImageMetadata = Schema.mutable(Schema.Struct({
+	/** Absolute URL of the image. */
 	url: Schema.String,
+	/** HTTPS URL of the image (for secure contexts). */
 	secureUrl: Schema.optional(Schema.String),
+	/** MIME type of the image (e.g. `"image/png"`). */
 	type: Schema.optional(Schema.String),
+	/** Image width in pixels. */
 	width: Schema.optional(Schema.Number),
+	/** Image height in pixels. */
 	height: Schema.optional(Schema.Number),
+	/** Alt text for the image. */
 	alt: Schema.optional(Schema.String)
 }));
+/**
+* Open Graph image: either a plain URL string or structured `OpenGraphImageMetadata`.
+*
+* @public
+*/
 const OpenGraphImageConfig = Schema.Union(Schema.String, OpenGraphImageMetadata);
+/**
+* Resolved Open Graph metadata emitted into each generated page's frontmatter.
+*
+* @public
+*/
 const OpenGraphMetadata = Schema.mutable(Schema.Struct({
+	/** Canonical site base URL. */
 	siteUrl: Schema.String,
+	/** Page route path (e.g. `/api/classes/myclass`). */
 	pageRoute: Schema.String,
+	/** Page description for the `og:description` tag. */
 	description: Schema.String,
+	/** ISO 8601 date string for `article:published_time`. */
 	publishedTime: Schema.String,
+	/** ISO 8601 date string for `article:modified_time`. */
 	modifiedTime: Schema.String,
+	/** Article section label (e.g. `"API"`). */
 	section: Schema.String,
+	/** Article tag keywords. */
 	tags: Schema.mutable(Schema.Array(Schema.String)),
+	/** Optional structured image metadata. */
 	ogImage: Schema.optional(OpenGraphImageMetadata),
+	/** Open Graph object type (e.g. `"article"`). */
 	ogType: Schema.String
 }));
 

package/schemas/performance.js

@@ -2,7 +2,7 @@ import { Schema } from "effect";
 
 //#region src/schemas/performance.ts
 const PerformanceThresholds = Schema.mutable(Schema.Struct({
-	slowCodeBlock: Schema.optionalWith(Schema.Number, { default: () => 100 }),
+	slowCodeBlock: Schema.optionalWith(Schema.Number, { default: () => 500 }),
 	slowPageGeneration: Schema.optionalWith(Schema.Number, { default: () => 500 }),
 	slowApiLoad: Schema.optionalWith(Schema.Number, { default: () => 1e3 }),
 	slowFileOperation: Schema.optionalWith(Schema.Number, { default: () => 50 }),

package/serve.js

@@ -9,6 +9,11 @@ const DEFAULT_PORT = 4173;
 * "ready ... built in" line, kept as a fallback in case the address-line format
 * changes. Pure and exported so it can be unit-tested and reused as a
 * {@link ServeOptions.readyWhen} building block.
+*
+* @param mode - the server mode (`"dev"` or `"preview"`)
+* @param output - a chunk of combined stdout/stderr from the server process
+* @returns `true` when the server appears to be listening
+* @public
 */
 function isServerReady(mode, output) {
 	if (output.includes("Local:")) return true;
@@ -19,6 +24,10 @@ function isServerReady(mode, output) {
 * Resolve {@link ServeOptions} into a concrete {@link ResolvedServeConfig},
 * applying all defaults. Pure (modulo reading `process.env`) and exported so
 * the resolution logic can be unit-tested without spawning a server.
+*
+* @param options - optional serve options; all fields have sensible defaults
+* @returns a fully resolved config with all defaults applied
+* @public
 */
 function resolveServeConfig(options = {}) {
 	const mode = options.mode ?? "dev";
@@ -81,6 +90,10 @@ function killProcessOnPort(port) {
 * returned promise resolves once the server is ready and the browser has been
 * opened; it does not resolve when the server stops. Port-freeing and browser
 * opening are best-effort and never reject.
+*
+* @param options - optional serve options; all fields have sensible defaults
+* @returns a promise that resolves once the server is ready and the browser has been opened
+* @public
 */
 async function serve(options = {}) {
 	const config = resolveServeConfig(options);

package/tsconfig-parser.js

@@ -124,4 +124,4 @@ function extractTypeResolutionOptions(tsOptions) {
 }
 
 //#endregion
-export { TsConfigParseError, parseTsConfig };
+export { TsConfigParseError, parseTsConfig, parseTsConfigWithMetadata };

package/twoslash-patterns.js

@@ -84,4 +84,4 @@ function classifyCutDirective(trimmedLine) {
 }
 
 //#endregion
-export { classifyCutDirective, isTwoslashDirective };
+export { RE_ANNOTATION, RE_CONFIG, RE_CUT, classifyCutDirective, isTwoslashDirective };

package/twoslash-transformer.js

@@ -1,6 +1,5 @@
-import { BuildMetrics } from "./layers/ObservabilityLive.js";
+import { PluginEvent } from "./observability/events.js";
 import { DEFAULT_COMPILER_OPTIONS } from "./typescript-config.js";
-import { Effect, Metric } from "effect";
 import { rendererRich, transformerTwoslash } from "@shikijs/twoslash";
 import { fromMarkdown } from "mdast-util-from-markdown";
 import { toHast } from "mdast-util-to-hast";
@@ -8,6 +7,22 @@ import { toHast } from "mdast-util-to-hast";
 //#region src/twoslash-transformer.ts
 /* v8 ignore start -- Shiki/Twoslash integration, requires full highlighter setup for testing */
 /**
+* Module-level emitter seam. Default is a no-op; wire in `setEventEmitter(emitSync)`
+* from plugin.ts right after the runtime emitter is created so that Twoslash error
+* events flow through the EventBus even though they fire in a sync Shiki callback
+* outside any Effect fiber.
+*/
+let emitEvent = () => {};
+let currentBuildId = "";
+/**
+* Inject the runtime-bound emitter into the Twoslash module.
+* Call this right after `makeRuntimeEmitter` in plugin.ts.
+*/
+function setEventEmitter(fn, buildId = "") {
+	emitEvent = fn;
+	currentBuildId = buildId;
+}
+/**
 * Module-level type routes map for resolving link references.
 * This is set by TwoslashManager.setTypeRoutes() before initialization.
 */
@@ -134,7 +149,7 @@ function renderMarkdown(markdown) {
 * Tags to hide entirely in hover popups.
 * These are either redundant with the API documentation structure or add noise.
 */
-const HIDDEN_TAGS = new Set([
+const HIDDEN_TAGS = /* @__PURE__ */ new Set([
 	"example",
 	"public",
 	"internal",
@@ -219,6 +234,23 @@ var TwoslashManager = class TwoslashManager {
 	*/
 	transformer = null;
 	/**
+	* VFS keys snapshot captured at initialize() time.
+	* Returned by vfsKeysSnapshot() for TwoslashCheckFailed events.
+	*/
+	_vfsKeys = [];
+	/**
+	* Resolved compiler options captured at initialize() time.
+	* Returned by compilerOptionsSnapshot() for TwoslashCheckFailed events.
+	*/
+	_resolvedCompilerOptions = DEFAULT_COMPILER_OPTIONS;
+	/**
+	* Path of the file whose code block is currently being processed.
+	* Used to attribute Twoslash error events to a source file. Defaults to
+	* "unknown"; remark plugins set this via setCurrentFile() before rendering
+	* each block (wired in Task 11).
+	*/
+	currentFilePath = "unknown";
+	/**
 	* Private constructor to enforce singleton pattern
 	*/
 	constructor() {}
@@ -242,7 +274,9 @@ var TwoslashManager = class TwoslashManager {
 	initialize(vfs, _reserved, _reserved2, tsEnvCache, compilerOptions) {
 		const extraFiles = {};
 		for (const [path, content] of vfs.entries()) extraFiles[path] = content;
+		this._vfsKeys = Array.from(vfs.keys());
 		const resolvedOptions = compilerOptions ?? DEFAULT_COMPILER_OPTIONS;
+		this._resolvedCompilerOptions = resolvedOptions;
 		this.transformer = transformerTwoslash({
 			renderer: rendererRich({
 				processHoverInfo: (info) => {
@@ -260,10 +294,8 @@ var TwoslashManager = class TwoslashManager {
 			},
 			explicitTrigger: true,
 			throws: false,
-			onTwoslashError: (error, _code) => {
-				Effect.runSync(Metric.increment(BuildMetrics.twoslashErrors));
-				const errorMsg = error instanceof Error ? error.message : String(error);
-				console.error(`🔴 Twoslash error: ${errorMsg}`);
+			onTwoslashError: (error, code) => {
+				this.handleTwoslashError(error, code, this.currentFilePath);
 			}
 		});
 	}
@@ -275,6 +307,15 @@ var TwoslashManager = class TwoslashManager {
 		return this.transformer;
 	}
 	/**
+	* Set the source file path used to attribute subsequent Twoslash error events.
+	* Remark plugins call this before rendering each code block (wired in Task 11).
+	*
+	* @param path - Source file path (e.g. "kitchensink/api/class/plugin.md")
+	*/
+	setCurrentFile(path) {
+		this.currentFilePath = path;
+	}
+	/**
 	* Clear the Twoslash transformer (useful for testing or reinitializing)
 	*/
 	clear() {
@@ -286,6 +327,50 @@ var TwoslashManager = class TwoslashManager {
 	static reset() {
 		TwoslashManager.instance = null;
 	}
+	/** Returns VFS keys snapshotted at initialize() time. Empty array before initialize(). */
+	vfsKeysSnapshot() {
+		return this._vfsKeys;
+	}
+	/** Returns compiler options snapshotted at initialize() time. Falls back to DEFAULT_COMPILER_OPTIONS. */
+	compilerOptionsSnapshot() {
+		return this._resolvedCompilerOptions;
+	}
+	handleTwoslashError(error, _code, file) {
+		const message = error instanceof Error ? error.message : String(error);
+		const match = /TS(\d+)/.exec(message);
+		const tsCode = match ? Number(match[1]) : 0;
+		emitEvent(PluginEvent.TwoslashDiagnostic({
+			ctx: {
+				buildId: currentBuildId,
+				file
+			},
+			level: "warn",
+			file,
+			line: 0,
+			col: 0,
+			code: tsCode,
+			message,
+			snippet: ""
+		}));
+		emitEvent(PluginEvent.TwoslashCheckFailed({
+			ctx: {
+				buildId: currentBuildId,
+				file
+			},
+			level: "trace",
+			file,
+			code: tsCode,
+			fsMapKeys: this.vfsKeysSnapshot(),
+			compilerOptions: JSON.stringify(this.compilerOptionsSnapshot())
+		}));
+	}
+	/**
+	* Test seam: drive `handleTwoslashError` directly without going through the Shiki transformer.
+	* @internal
+	*/
+	handleTwoslashErrorForTest(error, code, file) {
+		this.handleTwoslashError(error, code, file);
+	}
 	/**
 	* Set the type routes map for resolving link references in hover docs.
 	* This should be called before initialize() to enable type linking.
@@ -313,4 +398,4 @@ var TwoslashManager = class TwoslashManager {
 };
 
 //#endregion
-export { TwoslashManager };
+export { TwoslashManager, setEventEmitter };

package/typescript-config.js

@@ -165,4 +165,4 @@ async function resolveTypeScriptConfig(projectRoot, global, api, version, packag
 }
 
 //#endregion
-export { DEFAULT_COMPILER_OPTIONS, resolveTypeScriptConfig };
+export { DEFAULT_COMPILER_OPTIONS, mergeCompilerOptions, resolveTypeScriptConfig, resolveTypeScriptConfigSingleAsync };