rspress-plugin-api-extractor 0.3.8 → 0.5.0

package/README.md

@@ -49,6 +49,7 @@ The plugin reads your `.api.json` model and writes one MDX page per public API i
 - Generates API docs from `.api.json` models for classes, interfaces, functions, type aliases, enums, variables and namespaces.
 - Type-checks code examples and adds Twoslash hover tooltips that show inferred types.
 - Cross-links type references between pages, so a type named in a signature links to its own page.
+- Inlines compiler-generated base declarations (the `Foo_base` pattern from Effect `Schema.Class`, `Data.TaggedError` and mixin factories) in a "Base Class" section on the owning class page instead of documenting them as orphan variables.
 - Drives single-package sites, multi-package portals, RSPress multiVersion and i18n from one plugin.
 - Handles multi-entry-point packages: it deduplicates re-exports and notes which entry points each item is available from.
 - Writes per-package `llms*.txt` files and in-page actions for pointing an assistant at one package's docs.

package/build-stages.js

@@ -18,6 +18,7 @@ import { resolveEntryPoints } from "./multi-entry-resolver.js";
 import { OpenGraphResolver } from "./og-resolver.js";
 import { assertNoRouteCollisions } from "./route-collisions.js";
 import { SnapshotService } from "./services/SnapshotService.js";
+import { BASE_CLASS_ANCHOR, detectSyntheticBases } from "./synthetic-bases.js";
 import path from "node:path";
 import { Effect, Metric, Stream } from "effect";
 import { FileSystem } from "@effect/platform";
