knip 1.7.1 → 1.9.0

package/README.md

@@ -19,29 +19,29 @@ The dots don't connect themselves. This is where Knip comes in:
 - [x] Finds used dependencies not listed in `package.json`
 - [x] Finds duplicate exports
 - [x] Finds unused members of classes and enums
-- [x] Built-in support for monorepos/workspaces
-- [x] Growing list of [built-in plugins][1]
+- [x] Built-in support for [monorepos/workspaces][1]
+- [x] Growing list of [built-in plugins][2]
 - [x] Checks npm scripts for used and unlisted dependencies
 - [x] Supports JavaScript (without `tsconfig.json`, or TypeScript `allowJs: true`)
-- [x] Features multiple [reporters][2] and supports [custom reporters][3]
+- [x] Features multiple [reporters][3] and supports [custom reporters][4]
 - [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][5]][4] <sup>_“An orange cow with scissors, Van Gogh style” - generated
+[![An orange cow with scissors, Van Gogh style][6]][5] <sup>_“An orange cow with scissors, Van Gogh style” - generated
 with OpenAI_</sup>
 
 ## Migrating to v1.0.0
 
-When coming from version v0.13.3 or before, please see [migration to v1][6].
+When coming from version v0.13.3 or before, please see [migration to v1][7].
 
 ## Issues
 
-Are you seeing false positives? Please report them by [opening an issue in this repo][7]. Bonus points for linking to a
+Are you seeing false positives? Please report them by [opening an issue in this repo][8]. 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][8].
+Also see the [FAQ][9].
 
 ## Installation
 
@@ -66,6 +66,21 @@ with a configuration file (or a `knip` property in `package.json`). Let's name t
 The `entry` files target the starting point(s) to resolve the rest of the imported code. The `project` files should
 contain all files to match against the files resolved from the entry files, including potentially unused files.
 
+Use `knip.ts` with TypeScript if you prefer:
+
+```ts
+import type { KnipConfig } from 'knip';
+
+const config: KnipConfig = {
+  entry: ['src/index.ts'],
+  project: ['src/**/*.ts'],
+};
+
+export default config;
+```
+
+If you have, please see [workspaces & monorepos][1].
+
 Then run the checks with `npx knip`. Or first add this script to `package.json`:
 
 ```json
@@ -82,11 +97,13 @@ Use `npm run knip` to analyze the project and output unused files, dependencies
 ## Command-line options
 
     $ npx knip --help
-    knip [options]
+    ✂️  Find unused files, dependencies and exports in your JavaScript and TypeScript projects
+
+    Usage: knip [options]
 
     Options:
-      -c/--config [file]       Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)
-      -t/--tsConfig [file]     TypeScript configuration path (default: tsconfig.json)
+      -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)
+      -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)
       --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)
       --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
       --workspace              Analyze a single workspace (default: analyze all configured workspaces)
@@ -105,6 +122,8 @@ Use `npm run knip` to analyze the project and output unused files, dependencies
       --debug                  Show debug output
       --debug-file-filter      Filter for files in debug output (regex as string)
       --performance            Measure running time of expensive functions and display stats table
+      --h, --help              Print this help text
+      --V, version             Print version
 
     (1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
 
@@ -117,7 +136,7 @@ Use `npm run knip` to analyze the project and output unused files, dependencies
     $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
     $ knip --debug --debug-file-filter '(specific|particular)-module'
 
-    More info: https://github.com/webpro/knip
+    More documentation and bug reports: https://github.com/webpro/knip
 
 ## Screenshots
 
@@ -221,8 +240,13 @@ be part of the analysis. Here's an example:
 }
 ```
 
