knip 5.63.1 → 5.64.1

package/dist/schema/plugins.js

@@ -1,12 +1,12 @@
-import { z } from 'zod';
+import { z } from 'zod/mini';
 export const globSchema = z.union([z.string(), z.array(z.string())]);
 export const pluginSchema = z.union([
     z.boolean(),
     globSchema,
     z.object({
-        config: globSchema.optional(),
-        entry: globSchema.optional(),
-        project: globSchema.optional(),
+        config: z.optional(globSchema),
+        entry: z.optional(globSchema),
+        project: z.optional(globSchema),
     }),
 ]);
 export const pluginsSchema = z.object({
@@ -15,6 +15,7 @@ export const pluginsSchema = z.object({
     ava: pluginSchema,
     babel: pluginSchema,
     biome: pluginSchema,
+    bumpp: pluginSchema,
     bun: pluginSchema,
     c8: pluginSchema,
     capacitor: pluginSchema,
@@ -88,6 +89,7 @@ export const pluginsSchema = z.object({
     rsbuild: pluginSchema,
     rslib: pluginSchema,
     rspack: pluginSchema,
+    rstest: pluginSchema,
     'semantic-release': pluginSchema,
     sentry: pluginSchema,
     'simple-git-hooks': pluginSchema,

package/dist/types/PluginNames.d.ts

@@ -1,2 +1,2 @@
-export type PluginName = 'angular' | 'astro' | 'ava' | 'babel' | 'biome' | 'bun' | 'c8' | 'capacitor' | 'changelogen' | 'changelogithub' | 'changesets' | 'commitizen' | 'commitlint' | 'convex' | 'create-typescript-app' | 'cspell' | 'cucumber' | 'cypress' | 'dependency-cruiser' | 'docusaurus' | 'dotenv' | 'drizzle' | 'eleventy' | 'eslint' | 'expo' | 'gatsby' | 'github-action' | 'github-actions' | 'glob' | 'graphql-codegen' | 'hardhat' | 'husky' | 'i18next-parser' | 'jest' | 'karma' | 'ladle' | 'lefthook' | 'lint-staged' | 'linthtml' | 'lockfile-lint' | 'lost-pixel' | 'markdownlint' | 'metro' | 'mocha' | 'moonrepo' | 'msw' | 'nano-staged' | 'nest' | 'netlify' | 'next' | 'node' | 'node-modules-inspector' | 'nodemon' | 'npm-package-json-lint' | 'nuxt' | 'nx' | 'nyc' | 'oclif' | 'oxlint' | 'playwright' | 'playwright-ct' | 'playwright-test' | 'plop' | 'pnpm' | 'postcss' | 'preconstruct' | 'prettier' | 'prisma' | 'react-cosmos' | 'react-router' | 'relay' | 'release-it' | 'remark' | 'remix' | 'rollup' | 'rsbuild' | 'rslib' | 'rspack' | 'semantic-release' | 'sentry' | 'simple-git-hooks' | 'size-limit' | 'sst' | 'starlight' | 'storybook' | 'stryker' | 'stylelint' | 'svelte' | 'svgo' | 'syncpack' | 'tailwind' | 'travis' | 'ts-node' | 'tsdown' | 'tsup' | 'tsx' | 'typedoc' | 'typescript' | 'unbuild' | 'unocss' | 'vercel-og' | 'vike' | 'vite' | 'vitest' | 'vue' | 'webdriver-io' | 'webpack' | 'wireit' | 'wrangler' | 'xo' | 'yarn' | 'yorkie';
-export declare const pluginNames: readonly ["angular", "astro", "ava", "babel", "biome", "bun", "c8", "capacitor", "changelogen", "changelogithub", "changesets", "commitizen", "commitlint", "convex", "create-typescript-app", "cspell", "cucumber", "cypress", "dependency-cruiser", "docusaurus", "dotenv", "drizzle", "eleventy", "eslint", "expo", "gatsby", "github-action", "github-actions", "glob", "graphql-codegen", "hardhat", "husky", "i18next-parser", "jest", "karma", "ladle", "lefthook", "lint-staged", "linthtml", "lockfile-lint", "lost-pixel", "markdownlint", "metro", "mocha", "moonrepo", "msw", "nano-staged", "nest", "netlify", "next", "node", "node-modules-inspector", "nodemon", "npm-package-json-lint", "nuxt", "nx", "nyc", "oclif", "oxlint", "playwright", "playwright-ct", "playwright-test", "plop", "pnpm", "postcss", "preconstruct", "prettier", "prisma", "react-cosmos", "react-router", "relay", "release-it", "remark", "remix", "rollup", "rsbuild", "rslib", "rspack", "semantic-release", "sentry", "simple-git-hooks", "size-limit", "sst", "starlight", "storybook", "stryker", "stylelint", "svelte", "svgo", "syncpack", "tailwind", "travis", "ts-node", "tsdown", "tsup", "tsx", "typedoc", "typescript", "unbuild", "unocss", "vercel-og", "vike", "vite", "vitest", "vue", "webdriver-io", "webpack", "wireit", "wrangler", "xo", "yarn", "yorkie"];
+export type PluginName = 'angular' | 'astro' | 'ava' | 'babel' | 'biome' | 'bumpp' | 'bun' | 'c8' | 'capacitor' | 'changelogen' | 'changelogithub' | 'changesets' | 'commitizen' | 'commitlint' | 'convex' | 'create-typescript-app' | 'cspell' | 'cucumber' | 'cypress' | 'dependency-cruiser' | 'docusaurus' | 'dotenv' | 'drizzle' | 'eleventy' | 'eslint' | 'expo' | 'gatsby' | 'github-action' | 'github-actions' | 'glob' | 'graphql-codegen' | 'hardhat' | 'husky' | 'i18next-parser' | 'jest' | 'karma' | 'ladle' | 'lefthook' | 'lint-staged' | 'linthtml' | 'lockfile-lint' | 'lost-pixel' | 'markdownlint' | 'metro' | 'mocha' | 'moonrepo' | 'msw' | 'nano-staged' | 'nest' | 'netlify' | 'next' | 'node' | 'node-modules-inspector' | 'nodemon' | 'npm-package-json-lint' | 'nuxt' | 'nx' | 'nyc' | 'oclif' | 'oxlint' | 'playwright' | 'playwright-ct' | 'playwright-test' | 'plop' | 'pnpm' | 'postcss' | 'preconstruct' | 'prettier' | 'prisma' | 'react-cosmos' | 'react-router' | 'relay' | 'release-it' | 'remark' | 'remix' | 'rollup' | 'rsbuild' | 'rslib' | 'rspack' | 'rstest' | 'semantic-release' | 'sentry' | 'simple-git-hooks' | 'size-limit' | 'sst' | 'starlight' | 'storybook' | 'stryker' | 'stylelint' | 'svelte' | 'svgo' | 'syncpack' | 'tailwind' | 'travis' | 'ts-node' | 'tsdown' | 'tsup' | 'tsx' | 'typedoc' | 'typescript' | 'unbuild' | 'unocss' | 'vercel-og' | 'vike' | 'vite' | 'vitest' | 'vue' | 'webdriver-io' | 'webpack' | 'wireit' | 'wrangler' | 'xo' | 'yarn' | 'yorkie';
+export declare const pluginNames: readonly ["angular", "astro", "ava", "babel", "biome", "bumpp", "bun", "c8", "capacitor", "changelogen", "changelogithub", "changesets", "commitizen", "commitlint", "convex", "create-typescript-app", "cspell", "cucumber", "cypress", "dependency-cruiser", "docusaurus", "dotenv", "drizzle", "eleventy", "eslint", "expo", "gatsby", "github-action", "github-actions", "glob", "graphql-codegen", "hardhat", "husky", "i18next-parser", "jest", "karma", "ladle", "lefthook", "lint-staged", "linthtml", "lockfile-lint", "lost-pixel", "markdownlint", "metro", "mocha", "moonrepo", "msw", "nano-staged", "nest", "netlify", "next", "node", "node-modules-inspector", "nodemon", "npm-package-json-lint", "nuxt", "nx", "nyc", "oclif", "oxlint", "playwright", "playwright-ct", "playwright-test", "plop", "pnpm", "postcss", "preconstruct", "prettier", "prisma", "react-cosmos", "react-router", "relay", "release-it", "remark", "remix", "rollup", "rsbuild", "rslib", "rspack", "rstest", "semantic-release", "sentry", "simple-git-hooks", "size-limit", "sst", "starlight", "storybook", "stryker", "stylelint", "svelte", "svgo", "syncpack", "tailwind", "travis", "ts-node", "tsdown", "tsup", "tsx", "typedoc", "typescript", "unbuild", "unocss", "vercel-og", "vike", "vite", "vitest", "vue", "webdriver-io", "webpack", "wireit", "wrangler", "xo", "yarn", "yorkie"];

package/dist/types/PluginNames.js

@@ -4,6 +4,7 @@ export const pluginNames = [
     'ava',
     'babel',
     'biome',
+    'bumpp',
     'bun',
     'c8',
     'capacitor',
@@ -77,6 +78,7 @@ export const pluginNames = [
     'rsbuild',
     'rslib',
     'rspack',
+    'rstest',
     'semantic-release',
     'sentry',
     'simple-git-hooks',

package/dist/types/args.d.ts

@@ -1,4 +1,5 @@
 import type { ParsedArgs } from 'minimist';
+import type { Input } from '../util/input.js';
 export type ConfigArg = boolean | (string | [string, (id: string) => string])[];
 export type Args = {
     binaries?: string[];
@@ -11,4 +12,5 @@ export type Args = {
     config?: ConfigArg;
     args?: (args: string[]) => string[];
     fromArgs?: string[] | ((parsed: ParsedArgs, args: string[]) => string[]);
+    resolveInputs?: (parsed: ParsedArgs, args: string[]) => Input[];
 };

package/dist/types/config.d.ts

@@ -1,13 +1,13 @@
 import type ts from 'typescript';
-import type { z } from 'zod';
+import type { z } from 'zod/mini';
 import type { AsyncCompilers, SyncCompilers } from '../compilers/types.js';
 import type { knipConfigurationSchema } from '../schema/configuration.js';
 import type { pluginSchema } from '../schema/plugins.js';
 import type { Input } from '../util/input.js';
-import type { PluginName } from './PluginNames.js';
 import type { Args } from './args.js';
 import type { SymbolType } from './issues.js';
 import type { Tags } from './options.js';
+import type { PluginName } from './PluginNames.js';
 import type { PackageJson } from './package-json.js';
 export interface GetInputsFromScriptsOptions extends BaseOptions {
     knownBinsOnly?: boolean;

package/dist/types/exports.d.ts

@@ -1,7 +1,7 @@
 import type ts from 'typescript';
 import type { SymbolType } from './issues.js';
 type Identifier = string;
-type ExportPosTuple = [number, number, number];
+export type ExportPosTuple = [number, number, number];
 export type Fix = ExportPosTuple | undefined;
 export type Fixes = Array<ExportPosTuple>;
 export type ExportNode = {

package/dist/types/imports.d.ts

@@ -4,7 +4,7 @@ export interface ImportNode {
     identifier: string | undefined;
     alias?: string | undefined;
     namespace?: string | undefined;
-    pos: number | undefined;
+    pos: number;
     symbol?: ts.Symbol;
     isTypeOnly?: boolean;
     isReExport?: boolean;

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

@@ -19,7 +19,7 @@ export type ImportDetails = {
     reExportedNs: IdToFileMap;
 };
 export type ImportMap = Map<FilePath, ImportDetails>;
-export type UnresolvedImport = {
+export type Import = {
     specifier: string;
     pos?: number;
     line?: number;
@@ -50,13 +50,14 @@ export type ExportMember = {
     jsDocTags: Tags;
 };
 export type ExportMap = Map<Identifier, Export>;
+export type Specifiers = Set<[Import, FilePath]>;
 export type FileNode = {
     imports: {
         internal: ImportMap;
-        external: Set<string>;
-        unresolved: Set<UnresolvedImport>;
+        external: Set<Import>;
+        unresolved: Set<Import>;
         resolved: Set<FilePath>;
-        specifiers: Set<[string, FilePath]>;
+        specifiers: Specifiers;
     };
     exports: ExportMap;
     duplicates: Iterable<Array<IssueSymbol>>;

package/dist/typescript/SourceFile.d.ts

@@ -14,8 +14,8 @@ type PragmaMap = {
             pos?: number;
         };
         types?: {
-            value?: string;
-            pos?: number;
+            value: string;
+            pos: number;
         };
     };
     range?: {

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

@@ -49,3 +49,7 @@ export declare const isModuleExportsAccess: (node: ts.PropertyAccessExpression)
 export declare const getImportMap: (sourceFile: ts.SourceFile) => Map<string, string>;
 export declare const getDefaultImportName: (importMap: ReturnType<typeof getImportMap>, specifier: string) => string | undefined;
 export declare const getPropertyValues: (node: ts.ObjectLiteralExpression, propertyName: string) => Set<string>;
+export declare const getAccessedIdentifiers: (identifier: string, scope: ts.Node) => {
+    identifier: string;
+    pos: number;
+}[];

package/dist/typescript/ast-helpers.js

@@ -265,3 +265,32 @@ export const getPropertyValues = (node, propertyName) => {
     }
     return values;
 };
+export const getAccessedIdentifiers = (identifier, scope) => {
+    const identifiers = [];
+    function visit(node) {
+        if (ts.isPropertyAccessExpression(node) && node.expression.getText() === identifier) {
+            identifiers.push({ identifier: String(node.name.escapedText), pos: node.name.pos });
+        }
+        else if (ts.isElementAccessExpression(node) &&
+            node.expression.getText() === identifier &&
+            ts.isStringLiteral(node.argumentExpression)) {
+            identifiers.push({
+                identifier: stripQuotes(node.argumentExpression.text),
+                pos: node.argumentExpression.pos,
+            });
+        }
+        else if (ts.isVariableDeclaration(node) &&
+            node.initializer?.getText() === identifier &&
+            ts.isObjectBindingPattern(node.name)) {
+            for (const element of node.name.elements) {
+                if (ts.isBindingElement(element)) {
+                    const identifier = (element.propertyName ?? element.name).getText();
+                    identifiers.push({ identifier, pos: element.pos });
+                }
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(scope);
+    return identifiers;
+};

package/dist/typescript/find-internal-references.js

@@ -38,12 +38,21 @@ export const findInternalReferences = (item, sourceFile, typeChecker, referenced
                     const declaration = symbol.declarations?.[0];
                     if (declaration) {
                         if (findInFlow(declaration.name?.flowNode, item.symbol)) {
-                            return [++refCount, isSymbolInExport];
+                            refCount++;
+                            return [refCount, isSymbolInExport];
                         }
                         if (ts.isImportSpecifier(declaration) && symbols.has(symbol)) {
                             return [++refCount, isSymbolInExport];
                         }
                     }
+                    if (symbol && symbol.flags & ts.SymbolFlags.Property) {
+                        const type = typeChecker.getTypeOfSymbol(symbol);
+                        if (type?.symbol && item.symbol === type.symbol) {
+                            refCount++;
+                            if (isBindingElement)
+                                return [refCount, isSymbolInExport];
+                        }
+                    }
                     symbols.add(symbol);
                 }
             }

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

@@ -1,9 +1,9 @@
 import { isBuiltin } from 'node:module';
 import ts from 'typescript';
 import { ALIAS_TAG, ANONYMOUS, IMPORT_STAR, PROTOCOL_VIRTUAL } from '../constants.js';
-import { timerify } from '../util/Performance.js';
 import { addNsValue, addValue, createImports } from '../util/module-graph.js';
 import { getPackageNameFromFilePath, isStartsLikePackageName, sanitizeSpecifier } from '../util/modules.js';
+import { timerify } from '../util/Performance.js';
 import { isInNodeModules } from '../util/path.js';
 import { shouldIgnore } from '../util/tag.js';
 import { getAccessMembers, getDestructuredIds, getJSDocTags, getLineAndCharacterOfPosition, getTypeRef, isAccessExpression, isConsiderReferencedNS, isDestructuring, isImportSpecifier, isInForIteration, isObjectEnumerationCallExpressionArgument, isReferencedInExport, } from './ast-helpers.js';
@@ -78,7 +78,7 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options, i
     const addInternalImport = (options) => {
         const { identifier, symbol, filePath, namespace, alias, specifier, isReExport } = options;
         const isStar = identifier === IMPORT_STAR;
-        specifiers.add([specifier, filePath]);
+        specifiers.add([{ specifier, pos: options.pos, line: options.line, col: options.col }, filePath]);
         const file = internal.get(filePath);
         const imports = file ?? createImports();
         if (!file)
@@ -112,10 +112,9 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options, i
         }
     };
     const addImport = (opts, node) => {
-        const { specifier, isTypeOnly, pos, identifier = ANONYMOUS, isReExport = false } = opts;
-        if (isBuiltin(specifier))
+        if (isBuiltin(opts.specifier))
             return;
-        const module = resolveModule(specifier);
+        const module = resolveModule(opts.specifier);
         if (module) {
             const filePath = module.resolvedFileName;
             if (filePath) {
@@ -124,33 +123,44 @@ const getImportsAndExports = (sourceFile, resolveModule, typeChecker, options, i
                     return;
                 }
                 if (!module.isExternalLibraryImport || !isInNodeModules(filePath)) {
-                    addInternalImport({ ...opts, identifier, filePath, isReExport });
+                    const { line, character } = node.getSourceFile().getLineAndCharacterOfPosition(opts.pos);
+                    addInternalImport({
+                        ...opts,
+                        identifier: opts.identifier ?? ANONYMOUS,
+                        filePath,
+                        isReExport: opts.isReExport ?? false,
+                        line: line + 1,
+                        col: character + 1,
+                    });
                 }
                 if (module.isExternalLibraryImport) {
-                    if (options.skipTypeOnly && isTypeOnly)
+                    if (options.skipTypeOnly && opts.isTypeOnly)
                         return;
-                    const sanitizedSpecifier = sanitizeSpecifier(isInNodeModules(specifier) || isInNodeModules(filePath) ? getPackageNameFromFilePath(specifier) : specifier);
+                    const isInNM = isInNodeModules(opts.specifier);
+                    const sanitizedSpecifier = sanitizeSpecifier(isInNM || isInNodeModules(filePath) ? getPackageNameFromFilePath(opts.specifier) : opts.specifier);
                     if (!isStartsLikePackageName(sanitizedSpecifier)) {
                         return;
                     }
-                    external.add(sanitizedSpecifier);
+                    if (isInNM) {
+                        external.add({ specifier: sanitizedSpecifier });
+                    }
+                    else {
+                        const { line, character } = sourceFile.getLineAndCharacterOfPosition(opts.pos);
+                        external.add({ specifier: sanitizedSpecifier, pos: opts.pos, line: line + 1, col: character + 2 });
+                    }
                 }
             }
         }
         else {
-            if (options.skipTypeOnly && isTypeOnly)
+            if (options.skipTypeOnly && opts.isTypeOnly)
                 return;
             if (shouldIgnore(getJSDocTags(node), options.tags))
                 return;
-            if (specifier.startsWith(PROTOCOL_VIRTUAL))
+            if (opts.specifier.startsWith(PROTOCOL_VIRTUAL))
                 return;
-            if (typeof pos === 'number') {
-                const { line, character } = sourceFile.getLineAndCharacterOfPosition(pos);
-                unresolved.add({ specifier, pos, line: line + 1, col: character + 1 });
-            }
-            else {
-                unresolved.add({ specifier });
-            }
+            const pos = 'moduleSpecifier' in node ? node.moduleSpecifier.pos : node.pos;
+            const { line, character } = sourceFile.getLineAndCharacterOfPosition(pos);
+            unresolved.add({ specifier: opts.specifier, pos, line: line + 1, col: character + 2 });
         }
     };
     const addExport = ({ node, symbol, identifier, type, pos, members = [], fix }) => {

package/dist/typescript/resolve-module-names.js

@@ -2,8 +2,8 @@ import { existsSync } from 'node:fs';
 import { isBuiltin } from 'node:module';
 import ts from 'typescript';
 import { DEFAULT_EXTENSIONS } from '../constants.js';
-import { timerify } from '../util/Performance.js';
 import { sanitizeSpecifier } from '../util/modules.js';
+import { timerify } from '../util/Performance.js';
 import { dirname, extname, isAbsolute, isInNodeModules, join } from '../util/path.js';
 import { _createSyncResolver, _resolveSync } from '../util/resolve.js';
 import { isDeclarationFileExtension } from './ast-helpers.js';

package/dist/typescript/visitors/dynamic-imports/importCall.js

@@ -1,6 +1,6 @@
 import ts from 'typescript';
 import { ANONYMOUS } from '../../../constants.js';
-import { findAncestor, findDescendants, isAccessExpression, isImportCall, isTopLevel, stripQuotes, } from '../../ast-helpers.js';
+import { findAncestor, findDescendants, getAccessedIdentifiers, isAccessExpression, isImportCall, isTopLevel, stripQuotes, } from '../../ast-helpers.js';
 import { importVisitor as visit } from '../index.js';
 const getSymbol = (node, isTopLevel) => (isTopLevel ? node.symbol : undefined);
 export default visit(() => true, node => {
@@ -64,6 +64,11 @@ export default visit(() => true, node => {
                     if (ts.isIdentifier(variableDeclaration.name)) {
                         const alias = String(variableDeclaration.name.escapedText);
                         const symbol = getSymbol(variableDeclaration, isTLA);
+                        const scope = findAncestor(variableDeclaration, ts.isFunctionBody) || node.getSourceFile();
+                        const accessed = getAccessedIdentifiers(alias, scope);
+                        if (accessed.length > 0) {
+                            return accessed.map(acc => ({ identifier: acc.identifier, alias, symbol, specifier, pos: acc.pos }));
+                        }
                         return { identifier: 'default', alias, symbol, specifier, pos: node.arguments[0].pos };
                     }
                     const bindings = findDescendants(variableDeclaration, ts.isBindingElement);

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  -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";
-export default function (): {
+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, 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 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";
+export type ParsedCLIArgs = ReturnType<typeof parseCLIArgs>;
+export default function parseCLIArgs(): {
     cache?: boolean | undefined;
     'cache-location'?: string | undefined;
     config?: string | undefined;

package/dist/util/cli-arguments.js

@@ -29,7 +29,7 @@ Options:
   -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)
-  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, can be repeated (default: symbols)
+  --reporter               Select reporter: symbols, compact, codeowners, json, codeclimate, markdown, disclosure, github-actions, can be repeated (default: symbols)
   --reporter-options       Pass extra options to the reporter (as JSON string, see example)
   --tags                   Include or exclude tagged exports
   --no-config-hints        Suppress configuration hints
@@ -60,7 +60,7 @@ $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
 $ knip --tags=-lintignore
 
 Website: https://knip.dev`;
-export default function () {
+export default function parseCLIArgs() {
     return parseArgs({
         options: {
             cache: { type: 'boolean' },

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

@@ -1,8 +1,7 @@
 import type { Options } from '../types/options.js';
-import type parseArgs from './cli-arguments.js';
-type ParsedArgs = ReturnType<typeof parseArgs>;
+import type { ParsedCLIArgs } from './cli-arguments.js';
 interface CreateOptions extends Partial<Options> {
-    parsedCLIArgs?: ParsedArgs;
+    parsedCLIArgs?: ParsedCLIArgs;
 }
 export declare const createOptions: (options: CreateOptions) => Promise<{
     cacheLocation: string;
@@ -39,13 +38,6 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
     isTreatConfigHintsAsErrors: boolean;
     isWatch: boolean;
     parsedConfig: {
-        node?: string | boolean | string[] | {
-            config?: string | string[] | undefined;
-            entry?: string | string[] | undefined;
-            project?: string | string[] | undefined;
-        } | undefined;
-        entry?: string | string[] | undefined;
-        project?: string | string[] | undefined;
         angular?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -71,6 +63,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        bumpp?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         bun?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -296,6 +293,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        node?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'node-modules-inspector'?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -431,6 +433,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        rstest?: string | boolean | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'semantic-release'?: string | boolean | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -601,32 +608,7 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
-        exclude?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
-        $schema?: string | undefined;
-        rules?: Partial<Record<"files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers", "error" | "warn" | "off">> | undefined;
-        paths?: Record<string, string[]> | undefined;
-        ignore?: string | string[] | undefined;
-        ignoreBinaries?: (string | RegExp)[] | undefined;
-        ignoreDependencies?: (string | RegExp)[] | undefined;
-        ignoreMembers?: (string | RegExp)[] | undefined;
-        ignoreUnresolved?: (string | RegExp)[] | undefined;
-        ignoreExportsUsedInFile?: boolean | Partial<Record<"function" | "type" | "enum" | "class" | "interface" | "member", boolean>> | undefined;
-        ignoreWorkspaces?: string[] | undefined;
-        includeEntryExports?: boolean | undefined;
-        compilers?: Record<string, true | ((args_0: string, args_1: string, ...args: unknown[]) => string) | ((args_0: string, args_1: string, ...args: unknown[]) => Promise<string>)> | undefined;
-        syncCompilers?: Record<string, true | ((args_0: string, args_1: string, ...args: unknown[]) => string)> | undefined;
-        asyncCompilers?: Record<string, (args_0: string, args_1: string, ...args: unknown[]) => Promise<string>> | undefined;
-        tags?: string[] | undefined;
-        treatConfigHintsAsErrors?: boolean | undefined;
-        include?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
         workspaces?: Record<string, {
-            node?: string | boolean | string[] | {
-                config?: string | string[] | undefined;
-                entry?: string | string[] | undefined;
-                project?: string | string[] | undefined;
-            } | undefined;
-            entry?: string | string[] | undefined;
-            project?: string | string[] | undefined;
             angular?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -652,6 +634,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            bumpp?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             bun?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -877,6 +864,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            node?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             'node-modules-inspector'?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1012,6 +1004,11 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            rstest?: string | boolean | string[] | {
+                config?: string | string[] | undefined;
+                entry?: string | string[] | undefined;
+                project?: string | string[] | undefined;
+            } | undefined;
             'semantic-release'?: string | boolean | string[] | {
                 config?: string | string[] | undefined;
                 entry?: string | string[] | undefined;
@@ -1182,6 +1179,8 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
                 entry?: string | string[] | undefined;
                 project?: string | string[] | undefined;
             } | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
             paths?: Record<string, string[]> | undefined;
             ignore?: string | string[] | undefined;
             ignoreBinaries?: (string | RegExp)[] | undefined;
@@ -1190,6 +1189,33 @@ export declare const createOptions: (options: CreateOptions) => Promise<{
             ignoreUnresolved?: (string | RegExp)[] | undefined;
             includeEntryExports?: boolean | undefined;
         }> | undefined;
+        include?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
+        exclude?: ("files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers")[] | undefined;
+        $schema?: string | undefined;
+        rules?: Partial<Record<"files" | "dependencies" | "devDependencies" | "optionalPeerDependencies" | "unlisted" | "binaries" | "unresolved" | "exports" | "types" | "nsExports" | "nsTypes" | "duplicates" | "enumMembers" | "classMembers", "error" | "warn" | "off">> | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+        paths?: Record<string, string[]> | undefined;
+        ignore?: string | string[] | undefined;
+        ignoreBinaries?: (string | RegExp)[] | undefined;
+        ignoreDependencies?: (string | RegExp)[] | undefined;
+        ignoreMembers?: (string | RegExp)[] | undefined;
+        ignoreUnresolved?: (string | RegExp)[] | undefined;
+        ignoreExportsUsedInFile?: boolean | {
+            class?: boolean | undefined;
+            enum?: boolean | undefined;
+            function?: boolean | undefined;
+            interface?: boolean | undefined;
+            member?: boolean | undefined;
+            type?: boolean | undefined;
+        } | undefined;
+        ignoreWorkspaces?: string[] | undefined;
+        includeEntryExports?: boolean | undefined;
+        compilers?: Record<string, true | ((filename: string, contents: string) => string) | ((filename: string, contents: string) => Promise<string>)> | undefined;
+        syncCompilers?: Record<string, true | ((filename: string, contents: string) => string)> | undefined;
+        asyncCompilers?: Record<string, (filename: string, contents: string) => Promise<string>> | undefined;
+        tags?: string[] | undefined;
+        treatConfigHintsAsErrors?: boolean | undefined;
     };
     rules: {
         files: import("../types/issues.js").IssueSeverity;

package/dist/util/create-options.js

@@ -30,7 +30,7 @@ export const createOptions = async (options) => {
     if (parsedCLIArgs.config && !configFilePath && !manifest.knip) {
         throw new ConfigurationError(`Unable to find ${parsedCLIArgs.config} or package.json#knip`);
     }
-    const loadedConfig = Object.assign({}, manifest.knip, configFilePath ? await loadResolvedConfigFile(configFilePath) : {});
+    const loadedConfig = Object.assign({}, manifest.knip, configFilePath ? await loadResolvedConfigFile(configFilePath, parsedCLIArgs) : {});
     const parsedConfig = knipConfigurationSchema.parse(partitionCompilers(loadedConfig));
     if (!configFilePath && manifest.knip)
         configFilePath = manifestPath;

package/dist/util/errors.d.ts

@@ -1,4 +1,4 @@
-import { ZodError } from 'zod';
+import { core } from 'zod/mini';
 interface ErrorWithCause extends Error {
     cause: Error;
 }
@@ -6,8 +6,8 @@ export declare class ConfigurationError extends Error {
 }
 export declare class LoaderError extends Error {
 }
-export declare const isKnownError: (error: Error) => error is ZodError<any> | ConfigurationError | LoaderError;
-export declare const isDisplayReason: (error: Error) => error is ErrorWithCause;
+export declare const isKnownError: (error: Error) => error is core.$ZodError<any> | ConfigurationError | LoaderError;
+export declare const hasErrorCause: (error: Error) => error is ErrorWithCause;
 export declare const isConfigurationError: (error: Error) => error is ConfigurationError;
-export declare const getKnownError: (error: Error) => Error;
+export declare const getKnownErrors: (error: Error) => Error[];
 export {};

package/dist/util/errors.js

@@ -1,14 +1,14 @@
-import { ZodError } from 'zod';
-import { fromZodError, isValidationError } from 'zod-validation-error';
+import { core } from 'zod/mini';
+const isZodErrorLike = (error) => error instanceof core.$ZodError;
 export class ConfigurationError extends Error {
 }
 export class LoaderError extends Error {
 }
-export const isKnownError = (error) => error instanceof ConfigurationError || error instanceof LoaderError || error instanceof ZodError;
-export const isDisplayReason = (error) => !isValidationError(error) && error.cause instanceof Error;
+export const isKnownError = (error) => error instanceof ConfigurationError || error instanceof LoaderError || isZodErrorLike(error);
+export const hasErrorCause = (error) => !isZodErrorLike(error) && error.cause instanceof Error;
 export const isConfigurationError = (error) => error instanceof ConfigurationError;
-export const getKnownError = (error) => {
-    if (error instanceof ZodError)
-        return fromZodError(error);
-    return error;
+export const getKnownErrors = (error) => {
+    if (isZodErrorLike(error))
+        return [...error.issues].map(error => new Error(error.message));
+    return [error];
 };

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

@@ -1,9 +1,9 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { deserialize, serialize } from 'node:v8';
-import { timerify } from './Performance.js';
 import { debugLog } from './debug.js';
 import { isDirectory, isFile } from './fs.js';
+import { timerify } from './Performance.js';
 import { dirname, isAbsolute, resolve } from './path.js';
 const createCache = (filePath) => {
     try {