knip 2.0.0-alpha.0 → 2.0.0-alpha.2

package/README.md

@@ -21,27 +21,29 @@ The dots don't connect themselves. This is where Knip comes in:
 - [x] Finds unused members of classes and enums
 - [x] Built-in support for [monorepos/workspaces][1]
 - [x] Growing list of [built-in plugins][2]
+- [x] Use [compilers][3] to include other file types (e.g. MDX, Svelte, Astro)
 - [x] Checks npm scripts for used and unlisted dependencies
 - [x] Supports JavaScript (without `tsconfig.json`, or TypeScript `allowJs: true`)
-- [x] Features multiple [reporters][3] and supports [custom reporters][4]
+- [x] Features multiple [reporters][4] and supports [custom reporters][5]
 - [x] Run Knip as part of your CI environment to detect issues and prevent regressions
 
 Knip shines in both small and large projects. It's a fresh take on keeping your projects clean & tidy!
 
-[![An orange cow with scissors, Van Gogh style][6]][5] <sup>_“An orange cow with scissors, Van Gogh style” - generated
+[![An orange cow with scissors, Van Gogh style][7]][6] <sup>_“An orange cow with scissors, Van Gogh style” - generated
 with OpenAI_</sup>
 
-## Migrating to v1.0.0
+## Migrating to v2.0.0
 
-When coming from version v0.13.3 or before, please see [migration to v1][7].
+Migrating from v1 to v2 requires no changes in configuration. Please see [https://github.com/webpro/knip/issues/73][8]
+for the full story.
 
 ## Issues
 
-Are you seeing false positives? Please report them by [opening an issue in this repo][8]. Bonus points for linking to a
+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`.
 Correctness and bug fixes have priority over performance and new features.
 
-Also see the [FAQ][9].
+Also see the [FAQ][10].
 
 ## Installation
 
@@ -52,14 +54,24 @@ Knip supports LTS versions of Node.js, and currently requires at least Node.js v
 ## Usage
 
 Knip has good defaults and you can run it without any configuration, but especially larger projects get more out of Knip
-with a configuration file (or a `knip` property in `package.json`). Let's name this file `knip.json` with these contents
-(you might want to adjust right away for your project):
+with a configuration file (or a `knip` property in `package.json`). Here's a `knip.json` with the default values:
 
 ```json
 {
-  "$schema": "https://unpkg.com/knip@1/schema.json",
-  "entry": ["src/index.ts"],
-  "project": ["src/**/*.ts"]
+  "$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}"]
+}
+```
+
+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:
+
+```json
+{
+  "$schema": "https://unpkg.com/knip@next/schema.json",
+  "entry": ["lib/index.ts"],
+  "project": ["lib/**/*.ts"]
 }
 ```
 
@@ -79,7 +91,7 @@ const config: KnipConfig = {
 export default config;
 ```
 
-If you have, please see [workspaces & monorepos][1].
+Please see [workspaces & monorepos][1] for more details about configuring them.
 
 Then run the checks with `npx knip`. Or first add this script to `package.json`:
 
@@ -124,7 +136,7 @@ Use `npm run knip` to analyze the project and output unused files, dependencies
       --h, --help              Print this help text
       --V, version             Print version
 
-    (1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
+    (1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
 
     Examples:
 
@@ -153,20 +165,19 @@ The report contains the following types of issues:
 
 - **Unused files**: did not find references to this file
 - **Unused dependencies**: did not find references to this dependency
-- **Unlisted or unresolved dependencies**: used dependencies, but not listed in package.json _(1)_
+- **Unlisted dependencies**: used dependencies, but not listed in package.json
+- **Unresolved imports**: import specifiers that could not be resolved
 - **Unused exports**: did not find references to this exported variable
-- **Unused exports in namespaces**: did not find direct references to this exported variable _(2)_
+- **Unused exports in namespaces**: did not find direct references to this exported variable _(1)_
 - **Unused exported types**: did not find references to this exported type
-- **Unused exported types in namespaces**: did not find direct references to this exported variable _(2)_
+- **Unused exported types in namespaces**: did not find direct references to this exported variable _(1)_
 - **Unused exported enum members**: did not find references to this member of the exported enum
 - **Unused exported class members**: did not find references to this member of the exported class
 - **Duplicate exports**: the same thing is exported more than once
 
 When an issue type has zero issues, it is not shown.
 
-_(1)_ This includes imports that could not be resolved.
-
-_(2)_ The variable or type is not referenced directly, and has become a member of a namespace. Knip can't find a
+_(1)_ The variable or type is not referenced directly, and has become a member of a namespace. Knip can't find a
 reference to it, so you can _probably_ remove it.
 
 ### Output filters
@@ -174,9 +185,6 @@ reference to it, so you can _probably_ remove it.
 You can `--include` or `--exclude` any of the types to slice & dice the report to your needs. Alternatively, they can be
 added to the configuration (e.g. `"exclude": ["dependencies"]`).
 
-Knip finds issues of type `files`, `dependencies`, `unlisted` and `duplicates` very fast. Finding unused exports
-requires deeper analysis (`exports`, `nsExports`, `classMembers`, `types`, `nsTypes`, `enumMembers`).
-
 Use `--include` to report only specific issue types (the following example commands do the same):
 
     knip --include files --include dependencies
@@ -188,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][10] 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
 
@@ -204,6 +212,8 @@ There are a few ways to tell Knip to ignore certain packages, binaries, dependen
 }
 ```
 
+They can also be configured per workspace (except for `ignoreWorkspaces`).
+
 ## Now what?
 
 This is the fun part! Knip, knip, knip ✂️
@@ -213,6 +223,7 @@ As always, make sure to backup files or use Git before deleting files or making
 - Unused files can be removed.
 - Unused dependencies can be removed from `package.json`.
 - Unlisted dependencies should be added to `package.json`.
+- Unresolved imports should be reviewed.
 - Unused exports and types: remove the `export` keyword in front of unused exports. Then you can see whether the
   variable or type is used within the same file. If this is not the case, it can be removed.
 - Duplicate exports can be removed so they're exported only once.
@@ -243,7 +254,13 @@ be part of the analysis. Here's an example:
 }
 ```
 
-Note that if you have a root workspace, it must be under `workspaces` and have the `"."` key like in the example.
+It might be useful to run Knip first with no or little configuration to see where it needs different entry and/or
+project files. The default configuration of each workspace is the same as in the introduction of this documentation.
+
+Workspaces are sometimes also referred to as packages in a monorepo. Knip uses the term workspaces exclusively to
+indicate the directories that have a `package.json`.
+
+Root workspaces must be under `workspaces` and have the `"."` key like in the example.
 
 Knip supports workspaces as defined in three possible locations:
 
@@ -251,8 +268,6 @@ Knip supports workspaces as defined in three possible locations:
 - In the `workspaces.packages` array in `package.json`.
 - In the `packages` array in `pnpm-workspace.yaml`.
 
-Every directory with a match in `workspaces` of `knip.json` is part of the analysis.
-
 Extra "workspaces" not configured as a workspace in the root `package.json` can be configured as well, Knip is happy to
 analyze unused dependencies and exports from any directory with a `package.json`.
 
@@ -260,42 +275,44 @@ Here's some example output when running Knip in a workspace:
 
 <img src="./assets/screenshot-workspaces.png" alt="example output in workspaces" width="578">
 
+Use `--debug` to get more verbose output.
+
 ## Plugins
 
 Knip contains a growing list of plugins:
 
-- [Babel][11]
-- [Capacitor][12]
-- [Changesets][13]
-- [commitlint][14]
-- [Cypress][15]
-- [ESLint][16]
-- [Gatsby][17]
-- [GitHub Actions][18]
-- [husky][19]
-- [Jest][20]
-- [Lefthook][21]
-- [lint-staged][22]
-- [markdownlint][23]
-- [Mocha][24]
-- [Next.js][25]
-- [npm-package-json-lint][26]
-- [Nx][27]
-- [nyc][28]
-- [Playwright][29]
-- [PostCSS][30]
-- [Prettier][31]
-- [Release It][32]
-- [Remark][33]
-- [Remix][34]
-- [Rollup][35]
-- [Sentry][36]
-- [Storybook][37]
-- [Stryker][38]
-- [TypeDoc][39]
-- [TypeScript][40]
-- [Vitest][41]
-- [Webpack][42]
+- [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]
 
 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
@@ -303,7 +320,7 @@ 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][43]
+- `config` - custom dependency resolvers are applied to the [config files][44]
 - `entry` - files to include with the analysis of the rest of the source code
 
 See each plugin's documentation for its default values.
@@ -328,6 +345,14 @@ rest to find which of those dependencies are unused or missing.
 Other configuration files use `require` or `import` statements to use dependencies, so they can be analyzed like the
 rest of the source files. These configuration files are also considered `entry` files.
 
