rspress-plugin-api-extractor 0.14.0 → 0.15.0

package/BuildEnv.js

@@ -39,7 +39,6 @@ const Thresholds = Context.Reference("rspress-plugin-api-extractor/Thresholds",
 	slowPageGeneration: 500,
 	slowApiLoad: 1e3,
 	slowFileOperation: 50,
-	slowHttpRequest: 2e3,
 	slowDbOperation: 100
 }) });
 /**

package/build-program.js

@@ -1,5 +1,4 @@
 import { BuildId, PageConcurrency, SuppressExampleErrors } from "./BuildEnv.js";
-import { setProseLinker } from "./markdown/prose-linker.js";
 import { buildPipelineForApi, cleanupAndCommit, prepareWorkItems, writeMetadata } from "./build-stages.js";
 import { HideCutLinesTransformer, MemberFormatTransformer } from "./hide-cut-transformer.js";
 import { withPhase } from "./observability/spans.js";
@@ -10,6 +9,7 @@ import { ShikiCrossLinker } from "./shiki-transformer.js";
 import { VfsRegistry } from "./vfs-registry.js";
 import path from "node:path";
 import { Effect, FileSystem } from "effect";
+import { CrossLinker } from "@tsdoctor/model";
 import { attributionFacts, packageContext } from "@tsdoctor/seo";
 import { SnapshotService } from "@tsdoctor/snapshot";
 
@@ -54,10 +54,9 @@ function generateApiDocs(apiConfig, fileContextMap) {
 		const { workItems, crossLinkData } = yield* withPhase("resolve", phaseCtx, Effect.sync(() => prepareWorkItems({
 			apiPackage,
 			categories,
-			baseRoute,
-			packageName
+			baseRoute
 		})));
-		setProseLinker(crossLinkData.routes);
+		const linker = CrossLinker.fromRoutes(crossLinkData.routes);
 		const apiScope = baseRoute.replace(/^\//, "").split("/")[0] || packageName;
 		const shikiCrossLinker = ShikiCrossLinker.fromRoutes(crossLinkData.routes, apiScope);
 		addTypeRoutes(crossLinkData.routes);
@@ -88,6 +87,7 @@ function generateApiDocs(apiConfig, fileContextMap) {
 			existingSnapshots,
 			...suppressExampleErrors != null ? { suppressExampleErrors } : {},
 			...llmsPlugin != null ? { llmsPlugin } : {},
+			linker,
 			...apiConfig.docsRoot != null ? { docsRoot: apiConfig.docsRoot } : {},
 			...siteUrl != null ? { siteUrl } : {},
 			...ogImage != null ? { ogImage } : {},

package/build-stages.js

@@ -1,102 +1,50 @@
+import { emitMdxBody } from "./emit/mdx.js";
+import { emitIndexPage, renderCategoryMeta, renderRootMeta } from "./emit/meta.js";
 import { BuildMetrics } from "./layers/build-metrics.js";
+import { generateFrontmatter } from "./markdown/helpers.js";
 import { PluginEvent } from "./observability/events.js";
 import { emit } from "./observability/EventBus.js";
 import { emitSync, syncBuildId } from "./observability/sync-emitter.js";
-import { generateFrontmatter } from "./markdown/helpers.js";
-import { ClassPageGenerator } from "./markdown/page-generators/class-page.js";
-import { EnumPageGenerator } from "./markdown/page-generators/enum-page.js";
-import { FunctionPageGenerator } from "./markdown/page-generators/function-page.js";
-import { MainIndexPageGenerator } from "./markdown/page-generators/index-pages.js";
-import { InterfacePageGenerator } from "./markdown/page-generators/interface-page.js";
-import { NamespacePageGenerator } from "./markdown/page-generators/namespace-page.js";
-import { TypeAliasPageGenerator } from "./markdown/page-generators/type-alias-page.js";
-import { VariablePageGenerator } from "./markdown/page-generators/variable-page.js";
 import { OgService } from "./services/OgService.js";
 import path from "node:path";
+import { NavEntry, buildIndexPage, buildNav, buildPage, prepareWorkItems } from "@tsdoctor/pages";
 import { Effect, FileSystem, Metric, Option, Stream } from "effect";
+import { Routes, parseFrontmatter, stringifyFrontmatter } from "@tsdoctor/model";
 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, parseFrontmatter, stringifyFrontmatter } from "@tsdoctor/model";
 
 //#region src/build-stages.ts
 /**
-* Cross-link priority by API item kind (lower = higher priority). When a bare
-* name maps to multiple pages (the const+type companion pattern), the bare
-* cross-link resolves to the higher-priority kind — value declarations win over
-* type-only declarations, so `Foo` links to the importable schema, not the type.
-*/
-const CROSS_LINK_KIND_PRIORITY = {
-	Class: 0,
-	Function: 1,
-	Variable: 2,
-	Enum: 3,
-	Interface: 4,
-	TypeAlias: 5,
-	Namespace: 6
-};
-/** Lower number = higher priority for which page a bare cross-link name resolves to. */
-function crossLinkKindPriority(kind) {
-	return CROSS_LINK_KIND_PRIORITY[kind] ?? 100;
-}
-/**
 * Prepare the flat list of WorkItems to process and the cross-link data maps.
 *
-* This function:
-* 1. Categorizes API items from the model
-* 2. Builds cross-link routes and kinds maps for the prose and Shiki cross-linkers
-* 3. Extracts namespace members and adds their routes (with collision detection)
-* 4. Flattens all items into a single WorkItem[]
+* The computation lives in `@tsdoctor/pages`' `prepareWorkItems`; this is
+* the adapter's reporting over its result: an `ItemSkipped` warning per
+* uncategorized item through the sync-island seam, and a typed
+* `RouteCollisionDetected` event per collision before the fatal
+* `Routes.RouteCollisionError` — so the fatal build path still surfaces the
+* collision in .api-docs/build/issues.json (see plugin.ts's config() catch).
 *
 * NOTE: This function does NOT install the prose linker. The caller
 * is responsible for passing the returned crossLinkData to the cross-linker and
 * Shiki cross-linker as needed.
 */
