rspress-plugin-api-extractor 0.14.0 → 0.15.0

package/emit/mdx.js

@@ -0,0 +1,311 @@
+import { Result } from "effect";
+import { Blockquote, Code, Heading, InlineCode, Link, List, ListItem, Markdown, MdxJsxAttribute, MdxJsxAttributeValueExpression, MdxJsxFlowElement, MdxjsEsm, Paragraph, Root, Strong, Text } from "@effected/markdown";
+
+//#region src/emit/mdx.ts
+/** Serialize one flow node as its own document, without the trailing newline. */
+function serialize(node) {
+	return Result.map(Markdown.stringifyResult(Root.make({ children: [node] })), (text) => text.replace(/\n$/, ""));
+}
+/** Serialize phrasing content to the one-line string a JSX prop or a table cell carries. */
+function inlineText(children) {
+	if (children.length === 0) return Result.succeed("");
+	return serialize(Paragraph.make({ children: [...children] }));
+}
+const GENERICS = /<([A-Z][A-Za-z0-9_]*(?:\s+extends\s+[^,>\s][^,>]*)?(?:,\s*[A-Z][A-Za-z0-9_]*(?:\s+extends\s+[^,>\s][^,>]*)?)*)>/g;
+/**
+* {@link escapeMdxGenerics} as an mdast transform: a generic parameter list
+* in a text run becomes an inline code node, and a raw-HTML node that IS a
+* generic (`<T>` parses as an HTML tag) becomes one too. Code spans are
+* already inline code and are left alone; container nodes are walked.
+*
+* @remarks
+* Done on the tree rather than on the serialized string because the kit
+* escapes a bare `<` in text (`Map\<K, V\>`) as it serializes, and the
+* string-level regex would no longer see the generic. The two spellings are
+* the same MDX; the tree form is what lets the kit own every byte.
+*/
+function escapeGenericsInPhrasing(children) {
+	const out = [];
+	for (const node of children) if (node.type === "text") {
+		let last = 0;
+		for (const match of node.value.matchAll(GENERICS)) {
+			const index = match.index ?? 0;
+			if (index > last) out.push(Text.make({ value: node.value.slice(last, index) }));
+			out.push(InlineCode.make({ value: match[0] }));
+			last = index + match[0].length;
+		}
+		if (last === 0) out.push(node);
+		else if (last < node.value.length) out.push(Text.make({ value: node.value.slice(last) }));
+	} else if (node.type === "html" && new RegExp(`^${GENERICS.source}$`).test(node.value)) out.push(InlineCode.make({ value: node.value }));
+	else if (node.type === "link" || node.type === "strong" || node.type === "emphasis" || node.type === "delete") out.push({
+		...node,
+		children: [...escapeGenericsInPhrasing(node.children)]
+	});
+	else out.push(node);
+	return out;
+}
+/** Phrasing content with generics escaped — the tree form of {@link escapeMdxGenerics}. */
+function escapedPhrasing(children) {
+	return Result.succeed(escapeGenericsInPhrasing(children));
+}
+const text = (value) => Text.make({ value });
+const paragraph = (children) => Paragraph.make({ children: [...children] });
+const heading = (depth, value) => Heading.make({
+	depth,
+	children: [text(value)]
+});
+const code = (value) => InlineCode.make({ value });
+const expression = (name, value) => MdxJsxAttribute.make({
+	name,
+	value: MdxJsxAttributeValueExpression.make({ value: JSON.stringify(value) })
+});
+const literal = (name, value) => MdxJsxAttribute.make({
+	name,
+	value
+});
+const element = (name, attributes, children = []) => MdxJsxFlowElement.make({
+	name,
+	attributes: [...attributes],
+	children: [...children]
+});
+var Body = class {
+	chunks = [];
+	failure;
+	push(node, trailing = "\n\n") {
+		if (this.failure) return;
+		const result = serialize(node);
+		if (Result.isFailure(result)) {
+			this.failure = result.failure;
+			return;
+		}
+		this.chunks.push({
+			text: result.success,
+			trailing
+		});
+	}
+	/** Push a heading. */
+	heading(depth, value) {
+		this.push(heading(depth, value));
+	}
+	pushResult(result, use) {
+		if (this.failure) return;
+		if (Result.isFailure(result)) {
+			this.failure = result.failure;
+			return;
+		}
+		use(result.success);
+	}
+	render() {
+		if (this.failure) return Result.fail(this.failure);
+		return Result.succeed(this.chunks.map((chunk) => chunk.text + chunk.trailing).join(""));
+	}
+};
+const RUNTIME = "rspress-plugin-api-extractor/runtime";
+/** The component import lines each page kind carried. */
+function importLines(kind) {
+	const lines = [`import { SourceCode } from "@rspress/core/theme";`];
+	if (kind === "enum") lines.push(`import { EnumMembersTable } from "${RUNTIME}";`);
+	else if (kind !== "namespace") lines.push(`import { ParametersTable } from "${RUNTIME}";`);
+	const components = kind === "class" || kind === "interface" ? "ApiSignature, ApiMember, ApiExample" : "ApiSignature, ApiExample";
+	lines.push(`import { ${components} } from "${RUNTIME}";`);
+	return lines.join("\n");
+}
+function parameterRows(rows, escapeGenerics) {
+	return Result.all(rows.map((row) => Result.map(inlineText(escapeGenerics ? escapeGenericsInPhrasing(row.description) : row.description), (description) => ({
+		name: row.name,
+		...row.type !== void 0 ? { type: row.type } : {},
+		description
+	}))));
+}
+function enumRows(rows) {
+	return Result.all(rows.map((row) => Result.map(inlineText(row.description), (description) => ({
+		name: row.name,
+		...row.value !== void 0 ? { value: row.value } : {},
+		description
+	}))));
+}
+/** The literal `memberName` a role fixes, or none when the member's own name is spent as an expression. */
+function fixedMemberName(member) {
+	switch (member.role) {
+		case "constructor": return "constructor";
+		case "call-signature": return "Call Signature";
+		case "construct-signature": return "Construct Signature";
+		case "index-signature": return "Index Signature";
+		default: return;
+	}
+}
+/** Whether the role carried a `hasParameters` prop — constructors and methods, never properties or signatures. */
+function carriesHasParameters(member) {
+	return member.role === "constructor" || member.role === "method" || member.role === "getter";
+}
+function emitMember(body, member, apiScope) {
+	body.pushResult(member.summary ? escapedPhrasing(member.summary) : Result.succeed(void 0), (summaryNodes) => {
+		body.pushResult(summaryNodes ? inlineText(summaryNodes) : Result.succeed(""), (summary) => {
+			const fixedName = fixedMemberName(member);
+			const attributes = [
+				expression("code", member.code.display),
+				expression("source", member.code.source),
+				expression("apiScope", apiScope),
+				fixedName !== void 0 ? literal("memberName", fixedName) : expression("memberName", member.name)
+			];
+			if (summary) attributes.push(expression("summary", summary));
+			attributes.push(expression("id", member.anchor));
+			if (carriesHasParameters(member)) attributes.push(expression("hasParameters", member.parameters !== void 0));
+			body.push(element("ApiMember", attributes));
+		});
+	});
+	if (member.parameters !== void 0) body.pushResult(parameterRows(member.parameters, false), (rows) => {
+		body.push(element("ParametersTable", [expression("parameters", rows)]));
+	});
+	if (member.returns !== void 0) body.pushResult(escapedPhrasing(member.returns), (returns) => {
+		body.push(paragraph([
+			Strong.make({ children: [text("Returns:")] }),
+			text(" "),
+			...returns
+		]));
+	});
+}
+function emitBlock(body, block, page, options) {
+	const { apiScope } = options;
+	switch (block.kind) {
+		case "title":
+			body.heading(1, block.name);
+			if (block.deprecation !== void 0) body.pushResult(escapedPhrasing(block.deprecation), (message) => {
+				body.push(Blockquote.make({ children: [paragraph([
+					text("⚠️ "),
+					Strong.make({ children: [text("Deprecated:")] }),
+					text(" "),
+					...message
+				])] }));
+			});
+			if (block.releaseTag !== "Public") body.push(paragraph([code(block.releaseTag)]));
+			return;
+		case "prose":
+			if (block.role === "summary") {
+				for (const node of block.content) body.push(node);
+				return;
+			}
+			body.heading(2, block.role === "remarks" ? "Remarks" : "Returns");
+			for (const node of block.content) if (block.role === "returns" && node.type === "paragraph") body.pushResult(escapedPhrasing(node.children), (children) => body.push(paragraph(children)));
+			else body.push(node);
+			return;
+		case "available-from": {
+			const children = [text("Available from: ")];
+			block.entryPoints.forEach((entryPoint, index) => {
+				if (index > 0) children.push(text(", "));
+				children.push(code(entryPoint === "default" ? block.packageName : `${block.packageName}/${entryPoint}`));
+			});
+			body.push(paragraph(children));
+			return;
+		}
+		case "source-link": {
+			const children = [element("div", [literal("className", "api-docs-toolbar-left")], [element("SourceCode", [literal("href", block.href)])])];
+			if (options.llmsEnabled) children.push(element("div", [literal("className", "api-docs-toolbar-right")]));
+			body.push(element("div", [literal("className", "api-docs-toolbar")], children));
+			return;
+		}
+		case "signature": {
+			const attributes = [
+				expression("code", block.code.display),
+				expression("source", block.code.source),
+				expression("apiScope", apiScope)
+			];
+			if (block.hasParameters !== void 0) attributes.push(expression("hasParameters", block.hasParameters));
+			if (block.hasMembers !== void 0) attributes.push(expression("hasMembers", block.hasMembers));
+			body.push(element("ApiSignature", attributes), block.hasMembers === true ? "\n" : "\n\n");
+			return;
+		}
+		case "base-class":
+			body.heading(2, "Base Class");
+			body.push(paragraph([
+				code(block.className),
+				text(" extends "),
+				code(block.baseName),
+				text(", a compiler-generated declaration that is not exported from "),
+				code(block.packageName),
+				text(".")
+			]));
+			body.push(element("ApiSignature", [
+				expression("code", block.code.display),
+				expression("source", block.code.source),
+				expression("apiScope", apiScope)
+			]));
+			return;
+		case "member-group":
+			body.heading(2, block.title);
+			for (const member of block.members) emitMember(body, member, apiScope);
+			return;
+		case "parameters":
+			body.pushResult(parameterRows(block.rows, true), (rows) => {
+				body.push(element("ParametersTable", [expression("parameters", rows)]));
+			});
+			return;
+		case "enum-members":
+			body.pushResult(enumRows(block.rows), (rows) => {
+				body.push(element("EnumMembersTable", [expression("members", rows)]));
+			});
+			return;
+		case "examples":
+			body.heading(2, "Examples");
+			for (const example of block.items) if (example.typeChecked) body.push(element("ApiExample", [
+				expression("code", example.code.display),
+				expression("source", example.code.source),
+				expression("apiScope", apiScope)
+			]));
+			else body.push(Code.make({
+				value: example.code.display,
+				lang: example.language
+			}));
+			return;
+		case "see-also":
+			body.heading(2, "See Also");
+			body.pushResult(Result.all(block.references.map(escapedPhrasing)), (references) => {
+				body.push(List.make({
+					ordered: false,
+					spread: false,
+					children: references.map((reference) => ListItem.make({
+						spread: false,
+						children: [paragraph(reference)]
+					}))
+				}));
+			});
+			return;
+		case "member-index":
+			body.heading(2, block.title);
+			body.pushResult(Result.all(block.entries.map((entry) => entry.summary ? escapedPhrasing(entry.summary) : Result.succeed(void 0))), (summaries) => {
+				const items = block.entries.map((entry, index) => {
+					const children = [Link.make({
+						url: entry.route,
+						children: [text(entry.name)]
+					})];
+					const summary = summaries[index];
+					if (summary !== void 0) children.push(text(" - "), ...summary);
+					return ListItem.make({
+						spread: false,
+						children: [paragraph(children)]
+					});
+				});
+				body.push(List.make({
+					ordered: false,
+					spread: false,
+					children: items
+				}));
+			});
+			return;
+	}
+}
+/**
+* Emit a page's MDX body: the component import lines followed by every
+* block, joined as the generators joined them. No frontmatter — the adapter
+* assembles that from the page facts, in the generate stage the snapshot
+* hash is taken in.
+*/
+function emitMdxBody(page, options) {
+	const body = new Body();
+	body.push(MdxjsEsm.make({ value: importLines(page.kind) }));
+	for (const block of page.blocks) emitBlock(body, block, page, options);
+	return body.render();
+}
+
+//#endregion
+export { emitMdxBody };

