rspress-plugin-api-extractor 0.13.2 → 0.14.0

package/build-program.js

@@ -59,7 +59,7 @@ function generateApiDocs(apiConfig, fileContextMap) {
 		})));
 		setProseLinker(crossLinkData.routes);
 		const apiScope = baseRoute.replace(/^\//, "").split("/")[0] || packageName;
-		const shikiCrossLinker = ShikiCrossLinker.fromRoutes(crossLinkData.routes, crossLinkData.kinds, apiScope);
+		const shikiCrossLinker = ShikiCrossLinker.fromRoutes(crossLinkData.routes, apiScope);
 		addTypeRoutes(crossLinkData.routes);
 		const vfsConfig = {
 			highlighter,

package/build-stages.js

@@ -1,4 +1,3 @@
-import { parseFrontmatter, stringifyFrontmatter } from "./frontmatter.js";
 import { BuildMetrics } from "./layers/build-metrics.js";
 import { PluginEvent } from "./observability/events.js";
 import { emit } from "./observability/EventBus.js";
@@ -18,7 +17,7 @@ import { Effect, FileSystem, Metric, Option, Stream } from "effect";
 import { deriveScriptBody, headTags } from "@tsdoctor/seo";
 import { SnapshotService, hashContent, hashFrontmatter } from "@tsdoctor/snapshot";
 import { ApiItemKind } from "@microsoft/api-extractor-model";
-import { ApiItems, EntryPoints, Routes, SyntheticBases } from "@tsdoctor/model";
+import { ApiItems, EntryPoints, Routes, SyntheticBases, parseFrontmatter, stringifyFrontmatter } from "@tsdoctor/model";
 
 //#region src/build-stages.ts
 /**

package/index.d.ts

@@ -1,7 +1,7 @@
 import { OpenGraphImageConfig, OpenGraphImageMetadata, OpenGraphMetadata } from "@tsdoctor/seo";
 import { ApiItemKind, ApiModel } from "@microsoft/api-extractor-model";
 import { Schema } from "effect";
-import "typescript";
+import "@tsdoctor/vfs";
 import { RspressPlugin } from "@rspress/shared";
 import "@rspress/shared/logger";
 import "@rspress/shared/node-utils";
@@ -139,10 +139,6 @@ declare const VersionConfig: Schema.Struct<{
     readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
     readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
   }>>;
-  /** Path to a `tsconfig.json` for this version. */
-  readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-  /** TypeScript compiler options for Twoslash. */
-  readonly compilerOptions: Schema.optional<Schema.Unknown>;
 }>;
 /** @public */
 type VersionConfig = typeof VersionConfig.Encoded;
@@ -229,10 +225,6 @@ declare const SingleApiConfig: Schema.Struct<{
       readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
       readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
     }>>;
-    /** Path to a `tsconfig.json` for this version. */
-    readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-    /** TypeScript compiler options for Twoslash. */
-    readonly compilerOptions: Schema.optional<Schema.Unknown>;
   }>]>>>;
   /** Shiki syntax-highlighting theme. */
   readonly theme: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
@@ -499,10 +491,6 @@ declare const PluginOptions: Schema.Struct<{
         readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
         readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
       }>>;
-      /** Path to a `tsconfig.json` for this version. */
-      readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-      /** TypeScript compiler options for Twoslash. */
-      readonly compilerOptions: Schema.optional<Schema.Unknown>;
     }>]>>>;
     /** Shiki syntax-highlighting theme. */
     readonly theme: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
@@ -712,21 +700,6 @@ declare const PluginOptions: Schema.Struct<{
     readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
     readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
   }>]>>;
