knip 2.7.1 → 2.8.1

package/README.md

@@ -136,6 +136,7 @@ Using workspaces in a monorepo? Please see [workspaces][1] for more details abou
       -n, --no-progress        Don't show dynamic progress updates
       --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)
       --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+      --no-config-hints        Suppress 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

package/dist/ConfigurationChief.d.ts

@@ -44,6 +44,7 @@ export declare class ConfigurationChief {
             duplicates: import("./types/issues.js").IssueSeverity;
             enumMembers: import("./types/issues.js").IssueSeverity;
             classMembers: import("./types/issues.js").IssueSeverity;
+            binaries: import("./types/issues.js").IssueSeverity;
         };
         include: string[];
         exclude: string[];
@@ -67,5 +68,6 @@ export declare class ConfigurationChief {
     getIssueTypesToReport(): import("./types/issues.js").Report;
     findWorkspaceByFilePath(filePath: string): Workspace | undefined;
     findWorkspaceByPackageName(packageName: string): Workspace | undefined;
+    getUnusedIgnoredWorkspaces(): string[];
 }
 export {};

package/dist/ConfigurationChief.js

@@ -264,4 +264,9 @@ export class ConfigurationChief {
     findWorkspaceByPackageName(packageName) {
         return this.workspaces.find(workspace => workspace.pkgName === packageName);
     }
+    getUnusedIgnoredWorkspaces() {
+        const ignoredWorkspaceNames = this.config.ignoreWorkspaces;
+        const workspaceNames = this.getAllWorkspaces();
+        return ignoredWorkspaceNames.filter(workspaceName => !workspaceNames.includes(workspaceName));
+    }
 }

package/dist/DependencyDeputy.d.ts

@@ -1,5 +1,5 @@
 import { Workspace } from './ConfigurationChief.js';
-import type { Issue } from './types/issues.js';
+import type { ConfigurationHints, Issue } from './types/issues.js';
 import type { WorkspaceManifests } from './types/workspace.js';
 import type { PeerDependencies, InstalledBinaries } from './types/workspace.js';
 import type { PackageJson } from 'type-fest';