-function prepareWorkItems(input) {
+function prepareWorkItems$1(input) {
 	const { apiPackage, categories, baseRoute } = input;
-	const resolvedItems = EntryPoints.resolve(apiPackage);
-	const syntheticBases = SyntheticBases.detect(resolvedItems.map((r) => r.item));
-	const docItems = syntheticBases.bases.size ? resolvedItems.filter((r) => !syntheticBases.bases.has(r.item)) : resolvedItems;
-	const resolvedLookup = /* @__PURE__ */ new Map();
-	for (const resolved of docItems) {
-		const key = `${resolved.item.displayName}::${resolved.item.kind}`;
-		resolvedLookup.set(key, resolved);
-	}
-	const { items, uncategorized } = ApiItems.categorize(docItems, categories);
-	for (const skipped of uncategorized) emitSync(PluginEvent.ItemSkipped({
+	const prepared = prepareWorkItems({
+		apiPackage,
+		categories,
+		baseRoute
+	});
+	for (const skipped of prepared.uncategorized) emitSync(PluginEvent.ItemSkipped({
 		ctx: { buildId: syncBuildId() },
 		item: skipped.displayName,
 		kind: String(skipped.kind),
 		reason: "uncategorized",
 		level: "warn"
 	}));
-	const namespaceMembers = ApiItems.namespaceMembers(docItems);
-	const candidates = [];
-	for (const [categoryKey, categoryConfig] of Object.entries(categories)) for (const item of items[categoryKey] || []) candidates.push(new Routes.RouteCandidate({
-		id: `${item.displayName}::${item.kind}`,
-		displayName: item.displayName,
-		folder: categoryConfig.folderName,
-		baseName: item.displayName.toLowerCase(),
-		kind: String(item.kind),
-		canonicalRef: item.canonicalReference?.toString() ?? item.displayName
-	}));
-	for (const nsMember of namespaceMembers) {
-		const nsCategoryEntry = Object.entries(categories).find(([, config]) => config.itemKinds?.includes(nsMember.item.kind));
-		if (!nsCategoryEntry) continue;
-		const [, nsCategoryConfig] = nsCategoryEntry;
-		candidates.push(new Routes.RouteCandidate({
-			id: nsMember.qualifiedName,
-			displayName: nsMember.qualifiedName,
-			folder: nsCategoryConfig.folderName,
-			baseName: nsMember.qualifiedName.toLowerCase(),
-			kind: String(nsMember.item.kind),
-			canonicalRef: nsMember.item.canonicalReference?.toString() ?? nsMember.qualifiedName
-		}));
-	}
-	const collisions = Routes.detectCollisions(candidates);
-	if (collisions.length > 0) {
+	if (prepared.collisions.length > 0) {
 		try {
-			for (const collision of collisions) emitSync(PluginEvent.RouteCollisionDetected({
+			for (const collision of prepared.collisions) emitSync(PluginEvent.RouteCollisionDetected({
 				ctx: {
 					buildId: syncBuildId(),
 					route: collision.route
@@ -107,100 +55,12 @@ function prepareWorkItems(input) {
 		} catch {}
 		throw new Routes.RouteCollisionError({
 			baseRoute,
-			collisions
+			collisions: prepared.collisions
 		});
 	}
-	const routes = /* @__PURE__ */ new Map();
-	const kinds = /* @__PURE__ */ new Map();
-	const routeOwnerPriority = /* @__PURE__ */ new Map();
-	for (const [categoryKey, categoryConfig] of Object.entries(categories)) {
-		const categoryItems = items[categoryKey] || [];
-		for (const item of categoryItems) {
-			const itemRoute = `${baseRoute}/${categoryConfig.folderName}/${item.displayName.toLowerCase()}`;
-			const priority = crossLinkKindPriority(String(item.kind));
-			const existingPriority = routeOwnerPriority.get(item.displayName);
-			if (existingPriority === void 0 || priority < existingPriority) {
-				routes.set(item.displayName, itemRoute);
-				kinds.set(item.displayName, item.kind);
-				routeOwnerPriority.set(item.displayName, priority);
-			}
-			if (item.kind === "Class" || item.kind === "Interface") {
-				const itemWithMembers = item;
-				const anchors = ApiItems.memberAnchors(itemWithMembers);
-				const byCanonicalRef = new Map(itemWithMembers.members.map((member) => [member.canonicalReference?.toString() ?? member.displayName, member]));
-				for (const [routeKey, memberId] of ApiItems.memberRouteKeys(itemWithMembers)) {
-					const member = byCanonicalRef.get(memberId);
-					if (!member) continue;
-					const anchor = anchors.get(memberId) ?? Routes.memberAnchor(member.displayName);
-					routes.set(routeKey, `${itemRoute}#${anchor}`);
-					kinds.set(routeKey, member.kind);
-				}
-			}
-		}
-	}
-	const unqualifiedNameCounts = /* @__PURE__ */ new Map();
-	for (const nsMember of namespaceMembers) {
-		const name = nsMember.item.displayName;
-		unqualifiedNameCounts.set(name, (unqualifiedNameCounts.get(name) || 0) + 1);
-	}
-	for (const nsMember of namespaceMembers) {
-		const categoryEntry = Object.entries(categories).find(([, config]) => config.itemKinds?.includes(nsMember.item.kind));
-		if (!categoryEntry) continue;
-		const [, categoryConfig] = categoryEntry;
-		const qualifiedRoute = `${baseRoute}/${categoryConfig.folderName}/${nsMember.qualifiedName.toLowerCase()}`;
-		routes.set(nsMember.qualifiedName, qualifiedRoute);
-		kinds.set(nsMember.qualifiedName, nsMember.item.kind);
-		const displayName = nsMember.item.displayName;
-		if (/^[A-Z]/.test(displayName) && (unqualifiedNameCounts.get(displayName) || 0) <= 1 && !routes.has(displayName)) {
-			routes.set(displayName, qualifiedRoute);
-			kinds.set(displayName, nsMember.item.kind);
-		}
-	}
-	for (const [baseItem, syntheticBase] of syntheticBases.bases) {
-		const baseName = baseItem.displayName;
-		if (routes.has(baseName)) continue;
-		const owner = syntheticBase.ownerClasses[0];
-		const ownerRoute = owner ? routes.get(owner.displayName) : void 0;
-		if (!ownerRoute) continue;
-		routes.set(baseName, `${ownerRoute}#${SyntheticBases.BASE_CLASS_ANCHOR}`);
-		kinds.set(baseName, baseItem.kind);
-	}
-	const workItems = [];
-	for (const [categoryKey, categoryConfig] of Object.entries(categories)) {
-		const categoryItems = items[categoryKey] || [];
-		for (const item of categoryItems) {
-			const lookupKey = `${item.displayName}::${item.kind}`;
-			const resolved = resolvedLookup.get(lookupKey);
-			const syntheticBase = syntheticBases.baseByOwner.get(item);
-			const memberAnchors = item.kind === "Class" || item.kind === "Interface" ? ApiItems.memberAnchors(item) : void 0;
-			workItems.push({
-				item,
-				categoryKey,
-				categoryConfig,
-				...resolved?.availableFrom != null ? { availableFrom: resolved.availableFrom } : {},
-				...syntheticBase != null ? { syntheticBase } : {},
-				...memberAnchors != null ? { memberAnchors } : {}
-			});
-		}
-	}
-	for (const nsMember of namespaceMembers) {
-		const categoryEntry = Object.entries(categories).find(([, config]) => config.itemKinds?.includes(nsMember.item.kind));
-		if (categoryEntry) {
-			const [categoryKey, categoryConfig] = categoryEntry;
-			workItems.push({
-				item: nsMember.item,
-				categoryKey,
-				categoryConfig,
-				namespaceMember: nsMember
-			});
-		}
-	}
 	return {
-		workItems,
-		crossLinkData: {
-			routes,
-			kinds
-		}
+		workItems: prepared.workItems,
+		crossLinkData: prepared.crossLinkData
 	};
 }
 /**
@@ -220,94 +80,58 @@ function generateSinglePage(workItem, ctx) {
 		const { buildId, existingSnapshots, baseRoute, packageName, apiScope, apiName, source, buildTime, resolvedOutputDir, suppressExampleErrors, llmsPlugin } = ctx;
 		const { item, categoryConfig, namespaceMember } = workItem;
 		const pageGenStart = performance.now();
-		let page = null;
-		switch (item.kind) {
-			case ApiItemKind.Class: {
-				const generator = new ClassPageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom, workItem.syntheticBase, workItem.memberAnchors));
-				page = {
-					routePath: page.routePath.replace("/class/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.Interface: {
-				const generator = new InterfacePageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/interface/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.Function: {
-				const generator = new FunctionPageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/function/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.TypeAlias: {
-				const generator = new TypeAliasPageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/type/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.Enum: {
-				const generator = new EnumPageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/enum/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.Variable: {
-				const generator = new VariablePageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/variable/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			case ApiItemKind.Namespace: {
-				const generator = new NamespacePageGenerator();
-				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom));
-				page = {
-					routePath: page.routePath.replace("/namespace/", `/${categoryConfig.folderName}/`),
-					content: page.content
-				};
-				break;
-			}
-			default:
-				yield* emit(PluginEvent.ItemSkipped({
+		const built = yield* buildPage({
+			item,
+			categoryKey: workItem.categoryKey,
+			singularName: categoryConfig.singularName,
+			folderName: categoryConfig.folderName,
+			baseRoute,
+			packageName,
+			apiName,
+			namespaceMember,
+			availableFrom: workItem.availableFrom,
+			syntheticBase: workItem.syntheticBase,
+			memberAnchors: workItem.memberAnchors,
+			source,
+			suppressExampleErrors,
+			linker: ctx.linker,
+			onExampleFormatError: (error) => {
+				const cause = error.cause;
+				return emit(PluginEvent.PrettierError({
 					ctx: {
 						buildId,
 						packageName,
 						apiScope
 					},
-					item: item.displayName,
-					kind: String(item.kind),
-					reason: "unsupported kind",
-					level: "trace"
+					file: "unknown",
+					reason: cause instanceof Error ? cause.message : String(cause),
+					level: "warn"
 				}));
-				return null;
-		}
-		if (!page) return null;
-		if (namespaceMember) {
-			const qualifiedNameLower = namespaceMember.qualifiedName.toLowerCase();
-			const lastSlash = page.routePath.lastIndexOf("/");
-			page = {
-				routePath: `${page.routePath.slice(0, lastSlash + 1)}${qualifiedNameLower}`,
-				content: page.content
-			};
+			}
+		});
+		if (Option.isNone(built)) {
+			yield* emit(PluginEvent.ItemSkipped({
+				ctx: {
+					buildId,
+					packageName,
+					apiScope
+				},
+				item: item.displayName,
+				kind: String(item.kind),
+				reason: "unsupported kind",
+				level: "trace"
+			}));
+			return null;
 		}
+		const irPage = built.value;
+		const body = yield* Effect.fromResult(emitMdxBody(irPage, {
+			apiScope,
+			llmsEnabled: llmsPlugin?.enabled === true
+		})).pipe(Effect.orDie);
+		const page = {
+			routePath: irPage.route,
+			content: generateFrontmatter(irPage.entityName, irPage.description, irPage.singularName, apiName) + body
+		};
 		const codeblockCount = (page.content.match(/<(ApiSignature|ApiMember|ApiExample)\b/g) ?? []).length;
 		yield* emit(PluginEvent.PageGenerated({
 			ctx: {
@@ -543,20 +367,27 @@ function writeMetadata(input) {
 		const fileSystem = yield* FileSystem.FileSystem;
 		const snapshotSvc = yield* SnapshotService;
 		const { buildId, fileResults, categories, resolvedOutputDir, existingSnapshots, buildTime, baseRoute, packageName, generatedFiles } = input;
-		const categoriesWithItems = /* @__PURE__ */ new Set();
-		for (const result of fileResults) categoriesWithItems.add(result.categoryKey);
-		const apiMetaEntries = [];
-		for (const [categoryKey, categoryConfig] of Object.entries(categories)) if (categoriesWithItems.has(categoryKey)) apiMetaEntries.push({
-			type: "dir",
-			name: categoryConfig.folderName,
-			label: categoryConfig.displayName,
-			collapsible: categoryConfig.collapsible ?? true,
-			collapsed: categoryConfig.collapsed ?? true,
-			overviewHeaders: categoryConfig.overviewHeaders ?? [2]
+		const navCategories = {};
+		for (const [categoryKey, categoryConfig] of Object.entries(categories)) navCategories[categoryKey] = {
+			displayName: categoryConfig.displayName,
+			folderName: categoryConfig.folderName,
+			...categoryConfig.collapsible !== void 0 ? { collapsible: categoryConfig.collapsible } : {},
+			...categoryConfig.collapsed !== void 0 ? { collapsed: categoryConfig.collapsed } : {},
+			...categoryConfig.overviewHeaders !== void 0 ? { overviewHeaders: categoryConfig.overviewHeaders } : {}
+		};
+		const navTree = buildNav({
+			baseRoute,
+			categories: navCategories,
+			entries: fileResults.map((result) => NavEntry.make({
+				categoryKey: result.categoryKey,
+				label: result.label,
+				name: path.basename(result.relativePathWithExt, ".mdx"),
+				route: result.routePath
+			}))
 		});
 		const apiMetaJsonPath = path.join(resolvedOutputDir, "_meta.json");
 		const apiMetaJsonRelPath = "_meta.json";
-		const apiMetaJsonContent = JSON.stringify(apiMetaEntries, null, "	");
+		const apiMetaJsonContent = renderRootMeta(navTree);
 		const apiMetaContentHash = hashContent(apiMetaJsonContent);
 		const apiMetaOldSnapshot = existingSnapshots.get(apiMetaJsonRelPath);
 		let apiMetaUnchanged = false;
@@ -621,15 +452,17 @@ function writeMetadata(input) {
 			buildTime
 		}).pipe(Effect.ignore);
 		generatedFiles.add(apiMetaJsonRelPath);
-		const categoryCounts = {};
-		for (const result of fileResults) categoryCounts[result.categoryKey] = (categoryCounts[result.categoryKey] || 0) + 1;
-		const mainIndex = new MainIndexPageGenerator().generate(packageName, baseRoute, categoryCounts);
-		const indexRelativePath = `${mainIndex.routePath.replace(baseRoute, "").replace(/^\//, "")}.mdx`;
+		const mainIndex = buildIndexPage({
+			packageName,
+			baseRoute
+		});
+		const mainIndexContent = emitIndexPage(mainIndex);
+		const indexRelativePath = `${mainIndex.route.replace(baseRoute, "").replace(/^\//, "")}.mdx`;
 		const indexAbsolutePath = path.join(resolvedOutputDir, indexRelativePath);
 		if (!(yield* fileSystem.exists(indexAbsolutePath).pipe(Effect.orElseSucceed(() => false)))) {
 			const indexDirPath = path.dirname(indexAbsolutePath);
 			yield* fileSystem.makeDirectory(indexDirPath, { recursive: true }).pipe(Effect.orDie);
-			yield* fileSystem.writeFileString(indexAbsolutePath, mainIndex.content).pipe(Effect.orDie);
+			yield* fileSystem.writeFileString(indexAbsolutePath, mainIndexContent).pipe(Effect.orDie);
 			yield* Metric.update(BuildMetrics.filesTotal, 1);
 			yield* Metric.update(BuildMetrics.filesNew, 1);
 		} else {
@@ -637,28 +470,11 @@ function writeMetadata(input) {
 			yield* Metric.update(BuildMetrics.filesUnchanged, 1);
 		}
 		generatedFiles.add("index.mdx");
-		const categoryMetaEntriesMap = /* @__PURE__ */ new Map();
-		for (const result of fileResults) {
-			const baseName = path.basename(result.relativePathWithExt, ".mdx");
-			const entries = categoryMetaEntriesMap.get(result.categoryKey) || [];
-			entries.push({
-				name: baseName,
-				label: result.label
-			});
-			categoryMetaEntriesMap.set(result.categoryKey, entries);
-		}
-		const metaSnapshotsToUpdate = (yield* Effect.forEach(Array.from(categoryMetaEntriesMap.entries()), ([categoryKey, entries]) => Effect.gen(function* () {
-			const categoryConfig = categories[categoryKey];
-			if (!categoryConfig || entries.length === 0) return null;
-			entries.sort((a, b) => a.label.localeCompare(b.label));
-			const categoryMeta = entries.map((entry) => ({
-				type: "file",
-				name: entry.name,
-				label: entry.label
-			}));
+		const metaSnapshotsToUpdate = (yield* Effect.forEach(navTree.groups, (group) => Effect.gen(function* () {
+			const categoryConfig = group.category;
 			const categoryMetaPath = path.join(resolvedOutputDir, categoryConfig.folderName, "_meta.json");
 			const relPath = path.join(categoryConfig.folderName, "_meta.json");
-			const content = JSON.stringify(categoryMeta, null, "	");
+			const content = renderCategoryMeta(group);
 			const contentHash = hashContent(content);
 			const oldSnapshot = existingSnapshots.get(relPath);
 			let isUnchanged = false;
@@ -829,6 +645,7 @@ function buildPipelineForApi(input) {
 		resolvedOutputDir: input.resolvedOutputDir,
 		...input.suppressExampleErrors != null ? { suppressExampleErrors: input.suppressExampleErrors } : {},
 		...input.llmsPlugin != null ? { llmsPlugin: input.llmsPlugin } : {},
+		linker: input.linker,
 		...input.docsRoot !== void 0 ? { docsRoot: input.docsRoot } : {},
 		...input.siteUrl != null ? { siteUrl: input.siteUrl } : {},
 		...input.ogImage != null ? { ogImage: input.ogImage } : {},
@@ -849,4 +666,4 @@ function buildPipelineForApi(input) {
 }
 
 //#endregion
-export { buildPipelineForApi, cleanupAndCommit, crossLinkKindPriority, generateSinglePage, prepareWorkItems, writeMetadata, writeSingleFile };
+export { buildPipelineForApi, cleanupAndCommit, generateSinglePage, prepareWorkItems$1 as prepareWorkItems, writeMetadata, writeSingleFile };

package/config-helpers.js

@@ -1,7 +1,7 @@
-import { normalizeBaseRoute } from "./path-derivation.js";
 import { SyncDiscoveryLayer } from "./sync-node-fs.js";
 import fsSync from "node:fs";
 import path from "node:path";
+import { normalizeBaseRoute } from "@tsdoctor/pages";
 import { Effect, Result } from "effect";
 import { discoverBundle } from "@tsdoctor/bundle";