package/emit/meta.js

@@ -0,0 +1,62 @@
+import { emitFrontmatterBlock } from "@tsdoctor/model";
+
+//#region src/emit/meta.ts
+/**
+* The RSPress navigation and landing-page emitters: the root and
+* per-category `_meta.json` files rendered from a `@tsdoctor/pages`
+* {@link NavTree}, and the `index.mdx` frontmatter rendered from an
+* {@link IndexPage}.
+*
+* @remarks
+* Pure functions of the IR. The renderer defaults (`collapsible` and
+* `collapsed` true, `overviewHeaders` `[2]`) are RSPress sidebar policy the
+* tree leaves to its consumer; the tab-indented JSON is the spelling the
+* snapshot system compares an existing file against.
+*
+* @packageDocumentation
+*/
+/** The root `_meta.json` entries, one per category group that received a page. */
+function rootMetaEntries(tree) {
+	return tree.groups.map((group) => ({
+		type: "dir",
+		name: group.category.folderName,
+		label: group.category.displayName,
+		collapsible: group.category.collapsible ?? true,
+		collapsed: group.category.collapsed ?? true,
+		overviewHeaders: group.category.overviewHeaders ?? [2]
+	}));
+}
+/** A category folder's `_meta.json` entries, in the tree's (label-sorted) order. */
+function categoryMetaEntries(group) {
+	return group.pages.map((page) => ({
+		type: "file",
+		name: page.name,
+		label: page.label
+	}));
+}
+/** Serialize `_meta.json` entries the way the plugin always has: tab-indented JSON, no trailing newline. */
+function renderMeta(entries) {
+	return JSON.stringify(entries, null, "	");
+}
+/** The root `_meta.json` text for an API. */
+function renderRootMeta(tree) {
+	return renderMeta(rootMetaEntries(tree));
+}
+/** A category folder's `_meta.json` text. */
+function renderCategoryMeta(group) {
+	return renderMeta(categoryMetaEntries(group));
+}
+/**
+* The `index.mdx` text for an API: frontmatter only, with RSPress's
+* `overview: true` so the page lists its category folders.
+*/
+function emitIndexPage(index) {
+	return emitFrontmatterBlock({
+		title: index.title,
+		description: index.description,
+		overview: true
+	});
+}
+
+//#endregion
+export { categoryMetaEntries, emitIndexPage, renderCategoryMeta, renderMeta, renderRootMeta, rootMetaEntries };

