jsdoczoom 0.4.15 → 0.4.17

package/dist/drilldown.js

@@ -335,12 +335,35 @@ export async function drilldown(
 				truncated,
 			};
 		}
-		// Single file path — errors are fatal, no barrel gating
+		// Single file path — errors are fatal
 		const filePath = files[0];
 		const content = await readFile(filePath, "utf-8");
 		const info = await processWithCache(config, "drilldown", content, () =>
 			parseFileSummaries(filePath),
 		);
+		// Barrel transition: when a barrel with a summary is targeted directly
+		// at depth >= 3, apply the same transition as the glob pipeline —
+		// barrel disappears and children appear at depth - 2.
+		if (isBarrel(filePath) && info.summary !== null) {
+			let barrelEffectiveDepth = depth;
+			if (barrelEffectiveDepth === 2 && info.description === null) {
+				barrelEffectiveDepth = 3;
+			}
+			if (barrelEffectiveDepth >= 3) {
+				const children = getBarrelChildren(filePath, cwd);
+				const childDepth = barrelEffectiveDepth - 2;
+				const results = await collectSafeResults(
+					children,
+					childDepth,
+					cwd,
+					config,
+				);
+				const sorted = results.sort((a, b) =>
+					sortKey(a).localeCompare(sortKey(b)),
+				);
+				return { items: sorted, truncated: false };
+			}
+		}
 		const effectiveDepth = computeEffectiveDepth(depth, info);
 		const typeDeclarations = await computeTypeDeclarationsIfNeeded(
 			content,

package/dist/jsdoc-parser.js

@@ -17,9 +17,9 @@ import { appendText, DESCRIPTION_TAGS } from "./types.js";
  * Returns the raw JSDoc text without the leading `/**` and trailing `*​/` delimiters,
  * or null if no file-level JSDoc is found.
  */
-export function extractFileJsdoc(sourceText) {
+export function extractFileJsdoc(sourceText, fileName = "input.tsx") {
 	const sourceFile = ts.createSourceFile(
-		"input.ts",
+		fileName,
 		sourceText,
 		ts.ScriptTarget.Latest,
 		true,
@@ -222,7 +222,7 @@ export function parseFileSummaries(filePath) {
 	} catch {
 		throw new JsdocError("FILE_NOT_FOUND", `File not found: ${filePath}`);
 	}
-	const jsdocText = extractFileJsdoc(sourceText);
+	const jsdocText = extractFileJsdoc(sourceText, filePath);
 	if (jsdocText === null) {
 		return {
 			path: filePath,

package/package.json

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

package/types/jsdoc-parser.d.ts

@@ -14,7 +14,10 @@ import { type ParsedFileInfo } from "./types.js";
  * Returns the raw JSDoc text without the leading `/**` and trailing `*​/` delimiters,
  * or null if no file-level JSDoc is found.
  */
-export declare function extractFileJsdoc(sourceText: string): string | null;
+export declare function extractFileJsdoc(
+	sourceText: string,
+	fileName?: string,
+): string | null;
 /**
  * Parse a TypeScript file and extract its summary and description from file-level JSDoc.
  *