@@ -67,13 +68,15 @@ function sanitizeId(displayName) {
 function prepareWorkItems(input) {
 	const { apiPackage, categories, baseRoute } = input;
 	const resolvedItems = resolveEntryPoints(apiPackage);
+	const syntheticBases = detectSyntheticBases(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 resolvedItems) {
+	for (const resolved of docItems) {
 		const key = `${resolved.item.displayName}::${resolved.item.kind}`;
 		resolvedLookup.set(key, resolved);
 	}
-	const items = ApiParser.categorizeApiItems(resolvedItems, categories);
-	const namespaceMembers = ApiParser.extractNamespaceMembers(resolvedItems);
+	const items = ApiParser.categorizeApiItems(docItems, categories);
+	const namespaceMembers = ApiParser.extractNamespaceMembers(docItems);
 	const candidates = [];
 	for (const [categoryKey, categoryConfig] of Object.entries(categories)) for (const item of items[categoryKey] || []) candidates.push({
 		id: `${item.displayName}::${item.kind}`,
@@ -142,17 +145,28 @@ function prepareWorkItems(input) {
 			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}#${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);
 			workItems.push({
 				item,
 				categoryKey,
 				categoryConfig,
-				...resolved?.availableFrom != null ? { availableFrom: resolved.availableFrom } : {}
+				...resolved?.availableFrom != null ? { availableFrom: resolved.availableFrom } : {},
+				...syntheticBase != null ? { syntheticBase } : {}
 			});
 		}
 	}
@@ -197,7 +211,7 @@ function generateSinglePage(workItem, ctx) {
 		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));
+				page = yield* Effect.promise(() => generator.generate(item, baseRoute, packageName, categoryConfig.singularName, apiScope, apiName, source, suppressExampleErrors, llmsPlugin, workItem.availableFrom, workItem.syntheticBase));
 				page = {
 					routePath: page.routePath.replace("/class/", `/${categoryConfig.folderName}/`),
 					content: page.content

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

@@ -62,7 +62,7 @@ var ClassPageGenerator = class {
 	*
 	* @param apiScope - API scope identifier for VFS lookup
 	*/
-	async generate(apiClass, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom) {
+	async generate(apiClass, baseRoute, packageName, singularName, apiScope, apiName, sourceConfig, suppressExampleErrors, llmsPlugin, availableFrom, syntheticBase) {
 		const shouldSuppressErrors = suppressExampleErrors ?? true;
 		const name = apiClass.displayName;
 		const summary = ApiParser.getSummary(apiClass) || "No description available.";
@@ -95,6 +95,7 @@ var ClassPageGenerator = class {
 		const skeleton = this.generateClassSkeletonWithTwoslash(apiClass, packageName);
 		const displayCode = stripTwoslashDirectives(skeleton);
 		content += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(skeleton)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
+		content += this.generateBaseClassSection(apiClass, syntheticBase, packageName, apiScope);
 		const constructors = apiClass.members.filter((m) => m.kind === "Constructor");
 		if (constructors.length > 0) {
 			content += `## Constructors\n\n`;
@@ -214,6 +215,28 @@ var ClassPageGenerator = class {
 		};
 	}
 	/**
+	* Render the inline "Base Class" section for a synthetic base declaration
+	* (an unexported item referenced by the class's extends clause, e.g. the
+	* `Foo_base` variable TypeScript emits for `Schema.Class`-style patterns).
+	*
+	* The `## Base Class` heading slugs to `BASE_CLASS_ANCHOR` from
+	* `synthetic-bases.ts`, which is where the cross-link route for the base
+	* name points.
+	*/
+	generateBaseClassSection(apiClass, syntheticBase, packageName, apiScope) {
+		const baseDecl = syntheticBase;
+		if (!baseDecl?.excerpt?.text) return "";
+		let section = `## Base Class\n\n`;
+		section += `\`${apiClass.displayName}\` extends \`${baseDecl.displayName}\`, a compiler-generated declaration that is not exported from \`${packageName}\`.\n\n`;
+		const signature = this.typeFormatter.format(baseDecl.excerpt).trim();
+		let source = signature;
+		const apiPackage = apiClass.getAssociatedPackage?.();
+		if (apiPackage) source = prependHiddenImports(signature, new TypeReferenceExtractor(apiPackage, packageName).extractImportsForApiItem(baseDecl));
+		const displayCode = stripTwoslashDirectives(source);
+		section += `<ApiSignature code={${JSON.stringify(displayCode)}} source={${JSON.stringify(source)}} apiScope={${JSON.stringify(apiScope)}} />\n\n`;
+		return section;
+	}
+	/**
 	* Group class members by their type (static, instance, getters/setters)
 	*/
 	groupClassMembers(members) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.3.8",
+	"version": "0.5.0",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -14,7 +14,7 @@
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/spencerbeggs/rspress-plugin-api-extractor.git",
-		"directory": "plugin"
+		"directory": "package"
 	},
 	"license": "MIT",
 	"author": "Spencer Beggs",

package/runtime/components/EnumMembersTable/index.css

@@ -1,4 +1,4 @@
-.WkJdOG_table {
+._9sEZ2a_table {
   border: 1px solid var(--api-color-border);
   border-radius: 0 0 var(--api-border-radius) var(--api-border-radius);
   border-top: none;
@@ -7,16 +7,16 @@
   overflow: hidden;
 }
 
-html.WkJdOG_rp-dark .WkJdOG_table {
+html._9sEZ2a_rp-dark ._9sEZ2a_table {
   border-color: var(--api-color-border);
 }
 
-.WkJdOG_scroll {
+._9sEZ2a_scroll {
   -webkit-overflow-scrolling: touch;
   overflow-x: auto;
 }
 
-.WkJdOG_table table {
+._9sEZ2a_table table {
   border-collapse: collapse;
   width: 100%;
   font-size: var(--api-font-size-base);
@@ -25,12 +25,12 @@ html.WkJdOG_rp-dark .WkJdOG_table {
   margin: 0;
 }
 
-.WkJdOG_table thead {
+._9sEZ2a_table thead {
   background-color: var(--api-color-bg);
   border-bottom: 1px solid var(--api-color-border);
 }
 
-.WkJdOG_table th {
+._9sEZ2a_table th {
   padding: var(--api-spacing-md) var(--api-spacing-lg);
   text-align: left;
   color: var(--api-color-text);
@@ -38,62 +38,62 @@ html.WkJdOG_rp-dark .WkJdOG_table {
   font-weight: 600;
 }
 
-.WkJdOG_table th:first-child {
+._9sEZ2a_table th:first-child {
   width: 20%;
   min-width: 120px;
 }
 
-.WkJdOG_table th:nth-child(2) {
+._9sEZ2a_table th:nth-child(2) {
   width: 25%;
   min-width: 120px;
 }
 
-.WkJdOG_table th:last-child {
+._9sEZ2a_table th:last-child {
   width: 55%;
 }
 
-.WkJdOG_table td {
+._9sEZ2a_table td {
   padding: var(--api-spacing-md) var(--api-spacing-lg);
   border-top: 1px solid var(--api-color-border);
   vertical-align: top;
 }
 
-.WkJdOG_table td:first-child {
+._9sEZ2a_table td:first-child {
   width: 20%;
   min-width: 120px;
 }
 
-.WkJdOG_table td:nth-child(2) {
+._9sEZ2a_table td:nth-child(2) {
   width: 25%;
   min-width: 120px;
 }
 
-.WkJdOG_table td:last-child {
+._9sEZ2a_table td:last-child {
   width: 55%;
 }
 
-.WkJdOG_table td code, .WkJdOG_table th code {
+._9sEZ2a_table td code, ._9sEZ2a_table th code {
   font-size: var(--api-font-size-sm);
   background-color: var(--api-color-code-bg);
   border-radius: var(--api-border-radius-sm);
   padding: .125rem .375rem;
 }
 
-.WkJdOG_table td:last-child p:first-child {
+._9sEZ2a_table td:last-child p:first-child {
   margin-top: 0;
 }
 
-.WkJdOG_table td:last-child p:last-child, .WkJdOG_table td:last-child ul:last-child, .WkJdOG_table td:last-child ol:last-child {
+._9sEZ2a_table td:last-child p:last-child, ._9sEZ2a_table td:last-child ul:last-child, ._9sEZ2a_table td:last-child ol:last-child {
   margin-bottom: 0;
 }
 
 @media (width <= 768px) {
-  .WkJdOG_table td, .WkJdOG_table th {
+  ._9sEZ2a_table td, ._9sEZ2a_table th {
     padding: var(--api-spacing-sm) var(--api-spacing-md);
     font-size: var(--api-font-size-sm);
   }
 
-  .WkJdOG_table td:first-child, .WkJdOG_table th:first-child, .WkJdOG_table td:nth-child(2), .WkJdOG_table th:nth-child(2) {
+  ._9sEZ2a_table td:first-child, ._9sEZ2a_table th:first-child, ._9sEZ2a_table td:nth-child(2), ._9sEZ2a_table th:nth-child(2) {
     min-width: 100px;
   }
 }

package/runtime/components/EnumMembersTable/index.module.js

@@ -1,9 +1,9 @@
 import './index.css';
 //#region src/runtime/components/EnumMembersTable/index.module.css
 var index_module_default = {
-	"rpDark": "WkJdOG_rp-dark",
-	"scroll": "WkJdOG_scroll",
-	"table": "WkJdOG_table"
+	"rpDark": "_9sEZ2a_rp-dark",
+	"scroll": "_9sEZ2a_scroll",
+	"table": "_9sEZ2a_table"
 };
 
 //#endregion

package/runtime/components/ExampleBlock/index.css

@@ -1,4 +1,4 @@
-.PkJPlW_block {
+.L3GWXq_block {
   margin: var(--api-spacing-xl) 0;
   border-radius: var(--api-border-radius);
   border: 1px solid var(--api-color-border);
@@ -6,6 +6,6 @@
   overflow: visible;
 }
 
-html.PkJPlW_rp-dark .PkJPlW_block {
+html.L3GWXq_rp-dark .L3GWXq_block {
   border-color: var(--api-color-border);
 }

package/runtime/components/ExampleBlock/index.module.js

@@ -1,8 +1,8 @@
 import './index.css';
 //#region src/runtime/components/ExampleBlock/index.module.css
 var index_module_default = {
-	"block": "PkJPlW_block",
-	"rpDark": "PkJPlW_rp-dark"
+	"block": "L3GWXq_block",
+	"rpDark": "L3GWXq_rp-dark"
 };
 
 //#endregion

package/runtime/components/MemberSignature/index.css

@@ -1,4 +1,4 @@
-.gRiZQa_block {
+.sBksbq_block {
   margin: var(--api-spacing-xl) 0;
   border-radius: var(--api-border-radius);
   border: 1px solid var(--api-color-border);
@@ -6,21 +6,21 @@
   overflow: visible;
 }
 
-html.gRiZQa_rp-dark .gRiZQa_block {
+html.sBksbq_rp-dark .sBksbq_block {
   border-color: var(--api-color-border);
 }
 
-.gRiZQa_hasParameters {
+.sBksbq_hasParameters {
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
   margin-bottom: 0;
 }
 
-.gRiZQa_hasParameters .api-signature-code {
+.sBksbq_hasParameters .api-signature-code {
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
 }
 
-.gRiZQa_hasParameters .api-signature-code pre {
+.sBksbq_hasParameters .api-signature-code pre {
   border-radius: 0;
 }

package/runtime/components/MemberSignature/index.module.js

@@ -1,9 +1,9 @@
 import './index.css';
 //#region src/runtime/components/MemberSignature/index.module.css
 var index_module_default = {
-	"block": "gRiZQa_block",
-	"hasParameters": "gRiZQa_hasParameters",
-	"rpDark": "gRiZQa_rp-dark"
+	"block": "sBksbq_block",
+	"hasParameters": "sBksbq_hasParameters",
+	"rpDark": "sBksbq_rp-dark"
 };
 
 //#endregion

package/runtime/components/ParametersTable/index.css

@@ -1,4 +1,4 @@
-.NDYkiG_table {
+.qRA0fW_table {
   border: 1px solid var(--api-color-border);
   border-radius: 0 0 var(--api-border-radius) var(--api-border-radius);
   border-top: none;
@@ -7,16 +7,16 @@
   overflow: hidden;
 }
 
-html.NDYkiG_rp-dark .NDYkiG_table {
+html.qRA0fW_rp-dark .qRA0fW_table {
   border-color: var(--api-color-border);
 }
 
-.NDYkiG_scroll {
+.qRA0fW_scroll {
   -webkit-overflow-scrolling: touch;
   overflow-x: auto;
 }
 
-.NDYkiG_table table {
+.qRA0fW_table table {
   border-collapse: collapse;
   width: 100%;
   font-size: var(--api-font-size-base);
@@ -25,12 +25,12 @@ html.NDYkiG_rp-dark .NDYkiG_table {
   margin: 0;
 }
 
-.NDYkiG_table thead {
+.qRA0fW_table thead {
   background-color: var(--api-color-bg);
   border-bottom: 1px solid var(--api-color-border);
 }
 
-.NDYkiG_table th {
+.qRA0fW_table th {
   padding: var(--api-spacing-md) var(--api-spacing-lg);
   text-align: left;
   color: var(--api-color-text);
@@ -38,66 +38,66 @@ html.NDYkiG_rp-dark .NDYkiG_table {
   font-weight: 600;
 }
 
-.NDYkiG_table th:first-child {
+.qRA0fW_table th:first-child {
   width: 20%;
   min-width: 120px;
 }
 
-.NDYkiG_table th:nth-child(2) {
+.qRA0fW_table th:nth-child(2) {
   width: 30%;
   min-width: 150px;
 }
 
-.NDYkiG_table th:last-child {
+.qRA0fW_table th:last-child {
   width: 50%;
 }
 
-.NDYkiG_table td {
+.qRA0fW_table td {
   padding: var(--api-spacing-md) var(--api-spacing-lg);
   border-top: 1px solid var(--api-color-border);
   vertical-align: top;
 }
 
-.NDYkiG_table td:first-child {
+.qRA0fW_table td:first-child {
   width: 20%;
   min-width: 120px;
 }
 
-.NDYkiG_table td:nth-child(2) {
+.qRA0fW_table td:nth-child(2) {
   width: 30%;
   min-width: 150px;
 }
 
-.NDYkiG_table td:last-child {
+.qRA0fW_table td:last-child {
   width: 50%;
 }
 
-.NDYkiG_table td code, .NDYkiG_table th code {
+.qRA0fW_table td code, .qRA0fW_table th code {
   font-size: var(--api-font-size-sm);
   background-color: var(--api-color-code-bg);
   border-radius: var(--api-border-radius-sm);
   padding: .125rem .375rem;
 }
 
-.NDYkiG_table td:last-child p:first-child {
+.qRA0fW_table td:last-child p:first-child {
   margin-top: 0;
 }
 
-.NDYkiG_table td:last-child p:last-child, .NDYkiG_table td:last-child ul:last-child, .NDYkiG_table td:last-child ol:last-child {
+.qRA0fW_table td:last-child p:last-child, .qRA0fW_table td:last-child ul:last-child, .qRA0fW_table td:last-child ol:last-child {
   margin-bottom: 0;
 }
 
 @media (width <= 768px) {
-  .NDYkiG_table td, .NDYkiG_table th {
+  .qRA0fW_table td, .qRA0fW_table th {
     padding: var(--api-spacing-sm) var(--api-spacing-md);
     font-size: var(--api-font-size-sm);
   }
 
-  .NDYkiG_table td:first-child, .NDYkiG_table th:first-child {
+  .qRA0fW_table td:first-child, .qRA0fW_table th:first-child {
     min-width: 100px;
   }
 
-  .NDYkiG_table td:nth-child(2), .NDYkiG_table th:nth-child(2) {
+  .qRA0fW_table td:nth-child(2), .qRA0fW_table th:nth-child(2) {
     min-width: 120px;
   }
 }

package/runtime/components/ParametersTable/index.module.js

@@ -1,9 +1,9 @@
 import './index.css';
 //#region src/runtime/components/ParametersTable/index.module.css
 var index_module_default = {
-	"rpDark": "NDYkiG_rp-dark",
-	"scroll": "NDYkiG_scroll",
-	"table": "NDYkiG_table"
+	"rpDark": "qRA0fW_rp-dark",
+	"scroll": "qRA0fW_scroll",
+	"table": "qRA0fW_table"
 };
 
 //#endregion

package/runtime/components/SignatureBlock/index.css

@@ -1,4 +1,4 @@
-.L_PAPG_block {
+.PJvwTW_block {
   margin: var(--api-spacing-xl) 0;
   border-radius: var(--api-border-radius);
   border: 1px solid var(--api-color-border);
@@ -6,21 +6,21 @@
   overflow: visible;
 }
 
-html.L_PAPG_rp-dark .L_PAPG_block {
+html.PJvwTW_rp-dark .PJvwTW_block {
   border-color: var(--api-color-border);
 }
 
-.L_PAPG_hasParameters {
+.PJvwTW_hasParameters {
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
   margin-bottom: 0;
 }
 
-.L_PAPG_hasParameters .api-signature-code {
+.PJvwTW_hasParameters .api-signature-code {
   border-bottom-right-radius: 0;
   border-bottom-left-radius: 0;
 }
 
-.L_PAPG_hasParameters .api-signature-code pre {
+.PJvwTW_hasParameters .api-signature-code pre {
   border-radius: 0;
 }

package/runtime/components/SignatureBlock/index.module.js

@@ -1,9 +1,9 @@
 import './index.css';
 //#region src/runtime/components/SignatureBlock/index.module.css
 var index_module_default = {
-	"block": "L_PAPG_block",
-	"hasParameters": "L_PAPG_hasParameters",
-	"rpDark": "L_PAPG_rp-dark"
+	"block": "PJvwTW_block",
+	"hasParameters": "PJvwTW_hasParameters",
+	"rpDark": "PJvwTW_rp-dark"
 };
 
 //#endregion

package/runtime/components/SignatureCode/index.css

@@ -1,11 +1,11 @@
-.Ze8uHG_code {
+._5P8n3G_code {
   border-bottom-left-radius: var(--api-border-radius);
   border-bottom-right-radius: var(--api-border-radius);
   position: relative;
   container-type: inline-size;
 }
 
-.Ze8uHG_code pre {
+._5P8n3G_code pre {
   height: auto;
   max-height: none;
   padding: var(--api-spacing-lg);
@@ -15,11 +15,11 @@
   overflow-x: auto;
 }
 
-html.Ze8uHG_rp-dark .Ze8uHG_code pre {
+html._5P8n3G_rp-dark ._5P8n3G_code pre {
   background-color: var(--shiki-dark-bg);
 }
 
-.Ze8uHG_code code {
+._5P8n3G_code code {
   background-color: unset;
   min-height: var(--api-font-size-md);
   line-height: var(--api-line-height-base);
@@ -28,25 +28,25 @@ html.Ze8uHG_rp-dark .Ze8uHG_code pre {
   display: flex;
 }
 
-.Ze8uHG_code code span {
+._5P8n3G_code code span {
   color: var(--shiki-light);
 }
 
-html.Ze8uHG_rp-dark .Ze8uHG_code code span {
+html._5P8n3G_rp-dark ._5P8n3G_code code span {
   color: var(--shiki-dark);
 }
 
-.Ze8uHG_code .line {
+._5P8n3G_code .line {
   background: none;
   min-height: 1lh;
 }
 
-.Ze8uHG_wrapped pre {
+._5P8n3G_wrapped pre {
   white-space: pre-wrap;
   overflow-wrap: break-word;
 }
 
-.Ze8uHG_wrapped code {
+._5P8n3G_wrapped code {
   white-space: pre-wrap;
   overflow-wrap: break-word;
 }

package/runtime/components/SignatureCode/index.module.js

@@ -1,9 +1,9 @@
 import './index.css';
 //#region src/runtime/components/SignatureCode/index.module.css
 var index_module_default = {
-	"code": "Ze8uHG_code",
-	"rpDark": "Ze8uHG_rp-dark",
-	"wrapped": "Ze8uHG_wrapped"
+	"code": "_5P8n3G_code",
+	"rpDark": "_5P8n3G_rp-dark",
+	"wrapped": "_5P8n3G_wrapped"
 };
 
 //#endregion

package/runtime/components/SignatureToolbar/index.css

@@ -1,4 +1,4 @@
-.HQ_pKG_toolbar {
+.pmgBdW_toolbar {
   justify-content: flex-end;
   align-items: flex-end;
   gap: var(--api-spacing-sm);
@@ -9,16 +9,16 @@
   display: flex;
 }
 
-html.HQ_pKG_rp-dark .HQ_pKG_toolbar {
+html.pmgBdW_rp-dark .pmgBdW_toolbar {
   background-color: var(--api-color-bg);
   border-bottom-color: var(--api-color-border);
 }
 
-.HQ_pKG_toolbar:has(.HQ_pKG_memberHeading) {
+.pmgBdW_toolbar:has(.pmgBdW_memberHeading) {
   justify-content: space-between;
 }
 
-.HQ_pKG_toolbar h2, .HQ_pKG_toolbar h3 {
+.pmgBdW_toolbar h2, .pmgBdW_toolbar h3 {
   font-size: var(--api-font-size-lg);
   padding-left: var(--api-spacing-sm);
   font-family: var(--rp-font-family-mono);
@@ -26,14 +26,14 @@ html.HQ_pKG_rp-dark .HQ_pKG_toolbar {
   margin-bottom: 0;
 }
 
-.HQ_pKG_toolbarLeft {
+.pmgBdW_toolbarLeft {
   gap: var(--api-spacing-sm);
   flex-direction: column;
   flex: 1;
   display: flex;
 }
 
-.HQ_pKG_memberHeading {
+.pmgBdW_memberHeading {
   font-size: var(--api-font-size-md);
   color: var(--api-color-text);
   height: auto;
@@ -45,11 +45,11 @@ html.HQ_pKG_rp-dark .HQ_pKG_toolbar {
   overflow: visible;
 }
 
-html.HQ_pKG_rp-dark .HQ_pKG_memberHeading {
+html.pmgBdW_rp-dark .pmgBdW_memberHeading {
   color: var(--api-color-text);
 }
 
-.HQ_pKG_memberHeading .rp-header-anchor {
+.pmgBdW_memberHeading .rp-header-anchor {
   opacity: 0;
   font-weight: 500;
   font-size: inherit;
@@ -60,16 +60,16 @@ html.HQ_pKG_rp-dark .HQ_pKG_memberHeading {
   left: -1.2rem;
 }
 
-.HQ_pKG_memberHeading:hover .rp-header-anchor {
+.pmgBdW_memberHeading:hover .rp-header-anchor {
   opacity: .85;
 }
 
-.HQ_pKG_memberHeading .rp-header-anchor:hover {
+.pmgBdW_memberHeading .rp-header-anchor:hover {
   border-bottom: 1px solid var(--rp-c-brand);
   opacity: .85;
 }
 
-.HQ_pKG_memberHeadingH2 {
+.pmgBdW_memberHeadingH2 {
   font-size: var(--api-font-size-lg);
   text-transform: lowercase;
   border-top: none;
@@ -80,19 +80,19 @@ html.HQ_pKG_rp-dark .HQ_pKG_memberHeading {
   line-height: 2rem;
 }
 
-.HQ_pKG_memberHeadingH2:before, .HQ_pKG_memberHeadingH2:after {
+.pmgBdW_memberHeadingH2:before, .pmgBdW_memberHeadingH2:after {
   content: none;
   margin: 0;
   padding: 0;
   display: none;
 }
 
-.HQ_pKG_memberHeadingH2 .rp-header-anchor {
+.pmgBdW_memberHeadingH2 .rp-header-anchor {
   font-size: var(--api-font-size-lg);
   left: -1.5rem;
 }
 
-.HQ_pKG_summary {
+.pmgBdW_summary {
   padding: 0;
   padding-left: var(--api-spacing-sm);
   font-size: var(--api-font-size-md);
@@ -102,21 +102,21 @@ html.HQ_pKG_rp-dark .HQ_pKG_memberHeading {
   border: none;
 }
 
-html.HQ_pKG_rp-dark .HQ_pKG_summary {
+html.pmgBdW_rp-dark .pmgBdW_summary {
   color: var(--api-color-text-secondary);
   background-color: #0000;
   border: none;
 }
 
-.HQ_pKG_summary p:first-child {
+.pmgBdW_summary p:first-child {
   margin-top: 0;
 }
 
-.HQ_pKG_summary p:last-child, .HQ_pKG_summary ul:last-child, .HQ_pKG_summary ol:last-child {
+.pmgBdW_summary p:last-child, .pmgBdW_summary ul:last-child, .pmgBdW_summary ol:last-child {
   margin-bottom: 0;
 }
 
-.HQ_pKG_buttons {
+.pmgBdW_buttons {
   gap: var(--api-spacing-sm);
   display: flex;
 }

package/runtime/components/SignatureToolbar/index.module.js

@@ -1,13 +1,13 @@
 import './index.css';
 //#region src/runtime/components/SignatureToolbar/index.module.css
 var index_module_default = {
-	"buttons": "HQ_pKG_buttons",
-	"memberHeading": "HQ_pKG_memberHeading",
-	"memberHeadingH2": "HQ_pKG_memberHeadingH2",
-	"rpDark": "HQ_pKG_rp-dark",
-	"summary": "HQ_pKG_summary",
-	"toolbar": "HQ_pKG_toolbar",
-	"toolbarLeft": "HQ_pKG_toolbarLeft"
+	"buttons": "pmgBdW_buttons",
+	"memberHeading": "pmgBdW_memberHeading",
+	"memberHeadingH2": "pmgBdW_memberHeadingH2",
+	"rpDark": "pmgBdW_rp-dark",
+	"summary": "pmgBdW_summary",
+	"toolbar": "pmgBdW_toolbar",
+	"toolbarLeft": "pmgBdW_toolbarLeft"
 };
 
 //#endregion

package/runtime/components/buttons/index.css

@@ -1,9 +1,9 @@
-.Fw3JAa_buttonGroup {
+.yqpEWq_buttonGroup {
   gap: var(--api-spacing-sm);
   display: flex;
 }
 
-.Fw3JAa_button {
+.yqpEWq_button {
   align-items: center;
   gap: var(--api-spacing-xs);
   padding: var(--api-spacing-xs) var(--api-spacing-md);
@@ -19,17 +19,17 @@
   display: inline-flex;
 }
 
-.Fw3JAa_button:hover {
+.yqpEWq_button:hover {
   background-color: var(--api-color-hover-bg);
   border-color: var(--api-color-border-hover);
 }
 
-.Fw3JAa_button:active {
+.yqpEWq_button:active {
   background-color: var(--api-color-active-bg);
   transform: scale(.98);
 }
 
-.Fw3JAa_button svg {
+.yqpEWq_button svg {
   flex-shrink: 0;
   width: 16px;
   height: 16px;

package/runtime/components/buttons/index.module.js

@@ -1,8 +1,8 @@
 import './index.css';
 //#region src/runtime/components/buttons/index.module.css
 var index_module_default = {
-	"button": "Fw3JAa_button",
-	"buttonGroup": "Fw3JAa_buttonGroup"
+	"button": "yqpEWq_button",
+	"buttonGroup": "yqpEWq_buttonGroup"
 };
 
 //#endregion

package/synthetic-bases.js

@@ -0,0 +1,74 @@
+import { ApiExportedMixin, ApiItemKind, ExcerptTokenKind } from "@microsoft/api-extractor-model";
+
+//#region src/synthetic-bases.ts
+/**
+* Anchor id of the inline "Base Class" section rendered on the owner class
+* page. Must match the slug RSPress derives from the `## Base Class` heading
+* emitted by ClassPageGenerator.
+*/
+const BASE_CLASS_ANCHOR = "base-class";
+const EMPTY_DETECTION = {
+	bases: /* @__PURE__ */ new Map(),
+	baseByOwner: /* @__PURE__ */ new Map()
+};
+/**
+* Strip the trailing meaning (`:class`, `:var`, `:function(1)`, ...) from a
+* canonical reference string so the reference token in an extends clause
+* (`example!~Person_base`) matches the declaration's canonical reference
+* (`example!~Person_base:var`).
+*/
+function stripMeaning(canonicalRef) {
+	return canonicalRef.replace(/:[a-z]+(\(\d+\))?$/i, "");
+}
+/** True when the item carries ApiExportedMixin and is NOT exported from its entry point. */
+function isUnexported(item) {
+	return ApiExportedMixin.isBaseClassOf(item) && !item.isExported;
+}
+/**
+* Detect synthetic base declarations among top-level API items.
+*
+* An item qualifies when it is unexported (hoisted into the model only because
+* something references it) AND at least one class's extends clause references
+* its canonical symbol. Unexported items with no class referencing them
+* (genuine forgotten exports) are left alone, as are extends references whose
+* target is absent from the model.
+*/
+function detectSyntheticBases(items) {
+	const unexportedByRef = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		if (!isUnexported(item)) continue;
+		const ref = item.canonicalReference?.toString();
+		if (ref) unexportedByRef.set(stripMeaning(ref), item);
+	}
+	if (unexportedByRef.size === 0) return EMPTY_DETECTION;
+	const owners = /* @__PURE__ */ new Map();
+	const baseByOwner = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		if (item.kind !== ApiItemKind.Class) continue;
+		const apiClass = item;
+		const extendsType = apiClass.extendsType;
+		if (!extendsType) continue;
+		for (const token of extendsType.excerpt.spannedTokens) {
+			if (token.kind !== ExcerptTokenKind.Reference || !token.canonicalReference) continue;
+			const base = unexportedByRef.get(stripMeaning(token.canonicalReference.toString()));
+			if (!base || base === item || baseByOwner.has(item)) continue;
+			baseByOwner.set(item, base);
+			const ownerList = owners.get(base);
+			if (ownerList) ownerList.push(apiClass);
+			else owners.set(base, [apiClass]);
+		}
+	}
+	if (owners.size === 0) return EMPTY_DETECTION;
+	const bases = /* @__PURE__ */ new Map();
+	for (const [baseItem, ownerClasses] of owners) bases.set(baseItem, {
+		baseItem,
+		ownerClasses
+	});
+	return {
+		bases,
+		baseByOwner
+	};
+}
+
+//#endregion
+export { BASE_CLASS_ANCHOR, detectSyntheticBases };