package/index.d.ts

@@ -12,14 +12,6 @@ import "unified";
 import "vfile";
 import "react";
 //#region src/schemas/config.d.ts
-/**
- * Verbosity level for plugin build output.
- *
- * @public
- */
-declare const LogLevel: Schema.Literals<readonly ["none", "info", "verbose", "debug", "warn", "error"]>;
-/** @public */
-type LogLevel = typeof LogLevel.Type;
 /**
  * Configuration for a single documentation category (e.g. Classes, Functions).
  *
@@ -34,8 +26,6 @@ declare const CategoryConfig: Schema.Struct<{
   readonly folderName: Schema.String;
   /** API item kinds included in this category. */
   readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-  /** TSDoc modifier tag that marks items for this category. */
-  readonly tsdocModifier: Schema.optional<Schema.String>;
   /** Whether the sidebar section is collapsible. Defaults to `true`. */
   readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
   /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -90,8 +80,6 @@ declare const VersionConfig: Schema.Struct<{
     readonly folderName: Schema.String;
     /** API item kinds included in this category. */
     readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-    /** TSDoc modifier tag that marks items for this category. */
-    readonly tsdocModifier: Schema.optional<Schema.String>;
     /** Whether the sidebar section is collapsible. Defaults to `true`. */
     readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
     /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -110,8 +98,6 @@ declare const VersionConfig: Schema.Struct<{
   readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
     readonly name: Schema.String;
     readonly version: Schema.String;
-    readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-    readonly compilerOptions: Schema.optional<Schema.Unknown>;
   }>>>>;
   /** Auto-detect external packages from `package.json` dependency fields. */
   readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -176,8 +162,6 @@ declare const SingleApiConfig: Schema.Struct<{
       readonly folderName: Schema.String;
       /** API item kinds included in this category. */
       readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-      /** TSDoc modifier tag that marks items for this category. */
-      readonly tsdocModifier: Schema.optional<Schema.String>;
       /** Whether the sidebar section is collapsible. Defaults to `true`. */
       readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
       /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -196,8 +180,6 @@ declare const SingleApiConfig: Schema.Struct<{
     readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
       readonly name: Schema.String;
       readonly version: Schema.String;
-      readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-      readonly compilerOptions: Schema.optional<Schema.Unknown>;
     }>>>>;
     /** Auto-detect external packages from `package.json` dependency fields. */
     readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -241,8 +223,6 @@ declare const SingleApiConfig: Schema.Struct<{
     readonly folderName: Schema.String;
     /** API item kinds included in this category. */
     readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-    /** TSDoc modifier tag that marks items for this category. */
-    readonly tsdocModifier: Schema.optional<Schema.String>;
     /** Whether the sidebar section is collapsible. Defaults to `true`. */
     readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
     /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -261,8 +241,6 @@ declare const SingleApiConfig: Schema.Struct<{
   readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
     readonly name: Schema.String;
     readonly version: Schema.String;
-    readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-    readonly compilerOptions: Schema.optional<Schema.Unknown>;
   }>>>>;
   /** Auto-detect external packages from `package.json` dependency fields. */
   readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -330,8 +308,6 @@ declare const MultiApiConfig: Schema.Struct<{
     readonly folderName: Schema.String;
     /** API item kinds included in this category. */
     readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-    /** TSDoc modifier tag that marks items for this category. */
-    readonly tsdocModifier: Schema.optional<Schema.String>;
     /** Whether the sidebar section is collapsible. Defaults to `true`. */
     readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
     /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -350,8 +326,6 @@ declare const MultiApiConfig: Schema.Struct<{
   readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
     readonly name: Schema.String;
     readonly version: Schema.String;
-    readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-    readonly compilerOptions: Schema.optional<Schema.Unknown>;
   }>>>>;
   /** Auto-detect external packages from `package.json` dependency fields. */
   readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -442,8 +416,6 @@ declare const PluginOptions: Schema.Struct<{
         readonly folderName: Schema.String;
         /** API item kinds included in this category. */
         readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-        /** TSDoc modifier tag that marks items for this category. */
-        readonly tsdocModifier: Schema.optional<Schema.String>;
         /** Whether the sidebar section is collapsible. Defaults to `true`. */
         readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
         /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -462,8 +434,6 @@ declare const PluginOptions: Schema.Struct<{
       readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
         readonly name: Schema.String;
         readonly version: Schema.String;
-        readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-        readonly compilerOptions: Schema.optional<Schema.Unknown>;
       }>>>>;
       /** Auto-detect external packages from `package.json` dependency fields. */
       readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -507,8 +477,6 @@ declare const PluginOptions: Schema.Struct<{
       readonly folderName: Schema.String;
       /** API item kinds included in this category. */
       readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-      /** TSDoc modifier tag that marks items for this category. */
-      readonly tsdocModifier: Schema.optional<Schema.String>;
       /** Whether the sidebar section is collapsible. Defaults to `true`. */
       readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
       /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -527,8 +495,6 @@ declare const PluginOptions: Schema.Struct<{
     readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
       readonly name: Schema.String;
       readonly version: Schema.String;
-      readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-      readonly compilerOptions: Schema.optional<Schema.Unknown>;
     }>>>>;
     /** Auto-detect external packages from `package.json` dependency fields. */
     readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -590,8 +556,6 @@ declare const PluginOptions: Schema.Struct<{
       readonly folderName: Schema.String;
       /** API item kinds included in this category. */
       readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-      /** TSDoc modifier tag that marks items for this category. */
-      readonly tsdocModifier: Schema.optional<Schema.String>;
       /** Whether the sidebar section is collapsible. Defaults to `true`. */
       readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
       /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -610,8 +574,6 @@ declare const PluginOptions: Schema.Struct<{
     readonly externalPackages: Schema.optional<Schema.mutable<Schema.$Array<Schema.Struct<{
       readonly name: Schema.String;
       readonly version: Schema.String;
-      readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-      readonly compilerOptions: Schema.optional<Schema.Unknown>;
     }>>>>;
     /** Auto-detect external packages from `package.json` dependency fields. */
     readonly autoDetectDependencies: Schema.optional<Schema.Struct<{
@@ -677,8 +639,6 @@ declare const PluginOptions: Schema.Struct<{
     readonly folderName: Schema.String;
     /** API item kinds included in this category. */
     readonly itemKinds: Schema.optional<Schema.mutable<Schema.$Array<Schema.declare<ApiItemKind, ApiItemKind>>>>;
-    /** TSDoc modifier tag that marks items for this category. */
-    readonly tsdocModifier: Schema.optional<Schema.String>;
     /** Whether the sidebar section is collapsible. Defaults to `true`. */
     readonly collapsible: Schema.withDecodingDefault<Schema.Boolean, never>;
     /** Whether the sidebar section starts collapsed. Defaults to `true`. */
@@ -710,7 +670,6 @@ declare const PluginOptions: Schema.Struct<{
       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>;
     }>>;
   }>>;
@@ -936,5 +895,5 @@ declare function resolveServeConfig(options?: ServeOptions): ResolvedServeConfig
  */
 declare function serve(options?: ServeOptions): Promise<void>;
 //#endregion
-export { ApiExtractorPlugin, type PluginOptions as ApiExtractorPluginOptions, type BaseRoute, type CategoryConfig, DEFAULT_CATEGORIES, type DirInfo, type FromDirOptions, type LoadedModel, type LogLevel, type MultiApiConfig, type OpenGraphImageConfig, type OpenGraphImageMetadata, type OpenGraphMetadata, type ResolvedServeConfig, type ServeMode, type ServeOptions, type SingleApiConfig, type SourceConfig, type VersionConfig, isServerReady, resolveServeConfig, serve };
+export { ApiExtractorPlugin, type PluginOptions as ApiExtractorPluginOptions, type BaseRoute, type CategoryConfig, DEFAULT_CATEGORIES, type DirInfo, type FromDirOptions, type LoadedModel, type MultiApiConfig, type OpenGraphImageConfig, type OpenGraphImageMetadata, type OpenGraphMetadata, type ResolvedServeConfig, type ServeMode, type ServeOptions, type SingleApiConfig, type SourceConfig, type VersionConfig, isServerReady, resolveServeConfig, serve };
 //# sourceMappingURL=index.d.ts.map

package/layers/build-metrics.js

@@ -81,8 +81,7 @@ const BuildMetrics = {
 	phaseTimeMs: Metric.counter("phase.time.ms"),
 	vfsFiles: Metric.counter("vfs.files"),
 	importsPrepended: Metric.counter("imports.prepended"),
-	twoslashDiagnostics: Metric.counter("twoslash.diagnostics"),
-	configDefaultsApplied: Metric.counter("config.defaults.applied")
+	twoslashDiagnostics: Metric.counter("twoslash.diagnostics")
 };
 
 //#endregion

package/layers/config-resolution.js

@@ -4,22 +4,22 @@ import { PluginEvent } from "../observability/events.js";
 import { emit, wantsLevel } from "../observability/EventBus.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 { CategoryResolver } from "../category-resolver.js";
 import { ConfigValidationError } from "../errors.js";
 import { loadApiModel, loadPackageJson, loadVersionModel } from "../model-loader.js";
+import { deriveOutputPaths } from "../path-derivation.js";
 import { DEFAULT_CATEGORIES } from "../schemas/config.js";
 import { PluginConfig } from "../services/PluginConfig.js";
 import { TypeRegistryService } from "../services/TypeRegistryService.js";
 import { emitVfsPayloadEvents, mergeApiResult } from "./api-results.js";
 import { mergeExternalTypes } from "./external-types.js";
 import { registerTypeEnvironments, resolveTsConfigTyped } from "./type-environment.js";
-import path from "node:path";
+import { apiScopeOf, normalizeBaseRoute, unscopedName } from "@tsdoctor/pages";
 import { Effect, Metric } from "effect";
+import { ApiExtractedPackage, TypeReferenceExtractor } from "@tsdoctor/model";
 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
@@ -261,7 +261,6 @@ const makeConfigService = Effect.gen(function* () {
 						...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
 						...siteUrl != null ? { siteUrl } : {},
 						...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-						docsDir: path.dirname(outputDir),
 						...docsRoot != null ? { docsRoot } : {},
 						...resolvedTheme != null ? { theme: resolvedTheme } : {}
 					}
@@ -343,7 +342,6 @@ const makeConfigService = Effect.gen(function* () {
 									...resolvedLlms != null ? { llmsPlugin: resolvedLlms } : {},
 									...siteUrl != null ? { siteUrl } : {},
 									...resolvedOgImage != null ? { ogImage: resolvedOgImage } : {},
-									docsDir: path.dirname(outputDir),
 									...docsRoot != null ? { docsRoot } : {},
 									...resolvedTheme != null ? { theme: resolvedTheme } : {}
 								}

package/layers/type-environment.js

@@ -2,10 +2,9 @@ import { PluginEvent } from "../observability/events.js";
 import { emit } from "../observability/EventBus.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 { resolveTypeScriptConfig, twoslashEnvHash } from "@tsdoctor/vfs";
 import ts from "typescript";
 
 //#region src/layers/type-environment.ts

package/llms-program.js

@@ -1,14 +1,14 @@
 import { PluginEvent } from "./observability/events.js";
 import { emit } from "./observability/EventBus.js";
-import { filterLlmsFullTxt, filterLlmsTxt, generatePackageLlmsFullTxt, generatePackageLlmsTxt, generateStructuredLlmsTxt, parseLlmsTxtLine } from "./llms-processing.js";
 import path from "node:path";
+import { filterLlmsFullTxt, filterLlmsTxt, generatePackageLlmsFullTxt, generatePackageLlmsTxt, generateStructuredLlmsTxt, parseLlmsTxtLine } from "@tsdoctor/pages";
 import { Effect, FileSystem } from "effect";
 
 //#region src/llms-program.ts
 /**
 * Effect program for post-processing LLMs text files in afterBuild.
 *
-* Wires the pure processing functions from llms-processing.ts into the
+* Wires the pure processing functions from @tsdoctor/pages into the
 * plugin lifecycle, handling file I/O via the core `effect` FileSystem service.
 *
 * Responsibilities:
@@ -89,7 +89,7 @@ function buildPackagePointers(buildResults, prefix, packageRoutes) {
 * Collect API page entries from the global llms.txt for a specific package.
 *
 * Parses the global llms.txt to find entries whose URLs match this package's
-* generated API routes, building the LlmsTxtEntry array for per-package files.
+* generated API routes, building the `LlmsTxtEntry` array for per-package files.
 */
 function collectApiEntries(globalLlmsTxtContent, result) {
 	const base = result.baseRoute.endsWith("/") ? result.baseRoute : `${result.baseRoute}/`;