knip 5.45.0 → 5.46.0

package/dist/ConfigurationChief.d.ts

@@ -172,5 +172,6 @@ export declare class ConfigurationChief {
     getIncludedIssueTypes(cliArgs: CLIArguments): import("./types/issues.js").Report;
     findWorkspaceByFilePath(filePath: string): Workspace | undefined;
     getUnusedIgnoredWorkspaces(): string[];
+    getTags(): import("./types/cli.js").Tags;
 }
 export {};

package/dist/ConfigurationChief.js

@@ -18,6 +18,7 @@ import { getKeysByValue } from './util/object.js';
 import { join, relative } from './util/path.js';
 import { normalizePluginConfig } from './util/plugin.js';
 import { toRegexOrString } from './util/regex.js';
+import { splitTags } from './util/tag.js';
 import { unwrapFunction } from './util/unwrap-function.js';
 import { byPathDepth } from './util/workspace.js';
 const { config: rawConfigArg } = parsedArgValues;
@@ -43,6 +44,7 @@ const defaultConfig = {
     syncCompilers: new Map(),
     asyncCompilers: new Map(),
     rootPluginConfigs: {},
+    tags: [],
 };
 export class ConfigurationChief {
     cwd;
@@ -150,6 +152,7 @@ export class ConfigurationChief {
             syncCompilers: new Map(Object.entries(syncCompilers ?? {})),
             asyncCompilers: new Map(Object.entries(asyncCompilers ?? {})),
             rootPluginConfigs,
+            tags: rawConfig.tags ?? [],
         };
     }
     async setWorkspaces() {
@@ -371,4 +374,7 @@ export class ConfigurationChief {
             return !isDirectory(dir) || isFile(join(dir, 'package.json'));
         });
     }
+    getTags() {
+        return splitTags(this.config.tags);
+    }
 }

package/dist/IssueCollector.js

@@ -40,7 +40,8 @@ export class IssueCollector {
             if (this.isMatch(filePath))
                 continue;
             this.issues.files.add(filePath);
-            this.issues._files.add({ type: 'files', filePath, symbol: relative(filePath), severity: this.rules.files });
+            const symbol = relative(filePath);
+            this.issues._files[symbol] = [{ type: 'files', filePath, symbol, severity: this.rules.files }];
             this.counters.files++;
             this.counters.processed++;
         }

package/dist/IssueFixer.js