@@ -10,6 +10,7 @@ export declare class DependencyDeputy {
     isStrict: boolean;
     _manifests: WorkspaceManifests;
     referencedDependencies: Map<string, Set<string>>;
+    referencedBinaries: Map<string, Set<string>>;
     peerDependencies: Map<string, PeerDependencies>;
     installedBinaries: Map<string, InstalledBinaries>;
     constructor({ isStrict }: Options);
@@ -38,13 +39,16 @@ export declare class DependencyDeputy {
     setInstalledBinaries(workspaceName: string, installedBinaries: Map<string, Set<string>>): void;
     getInstalledBinaries(workspaceName: string): InstalledBinaries | undefined;
     addReferencedDependency(workspaceName: string, packageName: string): void;
+    addReferencedBinary(workspaceName: string, binaryName: string): void;
     addPeerDependencies(workspaceName: string, peerDependencies: Map<string, Set<string>>): void;
     getPeerDependencies(workspaceName: string, dependency: string): string[];
     maybeAddReferencedExternalDependency(workspace: Workspace, packageName: string): boolean;
+    maybeAddReferencedBinary(workspace: Workspace, binaryName: string): boolean;
     private isInDependencies;
     settleDependencyIssues(): {
         dependencyIssues: Issue[];
         devDependencyIssues: Issue[];
+        configurationHints: ConfigurationHints;
     };
 }
 export {};

package/dist/DependencyDeputy.js

@@ -1,16 +1,17 @@
 import { isBuiltin } from 'node:module';
-import { fromBinary, isBinary } from './binaries/util.js';
 import { IGNORE_DEFINITELY_TYPED, IGNORED_DEPENDENCIES, IGNORED_GLOBAL_BINARIES } from './constants.js';
 import { isDefinitelyTyped, getDefinitelyTypedFor, getPackageFromDefinitelyTyped } from './util/modules.js';
 export class DependencyDeputy {
     isStrict;
     _manifests = new Map();
     referencedDependencies;
+    referencedBinaries;
     peerDependencies;
     installedBinaries;
     constructor({ isStrict }) {
         this.isStrict = isStrict;
         this.referencedDependencies = new Map();
+        this.referencedBinaries = new Map();
         this.peerDependencies = new Map();
         this.installedBinaries = new Map();
     }
@@ -60,6 +61,12 @@ export class DependencyDeputy {
         }
         this.referencedDependencies.get(workspaceName)?.add(packageName);
     }
+    addReferencedBinary(workspaceName, binaryName) {
+        if (!this.referencedBinaries.has(workspaceName)) {
+            this.referencedBinaries.set(workspaceName, new Set());
+        }
+        this.referencedBinaries.get(workspaceName)?.add(binaryName);
+    }
     addPeerDependencies(workspaceName, peerDependencies) {
         this.peerDependencies.set(workspaceName, peerDependencies);
     }
@@ -73,24 +80,6 @@ export class DependencyDeputy {
             return true;
         const workspaceNames = this.isStrict ? [workspace.name] : [workspace.name, ...[...workspace.ancestors].reverse()];
         const closestWorkspaceName = workspaceNames.find(name => this.isInDependencies(name, packageName));
-        if (isBinary(packageName)) {
-            const binaryName = fromBinary(packageName);
-            if (IGNORED_GLOBAL_BINARIES.includes(binaryName))
-                return true;
-            if (this.getWorkspaceManifest(workspace.name)?.ignoreBinaries.includes(binaryName))
-                return true;
-            for (const name of workspaceNames) {
-                const binaries = this.getInstalledBinaries(name);
-                if (binaries?.has(binaryName)) {
-                    const dependencies = binaries.get(binaryName);
-                    if (dependencies?.size) {
-                        dependencies.forEach(dependency => this.addReferencedDependency(name, dependency));
-                        return true;
-                    }
-                }
-            }
-            return false;
-        }
         if (this.getWorkspaceManifest(workspace.name)?.ignoreDependencies.includes(packageName))
             return true;
         const typesPackageName = !isDefinitelyTyped(packageName) && getDefinitelyTypedFor(packageName);
@@ -102,6 +91,25 @@ export class DependencyDeputy {
         }
         return false;
     }
+    maybeAddReferencedBinary(workspace, binaryName) {
+        if (IGNORED_GLOBAL_BINARIES.includes(binaryName))
+            return true;
+        this.addReferencedBinary(workspace.name, binaryName);
+        if (this.getWorkspaceManifest(workspace.name)?.ignoreBinaries.includes(binaryName))
+            return true;
+        const workspaceNames = this.isStrict ? [workspace.name] : [workspace.name, ...[...workspace.ancestors].reverse()];
+        for (const name of workspaceNames) {
+            const binaries = this.getInstalledBinaries(name);
+            if (binaries?.has(binaryName)) {
+                const dependencies = binaries.get(binaryName);
+                if (dependencies?.size) {
+                    dependencies.forEach(dependency => this.addReferencedDependency(name, dependency));
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
     isInDependencies(workspaceName, packageName) {
         const manifest = this._manifests.get(workspaceName);
         if (!manifest)
@@ -112,8 +120,10 @@ export class DependencyDeputy {
     settleDependencyIssues() {
         const dependencyIssues = [];
         const devDependencyIssues = [];
+        const configurationHints = new Set();
         for (const [workspaceName, { manifestPath, ignoreDependencies, ignoreBinaries }] of this._manifests.entries()) {
             const referencedDependencies = this.referencedDependencies.get(workspaceName);
+            const referencedBinaries = this.referencedBinaries.get(workspaceName);
             const installedBinaries = this.getInstalledBinaries(workspaceName);
             const ignoreBins = [...IGNORED_GLOBAL_BINARIES, ...ignoreBinaries];
             const ignoreDeps = [...IGNORED_DEPENDENCIES, ...ignoreDependencies];
@@ -146,17 +156,25 @@ export class DependencyDeputy {
                 }
                 return false;
             };
-            this.getProductionDependencies(workspaceName)
-                .filter(isNotIgnoredDependency)
+            const pd = this.getProductionDependencies(workspaceName);
+            const dd = this.getDevDependencies(workspaceName);
+            pd.filter(isNotIgnoredDependency)
                 .filter(isNotIgnoredBinary)
                 .filter(isNotReferencedDependency)
                 .forEach(symbol => dependencyIssues.push({ type: 'dependencies', filePath: manifestPath, symbol }));
-            this.getDevDependencies(workspaceName)
-                .filter(isNotIgnoredDependency)
+            dd.filter(isNotIgnoredDependency)
                 .filter(isNotIgnoredBinary)
                 .filter(isNotReferencedDependency)
                 .forEach(symbol => devDependencyIssues.push({ type: 'devDependencies', filePath: manifestPath, symbol }));
+            const isReferencedDep = (name) => !([...pd, ...dd].includes(name) && referencedDependencies?.has(name));
+            const isReferencedBin = (name) => !installedBinaries?.has(name) && referencedBinaries?.has(name);
+            ignoreDependencies
+                .filter(packageName => IGNORED_DEPENDENCIES.includes(packageName) || !isReferencedDep(packageName))
+                .forEach(identifier => configurationHints.add({ workspaceName, identifier, type: 'ignoreDependencies' }));
+            ignoreBinaries
+                .filter(binaryName => IGNORED_GLOBAL_BINARIES.includes(binaryName) || !isReferencedBin(binaryName))
+                .forEach(identifier => configurationHints.add({ workspaceName, identifier, type: 'ignoreBinaries' }));
         }
-        return { dependencyIssues, devDependencyIssues };
+        return { dependencyIssues, devDependencyIssues, configurationHints };
     }
 }

package/dist/IssueCollector.d.ts

@@ -1,4 +1,4 @@
-import type { Issue, Rules } from './types/issues.js';
+import type { ConfigurationHint, Issue, Rules } from './types/issues.js';
 type IssueCollectorOptions = {
     cwd: string;
     rules: Rules;
@@ -9,6 +9,7 @@ export declare class IssueCollector {
     private issues;
     private counters;
     private referencedFiles;
+    private configurationHints;
     constructor({ cwd, rules }: IssueCollectorOptions);
     addFileCounts({ processed, unused }: {
         processed: number;
@@ -16,9 +17,11 @@ export declare class IssueCollector {
     }): void;
     addFilesIssues(filePaths: string[]): void;
     addIssue(issue: Issue): void;
+    addConfigurationHint(issue: ConfigurationHint): void;
     getIssues(): {
         issues: import("./types/issues.js").Issues;
         counters: import("./types/issues.js").Counters;
+        configurationHints: Set<unknown>;
     };
 }
 export {};

package/dist/IssueCollector.js

@@ -6,6 +6,7 @@ export class IssueCollector {
     issues = initIssues();
     counters = initCounters();
     referencedFiles = new Set();
+    configurationHints = new Set();
     constructor({ cwd, rules }) {
         this.cwd = cwd;
         this.rules = rules;
@@ -32,10 +33,14 @@ export class IssueCollector {
             this.counters[issue.type]++;
         }
     }
+    addConfigurationHint(issue) {
+        this.configurationHints.add(issue);
+    }
     getIssues() {
         return {
             issues: this.issues,
             counters: this.counters,
+            configurationHints: this.configurationHints,
         };
     }
 }

package/dist/cli.js

@@ -9,7 +9,7 @@ import { cwd, resolve } from './util/path.js';
 import { Performance } from './util/Performance.js';
 import { version } from './version.js';
 import { main } from './index.js';
-const { debug: isDebug = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, performance: isObservePerf = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, version: isVersion, } = parsedArgValues;
+const { debug: isDebug = false, help: isHelp, 'max-issues': maxIssues = '0', 'no-config-hints': noConfigHints = false, 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, performance: isObservePerf = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, version: isVersion, } = parsedArgValues;
 if (isHelp) {
     console.log(helpText);
     process.exit(0);
@@ -23,7 +23,7 @@ const printReport = reporter in reporters ? reporters[reporter] : await _load(re
 const run = async () => {
     try {
         const perfObserver = new Performance(isObservePerf);
-        const { report, issues, counters, rules } = await main({
+        const { report, issues, counters, rules, configurationHints } = await main({
             cwd,
             tsConfigFile: tsConfig,
             gitignore: !isNoGitIgnore,
@@ -31,7 +31,15 @@ const run = async () => {
             isProduction,
             isShowProgress,
         });
-        await printReport({ report, issues, cwd, isProduction, options: reporterOptions });
+        await printReport({
+            report,
+            issues,
+            configurationHints,
+            noConfigHints,
+            cwd,
+            isProduction,
+            options: reporterOptions,
+        });
         const totalErrorCount = Object.keys(report)
             .filter(reportGroup => report[reportGroup] && rules[reportGroup] === 'error')
             .reduce((errorCount, reportGroup) => errorCount + counters[reportGroup], 0);

package/dist/constants.js

@@ -6,6 +6,7 @@ export const TEST_FILE_PATTERNS = [
     '**/{test,__tests__}/**/*.{js,jsx,ts,tsx,mjs,cjs}',
 ];
 export const IGNORED_GLOBAL_BINARIES = [
+    'bash',
     'bun',
     'deno',
     'git',
@@ -14,6 +15,7 @@ export const IGNORED_GLOBAL_BINARIES = [
     'npx',
     'pnpm',
     'yarn',
+    'cat',
     'cd',
     'cp',
     'echo',
@@ -49,6 +51,7 @@ export const ISSUE_TYPES = [
     'dependencies',
     'devDependencies',
     'unlisted',
+    'binaries',
     'unresolved',
     'exports',
     'nsExports',
@@ -63,6 +66,7 @@ export const ISSUE_TYPE_TITLE = {
     dependencies: 'Unused dependencies',
     devDependencies: 'Unused devDependencies',
     unlisted: 'Unlisted dependencies',
+    binaries: 'Unresolved binaries',
     unresolved: 'Unresolved imports',
     exports: 'Unused exports',
     nsExports: 'Unused exports in namespaces',

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export declare const main: (unresolvedConfiguration: CommandLineOptions) => Prom
     issues: import("./types/issues.js").Issues;
     counters: import("./types/issues.js").Counters;
     rules: import("./types/issues.js").Rules;
+    configurationHints: Set<unknown>;
 }>;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { _getDependenciesFromScripts } from './binaries/index.js';
+import { fromBinary, isBinary } from './binaries/util.js';
 import { ConfigurationChief } from './ConfigurationChief.js';
 import { ConsoleStreamer } from './ConsoleStreamer.js';
 import { ROOT_WORKSPACE_NAME } from './constants.js';
@@ -47,14 +48,16 @@ export const main = async (unresolvedConfiguration) => {
             }
         }
         else {
-            if (isInNodeModules(specifier)) {
-                const packageName = getPackageNameFromFilePath(specifier);
-                const isHandled = deputy.maybeAddReferencedExternalDependency(workspace, packageName);
+            if (isBinary(specifier)) {
+                const binaryName = fromBinary(specifier);
+                const isHandled = deputy.maybeAddReferencedBinary(workspace, binaryName);
                 if (!isHandled)
-                    collector.addIssue({ type: 'unlisted', filePath: containingFilePath, symbol: packageName });
+                    collector.addIssue({ type: 'binaries', filePath: containingFilePath, symbol: binaryName });
             }
             else {
-                const packageName = getPackageNameFromModuleSpecifier(specifier);
+                const packageName = isInNodeModules(specifier)
+                    ? getPackageNameFromFilePath(specifier)
+                    : getPackageNameFromModuleSpecifier(specifier);
                 const isHandled = deputy.maybeAddReferencedExternalDependency(workspace, packageName);
                 if (!isHandled)
                     collector.addIssue({ type: 'unlisted', filePath: containingFilePath, symbol: specifier });
@@ -296,12 +299,15 @@ export const main = async (unresolvedConfiguration) => {
         }
     }
     if (isReportDependencies) {
-        const { dependencyIssues, devDependencyIssues } = deputy.settleDependencyIssues();
+        const { dependencyIssues, devDependencyIssues, configurationHints } = deputy.settleDependencyIssues();
         dependencyIssues.forEach(issue => collector.addIssue(issue));
         if (!isProduction)
             devDependencyIssues.forEach(issue => collector.addIssue(issue));
+        configurationHints.forEach(hint => collector.addConfigurationHint(hint));
     }
-    const { issues, counters } = collector.getIssues();
+    const unusedIgnoredWorkspaces = chief.getUnusedIgnoredWorkspaces();
+    unusedIgnoredWorkspaces.forEach(identifier => collector.addConfigurationHint({ type: 'ignoreWorkspaces', identifier }));
+    const { issues, counters, configurationHints } = collector.getIssues();
     streamer.clear();
-    return { report, issues, counters, rules };
+    return { report, issues, counters, rules, configurationHints };
 };

package/dist/reporters/index.d.ts

@@ -1,5 +1,5 @@
 declare const _default: {
-    symbols: ({ report, issues }: import("../index.js").ReporterOptions) => void;
+    symbols: ({ report, issues, configurationHints, noConfigHints }: import("../index.js").ReporterOptions) => void;
     compact: ({ report, issues }: import("../index.js").ReporterOptions) => void;
     codeowners: ({ report, issues, options }: import("../index.js").ReporterOptions) => void;
     json: ({ report, issues, options }: import("../index.js").ReporterOptions) => Promise<void>;

package/dist/reporters/symbols.d.ts

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

package/dist/reporters/symbols.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import EasyTable from 'easy-table';
+import { ROOT_WORKSPACE_NAME } from '../constants.js';
 import { relative } from '../util/path.js';
 import { getTitle, logTitle, logIssueSet, identity } from './util.js';
 const TRUNCATE_WIDTH = 40;
@@ -16,7 +17,7 @@ const logIssueRecord = (issues) => {
     });
     console.log(table.sort(['filePath', 'parentSymbol', 'symbol']).print().trim());
 };
-export default ({ report, issues }) => {
+export default ({ report, issues, configurationHints, noConfigHints }) => {
     const reportMultipleGroups = Object.values(report).filter(Boolean).length > 1;
     let totalIssues = 0;
     for (const [reportType, isReportType] of Object.entries(report)) {
@@ -38,6 +39,15 @@ export default ({ report, issues }) => {
             totalIssues = totalIssues + issuesForType.length;
         }
     }
+    if (!noConfigHints && configurationHints.size > 0) {
+        logTitle('Configuration issues', configurationHints.size);
+        configurationHints.forEach(hint => {
+            const { type, workspaceName, identifier } = hint;
+            const message = `Unused item in ${type}`;
+            const workspace = workspaceName && workspaceName !== ROOT_WORKSPACE_NAME ? ` (workspace: ${workspaceName})` : ``;
+            console.warn(chalk.grey(`${message}${workspace}:`), identifier);
+        });
+    }
     if (totalIssues === 0) {
         console.log('✂️  Excellent, Knip found no issues.');
     }

package/dist/types/issues.d.ts

@@ -23,6 +23,7 @@ export type Issues = {
     dependencies: IssueRecords;
     devDependencies: IssueRecords;
     unlisted: IssueRecords;
+    binaries: IssueRecords;
     unresolved: IssueRecords;
     exports: IssueRecords;
     types: IssueRecords;
@@ -41,6 +42,8 @@ export type Counters = Record<IssueType | 'processed' | 'total', number>;
 export type ReporterOptions = {
     report: Report;
     issues: Issues;
+    configurationHints: ConfigurationHints;
+    noConfigHints: boolean;
     cwd: string;
     workingDir: string;
     isProduction: boolean;
@@ -49,3 +52,9 @@ export type ReporterOptions = {
 export type Reporter = (options: ReporterOptions) => void;
 export type IssueSeverity = 'error' | 'warn' | 'off';
 export type Rules = Record<IssueType, IssueSeverity>;
+export type ConfigurationHints = Set<ConfigurationHint>;
+export type ConfigurationHint = {
+    type: 'ignoreBinaries' | 'ignoreDependencies' | 'ignoreWorkspaces';
+    identifier: string;
+    workspaceName?: string;
+};

package/dist/typescript/getImportsAndExports.js

@@ -1,5 +1,6 @@
 import { isBuiltin } from 'node:module';
 import ts from 'typescript';
+import { getOrSet } from '../util/map.js';
 import { isInNodeModules } from '../util/path.js';
 import { isDeclarationFileExtension, isAccessExpression, getAccessExpressionName } from './ast-helpers.js';
 import getExportVisitors from './visitors/exports/index.js';
@@ -22,17 +23,14 @@ export const getImportsAndExports = (sourceFile, options) => {
     const addInternalImport = ({ identifier, specifier, symbol, filePath, isDynamic }) => {
         const isStar = identifier === '*';
         const isReExported = Boolean(isStar && !symbol);
-        if (!internalImports.has(filePath)) {
-            internalImports.set(filePath, {
-                specifier,
-                isStar,
-                isReExported,
-                isReExportedBy: new Set(),
-                symbols: new Set(),
-                isDynamic,
-            });
-        }
-        const internalImport = internalImports.get(filePath);
+        const internalImport = getOrSet(internalImports, filePath, {
+            specifier,
+            isStar,
+            isReExported,
+            isReExportedBy: new Set(),
+            symbols: new Set(),
+            isDynamic,
+        });
         if (isReExported) {
             internalImport.isReExported = isReExported;
             internalImport.isReExportedBy.add(sourceFile.fileName);

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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --workspace              Analyze a single workspace (default: analyze all configured workspaces)\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,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  -n, --no-progress        Don't show dynamic progress updates\n  --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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  --debug-file-filter      Filter for files in debug output (regex as string)\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\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
+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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --workspace              Analyze a single workspace (default: analyze all configured workspaces)\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,unresolved\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  -n, --no-progress        Don't show dynamic progress updates\n  --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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  --debug-file-filter      Filter for files in debug output (regex as string)\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\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
 declare const _default: {
     config: string | undefined;
     debug: boolean | undefined;
@@ -9,6 +9,7 @@ declare const _default: {
     help: boolean | undefined;
     include: string[] | undefined;
     'max-issues': string | undefined;
+    'no-config-hints': boolean | undefined;
     'no-exit-code': boolean | undefined;
     'no-gitignore': boolean | undefined;
     'no-progress': boolean | undefined;

package/dist/util/cli-arguments.js

@@ -17,6 +17,7 @@ Options:
   -n, --no-progress        Don't show dynamic progress updates
   --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)
   --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+  --no-config-hints        Suppress 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
@@ -50,6 +51,7 @@ try {
             help: { type: 'boolean', short: 'h' },
             include: { type: 'string', multiple: true },
             'max-issues': { type: 'string' },
+            'no-config-hints': { type: 'boolean' },
             'no-exit-code': { type: 'boolean' },
             'no-gitignore': { type: 'boolean' },
             'no-progress': { type: 'boolean', short: 'n' },

package/dist/util/get-included-issue-types.js

@@ -1,7 +1,7 @@
 import { ISSUE_TYPES } from '../constants.js';
 export const getIncludedIssueTypes = (cliArgs, { include = [], exclude = [], isProduction = false } = {}) => {
     if (cliArgs.dependencies) {
-        cliArgs.include = [...cliArgs.include, 'dependencies', 'unlisted', 'unresolved'];
+        cliArgs.include = [...cliArgs.include, 'dependencies', 'unlisted', 'binaries', 'unresolved'];
     }
     if (cliArgs.exports) {
         const exports = ['exports', 'nsExports', 'classMembers', 'types', 'nsTypes', 'enumMembers', 'duplicates'];

package/dist/util/map.d.ts

@@ -0,0 +1 @@
+export declare const getOrSet: <K extends string, V, T extends Map<K, V>>(map: T, key: K, value: V) => NonNullable<V>;

package/dist/util/map.js

@@ -0,0 +1,6 @@
+export const getOrSet = (map, key, value) => {
+    if (!map.has(key)) {
+        map.set(key, value);
+    }
+    return map.get(key);
+};

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.7.1";
+export declare const version = "2.8.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '2.7.1';
+export const version = '2.8.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",
@@ -74,7 +74,7 @@
     "@typescript-eslint/parser": "5.57.1",
     "c8": "7.13.0",
     "eslint": "8.37.0",
-    "eslint-import-resolver-typescript": "3.5.4",
+    "eslint-import-resolver-typescript": "3.5.5",
     "eslint-plugin-import": "2.27.5",
     "eslint-plugin-n": "15.7.0",
     "globstar": "1.0.0",
@@ -83,7 +83,7 @@
     "remark-cli": "11.0.0",
     "remark-preset-webpro": "0.0.2",
     "tsx": "3.12.6",
-    "type-fest": "3.7.2"
+    "type-fest": "3.8.0"
   },
   "engines": {
     "node": ">=16.17.0 <17 || >=18.6.0"