-All `workspaces` or `workspaces.packages` in `package.json` with a match in `workspaces` of `Knip.json` are part of the
-analysis.
+Knip supports workspaces as defined in three possible locations:
+
+- In the `workspaces` array in `package.json`.
+- 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`.
@@ -235,36 +259,36 @@ Here's some example output when running Knip in a workspace:
 
 Knip contains a growing list of plugins:
 
-- [Babel][9]
-- [Capacitor][11]
-- [Changesets][12]
-- [commitlint][13]
-- [Cypress][14]
-- [ESLint][15]
-- [Gatsby][16]
-- [GitHub Actions][17]
-- [husky][18]
-- [Jest][19]
-- [lint-staged][20]
-- [markdownlint][21]
-- [Mocha][22]
-- [Next.js][23]
-- [npm-package-json-lint][24]
-- [Nx][25]
-- [nyc][26]
-- [Playwright][27]
-- [PostCSS][28]
-- [Prettier][29]
-- [Release It][30]
-- [Remark][31]
-- [Remix][32]
-- [Rollup][33]
-- [Sentry][34]
-- [Storybook][35]
-- [Stryker][36]
-- [TypeScript][37]
-- [Vitest][38]
-- [Webpack][39]
+- [Babel][11]
+- [Capacitor][12]
+- [Changesets][13]
+- [commitlint][14]
+- [Cypress][15]
+- [ESLint][16]
+- [Gatsby][17]
+- [GitHub Actions][18]
+- [husky][19]
+- [Jest][20]
+- [lint-staged][21]
+- [markdownlint][22]
+- [Mocha][23]
+- [Next.js][24]
+- [npm-package-json-lint][25]
+- [Nx][26]
+- [nyc][27]
+- [Playwright][28]
+- [PostCSS][29]
+- [Prettier][30]
+- [Release It][31]
+- [Remark][32]
+- [Remix][33]
+- [Rollup][34]
+- [Sentry][35]
+- [Storybook][36]
+- [Stryker][37]
+- [TypeScript][38]
+- [Vitest][39]
+- [Webpack][40]
 
 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
@@ -272,7 +296,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][40]
+- `config` - custom dependency resolvers are applied to the [config files][41]
 - `entry` - files to include with the analysis of the rest of the source code
 
 See each plugin's documentation for its default values.
@@ -356,7 +380,7 @@ aliases. They can be configured manually:
 
 ```json
 {
-  "$schema": "/Users/lars/p/knip/schema.json",
+  "$schema": "https://unpkg.com/knip@1/schema.json",
   "paths": {
     "@lib": ["./lib/index.ts"],
     "@lib/*": ["./lib/*"]
@@ -373,10 +397,10 @@ Each workspace can also have its own `paths` configured. Note that Knip `paths`
 
 Knip provides the following built-in reporters:
 
-- [`codeowners`][41]
-- [`compact`][42]
-- [`json`][43]
-- [`symbol`][44] (default)
+- [`codeowners`][42]
+- [`compact`][43]
+- [`json`][44]
+- [`symbol`][45] (default)
 
 The `compact` reporter shows the sorted files first, and then a list of symbols:
 
@@ -403,7 +427,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][45].
+Find more details and ideas in [custom reporters][46].
 
 ## Libraries and "unused" exports
 
@@ -461,7 +485,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][46].
+When the dependencies don't have a Knip plugin yet, please file an issue or [create a new plugin][47].
 
 #### Too many unused exports
 
@@ -469,7 +493,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][47].
+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?
 
@@ -489,7 +513,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][48] | [unimported][49] | [ts-unused-exports][50] | [ts-prune][51] |
+| Feature                            | **knip** | [depcheck][49] | [unimported][50] | [ts-unused-exports][51] | [ts-prune][52] |
 | :--------------------------------- | :------: | :------------: | :--------------: | :---------------------: | :------------: |
 | Unused files                       |    ✅    |       -        |        ✅        |            -            |       -        |
 | Unused dependencies                |    ✅    |       ✅       |        ✅        |            -            |       -        |
@@ -554,56 +578,56 @@ userland territory, much like code linters.
 Knip is Dutch for a "cut". A Dutch expression is "to be ge**knip**t for something", which means to be perfectly suited
 for the job. I'm motivated to make knip perfectly suited for the job of cutting projects to perfection! ✂️
 
