knip 5.55.1 → 5.56.0

package/dist/util/Performance.js

@@ -4,9 +4,13 @@ import { memoryUsage } from 'node:process';
 import parsedArgValues from './cli-arguments.js';
 import { getStats } from './math.js';
 import { Table } from './table.js';
-const { performance: isPerformanceEnabled = false, memory: isMemoryEnabled = false, 'memory-realtime': memoryRealtime = false, } = parsedArgValues;
+const { performance: enableTimerify = false, 'performance-fn': timerifyOnlyFnName, memory: enableMemoryUsage = false, 'memory-realtime': memoryRealtime = false, } = parsedArgValues;
+const isTimerifyFunctions = enableTimerify || !!timerifyOnlyFnName;
+const isMemoryUsageEnabled = enableMemoryUsage || memoryRealtime;
 export const timerify = (fn, name = fn.name) => {
-    if (!isPerformanceEnabled)
+    if (!isTimerifyFunctions)
+        return fn;
+    if (timerifyOnlyFnName && name !== timerifyOnlyFnName)
         return fn;
     return performance.timerify(Object.defineProperty(fn, 'name', { get: () => name }));
 };
@@ -18,8 +22,8 @@ const logHead = () => console.log(keys.map(key => key.padStart(10)).join('  '));
 const log = (memInfo) => console.log(keys.map(key => twoFixed(inMB(memInfo[key])).padStart(10)).join('  '));
 class Performance {
     isEnabled;
-    isPerformanceEnabled;
-    isMemoryEnabled;
+    isTimerifyFunctions;
+    isMemoryUsageEnabled;
     startTime = 0;
     endTime = 0;
     perfEntries = [];
@@ -30,15 +34,15 @@ class Performance {
     memObserver;
     memoryUsageStart;
     freeMemoryStart;
-    constructor({ isPerformanceEnabled = false, isMemoryEnabled = false }) {
-        this.isEnabled = isPerformanceEnabled || isMemoryEnabled;
-        this.isPerformanceEnabled = isPerformanceEnabled;
-        this.isMemoryEnabled = isMemoryEnabled;
+    constructor({ isTimerifyFunctions = false, isMemoryUsageEnabled = false }) {
+        this.isEnabled = isTimerifyFunctions || isMemoryUsageEnabled;
+        this.isTimerifyFunctions = isTimerifyFunctions;
+        this.isMemoryUsageEnabled = isMemoryUsageEnabled;
         this.startTime = performance.now();
         const instanceId = Math.floor(performance.now() * 100);
         this.perfId = `perf-${instanceId}`;
         this.memId = `mem-${instanceId}`;
-        if (isPerformanceEnabled) {
+        if (isTimerifyFunctions) {
             this.fnObserver = new PerformanceObserver(items => {
                 for (const entry of items.getEntries()) {
                     this.perfEntries.push(entry);
@@ -46,7 +50,7 @@ class Performance {
             });
             this.fnObserver.observe({ type: 'function' });
         }
-        if (isMemoryEnabled) {
+        if (isMemoryUsageEnabled) {
             this.memObserver = new PerformanceObserver(items => {
                 for (const entry of items.getEntries()) {
                     this.memEntries.push(entry);
@@ -82,12 +86,12 @@ class Performance {
             return entries;
         }, {});
     }
-    getPerformanceTable() {
+    getTimerifiedFunctionsTable() {
         const entriesByName = this.getPerfEntriesByName();
         const table = new Table({ header: true });
         for (const [name, values] of Object.entries(entriesByName)) {
             const stats = getStats(values);
-            table.newRow();
+            table.row();
             table.cell('Name', name);
             table.cell('size', values.length);
             table.cell('min', stats.min, twoFixed);
@@ -99,7 +103,7 @@ class Performance {
         return table.toString();
     }
     addMemoryMark(index) {
-        if (!this.isMemoryEnabled)
+        if (!this.isMemoryUsageEnabled)
             return;
         const id = `${this.memId}:${index}`;
         const detail = getMemInfo();
@@ -107,12 +111,12 @@ class Performance {
         if (memoryRealtime && detail)
             log(detail);
     }
-    getMemoryTable() {
+    getMemoryUsageTable() {
         const table = new Table({ header: true });
         for (const entry of this.memEntries) {
             if (!entry.detail)
                 continue;
-            table.newRow();
+            table.row();
             table.cell('heapUsed', inMB(entry.detail.heapUsed), twoFixed);
             table.cell('heapTotal', inMB(entry.detail.heapTotal), twoFixed);
             table.cell('freemem', inMB(entry.detail.freemem), twoFixed);
@@ -139,4 +143,4 @@ class Performance {
         this.memObserver?.disconnect();
     }
 }
-export const perfObserver = new Performance({ isPerformanceEnabled, isMemoryEnabled });
+export const perfObserver = new Performance({ isTimerifyFunctions, isMemoryUsageEnabled });

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\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, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of key functions and display stats table\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\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
+export declare const helpText = "\u2702\uFE0F  Find unused 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\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, can be repeated (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\n  --tags                   Include or exclude tagged exports\n  --no-config-hints        Suppress configuration hints\n  --treat-config-hints-as-errors    Exit with non-zero code (1) if there are any configuration hints\n  --no-exit-code           Always exit with code zero (0)\n  --max-issues             Maximum number of issues before non-zero exit code (default: 0)\n  -d, --debug              Show debug output\n  --trace                  Show trace output\n  --trace-export [name]    Show trace output for named export(s)\n  --trace-file [file]      Show trace output for exports in file\n  --performance            Measure count and running time of 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\n(2) Fixable issue types: dependencies, exports, types\n\nExamples:\n\n$ knip\n$ knip --production\n$ knip --workspace packages/client --include files,dependencies\n$ knip -c ./config/knip.json --reporter compact\n$ knip --reporter codeowners --reporter-options '{\"path\":\".github/CODEOWNERS\"}'\n$ knip --tags=-lintignore\n\nWebsite: https://knip.dev";
 declare const _default: {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;
@@ -29,6 +29,7 @@ declare const _default: {
     'no-gitignore'?: boolean | undefined;
     'no-progress'?: boolean | undefined;
     performance?: boolean | undefined;
+    'performance-fn'?: string | undefined;
     production?: boolean | undefined;
     preprocessor?: string[] | undefined;
     'preprocessor-options'?: string | undefined;

package/dist/util/cli-arguments.js

@@ -41,6 +41,7 @@ Options:
   --trace-export [name]    Show trace output for named export(s)
   --trace-file [file]      Show trace output for exports in file
   --performance            Measure count and running time of key functions and display stats table
+  --performance-fn [name]  Measure only function [name]
   --memory                 Measure memory usage and display data table
   --memory-realtime        Log memory usage in realtime
   -h, --help               Print this help text
@@ -92,6 +93,7 @@ try {
             'no-gitignore': { type: 'boolean' },
             'no-progress': { type: 'boolean', short: 'n' },
             performance: { type: 'boolean' },
+            'performance-fn': { type: 'string' },
             production: { type: 'boolean' },
             preprocessor: { type: 'string', multiple: true },
             'preprocessor-options': { type: 'string' },

package/dist/util/input.d.ts

@@ -1,5 +1,6 @@
 import type { PluginName } from '../types/PluginNames.js';
-type InputType = 'binary' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias';
+import type { IssueType } from '../types/issues.js';
+type InputType = 'binary' | 'entry' | 'project' | 'config' | 'dependency' | 'deferResolve' | 'deferResolveEntry' | 'alias' | 'ignore';
 export interface Input {
     type: InputType;
     specifier: string;
@@ -19,6 +20,10 @@ interface AliasInput extends Input {
     type: 'alias';
     prefixes: string[];
 }
+interface IgnoreInput extends Input {
+    type: 'ignore';
+    issueType: IssueType;
+}
 type Options = {
     optional?: boolean;
     dir?: string;
@@ -47,5 +52,7 @@ export declare const toDeferResolveEntry: (specifier: string, options?: Options)
 export declare const isDeferResolveEntry: (input: Input) => boolean;
 export declare const toAlias: (specifier: string, prefix: string | string[], options?: Options) => AliasInput;
 export declare const isAlias: (input: Input) => input is AliasInput;
+export declare const toIgnore: (specifier: string, issueType: IssueType) => IgnoreInput;
+export declare const isIgnore: (input: Input) => input is IgnoreInput;
 export declare const toDebugString: (input: Input) => string;
 export {};

package/dist/util/input.js

@@ -57,4 +57,10 @@ export const toAlias = (specifier, prefix, options = {}) => ({
     ...options,
 });
 export const isAlias = (input) => input.type === 'alias';
+export const toIgnore = (specifier, issueType) => ({
+    type: 'ignore',
+    specifier,
+    issueType,
+});
+export const isIgnore = (input) => input.type === 'ignore';
 export const toDebugString = (input) => `${input.type}:${isAbsolute(input.specifier) ? toRelative(input.specifier) : input.specifier}${input.containingFilePath ? ` (${toRelative(input.containingFilePath)})` : ''}`;

package/dist/util/resolve.d.ts

@@ -1,2 +1,4 @@
-export declare const createSyncResolver: (extensions: string[]) => (specifier: string, baseDir: string) => string | undefined;
+declare const createSyncResolver: (extensions: string[]) => (specifier: string, baseDir: string) => string | undefined;
 export declare const _resolveSync: (specifier: string, baseDir: string) => string | undefined;
+export declare const _createSyncResolver: typeof createSyncResolver;
+export {};

package/dist/util/resolve.js

@@ -1,23 +1,21 @@
-import fs from 'node:fs';
-import ER from 'enhanced-resolve';
+import { ResolverFactory } from 'oxc-resolver';
 import { DEFAULT_EXTENSIONS } from '../constants.js';
 import { timerify } from './Performance.js';
 import { toPosix } from './path.js';
-const fileSystem = new ER.CachedInputFileSystem(fs, 9999999);
-export const createSyncResolver = (extensions) => {
-    const resolver = ER.create.sync({
-        fileSystem,
+const createSyncResolver = (extensions) => {
+    const resolver = new ResolverFactory({
         extensions,
         conditionNames: ['require', 'import', 'node', 'default'],
     });
     return function resolveSync(specifier, baseDir) {
         try {
-            const resolved = resolver({}, baseDir, specifier);
-            if (resolved)
-                return toPosix(resolved);
+            const resolved = resolver.sync(baseDir, specifier);
+            if (resolved?.path)
+                return toPosix(resolved.path);
         }
         catch (_error) { }
     };
 };
 const resolveSync = createSyncResolver([...DEFAULT_EXTENSIONS, '.json']);
 export const _resolveSync = timerify(resolveSync);
+export const _createSyncResolver = extensions => timerify(createSyncResolver(extensions));

package/dist/util/table.d.ts

@@ -12,9 +12,11 @@ export declare class Table {
         truncateStart?: string[];
         noTruncate?: string[];
     });
+    row(): this;
     cell(column: string, value: Value, formatter?: (value: Value) => string): this;
-    newRow(): this;
-    sort(compareFn: ((a: any, b: any) => number) | string): this;
+    sort(column: string): this;
+    toCells(): string[][];
+    toRows(): string[];
     toString(): string;
 }
 export {};

package/dist/util/table.js

@@ -16,30 +16,24 @@ export class Table {
         this.truncateStart = options?.truncateStart || [];
         this.noTruncate = options?.noTruncate || [];
     }
+    row() {
+        this.rows.push({});
+        return this;
+    }
     cell(column, value, formatter) {
         if (!this.columns.includes(column))
             this.columns.push(column);
         const row = this.rows[this.rows.length - 1];
-        row[column] = {
-            value,
-            formatted: formatter ? formatter(value) : undefined,
-            align: typeof value === 'number' ? 'right' : 'left',
-        };
-        return this;
-    }
-    newRow() {
-        this.rows.push({});
+        const align = typeof value === 'number' ? 'right' : 'left';
+        const formatted = formatter ? formatter(value) : undefined;
+        row[column] = { value, formatted, align };
         return this;
     }
-    sort(compareFn) {
-        if (typeof compareFn === 'function') {
-            this.rows.sort(compareFn);
-            return this;
-        }
+    sort(column) {
         this.rows.sort((a, b) => {
-            const [col, order] = compareFn.split('|');
-            const vA = a[col].value;
-            const vB = b[col].value;
+            const [columnName, order] = column.split('|');
+            const vA = a[columnName].value;
+            const vB = b[columnName].value;
             if (typeof vA === 'string' && typeof vB === 'string')
                 return (order === 'desc' ? -1 : 1) * vA.localeCompare(vB);
             if (typeof vA === 'number' && typeof vB === 'number')
@@ -48,7 +42,7 @@ export class Table {
         });
         return this;
     }
-    toString() {
+    toCells() {
         const columns = this.columns.filter(col => this.rows.some(row => typeof row[col].value === 'string' || typeof row[col].value === 'number'));
         if (this.header) {
             const headerRow = {};
@@ -87,17 +81,19 @@ export class Table {
                 columnWidths[truncatableColumns.length > 0 ? truncatableColumns[0] : columns[0]] += roundingDiff;
             }
         }
-        return this.rows
-            .map(row => columns
-            .map((col, index) => {
+        return this.rows.map(row => columns.map((col, index) => {
             const cell = row[col];
             const width = columnWidths[col];
             const fill = cell.fill || ' ';
             const padded = pad(String(cell.formatted || cell.value || ''), width, fill, cell.align);
             const truncated = this.truncateStart.includes(col) ? truncateStart(padded, width) : truncate(padded, width);
             return index === 0 ? truncated : COLUMN_SEPARATOR + truncated;
-        })
-            .join(''))
-            .join('\n');
+        }));
+    }
+    toRows() {
+        return this.toCells().map(row => row.join(''));
+    }
+    toString() {
+        return this.toRows().join('\n');
     }
 }

package/dist/util/watch.js

@@ -42,7 +42,7 @@ export const getWatchHandler = async ({ analyzedFiles, analyzeSourceFile, chief,
                             debugLog(workspace.name, `Watcher: ± ${filename}`);
                             break;
                     }
-                    const filePaths = principal.getUsedResolvedFiles();
+                    const filePaths = factory.getPrincipals().flatMap(p => p.getUsedResolvedFiles());
                     if (event === 'added' || event === 'deleted') {
                         graph.clear();
                         for (const filePath of filePaths)
@@ -56,7 +56,7 @@ export const getWatchHandler = async ({ analyzedFiles, analyzeSourceFile, chief,
                             else {
                                 graph.delete(filePath);
                                 analyzedFiles.delete(filePath);
-                                if (filePath.startsWith(cwd))
+                                if (principal.projectPaths.has(filePath))
                                     cachedUnusedFiles.add(filePath);
                             }
                         }

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "5.55.1";
+export declare const version = "5.56.0";

package/dist/version.js

@@ -1 +1 @@
-export const version = '5.55.1';
+export const version = '5.56.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "5.55.1",
+  "version": "5.56.0",
   "description": "Find and fix unused dependencies, exports and files in your TypeScript and JavaScript projects",
   "homepage": "https://knip.dev",
   "repository": {
@@ -62,12 +62,12 @@
   ],
   "dependencies": {
     "@nodelib/fs.walk": "^1.2.3",
-    "enhanced-resolve": "^5.18.1",
     "fast-glob": "^3.3.3",
     "formatly": "^0.2.3",
     "jiti": "^2.4.2",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
+    "oxc-resolver": "^9.0.2",
     "picocolors": "^1.1.0",
     "picomatch": "^4.0.1",
     "smol-toml": "^1.3.1",

package/schema.json

@@ -359,6 +359,10 @@
           "title": "dependency-cruiser plugin configuration (https://knip.dev/reference/plugins/dependency-cruiser)",
           "$ref": "#/definitions/plugin"
         },
+        "docusaurus": {
+          "title": "Docusaurus plugin configuration (https://knip.dev/reference/plugins/docusaurus)",
+          "$ref": "#/definitions/plugin"
+        },
         "dotenv": {
           "title": "dotenv plugin configuration (https://knip.dev/reference/plugins/dotenv)",
           "$ref": "#/definitions/plugin"