-  /** Verbosity level for plugin build output. @deprecated Use `observability.logLevel`. */
-  readonly logLevel: Schema.optional<Schema.Literals<readonly ["none", "info", "verbose", "debug", "warn", "error"]>>;
-  /** Performance tuning options. @deprecated Use `observability.thresholds`. */
-  readonly performance: Schema.optional<Schema.Struct<{
-    readonly thresholds: Schema.optional<Schema.Struct<{
-      readonly slowCodeBlock: Schema.withDecodingDefault<Schema.Number, never>;
-      readonly slowPageGeneration: Schema.withDecodingDefault<Schema.Number, never>;
-      readonly slowApiLoad: Schema.withDecodingDefault<Schema.Number, never>;
-      readonly slowFileOperation: Schema.withDecodingDefault<Schema.Number, never>;
-      readonly slowHttpRequest: Schema.withDecodingDefault<Schema.Number, never>;
-      readonly slowDbOperation: Schema.withDecodingDefault<Schema.Number, never>;
-    }>>;
-    readonly showInsights: Schema.withDecodingDefault<Schema.Boolean, never>;
-    readonly trackDetailedMetrics: Schema.withDecodingDefault<Schema.Boolean, never>;
-  }>>;
   /** Unified observability configuration (logLevel, trace artifact, thresholds). */
   readonly observability: Schema.optional<Schema.Struct<{
     readonly logLevel: Schema.optional<Schema.Literals<readonly ["none", "error", "warn", "info", "debug", "trace", "verbose"]>>;
@@ -821,6 +794,10 @@ declare function fromDir(dir: string, overrides?: FromDirOptions): MultiApiConfi
 declare function fromParentDir(parentDir: string, options?: FromDirOptions): MultiApiConfig[];
 //#endregion
 //#region src/internal-types.d.ts
+/**
+ * Compiler options relevant to type resolution.
+ * Subset of TypeScript's CompilerOptions used by the type registry and Twoslash.
+ */
 /**
  * Result returned by a model loader function.
  *

package/layers/config-resolution.js

@@ -2,12 +2,10 @@ 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";
@@ -21,6 +19,7 @@ import path from "node:path";
 import { Effect, Metric } from "effect";
 import { deriveSiteUrl } from "@tsdoctor/seo";
 import { hashContent } from "@tsdoctor/snapshot";
+import { ApiExtractedPackage, TypeReferenceExtractor } from "@tsdoctor/model";
 import { PackageManifest } from "@effected/package-json";
 
 //#region src/layers/config-resolution.ts
@@ -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);
@@ -321,7 +320,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);

package/layers/type-environment.js

@@ -1,11 +1,11 @@
 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 } from "@tsdoctor/vfs";
 import ts from "typescript";
 
 //#region src/layers/type-environment.ts
@@ -64,12 +64,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/markdown/helpers.js

@@ -1,7 +1,6 @@
-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 { TypeReferenceExtractor, emitFrontmatterBlock } from "@tsdoctor/model";
 
 //#region src/markdown/helpers.ts
 /**

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

@@ -1,7 +1,6 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
-import { ApiItems, Routes, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Routes, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/class-page.ts
 /**

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

@@ -1,7 +1,6 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/function-page.ts
 /**

package/markdown/page-generators/index-pages.js

@@ -1,4 +1,4 @@
-import { emitFrontmatterBlock } from "../../frontmatter.js";
+import { emitFrontmatterBlock } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/index-pages.ts
 /**

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

@@ -1,7 +1,6 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
-import { ApiItems, Routes, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Routes, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/interface-page.ts
 /**

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

@@ -1,8 +1,7 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
 import { ApiItemKind } from "@microsoft/api-extractor-model";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/namespace-page.ts
 /**

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

@@ -1,7 +1,6 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/type-alias-page.ts
 /**

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

@@ -1,7 +1,6 @@
-import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
 import { linkProse } from "../prose-linker.js";
-import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
+import { ApiItems, Signature, Tsdoc, TypeReferenceExtractor } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/variable-page.ts
 /**

package/observability/sinks/console-sink.js

@@ -22,12 +22,11 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.13.2",
+	"version": "0.14.0",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -40,23 +40,24 @@
 		"@effect/platform-node": "4.0.0-rc.109",
 		"@effected/github": "^0.8.0",
 		"@effected/glob": "^0.4.0",
-		"@effected/jsonc": "^0.8.0",
+		"@effected/jsonc": "^0.8.1",
 		"@effected/markdown": "^0.7.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.1",
-		"@tsdoctor/model": "0.4.1",
-		"@tsdoctor/registry": "0.2.2",
+		"@tsdoctor/bundle": "0.2.2",
+		"@tsdoctor/model": "0.5.0",
+		"@tsdoctor/registry": "0.3.0",
 		"@tsdoctor/seo": "0.1.1",
-		"@tsdoctor/snapshot": "0.2.2",
+		"@tsdoctor/snapshot": "0.2.3",
+		"@tsdoctor/vfs": "0.1.0",
 		"@typescript/vfs": "^1.6.4",
 		"clsx": "^2.1.1",
 		"effect": "4.0.0-rc.109",

package/plugin.js

@@ -54,10 +54,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 +182,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/schemas/config.js

@@ -1,4 +1,3 @@
-import { PerformanceConfig } from "./performance.js";
 import { ObservabilityConfig } from "./observability.js";
 import { Effect, Schema } from "effect";
 import { OpenGraphImageConfig } from "@tsdoctor/seo";
@@ -190,11 +189,7 @@ const VersionConfig = Schema.Struct({
 	/** 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)
+	llmsPlugin: Schema.optional(LlmsPlugin)
 });
 /** Union for the versions record value: can be a path/function OR a full VersionConfig */
 const VersionValue = Schema.Union([ModelInput, VersionConfig]);
@@ -312,13 +307,9 @@ const PluginOptions = Schema.Struct({
 	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),
-	/** Performance tuning options. @deprecated Use `observability.thresholds`. */
-	performance: Schema.optional(PerformanceConfig),
 	/** Unified observability configuration (logLevel, trace artifact, thresholds). */
 	observability: Schema.optional(ObservabilityConfig)
 });
 
 //#endregion
