knip 1.3.0 → 1.4.0

package/README.md

@@ -233,26 +233,27 @@ Knip contains a growing list of plugins:
 - [Cypress][14]
 - [ESLint][15]
 - [Gatsby][16]
-- [Jest][17]
-- [lint-staged][18]
-- [markdownlint][19]
-- [Mocha][20]
-- [Next.js][21]
-- [npm-package-json-lint][22]
-- [Nx][23]
-- [nyc][24]
-- [Playwright][25]
-- [PostCSS][26]
-- [Prettier][27]
-- [Release It][28]
-- [Remark][29]
-- [Remix][30]
-- [Rollup][31]
-- [Sentry][32]
-- [Storybook][33]
-- [Stryker][34]
-- [TypeScript][35]
-- [Webpack][36]
+- [GitHub Actions][17]
+- [Jest][18]
+- [lint-staged][19]
+- [markdownlint][20]
+- [Mocha][21]
+- [Next.js][22]
+- [npm-package-json-lint][23]
+- [Nx][24]
+- [nyc][25]
+- [Playwright][26]
+- [PostCSS][27]
+- [Prettier][28]
+- [Release It][29]
+- [Remark][30]
+- [Remix][31]
+- [Rollup][32]
+- [Sentry][33]
+- [Storybook][34]
+- [Stryker][35]
+- [TypeScript][36]
+- [Webpack][37]
 
 Plugins are automatically activated, no need to enable anything. Each plugin is automatically enabled based on simple
 heuristics. Most of them check whether one or one of a few (dev) dependencies are listed in `package.json`. Once
@@ -260,7 +261,7 @@ enabled, they add a set of configuration and/or entry files for Knip to analyze.
 
 Most plugins use one or both of the following file types:
 
-- `config` - custom dependency resolvers are applied to the [config files][37]
+- `config` - custom dependency resolvers are applied to the [config files][38]
 - `entry` - files to include with the analysis of the rest of the source code
 
 See each plugin's documentation for its default values.
@@ -340,10 +341,10 @@ locations. The more plugins Knip will have, the more projects can be analyzed ou
 
 Knip provides the following built-in reporters:
 
-- [`codeowners`][38]
-- [`compact`][39]
-- [`json`][40]
-- [`symbol`][41] (default)
+- [`codeowners`][39]
+- [`compact`][40]
+- [`json`][41]
+- [`symbol`][42] (default)
 
 The `compact` reporter shows the sorted files first, and then a list of symbols:
 