@@ -57,7 +57,7 @@ export class IssueFixer {
     async removeUnusedFiles(issues) {
         if (!this.isFixFiles)
             return;
-        for (const issue of issues._files) {
+        for (const issue of Object.values(issues._files).flatMap(Object.values)) {
             await rm(issue.filePath);
             issue.isFixed = true;
         }

package/dist/binaries/package-manager/bun.js

@@ -5,7 +5,7 @@ import { isAbsolute, join } from '../../util/path.js';
 import { resolveX } from './bunx.js';
 const commands = ['add', 'create', 'init', 'install', 'link', 'pm', 'remove', 'run', 'test', 'update', 'upgrade', 'x'];
 export const resolve = (_binary, args, options) => {
-    const parsed = parseArgs(args);
+    const parsed = parseArgs(args, { string: ['cwd'] });
     const [command, script] = parsed._;
     if (command === 'x') {
         const argsForX = args.filter(arg => arg !== 'x');
@@ -14,11 +14,15 @@ export const resolve = (_binary, args, options) => {
     const { manifestScriptNames, cwd, fromArgs } = options;
     if (command === 'run' && manifestScriptNames.has(script))
         return [];
-    if (manifestScriptNames.has(command) || commands.includes(command))
+    if (manifestScriptNames.has(command))
+        return [];
+    if (command !== 'run' && commands.includes(command))
         return [];
     const filePath = command === 'run' ? script : command;
     const absFilePath = isAbsolute(filePath) ? filePath : join(cwd, filePath);
     if (isFile(absFilePath))
         return [toEntry(absFilePath)];
-    return fromArgs(args);
+    const dir = parsed.cwd ? join(cwd, parsed.cwd) : undefined;
+    const opts = dir ? { cwd: dir } : {};
+    return command === 'run' ? [] : fromArgs(args, opts);
 };

package/dist/binaries/package-manager/yarn.js

@@ -52,6 +52,8 @@ export const resolve = (_binary, args, options) => {
     const parsed = parseArgs(args, { boolean: ['top-level'], string: ['cwd'] });
     const dir = parsed['top-level'] ? rootCwd : parsed.cwd ? join(cwd, parsed.cwd) : undefined;
     const [command, binary] = parsed._;
+    if (!command && !binary)
+        return [];
     if (command === 'run') {
         if (manifestScriptNames.has(binary))
             return [];

package/dist/cli.js

@@ -10,7 +10,7 @@ import { splitTags } from './util/tag.js';
 import { isTrace } from './util/trace.js';
 import { version } from './version.js';
 const defaultCacheLocation = join(cwd, 'node_modules', '.cache', 'knip');
-const { 'allow-remove-files': isRemoveFiles = false, cache: isCache = false, 'cache-location': cacheLocation = defaultCacheLocation, debug: isDebug = false, dependencies: isDependenciesShorthand = false, exclude: excludedIssueTypes = [], 'experimental-tags': experimentalTags = [], exports: isExportsShorthand = false, files: isFilesShorthand = false, fix: isFix = false, 'fix-type': fixTypes = [], help: isHelp, include: includedIssueTypes = [], 'include-entry-exports': isIncludeEntryExports = false, 'include-libs': isIncludeLibs = false, 'isolate-workspaces': isIsolateWorkspaces = false, 'max-issues': maxIssues = '0', 'no-config-hints': isHideConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = isDebug || isTrace, preprocessor = [], 'preprocessor-options': preprocessorOptions = '', production: isProduction = false, reporter = ['symbols'], 'reporter-options': reporterOptions = '', strict: isStrict = false, tags = [], tsConfig, version: isVersion, watch: isWatch = false, workspace: rawWorkspaceArg, } = parsedArgValues;
+const { 'allow-remove-files': isRemoveFiles = false, cache: isCache = false, 'cache-location': cacheLocation = defaultCacheLocation, debug: isDebug = false, dependencies: isDependenciesShorthand = false, exclude: excludedIssueTypes = [], 'experimental-tags': experimentalTags = [], exports: isExportsShorthand = false, files: isFilesShorthand = false, fix: isFix = false, 'fix-type': fixTypes = [], help: isHelp, include: includedIssueTypes = [], 'include-entry-exports': isIncludeEntryExports = false, 'include-libs': isIncludeLibs = false, 'isolate-workspaces': isIsolateWorkspaces = false, 'max-issues': maxIssues = '0', 'no-config-hints': isDisableConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = isDebug || isTrace, preprocessor = [], 'preprocessor-options': preprocessorOptions = '', production: isProduction = false, reporter = ['symbols'], 'reporter-options': reporterOptions = '', strict: isStrict = false, tags = [], 'treat-config-hints-as-errors': isTreatConfigHintsAsErrors = false, tsConfig, version: isVersion, watch: isWatch = false, workspace: rawWorkspaceArg, } = parsedArgValues;
 if (isHelp) {
     console.log(helpText);
     process.exit(0);
@@ -36,7 +36,7 @@ const run = async () => {
             isExportsShorthand,
             isFilesShorthand,
             isFix: isFix || fixTypes.length > 0,
-            isHideConfigHints,
+            isDisableConfigHints,
             isIncludeEntryExports,
             isIncludeLibs,
             isIsolateWorkspaces,
@@ -57,7 +57,8 @@ const run = async () => {
             counters,
             tagHints,
             configurationHints,
-            noConfigHints: isHideConfigHints,
+            isDisableConfigHints,
+            isTreatConfigHintsAsErrors,
             cwd,
             isProduction,
             isShowProgress,
@@ -83,7 +84,8 @@ const run = async () => {
         if (isIsolateWorkspaces && report.classMembers) {
             logWarning('WARNING', 'Class members are not tracked when using the --isolate-workspaces flag');
         }
-        if (!noExitCode && totalErrorCount > Number(maxIssues)) {
+        if ((!noExitCode && totalErrorCount > Number(maxIssues)) ||
+            (isTreatConfigHintsAsErrors && configurationHints.size > 0)) {
             process.exit(1);
         }
     }

package/dist/compilers/index.d.ts

@@ -5,6 +5,7 @@ export declare const partitionCompilers: (rawLocalConfig: RawConfiguration) => {
     syncCompilers: Record<string, SyncCompilerFn>;
     asyncCompilers: Record<string, AsyncCompilerFn>;
     exclude?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
+    tags?: string[] | undefined;
     include?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
     node?: string | boolean | string[] | {
         config?: string | string[] | undefined;

package/dist/graph/analyze.d.ts

@@ -17,7 +17,7 @@ interface AnalyzeOptions {
     fixer: IssueFixer;
     graph: ModuleGraph;
     isFix: boolean;
-    isHideConfigHints: boolean;
+    isDisableConfigHints: boolean;
     isIncludeLibs: boolean;
     isProduction: boolean;
     report: Report;

package/dist/graph/analyze.js

@@ -5,13 +5,13 @@ import { findMatch } from '../util/regex.js';
 import { getShouldIgnoreHandler, getShouldIgnoreTagHandler } from '../util/tag.js';
 import { createAndPrintTrace, printTrace } from '../util/trace.js';
 export const analyze = async (options) => {
-    const { analyzedFiles, chief, collector, deputy, entryPaths, factory, fixer, graph, isFix, isHideConfigHints, isIncludeLibs, isProduction, report, streamer, tags, unreferencedFiles, workspace, } = options;
+    const { analyzedFiles, chief, collector, deputy, entryPaths, factory, fixer, graph, isFix, isDisableConfigHints, isIncludeLibs, isProduction, report, streamer, tags, unreferencedFiles, workspace, } = options;
     const isReportDependencies = report.dependencies || report.unlisted || report.unresolved;
     const isReportValues = report.exports || report.nsExports || report.classMembers;
     const isReportTypes = report.types || report.nsTypes || report.enumMembers;
     const isReportClassMembers = report.classMembers;
     const isSkipLibs = !(isIncludeLibs || isReportClassMembers);
-    const isShowConfigHints = !workspace && !isProduction && !isHideConfigHints;
+    const isShowConfigHints = !workspace && !isProduction && !isDisableConfigHints;
     const shouldIgnore = getShouldIgnoreHandler(isProduction);
     const shouldIgnoreTags = getShouldIgnoreTagHandler(tags);
     const isIdentifierReferenced = getIsIdentifierReferencedHandler(graph, entryPaths);

package/dist/graph/build.js

@@ -94,12 +94,12 @@ export async function build({ cacheLocation, chief, collector, cwd, deputy, fact
         const entryFilePatterns = new Set();
         const productionEntryFilePatterns = new Set();
         for (const input of inputs) {
-            const s = input.specifier;
+            const specifier = input.specifier;
             if (isEntry(input)) {
-                entryFilePatterns.add(isAbsolute(s) ? relative(dir, s) : s);
+                entryFilePatterns.add(isAbsolute(specifier) ? relative(dir, specifier) : specifier);
             }
             else if (isProductionEntry(input)) {
-                productionEntryFilePatterns.add(isAbsolute(s) ? relative(dir, s) : s);
+                productionEntryFilePatterns.add(isAbsolute(specifier) ? relative(dir, specifier) : specifier);
             }
             else if (!isConfig(input)) {
                 const ws = (input.containingFilePath && chief.findWorkspaceByFilePath(input.containingFilePath)) || workspace;
@@ -217,13 +217,7 @@ export async function build({ cacheLocation, chief, collector, cwd, deputy, fact
                 const dependencies = deputy.getDependencies(workspace.name);
                 const manifestScriptNames = new Set(Object.keys(chief.getManifestForWorkspace(workspace.name)?.scripts ?? {}));
                 const dir = dirname(filePath);
-                const options = {
-                    cwd: dir,
-                    rootCwd: cwd,
-                    containingFilePath: filePath,
-                    dependencies,
-                    manifestScriptNames,
-                };
+                const options = { cwd: dir, rootCwd: cwd, containingFilePath: filePath, dependencies, manifestScriptNames };
                 const inputs = _getInputsFromScripts(scripts, options);
                 for (const input of inputs) {
                     input.containingFilePath ??= filePath;

package/dist/index.js

@@ -11,7 +11,7 @@ import { debugLogObject } from './util/debug.js';
 import { getGitIgnoredHandler } from './util/glob-core.js';
 import { getWatchHandler } from './util/watch.js';
 export const main = async (unresolvedConfiguration) => {
-    const { cacheLocation, cwd, excludedIssueTypes, fixTypes, gitignore, includedIssueTypes, isCache, isDebug, isDependenciesShorthand, isExportsShorthand, isFilesShorthand, isFix, isHideConfigHints, isIncludeEntryExports, isIncludeLibs, isIsolateWorkspaces, isProduction, isRemoveFiles, isShowProgress, isStrict, isWatch, tags, tsConfigFile, workspace, } = unresolvedConfiguration;
+    const { cacheLocation, cwd, excludedIssueTypes, fixTypes, gitignore, includedIssueTypes, isCache, isDebug, isDependenciesShorthand, isExportsShorthand, isFilesShorthand, isFix, isDisableConfigHints, isIncludeEntryExports, isIncludeLibs, isIsolateWorkspaces, isProduction, isRemoveFiles, isShowProgress, isStrict, isWatch, tags, tsConfigFile, workspace, } = unresolvedConfiguration;
     debugLogObject('*', 'Unresolved configuration (from CLI arguments)', unresolvedConfiguration);
     const chief = new ConfigurationChief({ cwd, isProduction, isStrict, isIncludeEntryExports, workspace });
     const deputy = new DependencyDeputy({ isProduction, isStrict });
@@ -29,6 +29,7 @@ export const main = async (unresolvedConfiguration) => {
     });
     const rules = chief.getRules();
     const filters = chief.getFilters();
+    const finalTags = tags[0].length > 0 || tags[1].length > 0 ? tags : chief.getTags();
     const fixer = new IssueFixer({ isEnabled: isFix, cwd, fixTypes, isRemoveFiles });
     debugLogObject('*', 'Included issue types', report);
     const isReportClassMembers = report.classMembers;
@@ -57,7 +58,7 @@ export const main = async (unresolvedConfiguration) => {
         isWatch,
         report,
         streamer,
-        tags,
+        tags: finalTags,
         tsConfigFile,
         workspaces,
     });
@@ -71,12 +72,12 @@ export const main = async (unresolvedConfiguration) => {
         fixer,
         graph,
         isFix,
-        isHideConfigHints,
+        isDisableConfigHints,
         isIncludeLibs,
         isProduction,
         report,
         streamer,
-        tags,
+        tags: finalTags,
         unreferencedFiles,
         workspace,
     });

package/dist/plugins/storybook/index.js

@@ -4,11 +4,11 @@ import { hasDependency } from '../../util/plugin.js';
 const title = 'Storybook';
 const enablers = [/^@storybook\//, '@nrwl/storybook'];
 const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
-const config = ['.storybook/{main,test-runner}.{js,ts}'];
+const config = ['.storybook/{main,test-runner}.{js,ts,mts}'];
 const stories = ['**/*.@(mdx|stories.@(mdx|js|jsx|mjs|ts|tsx))'];
 const restEntry = ['.storybook/{manager,preview}.{js,jsx,ts,tsx}'];
 const entry = [...restEntry, ...stories];
-const project = ['.storybook/**/*.{js,jsx,ts,tsx}'];
+const project = ['.storybook/**/*.{js,jsx,ts,tsx,mts}'];
 const resolveEntryPaths = async (localConfig, options) => {
     const { cwd, configFileDir } = options;
     const strs = typeof localConfig?.stories === 'function' ? await localConfig.stories(stories) : localConfig?.stories;

package/dist/reporters/codeclimate.d.ts

@@ -0,0 +1,3 @@
+import type { ReporterOptions } from '../types/issues.js';
+declare const _default: ({ report, issues }: ReporterOptions) => Promise<void>;
+export default _default;

package/dist/reporters/codeclimate.js

@@ -0,0 +1,87 @@
+import { createHash } from 'node:crypto';
+import { toRelative } from '../util/path.js';
+import { getTitle } from './util.js';
+export default async ({ report, issues }) => {
+    const entries = [];
+    for (const [type, isReportType] of Object.entries(report)) {
+        if (!isReportType) {
+            continue;
+        }
+        const fixedType = type === 'files' ? '_files' : type;
+        for (const issue of flatten(issues[fixedType])) {
+            const { filePath } = issue;
+            if (fixedType === 'duplicates' && issue.symbols) {
+                entries.push(...issue.symbols.map(symbol => ({
+                    type: 'issue',
+                    check_name: getTitle(fixedType),
+                    description: getSymbolDescription({ symbol, parentSymbol: issue.parentSymbol }),
+                    categories: ['Duplication'],
+                    location: createLocation(filePath, symbol.line, symbol.col),
+                    severity: convertSeverity(issue.severity),
+                    fingerprint: createFingerprint(filePath, symbol.symbol, symbol.pos),
+                })));
+            }
+            else {
+                entries.push({
+                    type: 'issue',
+                    check_name: getTitle(fixedType),
+                    description: getIssueDescription(issue),
+                    categories: ['Bug Risk'],
+                    location: createLocation(filePath, issue.line, issue.col),
+                    severity: convertSeverity(issue.severity),
+                    fingerprint: createFingerprint(filePath, issue.symbol, issue.pos),
+                });
+            }
+        }
+    }
+    const output = JSON.stringify(entries);
+    process.stdout._handle?.setBlocking?.(true);
+    process.stdout.write(`${output}\n`);
+};
+function flatten(issues) {
+    return Object.values(issues).flatMap(Object.values);
+}
+function convertSeverity(severity) {
+    switch (severity) {
+        case 'error':
+            return 'major';
+        case 'warn':
+            return 'minor';
+        default:
+            return 'info';
+    }
+}
+function getIssueDescription({ symbol, symbols, parentSymbol }) {
+    const symbolDescription = symbols ? `${symbols.map(s => s.symbol).join(', ')}` : symbol;
+    return `${symbolDescription}${parentSymbol ? ` (${parentSymbol})` : ''}`;
+}
+function getSymbolDescription({ symbol, parentSymbol }) {
+    return `${symbol.symbol}${parentSymbol ? ` (${parentSymbol})` : ''}`;
+}
+function createLocation(filePath, line, col) {
+    if (col !== undefined) {
+        return {
+            path: toRelative(filePath),
+            positions: {
+                begin: {
+                    line: line ?? 0,
+                    column: col,
+                },
+            },
+        };
+    }
+    return {
+        path: toRelative(filePath),
+        lines: {
+            begin: line ?? 0,
+            end: line ?? 0,
+        },
+    };
+}
+function createFingerprint(filePath, message, pos) {
+    const md5 = createHash('md5');
+    md5.update(filePath);
+    md5.update(message);
+    md5.update(pos?.toString() ?? '');
+    return md5.digest('hex');
+}

package/dist/reporters/compact.js

@@ -16,7 +16,7 @@ export default ({ report, issues, isShowProgress }) => {
                     ? Object.values(issues[reportType]).flatMap(Object.values)
                     : Object.values(issues[reportType]).map(issues => {
                         const items = Object.values(issues);
-                        return { ...items[0], symbols: items.map(issue => issue.symbol) };
+                        return { ...items[0], symbols: items };
                     });
             if (issuesForType.length > 0) {
                 title && logTitle(title, issuesForType.length);

package/dist/reporters/disclosure.js

@@ -1,5 +1,5 @@
 import EasyTable from 'easy-table';
-import { relative, toRelative } from '../util/path.js';
+import { relative } from '../util/path.js';
 import { getTitle } from './util.js';
 const printHeader = (size, title) => console.log(`<details>\n${title ? `<summary>${title} (${size})</summary>\n` : ''}\n\`\`\``);
 const printFooter = () => console.log('```\n\n</details>\n');
@@ -10,7 +10,7 @@ const logIssueRecord = (issues) => {
         issue.parentSymbol && table.cell('parentSymbol', issue.parentSymbol);
         issue.symbolType && table.cell('symbolType', issue.symbolType);
         const pos = issue.line === undefined ? '' : `:${issue.line}${issue.col === undefined ? '' : `:${issue.col}`}`;
-        const cell = `${relative(issue.filePath)}${pos}`;
+        const cell = issue.type === 'files' ? '' : `${relative(issue.filePath)}${pos}`;
         table.cell('filePath', cell);
         table.newRow();
     }
@@ -19,30 +19,17 @@ const logIssueRecord = (issues) => {
 export default ({ report, issues }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     let totalIssues = 0;
-    for (const [reportType, isReportType] of Object.entries(report)) {
-        if (reportType === '_files')
-            continue;
+    for (let [reportType, isReportType] of Object.entries(report)) {
+        if (reportType === 'files')
+            reportType = '_files';
         if (isReportType) {
             const title = reportMultipleGroups ? getTitle(reportType) : undefined;
-            if (reportType === 'files') {
-                const issuesForType = Array.from(issues._files);
-                if (issuesForType.length > 0) {
-                    printHeader(issuesForType.length, title);
-                    const sortedIssues = issuesForType.sort((a, b) => a.filePath.localeCompare(b.filePath));
-                    for (const issue of sortedIssues)
-                        console.log(toRelative(issue.filePath));
-                    totalIssues = totalIssues + issuesForType.length;
-                    printFooter();
-                }
-            }
-            else {
-                const issuesForType = Object.values(issues[reportType]).flatMap(Object.values);
-                if (issuesForType.length > 0) {
-                    printHeader(issuesForType.length, title);
-                    logIssueRecord(issuesForType);
-                    totalIssues = totalIssues + issuesForType.length;
-                    printFooter();
-                }
+            const issuesForType = Object.values(issues[reportType]).flatMap(Object.values);
+            if (issuesForType.length > 0) {
+                printHeader(issuesForType.length, title);
+                logIssueRecord(issuesForType);
+                totalIssues = totalIssues + issuesForType.length;
+                printFooter();
             }
         }
     }

package/dist/reporters/index.d.ts

@@ -1,8 +1,9 @@
 declare const _default: {
-    symbols: ({ report, issues, tagHints, configurationHints, noConfigHints, isShowProgress }: import("../index.js").ReporterOptions) => void;
+    symbols: ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }: import("../index.js").ReporterOptions) => void;
     compact: ({ report, issues, isShowProgress }: import("../index.js").ReporterOptions) => void;
     codeowners: ({ report, issues, isShowProgress, options }: import("../index.js").ReporterOptions) => void;
     disclosure: ({ report, issues }: import("../index.js").ReporterOptions) => void;
+    codeclimate: ({ report, issues }: import("../index.js").ReporterOptions) => Promise<void>;
     json: ({ report, issues, options }: import("../index.js").ReporterOptions) => Promise<void>;
     markdown: ({ report, issues }: import("../index.js").ReporterOptions) => void;
 };

package/dist/reporters/index.js

@@ -1,3 +1,4 @@
+import codeclimate from './codeclimate.js';
 import codeowners from './codeowners.js';
 import compact from './compact.js';
 import disclosure from './disclosure.js';
@@ -9,6 +10,7 @@ export default {
     compact,
     codeowners,
     disclosure,
+    codeclimate,
     json,
     markdown,
 };

package/dist/reporters/symbols.d.ts

@@ -1,3 +1,3 @@
 import type { ReporterOptions } from '../types/issues.js';
-declare const _default: ({ report, issues, tagHints, configurationHints, noConfigHints, isShowProgress }: ReporterOptions) => void;
+declare const _default: ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }: ReporterOptions) => void;
 export default _default;

package/dist/reporters/symbols.js

@@ -33,56 +33,39 @@ const logIssueRecord = (issues) => {
         issue.parentSymbol && table.cell('parentSymbol', print(issue.parentSymbol));
         issue.symbolType && table.cell('symbolType', print(issue.symbolType));
         const pos = issue.line === undefined ? '' : `:${issue.line}${issue.col === undefined ? '' : `:${issue.col}`}`;
-        const cell = `${relative(issue.filePath)}${pos}`;
+        const cell = issue.type === 'files' ? '' : `${relative(issue.filePath)}${pos}`;
         table.cell('filePath', print(cell));
         issue.isFixed && table.cell('fixed', print('(removed)'));
         table.newRow();
     }
     console.log(table.sort(sortByPos).print().trim());
 };
-export default ({ report, issues, tagHints, configurationHints, noConfigHints, isShowProgress }) => {
+export default ({ report, issues, tagHints, configurationHints, isDisableConfigHints, isTreatConfigHintsAsErrors, isShowProgress, }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     let totalIssues = 0;
-    for (const [reportType, isReportType] of Object.entries(report)) {
-        if (reportType === '_files')
-            continue;
+    for (let [reportType, isReportType] of Object.entries(report)) {
+        if (reportType === 'files')
+            reportType = '_files';
         if (isReportType) {
             const title = reportMultipleGroups && getTitle(reportType);
-            if (reportType === 'files') {
-                const issuesForType = Array.from(issues._files);
-                if (issuesForType.length > 0) {
-                    title && logTitle(title, issuesForType.length);
-                    const sortedIssues = issuesForType.sort((a, b) => a.filePath.localeCompare(b.filePath));
-                    for (const issue of sortedIssues) {
-                        const relPath = toRelative(issue.filePath);
-                        if (issue.isFixed)
-                            console.log(dim(`${relPath} (removed)`));
-                        else if (issue.severity === 'warn')
-                            console.log(dim(relPath));
-                        else
-                            console.log(relPath);
-                    }
-                    totalIssues = totalIssues + issuesForType.length;
-                }
-            }
-            else {
-                const issuesForType = Object.values(issues[reportType]).flatMap(Object.values);
-                if (issuesForType.length > 0) {
-                    title && logTitle(title, issuesForType.length);
-                    logIssueRecord(issuesForType);
-                    totalIssues = totalIssues + issuesForType.length;
-                }
+            const issuesForType = Object.values(issues[reportType]).flatMap(Object.values);
+            if (issuesForType.length > 0) {
+                title && logTitle(title, issuesForType.length);
+                logIssueRecord(issuesForType);
+                totalIssues = totalIssues + issuesForType.length;
             }
         }
     }
-    if (!noConfigHints) {
+    if (!isDisableConfigHints) {
         if (configurationHints.size > 0) {
-            logTitleDimmed('Configuration hints');
+            const _logTitle = isTreatConfigHintsAsErrors ? logTitle : logTitleDimmed;
+            const _color = isTreatConfigHintsAsErrors ? identity : dim;
+            _logTitle('Configuration hints', configurationHints.size);
             for (const hint of configurationHints) {
                 const { type, workspaceName, identifier } = hint;
                 const message = `Unused item in ${type}`;
                 const workspace = workspaceName && workspaceName !== ROOT_WORKSPACE_NAME ? ` (workspace: ${workspaceName})` : '';
-                console.warn(dim(`${message}${workspace}:`), identifier);
+                console.warn(_color(`${message}${workspace}:`), identifier);
             }
         }
         if (tagHints.size > 0) {

package/dist/schema/configuration.d.ts

@@ -15,6 +15,7 @@ export declare const knipConfigurationSchema: z.ZodObject<z.objectUtil.extendSha
     compilers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodString], z.ZodUnknown>, z.ZodString>, z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodString], z.ZodUnknown>, z.ZodPromise<z.ZodString>>]>>>;
     syncCompilers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodString], z.ZodUnknown>, z.ZodString>>>;
     asyncCompilers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[z.ZodString, z.ZodString], z.ZodUnknown>, z.ZodPromise<z.ZodString>>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, {
     include: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"files">, z.ZodLiteral<"dependencies">, z.ZodLiteral<"devDependencies">, z.ZodLiteral<"optionalPeerDependencies">, z.ZodLiteral<"unlisted">, z.ZodLiteral<"binaries">, z.ZodLiteral<"unresolved">, z.ZodLiteral<"exports">, z.ZodLiteral<"types">, z.ZodLiteral<"nsExports">, z.ZodLiteral<"nsTypes">, z.ZodLiteral<"duplicates">, z.ZodLiteral<"enumMembers">, z.ZodLiteral<"classMembers">]>, "many">>;
     exclude: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodLiteral<"files">, z.ZodLiteral<"dependencies">, z.ZodLiteral<"devDependencies">, z.ZodLiteral<"optionalPeerDependencies">, z.ZodLiteral<"unlisted">, z.ZodLiteral<"binaries">, z.ZodLiteral<"unresolved">, z.ZodLiteral<"exports">, z.ZodLiteral<"types">, z.ZodLiteral<"nsExports">, z.ZodLiteral<"nsTypes">, z.ZodLiteral<"duplicates">, z.ZodLiteral<"enumMembers">, z.ZodLiteral<"classMembers">]>, "many">>;
@@ -3330,6 +3331,7 @@ export declare const knipConfigurationSchema: z.ZodObject<z.objectUtil.extendSha
     }>]>>;
 }>, "strip", z.ZodTypeAny, {
     exclude?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
+    tags?: string[] | undefined;
     include?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
     node?: string | boolean | string[] | {
         config?: string | string[] | undefined;
@@ -4269,6 +4271,7 @@ export declare const knipConfigurationSchema: z.ZodObject<z.objectUtil.extendSha
     }> | undefined;
 }, {
     exclude?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
+    tags?: string[] | undefined;
     include?: ("dependencies" | "exports" | "files" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
     node?: string | boolean | string[] | {
         config?: string | string[] | undefined;

package/dist/schema/configuration.js

@@ -50,6 +50,7 @@ const rootConfigurationSchema = z.object({
     compilers: compilersSchema.optional(),
     syncCompilers: z.record(z.string(), syncCompilerSchema).optional(),
     asyncCompilers: z.record(z.string(), asyncCompilerSchema).optional(),
+    tags: z.array(z.string()).optional(),
 });
 const reportConfigSchema = z.object({
     include: z.array(issueTypeSchema).optional(),

package/dist/types/cli.d.ts

@@ -11,7 +11,7 @@ export interface CommandLineOptions {
     isExportsShorthand: boolean;
     isFilesShorthand: boolean;
     isFix: boolean;
-    isHideConfigHints: boolean;
+    isDisableConfigHints: boolean;
     isIncludeEntryExports: boolean;
     isIncludeLibs: boolean;
     isIsolateWorkspaces: boolean;

package/dist/types/config.d.ts

@@ -47,6 +47,7 @@ export interface Configuration {
     syncCompilers: SyncCompilers;
     asyncCompilers: AsyncCompilers;
     rootPluginConfigs: Partial<PluginsConfiguration>;
+    tags: string[];
 }
 type NormalizedGlob = string[];
 export type EnsuredPluginConfiguration = {

package/dist/types/issues.d.ts

@@ -32,7 +32,7 @@ export type IssueSet = Set<string>;
 export type IssueRecords = Record<string, Record<string, Issue>>;
 export type Issues = {
     files: IssueSet;
-    _files: Set<Issue>;
+    _files: IssueRecords;
     dependencies: IssueRecords;
     devDependencies: IssueRecords;
     optionalPeerDependencies: IssueRecords;
@@ -48,7 +48,7 @@ export type Issues = {
     classMembers: IssueRecords;
 };
 export type IssueType = keyof Issues;
-export type SymbolIssueType = Exclude<IssueType, 'files' | '_files'>;
+export type SymbolIssueType = Exclude<IssueType, 'files'>;
 export type Report = {
     [key in keyof Issues]: boolean;
 };
@@ -59,7 +59,8 @@ export type ReporterOptions = {
     counters: Counters;
     tagHints: TagHints;
     configurationHints: ConfigurationHints;
-    noConfigHints: boolean;
+    isDisableConfigHints: boolean;
+    isTreatConfigHintsAsErrors: boolean;
     cwd: string;
     isProduction: boolean;
     isShowProgress: boolean;

package/dist/typescript/SourceFile.d.ts

@@ -27,7 +27,6 @@ type PragmaMap = {
 };
 export interface BoundSourceFile extends ts.SourceFile {
     symbol?: SymbolWithExports;
-    resolvedModules?: ts.ModeAwareCache<ts.ResolvedModuleWithFailedLookupLocations>;
     locals?: SymbolTable;
     getNamedDeclarations?(): Map<string, readonly ts.Declaration[]>;
     scriptKind?: ts.ScriptKind;

package/dist/typescript/find-internal-references.js

@@ -1,6 +1,13 @@
 import ts from 'typescript';
 import { isIdChar } from '../util/regex.js';
 export const isType = (item) => item.type === 'type' || item.type === 'interface' || item.type === 'enum';
+const findInFlow = (flowNode, targetSymbol) => {
+    if (!flowNode?.node)
+        return false;
+    if (flowNode.node.symbol === targetSymbol)
+        return true;
+    return findInFlow(flowNode.antecedent, targetSymbol);
+};
 export const findInternalReferences = (item, sourceFile, typeChecker, referencedSymbolsInExport, isBindingElement) => {
     if (!item.symbol)
         return [0, false];
@@ -19,7 +26,7 @@ export const findInternalReferences = (item, sourceFile, typeChecker, referenced
             const isExportDeclaration = index === item.pos || index === item.pos + 1;
             if (!isExportDeclaration) {
                 const symbol = typeChecker.getSymbolAtLocation(ts.getTokenAtPosition(sourceFile, index));
-                if (symbol) {
+                if (symbol && id === symbol.escapedName) {
                     const isInExport = referencedSymbolsInExport.has(symbol);
                     if (isInExport)
                         isSymbolInExport = true;
@@ -30,7 +37,7 @@ export const findInternalReferences = (item, sourceFile, typeChecker, referenced
                     }
                     const declaration = symbol.declarations?.[0];
                     if (declaration) {
-                        if (item.symbol === declaration.name?.flowNode?.node?.symbol) {
+                        if (findInFlow(declaration.name?.flowNode, item.symbol)) {
                             return [++refCount, isSymbolInExport];
                         }
                         if (ts.isImportSpecifier(declaration) && symbols.has(symbol)) {

package/dist/util/cli-arguments.d.ts

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no test files, devDependencies)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --cache                  Enable caching\n  --cache-location         Change cache location (default: node_modules/.cache/knip)\n  --watch                  Watch mode\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --files                  Shortcut for --include files\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --allow-remove-files     Allow Knip to remove files (with --fix)\n  --include-libs           Include type definitions from external dependencies (default: false)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n  --production             Analyze only production source files (e.g. no test files, devDependencies)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -W, --workspace [dir]    Analyze a single workspace (default: analyze all configured workspaces)\n  --directory [dir]        Run process from a different directory (default: cwd)\n  --cache                  Enable caching\n  --cache-location         Change cache location (default: node_modules/.cache/knip)\n  --watch                  Watch mode\n  --no-gitignore           Don't use .gitignore\n  --include                Report only provided issue type(s), can be comma-separated or repeated (1)\n  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)\n  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --files                  Shortcut for --include files\n  --fix                    Fix issues\n  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)\n  --allow-remove-files     Allow Knip to remove files (with --fix)\n  --include-libs           Include type definitions from external dependencies (default: false)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --isolate-workspaces     Isolate workspaces into separate programs\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated\n  --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)\n  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of expensive functions and display stats table\n  -h, --help               Print this help text\n  -V, --version            Print version\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 declare const _default: {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;
@@ -35,6 +35,7 @@ declare const _default: {
     trace?: boolean | undefined;
     'trace-export'?: string | undefined;
     'trace-file'?: string | undefined;
+    'treat-config-hints-as-errors'?: boolean | undefined;
     tsConfig?: string | undefined;
     version?: boolean | undefined;
     watch?: boolean | undefined;

package/dist/util/cli-arguments.js

@@ -28,10 +28,11 @@ Options:
   -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)
   --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated
   --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)
-  --reporter               Select reporter: symbols, compact, codeowners, json, can be repeated (default: symbols)
+  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, can be repeated (default: symbols)
   --reporter-options       Pass extra options to the reporter (as JSON string, see example)
   --tags                   Include or exclude tagged exports
   --no-config-hints        Suppress configuration hints
+  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints
   --no-exit-code           Always exit with code zero (0)
   --max-issues             Maximum number of issues before non-zero exit code (default: 0)
   -d, --debug              Show debug output
@@ -94,6 +95,7 @@ try {
             trace: { type: 'boolean' },
             'trace-export': { type: 'string' },
             'trace-file': { type: 'string' },
+            'treat-config-hints-as-errors': { type: 'boolean' },
             tsConfig: { type: 'string', short: 't' },
             version: { type: 'boolean', short: 'V' },
             watch: { type: 'boolean' },

package/dist/util/issue-initializers.js

@@ -2,7 +2,7 @@ import { ISSUE_TYPES } from '../constants.js';
 export const initIssues = () => ({
     ...Object.fromEntries(ISSUE_TYPES.map(issueType => [issueType, {}])),
     files: new Set(),
-    _files: new Set(),
+    _files: {},
 });
 export const initCounters = () => ({
     ...Object.fromEntries(ISSUE_TYPES.map(issueType => [issueType, 0])),

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.45.0";
+export declare const version = "5.46.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.45.0';
+export const version = '5.46.0';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "knip",
-  "version": "5.45.0",
+  "version": "5.46.0",
   "description": "Find and fix unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {
     "type": "git",
-    "url": "https://github.com/webpro-nl/knip",
+    "url": "git+https://github.com/webpro-nl/knip.git",
     "directory": "packages/knip"
   },
   "bugs": "https://github.com/webpro-nl/knip/issues",
@@ -30,8 +30,8 @@
   ],
   "main": "./dist/index.js",
   "bin": {
-    "knip": "./bin/knip.js",
-    "knip-bun": "./bin/knip-bun.js"
+    "knip": "bin/knip.js",
+    "knip-bun": "bin/knip-bun.js"
   },
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -49,7 +49,7 @@
     "qa": "bun lint && bun run build && bun knip && bun knip:production && bun run test",
     "release": "release-it",
     "create-plugin": "bun ./scripts/create-new-plugin.ts",
-    "postcreate-plugin": "bun run build && biome format --write schema.json schema-jsonc.json src/ConfigurationValidator.ts",
+    "postcreate-plugin": "bun run build && biome format --write schema.json schema-jsonc.json src/schema/plugins.ts",
     "generate-plugin-defs": "node ./scripts/generate-plugin-defs.js && biome check --write src/plugins/index.ts src/types/PluginNames.ts src/schema/plugins.ts"
   },
   "files": [
@@ -90,7 +90,7 @@
     "@types/webpack": "^5.28.5",
     "@wdio/types": "^9.5.0",
     "glob": "^10.4.2",
-    "release-it": "^18.1.2",
+    "release-it": "^19.0.0-next.1",
     "type-fest": "^4.31.0",
     "typescript": "^5.5.2"
   },

package/schema.json

@@ -102,6 +102,11 @@
       "title": "Include entry files when reporting unused exports",
       "type": "boolean"
     },
+    "tags": {
+      "title": "Exclude (-) or include (+) exports with the specified JSDoc/TSDoc tags",
+      "examples": ["+custom", "-lintignore", "-@internal"],
+      "$ref": "#/definitions/list"
+    },
     "workspaces": {
       "title": "Configuration for workspaces",
       "type": "object",