-export { AutoDetectDependencies, CategoryConfig, DEFAULT_CATEGORIES, ErrorConfig, ExternalPackageSpec, LlmsPlugin, LogLevel, ModelInput, MultiApiConfig, PluginOptions, SingleApiConfig, SourceConfig, ThemeConfig, VersionConfig };
+export { AutoDetectDependencies, CategoryConfig, DEFAULT_CATEGORIES, ErrorConfig, ExternalPackageSpec, LlmsPlugin, ModelInput, MultiApiConfig, PluginOptions, SingleApiConfig, SourceConfig, ThemeConfig, VersionConfig };

package/schemas/observability.js

@@ -31,21 +31,11 @@ function normalizeLevel(value) {
 	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 level = normalizeLevel(input.envLogLevel) ?? normalizeLevel(input.observability?.logLevel) ?? "info";
 	const traceOpt = input.observability?.trace;
 	const tracePath = typeof traceOpt === "string" ? traceOpt : traceOpt === true ? `${input.cwd}/.api-docs/build/trace-${input.buildId}.jsonl` : null;
 	const merged = {
 		...DEFAULT_THRESHOLDS,
-		...input.performance?.thresholds ?? {},
 		...input.observability?.thresholds ?? {}
 	};
 	const thresholds = {
@@ -59,16 +49,13 @@ function resolveObservability(input) {
 	const pi = input.observability?.progressInterval;
 	const seconds = pi === false ? null : typeof pi === "number" ? pi : 10;
 	const progressIntervalMs = seconds !== null && Number.isFinite(seconds) && seconds > 0 ? seconds * 1e3 : null;
-	return {
-		resolved: {
-			logLevel: level,
-			json: level === "debug",
-			tracePath,
-			progressIntervalMs,
-			thresholds
-		},
-		deprecations
-	};
+	return { resolved: {
+		logLevel: level,
+		json: level === "debug",
+		tracePath,
+		progressIntervalMs,
+		thresholds
+	} };
 }
 
 //#endregion

package/schemas/performance.js

@@ -9,11 +9,6 @@ const PerformanceThresholds = Schema.Struct({
 	slowHttpRequest: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(2e3))),
 	slowDbOperation: Schema.Number.pipe(Schema.withDecodingDefault(Effect.succeed(100)))
 });
