projscan 0.4.0 → 0.6.0

package/dist/core/ast.d.ts

@@ -0,0 +1,34 @@
+export type SymbolKind = 'function' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'default' | 'unknown';
+export interface AstImport {
+    source: string;
+    kind: 'static' | 'dynamic' | 'require' | 'reexport';
+    specifiers: string[];
+    typeOnly: boolean;
+    line: number;
+}
+export interface AstExport {
+    name: string;
+    kind: SymbolKind;
+    typeOnly: boolean;
+    line: number;
+}
+export interface AstResult {
+    ok: boolean;
+    reason?: string;
+    imports: AstImport[];
+    exports: AstExport[];
+    callSites: string[];
+    lineCount: number;
+}
+/** Is this a file we should try to AST-parse at all? */
+export declare function isParseable(filePath: string): boolean;
+/**
+ * Parse a source file and extract imports, exports, and call sites.
+ *
+ * Uses @babel/parser with generous options so we accept real-world code:
+ * TypeScript, JSX, decorators, top-level await, class properties, etc.
+ *
+ * Failures return ok:false with a reason — callers decide whether to fall
+ * back to regex or skip the file. Never throws.
+ */
+export declare function parseSource(filePath: string, content: string): AstResult;

package/dist/core/ast.js

@@ -0,0 +1,270 @@
+import { parse } from '@babel/parser';
+import path from 'node:path';
+const EMPTY = {
+    ok: false,
+    reason: 'unparsed',
+    imports: [],
+    exports: [],
+    callSites: [],
+    lineCount: 0,
+};
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.mts',
+    '.cts',
+]);
+/** Is this a file we should try to AST-parse at all? */
+export function isParseable(filePath) {
+    return SOURCE_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+/**
+ * Parse a source file and extract imports, exports, and call sites.
+ *
+ * Uses @babel/parser with generous options so we accept real-world code:
+ * TypeScript, JSX, decorators, top-level await, class properties, etc.
+ *
+ * Failures return ok:false with a reason — callers decide whether to fall
+ * back to regex or skip the file. Never throws.
+ */
+export function parseSource(filePath, content) {
+    if (!isParseable(filePath)) {
+        return { ...EMPTY, reason: 'non-source extension' };
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    const isTypeScript = ext === '.ts' || ext === '.tsx' || ext === '.mts' || ext === '.cts';
+    const isJSX = ext === '.tsx' || ext === '.jsx';
+    const plugins = [];
+    if (isTypeScript)
+        plugins.push('typescript');
+    if (isJSX)
+        plugins.push('jsx');
+    plugins.push('decorators-legacy', 'dynamicImport', 'topLevelAwait');
+    let ast;
+    try {
+        ast = parse(content, {
+            sourceType: 'module',
+            allowImportExportEverywhere: true,
+            allowAwaitOutsideFunction: true,
+            allowReturnOutsideFunction: true,
+            allowSuperOutsideMethod: true,
+            errorRecovery: true,
+            plugins,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ...EMPTY, reason: `parse error: ${msg.slice(0, 120)}` };
+    }
+    const imports = [];
+    const exports = [];
+    const callSites = [];
+    for (const node of ast.program.body) {
+        visitTopLevel(node, imports, exports);
+    }
+    // Second pass: extract dynamic imports + call sites. Walk the whole tree
+    // (cheap — we already have the AST in memory).
+    walk(ast.program, (n) => {
+        if (n.type === 'CallExpression') {
+            const callee = n.callee;
+            if (callee.type === 'Identifier') {
+                callSites.push(callee.name);
+            }
+            else if (callee.type === 'MemberExpression' && callee.property.type === 'Identifier') {
+                callSites.push(callee.property.name);
+            }
+            else if (callee.type === 'Import' && n.arguments[0] && n.arguments[0].type === 'StringLiteral') {
+                imports.push({
+                    source: n.arguments[0].value,
+                    kind: 'dynamic',
+                    specifiers: [],
+                    typeOnly: false,
+                    line: n.loc?.start.line ?? 0,
+                });
+            }
+            // CommonJS require()
+            if (callee.type === 'Identifier' &&
+                callee.name === 'require' &&
+                n.arguments[0] &&
+                n.arguments[0].type === 'StringLiteral') {
+                imports.push({
+                    source: n.arguments[0].value,
+                    kind: 'require',
+                    specifiers: [],
+                    typeOnly: false,
+                    line: n.loc?.start.line ?? 0,
+                });
+            }
+        }
+    });
+    return {
+        ok: true,
+        imports,
+        exports,
+        callSites: [...new Set(callSites)],
+        lineCount: content ? content.split('\n').length : 0,
+    };
+}
+function visitTopLevel(node, imports, exports) {
+    switch (node.type) {
+        case 'ImportDeclaration': {
+            imports.push(importFromNode(node));
+            return;
+        }
+        case 'ExportNamedDeclaration': {
+            collectNamedExport(node, exports, imports);
+            return;
+        }
+        case 'ExportDefaultDeclaration': {
+            exports.push({
+                name: 'default',
+                kind: 'default',
+                typeOnly: false,
+                line: node.loc?.start.line ?? 0,
+            });
+            return;
+        }
+        case 'ExportAllDeclaration': {
+            const source = node.source.value;
+            imports.push({
+                source,
+                kind: 'reexport',
+                specifiers: [],
+                typeOnly: Boolean(node.exportKind === 'type'),
+                line: node.loc?.start.line ?? 0,
+            });
+            return;
+        }
+        default:
+            return;
+    }
+}
+function importFromNode(node) {
+    const specifiers = node.specifiers.map((s) => {
+        if (s.type === 'ImportDefaultSpecifier')
+            return 'default';
+        if (s.type === 'ImportNamespaceSpecifier')
+            return '*';
+        if (s.type === 'ImportSpecifier') {
+            const imported = s.imported;
+            if (imported.type === 'Identifier')
+                return imported.name;
+            return imported.value;
+        }
+        return '';
+    });
+    return {
+        source: node.source.value,
+        kind: 'static',
+        specifiers: specifiers.filter(Boolean),
+        typeOnly: node.importKind === 'type',
+        line: node.loc?.start.line ?? 0,
+    };
+}
+function collectNamedExport(node, exports, imports) {
+    // Re-export: export { X } from 'source'
+    if (node.source) {
+        imports.push({
+            source: node.source.value,
+            kind: 'reexport',
+            specifiers: node.specifiers.map((s) => {
+                if (s.type === 'ExportSpecifier') {
+                    const exported = s.exported;
+                    return exported.type === 'Identifier' ? exported.name : exported.value;
+                }
+                return '';
+            }).filter(Boolean),
+            typeOnly: node.exportKind === 'type',
+            line: node.loc?.start.line ?? 0,
+        });
+    }
+    // Inline declaration: export function foo() {} / export const x = ... / etc.
+    if (node.declaration) {
+        const typeOnly = node.exportKind === 'type';
+        const line = node.declaration.loc?.start.line ?? node.loc?.start.line ?? 0;
+        switch (node.declaration.type) {
+            case 'FunctionDeclaration': {
+                const name = node.declaration.id?.name;
+                if (name)
+                    exports.push({ name, kind: 'function', typeOnly, line });
+                return;
+            }
+            case 'ClassDeclaration': {
+                const name = node.declaration.id?.name;
+                if (name)
+                    exports.push({ name, kind: 'class', typeOnly, line });
+                return;
+            }
+            case 'VariableDeclaration': {
+                for (const decl of node.declaration.declarations) {
+                    if (decl.id.type === 'Identifier') {
+                        exports.push({ name: decl.id.name, kind: 'variable', typeOnly, line });
+                    }
+                }
+                return;
+            }
+            case 'TSInterfaceDeclaration': {
+                const name = node.declaration.id.name;
+                exports.push({ name, kind: 'interface', typeOnly: true, line });
+                return;
+            }
+            case 'TSTypeAliasDeclaration': {
+                const name = node.declaration.id.name;
+                exports.push({ name, kind: 'type', typeOnly: true, line });
+                return;
+            }
+            case 'TSEnumDeclaration': {
+                const name = node.declaration.id.name;
+                exports.push({ name, kind: 'enum', typeOnly, line });
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    // Named re-export of local symbols: export { foo, bar }
+    for (const spec of node.specifiers) {
+        if (spec.type !== 'ExportSpecifier')
+            continue;
+        const exported = spec.exported;
+        const name = exported.type === 'Identifier' ? exported.name : exported.value;
+        exports.push({
+            name,
+            kind: 'unknown',
+            typeOnly: node.exportKind === 'type',
+            line: spec.loc?.start.line ?? node.loc?.start.line ?? 0,
+        });
+    }
+}
+/**
+ * Lightweight AST walker. We only care about recursing through node properties
+ * to find CallExpressions (for call sites + dynamic imports + require).
+ * Avoids the full babel-traverse dependency.
+ */
+function walk(node, visit) {
+    if (!node || typeof node !== 'object')
+        return;
+    visit(node);
+    for (const key of Object.keys(node)) {
+        if (key === 'loc' || key === 'range' || key === 'leadingComments' || key === 'trailingComments')
+            continue;
+        const child = node[key];
+        if (!child)
+            continue;
+        if (Array.isArray(child)) {
+            for (const item of child) {
+                if (item && typeof item === 'object' && 'type' in item) {
+                    walk(item, visit);
+                }
+            }
+        }
+        else if (typeof child === 'object' && 'type' in child) {
+            walk(child, visit);
+        }
+    }
+}
+//# sourceMappingURL=ast.js.map

package/dist/core/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../src/core/ast.ts"],"names":[],"mappings":"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"}

package/dist/core/codeGraph.d.ts

@@ -0,0 +1,36 @@
+import type { FileEntry } from '../types.js';
+import { type AstImport, type AstExport } from './ast.js';
+export interface GraphFile {
+    relativePath: string;
+    imports: AstImport[];
+    exports: AstExport[];
+    callSites: string[];
+    lineCount: number;
+    mtimeMs: number;
+    parseOk: boolean;
+    parseReason?: string;
+}
+export interface CodeGraph {
+    /** per-file parse results, keyed by relativePath */
+    files: Map<string, GraphFile>;
+    /** package name → relativePaths that import it */
+    packageImporters: Map<string, Set<string>>;
+    /** relativePath → relativePaths that import it (local resolution) */
+    localImporters: Map<string, Set<string>>;
+    /** symbol name → relativePaths that export it */
+    symbolDefs: Map<string, Set<string>>;
+    /** scanned file count */
+    scannedFiles: number;
+}
+export declare function buildCodeGraph(rootPath: string, files: FileEntry[], previousGraph?: CodeGraph): Promise<CodeGraph>;
+/**
+ * Convert an import specifier to a bare package name.
+ */
+export declare function toPackageName(specifier: string): string | null;
+export declare function packagesUsed(graph: CodeGraph): Set<string>;
+export declare function filesImportingPackage(graph: CodeGraph, pkg: string): string[];
+export declare function filesImportingFile(graph: CodeGraph, relativePath: string): string[];
+export declare function filesDefiningSymbol(graph: CodeGraph, name: string): string[];
+export declare function importersOf(graph: CodeGraph, relativePath: string): string[];
+export declare function exportsOf(graph: CodeGraph, relativePath: string): AstExport[];
+export declare function importsOf(graph: CodeGraph, relativePath: string): AstImport[];

package/dist/core/codeGraph.js

@@ -0,0 +1,167 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseSource, isParseable } from './ast.js';
+const NODE_BUILTINS = new Set([
+    'assert', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console', 'constants', 'crypto',
+    'dgram', 'dns', 'domain', 'events', 'fs', 'fs/promises', 'http', 'http2', 'https', 'inspector',
+    'module', 'net', 'os', 'path', 'perf_hooks', 'process', 'punycode', 'querystring', 'readline',
+    'repl', 'stream', 'string_decoder', 'sys', 'timers', 'tls', 'trace_events', 'tty', 'url', 'util',
+    'v8', 'vm', 'wasi', 'worker_threads', 'zlib',
+]);
+const RESOLUTION_EXTS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts'];
+const MAX_FILE_SIZE = 1024 * 1024;
+export async function buildCodeGraph(rootPath, files, previousGraph) {
+    const parseable = files.filter((f) => isParseable(f.relativePath) && f.sizeBytes <= MAX_FILE_SIZE);
+    const graphFiles = new Map();
+    const packageImporters = new Map();
+    const localImporters = new Map();
+    const symbolDefs = new Map();
+    // Parse each file (with mtime-based reuse if we have a previous graph)
+    await Promise.all(parseable.map(async (file) => {
+        const absolutePath = path.isAbsolute(file.absolutePath)
+            ? file.absolutePath
+            : path.resolve(rootPath, file.relativePath);
+        let mtimeMs;
+        try {
+            const stat = await fs.stat(absolutePath);
+            mtimeMs = stat.mtimeMs;
+        }
+        catch {
+            return;
+        }
+        const cached = previousGraph?.files.get(file.relativePath);
+        if (cached && cached.mtimeMs === mtimeMs) {
+            graphFiles.set(file.relativePath, cached);
+            return;
+        }
+        let content;
+        try {
+            content = await fs.readFile(absolutePath, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        const result = parseSource(file.relativePath, content);
+        graphFiles.set(file.relativePath, {
+            relativePath: file.relativePath,
+            imports: result.imports,
+            exports: result.exports,
+            callSites: result.callSites,
+            lineCount: result.lineCount,
+            mtimeMs,
+            parseOk: result.ok,
+            parseReason: result.reason,
+        });
+    }));
+    // Build derived indexes after all parsing is done
+    for (const [importingFile, entry] of graphFiles) {
+        const importingDir = path.posix.dirname(importingFile);
+        for (const imp of entry.imports) {
+            const pkg = toPackageName(imp.source);
+            if (pkg) {
+                if (!packageImporters.has(pkg))
+                    packageImporters.set(pkg, new Set());
+                packageImporters.get(pkg).add(importingFile);
+            }
+            else if (imp.source.startsWith('.') || imp.source.startsWith('/')) {
+                const resolved = resolveRelative(importingDir, imp.source, graphFiles);
+                if (resolved) {
+                    if (!localImporters.has(resolved))
+                        localImporters.set(resolved, new Set());
+                    localImporters.get(resolved).add(importingFile);
+                }
+            }
+        }
+        for (const exp of entry.exports) {
+            if (!exp.name)
+                continue;
+            if (!symbolDefs.has(exp.name))
+                symbolDefs.set(exp.name, new Set());
+            symbolDefs.get(exp.name).add(importingFile);
+        }
+    }
+    return {
+        files: graphFiles,
+        packageImporters,
+        localImporters,
+        symbolDefs,
+        scannedFiles: graphFiles.size,
+    };
+}
+/**
+ * Convert an import specifier to a bare package name.
+ */
+export function toPackageName(specifier) {
+    if (!specifier)
+        return null;
+    if (specifier.startsWith('.') || specifier.startsWith('/'))
+        return null;
+    if (specifier.startsWith('node:'))
+        return null;
+    if (NODE_BUILTINS.has(specifier))
+        return null;
+    if (specifier.startsWith('@')) {
+        const segments = specifier.split('/');
+        if (segments.length < 2)
+            return null;
+        return `${segments[0]}/${segments[1]}`;
+    }
+    return specifier.split('/')[0];
+}
+/**
+ * Resolve a relative import to a file in the graph, or null if no match.
+ * Supports:
+ *   - direct hit  (./foo.ts → foo.ts)
+ *   - extension inference (./foo → foo.ts)
+ *   - barrel index (./foo → foo/index.ts)
+ *   - .js that resolves to .ts under NodeNext
+ */
+function resolveRelative(importingDir, specifier, graphFiles) {
+    const base = path.posix.normalize(path.posix.join(importingDir, specifier));
+    if (graphFiles.has(base))
+        return base;
+    for (const ext of RESOLUTION_EXTS) {
+        if (graphFiles.has(base + ext))
+            return base + ext;
+    }
+    for (const ext of RESOLUTION_EXTS) {
+        const barrel = `${base}/index${ext}`;
+        if (graphFiles.has(barrel))
+            return barrel;
+    }
+    // .js → .ts fallback (NodeNext)
+    if (base.endsWith('.js')) {
+        const trimmed = base.slice(0, -3);
+        if (graphFiles.has(`${trimmed}.ts`))
+            return `${trimmed}.ts`;
+        if (graphFiles.has(`${trimmed}.tsx`))
+            return `${trimmed}.tsx`;
+    }
+    return null;
+}
+// ── Query API ──────────────────────────────────────────────
+export function packagesUsed(graph) {
+    return new Set(graph.packageImporters.keys());
+}
+export function filesImportingPackage(graph, pkg) {
+    const set = graph.packageImporters.get(pkg);
+    return set ? [...set].sort() : [];
+}
+export function filesImportingFile(graph, relativePath) {
+    const set = graph.localImporters.get(relativePath);
+    return set ? [...set].sort() : [];
+}
+export function filesDefiningSymbol(graph, name) {
+    const set = graph.symbolDefs.get(name);
+    return set ? [...set].sort() : [];
+}
+export function importersOf(graph, relativePath) {
+    return filesImportingFile(graph, relativePath);
+}
+export function exportsOf(graph, relativePath) {
+    return graph.files.get(relativePath)?.exports ?? [];
+}
+export function importsOf(graph, relativePath) {
+    return graph.files.get(relativePath)?.imports ?? [];
+}
+//# sourceMappingURL=codeGraph.js.map

package/dist/core/codeGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeGraph.js","sourceRoot":"","sources":["../../src/core/codeGraph.ts"],"names":[],"mappings":"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"}

package/dist/core/coverageJoin.d.ts

@@ -0,0 +1,6 @@
+import type { CoverageJoinedReport, CoverageReport, HotspotReport } from '../types.js';
+/**
+ * Join a hotspot report with a coverage report and rank entries by
+ * "risk × uncovered fraction" — the files that most deserve tests.
+ */
+export declare function joinCoverageWithHotspots(hotspots: HotspotReport, coverage: CoverageReport): CoverageJoinedReport;

package/dist/core/coverageJoin.js

@@ -0,0 +1,50 @@
+/**
+ * Join a hotspot report with a coverage report and rank entries by
+ * "risk × uncovered fraction" — the files that most deserve tests.
+ */
+export function joinCoverageWithHotspots(hotspots, coverage) {
+    if (!hotspots.available) {
+        return {
+            available: false,
+            reason: hotspots.reason ?? 'hotspots unavailable',
+            coverageSource: coverage.source,
+            coverageSourceFile: coverage.sourceFile,
+            entries: [],
+        };
+    }
+    if (!coverage.available) {
+        return {
+            available: false,
+            reason: coverage.reason ?? 'coverage unavailable',
+            coverageSource: coverage.source,
+            coverageSourceFile: coverage.sourceFile,
+            entries: [],
+        };
+    }
+    const coverageMap = new Map();
+    for (const f of coverage.files)
+        coverageMap.set(f.relativePath, f.lineCoverage);
+    const entries = hotspots.hotspots.map((h) => {
+        const cov = coverageMap.get(h.relativePath);
+        const uncovered = typeof cov === 'number' ? Math.max(0, (100 - cov) / 100) : 1;
+        const priority = h.riskScore * (0.3 + 0.7 * uncovered);
+        return {
+            relativePath: h.relativePath,
+            riskScore: h.riskScore,
+            churn: h.churn,
+            lineCount: h.lineCount,
+            issueCount: h.issueCount,
+            coverage: typeof cov === 'number' ? cov : null,
+            priority: Math.round(priority * 10) / 10,
+            reasons: h.reasons,
+        };
+    });
+    entries.sort((a, b) => b.priority - a.priority);
+    return {
+        available: true,
+        coverageSource: coverage.source,
+        coverageSourceFile: coverage.sourceFile,
+        entries,
+    };
+}
+//# sourceMappingURL=coverageJoin.js.map

package/dist/core/coverageJoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverageJoin.js","sourceRoot":"","sources":["../../src/core/coverageJoin.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAuB,EACvB,QAAwB;IAExB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,sBAAsB;YACjD,cAAc,EAAE,QAAQ,CAAC,MAAM;YAC/B,kBAAkB,EAAE,QAAQ,CAAC,UAAU;YACvC,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,sBAAsB;YACjD,cAAc,EAAE,QAAQ,CAAC,MAAM;YAC/B,kBAAkB,EAAE,QAAQ,CAAC,UAAU;YACvC,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK;QAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;IAEhF,MAAM,OAAO,GAA4B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,SAAS,CAAC,CAAC;QACvD,OAAO;YACL,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAC9C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,EAAE;YACxC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO;QACL,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,kBAAkB,EAAE,QAAQ,CAAC,UAAU;QACvC,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/core/coverageParser.d.ts

@@ -0,0 +1,15 @@
+import type { CoverageReport } from '../types.js';
+/**
+ * Detect and parse whatever coverage file the project has. Supports the three
+ * common formats produced by Istanbul/c8/Vitest/Jest:
+ *   - lcov.info (line-oriented LCOV)
+ *   - coverage-final.json (Istanbul per-file detail)
+ *   - coverage-summary.json (Istanbul per-file summary)
+ *
+ * Returns per-file line coverage, normalized to relative posix paths.
+ */
+export declare function parseCoverage(rootPath: string): Promise<CoverageReport>;
+/**
+ * Build a Map<relativePath, coverage%> for fast lookup.
+ */
+export declare function coverageMap(report: CoverageReport): Map<string, number>;