knip 5.74.0 → 5.75.1

package/dist/types/module-graph.d.ts

@@ -7,7 +7,7 @@ type NamespaceOrAlias = string;
 type Reference = string;
 type References = Set<Reference>;
 type Tags = Set<string>;
-interface SourceLocation {
+export interface Position {
     pos: number;
     line: number;
     col: number;
@@ -24,13 +24,13 @@ export type ImportMaps = {
     reExportedNs: IdToFileMap;
 };
 export type ImportMap = Map<FilePath, ImportMaps>;
-export interface Import extends SourceLocation {
+export interface Import extends Position {
     readonly specifier: string;
     readonly filePath: string | undefined;
     readonly identifier: string | undefined;
     readonly isTypeOnly: boolean;
 }
-export interface Export extends SourceLocation {
+export interface Export extends Position {
     readonly identifier: Identifier;
     readonly type: SymbolType;
     readonly members: ExportMember[];

package/dist/types/options.d.ts

@@ -17,8 +17,10 @@ export interface Options {
     isIsolateWorkspaces: boolean;
     isProduction: boolean;
     isRemoveFiles: boolean;
+    isSession: boolean;
     isShowProgress: boolean;
     isStrict: boolean;
+    isUseTscFiles: boolean;
     isWatch: boolean;
     tags: string[];
     tsConfigFile: string | undefined;

package/dist/typescript/SourceFileManager.d.ts

@@ -8,12 +8,15 @@ export declare class SourceFileManager {
     isSkipLibs: boolean;
     sourceFileCache: Map<string, ts.SourceFile | undefined>;
     snapshotCache: Map<string, ts.IScriptSnapshot | undefined>;
+    scriptVersions: Map<string, number>;
     syncCompilers: SyncCompilers;
     asyncCompilers: AsyncCompilers;
     constructor({ compilers, isSkipLibs }: SourceFileManagerOptions);
     createSourceFile(filePath: string, contents: string): ts.SourceFile;
     getSourceFile(filePath: string): ts.SourceFile | undefined;
     getSnapshot(filePath: string): ts.IScriptSnapshot | undefined;
+    getScriptVersion(filePath: string): number;
+    invalidate(filePath: string): void;
     compileAndAddSourceFile(filePath: string): Promise<void>;
 }
 export {};

package/dist/typescript/SourceFileManager.js

@@ -7,6 +7,7 @@ export class SourceFileManager {
     isSkipLibs;
     sourceFileCache = new Map();
     snapshotCache = new Map();
+    scriptVersions = new Map();
     syncCompilers;
     asyncCompilers;
     constructor({ compilers, isSkipLibs }) {
@@ -53,6 +54,14 @@ export class SourceFileManager {
         this.snapshotCache.set(filePath, snapshot);
         return snapshot;
     }
+    getScriptVersion(filePath) {
+        return this.scriptVersions.get(filePath) ?? 0;
+    }
+    invalidate(filePath) {
+        this.sourceFileCache.delete(filePath);
+        this.snapshotCache.delete(filePath);
+        this.scriptVersions.set(filePath, (this.scriptVersions.get(filePath) ?? 0) + 1);
+    }
     async compileAndAddSourceFile(filePath) {
         const contents = ts.sys.readFile(filePath);
         if (typeof contents !== 'string')

package/dist/typescript/create-hosts.js

@@ -10,7 +10,7 @@ export const createHosts = ({ cwd, compilerOptions, fileManager, entryPaths, com
     const languageServiceHost = {
         getCompilationSettings: () => compilerOptions,
         getScriptFileNames: () => Array.from(entryPaths),
-        getScriptVersion: () => '0',
+        getScriptVersion: (fileName) => fileManager.getScriptVersion(fileName).toString(),
         getScriptSnapshot: (fileName) => fileManager.getSnapshot(fileName),
         getCurrentDirectory: () => cwd,
         getDefaultLibFileName: ts.getDefaultLibFilePath,

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

package/dist/util/cli-arguments.js

@@ -26,6 +26,7 @@ Options:
   --include-libs           Include type definitions from external dependencies (default: false)
   --include-entry-exports  Include entry files when reporting unused exports
   --isolate-workspaces     Isolate workspaces into separate programs
+  --use-tsconfig-files     Use tsconfig.json to define project files (override \`project\` patterns)
   -n, --no-progress        Don't show dynamic progress updates (automatically enabled in CI environments)
   --preprocessor           Preprocess the results before providing it to the reporter(s), can be repeated
   --preprocessor-options   Pass extra options to the preprocessor (as JSON string, see --reporter-options example)
@@ -106,6 +107,7 @@ export default function parseCLIArgs() {
             'trace-file': { type: 'string' },
             'treat-config-hints-as-errors': { type: 'boolean' },
             tsConfig: { type: 'string', short: 't' },
+            'use-tsconfig-files': { type: 'boolean' },
             version: { type: 'boolean', short: 'V' },
             watch: { type: 'boolean' },
             workspace: { type: 'string', short: 'W' },

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

@@ -33,11 +33,13 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     isReportDependencies: boolean;
     isReportTypes: boolean;
     isReportValues: boolean;
+    isSession: boolean;
     isShowProgress: boolean;
     isSkipLibs: boolean;
     isStrict: boolean;
     isTrace: boolean;
     isTreatConfigHintsAsErrors: boolean;
+    isUseTscFiles: boolean | undefined;
     isWatch: boolean;
     maxShowIssues: number | undefined;
     parsedConfig: {

package/dist/util/create-options.js

@@ -103,6 +103,7 @@ export const createOptions = async (options) => {
             includedIssueTypes.binaries,
         isReportTypes: includedIssueTypes.types || includedIssueTypes.nsTypes || includedIssueTypes.enumMembers,
         isReportValues: includedIssueTypes.exports || includedIssueTypes.nsExports || isReportClassMembers,
+        isSession: options.isSession ?? false,
         isShowProgress: !isDebug &&
             !isTrace &&
             parsedCLIArgs['no-progress'] !== true &&
@@ -113,6 +114,7 @@ export const createOptions = async (options) => {
         isStrict,
         isTrace,
         isTreatConfigHintsAsErrors: parsedCLIArgs['treat-config-hints-as-errors'] ?? parsedConfig.treatConfigHintsAsErrors ?? false,
+        isUseTscFiles: options.isUseTscFiles ?? parsedCLIArgs['use-tsconfig-files'] ?? (options.isSession && !configFilePath),
         isWatch: parsedCLIArgs.watch ?? options.isWatch ?? false,
         maxShowIssues: parsedCLIArgs['max-show-issues'] ? Number(parsedCLIArgs['max-show-issues']) : undefined,
         parsedConfig,

package/dist/util/load-tsconfig.d.ts

@@ -2,5 +2,5 @@ import ts from 'typescript';
 export declare const loadTSConfig: (tsConfigFilePath: string) => Promise<{
     isFile: boolean;
     compilerOptions: ts.CompilerOptions;
-    definitionPaths: string[];
+    fileNames: string[];
 }>;

package/dist/util/load-tsconfig.js

@@ -1,14 +1,13 @@
 import ts from 'typescript';
 import { isFile } from './fs.js';
 import { dirname } from './path.js';
-const dtsMatch = /\.d\.(c|m)?ts$/;
 export const loadTSConfig = async (tsConfigFilePath) => {
     if (isFile(tsConfigFilePath)) {
         const config = ts.readConfigFile(tsConfigFilePath, ts.sys.readFile);
         const parsedConfig = ts.parseJsonConfigFileContent(config.config, ts.sys, dirname(tsConfigFilePath));
         const compilerOptions = parsedConfig.options ?? {};
-        const definitionPaths = parsedConfig.fileNames.filter(filePath => dtsMatch.test(filePath));
-        return { isFile: true, compilerOptions, definitionPaths };
+        const fileNames = parsedConfig.fileNames;
+        return { isFile: true, compilerOptions, fileNames };
     }
-    return { isFile: false, compilerOptions: {}, definitionPaths: [] };
+    return { isFile: false, compilerOptions: {}, fileNames: [] };
 };

package/dist/util/watch.d.ts

@@ -11,12 +11,12 @@ export type OnFileChange = (options: {
     duration?: number;
     mem?: number;
 }) => void;
-type WatchChange = {
+export type WatchChange = {
     type: 'added' | 'deleted' | 'modified';
     filePath: string;
 };
-export type WatchHandler = Awaited<ReturnType<typeof getWatchHandler>>;
-type Watch = {
+export type SessionHandler = Awaited<ReturnType<typeof getSessionHandler>>;
+type WatchOptions = {
     analyzedFiles: Set<string>;
     analyzeSourceFile: (filePath: string, principal: ProjectPrincipal) => void;
     chief: ConfigurationChief;
@@ -29,7 +29,7 @@ type Watch = {
     unreferencedFiles: Set<string>;
     entryPaths: Set<string>;
 };
-export declare const getWatchHandler: (options: MainOptions, { analyzedFiles, analyzeSourceFile, chief, collector, analyze, factory, graph, isIgnored, onFileChange, unreferencedFiles, entryPaths, }: Watch) => Promise<{
+export declare const getSessionHandler: (options: MainOptions, { analyzedFiles, analyzeSourceFile, chief, collector, analyze, factory, graph, isIgnored, onFileChange, unreferencedFiles, entryPaths, }: WatchOptions) => Promise<{
     listener: WatchListener<string | Buffer<ArrayBufferLike>>;
     handleFileChanges: (changes: WatchChange[]) => Promise<{
         duration: number;
@@ -37,6 +37,11 @@ export declare const getWatchHandler: (options: MainOptions, { analyzedFiles, an
     }>;
     getEntryPaths: () => Set<string>;
     getGraph: () => ModuleGraph;
-    getIssues: () => Issues;
+    getIssues: () => {
+        issues: Issues;
+        counters: import("../types/issues.js").Counters;
+        tagHints: Set<import("../types/issues.js").TagHint>;
+        configurationHints: Set<import("../types/issues.js").ConfigurationHint>;
+    };
 }>;
 export {};

package/dist/util/watch.js

@@ -1,3 +1,4 @@
+import { invalidateCache } from '../graph-explorer/cache.js';
 import { debugLog } from './debug.js';
 import { isFile } from './fs.js';
 import { updateImportMap } from './module-graph.js';
@@ -7,8 +8,7 @@ const createUpdate = (options) => {
     const mem = process.memoryUsage().heapUsed;
     return { duration, mem };
 };
-export const getWatchHandler = async (options, { analyzedFiles, analyzeSourceFile, chief, collector, analyze, factory, graph, isIgnored, onFileChange, unreferencedFiles, entryPaths, }) => {
-    const getIssues = () => collector.getIssues().issues;
+export const getSessionHandler = async (options, { analyzedFiles, analyzeSourceFile, chief, collector, analyze, factory, graph, isIgnored, onFileChange, unreferencedFiles, entryPaths, }) => {
     const handleFileChanges = async (changes) => {
         const startTime = performance.now();
         const added = new Set();
@@ -49,6 +49,7 @@ export const getWatchHandler = async (options, { analyzedFiles, analyzeSourceFil
         }
         if (added.size === 0 && deleted.size === 0 && modified.size === 0)
             return createUpdate({ startTime });
+        invalidateCache(graph);
         unreferencedFiles.clear();
         const cachedUnusedFiles = collector.purge();
         for (const filePath of added)
@@ -117,7 +118,7 @@ export const getWatchHandler = async (options, { analyzedFiles, analyzeSourceFil
             collector.addIssue(issue);
         const update = createUpdate({ startTime });
         if (onFileChange)
-            onFileChange(Object.assign({ issues: getIssues() }, update));
+            onFileChange(Object.assign({ issues: getIssues().issues }, update));
         return update;
     };
     const listener = (eventType, filePath) => {
@@ -127,9 +128,10 @@ export const getWatchHandler = async (options, { analyzedFiles, analyzeSourceFil
             handleFileChanges([{ type, filePath }]);
         }
     };
-    if (onFileChange)
-        onFileChange({ issues: getIssues() });
+    const getIssues = () => collector.getIssues();
     const getEntryPaths = () => entryPaths;
     const getGraph = () => graph;
+    if (onFileChange)
+        onFileChange({ issues: getIssues().issues });
     return { listener, handleFileChanges, getEntryPaths, getGraph, getIssues };
 };

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.74.0";
+export declare const version = "5.75.1";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.74.0';
+export const version = '5.75.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.74.0",
+  "version": "5.75.1",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {
@@ -24,7 +24,16 @@
       "url": "https://opencollective.com/knip"
     }
   ],
-  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "default": "./dist/session/index.js"
+    }
+  },
   "bin": {
     "knip": "bin/knip.js",
     "knip-bun": "bin/knip-bun.js"