rspress-plugin-api-extractor 0.6.0 → 0.6.2

package/build-stages.js

@@ -287,10 +287,10 @@ function generateSinglePage(workItem, ctx) {
 		}
 		if (!page) return null;
 		if (namespaceMember) {
-			const simpleName = item.displayName.toLowerCase();
 			const qualifiedNameLower = namespaceMember.qualifiedName.toLowerCase();
+			const lastSlash = page.routePath.lastIndexOf("/");
 			page = {
-				routePath: page.routePath.replace(`/${simpleName}`, `/${qualifiedNameLower}`),
+				routePath: `${page.routePath.slice(0, lastSlash + 1)}${qualifiedNameLower}`,
 				content: page.content
 			};
 		}
@@ -706,17 +706,21 @@ function cleanupAndCommit(input) {
 				level: "trace"
 			}));
 		}), { concurrency: "unbounded" });
-		if (orphanedFiles.length > 0) {
+		const removedFiles = [...staleFiles, ...orphanedFiles];
+		if (removedFiles.length > 0) {
 			const dirs = /* @__PURE__ */ new Set();
-			for (const orphan of orphanedFiles) {
-				const dir = path.dirname(orphan);
-				if (dir !== ".") dirs.add(dir);
+			for (const removed of removedFiles) {
+				let dir = path.dirname(removed.replace(/\\/g, "/"));
+				while (dir !== "." && dir !== "/" && !dirs.has(dir)) {
+					dirs.add(dir);
+					dir = path.dirname(dir);
+				}
 			}
 			const sortedDirs = [...dirs].sort((a, b) => b.split("/").length - a.split("/").length);
 			for (const dir of sortedDirs) {
 				const fullDir = path.join(resolvedOutputDir, dir);
 				if ((yield* fileSystem.readDirectory(fullDir).pipe(Effect.orElseSucceed(() => ["placeholder"]))).length === 0) {
-					yield* fileSystem.remove(fullDir).pipe(Effect.ignore);
+					yield* fileSystem.remove(fullDir, { recursive: true }).pipe(Effect.ignore);
 					yield* emit(PluginEvent.EmptyDirRemoved({
 						ctx: { buildId },
 						dir,

package/index.d.ts

@@ -378,9 +378,19 @@ declare const MultiApiConfig: Schema.Struct<{
     readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
     readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
   }>>;
-  /** Path to a `tsconfig.json` for Twoslash. */
+  /**
+   * Path to a `tsconfig.json` for Twoslash.
+   *
+   * @remarks
+   * Twoslash runs against a single shared TypeScript environment for the
+   * whole build, so per-API tsconfigs are not honored in multi-API mode:
+   * the first API that provides one wins and the rest are ignored (a
+   * `ConfigCascadeWarning` is emitted when they differ). Ensure the
+   * configured tsconfigs are equivalent, or set the intended one on the
+   * first API only.
+   */
   readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-  /** TypeScript compiler options for Twoslash. */
+  /** TypeScript compiler options for Twoslash. First API wins, as with `tsconfig`. */
   readonly compilerOptions: Schema.optional<Schema.Unknown>;
 }>;
 /** @public */
@@ -622,9 +632,19 @@ declare const PluginOptions: Schema.Struct<{
       readonly copyButtonText: Schema.withDecodingDefault<Schema.String, never>;
       readonly viewOptions: Schema.withDecodingDefault<Schema.mutable<Schema.$Array<Schema.Literals<readonly ["markdownLink", "chatgpt", "claude"]>>>, never>;
     }>>;
-    /** Path to a `tsconfig.json` for Twoslash. */
+    /**
+     * Path to a `tsconfig.json` for Twoslash.
+     *
+     * @remarks
+     * Twoslash runs against a single shared TypeScript environment for the
+     * whole build, so per-API tsconfigs are not honored in multi-API mode:
+     * the first API that provides one wins and the rest are ignored (a
+     * `ConfigCascadeWarning` is emitted when they differ). Ensure the
+     * configured tsconfigs are equivalent, or set the intended one on the
+     * first API only.
+     */
     readonly tsconfig: Schema.optional<Schema.declare<string | URL | ((...args: Array<unknown>) => unknown), string | URL | ((...args: Array<unknown>) => unknown)>>;
-    /** TypeScript compiler options for Twoslash. */
+    /** TypeScript compiler options for Twoslash. First API wins, as with `tsconfig`. */
     readonly compilerOptions: Schema.optional<Schema.Unknown>;
   }>>>>;
   /** Canonical site URL used for Open Graph absolute URLs. */

package/observability/sinks/console-sink.js

@@ -18,7 +18,7 @@ function render(event) {
 		case "BuildCompleted": return `API documentation complete (${(event.durationMs / 1e3).toFixed(2)}s)`;
 		case "BuildFailed": return `Error in ${event.phase}: ${event.error}`;
 		case "SlowOperation": return `slow ${event.operation}: ${event.durationMs}ms (>${event.threshold}ms)`;
-		case "ConfigCascadeWarning": return `${event.field}: using '${event.chosen}', ignoring ${event.ignored.join(", ")}`;
+		case "ConfigCascadeWarning": return event.ignored.length > 2 ? `${event.field}: using '${event.chosen}', ignoring ${event.ignored.length} alternatives (first configured value wins)` : `${event.field}: using '${event.chosen}', ignoring ${event.ignored.join(", ")}`;
 		case "ConfigValidationWarning": return `${event.field}: rejected '${event.value}'${event.reason ? ` — ${event.reason}` : ""}`;
 		case "DeprecatedConfigUsed": return `option '${event.key}' is deprecated; use ${event.replacement}`;
 		case "ModelLoaded": return `loaded model: ${event.itemCount} items, ${event.entryPoints} entry point(s) (${event.durationMs}ms)`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rspress-plugin-api-extractor",
-	"version": "0.6.0",
+	"version": "0.6.2",
 	"private": false,
 	"description": "RSPress plugin for generating API documentation from TypeScript API Extractor models",
 	"keywords": [
@@ -34,18 +34,18 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@effect/platform-node": "4.0.0-beta.98",
-		"@effect/sql-sqlite-node": "4.0.0-beta.98",
-		"@effected/semver": "^0.1.0",
-		"@effected/store": "^0.1.0",
-		"@effected/tsconfig-json": "^0.2.3",
-		"@effected/xdg": "^0.1.3",
-		"@microsoft/api-extractor-model": "^7.33.8",
+		"@effect/platform-node": "4.0.0-beta.99",
+		"@effect/sql-sqlite-node": "4.0.0-beta.99",
+		"@effected/semver": "^0.2.0",
+		"@effected/store": "^0.1.1",
+		"@effected/tsconfig-json": "^0.2.7",
+		"@effected/xdg": "^0.1.7",
+		"@microsoft/api-extractor-model": "^7.33.10",
 		"@shikijs/twoslash": "^4.3.1",
 		"@typescript/vfs": "^1.6.4",
 		"api-extractor-llms": "^0.2.0",
 		"clsx": "^2.1.1",
-		"effect": "4.0.0-beta.98",
+		"effect": "4.0.0-beta.99",
 		"gray-matter": "^4.0.3",
 		"hast-util-to-jsx-runtime": "^2.3.6",
 		"image-size": "^2.0.2",
@@ -56,7 +56,7 @@
 		"prettier": "^3.9.5",
 		"react-markdown": "^10.1.0",
 		"shiki": "^4.3.1",
-		"type-registry-effect": "^2.0.0",
+		"type-registry-effect": "^2.1.2",
 		"typescript": "^6.0.3",
 		"unist-util-visit": "^5.1.0"
 	},

package/schemas/config.js

@@ -269,9 +269,19 @@ const MultiApiConfig = Schema.Struct({
 	ogImage: Schema.optional(OpenGraphImageConfig),
 	/** LLMs integration options. */
 	llmsPlugin: Schema.optional(LlmsPlugin),
-	/** Path to a `tsconfig.json` for Twoslash. */
+	/**
+	* Path to a `tsconfig.json` for Twoslash.
+	*
+	* @remarks
+	* Twoslash runs against a single shared TypeScript environment for the
+	* whole build, so per-API tsconfigs are not honored in multi-API mode:
+	* the first API that provides one wins and the rest are ignored (a
+	* `ConfigCascadeWarning` is emitted when they differ). Ensure the
+	* configured tsconfigs are equivalent, or set the intended one on the
+	* first API only.
+	*/
 	tsconfig: Schema.optional(ModelInput),
-	/** TypeScript compiler options for Twoslash. */
+	/** TypeScript compiler options for Twoslash. First API wins, as with `tsconfig`. */
 	compilerOptions: Schema.optional(Schema.Unknown)
 });
 /**