@happyvertical/smrt-scanner 0.55.6 → 0.55.7

package/dist/chunks/{scanner-CeTWAIar.js → scanner-CcSYWHNX.js}

@@ -2306,13 +2306,13 @@ function reportUnresolvedSpreads(unresolved, filePath, sourceText, errors) {
 		});
 	}
 }
-function extractClassFromNode(node, filePath, sourceText, importAliases, ctx) {
-	if (node.type === "ExportNamedDeclaration" && node.declaration) return extractClassFromNode(node.declaration, filePath, sourceText, importAliases, ctx);
-	if (node.type === "ExportDefaultDeclaration" && node.declaration) return extractClassFromNode(node.declaration, filePath, sourceText, importAliases, ctx);
-	if (node.type === "ClassDeclaration") return extractClassDeclaration(node, filePath, sourceText, importAliases, ctx);
+function extractClassFromNode(node, filePath, sourceText, importAliases, ctx, outerStart) {
+	if (node.type === "ExportNamedDeclaration" && node.declaration) return extractClassFromNode(node.declaration, filePath, sourceText, importAliases, ctx, node.start ?? outerStart);
+	if (node.type === "ExportDefaultDeclaration" && node.declaration) return extractClassFromNode(node.declaration, filePath, sourceText, importAliases, ctx, node.start ?? outerStart);
+	if (node.type === "ClassDeclaration") return extractClassDeclaration(node, filePath, sourceText, importAliases, ctx, outerStart);
 	return null;
 }
-function extractClassDeclaration(node, filePath, sourceText, importAliases, ctx) {
+function extractClassDeclaration(node, filePath, sourceText, importAliases, ctx, outerStart) {
 	const className = node.id?.name || "AnonymousClass";
 	const decorators = node.decorators || [];
 	const smrtDecorator = decorators.find((d) => isSmrtDecorator(d, importAliases));
@@ -2338,6 +2338,11 @@ function extractClassDeclaration(node, filePath, sourceText, importAliases, ctx)
 		const method = extractMethodDefinition(member, sourceText, ctx);
 		if (method) methods.push(method);
 	}
+	const description = (typeof smrtConfig?.description === "string" ? normalizeModelDescription(smrtConfig.description) : void 0) ?? extractClassJsDocDescription(sourceText, className, [
+		node.start,
+		outerStart,
+		...decorators.map((d) => d.start)
+	].filter((n) => typeof n === "number"));
 	return {
 		className,
 		filePath,
@@ -2345,6 +2350,7 @@ function extractClassDeclaration(node, filePath, sourceText, importAliases, ctx)
 		extendsTypeArg,
 		decoratorConfig,
 		hasSmartDecorator,
+		...description ? { description } : {},
 		fields,
 		methods,
 		startLine: node.loc?.start.line || 1,
@@ -2352,6 +2358,59 @@ function extractClassDeclaration(node, filePath, sourceText, importAliases, ctx)
 		...typeof node.body?.start === "number" ? { bodyStart: node.body.start } : {}
 	};
 }
+var MODEL_DESCRIPTION_MAX = 200;
+function normalizeModelDescription(raw) {
+	const text = raw.replace(/\s+/g, " ").trim();
+	if (!text) return void 0;
+	if (text.length <= MODEL_DESCRIPTION_MAX) return text;
+	const head = text.slice(0, MODEL_DESCRIPTION_MAX);
+	const sentenceEnd = Math.max(head.lastIndexOf(". "), head.lastIndexOf("! "), head.lastIndexOf("? "));
+	if (sentenceEnd > 0) return head.slice(0, sentenceEnd + 1);
+	const wordEnd = head.lastIndexOf(" ");
+	return `${(wordEnd > 0 ? head.slice(0, wordEnd) : head).replace(/[,;:\s]+$/, "")}\u2026`;
+}
+function extractClassJsDocDescription(sourceText, className, anchors) {
+	if (anchors.length === 0) return void 0;
+	const before = sourceText.slice(0, Math.min(...anchors)).trimEnd();
+	if (!before.endsWith("*/")) return void 0;
+	const open = before.lastIndexOf("/**");
+	if (open < 0 || before.indexOf("*/", open) !== before.length - 2) return;
+	return summarizeJsDoc(before.slice(open, before.length), className);
+}
+function summarizeJsDoc(block, className) {
+	const lines = block.replace(/^\/\*\*/, "").replace(/\*\/$/, "").split("\n").map((line) => line.replace(/^\s*\*\s?/, "").trimEnd());
+	const summary = [];
+	let internal = false;
+	let inFence = false;
+	for (const line of lines) {
+		if (/^\s*@internal\b/.test(line)) internal = true;
+		if (/^\s*```/.test(line)) {
+			inFence = !inFence;
+			continue;
+		}
+		if (inFence) continue;
+		if (/^\s*@\w+/.test(line)) {
+			summary.push("\0");
+			continue;
+		}
+		summary.push(line);
+	}
+	if (internal) return void 0;
+	const paragraph = [];
+	for (const line of summary) {
+		if (line === "\0") break;
+		if (line.trim() === "") {
+			if (paragraph.length > 0) break;
+			continue;
+		}
+		paragraph.push(line.trim());
+	}
+	let text = paragraph.join(" ");
+	const escaped = className.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	text = text.replace(new RegExp(`^${escaped}\\s*(?:[-\u2013\u2014:]+)\\s*`), "").replace(/\{@(?:link|linkcode|linkplain)\s+([^}|\s]+)(?:[|\s]+([^}]*))?\}/g, (_m, target, label) => label?.trim() ? label.trim() : target).replace(/\{@\w+\s*([^}]*)\}/g, "$1").replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").replace(/`([^`]*)`/g, "$1").replace(/<\/?[a-zA-Z][^>]*>/g, "").replace(/(\*\*|__)(.+?)\1/g, "$2");
+	if (text.length > 0) text = text[0].toUpperCase() + text.slice(1);
+	return normalizeModelDescription(text);
+}
 function isSmrtDecorator(decorator, importAliases) {
 	return isNamedDecorator(decorator, "smrt", importAliases);
 }
@@ -3031,6 +3090,7 @@ var ManifestAdapter = class ManifestAdapter {
 			className: classDef.className,
 			qualifiedName,
 			collection,
+			...classDef.description ? { description: classDef.description } : {},
 			filePath: classDef.filePath,
 			packageName: packageName || void 0,
 			fields,
@@ -4138,4 +4198,4 @@ var OxcScanner = class {
 //#endregion
 export { mergeAgentSurfaces as C, isPrunedAgentSurfacePath as S, sourceMayDeclareAgentSurface as T, relativeGlobToCwd as _, parseAgentSurfaceFile as a, extractAgentSurface as b, parseSource as c, resolveRecipes as d, sourceMayDeclareRecipe as f, normalizeGlobSeparators as g, discoverSourceFiles as h, extractSmrtImports as i, deriveHelpFieldRefs as l, resolveEnumValues as m, parseUiSelectorsFile as n, parseFile as o, InheritanceResolver as p, ManifestAdapter as r, parseRecipeFile as s, OxcScanner as t, extractRecipes as u, checkAgentSurfaceToolNames as v, scanSvelteAgentSurface as w, isAgentSurfaceSourcePath as x, emptyAgentSurface as y };
 
-//# sourceMappingURL=scanner-CeTWAIar.js.map
+//# sourceMappingURL=scanner-CcSYWHNX.js.map