knip 5.63.0 → 5.63.1

package/dist/types/{cli.d.ts → options.d.ts}

@@ -1,4 +1,4 @@
-export interface CommandLineOptions {
+export interface Options {
     cacheLocation: string;
     cwd: string;
     excludedIssueTypes: string[];
@@ -20,7 +20,7 @@ export interface CommandLineOptions {
     isShowProgress: boolean;
     isStrict: boolean;
     isWatch: boolean;
-    tags: Tags;
+    tags: string[];
     tsConfigFile: string | undefined;
     workspace: string | undefined;
 }

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

@@ -45,6 +45,7 @@ export type PackageJson = {
     browser?: string;
     types?: string;
     typings?: string;
+    packageManager?: string;
 } & Plugins;
 export type WorkspacePackage = {
     dir: string;

package/dist/types/project.d.ts

@@ -3,16 +3,10 @@ import type { AsyncCompilers, SyncCompilers } from '../compilers/types.js';
 import type { ToSourceFilePath } from '../util/to-source-path.js';
 export type Paths = ts.CompilerOptions['paths'];
 export type PrincipalOptions = {
-    cwd: string;
+    dir: string;
     isFile: boolean;
     compilerOptions: ts.CompilerOptions;
     compilers: [SyncCompilers, AsyncCompilers];
     pkgName: string;
-    isIsolateWorkspaces: boolean;
-    isSkipLibs: boolean;
-    isWatch: boolean;
     toSourceFilePath: ToSourceFilePath;
-    isCache: boolean;
-    cacheLocation: string;
-    isProduction: boolean;
 };

package/dist/typescript/get-imports-and-exports.d.ts

@@ -1,5 +1,5 @@
 import ts from 'typescript';
-import type { GetImportsAndExportsOptions } from '../types/config.js';
+import type { GetImportsAndExportsOptions, IgnoreExportsUsedInFile } from '../types/config.js';
 import type { FileNode } from '../types/module-graph.js';
 import type { BoundSourceFile } from './SourceFile.js';
-export declare const _getImportsAndExports: (sourceFile: BoundSourceFile, resolveModule: (specifier: string) => ts.ResolvedModuleFull | undefined, typeChecker: ts.TypeChecker, options: GetImportsAndExportsOptions) => FileNode;
+export declare const _getImportsAndExports: (sourceFile: BoundSourceFile, resolveModule: (specifier: string) => ts.ResolvedModuleFull | undefined, typeChecker: ts.TypeChecker, options: GetImportsAndExportsOptions, ignoreExportsUsedInFile: IgnoreExportsUsedInFile, skipExports: boolean) => FileNode;

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

@@ -33,8 +33,7 @@ const createMember = (node, member, pos) => {
         jsDocTags: getJSDocTags(member.node),
     };
 };
-const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options) => {
-    const { skipTypeOnly, tags, ignoreExportsUsedInFile } = options;
+const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options, ignoreExportsUsedInFile, skipExports) => {
     const internal = new Map();
     const external = new Set();
     const unresolved = new Set();
@@ -112,23 +111,23 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options) =
                 importedInternalSymbols.set(symbol, filePath);
         }
     };
