knip 2.0.0-alpha.1 → 2.0.0-alpha.10

package/README.md

@@ -40,7 +40,7 @@ for the full story.
 ## Issues
 
 Are you seeing false positives? Please report them by [opening an issue in this repo][9]. Bonus points for linking to a
-public repository using Knip, or even opening a pull request with a directory and example files in `test/fixtures`.
+public repository using Knip, or even opening a pull request with a directory and example files in `tests/fixtures`.
 Correctness and bug fixes have priority over performance and new features.
 
 Also see the [FAQ][10].
@@ -59,19 +59,19 @@ with a configuration file (or a `knip` property in `package.json`). Here's a `kn
 ```json
 {
   "$schema": "https://unpkg.com/knip@next/schema.json",
-  "entry": ["index.{js,mjs,cjs,jsx,ts,tsx}", "src/index.{js,mjs,cjs,jsx,ts,tsx}"],
-  "project": ["**/*.{js,mjs,cjs,jsx,ts,tsx}"]
+  "entry": ["index.{js,mjs,cjs,jsx,ts,tsx,mts,cts}", "src/index.{js,mjs,cjs,jsx,ts,tsx,mts,cts}"],
+  "project": ["**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts}"]
 }
 ```
 
 If this matches your project, you don't need any configuration. But let's say you are using `.ts` files excusively and
-have all source files in the `lib` directory:
+have all source files only in the `src` directory:
 
 ```json
 {
   "$schema": "https://unpkg.com/knip@next/schema.json",
-  "entry": ["lib/index.ts"],
-  "project": ["lib/**/*.ts"]
+  "entry": ["src/index.ts"],
+  "project": ["src/**/*.ts"]
 }
 ```
 
@@ -196,8 +196,8 @@ Use `--exclude` to ignore reports you're not interested in:
 
 Use `--dependencies` or `--exports` as shortcuts to combine groups of related types.
 
-Still not happy with the results? Getting too much output/false positives? The [FAQ][9] may be useful. Feel free to open
-an issue and I'm happy to look into it. Also see the next section on how to [ignore][11] certain false positives:
+Still not happy with the results? Getting too much output/false positives? The [FAQ][10] may be useful. Feel free to
+open an issue and I'm happy to look into it. Also see the next section on how to [ignore][11] certain false positives:
 
 ## Ignore
 
@@ -281,38 +281,42 @@ Use `--debug` to get more verbose output.
 
 Knip contains a growing list of plugins:
 
-- [Babel][12]
-- [Capacitor][13]
-- [Changesets][14]
-- [commitlint][15]
-- [Cypress][16]
-- [ESLint][17]
-- [Gatsby][18]
-- [GitHub Actions][19]
-- [husky][20]
-- [Jest][21]
-- [Lefthook][22]
-- [lint-staged][23]
-- [markdownlint][24]
-- [Mocha][25]
-- [Next.js][26]
-- [npm-package-json-lint][27]
-- [Nx][28]
-- [nyc][29]
-- [Playwright][30]
-- [PostCSS][31]
-- [Prettier][32]
-- [Release It][33]
-- [Remark][34]
-- [Remix][35]
-- [Rollup][36]
-- [Sentry][37]
-- [Storybook][38]
-- [Stryker][39]
-- [TypeDoc][40]
-- [TypeScript][41]
-- [Vitest][42]
-- [Webpack][43]
+- [Ava][plugin-ava]
+- [Babel][plugin-babel]
+- [Capacitor][plugin-capacitor]
+- [Changesets][plugin-changesets]
+- [commitlint][plugin-commitlint]
+- [cspell][plugin-cspell]
+- [Cypress][plugin-cypress]
+- [ESLint][plugin-eslint]
+- [Gatsby][plugin-gatsby]
+- [GitHub Actions][plugin-github-actions]
+- [husky][plugin-husky]
+- [Jest][plugin-jest]
+- [Lefthook][plugin-lefthook]
+- [lint-staged][plugin-lint-staged]
+- [markdownlint][plugin-markdownlint]
+- [Mocha][plugin-mocha]
+- [Next.js][plugin-next]
+- [npm-package-json-lint][plugin-npm-package-json-lint]
+- [Nx][plugin-nx]
+- [nyc][plugin-nyc]
+- [Playwright][plugin-playwright]
+- [PostCSS][plugin-postcss]
+- [Prettier][plugin-prettier]
+- [Release It][plugin-release-it]
+- [Remark][plugin-remark]
+- [Remix][plugin-remix]
+- [Rollup][plugin-rollup]
+- [Semantic Release][plugin-semantic-release]
+- [Sentry][plugin-sentry]
+- [Storybook][plugin-storybook]
+- [Stryker][plugin-stryker]
+- [Svelte][plugin-svelte]
+- [TypeDoc][plugin-typedoc]
+- [TypeScript][plugin-typescript]
+- [Vitest][plugin-vitest]
+- [Webpack][plugin-webpack]
 
 Plugins are automatically activated. 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 enabled, they add a set of
@@ -320,25 +324,16 @@ configuration and/or entry files for Knip to analyze. These defaults can be over
 
 Most plugins use one or both of the following file types:
 
-- `config` - custom dependency resolvers are applied to the [config files][44]
+- `config` - custom dependency resolvers are applied to the [config files][12]
 - `entry` - files to include with the analysis of the rest of the source code
 
 See each plugin's documentation for its default values.
 
 ### `config`
 
-Plugins may include `config` files. They are parsed by the plugin's custom dependency resolver. Here are some examples
-to get an idea of how they work and why they are needed:
-
-- The `eslint` plugin tells Knip that the `"prettier"` entry in the array of `plugins` means that the
-  `eslint-plugin-prettier` dependency should be installed. Or that the `"airbnb"` entry in `extends` requires the
-  `eslint-config-airbnb` dependency.
-- The `storybook` plugin understands that `core.builder: 'webpack5'` in `main.js` means that the
-  `@storybook/builder-webpack5` and `@storybook/manager-webpack5` dependencies are required.
-- Static configuration files such as JSON and YAML always require a custom dependency resolver.
-
-Custom dependency resolvers return all referenced dependencies for the configuration files it is given. Knip handles the
-rest to find which of those dependencies are unused or missing.
+Plugins may include `config` files. They are parsed by the plugin's custom dependency finder. Custom dependency finders
+return all dependencies referenced in the configuration files it is given. Knip handles the rest to determine which of
+those dependencies are unused or missing.
 
 ### `entry`
 
@@ -351,15 +346,13 @@ In case a plugin causes issues, it can be disabled by using `false` as its value
 
 ### Create a new plugin
 
-Getting false positives because a plugin is missing? Want to help out? Feel free to add your own plugin! Here's how to
-get started:
-
-    npm run create-plugin -- --name [myplugin]
+Getting false positives because a plugin is missing? Want to help out? Please read more at [writing a plugin][13]. This
+guide also contains more details if you want to learn more about plugins and why they are useful.
 
 ## Compilers
 
 Knip v2 introduces compilers which allows to include files that are not JavaScript or TypeScript in the process of
-finding unused or missing dependencies.
+finding unused or missing dependencies. For instance, `.mdx`, `.vue` and `.svelte` files come to mind.
 
 Currently this is only supported by using `knip.js` or `knip.ts`. Provide a `compilers` object in the configuration
 where each key represents the extension and the value is a function that takes the contents of these files as input and
@@ -375,6 +368,8 @@ export default {
 };
 ```
 
+Read [Compilers][14] for more details and examples.
+
 ## Production Mode
 
 The default mode for Knip is holistic and targets all project code, including configuration files and tests. Test files
@@ -403,17 +398,16 @@ Here's what's included in production mode analysis:
 
 Additionally, the `--strict` flag can be used to:
 
-- Consider only `dependencies` (not `devDependencies`) when finding unused or unlisted dependencies.
-- Consider only non-type imports (i.e. ignore `import type {}`).
-- Assume each workspace is self-contained: they have their own `dependencies` (and not rely on packages of ancestor
-  workspaces).
+- Consider `dependencies` (not `devDependencies`) when finding unused or unlisted dependencies.
+- Include `peerDependencies` when finding unused or unlisted dependencies.
+- Ignore type-only imports (`import type {}`).
+- Verify each workspace is self-contained: have their own `dependencies` (and not use packages of ancestor workspaces).
 
 ### Plugins
 
 Plugins also have this distinction. For instance, Next.js entry files for pages (`pages/**/*.tsx`) and Remix routes
-(`app/routes/**/*.tsx`) are production code, while Jest and Playwright entry files (e.g. `*.spec.ts`) are not. All of
-this is handled automatically by Knip and its plugins. You only need to point Knip to additional files or custom file
-locations. The more plugins Knip will have, the more projects can be analyzed out of the box!
+(`app/routes/**/*.tsx`) are production code, while Jest and Storybook entry files (e.g. `*.spec.ts` or `*.stories.js`)
+are not. All of this is handled automatically by Knip and its plugins.
 
 ## Paths
 
@@ -440,10 +434,10 @@ Each workspace can also have its own `paths` configured. Note that Knip `paths`
 
 Knip provides the following built-in reporters:
 
-- [`codeowners`][45]
-- [`compact`][46]
-- [`json`][47]
-- [`symbol`][48] (default)
+- codeowners
+- compact
+- json
+- symbol
 
 The `compact` reporter shows the sorted files first, and then a list of symbols:
 
@@ -470,13 +464,12 @@ 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][49].
+Find more details and ideas in [custom reporters][15].
 
-## Libraries and "unused" exports
+## Public exports
 
-Libraries and applications are identical when it comes to files and dependencies: whatever is unused should be removed.
-Yet libraries usually have exports meant to be used by other libraries or applications. Such public variables and types
-in libraries can be marked with the JSDoc `@public` tag:
+Sometimes a file that's not an entry file has one or more exports that are public, and should not be reported as unused.
+Such variables and types can be marked with the JSDoc `@public` tag:
 
 ```js
 /**
@@ -528,7 +521,7 @@ 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][50].
+When the dependencies don't have a Knip plugin yet, please file an issue or [create a new plugin][16].
 
 #### Too many unused exports
 
@@ -536,7 +529,7 @@ When the project is a library and the exports are meant to be used by consumers
 
 1.  By default, unused exports of `entry` files are not reported. You could re-export from an existing entry file, or
     add the containing file to the `entry` array in the configuration.
-2.  The exported values or types can be marked [using the JSDoc `@public` tag][51].
+2.  The exported values or types can be marked [using the JSDoc `@public` tag][17]
 
 ### How to start using Knip in CI while having too many issues to sort out?
 
@@ -556,22 +549,23 @@ 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][52] | [unimported][53] | [ts-unused-exports][54] | [ts-prune][55] |
-| :--------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
-| Unused files                       |    ✅    |       -        |        ✅        |            -            |       -        |
-| Unused dependencies                |    ✅    |       ✅       |        ✅        |            -            |       -        |
-| Unlisted dependencies              |    ✅    |       ✅       |        ✅        |            -            |       -        |
-| [Plugins][1]                       |    ✅    |       ✅       |        ❌        |            -            |       -        |
-| Unused exports                     |    ✅    |       -        |        -         |           ✅            |       ✅       |
-| Unused class members               |    ✅    |       -        |        -         |            -            |       -        |
-| Unused enum members                |    ✅    |       -        |        -         |            -            |       -        |
-| Duplicate exports                  |    ✅    |       -        |        -         |           ❌            |       ❌       |
-| Search namespaces                  |    ✅    |       -        |        -         |           ✅            |       ❌       |
-| Custom reporters                   |    ✅    |       -        |        -         |            -            |       -        |
-| JavaScript support                 |    ✅    |       ✅       |        ✅        |            -            |       -        |
-| Configure entry files              |    ✅    |       ❌       |        ✅        |           ❌            |       ❌       |
-| [Support workspaces/monorepos][52] |    ✅    |       ❌       |        ❌        |            -            |       -        |
-| ESLint plugin available            |    -     |       -        |        -         |           ✅            |       -        |
+| Feature                           | **knip** | [depcheck][18] | [unimported][19] | [ts-unused-exports][20] | [ts-prune][21] |
+| :-------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
+| Unused files                      |    ✅    |       -        |        ✅        |            -            |       -        |
+| Unused dependencies               |    ✅    |       ✅       |        ✅        |            -            |       -        |
+| Unlisted dependencies             |    ✅    |       ✅       |        ✅        |            -            |       -        |
+| [Plugins][2]                      |    ✅    |       ✅       |        ❌        |            -            |       -        |
+| [Compilers][3]                    |    ✅    |       -        |        -         |            -            |       -        |
+| Unused exports                    |    ✅    |       -        |        -         |           ✅            |       ✅       |
+| Unused class members              |    ✅    |       -        |        -         |            -            |       -        |
+| Unused enum members               |    ✅    |       -        |        -         |            -            |       -        |
+| Duplicate exports                 |    ✅    |       -        |        -         |           ❌            |       ❌       |
+| Search namespaces                 |    ✅    |       -        |        -         |           ✅            |       ❌       |
+| Custom reporters                  |    ✅    |       -        |        -         |            -            |       -        |
+| JavaScript support                |    ✅    |       ✅       |        ✅        |            -            |       -        |
+| Configure entry files             |    ✅    |       ❌       |        ✅        |           ❌            |       ❌       |
+| [Support workspaces/monorepos][1] |    ✅    |       ❌       |        ❌        |            -            |       -        |
+| ESLint plugin available           |    -     |       -        |        -         |           ✅            |       -        |
 
 ✅ = Supported, ❌ = Not supported, - = Out of scope
 
@@ -591,7 +585,7 @@ The following commands are similar:
     unimported
     knip --production --dependencies --include files
 
-Also see [production mode][56].
+Also see [production mode][22].
 
 ### ts-unused-exports
 
@@ -609,13 +603,6 @@ The following commands are similar:
     knip --include exports,types
     knip --exports  # Adds unused exports/types in namespaces and unused enum/class members
 
-## TypeScript language services
-
-TypeScript language services could play a major role in most of the "unused" areas, as they have an overview of the
-project as a whole. This powers things in VS Code like "Find references" or the "Module "./some" declares 'Thing'
-locally, but it is not exported" message. I think features like "duplicate exports" or "custom dependency resolvers" are
-userland territory, much like code linters.
-
 ## Knip?!
 
 Knip is Dutch for a "cut". A Dutch expression is "to be ge**knip**t for something", which means to be perfectly suited
@@ -632,48 +619,50 @@ for the job. I'm motivated to make knip perfectly suited for the job of cutting
 [9]: https://github.com/webpro/knip/issues
 [10]: #faq
 [11]: #ignore
-[12]: ./src/plugins/babel
-[13]: ./src/plugins/capacitor
-[14]: ./src/plugins/changesets
-[15]: ./src/plugins/commitlint
-[16]: ./src/plugins/cypress
-[17]: ./src/plugins/eslint
-[18]: ./src/plugins/gatsby
-[19]: ./src/plugins/github-actions
-[20]: ./src/plugins/husky
-[21]: ./src/plugins/jest
-[22]: ./src/plugins/lefthook
-[23]: ./src/plugins/lint-staged
-[24]: ./src/plugins/markdownlint
-[25]: ./src/plugins/mocha
-[26]: ./src/plugins/next
-[27]: ./src/plugins/npm-package-json-lint
-[28]: ./src/plugins/nx
-[29]: ./src/plugins/nyc
-[30]: ./src/plugins/playwright
-[31]: ./src/plugins/postcss
-[32]: ./src/plugins/prettier
-[33]: ./src/plugins/release-it
-[34]: ./src/plugins/remark
-[35]: ./src/plugins/remix
-[36]: ./src/plugins/rollup
-[37]: ./src/plugins/sentry
-[38]: ./src/plugins/storybook
-[39]: ./src/plugins/stryker
-[40]: ./src/plugins/typedoc
-[41]: ./src/plugins/typescript
-[42]: ./src/plugins/vitest
-[43]: ./src/plugins/webpack
-[44]: #config
-[45]: #code-owners
-[46]: #compact
-[47]: #json
-[48]: #symbol-default
-[49]: ./docs/custom-reporters.md
-[50]: #create-a-new-plugin
-[51]: #libraries-and-unused-exports
-[52]: https://github.com/depcheck/depcheck
-[53]: https://github.com/smeijer/unimported
-[54]: https://github.com/pzavolinsky/ts-unused-exports
-[55]: https://github.com/nadeesha/ts-prune
-[56]: #production-mode
+[12]: #config
+[13]: ./docs/writing-a-plugin.md
+[14]: ./docs/compilers.md
+[15]: ./docs/custom-reporters.md
+[16]: #create-a-new-plugin
+[17]: #public-exports
+[18]: https://github.com/depcheck/depcheck
+[19]: https://github.com/smeijer/unimported
+[20]: https://github.com/pzavolinsky/ts-unused-exports
+[21]: https://github.com/nadeesha/ts-prune
+[22]: #production-mode
+[plugin-ava]: ./src/plugins/ava
+[plugin-babel]: ./src/plugins/babel
+[plugin-capacitor]: ./src/plugins/capacitor
+[plugin-changesets]: ./src/plugins/changesets
+[plugin-commitlint]: ./src/plugins/commitlint
+[plugin-cspell]: ./src/plugins/cspell
+[plugin-cypress]: ./src/plugins/cypress
+[plugin-eslint]: ./src/plugins/eslint
+[plugin-gatsby]: ./src/plugins/gatsby
+[plugin-github-actions]: ./src/plugins/github-actions
+[plugin-husky]: ./src/plugins/husky
+[plugin-jest]: ./src/plugins/jest
+[plugin-lefthook]: ./src/plugins/lefthook
+[plugin-lint-staged]: ./src/plugins/lint-staged
+[plugin-markdownlint]: ./src/plugins/markdownlint
+[plugin-mocha]: ./src/plugins/mocha
+[plugin-next]: ./src/plugins/next
+[plugin-npm-package-json-lint]: ./src/plugins/npm-package-json-lint
+[plugin-nx]: ./src/plugins/nx
+[plugin-nyc]: ./src/plugins/nyc
+[plugin-playwright]: ./src/plugins/playwright
+[plugin-postcss]: ./src/plugins/postcss
+[plugin-prettier]: ./src/plugins/prettier
+[plugin-release-it]: ./src/plugins/release-it
+[plugin-remark]: ./src/plugins/remark
+[plugin-remix]: ./src/plugins/remix
+[plugin-rollup]: ./src/plugins/rollup
+[plugin-semantic-release]: ./src/plugins/semantic-release
+[plugin-sentry]: ./src/plugins/sentry
+[plugin-storybook]: ./src/plugins/storybook
+[plugin-stryker]: ./src/plugins/stryker
+[plugin-svelte]: ./src/plugins/svelte
+[plugin-typedoc]: ./src/plugins/typedoc
+[plugin-typescript]: ./src/plugins/typescript
+[plugin-vitest]: ./src/plugins/vitest
+[plugin-webpack]: ./src/plugins/webpack

package/dist/binaries/bash-parser.d.ts

@@ -0,0 +1,6 @@
+import type { PackageJson } from 'type-fest';
+export declare const getBinariesFromScript: (script: string, { cwd, manifest, knownGlobalsOnly }: {
+    cwd: string;
+    manifest: PackageJson;
+    knownGlobalsOnly?: boolean | undefined;
+}) => string[];

package/dist/binaries/bash-parser.js

@@ -0,0 +1,57 @@
+import parse from 'bash-parser';
+import parseArgs from 'minimist';
+import * as FallbackResolver from './resolvers/fallback.js';
+import * as KnownResolvers from './resolvers/index.js';
+const spawningBinaries = ['cross-env', 'dotenv'];
+export const getBinariesFromScript = (script, { cwd, manifest, knownGlobalsOnly = false }) => {
+    if (!script)
+        return [];
+    const fromArgs = (args) => getBinariesFromScript(args.join(' '), { cwd, manifest });
+    const getBinariesFromNodes = (nodes) => nodes.flatMap(node => {
+        switch (node.type) {
+            case 'Command': {
+                const binary = node.name?.text;
+                const commandExpansions = node.prefix?.flatMap(prefix => prefix.expansion?.filter(expansion => expansion.type === 'CommandExpansion') ?? []) ?? [];
+                if (commandExpansions.length > 0) {
+                    return commandExpansions.flatMap(expansion => getBinariesFromNodes(expansion.commandAST.commands)) ?? [];
+                }
+                if (!binary || binary === '.' || binary === 'source')
+                    return [];
+                if (binary.startsWith('-') || binary.startsWith('"') || binary.startsWith('..'))
+                    return [];
+                if (['bun', 'deno'].includes(binary))
+                    return [];
+                const args = node.suffix?.map(arg => arg.text) ?? [];
+                if (['!', 'test'].includes(binary))
+                    return fromArgs(args);
+                if (binary in KnownResolvers) {
+                    return KnownResolvers[binary].resolve(binary, args, { cwd, manifest, fromArgs });
+                }
+                if (knownGlobalsOnly)
+                    return [];
+                if (spawningBinaries.includes(binary)) {
+                    const parsedArgs = parseArgs(args);
+                    const [spawnedBinary] = parsedArgs._;
+                    if (spawnedBinary) {
+                        const restArgs = args.slice(args.indexOf(spawnedBinary));
+                        return [binary, ...fromArgs(restArgs)];
+                    }
+                    else {
+                        return [];
+                    }
+                }
+                return FallbackResolver.resolve(binary, args, { cwd, manifest, fromArgs });
+            }
+            case 'LogicalExpression':
+                return getBinariesFromNodes([node.left, node.right]);
+            case 'If':
+                return getBinariesFromNodes([...node.clause.commands, ...node.then.commands]);
+            case 'For':
+                return getBinariesFromNodes(node.do.commands);
+            default:
+                return [];
+        }
+    });
+    const parsed = parse(script);
+    return parsed?.commands ? getBinariesFromNodes(parsed.commands) : [];
+};

package/dist/binaries/index.d.ts

@@ -0,0 +1,2 @@
+import type { GetReferencesFromScripts } from './types.js';
+export declare const _getReferencesFromScripts: GetReferencesFromScripts;

package/dist/binaries/index.js

@@ -0,0 +1,22 @@
+import { IGNORED_GLOBAL_BINARIES } from '../constants.js';
+import { compact } from '../util/array.js';
+import { partition } from '../util/array.js';
+import { getPackageNameFromModuleSpecifier, stripBinary } from '../util/modules.js';
+import { isInternal } from '../util/path.js';
+import { timerify } from '../util/performance.js';
+import { getBinariesFromScript } from './bash-parser.js';
+const defaultCwd = process.cwd();
+const getReferencesFromScripts = (npmScripts, options = {}) => {
+    const { cwd = defaultCwd, manifest = {}, ignore = [], knownGlobalsOnly = false } = options;
+    const scripts = [npmScripts].flat();
+    const results = scripts.flatMap(script => getBinariesFromScript(script, { cwd, manifest, knownGlobalsOnly }));
+    const [entryFiles, binaries] = partition(compact(results), isInternal);
+    return {
+        entryFiles,
+        binaries: binaries
+            .map(stripBinary)
+            .map(getPackageNameFromModuleSpecifier)
+            .filter(binaryName => !IGNORED_GLOBAL_BINARIES.includes(binaryName) && !ignore.includes(binaryName)),
+    };
+};
+export const _getReferencesFromScripts = timerify(getReferencesFromScripts);

package/dist/binaries/resolvers/fallback.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from '../types.js';
+export declare const resolve: Resolver;

package/dist/binaries/resolvers/fallback.js

@@ -0,0 +1,14 @@
+import parseArgs from 'minimist';
+import { tryResolveFilePaths } from './node.js';
+const argResolvers = {
+    'babel-node': parsed => [parsed._[0], parsed.require].flat(),
+    'ts-node': parsed => [parsed._[0], parsed.require].flat(),
+    tsx: parsed => parsed._.filter(p => p !== 'watch'),
+    default: parsed => [parsed.require].flat(),
+};
+export const resolve = (binary, args, { cwd }) => {
+    const parsed = parseArgs(args, { string: ['r'], alias: { require: ['r', 'loader'] } });
+    const resolver = argResolvers[binary] ?? argResolvers.default;
+    const resolve = resolver(parsed);
+    return [binary, ...tryResolveFilePaths(cwd, resolve)];
+};

package/dist/binaries/resolvers/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/binaries/resolvers/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/binaries/resolvers/node.d.ts

@@ -0,0 +1,3 @@
+import type { Resolver } from '../types.js';
+export declare const tryResolveFilePaths: (cwd: string, specifiers: string[]) => string[];
+export declare const resolve: Resolver;

package/dist/binaries/resolvers/node.js

@@ -0,0 +1,20 @@
+import parseArgs from 'minimist';
+import { isInNodeModules, join } from '../../util/path.js';
+import { _tryResolve } from '../../util/require.js';
+const tryResolveFilePath = (cwd, specifier, fallback) => {
+    if (specifier) {
+        const filePath = join(cwd, specifier);
+        if (!isInNodeModules(filePath)) {
+            const resolvedFilePath = _tryResolve(filePath, cwd);
+            if (resolvedFilePath)
+                return [resolvedFilePath];
+        }
+        return fallback ? [fallback] : [];
+    }
+    return [];
+};
+export const tryResolveFilePaths = (cwd, specifiers) => specifiers.flatMap(specifier => tryResolveFilePath(cwd, specifier, specifier));
+export const resolve = (binary, args, { cwd }) => {
+    const parsed = parseArgs(args, { string: ['r'], alias: { require: ['r', 'loader', 'experimental-loader'] } });
+    return [...tryResolveFilePath(cwd, parsed._[0]), ...tryResolveFilePaths(cwd, [parsed.require].flat())];
+};

package/dist/binaries/resolvers/npx.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from '../types.js';
+export declare const resolve: Resolver;

package/dist/binaries/resolvers/npx.js

@@ -0,0 +1,5 @@
+import parseArgs from 'minimist';
+export const resolve = (binary, args, { fromArgs }) => {
+    const parsed = parseArgs(args, { '--': true, stopEarly: true, boolean: ['yes', 'no'], alias: { yes: 'y', no: 'n' } });
+    return [...(parsed.yes ? [] : fromArgs(parsed._)), ...(parsed['--'] ? fromArgs(parsed['--']) : [])];
+};

package/dist/binaries/resolvers/pnpm.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from '../types.js';
+export declare const resolve: Resolver;

package/dist/binaries/resolvers/pnpm.js

@@ -0,0 +1,45 @@
+import parseArgs from 'minimist';
+const commands = [
+    'add',
+    'dlx',
+    'run',
+    '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 parsed = parseArgs(args, {});
+    const [command, result] = parsed._;
+    if (scripts.includes(command) || commands.includes(command))
+        return [];
+    if (command === 'exec')
+        return [result];
+    return command ? [command] : [];
+};

package/dist/binaries/resolvers/yarn.d.ts

@@ -0,0 +1,2 @@
+import type { Resolver } from '../types.js';
+export declare const resolve: Resolver;