+For plugins related to test files, it's good to know that the following glob patterns are always included by default:
+
+- `**/*.{test,spec}.{js,jsx,ts,tsx,mjs,cjs}`
+- `**/__tests__/**/*.{js,jsx,ts,tsx,mjs,cjs}`
+- `**/test/**/*.{js,jsx,ts,tsx,mjs,cjs}`
+
+Files matching these patterns are excluded in [production mode][45].
+
 ### Disable a plugin
 
 In case a plugin causes issues, it can be disabled by using `false` as its value (e.g. `"webpack": false`).
@@ -339,6 +364,25 @@ get started:
 
     npm run create-plugin -- --name [myplugin]
 
+## 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.
+
+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
+returns JavaScript or TypeScript as output. For example:
+
+```js
+import { compileSync } from 'mdx-js/mdx';
+
+export default {
+  compilers: {
+    mdx: compileSync,
+  },
+};
+```
+
 ## Production Mode
 
 The default mode for Knip is holistic and targets all project code, including configuration files and tests. Test files
@@ -387,7 +431,7 @@ aliases. They can be configured manually:
 
 ```json
 {
-  "$schema": "https://unpkg.com/knip@1/schema.json",
+  "$schema": "https://unpkg.com/knip@next/schema.json",
   "paths": {
     "@lib": ["./lib/index.ts"],
     "@lib/*": ["./lib/*"]
@@ -404,10 +448,10 @@ Each workspace can also have its own `paths` configured. Note that Knip `paths`
 
 Knip provides the following built-in reporters:
 
-- [`codeowners`][44]
-- [`compact`][45]
-- [`json`][46]
-- [`symbol`][47] (default)
+- codeowners
+- compact
+- json
+- symbol
 
 The `compact` reporter shows the sorted files first, and then a list of symbols:
 
@@ -434,13 +478,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][48].
+Find more details and ideas in [custom reporters][46].
 
-## 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
 /**
@@ -481,7 +524,7 @@ an issue.
 
 When the list of unused files is too long, this means the gap between the set of `entry` and the set of `project` files
 needs tweaking. The gap can be narrowed down by increasing the `entry` files or reducing the `project` files, for
-instance by ignoring specific folders that are not related to the source code imported by the `entry` files.
+instance by ignoring specific directories that are not related to the source code imported by the `entry` files.
 
 #### Too many unused dependencies
 
@@ -492,7 +535,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][49].
+When the dependencies don't have a Knip plugin yet, please file an issue or [create a new plugin][47].
 
 #### Too many unused exports
 
@@ -500,7 +543,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][50].
+2.  The exported values or types can be marked [using the JSDoc `@public` tag][48]
 
 ### How to start using Knip in CI while having too many issues to sort out?
 
@@ -520,22 +563,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][51] | [unimported][52] | [ts-unused-exports][53] | [ts-prune][54] |
-| :--------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
-| 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][49] | [unimported][50] | [ts-unused-exports][51] | [ts-prune][52] |
+| :-------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
+| 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
 
@@ -555,7 +599,7 @@ The following commands are similar:
     unimported
     knip --production --dependencies --include files
 
-Also see [production mode][55].
+Also see [production mode][45].
 
 ### ts-unused-exports
 
@@ -573,13 +617,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
@@ -587,56 +624,53 @@ for the job. I'm motivated to make knip perfectly suited for the job of cutting
 
 [1]: #workspaces--monorepos
 [2]: #plugins
-[3]: #reporters
-[4]: #custom-reporters
-[5]: https://labs.openai.com/s/xZQACaLepaKya0PRUPtIN5dC
-[6]: ./assets/cow-with-orange-scissors-van-gogh-style.webp
-[7]: ./docs/migration-to-v1.md
-[8]: https://github.com/webpro/knip/issues
-[9]: #faq
-[10]: #ignore
-[11]: ./src/plugins/babel
-[12]: ./src/plugins/capacitor
-[13]: ./src/plugins/changesets
-[14]: ./src/plugins/commitlint
-[15]: ./src/plugins/cypress
-[16]: ./src/plugins/eslint
-[17]: ./src/plugins/gatsby
-[18]: ./src/plugins/github-actions
-[19]: ./src/plugins/husky
-[20]: ./src/plugins/jest
-[21]: ./src/plugins/lefthook
-[22]: ./src/plugins/lint-staged
-[23]: ./src/plugins/markdownlint
-[24]: ./src/plugins/mocha
-[25]: ./src/plugins/next
-[26]: ./src/plugins/npm-package-json-lint
-[27]: ./src/plugins/nx
-[28]: ./src/plugins/nyc
-[29]: ./src/plugins/playwright
-[30]: ./src/plugins/postcss
-[31]: ./src/plugins/prettier
-[32]: ./src/plugins/release-it
-[33]: ./src/plugins/remark
-[34]: ./src/plugins/remix
-[35]: ./src/plugins/rollup
-[36]: ./src/plugins/sentry
-[37]: ./src/plugins/storybook
-[38]: ./src/plugins/stryker
-[39]: ./src/plugins/typedoc
-[40]: ./src/plugins/typescript
-[41]: ./src/plugins/vitest
-[42]: ./src/plugins/webpack
-[43]: #config
-[44]: #code-owners
-[45]: #compact
-[46]: #json
-[47]: #symbol-default
-[48]: ./docs/custom-reporters.md
-[49]: #create-a-new-plugin
-[50]: #libraries-and-unused-exports
-[51]: https://github.com/depcheck/depcheck
-[52]: https://github.com/smeijer/unimported
-[53]: https://github.com/pzavolinsky/ts-unused-exports
-[54]: https://github.com/nadeesha/ts-prune
-[55]: #production-mode
+[3]: #compilers
+[4]: #reporters
+[5]: #custom-reporters
+[6]: https://labs.openai.com/s/xZQACaLepaKya0PRUPtIN5dC
+[7]: ./assets/cow-with-orange-scissors-van-gogh-style.webp
+[8]: https://github.com/webpro/knip/issues/73
+[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]: #production-mode
+[46]: ./docs/custom-reporters.md
+[47]: #create-a-new-plugin
+[48]: #public-exports
+[49]: https://github.com/depcheck/depcheck
+[50]: https://github.com/smeijer/unimported
+[51]: https://github.com/pzavolinsky/ts-unused-exports
+[52]: https://github.com/nadeesha/ts-prune

package/dist/configuration-chief.js

@@ -17,10 +17,10 @@ import { resolveIncludedIssueTypes } from './util/resolve-included-issue-types.j
 import { byPathDepth } from './util/workspace.js';
 const { config: rawConfigArg, workspace: rawWorkspaceArg, include = [], exclude = [], dependencies = false, exports = false, } = parsedArgs.values;
 const getDefaultWorkspaceConfig = (extensions) => {
-    const extsGlobStr = [...DEFAULT_EXTENSIONS, ...(extensions ?? [])].map(ext => ext.slice(1)).join(',');
+    const exts = [...DEFAULT_EXTENSIONS, ...(extensions ?? [])].map(ext => ext.slice(1)).join(',');
     return {
-        entry: [`index.{${extsGlobStr}}!`, `src/index.{${extsGlobStr}}!`],
-        project: [`**/*.{${extsGlobStr}}!`],
+        entry: [`index.{${exts}}!`, `src/index.{${exts}}!`],
+        project: [`**/*.{${exts}}!`],
         paths: {},
         ignore: [],
         ignoreBinaries: [],

package/dist/constants.js

@@ -1,7 +1,11 @@
 export const ROOT_WORKSPACE_NAME = '.';
 export const KNIP_CONFIG_LOCATIONS = ['knip.json', 'knip.jsonc', '.knip.json', '.knip.jsonc', 'knip.ts', 'knip.js'];
 export const DEFAULT_EXTENSIONS = ['.js', '.mjs', '.cjs', '.jsx', '.ts', '.tsx'];
-export const TEST_FILE_PATTERNS = ['**/*.{test,spec}.{js,jsx,ts,tsx}', '**/__tests__/**/*.{js,jsx,ts,tsx}'];
+export const TEST_FILE_PATTERNS = [
+    '**/*.{test,spec}.{js,jsx,ts,tsx,mjs,cjs}',
+    '**/__tests__/**/*.{js,jsx,ts,tsx,mjs,cjs}',
+    '**/test/**/*.{js,jsx,ts,tsx,mjs,cjs}',
+];
 export const IGNORED_GLOBAL_BINARIES = [
     'bun',
     'deno',

package/dist/plugins/jest/index.d.ts

@@ -3,5 +3,5 @@ export declare const NAME = "Jest";
 export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
-export declare const ENTRY_FILE_PATTERNS: string[];
+export declare const ENTRY_FILE_PATTERNS: never[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/jest/index.js

@@ -9,7 +9,7 @@ export const NAME = 'Jest';
 export const ENABLERS = ['jest'];
 export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
 export const CONFIG_FILE_PATTERNS = ['jest.config.{js,ts,mjs,cjs,json}'];
-export const ENTRY_FILE_PATTERNS = ['**/__tests__/**/*.[jt]s?(x)', '**/?(*.)+(spec|test).[jt]s?(x)'];
+export const ENTRY_FILE_PATTERNS = [];
 const join = (base, id) => (isAbsolute(id) ? id : path.join(path.dirname(base), id));
 const resolveExtensibleConfig = async (configFilePath) => {
     const config = await _load(configFilePath);

package/dist/plugins/mocha/index.d.ts

@@ -3,5 +3,5 @@ export declare const NAME = "Mocha";
 export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
-export declare const ENTRY_FILE_PATTERNS: string[];
+export declare const ENTRY_FILE_PATTERNS: never[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/mocha/index.js

@@ -6,7 +6,7 @@ export const NAME = 'Mocha';
 export const ENABLERS = ['mocha'];
 export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
 export const CONFIG_FILE_PATTERNS = ['.mocharc.{js,cjs,json,jsonc,yml,yaml}', 'package.json'];
-export const ENTRY_FILE_PATTERNS = ['test/**/*.{js,cjs,mjs}'];
+export const ENTRY_FILE_PATTERNS = [];
 const findMochaDependencies = async (configFilePath, { manifest }) => {
     const config = configFilePath.endsWith('package.json') ? manifest.mocha : await _load(configFilePath);
     if (config) {

package/dist/plugins/playwright/index.js

@@ -2,4 +2,4 @@ import { hasDependency } from '../../util/plugin.js';
 export const NAME = 'Playwright';
 export const ENABLERS = ['@playwright/test'];
 export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
-export const ENTRY_FILE_PATTERNS = ['playwright.config.{js,ts}', '.*{test,spec}.{js,ts,mjs}'];
+export const ENTRY_FILE_PATTERNS = ['playwright.config.{js,ts}'];

package/dist/plugins/typedoc/index.js

@@ -12,6 +12,6 @@ export const CONFIG_FILE_PATTERNS = [
 ];
 const findPluginDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);
-    return config?.plugins ?? [];
+    return config?.plugin ?? [];
 };
 export const findDependencies = timerify(findPluginDependencies);

package/dist/plugins/typedoc/types.d.ts

@@ -1,3 +1,3 @@
 export type PluginConfig = {
-    plugins?: string[];
+    plugin?: string[];
 };

package/dist/plugins/vitest/index.d.ts

@@ -3,5 +3,5 @@ export declare const NAME = "Vitest";
 export declare const ENABLERS: string[];
 export declare const isEnabled: IsPluginEnabledCallback;
 export declare const CONFIG_FILE_PATTERNS: string[];
-export declare const ENTRY_FILE_PATTERNS: string[];
+export declare const ENTRY_FILE_PATTERNS: never[];
 export declare const findDependencies: GenericPluginCallback;

package/dist/plugins/vitest/index.js

@@ -7,7 +7,7 @@ export const NAME = 'Vitest';
 export const ENABLERS = ['vitest'];
 export const isEnabled = ({ dependencies }) => hasDependency(dependencies, ENABLERS);
 export const CONFIG_FILE_PATTERNS = ['vitest.config.ts', 'vite.config.ts'];
-export const ENTRY_FILE_PATTERNS = ['**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'];
+export const ENTRY_FILE_PATTERNS = [];
 const findVitestDependencies = async (configFilePath) => {
     const config = await _load(configFilePath);
     if (!config || !config.test)

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

@@ -1,4 +1,4 @@
-export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports 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, knip.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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --workspace              Analyze a single workspace (default: analyze all configured workspaces)\n  --ignore                 Ignore files matching this glob pattern, can be repeated\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\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --no-progress            Don't show dynamic progress updates\n  --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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  --debug                  Show debug output\n  --debug-file-filter      Filter for files in debug output (regex as string)\n  --performance            Measure count and running time of expensive functions and display stats table\n  --h, --help              Print this help text\n  --V, version             Print version\n\n(1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
+export declare const helpText = "\u2702\uFE0F  Find unused files, dependencies and exports 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, knip.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 tests, devDependencies, exported types)\n  --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)\n  --workspace              Analyze a single workspace (default: analyze all configured workspaces)\n  --ignore                 Ignore files matching this glob pattern, can be repeated\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\n  --exports                Shortcut for --include exports,nsExports,classMembers,types,nsTypes,enumMembers,duplicates\n  --no-progress            Don't show dynamic progress updates\n  --reporter               Select reporter: symbols, compact, codeowners, json (default: symbols)\n  --reporter-options       Pass extra options to the reporter (as JSON string, see example)\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  --debug                  Show debug output\n  --debug-file-filter      Filter for files in debug output (regex as string)\n  --performance            Measure count and running time of expensive functions and display stats table\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\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 --debug --debug-file-filter '(specific|particular)-module'\n\nMore documentation and bug reports: https://github.com/webpro/knip";
 declare const _default: {
     values: {
         config: string | undefined;

package/dist/util/cli-arguments.js

@@ -26,7 +26,7 @@ Options:
   --h, --help              Print this help text
   --V, version             Print version
 
-(1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
+(1) Issue types: files, dependencies, unlisted, unresolved, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
 
 Examples:
 

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.0.0-alpha.0";
+export declare const version = "2.0.0-alpha.2";

package/dist/version.js

@@ -1 +1 @@
-export const version = '2.0.0-alpha.0';
+export const version = '2.0.0-alpha.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "2.0.0-alpha.0",
+  "version": "2.0.0-alpha.2",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",
@@ -22,7 +22,7 @@
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "format": "prettier scripts src test --with-node-modules --write --config .prettierrc",
-    "test": "globstar -- node --loader tsx --test \"test/**/*.test.ts\"",
+    "test": "globstar -- node --loader tsx --test \"tests/**/*.test.ts\"",
     "watch": "tsc --watch",
     "prebuild": "rm -rf dist",
     "build": "tsc",
@@ -30,6 +30,7 @@
     "docs:cli": "tsx ./scripts/update-cli-usage-in-readme.ts",
     "docs:plugins": "tsx ./scripts/generate-plugin-docs.ts",
     "docs:format": "remark README.md docs/*.md src/plugins/*/README.md -o",
+    "qa": "npm run lint && npm run build && npm run knip && npm run knip:production && npm test",
     "release": "release-it",
     "create-plugin": "tsx ./scripts/create-new-plugin.ts"
   },
@@ -57,24 +58,24 @@
     "zod": "^3.20.6"
   },
   "devDependencies": {
-    "@jest/types": "29.4.3",
+    "@jest/types": "29.5.0",
     "@npmcli/package-json": "3.0.0",
     "@release-it/bumper": "4.0.2",
     "@types/eslint": "8.21.1",
     "@types/js-yaml": "4.0.5",
     "@types/micromatch": "4.0.2",
     "@types/minimist": "1.2.2",
-    "@types/node": "18.14.2",
+    "@types/node": "18.14.6",
     "@types/npmcli__map-workspaces": "3.0.0",
     "@types/webpack": "5.28.0",
-    "@typescript-eslint/eslint-plugin": "5.54.0",
-    "@typescript-eslint/parser": "5.54.0",
+    "@typescript-eslint/eslint-plugin": "5.54.1",
+    "@typescript-eslint/parser": "5.54.1",
     "eslint": "8.35.0",
     "eslint-import-resolver-typescript": "3.5.3",
     "eslint-plugin-import": "2.27.5",
     "globstar": "1.0.0",
     "prettier": "2.8.4",
-    "release-it": "^15.6.1",
+    "release-it": "^15.7.0",
     "remark-cli": "11.0.0",
     "remark-preset-webpro": "0.0.1",
     "tsx": "3.12.3",

package/schema.json

@@ -129,17 +129,17 @@
           "title": "Files to ignore in the analysis.",
           "example": ["**/fixtures", "mocks"],
           "default": [],
-          "$ref": "#/definitions/globPatterns",
-          "ignoreBinaries": {
-            "title": "Binaries to ignore",
-            "examples": ["rm", "docker-compose", "curl"],
-            "$ref": "#/definitions/list"
-          },
-          "ignoreDependencies": {
-            "title": "Dependencies from package.json to ignore",
-            "examples": ["husky", "lint-staged"],
-            "$ref": "#/definitions/list"
-          }
+          "$ref": "#/definitions/globPatterns"
+        },
+        "ignoreBinaries": {
+          "title": "Binaries to ignore",
+          "examples": ["rm", "docker-compose", "curl"],
+          "$ref": "#/definitions/list"
+        },
+        "ignoreDependencies": {
+          "title": "Dependencies from package.json to ignore",
+          "examples": ["husky", "lint-staged"],
+          "$ref": "#/definitions/list"
         }
       }
     },