-    const addImport = (options, node) => {
-        const { specifier, isTypeOnly, pos, identifier = ANONYMOUS, isReExport = false } = options;
+    const addImport = (opts, node) => {
+        const { specifier, isTypeOnly, pos, identifier = ANONYMOUS, isReExport = false } = opts;
         if (isBuiltin(specifier))
             return;
         const module = resolveModule(specifier);
         if (module) {
             const filePath = module.resolvedFileName;
             if (filePath) {
-                if (options.resolve && !isInNodeModules(filePath)) {
+                if (opts.resolve && !isInNodeModules(filePath)) {
                     resolved.add(filePath);
                     return;
                 }
                 if (!module.isExternalLibraryImport || !isInNodeModules(filePath)) {
-                    addInternalImport({ ...options, identifier, filePath, isReExport });
+                    addInternalImport({ ...opts, identifier, filePath, isReExport });
                 }
                 if (module.isExternalLibraryImport) {
-                    if (skipTypeOnly && isTypeOnly)
+                    if (options.skipTypeOnly && isTypeOnly)
                         return;
                     const sanitizedSpecifier = sanitizeSpecifier(isInNodeModules(specifier) || isInNodeModules(filePath) ? getPackageNameFromFilePath(specifier) : specifier);
                     if (!isStartsLikePackageName(sanitizedSpecifier)) {
@@ -139,9 +138,9 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options) =
             }
         }
         else {
-            if (skipTypeOnly && isTypeOnly)
+            if (options.skipTypeOnly && isTypeOnly)
                 return;
-            if (shouldIgnore(getJSDocTags(node), tags))
+            if (shouldIgnore(getJSDocTags(node), options.tags))
                 return;
             if (specifier.startsWith(PROTOCOL_VIRTUAL))
                 return;
@@ -155,7 +154,7 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options) =
         }
     };
     const addExport = ({ node, symbol, identifier, type, pos, members = [], fix }) => {
-        if (options.skipExports)
+        if (skipExports)
             return;
         if (symbol) {
             const importedSymbolFilePath = importedInternalSymbols.get(symbol);

package/dist/util/Performance.js

@@ -1,12 +1,22 @@
 import os from 'node:os';
 import { PerformanceObserver, performance } from 'node:perf_hooks';
 import { memoryUsage } from 'node:process';
-import parsedArgValues from './cli-arguments.js';
+import { parseArgs } from 'node:util';
 import { getStats } from './math.js';
 import { Table } from './table.js';
-const { performance: enableTimerify = false, 'performance-fn': timerifyOnlyFnName, memory: enableMemoryUsage = false, 'memory-realtime': memoryRealtime = false, } = parsedArgValues;
-const isTimerifyFunctions = enableTimerify || !!timerifyOnlyFnName;
-const isMemoryUsageEnabled = enableMemoryUsage || memoryRealtime;
+const { values } = parseArgs({
+    strict: false,
+    options: {
+        performance: { type: 'boolean' },
+        'performance-fn': { type: 'string' },
+        memory: { type: 'boolean' },
+        'memory-realtime': { type: 'boolean' },
+    },
+});
+const timerifyOnlyFnName = values['performance-fn'];
+const isMemoryRealtime = !!values['memory-realtime'];
+const isTimerifyFunctions = !!values.performance || !!timerifyOnlyFnName;
+const isMemoryUsageEnabled = !!values.memory || isMemoryRealtime;
 export const timerify = (fn, name = fn.name) => {
     if (!isTimerifyFunctions)
         return fn;
@@ -57,7 +67,7 @@ class Performance {
                 }
             });
             this.memObserver.observe({ type: 'mark' });
-            if (memoryRealtime)
+            if (isMemoryRealtime)
                 logHead();
             this.addMemoryMark(0);
         }
@@ -108,7 +118,7 @@ class Performance {
         const id = `${this.memId}:${index}`;
         const detail = getMemInfo();
         performance.mark(id, { detail });
-        if (memoryRealtime && detail)
+        if (isMemoryRealtime && detail)
             log(detail);
     }
     getMemoryUsageTable() {

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

@@ -1,5 +1,5 @@
 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: {
+export default function (): {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;
     config?: string | undefined;
@@ -45,4 +45,3 @@ declare const _default: {
     watch?: boolean | undefined;
     workspace?: string | undefined;
 };
-export default _default;

package/dist/util/cli-arguments.js

@@ -60,9 +60,8 @@ $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
 $ knip --tags=-lintignore
 
 Website: https://knip.dev`;
-let parsedArgs;
-try {
-    parsedArgs = parseArgs({
+export default function () {
+    return parseArgs({
         options: {
             cache: { type: 'boolean' },
             'cache-location': { type: 'string' },
@@ -109,14 +108,5 @@ try {
             watch: { type: 'boolean' },
             workspace: { type: 'string', short: 'W' },
         },
-    });
+    }).values;
 }
-catch (error) {
-    if (error instanceof Error) {
-        console.error(error.message);
-        console.log(`\n${helpText}`);
-        process.exit(1);
-    }
-    throw error;
-}
-export default parsedArgs.values;