jsdoczoom 0.4.18 → 0.4.20

package/dist/drilldown.js

@@ -62,8 +62,15 @@ function sortKey(entry) {
  * If the requested depth level is null (empty), advance to the next non-null level.
  * Output contains next_id when more detail is available, or id at terminal level.
  */
-function processFile(info, typeDeclarations, fileContent, depth, cwd) {
-	const idPath = displayPath(info.path, cwd);
+function processFile(
+	filePath,
+	info,
+	typeDeclarations,
+	fileContent,
+	depth,
+	cwd,
+) {
+	const idPath = displayPath(filePath, cwd);
 	const levels = buildLevels(info, typeDeclarations, fileContent);
 	// Clamp depth to [1, TERMINAL_LEVEL], advance past null levels
 	let effectiveDepth = Math.max(1, Math.min(depth, TERMINAL_LEVEL));
@@ -149,7 +156,7 @@ async function processFileSafe(filePath, depth, cwd, config) {
 			effectiveDepth,
 			config,
 		);
-		return processFile(info, typeDeclarations, content, depth, cwd);
+		return processFile(filePath, info, typeDeclarations, content, depth, cwd);
 	} catch (error) {
 		if (isParseError(error)) return makeParseErrorItem(filePath, error, cwd);
 		throw error;
@@ -371,7 +378,9 @@ export async function drilldown(
 			effectiveDepth,
 			config,
 		);
-		const items = [processFile(info, typeDeclarations, content, depth, cwd)];
+		const items = [
+			processFile(filePath, info, typeDeclarations, content, depth, cwd),
+		];
 		return { items, truncated: false };
 	}
 	// Glob selector — apply barrel gating

package/dist/jsdoc-parser.js

@@ -118,6 +118,11 @@ function getAllBlockComments(sourceText, start, end) {
 			pos++;
 			continue;
 		}
+		// Skip shebang line (e.g. #!/usr/bin/env node) — only valid at position 0
+		if (pos === 0 && sourceText[0] === "#" && sourceText[1] === "!") {
+			pos = findLineCommentEnd(sourceText, pos + 2);
+			continue;
+		}
 		const nextChar = sourceText[pos + 1];
 		if (sourceText[pos] !== "/" || pos + 1 >= end) break;
 		if (nextChar === "*") {
@@ -225,7 +230,6 @@ export function parseFileSummaries(filePath) {
 	const jsdocText = extractFileJsdoc(sourceText, filePath);
 	if (jsdocText === null) {
 		return {
-			path: filePath,
 			summary: null,
 			description: null,
 			summaryCount: 0,
@@ -234,7 +238,6 @@ export function parseFileSummaries(filePath) {
 	}
 	const { summary, description, summaryCount } = parseJsdocContent(jsdocText);
 	return {
-		path: filePath,
 		summary,
 		description,
 		summaryCount,

package/dist/lint.js

@@ -28,13 +28,16 @@ import { DEFAULT_CACHE_DIR } from "./types.js";
  */
 async function lintSingleFile(eslint, filePath, cwd, config) {
 	const sourceText = await readFile(filePath, "utf-8");
-	return processWithCache(config, "lint", sourceText, async () => {
-		const diagnostics = await lintFileForLint(eslint, sourceText, filePath);
-		return {
-			filePath: relative(cwd, filePath),
-			diagnostics,
-		};
-	});
+	const { diagnostics } = await processWithCache(
+		config,
+		"lint",
+		sourceText,
+		async () => {
+			const diagnostics = await lintFileForLint(eslint, sourceText, filePath);
+			return { diagnostics };
+		},
+	);
+	return { filePath: relative(cwd, filePath), diagnostics };
 }
 /**
  * Build a LintResult from per-file results, applying a limit to files with issues.

package/dist/validate.js

@@ -27,11 +27,21 @@ async function classifyFile(eslint, filePath, cwd, config) {
 	} catch {
 		throw new JsdocError("FILE_NOT_FOUND", `File not found: ${filePath}`);
 	}
-	return processWithCache(config, "validate", sourceText, async () => {
-		const messages = await lintFileForValidation(eslint, sourceText, filePath);
-		const status = mapToValidationStatus(messages);
-		return { path: relativePath, status };
-	});
+	const { status } = await processWithCache(
+		config,
+		"validate",
+		sourceText,
+		async () => {
+			const messages = await lintFileForValidation(
+				eslint,
+				sourceText,
+				filePath,
+			);
+			const status = mapToValidationStatus(messages);
+			return { status };
+		},
+	);
+	return { path: relativePath, status };
 }
 /**
  * Group file statuses into a ValidationResult, applying a limit

package/package.json

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

package/types/types.d.ts

@@ -69,7 +69,6 @@ export interface ValidationResult {
 }
 /** Parsed summary and description from a file's JSDoc */
 export interface ParsedFileInfo {
-	path: string;
 	summary: string | null;
 	description: string | null;
 	summaryCount: number;