rspress-plugin-api-extractor 0.8.9 → 0.9.0

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

@@ -1,8 +1,7 @@
-import { ApiParser } from "../../loader.js";
 import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
-import { TypeSignatureFormatter } from "../../formatter.js";
+import { linkProse } from "../prose-linker.js";
+import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/type-alias-page.ts
 /**
@@ -23,15 +22,14 @@ import { TypeSignatureFormatter } from "../../formatter.js";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @see {@link InterfacePageGenerator} for interface documentation
 * @see {@link EnumPageGenerator} for enum documentation
 */
 var TypeAliasPageGenerator = class {
-	typeFormatter = new TypeSignatureFormatter();
 	/**
 	* Generate a markdown page for a type alias
 	*
@@ -40,22 +38,22 @@ var TypeAliasPageGenerator = class {
 	async generate(apiTypeAlias, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiTypeAlias.displayName;
-		const summary = ApiParser.getSummary(apiTypeAlias) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiTypeAlias);
+		const summary = Tsdoc.summary(apiTypeAlias) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiTypeAlias);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { ParametersTable } from "rspress-plugin-api-extractor/runtime";\n`;
 		content += `import { ApiSignature, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiTypeAlias);
+		const deprecation = Tsdoc.deprecation(apiTypeAlias);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> ⚠️ **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiTypeAlias, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiTypeAlias, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -68,7 +66,7 @@ var TypeAliasPageGenerator = class {
 			content += `</div>\n\n`;
 		}
 		if (apiTypeAlias.excerpt.text) {
-			const signature = this.typeFormatter.format(apiTypeAlias.excerpt).trim();
+			const signature = Signature.format(apiTypeAlias.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiTypeAlias.getAssociatedPackage?.();
 			if (apiPackage) {
@@ -78,7 +76,7 @@ var TypeAliasPageGenerator = class {
 			const displayCode = stripTwoslashDirectives(signatureWithImports);
 			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(signatureWithImports)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
 		}
-		const examples = ApiParser.getExamples(apiTypeAlias);
+		const examples = Tsdoc.examples(apiTypeAlias);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -93,11 +91,11 @@ var TypeAliasPageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiTypeAlias);
+		const seeReferences = Tsdoc.seeReferences(apiTypeAlias);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;

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

@@ -1,8 +1,7 @@
-import { ApiParser } from "../../loader.js";
 import { TypeReferenceExtractor } from "../../type-reference-extractor.js";
 import { escapeMdxGenerics, formatExampleCode, generateAvailableFrom, generateFrontmatter, prepareExampleCode, prependHiddenImports, stripTwoslashDirectives } from "../helpers.js";
-import { markdownCrossLinker } from "../cross-linker.js";
-import { TypeSignatureFormatter } from "../../formatter.js";
+import { linkProse } from "../prose-linker.js";
+import { ApiItems, Signature, Tsdoc } from "@tsdoctor/model";
 
 //#region src/markdown/page-generators/variable-page.ts
 /**
@@ -23,15 +22,14 @@ import { TypeSignatureFormatter } from "../../formatter.js";
 *
 * **Relationships:**
 * - Created and invoked by {@link ApiExtractorPlugin} during page generation
-* - Uses {@link TypeSignatureFormatter} for formatting type signatures
-* - Uses {@link ApiParser} for extracting documentation from API models
-* - Uses {@link MarkdownCrossLinker} for adding type reference links
+* - Uses `Signature.format` from `@tsdoctor/model` for formatting type signatures
+* - Uses the `Tsdoc` / `ApiItems` modules from `@tsdoctor/model` for extracting documentation
+* - Uses the per-build prose linker (`linkProse`) for adding type reference links
 *
 * @see {@link FunctionPageGenerator} for function documentation
 * @see {@link EnumPageGenerator} for enum documentation
 */
 var VariablePageGenerator = class {
-	typeFormatter = new TypeSignatureFormatter();
 	/**
 	* Generate a markdown page for a variable
 	*
@@ -40,22 +38,22 @@ var VariablePageGenerator = class {
 	async generate(apiVariable, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiVariable.displayName;
-		const summary = ApiParser.getSummary(apiVariable) || "No description available.";
-		const releaseTag = ApiParser.getReleaseTag(apiVariable);
+		const summary = Tsdoc.summary(apiVariable) || "No description available.";
+		const releaseTag = Tsdoc.releaseTag(apiVariable);
 		let content = generateFrontmatter(name, summary, singularName, apiName);
 		content += `import { SourceCode } from "@rspress/core/theme";\n`;
 		content += `import { ParametersTable } from "rspress-plugin-api-extractor/runtime";\n`;
 		content += `import { ApiSignature, ApiExample } from "rspress-plugin-api-extractor/runtime";\n\n`;
 		content += `# ${name}\n\n`;
-		const deprecation = ApiParser.getDeprecation(apiVariable);
+		const deprecation = Tsdoc.deprecation(apiVariable);
 		if (deprecation) {
-			const message = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(deprecation.message));
+			const message = escapeMdxGenerics(linkProse(deprecation.message));
 			content += `> ⚠️ **Deprecated:** ${message}\n\n`;
 		}
 		if (releaseTag !== "Public") content += `\`${releaseTag}\`\n\n`;
 		content += `${summary}\n\n`;
 		content += generateAvailableFrom(packageName, availableFrom);
-		const sourceLink = ApiParser.getSourceLink(apiVariable, sourceConfig);
+		const sourceLink = ApiItems.sourceLink(apiVariable, sourceConfig);
 		if (sourceLink) {
 			content += `<div className="api-docs-toolbar">\n`;
 			content += `  <div className="api-docs-toolbar-left">\n`;
@@ -68,7 +66,7 @@ var VariablePageGenerator = class {
 			content += `</div>\n\n`;
 		}
 		if (apiVariable.excerpt.text) {
-			const signature = this.typeFormatter.format(apiVariable.excerpt).trim();
+			const signature = Signature.format(apiVariable.excerpt).trim();
 			let signatureWithImports = signature;
 			const apiPackage = apiVariable.getAssociatedPackage?.();
 			if (apiPackage) {
@@ -78,7 +76,7 @@ var VariablePageGenerator = class {
 			const displayCode = stripTwoslashDirectives(signatureWithImports);
 			content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(signatureWithImports)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
 		}
-		const examples = ApiParser.getExamples(apiVariable);
+		const examples = Tsdoc.examples(apiVariable);
 		if (examples.length > 0) {
 			content += `## Examples\n\n`;
 			for (const example of examples) {
@@ -93,11 +91,11 @@ var VariablePageGenerator = class {
 				} else content += `\`\`\`${prepared.language}\n${formattedCode}\n\`\`\`\n\n`;
 			}
 		}
-		const seeReferences = ApiParser.getSeeReferences(apiVariable);
+		const seeReferences = Tsdoc.seeReferences(apiVariable);
 		if (seeReferences.length > 0) {
 			content += `## See Also\n\n`;
 			for (const reference of seeReferences) {
-				const refText = escapeMdxGenerics(markdownCrossLinker.addCrossLinks(reference.text));
+				const refText = escapeMdxGenerics(linkProse(reference.text));
 				content += `- ${refText}\n`;
 			}
 			content += `\n`;

package/markdown/prose-linker.js

@@ -0,0 +1,22 @@
+import { CrossLinker } from "@tsdoctor/model";
+
+//#region src/markdown/prose-linker.ts
+/**
+* Per-build prose cross-linker holder. Adapter wiring, not logic: the build
+* program installs the immutable `@tsdoctor/model` CrossLinker built from the
+* routes `prepareWorkItems` computed, and page generators link prose through
+* it. Page generators run synchronously outside any service context, hence
+* the module-level holder (the same shape as the sync-island event emitters).
+*/
+let current = CrossLinker.empty;
+/** Install the cross-linker for the current API build from its route map. */
+function setProseLinker(routes) {
+	current = CrossLinker.fromRoutes(routes);
+}
+/** Cross-link prose text with the currently installed linker. */
+function linkProse(text) {
+	return current.link(text);
+}
+
+//#endregion
+export { linkProse, setProseLinker };

package/model-loader.js

@@ -1,128 +1,74 @@
-import { PluginEvent } from "./observability/events.js";
 import { isLoadedModel, isVersionConfig } from "./config-utils.js";
 import fs from "node:fs";
 import path from "node:path";
-import { loadApiModel } from "@tsdoctor/model";
+import { Effect } from "effect";
+import { Model } from "@tsdoctor/model";
 
 //#region src/model-loader.ts
 /**
-* Module-level emitter seam. `loadFromPath` is called from inside an
-* `Effect.promise(async () => {...})` body in `ConfigServiceLive.ts`, so a
-* load failure cannot `yield* emit(...)` — it mirrors the sync-island pattern
-* used by `twoslash-transformer.ts` (`setEventEmitter`) and `loader.ts`
-* (`setLoaderEventEmitter`, a DIFFERENT module — the ApiParser/TSDoc statics,
-* not this one). Default is a no-op; wired in plugin.ts via
-* `setModelLoaderEventEmitter(emitSync, buildId)` right after the runtime
-* emitter is created.
+* Load package.json from a path (string, URL, or Buffer).
 */
-let emitEvent = () => {};
-let currentBuildId = "";
+async function loadPackageJsonFromPath(pkgPath) {
+	const resolvedPath = path.resolve(pkgPath.toString());
+	if (!fs.existsSync(resolvedPath)) throw new Error(`Package.json file not found: ${resolvedPath}`);
+	const content = fs.readFileSync(resolvedPath, "utf-8");
+	try {
+		return JSON.parse(content);
+	} catch (error) {
+		throw new Error(`Failed to parse package.json at ${resolvedPath}: ${error.message}`);
+	}
+}
 /**
-* Inject the runtime-bound emitter into the model-loader module.
-* Call this right after `makeRuntimeEmitter` in plugin.ts.
+* Load package.json from PathLike or async function.
 */
-function setModelLoaderEventEmitter(fn, buildId = "") {
-	emitEvent = fn;
-	currentBuildId = buildId;
+async function loadPackageJson(loader) {
+	if (typeof loader === "function") return await loader();
+	return await loadPackageJsonFromPath(loader);
 }
+/** Extract the first package from a user-loader result (ApiModel-shaped object). */
+const packageFromLoaderResult = (result) => {
+	if (result && typeof result === "object" && "packages" in result) return Model.firstPackage(result).pipe(Effect.mapError(() => new Model.EmptyModelError({ reason: "API model returned by function contains no packages" })));
+	return Effect.fail(new Model.EmptyModelError({ reason: "API model loader function must return an ApiModel" }));
+};
 /**
-* Utility class for loading API models from various sources
+* Load an API model from a PathLike (via `Model.load`, typed errors) or a
+* user-supplied async loader function (ApiModel or LoadedModel result).
 */
-var ApiModelLoader = class ApiModelLoader {
-	/**
-	* Private constructor to prevent instantiation
-	*/
-	constructor() {}
-	/**
-	* Load an API model from a path (string, URL, or Buffer)
-	*/
-	static async loadFromPath(modelPath) {
-		const resolvedPath = path.resolve(modelPath.toString());
-		try {
-			if (!fs.existsSync(resolvedPath)) throw new Error(`API model file not found: ${resolvedPath}`);
-			return await loadApiModel(resolvedPath);
-		} catch (error) {
-			try {
-				emitEvent(PluginEvent.ModelLoadFailed({
-					ctx: { buildId: currentBuildId },
-					level: "error",
-					modelPath: resolvedPath,
-					reason: error instanceof Error ? error.message : String(error)
-				}));
-			} catch {}
-			throw error;
-		}
-	}
-	/**
-	* Load package.json from a path (string, URL, or Buffer)
-	*/
-	static async loadPackageJsonFromPath(pkgPath) {
-		const resolvedPath = path.resolve(pkgPath.toString());
-		if (!fs.existsSync(resolvedPath)) throw new Error(`Package.json file not found: ${resolvedPath}`);
-		const content = fs.readFileSync(resolvedPath, "utf-8");
-		try {
-			return JSON.parse(content);
-		} catch (error) {
-			throw new Error(`Failed to parse package.json at ${resolvedPath}: ${error.message}`);
-		}
-	}
-	/**
-	* Load package.json from PathLike or async function
-	*/
-	static async loadPackageJson(loader) {
-		if (typeof loader === "function") return await loader();
-		return await ApiModelLoader.loadPackageJsonFromPath(loader);
-	}
-	/**
-	* Load an API model from PathLike or async function
-	*/
-	static async loadApiModel(loader) {
-		if (typeof loader === "function") {
-			const result = await loader();
-			if (isLoadedModel(result)) {
-				const model = result.model;
-				if (model && typeof model === "object" && "packages" in model) {
-					const packages = model.packages;
-					if (packages.length === 0) throw new Error("API model returned by function contains no packages");
-					const loadedResult = { apiPackage: packages[0] };
-					if (result.source != null) loadedResult.source = result.source;
-					return loadedResult;
-				}
-				throw new Error("API model loader function must return an ApiModel");
-			}
-			if (result && typeof result === "object" && "packages" in result) {
-				const packages = result.packages;
-				if (packages.length === 0) throw new Error("API model returned by function contains no packages");
-				return { apiPackage: packages[0] };
-			}
-			throw new Error("API model loader function must return an ApiModel or LoadedModel");
+function loadApiModel(loader) {
+	if (typeof loader !== "function") return Model.load(loader.toString()).pipe(Effect.map((apiPackage) => ({ apiPackage })));
+	return Effect.gen(function* () {
+		const result = yield* Effect.promise(() => loader());
+		if (isLoadedModel(result)) {
+			const apiPackage = yield* packageFromLoaderResult(result.model);
+			return result.source != null ? {
+				apiPackage,
+				source: result.source
+			} : { apiPackage };
 		}
-		return { apiPackage: await ApiModelLoader.loadFromPath(loader) };
-	}
-	/**
-	* Resolve and load a version config
-	*/
-	static async loadVersionModel(versionValue) {
-		if (isVersionConfig(versionValue)) {
-			const { apiPackage, source: loaderSource } = await ApiModelLoader.loadApiModel(versionValue.model);
-			const packageJson = versionValue.packageJson ? await ApiModelLoader.loadPackageJson(versionValue.packageJson) : void 0;
-			const versionResult = { apiPackage };
-			if (packageJson != null) versionResult.packageJson = packageJson;
-			if (versionValue.categories != null) versionResult.categories = versionValue.categories;
-			const resolvedSource = loaderSource || versionValue.source;
-			if (resolvedSource != null) versionResult.source = resolvedSource;
-			if (versionValue.externalPackages != null) versionResult.externalPackages = versionValue.externalPackages;
-			if (versionValue.autoDetectDependencies != null) versionResult.autoDetectDependencies = versionValue.autoDetectDependencies;
-			if (versionValue.ogImage != null) versionResult.ogImage = versionValue.ogImage;
-			if (versionValue.llmsPlugin != null) versionResult.llmsPlugin = versionValue.llmsPlugin;
-			return versionResult;
-		}
-		const { apiPackage, source } = await ApiModelLoader.loadApiModel(versionValue);
-		const simpleResult = { apiPackage };
-		if (source != null) simpleResult.source = source;
-		return simpleResult;
-	}
-};
+		return { apiPackage: yield* packageFromLoaderResult(result) };
+	});
+}
+/**
+* Resolve and load a version config (full VersionConfig, or a bare model
+* path/loader).
+*/
+function loadVersionModel(versionValue) {
+	if (!isVersionConfig(versionValue)) return loadApiModel(versionValue);
+	return Effect.gen(function* () {
+		const { apiPackage, source: loaderSource } = yield* loadApiModel(versionValue.model);
+		const packageJson = versionValue.packageJson ? yield* Effect.promise(() => loadPackageJson(versionValue.packageJson)) : void 0;
+		const versionResult = { apiPackage };
+		if (packageJson != null) versionResult.packageJson = packageJson;
+		if (versionValue.categories != null) versionResult.categories = versionValue.categories;
+		const resolvedSource = loaderSource || versionValue.source;
+		if (resolvedSource != null) versionResult.source = resolvedSource;
+		if (versionValue.externalPackages != null) versionResult.externalPackages = versionValue.externalPackages;
+		if (versionValue.autoDetectDependencies != null) versionResult.autoDetectDependencies = versionValue.autoDetectDependencies;
+		if (versionValue.ogImage != null) versionResult.ogImage = versionValue.ogImage;
+		if (versionValue.llmsPlugin != null) versionResult.llmsPlugin = versionValue.llmsPlugin;
+		return versionResult;
+	});
+}
 
 //#endregion
-export { ApiModelLoader, setModelLoaderEventEmitter };
+export { loadApiModel, loadPackageJson, loadVersionModel };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.8.9",
+	"version": "0.9.0",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -38,19 +38,25 @@
 	},
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-rc.109",
-		"@effect/sql-sqlite-node": "4.0.0-rc.109",
+		"@effected/github": "^0.8.0",
+		"@effected/glob": "^0.4.0",
+		"@effected/npm": "^0.12.0",
+		"@effected/package-json": "^0.11.0",
 		"@effected/semver": "^0.5.0",
 		"@effected/store": "^0.4.0",
 		"@effected/tsconfig-json": "^0.6.0",
+		"@effected/walker": "^0.5.0",
 		"@effected/xdg": "^0.3.0",
+		"@effected/yaml": "^0.11.0",
 		"@microsoft/api-extractor-model": "^7.33.11",
 		"@shikijs/twoslash": "^4.4.3",
-		"@tsdoctor/model": "0.1.0",
-		"@tsdoctor/registry": "0.1.0",
+		"@tsdoctor/bundle": "0.1.0",
+		"@tsdoctor/model": "0.2.0",
+		"@tsdoctor/registry": "0.2.0",
+		"@tsdoctor/snapshot": "0.1.0",
 		"@typescript/vfs": "^1.6.4",
 		"clsx": "^2.1.1",
 		"effect": "4.0.0-rc.109",
-		"gray-matter": "^4.0.3",
 		"hast-util-to-jsx-runtime": "^2.3.6",
 		"image-size": "^2.0.2",
 		"ioredis": "^5.7.0",

package/plugin.js

@@ -3,7 +3,6 @@ import { emit, makeRuntimeEmitter } from "./observability/EventBus.js";
 import { runHeartbeat } from "./observability/heartbeat.js";
 import { writeIssuesJson } from "./observability/sinks/issues-sink.js";
 import { buildEventBus, logBuildSummary, makeSummaryLoggerLayer } from "./layers/ObservabilityLive.js";
-import { setLoaderEventEmitter } from "./loader.js";
 import { setPrettierEventEmitter } from "./prettier-formatter.js";
 import { setOgResolverEventEmitter } from "./og-resolver.js";
 import { setBuildStagesEventEmitter } from "./build-stages.js";
@@ -14,14 +13,12 @@ import { deriveOutputPaths, normalizeBaseRoute, unscopedName } from "./path-deri
 import { fromDir, fromParentDir } from "./config-helpers.js";
 import { classifyApiConfig, mergeLlmsPluginConfig } from "./config-utils.js";
 import { DEFAULT_SHIKI_THEMES, setShikiUtilsEventEmitter } from "./markdown/shiki-utils.js";
-import { setModelLoaderEventEmitter } from "./model-loader.js";
 import { resolveObservability } from "./schemas/observability.js";
 import { PluginOptions } from "./schemas/config.js";
 import "./schemas/index.js";
 import { ConfigService } from "./services/ConfigService.js";
 import { ConfigServiceLive } from "./layers/ConfigServiceLive.js";
 import { PathDerivationServiceLive } from "./layers/PathDerivationServiceLive.js";
-import { SnapshotServiceLive } from "./layers/SnapshotServiceLive.js";
 import { TypeRegistryServiceLive } from "./layers/TypeRegistryServiceLive.js";
 import { remarkApiCodeblocks, setRemarkApiCodeblocksEventEmitter } from "./remark-api-codeblocks.js";
 import { remarkWithApi, setRemarkWithApiEventEmitter } from "./remark-with-api.js";
@@ -31,6 +28,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { NodeFileSystem } from "@effect/platform-node";
+import { SnapshotServiceLive } from "@tsdoctor/snapshot";
 import { Effect, FileSystem, Layer, ManagedRuntime, Ref, Schema } from "effect";
 
 //#region src/plugin.ts
@@ -93,14 +91,12 @@ function ApiExtractorPluginImpl(rawOptions) {
 	const effectRuntime = ManagedRuntime.make(EffectAppLayer);
 	const emitSync = makeRuntimeEmitter(effectRuntime);
 	setEventEmitter(emitSync, buildId);
-	setLoaderEventEmitter(emitSync, buildId);
 	setShikiUtilsEventEmitter(emitSync, buildId);
 	setPrettierEventEmitter(emitSync, buildId);
 	setOgResolverEventEmitter(emitSync, buildId);
 	setRemarkWithApiEventEmitter(emitSync, buildId, obs.thresholds.slowCodeBlock);
 	setRemarkApiCodeblocksEventEmitter(emitSync, buildId);
 	setBuildStagesEventEmitter(emitSync, buildId);
-	setModelLoaderEventEmitter(emitSync, buildId);
 	const fileContextMap = /* @__PURE__ */ new Map();
 	let docsRoot;
 	let isFirstBuild = true;

package/shiki-transformer.js

@@ -8,7 +8,7 @@
 * class member references (e.g., `ClassName.methodName`).
 *
 * **How it works:**
-* 1. The transformer is initialized with route and kind maps from {@link MarkdownCrossLinker}
+* 1. The transformer is initialized with route and kind maps from `prepareWorkItems`
 * 2. During Shiki rendering, it walks the HAST tree looking for type names
 * 3. When a match is found, it wraps the text node in an anchor tag with the route
 * 4. Semantic CSS classes are added based on the API item kind (class, interface, etc.)
@@ -20,7 +20,7 @@
 *
 * **Relationships:**
 * - Initialized by {@link ApiExtractorPlugin} during the beforeBuild hook
-* - Receives route data from {@link MarkdownCrossLinker.initialize}
+* - Receives route data from the cross-link maps built in `prepareWorkItems`
 * - Used alongside {@link TwoslashManager} for type-aware code blocks
 * - Works with the hide-cut transformer for member signatures
 *
@@ -44,7 +44,7 @@
 * });
 * ```
 *
-* @see {@link MarkdownCrossLinker} for the markdown equivalent
+* @see the `@tsdoctor/model` CrossLinker for the markdown equivalent
 * @see {@link TwoslashManager} for type-aware documentation features
 */
 var ShikiCrossLinker = class {

package/sync-node-fs.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import { Effect, FileSystem, Layer, Option, Path, PlatformError } from "effect";
+
+//#region src/sync-node-fs.ts
+/**
+* A synchronous, read-only `FileSystem` implementation over `node:fs`'s sync
+* API, covering exactly the members `@tsdoctor/bundle`'s discovery walks:
+* `exists`, `stat`, `readFileString`, `readDirectory` and `readLink`.
+*
+* The config helpers (`fromDir`/`fromParentDir`) are a SYNC public API called
+* at rspress.config evaluation time, while bundle discovery is an Effect
+* program over the `FileSystem` service. `@effect/platform-node`'s
+* `NodeFileSystem` is promise-backed, so running discovery under
+* `Effect.runSync` needs this bridge; every other member stays
+* `layerNoop`-denied, which is deliberate — a new discovery dependency on an
+* unimplemented member should fail loudly here, not silently misbehave.
+*/
+const tagOf = (cause) => {
+	const code = cause?.code;
+	if (code === "ENOENT") return "NotFound";
+	if (code === "EACCES" || code === "EPERM") return "PermissionDenied";
+	return "Unknown";
+};
+const fail = (method, pathOrDescriptor, cause) => PlatformError.systemError({
+	_tag: tagOf(cause),
+	module: "FileSystem",
+	method,
+	pathOrDescriptor,
+	cause
+});
+const typeOf = (stats) => {
+	if (stats.isDirectory()) return "Directory";
+	if (stats.isSymbolicLink()) return "SymbolicLink";
+	if (stats.isFile()) return "File";
+	return "Unknown";
+};
+const infoFromStats = (stats) => ({
+	type: typeOf(stats),
+	mtime: Option.some(stats.mtime),
+	atime: Option.some(stats.atime),
+	birthtime: Option.some(stats.birthtime),
+	dev: stats.dev,
+	ino: Option.some(stats.ino),
+	mode: stats.mode,
+	nlink: Option.some(stats.nlink),
+	uid: Option.some(stats.uid),
+	gid: Option.some(stats.gid),
+	rdev: Option.some(stats.rdev),
+	size: FileSystem.Size(stats.size),
+	blksize: Option.some(FileSystem.Size(stats.blksize)),
+	blocks: Option.some(stats.blocks)
+});
+const syncFileSystem = FileSystem.layerNoop({
+	exists: (path) => Effect.sync(() => fs.existsSync(path)),
+	stat: (path) => Effect.try({
+		try: () => infoFromStats(fs.statSync(path)),
+		catch: (cause) => fail("stat", path, cause)
+	}),
+	readFileString: (path) => Effect.try({
+		try: () => fs.readFileSync(path, "utf8"),
+		catch: (cause) => fail("readFileString", path, cause)
+	}),
+	readDirectory: (path) => Effect.try({
+		try: () => fs.readdirSync(path),
+		catch: (cause) => fail("readDirectory", path, cause)
+	}),
+	readLink: (path) => Effect.try({
+		try: () => fs.readlinkSync(path),
+		catch: (cause) => fail("readLink", path, cause)
+	})
+});
+/**
+* The full sync environment bundle discovery runs under from the config
+* helpers: the sync `FileSystem` bridge plus the (already sync) `Path`
+* service.
+*/
+const SyncDiscoveryLayer = Layer.mergeAll(syncFileSystem, Path.layer);
+
+//#endregion
+export { SyncDiscoveryLayer };

package/twoslash-transformer.js

@@ -204,7 +204,7 @@ function renderMarkdownInline(markdown, context) {
 * **VFS Integration:**
 * The VFS is populated by {@link TypeRegistryService} with:
 * - The documented package's own type definitions (from API Extractor)
-* - External package types (fetched via type-registry-effect)
+* - External package types (fetched via @tsdoctor/registry)
 *
 * **Error Handling:**
 * TypeScript errors in code blocks are captured (not thrown) and: