knip 6.13.0 → 6.14.0

package/dist/plugins/sst/resolveFromAST.js

@@ -1,6 +1,6 @@
 import { Visitor } from 'oxc-parser';
 import { collectPropertyValues, getImportMap } from '../../typescript/ast-helpers.js';
-import { parseFile } from '../../typescript/ast-nodes.js';
+import { _parseFile } from '../../typescript/ast-nodes.js';
 import { toDeferResolveProductionEntry } from '../../util/input.js';
 import { dirname } from '../../util/path.js';
 import { _resolveSync } from '../../util/resolve.js';
@@ -27,7 +27,7 @@ export const getInputsFromHandlers = (program, options) => {
                             if (resolvedPath) {
                                 const stackText = options.readFile(resolvedPath);
                                 if (stackText) {
-                                    const stackResult = parseFile('stack.ts', stackText);
+                                    const stackResult = _parseFile('stack.ts', stackText);
                                     addHandlers(collectPropertyValues(stackResult.program, 'handler'));
                                 }
                             }

package/dist/plugins/tailwind/index.js

@@ -3,7 +3,7 @@ import compiler from './compiler.js';
 const title = 'Tailwind';
 const enablers = ['tailwindcss', '@tailwindcss/vite', '@tailwindcss/postcss', '@tailwindcss/cli'];
 const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
-const entry = ['tailwind.config.{js,cjs,mjs,ts}'];
+const entry = ['tailwind.config.{js,cjs,mjs,ts,cts,mts}'];
 const registerCompilers = ({ registerCompiler, hasDependency }) => {
     if (enablers.some(enabler => hasDependency(enabler)))
         registerCompiler({ extension: '.css', compiler });

package/dist/plugins/wxt/index.js

@@ -3,7 +3,7 @@ import { hasDependency } from '../../util/plugin.js';
 const title = 'WXT';
 const enablers = ['wxt'];
 const isEnabled = ({ dependencies }) => hasDependency(dependencies, enablers);
-const config = ['wxt.config.{js,mjs,ts}'];
+const config = ['wxt.config.{js,cjs,mjs,ts,cts,mts}'];
 const production = ['entrypoints/**/*'];
 const resolveConfig = async (localConfig) => {
     const inputs = [];

package/dist/reporters/trace.js

@@ -35,7 +35,7 @@ export default ({ graph, explorer, options, workspaceFilePathFilter }) => {
         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])
+            if (explorer.isReferenced(node.filePath, node.identifier, { traverseEntries: false })[0])
                 return true;
             if (explorer.hasStrictlyNsReferences(node.filePath, node.identifier)[0])
                 return true;
@@ -48,7 +48,11 @@ export default ({ graph, explorer, options, workspaceFilePathFilter }) => {
                 memberStatuses = [];
                 for (const m of exp.members) {
                     const id = `${node.identifier}.${m.identifier}`;
-                    const referenced = m.hasRefsInFile || explorer.isReferenced(node.filePath, id, { includeEntryExports: true })[0];
+                    const referenced = m.hasRefsInFile ||
+                        explorer.isReferenced(node.filePath, id, {
+                            traverseEntries: true,
+                            treatStarAtEntryAsReferenced: true,
+                        })[0];
                     memberStatuses.push({ identifier: m.identifier, referenced });
                 }
             }

package/dist/run.js

@@ -9,6 +9,7 @@ import { IssueCollector } from './IssueCollector.js';
 import { ProjectPrincipal } from './ProjectPrincipal.js';
 import watchReporter from './reporters/watch.js';
 import { debugLogObject } from './util/debug.js';
+import { flushGitignoreCache, initGitignoreCache } from './util/gitignore-cache.js';
 import { flushGlobCache, initGlobCache } from './util/glob-cache.js';
 import { getGitIgnoredHandler } from './util/glob-core.js';
 import { getModuleSourcePathHandler, getWorkspaceManifestHandler } from './util/to-source-path.js';
@@ -16,8 +17,10 @@ import { getSessionHandler } from './util/watch.js';
 export const run = async (options) => {
     debugLogObject('*', 'Unresolved configuration', options);
     debugLogObject('*', 'Included issue types', options.includedIssueTypes);
-    if (options.isCache)
+    if (options.isCache) {
         initGlobCache(options.cacheLocation);
+        initGitignoreCache(options.cacheLocation);
+    }
     const chief = new ConfigurationChief(options);
     const deputy = new DependencyDeputy(options);
     const streamer = new ConsoleStreamer(options);
@@ -83,8 +86,10 @@ export const run = async (options) => {
     const { issues, counters, tagHints, configurationHints } = collector.getIssues();
     if (!options.isWatch)
         streamer.clear();
-    if (options.isCache)
+    if (options.isCache) {
         flushGlobCache();
+        flushGitignoreCache();
+    }
     return {
         results: {
             issues,

package/dist/typescript/ast-helpers.js

@@ -1,7 +1,7 @@
 import { Visitor } from 'oxc-parser';
 import stripJsonComments from 'strip-json-comments';
 import { extname, isInternal } from '../util/path.js';
-import { getStringValue, isStringLiteral, parseFile } from './ast-nodes.js';
+import { _parseFile, getStringValue, isStringLiteral } from './ast-nodes.js';
 export const getPropertyKey = (prop) => prop?.key?.type === 'Identifier' ? prop.key.name : getStringValue(prop?.key);
 export const getImportMap = (program) => {
     const importMap = new Map();
@@ -191,7 +191,7 @@ export const collectStringLiterals = (sourceText, filePath) => {
             collectJsonStringLiterals(JSON.parse(stripJsonComments(sourceText, { trailingCommas: true })), literals);
             return literals;
         }
-        const result = parseFile(filePath, sourceText);
+        const result = _parseFile(filePath, sourceText);
         const visitor = new Visitor({
             Literal(node) {
                 if (typeof node.value === 'string')

package/dist/typescript/ast-nodes.d.ts

@@ -2,7 +2,7 @@ import { type TSEnumDeclaration, type TSModuleDeclaration } from 'oxc-parser';
 import type { GetImportsAndExportsOptions, IgnoreExportsUsedInFile } from '../types/config.ts';
 import type { SymbolType } from '../types/issues.ts';
 import type { ExportMember } from '../types/module-graph.ts';
-export declare const parseFile: (filePath: string, sourceText: string) => import("oxc-parser").ParseResult;
+export declare const _parseFile: (filePath: string, sourceText: string) => import("oxc-parser").ParseResult;
 export type ResolveModule = (specifier: string, containingFile: string) => ResolvedModule | undefined;
 export interface ResolvedModule {
     resolvedFileName: string;

package/dist/typescript/ast-nodes.js

@@ -1,16 +1,18 @@
 import { parseSync, rawTransferSupported, } from 'oxc-parser';
 import { DEFAULT_EXTENSIONS, FIX_FLAGS, SYMBOL_TYPE } from '../constants.js';
 import { extname } from '../util/path.js';
+import { timerify } from '../util/Performance.js';
 import { EMPTY_TAGS } from './visitors/jsdoc.js';
 const defaultParseOptions = {
     sourceType: 'unambiguous',
     experimentalRawTransfer: rawTransferSupported(),
 };
-export const parseFile = (filePath, sourceText) => {
+const parseFile = (filePath, sourceText) => {
     const ext = extname(filePath);
     const parseFileName = DEFAULT_EXTENSIONS.has(ext) ? filePath : `${filePath}.ts`;
     return parseSync(parseFileName, sourceText, defaultParseOptions);
 };
+export const _parseFile = timerify(parseFile);
 export const buildLineStarts = (sourceText) => {
     const starts = [0];
     for (let i = 0; i < sourceText.length; i++) {

package/dist/typescript/get-imports-and-exports.js

@@ -6,9 +6,9 @@ import { timerify } from '../util/Performance.js';
 import { dirname, isInNodeModules, resolve } from '../util/path.js';
 import { shouldIgnore } from '../util/tag.js';
 import { extractImportsFromComments } from './comments.js';
-import { buildLineStarts, getLineAndCol, parseFile, shouldCountRefs, } from './ast-nodes.js';
+import { _parseFile, buildLineStarts, getLineAndCol, shouldCountRefs, } from './ast-nodes.js';
 import { buildJSDocTagLookup } from './visitors/jsdoc.js';
-import { walkAST } from './visitors/walk.js';
+import { _walkAST } from './visitors/walk.js';
 const getImportsAndExports = (filePath, sourceText, resolveModule, options, ignoreExportsUsedInFile, skipExportsForFile, visitor, pluginCtx, cachedParseResult) => {
     const skipExports = skipExportsForFile || !options.isReportExports;
     const isDts = filePath.endsWith('.d.ts') || filePath.endsWith('.d.cts') || filePath.endsWith('.d.mts');
@@ -159,7 +159,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
             }
         }
     };
-    const result = cachedParseResult ?? parseFile(filePath, sourceText);
+    const result = cachedParseResult ?? _parseFile(filePath, sourceText);
     const lineStarts = buildLineStarts(sourceText);
     const getJSDocTags = buildJSDocTagLookup(result.comments, sourceText);
     let hasNodeModuleImport = false;
@@ -255,7 +255,7 @@ const getImportsAndExports = (filePath, sourceText, resolveModule, options, igno
         pluginCtx.addScript = (s) => scripts.add(s);
         pluginCtx.addImport = (spec, pos, mod) => addImport(spec, undefined, undefined, undefined, pos, mod);
     }
-    const localRefs = walkAST(result.program, sourceText, filePath, {
+    const localRefs = _walkAST(result.program, sourceText, filePath, {
         lineStarts,
         skipExports,
         options,

package/dist/typescript/visitors/walk.d.ts

@@ -81,5 +81,6 @@ export interface WalkState extends WalkContext {
 }
 export declare const isShadowed: (name: string, pos: number) => boolean;
 export declare function buildVisitor(pluginVisitorObjects: PluginVisitorObject[], includeLocalRefs?: boolean): Visitor;
-export declare function walkAST(program: Program, sourceText: string, filePath: string, ctx: WalkContext): Set<string> | undefined;
+declare function walkAST(program: Program, sourceText: string, filePath: string, ctx: WalkContext): Set<string> | undefined;
+export declare const _walkAST: typeof walkAST;
 export {};

package/dist/typescript/visitors/walk.js

@@ -2,6 +2,7 @@ import { Visitor, visitorKeys, } from 'oxc-parser';
 import { FIX_FLAGS, IMPORT_FLAGS, OPAQUE, SYMBOL_TYPE } from '../../constants.js';
 import { addValue } from '../../util/module-graph.js';
 import { isInNodeModules } from '../../util/path.js';
+import { timerify } from '../../util/Performance.js';
 import { getLineAndCol, getStringValue, isStringLiteral } from '../ast-nodes.js';
 import { EMPTY_TAGS } from './jsdoc.js';
 import { handleCallExpression, handleNewExpression } from './calls.js';
@@ -673,7 +674,7 @@ export function buildVisitor(pluginVisitorObjects, includeLocalRefs) {
     }
     return new Visitor(merged);
 }
-export function walkAST(program, sourceText, filePath, ctx) {
+function walkAST(program, sourceText, filePath, ctx) {
     const isJS = filePath.endsWith('.js') || filePath.endsWith('.mjs') || filePath.endsWith('.cjs') || filePath.endsWith('.jsx');
     state = {
         ...ctx,
@@ -780,3 +781,4 @@ export function walkAST(program, sourceText, filePath, ctx) {
     state = undefined;
     return localRefs;
 }
+export const _walkAST = timerify(walkAST);

package/dist/util/Performance.d.ts

@@ -13,6 +13,7 @@ declare class Performance {
     isEnabled: boolean;
     isTimerifyFunctions: boolean;
     isMemoryUsageEnabled: boolean;
+    isDurationEnabled: boolean;
     startTime: number;
     endTime: number;
     perfEntries: PerformanceEntry[];
@@ -21,7 +22,8 @@ declare class Performance {
     memId?: string;
     fnObserver?: PerformanceObserver;
     memObserver?: PerformanceObserver;
-    constructor({ isTimerifyFunctions, isMemoryUsageEnabled }: {
+    constructor({ isTimerifyFunctions, isMemoryUsageEnabled, isDurationEnabled }: {
+        isDurationEnabled?: boolean | undefined;
         isMemoryUsageEnabled?: boolean | undefined;
         isTimerifyFunctions?: boolean | undefined;
     });

package/dist/util/Performance.js

@@ -10,12 +10,14 @@ const { values } = parseArgs({
         'performance-fn': { type: 'string', multiple: true },
         memory: { type: 'boolean' },
         'memory-realtime': { type: 'boolean' },
+        duration: { type: 'boolean' },
     },
 });
 const timerifyOnlyFnName = values['performance-fn'];
 const isMemoryRealtime = !!values['memory-realtime'];
 const isTimerifyFunctions = !!values.performance || !!timerifyOnlyFnName;
 const isMemoryUsageEnabled = !!values.memory || isMemoryRealtime;
+const isDurationEnabled = !!values.duration;
 export const timerify = (fn, name = fn.name) => {
     if (!isTimerifyFunctions)
         return fn;
@@ -36,6 +38,7 @@ class Performance {
     isEnabled;
     isTimerifyFunctions;
     isMemoryUsageEnabled;
+    isDurationEnabled;
     startTime = 0;
     endTime = 0;
     perfEntries = [];
@@ -44,10 +47,11 @@ class Performance {
     memId;
     fnObserver;
     memObserver;
-    constructor({ isTimerifyFunctions = false, isMemoryUsageEnabled = false }) {
+    constructor({ isTimerifyFunctions = false, isMemoryUsageEnabled = false, isDurationEnabled = false }) {
         this.isEnabled = isTimerifyFunctions || isMemoryUsageEnabled;
         this.isTimerifyFunctions = isTimerifyFunctions;
         this.isMemoryUsageEnabled = isMemoryUsageEnabled;
+        this.isDurationEnabled = isDurationEnabled;
         this.startTime = performance.now();
         const instanceId = Math.floor(performance.now() * 100);
         this.perfId = `perf-${instanceId}`;
@@ -172,4 +176,4 @@ class Performance {
         this.memObserver?.disconnect();
     }
 }
-export const perfObserver = new Performance({ isTimerifyFunctions, isMemoryUsageEnabled });
+export const perfObserver = new Performance({ isTimerifyFunctions, isMemoryUsageEnabled, isDurationEnabled });

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

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help               Print this help text\n  -V, --version            Print version\n  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]      Configuration file path\n                           (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n  --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)\n\nMode\n  --cache                  Enable caching\n  --cache-location         Change cache location (default: node_modules/.cache/knip)\n  --include-entry-exports  Include entry files when reporting unused exports\n  --no-gitignore           Don't respect .gitignore\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  --watch                  Watch mode\n\nScope\n  -W, --workspace [filter] Filter workspaces by name, directory, or glob (can be repeated)\n  --directory [dir]        Run process from a different directory (default: cwd)\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,catalog\n  --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n  --files                  Shortcut for --include files\n  --tags                   Include or exclude tagged exports\n\nFix\n  --fix                    Fix issues (modifies files in your repo)\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  --format                 Format modified files after --fix using the local formatter\n\nOutput\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 (default: symbols), can be repeated (3)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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  --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n  --max-show-issues        Maximum number of issues to display per type\n  --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug              Show debug output\n  --memory                 Measure memory usage and display data table\n  --memory-realtime        Log memory usage in realtime\n  --performance            Measure count and running time of key functions and display stats table\n  --performance-fn [name]  Measure only function [name]\n  --trace                  Show trace output\n  --trace-dependency [name] Show files that import the named dependency\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\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 dependencies, exports and files in your JavaScript and TypeScript projects\n\nUsage: knip [options]\n\nOptions:\n  -h, --help                   Print this help text\n  -V, --version                Print version\n  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)\n  -c, --config [file]          Configuration file path\n                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)\n      --use-tsconfig-files     Use tsconfig.json to define project files (override `project` patterns)\n  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)\n\nMode\n      --cache                  Enable caching\n      --cache-location         Change cache location (default: node_modules/.cache/knip)\n      --include-entry-exports  Include entry files when reporting unused exports\n      --no-gitignore           Don't respect .gitignore\n  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)\n  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  -w, --watch                  Watch mode\n\nScope\n  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)\n  -D, --directory [dir]        Run process from a different directory (default: cwd)\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,catalog\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --tags                   Include or exclude tagged exports\n\nFix\n  -f, --fix                    Fix issues (modifies files in your repo)\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  -F, --format                 Format modified files after --fix using the local formatter\n\nOutput\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 (default: symbols), can be repeated (3)\n      --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)\n      --max-show-issues        Maximum number of issues to display per type\n      --no-exit-code           Always exit with code zero (0)\n\nTroubleshooting\n  -d, --debug                  Show debug output\n      --memory                 Measure memory usage and display data table\n      --memory-realtime        Log memory usage in realtime\n      --performance            Measure count and running time of key functions and display stats table\n      --performance-fn [name]  Measure only function [name]\n  -u, --duration               Print total running time (zero overhead, no instrumentation)\n      --trace                  Show trace output\n      --trace-dependency [name]  Show files that import the named dependency\n      --trace-export [name]    Show trace output for named export(s)\n      --trace-file [file]      Show trace output for exports in file\n\n(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, json, codeclimate, markdown, disclosure, github-actions\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip --workspace @myorg/* --workspace '!@myorg/legacy'\n$ knip --workspace './apps/*' --workspace '@shared/utils'\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 type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
 export default function parseCLIArgs(): {
     cache?: boolean | undefined;
@@ -33,6 +33,7 @@ export default function parseCLIArgs(): {
     'preprocessor-options'?: string | undefined;
     reporter?: string[] | undefined;
     'reporter-options'?: string | undefined;
+    duration?: boolean | undefined;
     strict?: boolean | undefined;
     trace?: boolean | undefined;
     'trace-dependency'?: string | undefined;

package/dist/util/cli-arguments.js

@@ -4,60 +4,61 @@ export const helpText = `✂️  Find unused dependencies, exports and files in
 Usage: knip [options]
 
 Options:
-  -h, --help               Print this help text
-  -V, --version            Print version
-  -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)
-  -c, --config [file]      Configuration file path
-                           (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)
-  --use-tsconfig-files     Use tsconfig.json to define project files (override \`project\` patterns)
-  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)
+  -h, --help                   Print this help text
+  -V, --version                Print version
+  -n, --no-progress            Don't show dynamic progress updates (automatically enabled in CI environments)
+  -c, --config [file]          Configuration file path
+                               (default: [.]knip.json[c], knip.(js|ts), knip.config.(js|ts) or package.json#knip)
+      --use-tsconfig-files     Use tsconfig.json to define project files (override \`project\` patterns)
+  -t, --tsConfig [file]        TypeScript configuration path (default: tsconfig.json)
 
 Mode
-  --cache                  Enable caching
-  --cache-location         Change cache location (default: node_modules/.cache/knip)
-  --include-entry-exports  Include entry files when reporting unused exports
-  --no-gitignore           Don't respect .gitignore
-  --production             Analyze only production source files (e.g. no test files, devDependencies)
-  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
-  --watch                  Watch mode
+      --cache                  Enable caching
+      --cache-location         Change cache location (default: node_modules/.cache/knip)
+      --include-entry-exports  Include entry files when reporting unused exports
+      --no-gitignore           Don't respect .gitignore
+  -p, --production             Analyze only production source files (e.g. no test files, devDependencies)
+  -s, --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
+  -w, --watch                  Watch mode
 
 Scope
-  -W, --workspace [filter] Filter workspaces by name, directory, or glob (can be repeated)
-  --directory [dir]        Run process from a different directory (default: cwd)
-  --include                Report only provided issue type(s), can be comma-separated or repeated (1)
-  --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
-  --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
-  --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
-  --files                  Shortcut for --include files
-  --tags                   Include or exclude tagged exports
+  -W, --workspace [filter]     Filter workspaces by name, directory, or glob (can be repeated)
+  -D, --directory [dir]        Run process from a different directory (default: cwd)
+      --include                Report only provided issue type(s), can be comma-separated or repeated (1)
+      --exclude                Exclude provided issue type(s) from report, can be comma-separated or repeated (1)
+      --dependencies           Shortcut for --include dependencies,unlisted,binaries,unresolved,catalog
+      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates
+      --files                  Shortcut for --include files
+      --tags                   Include or exclude tagged exports
 
 Fix
-  --fix                    Fix issues (modifies files in your repo)
-  --fix-type               Fix only issues of type, can be comma-separated or repeated (2)
-  --allow-remove-files     Allow Knip to remove files (with --fix)
-  --format                 Format modified files after --fix using the local formatter
+  -f, --fix                    Fix issues (modifies files in your repo)
+      --fix-type               Fix only issues of type, can be comma-separated or repeated (2)
+      --allow-remove-files     Allow Knip to remove files (with --fix)
+  -F, --format                 Format modified files after --fix using the local formatter
 
 Output
-  --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 (default: symbols), can be repeated (3)
-  --reporter-options       Pass extra options to the reporter (as JSON string, see example)
-  --no-config-hints        Suppress configuration hints
-  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints
-  --max-issues             Maximum number of total issues before non-zero exit code (default: 0)
-  --max-show-issues        Maximum number of issues to display per type
-  --no-exit-code           Always exit with code zero (0)
+      --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 (default: symbols), can be repeated (3)
+      --reporter-options       Pass extra options to the reporter (as JSON string, see example)
+      --no-config-hints        Suppress configuration hints
+      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints
+      --max-issues             Maximum number of total issues before non-zero exit code (default: 0)
+      --max-show-issues        Maximum number of issues to display per type
+      --no-exit-code           Always exit with code zero (0)
 
 Troubleshooting
-  -d, --debug              Show debug output
-  --memory                 Measure memory usage and display data table
-  --memory-realtime        Log memory usage in realtime
-  --performance            Measure count and running time of key functions and display stats table
-  --performance-fn [name]  Measure only function [name]
-  --trace                  Show trace output
-  --trace-dependency [name] Show files that import the named dependency
-  --trace-export [name]    Show trace output for named export(s)
-  --trace-file [file]      Show trace output for exports in file
+  -d, --debug                  Show debug output
+      --memory                 Measure memory usage and display data table
+      --memory-realtime        Log memory usage in realtime
+      --performance            Measure count and running time of key functions and display stats table
+      --performance-fn [name]  Measure only function [name]
+  -u, --duration               Print total running time (zero overhead, no instrumentation)
+      --trace                  Show trace output
+      --trace-dependency [name]  Show files that import the named dependency
+      --trace-export [name]    Show trace output for named export(s)
+      --trace-file [file]      Show trace output for exports in file
 
 (1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, types, nsTypes, enumMembers, namespaceMembers, duplicates, catalog
 (2) Fixable issue types: dependencies, exports, types, files, catalog
@@ -83,14 +84,14 @@ export default function parseCLIArgs() {
             config: { type: 'string', short: 'c' },
             debug: { type: 'boolean', short: 'd' },
             dependencies: { type: 'boolean' },
-            directory: { type: 'string' },
+            directory: { type: 'string', short: 'D' },
             exclude: { type: 'string', multiple: true },
             exports: { type: 'boolean' },
             tags: { type: 'string', multiple: true },
             files: { type: 'boolean' },
-            fix: { type: 'boolean' },
+            fix: { type: 'boolean', short: 'f' },
             'fix-type': { type: 'string', multiple: true },
-            format: { type: 'boolean' },
+            format: { type: 'boolean', short: 'F' },
             'allow-remove-files': { type: 'boolean' },
             help: { type: 'boolean', short: 'h' },
             include: { type: 'string', multiple: true },
@@ -105,12 +106,13 @@ export default function parseCLIArgs() {
             'no-progress': { type: 'boolean', short: 'n' },
             performance: { type: 'boolean' },
             'performance-fn': { type: 'string' },
-            production: { type: 'boolean' },
+            production: { type: 'boolean', short: 'p' },
             preprocessor: { type: 'string', multiple: true },
             'preprocessor-options': { type: 'string' },
             reporter: { type: 'string', multiple: true },
             'reporter-options': { type: 'string' },
-            strict: { type: 'boolean' },
+            duration: { type: 'boolean', short: 'u' },
+            strict: { type: 'boolean', short: 's' },
             trace: { type: 'boolean' },
             'trace-dependency': { type: 'string' },
             'trace-export': { type: 'string' },
@@ -119,7 +121,7 @@ export default function parseCLIArgs() {
             tsConfig: { type: 'string', short: 't' },
             'use-tsconfig-files': { type: 'boolean' },
             version: { type: 'boolean', short: 'V' },
-            watch: { type: 'boolean' },
+            watch: { type: 'boolean', short: 'w' },
             workspace: { type: 'string', short: 'W', multiple: true },
         },
     }).values;

package/dist/util/disk-cache.d.ts

@@ -0,0 +1,10 @@
+export interface DiskCache<V> {
+    init: (cacheLocation: string) => void;
+    isEnabled: () => boolean;
+    get: (key: string) => V | undefined;
+    set: (key: string, value: V) => void;
+    delete: (key: string) => void;
+    clear: () => void;
+    flush: () => void;
+}
+export declare const createDiskCache: <V>(name: string) => DiskCache<V>;

package/dist/util/disk-cache.js

@@ -0,0 +1,62 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { deserialize, serialize } from 'node:v8';
+import { version } from '../version.js';
+import { debugLog } from './debug.js';
+import { isDirectory, isFile } from './fs.js';
+import { dirname } from './path.js';
+export const createDiskCache = (name) => {
+    const filename = `${name}-${version}.cache`;
+    let cacheFilePath;
+    let cache;
+    let isDirty = false;
+    return {
+        init(cacheLocation) {
+            cacheFilePath = path.resolve(cacheLocation, filename);
+            if (isFile(cacheFilePath)) {
+                try {
+                    cache = deserialize(fs.readFileSync(cacheFilePath));
+                }
+                catch {
+                    debugLog('*', `Error reading cache from ${cacheFilePath}`);
+                    cache = new Map();
+                }
+            }
+            else {
+                cache = new Map();
+            }
+        },
+        isEnabled: () => cache !== undefined,
+        get: key => cache?.get(key),
+        set(key, value) {
+            if (!cache)
+                return;
+            cache.set(key, value);
+            isDirty = true;
+        },
+        delete(key) {
+            if (cache?.delete(key))
+                isDirty = true;
+        },
+        clear() {
+            if (cache && cache.size > 0) {
+                cache.clear();
+                isDirty = true;
+            }
+        },
+        flush() {
+            if (!cache || !cacheFilePath || !isDirty)
+                return;
+            try {
+                const dir = dirname(cacheFilePath);
+                if (!isDirectory(dir))
+                    fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(cacheFilePath, serialize(cache));
+                isDirty = false;
+            }
+            catch {
+                debugLog('*', `Error writing cache to ${cacheFilePath}`);
+            }
+        },
+    };
+};

package/dist/util/file-entry-cache.d.ts

@@ -1,4 +1,3 @@
-import fs from 'node:fs';
 type MetaData<T> = {
     size: number;
     mtime: number;
@@ -16,14 +15,8 @@ export declare class FileEntryCache<T> {
     cache: Map<string, MetaData<T>>;
     normalizedEntries: Map<string, FileDescriptor<T>>;
     constructor(cacheId: string, _path: string);
-    removeNotFoundFiles(): void;
     getFileDescriptor(filePath: string): FileDescriptor<T>;
-    _getFileDescriptorUsingMtimeAndSize(filePath: string, fstat: fs.Stats): FileDescriptor<T>;
     removeEntry(entryName: string): void;
-    _getMetaForFileUsingMtimeAndSize(cacheEntry: FileDescriptor<T>): {
-        size: number;
-        mtime: number;
-    };
     reconcile(): void;
 }
 export {};