-[1]: #plugins
-[2]: #reporters
-[3]: #custom-reporters
-[4]: https://labs.openai.com/s/xZQACaLepaKya0PRUPtIN5dC
-[5]: ./assets/cow-with-orange-scissors-van-gogh-style.webp
-[6]: ./docs/migration-to-v1.md
-[7]: https://github.com/webpro/knip/issues
-[8]: #faq
-[9]: ./src/plugins/babel
+[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/capacitor
-[12]: ./src/plugins/changesets
-[13]: ./src/plugins/commitlint
-[14]: ./src/plugins/cypress
-[15]: ./src/plugins/eslint
-[16]: ./src/plugins/gatsby
-[17]: ./src/plugins/github-actions
-[18]: ./src/plugins/husky
-[19]: ./src/plugins/jest
-[20]: ./src/plugins/lint-staged
-[21]: ./src/plugins/markdownlint
-[22]: ./src/plugins/mocha
-[23]: ./src/plugins/next
-[24]: ./src/plugins/npm-package-json-lint
-[25]: ./src/plugins/nx
-[26]: ./src/plugins/nyc
-[27]: ./src/plugins/playwright
-[28]: ./src/plugins/postcss
-[29]: ./src/plugins/prettier
-[30]: ./src/plugins/release-it
-[31]: ./src/plugins/remark
-[32]: ./src/plugins/remix
-[33]: ./src/plugins/rollup
-[34]: ./src/plugins/sentry
-[35]: ./src/plugins/storybook
-[36]: ./src/plugins/stryker
-[37]: ./src/plugins/typescript
-[38]: ./src/plugins/vitest
-[39]: ./src/plugins/webpack
-[40]: #config
-[41]: #code-owners
-[42]: #compact
-[43]: #json
-[44]: #symbol-default
-[45]: ./docs/custom-reporters.md
-[46]: #create-a-new-plugin
-[47]: #libraries-and-unused-exports
-[48]: https://github.com/depcheck/depcheck
-[49]: https://github.com/smeijer/unimported
-[50]: https://github.com/pzavolinsky/ts-unused-exports
-[51]: https://github.com/nadeesha/ts-prune
-[52]: #workspaces--monorepos
+[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/lint-staged
+[22]: ./src/plugins/markdownlint
+[23]: ./src/plugins/mocha
+[24]: ./src/plugins/next
+[25]: ./src/plugins/npm-package-json-lint
+[26]: ./src/plugins/nx
+[27]: ./src/plugins/nyc
+[28]: ./src/plugins/playwright
+[29]: ./src/plugins/postcss
+[30]: ./src/plugins/prettier
+[31]: ./src/plugins/release-it
+[32]: ./src/plugins/remark
+[33]: ./src/plugins/remix
+[34]: ./src/plugins/rollup
+[35]: ./src/plugins/sentry
+[36]: ./src/plugins/storybook
+[37]: ./src/plugins/stryker
+[38]: ./src/plugins/typescript
+[39]: ./src/plugins/vitest
+[40]: ./src/plugins/webpack
+[41]: #config
+[42]: #code-owners
+[43]: #compact
+[44]: #json
+[45]: #symbol-default
+[46]: ./docs/custom-reporters.md
+[47]: #create-a-new-plugin
+[48]: #libraries-and-unused-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
 [53]: #production-mode

package/dist/cli.js

@@ -6,13 +6,18 @@ 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 { version } from './version.js';
 import { main } from './index.js';
 register();
-const { values: { debug: isDebug = false, help, 'include-entry-exports': isIncludeEntryExports = false, 'max-issues': maxIssues = '0', 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, }, } = parsedArgs;
-if (help) {
+const { values: { debug: isDebug = false, help: isHelp, 'include-entry-exports': isIncludeEntryExports = false, 'max-issues': maxIssues = '0', 'no-exit-code': noExitCode = false, 'no-gitignore': isNoGitIgnore = false, 'no-progress': isNoProgress = false, production: isProduction = false, reporter = 'symbols', 'reporter-options': reporterOptions = '', strict: isStrict = false, tsConfig, version: isVersion, }, } = parsedArgs;
+if (isHelp) {
     console.log(helpText);
     process.exit(0);
 }
+if (isVersion) {
+    console.log(version);
+    process.exit(0);
+}
 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 _load(path.join(cwd, reporter));

package/dist/configuration-chief.d.ts

@@ -12,6 +12,7 @@ export default class ConfigurationChief {
     manifestPath: undefined | string;
     manifest: undefined | PackageJson;
     manifestWorkspaces: undefined | string[];
+    resolvedConfigFilePath: undefined | string;
     constructor({ cwd, isProduction }: ConfigurationManagerOptions);
     loadLocalConfig(): Promise<void>;
     normalize(rawLocalConfig: RawConfiguration): {

package/dist/configuration-chief.js

@@ -34,29 +34,34 @@ export default class ConfigurationChief {
     manifestPath;
     manifest;
     manifestWorkspaces;
+    resolvedConfigFilePath;
     constructor({ cwd, isProduction }) {
         this.cwd = cwd;
         this.isProduction = isProduction;
         this.config = defaultConfig;
     }
     async loadLocalConfig() {
-        const manifestPath = await findFile(this.cwd, 'package.json');
+        const manifestPath = findFile(this.cwd, 'package.json');
         const manifest = manifestPath && (await loadJSON(manifestPath));
         if (!manifestPath || !manifest) {
             throw new ConfigurationError('Unable to find package.json');
         }
         this.manifestPath = manifestPath;
         this.manifest = manifest;
-        let resolvedConfigFilePath;
+        const pnpmWorkspacesPath = findFile(this.cwd, 'pnpm-workspace.yaml');
+        const pnpmWorkspaces = pnpmWorkspacesPath && (await _load(pnpmWorkspacesPath));
+        if (this.manifest && !this.manifest.workspaces && pnpmWorkspaces) {
+            this.manifest.workspaces = pnpmWorkspaces;
+        }
         for (const configPath of rawConfigArg ? [rawConfigArg] : KNIP_CONFIG_LOCATIONS) {
-            resolvedConfigFilePath = await findFile(this.cwd, configPath);
-            if (resolvedConfigFilePath)
+            this.resolvedConfigFilePath = findFile(this.cwd, configPath);
+            if (this.resolvedConfigFilePath)
                 break;
         }
-        if (rawConfigArg && !resolvedConfigFilePath && !manifest.knip) {
+        if (rawConfigArg && !this.resolvedConfigFilePath && !manifest.knip) {
             throw new ConfigurationError(`Unable to find ${rawConfigArg} or package.json#knip`);
         }
-        const rawLocalConfig = resolvedConfigFilePath ? await _load(resolvedConfigFilePath) : manifest.knip;
+        const rawLocalConfig = this.resolvedConfigFilePath ? await _load(this.resolvedConfigFilePath) : manifest.knip;
         if (rawLocalConfig) {
             this.config = this.normalize(ConfigurationValidator.parse(rawLocalConfig));
         }

package/dist/index.js

@@ -17,7 +17,7 @@ import WorkspaceWorker from './workspace-worker.js';
 export const main = async (unresolvedConfiguration) => {
     const { cwd, tsConfigFile, gitignore, isStrict, isProduction, isShowProgress, isIncludeEntryExports } = unresolvedConfiguration;
     const chief = new ConfigurationChief({ cwd, isProduction });
-    debugLogObject('Unresolved configuration', unresolvedConfiguration);
+    debugLogObject('Unresolved configuration (from CLI arguments)', unresolvedConfiguration);
     const collector = new IssueCollector({ cwd, isShowProgress });
     collector.updateMessage('Reading configuration and manifest files...');
     await chief.loadLocalConfig();
@@ -34,7 +34,7 @@ export const main = async (unresolvedConfiguration) => {
     for (const { name, dir, config, ancestors } of workspaces) {
         const isRoot = name === ROOT_WORKSPACE_NAME;
         const suffix = isRoot ? '' : ` (${name})`;
-        const manifestPath = isRoot ? chief.manifestPath : await findFile(dir, 'package.json');
+        const manifestPath = isRoot ? chief.manifestPath : findFile(dir, 'package.json');
         const manifest = isRoot ? chief.manifest : manifestPath && (await loadJSON(manifestPath));
         if (!manifestPath || !manifest)
             continue;
@@ -195,6 +195,9 @@ export const main = async (unresolvedConfiguration) => {
     }
     collector.setReport(report);
     collector.updateMessage('Connecting the dots...');
+    if (chief.resolvedConfigFilePath) {
+        principal.removeProjectPath(chief.resolvedConfigFilePath);
+    }
     principal.createProjects();
     const moduleSpecifierCache = new WeakMap();
     const resolvedFiles = principal.getResolvedFiles();

package/dist/project-principal.d.ts

@@ -12,6 +12,7 @@ export default class ProjectPrincipal {
     addEntryPath(filePath: string): void;
     addSourceFile(filePath: string): void;
     addProjectPath(filePath: string): void;
+    removeProjectPath(filePath: string): void;
     addTypeScriptPaths(workspaceDir: string, compilerOptions: TsConfigJson['compilerOptions']): void;
     createProjects(): void;
     getResolvedFiles(): SourceFile[];

package/dist/project-principal.js

@@ -31,6 +31,9 @@ export default class ProjectPrincipal {
     addProjectPath(filePath) {
         this.projectPaths.add(filePath);
     }
+    removeProjectPath(filePath) {
+        this.projectPaths.delete(filePath);
+    }
     addTypeScriptPaths(workspaceDir, compilerOptions) {
         if (!compilerOptions || !compilerOptions.paths)
             return;

package/dist/reporters/json.js

@@ -13,7 +13,7 @@ export default async ({ report, issues, options }) => {
     }
     const json = {};
     const codeownersFilePath = path.resolve(opts.codeowners ?? '.github/CODEOWNERS');
-    const codeownersEngine = (await isFile(codeownersFilePath)) && OwnershipEngine.FromCodeownersFile(codeownersFilePath);
+    const codeownersEngine = isFile(codeownersFilePath) && OwnershipEngine.FromCodeownersFile(codeownersFilePath);
     const flatten = (issues) => Object.values(issues).map(Object.values).flat();
     const initRow = (filePath) => {
         const file = relative(filePath);

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

@@ -1,4 +1,4 @@
-export declare const helpText = "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  --include-entry-exports  Include unused exports in entry files (without `@public`)\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 running time of expensive functions and display stats table\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 info: 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  --include-entry-exports  Include unused exports in entry files (without `@public`)\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 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";
 declare const _default: {
     values: {
         config: string | undefined;
@@ -21,6 +21,7 @@ declare const _default: {
         'reporter-options': string | undefined;
         strict: boolean | undefined;
         tsConfig: string | undefined;
+        version: boolean | undefined;
         workspace: string | undefined;
     };
     positionals: [];

package/dist/util/cli-arguments.js

@@ -1,9 +1,11 @@
 import { parseArgs } from 'node:util';
-export const helpText = `knip [options]
+export const helpText = `✂️  Find unused files, dependencies and exports in your JavaScript and TypeScript projects
+
+Usage: knip [options]
 
 Options:
-  -c/--config [file]       Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)
-  -t/--tsConfig [file]     TypeScript configuration path (default: tsconfig.json)
+  -c, --config [file]      Configuration file path (default: [.]knip.json[c], knip.js, knip.ts or package.json#knip)
+  -t, --tsConfig [file]    TypeScript configuration path (default: tsconfig.json)
   --production             Analyze only production source files (e.g. no tests, devDependencies, exported types)
   --strict                 Consider only direct dependencies of workspace (not devDependencies, not other workspaces)
   --workspace              Analyze a single workspace (default: analyze all configured workspaces)
@@ -22,6 +24,8 @@ Options:
   --debug                  Show debug output
   --debug-file-filter      Filter for files in debug output (regex as string)
   --performance            Measure running time of expensive functions and display stats table
+  --h, --help              Print this help text
+  --V, version             Print version
 
 (1) Issue types: files, dependencies, unlisted, exports, nsExports, classMembers, types, nsTypes, enumMembers, duplicates
 
@@ -34,7 +38,7 @@ $ knip -c ./config/knip.json --reporter compact
 $ knip --reporter codeowners --reporter-options '{"path":".github/CODEOWNERS"}'
 $ knip --debug --debug-file-filter '(specific|particular)-module'
 
-More info: https://github.com/webpro/knip`;
+More documentation and bug reports: https://github.com/webpro/knip`;
 export default parseArgs({
     options: {
         config: { type: 'string', short: 'c' },
@@ -57,6 +61,7 @@ export default parseArgs({
         'reporter-options': { type: 'string' },
         strict: { type: 'boolean' },
         tsConfig: { type: 'string', short: 't' },
+        version: { type: 'boolean', short: 'V' },
         workspace: { type: 'string' },
     },
 });

package/dist/util/tsconfig-loader.js

@@ -3,7 +3,7 @@ import { isFile } from './fs.js';
 import { logIfDebug } from './log.js';
 export const loadTSConfig = async (tsConfigFilePath) => {
     try {
-        if (await isFile(tsConfigFilePath)) {
+        if (isFile(tsConfigFilePath)) {
             return parseTsconfig(tsConfigFilePath);
         }
     }

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const version = "1.9.0";

package/dist/version.js

@@ -0,0 +1 @@
+export const version = '1.9.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knip",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "description": "Find unused files, dependencies and exports in your TypeScript and JavaScript projects",
   "homepage": "https://github.com/webpro/knip",
   "repository": "github:webpro/knip",
@@ -63,6 +63,7 @@
   "devDependencies": {
     "@jest/types": "29.3.1",
     "@npmcli/package-json": "3.0.0",
+    "@release-it/bumper": "^4.0.2",
     "@types/eslint": "8.4.10",
     "@types/js-yaml": "4.0.5",
     "@types/micromatch": "4.0.2",
@@ -98,6 +99,11 @@
     },
     "github": {
       "release": true
+    },
+    "plugins": {
+      "@release-it/bumper": {
+        "out": "{dist,src}/version.*"
+      }
     }
   },
   "remarkConfig": {