-const PerformanceConfig = Schema.Struct({
-	thresholds: Schema.optional(PerformanceThresholds),
-	showInsights: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
-	trackDetailedMetrics: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false)))
-});
 
 //#endregion
-export { PerformanceConfig, PerformanceThresholds };
+export { PerformanceThresholds };

package/services/TwoslashCacheService.js

@@ -20,23 +20,29 @@ var TwoslashCacheService = class TwoslashCacheService extends Context.Service()(
 	* @remarks
 	* Failure is absorbed at TWO levels, and both are load-bearing. Inside the
 	* service, a failed read or write degrades that one operation. Around the
-	* layer, a failed CONSTRUCTION — no HOME for XDG, an unwritable cache
-	* directory, a corrupt database — degrades to {@link DegradedLive}.
+	* cache layer, a failed CONSTRUCTION — no HOME for XDG, an unwritable cache
+	* directory, a corrupt database — degrades to a cache that always misses,
+	* via `Cache.degrading` (see {@link CacheLive}).
 	*
-	* The second is why `Layer.catchCause` wraps this at all. While the sqlite
-	* layer was provided inside each method, a construction failure surfaced as
-	* that method's failure and the in-method handler swallowed it. Hoisting
+	* The second is why anything wraps this at all. While the sqlite layer was
+	* provided inside each method, a construction failure surfaced as that
+	* method's failure and the in-method handler swallowed it. Hoisting
 	* acquisition to layer construction moved the failure to `ManagedRuntime`
 	* build time, where it would abort the entire build — breaking the contract
 	* this service documents, that an unreachable cache must never fail a build
-	* that would otherwise succeed. `catchCause` rather than a failure-only catch
-	* because a defect thrown by the sqlite driver must degrade too.
+	* that would otherwise succeed.
+	*
+	* There is no separate degraded implementation of this service any more.
+	* Degrading one level down, at the `Cache`, means the ordinary
+	* implementation running over an always-missing cache IS the degraded
+	* behaviour, so a second implementation would only be a way for the two to
+	* disagree.
 	*
 	* `Layer.suspend` because the composition below is declared after this class:
 	* a static initializer runs while the module body is still evaluating, so
 	* naming those consts directly throws at import time with a clean typecheck.
 	*/
-	static layer = Layer.suspend(() => CacheBackedLive.pipe(Layer.catchCause(() => DegradedLive)));
+	static layer = Layer.suspend(() => CacheBackedLive);
 	/**
 	* An always-cold in-memory double.
 	*
@@ -50,6 +56,7 @@ var TwoslashCacheService = class TwoslashCacheService extends Context.Service()(
 	* the render path's SHAPE rather than merely dropping its persistence.
 	*/
 	static makeTest = (overrides = {}) => ({
+		degraded: overrides.degraded ?? false,
 		load: overrides.load ?? (() => Effect.succeed(/* @__PURE__ */ new Map())),
 		save: overrides.save ?? (() => Effect.void),
 		open: overrides.open ?? (() => Effect.succeed(makeTwoslashCache())),
@@ -117,6 +124,7 @@ function withGeneration(base) {
 const CacheBackedLive = Layer.effect(TwoslashCacheService, Effect.gen(function* () {
 	const cache = yield* Cache;
 	return withGeneration({
+		degraded: cache.degraded,
 		load: (envHash) => cache.get(twoslashBlobKey(envHash)).pipe(Effect.map((entry) => Option.isSome(entry) ? decodeTwoslashCache(entry.value.value) : /* @__PURE__ */ new Map()), Effect.catch(() => Effect.succeed(/* @__PURE__ */ new Map()))),
 		save: (envHash, entries) => cache.set({
 			key: twoslashBlobKey(envHash),
@@ -124,7 +132,7 @@ const CacheBackedLive = Layer.effect(TwoslashCacheService, Effect.gen(function*
 			tags: ["twoslash"]
 		}).pipe(Effect.catch(() => Effect.void))
 	});
-})).pipe(Layer.provide(CacheLive));
+})).pipe(Layer.provide(Cache.degrading(CacheLive)));
 /**
 * A cache that holds nothing, for when the real one cannot be opened.
 *
@@ -132,10 +140,6 @@ const CacheBackedLive = Layer.effect(TwoslashCacheService, Effect.gen(function*
 * `load` returns empty and `save` discards, which is precisely the behaviour
 * before this cache existed: type-check everything, persist nothing.
 */
-const DegradedLive = Layer.succeed(TwoslashCacheService, withGeneration({
-	load: () => Effect.succeed(/* @__PURE__ */ new Map()),
-	save: () => Effect.void
-}));
 
 //#endregion
 export { TwoslashCacheService };

package/services/TypeRegistryService.js

@@ -3,11 +3,11 @@ import { emit } from "../observability/EventBus.js";
 import { resolveExternalPackageVersions } from "../config-utils.js";
 import { TypeRegistryError } from "../errors.js";
 import { AppDirsLive, PlatformLive } from "../layers/xdg.js";
-import { Context, Duration, Effect, Layer, Path } from "effect";
+import { Cause, Context, Duration, Effect, Layer, Path } from "effect";
 import { NodeHttpClient } from "@effect/platform-node";
-import { PackageFetcher, PackageSpec, RegistryObserver, TypeCache, TypeRegistry } from "@tsdoctor/registry";
 import { Cache } from "@effected/store";
 import { AppDirs } from "@effected/xdg";
+import { PackageFetcher, PackageSpec, RegistryObserver, TypeCache, TypeRegistry } from "@tsdoctor/registry";
 
 //#region src/services/TypeRegistryService.ts
 var TypeRegistryService = class TypeRegistryService extends Context.Service()("rspress-plugin-api-extractor/TypeRegistryService") {
@@ -27,7 +27,7 @@ var TypeRegistryService = class TypeRegistryService extends Context.Service()("r
 	* static initializer runs while the module body is still evaluating, so naming
 	* those consts directly throws at import time with a clean typecheck.
 	*/
-	static layer = Layer.suspend(() => RegistryBackedLive.pipe(Layer.catchCause(() => DegradedLive)));
+	static layer = Layer.suspend(() => RegistryBackedLive.pipe(Layer.catchCause((cause) => Cause.hasInterrupts(cause) ? Layer.effectContext(Effect.failCause(Cause.interrupt([...Cause.interruptors(cause)][0]))) : DegradedLive)));
 	/**
 	* An in-memory double: no network, no XDG cache, no sqlite.
 	*
@@ -132,7 +132,7 @@ const MetadataCacheLive = Layer.unwrap(Effect.gen(function* () {
 	const path = yield* Path.Path;
 	const cacheDir = yield* appDirs.ensureCache;
 	return Cache.layerSqlite({ filename: path.join(cacheDir, "metadata.sqlite") });
-})).pipe(Layer.provide(Layer.mergeAll(AppDirsLive, PlatformLive)));
+})).pipe(Layer.provide(Layer.mergeAll(AppDirsLive, PlatformLive)), Cache.degrading);
 /**
 * The full registry runtime: TypeRegistry over an XDG-rooted TypeCache and the
 * jsDelivr PackageFetcher, with the observer that forwards registry events to