knip 6.33.0 → 6.35.0

package/dist/util/catalog.js

@@ -27,7 +27,7 @@ export const getCatalogContainer = async (cwd, manifest, manifestPath, pnpmWorks
         yarnWorkspace?.catalogs ??
         manifest.catalogs ??
         ((!Array.isArray(manifest.workspaces) && manifest.workspaces?.catalogs) || {});
-    return { filePath, catalog, catalogs };
+    return { filePath, catalog, catalogs, overrides: pnpmWorkspace?.overrides };
 };
 const extractEntries = (catalog) => {
     if (catalog && typeof catalog === 'object')
@@ -56,23 +56,43 @@ export const parseCatalog = (container) => {
             entries.add(id);
     return entries;
 };
+const OVERRIDE_DELIMITER = /[^ |@]>/;
+const toCatalogReference = (packageName, version) => {
+    if (typeof version !== 'string' || !version.startsWith('catalog:'))
+        return;
+    return { catalogName: version.slice('catalog:'.length) || DEFAULT_CATALOG, packageName };
+};
+const collectCatalogReferences = (dependencies, catalogReferences) => {
+    if (!dependencies)
+        return;
+    for (const [packageName, version] of Object.entries(dependencies)) {
+        const reference = toCatalogReference(packageName, version);
+        if (reference)
+            catalogReferences.push(reference);
+    }
+};
+export const getOverrideCatalogReferences = (overrides) => {
+    const catalogReferences = [];
+    if (!overrides)
+        return catalogReferences;
+    for (const [selector, version] of Object.entries(overrides)) {
+        const delimiterIndex = selector.search(OVERRIDE_DELIMITER);
+        const target = delimiterIndex === -1 ? selector : selector.slice(delimiterIndex + 2);
+        const packageName = getPackageNameFromModuleSpecifier(target);
+        if (!packageName)
+            continue;
+        const reference = toCatalogReference(packageName, version);
+        if (reference)
+            catalogReferences.push({ ...reference, selector });
+    }
+    return catalogReferences;
+};
 export const extractCatalogReferences = (manifest) => {
     const catalogReferences = [];
-    const checkDependencies = (dependencies) => {
-        if (!dependencies)
-            return;
-        for (const [name, version] of Object.entries(dependencies)) {
-            if (typeof version === 'string' && version.startsWith('catalog:')) {
-                const catalogName = version.slice('catalog:'.length) || DEFAULT_CATALOG;
-                catalogReferences.push({ catalogName, packageName: name });
-            }
-        }
-    };
-    checkDependencies(manifest.dependencies);
-    checkDependencies(manifest.devDependencies);
-    checkDependencies(manifest.peerDependencies);
-    checkDependencies(manifest.optionalDependencies);
-    checkDependencies(manifest.resolutions);
-    checkDependencies(manifest.pnpm?.overrides);
+    collectCatalogReferences(manifest.dependencies, catalogReferences);
+    collectCatalogReferences(manifest.devDependencies, catalogReferences);
+    collectCatalogReferences(manifest.peerDependencies, catalogReferences);
+    collectCatalogReferences(manifest.optionalDependencies, catalogReferences);
+    collectCatalogReferences(manifest.resolutions, catalogReferences);
     return catalogReferences;
 };

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

@@ -1,5 +1,6 @@
 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                Include 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,catalogReferences\n      --exports                Shortcut for --include exports,nsExports,types,nsTypes,enumMembers,namespaceMembers,duplicates\n      --files                  Shortcut for --include files\n      --cycles                 Shortcut for --include cycles (circular dependencies)\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      --no-tag-hints           Suppress tag hints\n      --treat-config-hints-as-errors   Exit with non-zero code (1) if there are any configuration hints\n      --treat-tag-hints-as-errors      Exit with non-zero code (1) if there are any tag 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, catalogReferences, cycles\n(2) Fixable issue types: dependencies, exports, types, files, catalog\n(3) Built-in reporters: symbols (default), compact, codeowners, cycles, json, codeclimate, markdown, disclosure, github-actions, sarif\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 declare const parseNumericOption: (value: string | undefined, option: string) => number | undefined;
 export default function parseCLIArgs(): {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;

package/dist/util/cli-arguments.js

@@ -1,4 +1,5 @@
 import { parseArgs } from 'node:util';
+import { ConfigurationError } from './errors.js';
 export const helpText = `✂️  Find unused dependencies, exports and files in your JavaScript and TypeScript projects
 
 Usage: knip [options]
@@ -79,6 +80,14 @@ $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
 $ knip --tags=-lintignore
 
 Website: https://knip.dev`;
+export const parseNumericOption = (value, option) => {
+    if (value === undefined)
+        return undefined;
+    if (!/^\d+$/.test(value)) {
+        throw new ConfigurationError(`Option --${option} expects a non-negative integer, got: ${value}`);
+    }
+    return Number(value);
+};
 export default function parseCLIArgs() {
     return parseArgs({
         options: {

package/dist/util/create-options.d.ts

@@ -1,5 +1,5 @@
 import type { Options } from '../types/options.ts';
-import type { ParsedCLIArgs } from './cli-arguments.ts';
+import { type ParsedCLIArgs } from './cli-arguments.ts';
 interface CreateOptions extends Partial<Options> {
     args?: ParsedCLIArgs;
 }
@@ -43,6 +43,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     isTreatTagHintsAsErrors: boolean;
     isUseTscFiles: boolean | undefined;
     isWatch: boolean;
+    maxIssues: number;
     maxShowIssues: number | undefined;
     parsedConfig: {
         angular?: string | boolean | string[] | {
@@ -365,6 +366,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        mise?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         mocha?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -974,12 +980,13 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
         } | undefined;
         ignoreWorkspaces?: string[] | undefined;
         includeEntryExports?: boolean | undefined;
-        compilers?: Record<string, true | import("../compilers/types.ts").CompilerAsync | import("../compilers/types.ts").CompilerSync> | undefined;
-        syncCompilers?: Record<string, true | import("../compilers/types.ts").CompilerSync> | undefined;
-        asyncCompilers?: Record<string, import("../compilers/types.ts").CompilerAsync> | undefined;
+        compilers?: Record<string, true | import("../types.ts").Compiler> | undefined;
+        asyncCompilers?: Record<string, import("../types.ts").Compiler> | undefined;
         tags?: string[] | undefined;
         treatConfigHintsAsErrors?: boolean | undefined;
         treatTagHintsAsErrors?: boolean | undefined;
+        preprocessor?: string | string[] | undefined;
+        preprocessorOptions?: Record<string, unknown> | undefined;
         include?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
         exclude?: ("binaries" | "catalog" | "catalogReferences" | "cycles" | "dependencies" | "devDependencies" | "duplicates" | "enumMembers" | "exports" | "files" | "namespaceMembers" | "nsExports" | "nsTypes" | "optionalPeerDependencies" | "types" | "unlisted" | "unresolved")[] | undefined;
         workspaces?: Record<string, {
@@ -1303,6 +1310,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            mise?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             mocha?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1907,6 +1919,9 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             includeEntryExports?: boolean | undefined;
         }> | undefined;
     };
+    preprocessor: string[];
+    preprocessorInputs: string[];
+    preprocessorOptions: string;
     rules: {
         binaries: import("../types/issues.ts").IssueSeverity;
         catalog: import("../types/issues.ts").IssueSeverity;

package/dist/util/create-options.js

@@ -1,7 +1,8 @@
-import { partitionCompilers } from '../compilers/index.js';
 import { ISSUE_TYPES, KNIP_CONFIG_LOCATIONS } from '../constants.js';
 import { knipConfigurationSchema } from '../schema/configuration.js';
+import { arrayify } from './array.js';
 import { getCatalogContainer } from './catalog.js';
+import { parseNumericOption } from './cli-arguments.js';
 import { ConfigurationError } from './errors.js';
 import { findFile, loadJSON } from './fs.js';
 import { getIncludedIssueTypes, shorthandCycles, shorthandDeps, shorthandExports, shorthandFiles, } from './get-included-issue-types.js';
@@ -10,7 +11,7 @@ import { loadResolvedConfigFile } from './load-config.js';
 import { _load } from './loader.js';
 import { logWarning } from './log.js';
 import { getKeysByValue } from './object.js';
-import { isAbsolute, join, normalize, toAbsolute, toPosix } from './path.js';
+import { isAbsolute, isInternal, join, normalize, toAbsolute, toPosix } from './path.js';
 import { splitTags } from './tag.js';
 export const createOptions = async (options) => {
     const { args = {} } = options;
@@ -55,7 +56,7 @@ export const createOptions = async (options) => {
             }
         }
     }
-    const parsedConfig = knipConfigurationSchema.parse(partitionCompilers(loadedConfig));
+    const parsedConfig = knipConfigurationSchema.parse(loadedConfig);
     if (!configFilePath && manifest.knip)
         configFilePath = manifestPath;
     const pnpmWorkspacePath = findFile(cwd, 'pnpm-workspace.yaml');
@@ -93,6 +94,14 @@ export const createOptions = async (options) => {
     const isFixFiles = args['allow-remove-files'] && (fixTypes.length === 0 || fixTypes.includes('files'));
     const tags = splitTags(args.tags ?? options.tags ?? parsedConfig.tags ?? []);
     const workspace = options.workspace ?? args.workspace;
+    const toPreprocessor = (specifier) => (isInternal(specifier) ? toAbsolute(specifier, cwd) : specifier);
+    const configuredPreprocessor = arrayify(parsedConfig.preprocessor).map(toPreprocessor);
+    const preprocessor = args.preprocessor ? args.preprocessor.map(toPreprocessor) : configuredPreprocessor;
+    const preprocessorInputs = args.preprocessor
+        ? [...new Set([...configuredPreprocessor, ...preprocessor])]
+        : preprocessor;
+    const preprocessorOptions = args['preprocessor-options'] ??
+        (parsedConfig.preprocessorOptions ? JSON.stringify(parsedConfig.preprocessorOptions) : '');
     return {
         cacheLocation: args['cache-location'] ?? join(cwd, 'node_modules', '.cache', 'knip'),
         catalog: await getCatalogContainer(cwd, manifest, manifestPath, pnpmWorkspacePath, pnpmWorkspace),
@@ -150,8 +159,12 @@ export const createOptions = async (options) => {
         isTreatTagHintsAsErrors: args['treat-tag-hints-as-errors'] ?? parsedConfig.treatTagHintsAsErrors ?? false,
         isUseTscFiles: options.isUseTscFiles ?? args['use-tsconfig-files'] ?? (options.isSession && !configFilePath),
         isWatch: args.watch ?? options.isWatch ?? false,
-        maxShowIssues: args['max-show-issues'] ? Number(args['max-show-issues']) : undefined,
+        maxIssues: parseNumericOption(args['max-issues'], 'max-issues') ?? 0,
+        maxShowIssues: parseNumericOption(args['max-show-issues'], 'max-show-issues'),
         parsedConfig,
+        preprocessor,
+        preprocessorInputs,
+        preprocessorOptions,
         rules,
         tags,
         traceDependency: args['trace-dependency'],

package/dist/util/errors.d.ts

@@ -4,9 +4,11 @@ interface ErrorWithCause extends Error {
 }
 export declare class ConfigurationError extends Error {
 }
+export declare class CompilerError extends Error {
+}
 export declare class LoaderError extends Error {
 }
-export declare const isKnownError: (error: Error) => error is core.$ZodError<any> | ConfigurationError | LoaderError;
+export declare const isKnownError: (error: Error) => error is core.$ZodError<any> | CompilerError | ConfigurationError | LoaderError;
 export declare const hasErrorCause: (error: Error) => error is ErrorWithCause;
 export declare const isConfigurationError: (error: Error) => error is ConfigurationError;
 export declare const isModuleNotFoundError: (error: Error) => boolean;

package/dist/util/errors.js

@@ -3,9 +3,14 @@ import { substringBefore } from './string.js';
 const isZodErrorLike = (error) => error instanceof core.$ZodError;
 export class ConfigurationError extends Error {
 }
+export class CompilerError extends Error {
+}
 export class LoaderError extends Error {
 }
-export const isKnownError = (error) => error instanceof ConfigurationError || error instanceof LoaderError || isZodErrorLike(error);
+export const isKnownError = (error) => error instanceof ConfigurationError ||
+    error instanceof CompilerError ||
+    error instanceof LoaderError ||
+    isZodErrorLike(error);
 export const hasErrorCause = (error) => !isZodErrorLike(error) && error.cause instanceof Error;
 export const isConfigurationError = (error) => error instanceof ConfigurationError;
 export const isModuleNotFoundError = (error) => 'code' in error && error.code === 'MODULE_NOT_FOUND';

package/dist/util/file-entry-cache.js

@@ -4,7 +4,7 @@ import { deserialize, serialize } from 'node:v8';
 import { debugLog } from './debug.js';
 import { isDirectory, isFile } from './fs.js';
 import { timerify } from './Performance.js';
-import { dirname, isAbsolute, resolve } from './path.js';
+import { isAbsolute, resolve } from './path.js';
 const createCache = (filePath) => {
     try {
         return deserialize(fs.readFileSync(filePath));
@@ -70,7 +70,7 @@ export class FileEntryCache {
     }
     reconcile() {
         try {
-            const dir = dirname(this.filePath);
+            const dir = path.dirname(this.filePath);
             if (!isDirectory(dir))
                 fs.mkdirSync(dir, { recursive: true });
             fs.writeFileSync(this.filePath, serialize(this.cache));

package/dist/util/module-graph.js

@@ -35,6 +35,7 @@ export const updateImportMap = (file, importMap, graph) => {
     }
 };
 export const createFileNode = () => ({
+    skipExports: false,
     imports: {
         internal: new Map(),
         external: new Set(),

package/dist/util/package-json.d.ts

@@ -231,6 +231,7 @@ export declare const getPublishedTypeManifest: (manifest: PackageJson) => {
     mdx: unknown;
     mdxlint: unknown;
     metro: unknown;
+    mise: unknown;
     mocha: unknown;
     moonrepo: unknown;
     msw: unknown;

package/dist/util/preprocessor.d.ts

@@ -0,0 +1,6 @@
+import type { Results } from '../run.ts';
+import type { ReporterOptions } from '../types/issues.ts';
+import type { ParsedCLIArgs } from './cli-arguments.ts';
+import type { MainOptions } from './create-options.ts';
+export declare const toReporterOptions: (options: MainOptions, results: Results, args?: ParsedCLIArgs) => ReporterOptions;
+export declare const createPreprocessor: (processors: string[]) => Promise<(data: ReporterOptions) => Promise<ReporterOptions>>;

package/dist/util/preprocessor.js

@@ -0,0 +1,24 @@
+import { _load } from './loader.js';
+export const toReporterOptions = (options, results, args) => ({
+    ...results,
+    report: options.includedIssueTypes,
+    cwd: options.cwd,
+    configFilePath: options.configFilePath,
+    isDisableConfigHints: options.isDisableConfigHints,
+    isDisableTagHints: options.isDisableTagHints,
+    isProduction: options.isProduction,
+    isShowProgress: options.isShowProgress,
+    isTreatConfigHintsAsErrors: options.isTreatConfigHintsAsErrors,
+    isTreatTagHintsAsErrors: options.isTreatTagHintsAsErrors,
+    maxShowIssues: options.maxShowIssues,
+    options: args?.['reporter-options'] ?? '',
+    preprocessorOptions: options.preprocessorOptions,
+});
+export const createPreprocessor = async (processors) => {
+    const preprocessors = await Promise.all(processors.map(_load));
+    return async (data) => {
+        for (const preprocessor of preprocessors)
+            data = await preprocessor(data);
+        return data;
+    };
+};

package/dist/util/reporter.d.ts

@@ -1,3 +1,2 @@
 import type { ReporterOptions } from '../types/issues.ts';
-export declare const runPreprocessors: (processors: string[], data: ReporterOptions) => Promise<ReporterOptions>;
 export declare const runReporters: (reporter: string[], options: ReporterOptions) => Promise<void>;

package/dist/util/reporter.js

@@ -1,13 +1,6 @@
 import internalReporters from '../reporters/index.js';
 import { _load } from './loader.js';
 import { isAbsolute, isInternal, resolve } from './path.js';
-export const runPreprocessors = async (processors, data) => {
-    const preprocessors = await Promise.all(processors.map(proc => _load(isInternal(proc) && !isAbsolute(proc) ? resolve(proc) : proc)));
-    let result = data;
-    for (const preprocessor of preprocessors)
-        result = await preprocessor(result);
-    return result;
-};
 export const runReporters = async (reporter, options) => {
     const reporters = await Promise.all(reporter.map(async (reporter) => {
         return reporter in internalReporters

package/dist/util/watch.d.ts

@@ -17,7 +17,7 @@ export type WatchChange = {
 export type SessionHandler = Awaited<ReturnType<typeof getSessionHandler>>;
 type WatchOptions = {
     analyzedFiles: Set<string>;
-    analyzeSourceFile: (filePath: string, principal: ProjectPrincipal) => void;
+    analyzeSourceFile: (filePath: string) => Promise<void>;
     chief: ConfigurationChief;
     collector: IssueCollector;
     analyze: () => Promise<void>;

package/dist/util/watch.js

@@ -1,7 +1,8 @@
-import { readFileSync } from 'node:fs';
 import { invalidateCache } from '../graph-explorer/cache.js';
 import { debugLog } from './debug.js';
+import { hasErrorCause } from './errors.js';
 import { isFile } from './fs.js';
+import { logError } from './log.js';
 import { updateImportMap } from './module-graph.js';
 import { toAbsolute, toPosix, toRelative } from './path.js';
 import { clearModuleResolutionCaches } from '../typescript/resolve-module-names.js';
@@ -13,11 +14,12 @@ const createUpdate = (options) => {
     return { duration, mem };
 };
 export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceFile, chief, collector, analyze, principal, graph, isIgnored, onFileChange, unreferencedFiles, entryPaths, }) => {
-    const handleFileChanges = async (changes) => {
+    const added = new Set();
+    const deleted = new Set();
+    const modified = new Set();
+    const processFileChanges = async (changes) => {
         const startTime = performance.now();
-        const added = new Set();
-        const deleted = new Set();
-        const modified = new Set();
+        let hasRelevantChanges = false;
         for (const change of changes) {
             const filePath = toAbsolute(change.filePath, options.cwd);
             const relativePath = toRelative(change.filePath, options.cwd);
@@ -28,23 +30,24 @@ export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceF
             const workspace = chief.findWorkspaceByFilePath(filePath);
             if (!workspace)
                 continue;
+            hasRelevantChanges = true;
             switch (change.type) {
                 case 'added':
                     principal.addProjectPath(filePath);
-                    principal.deletedFiles.delete(filePath);
+                    deleted.delete(filePath);
                     if (principal.projectPaths.has(filePath))
                         added.add(filePath);
                     debugLog(workspace.name, `Watcher: + ${relativePath}`);
                     break;
                 case 'deleted':
                     deleted.add(filePath);
+                    added.delete(filePath);
                     analyzedFiles.delete(filePath);
                     principal.removeProjectPath(filePath);
                     debugLog(workspace.name, `Watcher: - ${relativePath}`);
                     break;
                 default: {
-                    const cached = principal.fileManager.sourceTextCache.get(filePath);
-                    if (cached !== undefined && cached === readFileSync(filePath, 'utf8')) {
+                    if (!principal.fileManager.hasChanged(filePath)) {
                         debugLog(workspace.name, `Watcher: = ${relativePath}`);
                         continue;
                     }
@@ -55,31 +58,31 @@ export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceF
             }
             principal.invalidateFile(filePath);
         }
-        if (added.size === 0 && deleted.size === 0 && modified.size === 0)
+        if (!hasRelevantChanges || (added.size === 0 && deleted.size === 0 && modified.size === 0))
             return;
         clearResolverCache();
         clearModuleResolutionCaches();
         clearGlobCache();
         invalidateCache(graph);
+        const filePaths = await principal.getUsedResolvedFiles();
         unreferencedFiles.clear();
         const cachedUnusedFiles = collector.purge();
         for (const filePath of added)
             cachedUnusedFiles.add(filePath);
         for (const filePath of deleted)
             cachedUnusedFiles.delete(filePath);
-        const filePaths = principal.getUsedResolvedFiles();
         if (added.size > 0 || deleted.size > 0) {
             graph.clear();
             for (const filePath of filePaths) {
                 const workspace = chief.findWorkspaceByFilePath(filePath);
                 if (workspace) {
-                    analyzeSourceFile(filePath, principal);
+                    await analyzeSourceFile(filePath);
                 }
             }
         }
         else {
             for (const [filePath, file] of graph) {
-                if (filePaths.includes(filePath)) {
+                if (filePaths.has(filePath)) {
                     file.importedBy = undefined;
                 }
                 else {
@@ -94,7 +97,7 @@ export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceF
                 if (!graph.has(filePath)) {
                     const workspace = chief.findWorkspaceByFilePath(filePath);
                     if (workspace) {
-                        analyzeSourceFile(filePath, principal);
+                        await analyzeSourceFile(filePath);
                     }
                 }
             }
@@ -103,7 +106,7 @@ export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceF
                     const workspace = chief.findWorkspaceByFilePath(filePath);
                     if (workspace) {
                         if (principal.projectPaths.has(filePath) || graph.has(filePath)) {
-                            analyzeSourceFile(filePath, principal);
+                            await analyzeSourceFile(filePath);
                         }
                     }
                 }
@@ -120,17 +123,32 @@ export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceF
         collector.addFileCounts({ processed: analyzedFiles.size, unused: unusedFiles.length });
         for (const issue of collector.getRetainedIssues())
             collector.addIssue(issue);
+        added.clear();
+        deleted.clear();
+        modified.clear();
         const update = createUpdate({ startTime });
         if (onFileChange)
             onFileChange(Object.assign({ issues: getIssues().issues }, update));
         return update;
     };
+    const clearSourceText = () => principal.fileManager.sourceTextCache.clear();
+    let pending = Promise.resolve();
+    const handleFileChanges = (changes) => {
+        const update = pending.then(() => processFileChanges(changes));
+        pending = update.then(clearSourceText, clearSourceText);
+        return update;
+    };
     const listener = (eventType, filePath) => {
         debugLog('*', `(raw) ${eventType} ${filePath}`);
         if (typeof filePath === 'string') {
             const normalizedPath = toPosix(filePath);
             const type = eventType === 'rename' ? (isFile(options.cwd, normalizedPath) ? 'added' : 'deleted') : 'modified';
-            handleFileChanges([{ type, filePath: normalizedPath }]);
+            handleFileChanges([{ type, filePath: normalizedPath }]).catch(error => {
+                const message = error instanceof Error ? error.message : String(error);
+                const reason = error instanceof Error && hasErrorCause(error) ? `\nReason: ${error.cause.message}` : '';
+                logError(message + reason);
+                process.exitCode = 2;
+            });
         }
     };
     const getIssues = () => collector.getIssues();

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "6.33.0";
+export declare const version = "6.35.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '6.33.0';
+export const version = '6.35.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "6.33.0",
+  "version": "6.35.0",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "keywords": [
     "analysis",
@@ -85,25 +85,25 @@
     "formatly": "^0.7.0",
     "get-tsconfig": "4.14.3",
     "jiti": "^2.7.0",
-    "oxc-parser": "^0.147.0",
+    "oxc-parser": "^0.148.0",
     "oxc-resolver": "11.24.2",
     "picomatch": "^4.0.7",
     "smol-toml": "^1.8.0",
     "strip-json-comments": "5.0.3",
     "tinyglobby": "^0.2.17",
-    "unbash": "^4.0.10",
+    "unbash": "^4.0.11",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@jest/types": "^30.4.1",
-    "@types/bun": "^1.4.0",
+    "@jest/types": "^30.5.1",
+    "@types/bun": "^1.4.1",
     "@types/picomatch": "^4.0.3",
-    "@types/webpack": "^5.28.5",
     "codeclimate-types": "^0.3.1",
     "prettier": "^3.9.6",
-    "tsx": "^4.23.12",
-    "typescript": "7.0.2"
+    "tsx": "^4.23.13",
+    "typescript": "7.0.2",
+    "webpack": "^5.110.3"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"

package/schema.json

@@ -173,6 +173,14 @@
         }
       }
     },
+    "preprocessor": {
+      "title": "Preprocess the results before providing them to the reporter(s)",
+      "oneOf": [{ "type": "string" }, { "$ref": "#/definitions/list" }]
+    },
+    "preprocessorOptions": {
+      "title": "Extra options to pass to the preprocessor",
+      "type": "object"
+    },
     "treatConfigHintsAsErrors": {
       "title": "Exit with non-zero code (1) if there are any configuration hints",
       "type": "boolean"
@@ -650,6 +658,10 @@
           "title": "metro plugin configuration (https://knip.dev/reference/plugins/metro)",
           "$ref": "#/definitions/plugin"
         },
+        "mise": {
+          "title": "mise plugin configuration (https://knip.dev/reference/plugins/mise)",
+          "$ref": "#/definitions/plugin"
+        },
         "mocha": {
           "title": "Mocha plugin configuration (https://knip.dev/reference/plugins/mocha)",
           "$ref": "#/definitions/plugin"