jsdoczoom 0.4.12 → 0.4.15

package/dist/drilldown.js

@@ -389,12 +389,15 @@ export async function drilldownFiles(
 ) {
 	const d = depth ?? 1;
 	const ig = loadGitignore(cwd);
-	const tsFiles = filePaths.filter(
-		(f) =>
-			(f.endsWith(".ts") || f.endsWith(".tsx")) &&
-			!f.endsWith(".d.ts") &&
-			!ig.ignores(relative(cwd, f)),
-	);
+	const tsFiles = filePaths.filter((f) => {
+		if (!(f.endsWith(".ts") || f.endsWith(".tsx")) || f.endsWith(".d.ts")) {
+			return false;
+		}
+		const rel = relative(cwd, f);
+		// Files outside cwd (traversal paths) are beyond the gitignore scope
+		if (rel.startsWith("..")) return true;
+		return !ig.ignores(rel);
+	});
 	const results = await collectSafeResults(tsFiles, d, cwd, config);
 	const sorted = results.sort((a, b) => sortKey(a).localeCompare(sortKey(b)));
 	const total = sorted.length;

package/dist/jsdoc-parser.js

@@ -33,9 +33,11 @@ export function extractFileJsdoc(sourceText) {
 		);
 	}
 	// Find the first non-import top-level statement
+	let firstImport;
 	let firstNonImportStatement;
 	for (const statement of sourceFile.statements) {
 		if (ts.isImportDeclaration(statement)) {
+			firstImport ??= statement;
 			continue;
 		}
 		firstNonImportStatement = statement;
@@ -45,7 +47,24 @@ export function extractFileJsdoc(sourceText) {
 	if (firstNonImportStatement === undefined) {
 		return findFirstJsdocBlock(sourceText, 0, sourceText.length);
 	}
-	// The JSDoc block sits in the leading trivia of the first non-import statement.
+	// When imports exist, the file-level JSDoc lives in the leading trivia of
+	// the first import (before any imports), not the first non-import statement.
+	// Check there first; fall back to the first non-import statement's trivia
+	// for the "JSDoc after imports" pattern.
+	if (firstImport) {
+		const importFullStart = firstImport.getFullStart();
+		const importNodeStart = firstImport.getStart(sourceFile);
+		const preImportJsdoc = findFirstJsdocBlock(
+			sourceText,
+			importFullStart,
+			importNodeStart,
+		);
+		if (preImportJsdoc !== null) {
+			return preImportJsdoc;
+		}
+	}
+	// JSDoc in the leading trivia of the first non-import statement
+	// (handles "JSDoc after imports but before code" pattern).
 	const fullStart = firstNonImportStatement.getFullStart();
 	const nodeStart = firstNonImportStatement.getStart(sourceFile);
 	return findFirstJsdocBlock(sourceText, fullStart, nodeStart);

package/package.json

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