rspress-plugin-api-extractor 0.8.8 → 0.9.0

package/route-collisions.js

@@ -1,44 +0,0 @@
-//#region src/route-collisions.ts
-/**
-* Group candidates by their final route (`${folder}/${baseName}`) and return the
-* groups with more than one distinct item. The route key is the lowercased path
-* the file is written to, so detection matches generation (and what a
-* case-insensitive filesystem would merge). Companion pairs (same name, different
-* folders) land under different keys and are never collisions.
-*
-* Output is deterministic: collisions ordered by route, items within a collision
-* ordered by canonicalReference.
-*/
-function detectRouteCollisions(candidates) {
-	const byKey = /* @__PURE__ */ new Map();
-	for (const candidate of candidates) {
-		const key = `${candidate.folder}/${candidate.baseName}`;
-		const group = byKey.get(key) ?? [];
-		group.push(candidate);
-		byKey.set(key, group);
-	}
-	const collisions = [];
-	for (const [route, group] of byKey) if (group.length > 1) {
-		const items = [...group].sort((a, b) => a.canonicalRef < b.canonicalRef ? -1 : a.canonicalRef > b.canonicalRef ? 1 : 0);
-		collisions.push({
-			route,
-			items
-		});
-	}
-	collisions.sort((a, b) => a.route < b.route ? -1 : a.route > b.route ? 1 : 0);
-	return collisions;
-}
-/** Build an actionable build-time error message for one or more route collisions. */
-function formatRouteCollisionError(collisions, baseRoute) {
-	const lines = [];
-	for (const collision of collisions) {
-		lines.push(`Route collision: ${collision.items.length} API items resolve to the same documentation path "${baseRoute}/${collision.route}":`);
-		for (const item of collision.items) lines.push(`  - ${item.displayName} (${item.kind})  [${item.canonicalRef}]`);
-	}
-	lines.push("");
-	lines.push("Item names must be unique per category folder. Paths are lowercased, so names differing only in case collide. Rename one of the items, or configure categories so they map to different folders.");
-	return `[rspress-plugin-api-extractor] ${lines.join("\n")}`;
-}
-
-//#endregion
-export { detectRouteCollisions, formatRouteCollisionError };

package/services/SnapshotService.js

@@ -1,7 +0,0 @@
-import { Context } from "effect";
-
-//#region src/services/SnapshotService.ts
-var SnapshotService = class extends Context.Service()("rspress-plugin-api-extractor/SnapshotService") {};
-
-//#endregion
-export { SnapshotService };

package/synthetic-bases.js

@@ -1,74 +0,0 @@
-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 };