rspress-plugin-api-extractor 0.10.0 → 0.12.0

package/layers/ConfigServiceLive.js

@@ -1,600 +0,0 @@
-import { PluginEvent } from "../observability/events.js";
-import { emit, wantsLevel } from "../observability/EventBus.js";
-import { BuildMetrics } from "./build-metrics.js";
-import "./ObservabilityLive.js";
-import { TypeReferenceExtractor } from "../type-reference-extractor.js";
-import { OpenGraphResolver } from "../og-resolver.js";
-import { withPhase } from "../observability/spans.js";
-import { resolveTypeScriptConfig } from "../typescript-config.js";
-import { TwoslashManager } from "../twoslash-transformer.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 { HideCutLinesTransformer, MemberFormatTransformer } from "../hide-cut-transformer.js";
-import { DEFAULT_SHIKI_THEMES } from "../markdown/shiki-utils.js";
-import { loadApiModel, loadPackageJson, loadVersionModel } from "../model-loader.js";
-import { DEFAULT_CATEGORIES } from "../schemas/config.js";
-import "../schemas/index.js";
-import { ConfigService } from "../services/ConfigService.js";
-import { PathDerivationService } from "../services/PathDerivationService.js";
-import { TwoslashCacheService } from "../services/TwoslashCacheService.js";
-import { TypeRegistryService } from "../services/TypeRegistryService.js";
-import { makeTwoslashCache, twoslashEnvHash } from "../twoslash-cache.js";
-import path from "node:path";
-import { hashContent } from "@tsdoctor/snapshot";
-import { Effect, Layer, Metric } from "effect";
-import ts from "typescript";
-import os from "node:os";
-import { createHighlighter } from "shiki";
-
-//#region src/layers/ConfigServiceLive.ts
-const DEFAULT_THRESHOLDS = {
-	slowCodeBlock: 100,
-	slowPageGeneration: 500,
-	slowApiLoad: 1e3,
-	slowFileOperation: 50,
-	slowHttpRequest: 2e3,
-	slowDbOperation: 100
-};
-/**
-* Normalize theme configuration from user input to a consistent format.
-*/
-function normalizeThemeConfig(theme) {
-	if (!theme) return { ...DEFAULT_SHIKI_THEMES };
-	if (typeof theme === "string") return {
-		light: theme,
-		dark: theme
-	};
-	if ("light" in theme && "dark" in theme && typeof theme.light === "string" && typeof theme.dark === "string") return {
-		light: theme.light,
-		dark: theme.dark
-	};
-	return {
-		light: theme,
-		dark: theme
-	};
-}
-/**
-* Prepend import statements for external type references to the VFS declaration files.
-* Returns per-entry payloads for event emission (heavy content/importRefs gated on wantTrace).
-*/
-function prependImportsToVfs(vfs, apiPackage, packageName, wantTrace) {
-	const extractor = new TypeReferenceExtractor(apiPackage, packageName);
-	const payloads = [];
-	for (const entryPoint of apiPackage.entryPoints) {
-		const entryEp = entryPoint;
-		const imports = extractor.extractImportsForEntryPoint(entryEp);
-		const importStatements = TypeReferenceExtractor.formatImports(imports);
-		const entryName = entryEp.displayName || "";
-		const file = `node_modules/${packageName}/${entryName ? `${entryName}.d.ts` : "index.d.ts"}`;
-		const hasImports = importStatements.length > 0;
-		if (hasImports) {
-			const existing = vfs.get(file);
-			if (existing) vfs.set(file, `${importStatements.join("\n")}\n\n${existing}`);
-		}
-		const content = vfs.get(file) ?? "";
-		const declCount = entryEp.members.length;
-		const contentHash = hashContent(content);
-		const importRefs = wantTrace && hasImports ? imports.map((i) => ({
-			from: i.packageName,
-			symbols: [...i.symbols]
-		})) : [];
-		payloads.push({
-			file,
-			entryPoint: entryName,
-			declCount,
-			contentHash,
-			content: wantTrace ? content : "",
-			hasImports,
-			importRefs
-		});
-	}
-	return payloads;
-}
-/**
-* Validate plugin options and return an Effect that fails with ConfigValidationError.
-*/
-function validateOptions(options, rspressConfig) {
-	return Effect.gen(function* () {
-		const api = options.api ?? void 0;
-		const apis = options.apis != null && options.apis.length > 0 ? options.apis : void 0;
-		const { multiVersion } = rspressConfig;
-		if (api && apis) return yield* new ConfigValidationError({
-			field: "api/apis",
-			reason: "Cannot provide both 'api' and 'apis'. Use 'api' for single-package sites or 'apis' for multi-package portals."
-		});
-		if (!api && !apis) {
-			if (classifyApiConfig(options) === "missing") return yield* new ConfigValidationError({
-				field: "api/apis",
-				reason: "Must provide either 'api' or 'apis'."
-			});
-			return;
-		}
-		if (apis) {
-			if (multiVersion) return yield* new ConfigValidationError({
-				field: "apis",
-				reason: "multiVersion is not supported with 'apis' (multi-API mode). Use 'api' (single-API mode) for versioned documentation."
-			});
-			return;
-		}
-		if (api) {
-			if (multiVersion) {
-				if (!api.versions) return yield* new ConfigValidationError({
-					field: "api.versions",
-					reason: "'versions' is required when multiVersion is active."
-				});
-				const pluginKeys = new Set(Object.keys(api.versions));
-				const rspressKeys = new Set(multiVersion.versions);
-				if (pluginKeys.size !== rspressKeys.size || ![...pluginKeys].every((k) => rspressKeys.has(k))) return yield* new ConfigValidationError({
-					field: "api.versions",
-					reason: `api.versions keys [${[...pluginKeys].join(", ")}] must exactly match multiVersion.versions [${[...rspressKeys].join(", ")}].`
-				});
-			} else {
-				if (api.versions) yield* emit(PluginEvent.ConfigCascadeWarning({
-					ctx: { buildId: "" },
-					level: "warn",
-					field: "versions",
-					chosen: "(none — multiVersion not configured)",
-					ignored: ["api.versions"]
-				}));
-				if (!api.model) return yield* new ConfigValidationError({
-					field: "api.model",
-					reason: "'model' is required when multiVersion is not active."
-				});
-			}
-		}
-	});
-}
-/**
-* Create ConfigServiceLive from plugin options.
-* Resolves plugin options + RSPress config into a fully prepared build context
-* with loaded models, type system, and resources.
-*/
-function ConfigServiceLive(options, shikiCrossLinker, buildId = "", resolvedThresholds) {
-	return Layer.effect(ConfigService, Effect.gen(function* () {
-		const typeRegistry = yield* TypeRegistryService;
-		const pathService = yield* PathDerivationService;
-		return { resolve: (rspressConfig) => Effect.gen(function* () {
-			const loadStart = performance.now();
-			const wantTrace = yield* wantsLevel("trace");
-			yield* validateOptions(options, { ...rspressConfig.multiVersion ? { multiVersion: {
-				default: rspressConfig.multiVersion.default,
-				versions: [...rspressConfig.multiVersion.versions]
-			} } : {} });
-			const rspressMultiVersion = rspressConfig.multiVersion;
-			const rspressLocales = rspressConfig.locales?.map((l) => l.lang) ?? [];
-			const rspressLang = rspressConfig.lang;
-			const docsRoot = rspressConfig.root;
-			const rspressRoot = docsRoot || process.cwd();
-			const categoryResolver = new CategoryResolver();
-			const pluginDefaults = categoryResolver.mergeCategories(DEFAULT_CATEGORIES, options.defaultCategories);
-			const apiConfigs = [];
-			const combinedVfs = /* @__PURE__ */ new Map();
-			const allExternalPackages = [];
-			let firstApiTsconfig;
-			let firstApiCompilerOptions;
-			/**
-			* Raw TypeScript config per API scope. Each documented package is
-			* type-checked under its OWN configuration; the build no longer picks
-			* one and applies it to everything.
-			*/
-			const scopeTsConfigs = /* @__PURE__ */ new Map();
-			/**
-			* Emit a typed ModelLoadFailed event for a failed model load, then
-			* convert the typed failure to a defect — a missing or unparsable
-			* model remains fatal to the build, exactly as before, but the
-			* event now rides the error channel instead of a sync-island seam.
-			*/
-			const withModelLoadEvents = (self) => self.pipe(Effect.tapError((error) => emit(PluginEvent.ModelLoadFailed({
-				ctx: { buildId },
-				level: "error",
-				modelPath: "modelPath" in error ? error.modelPath : "<loader function>",
-				reason: error.message
-			}))), Effect.orDie);
-			/**
-			* Helper to process a single API model (shared by single and multi modes).
-			*/
-			const processSimpleApi = (api, model, outputDir, fullRoute, wantTrace) => Effect.gen(function* () {
-				const { apiPackage, source: loaderSource } = yield* withModelLoadEvents(loadApiModel(model));
-				return yield* Effect.promise(async () => {
-					const resolvedCategories = categoryResolver.resolveCategoryConfig(pluginDefaults, api.categories);
-					const resolvedSource = categoryResolver.resolveSourceConfig(api.source, loaderSource);
-					const resolvedLlms = mergeLlmsPluginConfig(options.llmsPlugin, api.llmsPlugin);
-					const packageJson = api.packageJson ? await loadPackageJson(api.packageJson) : void 0;
-					validateExternalPackages(api.externalPackages, packageJson);
-					const externalPackages = api.externalPackages || extractAutoDetectedPackages(packageJson, api.autoDetectDependencies);
-					if (externalPackages && externalPackages.length > 0) Effect.runSync(Metric.update(BuildMetrics.externalPackagesTotal, externalPackages.length));
-					const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).generateVfs();
-					const vfsPayloads = prependImportsToVfs(vfs, apiPackage, api.packageName, wantTrace);
-					const resolvedOgImage = api.ogImage ?? options.ogImage;
-					const resolvedTheme = normalizeThemeConfig(api.theme);
-					return {
-						vfs,
-						vfsPayloads,
-						externalPackages: externalPackages || [],
-						config: {
-							apiPackage,
-							packageName: api.packageName,
-							...api.name != null ? { apiName: api.name } : {},
-							outputDir,
-							baseRoute: fullRoute,
-							categories: resolvedCategories,
-							...resolvedSource != null ? { source: resolvedSource } : {},
-							...packageJson != null ? { packageJson } : {},
-							...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
-							...options.siteUrl != null ? { siteUrl: options.siteUrl } : {},
-							...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-							docsDir: path.dirname(outputDir),
-							...docsRoot != null ? { docsRoot } : {},
-							...resolvedTheme != null ? { theme: resolvedTheme } : {}
-						}
-					};
-				});
-			});
-			yield* withPhase("modelLoad", { buildId }, Effect.gen(function* () {
-				if (options.api) {
-					const api = options.api;
-					const baseRoute = yield* pathService.normalizeBaseRoute(api.baseRoute ?? "/");
-					firstApiTsconfig = api.tsconfig;
-					firstApiCompilerOptions = api.compilerOptions;
-					scopeTsConfigs.set(apiScopeOf(baseRoute, api.packageName), rawTsConfig(api));
-					if (rspressMultiVersion && api.versions) {
-						const versionResults = yield* Effect.forEach(Object.entries(api.versions), ([version, versionValue]) => Effect.gen(function* () {
-							const versionDp = (yield* pathService.derivePaths({
-								mode: "single",
-								docsRoot: rspressRoot,
-								baseRoute,
-								apiFolder: api.apiFolder ?? "api",
-								locales: rspressLocales,
-								defaultLang: rspressLang,
-								versions: [version],
-								defaultVersion: rspressMultiVersion?.default
-							}))[0];
-							if (!versionDp) return {
-								vfs: /* @__PURE__ */ new Map(),
-								vfsPayloads: [],
-								externalPackages: [],
-								config: null
-							};
-							const versionConfig = isVersionConfig(versionValue) ? versionValue : { model: versionValue };
-							const { apiPackage, packageJson: versionPackageJson, categories: versionCategories, source: versionSource, externalPackages: versionExternalPackages, autoDetectDependencies: versionAutoDetectDependencies, llmsPlugin: versionLlms, ogImage: versionOgImage } = yield* withModelLoadEvents(loadVersionModel(versionConfig));
-							return yield* Effect.promise(async () => {
-								Effect.runSync(Metric.update(BuildMetrics.apiVersionsLoaded, 1));
-								const resolvedCategories = categoryResolver.resolveCategoryConfig(pluginDefaults, api.categories, versionCategories);
-								const resolvedSource = categoryResolver.resolveSourceConfig(api.source, versionSource);
-								const resolvedLlms = mergeLlmsPluginConfig(options.llmsPlugin, api.llmsPlugin, versionLlms);
-								const packageJson = versionPackageJson || (api.packageJson ? await loadPackageJson(api.packageJson) : void 0);
-								validateExternalPackages(versionExternalPackages || api.externalPackages, packageJson);
-								const autoDetectOptions = versionAutoDetectDependencies || api.autoDetectDependencies;
-								const externalPackages = versionExternalPackages || api.externalPackages || extractAutoDetectedPackages(packageJson, autoDetectOptions);
-								if (externalPackages && externalPackages.length > 0) Effect.runSync(Metric.update(BuildMetrics.externalPackagesTotal, externalPackages.length));
-								const vfs = ApiExtractedPackage.fromPackage(apiPackage, api.packageName).generateVfs();
-								const vfsPayloads = prependImportsToVfs(vfs, apiPackage, api.packageName, wantTrace);
-								const resolvedOgImage = versionOgImage ?? api.ogImage ?? options.ogImage;
-								const resolvedTheme = normalizeThemeConfig(api.theme);
-								const outputDir = versionDp.outputDir;
-								const fullRoute = versionDp.routeBase;
-								return {
-									vfs,
-									vfsPayloads,
-									externalPackages: externalPackages || [],
-									config: {
-										apiPackage,
-										packageName: `${api.packageName} (${version})`,
-										...api.name != null ? { apiName: api.name } : {},
-										outputDir,
-										baseRoute: fullRoute,
-										categories: resolvedCategories,
-										...resolvedSource != null ? { source: resolvedSource } : {},
-										...packageJson != null ? { packageJson } : {},
-										...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
-										...options.siteUrl != null ? { siteUrl: options.siteUrl } : {},
-										...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-										docsDir: path.dirname(outputDir),
-										...docsRoot != null ? { docsRoot } : {},
-										...resolvedTheme != null ? { theme: resolvedTheme } : {}
-									}
-								};
-							});
-						}), { concurrency: "unbounded" });
-						for (const result of versionResults) {
-							for (const [filepath, content] of result.vfs.entries()) combinedVfs.set(filepath, content);
-							if (result.externalPackages.length > 0) allExternalPackages.push(...result.externalPackages);
-							if (result.config) apiConfigs.push(result.config);
-							for (const payload of result.vfsPayloads) {
-								yield* emit(PluginEvent.VfsGenerated({
-									ctx: {
-										buildId: "",
-										packageName: api.packageName,
-										...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-									},
-									level: "debug",
-									file: payload.file,
-									declCount: payload.declCount,
-									contentHash: payload.contentHash,
-									...wantTrace && payload.content ? { content: payload.content } : {}
-								}));
-								if (payload.hasImports) yield* emit(PluginEvent.ImportsPrepended({
-									ctx: {
-										buildId: "",
-										packageName: api.packageName,
-										...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-									},
-									level: "debug",
-									file: payload.file,
-									imports: wantTrace ? payload.importRefs : []
-								}));
-							}
-						}
-					} else if (api.model) {
-						const dp = (yield* pathService.derivePaths({
-							mode: "single",
-							docsRoot: rspressRoot,
-							baseRoute,
-							apiFolder: api.apiFolder ?? "api",
-							locales: rspressLocales,
-							defaultLang: rspressLang,
-							versions: [],
-							defaultVersion: void 0
-						}))[0];
-						if (dp) {
-							const result = yield* processSimpleApi(api, api.model, dp.outputDir, dp.routeBase, wantTrace);
-							for (const [filepath, content] of result.vfs.entries()) combinedVfs.set(filepath, content);
-							if (result.externalPackages.length > 0) allExternalPackages.push(...result.externalPackages);
-							apiConfigs.push(result.config);
-							for (const payload of result.vfsPayloads) {
-								yield* emit(PluginEvent.VfsGenerated({
-									ctx: {
-										buildId: "",
-										packageName: api.packageName,
-										...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-									},
-									level: "debug",
-									file: payload.file,
-									declCount: payload.declCount,
-									contentHash: payload.contentHash,
-									...wantTrace && payload.content ? { content: payload.content } : {}
-								}));
-								if (payload.hasImports) yield* emit(PluginEvent.ImportsPrepended({
-									ctx: {
-										buildId: "",
-										packageName: api.packageName,
-										...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-									},
-									level: "debug",
-									file: payload.file,
-									imports: wantTrace ? payload.importRefs : []
-								}));
-							}
-						}
-					}
-				} else if (options.apis) {
-					const apisWithTsconfig = options.apis.filter((a) => a.tsconfig);
-					if (apisWithTsconfig.length > 0) firstApiTsconfig = apisWithTsconfig[0].tsconfig;
-					const apisWithCompilerOptions = options.apis.filter((a) => a.compilerOptions);
-					if (apisWithCompilerOptions.length > 0) firstApiCompilerOptions = apisWithCompilerOptions[0].compilerOptions;
-					for (const a of options.apis) {
-						const scopeRoute = yield* pathService.normalizeBaseRoute(a.baseRoute ?? `/${unscopedName(a.packageName)}`);
-						scopeTsConfigs.set(apiScopeOf(scopeRoute, a.packageName), rawTsConfig(a));
-					}
-					const multiResults = yield* Effect.forEach(options.apis, (api) => Effect.gen(function* () {
-						const apiBaseRoute = yield* pathService.normalizeBaseRoute(api.baseRoute ?? `/${unscopedName(api.packageName)}`);
-						const dp = (yield* pathService.derivePaths({
-							mode: "multi",
-							docsRoot: rspressRoot,
-							baseRoute: apiBaseRoute,
-							apiFolder: api.apiFolder ?? "api",
-							locales: rspressLocales,
-							defaultLang: rspressLang,
-							versions: [],
-							defaultVersion: void 0
-						}))[0];
-						if (!dp) return [];
-						const result = yield* processSimpleApi(api, api.model, dp.outputDir, dp.routeBase, wantTrace);
-						for (const payload of result.vfsPayloads) {
-							yield* emit(PluginEvent.VfsGenerated({
-								ctx: {
-									buildId: "",
-									packageName: api.packageName,
-									...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-								},
-								level: "debug",
-								file: payload.file,
-								declCount: payload.declCount,
-								contentHash: payload.contentHash,
-								...wantTrace && payload.content ? { content: payload.content } : {}
-							}));
-							if (payload.hasImports) yield* emit(PluginEvent.ImportsPrepended({
-								ctx: {
-									buildId: "",
-									packageName: api.packageName,
-									...payload.entryPoint ? { entryPoint: payload.entryPoint } : {}
-								},
-								level: "debug",
-								file: payload.file,
-								imports: wantTrace ? payload.importRefs : []
-							}));
-						}
-						return [result];
-					}), { concurrency: "unbounded" });
-					for (const results of multiResults) for (const result of results) {
-						for (const [filepath, content] of result.vfs.entries()) combinedVfs.set(filepath, content);
-						if (result.externalPackages.length > 0) allExternalPackages.push(...result.externalPackages);
-						apiConfigs.push(result.config);
-					}
-				}
-			}), resolvedThresholds ?? DEFAULT_THRESHOLDS);
-			const loadMs = performance.now() - loadStart;
-			yield* emit(PluginEvent.ModelLoaded({
-				ctx: { buildId: "" },
-				level: "debug",
-				entryPoints: apiConfigs.length,
-				itemCount: apiConfigs.reduce((sum, cfg) => sum + cfg.apiPackage.entryPoints.reduce((s, ep) => s + ep.members.length, 0), 0),
-				durationMs: Math.round(loadMs)
-			}));
-			const projectRoot = process.cwd();
-			let globalTsConfig;
-			if (firstApiTsconfig || firstApiCompilerOptions) {
-				globalTsConfig = {};
-				if (firstApiTsconfig != null) globalTsConfig.tsconfig = firstApiTsconfig;
-				if (firstApiCompilerOptions != null) globalTsConfig.compilerOptions = firstApiCompilerOptions;
-			}
-			const resolvedCompilerOptions = yield* Effect.promise(() => resolveTypeScriptConfig(projectRoot, globalTsConfig));
-			yield* emit(PluginEvent.TsCacheCreated({
-				ctx: { buildId: "" },
-				level: "debug",
-				compilerOptions: `target=${resolvedCompilerOptions.target}, module=${resolvedCompilerOptions.module}, lib=[${resolvedCompilerOptions.lib?.join(", ") ?? ""}]`,
-				durationMs: 0
-			}));
-			const documentedPackageNames = new Set(apiConfigs.map((config) => config.packageName));
-			const externalPackagesToLoad = allExternalPackages.filter((pkg) => !documentedPackageNames.has(pkg.name));
-			const typeLoadResult = yield* Effect.result(Effect.gen(function* () {
-				if (externalPackagesToLoad.length > 0) {
-					const resolvedPackages = yield* typeRegistry.resolveVersions(externalPackagesToLoad);
-					const droppedCount = externalPackagesToLoad.length - resolvedPackages.length;
-					if (droppedCount > 0) yield* emit(PluginEvent.ExternalPackageSkipped({
-						ctx: { buildId: "" },
-						level: "debug",
-						reason: `${droppedCount} unresolvable package(s) (unpublished or workspace-only)`
-					}));
-					if (resolvedPackages.length > 0) {
-						const result = yield* typeRegistry.loadPackages(resolvedPackages);
-						for (const [filePath, content] of result.vfs.entries()) combinedVfs.set(filePath, content);
-						yield* emit(PluginEvent.VfsMerged({
-							ctx: { buildId: "" },
-							level: "debug",
-							totalFiles: result.vfs.size,
-							packages: resolvedPackages.map((p) => p.name)
-						}));
-					}
-				}
-			}));
-			if (typeLoadResult._tag === "Failure") yield* emit(PluginEvent.ConfigCascadeWarning({
-				ctx: { buildId: "" },
-				level: "warn",
-				field: "externalTypes",
-				chosen: "empty VFS",
-				ignored: [typeLoadResult.failure.message ?? String(typeLoadResult.failure)]
-			}));
-			const twoslashEnv = twoslashEnvHash(combinedVfs, `typescript@${ts.version}`);
-			const restored = yield* (yield* TwoslashCacheService).load(twoslashEnv);
-			const twoslashCache = makeTwoslashCache(restored);
-			yield* emit(PluginEvent.TwoslashCacheLoaded({
-				ctx: { buildId: "" },
-				level: "debug",
-				envHash: twoslashEnv,
-				entries: restored.size
-			}));
-			const twoslashStartMs = performance.now();
-			const manager = TwoslashManager.getInstance();
-			manager.initialize(combinedVfs, void 0, void 0, void 0, resolvedCompilerOptions, twoslashCache);
-			const resolvedByRawConfig = /* @__PURE__ */ new Map();
-			for (const [apiScope, rawConfig] of scopeTsConfigs) {
-				if (rawConfig === void 0) {
-					manager.registerScope(apiScope, resolvedCompilerOptions);
-					continue;
-				}
-				const rawKey = JSON.stringify([String(rawConfig.tsconfig ?? ""), rawConfig.compilerOptions ?? null]);
-				let scopeOptions = resolvedByRawConfig.get(rawKey);
-				if (scopeOptions === void 0) {
-					scopeOptions = yield* Effect.promise(() => resolveTypeScriptConfig(projectRoot, rawConfig));
-					resolvedByRawConfig.set(rawKey, scopeOptions);
-				}
-				manager.initialize(combinedVfs, void 0, void 0, void 0, scopeOptions, twoslashCache);
-				manager.registerScope(apiScope, scopeOptions);
-			}
-			yield* emit(PluginEvent.TwoslashInitialized({
-				ctx: { buildId: "" },
-				level: "debug",
-				durationMs: Math.round(performance.now() - twoslashStartMs),
-				vfsFileCount: combinedVfs.size
-			}));
-			const shikiStartMs = performance.now();
-			const themeSet = /* @__PURE__ */ new Set();
-			const customThemes = [];
-			for (const config of apiConfigs) {
-				const theme = config.theme ?? {
-					light: DEFAULT_SHIKI_THEMES.light,
-					dark: DEFAULT_SHIKI_THEMES.dark
-				};
-				if (typeof theme.light === "string") themeSet.add(theme.light);
-				else if (typeof theme.light === "object") customThemes.push(theme.light);
-				if (typeof theme.dark === "string") themeSet.add(theme.dark);
-				else if (typeof theme.dark === "object") customThemes.push(theme.dark);
-			}
-			if (typeof DEFAULT_SHIKI_THEMES.light === "string") themeSet.add(DEFAULT_SHIKI_THEMES.light);
-			if (typeof DEFAULT_SHIKI_THEMES.dark === "string") themeSet.add(DEFAULT_SHIKI_THEMES.dark);
-			const themes = [...themeSet, ...customThemes];
-			const langs = [
-				"typescript",
-				"javascript",
-				"json",
-				"bash",
-				"sh"
-			];
-			const highlighter = yield* Effect.promise(() => createHighlighter({
-				themes,
-				langs
-			}));
-			yield* emit(PluginEvent.PhaseCompleted({
-				ctx: { buildId: "" },
-				level: "debug",
-				phase: "shikiInit",
-				durationMs: Math.round(performance.now() - shikiStartMs)
-			}));
-			const ogResolver = options.siteUrl ? new OpenGraphResolver({
-				siteUrl: options.siteUrl,
-				...docsRoot != null ? { docsRoot } : {}
-			}) : null;
-			const hideCutTransformer = MemberFormatTransformer;
-			const hideCutLinesTransformer = HideCutLinesTransformer;
-			const twoslashTransformer = TwoslashManager.getInstance().getTransformer() ?? void 0;
-			const logLevel = options.logLevel ?? "info";
-			const suppressExampleErrors = options.errors?.example !== "show";
-			return {
-				apiConfigs,
-				combinedVfs,
-				highlighter,
-				resolvedCompilerOptions,
-				ogResolver,
-				shikiCrossLinker,
-				hideCutTransformer,
-				hideCutLinesTransformer,
-				twoslashTransformer,
-				twoslashCache,
-				twoslashEnvHash: twoslashEnv,
-				pageConcurrency: os.cpus().length,
-				logLevel: logLevel === "none" ? "info" : logLevel,
-				suppressExampleErrors,
-				thresholds: resolvedThresholds ?? DEFAULT_THRESHOLDS,
-				buildId
-			};
-		}) };
-	}));
-}
-/**
-* Derive the API scope key from a base route, matching the derivation in
-* `build-program.ts` so config resolution and the remark plugins agree on the
-* name a code block is attributed to.
-*/
-function apiScopeOf(baseRoute, packageName) {
-	return baseRoute.replace(/^\//, "").split("/")[0] || packageName;
-}
-/** The raw TypeScript config an API declares, or undefined when it declares none. */
-function rawTsConfig(api) {
-	if (api.tsconfig == null && api.compilerOptions == null) return void 0;
-	const cfg = {};
-	if (api.tsconfig != null) cfg.tsconfig = api.tsconfig;
-	if (api.compilerOptions != null) cfg.compilerOptions = api.compilerOptions;
-	return cfg;
-}
-/**
-* Strip npm scope from a package name.
-*/
-function unscopedName(packageName) {
-	return packageName.startsWith("@") ? packageName.split("/")[1] ?? packageName : packageName;
-}
-
-//#endregion
-export { ConfigServiceLive };

package/layers/PathDerivationServiceLive.js

@@ -1,16 +0,0 @@
-import { deriveOutputPaths, normalizeBaseRoute } from "../path-derivation.js";
-import { PathDerivationService } from "../services/PathDerivationService.js";
-import { Effect, Layer } from "effect";
-
-//#region src/layers/PathDerivationServiceLive.ts
-const PathDerivationServiceLive = Layer.succeed(PathDerivationService, {
-	derivePaths: (input) => Effect.succeed(deriveOutputPaths({
-		...input,
-		locales: [...input.locales],
-		versions: [...input.versions]
-	})),
-	normalizeBaseRoute: (route) => Effect.succeed(normalizeBaseRoute(route))
-});
-
-//#endregion
-export { PathDerivationServiceLive };

package/layers/TwoslashCacheServiceLive.js

@@ -1,53 +0,0 @@
-import { TwoslashCacheService } from "../services/TwoslashCacheService.js";
-import { decodeTwoslashCache, encodeTwoslashCache, twoslashBlobKey } from "../twoslash-cache.js";
-import { NodeFileSystem } from "@effect/platform-node";
-import { Effect, Layer, Option, Path } from "effect";
-import { Cache } from "@effected/store";
-import { AppDirs, Xdg } from "@effected/xdg";
-
-//#region src/layers/TwoslashCacheServiceLive.ts
-const PlatformLive = Layer.mergeAll(NodeFileSystem.layer, Path.layer);
-/**
-* XDG app dirs under the same `tsdoctor` namespace the type registry uses, so
-* every derived-artifact cache this plugin keeps lives in one place.
-*/
-const AppDirsLive = AppDirs.layer({ namespace: "tsdoctor" }).pipe(Layer.provide(Layer.mergeAll(Xdg.layer, PlatformLive)));
-/**
-* A sqlite-backed `@effected/store` Cache in the XDG cache dir, separate from
-* the registry's `metadata.sqlite`.
-*
-* XDG rather than the repo: these are regenerable results derived from content
-* hashes, so they belong with the user's other caches — shared across worktrees
-* and checkouts of the same project, and untouched by cleaning `dist/`. Nothing
-* here needs to be committed for a build to be correct.
-*/
-const CacheLive = Layer.unwrap(Effect.gen(function* () {
-	const appDirs = yield* AppDirs;
-	const path = yield* Path.Path;
-	const cacheDir = yield* appDirs.ensureCache;
-	return Cache.layerSqlite({ filename: path.join(cacheDir, "twoslash.sqlite") });
-})).pipe(Layer.provide(Layer.mergeAll(AppDirsLive, PlatformLive)));
-/**
-* Live Twoslash cache persistence.
-*
-* Both operations swallow every failure by design — see the service docs. A
-* missing HOME, an unwritable cache dir or a corrupt database degrades the
-* build to "type-check everything", which is exactly the behaviour before this
-* cache existed.
-*/
-const TwoslashCacheServiceLive = Layer.succeed(TwoslashCacheService, {
-	load: (envHash) => Effect.gen(function* () {
-		const entry = yield* (yield* Cache).get(twoslashBlobKey(envHash));
-		return Option.isSome(entry) ? decodeTwoslashCache(entry.value.value) : /* @__PURE__ */ new Map();
-	}).pipe(Effect.provide(CacheLive), Effect.catchCause(() => Effect.succeed(/* @__PURE__ */ new Map()))),
-	save: (envHash, entries) => Effect.gen(function* () {
-		yield* (yield* Cache).set({
-			key: twoslashBlobKey(envHash),
-			value: encodeTwoslashCache(entries),
-			tags: ["twoslash"]
-		});
-	}).pipe(Effect.provide(CacheLive), Effect.catchCause(() => Effect.void))
-});
-
-//#endregion
-export { TwoslashCacheServiceLive };