@@ -370,7 +371,7 @@ type ReporterOptions = {
 
 The data can then be used to write issues to `stdout`, a JSON or CSV file, or sent to a service.
 
-Find more details and ideas in [custom reporters][42].
+Find more details and ideas in [custom reporters][43].
 
 ## Libraries and "unused" exports
 
@@ -427,14 +428,14 @@ When unused dependencies are related to dependencies having a Knip [plugin][1],
 for that dependency are at custom locations. The default values are at the plugin's documentation, and can be overridden
 to match the custom location(s).
 
-When the dependencies don't have a Knip plugin yet, please file an issue or [create a new plugin][43].
+When the dependencies don't have a Knip plugin yet, please file an issue or [create a new plugin][44].
 
 #### Too many unused exports
 
 When the project is a library and the exports are meant to be used by consumers of the library, there are two options:
 
 1.  By default, unused exports of `entry` files are not reported, so you can add the containing file to it.
-2.  The exported values or types can be marked [using the JSDoc `@public` tag][44].
+2.  The exported values or types can be marked [using the JSDoc `@public` tag][45].
 
 ### How to start using Knip in CI while having too many issues to sort out?
 
@@ -451,7 +452,7 @@ All of this is hiding problems, so please make sure to plan for fixing them and/
 
 This table is an ongoing comparison. Based on their docs (please report any mistakes):
 
-| Feature                            | **knip** | [depcheck][45] | [unimported][46] | [ts-unused-exports][47] | [ts-prune][48] |
+| Feature                            | **knip** | [depcheck][46] | [unimported][47] | [ts-unused-exports][48] | [ts-prune][49] |
 | :--------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
 | Unused files                       |    ✅    |       -        |        ✅        |            -            |       -        |
 | Unused dependencies                |    ✅    |       ✅       |        ✅        |            -            |       -        |
@@ -465,7 +466,7 @@ This table is an ongoing comparison. Based on their docs (please report any mist
 | Custom reporters                   |    ✅    |       -        |        -         |            -            |       -        |
 | JavaScript support                 |    ✅    |       ✅       |        ✅        |            -            |       -        |
 | Configure entry files              |    ✅    |       ❌       |        ✅        |           ❌            |       ❌       |
-| [Support workspaces/monorepos][49] |    ✅    |       ❌       |        ❌        |            -            |       -        |
+| [Support workspaces/monorepos][50] |    ✅    |       ❌       |        ❌        |            -            |       -        |
 | ESLint plugin available            |    -     |       -        |        -         |           ✅            |       -        |
 
 ✅ = Supported, ❌ = Not supported, - = Out of scope
@@ -486,7 +487,7 @@ The following commands are similar:
     unimported
     knip --production --dependencies --include files
 
-Also see [production mode][50].
+Also see [production mode][51].
 
 ### ts-unused-exports
 
@@ -532,37 +533,38 @@ for the job. I'm motivated to make knip perfectly suited for the job of cutting
 [14]: ./src/plugins/cypress
 [15]: ./src/plugins/eslint
 [16]: ./src/plugins/gatsby
-[17]: ./src/plugins/jest
-[18]: ./src/plugins/lint-staged
-[19]: ./src/plugins/markdownlint
-[20]: ./src/plugins/mocha
-[21]: ./src/plugins/next
-[22]: ./src/plugins/npm-package-json-lint
-[23]: ./src/plugins/nx
-[24]: ./src/plugins/nyc
-[25]: ./src/plugins/playwright
-[26]: ./src/plugins/postcss
-[27]: ./src/plugins/prettier
-[28]: ./src/plugins/release-it
-[29]: ./src/plugins/remark
-[30]: ./src/plugins/remix
-[31]: ./src/plugins/rollup
-[32]: ./src/plugins/sentry
-[33]: ./src/plugins/storybook
-[34]: ./src/plugins/stryker
-[35]: ./src/plugins/typescript
-[36]: ./src/plugins/webpack
-[37]: #config
-[38]: #code-owners
-[39]: #compact
-[40]: #json
-[41]: #symbol-default
-[42]: ./docs/custom-reporters.md
-[43]: #create-a-new-plugin
-[44]: #libraries-and-unused-exports
-[45]: https://github.com/depcheck/depcheck
-[46]: https://github.com/smeijer/unimported
-[47]: https://github.com/pzavolinsky/ts-unused-exports
-[48]: https://github.com/nadeesha/ts-prune
-[49]: #workspaces--monorepos
-[50]: #production-mode
+[17]: ./src/plugins/github-actions
+[18]: ./src/plugins/jest
+[19]: ./src/plugins/lint-staged
+[20]: ./src/plugins/markdownlint
+[21]: ./src/plugins/mocha
+[22]: ./src/plugins/next
+[23]: ./src/plugins/npm-package-json-lint
+[24]: ./src/plugins/nx
+[25]: ./src/plugins/nyc
+[26]: ./src/plugins/playwright
+[27]: ./src/plugins/postcss
+[28]: ./src/plugins/prettier
+[29]: ./src/plugins/release-it
+[30]: ./src/plugins/remark
+[31]: ./src/plugins/remix
+[32]: ./src/plugins/rollup
+[33]: ./src/plugins/sentry
+[34]: ./src/plugins/storybook
+[35]: ./src/plugins/stryker
+[36]: ./src/plugins/typescript
+[37]: ./src/plugins/webpack
+[38]: #config
+[39]: #code-owners
+[40]: #compact
+[41]: #json
+[42]: #symbol-default
+[43]: ./docs/custom-reporters.md
+[44]: #create-a-new-plugin
+[45]: #libraries-and-unused-exports
+[46]: https://github.com/depcheck/depcheck
+[47]: https://github.com/smeijer/unimported
+[48]: https://github.com/pzavolinsky/ts-unused-exports
+[49]: https://github.com/nadeesha/ts-prune
+[50]: #workspaces--monorepos
+[51]: #production-mode

package/dist/cli.js

@@ -4,6 +4,7 @@ import { register } from 'esbuild-register/dist/node.js';
 import reporters from './reporters/index.js';
 import parsedArgs, { helpText } from './util/cli-arguments.js';
 import { ConfigurationError } from './util/errors.js';
+import { _load } from './util/loader.js';
 import { measure } from './util/performance.js';
 import { main } from './index.js';
 register();
@@ -14,7 +15,7 @@ if (help) {
 }
 const cwd = process.cwd();
 const isShowProgress = !isDebug && isNoProgress === false && process.stdout.isTTY && typeof process.stdout.cursorTo === 'function';
-const printReport = reporter in reporters ? reporters[reporter] : await import(path.join(cwd, reporter));
+const printReport = reporter in reporters ? reporters[reporter] : await _load(path.join(cwd, reporter));
 const run = async () => {
     try {
         const { report, issues, counters } = await main({

package/dist/configuration-chief.d.ts

@@ -1,7 +1,5 @@
 /// <reference types="npmcli__package-json" />
-import { z } from 'zod';
-import { ConfigurationValidator } from './configuration-validator.js';
-import type { Configuration, WorkspaceConfiguration } from './types/config.js';
+import type { RawConfiguration, Configuration, WorkspaceConfiguration } from './types/config.js';
 import type { PackageJson } from '@npmcli/package-json';
 type ConfigurationManagerOptions = {
     cwd: string;
@@ -16,7 +14,7 @@ export default class ConfigurationChief {
     manifestWorkspaces: undefined | string[];
     constructor({ cwd, isProduction }: ConfigurationManagerOptions);
     loadLocalConfig(): Promise<void>;
-    normalize(rawLocalConfig: z.infer<typeof ConfigurationValidator>): {
+    normalize(rawLocalConfig: RawConfiguration): {
         include: string[];
         exclude: string[];
         ignore: string[];

package/dist/configuration-validator.d.ts

@@ -119,6 +119,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         }>]>>;
+        'github-actions': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+            config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        }, "strip", z.ZodTypeAny, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }, {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        }>]>>;
         'lint-staged': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
             config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
             entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -397,6 +410,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'github-actions'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'lint-staged'?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -531,6 +549,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'github-actions'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'lint-staged'?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -727,6 +750,19 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     }>]>>;
+    'github-actions': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
+        config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        project: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }, {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    }>]>>;
     'lint-staged': z.ZodOptional<z.ZodUnion<[z.ZodLiteral<false>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, z.ZodObject<{
         config: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         entry: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
@@ -1010,6 +1046,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'github-actions'?: string | false | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     'lint-staged'?: string | false | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1144,6 +1185,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'github-actions'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'lint-staged'?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;
@@ -1284,6 +1330,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
         entry?: string | string[] | undefined;
         project?: string | string[] | undefined;
     } | undefined;
+    'github-actions'?: string | false | string[] | {
+        config?: string | string[] | undefined;
+        entry?: string | string[] | undefined;
+        project?: string | string[] | undefined;
+    } | undefined;
     'lint-staged'?: string | false | string[] | {
         config?: string | string[] | undefined;
         entry?: string | string[] | undefined;
@@ -1418,6 +1469,11 @@ export declare const ConfigurationValidator: z.ZodObject<z.extendShape<z.extendS
             entry?: string | string[] | undefined;
             project?: string | string[] | undefined;
         } | undefined;
+        'github-actions'?: string | false | string[] | {
+            config?: string | string[] | undefined;
+            entry?: string | string[] | undefined;
+            project?: string | string[] | undefined;
+        } | undefined;
         'lint-staged'?: string | false | string[] | {
             config?: string | string[] | undefined;
             entry?: string | string[] | undefined;

package/dist/configuration-validator.js

@@ -30,6 +30,7 @@ const pluginsSchema = z.object({
     eslint: pluginSchema,
     gatsby: pluginSchema,
     jest: pluginSchema,
+    'github-actions': pluginSchema,
     'lint-staged': pluginSchema,
     mocha: pluginSchema,
     next: pluginSchema,

package/dist/constants.d.ts

@@ -9,6 +9,5 @@ export declare const DEFAULT_WORKSPACE_CONFIG: {
 export declare const TEST_FILE_PATTERNS: string[];
 export declare const IGNORED_GLOBAL_BINARIES: string[];
 export declare const IGNORE_DEFINITELY_TYPED: string[];
-export declare const FIRST_ARGUMENT_AS_BINARY_EXCEPTIONS: string[];
 export declare const ISSUE_TYPES: IssueType[];
 export declare const ISSUE_TYPE_TITLE: Record<IssueType, string>;

package/dist/constants.js

@@ -8,7 +8,6 @@ export const DEFAULT_WORKSPACE_CONFIG = {
 export const TEST_FILE_PATTERNS = ['**/*.{test,spec}.{js,jsx,ts,tsx}', '**/__tests__/**/*.{js,jsx,ts,tsx}'];
 export const IGNORED_GLOBAL_BINARIES = ['npm', 'npx', 'node', 'yarn', 'pnpm', 'deno', 'git'];
 export const IGNORE_DEFINITELY_TYPED = ['node'];
-export const FIRST_ARGUMENT_AS_BINARY_EXCEPTIONS = ['npx', 'cross-env', 'dotenv'];
 export const ISSUE_TYPES = [
     'files',
     'dependencies',

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import type { CommandLineOptions } from './types/cli.js';
 import type { Report } from './types/issues.js';
+export type { RawConfiguration as KnipConfig } from './types/config.js';
+export type { Reporter, ReporterOptions } from './types/issues.js';
 export declare const main: (unresolvedConfiguration: CommandLineOptions) => Promise<{
     report: Report;
     issues: import("./types/issues.js").Issues;

package/dist/manifest/helpers.d.ts

@@ -1,2 +1 @@
-export declare const getBinariesFromScripts: (npmScripts: string[]) => string[];
 export declare const getPackageManifest: (workingDir: string, packageName: string, isRoot: boolean, cwd: string) => Promise<any>;

package/dist/manifest/helpers.js

@@ -1,37 +1,5 @@
 import path from 'node:path';
-import { FIRST_ARGUMENT_AS_BINARY_EXCEPTIONS } from '../constants.js';
-import { getArgumentValues } from '../util/plugin.js';
 import { require } from '../util/require.js';
-const normalizeBinaries = (command) => command.replace(/(\.\/)?node_modules\/\.bin\/(\w+)/, '$2').replace(/\$\(npm bin\)\/(\w+)/, '$1');
-const stripEnvironmentVariables = (value) => value.replace(/([A-Z][^ ]*)=([^ ])+ /g, '');
-const getLoaderArgumentValues = (value) => getArgumentValues(value, / (--(experimental-)?loader|--require|-r)[ =]([^ ]+)/g);
-const getDependenciesFromLoaderArguments = (args) => getLoaderArgumentValues(' ' + args.join(' '))
-    .filter(scripts => !scripts.startsWith('.'))
-    .map(script => {
-    if (script.startsWith('@')) {
-        const [scope, packageName] = script.split('/');
-        return [scope, packageName].join('/');
-    }
-    return script.split('/')[0];
-});
-export const getBinariesFromScripts = (npmScripts) => Array.from(npmScripts.reduce((binaries, script) => {
-    script
-        .split(' && ')
-        .flatMap(command => command.split(' -- '))
-        .map(normalizeBinaries)
-        .filter(command => /^\w/.test(command))
-        .map(stripEnvironmentVariables)
-        .flatMap(command => {
-        const [binary, ...args] = command.trim().split(' ');
-        if (binary === 'npx' && /-y|--yes/.test(args[0]))
-            return [binary];
-        const firstArgument = FIRST_ARGUMENT_AS_BINARY_EXCEPTIONS.includes(binary) && args.find(arg => !arg.startsWith('-'));
-        const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
-        return [binary, firstArgument, ...dependenciesFromArguments];
-    })
-        .forEach(binary => binary && binaries.add(binary));
-    return binaries;
-}, new Set()));
 export const getPackageManifest = async (workingDir, packageName, isRoot, cwd) => {
     try {
         return require(path.join(workingDir, 'node_modules', packageName, 'package.json'));

package/dist/manifest/index.js

@@ -1,6 +1,6 @@
-import { IGNORED_GLOBAL_BINARIES } from '../constants.js';
+import { getBinariesFromScripts } from '../util/binaries/index.js';
 import { timerify } from '../util/performance.js';
-import { getBinariesFromScripts, getPackageManifest } from './helpers.js';
+import { getPackageManifest } from './helpers.js';
 const findManifestDependencies = async ({ rootConfig, manifest, isRoot, isProduction, dir, cwd }) => {
     const { ignoreBinaries } = rootConfig;
     const scriptFilter = isProduction ? ['start', 'postinstall'] : [];
@@ -12,9 +12,7 @@ const findManifestDependencies = async ({ rootConfig, manifest, isRoot, isProduc
         }
         return scripts;
     }, []);
-    const referencedBinaries = getBinariesFromScripts(scripts)
-        .filter(binaryName => !IGNORED_GLOBAL_BINARIES.includes(binaryName))
-        .filter(binaryName => !ignoreBinaries.includes(binaryName));
+    const referencedBinaries = getBinariesFromScripts(scripts, { manifest, ignore: rootConfig.ignoreBinaries });
     const installedBinaries = new Map();
     const packageNames = [...Object.keys(manifest.dependencies ?? {}), ...Object.keys(manifest.devDependencies ?? {})];
     for (const packageName of packageNames) {

package/dist/plugins/github-actions/index.d.ts

@@ -0,0 +1,6 @@
+import type { IsPluginEnabledCallback, GenericPluginCallback } from '../../types/plugins.js';
+export declare const NAME = "GitHub Actions";
+export declare const ENABLERS = "This plugin is enabled when a `.yml` file is found in the `.github/workflows` folder.";
+export declare const isEnabled: IsPluginEnabledCallback;
+export declare const CONFIG_FILE_PATTERNS: string[];
+export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/github-actions/index.js

@@ -0,0 +1,26 @@
+import { EOL } from 'os';
+import { getBinariesFromScripts } from '../../util/binaries/index.js';
+import { _firstGlob } from '../../util/glob.js';
+import { _load } from '../../util/loader.js';
+import { getValuesByKeyDeep } from '../../util/object.js';
+import { timerify } from '../../util/performance.js';
+export const NAME = 'GitHub Actions';
+export const ENABLERS = 'This plugin is enabled when a `.yml` file is found in the `.github/workflows` folder.';
+export const isEnabled = () => Boolean(_firstGlob({ cwd: process.cwd(), patterns: ['.github/workflows/*.yml'] }));
+export const CONFIG_FILE_PATTERNS = ['.github/workflows/*.yml'];
+const findGithubActionsDependencies = async (configFilePath, { manifest, rootConfig }) => {
+    const config = await _load(configFilePath);
+    if (!config)
+        return [];
+    const scripts = getValuesByKeyDeep(config, 'run')
+        .filter((value) => typeof value === 'string')
+        .flatMap(script => script.split(EOL))
+        .map(script => script.trim());
+    const binaries = getBinariesFromScripts(scripts, {
+        manifest,
+        ignore: rootConfig.ignoreBinaries,
+        knownGlobalsOnly: true,
+    });
+    return binaries;
+};
+export const findDependencies = timerify(findGithubActionsDependencies);

package/dist/plugins/index.d.ts

@@ -5,6 +5,7 @@ export * as commitlint from './commitlint/index.js';
 export * as cypress from './cypress/index.js';
 export * as eslint from './eslint/index.js';
 export * as gatsby from './gatsby/index.js';
+export * as githubActions from './github-actions/index.js';
 export * as jest from './jest/index.js';
 export * as lintStaged from './lint-staged/index.js';
 export * as markdownlint from './markdownlint/index.js';

package/dist/plugins/index.js

@@ -5,6 +5,7 @@ export * as commitlint from './commitlint/index.js';
 export * as cypress from './cypress/index.js';
 export * as eslint from './eslint/index.js';
 export * as gatsby from './gatsby/index.js';
+export * as githubActions from './github-actions/index.js';
 export * as jest from './jest/index.js';
 export * as lintStaged from './lint-staged/index.js';
 export * as markdownlint from './markdownlint/index.js';

package/dist/plugins/lint-staged/index.js

@@ -1,4 +1,4 @@
-import { getBinariesFromScripts } from '../../manifest/helpers.js';
+import { getBinariesFromScripts } from '../../util/binaries/index.js';
 import { _load } from '../../util/loader.js';
 import { timerify } from '../../util/performance.js';
 import { hasDependency } from '../../util/plugin.js';
@@ -13,7 +13,7 @@ export const CONFIG_FILE_PATTERNS = [
     'lint-staged.config.{js,mjs,cjs}',
     'package.json',
 ];
-const findLintStagedDependencies = async (configFilePath, { manifest }) => {
+const findLintStagedDependencies = async (configFilePath, { manifest, rootConfig }) => {
     let config = configFilePath.endsWith('package.json')
         ? manifest['lint-staged']
         : await _load(configFilePath);
@@ -25,7 +25,7 @@ const findLintStagedDependencies = async (configFilePath, { manifest }) => {
     const binaries = new Set();
     for (const entry of Object.values(config).flat()) {
         const scripts = [typeof entry === 'function' ? await entry([]) : entry].flat();
-        getBinariesFromScripts(scripts).forEach(binary => binaries.add(binary));
+        getBinariesFromScripts(scripts, { manifest, ignore: rootConfig.ignoreBinaries }).forEach(bin => binaries.add(bin));
     }
     return Array.from(binaries);
 };

package/dist/reporters/index.d.ts

@@ -1,7 +1,7 @@
 declare const _default: {
-    symbols: ({ report, issues }: import("../types/issues.js").ReporterOptions) => void;
-    compact: ({ report, issues }: import("../types/issues.js").ReporterOptions) => void;
-    codeowners: ({ report, issues, options }: import("../types/issues.js").ReporterOptions) => void;
-    json: ({ report, issues, options }: import("../types/issues.js").ReporterOptions) => Promise<void>;
+    symbols: ({ report, issues }: import("../index.js").ReporterOptions) => void;
+    compact: ({ report, issues }: import("../index.js").ReporterOptions) => void;
+    codeowners: ({ report, issues, options }: import("../index.js").ReporterOptions) => void;
+    json: ({ report, issues, options }: import("../index.js").ReporterOptions) => Promise<void>;
 };
 export default _default;

package/dist/types/config.d.ts

@@ -1,4 +1,7 @@
+import { z } from 'zod';
+import { ConfigurationValidator } from '../configuration-validator.js';
 import * as Plugins from '../plugins/index.js';
+export type RawConfiguration = z.infer<typeof ConfigurationValidator>;
 type NormalizedGlob = string[];
 export type PluginName = keyof typeof Plugins;
 export type PluginConfiguration = {

package/dist/types/plugins.d.ts

@@ -1,4 +1,4 @@
-import { PluginConfiguration, WorkspaceConfiguration } from './config.js';
+import { Configuration, PluginConfiguration, WorkspaceConfiguration } from './config.js';
 import type { PackageJson } from 'type-fest';
 type IsPluginEnabledCallbackOptions = {
     manifest: PackageJson;
@@ -10,6 +10,7 @@ type GenericPluginCallbackOptions = {
     manifest: PackageJson;
     config: PluginConfiguration;
     workspaceConfig: WorkspaceConfiguration;
+    rootConfig: Configuration;
     isProduction: boolean;
 };
 export type GenericPluginCallback = (configFilePath: string, { cwd, manifest, config, workspaceConfig, isProduction }: GenericPluginCallbackOptions) => Promise<string[]> | string[];

package/dist/util/binaries/binaries/cross-env.d.ts

@@ -0,0 +1 @@
+export declare const resolve: (binary: string, args: string[]) => string[];

package/dist/util/binaries/binaries/cross-env.js

@@ -0,0 +1,5 @@
+import { getDependenciesFromLoaderArguments } from '../index.js';
+export const resolve = (binary, args) => {
+    const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
+    return [binary, args[0], ...dependenciesFromArguments];
+};

package/dist/util/binaries/binaries/dotenv.d.ts

@@ -0,0 +1 @@
+export declare const resolve: (binary: string, args: string[]) => string[];

package/dist/util/binaries/binaries/dotenv.js

@@ -0,0 +1,5 @@
+import { getDependenciesFromLoaderArguments } from '../index.js';
+export const resolve = (binary, args) => {
+    const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
+    return [binary, args[0], ...dependenciesFromArguments];
+};

package/dist/util/binaries/binaries/index.d.ts

@@ -0,0 +1,2 @@
+export * as crossEnv from './cross-env.js';
+export * as dotenv from './dotenv.js';

package/dist/util/binaries/binaries/index.js

@@ -0,0 +1,2 @@
+export * as crossEnv from './cross-env.js';
+export * as dotenv from './dotenv.js';

package/dist/util/binaries/globals/index.d.ts

@@ -0,0 +1,4 @@
+export * as node from './node.js';
+export * as npx from './npx.js';
+export * as pnpm from './pnpm.js';
+export * as yarn from './yarn.js';

package/dist/util/binaries/globals/index.js

@@ -0,0 +1,4 @@
+export * as node from './node.js';
+export * as npx from './npx.js';
+export * as pnpm from './pnpm.js';
+export * as yarn from './yarn.js';

package/dist/util/binaries/globals/node.d.ts

@@ -0,0 +1 @@
+export declare const resolve: (binary: string, args: string[]) => string[];

package/dist/util/binaries/globals/node.js

@@ -0,0 +1,5 @@
+import { getDependenciesFromLoaderArguments } from '../index.js';
+export const resolve = (binary, args) => {
+    const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
+    return dependenciesFromArguments;
+};

package/dist/util/binaries/globals/npx.d.ts

@@ -0,0 +1 @@
+export declare const resolve: (binary: string, args: string[]) => (string | undefined)[];

package/dist/util/binaries/globals/npx.js

@@ -0,0 +1,8 @@
+import { getDependenciesFromLoaderArguments } from '../index.js';
+export const resolve = (binary, args) => {
+    if (/-y|--yes/.test(args[0]))
+        return [];
+    const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
+    const firstArgument = args.find(arg => !arg.startsWith('-'));
+    return [firstArgument, ...dependenciesFromArguments];
+};

package/dist/util/binaries/globals/pnpm.d.ts

@@ -0,0 +1,2 @@
+import type { PackageJson } from 'type-fest';
+export declare const resolve: (binary: string, args: string[], manifest: PackageJson) => string | never[] | undefined;

package/dist/util/binaries/globals/pnpm.js

@@ -0,0 +1,43 @@
+const commands = [
+    'add',
+    'i',
+    'install',
+    'up',
+    'update',
+    'upgrade',
+    'remove',
+    'rm',
+    'uninstall',
+    'un',
+    'link',
+    'ln',
+    'unlink',
+    'import',
+    'rebuild',
+    'rb',
+    'prune',
+    'fetch',
+    'install-test',
+    'it',
+    'patch',
+    'patch-commit',
+    'audit',
+    'list',
+    'ls',
+    'outdated',
+    'why',
+    'test',
+    't',
+    'tst',
+];
+export const resolve = (binary, args, manifest) => {
+    const scripts = manifest.scripts ? Object.keys(manifest.scripts) : [];
+    const [command, ...commandArgs] = args;
+    if (scripts.includes(command) || commands.includes(command))
+        return [];
+    if (command === 'run' && scripts.includes(commandArgs[0]))
+        return [];
+    if (command === 'run' || command === 'exec')
+        return commandArgs.find(arg => !arg.startsWith('-'));
+    return args.find(arg => !arg.startsWith('-'));
+};

package/dist/util/binaries/globals/yarn.d.ts

@@ -0,0 +1,2 @@
+import type { PackageJson } from 'type-fest';
+export declare const resolve: (binary: string, args: string[], manifest: PackageJson) => string | never[] | undefined;

package/dist/util/binaries/globals/yarn.js

@@ -0,0 +1,42 @@
+const commands = [
+    'add',
+    'bin',
+    'cache',
+    'config',
+    'constraints',
+    'dedupe',
+    'dlx',
+    'explain',
+    'info',
+    'init',
+    'install',
+    'link',
+    'pack',
+    'patch',
+    'patch-commit',
+    'plugin',
+    'rebuild',
+    'remove',
+    'search',
+    'set',
+    'stage',
+    'unlink',
+    'unplug',
+    'up',
+    'upgrade-interactive',
+    'version',
+    'why',
+    'workspace',
+    'workspaces',
+];
+export const resolve = (binary, args, manifest) => {
+    const scripts = manifest.scripts ? Object.keys(manifest.scripts) : [];
+    const [command, ...commandArgs] = args;
+    if (scripts.includes(command) || commands.includes(command))
+        return [];
+    if (command === 'run' && scripts.includes(commandArgs[0]))
+        return [];
+    if (command === 'run' || command === 'exec')
+        return commandArgs.find(arg => !arg.startsWith('-'));
+    return args.find(arg => !arg.startsWith('-'));
+};

package/dist/util/binaries/index.d.ts

@@ -0,0 +1,7 @@
+import type { PackageJson } from 'type-fest';
+export declare const getDependenciesFromLoaderArguments: (args: string[]) => string[];
+export declare const getBinariesFromScripts: (npmScripts: string[], { manifest, ignore, knownGlobalsOnly, }: {
+    manifest: PackageJson;
+    ignore?: string[] | undefined;
+    knownGlobalsOnly?: boolean | undefined;
+}) => string[];

package/dist/util/binaries/index.js

@@ -0,0 +1,46 @@
+import { IGNORED_GLOBAL_BINARIES } from '../../constants.js';
+import { getArgumentValues } from '../plugin.js';
+import { toCamelCase } from '../plugin.js';
+import * as BinaryResolvers from './binaries/index.js';
+import * as GlobalBinaryResolvers from './globals/index.js';
+const normalizeBinaries = (command) => command
+    .replace(/(\.\/)?node_modules\/\.bin\/(\w+)/, '$2')
+    .replace(/\$\(npm bin\)\/(\w+)/, '$1')
+    .replace(/(\S+)@.*/, '$1');
+const stripEnvironmentVariables = (value) => value.replace(/([A-Z][^ ]*)=([^ ])+ /g, '');
+const getLoaderArgumentValues = (value) => getArgumentValues(value, / (--(experimental-)?loader|--require|-r)[ =]([^ ]+)/g);
+export const getDependenciesFromLoaderArguments = (args) => getLoaderArgumentValues(' ' + args.join(' '))
+    .filter(scripts => !scripts.startsWith('.'))
+    .map(script => {
+    if (script.startsWith('@')) {
+        const [scope, packageName] = script.split('/');
+        return [scope, packageName].join('/');
+    }
+    return script.split('/')[0];
+});
+export const getBinariesFromScripts = (npmScripts, { manifest, ignore = [], knownGlobalsOnly = false, }) => Array.from(npmScripts.reduce((binaries, script) => {
+    script
+        .split(' && ')
+        .flatMap(command => command.split(' -- '))
+        .map(normalizeBinaries)
+        .filter(command => /^\w/.test(command))
+        .map(stripEnvironmentVariables)
+        .flatMap(command => {
+        const [binary, ...args] = command.trim().split(' ');
+        const camelCased = toCamelCase(binary);
+        if (['bun', 'deno'].includes(binary))
+            return [];
+        if (camelCased in GlobalBinaryResolvers) {
+            return GlobalBinaryResolvers[camelCased].resolve(binary, args, manifest);
+        }
+        if (knownGlobalsOnly)
+            return [];
+        if (camelCased in BinaryResolvers) {
+            return BinaryResolvers[camelCased].resolve(binary, args);
+        }
+        const dependenciesFromArguments = getDependenciesFromLoaderArguments(args);
+        return [binary, ...dependenciesFromArguments];
+    })
+        .forEach(binary => binary && binaries.add(binary));
+    return binaries;
+}, new Set())).filter(binaryName => !IGNORED_GLOBAL_BINARIES.includes(binaryName) && !ignore.includes(binaryName));

package/dist/util/debug.js

@@ -47,13 +47,3 @@ export const debugLogIssues = (name, issues) => {
     console.debug(`[knip] ${name} (${symbols.length})`);
     logArray(symbols);
 };
-const debugLogDiff = (name, arrA, arrB) => {
-    const onlyInA = arrA.filter(itemA => !arrB.includes(itemA)).sort();
-    const onlyInB = arrB.filter(itemB => !arrA.includes(itemB)).sort();
-    console.log(`[knip] ${name}`);
-    console.log(`[knip] Only in left:`);
-    logArray(onlyInA);
-    console.log();
-    console.log(`[knip] Only in right:`);
-    logArray(onlyInB);
-};

package/dist/util/fs.d.ts

@@ -1,3 +1,3 @@
-export declare const isFile: (filePath: string) => Promise<boolean>;
-export declare const findFile: (workingDir: string, fileName: string) => Promise<string | undefined>;
+export declare const isFile: (filePath: string) => boolean;
+export declare const findFile: (workingDir: string, fileName: string) => string | undefined;
 export declare const loadJSON: (filePath: string) => Promise<any>;

package/dist/util/fs.js

@@ -1,20 +1,16 @@
-import fs from 'node:fs/promises';
+import { statSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import stripJsonComments from 'strip-json-comments';
-export const isFile = async (filePath) => {
-    try {
-        const stats = await fs.stat(filePath);
-        return stats.isFile();
-    }
-    catch {
-        return false;
-    }
+export const isFile = (filePath) => {
+    const stat = statSync(filePath, { throwIfNoEntry: false });
+    return stat !== undefined && stat.isFile();
 };
-export const findFile = async (workingDir, fileName) => {
+export const findFile = (workingDir, fileName) => {
     const filePath = path.join(workingDir, fileName);
-    return (await isFile(filePath)) ? filePath : undefined;
+    return isFile(filePath) ? filePath : undefined;
 };
 export const loadJSON = async (filePath) => {
-    const contents = await fs.readFile(filePath);
+    const contents = await readFile(filePath);
     return JSON.parse(stripJsonComments(contents.toString()));
 };

package/dist/util/object.d.ts

@@ -0,0 +1 @@
+export declare const getValuesByKeyDeep: (obj: any, key: string) => unknown[];

package/dist/util/object.js

@@ -0,0 +1,15 @@
+export const getValuesByKeyDeep = (obj, key) => {
+    const objects = [];
+    if (obj && typeof obj === 'object') {
+        for (const i in obj) {
+            if (obj[i] && typeof obj[i] === 'object') {
+                const values = getValuesByKeyDeep(obj[i], key);
+                objects.push(...values);
+            }
+            else if (i === key) {
+                objects.push(obj[i]);
+            }
+        }
+    }
+    return objects;
+};

package/dist/workspace-worker.js

@@ -229,6 +229,7 @@ export default class WorkspaceWorker {
                 cwd,
                 manifest: this.manifest,
                 config: pluginConfig,
+                rootConfig: this.rootConfig,
                 workspaceConfig: this.config,
                 isProduction: this.isProduction,
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",
@@ -10,11 +10,12 @@
     "name": "Lars Kappert",
     "email": "lars@webpro.nl"
   },
-  "main": "dist/index.js",
+  "main": "./dist/index.js",
   "bin": {
-    "knip": "dist/cli.js"
+    "knip": "./dist/cli.js"
   },
   "type": "module",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "knip": "node ./dist/cli.js",
     "knip:production": "node ./dist/cli.js --production --strict",
@@ -42,9 +43,9 @@
     "@snyk/github-codeowners": "1.1.0",
     "chalk": "5.2.0",
     "easy-table": "1.2.0",
-    "esbuild": "0.16.17",
+    "esbuild": "0.17.0",
     "esbuild-register": "3.4.2",
-    "eslint": "8.31.0",
+    "eslint": "8.32.0",
     "fast-glob": "3.2.12",
     "get-tsconfig": "4.3.0",
     "globby": "13.1.3",
@@ -77,7 +78,7 @@
     "remark-cli": "11.0.0",
     "remark-preset-webpro": "0.0.1",
     "tsx": "3.12.2",
-    "type-fest": "3.5.1",
+    "type-fest": "3.5.2",
     "typescript": "4.9.4"
   },
   "engines": {

package/schema.json

@@ -23,7 +23,7 @@
   "properties": {
     "ignoreBinaries": {
       "title": "Binaries to ignore",
-      "examples": ["rm", "docker-compose", "eslint"],
+      "examples": ["rm", "docker-compose", "curl"],
       "$ref": "#/definitions/list"
     },
     "ignoreDependencies": {
@@ -184,6 +184,10 @@
           "title": "Gatsby plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/gatsby/README.md)",
           "$ref": "#/definitions/plugin"
         },
+        "github-actions": {
+          "title": "github-actions plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/github-actions/README.md)",
+          "$ref": "#/definitions/plugin"
+        },
         "jest": {
           "title": "Jest plugin configuration (https://github.com/webpro/knip/blob/main/src/plugins/jest/README.md)",
           "$ref": "#/definitions/plugin"