knip/dist/reporters/trace.js

Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects

import pc from 'picocolors';
import { toRelative } from "../util/path.js";
import { toRegexOrString } from "../util/regex.js";
import { Table } from "../util/table.js";
import { formatTrace } from "../util/trace.js";
export default ({ graph, explorer, options, workspaceFilePathFilter }) => {
    if (options.traceDependency) {
        const pattern = toRegexOrString(options.traceDependency);
        const toRel = (path) => toRelative(path, options.cwd);
        const table = new Table({ truncateStart: ['filePath'] });
        const seen = new Set();
        for (const [packageName, { imports }] of explorer.getDependencyUsage(pattern)) {
            const filtered = imports.filter(i => workspaceFilePathFilter(i.filePath));
            filtered.sort((a, b) => a.filePath.localeCompare(b.filePath) || (a.line ?? 0) - (b.line ?? 0));
            for (const _import of filtered) {
                const pos = _import.line ? `:${_import.line}:${_import.col}` : '';
                const key = `${_import.filePath}${pos}:${packageName}`;
                if (seen.has(key))
                    continue;
                seen.add(key);
                table.row();
                table.cell('filePath', pc.whiteBright(`${toRel(_import.filePath)}${pos}`));
                table.cell('package', pc.cyanBright(packageName));
            }
        }
        for (const line of table.toRows())
            console.log(line);
    }
    else {
        const nodes = explorer.buildExportsTree({ filePath: options.traceFile, identifier: options.traceExport });
        nodes.sort((a, b) => a.filePath.localeCompare(b.filePath) || a.identifier.localeCompare(b.identifier));
        const toRel = (path) => toRelative(path, options.cwd);
        const isReferenced = (node) => {
            if (explorer.isReferenced(node.filePath, node.identifier, { includeEntryExports: false })[0])
                return true;
            if (explorer.hasStrictlyNsReferences(node.filePath, node.identifier)[0])
                return true;
            return !!graph.get(node.filePath)?.exports.get(node.identifier)?.hasRefsInFile;
        };
        for (const node of nodes)
            console.log(formatTrace(node, toRel, isReferenced(node)));
    }
};