jsdoczoom 1.2.2 → 1.2.3

package/dist/drilldown.js

@@ -6,7 +6,10 @@ import { debugDrilldown } from "./debug.js";
 import { JsdocError } from "./errors.js";
 import { discoverFiles, loadGitignore } from "./file-discovery.js";
 import { parseFileSummaries } from "./jsdoc-parser.js";
-import { generateTypeDeclarations } from "./type-declarations.js";
+import {
+	generateTypeDeclarations,
+	splitDeclarations,
+} from "./type-declarations.js";
 import { DEFAULT_CACHE_DIR } from "./types.js";
 
 /** Terminal level (1-indexed): 1=summary, 2=description, 3=type declarations, 4=full file. */
@@ -28,16 +31,31 @@ const DEFAULT_CACHE_CONFIG = {
  * Type declarations and file content are pre-computed and passed in to support
  * async cache integration.
  */
+/**
+ * Build the text for level 3 (type declarations).
+ * Description is rendered as plain markdown prose; declaration blocks
+ * (those starting with a `// L` annotation) are each wrapped in a
+ * typescript code fence. The module-level chunk (JSDoc + imports) is dropped.
+ */
+function buildLevel3Text(description, typeDeclarations) {
+	const parts = [];
+	if (description !== null) parts.push(description);
+	if (typeDeclarations.length > 0) {
+		const fenced = splitDeclarations(typeDeclarations)
+			.filter((chunk) => chunk.startsWith("// L"))
+			.map((chunk) => `\`\`\`typescript\n${chunk}\n\`\`\``)
+			.join("\n\n");
+		if (fenced) parts.push(fenced);
+	}
+	return parts.join("\n\n");
+}
 function buildLevels(info, typeDeclarations, fileContent) {
 	const { summary, description } = info;
 	return [
 		summary !== null ? { text: summary } : null,
 		description !== null ? { text: description } : null,
 		{
-			text:
-				typeDeclarations.length > 0
-					? `\`\`\`typescript\n${typeDeclarations}\n\`\`\``
-					: typeDeclarations,
+			text: buildLevel3Text(description, typeDeclarations),
 		},
 		{ text: `\`\`\`typescript\n${fileContent}\n\`\`\`` },
 	];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jsdoczoom",
-	"version": "1.2.2",
+	"version": "1.2.3",
 	"description": "CLI tool for extracting JSDoc summaries at configurable depths",
 	"type": "module",
 	"sideEffects": false,

package/types/debug.d.ts

@@ -8,17 +8,17 @@
  *
  * @summary Namespaced debug loggers and perf_hooks timing helper
  */
-import createDebug from "debug";
 import type { Debugger } from "debug";
-export declare const debugDiscovery: createDebug.Debugger;
-export declare const debugSearch: createDebug.Debugger;
-export declare const debugCache: createDebug.Debugger;
-export declare const debugEslint: createDebug.Debugger;
-export declare const debugLint: createDebug.Debugger;
-export declare const debugValidate: createDebug.Debugger;
-export declare const debugBarrel: createDebug.Debugger;
-export declare const debugDrilldown: createDebug.Debugger;
-export declare const debugTs: createDebug.Debugger;
+import createDebug from "debug";
+export declare const debugDiscovery: Debugger;
+export declare const debugSearch: Debugger;
+export declare const debugCache: Debugger;
+export declare const debugEslint: Debugger;
+export declare const debugLint: Debugger;
+export declare const debugValidate: Debugger;
+export declare const debugBarrel: Debugger;
+export declare const debugDrilldown: Debugger;
+export declare const debugTs: Debugger;
 export { createDebug };
 /** Record a cache hit without emitting a log line. */
 export declare function recordCacheHit(): void;